SDK de extensiones

Las extensiones de drawtonomy son aplicaciones web alojadas en iframe que se comunican con el editor mediante postMessage. El SDK te da un cliente tipado; el dev-server te da un editor local contra el que desarrollar.

Esta página es una orientación rápida. La guía completa — esquema del manifest, lista de capabilities, protocolo de mensajes — está en el repo público:

➡ Guía de Desarrollo de Extensiones (日本語)

Inicio rápido

# Editor en :3000
pnpm add -g @drawtonomy/dev-server
drawtonomy-dev-server

# Tu extensión en :3001
cd my-extension && pnpm dev --port 3001

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

Extensión mínima

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

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

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' })])
})

Extensiones de referencia

Las extensiones internas son ejemplos de fidelidad completa:

ai-scene-generator — generación de escenas en lenguaje natural y OpenSCENARIO.
template-preview — vista previa de una plantilla de forma.
exporter-playground — ejercita el exportador contra un lienzo en vivo.
path-footprint-lab — experimentación con Path Footprint.

Véase también

Arquitectura de extensiones — por qué iframes, por qué postMessage.
Resumen de @drawtonomy/sdk — el paquete y sus módulos.