@dxos/plugin-illustrator 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/PLUGIN.mdl

@@ -19,9 +19,10 @@ Each extension is defined in the Appendix or resolved via its URI.
 |-------------|--------------------------------|
 | `type`      | `org.dxos.mdl.type@1.0`        |
 | `feat`      | `org.dxos.mdl.feat@1.0`        |
-| `test`      | `org.dxos.mdl.test@1.0`        |
+| `scenario`  | `org.dxos.mdl.scenario@1.0`    |
 | `component` | `org.dxos.mdl.component@1.0`   |
-| `op`        | `org.dxos.mdl.op@1.0`          |
+| `op`        | `org.dxos.mdl.op@1.1`          |
+| `test`      | `org.dxos.mdl.test@1.0`        |
 
 ## Types
 
@@ -45,22 +46,26 @@ component VariantProvider
 
 ```mdl
 op create
+  key: org.dxos.operation.illustrator.create
   desc: Creates a Sketch with an empty canvas for the requested (or default) variant.
 
 op read
+  key: org.dxos.operation.illustrator.read
   desc: Returns the current scene of a sketch as world objects with object-local coordinates.
 
 op edit
+  key: org.dxos.operation.illustrator.edit
   desc: Applies scene commands to a sketch via the variant's builder; returns the resulting scene.
 
 op generate
+  key: org.dxos.operation.illustrator.generate
   desc: Replaces a sketch with a diagram compiled from mermaid source (flowchart or classDiagram);
         the dialect owns the layout, so no coordinates are supplied.
 ```
 
 ## Dialects
 
-Higher-level diagram languages compile to scene commands (see `src/model/dialect.ts`); each
+Higher-level diagram languages compile to scene commands (see `@dxos/diagram`, `packages/common/diagram/src/dialect.ts`); each
 dialect owns its layout, so its output lands as ordinary world objects that stay editable by id.
 
 ```mdl
@@ -101,3 +106,91 @@ component UmlSkill
         the agent extracts the class model, emits a mermaid classDiagram, and the generate
         operation compiles and lays it out.
 ```
+
+## QA
+
+Executable tests. Each step carries a human instruction (`do`) and, where the step maps to an
+invocable operation, an agent binding (`invoke`). Report failures by test and step number.
+
+```mdl
+test QA-1: Create, edit, and read back a drawing
+  desc: |
+    The scene-DSL round-trip through the SVG variant (owned by this plugin, so no renderer plugin
+    dependency is needed). Note: the source's runtime ECHO type is `Drawing`, not the `Sketch`
+    type documented above — this test uses the real name.
+  actors: agent
+  covers: []
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, to create into
+    - no drawing named "QA Sketch" exists — ABORT rather than deleting one this test did not create
+  steps:
+    - name: Create the drawing
+      do: In the navtree, click + on a collection and choose Drawing (or ask the assistant to create one). Name it "QA Sketch".
+      invoke: [op:create] { name: "QA Sketch", variant: "svg" }
+      capture: created
+      expect: a Drawing named "QA Sketch" exists with an empty SVG canvas
+      assert: return !!$created.object
+    - name: Place it in the collection
+      do: (no separate gesture — the navtree create action places it for you)
+      invoke: org.dxos.operation.space.addObject { object: $created.object, target: $given.collection }
+      expect: "QA Sketch" appears as a row under the collection
+    - name: Edit the scene
+      do: Ask the assistant to draw a rectangle labeled "Start" at the origin.
+      invoke: [op:edit] { drawing: $created.object, commands: [{ _tag: "upsert", id: "start", shape: { _tag: "rect", label: "Start", x: 0, y: 0, width: 120, height: 60 } }] }
+      capture: edited
+      expect: a rectangle labeled "Start" renders on the canvas
+      assert: return $edited.upserted.includes('start')
+    - name: Read the scene back
+      do: (no separate gesture — the canvas already shows the result of the edit)
+      invoke: [op:read] { drawing: $created.object }
+      expect: the returned scene's world objects include the "start" shape with the coordinates just written
+      assert: return $result.scene.objects?.some((o) => o.id === 'start')
+  after:
+    - name: Delete the drawing
+      do: Right-click "QA Sketch" in the navtree and choose Delete.
+      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.collection }
+      expect: the row leaves the navtree and its plank closes if it was open
+```
+
+```mdl
+test QA-2: Generate a UML class diagram from mermaid source
+  desc: The UmlSkill path — replace a drawing's contents with a class diagram compiled from mermaid source, with layout owned by the dialect.
+  actors: agent
+  covers: []
+  status: unverified
+  given:
+    - an identity exists
+    - space: a space is open
+    - collection: a collection in that space, to create into
+    - no drawing named "QA UML" exists — ABORT rather than deleting one this test did not create
+  steps:
+    - name: Create the drawing
+      do: Ask the assistant to create a new drawing named "QA UML".
+      invoke: [op:create] { name: "QA UML", variant: "svg" }
+      capture: created
+      expect: an empty Drawing named "QA UML" exists
+      assert: return !!$created.object
+    - name: Place it in the collection
+      do: (no separate gesture)
+      invoke: org.dxos.operation.space.addObject { object: $created.object, target: $given.collection }
+      expect: "QA UML" appears as a row under the collection
+    - name: Generate from a mermaid classDiagram
+      do: |
+        Ask the assistant to render this class diagram into "QA UML":
+        classDiagram
+          class Animal { +String name +makeSound() }
+          class Dog
+          Animal <|-- Dog
+      invoke: |
+        [op:generate] { drawing: $created.object, source: "classDiagram\n  class Animal { +String name +makeSound() }\n  class Dog\n  Animal <|-- Dog\n" }
+      expect: two class boxes ("Animal", "Dog") render with a supertype-above-subtype layered layout and an inheritance arrow between them, replacing the drawing's prior contents
+      assert: return $result.upserted.length >= 2
+  after:
+    - name: Delete the drawing
+      do: Right-click "QA UML" in the navtree and choose Delete.
+      invoke: org.dxos.operation.space.removeObjects { objects: [$created.object], target: $given.collection }
+      expect: the row leaves the navtree and its plank closes if it was open
+```

package/dist/lib/Drawing.mjs

@@ -1,8 +1,7 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
-import { Annotation, DXN, Obj, Ref, Type } from "@dxos/echo";
 import * as Schema from "effect/Schema";
-import { FormInputAnnotation, HiddenAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
-import { CardAnnotation, CollectionItemAnnotation } from "@dxos/schema";
+import { Annotation, Collection, DXN, Obj, Ref, Type } from "@dxos/echo";
+import { CardAnnotation } from "@dxos/schema";
 //#region src/types/Drawing.ts
 var Drawing_exports = /* @__PURE__ */ __exportAll({
 	Canvas: () => Canvas,
@@ -23,7 +22,7 @@ var Drawing_exports = /* @__PURE__ */ __exportAll({
 var Canvas = class extends Type.makeObject(DXN.make("org.dxos.type.canvas", "0.1.0"))(Schema.Struct({
 	schema: Schema.String.pipe(Schema.optional),
 	content: Schema.Record(Schema.String, Schema.Any)
-}).pipe(HiddenAnnotation.set(true))) {};
+})) {};
 /** Creates a {@link Canvas} for the given renderer schema. */
 var makeCanvas = ({ schema, content = {} }) => Obj.make(Canvas, {
 	schema,
@@ -38,11 +37,11 @@ var isCanvas = (object) => Obj.instanceOf(Canvas, object);
 */
 var Drawing = class extends Type.makeObject(DXN.make("org.dxos.type.drawing", "0.1.0"))(Schema.Struct({
 	name: Schema.optional(Schema.String),
-	canvas: Ref.Ref(Canvas).annotate({ description: "Reference to the canvas holding the renderer-specific content." }).pipe(FormInputAnnotation.set(false))
-}).pipe(LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
+	canvas: Ref.Ref(Canvas).annotate({ description: "Reference to the canvas holding the renderer-specific content." }).pipe(Annotation.FormInputAnnotation.set(false))
+}).pipe(Annotation.LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
 	icon: "ph--compass-tool--regular",
 	hue: "indigo"
-}), CardAnnotation.set(true), CollectionItemAnnotation.set(true))) {};
+}), CardAnnotation.set(true), Annotation.UserType.set({ tags: [Collection.ItemTag] }))) {};
 /**
 * Build a `Drawing` referencing the given canvas.
 *

package/dist/lib/Drawing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Drawing.mjs","names":[],"sources":["../../src/types/Drawing.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { FormInputAnnotation, HiddenAnnotation, LabelAnnotation } from '@dxos/echo/Annotation';\nimport { CardAnnotation, CollectionItemAnnotation } from '@dxos/schema';\n\n/**\n * Canvas content shared by every renderer: an opaque map of record id → record, managed by the\n * renderer's store adapter and CRDT-merged by ECHO without knowing its shape. `schema` identifies\n * the renderer dialect (e.g. `tldraw.com/2`, `excalidraw.com/2`) and is how a `Drawing` is matched\n * to the variant that can render it.\n *\n * Hidden: reached through `Drawing.canvas`, never listed on its own.\n */\nexport class Canvas extends Type.makeObject<Canvas>(DXN.make('org.dxos.type.canvas', '0.1.0'))(\n  Schema.Struct({\n    schema: Schema.String.pipe(Schema.optional),\n    content: Schema.Record(Schema.String, Schema.Any),\n  }).pipe(HiddenAnnotation.set(true)),\n) {}\n\nexport type MakeCanvasOptions = Omit<Partial<Obj.MakeProps<typeof Canvas>>, 'schema'> & {\n  /** Required at construction: matches the canvas to a renderer variant. */\n  schema: string;\n};\n\n/** Creates a {@link Canvas} for the given renderer schema. */\nexport const makeCanvas = ({ schema, content = {} }: MakeCanvasOptions): Canvas =>\n  Obj.make(Canvas, { schema, content });\n\n/** Type guard for {@link Canvas} objects. */\nexport const isCanvas = (object: unknown): object is Canvas => Obj.instanceOf(Canvas, object);\n\n/**\n * Base Drawing object. Renderer-specific behaviour lives in the variant that claims the canvas's\n * `schema`, so all renderers (tldraw, excalidraw, ...) share one typename, graph node, create\n * flow, and surface scaffolding.\n */\nexport class Drawing extends Type.makeObject<Drawing>(DXN.make('org.dxos.type.drawing', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    canvas: Ref.Ref(Canvas)\n      .annotate({ description: 'Reference to the canvas holding the renderer-specific content.' })\n      .pipe(FormInputAnnotation.set(false)),\n  }).pipe(\n    LabelAnnotation.set(['name']),\n    Annotation.IconAnnotation.set({ icon: 'ph--compass-tool--regular', hue: 'indigo' }),\n    CardAnnotation.set(true),\n    CollectionItemAnnotation.set(true),\n  ),\n) {}\n\n/**\n * Build a `Drawing` referencing the given canvas.\n *\n * @param name Optional display name shown in the graph node and Properties form.\n * @param canvas Canvas holding the renderer's content.\n */\nexport const make = ({ name, canvas }: { name?: string; canvas: Canvas }): Drawing =>\n  Obj.make(Drawing, { name, canvas: Ref.make(canvas) });\n\n/** Type guard for {@link Drawing} objects. */\nexport const isDrawing = (object: unknown): object is Drawing => Obj.instanceOf(Drawing, object);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,QAAQ,OAAO,OAAO,KAAK,OAAO,QAAQ;CAC1C,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,GAAG;AAClD,CAAC,CAAC,CAAC,KAAK,iBAAiB,IAAI,IAAI,CAAC,CACpC,CAAC,CAAC,CAAC;;AAQH,IAAa,cAAc,EAAE,QAAQ,UAAU,CAAC,QAC9C,IAAI,KAAK,QAAQ;CAAE;CAAQ;AAAQ,CAAC;;AAGtC,IAAa,YAAY,WAAsC,IAAI,WAAW,QAAQ,MAAM;;;;;;AAO5F,IAAa,UAAb,cAA6B,KAAK,WAAoB,IAAI,KAAK,yBAAyB,OAAO,CAAC,CAAC,CAC/F,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,QAAQ,IAAI,IAAI,MAAM,CAAA,CACnB,SAAS,EAAE,aAAa,iEAAiE,CAAC,CAAA,CAC1F,KAAK,oBAAoB,IAAI,KAAK,CAAC;AACxC,CAAC,CAAC,CAAC,KACD,gBAAgB,IAAI,CAAC,MAAM,CAAC,GAC5B,WAAW,eAAe,IAAI;CAAE,MAAM;CAA6B,KAAK;AAAS,CAAC,GAClF,eAAe,IAAI,IAAI,GACvB,yBAAyB,IAAI,IAAI,CACnC,CACF,CAAC,CAAC,CAAC;;;;;;;AAQH,IAAa,QAAQ,EAAE,MAAM,aAC3B,IAAI,KAAK,SAAS;CAAE;CAAM,QAAQ,IAAI,KAAK,MAAM;AAAE,CAAC;;AAGtD,IAAa,aAAa,WAAuC,IAAI,WAAW,SAAS,MAAM"}
+{"version":3,"file":"Drawing.mjs","names":[],"sources":["../../src/types/Drawing.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, Collection, DXN, Obj, Ref, Type } from '@dxos/echo';\nimport { CardAnnotation } from '@dxos/schema';\n\n/**\n * Canvas content shared by every renderer: an opaque map of record id → record, managed by the\n * renderer's store adapter and CRDT-merged by ECHO without knowing its shape. `schema` identifies\n * the renderer dialect (e.g. `tldraw.com/2`, `excalidraw.com/2`) and is how a `Drawing` is matched\n * to the variant that can render it.\n *\n * Hidden: reached through `Drawing.canvas`, never listed on its own.\n */\nexport class Canvas extends Type.makeObject<Canvas>(DXN.make('org.dxos.type.canvas', '0.1.0'))(\n  Schema.Struct({\n    schema: Schema.String.pipe(Schema.optional),\n    content: Schema.Record(Schema.String, Schema.Any),\n  }),\n) {}\n\nexport type MakeCanvasOptions = Omit<Partial<Obj.MakeProps<typeof Canvas>>, 'schema'> & {\n  /** Required at construction: matches the canvas to a renderer variant. */\n  schema: string;\n};\n\n/** Creates a {@link Canvas} for the given renderer schema. */\nexport const makeCanvas = ({ schema, content = {} }: MakeCanvasOptions): Canvas =>\n  Obj.make(Canvas, { schema, content });\n\n/** Type guard for {@link Canvas} objects. */\nexport const isCanvas = (object: unknown): object is Canvas => Obj.instanceOf(Canvas, object);\n\n/**\n * Base Drawing object. Renderer-specific behaviour lives in the variant that claims the canvas's\n * `schema`, so all renderers (tldraw, excalidraw, ...) share one typename, graph node, create\n * flow, and surface scaffolding.\n */\nexport class Drawing extends Type.makeObject<Drawing>(DXN.make('org.dxos.type.drawing', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    canvas: Ref.Ref(Canvas)\n      .annotate({ description: 'Reference to the canvas holding the renderer-specific content.' })\n      .pipe(Annotation.FormInputAnnotation.set(false)),\n  }).pipe(\n    Annotation.LabelAnnotation.set(['name']),\n    Annotation.IconAnnotation.set({ icon: 'ph--compass-tool--regular', hue: 'indigo' }),\n    CardAnnotation.set(true),\n    Annotation.UserType.set({ tags: [Collection.ItemTag] }),\n  ),\n) {}\n\n/**\n * Build a `Drawing` referencing the given canvas.\n *\n * @param name Optional display name shown in the graph node and Properties form.\n * @param canvas Canvas holding the renderer's content.\n */\nexport const make = ({ name, canvas }: { name?: string; canvas: Canvas }): Drawing =>\n  Obj.make(Drawing, { name, canvas: Ref.make(canvas) });\n\n/** Type guard for {@link Drawing} objects. */\nexport const isDrawing = (object: unknown): object is Drawing => Obj.instanceOf(Drawing, object);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,QAAQ,OAAO,OAAO,KAAK,OAAO,QAAQ;CAC1C,SAAS,OAAO,OAAO,OAAO,QAAQ,OAAO,GAAG;AAClD,CAAC,CACH,CAAC,CAAC,CAAC;;AAQH,IAAa,cAAc,EAAE,QAAQ,UAAU,CAAC,QAC9C,IAAI,KAAK,QAAQ;CAAE;CAAQ;AAAQ,CAAC;;AAGtC,IAAa,YAAY,WAAsC,IAAI,WAAW,QAAQ,MAAM;;;;;;AAO5F,IAAa,UAAb,cAA6B,KAAK,WAAoB,IAAI,KAAK,yBAAyB,OAAO,CAAC,CAAC,CAC/F,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,QAAQ,IAAI,IAAI,MAAM,CAAA,CACnB,SAAS,EAAE,aAAa,iEAAiE,CAAC,CAAA,CAC1F,KAAK,WAAW,oBAAoB,IAAI,KAAK,CAAC;AACnD,CAAC,CAAC,CAAC,KACD,WAAW,gBAAgB,IAAI,CAAC,MAAM,CAAC,GACvC,WAAW,eAAe,IAAI;CAAE,MAAM;CAA6B,KAAK;AAAS,CAAC,GAClF,eAAe,IAAI,IAAI,GACvB,WAAW,SAAS,IAAI,EAAE,MAAM,CAAC,WAAW,OAAO,EAAE,CAAC,CACxD,CACF,CAAC,CAAC,CAAC;;;;;;;AAQH,IAAa,QAAQ,EAAE,MAAM,aAC3B,IAAI,KAAK,SAAS;CAAE;CAAM,QAAQ,IAAI,KAAK,MAAM;AAAE,CAAC;;AAGtD,IAAa,aAAa,WAAuC,IAAI,WAAW,SAAS,MAAM"}

package/dist/lib/DrawingOperation.mjs

@@ -1,22 +1,25 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { Drawing } from "./Drawing.mjs";
 import * as Capability from "@dxos/app-framework/Capability";
-import { Scene } from "#model";
-import { Database, Ref, Type } from "@dxos/echo";
+import { Diagnostics, Scene } from "@dxos/diagram";
 import * as Schema from "effect/Schema";
-import * as Operation from "@dxos/compute/Operation";
+import { Database, Ref, Type } from "@dxos/echo";
 import { DXN as DXN$1 } from "@dxos/keys";
+import * as Operation from "@dxos/compute/Operation";
 //#region src/types/DrawingOperation.ts
 var DrawingOperation_exports = /* @__PURE__ */ __exportAll({
 	Create: () => Create,
+	Draw: () => Draw,
 	Edit: () => Edit,
 	Generate: () => Generate,
-	Read: () => Read
+	Read: () => Read,
+	Score: () => Score
 });
 var Create = Operation.make({
 	meta: {
 		key: DXN$1.make("org.dxos.operation.illustrator.create"),
 		name: "Create Drawing",
+		description: "Creates an empty drawing in the space and returns it; pass it to Generate, Draw or Edit.",
 		icon: "ph--pencil-simple--regular"
 	},
 	input: Schema.Struct({
@@ -60,6 +63,41 @@ var Edit = Operation.make({
 	}),
 	services: [Capability.Service, Database.Service]
 });
+var Draw = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.illustrator.draw"),
+		name: "Draw Diagram",
+		description: "Applies a diagram written in the native text DSL: either semantic statements (`node`, `edge`, `group`) that state intent and are laid out for you, or scene statements where you choose every coordinate, or both. Use semantic statements for boxes-and-arrows diagrams, scene statements for precise figures or to hand-edit a drawing.",
+		icon: "ph--code--regular"
+	},
+	input: Schema.Struct({
+		drawing: Ref.Ref(Drawing).annotate({ description: "The drawing to draw into." }),
+		source: Schema.String.annotate({ description: [
+			"Diagram DSL. Semantic statements: `node <id> [\"label\"] [right-of|left-of|above|below|same-row|same-col <node>]* [@cell(c,r)] [ref=]`,",
+			"`group <id> [\"label\"] [right-of|below… <group>] { node… edge… }`, `edge <a>[:side|side] -> <b>[:side] [\"label\"] [via x,_ | _,y] [bus]`",
+			"(`~` before a relation makes it soft; `<->` two arrows; `a -> b, c bus` one trunk), `diagram [flow=down|right]`; the engine places and routes the rest.",
+			"In place of `->` an edge may name its relationship, left end being the child/whole/owner/one side: `extends`, `implements`, `composes`, `owns`, `one-to-many`, `many-to-many`, `depends-on`.",
+			"Scene statements are `object <id> [@ <x>,<y>] [scale=] [index=] [ref=] { <element>* }`,",
+			"`elements <objectId> { … }`, `move <id> @ <x>,<y>`, `remove object <id>`, `remove elements <id> <ids…>`.",
+			"An element is `<kind> <id> <geometry> [\"label\"] <name=value>*` where kind is rect/ellipse/diamond/triangle",
+			"(`x,y WxH`), circle (`cx,cy r`), line/curve (two or more `x,y`), arc (`cx,cy r a0..a1`), text (`x,y \"s\"`),",
+			"arrow (`<end> -> <end>`, each end a ref like `Obj/elem#port`, a point, or `_`), or portal (`x,y WxH ref=\"<dxn>\"`)."
+		].join(" ") })
+	}),
+	output: Schema.Struct({
+		...SceneOutput,
+		upserted: Schema.Array(Schema.String).annotate({ description: "Object ids created or modified." }),
+		removed: Schema.Number.annotate({ description: "Number of shapes removed." }),
+		problems: Schema.Array(Schema.Struct({
+			severity: Schema.Literals(["error", "warning"]),
+			message: Schema.String,
+			line: Schema.Number,
+			column: Schema.Number
+		})).annotate({ description: "Syntax and schema problems in the source, with 1-based line/column. A single `error` leaves the drawing untouched — fix it and draw again." }),
+		diagnostics: Schema.Array(Diagnostics.Diagnostic).annotate({ description: "Layout report over the resulting scene. Fix every `error` (overlap, connector through a node, label overflow) by moving or resizing the offending elements and drawing again." })
+	}),
+	services: [Capability.Service, Database.Service]
+});
 var Generate = Operation.make({
 	meta: {
 		key: DXN$1.make("org.dxos.operation.illustrator.generate"),
@@ -69,15 +107,36 @@ var Generate = Operation.make({
 	},
 	input: Schema.Struct({
 		drawing: Ref.Ref(Drawing).annotate({ description: "The drawing to generate into." }),
-		source: Schema.String.annotate({ description: "Mermaid source: a flowchart or a classDiagram." })
+		source: Schema.String.annotate({ description: "Mermaid source: a flowchart or a classDiagram. Flowcharts may carry `%% ref <nodeId> <target>` lines saying what a node depicts: an ECHO object reference opens on activation; other URIs and paths are carried for tooling." })
 	}),
 	output: Schema.Struct({
 		...SceneOutput,
-		upserted: Schema.Array(Schema.String).annotate({ description: "Object ids created or modified." })
+		upserted: Schema.Array(Schema.String).annotate({ description: "Object ids created or modified." }),
+		diagnostics: Schema.Array(Diagnostics.Diagnostic).annotate({ description: "Layout report. Fix every `error` (overlap, connector through a node, label overflow) by simplifying or splitting the diagram and regenerating; `warning`s (crossings, bends) are quality hints." })
+	}),
+	services: [Capability.Service, Database.Service]
+});
+var Score = Operation.make({
+	meta: {
+		key: DXN$1.make("org.dxos.operation.illustrator.analyze"),
+		name: "Score Drawing",
+		description: "Grades the drawing as laid out, on one 0–1 scale (1 is good): each layout constraint (pass 1 / fail 0) and cost term (crossings, overlapping arrows, overlapping labels, bends, length, gaps, compactness), their overall score, and the diagnostics behind them. Call after Generate to decide what to change before regenerating.",
+		icon: "ph--gauge--regular"
+	},
+	input: Schema.Struct({ drawing: Ref.Ref(Drawing).annotate({ description: "The drawing to score." }) }),
+	output: Schema.Struct({
+		overall: Schema.optional(Schema.Number).annotate({ description: "The worst constraint gating the mean of the cost scores; absent when nothing could be scored." }),
+		scores: Schema.Array(Schema.Struct({
+			id: Schema.String,
+			kind: Schema.String,
+			score: Schema.Number,
+			detail: Schema.optional(Schema.String)
+		})),
+		diagnostics: Schema.Array(Diagnostics.Diagnostic)
 	}),
 	services: [Capability.Service, Database.Service]
 });
 //#endregion
-export { Create, Edit, Generate, Read, DrawingOperation_exports as t };
+export { Create, Draw, Edit, Generate, Read, Score, DrawingOperation_exports as t };
 
 //# sourceMappingURL=DrawingOperation.mjs.map

package/dist/lib/DrawingOperation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DrawingOperation.mjs","names":[],"sources":["../../src/types/DrawingOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, Ref, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport { Scene } from '#model';\n\nimport * as Drawing from './Drawing';\n\nexport const Create = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.create'),\n    name: 'Create Drawing',\n    icon: 'ph--pencil-simple--regular',\n  },\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    variant: Schema.optional(Schema.String).annotate({\n      description: 'Variant id (canvas typename); defaults to the first registered variant.',\n    }),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Drawing.Drawing),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\n/** The scene as derived from the live canvas. */\nconst SceneOutput = {\n  scene: Scene.Scene.annotate({ description: 'The diagram as world objects with object-local coordinates.' }),\n  unmanaged: Schema.Number.annotate({\n    description: 'Number of shapes on the canvas not managed by the DSL (drawn by users).',\n  }),\n};\n\nexport const Read = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.read'),\n    name: 'Read Drawing',\n    description:\n      'Returns the current scene of a drawing: world objects (by id) with their elements in object-local units. Call before editing an existing drawing.',\n    icon: 'ph--eye--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to read.' }),\n  }),\n  output: Schema.Struct(SceneOutput),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Edit = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.edit'),\n    name: 'Edit Drawing',\n    description:\n      'Applies scene commands to a drawing: upsert/move/remove world objects or individual elements by id. Returns the resulting scene.',\n    icon: 'ph--pencil-simple-line--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to edit.' }),\n    commands: Schema.Array(Scene.Command).annotate({ description: 'Commands applied in order, atomically.' }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotate({ description: 'Object ids created or modified.' }),\n    removed: Schema.Number.annotate({ description: 'Number of shapes removed.' }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Generate = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.generate'),\n    name: 'Generate Drawing',\n    description:\n      'Replaces a drawing with a diagram compiled from a mermaid description (flowchart or classDiagram). The dialect owns layout, so no coordinates are supplied.',\n    icon: 'ph--graph--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to generate into.' }),\n    source: Schema.String.annotate({ description: 'Mermaid source: a flowchart or a classDiagram.' }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotate({ description: 'Object ids created or modified.' }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n"],"mappings":";;;;;;;;;;;;;;;AAiBA,IAAa,SAAS,UAAU,KAAK;CACnC,MAAM;EACJ,KAAK,MAAI,KAAK,uCAAuC;EACrD,MAAM;EACN,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,MAAM,OAAO,SAAS,OAAO,MAAM;EACnC,SAAS,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,SAAS,EAC/C,aAAa,0EACf,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,QAAQ,KAAK,UAAU,OAAe,EACxC,CAAC;CACD,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC;;AAGD,IAAM,cAAc;CAClB,OAAO,MAAM,MAAM,SAAS,EAAE,aAAa,8DAA8D,CAAC;CAC1G,WAAW,OAAO,OAAO,SAAS,EAChC,aAAa,0EACf,CAAC;AACH;AAEA,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,MAAI,KAAK,qCAAqC;EACnD,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,SAAS,IAAI,IAAI,OAAe,CAAC,CAAC,SAAS,EAAE,aAAa,uBAAuB,CAAC,EACpF,CAAC;CACD,QAAQ,OAAO,OAAO,WAAW;CACjC,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC;AAED,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,MAAI,KAAK,qCAAqC;EACnD,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,SAAS,IAAI,IAAI,OAAe,CAAC,CAAC,SAAS,EAAE,aAAa,uBAAuB,CAAC;EAClF,UAAU,OAAO,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,EAAE,aAAa,yCAAyC,CAAC;CAC1G,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,GAAG;EACH,UAAU,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,SAAS,EAAE,aAAa,kCAAkC,CAAC;EACjG,SAAS,OAAO,OAAO,SAAS,EAAE,aAAa,4BAA4B,CAAC;CAC9E,CAAC;CACD,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC;AAED,IAAa,WAAW,UAAU,KAAK;CACrC,MAAM;EACJ,KAAK,MAAI,KAAK,yCAAyC;EACvD,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,SAAS,IAAI,IAAI,OAAe,CAAC,CAAC,SAAS,EAAE,aAAa,gCAAgC,CAAC;EAC3F,QAAQ,OAAO,OAAO,SAAS,EAAE,aAAa,iDAAiD,CAAC;CAClG,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,GAAG;EACH,UAAU,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,SAAS,EAAE,aAAa,kCAAkC,CAAC;CACnG,CAAC;CACD,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC"}
+{"version":3,"file":"DrawingOperation.mjs","names":[],"sources":["../../src/types/DrawingOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Diagnostics, Scene } from '@dxos/diagram';\nimport { Database, Ref, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport * as Drawing from './Drawing.ts';\n\nexport const Create = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.create'),\n    name: 'Create Drawing',\n    description: 'Creates an empty drawing in the space and returns it; pass it to Generate, Draw or Edit.',\n    icon: 'ph--pencil-simple--regular',\n  },\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    variant: Schema.optional(Schema.String).annotate({\n      description: 'Variant id (canvas typename); defaults to the first registered variant.',\n    }),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Drawing.Drawing),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\n/** The scene as derived from the live canvas. */\nconst SceneOutput = {\n  scene: Scene.Scene.annotate({ description: 'The diagram as world objects with object-local coordinates.' }),\n  unmanaged: Schema.Number.annotate({\n    description: 'Number of shapes on the canvas not managed by the DSL (drawn by users).',\n  }),\n};\n\nexport const Read = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.read'),\n    name: 'Read Drawing',\n    description:\n      'Returns the current scene of a drawing: world objects (by id) with their elements in object-local units. Call before editing an existing drawing.',\n    icon: 'ph--eye--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to read.' }),\n  }),\n  output: Schema.Struct(SceneOutput),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Edit = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.edit'),\n    name: 'Edit Drawing',\n    description:\n      'Applies scene commands to a drawing: upsert/move/remove world objects or individual elements by id. Returns the resulting scene.',\n    icon: 'ph--pencil-simple-line--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to edit.' }),\n    commands: Schema.Array(Scene.Command).annotate({ description: 'Commands applied in order, atomically.' }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotate({ description: 'Object ids created or modified.' }),\n    removed: Schema.Number.annotate({ description: 'Number of shapes removed.' }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Draw = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.draw'),\n    name: 'Draw Diagram',\n    description:\n      'Applies a diagram written in the native text DSL: either semantic statements (`node`, `edge`, `group`) that state intent and are laid out for you, or scene statements where you choose every coordinate, or both. Use semantic statements for boxes-and-arrows diagrams, scene statements for precise figures or to hand-edit a drawing.',\n    icon: 'ph--code--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to draw into.' }),\n    source: Schema.String.annotate({\n      description: [\n        'Diagram DSL. Semantic statements: `node <id> [\"label\"] [right-of|left-of|above|below|same-row|same-col <node>]* [@cell(c,r)] [ref=]`,',\n        '`group <id> [\"label\"] [right-of|below… <group>] { node… edge… }`, `edge <a>[:side|side] -> <b>[:side] [\"label\"] [via x,_ | _,y] [bus]`',\n        '(`~` before a relation makes it soft; `<->` two arrows; `a -> b, c bus` one trunk), `diagram [flow=down|right]`; the engine places and routes the rest.',\n        'In place of `->` an edge may name its relationship, left end being the child/whole/owner/one side: `extends`, `implements`, `composes`, `owns`, `one-to-many`, `many-to-many`, `depends-on`.',\n        'Scene statements are `object <id> [@ <x>,<y>] [scale=] [index=] [ref=] { <element>* }`,',\n        '`elements <objectId> { … }`, `move <id> @ <x>,<y>`, `remove object <id>`, `remove elements <id> <ids…>`.',\n        'An element is `<kind> <id> <geometry> [\"label\"] <name=value>*` where kind is rect/ellipse/diamond/triangle',\n        '(`x,y WxH`), circle (`cx,cy r`), line/curve (two or more `x,y`), arc (`cx,cy r a0..a1`), text (`x,y \"s\"`),',\n        'arrow (`<end> -> <end>`, each end a ref like `Obj/elem#port`, a point, or `_`), or portal (`x,y WxH ref=\"<dxn>\"`).',\n      ].join(' '),\n    }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotate({ description: 'Object ids created or modified.' }),\n    removed: Schema.Number.annotate({ description: 'Number of shapes removed.' }),\n    problems: Schema.Array(\n      Schema.Struct({\n        severity: Schema.Literals(['error', 'warning']),\n        message: Schema.String,\n        line: Schema.Number,\n        column: Schema.Number,\n      }),\n    ).annotate({\n      description:\n        'Syntax and schema problems in the source, with 1-based line/column. A single `error` leaves the drawing untouched — fix it and draw again.',\n    }),\n    diagnostics: Schema.Array(Diagnostics.Diagnostic).annotate({\n      description:\n        'Layout report over the resulting scene. Fix every `error` (overlap, connector through a node, label overflow) by moving or resizing the offending elements and drawing again.',\n    }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Generate = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.generate'),\n    name: 'Generate Drawing',\n    description:\n      'Replaces a drawing with a diagram compiled from a mermaid description (flowchart or classDiagram). The dialect owns layout, so no coordinates are supplied.',\n    icon: 'ph--graph--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to generate into.' }),\n    source: Schema.String.annotate({\n      description:\n        'Mermaid source: a flowchart or a classDiagram. Flowcharts may carry `%% ref <nodeId> <target>` lines saying what a node depicts: an ECHO object reference opens on activation; other URIs and paths are carried for tooling.',\n    }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotate({ description: 'Object ids created or modified.' }),\n    diagnostics: Schema.Array(Diagnostics.Diagnostic).annotate({\n      description:\n        'Layout report. Fix every `error` (overlap, connector through a node, label overflow) by simplifying or splitting the diagram and regenerating; `warning`s (crossings, bends) are quality hints.',\n    }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\nexport const Score = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.illustrator.analyze'),\n    name: 'Score Drawing',\n    description:\n      'Grades the drawing as laid out, on one 0–1 scale (1 is good): each layout constraint (pass 1 / fail 0) and cost ' +\n      'term (crossings, overlapping arrows, overlapping labels, bends, length, gaps, compactness), their overall score, ' +\n      'and the diagnostics behind them. Call after Generate to decide what to change before regenerating.',\n    icon: 'ph--gauge--regular',\n  },\n  input: Schema.Struct({\n    drawing: Ref.Ref(Drawing.Drawing).annotate({ description: 'The drawing to score.' }),\n  }),\n  output: Schema.Struct({\n    overall: Schema.optional(Schema.Number).annotate({\n      description: 'The worst constraint gating the mean of the cost scores; absent when nothing could be scored.',\n    }),\n    scores: Schema.Array(\n      Schema.Struct({\n        id: Schema.String,\n        kind: Schema.String,\n        score: Schema.Number,\n        detail: Schema.optional(Schema.String),\n      }),\n    ),\n    diagnostics: Schema.Array(Diagnostics.Diagnostic),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n"],"mappings":"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"}

package/dist/lib/DrawingSkill.mjs

@@ -0,0 +1,68 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { DrawingOperation } from "#types";
+import { trim } from "@dxos/util";
+import * as Operation from "@dxos/compute/Operation";
+import * as Skill from "@dxos/compute/Skill";
+import * as Template from "@dxos/compute/Template";
+//#region src/skills/DrawingSkill.ts
+var DrawingSkill_exports = /* @__PURE__ */ __exportAll({
+	key: () => key,
+	make: () => make
+});
+var key = "org.dxos.skill.drawing";
+var operations = [
+	DrawingOperation.Create,
+	DrawingOperation.Read,
+	DrawingOperation.Edit
+];
+var make = () => Skill.make({
+	key,
+	name: "Drawing",
+	tools: Skill.toolDefinitions({ operations }),
+	instructions: Template.make({ source: trim`
+        {{! Drawing }}
+
+        You can draw and edit diagrams on a shared canvas using a scene DSL.
+
+        ## Model
+
+        A drawing is a set of WORLD OBJECTS — semantic things like "face", "hat", "server" —
+        each composed of graphical ELEMENTS (rect, ellipse, circle, diamond, triangle, line,
+        curve, arc, text, arrow). You do the layout; there is no auto-layout.
+
+        - Give objects and elements short, semantic ids ("face", "left-eye"). Ids are how you
+          edit or delete things later — choose them as carefully as variable names.
+        - Element coordinates are OBJECT-LOCAL units. Design each object in roughly a 100-unit
+          box. The object's "origin" (canvas px) and "scale" (px per unit) place it on the
+          canvas: canvas = origin + local * scale. Prefer scale 2-3 for a primary subject.
+        - Screen coordinates: x grows right, y grows DOWN. Arc angles are degrees clockwise
+          from the +x axis: startAngle 30, endAngle 150 bulges downward (a smile);
+          210 to 330 bulges upward (a frown).
+        - Circle is sugar for ellipse (reads back as ellipse); arc is sugar for curve.
+        - Arrows can bind to elements: from/to is an element id in the same object, or
+          "objectId/elementId" across objects. Bound arrows track their targets.
+        - Styles: color (named palette), fill (none | solid | pattern),
+          stroke (sketchy | solid | dashed | dotted), weight (s | m | l | xl).
+
+        ## Workflow
+
+        1. If no drawing exists in context, create one first.
+        2. ALWAYS call ${Operation.toolName(DrawingOperation.Read)} before editing an existing drawing — it returns the scene as you
+           (or the user) last left it, with origins derived from the live canvas, so it stays
+           correct even after the user drags shapes around. Note "unmanaged" counts shapes the
+           user drew by hand that are not part of the scene.
+        3. Edit with commands, in one batch where possible:
+           - upsert-object: create a new object, or redraw one wholesale.
+           - upsert-elements: add or replace specific elements of an object — prefer this for
+             incremental changes ("make the smile bigger" replaces only "smile").
+           - remove-elements / remove-object: delete by id.
+           - move-object: reposition an object (canvas px) without resending its elements.
+        4. Compose scenes from multiple objects: "add a hat" means a NEW "hat" object placed
+           relative to the existing object's origin and size (from read) — do not redraw the
+           existing object.
+      ` })
+});
+//#endregion
+export { key, make, DrawingSkill_exports as t };
+
+//# sourceMappingURL=DrawingSkill.mjs.map

package/dist/lib/DrawingSkill.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawingSkill.mjs","names":[],"sources":["../../src/skills/DrawingSkill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { trim } from '@dxos/util';\n\nimport { DrawingOperation } from '#types';\n\nexport const key = 'org.dxos.skill.drawing';\n\nconst operations = [DrawingOperation.Create, DrawingOperation.Read, DrawingOperation.Edit];\n\nexport const make = () =>\n  Skill.make({\n    key: key,\n    name: 'Drawing',\n    tools: Skill.toolDefinitions({ operations }),\n    instructions: Template.make({\n      source: trim`\n        {{! Drawing }}\n\n        You can draw and edit diagrams on a shared canvas using a scene DSL.\n\n        ## Model\n\n        A drawing is a set of WORLD OBJECTS — semantic things like \"face\", \"hat\", \"server\" —\n        each composed of graphical ELEMENTS (rect, ellipse, circle, diamond, triangle, line,\n        curve, arc, text, arrow). You do the layout; there is no auto-layout.\n\n        - Give objects and elements short, semantic ids (\"face\", \"left-eye\"). Ids are how you\n          edit or delete things later — choose them as carefully as variable names.\n        - Element coordinates are OBJECT-LOCAL units. Design each object in roughly a 100-unit\n          box. The object's \"origin\" (canvas px) and \"scale\" (px per unit) place it on the\n          canvas: canvas = origin + local * scale. Prefer scale 2-3 for a primary subject.\n        - Screen coordinates: x grows right, y grows DOWN. Arc angles are degrees clockwise\n          from the +x axis: startAngle 30, endAngle 150 bulges downward (a smile);\n          210 to 330 bulges upward (a frown).\n        - Circle is sugar for ellipse (reads back as ellipse); arc is sugar for curve.\n        - Arrows can bind to elements: from/to is an element id in the same object, or\n          \"objectId/elementId\" across objects. Bound arrows track their targets.\n        - Styles: color (named palette), fill (none | solid | pattern),\n          stroke (sketchy | solid | dashed | dotted), weight (s | m | l | xl).\n\n        ## Workflow\n\n        1. If no drawing exists in context, create one first.\n        2. ALWAYS call ${Operation.toolName(DrawingOperation.Read)} before editing an existing drawing — it returns the scene as you\n           (or the user) last left it, with origins derived from the live canvas, so it stays\n           correct even after the user drags shapes around. Note \"unmanaged\" counts shapes the\n           user drew by hand that are not part of the scene.\n        3. Edit with commands, in one batch where possible:\n           - upsert-object: create a new object, or redraw one wholesale.\n           - upsert-elements: add or replace specific elements of an object — prefer this for\n             incremental changes (\"make the smile bigger\" replaces only \"smile\").\n           - remove-elements / remove-object: delete by id.\n           - move-object: reposition an object (canvas px) without resending its elements.\n        4. Compose scenes from multiple objects: \"add a hat\" means a NEW \"hat\" object placed\n           relative to the existing object's origin and size (from read) — do not redraw the\n           existing object.\n      `,\n    }),\n  });\n"],"mappings":";;;;;;;;;;;AAWA,IAAa,MAAM;AAEnB,IAAM,aAAa;CAAC,iBAAiB;CAAQ,iBAAiB;CAAM,iBAAiB;AAAI;AAEzF,IAAa,aACX,MAAM,KAAK;CACJ;CACL,MAAM;CACN,OAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC;CAC3C,cAAc,SAAS,KAAK,EAC1B,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA4BO,UAAU,SAAS,iBAAiB,IAAI,EAAE;;;;;;;;;;;;;QAc/D,CAAC;AACH,CAAC"}

package/dist/lib/IllustratorCapabilities.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"IllustratorCapabilities.mjs","names":[],"sources":["../../src/types/IllustratorCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Effect from 'effect/Effect';\nimport type { ComponentType } from 'react';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type { Database, Obj, Type } from '@dxos/echo';\n\nimport { meta } from '#meta';\nimport { type DrawingBuilder } from '#model';\n\nimport type * as Drawing from './Drawing';\n\n/**\n * A drawing variant contribution. Each renderer plugin (tldraw, excalidraw, ...) contributes one\n * via `Capability.contribute(IllustratorCapabilities.VariantProvider, variant)`.\n * Consumers iterate via `Capability.getAll(IllustratorCapabilities.VariantProvider)` (Effect) or\n * `useCapabilities(IllustratorCapabilities.VariantProvider)` (React).\n */\nexport const VariantProvider = Capability.make<DrawingVariant>()(`${meta.profile.key}.capability.variant`);\n\n/**\n * Contribution from a renderer plugin (e.g. plugin-tldraw, plugin-excalidraw).\n * Defines how a drawing variant is created, rendered, and how the scene DSL maps onto it.\n */\nexport type DrawingVariant = {\n  /** Renderer dialect claimed by this variant; matched against `Canvas.schema` (e.g. 'tldraw.com/2'). */\n  id: string;\n  /** Human-readable variant name (e.g. 'tldraw'). */\n  label: string;\n  /** Optional Phosphor icon name (e.g. 'ph--compass-tool--regular'). */\n  icon?: string;\n  /**\n   * Canvas type, when the renderer extends the base `Drawing.Canvas` with its own fields.\n   * Omit to use the base type — the common case, since `schema` already discriminates.\n   */\n  canvasType?: Type.AnyObj;\n  /** Build an empty canvas. Defaults to a base `Drawing.Canvas` stamped with `id` as its schema. */\n  createCanvas?: (input?: Record<string, any>) => Effect.Effect<Drawing.Canvas, Error, Database.Service>;\n  /** Maps the scene DSL onto this variant's canvas records. */\n  builder: DrawingBuilder;\n  /** Optional Card surface component for this variant. */\n  card?: ComponentType<DrawingVariantSurfaceProps>;\n  /** Optional Article/Section/Slide surface component for this variant. */\n  article?: ComponentType<DrawingVariantSurfaceProps>;\n};\n\nexport type DrawingVariantSurfaceProps = {\n  /** The base Drawing object (may be a snapshot from useObject/Surface). */\n  drawing: Obj.Snapshot<Drawing.Drawing> | Drawing.Drawing;\n  /** The resolved LIVE canvas object — variant store adapters need `Doc.createAccessor`. */\n  canvas: Drawing.Canvas;\n  /** Surface role passed through from the host. */\n  role?: string;\n  /** Attendable id passed through from the host. */\n  attendableId?: string;\n  /** Card surfaces: whether the card is editable. */\n  editable?: boolean;\n  /** Section surfaces: whether the embed is extrinsically sized. */\n  extrinsic?: boolean;\n};\n"],"mappings":";;;;;;;;;;;AAuBA,IAAa,kBAAkB,WAAW,KAAqB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,oBAAoB"}
+{"version":3,"file":"IllustratorCapabilities.mjs","names":[],"sources":["../../src/types/IllustratorCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Effect from 'effect/Effect';\nimport type { ComponentType } from 'react';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type { Database, Obj, Type } from '@dxos/echo';\n\nimport { meta } from '#meta';\nimport { type DrawingBuilder } from '#model';\n\nimport type * as Drawing from './Drawing.ts';\n\n/**\n * A drawing variant contribution. Each renderer plugin (tldraw, excalidraw, ...) contributes one\n * via `Capability.contribute(IllustratorCapabilities.VariantProvider, variant)`.\n * Consumers iterate via `Capability.getAll(IllustratorCapabilities.VariantProvider)` (Effect) or\n * `useCapabilities(IllustratorCapabilities.VariantProvider)` (React).\n */\nexport const VariantProvider = Capability.make<DrawingVariant>()(`${meta.profile.key}.capability.variant`);\n\n/**\n * Contribution from a renderer plugin (e.g. plugin-tldraw, plugin-excalidraw).\n * Defines how a drawing variant is created, rendered, and how the scene DSL maps onto it.\n */\nexport type DrawingVariant = {\n  /** Renderer dialect claimed by this variant; matched against `Canvas.schema` (e.g. 'tldraw.com/2'). */\n  id: string;\n  /** Human-readable variant name (e.g. 'tldraw'). */\n  label: string;\n  /** Optional Phosphor icon name (e.g. 'ph--compass-tool--regular'). */\n  icon?: string;\n  /**\n   * Canvas type, when the renderer extends the base `Drawing.Canvas` with its own fields.\n   * Omit to use the base type — the common case, since `schema` already discriminates.\n   */\n  canvasType?: Type.AnyObj;\n  /** Build an empty canvas. Defaults to a base `Drawing.Canvas` stamped with `id` as its schema. */\n  createCanvas?: (input?: Record<string, any>) => Effect.Effect<Drawing.Canvas, Error, Database.Service>;\n  /** Maps the scene DSL onto this variant's canvas records. */\n  builder: DrawingBuilder;\n  /** Optional Card surface component for this variant. */\n  card?: ComponentType<DrawingVariantSurfaceProps>;\n  /** Optional Article/Section/Slide surface component for this variant. */\n  article?: ComponentType<DrawingVariantSurfaceProps>;\n};\n\nexport type DrawingVariantSurfaceProps = {\n  /** The base Drawing object (may be a snapshot from useObject/Surface). */\n  drawing: Obj.Snapshot<Drawing.Drawing> | Drawing.Drawing;\n  /** The resolved LIVE canvas object — variant store adapters need `Doc.createAccessor`. */\n  canvas: Drawing.Canvas;\n  /** Surface role passed through from the host. */\n  role?: string;\n  /** Attendable id passed through from the host. */\n  attendableId?: string;\n  /** Card surfaces: whether the card is editable. */\n  editable?: boolean;\n  /** Section surfaces: whether the embed is extrinsically sized. */\n  extrinsic?: boolean;\n  /** Selected world-object ids, owned by the host so every renderer shares one selection model. */\n  selection?: readonly string[];\n  /** The user changed the selection. Ids are scene object ids — never renderer shape ids. */\n  onSelectionChange?: (objectIds: readonly string[]) => void;\n  /** The user activated an object (double-click / enter): open what it depicts. */\n  onActivate?: (objectId: string) => void;\n};\n"],"mappings":";;;;;;;;;;;AAuBA,IAAa,kBAAkB,WAAW,KAAqB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,oBAAoB"}

package/dist/lib/IllustratorError.mjs

@@ -0,0 +1,10 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { BaseError } from "@dxos/errors";
+//#region src/types/IllustratorError.ts
+var IllustratorError_exports = /* @__PURE__ */ __exportAll({ LayoutFailed: () => LayoutFailed });
+/** The layout engine (ELK) rejected the diagram; the cause carries its message. */
+var LayoutFailed = class extends BaseError.extend("IllustratorLayoutFailed", "Diagram layout failed") {};
+//#endregion
+export { LayoutFailed, IllustratorError_exports as t };
+
+//# sourceMappingURL=IllustratorError.mjs.map

package/dist/lib/IllustratorError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IllustratorError.mjs","names":[],"sources":["../../src/types/IllustratorError.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { BaseError } from '@dxos/errors';\n\n/** The layout engine (ELK) rejected the diagram; the cause carries its message. */\nexport class LayoutFailed extends BaseError.extend('IllustratorLayoutFailed', 'Diagram layout failed') {}\n\nexport type IllustratorError = LayoutFailed;\n"],"mappings":";;;;;AASA,IAAa,eAAb,cAAkC,UAAU,OAAO,2BAA2B,uBAAuB,CAAC,CAAC,CAAC"}

package/dist/lib/LegacySketch.mjs

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
 import { Canvas } from "./Drawing.mjs";
-import { DXN, Ref, Type } from "@dxos/echo";
 import * as Schema from "effect/Schema";
+import { DXN, Ref, Type } from "@dxos/echo";
 //#region src/types/LegacySketch.ts
 var LegacySketch_exports = /* @__PURE__ */ __exportAll({ Sketch: () => Sketch });
 /**

package/dist/lib/LegacySketch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"LegacySketch.mjs","names":[],"sources":["../../src/types/LegacySketch.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN, Ref, Type } from '@dxos/echo';\n\nimport * as Drawing from './Drawing';\n\n/**\n * The pre-rename `Sketch` object, kept solely so `Migration.define` can read existing data and\n * convert it to {@link Drawing}. Never constructed by this plugin.\n *\n * Its canvas already points at `org.dxos.type.canvas` carrying `schema: 'tldraw.com/2'`, which is\n * exactly the base `Drawing.Canvas` — so only the wrapper needs migrating.\n */\nexport class Sketch extends Type.makeObject<Sketch>(DXN.make('org.dxos.type.sketch', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    canvas: Ref.Ref(Drawing.Canvas),\n  }),\n) {}\n"],"mappings":";;;;;;;;;;;;;AAmBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,QAAQ,IAAI,IAAI,MAAc;AAChC,CAAC,CACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"LegacySketch.mjs","names":[],"sources":["../../src/types/LegacySketch.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { DXN, Ref, Type } from '@dxos/echo';\n\nimport * as Drawing from './Drawing.ts';\n\n/**\n * The pre-rename `Sketch` object, kept solely so `Migration.define` can read existing data and\n * convert it to {@link Drawing}. Never constructed by this plugin.\n *\n * Its canvas already points at `org.dxos.type.canvas` carrying `schema: 'tldraw.com/2'`, which is\n * exactly the base `Drawing.Canvas` — so only the wrapper needs migrating.\n */\nexport class Sketch extends Type.makeObject<Sketch>(DXN.make('org.dxos.type.sketch', '0.1.0'))(\n  Schema.Struct({\n    name: Schema.optional(Schema.String),\n    canvas: Ref.Ref(Drawing.Canvas),\n  }),\n) {}\n"],"mappings":";;;;;;;;;;;;;AAmBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,QAAQ,IAAI,IAAI,MAAc;AAChC,CAAC,CACH,CAAC,CAAC,CAAC"}