@pixerate/editor 0.80.0 → 0.82.0

package/dist/{chunk-HXDMZQTD.cjs → chunk-TPOT575P.cjs}

@@ -462,6 +462,10 @@ function createComponentCommands(controller, options = {}) {
     ...hasVariantCommands(controller) ? variantCommands(controller, prefix, base) : []
   ];
 }
+function orFail(changed, message) {
+  if (!changed) throw new Error(message);
+  return true;
+}
 function createSpreadsheetCommands(controller, options = {}) {
   const prefix = _nullishCoalesce(options.prefix, () => ( "spreadsheet."));
   const scope = options.scope === null ? void 0 : _nullishCoalesce(options.scope, () => ( "spreadsheet"));
@@ -478,9 +482,30 @@ function createSpreadsheetCommands(controller, options = {}) {
       run: () => controller.clearFilters()
     },
     { ...base, id: `${prefix}unhideAll`, label: "Unhide All Rows and Columns", keywords: ["show", "hidden"], run: () => controller.unhideAll() },
-    { ...base, id: `${prefix}mergeCells`, label: "Merge Cells", keywords: ["combine"], enabled: hasRange, run: () => controller.mergeCells() },
-    { ...base, id: `${prefix}unmergeCells`, label: "Unmerge Cells", keywords: ["split"], enabled: hasRange, run: () => controller.unmergeCells() },
-    { ...base, id: `${prefix}transposeRange`, label: "Transpose Range", keywords: ["rotate", "swap rows columns"], enabled: hasRange, run: () => controller.transposeRange() }
+    {
+      ...base,
+      id: `${prefix}mergeCells`,
+      label: "Merge Cells",
+      keywords: ["combine"],
+      enabled: hasRange,
+      run: () => orFail(controller.mergeCells(), "Cannot merge the selection: it is a single cell, or it partly overlaps a merge or a spill range.")
+    },
+    {
+      ...base,
+      id: `${prefix}unmergeCells`,
+      label: "Unmerge Cells",
+      keywords: ["split"],
+      enabled: hasRange,
+      run: () => orFail(controller.unmergeCells(), "There are no merged cells in the selection.")
+    },
+    {
+      ...base,
+      id: `${prefix}transposeRange`,
+      label: "Transpose Range",
+      keywords: ["rotate", "swap rows columns"],
+      enabled: hasRange,
+      run: () => orFail(controller.transposeRange(), "Cannot transpose the selection: it is a single cell, or a merge or a spill range is in the way.")
+    }
   ];
 }
 
@@ -494,4 +519,4 @@ function createSpreadsheetCommands(controller, options = {}) {
 
 
 exports.DEFAULT_HISTORY_SHORTCUTS = DEFAULT_HISTORY_SHORTCUTS; exports.createHistoryCommands = createHistoryCommands; exports.matchHistoryShortcut = matchHistoryShortcut; exports.createArrangeCommands = createArrangeCommands; exports.createShapeCommands = createShapeCommands; exports.hasVariantCommands = hasVariantCommands; exports.createComponentCommands = createComponentCommands; exports.createSpreadsheetCommands = createSpreadsheetCommands;
-//# sourceMappingURL=chunk-HXDMZQTD.cjs.map
+//# sourceMappingURL=chunk-TPOT575P.cjs.map

package/dist/{chunk-IB3ZHQAX.js.map → chunk-TPOT575P.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/builtins.ts"],"sourcesContent":["import type { HistoryState } from '../history/types.js';\nimport type { CanvasArrangeAction } from '../canvas/arrangeShortcuts.js';\nimport type { AlignEdge, DistributeAxis, DistributeMode, ZOrderOperation } from '../canvas/arrange.js';\nimport { DEFAULT_ARRANGE_SHORTCUTS } from '../canvas/arrangeShortcuts.js';\nimport type { CommandParamsSchema, CommandSpec } from './registry.js';\nimport { ShortcutMap, type ShortcutBinding } from './shortcuts.js';\nimport type { KeyboardEventLike, Platform } from './chords.js';\n\n// ---------------------------------------------------------------------------\n// History\n// ---------------------------------------------------------------------------\n\n/** Minimal history surface (`HistoryManager` satisfies it). */\nexport interface HistoryCommandTarget {\n\tundo(): boolean | void;\n\tredo(): boolean | void;\n\tgetState(): Pick<HistoryState, 'canUndo' | 'canRedo'> & Partial<Pick<HistoryState, 'undoName' | 'redoName'>>;\n}\n\n/** Default history bindings: `Mod+Z` undo; `Mod+Shift+Z` redo, plus `Mod+Y` off macOS. */\nexport const DEFAULT_HISTORY_SHORTCUTS: readonly ShortcutBinding[] = [\n\t{ command: 'undo', chord: 'Mod+Z' },\n\t{ command: 'redo', chord: 'Mod+Shift+Z' },\n\t{ command: 'redo', chord: 'Mod+Y', platforms: ['windows', 'linux'] }\n];\n\nexport interface HistoryCommandOptions {\n\t/** Id prefix (default `history.`). */\n\tprefix?: string;\n\tgroup?: string;\n\tscope?: string;\n}\n\n/** `history.undo` / `history.redo` commands for a `HistoryManager` (disabled with a reason when empty). */\nexport function createHistoryCommands(history: HistoryCommandTarget, options: HistoryCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'history.';\n\tconst group = options.group ?? 'Edit';\n\tconst shortcutsOf = (command: 'undo' | 'redo') =>\n\t\tDEFAULT_HISTORY_SHORTCUTS.filter((b) => b.command === command).map(({ command: _c, ...rest }) => rest);\n\treturn [\n\t\t{\n\t\t\tid: `${prefix}undo`,\n\t\t\tlabel: 'Undo',\n\t\t\tgroup,\n\t\t\tkeywords: ['revert', 'back'],\n\t\t\tdescription: 'Reverts the last change.',\n\t\t\tshortcut: shortcutsOf('undo'),\n\t\t\t...(options.scope ? { scope: options.scope } : {}),\n\t\t\tenabled: () => (history.getState().canUndo ? true : 'Nothing to undo.'),\n\t\t\trun: () => {\n\t\t\t\thistory.undo();\n\t\t\t\treturn { undone: true, state: history.getState() };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tid: `${prefix}redo`,\n\t\t\tlabel: 'Redo',\n\t\t\tgroup,\n\t\t\tkeywords: ['repeat', 'forward'],\n\t\t\tdescription: 'Re-applies the last undone change.',\n\t\t\tshortcut: shortcutsOf('redo'),\n\t\t\t...(options.scope ? { scope: options.scope } : {}),\n\t\t\tenabled: () => (history.getState().canRedo ? true : 'Nothing to redo.'),\n\t\t\trun: () => {\n\t\t\t\thistory.redo();\n\t\t\t\treturn { redone: true, state: history.getState() };\n\t\t\t}\n\t\t}\n\t];\n}\n\nlet historyShortcutMap: ShortcutMap | null = null;\n\n/**\n * Resolves a keydown event to `undo` / `redo` with the default history bindings\n * (`Mod` is ⌘ on macOS and Ctrl elsewhere). Events from text inputs and\n * contenteditable elements are ignored unless `allowInEditable`.\n */\nexport function matchHistoryShortcut(\n\tevent: KeyboardEventLike,\n\toptions: { platform?: Platform; allowInEditable?: boolean } = {}\n): 'undo' | 'redo' | null {\n\thistoryShortcutMap ??= new ShortcutMap(DEFAULT_HISTORY_SHORTCUTS);\n\treturn (historyShortcutMap.resolve(event, options)?.command as 'undo' | 'redo' | undefined) ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Canvas arrange\n// ---------------------------------------------------------------------------\n\n/** Minimal arrange controller surface (`createCanvasArrangeController` satisfies it). */\nexport interface ArrangeCommandTarget {\n\talign(edge: AlignEdge, ids?: Iterable<string>): unknown;\n\tdistribute(axis: DistributeAxis, mode?: DistributeMode, ids?: Iterable<string>): unknown;\n\treorder(operation: ZOrderOperation, ids?: Iterable<string>): unknown;\n\tlock(ids?: Iterable<string>): unknown;\n\tunlock(ids?: Iterable<string>): unknown;\n}\n\nexport interface ArrangeCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope of the commands and their shortcuts (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n\t/** Current selection, used for enablement (\"Select at least two nodes\"). */\n\tgetSelectedIds?: () => string[];\n\t/** Scene navigation (`nextScene` / `previousScene`); those commands are only added when given. */\n\tscenes?: { next(): unknown; previous(): unknown };\n\t/** Use these bindings instead of `DEFAULT_ARRANGE_SHORTCUTS`. */\n\tbindings?: readonly { action: CanvasArrangeAction; label: string }[];\n}\n\nconst ARRANGE_LABELS: Record<CanvasArrangeAction, string> = {\n\talignLeft: 'Align Left',\n\talignCenter: 'Align Horizontal Centers',\n\talignRight: 'Align Right',\n\talignTop: 'Align Top',\n\talignMiddle: 'Align Vertical Centers',\n\talignBottom: 'Align Bottom',\n\tdistributeHorizontal: 'Distribute Horizontally',\n\tdistributeVertical: 'Distribute Vertically',\n\tlock: 'Lock',\n\tunlock: 'Unlock',\n\tbringForward: 'Bring Forward',\n\tsendBackward: 'Send Backward',\n\tbringToFront: 'Bring to Front',\n\tsendToBack: 'Send to Back',\n\tnextScene: 'Next Scene',\n\tpreviousScene: 'Previous Scene'\n};\n\nconst IDS_PARAMS: CommandParamsSchema = {\n\ttype: 'object',\n\tproperties: {\n\t\tids: {\n\t\t\ttype: 'array',\n\t\t\titems: { type: 'string' },\n\t\t\tdescription: 'Node ids to act on (default: the selection).'\n\t\t}\n\t}\n};\n\n/**\n * Commands for the canvas arrange actions (`canvas.alignLeft`, `canvas.bringToFront`, …)\n * with the default arrange shortcuts. Each accepts `{ ids? }`; enablement checks the\n * named ids, or the selection when none are named.\n */\nexport function createArrangeCommands(controller: ArrangeCommandTarget, options: ArrangeCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Arrange';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst bindings = options.bindings ?? DEFAULT_ARRANGE_SHORTCUTS;\n\tconst count = (params?: { ids?: string[] }) => params?.ids?.length ?? options.getSelectedIds?.().length;\n\tconst needs = (min: number, what: string) => (_: unknown, params?: { ids?: string[] }) => {\n\t\tconst n = count(params);\n\t\tif (n === undefined || n >= min) return true;\n\t\treturn min === 1 ? `Select a ${what} first.` : `Select at least ${min} ${what}s.`;\n\t};\n\n\tconst run: Record<CanvasArrangeAction, (ids?: string[]) => unknown> = {\n\t\talignLeft: (ids) => controller.align('left', ids),\n\t\talignCenter: (ids) => controller.align('center', ids),\n\t\talignRight: (ids) => controller.align('right', ids),\n\t\talignTop: (ids) => controller.align('top', ids),\n\t\talignMiddle: (ids) => controller.align('middle', ids),\n\t\talignBottom: (ids) => controller.align('bottom', ids),\n\t\tdistributeHorizontal: (ids) => controller.distribute('horizontal', 'gaps', ids),\n\t\tdistributeVertical: (ids) => controller.distribute('vertical', 'gaps', ids),\n\t\tlock: (ids) => controller.lock(ids),\n\t\tunlock: (ids) => controller.unlock(ids),\n\t\tbringForward: (ids) => controller.reorder('bringForward', ids),\n\t\tsendBackward: (ids) => controller.reorder('sendBackward', ids),\n\t\tbringToFront: (ids) => controller.reorder('bringToFront', ids),\n\t\tsendToBack: (ids) => controller.reorder('sendToBack', ids),\n\t\tnextScene: () => options.scenes?.next(),\n\t\tpreviousScene: () => options.scenes?.previous()\n\t};\n\n\tconst actions = Object.keys(ARRANGE_LABELS) as CanvasArrangeAction[];\n\treturn actions\n\t\t.filter((action) => options.scenes || (action !== 'nextScene' && action !== 'previousScene'))\n\t\t.map((action): CommandSpec => {\n\t\t\tconst isScene = action === 'nextScene' || action === 'previousScene';\n\t\t\tconst enabled = isScene\n\t\t\t\t? undefined\n\t\t\t\t: action.startsWith('align')\n\t\t\t\t\t? needs(2, 'node')\n\t\t\t\t\t: action.startsWith('distribute')\n\t\t\t\t\t\t? needs(3, 'node')\n\t\t\t\t\t\t: needs(1, 'node');\n\t\t\treturn {\n\t\t\t\tid: `${prefix}${action}`,\n\t\t\t\tlabel: ARRANGE_LABELS[action],\n\t\t\t\tgroup: isScene ? 'Scenes' : group,\n\t\t\t\tkeywords: isScene ? ['scene', 'slide', 'page'] : action.startsWith('align') ? ['align'] : ['arrange', 'layer', 'order'],\n\t\t\t\t...(scope ? { scope } : {}),\n\t\t\t\tshortcut: bindings.filter((b) => b.action === action).map((b) => b.label),\n\t\t\t\t...(isScene ? {} : { params: IDS_PARAMS }),\n\t\t\t\t...(enabled ? { enabled } : {}),\n\t\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => run[action](params?.ids)\n\t\t\t};\n\t\t});\n}\n\n// ---------------------------------------------------------------------------\n// Canvas shape operations\n// ---------------------------------------------------------------------------\n\n/** Shape operations surface of the arrange controller (`createCanvasArrangeController` satisfies it). */\nexport interface ShapeCommandTarget {\n\tcombineShapes(operation: 'unite' | 'intersect' | 'subtract' | 'exclude' | 'divide', ids?: Iterable<string>): unknown;\n\tcanCombineShapes(ids?: Iterable<string>): boolean;\n\toffsetShapes(distance: number, ids?: Iterable<string>, options?: { join?: 'miter' | 'round' | 'bevel'; miterLimit?: number }): unknown;\n\tcanOffsetShapes(ids?: Iterable<string>): boolean;\n\toutlineStroke(\n\t\tids?: Iterable<string>,\n\t\toptions?: { join?: 'miter' | 'round' | 'bevel'; cap?: 'butt' | 'round' | 'square'; miterLimit?: number }\n\t): unknown;\n\tcanOutlineStroke(ids?: Iterable<string>): boolean;\n}\n\nexport interface ShapeCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n\t/** Offset distance used when `canvas.offsetPath` is run without one (default 10). */\n\tdefaultOffset?: number;\n}\n\nconst SHAPE_COMMANDS = [\n\t{ op: 'unite', label: 'Unite Shapes', keywords: ['union', 'merge', 'boolean', 'combine'] },\n\t{ op: 'intersect', label: 'Intersect Shapes', keywords: ['intersection', 'boolean', 'combine'] },\n\t{ op: 'subtract', label: 'Subtract Shapes', keywords: ['difference', 'minus front', 'boolean', 'combine'] },\n\t{ op: 'exclude', label: 'Exclude Shapes', keywords: ['xor', 'boolean', 'combine'] },\n\t{ op: 'divide', label: 'Divide Shapes', keywords: ['split', 'pathfinder', 'boolean'] }\n] as const;\n\nconst JOIN_PARAM = { type: 'string', enum: ['miter', 'round', 'bevel'], description: 'Corner style (default miter).' } as const;\n\n/**\n * Palette / context-menu / agent commands for the shape operations: `canvas.unite`,\n * `canvas.intersect`, `canvas.subtract`, `canvas.exclude`, `canvas.divide`,\n * `canvas.offsetPath` (`{ distance, join?, miterLimit?, ids? }`) and `canvas.outlineStroke`\n * (`{ join?, cap?, miterLimit?, ids? }`). Each is one undoable step when the controller has a\n * history; enablement explains why a command cannot run.\n */\nexport function createShapeCommands(controller: ShapeCommandTarget, options: ShapeCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Shape';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst base = { group, ...(scope ? { scope } : {}) };\n\tconst combine = SHAPE_COMMANDS.map(\n\t\t({ op, label, keywords }): CommandSpec => ({\n\t\t\t...base,\n\t\t\tid: `${prefix}${op}`,\n\t\t\tlabel,\n\t\t\tkeywords: [...keywords],\n\t\t\tdescription: `${label.split(' ')[0]}s the selected shapes into a new path (curves are kept).`,\n\t\t\tparams: IDS_PARAMS,\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canCombineShapes(params?.ids) ? true : 'Select at least two unlocked shapes.',\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => controller.combineShapes(op, params?.ids)\n\t\t})\n\t);\n\treturn [\n\t\t...combine,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}offsetPath`,\n\t\t\tlabel: 'Offset Path…',\n\t\t\tkeywords: ['inset', 'outset', 'grow', 'shrink', 'expand', 'contract'],\n\t\t\tdescription: 'Grows (positive distance) or shrinks (negative) the selected shapes.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tdistance: { type: 'number', description: `Offset in canvas units (default ${options.defaultOffset ?? 10}).` },\n\t\t\t\t\tjoin: JOIN_PARAM,\n\t\t\t\t\tmiterLimit: { type: 'number', description: 'Miter limit (default 4).' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canOffsetShapes(params?.ids) ? true : 'Select an unlocked shape.',\n\t\t\trun: (_ctx: unknown, params: { distance?: number; join?: 'miter' | 'round' | 'bevel'; miterLimit?: number; ids?: string[] }) =>\n\t\t\t\tcontroller.offsetShapes(params?.distance ?? options.defaultOffset ?? 10, params?.ids, {\n\t\t\t\t\t...(params?.join ? { join: params.join } : {}),\n\t\t\t\t\t...(params?.miterLimit !== undefined ? { miterLimit: params.miterLimit } : {})\n\t\t\t\t})\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}outlineStroke`,\n\t\t\tlabel: 'Outline Stroke',\n\t\t\tkeywords: ['expand stroke', 'stroke to path', 'convert stroke'],\n\t\t\tdescription: 'Converts the strokes of the selected shapes to filled shapes.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tjoin: JOIN_PARAM,\n\t\t\t\t\tcap: { type: 'string', enum: ['butt', 'round', 'square'], description: 'Line cap (default butt).' },\n\t\t\t\t\tmiterLimit: { type: 'number', description: 'Miter limit (default 4).' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canOutlineStroke(params?.ids) ? true : 'Select an unlocked shape with a stroke.',\n\t\t\trun: (\n\t\t\t\t_ctx: unknown,\n\t\t\t\tparams: { join?: 'miter' | 'round' | 'bevel'; cap?: 'butt' | 'round' | 'square'; miterLimit?: number; ids?: string[] }\n\t\t\t) =>\n\t\t\t\tcontroller.outlineStroke(params?.ids, {\n\t\t\t\t\t...(params?.join ? { join: params.join } : {}),\n\t\t\t\t\t...(params?.cap ? { cap: params.cap } : {}),\n\t\t\t\t\t...(params?.miterLimit !== undefined ? { miterLimit: params.miterLimit } : {})\n\t\t\t\t})\n\t\t}\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// Canvas components and instances\n// ---------------------------------------------------------------------------\n\ntype ComponentActionResult = { ok: true; ids: string[] } | { ok: false; reason: string };\n\n/** Components surface of the components controller (`createCanvasComponentsController` satisfies it). */\nexport interface ComponentCommandTarget {\n\tcreateComponent(ids?: Iterable<string>): ComponentActionResult;\n\tcanCreateComponent(ids?: Iterable<string>): true | string;\n\tcombineAsVariants(ids?: Iterable<string>): ComponentActionResult;\n\tcanCombineAsVariants(ids?: Iterable<string>): true | string;\n\tcreateInstance(componentId: string, options?: { parentId?: string; position?: { x: number; y: number }; properties?: Record<string, boolean | string> }): ComponentActionResult;\n\tcanCreateInstance(componentId?: string, parentId?: string): true | string;\n\tdetachInstance(ids?: Iterable<string>): ComponentActionResult;\n\tcanDetachInstance(ids?: Iterable<string>): true | string;\n\tresetOverrides(id?: string, group?: string): ComponentActionResult;\n\tcanResetOverrides(id?: string): true | string;\n\tpushOverrides(id?: string): ComponentActionResult;\n\tcanPushOverrides(id?: string): true | string;\n\tswapInstance(componentId: string, ids?: Iterable<string>): ComponentActionResult;\n\tcanSwapInstance(componentId?: string, ids?: Iterable<string>): true | string;\n\tsetInstanceProperties(properties: Record<string, unknown>, ids?: Iterable<string>): ComponentActionResult;\n\tcanSetInstanceProperties(ids?: Iterable<string>): true | string;\n\trestoreMainComponent(id?: string): ComponentActionResult;\n\tcanRestoreMainComponent(id?: string): true | string;\n\tgoToMainComponent(id?: string): string | undefined;\n\tcanGoToMainComponent(id?: string): true | string;\n\tlist(): unknown;\n\tinspect(id?: string): unknown;\n\t// Variant editing (optional so older targets keep type-checking; the controller has them all).\n\taddVariant?(\n\t\tsetId?: string,\n\t\toptions?: { from?: string; variant?: Record<string, string>; position?: { x: number; y: number }; defaultValue?: string }\n\t): ComponentActionResult;\n\tcanAddVariant?(setId?: string, options?: { from?: string; variant?: Record<string, string> }): true | string;\n\tremoveVariant?(variantId?: string): ComponentActionResult;\n\tcanRemoveVariant?(variantId?: string): true | string;\n\tsetVariantProperties?(values: Record<string, string>, variantId?: string, options?: { defaultValue?: string }): ComponentActionResult;\n\tcanSetVariantProperties?(values?: Record<string, string>, variantId?: string): true | string;\n\trenameVariantProperty?(name: string, newName: string, setId?: string): ComponentActionResult;\n\tcanRenameVariantProperty?(name?: string, newName?: string, setId?: string): true | string;\n\trenameVariantValue?(property: string, value: string, newValue: string, setId?: string): ComponentActionResult;\n\tcanRenameVariantValue?(property?: string, value?: string, newValue?: string, setId?: string): true | string;\n}\n\n/** The variant-editing part of a `ComponentCommandTarget` (present on the components controller). */\ntype VariantCommandTarget = Required<\n\tPick<\n\t\tComponentCommandTarget,\n\t\t| 'addVariant'\n\t\t| 'canAddVariant'\n\t\t| 'removeVariant'\n\t\t| 'canRemoveVariant'\n\t\t| 'setVariantProperties'\n\t\t| 'canSetVariantProperties'\n\t\t| 'renameVariantProperty'\n\t\t| 'canRenameVariantProperty'\n\t\t| 'renameVariantValue'\n\t\t| 'canRenameVariantValue'\n\t>\n>;\n\n/** Whether a command target can edit variants. */\nexport function hasVariantCommands(controller: ComponentCommandTarget): controller is ComponentCommandTarget & VariantCommandTarget {\n\treturn typeof controller.addVariant === 'function' && typeof controller.removeVariant === 'function';\n}\n\nconst SET_ID_PARAM = { type: 'string', description: 'Component set (or one of its variants) to act on (default: the selection’s set).' } as const;\nconst VARIANT_ID_PARAM = { type: 'string', description: 'Variant to act on (default: the first selected variant).' } as const;\nconst VARIANT_VALUES_PARAM = {\n\ttype: 'object',\n\tdescription: 'Variant property → value, e.g. { \"Size\": \"Medium\" }. New property names are added to every variant.',\n\tadditionalProperties: { type: 'string' }\n} as const;\n\nfunction variantCommands(controller: ComponentCommandTarget & VariantCommandTarget, prefix: string, base: Partial<CommandSpec>): CommandSpec[] {\n\treturn [\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}addVariant`,\n\t\t\tlabel: 'Add Variant',\n\t\t\tkeywords: ['variant', 'new variant', 'duplicate variant', 'component set'],\n\t\t\tdescription: 'Adds a variant to a component set by duplicating one (default: the selected or default variant) with new property values.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tsetId: SET_ID_PARAM,\n\t\t\t\t\tfrom: { type: 'string', description: 'Variant to duplicate (default: the selected variant, else the default one).' },\n\t\t\t\t\tvariant: VARIANT_VALUES_PARAM,\n\t\t\t\t\tx: { type: 'number', description: 'X in the set’s space (default: next to the source).' },\n\t\t\t\t\ty: { type: 'number', description: 'Y in the set’s space.' }\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { setId?: string; from?: string; variant?: Record<string, string> }) =>\n\t\t\t\tcontroller.canAddVariant(params?.setId, {\n\t\t\t\t\t...(params?.from !== undefined ? { from: params.from } : {}),\n\t\t\t\t\t...(params?.variant ? { variant: params.variant } : {})\n\t\t\t\t}),\n\t\t\trun: (_ctx: unknown, params?: { setId?: string; from?: string; variant?: Record<string, string>; x?: number; y?: number }) =>\n\t\t\t\toutcome(\n\t\t\t\t\tcontroller.addVariant(params?.setId, {\n\t\t\t\t\t\t...(params?.from !== undefined ? { from: params.from } : {}),\n\t\t\t\t\t\t...(params?.variant ? { variant: params.variant } : {}),\n\t\t\t\t\t\t...(params?.x !== undefined || params?.y !== undefined ? { position: { x: params?.x ?? 0, y: params?.y ?? 0 } } : {})\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}removeVariant`,\n\t\t\tlabel: 'Remove Variant',\n\t\t\tkeywords: ['delete variant', 'variant'],\n\t\t\tdescription: 'Removes a variant; its instances switch to the closest remaining variant, keeping overrides.',\n\t\t\tparams: { type: 'object', properties: { id: VARIANT_ID_PARAM } },\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canRemoveVariant(params?.id),\n\t\t\trun: (_ctx: unknown, params?: { id?: string }) => outcome(controller.removeVariant(params?.id))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}setVariantProperties`,\n\t\t\tlabel: 'Edit Variant Properties…',\n\t\t\tkeywords: ['rename variant', 'variant values', 'variant'],\n\t\t\tdescription: 'Sets a variant’s property values (refusing a combination another variant has).',\n\t\t\tparams: { type: 'object', properties: { values: VARIANT_VALUES_PARAM, id: VARIANT_ID_PARAM }, required: ['values'] },\n\t\t\tenabled: (_ctx: unknown, params?: { values?: Record<string, string>; id?: string }) => controller.canSetVariantProperties(params?.values, params?.id),\n\t\t\trun: (_ctx: unknown, params: { values: Record<string, string>; id?: string }) => outcome(controller.setVariantProperties(params.values, params?.id))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}renameVariantProperty`,\n\t\t\tlabel: 'Rename Variant Property…',\n\t\t\tkeywords: ['rename property', 'variant property'],\n\t\t\tdescription: 'Renames a variant property across a component set.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { name: { type: 'string' }, newName: { type: 'string' }, setId: SET_ID_PARAM },\n\t\t\t\trequired: ['name', 'newName']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { name?: string; newName?: string; setId?: string }) =>\n\t\t\t\tcontroller.canRenameVariantProperty(params?.name, params?.newName, params?.setId),\n\t\t\trun: (_ctx: unknown, params: { name: string; newName: string; setId?: string }) =>\n\t\t\t\toutcome(controller.renameVariantProperty(params.name, params.newName, params?.setId))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}renameVariantValue`,\n\t\t\tlabel: 'Rename Variant Value…',\n\t\t\tkeywords: ['rename value', 'variant value'],\n\t\t\tdescription: 'Renames a value of a variant property across a component set.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { property: { type: 'string' }, value: { type: 'string' }, newValue: { type: 'string' }, setId: SET_ID_PARAM },\n\t\t\t\trequired: ['property', 'value', 'newValue']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { property?: string; value?: string; newValue?: string; setId?: string }) =>\n\t\t\t\tcontroller.canRenameVariantValue(params?.property, params?.value, params?.newValue, params?.setId),\n\t\t\trun: (_ctx: unknown, params: { property: string; value: string; newValue: string; setId?: string }) =>\n\t\t\t\toutcome(controller.renameVariantValue(params.property, params.value, params.newValue, params?.setId))\n\t\t} as CommandSpec\n\t];\n}\n\nexport interface ComponentCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n}\n\nconst outcome = (result: ComponentActionResult) => {\n\tif (!result.ok) throw new Error(result.reason);\n\treturn { ids: result.ids };\n};\n\nconst ID_PARAM = { type: 'string', description: 'Instance (or layer inside one) to act on (default: the first selected node).' } as const;\n\n/**\n * Palette / context-menu / agent commands for components and instances:\n * `canvas.createComponent`, `canvas.combineAsVariants`, `canvas.createInstance`\n * (`{ componentId, parentId?, x?, y?, properties? }`), `canvas.detachInstance`,\n * `canvas.resetOverrides` (`{ id?, group? }`), `canvas.pushOverrides`, `canvas.goToMainComponent`,\n * `canvas.swapInstance` (`{ componentId, ids? }`), `canvas.setInstanceProperties`\n * (`{ properties, ids? }`: variant and component property values), `canvas.restoreMainComponent`,\n * the variant editors `canvas.addVariant` (`{ setId?, from?, variant?, x?, y? }`),\n * `canvas.removeVariant` (`{ id? }`), `canvas.setVariantProperties` (`{ values, id? }`),\n * `canvas.renameVariantProperty` (`{ name, newName, setId? }`) and `canvas.renameVariantValue`\n * (`{ property, value, newValue, setId? }`) when the target has them, and the read-only `canvas.listComponents` / `canvas.inspectInstance`. Each action is one\n * undoable step when the controller has a history; enablement explains why it cannot run.\n */\nexport function createComponentCommands(controller: ComponentCommandTarget, options: ComponentCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Components';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst base = { group, ...(scope ? { scope } : {}) };\n\tconst idParams: CommandParamsSchema = { type: 'object', properties: { id: ID_PARAM } };\n\treturn [\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}createComponent`,\n\t\t\tlabel: 'Create Component',\n\t\t\tkeywords: ['component', 'symbol', 'main component', 'reusable'],\n\t\t\tdescription: 'Turns the selected frame into a main component, or wraps the selection in one.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tshortcut: 'Mod+Alt+K',\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canCreateComponent(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.createComponent(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}combineAsVariants`,\n\t\t\tlabel: 'Combine as Variants',\n\t\t\tkeywords: ['component set', 'variant', 'variants'],\n\t\t\tdescription: 'Wraps the selected components in a component set.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canCombineAsVariants(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.combineAsVariants(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}createInstance`,\n\t\t\tlabel: 'Create Instance',\n\t\t\tkeywords: ['instance', 'insert component', 'use component'],\n\t\t\tdescription: 'Places an instance of a component (or a component set’s default variant).',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tcomponentId: { type: 'string', description: 'Component or component set id.' },\n\t\t\t\t\tparentId: { type: 'string', description: 'Frame to place it in (default: the canvas).' },\n\t\t\t\t\tx: { type: 'number', description: 'X in the parent’s space (default: next to the main).' },\n\t\t\t\t\ty: { type: 'number', description: 'Y in the parent’s space.' },\n\t\t\t\t\tproperties: { type: 'object', description: 'Variant and component property values.', additionalProperties: true }\n\t\t\t\t},\n\t\t\t\trequired: ['componentId']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { componentId?: string; parentId?: string }) =>\n\t\t\t\tparams?.componentId === undefined ? true : controller.canCreateInstance(params.componentId, params.parentId),\n\t\t\trun: (_ctx: unknown, params: { componentId: string; parentId?: string; x?: number; y?: number; properties?: Record<string, boolean | string> }) =>\n\t\t\t\toutcome(\n\t\t\t\t\tcontroller.createInstance(params.componentId, {\n\t\t\t\t\t\t...(params.parentId !== undefined ? { parentId: params.parentId } : {}),\n\t\t\t\t\t\t...(params.x !== undefined || params.y !== undefined ? { position: { x: params.x ?? 0, y: params.y ?? 0 } } : {}),\n\t\t\t\t\t\t...(params.properties ? { properties: params.properties } : {})\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}detachInstance`,\n\t\t\tlabel: 'Detach Instance',\n\t\t\tkeywords: ['unlink', 'break instance'],\n\t\t\tdescription: 'Turns the selected instances into plain frames that keep their look.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tshortcut: 'Mod+Alt+B',\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canDetachInstance(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.detachInstance(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}resetOverrides`,\n\t\t\tlabel: 'Reset All Changes',\n\t\t\tkeywords: ['reset instance', 'reset overrides', 'revert'],\n\t\t\tdescription: 'Resets the overrides of an instance (or of a layer, or one override group) to its main.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tid: ID_PARAM,\n\t\t\t\t\tgroup: { type: 'string', description: 'One override group to reset, e.g. \"data.label\" or \"shape.fill\" (default: all).' }\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canResetOverrides(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string; group?: string }) => outcome(controller.resetOverrides(params?.id, params?.group))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}pushOverrides`,\n\t\t\tlabel: 'Push Changes to Main Component',\n\t\t\tkeywords: ['push overrides', 'update main component'],\n\t\t\tdescription: 'Copies the instance’s overrides to its main component and every other instance.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canPushOverrides(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => outcome(controller.pushOverrides(params?.id))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}goToMainComponent`,\n\t\t\tlabel: 'Go to Main Component',\n\t\t\tkeywords: ['main component', 'find main', 'reveal'],\n\t\t\tdescription: 'Selects the main component of the selected instance.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canGoToMainComponent(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => {\n\t\t\t\tconst main = controller.goToMainComponent(params?.id);\n\t\t\t\tif (!main) throw new Error('The main component was not found.');\n\t\t\t\treturn { id: main };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}swapInstance`,\n\t\t\tlabel: 'Swap Instance…',\n\t\t\tkeywords: ['replace instance', 'swap component'],\n\t\t\tdescription: 'Makes the selected instances show another component, keeping matching overrides.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tcomponentId: { type: 'string', description: 'Component or component set to swap to.' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t},\n\t\t\t\trequired: ['componentId']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { componentId?: string; ids?: string[] }) => controller.canSwapInstance(params?.componentId, params?.ids),\n\t\t\trun: (_ctx: unknown, params: { componentId: string; ids?: string[] }) => outcome(controller.swapInstance(params.componentId, params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}setInstanceProperties`,\n\t\t\tlabel: 'Set Instance Properties…',\n\t\t\tkeywords: ['variant', 'switch variant', 'component property', 'toggle'],\n\t\t\tdescription: 'Sets variant properties (switching variants) and component property values of the selected instances.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tproperties: { type: 'object', description: 'Property name → value (variant value, boolean, text or component id).', additionalProperties: true },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t},\n\t\t\t\trequired: ['properties']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canSetInstanceProperties(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { properties: Record<string, unknown>; ids?: string[] }) =>\n\t\t\t\toutcome(controller.setInstanceProperties(params.properties, params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}restoreMainComponent`,\n\t\t\tlabel: 'Restore Main Component',\n\t\t\tkeywords: ['missing main', 'recover component'],\n\t\t\tdescription: 'Turns an instance whose main was deleted back into the main component.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canRestoreMainComponent(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => outcome(controller.restoreMainComponent(params?.id))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}listComponents`,\n\t\t\tlabel: 'List Components',\n\t\t\tkeywords: ['components', 'variants', 'assets'],\n\t\t\tdescription: 'Lists the components and component sets (with their variant options).',\n\t\t\treadOnly: true,\n\t\t\trun: () => controller.list()\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}inspectInstance`,\n\t\t\tlabel: 'Inspect Instance',\n\t\t\tkeywords: ['instance', 'overrides', 'properties'],\n\t\t\tdescription: 'Describes an instance: its main, variant, property values and overrides.',\n\t\t\tparams: idParams,\n\t\t\treadOnly: true,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => (controller.inspect(params?.id) ? true : 'Select an instance.'),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => controller.inspect(params?.id) ?? null\n\t\t},\n\t\t...(hasVariantCommands(controller) ? variantCommands(controller, prefix, base) : [])\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// Spreadsheet table actions\n// ---------------------------------------------------------------------------\n\n/** Spreadsheet controller surface used by `createSpreadsheetCommands`. */\nexport interface SpreadsheetCommandTarget {\n\tselectedRange: unknown;\n\tgetFilterState(): { enabled: boolean; rules: readonly unknown[] };\n\ttoggleFilters(): void;\n\tclearFilters(): void;\n\tunhideAll(): void;\n\tmergeCells(): boolean;\n\tunmergeCells(): boolean;\n\ttransposeRange(): boolean;\n}\n\nexport interface SpreadsheetCommandOptions {\n\t/** Id prefix (default `spreadsheet.`). */\n\tprefix?: string;\n\t/** Scope (default `spreadsheet`). Pass `null` for global. */\n\tscope?: string | null;\n}\n\n/** Palette / agent commands for common spreadsheet table actions (no default shortcuts). */\nexport function createSpreadsheetCommands(\n\tcontroller: SpreadsheetCommandTarget,\n\toptions: SpreadsheetCommandOptions = {}\n): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'spreadsheet.';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'spreadsheet';\n\tconst hasRange = () => (controller.selectedRange ? true : 'Select a range first.');\n\tconst base = { group: 'Table', ...(scope ? { scope } : {}) };\n\treturn [\n\t\t{ ...base, id: `${prefix}toggleFilters`, label: 'Toggle Filters', keywords: ['filter'], run: () => controller.toggleFilters() },\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}clearFilters`,\n\t\t\tlabel: 'Clear Filters',\n\t\t\tkeywords: ['filter', 'reset'],\n\t\t\tenabled: () => (controller.getFilterState().rules.length > 0 ? true : 'No filters to clear.'),\n\t\t\trun: () => controller.clearFilters()\n\t\t},\n\t\t{ ...base, id: `${prefix}unhideAll`, label: 'Unhide All Rows and Columns', keywords: ['show', 'hidden'], run: () => controller.unhideAll() },\n\t\t{ ...base, id: `${prefix}mergeCells`, label: 'Merge Cells', keywords: ['combine'], enabled: hasRange, run: () => controller.mergeCells() },\n\t\t{ ...base, id: `${prefix}unmergeCells`, label: 'Unmerge Cells', keywords: ['split'], enabled: hasRange, run: () => controller.unmergeCells() },\n\t\t{ ...base, id: `${prefix}transposeRange`, label: 'Transpose Range', keywords: ['rotate', 'swap rows columns'], enabled: hasRange, run: () => controller.transposeRange() }\n\t];\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/chunk-TPOT575P.cjs","../src/commands/builtins.ts"],"names":[],"mappings":"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AA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AACN,IAAA;AACA,IAAA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AACN,IAAA;AACI,IAAA;AACL,EAAA;AACD;AA0BS;AACH,EAAA;AACE,EAAA;AACR;AAOgB;AAIT,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACC,EAAA;AACD,IAAA;AACL,IAAA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AACN,IAAA;AACK,IAAA;AACL,IAAA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AAEN,IAAA;AACA,IAAA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AACN,IAAA;AACA,IAAA;AACI,MAAA;AACC,MAAA;AACJ,MAAA;AACA,MAAA;AACA,MAAA;AACK,MAAA;AAEN,IAAA;AACD,EAAA;AACD;ADnQW;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/editor/editor/packages/core/dist/chunk-TPOT575P.cjs","sourcesContent":[null,"import type { HistoryState } from '../history/types.js';\nimport type { CanvasArrangeAction } from '../canvas/arrangeShortcuts.js';\nimport type { AlignEdge, DistributeAxis, DistributeMode, ZOrderOperation } from '../canvas/arrange.js';\nimport { DEFAULT_ARRANGE_SHORTCUTS } from '../canvas/arrangeShortcuts.js';\nimport type { CommandParamsSchema, CommandSpec } from './registry.js';\nimport { ShortcutMap, type ShortcutBinding } from './shortcuts.js';\nimport type { KeyboardEventLike, Platform } from './chords.js';\n\n// ---------------------------------------------------------------------------\n// History\n// ---------------------------------------------------------------------------\n\n/** Minimal history surface (`HistoryManager` satisfies it). */\nexport interface HistoryCommandTarget {\n\tundo(): boolean | void;\n\tredo(): boolean | void;\n\tgetState(): Pick<HistoryState, 'canUndo' | 'canRedo'> & Partial<Pick<HistoryState, 'undoName' | 'redoName'>>;\n}\n\n/** Default history bindings: `Mod+Z` undo; `Mod+Shift+Z` redo, plus `Mod+Y` off macOS. */\nexport const DEFAULT_HISTORY_SHORTCUTS: readonly ShortcutBinding[] = [\n\t{ command: 'undo', chord: 'Mod+Z' },\n\t{ command: 'redo', chord: 'Mod+Shift+Z' },\n\t{ command: 'redo', chord: 'Mod+Y', platforms: ['windows', 'linux'] }\n];\n\nexport interface HistoryCommandOptions {\n\t/** Id prefix (default `history.`). */\n\tprefix?: string;\n\tgroup?: string;\n\tscope?: string;\n}\n\n/** `history.undo` / `history.redo` commands for a `HistoryManager` (disabled with a reason when empty). */\nexport function createHistoryCommands(history: HistoryCommandTarget, options: HistoryCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'history.';\n\tconst group = options.group ?? 'Edit';\n\tconst shortcutsOf = (command: 'undo' | 'redo') =>\n\t\tDEFAULT_HISTORY_SHORTCUTS.filter((b) => b.command === command).map(({ command: _c, ...rest }) => rest);\n\treturn [\n\t\t{\n\t\t\tid: `${prefix}undo`,\n\t\t\tlabel: 'Undo',\n\t\t\tgroup,\n\t\t\tkeywords: ['revert', 'back'],\n\t\t\tdescription: 'Reverts the last change.',\n\t\t\tshortcut: shortcutsOf('undo'),\n\t\t\t...(options.scope ? { scope: options.scope } : {}),\n\t\t\tenabled: () => (history.getState().canUndo ? true : 'Nothing to undo.'),\n\t\t\trun: () => {\n\t\t\t\thistory.undo();\n\t\t\t\treturn { undone: true, state: history.getState() };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tid: `${prefix}redo`,\n\t\t\tlabel: 'Redo',\n\t\t\tgroup,\n\t\t\tkeywords: ['repeat', 'forward'],\n\t\t\tdescription: 'Re-applies the last undone change.',\n\t\t\tshortcut: shortcutsOf('redo'),\n\t\t\t...(options.scope ? { scope: options.scope } : {}),\n\t\t\tenabled: () => (history.getState().canRedo ? true : 'Nothing to redo.'),\n\t\t\trun: () => {\n\t\t\t\thistory.redo();\n\t\t\t\treturn { redone: true, state: history.getState() };\n\t\t\t}\n\t\t}\n\t];\n}\n\nlet historyShortcutMap: ShortcutMap | null = null;\n\n/**\n * Resolves a keydown event to `undo` / `redo` with the default history bindings\n * (`Mod` is ⌘ on macOS and Ctrl elsewhere). Events from text inputs and\n * contenteditable elements are ignored unless `allowInEditable`.\n */\nexport function matchHistoryShortcut(\n\tevent: KeyboardEventLike,\n\toptions: { platform?: Platform; allowInEditable?: boolean } = {}\n): 'undo' | 'redo' | null {\n\thistoryShortcutMap ??= new ShortcutMap(DEFAULT_HISTORY_SHORTCUTS);\n\treturn (historyShortcutMap.resolve(event, options)?.command as 'undo' | 'redo' | undefined) ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Canvas arrange\n// ---------------------------------------------------------------------------\n\n/** Minimal arrange controller surface (`createCanvasArrangeController` satisfies it). */\nexport interface ArrangeCommandTarget {\n\talign(edge: AlignEdge, ids?: Iterable<string>): unknown;\n\tdistribute(axis: DistributeAxis, mode?: DistributeMode, ids?: Iterable<string>): unknown;\n\treorder(operation: ZOrderOperation, ids?: Iterable<string>): unknown;\n\tlock(ids?: Iterable<string>): unknown;\n\tunlock(ids?: Iterable<string>): unknown;\n}\n\nexport interface ArrangeCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope of the commands and their shortcuts (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n\t/** Current selection, used for enablement (\"Select at least two nodes\"). */\n\tgetSelectedIds?: () => string[];\n\t/** Scene navigation (`nextScene` / `previousScene`); those commands are only added when given. */\n\tscenes?: { next(): unknown; previous(): unknown };\n\t/** Use these bindings instead of `DEFAULT_ARRANGE_SHORTCUTS`. */\n\tbindings?: readonly { action: CanvasArrangeAction; label: string }[];\n}\n\nconst ARRANGE_LABELS: Record<CanvasArrangeAction, string> = {\n\talignLeft: 'Align Left',\n\talignCenter: 'Align Horizontal Centers',\n\talignRight: 'Align Right',\n\talignTop: 'Align Top',\n\talignMiddle: 'Align Vertical Centers',\n\talignBottom: 'Align Bottom',\n\tdistributeHorizontal: 'Distribute Horizontally',\n\tdistributeVertical: 'Distribute Vertically',\n\tlock: 'Lock',\n\tunlock: 'Unlock',\n\tbringForward: 'Bring Forward',\n\tsendBackward: 'Send Backward',\n\tbringToFront: 'Bring to Front',\n\tsendToBack: 'Send to Back',\n\tnextScene: 'Next Scene',\n\tpreviousScene: 'Previous Scene'\n};\n\nconst IDS_PARAMS: CommandParamsSchema = {\n\ttype: 'object',\n\tproperties: {\n\t\tids: {\n\t\t\ttype: 'array',\n\t\t\titems: { type: 'string' },\n\t\t\tdescription: 'Node ids to act on (default: the selection).'\n\t\t}\n\t}\n};\n\n/**\n * Commands for the canvas arrange actions (`canvas.alignLeft`, `canvas.bringToFront`, …)\n * with the default arrange shortcuts. Each accepts `{ ids? }`; enablement checks the\n * named ids, or the selection when none are named.\n */\nexport function createArrangeCommands(controller: ArrangeCommandTarget, options: ArrangeCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Arrange';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst bindings = options.bindings ?? DEFAULT_ARRANGE_SHORTCUTS;\n\tconst count = (params?: { ids?: string[] }) => params?.ids?.length ?? options.getSelectedIds?.().length;\n\tconst needs = (min: number, what: string) => (_: unknown, params?: { ids?: string[] }) => {\n\t\tconst n = count(params);\n\t\tif (n === undefined || n >= min) return true;\n\t\treturn min === 1 ? `Select a ${what} first.` : `Select at least ${min} ${what}s.`;\n\t};\n\n\tconst run: Record<CanvasArrangeAction, (ids?: string[]) => unknown> = {\n\t\talignLeft: (ids) => controller.align('left', ids),\n\t\talignCenter: (ids) => controller.align('center', ids),\n\t\talignRight: (ids) => controller.align('right', ids),\n\t\talignTop: (ids) => controller.align('top', ids),\n\t\talignMiddle: (ids) => controller.align('middle', ids),\n\t\talignBottom: (ids) => controller.align('bottom', ids),\n\t\tdistributeHorizontal: (ids) => controller.distribute('horizontal', 'gaps', ids),\n\t\tdistributeVertical: (ids) => controller.distribute('vertical', 'gaps', ids),\n\t\tlock: (ids) => controller.lock(ids),\n\t\tunlock: (ids) => controller.unlock(ids),\n\t\tbringForward: (ids) => controller.reorder('bringForward', ids),\n\t\tsendBackward: (ids) => controller.reorder('sendBackward', ids),\n\t\tbringToFront: (ids) => controller.reorder('bringToFront', ids),\n\t\tsendToBack: (ids) => controller.reorder('sendToBack', ids),\n\t\tnextScene: () => options.scenes?.next(),\n\t\tpreviousScene: () => options.scenes?.previous()\n\t};\n\n\tconst actions = Object.keys(ARRANGE_LABELS) as CanvasArrangeAction[];\n\treturn actions\n\t\t.filter((action) => options.scenes || (action !== 'nextScene' && action !== 'previousScene'))\n\t\t.map((action): CommandSpec => {\n\t\t\tconst isScene = action === 'nextScene' || action === 'previousScene';\n\t\t\tconst enabled = isScene\n\t\t\t\t? undefined\n\t\t\t\t: action.startsWith('align')\n\t\t\t\t\t? needs(2, 'node')\n\t\t\t\t\t: action.startsWith('distribute')\n\t\t\t\t\t\t? needs(3, 'node')\n\t\t\t\t\t\t: needs(1, 'node');\n\t\t\treturn {\n\t\t\t\tid: `${prefix}${action}`,\n\t\t\t\tlabel: ARRANGE_LABELS[action],\n\t\t\t\tgroup: isScene ? 'Scenes' : group,\n\t\t\t\tkeywords: isScene ? ['scene', 'slide', 'page'] : action.startsWith('align') ? ['align'] : ['arrange', 'layer', 'order'],\n\t\t\t\t...(scope ? { scope } : {}),\n\t\t\t\tshortcut: bindings.filter((b) => b.action === action).map((b) => b.label),\n\t\t\t\t...(isScene ? {} : { params: IDS_PARAMS }),\n\t\t\t\t...(enabled ? { enabled } : {}),\n\t\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => run[action](params?.ids)\n\t\t\t};\n\t\t});\n}\n\n// ---------------------------------------------------------------------------\n// Canvas shape operations\n// ---------------------------------------------------------------------------\n\n/** Shape operations surface of the arrange controller (`createCanvasArrangeController` satisfies it). */\nexport interface ShapeCommandTarget {\n\tcombineShapes(operation: 'unite' | 'intersect' | 'subtract' | 'exclude' | 'divide', ids?: Iterable<string>): unknown;\n\tcanCombineShapes(ids?: Iterable<string>): boolean;\n\toffsetShapes(distance: number, ids?: Iterable<string>, options?: { join?: 'miter' | 'round' | 'bevel'; miterLimit?: number }): unknown;\n\tcanOffsetShapes(ids?: Iterable<string>): boolean;\n\toutlineStroke(\n\t\tids?: Iterable<string>,\n\t\toptions?: { join?: 'miter' | 'round' | 'bevel'; cap?: 'butt' | 'round' | 'square'; miterLimit?: number }\n\t): unknown;\n\tcanOutlineStroke(ids?: Iterable<string>): boolean;\n}\n\nexport interface ShapeCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n\t/** Offset distance used when `canvas.offsetPath` is run without one (default 10). */\n\tdefaultOffset?: number;\n}\n\nconst SHAPE_COMMANDS = [\n\t{ op: 'unite', label: 'Unite Shapes', keywords: ['union', 'merge', 'boolean', 'combine'] },\n\t{ op: 'intersect', label: 'Intersect Shapes', keywords: ['intersection', 'boolean', 'combine'] },\n\t{ op: 'subtract', label: 'Subtract Shapes', keywords: ['difference', 'minus front', 'boolean', 'combine'] },\n\t{ op: 'exclude', label: 'Exclude Shapes', keywords: ['xor', 'boolean', 'combine'] },\n\t{ op: 'divide', label: 'Divide Shapes', keywords: ['split', 'pathfinder', 'boolean'] }\n] as const;\n\nconst JOIN_PARAM = { type: 'string', enum: ['miter', 'round', 'bevel'], description: 'Corner style (default miter).' } as const;\n\n/**\n * Palette / context-menu / agent commands for the shape operations: `canvas.unite`,\n * `canvas.intersect`, `canvas.subtract`, `canvas.exclude`, `canvas.divide`,\n * `canvas.offsetPath` (`{ distance, join?, miterLimit?, ids? }`) and `canvas.outlineStroke`\n * (`{ join?, cap?, miterLimit?, ids? }`). Each is one undoable step when the controller has a\n * history; enablement explains why a command cannot run.\n */\nexport function createShapeCommands(controller: ShapeCommandTarget, options: ShapeCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Shape';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst base = { group, ...(scope ? { scope } : {}) };\n\tconst combine = SHAPE_COMMANDS.map(\n\t\t({ op, label, keywords }): CommandSpec => ({\n\t\t\t...base,\n\t\t\tid: `${prefix}${op}`,\n\t\t\tlabel,\n\t\t\tkeywords: [...keywords],\n\t\t\tdescription: `${label.split(' ')[0]}s the selected shapes into a new path (curves are kept).`,\n\t\t\tparams: IDS_PARAMS,\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canCombineShapes(params?.ids) ? true : 'Select at least two unlocked shapes.',\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => controller.combineShapes(op, params?.ids)\n\t\t})\n\t);\n\treturn [\n\t\t...combine,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}offsetPath`,\n\t\t\tlabel: 'Offset Path…',\n\t\t\tkeywords: ['inset', 'outset', 'grow', 'shrink', 'expand', 'contract'],\n\t\t\tdescription: 'Grows (positive distance) or shrinks (negative) the selected shapes.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tdistance: { type: 'number', description: `Offset in canvas units (default ${options.defaultOffset ?? 10}).` },\n\t\t\t\t\tjoin: JOIN_PARAM,\n\t\t\t\t\tmiterLimit: { type: 'number', description: 'Miter limit (default 4).' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canOffsetShapes(params?.ids) ? true : 'Select an unlocked shape.',\n\t\t\trun: (_ctx: unknown, params: { distance?: number; join?: 'miter' | 'round' | 'bevel'; miterLimit?: number; ids?: string[] }) =>\n\t\t\t\tcontroller.offsetShapes(params?.distance ?? options.defaultOffset ?? 10, params?.ids, {\n\t\t\t\t\t...(params?.join ? { join: params.join } : {}),\n\t\t\t\t\t...(params?.miterLimit !== undefined ? { miterLimit: params.miterLimit } : {})\n\t\t\t\t})\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}outlineStroke`,\n\t\t\tlabel: 'Outline Stroke',\n\t\t\tkeywords: ['expand stroke', 'stroke to path', 'convert stroke'],\n\t\t\tdescription: 'Converts the strokes of the selected shapes to filled shapes.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tjoin: JOIN_PARAM,\n\t\t\t\t\tcap: { type: 'string', enum: ['butt', 'round', 'square'], description: 'Line cap (default butt).' },\n\t\t\t\t\tmiterLimit: { type: 'number', description: 'Miter limit (default 4).' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) =>\n\t\t\t\tcontroller.canOutlineStroke(params?.ids) ? true : 'Select an unlocked shape with a stroke.',\n\t\t\trun: (\n\t\t\t\t_ctx: unknown,\n\t\t\t\tparams: { join?: 'miter' | 'round' | 'bevel'; cap?: 'butt' | 'round' | 'square'; miterLimit?: number; ids?: string[] }\n\t\t\t) =>\n\t\t\t\tcontroller.outlineStroke(params?.ids, {\n\t\t\t\t\t...(params?.join ? { join: params.join } : {}),\n\t\t\t\t\t...(params?.cap ? { cap: params.cap } : {}),\n\t\t\t\t\t...(params?.miterLimit !== undefined ? { miterLimit: params.miterLimit } : {})\n\t\t\t\t})\n\t\t}\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// Canvas components and instances\n// ---------------------------------------------------------------------------\n\ntype ComponentActionResult = { ok: true; ids: string[] } | { ok: false; reason: string };\n\n/** Components surface of the components controller (`createCanvasComponentsController` satisfies it). */\nexport interface ComponentCommandTarget {\n\tcreateComponent(ids?: Iterable<string>): ComponentActionResult;\n\tcanCreateComponent(ids?: Iterable<string>): true | string;\n\tcombineAsVariants(ids?: Iterable<string>): ComponentActionResult;\n\tcanCombineAsVariants(ids?: Iterable<string>): true | string;\n\tcreateInstance(componentId: string, options?: { parentId?: string; position?: { x: number; y: number }; properties?: Record<string, boolean | string> }): ComponentActionResult;\n\tcanCreateInstance(componentId?: string, parentId?: string): true | string;\n\tdetachInstance(ids?: Iterable<string>): ComponentActionResult;\n\tcanDetachInstance(ids?: Iterable<string>): true | string;\n\tresetOverrides(id?: string, group?: string): ComponentActionResult;\n\tcanResetOverrides(id?: string): true | string;\n\tpushOverrides(id?: string): ComponentActionResult;\n\tcanPushOverrides(id?: string): true | string;\n\tswapInstance(componentId: string, ids?: Iterable<string>): ComponentActionResult;\n\tcanSwapInstance(componentId?: string, ids?: Iterable<string>): true | string;\n\tsetInstanceProperties(properties: Record<string, unknown>, ids?: Iterable<string>): ComponentActionResult;\n\tcanSetInstanceProperties(ids?: Iterable<string>): true | string;\n\trestoreMainComponent(id?: string): ComponentActionResult;\n\tcanRestoreMainComponent(id?: string): true | string;\n\tgoToMainComponent(id?: string): string | undefined;\n\tcanGoToMainComponent(id?: string): true | string;\n\tlist(): unknown;\n\tinspect(id?: string): unknown;\n\t// Variant editing (optional so older targets keep type-checking; the controller has them all).\n\taddVariant?(\n\t\tsetId?: string,\n\t\toptions?: { from?: string; variant?: Record<string, string>; position?: { x: number; y: number }; defaultValue?: string }\n\t): ComponentActionResult;\n\tcanAddVariant?(setId?: string, options?: { from?: string; variant?: Record<string, string> }): true | string;\n\tremoveVariant?(variantId?: string): ComponentActionResult;\n\tcanRemoveVariant?(variantId?: string): true | string;\n\tsetVariantProperties?(values: Record<string, string>, variantId?: string, options?: { defaultValue?: string }): ComponentActionResult;\n\tcanSetVariantProperties?(values?: Record<string, string>, variantId?: string): true | string;\n\trenameVariantProperty?(name: string, newName: string, setId?: string): ComponentActionResult;\n\tcanRenameVariantProperty?(name?: string, newName?: string, setId?: string): true | string;\n\trenameVariantValue?(property: string, value: string, newValue: string, setId?: string): ComponentActionResult;\n\tcanRenameVariantValue?(property?: string, value?: string, newValue?: string, setId?: string): true | string;\n}\n\n/** The variant-editing part of a `ComponentCommandTarget` (present on the components controller). */\ntype VariantCommandTarget = Required<\n\tPick<\n\t\tComponentCommandTarget,\n\t\t| 'addVariant'\n\t\t| 'canAddVariant'\n\t\t| 'removeVariant'\n\t\t| 'canRemoveVariant'\n\t\t| 'setVariantProperties'\n\t\t| 'canSetVariantProperties'\n\t\t| 'renameVariantProperty'\n\t\t| 'canRenameVariantProperty'\n\t\t| 'renameVariantValue'\n\t\t| 'canRenameVariantValue'\n\t>\n>;\n\n/** Whether a command target can edit variants. */\nexport function hasVariantCommands(controller: ComponentCommandTarget): controller is ComponentCommandTarget & VariantCommandTarget {\n\treturn typeof controller.addVariant === 'function' && typeof controller.removeVariant === 'function';\n}\n\nconst SET_ID_PARAM = { type: 'string', description: 'Component set (or one of its variants) to act on (default: the selection’s set).' } as const;\nconst VARIANT_ID_PARAM = { type: 'string', description: 'Variant to act on (default: the first selected variant).' } as const;\nconst VARIANT_VALUES_PARAM = {\n\ttype: 'object',\n\tdescription: 'Variant property → value, e.g. { \"Size\": \"Medium\" }. New property names are added to every variant.',\n\tadditionalProperties: { type: 'string' }\n} as const;\n\nfunction variantCommands(controller: ComponentCommandTarget & VariantCommandTarget, prefix: string, base: Partial<CommandSpec>): CommandSpec[] {\n\treturn [\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}addVariant`,\n\t\t\tlabel: 'Add Variant',\n\t\t\tkeywords: ['variant', 'new variant', 'duplicate variant', 'component set'],\n\t\t\tdescription: 'Adds a variant to a component set by duplicating one (default: the selected or default variant) with new property values.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tsetId: SET_ID_PARAM,\n\t\t\t\t\tfrom: { type: 'string', description: 'Variant to duplicate (default: the selected variant, else the default one).' },\n\t\t\t\t\tvariant: VARIANT_VALUES_PARAM,\n\t\t\t\t\tx: { type: 'number', description: 'X in the set’s space (default: next to the source).' },\n\t\t\t\t\ty: { type: 'number', description: 'Y in the set’s space.' }\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { setId?: string; from?: string; variant?: Record<string, string> }) =>\n\t\t\t\tcontroller.canAddVariant(params?.setId, {\n\t\t\t\t\t...(params?.from !== undefined ? { from: params.from } : {}),\n\t\t\t\t\t...(params?.variant ? { variant: params.variant } : {})\n\t\t\t\t}),\n\t\t\trun: (_ctx: unknown, params?: { setId?: string; from?: string; variant?: Record<string, string>; x?: number; y?: number }) =>\n\t\t\t\toutcome(\n\t\t\t\t\tcontroller.addVariant(params?.setId, {\n\t\t\t\t\t\t...(params?.from !== undefined ? { from: params.from } : {}),\n\t\t\t\t\t\t...(params?.variant ? { variant: params.variant } : {}),\n\t\t\t\t\t\t...(params?.x !== undefined || params?.y !== undefined ? { position: { x: params?.x ?? 0, y: params?.y ?? 0 } } : {})\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}removeVariant`,\n\t\t\tlabel: 'Remove Variant',\n\t\t\tkeywords: ['delete variant', 'variant'],\n\t\t\tdescription: 'Removes a variant; its instances switch to the closest remaining variant, keeping overrides.',\n\t\t\tparams: { type: 'object', properties: { id: VARIANT_ID_PARAM } },\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canRemoveVariant(params?.id),\n\t\t\trun: (_ctx: unknown, params?: { id?: string }) => outcome(controller.removeVariant(params?.id))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}setVariantProperties`,\n\t\t\tlabel: 'Edit Variant Properties…',\n\t\t\tkeywords: ['rename variant', 'variant values', 'variant'],\n\t\t\tdescription: 'Sets a variant’s property values (refusing a combination another variant has).',\n\t\t\tparams: { type: 'object', properties: { values: VARIANT_VALUES_PARAM, id: VARIANT_ID_PARAM }, required: ['values'] },\n\t\t\tenabled: (_ctx: unknown, params?: { values?: Record<string, string>; id?: string }) => controller.canSetVariantProperties(params?.values, params?.id),\n\t\t\trun: (_ctx: unknown, params: { values: Record<string, string>; id?: string }) => outcome(controller.setVariantProperties(params.values, params?.id))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}renameVariantProperty`,\n\t\t\tlabel: 'Rename Variant Property…',\n\t\t\tkeywords: ['rename property', 'variant property'],\n\t\t\tdescription: 'Renames a variant property across a component set.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { name: { type: 'string' }, newName: { type: 'string' }, setId: SET_ID_PARAM },\n\t\t\t\trequired: ['name', 'newName']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { name?: string; newName?: string; setId?: string }) =>\n\t\t\t\tcontroller.canRenameVariantProperty(params?.name, params?.newName, params?.setId),\n\t\t\trun: (_ctx: unknown, params: { name: string; newName: string; setId?: string }) =>\n\t\t\t\toutcome(controller.renameVariantProperty(params.name, params.newName, params?.setId))\n\t\t} as CommandSpec,\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}renameVariantValue`,\n\t\t\tlabel: 'Rename Variant Value…',\n\t\t\tkeywords: ['rename value', 'variant value'],\n\t\t\tdescription: 'Renames a value of a variant property across a component set.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { property: { type: 'string' }, value: { type: 'string' }, newValue: { type: 'string' }, setId: SET_ID_PARAM },\n\t\t\t\trequired: ['property', 'value', 'newValue']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { property?: string; value?: string; newValue?: string; setId?: string }) =>\n\t\t\t\tcontroller.canRenameVariantValue(params?.property, params?.value, params?.newValue, params?.setId),\n\t\t\trun: (_ctx: unknown, params: { property: string; value: string; newValue: string; setId?: string }) =>\n\t\t\t\toutcome(controller.renameVariantValue(params.property, params.value, params.newValue, params?.setId))\n\t\t} as CommandSpec\n\t];\n}\n\nexport interface ComponentCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n}\n\nconst outcome = (result: ComponentActionResult) => {\n\tif (!result.ok) throw new Error(result.reason);\n\treturn { ids: result.ids };\n};\n\nconst ID_PARAM = { type: 'string', description: 'Instance (or layer inside one) to act on (default: the first selected node).' } as const;\n\n/**\n * Palette / context-menu / agent commands for components and instances:\n * `canvas.createComponent`, `canvas.combineAsVariants`, `canvas.createInstance`\n * (`{ componentId, parentId?, x?, y?, properties? }`), `canvas.detachInstance`,\n * `canvas.resetOverrides` (`{ id?, group? }`), `canvas.pushOverrides`, `canvas.goToMainComponent`,\n * `canvas.swapInstance` (`{ componentId, ids? }`), `canvas.setInstanceProperties`\n * (`{ properties, ids? }`: variant and component property values), `canvas.restoreMainComponent`,\n * the variant editors `canvas.addVariant` (`{ setId?, from?, variant?, x?, y? }`),\n * `canvas.removeVariant` (`{ id? }`), `canvas.setVariantProperties` (`{ values, id? }`),\n * `canvas.renameVariantProperty` (`{ name, newName, setId? }`) and `canvas.renameVariantValue`\n * (`{ property, value, newValue, setId? }`) when the target has them, and the read-only `canvas.listComponents` / `canvas.inspectInstance`. Each action is one\n * undoable step when the controller has a history; enablement explains why it cannot run.\n */\nexport function createComponentCommands(controller: ComponentCommandTarget, options: ComponentCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Components';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst base = { group, ...(scope ? { scope } : {}) };\n\tconst idParams: CommandParamsSchema = { type: 'object', properties: { id: ID_PARAM } };\n\treturn [\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}createComponent`,\n\t\t\tlabel: 'Create Component',\n\t\t\tkeywords: ['component', 'symbol', 'main component', 'reusable'],\n\t\t\tdescription: 'Turns the selected frame into a main component, or wraps the selection in one.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tshortcut: 'Mod+Alt+K',\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canCreateComponent(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.createComponent(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}combineAsVariants`,\n\t\t\tlabel: 'Combine as Variants',\n\t\t\tkeywords: ['component set', 'variant', 'variants'],\n\t\t\tdescription: 'Wraps the selected components in a component set.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canCombineAsVariants(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.combineAsVariants(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}createInstance`,\n\t\t\tlabel: 'Create Instance',\n\t\t\tkeywords: ['instance', 'insert component', 'use component'],\n\t\t\tdescription: 'Places an instance of a component (or a component set’s default variant).',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tcomponentId: { type: 'string', description: 'Component or component set id.' },\n\t\t\t\t\tparentId: { type: 'string', description: 'Frame to place it in (default: the canvas).' },\n\t\t\t\t\tx: { type: 'number', description: 'X in the parent’s space (default: next to the main).' },\n\t\t\t\t\ty: { type: 'number', description: 'Y in the parent’s space.' },\n\t\t\t\t\tproperties: { type: 'object', description: 'Variant and component property values.', additionalProperties: true }\n\t\t\t\t},\n\t\t\t\trequired: ['componentId']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { componentId?: string; parentId?: string }) =>\n\t\t\t\tparams?.componentId === undefined ? true : controller.canCreateInstance(params.componentId, params.parentId),\n\t\t\trun: (_ctx: unknown, params: { componentId: string; parentId?: string; x?: number; y?: number; properties?: Record<string, boolean | string> }) =>\n\t\t\t\toutcome(\n\t\t\t\t\tcontroller.createInstance(params.componentId, {\n\t\t\t\t\t\t...(params.parentId !== undefined ? { parentId: params.parentId } : {}),\n\t\t\t\t\t\t...(params.x !== undefined || params.y !== undefined ? { position: { x: params.x ?? 0, y: params.y ?? 0 } } : {}),\n\t\t\t\t\t\t...(params.properties ? { properties: params.properties } : {})\n\t\t\t\t\t})\n\t\t\t\t)\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}detachInstance`,\n\t\t\tlabel: 'Detach Instance',\n\t\t\tkeywords: ['unlink', 'break instance'],\n\t\t\tdescription: 'Turns the selected instances into plain frames that keep their look.',\n\t\t\tparams: IDS_PARAMS,\n\t\t\tshortcut: 'Mod+Alt+B',\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canDetachInstance(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { ids?: string[] }) => outcome(controller.detachInstance(params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}resetOverrides`,\n\t\t\tlabel: 'Reset All Changes',\n\t\t\tkeywords: ['reset instance', 'reset overrides', 'revert'],\n\t\t\tdescription: 'Resets the overrides of an instance (or of a layer, or one override group) to its main.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tid: ID_PARAM,\n\t\t\t\t\tgroup: { type: 'string', description: 'One override group to reset, e.g. \"data.label\" or \"shape.fill\" (default: all).' }\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canResetOverrides(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string; group?: string }) => outcome(controller.resetOverrides(params?.id, params?.group))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}pushOverrides`,\n\t\t\tlabel: 'Push Changes to Main Component',\n\t\t\tkeywords: ['push overrides', 'update main component'],\n\t\t\tdescription: 'Copies the instance’s overrides to its main component and every other instance.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canPushOverrides(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => outcome(controller.pushOverrides(params?.id))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}goToMainComponent`,\n\t\t\tlabel: 'Go to Main Component',\n\t\t\tkeywords: ['main component', 'find main', 'reveal'],\n\t\t\tdescription: 'Selects the main component of the selected instance.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canGoToMainComponent(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => {\n\t\t\t\tconst main = controller.goToMainComponent(params?.id);\n\t\t\t\tif (!main) throw new Error('The main component was not found.');\n\t\t\t\treturn { id: main };\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}swapInstance`,\n\t\t\tlabel: 'Swap Instance…',\n\t\t\tkeywords: ['replace instance', 'swap component'],\n\t\t\tdescription: 'Makes the selected instances show another component, keeping matching overrides.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tcomponentId: { type: 'string', description: 'Component or component set to swap to.' },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t},\n\t\t\t\trequired: ['componentId']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { componentId?: string; ids?: string[] }) => controller.canSwapInstance(params?.componentId, params?.ids),\n\t\t\trun: (_ctx: unknown, params: { componentId: string; ids?: string[] }) => outcome(controller.swapInstance(params.componentId, params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}setInstanceProperties`,\n\t\t\tlabel: 'Set Instance Properties…',\n\t\t\tkeywords: ['variant', 'switch variant', 'component property', 'toggle'],\n\t\t\tdescription: 'Sets variant properties (switching variants) and component property values of the selected instances.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\tproperties: { type: 'object', description: 'Property name → value (variant value, boolean, text or component id).', additionalProperties: true },\n\t\t\t\t\tids: IDS_PARAMS.properties!.ids\n\t\t\t\t},\n\t\t\t\trequired: ['properties']\n\t\t\t},\n\t\t\tenabled: (_ctx: unknown, params?: { ids?: string[] }) => controller.canSetInstanceProperties(params?.ids),\n\t\t\trun: (_ctx: unknown, params: { properties: Record<string, unknown>; ids?: string[] }) =>\n\t\t\t\toutcome(controller.setInstanceProperties(params.properties, params?.ids))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}restoreMainComponent`,\n\t\t\tlabel: 'Restore Main Component',\n\t\t\tkeywords: ['missing main', 'recover component'],\n\t\t\tdescription: 'Turns an instance whose main was deleted back into the main component.',\n\t\t\tparams: idParams,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => controller.canRestoreMainComponent(params?.id),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => outcome(controller.restoreMainComponent(params?.id))\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}listComponents`,\n\t\t\tlabel: 'List Components',\n\t\t\tkeywords: ['components', 'variants', 'assets'],\n\t\t\tdescription: 'Lists the components and component sets (with their variant options).',\n\t\t\treadOnly: true,\n\t\t\trun: () => controller.list()\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}inspectInstance`,\n\t\t\tlabel: 'Inspect Instance',\n\t\t\tkeywords: ['instance', 'overrides', 'properties'],\n\t\t\tdescription: 'Describes an instance: its main, variant, property values and overrides.',\n\t\t\tparams: idParams,\n\t\t\treadOnly: true,\n\t\t\tenabled: (_ctx: unknown, params?: { id?: string }) => (controller.inspect(params?.id) ? true : 'Select an instance.'),\n\t\t\trun: (_ctx: unknown, params: { id?: string }) => controller.inspect(params?.id) ?? null\n\t\t},\n\t\t...(hasVariantCommands(controller) ? variantCommands(controller, prefix, base) : [])\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// Spreadsheet table actions\n// ---------------------------------------------------------------------------\n\n/** Spreadsheet controller surface used by `createSpreadsheetCommands`. */\nexport interface SpreadsheetCommandTarget {\n\tselectedRange: unknown;\n\tgetFilterState(): { enabled: boolean; rules: readonly unknown[] };\n\ttoggleFilters(): void;\n\tclearFilters(): void;\n\tunhideAll(): void;\n\tmergeCells(): boolean;\n\tunmergeCells(): boolean;\n\ttransposeRange(): boolean;\n}\n\nexport interface SpreadsheetCommandOptions {\n\t/** Id prefix (default `spreadsheet.`). */\n\tprefix?: string;\n\t/** Scope (default `spreadsheet`). Pass `null` for global. */\n\tscope?: string | null;\n}\n\n/** Turns a controller's `false` (nothing changed) into a failure the palette and agents see. */\nfunction orFail(changed: boolean, message: string): true {\n\tif (!changed) throw new Error(message);\n\treturn true;\n}\n\n/**\n * Palette / agent commands for common spreadsheet table actions (no default shortcuts).\n * Merge, unmerge and transpose act on the user's selection; agents should use the\n * `merge_cells` / `unmerge_cells` / `transpose_range` tools, which take a range.\n */\nexport function createSpreadsheetCommands(\n\tcontroller: SpreadsheetCommandTarget,\n\toptions: SpreadsheetCommandOptions = {}\n): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'spreadsheet.';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'spreadsheet';\n\tconst hasRange = () => (controller.selectedRange ? true : 'Select a range first.');\n\tconst base = { group: 'Table', ...(scope ? { scope } : {}) };\n\treturn [\n\t\t{ ...base, id: `${prefix}toggleFilters`, label: 'Toggle Filters', keywords: ['filter'], run: () => controller.toggleFilters() },\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}clearFilters`,\n\t\t\tlabel: 'Clear Filters',\n\t\t\tkeywords: ['filter', 'reset'],\n\t\t\tenabled: () => (controller.getFilterState().rules.length > 0 ? true : 'No filters to clear.'),\n\t\t\trun: () => controller.clearFilters()\n\t\t},\n\t\t{ ...base, id: `${prefix}unhideAll`, label: 'Unhide All Rows and Columns', keywords: ['show', 'hidden'], run: () => controller.unhideAll() },\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}mergeCells`,\n\t\t\tlabel: 'Merge Cells',\n\t\t\tkeywords: ['combine'],\n\t\t\tenabled: hasRange,\n\t\t\trun: () =>\n\t\t\t\torFail(controller.mergeCells(), 'Cannot merge the selection: it is a single cell, or it partly overlaps a merge or a spill range.')\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}unmergeCells`,\n\t\t\tlabel: 'Unmerge Cells',\n\t\t\tkeywords: ['split'],\n\t\t\tenabled: hasRange,\n\t\t\trun: () => orFail(controller.unmergeCells(), 'There are no merged cells in the selection.')\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}transposeRange`,\n\t\t\tlabel: 'Transpose Range',\n\t\t\tkeywords: ['rotate', 'swap rows columns'],\n\t\t\tenabled: hasRange,\n\t\t\trun: () =>\n\t\t\t\torFail(controller.transposeRange(), 'Cannot transpose the selection: it is a single cell, or a merge or a spill range is in the way.')\n\t\t}\n\t];\n}\n"]}

package/dist/chunk-VJUVNERT.cjs

@@ -0,0 +1,201 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/tools/capture.ts
+function unionCaptureRects(rects) {
+  let minX = Infinity;
+  let minY = Infinity;
+  let maxX = -Infinity;
+  let maxY = -Infinity;
+  for (const r of rects) {
+    if (!r) continue;
+    minX = Math.min(minX, r.x);
+    minY = Math.min(minY, r.y);
+    maxX = Math.max(maxX, r.x + r.width);
+    maxY = Math.max(maxY, r.y + r.height);
+  }
+  return minX === Infinity ? null : { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+function captureOutputSize(rect, maxEdge, maxScale = 2) {
+  const longest = Math.max(rect.width, rect.height);
+  const scale = Math.min(maxScale, maxEdge / longest);
+  return {
+    width: Math.max(1, Math.round(rect.width * scale)),
+    height: Math.max(1, Math.round(rect.height * scale)),
+    scale
+  };
+}
+function toCapturedImageData(image, fallbackMimeType) {
+  if (typeof image !== "string") return image;
+  if (!image.startsWith("data:")) return { data: image, mimeType: fallbackMimeType };
+  const match = /^data:([^;,]*)(?:;[^,]*)?,(.*)$/s.exec(image);
+  if (!_optionalChain([match, 'optionalAccess', _ => _[1]]) || !match[2]) throw new Error("The surface returned an empty image; rendering may not be available in this environment.");
+  return { data: match[2], mimeType: match[1] };
+}
+var round = (n) => Math.round(n * 100) / 100;
+var roundRect = (r) => ({ x: round(r.x), y: round(r.y), width: round(r.width), height: round(r.height) });
+var pad = (r, p) => ({ x: r.x - p, y: r.y - p, width: r.width + 2 * p, height: r.height + 2 * p });
+function regionsOf(surface) {
+  return [
+    ...surface.viewport ? ["viewport"] : [],
+    "content",
+    ...surface.selection ? ["selection"] : [],
+    ...surface.items ? [surface.items.region] : [],
+    "rect"
+  ];
+}
+function captureInputSchema(surface, options = {}) {
+  const regions = regionsOf(surface);
+  const units = surface.units;
+  const properties = {
+    region: {
+      type: "string",
+      enum: regions,
+      description: `What to capture (default ${regions[0]}): ` + [
+        surface.viewport ? '"viewport" is what is on screen now' : "",
+        '"content" is everything',
+        surface.selection ? '"selection" is the selected items' : "",
+        surface.items ? `"${surface.items.region}" is the ${surface.items.noun}s in "ids"` : "",
+        `"rect" is the area in "rect"`
+      ].filter(Boolean).join(", ") + "."
+    },
+    ...surface.items ? {
+      ids: {
+        type: "array",
+        items: { type: "string" },
+        minItems: 1,
+        description: `With region "${surface.items.region}": ids of the ${surface.items.noun}s to frame${surface.items.source ? ` (from ${surface.items.source})` : ""}.`
+      }
+    } : {},
+    rect: {
+      type: "object",
+      properties: {
+        x: { type: "number", description: `Left edge in ${units}.` },
+        y: { type: "number", description: `Top edge in ${units}.` },
+        width: { type: "number", exclusiveMinimum: 0, description: `Width in ${units}.` },
+        height: { type: "number", exclusiveMinimum: 0, description: `Height in ${units}.` }
+      },
+      required: ["x", "y", "width", "height"],
+      additionalProperties: false,
+      description: `With region "rect": the area to capture, in ${units}.`
+    },
+    padding: {
+      type: "number",
+      minimum: 0,
+      description: `Margin around content, selection${surface.items ? ` and ${surface.items.region}` : ""} regions, in ${units} (default ${_nullishCoalesce(options.defaultPadding, () => ( 16))}).`
+    },
+    maxEdge: {
+      type: "integer",
+      minimum: 64,
+      maximum: 4096,
+      description: `Longest side of the image in pixels (default ${_nullishCoalesce(options.defaultMaxEdge, () => ( 1024))}). Small regions are not enlarged beyond ${_nullishCoalesce(surface.maxScale, () => ( 2))} pixels per unit.`
+    },
+    format: { type: "string", enum: ["png", "jpeg"], description: "Image format (default png; jpeg is smaller for photos)." },
+    quality: { type: "number", minimum: 0.1, maximum: 1, description: "JPEG quality from 0.1 to 1 (default 0.85). Ignored for png." },
+    ...surface.overlays ? { includeOverlays: { type: "boolean", description: `Also draw ${surface.overlays} (default false).` } } : {}
+  };
+  return { type: "object", properties, additionalProperties: false };
+}
+function resolveCaptureRequest(surface, args, options = {}) {
+  const regions = regionsOf(surface);
+  const region = _nullishCoalesce(args.region, () => ( regions[0]));
+  if (!regions.includes(region)) throw new Error(`Unknown region "${region}". Use one of: ${regions.join(", ")}.`);
+  if (args.rect !== void 0 && region !== "rect") throw new Error(`"rect" only applies with region "rect"; drop it or set region to "rect".`);
+  if (args.ids !== void 0 && region !== _optionalChain([surface, 'access', _2 => _2.items, 'optionalAccess', _3 => _3.region])) {
+    throw new Error(`"ids" only applies with region "${_nullishCoalesce(_optionalChain([surface, 'access', _4 => _4.items, 'optionalAccess', _5 => _5.region]), () => ( "items"))}"; drop it or change the region.`);
+  }
+  const padding = typeof args.padding === "number" ? args.padding : _nullishCoalesce(options.defaultPadding, () => ( 16));
+  let rect;
+  let ids;
+  if (region === "viewport") {
+    rect = surface.viewport();
+    if (!rect) throw new Error('The view is not on screen (not mounted or zero size). Use region "content" instead.');
+  } else if (region === "content") {
+    const content = surface.content();
+    if (!content) throw new Error("There is nothing to capture: the surface is empty.");
+    rect = pad(content, padding);
+  } else if (region === "selection") {
+    const selection = surface.selection();
+    if (!selection.rect) throw new Error('Nothing is selected. Select something first, or use region "content".');
+    rect = pad(selection.rect, padding);
+    ids = selection.ids;
+  } else if (region === "rect") {
+    if (!args.rect) throw new Error(`Region "rect" needs "rect": {"x", "y", "width", "height"} in ${surface.units}.`);
+    rect = { x: args.rect.x, y: args.rect.y, width: args.rect.width, height: args.rect.height };
+  } else {
+    const items = surface.items;
+    const wanted = Array.isArray(args.ids) ? args.ids : [];
+    if (!wanted.length) throw new Error(`Region "${items.region}" needs "ids": the ${items.noun} ids to frame.`);
+    const found = items.bounds(wanted);
+    if (found.missing.length) {
+      throw new Error(
+        `Unknown ${items.noun} id(s): ${found.missing.join(", ")}.${items.source ? ` Read the current ids with ${items.source}.` : ""}`
+      );
+    }
+    if (!found.rect) throw new Error(`The ${items.noun}s ${wanted.join(", ")} have no size yet; try again once they are drawn.`);
+    rect = pad(found.rect, padding);
+    ids = wanted;
+  }
+  if (!(rect.width > 0) || !(rect.height > 0)) {
+    throw new Error(`The ${region} region is empty (${rect.width} \xD7 ${rect.height} ${surface.units}); capture a larger area.`);
+  }
+  const maxEdge = typeof args.maxEdge === "number" ? args.maxEdge : _nullishCoalesce(options.defaultMaxEdge, () => ( 1024));
+  const size = captureOutputSize(rect, maxEdge, _nullishCoalesce(surface.maxScale, () => ( 2)));
+  return {
+    region,
+    rect,
+    ...size,
+    format: args.format === "jpeg" ? "jpeg" : "png",
+    quality: typeof args.quality === "number" ? args.quality : 0.85,
+    includeOverlays: !!surface.overlays && args.includeOverlays === true,
+    ...ids ? { ids } : {}
+  };
+}
+function createCaptureTool(surface, options = {}) {
+  const title = _nullishCoalesce(options.title, () => ( "Capture a screenshot"));
+  const subject = _nullishCoalesce(options.subject, () => ( "the view"));
+  return {
+    name: _nullishCoalesce(options.name, () => ( "capture_view")),
+    title,
+    description: `Takes a screenshot of ${subject} so you can check how it looks, without changing anything. Captures the ${regionsOf(surface).join(", ")} region and returns the image plus the captured rect (in ${surface.units}) and the pixel scale, so a point (px, py) in the image is at (rect.x + px / scale, rect.y + py / scale).` + (surface.overlays ? ` Transient overlays (${surface.overlays}) are left out unless includeOverlays is true.` : ""),
+    inputSchema: captureInputSchema(surface, options),
+    annotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    handler: async (args, context) => {
+      const { ids, ...request } = resolveCaptureRequest(surface, args, options);
+      const mimeType = request.format === "jpeg" ? "image/jpeg" : "image/png";
+      const image = toCapturedImageData(await surface.render({ ...request, signal: context.signal }), mimeType);
+      const rect = roundRect(request.rect);
+      const meta = {
+        region: request.region,
+        rect,
+        units: surface.units,
+        width: request.width,
+        height: request.height,
+        scale: round(request.scale),
+        mimeType: image.mimeType,
+        ...ids ? { ids } : {}
+      };
+      return {
+        content: [
+          { type: "image", data: image.data, mimeType: image.mimeType },
+          {
+            type: "text",
+            text: `Captured ${request.region} at ${request.width}\xD7${request.height} px: x ${rect.x}, y ${rect.y}, ${rect.width}\xD7${rect.height} ${surface.units} (${meta.scale} px per unit).`
+          }
+        ],
+        structuredContent: meta
+      };
+    }
+  };
+}
+function createCaptureToolProvider(surface, options = {}) {
+  return { id: _nullishCoalesce(options.id, () => ( "capture")), namespace: options.namespace, tools: [createCaptureTool(surface, options)] };
+}
+
+
+
+
+
+
+
+
+
+exports.unionCaptureRects = unionCaptureRects; exports.captureOutputSize = captureOutputSize; exports.toCapturedImageData = toCapturedImageData; exports.captureInputSchema = captureInputSchema; exports.resolveCaptureRequest = resolveCaptureRequest; exports.createCaptureTool = createCaptureTool; exports.createCaptureToolProvider = createCaptureToolProvider;
+//# sourceMappingURL=chunk-VJUVNERT.cjs.map

package/dist/chunk-VJUVNERT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/chunk-VJUVNERT.cjs","../src/tools/capture.ts"],"names":[],"mappings":"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","file":"/home/runner/work/editor/editor/packages/core/dist/chunk-VJUVNERT.cjs","sourcesContent":[null,"import type { AgentTool, AgentToolProvider, McpToolResult } from './registry.js';\nimport type { JsonSchema } from './schema.js';\n\n/** A rectangle in a surface's own units (canvas units, image pixels, CSS pixels). */\nexport interface CaptureRect {\n\tx: number;\n\ty: number;\n\twidth: number;\n\theight: number;\n}\n\n/**\n * What to capture: what is on screen (`viewport`), everything (`content`), the\n * selection, the bounds of some items by id (the surface's `items.region`,\n * e.g. `nodes`), or an explicit `rect`.\n */\nexport type CaptureRegion = 'viewport' | 'content' | 'selection' | 'rect' | (string & {});\n\nexport type CaptureFormat = 'png' | 'jpeg';\n\n/** What a surface is asked to draw. */\nexport interface CaptureRenderRequest {\n\t/** Region name the agent asked for. */\n\tregion: CaptureRegion;\n\t/** The area to draw, in surface units. */\n\trect: CaptureRect;\n\t/** Output size in pixels. */\n\twidth: number;\n\theight: number;\n\t/** Output pixels per surface unit (`width / rect.width`). */\n\tscale: number;\n\tformat: CaptureFormat;\n\t/** JPEG quality, 0-1. */\n\tquality: number;\n\t/** Draw selection boxes, presence cursors and other transient overlays too. */\n\tincludeOverlays: boolean;\n\tsignal?: AbortSignal;\n}\n\n/** A rendered image: base64 data with its MIME type, or a `data:` URL. */\nexport type CapturedImage = { data: string; mimeType: string } | string;\n\n/**\n * Something an agent can take a screenshot of. Bounds are in the surface's\n * own units; `render` draws a rectangle of it at a given pixel size.\n */\nexport interface CaptureSurface {\n\t/** Name of the coordinate space, used in the tool description and results (e.g. `canvas units`). */\n\tunits: string;\n\t/** What is on screen now. Omit when the surface has no viewport. */\n\tviewport?: () => CaptureRect | null;\n\t/** Bounds of everything, or `null` when the surface is empty. */\n\tcontent: () => CaptureRect | null;\n\t/** Bounds of the selection (`null` when nothing is selected) and the selected ids. */\n\tselection?: () => { rect: CaptureRect | null; ids?: string[] };\n\t/** Capture by item ids, e.g. canvas nodes. */\n\titems?: {\n\t\t/** Region name, e.g. `nodes`. */\n\t\tregion: string;\n\t\t/** Singular noun for messages, e.g. `node`. */\n\t\tnoun: string;\n\t\t/** Where the ids come from, for error messages (e.g. `get_editor_state`). */\n\t\tsource?: string;\n\t\t/** Bounds of the found items and the ids that were not found. */\n\t\tbounds: (ids: string[]) => { rect: CaptureRect | null; missing: string[] };\n\t};\n\t/** Describes the overlays `includeOverlays` adds; omit when the surface has none. */\n\toverlays?: string;\n\t/** Largest output pixels per surface unit (default 2). */\n\tmaxScale?: number;\n\trender: (request: CaptureRenderRequest) => CapturedImage | Promise<CapturedImage>;\n}\n\nexport interface CaptureToolOptions {\n\t/** Tool name (default `capture_view`). */\n\tname?: string;\n\t/** Tool title (default `Capture a screenshot`). */\n\ttitle?: string;\n\t/** What is being captured, for the description (default `the view`). */\n\tsubject?: string;\n\t/** Longest output side when the agent passes no `maxEdge` (default 1024). */\n\tdefaultMaxEdge?: number;\n\t/** Margin around `content`, `selection` and item regions when the agent passes no `padding` (default 16 units). */\n\tdefaultPadding?: number;\n}\n\nexport interface CaptureToolProviderOptions extends CaptureToolOptions {\n\t/** Provider id (unique per registry, default `capture`). */\n\tid?: string;\n\t/** Always prefix tool names with `<namespace>__`. */\n\tnamespace?: string;\n}\n\n/** Bounds of the capture: union of rects, `null` for none. */\nexport function unionCaptureRects(rects: readonly (CaptureRect | null | undefined)[]): CaptureRect | null {\n\tlet minX = Infinity;\n\tlet minY = Infinity;\n\tlet maxX = -Infinity;\n\tlet maxY = -Infinity;\n\tfor (const r of rects) {\n\t\tif (!r) continue;\n\t\tminX = Math.min(minX, r.x);\n\t\tminY = Math.min(minY, r.y);\n\t\tmaxX = Math.max(maxX, r.x + r.width);\n\t\tmaxY = Math.max(maxY, r.y + r.height);\n\t}\n\treturn minX === Infinity ? null : { x: minX, y: minY, width: maxX - minX, height: maxY - minY };\n}\n\n/**\n * Output pixel size for `rect`: the longest side at most `maxEdge`, never more\n * than `maxScale` pixels per unit, at least 1 × 1.\n */\nexport function captureOutputSize(rect: CaptureRect, maxEdge: number, maxScale = 2): { width: number; height: number; scale: number } {\n\tconst longest = Math.max(rect.width, rect.height);\n\tconst scale = Math.min(maxScale, maxEdge / longest);\n\treturn {\n\t\twidth: Math.max(1, Math.round(rect.width * scale)),\n\t\theight: Math.max(1, Math.round(rect.height * scale)),\n\t\tscale\n\t};\n}\n\n/** Splits a `data:` URL or plain base64 into base64 data and MIME type. */\nexport function toCapturedImageData(image: CapturedImage, fallbackMimeType: string): { data: string; mimeType: string } {\n\tif (typeof image !== 'string') return image;\n\tif (!image.startsWith('data:')) return { data: image, mimeType: fallbackMimeType };\n\tconst match = /^data:([^;,]*)(?:;[^,]*)?,(.*)$/s.exec(image);\n\tif (!match?.[1] || !match[2]) throw new Error('The surface returned an empty image; rendering may not be available in this environment.');\n\treturn { data: match[2], mimeType: match[1] };\n}\n\nconst round = (n: number) => Math.round(n * 100) / 100;\nconst roundRect = (r: CaptureRect): CaptureRect => ({ x: round(r.x), y: round(r.y), width: round(r.width), height: round(r.height) });\nconst pad = (r: CaptureRect, p: number): CaptureRect => ({ x: r.x - p, y: r.y - p, width: r.width + 2 * p, height: r.height + 2 * p });\n\nfunction regionsOf(surface: CaptureSurface): string[] {\n\treturn [\n\t\t...(surface.viewport ? ['viewport'] : []),\n\t\t'content',\n\t\t...(surface.selection ? ['selection'] : []),\n\t\t...(surface.items ? [surface.items.region] : []),\n\t\t'rect'\n\t];\n}\n\n/** JSON Schema of the capture tool's arguments for a surface (only the options it supports). */\nexport function captureInputSchema(surface: CaptureSurface, options: CaptureToolOptions = {}): JsonSchema & { type: 'object' } {\n\tconst regions = regionsOf(surface);\n\tconst units = surface.units;\n\tconst properties: Record<string, JsonSchema> = {\n\t\tregion: {\n\t\t\ttype: 'string',\n\t\t\tenum: regions,\n\t\t\tdescription:\n\t\t\t\t`What to capture (default ${regions[0]}): ` +\n\t\t\t\t[\n\t\t\t\t\tsurface.viewport ? '\"viewport\" is what is on screen now' : '',\n\t\t\t\t\t'\"content\" is everything',\n\t\t\t\t\tsurface.selection ? '\"selection\" is the selected items' : '',\n\t\t\t\t\tsurface.items ? `\"${surface.items.region}\" is the ${surface.items.noun}s in \"ids\"` : '',\n\t\t\t\t\t`\"rect\" is the area in \"rect\"`\n\t\t\t\t]\n\t\t\t\t\t.filter(Boolean)\n\t\t\t\t\t.join(', ') +\n\t\t\t\t'.'\n\t\t},\n\t\t...(surface.items\n\t\t\t? {\n\t\t\t\t\tids: {\n\t\t\t\t\t\ttype: 'array',\n\t\t\t\t\t\titems: { type: 'string' },\n\t\t\t\t\t\tminItems: 1,\n\t\t\t\t\t\tdescription: `With region \"${surface.items.region}\": ids of the ${surface.items.noun}s to frame${surface.items.source ? ` (from ${surface.items.source})` : ''}.`\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t: {}),\n\t\trect: {\n\t\t\ttype: 'object',\n\t\t\tproperties: {\n\t\t\t\tx: { type: 'number', description: `Left edge in ${units}.` },\n\t\t\t\ty: { type: 'number', description: `Top edge in ${units}.` },\n\t\t\t\twidth: { type: 'number', exclusiveMinimum: 0, description: `Width in ${units}.` },\n\t\t\t\theight: { type: 'number', exclusiveMinimum: 0, description: `Height in ${units}.` }\n\t\t\t},\n\t\t\trequired: ['x', 'y', 'width', 'height'],\n\t\t\tadditionalProperties: false,\n\t\t\tdescription: `With region \"rect\": the area to capture, in ${units}.`\n\t\t},\n\t\tpadding: {\n\t\t\ttype: 'number',\n\t\t\tminimum: 0,\n\t\t\tdescription: `Margin around content, selection${surface.items ? ` and ${surface.items.region}` : ''} regions, in ${units} (default ${options.defaultPadding ?? 16}).`\n\t\t},\n\t\tmaxEdge: {\n\t\t\ttype: 'integer',\n\t\t\tminimum: 64,\n\t\t\tmaximum: 4096,\n\t\t\tdescription: `Longest side of the image in pixels (default ${options.defaultMaxEdge ?? 1024}). Small regions are not enlarged beyond ${surface.maxScale ?? 2} pixels per unit.`\n\t\t},\n\t\tformat: { type: 'string', enum: ['png', 'jpeg'], description: 'Image format (default png; jpeg is smaller for photos).' },\n\t\tquality: { type: 'number', minimum: 0.1, maximum: 1, description: 'JPEG quality from 0.1 to 1 (default 0.85). Ignored for png.' },\n\t\t...(surface.overlays\n\t\t\t? { includeOverlays: { type: 'boolean', description: `Also draw ${surface.overlays} (default false).` } }\n\t\t\t: {})\n\t};\n\treturn { type: 'object', properties, additionalProperties: false };\n}\n\n/**\n * Works out the rectangle and pixel size for a capture call, checking the\n * arguments against the surface. Throws an error that says how to fix the call.\n */\nexport function resolveCaptureRequest(\n\tsurface: CaptureSurface,\n\targs: Record<string, any>,\n\toptions: CaptureToolOptions = {}\n): Omit<CaptureRenderRequest, 'signal'> & { ids?: string[] } {\n\tconst regions = regionsOf(surface);\n\tconst region: string = args.region ?? regions[0];\n\tif (!regions.includes(region)) throw new Error(`Unknown region \"${region}\". Use one of: ${regions.join(', ')}.`);\n\tif (args.rect !== undefined && region !== 'rect') throw new Error(`\"rect\" only applies with region \"rect\"; drop it or set region to \"rect\".`);\n\tif (args.ids !== undefined && region !== surface.items?.region) {\n\t\tthrow new Error(`\"ids\" only applies with region \"${surface.items?.region ?? 'items'}\"; drop it or change the region.`);\n\t}\n\tconst padding = typeof args.padding === 'number' ? args.padding : (options.defaultPadding ?? 16);\n\tlet rect: CaptureRect | null;\n\tlet ids: string[] | undefined;\n\tif (region === 'viewport') {\n\t\trect = surface.viewport!();\n\t\tif (!rect) throw new Error('The view is not on screen (not mounted or zero size). Use region \"content\" instead.');\n\t} else if (region === 'content') {\n\t\tconst content = surface.content();\n\t\tif (!content) throw new Error('There is nothing to capture: the surface is empty.');\n\t\trect = pad(content, padding);\n\t} else if (region === 'selection') {\n\t\tconst selection = surface.selection!();\n\t\tif (!selection.rect) throw new Error('Nothing is selected. Select something first, or use region \"content\".');\n\t\trect = pad(selection.rect, padding);\n\t\tids = selection.ids;\n\t} else if (region === 'rect') {\n\t\tif (!args.rect) throw new Error(`Region \"rect\" needs \"rect\": {\"x\", \"y\", \"width\", \"height\"} in ${surface.units}.`);\n\t\trect = { x: args.rect.x, y: args.rect.y, width: args.rect.width, height: args.rect.height };\n\t} else {\n\t\tconst items = surface.items!;\n\t\tconst wanted = Array.isArray(args.ids) ? (args.ids as string[]) : [];\n\t\tif (!wanted.length) throw new Error(`Region \"${items.region}\" needs \"ids\": the ${items.noun} ids to frame.`);\n\t\tconst found = items.bounds(wanted);\n\t\tif (found.missing.length) {\n\t\t\tthrow new Error(\n\t\t\t\t`Unknown ${items.noun} id(s): ${found.missing.join(', ')}.${items.source ? ` Read the current ids with ${items.source}.` : ''}`\n\t\t\t);\n\t\t}\n\t\tif (!found.rect) throw new Error(`The ${items.noun}s ${wanted.join(', ')} have no size yet; try again once they are drawn.`);\n\t\trect = pad(found.rect, padding);\n\t\tids = wanted;\n\t}\n\tif (!(rect.width > 0) || !(rect.height > 0)) {\n\t\tthrow new Error(`The ${region} region is empty (${rect.width} × ${rect.height} ${surface.units}); capture a larger area.`);\n\t}\n\tconst maxEdge = typeof args.maxEdge === 'number' ? args.maxEdge : (options.defaultMaxEdge ?? 1024);\n\tconst size = captureOutputSize(rect, maxEdge, surface.maxScale ?? 2);\n\treturn {\n\t\tregion,\n\t\trect,\n\t\t...size,\n\t\tformat: args.format === 'jpeg' ? 'jpeg' : 'png',\n\t\tquality: typeof args.quality === 'number' ? args.quality : 0.85,\n\t\tincludeOverlays: !!surface.overlays && args.includeOverlays === true,\n\t\t...(ids ? { ids } : {})\n\t};\n}\n\n/**\n * The `capture_view` agent tool for a surface: renders a region as an image\n * the model can look at. The result has the image and a text block, and\n * `structuredContent` with the captured `rect` (surface units), the pixel\n * size and `scale`, so a point in the image maps back with\n * `x = rect.x + px / scale`.\n */\nexport function createCaptureTool(surface: CaptureSurface, options: CaptureToolOptions = {}): AgentTool {\n\tconst title = options.title ?? 'Capture a screenshot';\n\tconst subject = options.subject ?? 'the view';\n\treturn {\n\t\tname: options.name ?? 'capture_view',\n\t\ttitle,\n\t\tdescription:\n\t\t\t`Takes a screenshot of ${subject} so you can check how it looks, without changing anything. ` +\n\t\t\t`Captures the ${regionsOf(surface).join(', ')} region and returns the image plus the captured rect (in ${surface.units}) and the pixel scale, ` +\n\t\t\t'so a point (px, py) in the image is at (rect.x + px / scale, rect.y + py / scale).' +\n\t\t\t(surface.overlays ? ` Transient overlays (${surface.overlays}) are left out unless includeOverlays is true.` : ''),\n\t\tinputSchema: captureInputSchema(surface, options),\n\t\tannotations: { title, readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },\n\t\thandler: async (args, context): Promise<McpToolResult> => {\n\t\t\tconst { ids, ...request } = resolveCaptureRequest(surface, args, options);\n\t\t\tconst mimeType = request.format === 'jpeg' ? 'image/jpeg' : 'image/png';\n\t\t\tconst image = toCapturedImageData(await surface.render({ ...request, signal: context.signal }), mimeType);\n\t\t\tconst rect = roundRect(request.rect);\n\t\t\tconst meta = {\n\t\t\t\tregion: request.region,\n\t\t\t\trect,\n\t\t\t\tunits: surface.units,\n\t\t\t\twidth: request.width,\n\t\t\t\theight: request.height,\n\t\t\t\tscale: round(request.scale),\n\t\t\t\tmimeType: image.mimeType,\n\t\t\t\t...(ids ? { ids } : {})\n\t\t\t};\n\t\t\treturn {\n\t\t\t\tcontent: [\n\t\t\t\t\t{ type: 'image', data: image.data, mimeType: image.mimeType },\n\t\t\t\t\t{\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\ttext: `Captured ${request.region} at ${request.width}×${request.height} px: x ${rect.x}, y ${rect.y}, ${rect.width}×${rect.height} ${surface.units} (${meta.scale} px per unit).`\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\tstructuredContent: meta\n\t\t\t};\n\t\t}\n\t};\n}\n\n/** A provider with just the `capture_view` tool for a surface. */\nexport function createCaptureToolProvider(surface: CaptureSurface, options: CaptureToolProviderOptions = {}): AgentToolProvider {\n\treturn { id: options.id ?? 'capture', namespace: options.namespace, tools: [createCaptureTool(surface, options)] };\n}\n"]}

package/dist/commands/index.cjs

@@ -7,7 +7,7 @@
 
 
 
-var _chunkHXDMZQTDcjs = require('../chunk-HXDMZQTD.cjs');
+var _chunkTPOT575Pcjs = require('../chunk-TPOT575P.cjs');
 
 
 
@@ -980,5 +980,5 @@ function createCanvasAnimationCommands(controller, options = {}) {
 
 
 
-exports.CommandRegistry = CommandRegistry; exports.CommandRegistryError = CommandRegistryError; exports.DEFAULT_HISTORY_SHORTCUTS = _chunkHXDMZQTDcjs.DEFAULT_HISTORY_SHORTCUTS; exports.DEFAULT_RECENT_LIMIT = DEFAULT_RECENT_LIMIT; exports.PLATFORMS = _chunk26BVFKHUcjs.PLATFORMS; exports.ShortcutMap = _chunk26BVFKHUcjs.ShortcutMap; exports.chordToString = _chunk26BVFKHUcjs.chordToString; exports.codeFromKey = _chunk26BVFKHUcjs.codeFromKey; exports.codeToKeyText = _chunk26BVFKHUcjs.codeToKeyText; exports.createArrangeCommands = _chunkHXDMZQTDcjs.createArrangeCommands; exports.createCanvasAnimationCommands = createCanvasAnimationCommands; exports.createCommandPaletteController = createCommandPaletteController; exports.createCommandRegistry = createCommandRegistry; exports.createCommandToolProvider = createCommandToolProvider; exports.createComponentCommands = _chunkHXDMZQTDcjs.createComponentCommands; exports.createHistoryCommands = _chunkHXDMZQTDcjs.createHistoryCommands; exports.createShapeCommands = _chunkHXDMZQTDcjs.createShapeCommands; exports.createSpreadsheetCommands = _chunkHXDMZQTDcjs.createSpreadsheetCommands; exports.defineCommand = defineCommand; exports.detectPlatform = _chunk26BVFKHUcjs.detectPlatform; exports.effectiveChord = _chunk26BVFKHUcjs.effectiveChord; exports.effectiveChordKey = _chunk26BVFKHUcjs.effectiveChordKey; exports.eventCode = _chunk26BVFKHUcjs.eventCode; exports.exactBonus = exactBonus; exports.formatShortcut = _chunk26BVFKHUcjs.formatShortcut; exports.fuzzyMatch = fuzzyMatch; exports.fuzzyScore = fuzzyScore; exports.hasVariantCommands = _chunkHXDMZQTDcjs.hasVariantCommands; exports.isEditableEventTarget = _chunk26BVFKHUcjs.isEditableEventTarget; exports.keyToCode = _chunk26BVFKHUcjs.keyToCode; exports.matchHistoryShortcut = _chunkHXDMZQTDcjs.matchHistoryShortcut; exports.matchPaletteHotkey = matchPaletteHotkey; exports.normalizeChord = _chunk26BVFKHUcjs.normalizeChord; exports.parseChord = _chunk26BVFKHUcjs.parseChord; exports.pushRecent = pushRecent; exports.rankCommands = rankCommands; exports.shortcutCode = _chunk26BVFKHUcjs.shortcutCode; exports.toShortcutBindings = _chunk26BVFKHUcjs.toShortcutBindings;
+exports.CommandRegistry = CommandRegistry; exports.CommandRegistryError = CommandRegistryError; exports.DEFAULT_HISTORY_SHORTCUTS = _chunkTPOT575Pcjs.DEFAULT_HISTORY_SHORTCUTS; exports.DEFAULT_RECENT_LIMIT = DEFAULT_RECENT_LIMIT; exports.PLATFORMS = _chunk26BVFKHUcjs.PLATFORMS; exports.ShortcutMap = _chunk26BVFKHUcjs.ShortcutMap; exports.chordToString = _chunk26BVFKHUcjs.chordToString; exports.codeFromKey = _chunk26BVFKHUcjs.codeFromKey; exports.codeToKeyText = _chunk26BVFKHUcjs.codeToKeyText; exports.createArrangeCommands = _chunkTPOT575Pcjs.createArrangeCommands; exports.createCanvasAnimationCommands = createCanvasAnimationCommands; exports.createCommandPaletteController = createCommandPaletteController; exports.createCommandRegistry = createCommandRegistry; exports.createCommandToolProvider = createCommandToolProvider; exports.createComponentCommands = _chunkTPOT575Pcjs.createComponentCommands; exports.createHistoryCommands = _chunkTPOT575Pcjs.createHistoryCommands; exports.createShapeCommands = _chunkTPOT575Pcjs.createShapeCommands; exports.createSpreadsheetCommands = _chunkTPOT575Pcjs.createSpreadsheetCommands; exports.defineCommand = defineCommand; exports.detectPlatform = _chunk26BVFKHUcjs.detectPlatform; exports.effectiveChord = _chunk26BVFKHUcjs.effectiveChord; exports.effectiveChordKey = _chunk26BVFKHUcjs.effectiveChordKey; exports.eventCode = _chunk26BVFKHUcjs.eventCode; exports.exactBonus = exactBonus; exports.formatShortcut = _chunk26BVFKHUcjs.formatShortcut; exports.fuzzyMatch = fuzzyMatch; exports.fuzzyScore = fuzzyScore; exports.hasVariantCommands = _chunkTPOT575Pcjs.hasVariantCommands; exports.isEditableEventTarget = _chunk26BVFKHUcjs.isEditableEventTarget; exports.keyToCode = _chunk26BVFKHUcjs.keyToCode; exports.matchHistoryShortcut = _chunkTPOT575Pcjs.matchHistoryShortcut; exports.matchPaletteHotkey = matchPaletteHotkey; exports.normalizeChord = _chunk26BVFKHUcjs.normalizeChord; exports.parseChord = _chunk26BVFKHUcjs.parseChord; exports.pushRecent = pushRecent; exports.rankCommands = rankCommands; exports.shortcutCode = _chunk26BVFKHUcjs.shortcutCode; exports.toShortcutBindings = _chunk26BVFKHUcjs.toShortcutBindings;
 //# sourceMappingURL=index.cjs.map

package/dist/commands/index.d.cts

@@ -1,7 +1,7 @@
 import { a as CommandRegistry, P as Platform, b as CommandResult, c as CommandEntry, K as KeyboardEventLike, C as CommandSpec } from '../registry-CaR7LC6W.cjs';
 export { d as Chord, e as CommandErrorCode, f as CommandHistoryTarget, g as CommandListOptions, h as CommandParamsSchema, i as CommandRegistryError, j as CommandRegistryOptions, E as EffectiveChord, k as PLATFORMS, S as ShortcutBinding, l as ShortcutConflict, m as ShortcutInput, n as ShortcutMap, o as ShortcutMapOptions, p as ShortcutMatch, q as ShortcutResolveOptions, r as chordToString, s as codeFromKey, t as codeToKeyText, u as createCommandRegistry, v as defineCommand, w as detectPlatform, x as effectiveChord, y as effectiveChordKey, z as eventCode, A as formatShortcut, B as isEditableEventTarget, D as keyToCode, F as normalizeChord, G as parseChord, H as shortcutCode, I as toShortcutBindings } from '../registry-CaR7LC6W.cjs';
-import { A as AgentToolProvider } from '../registry-DIpIaCkH.cjs';
-export { A as ArrangeCommandOptions, a as ArrangeCommandTarget, C as ComponentCommandOptions, b as ComponentCommandTarget, D as DEFAULT_HISTORY_SHORTCUTS, H as HistoryCommandOptions, c as HistoryCommandTarget, S as ShapeCommandOptions, d as ShapeCommandTarget, e as SpreadsheetCommandOptions, f as SpreadsheetCommandTarget, g as createArrangeCommands, h as createComponentCommands, i as createHistoryCommands, j as createShapeCommands, k as createSpreadsheetCommands, l as hasVariantCommands, m as matchHistoryShortcut } from '../builtins-1kqwLUnb.cjs';
+import { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
+export { A as ArrangeCommandOptions, a as ArrangeCommandTarget, C as ComponentCommandOptions, b as ComponentCommandTarget, D as DEFAULT_HISTORY_SHORTCUTS, H as HistoryCommandOptions, c as HistoryCommandTarget, S as ShapeCommandOptions, d as ShapeCommandTarget, e as SpreadsheetCommandOptions, f as SpreadsheetCommandTarget, g as createArrangeCommands, h as createComponentCommands, i as createHistoryCommands, j as createShapeCommands, k as createSpreadsheetCommands, l as hasVariantCommands, m as matchHistoryShortcut } from '../builtins-c4w0eAYl.cjs';
 import '../schema-Di0CS6Pe.cjs';
 import '../types-DsiXGmjo.cjs';
 import '../arrange-B6GH5Qcc.cjs';

package/dist/commands/index.d.ts

@@ -1,7 +1,7 @@
 import { a as CommandRegistry, P as Platform, b as CommandResult, c as CommandEntry, K as KeyboardEventLike, C as CommandSpec } from '../registry-rVtFJjRM.js';
 export { d as Chord, e as CommandErrorCode, f as CommandHistoryTarget, g as CommandListOptions, h as CommandParamsSchema, i as CommandRegistryError, j as CommandRegistryOptions, E as EffectiveChord, k as PLATFORMS, S as ShortcutBinding, l as ShortcutConflict, m as ShortcutInput, n as ShortcutMap, o as ShortcutMapOptions, p as ShortcutMatch, q as ShortcutResolveOptions, r as chordToString, s as codeFromKey, t as codeToKeyText, u as createCommandRegistry, v as defineCommand, w as detectPlatform, x as effectiveChord, y as effectiveChordKey, z as eventCode, A as formatShortcut, B as isEditableEventTarget, D as keyToCode, F as normalizeChord, G as parseChord, H as shortcutCode, I as toShortcutBindings } from '../registry-rVtFJjRM.js';
-import { A as AgentToolProvider } from '../registry-7AZFuand.js';
-export { A as ArrangeCommandOptions, a as ArrangeCommandTarget, C as ComponentCommandOptions, b as ComponentCommandTarget, D as DEFAULT_HISTORY_SHORTCUTS, H as HistoryCommandOptions, c as HistoryCommandTarget, S as ShapeCommandOptions, d as ShapeCommandTarget, e as SpreadsheetCommandOptions, f as SpreadsheetCommandTarget, g as createArrangeCommands, h as createComponentCommands, i as createHistoryCommands, j as createShapeCommands, k as createSpreadsheetCommands, l as hasVariantCommands, m as matchHistoryShortcut } from '../builtins-BKYlHH1s.js';
+import { a as AgentToolProvider } from '../registry-D-4fit9C.js';
+export { A as ArrangeCommandOptions, a as ArrangeCommandTarget, C as ComponentCommandOptions, b as ComponentCommandTarget, D as DEFAULT_HISTORY_SHORTCUTS, H as HistoryCommandOptions, c as HistoryCommandTarget, S as ShapeCommandOptions, d as ShapeCommandTarget, e as SpreadsheetCommandOptions, f as SpreadsheetCommandTarget, g as createArrangeCommands, h as createComponentCommands, i as createHistoryCommands, j as createShapeCommands, k as createSpreadsheetCommands, l as hasVariantCommands, m as matchHistoryShortcut } from '../builtins-CV1fDj64.js';
 import '../schema-Di0CS6Pe.js';
 import '../types-DsiXGmjo.js';
 import '../arrange-BPAXGdMm.js';

package/dist/commands/index.js

@@ -7,7 +7,7 @@ import {
   createSpreadsheetCommands,
   hasVariantCommands,
   matchHistoryShortcut
-} from "../chunk-IB3ZHQAX.js";
+} from "../chunk-PTYWCFFW.js";
 import {
   PLATFORMS,
   ShortcutMap,