@dxos/plugin-illustrator 0.10.0

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/PLUGIN.mdl

@@ -0,0 +1,55 @@
+---
+id: org.dxos.plugin.illustrator
+name: IllustratorPlugin
+version: 0.1.0
+---
+
+A headless diagramming host plugin for `DXOS` Composer. Owns the base `Sketch` ECHO type, the
+renderer-neutral scene DSL and dialect registry, and the agent-facing sketch skill/operations.
+Canvas renderers (e.g. plugin-tldraw, plugin-excalidraw) contribute a `SketchVariant` capability
+supplying their canvas schema, a builder that maps the scene DSL onto their records, and surface
+components; plugin-illustrator resolves the variant at runtime and delegates.
+
+## Extensions
+
+The following extension dialects are used in this document.
+Each extension is defined in the Appendix or resolved via its URI.
+
+| Term        | URI                            |
+|-------------|--------------------------------|
+| `type`      | `org.dxos.mdl.type@1.0`        |
+| `feat`      | `org.dxos.mdl.feat@1.0`        |
+| `test`      | `org.dxos.mdl.test@1.0`        |
+| `component` | `org.dxos.mdl.component@1.0`   |
+| `op`        | `org.dxos.mdl.op@1.0`          |
+
+## Types
+
+```mdl
+type Sketch
+  desc: Named handle around a renderer-specific canvas object.
+  fields:
+    name?: string
+    canvas: Ref<Unknown>   # reference to the renderer-specific canvas (e.g. Tldraw.Canvas)
+```
+
+## Capabilities
+
+```mdl
+component VariantProvider
+  desc: Contributed by renderer plugins; supplies the canvas type, a scene-DSL builder
+        (read/apply), a create factory, and Article/Card surface components.
+```
+
+## Operations
+
+```mdl
+op create
+  desc: Creates a Sketch with an empty canvas for the requested (or default) variant.
+
+op read
+  desc: Returns the current scene of a sketch as world objects with object-local coordinates.
+
+op edit
+  desc: Applies scene commands to a sketch via the variant's builder; returns the resulting scene.
+```

package/dist/lib/IllustratorPlugin.mjs

@@ -0,0 +1,18 @@
+import { Plugin } from "@dxos/app-framework";
+import { Sketch } from "#types";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { CommentConfig, CreateObject, OperationHandler, ReactSurface, SkillDefinition } from "#capabilities";
+import { translations } from "#translations";
+//#endregion
+//#region src/IllustratorPlugin.tsx
+var IllustratorPlugin = Plugin.define(meta).pipe(AppPlugin.addCommentConfigModule({ activate: CommentConfig }), AppPlugin.addCreateObjectModule({ activate: CreateObject }), AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }), AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addSurfaceModule({ activate: ReactSurface }), AppPlugin.addTranslationsModule({ translations }), AppPlugin.addPluginAssetModule({ asset: {
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: "---\nid: org.dxos.plugin.illustrator\nname: IllustratorPlugin\nversion: 0.1.0\n---\n\nA headless diagramming host plugin for `DXOS` Composer. Owns the base `Sketch` ECHO type, the\nrenderer-neutral scene DSL and dialect registry, and the agent-facing sketch skill/operations.\nCanvas renderers (e.g. plugin-tldraw, plugin-excalidraw) contribute a `SketchVariant` capability\nsupplying their canvas schema, a builder that maps the scene DSL onto their records, and surface\ncomponents; plugin-illustrator resolves the variant at runtime and delegates.\n\n## Extensions\n\nThe following extension dialects are used in this document.\nEach extension is defined in the Appendix or resolved via its URI.\n\n| Term        | URI                            |\n|-------------|--------------------------------|\n| `type`      | `org.dxos.mdl.type@1.0`        |\n| `feat`      | `org.dxos.mdl.feat@1.0`        |\n| `test`      | `org.dxos.mdl.test@1.0`        |\n| `component` | `org.dxos.mdl.component@1.0`   |\n| `op`        | `org.dxos.mdl.op@1.0`          |\n\n## Types\n\n```mdl\ntype Sketch\n  desc: Named handle around a renderer-specific canvas object.\n  fields:\n    name?: string\n    canvas: Ref<Unknown>   # reference to the renderer-specific canvas (e.g. Tldraw.Canvas)\n```\n\n## Capabilities\n\n```mdl\ncomponent VariantProvider\n  desc: Contributed by renderer plugins; supplies the canvas type, a scene-DSL builder\n        (read/apply), a create factory, and Article/Card surface components.\n```\n\n## Operations\n\n```mdl\nop create\n  desc: Creates a Sketch with an empty canvas for the requested (or default) variant.\n\nop read\n  desc: Returns the current scene of a sketch as world objects with object-local coordinates.\n\nop edit\n  desc: Applies scene commands to a sketch via the variant's builder; returns the resulting scene.\n```\n",
+	mimeType: "application/x-mdl"
+} }), Plugin.make);
+//#endregion
+export { IllustratorPlugin, IllustratorPlugin as default };
+
+//# sourceMappingURL=IllustratorPlugin.mjs.map

package/dist/lib/IllustratorPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllustratorPlugin.mjs","names":[],"sources":["../../src/IllustratorPlugin.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { CommentConfig, CreateObject, OperationHandler, ReactSurface, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Sketch } from '#types';\n\n// eslint-disable-next-line import/no-relative-packages\nimport pluginSpec from '../PLUGIN.mdl?raw';\n\nexport const IllustratorPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addCommentConfigModule({ activate: CommentConfig }),\n  AppPlugin.addCreateObjectModule({ activate: CreateObject }),\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }),\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addSurfaceModule({ activate: ReactSurface }),\n  AppPlugin.addTranslationsModule({ translations }),\n  AppPlugin.addPluginAssetModule({\n    asset: { pluginId: meta.profile.key, path: 'PLUGIN.mdl', content: pluginSpec, mimeType: 'application/x-mdl' },\n  }),\n  Plugin.make,\n);\n\nexport default IllustratorPlugin;\n"],"mappings":";;;;;;;;AAeA,IAAa,oBAAoB,OAAO,OAAO,IAAI,CAAC,CAAC,KACnD,UAAU,uBAAuB,EAAE,UAAU,cAAc,CAAC,GAC5D,UAAU,sBAAsB,EAAE,UAAU,aAAa,CAAC,GAC1D,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ,CAAC,OAAO,MAAM,EAAE,CAAC,GACrD,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,iBAAiB,EAAE,UAAU,aAAa,CAAC,GACrD,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,UAAU,qBAAqB,EAC7B,OAAO;CAAE,UAAU,KAAK,QAAQ;CAAK,MAAM;CAAc,SAAS;CAAY,UAAU;AAAoB,EAC9G,CAAC,GACD,OAAO,IACT"}

package/dist/lib/IllustratorPlugin.node.mjs

@@ -0,0 +1,18 @@
+import { Plugin } from "@dxos/app-framework";
+import { Sketch } from "#types";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+import { OperationHandler, SkillDefinition } from "#capabilities";
+import { translations } from "#translations";
+//#region src/IllustratorPlugin.node.tsx
+/**
+* Headless variant of IllustratorPlugin (no React surfaces / CreateObject panel).
+* Used in node contexts (CLI, agents, tests) where rendering is unavailable —
+* the full variant lazy-loads `CreateSketchPanel` from `react-ui-search` which
+* downstream bundlers don't resolve cleanly under nested pnpm symlinks.
+*/
+var IllustratorPlugin = Plugin.define(meta).pipe(AppPlugin.addOperationHandlerModule({ activate: OperationHandler }), AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }), AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }), AppPlugin.addTranslationsModule({ translations }), Plugin.make);
+//#endregion
+export { IllustratorPlugin, IllustratorPlugin as default };
+
+//# sourceMappingURL=IllustratorPlugin.node.mjs.map

package/dist/lib/IllustratorPlugin.node.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllustratorPlugin.node.mjs","names":[],"sources":["../../src/IllustratorPlugin.node.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { OperationHandler, SkillDefinition } from '#capabilities';\nimport { meta } from '#meta';\nimport { translations } from '#translations';\nimport { Sketch } from '#types';\n\n/**\n * Headless variant of IllustratorPlugin (no React surfaces / CreateObject panel).\n * Used in node contexts (CLI, agents, tests) where rendering is unavailable —\n * the full variant lazy-loads `CreateSketchPanel` from `react-ui-search` which\n * downstream bundlers don't resolve cleanly under nested pnpm symlinks.\n */\nexport const IllustratorPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addOperationHandlerModule({ activate: OperationHandler }),\n  AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }),\n  AppPlugin.addSkillDefinitionModule({ activate: SkillDefinition }),\n  AppPlugin.addTranslationsModule({ translations }),\n  Plugin.make,\n);\n\nexport default IllustratorPlugin;\n"],"mappings":";;;;;;;;;;;;;AAkBA,IAAa,oBAAoB,OAAO,OAAO,IAAI,CAAC,CAAC,KACnD,UAAU,0BAA0B,EAAE,UAAU,iBAAiB,CAAC,GAClE,UAAU,gBAAgB,EAAE,QAAQ,CAAC,OAAO,MAAM,EAAE,CAAC,GACrD,UAAU,yBAAyB,EAAE,UAAU,gBAAgB,CAAC,GAChE,UAAU,sBAAsB,EAAE,aAAa,CAAC,GAChD,OAAO,IACT"}

package/dist/lib/IllustratorPlugin.workerd.mjs

@@ -0,0 +1,10 @@
+import { Plugin } from "@dxos/app-framework";
+import { Sketch } from "#types";
+import { meta } from "#meta";
+import { AppPlugin } from "@dxos/app-toolkit";
+//#region src/IllustratorPlugin.workerd.tsx
+var IllustratorPlugin = Plugin.define(meta).pipe(AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }), Plugin.make);
+//#endregion
+export { IllustratorPlugin, IllustratorPlugin as default };
+
+//# sourceMappingURL=IllustratorPlugin.workerd.mjs.map

package/dist/lib/IllustratorPlugin.workerd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllustratorPlugin.workerd.mjs","names":[],"sources":["../../src/IllustratorPlugin.workerd.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\nimport { AppPlugin } from '@dxos/app-toolkit';\n\nimport { meta } from '#meta';\nimport { Sketch } from '#types';\n\nexport const IllustratorPlugin = Plugin.define(meta).pipe(\n  AppPlugin.addSchemaModule({ schema: [Sketch.Sketch] }),\n  Plugin.make,\n);\n\nexport default IllustratorPlugin;\n"],"mappings":";;;;;AAUA,IAAa,oBAAoB,OAAO,OAAO,IAAI,CAAC,CAAC,KACnD,UAAU,gBAAgB,EAAE,QAAQ,CAAC,OAAO,MAAM,EAAE,CAAC,GACrD,OAAO,IACT"}

package/dist/lib/capabilities.mjs

@@ -0,0 +1,11 @@
+import { Capability } from "@dxos/app-framework";
+//#region src/capabilities/index.ts
+var CommentConfig = Capability.lazy("CommentConfig", () => import("./chunk-comment-config.mjs"));
+var CreateObject = Capability.lazy("CreateObject", () => import("./chunk-create-object.mjs"));
+var OperationHandler = Capability.lazy("OperationHandler", () => import("./chunk-operation-handler.mjs"));
+var ReactSurface = Capability.lazy("ReactSurface", () => import("./chunk-react-surface.mjs"));
+var SkillDefinition = Capability.lazy("SkillDefinition", () => import("./chunk-skill-definition.mjs"));
+//#endregion
+export { CommentConfig, CreateObject, OperationHandler, ReactSurface, SkillDefinition };
+
+//# sourceMappingURL=capabilities.mjs.map

package/dist/lib/capabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.mjs","names":[],"sources":["../../src/capabilities/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Capability } from '@dxos/app-framework';\nimport { OperationHandlerSet } from '@dxos/compute';\n\nexport const CommentConfig = Capability.lazy('CommentConfig', () => import('./comment-config'));\nexport const CreateObject = Capability.lazy('CreateObject', () => import('./create-object'));\nexport const OperationHandler = Capability.lazy<OperationHandlerSet.OperationHandlerSet>(\n  'OperationHandler',\n  () => import('./operation-handler'),\n);\nexport const ReactSurface = Capability.lazy('ReactSurface', () => import('./react-surface'));\nexport const SkillDefinition = Capability.lazy('SkillDefinition', () => import('./skill-definition'));\n"],"mappings":";;AAOA,IAAa,gBAAgB,WAAW,KAAK,uBAAuB,OAAO,6BAAmB;AAC9F,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,mBAAmB,WAAW,KACzC,0BACM,OAAO,gCACf;AACA,IAAa,eAAe,WAAW,KAAK,sBAAsB,OAAO,4BAAkB;AAC3F,IAAa,kBAAkB,WAAW,KAAK,yBAAyB,OAAO,+BAAqB"}

package/dist/lib/chunk-IllustratorCapabilities.mjs

@@ -0,0 +1,16 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Capability } from "@dxos/app-framework";
+import { meta } from "#meta";
+//#region src/types/IllustratorCapabilities.ts
+var IllustratorCapabilities_exports = /* @__PURE__ */ __exportAll({ VariantProvider: () => VariantProvider });
+/**
+* A sketch variant contribution. Each renderer plugin (tldraw, excalidraw, ...)
+* contributes one of these via `Capability.contributes(IllustratorCapabilities.VariantProvider, variant)`.
+* Consumers iterate via `Capability.getAll(IllustratorCapabilities.VariantProvider)` (Effect) or
+* `useCapabilities(IllustratorCapabilities.VariantProvider)` (React).
+*/
+var VariantProvider = Capability.make(`${meta.profile.key}.capability.variant`);
+//#endregion
+export { VariantProvider as n, IllustratorCapabilities_exports as t };
+
+//# sourceMappingURL=chunk-IllustratorCapabilities.mjs.map

package/dist/lib/chunk-IllustratorCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-IllustratorCapabilities.mjs","names":[],"sources":["../../src/types/IllustratorCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { Capability } from '@dxos/app-framework';\n\nimport { meta } from '#meta';\n\nimport type { SketchVariant } from './types';\n\n/**\n * A sketch variant contribution. Each renderer plugin (tldraw, excalidraw, ...)\n * contributes one of these via `Capability.contributes(IllustratorCapabilities.VariantProvider, variant)`.\n * Consumers iterate via `Capability.getAll(IllustratorCapabilities.VariantProvider)` (Effect) or\n * `useCapabilities(IllustratorCapabilities.VariantProvider)` (React).\n */\nexport const VariantProvider = Capability.make<SketchVariant>(`${meta.profile.key}.capability.variant`);\n"],"mappings":";;;;;;;;;;;AAkBA,IAAa,kBAAkB,WAAW,KAAoB,GAAG,KAAK,QAAQ,IAAI,oBAAoB"}

package/dist/lib/chunk-comment-config.mjs

@@ -0,0 +1,16 @@
+import { Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { Sketch } from "#types";
+import { Type } from "@dxos/echo";
+import { AppCapabilities } from "@dxos/app-toolkit";
+//#region src/capabilities/comment-config.ts
+var activate = Effect.fnUntraced(function* () {
+	return Capability.contributes(AppCapabilities.CommentConfig, {
+		id: Type.getTypename(Sketch.Sketch),
+		comments: "unanchored"
+	});
+});
+//#endregion
+export { activate as default };
+
+//# sourceMappingURL=chunk-comment-config.mjs.map

package/dist/lib/chunk-comment-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-comment-config.mjs","names":[],"sources":["../../src/capabilities/comment-config.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { AppCapabilities } from '@dxos/app-toolkit';\nimport { Type } from '@dxos/echo';\n\nimport { Sketch } from '#types';\n\nconst activate = Effect.fnUntraced(function* () {\n  return Capability.contributes(AppCapabilities.CommentConfig, {\n    id: Type.getTypename(Sketch.Sketch),\n    comments: 'unanchored',\n  });\n});\n\nexport default activate;\n"],"mappings":";;;;;;AAYA,IAAM,WAAW,OAAO,WAAW,aAAa;CAC9C,OAAO,WAAW,YAAY,gBAAgB,eAAe;EAC3D,IAAI,KAAK,YAAY,OAAO,MAAM;EAClC,UAAU;CACZ,CAAC;AACH,CAAC"}

package/dist/lib/chunk-create-object.mjs

@@ -0,0 +1,46 @@
+import { n as VariantProvider } from "./chunk-IllustratorCapabilities.mjs";
+import { a as Sketch, s as make } from "./chunk-types.mjs";
+import { Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { invariant } from "@dxos/invariant";
+import { Operation } from "@dxos/compute";
+import { Database, Type } from "@dxos/echo";
+import { SpaceCapabilities, SpaceOperation } from "@dxos/plugin-space";
+import { CreateSketchPanel } from "#components";
+//#region src/capabilities/create-object.ts
+var __dxlog_file = "/Users/burdon/Code/dxos/dxos/.claude/worktrees/peaceful-allen-9b542f/packages/plugins/plugin-illustrator/src/capabilities/create-object.ts";
+var create_object_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {
+		id: Type.getTypename(Sketch),
+		customPanel: CreateSketchPanel,
+		createObject: ({ variantId, input }, options) => Effect.gen(function* () {
+			const variant = (yield* Capability.getAll(VariantProvider)).find((entry) => entry.id === variantId);
+			invariant(variant, `Unknown sketch variant: ${variantId}`, {
+				"~LogMeta": "~LogMeta",
+				F: __dxlog_file,
+				L: 31,
+				S: this,
+				A: ["variant", "`Unknown sketch variant: ${variantId}`"]
+			});
+			const canvas = yield* variant.createCanvas(input ?? {}).pipe(Effect.provideService(Database.Service, Database.makeService(options.db)));
+			yield* Operation.invoke(SpaceOperation.AddObject, {
+				object: canvas,
+				target: options.target,
+				targetNodeId: options.targetNodeId
+			});
+			const sketch = make({
+				name: typeof input?.name === "string" ? input.name : void 0,
+				canvas
+			});
+			return yield* Operation.invoke(SpaceOperation.AddObject, {
+				object: sketch,
+				target: options.target,
+				targetNodeId: options.targetNodeId
+			}).pipe(Effect.tapError(() => Operation.invoke(SpaceOperation.RemoveObjects, { objects: [canvas] }).pipe(Effect.ignore)));
+		})
+	});
+}));
+//#endregion
+export { create_object_default as default };
+
+//# sourceMappingURL=chunk-create-object.mjs.map

package/dist/lib/chunk-create-object.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-create-object.mjs","names":[],"sources":["../../src/capabilities/create-object.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\nimport { Database, Type } from '@dxos/echo';\nimport { invariant } from '@dxos/invariant';\nimport { SpaceCapabilities, SpaceOperation } from '@dxos/plugin-space';\n\nimport { CreateSketchPanel } from '#components';\n\nimport { IllustratorCapabilities, Sketch } from '../types';\n\ntype CreateOptions = Parameters<SpaceCapabilities.CreateObjectEntry['createObject']>[1];\n\nexport default Capability.makeModule(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(SpaceCapabilities.CreateObjectEntry, {\n      id: Type.getTypename(Sketch.Sketch),\n      customPanel: CreateSketchPanel,\n      createObject: (\n        { variantId, input }: { variantId: string; input?: Record<string, any> },\n        options: CreateOptions,\n      ) =>\n        Effect.gen(function* () {\n          const variants = yield* Capability.getAll(IllustratorCapabilities.VariantProvider);\n          const variant = variants.find((entry) => entry.id === variantId);\n          invariant(variant, `Unknown sketch variant: ${variantId}`);\n\n          // Build the canvas object via the variant's factory.\n          const canvas = yield* variant\n            .createCanvas(input ?? {})\n            .pipe(Effect.provideService(Database.Service, Database.makeService(options.db)));\n\n          // Add the canvas to the database. Stays hidden — it's referenced by the Sketch and\n          // shouldn't appear as a top-level item in the user's space.\n          yield* Operation.invoke(SpaceOperation.AddObject, {\n            object: canvas,\n            target: options.target,\n            targetNodeId: options.targetNodeId,\n          });\n\n          const sketch = Sketch.make({\n            name: typeof input?.name === 'string' ? input.name : undefined,\n            canvas,\n          });\n\n          // Add the user-facing Sketch wrapper. Not hidden — this is the object the user sees\n          // and navigates to. If this second write fails, roll back the canvas so we don't\n          // leak an orphaned object into the space.\n          return yield* Operation.invoke(SpaceOperation.AddObject, {\n            object: sketch,\n            target: options.target,\n            targetNodeId: options.targetNodeId,\n          }).pipe(\n            Effect.tapError(() =>\n              Operation.invoke(SpaceOperation.RemoveObjects, { objects: [canvas] }).pipe(Effect.ignore),\n            ),\n          );\n        }),\n    });\n  }),\n);\n"],"mappings":";;;;;;;;;;;AAkBA,IAAA,wBAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,kBAAkB,mBAAmB;EACjE,IAAI,KAAK,YAAY,MAAa;EAClC,aAAa;EACb,eACE,EAAE,WAAW,SACb,YAEA,OAAO,IAAI,aAAa;GAEtB,MAAM,WAAU,OADQ,WAAW,OAAO,eAAuC,EAAA,CACxD,MAAM,UAAU,MAAM,OAAO,SAAS;GAC/D,UAAU,SAAS,2BAA2B,aAAU;IAAA,YAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA;IAAA,GAAA,CAAA,WAAA,wCAAA;GAAA,CAAC;GAGzD,MAAM,SAAS,OAAO,QACnB,aAAa,SAAS,CAAC,CAAC,CAAA,CACxB,KAAK,OAAO,eAAe,SAAS,SAAS,SAAS,YAAY,QAAQ,EAAE,CAAC,CAAC;GAIjF,OAAO,UAAU,OAAO,eAAe,WAAW;IAChD,QAAQ;IACR,QAAQ,QAAQ;IAChB,cAAc,QAAQ;GACxB,CAAC;GAED,MAAM,SAAS,KAAY;IACzB,MAAM,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO,KAAA;IACrD;GACF,CAAC;GAKD,OAAO,OAAO,UAAU,OAAO,eAAe,WAAW;IACvD,QAAQ;IACR,QAAQ,QAAQ;IAChB,cAAc,QAAQ;GACxB,CAAC,CAAC,CAAC,KACD,OAAO,eACL,UAAU,OAAO,eAAe,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,MAAM,CAC1F,CACF;EACF,CAAC;CACL,CAAC;AACH,CAAC,CACH"}

package/dist/lib/chunk-create.mjs

@@ -0,0 +1,20 @@
+import { n as VariantProvider } from "./chunk-IllustratorCapabilities.mjs";
+import { s as make, t as Create } from "./chunk-types.mjs";
+import { n as UnknownSketchVariantError } from "./chunk-load-sketch.mjs";
+import { Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { Operation } from "@dxos/compute";
+//#region src/operations/create.ts
+var handler = Create.pipe(Operation.withHandler(Effect.fn(function* ({ name, variant: variantId }) {
+	const variants = yield* Capability.getAll(VariantProvider);
+	const variant = variantId ? variants.find((entry) => entry.id === variantId) : variants[0];
+	if (!variant) return yield* Effect.fail(new UnknownSketchVariantError(variantId ?? "(none registered)"));
+	return { object: make({
+		name,
+		canvas: yield* variant.createCanvas()
+	}) };
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-create.mjs.map

package/dist/lib/chunk-create.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-create.mjs","names":[],"sources":["../../src/operations/create.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\n\nimport { IllustratorCapabilities, Sketch, SketchOperation } from '../types';\nimport { UnknownSketchVariantError } from '../util/load-sketch';\n\nconst handler: Operation.WithHandler<typeof SketchOperation.Create> = SketchOperation.Create.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ name, variant: variantId }) {\n      const variants = yield* Capability.getAll(IllustratorCapabilities.VariantProvider);\n      const variant = variantId ? variants.find((entry) => entry.id === variantId) : variants[0];\n      if (!variant) {\n        return yield* Effect.fail(new UnknownSketchVariantError(variantId ?? '(none registered)'));\n      }\n      const canvas = yield* variant.createCanvas();\n      return { object: Sketch.make({ name, canvas }) };\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;;;AAYA,IAAM,UAAA,OAAuF,KAC3F,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,MAAM,SAAS,aAAa;CACjD,MAAM,WAAW,OAAO,WAAW,OAAO,eAAuC;CACjF,MAAM,UAAU,YAAY,SAAS,MAAM,UAAU,MAAM,OAAO,SAAS,IAAI,SAAS;CACxF,IAAI,CAAC,SACH,OAAO,OAAO,OAAO,KAAK,IAAI,0BAA0B,aAAa,mBAAmB,CAAC;CAG3F,OAAO,EAAE,QAAQ,KAAY;EAAE;EAAM,eADf,QAAQ,aAAa;CACC,CAAC,EAAE;AACjD,CAAC,CACH,CACF"}

package/dist/lib/chunk-edit.mjs

@@ -0,0 +1,20 @@
+import { n as Edit } from "./chunk-types.mjs";
+import { i as resolveVariant } from "./chunk-load-sketch.mjs";
+import * as Effect from "effect/Effect";
+import { Operation } from "@dxos/compute";
+//#region src/operations/edit.ts
+var handler = Edit.pipe(Operation.withHandler(Effect.fn(function* ({ sketch, commands }) {
+	const { canvas, variant } = yield* resolveVariant(sketch);
+	const { upserted, removed } = variant.builder.apply(canvas, commands);
+	const { scene, unmanaged } = variant.builder.read(canvas);
+	return {
+		scene,
+		unmanaged,
+		upserted,
+		removed
+	};
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-edit.mjs.map

package/dist/lib/chunk-edit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-edit.mjs","names":[],"sources":["../../src/operations/edit.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Operation } from '@dxos/compute';\n\nimport { SketchOperation } from '../types';\nimport { resolveVariant } from '../util/load-sketch';\n\nconst handler: Operation.WithHandler<typeof SketchOperation.Edit> = SketchOperation.Edit.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ sketch, commands }) {\n      const { canvas, variant } = yield* resolveVariant(sketch);\n      const { upserted, removed } = variant.builder.apply(canvas, commands);\n      const { scene, unmanaged } = variant.builder.read(canvas);\n      return { scene, unmanaged, upserted, removed };\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;AAWA,IAAM,UAAA,KAAmF,KACvF,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,QAAQ,YAAY;CACzC,MAAM,EAAE,QAAQ,YAAY,OAAO,eAAe,MAAM;CACxD,MAAM,EAAE,UAAU,YAAY,QAAQ,QAAQ,MAAM,QAAQ,QAAQ;CACpE,MAAM,EAAE,OAAO,cAAc,QAAQ,QAAQ,KAAK,MAAM;CACxD,OAAO;EAAE;EAAO;EAAW;EAAU;CAAQ;AAC/C,CAAC,CACH,CACF"}

package/dist/lib/chunk-load-sketch.mjs

@@ -0,0 +1,64 @@
+import { n as VariantProvider } from "./chunk-IllustratorCapabilities.mjs";
+import { Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { Database, Obj, Type } from "@dxos/echo";
+//#region src/util/load-sketch.ts
+var SketchVariantMismatchError = class extends Error {
+	sketchId;
+	expectedTypename;
+	actualTypename;
+	_tag = "SketchVariantMismatchError";
+	constructor(sketchId, expectedTypename, actualTypename) {
+		super(`Sketch ${sketchId} canvas typename mismatch: expected ${expectedTypename}, got ${actualTypename}.`);
+		this.sketchId = sketchId;
+		this.expectedTypename = expectedTypename;
+		this.actualTypename = actualTypename;
+	}
+};
+var UnknownSketchVariantError = class extends Error {
+	typename;
+	_tag = "UnknownSketchVariantError";
+	constructor(typename) {
+		super(`No sketch variant registered for canvas type: ${typename}.`);
+		this.typename = typename;
+	}
+};
+/**
+* Loads a Sketch from a Ref and resolves its canvas, asserting the canvas matches
+* the expected type. Returns the typed pair.
+*
+* Use in operation handlers that declare `input.sketch: SketchRef<MyCanvas>`.
+*/
+var loadSketch = (ref, canvasType) => Effect.gen(function* () {
+	const sketch = yield* Database.load(ref);
+	const canvas = yield* Database.load(sketch.canvas);
+	if (!Obj.instanceOf(canvasType, canvas)) {
+		const expected = Type.getTypename(canvasType) ?? "unknown";
+		const actual = Obj.getTypename(canvas) ?? "unknown";
+		return yield* Effect.fail(new SketchVariantMismatchError(sketch.id, expected, actual));
+	}
+	return {
+		sketch,
+		canvas
+	};
+});
+/**
+* Loads a Sketch and resolves the variant provider matching its canvas typename.
+* Used by the renderer-agnostic read/edit operations.
+*/
+var resolveVariant = (ref) => Effect.gen(function* () {
+	const sketch = yield* Database.load(ref);
+	const canvas = yield* Database.load(sketch.canvas);
+	const typename = Obj.getTypename(canvas) ?? "unknown";
+	const variant = (yield* Capability.getAll(VariantProvider)).find((entry) => entry.id === typename);
+	if (!variant) return yield* Effect.fail(new UnknownSketchVariantError(typename));
+	return {
+		sketch,
+		canvas,
+		variant
+	};
+});
+//#endregion
+export { resolveVariant as i, UnknownSketchVariantError as n, loadSketch as r, SketchVariantMismatchError as t };
+
+//# sourceMappingURL=chunk-load-sketch.mjs.map

package/dist/lib/chunk-load-sketch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-load-sketch.mjs","names":[],"sources":["../../src/util/load-sketch.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Database, Obj, type Ref, Type } from '@dxos/echo';\n\nimport * as IllustratorCapabilities from '../types/IllustratorCapabilities';\nimport * as Sketch from '../types/Sketch';\nimport { type SketchVariant } from '../types/types';\n\nexport class SketchVariantMismatchError extends Error {\n  readonly _tag = 'SketchVariantMismatchError';\n  constructor(\n    readonly sketchId: string,\n    readonly expectedTypename: string,\n    readonly actualTypename: string,\n  ) {\n    super(`Sketch ${sketchId} canvas typename mismatch: expected ${expectedTypename}, got ${actualTypename}.`);\n  }\n}\n\nexport class UnknownSketchVariantError extends Error {\n  readonly _tag = 'UnknownSketchVariantError';\n  constructor(readonly typename: string) {\n    super(`No sketch variant registered for canvas type: ${typename}.`);\n  }\n}\n\n/**\n * Loads a Sketch from a Ref and resolves its canvas, asserting the canvas matches\n * the expected type. Returns the typed pair.\n *\n * Use in operation handlers that declare `input.sketch: SketchRef<MyCanvas>`.\n */\nexport const loadSketch = <S extends Type.AnyObj>(\n  ref: Ref.Ref<Sketch.Sketch>,\n  canvasType: S,\n): Effect.Effect<{ sketch: Sketch.Sketch; canvas: Type.InstanceType<S> }, Error, Database.Service> =>\n  Effect.gen(function* () {\n    const sketch = yield* Database.load(ref);\n    const canvas = yield* Database.load(sketch.canvas);\n    if (!Obj.instanceOf(canvasType, canvas)) {\n      const expected = Type.getTypename(canvasType) ?? 'unknown';\n      const actual = Obj.getTypename(canvas as Obj.Any) ?? 'unknown';\n      return yield* Effect.fail(new SketchVariantMismatchError(sketch.id, expected, actual));\n    }\n    return { sketch, canvas: canvas as Type.InstanceType<S> };\n  });\n\n/**\n * Loads a Sketch and resolves the variant provider matching its canvas typename.\n * Used by the renderer-agnostic read/edit operations.\n */\nexport const resolveVariant = (\n  ref: Ref.Ref<Sketch.Sketch>,\n): Effect.Effect<\n  { sketch: Sketch.Sketch; canvas: Obj.Any; variant: SketchVariant },\n  Error,\n  Database.Service | Capability.Service\n> =>\n  Effect.gen(function* () {\n    const sketch = yield* Database.load(ref);\n    const canvas = (yield* Database.load(sketch.canvas)) as Obj.Any;\n    const typename = Obj.getTypename(canvas) ?? 'unknown';\n    const variants = yield* Capability.getAll(IllustratorCapabilities.VariantProvider);\n    const variant = variants.find((entry) => entry.id === typename);\n    if (!variant) {\n      return yield* Effect.fail(new UnknownSketchVariantError(typename));\n    }\n    return { sketch, canvas, variant };\n  });\n"],"mappings":";;;;;AAaA,IAAa,6BAAb,cAAgD,MAAM;CAGzC;CACA;CACA;CAJX,OAAgB;CAChB,YACE,UACA,kBACA,gBACA;EACA,MAAM,UAAU,SAAS,sCAAsC,iBAAiB,QAAQ,eAAe,EAAE;EAJhG,KAAA,WAAA;EACA,KAAA,mBAAA;EACA,KAAA,iBAAA;CAGX;AACF;AAEA,IAAa,4BAAb,cAA+C,MAAM;CAE9B;CADrB,OAAgB;CAChB,YAAY,UAA2B;EACrC,MAAM,iDAAiD,SAAS,EAAE;EAD/C,KAAA,WAAA;CAErB;AACF;;;;;;;AAQA,IAAa,cACX,KACA,eAEA,OAAO,IAAI,aAAa;CACtB,MAAM,SAAS,OAAO,SAAS,KAAK,GAAG;CACvC,MAAM,SAAS,OAAO,SAAS,KAAK,OAAO,MAAM;CACjD,IAAI,CAAC,IAAI,WAAW,YAAY,MAAM,GAAG;EACvC,MAAM,WAAW,KAAK,YAAY,UAAU,KAAK;EACjD,MAAM,SAAS,IAAI,YAAY,MAAiB,KAAK;EACrD,OAAO,OAAO,OAAO,KAAK,IAAI,2BAA2B,OAAO,IAAI,UAAU,MAAM,CAAC;CACvF;CACA,OAAO;EAAE;EAAgB;CAA+B;AAC1D,CAAC;;;;;AAMH,IAAa,kBACX,QAMA,OAAO,IAAI,aAAa;CACtB,MAAM,SAAS,OAAO,SAAS,KAAK,GAAG;CACvC,MAAM,SAAU,OAAO,SAAS,KAAK,OAAO,MAAM;CAClD,MAAM,WAAW,IAAI,YAAY,MAAM,KAAK;CAE5C,MAAM,WAAU,OADQ,WAAW,OAAO,eAAuC,EAAA,CACxD,MAAM,UAAU,MAAM,OAAO,QAAQ;CAC9D,IAAI,CAAC,SACH,OAAO,OAAO,OAAO,KAAK,IAAI,0BAA0B,QAAQ,CAAC;CAEnE,OAAO;EAAE;EAAQ;EAAQ;CAAQ;AACnC,CAAC"}

package/dist/lib/chunk-meta.mjs

@@ -0,0 +1,40 @@
+import { Plugin } from "@dxos/app-framework";
+import { Config2 } from "@dxos/app-framework/config";
+import { trim } from "@dxos/util";
+//#region dx.config.ts
+var dx_config_default = Config2.make({ plugin: {
+	key: "org.dxos.plugin.illustrator",
+	name: "Illustrator",
+	author: "DXOS",
+	description: trim`
+      Headless diagramming host plugin that provides shared infrastructure for local-first
+      drawing and diagramming inside DXOS Composer. The plugin owns the base \`Sketch\` ECHO
+      type — a named handle referencing a renderer-specific canvas object — together with the
+      renderer-neutral scene DSL, the diagram dialect registry, and the agent-facing sketch
+      skill and operations (create, read, edit).
+
+      Canvas renderers (tldraw, excalidraw, and others) are contributed by separate plugins
+      via the \`IllustratorCapabilities.VariantProvider\` capability. Each variant supplies its
+      own canvas schema, a builder that maps the scene DSL onto its records, and surface
+      components (Article and Card). Plugin-illustrator resolves the correct variant at
+      runtime and delegates rendering and DSL compilation, keeping the host layer fully
+      decoupled from renderer internals.
+
+      Canvas objects are stored as hidden ECHO objects alongside the top-level \`Sketch\`,
+      ensuring they replicate to all peers but do not appear as independent items in the
+      user's space graph.
+    `,
+	source: "https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-illustrator",
+	icon: {
+		key: "ph--compass-tool--regular",
+		hue: "indigo"
+	},
+	spec: "PLUGIN.mdl"
+} });
+//#endregion
+//#region src/meta.ts
+var meta = Plugin.getMetaFromConfig(dx_config_default);
+//#endregion
+export { meta as t };
+
+//# sourceMappingURL=chunk-meta.mjs.map

package/dist/lib/chunk-meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-meta.mjs","names":[],"sources":["../../dx.config.ts","../../src/meta.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Config2 } from '@dxos/app-framework/config';\nimport { trim } from '@dxos/util';\n\nexport default Config2.make({\n  plugin: {\n    key: 'org.dxos.plugin.illustrator',\n    name: 'Illustrator',\n    author: 'DXOS',\n    description: trim`\n      Headless diagramming host plugin that provides shared infrastructure for local-first\n      drawing and diagramming inside DXOS Composer. The plugin owns the base \\`Sketch\\` ECHO\n      type — a named handle referencing a renderer-specific canvas object — together with the\n      renderer-neutral scene DSL, the diagram dialect registry, and the agent-facing sketch\n      skill and operations (create, read, edit).\n\n      Canvas renderers (tldraw, excalidraw, and others) are contributed by separate plugins\n      via the \\`IllustratorCapabilities.VariantProvider\\` capability. Each variant supplies its\n      own canvas schema, a builder that maps the scene DSL onto its records, and surface\n      components (Article and Card). Plugin-illustrator resolves the correct variant at\n      runtime and delegates rendering and DSL compilation, keeping the host layer fully\n      decoupled from renderer internals.\n\n      Canvas objects are stored as hidden ECHO objects alongside the top-level \\`Sketch\\`,\n      ensuring they replicate to all peers but do not appear as independent items in the\n      user's space graph.\n    `,\n    source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-illustrator',\n    icon: { key: 'ph--compass-tool--regular', hue: 'indigo' },\n    spec: 'PLUGIN.mdl',\n  },\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport { Plugin } from '@dxos/app-framework';\n\nimport config from '../dx.config';\n\nexport const meta = Plugin.getMetaFromConfig(config);\n"],"mappings":";;;;AAOA,IAAA,oBAAe,QAAQ,KAAK,EAC1B,QAAQ;CACN,KAAK;CACL,MAAM;CACN,QAAQ;CACR,aAAa,IAAI;;;;;;;;;;;;;;;;;;CAkBjB,QAAQ;CACR,MAAM;EAAE,KAAK;EAA6B,KAAK;CAAS;CACxD,MAAM;AACR,EACF,CAAC;;;AC1BD,IAAa,OAAO,OAAO,kBAAkB,iBAAM"}