SDK d'extension

Les extensions drawtonomy sont des applications web hébergées en iframe qui dialoguent avec l’éditeur via postMessage. Le SDK fournit un client typé ; le dev-server fournit un éditeur local sur lequel développer.

Cette page est une orientation rapide. Le guide complet — schéma du manifeste, liste des capacités, protocole des messages — est dans le dépôt public :

➡ Guide de développement d’extensions (日本語)

Démarrage rapide

# Éditeur sur :3000
pnpm add -g @drawtonomy/dev-server
drawtonomy-dev-server

# Votre extension sur :3001
cd my-extension && pnpm dev --port 3001

open "http://localhost:3000/?ext=http://localhost:3001/manifest.json"

Extension minimale

my-extension/
  manifest.json
  index.html
  src/

manifest.json

{
  "id": "my-extension",
  "name": "My Extension",
  "version": "1.0.0",
  "entry": "./index.html",
  "capabilities": ["shapes:read", "shapes:write", "ui:panel"]
}

src/main.ts

import { ExtensionClient, createVehicle } from '@drawtonomy/sdk'

const client = new ExtensionClient()
await client.ready()

document.getElementById('add')!.addEventListener('click', async () => {
  await client.addShapes([createVehicle(0, 0, { templateId: 'sedan' })])
})

Extensions de référence

Les extensions intégrées sont des exemples pleine fidélité :

• ai-scene-generator — génération de scènes en langage naturel et OpenSCENARIO.
• template-preview — prévisualisation d’un modèle de forme.
• exporter-playground — exercer l’exporteur face à un canevas en direct.
• path-footprint-lab — expérimentation autour de l’empreinte de trajectoire.

Voir aussi

• Architecture des extensions — pourquoi des iframes, pourquoi postMessage.
• Vue d’ensemble de @drawtonomy/sdk — le paquet et ses modules.