@drawtonomy/sdk 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @drawtonomy/sdk
+
+Drawtonomy エクステンション開発用SDK。
+
+## インストール
+
+```bash
+npm install @drawtonomy/sdk
+```
+
+## クイックスタート
+
+### 1. マニフェストを作成
+
+```json
+{
+  "id": "my-extension",
+  "name": "My Extension",
+  "version": "1.0.0",
+  "description": "何をするエクステンションか",
+  "author": { "name": "Your Name" },
+  "entry": "./index.html",
+  "capabilities": ["shapes:write", "shapes:read", "ui:panel"]
+}
+```
+
+### 2. SDKを使ってエクステンションを実装
+
+```typescript
+import { ExtensionClient, createVehicle, createLaneWithBoundaries } from '@drawtonomy/sdk'
+
+const client = new ExtensionClient('my-extension')
+
+// ホストとの接続を待つ
+const init = await client.waitForInit()
+console.log('Connected! Capabilities:', init.grantedCapabilities)
+
+// 車両を追加
+client.addShapes([
+  createVehicle(200, 300, { templateId: 'sedan', color: 'blue' })
+])
+
+// レーンを一括作成
+const laneShapes = createLaneWithBoundaries(
+  [{ x: 0, y: 0 }, { x: 500, y: 0 }],
+  [{ x: 0, y: 70 }, { x: 500, y: 70 }]
+)
+client.addShapes(laneShapes)
+
+// 既存シェイプを読み取り
+const vehicles = await client.requestShapes({ types: ['vehicle'] })
+
+// 通知を表示
+client.notify('完了しました', 'success')
+```
+
+### 3. 開発サーバーで起動
+
+```bash
+npm run dev -- --port 3001
+```
+
+### 4. Drawtonomyで読み込む
+
+ブラウザで以下のURLにアクセス:
+
+```
+https://drawtonomy.com?ext=http://localhost:3001/manifest.json
+```
+
+## API
+
+### ExtensionClient
+
+| メソッド | 必要なCapability | 説明 |
+|---------|-----------------|------|
+| `waitForInit()` | - | ホストとの接続を待つ |
+| `addShapes(shapes)` | `shapes:write` | シェイプを追加 |
+| `updateShapes(updates)` | `shapes:write` | シェイプを更新 |
+| `deleteShapes(ids)` | `shapes:write` | シェイプを削除 |
+| `requestShapes(filter?)` | `shapes:read` | シェイプを読み取り |
+| `requestSnapshot()` | `snapshot:read` | スナップショットを取得 |
+| `requestViewport()` | `viewport:read` | ビューポート情報を取得 |
+| `requestSelection()` | `selection:read` | 選択状態を取得 |
+| `notify(message, level?)` | `ui:notify` | 通知を表示 |
+| `resize(height, width?)` | `ui:panel` | パネルサイズを変更 |
+
+### ファクトリ関数
+
+| 関数 | 説明 |
+|------|------|
+| `createPoint(x, y, options?)` | ポイントを作成 |
+| `createLinestring(x, y, pointIds, options?)` | ラインストリングを作成 |
+| `createLane(x, y, leftId, rightId, options?)` | レーンを作成 |
+| `createLaneWithBoundaries(leftPts, rightPts, options?)` | レーン+境界を一括作成 |
+| `createVehicle(x, y, options?)` | 車両を作成 |
+| `createPedestrian(x, y, options?)` | 歩行者を作成 |
+| `createRectangle(x, y, w, h, options?)` | 矩形を作成 |
+| `createEllipse(x, y, w, h, options?)` | 楕円を作成 |
+| `createText(x, y, text, options?)` | テキストを作成 |
+| `createSnapshot(shapes)` | スナップショットを作成 |
+
+## デプロイ
+
+エクステンションは任意のHTTPSホスティングサービスにデプロイできます。
+
+### GitHub Pages
+
+`manifest.json`のCORSヘッダーは自動付与されるため設定不要。
+
+### Vercel
+
+`vercel.json`:
+```json
+{
+  "headers": [
+    {
+      "source": "/manifest.json",
+      "headers": [
+        { "key": "Access-Control-Allow-Origin", "value": "*" }
+      ]
+    }
+  ]
+}
+```
+
+### Netlify
+
+`_headers`:
+```
+/manifest.json
+  Access-Control-Allow-Origin: *
+```
+
+### ローカル開発
+
+Vite devサーバーはデフォルトでCORS許可済み。`localhost`はHTTPでも動作します。
+
+## ドキュメント
+
+詳細は https://github.com/kosuke55/drawtonomy-app/blob/main/docs/extensions.md を参照。

package/dist/ExtensionClient.d.ts

@@ -0,0 +1,41 @@
+import type { InitPayload, ShapeFilter, BaseShape, DrawtonomySnapshot } from './types';
+export declare class ExtensionClient {
+    private manifestId;
+    private initPromise;
+    private initResolve;
+    private pendingRequests;
+    private requestTimeout;
+    constructor(manifestId: string, options?: {
+        requestTimeout?: number;
+    });
+    /**
+     * Wait for the host to send init payload
+     */
+    waitForInit(): Promise<InitPayload>;
+    addShapes(shapes: BaseShape[]): void;
+    updateShapes(updates: Array<{
+        id: string;
+        props: Record<string, unknown>;
+    }>): void;
+    deleteShapes(ids: string[]): void;
+    requestShapes(filter?: ShapeFilter): Promise<BaseShape[]>;
+    requestSnapshot(): Promise<DrawtonomySnapshot>;
+    requestViewport(): Promise<{
+        x: number;
+        y: number;
+        zoom: number;
+        width: number;
+        height: number;
+    }>;
+    requestSelection(): Promise<{
+        ids: string[];
+    }>;
+    notify(message: string, level?: 'info' | 'success' | 'error'): void;
+    resize(height: number, width?: number): void;
+    private send;
+    private handleMessage;
+    private requestIdCounter;
+    private nextRequestId;
+    private waitForResponse;
+}
+//# sourceMappingURL=ExtensionClient.d.ts.map

package/dist/ExtensionClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionClient.d.ts","sourceRoot":"","sources":["../src/ExtensionClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,kBAAkB,EACnB,MAAM,SAAS,CAAA;AAQhB,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,cAAc,CAAQ;gBAElB,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAcrE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAMzC,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE;IAI7B,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAI3E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE;IAMpB,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASzD,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAS9C,eAAe,IAAI,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQjG,gBAAgB,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAQpD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,SAAS,GAAG,OAAgB;IAMpE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAMrC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,gBAAgB,CAAI;IAE5B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;CAUxB"}

package/dist/ExtensionClient.js

@@ -0,0 +1,111 @@
+export class ExtensionClient {
+    constructor(manifestId, options) {
+        this.pendingRequests = new Map();
+        this.requestIdCounter = 0;
+        this.manifestId = manifestId;
+        this.requestTimeout = options?.requestTimeout ?? 30000;
+        this.initPromise = new Promise(resolve => {
+            this.initResolve = resolve;
+        });
+        window.addEventListener('message', this.handleMessage.bind(this));
+        // Send ready signal
+        this.send({ type: 'ext:ready', payload: { manifestId } });
+    }
+    /**
+     * Wait for the host to send init payload
+     */
+    async waitForInit() {
+        return this.initPromise;
+    }
+    // --- shapes:write ---
+    addShapes(shapes) {
+        this.send({ type: 'ext:shapes-add', payload: { shapes } });
+    }
+    updateShapes(updates) {
+        this.send({ type: 'ext:shapes-update', payload: { updates } });
+    }
+    deleteShapes(ids) {
+        this.send({ type: 'ext:shapes-delete', payload: { ids } });
+    }
+    // --- shapes:read ---
+    async requestShapes(filter) {
+        const requestId = this.nextRequestId();
+        this.send({ type: 'ext:shapes-request', payload: { requestId, filter } });
+        const response = await this.waitForResponse(requestId);
+        return response.shapes;
+    }
+    // --- snapshot:read ---
+    async requestSnapshot() {
+        const requestId = this.nextRequestId();
+        this.send({ type: 'ext:snapshot-request', payload: { requestId } });
+        const response = await this.waitForResponse(requestId);
+        return response.snapshot;
+    }
+    // --- viewport:read ---
+    async requestViewport() {
+        const requestId = this.nextRequestId();
+        this.send({ type: 'ext:viewport-request', payload: { requestId } });
+        return await this.waitForResponse(requestId);
+    }
+    // --- selection:read ---
+    async requestSelection() {
+        const requestId = this.nextRequestId();
+        this.send({ type: 'ext:selection-request', payload: { requestId } });
+        return await this.waitForResponse(requestId);
+    }
+    // --- ui:notify ---
+    notify(message, level = 'info') {
+        this.send({ type: 'ext:notify', payload: { message, level } });
+    }
+    // --- ui:panel ---
+    resize(height, width) {
+        this.send({ type: 'ext:resize', payload: { height, width } });
+    }
+    // --- Internal ---
+    send(message) {
+        window.parent.postMessage(message, '*');
+    }
+    handleMessage(event) {
+        const data = event.data;
+        if (!data || typeof data !== 'object' || typeof data.type !== 'string')
+            return;
+        if (!data.type.startsWith('ext:'))
+            return;
+        if (data.type === 'ext:init') {
+            this.initResolve(data.payload);
+            return;
+        }
+        // Handle responses
+        if (data.type === 'ext:error' && data.payload?.requestId) {
+            const pending = this.pendingRequests.get(data.payload.requestId);
+            if (pending) {
+                clearTimeout(pending.timeout);
+                this.pendingRequests.delete(data.payload.requestId);
+                pending.reject(new Error(data.payload.message));
+            }
+            return;
+        }
+        const requestId = data.payload?.requestId;
+        if (requestId) {
+            const pending = this.pendingRequests.get(requestId);
+            if (pending) {
+                clearTimeout(pending.timeout);
+                this.pendingRequests.delete(requestId);
+                pending.resolve(data.payload);
+            }
+        }
+    }
+    nextRequestId() {
+        return `${this.manifestId}_${++this.requestIdCounter}_${Date.now().toString(36)}`;
+    }
+    waitForResponse(requestId) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                reject(new Error(`Request ${requestId} timed out`));
+            }, this.requestTimeout);
+            this.pendingRequests.set(requestId, { resolve, reject, timeout });
+        });
+    }
+}
+//# sourceMappingURL=ExtensionClient.js.map

package/dist/ExtensionClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionClient.js","sourceRoot":"","sources":["../src/ExtensionClient.ts"],"names":[],"mappings":"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"}

package/dist/helpers.d.ts

@@ -0,0 +1,54 @@
+import type { BaseShape, PointProps, LinestringProps, LaneProps, VehicleProps, PedestrianProps, RectangleProps, EllipseProps, TextProps, DrawtonomySnapshot } from './types';
+export declare function resetIdCounter(): void;
+export declare function createPoint(x: number, y: number, options?: Partial<PointProps> & {
+    id?: string;
+}): BaseShape<'point', PointProps>;
+export declare function createLinestring(x: number, y: number, pointIds: string[], options?: Partial<LinestringProps> & {
+    id?: string;
+}): BaseShape<'linestring', LinestringProps>;
+export declare function createLane(x: number, y: number, leftBoundaryId: string, rightBoundaryId: string, options?: Partial<LaneProps> & {
+    id?: string;
+}): BaseShape<'lane', LaneProps>;
+export interface LaneWithBoundariesOptions {
+    laneOptions?: Partial<LaneProps> & {
+        id?: string;
+    };
+    leftOptions?: Partial<LinestringProps> & {
+        id?: string;
+    };
+    rightOptions?: Partial<LinestringProps> & {
+        id?: string;
+    };
+}
+/**
+ * Create a complete lane with its boundary linestrings and points.
+ *
+ * @param leftPoints - Array of {x, y} for left boundary
+ * @param rightPoints - Array of {x, y} for right boundary
+ * @param options - Optional configuration for lane and boundaries
+ * @returns Array of shapes: points, linestrings, lane (in dependency order)
+ */
+export declare function createLaneWithBoundaries(leftPoints: Array<{
+    x: number;
+    y: number;
+}>, rightPoints: Array<{
+    x: number;
+    y: number;
+}>, options?: LaneWithBoundariesOptions): BaseShape<string, any>[];
+export declare function createVehicle(x: number, y: number, options?: Partial<VehicleProps> & {
+    id?: string;
+}): BaseShape<'vehicle', VehicleProps>;
+export declare function createPedestrian(x: number, y: number, options?: Partial<PedestrianProps> & {
+    id?: string;
+}): BaseShape<'pedestrian', PedestrianProps>;
+export declare function createRectangle(x: number, y: number, w: number, h: number, options?: Partial<RectangleProps> & {
+    id?: string;
+}): BaseShape<'rectangle', RectangleProps>;
+export declare function createEllipse(x: number, y: number, w: number, h: number, options?: Partial<EllipseProps> & {
+    id?: string;
+}): BaseShape<'ellipse', EllipseProps>;
+export declare function createText(x: number, y: number, text: string, options?: Partial<TextProps> & {
+    id?: string;
+}): BaseShape<'text', TextProps>;
+export declare function createSnapshot(shapes: BaseShape[]): DrawtonomySnapshot;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/helpers.js

@@ -0,0 +1,204 @@
+let idCounter = 0;
+function nextId(prefix = 'ext') {
+    return `${prefix}_${++idCounter}_${Date.now().toString(36)}`;
+}
+export function resetIdCounter() {
+    idCounter = 0;
+}
+// --- Point ---
+export function createPoint(x, y, options) {
+    return {
+        id: options?.id ?? nextId('pt'),
+        type: 'point',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            color: options?.color ?? 'black',
+            visible: options?.visible ?? true,
+            osmId: options?.osmId ?? '',
+        },
+    };
+}
+// --- Linestring ---
+export function createLinestring(x, y, pointIds, options) {
+    return {
+        id: options?.id ?? nextId('ls'),
+        type: 'linestring',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            pointIds,
+            color: options?.color ?? 'black',
+            strokeWidth: options?.strokeWidth ?? 2,
+            attributes: options?.attributes ?? { type: 'linestring', subtype: 'solid' },
+            osmId: options?.osmId ?? '',
+        },
+    };
+}
+// --- Lane ---
+export function createLane(x, y, leftBoundaryId, rightBoundaryId, options) {
+    return {
+        id: options?.id ?? nextId('lane'),
+        type: 'lane',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            leftBoundaryId,
+            rightBoundaryId,
+            invertLeft: options?.invertLeft ?? false,
+            invertRight: options?.invertRight ?? false,
+            color: options?.color ?? 'default',
+            size: options?.size ?? 'm',
+            attributes: options?.attributes ?? { type: 'lanelet', subtype: 'road', speed_limit: '30' },
+            next: options?.next ?? [],
+            prev: options?.prev ?? [],
+            osmId: options?.osmId ?? '',
+        },
+    };
+}
+/**
+ * Create a complete lane with its boundary linestrings and points.
+ *
+ * @param leftPoints - Array of {x, y} for left boundary
+ * @param rightPoints - Array of {x, y} for right boundary
+ * @param options - Optional configuration for lane and boundaries
+ * @returns Array of shapes: points, linestrings, lane (in dependency order)
+ */
+export function createLaneWithBoundaries(leftPoints, rightPoints, options) {
+    const shapes = [];
+    // Create left boundary points
+    const leftPointIds = [];
+    for (const pt of leftPoints) {
+        const point = createPoint(pt.x, pt.y);
+        leftPointIds.push(point.id);
+        shapes.push(point);
+    }
+    // Create right boundary points
+    const rightPointIds = [];
+    for (const pt of rightPoints) {
+        const point = createPoint(pt.x, pt.y);
+        rightPointIds.push(point.id);
+        shapes.push(point);
+    }
+    // Create linestrings
+    const leftLs = createLinestring(0, 0, leftPointIds, options?.leftOptions);
+    const rightLs = createLinestring(0, 0, rightPointIds, options?.rightOptions);
+    shapes.push(leftLs);
+    shapes.push(rightLs);
+    // Create lane
+    const lane = createLane(0, 0, leftLs.id, rightLs.id, options?.laneOptions);
+    shapes.push(lane);
+    return shapes;
+}
+// --- Vehicle ---
+export function createVehicle(x, y, options) {
+    return {
+        id: options?.id ?? nextId('veh'),
+        type: 'vehicle',
+        x,
+        y,
+        rotation: options?.templateId ? 0 : 0,
+        zIndex: 0,
+        props: {
+            w: options?.w ?? 90,
+            h: options?.h ?? 45,
+            color: options?.color ?? 'black',
+            size: options?.size ?? 'm',
+            attributes: options?.attributes ?? { type: 'vehicle', subtype: 'car' },
+            osmId: options?.osmId ?? '',
+            templateId: options?.templateId ?? 'default',
+        },
+    };
+}
+// --- Pedestrian ---
+export function createPedestrian(x, y, options) {
+    return {
+        id: options?.id ?? nextId('ped'),
+        type: 'pedestrian',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            w: options?.w ?? 22,
+            h: options?.h ?? 22,
+            color: options?.color ?? 'black',
+            size: options?.size ?? 'm',
+            attributes: options?.attributes ?? { type: 'pedestrian', subtype: 'person' },
+            osmId: options?.osmId ?? '',
+            templateId: options?.templateId ?? 'filled',
+        },
+    };
+}
+// --- Rectangle ---
+export function createRectangle(x, y, w, h, options) {
+    return {
+        id: options?.id ?? nextId('rect'),
+        type: 'rectangle',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            w,
+            h,
+            color: options?.color ?? '#000000',
+            fill: options?.fill ?? 'none',
+            strokeWidth: options?.strokeWidth ?? 2,
+        },
+    };
+}
+// --- Ellipse ---
+export function createEllipse(x, y, w, h, options) {
+    return {
+        id: options?.id ?? nextId('ell'),
+        type: 'ellipse',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            w,
+            h,
+            color: options?.color ?? '#000000',
+            fill: options?.fill ?? 'none',
+            strokeWidth: options?.strokeWidth ?? 2,
+        },
+    };
+}
+// --- Text ---
+export function createText(x, y, text, options) {
+    return {
+        id: options?.id ?? nextId('txt'),
+        type: 'text',
+        x,
+        y,
+        rotation: 0,
+        zIndex: 0,
+        props: {
+            w: options?.w ?? 200,
+            h: options?.h ?? 32,
+            text,
+            color: options?.color ?? 'black',
+            fontSize: options?.fontSize ?? 20,
+            font: options?.font ?? 'sans',
+            textAlign: options?.textAlign ?? 'left',
+            autoSize: options?.autoSize ?? true,
+        },
+    };
+}
+// --- Snapshot ---
+export function createSnapshot(shapes) {
+    return {
+        version: '1.1',
+        timestamp: new Date().toISOString(),
+        shapes,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './helpers';
+export { ExtensionClient } from './ExtensionClient';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// @drawtonomy/sdk - Entry Point
+export * from './types';
+export * from './helpers';
+export { ExtensionClient } from './ExtensionClient';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,205 @@
+export type ShapeId = string;
+export interface BaseShape<Type extends string = string, Props = Record<string, unknown>> {
+    id: ShapeId;
+    type: Type;
+    x: number;
+    y: number;
+    rotation: number;
+    zIndex: number;
+    index?: string;
+    props: Props;
+}
+export interface PointProps {
+    color: string;
+    visible: boolean;
+    osmId: string;
+}
+export interface LinestringProps {
+    pointIds: string[];
+    color: string;
+    strokeWidth: number;
+    opacity?: number | null;
+    attributes: {
+        type: string;
+        subtype: string;
+    };
+    osmId: string;
+    isPath?: boolean;
+    arrowHead?: string | null;
+    arrowHeadSize?: number | null;
+    smooth?: boolean | null;
+    segments?: Record<string, {
+        color?: string;
+        strokeWidth?: number;
+        opacity?: number;
+    }> | null;
+}
+export interface LaneProps {
+    leftBoundaryId: string | null;
+    rightBoundaryId: string | null;
+    invertLeft: boolean;
+    invertRight: boolean;
+    color: string;
+    opacity?: number | null;
+    smooth?: boolean | null;
+    size: string;
+    attributes: {
+        type: string;
+        subtype: string;
+        speed_limit?: string;
+    };
+    next: string[];
+    prev: string[];
+    osmId: string;
+}
+export interface VehicleProps {
+    w: number;
+    h: number;
+    color: string;
+    size: string;
+    opacity?: number | null;
+    attributes: {
+        type: 'vehicle';
+        subtype: string;
+    };
+    osmId: string;
+    templateId: string;
+}
+export interface PedestrianProps {
+    w: number;
+    h: number;
+    color: string;
+    size: string;
+    opacity?: number | null;
+    attributes: {
+        type: 'pedestrian';
+        subtype: string;
+    };
+    osmId: string;
+    templateId: string;
+}
+export interface RectangleProps {
+    w: number;
+    h: number;
+    color: string;
+    fill: string;
+    strokeWidth: number;
+    opacity?: number | null;
+}
+export interface EllipseProps {
+    w: number;
+    h: number;
+    color: string;
+    fill: string;
+    strokeWidth: number;
+    opacity?: number | null;
+}
+export interface ArrowProps {
+    w: number;
+    h: number;
+    color: string;
+    fill: string;
+    strokeWidth: number;
+    opacity?: number | null;
+    direction: string;
+    headPosition: number;
+    bodyThickness: number;
+}
+export interface TextProps {
+    w: number;
+    h: number;
+    text: string;
+    color: string;
+    fontSize: number;
+    font: string;
+    textAlign: 'left' | 'center' | 'right';
+    autoSize: boolean;
+}
+export interface PolygonProps {
+    pointIds: string[];
+    color: string;
+    strokeWidth: number;
+    fillOpacity?: number | null;
+    attributes: Record<string, unknown>;
+    osmId: string;
+    smooth?: boolean | null;
+    segments?: Record<string, {
+        color?: string;
+        strokeWidth?: number;
+        opacity?: number;
+    }> | null;
+}
+export interface TrafficLightProps {
+    w: number;
+    h: number;
+    color: string;
+    attributes: {
+        type: 'traffic_light';
+        subtype?: string;
+    };
+    osmId: string;
+}
+export interface CrosswalkProps {
+    pointIds: string[];
+    color: string;
+    stripeWidth?: number;
+    stripeGap?: number;
+    attributes: {
+        type: 'crosswalk';
+        subtype?: string;
+    };
+    osmId: string;
+}
+export interface FreehandProps {
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    color: string;
+    strokeWidth: number;
+    opacity?: number | null;
+    isComplete: boolean;
+}
+export interface DrawtonomySnapshot {
+    version: string;
+    timestamp: string;
+    shapes: BaseShape[];
+    camera?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export type ExtensionCapability = 'shapes:write' | 'shapes:read' | 'snapshot:read' | 'viewport:read' | 'selection:read' | 'ui:panel' | 'ui:notify';
+export interface ExtensionManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author: {
+        name: string;
+        url?: string;
+    };
+    entry: string;
+    icon?: string;
+    capabilities: ExtensionCapability[];
+    minHostVersion?: string;
+}
+export interface ShapeFilter {
+    types?: string[];
+    ids?: string[];
+    selectedOnly?: boolean;
+}
+export interface ShapeUpdate {
+    id: string;
+    props: Record<string, unknown>;
+}
+export interface InitPayload {
+    hostVersion: string;
+    grantedCapabilities: ExtensionCapability[];
+    viewport: {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,4 @@
+// Public SDK Type Definitions
+// These types are intended for extension developers
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,oDAAoD"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@drawtonomy/sdk",
+  "version": "0.1.0",
+  "description": "SDK for building Drawtonomy extensions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "drawtonomy",
+    "extension",
+    "sdk",
+    "traffic",
+    "drawing"
+  ],
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}