@dxos/plugin-illustrator 0.10.0

package/dist/lib/chunk-model.mjs

@@ -0,0 +1,202 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { invariant } from "@dxos/invariant";
+//#region src/model/scene.ts
+var scene_exports = /* @__PURE__ */ __exportAll({
+	Arc: () => Arc,
+	Arrow: () => Arrow,
+	Box: () => Box,
+	Circle: () => Circle,
+	Color: () => Color,
+	Command: () => Command,
+	Curve: () => Curve,
+	Element: () => Element,
+	Fill: () => Fill,
+	MoveObject: () => MoveObject,
+	Point: () => Point,
+	Polyline: () => Polyline,
+	RemoveElements: () => RemoveElements,
+	RemoveObject: () => RemoveObject,
+	Scene: () => Scene,
+	Stroke: () => Stroke,
+	Text: () => Text,
+	UpsertElements: () => UpsertElements,
+	UpsertObject: () => UpsertObject,
+	Weight: () => Weight,
+	WorldObject: () => WorldObject
+});
+var Color = Schema.Literal("black", "grey", "light-violet", "violet", "blue", "light-blue", "yellow", "orange", "green", "light-green", "light-red", "red", "white");
+var Fill = Schema.Literal("none", "solid", "pattern");
+var Stroke = Schema.Literal("sketchy", "solid", "dashed", "dotted");
+var Weight = Schema.Literal("s", "m", "l", "xl");
+var Point = Schema.Struct({
+	x: Schema.Number,
+	y: Schema.Number
+});
+/** Style props shared by all elements; every field is optional with sensible defaults. */
+var styleFields = {
+	color: Schema.optional(Color).annotations({ description: "Stroke/text color." }),
+	fill: Schema.optional(Fill).annotations({ description: "Interior fill of closed shapes." }),
+	stroke: Schema.optional(Stroke).annotations({ description: "Stroke rendering; sketchy is hand-drawn." }),
+	weight: Schema.optional(Weight).annotations({ description: "Stroke weight / text size." })
+};
+var id = Schema.String.annotations({ description: "Stable element id, unique within the object (e.g. \"left-eye\"). Used to edit or delete the element." });
+/** Closed shape drawn inside a local bounding box. */
+var Box = Schema.Struct({
+	kind: Schema.Literal("rect", "ellipse", "diamond", "triangle"),
+	id,
+	x: Schema.Number.annotations({ description: "Left edge (object-local units)." }),
+	y: Schema.Number.annotations({ description: "Top edge (object-local units)." }),
+	w: Schema.Number,
+	h: Schema.Number,
+	rotation: Schema.optional(Schema.Number).annotations({ description: "Clockwise rotation in degrees." }),
+	text: Schema.optional(Schema.String).annotations({ description: "Centered label." }),
+	...styleFields
+});
+/** Circle sugar; reads back as an ellipse. */
+var Circle = Schema.Struct({
+	kind: Schema.Literal("circle"),
+	id,
+	cx: Schema.Number.annotations({ description: "Center x (object-local units)." }),
+	cy: Schema.Number.annotations({ description: "Center y (object-local units)." }),
+	r: Schema.Number,
+	text: Schema.optional(Schema.String),
+	...styleFields
+});
+/** Straight segment or open polyline through the given points. */
+var Polyline = Schema.Struct({
+	kind: Schema.Literal("line"),
+	id,
+	points: Schema.Array(Point).annotations({ description: "Two or more points (object-local units)." }),
+	closed: Schema.optional(Schema.Boolean).annotations({ description: "Close the path back to the first point." }),
+	...styleFields
+});
+/** Smooth curve through the given points (spline). */
+var Curve = Schema.Struct({
+	kind: Schema.Literal("curve"),
+	id,
+	points: Schema.Array(Point).annotations({ description: "Control points the curve passes through." }),
+	...styleFields
+});
+/**
+* Circular arc sugar; reads back as a curve. Angles are degrees, measured clockwise from
+* the positive x-axis in screen coordinates (y grows downward): 0–180 is the lower half
+* (a smile), 180–360 the upper half (a frown).
+*/
+var Arc = Schema.Struct({
+	kind: Schema.Literal("arc"),
+	id,
+	cx: Schema.Number,
+	cy: Schema.Number,
+	r: Schema.Number,
+	startAngle: Schema.Number,
+	endAngle: Schema.Number,
+	...styleFields
+});
+/** Free-standing text. */
+var Text = Schema.Struct({
+	kind: Schema.Literal("text"),
+	id,
+	x: Schema.Number,
+	y: Schema.Number,
+	w: Schema.optional(Schema.Number).annotations({ description: "Wrap width; omit for auto-size." }),
+	text: Schema.String,
+	...styleFields
+});
+/**
+* Connector. Endpoints are element refs — `"<elementId>"` within the same object or
+* `"<objectId>/<elementId>"` across objects — or explicit local points. Bound endpoints
+* track their target when it moves.
+*/
+var Arrow = Schema.Struct({
+	kind: Schema.Literal("arrow"),
+	id,
+	from: Schema.optional(Schema.String).annotations({ description: "Source element ref." }),
+	to: Schema.optional(Schema.String).annotations({ description: "Target element ref." }),
+	start: Schema.optional(Point).annotations({ description: "Explicit start (used when `from` is omitted)." }),
+	end: Schema.optional(Point).annotations({ description: "Explicit end (used when `to` is omitted)." }),
+	text: Schema.optional(Schema.String).annotations({ description: "Label at the arrow midpoint." }),
+	...styleFields
+});
+var Element = Schema.Union(Box, Circle, Polyline, Curve, Arc, Text, Arrow);
+/**
+* A semantic group of elements ("face", "hat") authored in its own local unit space.
+* `origin` (canvas px) and `scale` (px per unit) place it on the canvas:
+* `canvas = origin + local * scale`. On read, `origin` is derived as the top-left of the
+* object's bounding box, so the model survives users dragging shapes around.
+*/
+var WorldObject = Schema.Struct({
+	id: Schema.String.annotations({ description: "Stable object id naming the thing depicted (e.g. \"face\", \"hat\")." }),
+	origin: Schema.optional(Point).annotations({ description: "Canvas position (px). Omit on upsert to keep the current position." }),
+	scale: Schema.optional(Schema.Number).annotations({ description: "Canvas px per local unit (default 1)." }),
+	elements: Schema.Array(Element)
+});
+var Scene = Schema.Struct({ objects: Schema.Array(WorldObject) });
+var UpsertObject = Schema.Struct({
+	op: Schema.Literal("upsert-object"),
+	object: WorldObject
+}).annotations({ description: "Create an object, or replace an existing one wholesale (same id)." });
+var UpsertElements = Schema.Struct({
+	op: Schema.Literal("upsert-elements"),
+	objectId: Schema.String,
+	elements: Schema.Array(Element)
+}).annotations({ description: "Add elements to an existing object, replacing any with matching ids." });
+var RemoveElements = Schema.Struct({
+	op: Schema.Literal("remove-elements"),
+	objectId: Schema.String,
+	elementIds: Schema.Array(Schema.String)
+});
+var RemoveObject = Schema.Struct({
+	op: Schema.Literal("remove-object"),
+	objectId: Schema.String
+});
+var MoveObject = Schema.Struct({
+	op: Schema.Literal("move-object"),
+	objectId: Schema.String,
+	origin: Point.annotations({ description: "New canvas position (px) for the object top-left." })
+});
+var Command = Schema.Union(UpsertObject, UpsertElements, RemoveElements, RemoveObject, MoveObject);
+//#endregion
+//#region src/model/dialect.ts
+var __dxlog_file = "/Users/burdon/Code/dxos/dxos/.claude/worktrees/peaceful-allen-9b542f/packages/plugins/plugin-illustrator/src/model/dialect.ts";
+/** The core dialect: input is already scene edit commands (identity compile). */
+var sceneDialect = {
+	id: "scene",
+	description: "Positioned world objects and elements; the agent does the layout.",
+	input: Schema.Array(Command),
+	compile: Effect.succeed
+};
+var DialectRegistry = class {
+	#dialects = /* @__PURE__ */ new Map();
+	constructor(dialects = [sceneDialect]) {
+		dialects.forEach((dialect) => this.register(dialect));
+	}
+	register(dialect) {
+		invariant(!this.#dialects.has(dialect.id), `duplicate dialect: ${dialect.id}`, {
+			"~LogMeta": "~LogMeta",
+			F: __dxlog_file,
+			L: 42,
+			S: this,
+			A: ["!this.#dialects.has(dialect.id)", "`duplicate dialect: ${dialect.id}`"]
+		});
+		this.#dialects.set(dialect.id, dialect);
+	}
+	get(id) {
+		return this.#dialects.get(id);
+	}
+	list() {
+		return [...this.#dialects.values()];
+	}
+};
+//#endregion
+//#region src/model/index.ts
+var model_exports = /* @__PURE__ */ __exportAll({
+	DialectRegistry: () => DialectRegistry,
+	Scene: () => scene_exports,
+	sceneDialect: () => sceneDialect
+});
+//#endregion
+export { scene_exports as i, DialectRegistry as n, sceneDialect as r, model_exports as t };
+
+//# sourceMappingURL=chunk-model.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-model.mjs","names":[],"sources":["../../src/model/scene.ts","../../src/model/dialect.ts","../../src/model/index.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n//\n// Backend-neutral scene DSL: a diagram is a set of named world objects (\"face\", \"hat\"),\n// each composed of graphical elements (rect, ellipse, line, curve, text, arrow) authored\n// in object-local units. A backend compiler (tldraw today) maps the scene onto the\n// concrete canvas; see `render.ts` / `read.ts`.\n//\n\nimport * as Schema from 'effect/Schema';\n\nexport const Color = Schema.Literal(\n  'black',\n  'grey',\n  'light-violet',\n  'violet',\n  'blue',\n  'light-blue',\n  'yellow',\n  'orange',\n  'green',\n  'light-green',\n  'light-red',\n  'red',\n  'white',\n);\nexport type Color = Schema.Schema.Type<typeof Color>;\n\nexport const Fill = Schema.Literal('none', 'solid', 'pattern');\nexport type Fill = Schema.Schema.Type<typeof Fill>;\n\nexport const Stroke = Schema.Literal('sketchy', 'solid', 'dashed', 'dotted');\nexport type Stroke = Schema.Schema.Type<typeof Stroke>;\n\nexport const Weight = Schema.Literal('s', 'm', 'l', 'xl');\nexport type Weight = Schema.Schema.Type<typeof Weight>;\n\nexport const Point = Schema.Struct({\n  x: Schema.Number,\n  y: Schema.Number,\n});\nexport type Point = Schema.Schema.Type<typeof Point>;\n\n/** Style props shared by all elements; every field is optional with sensible defaults. */\nconst styleFields = {\n  color: Schema.optional(Color).annotations({ description: 'Stroke/text color.' }),\n  fill: Schema.optional(Fill).annotations({ description: 'Interior fill of closed shapes.' }),\n  stroke: Schema.optional(Stroke).annotations({ description: 'Stroke rendering; sketchy is hand-drawn.' }),\n  weight: Schema.optional(Weight).annotations({ description: 'Stroke weight / text size.' }),\n};\n\nconst id = Schema.String.annotations({\n  description: 'Stable element id, unique within the object (e.g. \"left-eye\"). Used to edit or delete the element.',\n});\n\n/** Closed shape drawn inside a local bounding box. */\nexport const Box = Schema.Struct({\n  kind: Schema.Literal('rect', 'ellipse', 'diamond', 'triangle'),\n  id,\n  x: Schema.Number.annotations({ description: 'Left edge (object-local units).' }),\n  y: Schema.Number.annotations({ description: 'Top edge (object-local units).' }),\n  w: Schema.Number,\n  h: Schema.Number,\n  rotation: Schema.optional(Schema.Number).annotations({ description: 'Clockwise rotation in degrees.' }),\n  text: Schema.optional(Schema.String).annotations({ description: 'Centered label.' }),\n  ...styleFields,\n});\nexport type Box = Schema.Schema.Type<typeof Box>;\n\n/** Circle sugar; reads back as an ellipse. */\nexport const Circle = Schema.Struct({\n  kind: Schema.Literal('circle'),\n  id,\n  cx: Schema.Number.annotations({ description: 'Center x (object-local units).' }),\n  cy: Schema.Number.annotations({ description: 'Center y (object-local units).' }),\n  r: Schema.Number,\n  text: Schema.optional(Schema.String),\n  ...styleFields,\n});\nexport type Circle = Schema.Schema.Type<typeof Circle>;\n\n/** Straight segment or open polyline through the given points. */\nexport const Polyline = Schema.Struct({\n  kind: Schema.Literal('line'),\n  id,\n  points: Schema.Array(Point).annotations({ description: 'Two or more points (object-local units).' }),\n  closed: Schema.optional(Schema.Boolean).annotations({ description: 'Close the path back to the first point.' }),\n  ...styleFields,\n});\nexport type Polyline = Schema.Schema.Type<typeof Polyline>;\n\n/** Smooth curve through the given points (spline). */\nexport const Curve = Schema.Struct({\n  kind: Schema.Literal('curve'),\n  id,\n  points: Schema.Array(Point).annotations({ description: 'Control points the curve passes through.' }),\n  ...styleFields,\n});\nexport type Curve = Schema.Schema.Type<typeof Curve>;\n\n/**\n * Circular arc sugar; reads back as a curve. Angles are degrees, measured clockwise from\n * the positive x-axis in screen coordinates (y grows downward): 0–180 is the lower half\n * (a smile), 180–360 the upper half (a frown).\n */\nexport const Arc = Schema.Struct({\n  kind: Schema.Literal('arc'),\n  id,\n  cx: Schema.Number,\n  cy: Schema.Number,\n  r: Schema.Number,\n  startAngle: Schema.Number,\n  endAngle: Schema.Number,\n  ...styleFields,\n});\nexport type Arc = Schema.Schema.Type<typeof Arc>;\n\n/** Free-standing text. */\nexport const Text = Schema.Struct({\n  kind: Schema.Literal('text'),\n  id,\n  x: Schema.Number,\n  y: Schema.Number,\n  w: Schema.optional(Schema.Number).annotations({ description: 'Wrap width; omit for auto-size.' }),\n  text: Schema.String,\n  ...styleFields,\n});\nexport type Text = Schema.Schema.Type<typeof Text>;\n\n/**\n * Connector. Endpoints are element refs — `\"<elementId>\"` within the same object or\n * `\"<objectId>/<elementId>\"` across objects — or explicit local points. Bound endpoints\n * track their target when it moves.\n */\nexport const Arrow = Schema.Struct({\n  kind: Schema.Literal('arrow'),\n  id,\n  from: Schema.optional(Schema.String).annotations({ description: 'Source element ref.' }),\n  to: Schema.optional(Schema.String).annotations({ description: 'Target element ref.' }),\n  start: Schema.optional(Point).annotations({ description: 'Explicit start (used when `from` is omitted).' }),\n  end: Schema.optional(Point).annotations({ description: 'Explicit end (used when `to` is omitted).' }),\n  text: Schema.optional(Schema.String).annotations({ description: 'Label at the arrow midpoint.' }),\n  ...styleFields,\n});\nexport type Arrow = Schema.Schema.Type<typeof Arrow>;\n\nexport const Element = Schema.Union(Box, Circle, Polyline, Curve, Arc, Text, Arrow);\nexport type Element = Schema.Schema.Type<typeof Element>;\n\n/**\n * A semantic group of elements (\"face\", \"hat\") authored in its own local unit space.\n * `origin` (canvas px) and `scale` (px per unit) place it on the canvas:\n * `canvas = origin + local * scale`. On read, `origin` is derived as the top-left of the\n * object's bounding box, so the model survives users dragging shapes around.\n */\nexport const WorldObject = Schema.Struct({\n  id: Schema.String.annotations({\n    description: 'Stable object id naming the thing depicted (e.g. \"face\", \"hat\").',\n  }),\n  origin: Schema.optional(Point).annotations({\n    description: 'Canvas position (px). Omit on upsert to keep the current position.',\n  }),\n  scale: Schema.optional(Schema.Number).annotations({ description: 'Canvas px per local unit (default 1).' }),\n  elements: Schema.Array(Element),\n});\nexport type WorldObject = Schema.Schema.Type<typeof WorldObject>;\n\nexport const Scene = Schema.Struct({\n  objects: Schema.Array(WorldObject),\n});\nexport type Scene = Schema.Schema.Type<typeof Scene>;\n\n//\n// Edit commands.\n//\n\nexport const UpsertObject = Schema.Struct({\n  op: Schema.Literal('upsert-object'),\n  object: WorldObject,\n}).annotations({ description: 'Create an object, or replace an existing one wholesale (same id).' });\n\nexport const UpsertElements = Schema.Struct({\n  op: Schema.Literal('upsert-elements'),\n  objectId: Schema.String,\n  elements: Schema.Array(Element),\n}).annotations({ description: 'Add elements to an existing object, replacing any with matching ids.' });\n\nexport const RemoveElements = Schema.Struct({\n  op: Schema.Literal('remove-elements'),\n  objectId: Schema.String,\n  elementIds: Schema.Array(Schema.String),\n});\n\nexport const RemoveObject = Schema.Struct({\n  op: Schema.Literal('remove-object'),\n  objectId: Schema.String,\n});\n\nexport const MoveObject = Schema.Struct({\n  op: Schema.Literal('move-object'),\n  objectId: Schema.String,\n  origin: Point.annotations({ description: 'New canvas position (px) for the object top-left.' }),\n});\n\nexport const Command = Schema.Union(UpsertObject, UpsertElements, RemoveElements, RemoveObject, MoveObject);\nexport type Command = Schema.Schema.Type<typeof Command>;\n","//\n// Copyright 2026 DXOS.org\n//\n\n//\n// Extension point for higher-level diagram languages (mermaid, d2, sequence, uml-class, …).\n// A dialect compiles its input into scene edit commands — owning any layout it needs — so its\n// output lands as ordinary world objects and stays editable by id. Mirrors the architecture\n// shared by Mermaid/D2/Kroki: dialect → intermediate positioned model → renderer.\n//\n\nimport * as Effect from 'effect/Effect';\nimport * as Schema from 'effect/Schema';\n\nimport { invariant } from '@dxos/invariant';\n\nimport * as Scene from './scene';\n\nexport type Dialect<Input = any> = {\n  id: string;\n  description: string;\n  input: Schema.Schema<Input, any>;\n  compile: (input: Input) => Effect.Effect<readonly Scene.Command[]>;\n};\n\n/** The core dialect: input is already scene edit commands (identity compile). */\nexport const sceneDialect: Dialect<readonly Scene.Command[]> = {\n  id: 'scene',\n  description: 'Positioned world objects and elements; the agent does the layout.',\n  input: Schema.Array(Scene.Command),\n  compile: Effect.succeed,\n};\n\nexport class DialectRegistry {\n  readonly #dialects = new Map<string, Dialect>();\n\n  constructor(dialects: Dialect[] = [sceneDialect]) {\n    dialects.forEach((dialect) => this.register(dialect));\n  }\n\n  register(dialect: Dialect): void {\n    invariant(!this.#dialects.has(dialect.id), `duplicate dialect: ${dialect.id}`);\n    this.#dialects.set(dialect.id, dialect);\n  }\n\n  get(id: string): Dialect | undefined {\n    return this.#dialects.get(id);\n  }\n\n  list(): Dialect[] {\n    return [...this.#dialects.values()];\n  }\n}\n","//\n// Copyright 2026 DXOS.org\n//\n\nexport * from './builder';\nexport * from './dialect';\nexport * as Scene from './scene';\n"],"mappings":"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"}

package/dist/lib/chunk-operation-handler.mjs

@@ -0,0 +1,11 @@
+import { Capabilities, Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { IllustratorOperationHandlerSet } from "#operations";
+//#region src/capabilities/operation-handler.ts
+var operation_handler_default = Capability.makeModule(Effect.fnUntraced(function* () {
+	return Capability.contributes(Capabilities.OperationHandler, IllustratorOperationHandlerSet);
+}));
+//#endregion
+export { operation_handler_default as default };
+
+//# sourceMappingURL=chunk-operation-handler.mjs.map

package/dist/lib/chunk-operation-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-operation-handler.mjs","names":[],"sources":["../../src/capabilities/operation-handler.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport type { OperationHandlerSet } from '@dxos/compute';\n\nimport { IllustratorOperationHandlerSet } from '#operations';\n\nexport default Capability.makeModule<OperationHandlerSet.OperationHandlerSet>(\n  Effect.fnUntraced(function* () {\n    return Capability.contributes(Capabilities.OperationHandler, IllustratorOperationHandlerSet);\n  }),\n);\n"],"mappings":";;;;AAWA,IAAA,4BAAe,WAAW,WACxB,OAAO,WAAW,aAAa;CAC7B,OAAO,WAAW,YAAY,aAAa,kBAAkB,8BAA8B;AAC7F,CAAC,CACH"}

package/dist/lib/chunk-react-surface.mjs

@@ -0,0 +1,31 @@
+import { a as Sketch } from "./chunk-types.mjs";
+import { Capabilities, Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import "react";
+import { Surface } from "@dxos/app-framework/ui";
+import { jsx } from "react/jsx-runtime";
+import { AppSurface } from "@dxos/app-toolkit/ui";
+import { SketchArticle, SketchCard } from "#containers";
+//#region src/capabilities/react-surface.tsx
+var react_surface_default = Capability.makeModule(() => Effect.succeed(Capability.contributes(Capabilities.ReactSurface, [Surface.create({
+	id: "sketch",
+	filter: AppSurface.oneOf(AppSurface.object(AppSurface.Article, Sketch), AppSurface.object(AppSurface.Section, Sketch), AppSurface.object(AppSurface.Slide, Sketch)),
+	component: ({ data: { subject, attendableId, extrinsic }, role }) => /* @__PURE__ */ jsx(SketchArticle, {
+		role,
+		subject,
+		attendableId,
+		extrinsic
+	})
+}), Surface.create({
+	id: "sketchCard",
+	filter: AppSurface.object(AppSurface.CardContent, Sketch),
+	component: ({ data, role }) => /* @__PURE__ */ jsx(SketchCard, {
+		role,
+		subject: data.subject,
+		editable: data.editable
+	})
+})])));
+//#endregion
+export { react_surface_default as default };
+
+//# sourceMappingURL=chunk-react-surface.mjs.map

package/dist/lib/chunk-react-surface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-react-surface.mjs","names":[],"sources":["../../src/capabilities/react-surface.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\nimport React from 'react';\n\nimport { Capabilities, Capability } from '@dxos/app-framework';\nimport { Surface } from '@dxos/app-framework/ui';\nimport { AppSurface } from '@dxos/app-toolkit/ui';\n\nimport { SketchArticle, SketchCard } from '#containers';\n\nimport { Sketch } from '../types';\n\nexport default Capability.makeModule(() =>\n  Effect.succeed(\n    Capability.contributes(Capabilities.ReactSurface, [\n      Surface.create({\n        id: 'sketch',\n        filter: AppSurface.oneOf(\n          AppSurface.object(AppSurface.Article, Sketch.Sketch),\n          AppSurface.object(AppSurface.Section, Sketch.Sketch),\n          AppSurface.object(AppSurface.Slide, Sketch.Sketch),\n        ),\n        component: ({ data: { subject, attendableId, extrinsic }, role }) => (\n          <SketchArticle role={role} subject={subject} attendableId={attendableId} extrinsic={extrinsic} />\n        ),\n      }),\n      Surface.create({\n        id: 'sketchCard',\n        filter: AppSurface.object(AppSurface.CardContent, Sketch.Sketch),\n        component: ({ data, role }) => <SketchCard role={role} subject={data.subject} editable={data.editable} />,\n      }),\n    ]),\n  ),\n);\n"],"mappings":";;;;;;;;;AAeA,IAAA,wBAAe,WAAW,iBACxB,OAAO,QACL,WAAW,YAAY,aAAa,cAAc,CAChD,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,WAAW,MACjB,WAAW,OAAO,WAAW,SAAS,MAAa,GACnD,WAAW,OAAO,WAAW,SAAS,MAAa,GACnD,WAAW,OAAO,WAAW,OAAO,MAAa,CACnD;CACA,YAAY,EAAE,MAAM,EAAE,SAAS,cAAc,aAAa,WACxD,oBAAC,eAAD;EAAqB;EAAe;EAAuB;EAAyB;CAAY,CAAA;AAEpG,CAAC,GACD,QAAQ,OAAO;CACb,IAAI;CACJ,QAAQ,WAAW,OAAO,WAAW,aAAa,MAAa;CAC/D,YAAY,EAAE,MAAM,WAAW,oBAAC,YAAD;EAAkB;EAAM,SAAS,KAAK;EAAS,UAAU,KAAK;CAAW,CAAA;AAC1G,CAAC,CACH,CAAC,CACH,CACF"}

package/dist/lib/chunk-read.mjs

@@ -0,0 +1,13 @@
+import { r as Read } 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/read.ts
+var handler = Read.pipe(Operation.withHandler(Effect.fn(function* ({ sketch }) {
+	const { canvas, variant } = yield* resolveVariant(sketch);
+	return variant.builder.read(canvas);
+})));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-read.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-read.mjs","names":[],"sources":["../../src/operations/read.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.Read> = SketchOperation.Read.pipe(\n  Operation.withHandler(\n    Effect.fn(function* ({ sketch }) {\n      const { canvas, variant } = yield* resolveVariant(sketch);\n      return variant.builder.read(canvas);\n    }),\n  ),\n);\n\nexport default handler;\n"],"mappings":";;;;;AAWA,IAAM,UAAA,KAAmF,KACvF,UAAU,YACR,OAAO,GAAG,WAAW,EAAE,UAAU;CAC/B,MAAM,EAAE,QAAQ,YAAY,OAAO,eAAe,MAAM;CACxD,OAAO,QAAQ,QAAQ,KAAK,MAAM;AACpC,CAAC,CACH,CACF"}

package/dist/lib/chunk-rolldown-runtime.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/lib/chunk-skill-definition.mjs

@@ -0,0 +1,10 @@
+import { Capability } from "@dxos/app-framework";
+import * as Effect from "effect/Effect";
+import { AppCapabilities } from "@dxos/app-toolkit";
+import { SketchSkill } from "#skills";
+//#region src/capabilities/skill-definition.ts
+var skillDefinition = () => Effect.succeed([Capability.contributes(AppCapabilities.SkillDefinition, SketchSkill)]);
+//#endregion
+export { skillDefinition as default };
+
+//# sourceMappingURL=chunk-skill-definition.mjs.map

package/dist/lib/chunk-skill-definition.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-skill-definition.mjs","names":[],"sources":["../../src/capabilities/skill-definition.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';\n\nimport { SketchSkill } from '#skills';\n\nconst skillDefinition = () => Effect.succeed([Capability.contributes(AppCapabilities.SkillDefinition, SketchSkill)]);\n\nexport default skillDefinition;\n"],"mappings":";;;;;AAWA,IAAM,wBAAwB,OAAO,QAAQ,CAAC,WAAW,YAAY,gBAAgB,iBAAiB,WAAW,CAAC,CAAC"}

package/dist/lib/chunk-skills.mjs

@@ -0,0 +1,65 @@
+import { trim } from "@dxos/util";
+import { Skill, Template } from "@dxos/compute";
+import { SketchOperation } from "#types";
+//#region src/skills/sketch-skill.ts
+var SKILL_KEY = "org.dxos.skill.sketch";
+var operations = [
+	SketchOperation.Create,
+	SketchOperation.Read,
+	SketchOperation.Edit
+];
+var make = () => Skill.make({
+	key: SKILL_KEY,
+	name: "Sketch",
+	tools: Skill.toolDefinitions({ operations }),
+	instructions: Template.make({ source: trim`
+        {{! Sketch }}
+
+        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 sketch exists in context, create one first.
+        2. ALWAYS call read before editing an existing sketch — 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.
+      ` })
+});
+var skill = {
+	key: SKILL_KEY,
+	make
+};
+//#endregion
+export { skill as t };
+
+//# sourceMappingURL=chunk-skills.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-skills.mjs","names":[],"sources":["../../src/skills/sketch-skill.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport { Skill, Template } from '@dxos/compute';\nimport { trim } from '@dxos/util';\n\nimport { SketchOperation } from '#types';\n\nconst SKILL_KEY = 'org.dxos.skill.sketch';\n\nconst operations = [SketchOperation.Create, SketchOperation.Read, SketchOperation.Edit];\n\nconst make = () =>\n  Skill.make({\n    key: SKILL_KEY,\n    name: 'Sketch',\n    tools: Skill.toolDefinitions({ operations }),\n    instructions: Template.make({\n      source: trim`\n        {{! Sketch }}\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 sketch exists in context, create one first.\n        2. ALWAYS call read before editing an existing sketch — 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\nconst skill: Skill.Definition = {\n  key: SKILL_KEY,\n  make,\n};\n\nexport default skill;\n"],"mappings":";;;;AASA,IAAM,YAAY;AAElB,IAAM,aAAa;CAAC,gBAAgB;CAAQ,gBAAgB;CAAM,gBAAgB;AAAI;AAEtF,IAAM,aACJ,MAAM,KAAK;CACT,KAAK;CACL,MAAM;CACN,OAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC;CAC3C,cAAc,SAAS,KAAK,EAC1B,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0Cd,CAAC;AACH,CAAC;AAEH,IAAM,QAA0B;CAC9B,KAAK;CACL;AACF"}

package/dist/lib/chunk-types.mjs

@@ -0,0 +1,108 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import "./chunk-IllustratorCapabilities.mjs";
+import { Capability } from "@dxos/app-framework";
+import * as Schema from "effect/Schema";
+import { Operation } from "@dxos/compute";
+import { meta } from "#meta";
+import { Annotation, DXN, Database, Obj, Ref, Type } from "@dxos/echo";
+import { FormInputAnnotation, LabelAnnotation } from "@dxos/echo/Annotation";
+import { CardAnnotation, CollectionItemAnnotation } from "@dxos/schema";
+import { DXN as DXN$1 } from "@dxos/keys";
+import { Scene } from "#model";
+//#region src/types/Sketch.ts
+var Sketch_exports = /* @__PURE__ */ __exportAll({
+	Sketch: () => Sketch,
+	SketchRef: () => SketchRef,
+	isSketch: () => isSketch,
+	make: () => make
+});
+/**
+* Base Sketch object. Renderer-specific canvas data lives in a separate referenced object.
+* Unifies all canvas renderers (tldraw, excalidraw, ...) under one typename so they share
+* graph node, create flow, and shared surface scaffolding.
+*/
+var Sketch = class extends Type.makeObject(DXN.make("org.dxos.type.sketch", "0.1.0"))(Schema.Struct({
+	name: Schema.optional(Schema.String),
+	canvas: Ref.Ref(Obj.Unknown).annotations({ description: "Reference to the renderer-specific canvas object." }).pipe(FormInputAnnotation.set(false))
+}).pipe(LabelAnnotation.set(["name"]), Annotation.IconAnnotation.set({
+	icon: "ph--compass-tool--regular",
+	hue: "indigo"
+}), CardAnnotation.set(true), CollectionItemAnnotation.set(true))) {};
+var SketchRef = (_canvasType) => Ref.Ref(Sketch);
+/**
+* Build a base `Sketch` object referencing the given canvas ECHO object.
+*
+* The canvas is stored as a `Ref` so the renderer-specific data (e.g. `Tldraw.Canvas`,
+* `Excalidraw.Canvas`) lives as its own ECHO object alongside the Sketch.
+*
+* @param name Optional display name shown in the graph node and Properties form.
+* @param canvas Renderer-specific canvas object.
+* @returns A new `Sketch` object with `canvas` stored as a Ref.
+*/
+var make = ({ name, canvas }) => {
+	return Obj.make(Sketch, {
+		name,
+		canvas: Ref.make(canvas)
+	});
+};
+/** Type guard for {@link Sketch} objects. */
+var isSketch = (object) => Obj.instanceOf(Sketch, object);
+//#endregion
+//#region src/types/SketchOperation.ts
+var SketchOperation_exports = /* @__PURE__ */ __exportAll({
+	Create: () => Create,
+	Edit: () => Edit,
+	Read: () => Read
+});
+var makeKey = (name) => DXN$1.make(`${meta.profile.key}.operation.${name}`);
+var Create = Operation.make({
+	meta: {
+		key: makeKey("create"),
+		name: "Create Sketch",
+		icon: "ph--pencil-simple--regular"
+	},
+	input: Schema.Struct({
+		name: Schema.optional(Schema.String),
+		variant: Schema.optional(Schema.String).annotations({ description: "Variant id (canvas typename); defaults to the first registered variant." })
+	}),
+	output: Schema.Struct({ object: Type.getSchema(Sketch) }),
+	services: [Capability.Service, Database.Service]
+});
+/** The scene as derived from the live canvas. */
+var SceneOutput = {
+	scene: Scene.Scene.annotations({ description: "The diagram as world objects with object-local coordinates." }),
+	unmanaged: Schema.Number.annotations({ description: "Number of shapes on the canvas not managed by the DSL (drawn by users)." })
+};
+var Read = Operation.make({
+	meta: {
+		key: makeKey("read"),
+		name: "Read Sketch",
+		description: "Returns the current scene of a sketch: world objects (by id) with their elements in object-local units. Call before editing an existing sketch.",
+		icon: "ph--eye--regular"
+	},
+	input: Schema.Struct({ sketch: Ref.Ref(Sketch).annotations({ description: "The sketch to read." }) }),
+	output: Schema.Struct(SceneOutput),
+	services: [Capability.Service, Database.Service]
+});
+var Edit = Operation.make({
+	meta: {
+		key: makeKey("edit"),
+		name: "Edit Sketch",
+		description: "Applies scene commands to a sketch: upsert/move/remove world objects or individual elements by id. Returns the resulting scene.",
+		icon: "ph--pencil-simple-line--regular"
+	},
+	input: Schema.Struct({
+		sketch: Ref.Ref(Sketch).annotations({ description: "The sketch to edit." }),
+		commands: Schema.Array(Scene.Command).annotations({ description: "Commands applied in order, atomically." })
+	}),
+	output: Schema.Struct({
+		...SceneOutput,
+		upserted: Schema.Array(Schema.String).annotations({ description: "Object ids created or modified." }),
+		removed: Schema.Number.annotations({ description: "Number of shapes removed." })
+	}),
+	services: [Capability.Service, Database.Service]
+});
+//#endregion
+export { Sketch as a, SketchOperation_exports as i, Edit as n, Sketch_exports as o, Read as r, make as s, Create as t };
+
+//# sourceMappingURL=chunk-types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-types.mjs","names":[],"sources":["../../src/types/Sketch.ts","../../src/types/SketchOperation.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, LabelAnnotation } from '@dxos/echo/Annotation';\nimport { CardAnnotation, CollectionItemAnnotation } from '@dxos/schema';\n\n/**\n * Base Sketch object. Renderer-specific canvas data lives in a separate referenced object.\n * Unifies all canvas renderers (tldraw, excalidraw, ...) under one typename so they share\n * graph node, create flow, and shared surface scaffolding.\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(Obj.Unknown)\n      .annotations({ description: 'Reference to the renderer-specific canvas object.' })\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 * Variant-narrowed reference to a Sketch.\n *\n * Encodes — at the type level — that the canvas ref points to a specific canvas type.\n * Runtime narrowing is performed by `loadSketch(ref, canvasType)` which validates and\n * returns the resolved Sketch together with its typed canvas.\n *\n * @example\n * ```ts\n * input: Schema.Struct({\n *   sketch: SketchRef(Tldraw.Canvas),\n * }),\n * // handler:\n * const { sketch, canvas } = yield* loadSketch(input.sketch, Tldraw.Canvas);\n * // `canvas` is typed as Tldraw.Canvas.\n * ```\n */\nexport type SketchRef<_V> = Ref.Ref<Sketch>;\n\nexport const SketchRef = <S extends Type.AnyObj>(_canvasType: S) =>\n  Ref.Ref(Sketch) as Schema.Schema<SketchRef<Type.InstanceType<S>>, any, never>;\n\n/**\n * Build a base `Sketch` object referencing the given canvas ECHO object.\n *\n * The canvas is stored as a `Ref` so the renderer-specific data (e.g. `Tldraw.Canvas`,\n * `Excalidraw.Canvas`) lives as its own ECHO object alongside the Sketch.\n *\n * @param name Optional display name shown in the graph node and Properties form.\n * @param canvas Renderer-specific canvas object.\n * @returns A new `Sketch` object with `canvas` stored as a Ref.\n */\nexport const make = ({ name, canvas }: { name?: string; canvas: Obj.Unknown }): Sketch => {\n  return Obj.make(Sketch, { name, canvas: Ref.make(canvas) });\n};\n\n/** Type guard for {@link Sketch} objects. */\nexport const isSketch = (object: unknown): object is Sketch => Obj.instanceOf(Sketch, object);\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Capability } from '@dxos/app-framework';\nimport { Operation } from '@dxos/compute';\nimport { Database, Ref, Type } from '@dxos/echo';\nimport { DXN } from '@dxos/keys';\n\nimport { meta } from '#meta';\nimport { Scene } from '#model';\n\nimport * as Sketch from './Sketch';\n\nconst makeKey = (name: string) => DXN.make(`${meta.profile.key}.operation.${name}`);\n\nexport const Create = Operation.make({\n  meta: { key: makeKey('create'), name: 'Create Sketch', icon: 'ph--pencil-simple--regular' },\n  input: Schema.Struct({\n    name: Schema.optional(Schema.String),\n    variant: Schema.optional(Schema.String).annotations({\n      description: 'Variant id (canvas typename); defaults to the first registered variant.',\n    }),\n  }),\n  output: Schema.Struct({\n    object: Type.getSchema(Sketch.Sketch),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n\n/** The scene as derived from the live canvas. */\nconst SceneOutput = {\n  scene: Scene.Scene.annotations({ description: 'The diagram as world objects with object-local coordinates.' }),\n  unmanaged: Schema.Number.annotations({\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: makeKey('read'),\n    name: 'Read Sketch',\n    description:\n      'Returns the current scene of a sketch: world objects (by id) with their elements in object-local units. Call before editing an existing sketch.',\n    icon: 'ph--eye--regular',\n  },\n  input: Schema.Struct({\n    sketch: Ref.Ref(Sketch.Sketch).annotations({ description: 'The sketch 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: makeKey('edit'),\n    name: 'Edit Sketch',\n    description:\n      'Applies scene commands to a sketch: 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    sketch: Ref.Ref(Sketch.Sketch).annotations({ description: 'The sketch to edit.' }),\n    commands: Schema.Array(Scene.Command).annotations({ description: 'Commands applied in order, atomically.' }),\n  }),\n  output: Schema.Struct({\n    ...SceneOutput,\n    upserted: Schema.Array(Schema.String).annotations({ description: 'Object ids created or modified.' }),\n    removed: Schema.Number.annotations({ description: 'Number of shapes removed.' }),\n  }),\n  services: [Capability.Service, Database.Service],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAiBA,IAAa,SAAb,cAA4B,KAAK,WAAmB,IAAI,KAAK,wBAAwB,OAAO,CAAC,CAAC,CAC5F,OAAO,OAAO;CACZ,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAA,CACxB,YAAY,EAAE,aAAa,oDAAoD,CAAC,CAAA,CAChF,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;AAqBH,IAAa,aAAoC,gBAC/C,IAAI,IAAI,MAAM;;;;;;;;;;;AAYhB,IAAa,QAAQ,EAAE,MAAM,aAA6D;CACxF,OAAO,IAAI,KAAK,QAAQ;EAAE;EAAM,QAAQ,IAAI,KAAK,MAAM;CAAE,CAAC;AAC5D;;AAGA,IAAa,YAAY,WAAsC,IAAI,WAAW,QAAQ,MAAM;;;;;;;;AClD5F,IAAM,WAAW,SAAiB,MAAI,KAAK,GAAG,KAAK,QAAQ,IAAI,aAAa,MAAM;AAElF,IAAa,SAAS,UAAU,KAAK;CACnC,MAAM;EAAE,KAAK,QAAQ,QAAQ;EAAG,MAAM;EAAiB,MAAM;CAA6B;CAC1F,OAAO,OAAO,OAAO;EACnB,MAAM,OAAO,SAAS,OAAO,MAAM;EACnC,SAAS,OAAO,SAAS,OAAO,MAAM,CAAC,CAAC,YAAY,EAClD,aAAa,0EACf,CAAC;CACH,CAAC;CACD,QAAQ,OAAO,OAAO,EACpB,QAAQ,KAAK,UAAU,MAAa,EACtC,CAAC;CACD,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC;;AAGD,IAAM,cAAc;CAClB,OAAO,MAAM,MAAM,YAAY,EAAE,aAAa,8DAA8D,CAAC;CAC7G,WAAW,OAAO,OAAO,YAAY,EACnC,aAAa,0EACf,CAAC;AACH;AAEA,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,QAAQ,MAAM;EACnB,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO,EACnB,QAAQ,IAAI,IAAI,MAAa,CAAC,CAAC,YAAY,EAAE,aAAa,sBAAsB,CAAC,EACnF,CAAC;CACD,QAAQ,OAAO,OAAO,WAAW;CACjC,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC;AAED,IAAa,OAAO,UAAU,KAAK;CACjC,MAAM;EACJ,KAAK,QAAQ,MAAM;EACnB,MAAM;EACN,aACE;EACF,MAAM;CACR;CACA,OAAO,OAAO,OAAO;EACnB,QAAQ,IAAI,IAAI,MAAa,CAAC,CAAC,YAAY,EAAE,aAAa,sBAAsB,CAAC;EACjF,UAAU,OAAO,MAAM,MAAM,OAAO,CAAC,CAAC,YAAY,EAAE,aAAa,yCAAyC,CAAC;CAC7G,CAAC;CACD,QAAQ,OAAO,OAAO;EACpB,GAAG;EACH,UAAU,OAAO,MAAM,OAAO,MAAM,CAAC,CAAC,YAAY,EAAE,aAAa,kCAAkC,CAAC;EACpG,SAAS,OAAO,OAAO,YAAY,EAAE,aAAa,4BAA4B,CAAC;CACjF,CAAC;CACD,UAAU,CAAC,WAAW,SAAS,SAAS,OAAO;AACjD,CAAC"}

package/dist/lib/components.mjs

@@ -0,0 +1,45 @@
+import { IllustratorCapabilities } from "#types";
+import { meta } from "#meta";
+import { useCallback, useMemo } from "react";
+import { useCapabilities } from "@dxos/app-framework/ui";
+import { useTranslation } from "@dxos/react-ui";
+import { SearchList, useSearchListResults } from "@dxos/react-ui-search";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/CreateSketchPanel.tsx
+/**
+* Variant picker for sketches (SearchList over contributed `SketchVariant[]`).
+* On select, calls `onCreateObject({ variantId })`; plugin-illustrator's
+* CreateObjectEntry.createObject resolves the variantId, builds the canvas via
+* variant.createCanvas, then wraps it in a Sketch.
+*/
+var CreateSketchPanel = ({ onCreateObject, variants: variantsProp }) => {
+	const { t } = useTranslation(meta.profile.key);
+	const capabilityVariants = useCapabilities(IllustratorCapabilities.VariantProvider);
+	const variants = variantsProp ?? capabilityVariants;
+	const { results, handleSearch } = useSearchListResults({
+		items: useMemo(() => [...variants].sort((a, b) => a.label.localeCompare(b.label)), [variants]),
+		extract: (variant) => variant.label
+	});
+	const handleSelect = useCallback((id) => {
+		if (!variants.find((entry) => entry.id === id)) return;
+		onCreateObject({ variantId: id });
+	}, [variants, onCreateObject]);
+	return /* @__PURE__ */ jsxs(SearchList.Root, {
+		onSearch: handleSearch,
+		children: [/* @__PURE__ */ jsx(SearchList.Input, {
+			classNames: "mb-form-gap",
+			autoFocus: true,
+			"data-testid": "create-sketch-panel.variant-input",
+			placeholder: t("create-panel.variant.placeholder")
+		}), /* @__PURE__ */ jsx(SearchList.Viewport, { children: results.map((variant) => /* @__PURE__ */ jsx(SearchList.Item, {
+			value: variant.id,
+			label: variant.label,
+			icon: variant.icon ?? "ph--compass-tool--regular",
+			onSelect: () => handleSelect(variant.id)
+		}, variant.id)) })]
+	});
+};
+//#endregion
+export { CreateSketchPanel };
+
+//# sourceMappingURL=components.mjs.map

package/dist/lib/components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","names":[],"sources":["../../src/components/CreateSketchPanel.tsx"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport React, { useCallback, useMemo } from 'react';\n\nimport { useCapabilities } from '@dxos/app-framework/ui';\nimport { type SpaceCapabilities } from '@dxos/plugin-space';\nimport { useTranslation } from '@dxos/react-ui';\nimport { SearchList, useSearchListResults } from '@dxos/react-ui-search';\n\nimport { meta } from '#meta';\nimport { IllustratorCapabilities, type SketchVariant } from '#types';\n\nexport type CreateSketchPanelProps = SpaceCapabilities.CreateObjectCustomPanelProps & {\n  /** Optional override (primarily for stories/tests). Defaults to IllustratorCapabilities.VariantProvider. */\n  variants?: SketchVariant[];\n};\n\n/**\n * Variant picker for sketches (SearchList over contributed `SketchVariant[]`).\n * On select, calls `onCreateObject({ variantId })`; plugin-illustrator's\n * CreateObjectEntry.createObject resolves the variantId, builds the canvas via\n * variant.createCanvas, then wraps it in a Sketch.\n */\nexport const CreateSketchPanel = ({ onCreateObject, variants: variantsProp }: CreateSketchPanelProps) => {\n  const { t } = useTranslation(meta.profile.key);\n  const capabilityVariants = useCapabilities(IllustratorCapabilities.VariantProvider);\n  const variants = variantsProp ?? capabilityVariants;\n  const sorted = useMemo(() => [...variants].sort((a, b) => a.label.localeCompare(b.label)), [variants]);\n  const { results, handleSearch } = useSearchListResults({\n    items: sorted,\n    extract: (variant) => variant.label,\n  });\n\n  const handleSelect = useCallback(\n    (id: string) => {\n      const variant = variants.find((entry) => entry.id === id);\n      if (!variant) {\n        return;\n      }\n      void onCreateObject({ variantId: id });\n    },\n    [variants, onCreateObject],\n  );\n\n  return (\n    <SearchList.Root onSearch={handleSearch}>\n      <SearchList.Input\n        classNames='mb-form-gap'\n        autoFocus\n        data-testid='create-sketch-panel.variant-input'\n        placeholder={t('create-panel.variant.placeholder')}\n      />\n      <SearchList.Viewport>\n        {results.map((variant) => (\n          <SearchList.Item\n            key={variant.id}\n            value={variant.id}\n            label={variant.label}\n            icon={variant.icon ?? 'ph--compass-tool--regular'}\n            onSelect={() => handleSelect(variant.id)}\n          />\n        ))}\n      </SearchList.Viewport>\n    </SearchList.Root>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;AAyBA,IAAa,qBAAqB,EAAE,gBAAgB,UAAU,mBAA2C;CACvG,MAAM,EAAE,MAAM,eAAe,KAAK,QAAQ,GAAG;CAC7C,MAAM,qBAAqB,gBAAgB,wBAAwB,eAAe;CAClF,MAAM,WAAW,gBAAgB;CAEjC,MAAM,EAAE,SAAS,iBAAiB,qBAAqB;EACrD,OAFa,cAAc,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAE3F;EACP,UAAU,YAAY,QAAQ;CAChC,CAAC;CAED,MAAM,eAAe,aAClB,OAAe;EAEd,IAAI,CADY,SAAS,MAAM,UAAU,MAAM,OAAO,EACjD,GACH;EAEF,eAAoB,EAAE,WAAW,GAAG,CAAC;CACvC,GACA,CAAC,UAAU,cAAc,CAC3B;CAEA,OACE,qBAAC,WAAW,MAAZ;EAAiB,UAAU;YAA3B,CACE,oBAAC,WAAW,OAAZ;GACE,YAAW;GACX,WAAA;GACA,eAAY;GACZ,aAAa,EAAE,kCAAkC;EAClD,CAAA,GACD,oBAAC,WAAW,UAAZ,EAAA,UACG,QAAQ,KAAK,YACZ,oBAAC,WAAW,MAAZ;GAEE,OAAO,QAAQ;GACf,OAAO,QAAQ;GACf,MAAM,QAAQ,QAAQ;GACtB,gBAAgB,aAAa,QAAQ,EAAE;EACxC,GALM,QAAQ,EAKd,CACF,EACkB,CAAA,CACN;;AAErB"}