@pixerate/editor 0.137.0 → 0.138.0

package/dist/chunk-J7DSKTKB.js.map

@@ -0,0 +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 { CanvasBrush, CanvasBrushPaint, CanvasBrushPreset } from '../canvas/brushTypes.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 freehand drawing\n// ---------------------------------------------------------------------------\n\n/** Draw surface of the freehand draw controller (`createCanvasDrawController` satisfies it). */\nexport interface DrawCommandTarget {\n\tdrawStroke(input: {\n\t\tpoints: readonly (readonly [number, number])[];\n\t\ttool?: 'pen' | 'highlighter';\n\t\tstyle?: { color?: string; width?: number; opacity?: number; brush?: CanvasBrush; brushSize?: number; paint?: CanvasBrushPaint };\n\t\tpressure?: readonly number[];\n\t\ttiltX?: readonly number[];\n\t\ttiltY?: readonly number[];\n\t\tstreamline?: boolean;\n\t}): Promise<{ id: string; bounds: { x: number; y: number; width: number; height: number }; brush?: unknown }>;\n\t/** The dry paint presets a stroke can be brushed with (loads the paint engine). */\n\tlistBrushes(): Promise<CanvasBrushPreset[]>;\n}\n\nexport interface DrawCommandOptions {\n\t/** Id prefix (default `canvas.`). */\n\tprefix?: string;\n\tgroup?: string;\n\t/** Scope of the commands (default `canvas`). Pass `null` for global. */\n\tscope?: string | null;\n\t/** Refuse drawing with this reason (e.g. a read-only canvas); `canvas.listBrushes` still runs. */\n\treadOnlyReason?: () => string | null | undefined;\n}\n\nconst PROFILE_PARAM = (what: string, lo: number, hi: number) =>\n\t({\n\t\ttype: 'array',\n\t\tminItems: 1,\n\t\tmaxItems: 256,\n\t\titems: { type: 'number', minimum: lo, maximum: hi },\n\t\tdescription: `${what} spread evenly along the stroke's length: the first value at the start, the last at the end, linearly in between; one value is constant. Only with a brush.`\n\t}) as const;\n\nconst BRUSH_SETTINGS_PARAM = {\n\ttype: 'object',\n\tadditionalProperties: false,\n\tdescription: 'Tip settings instead of a preset.',\n\tproperties: {\n\t\tsize: { type: 'number', minimum: 1, maximum: 2500, description: 'Brush diameter in canvas units (default: `width` when given, else 3).' },\n\t\thardness: { type: 'number', minimum: 0, maximum: 1, description: 'Edge hardness, 0 soft to 1 hard (default 1).' },\n\t\tspacing: { type: 'number', minimum: 0.01, maximum: 10, description: 'Dab spacing as a fraction of the diameter (default 0.1).' },\n\t\tangle: { type: 'number', minimum: -360, maximum: 360, description: 'Tip angle in degrees (default 0).' },\n\t\troundness: { type: 'number', minimum: 0.01, maximum: 1, description: 'Tip roundness, 1 round to 0.01 flat (default 1).' },\n\t\topacity: { type: 'number', minimum: 0, maximum: 1, description: 'Opacity ceiling of the stroke 0..1 (default 1).' },\n\t\tflow: { type: 'number', minimum: 0, maximum: 1, description: 'Build-up per dab 0..1 (default 1).' },\n\t\tpressureSize: { type: 'boolean', description: 'Pressure scales the size (default true).' },\n\t\tpressureOpacity: { type: 'boolean', description: 'Pressure scales the opacity (default false).' }\n\t}\n} as const;\n\nconst HEX_PARAM = '^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$';\n\n/**\n * Gradient paint for a brushed stroke: the paint engine's `PaintSource` described structurally,\n * so commands never import the paint module (see GOTCHAS: the DTS build runs out of memory).\n * The canvas renderer validates it again (sorted stops, defaults) before anything is drawn.\n */\nconst BRUSH_PAINT_PARAM = {\n\tdescription:\n\t\t'Paint the brushed stroke with gradient paint (or one colour) instead of `color`, sampled dab by dab along the path; `color` still gives the alpha and fills \"paint\" stops. Only with `brush`. Example (blue to yellow over 200 canvas units, and back): { \"type\": \"gradient\", \"stops\": [{ \"offset\": 0, \"color\": \"#1d4ed8\" }, { \"offset\": 1, \"color\": \"#facc15\" }], \"map\": { \"by\": \"distance\", \"length\": 200, \"repeat\": \"mirror\" } }.',\n\toneOf: [\n\t\t{\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\trequired: ['type', 'color'],\n\t\t\tdescription: 'One colour.',\n\t\t\tproperties: {\n\t\t\t\ttype: { type: 'string', enum: ['color'], description: 'Always \"color\".' },\n\t\t\t\tcolor: { type: 'string', pattern: HEX_PARAM, description: 'The colour as #rrggbb (or #rgb).' }\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\ttype: 'object',\n\t\t\tadditionalProperties: false,\n\t\t\trequired: ['type', 'stops'],\n\t\t\tdescription: 'Gradient paint: the brush samples it dab by dab as the stroke goes.',\n\t\t\tproperties: {\n\t\t\t\ttype: { type: 'string', enum: ['gradient'], description: 'Always \"gradient\".' },\n\t\t\t\tstops: {\n\t\t\t\t\ttype: 'array',\n\t\t\t\t\tminItems: 2,\n\t\t\t\t\tmaxItems: 16,\n\t\t\t\t\tdescription: '2..16 stops sorted by offset.',\n\t\t\t\t\titems: {\n\t\t\t\t\t\ttype: 'object',\n\t\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t\t\trequired: ['offset', 'color'],\n\t\t\t\t\t\tproperties: {\n\t\t\t\t\t\t\toffset: { type: 'number', minimum: 0, maximum: 1, description: 'Position 0..1 along the gradient.' },\n\t\t\t\t\t\t\tcolor: {\n\t\t\t\t\t\t\t\ttype: 'string',\n\t\t\t\t\t\t\t\tdescription: 'The stop colour as #rrggbb, or \"paint\" (the stroke colour) or \"secondary\" (white).',\n\t\t\t\t\t\t\t\tanyOf: [{ pattern: HEX_PARAM }, { enum: ['paint', 'secondary'] }]\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\topacity: { type: 'number', minimum: 0, maximum: 1, description: 'Multiplies the brush flow where this colour is laid, 0..1 (default 1).' },\n\t\t\t\t\t\t\tmidpoint: { type: 'number', minimum: 0.05, maximum: 0.95, description: 'Where between this stop and the next the colours are half mixed, 0.05..0.95 (default 0.5).' }\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tspace: { type: 'string', enum: ['pigment', 'oklab', 'srgb'], description: 'How neighbouring stops mix: pigment (default; like paint, blue to yellow passes green), oklab (perceptual) or srgb (plain numbers).' },\n\t\t\t\tmap: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t\trequired: ['by'],\n\t\t\t\t\tdescription: 'What moves the stroke along the gradient (default distance, 300 canvas units, mirror).',\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\tby: {\n\t\t\t\t\t\t\ttype: 'string',\n\t\t\t\t\t\t\tenum: ['distance', 'pressure', 'tilt', 'direction', 'across-tip', 'random'],\n\t\t\t\t\t\t\tdescription:\n\t\t\t\t\t\t\t\t'distance: canvas units (or dabs) travelled along the path; pressure: the pressure profile 0..1; tilt: pen lean from the tilt profiles, upright 0 .. flat 1; direction: direction of travel, once round per 360°; across-tip: left to right across the tip (a brush loaded with several colours); random: a seeded random point per dab. Canvas strokes carry no timing, so velocity and time are not available.'\n\t\t\t\t\t\t},\n\t\t\t\t\t\tlength: { type: 'number', minimum: 1, maximum: 100000, description: 'distance: canvas units (or dabs, with unit \"dabs\") per run through the gradient (default 300).' },\n\t\t\t\t\t\trepeat: { type: 'string', enum: ['clamp', 'repeat', 'mirror'], description: 'distance: past the end, clamp (hold the last colour), repeat (start again) or mirror (run back; default).' },\n\t\t\t\t\t\tunit: { type: 'string', enum: ['px', 'dabs'], description: 'distance: canvas units (\"px\", default) or dabs.' },\n\t\t\t\t\t\tevery: { type: 'integer', minimum: 1, maximum: 500, description: 'random: dabs per random pick (default 1).' }\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\tsoftness: { type: 'number', minimum: 0, maximum: 1, description: 'How softly neighbouring stops blend: 1 smooth (default) .. 0 hard steps.' }\n\t\t\t}\n\t\t}\n\t]\n} as const;\n\n/**\n * Agent / palette commands for freehand drawing: `canvas.drawFreehand` (a pen or highlighter\n * stroke through given points, optionally brushed with a dry paint preset and a pressure / tilt\n * profile; one undo step) and the read-only `canvas.listBrushes` (the dry presets it accepts).\n */\nexport function createDrawCommands(target: DrawCommandTarget, options: DrawCommandOptions = {}): CommandSpec[] {\n\tconst prefix = options.prefix ?? 'canvas.';\n\tconst group = options.group ?? 'Draw';\n\tconst scope = options.scope === null ? undefined : options.scope ?? 'canvas';\n\tconst base = { group, ...(scope ? { scope } : {}) };\n\treturn [\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}drawFreehand`,\n\t\t\tlabel: 'Draw Freehand Stroke',\n\t\t\tkeywords: ['pen', 'highlighter', 'brush', 'sketch', 'draw', 'stroke', 'pencil', 'ink'],\n\t\t\tdescription:\n\t\t\t\t'Draws a freehand pen or highlighter stroke through points (canvas coordinates) as one path shape node, in one undo step. With `brush` it is painted with a dry paint brush (a preset id from canvas.listBrushes, or tip settings) and `pressure` / `tiltX` / `tiltY` profiles shape it along its length; `paint` gives it gradient paint that changes colour along the stroke. Wet brushes are refused. Returns the new node `id`, its `bounds` and the stored `brush`.',\n\t\t\tparams: {\n\t\t\t\ttype: 'object',\n\t\t\t\tadditionalProperties: false,\n\t\t\t\trequired: ['points'],\n\t\t\t\tproperties: {\n\t\t\t\t\tpoints: {\n\t\t\t\t\t\ttype: 'array',\n\t\t\t\t\t\tminItems: 1,\n\t\t\t\t\t\tmaxItems: 5000,\n\t\t\t\t\t\titems: { type: 'array', minItems: 2, maxItems: 2, items: { type: 'number' } },\n\t\t\t\t\t\tdescription: 'Stroke points as [x, y] pairs in canvas (flow) units, in drawing order. Use a point every few units along curves.'\n\t\t\t\t\t},\n\t\t\t\t\ttool: { type: 'string', enum: ['pen', 'highlighter'], description: 'Pen (default: blue, width 3) or highlighter (yellow, width 24, opacity 0.35); sets the defaults below.' },\n\t\t\t\t\tcolor: { type: 'string', description: 'Stroke colour, any CSS colour (default from the tool).' },\n\t\t\t\t\twidth: { type: 'number', exclusiveMinimum: 0, maximum: 2500, description: 'Stroke width in canvas units (default from the tool). For brushed strokes it is the brush diameter; leave it out to use the preset\\'s own size (canvas.listBrushes gives it).' },\n\t\t\t\t\topacity: { type: 'number', minimum: 0, maximum: 1, description: 'Stroke opacity 0..1 (default from the tool).' },\n\t\t\t\t\tbrush: {\n\t\t\t\t\t\tdescription: 'Paint the stroke with a dry paint brush: a preset id such as \"ink-pen\", \"pencil-hb\", \"brush-pen\", \"charcoal-stick\", \"soft-pastel\", \"marker\" or \"airbrush\" (all ids: canvas.listBrushes), or tip settings. Omit for a plain vector stroke.',\n\t\t\t\t\t\toneOf: [{ type: 'string', minLength: 1 }, BRUSH_SETTINGS_PARAM]\n\t\t\t\t\t},\n\t\t\t\t\tpaint: BRUSH_PAINT_PARAM,\n\t\t\t\t\tpressure: PROFILE_PARAM('Pen pressure 0..1', 0, 1),\n\t\t\t\t\ttiltX: PROFILE_PARAM('Pen tilt along x in degrees (−90..90)', -90, 90),\n\t\t\t\t\ttiltY: PROFILE_PARAM('Pen tilt along y in degrees (−90..90)', -90, 90),\n\t\t\t\t\tstreamline: { type: 'boolean', description: 'Smooth jittery points before fitting the path (default false).' }\n\t\t\t\t}\n\t\t\t},\n\t\t\tenabled: () => options.readOnlyReason?.() || true,\n\t\t\trun: (\n\t\t\t\t_ctx: unknown,\n\t\t\t\tparams: {\n\t\t\t\t\tpoints: [number, number][];\n\t\t\t\t\ttool?: 'pen' | 'highlighter';\n\t\t\t\t\tcolor?: string;\n\t\t\t\t\twidth?: number;\n\t\t\t\t\topacity?: number;\n\t\t\t\t\tbrush?: CanvasBrush;\n\t\t\t\t\tpaint?: CanvasBrushPaint;\n\t\t\t\t\tpressure?: number[];\n\t\t\t\t\ttiltX?: number[];\n\t\t\t\t\ttiltY?: number[];\n\t\t\t\t\tstreamline?: boolean;\n\t\t\t\t}\n\t\t\t) =>\n\t\t\t\ttarget.drawStroke({\n\t\t\t\t\tpoints: params.points,\n\t\t\t\t\t...(params.tool ? { tool: params.tool } : {}),\n\t\t\t\t\tstyle: {\n\t\t\t\t\t\t...(params.color !== undefined ? { color: params.color } : {}),\n\t\t\t\t\t\t...(params.width !== undefined ? { width: params.width } : {}),\n\t\t\t\t\t\t...(params.width !== undefined && params.brush !== undefined ? { brushSize: params.width } : {}),\n\t\t\t\t\t\t...(params.opacity !== undefined ? { opacity: params.opacity } : {}),\n\t\t\t\t\t\t...(params.brush !== undefined ? { brush: params.brush } : {}),\n\t\t\t\t\t\t...(params.paint !== undefined ? { paint: params.paint } : {})\n\t\t\t\t\t},\n\t\t\t\t\t...(params.pressure ? { pressure: params.pressure } : {}),\n\t\t\t\t\t...(params.tiltX ? { tiltX: params.tiltX } : {}),\n\t\t\t\t\t...(params.tiltY ? { tiltY: params.tiltY } : {}),\n\t\t\t\t\t...(params.streamline ? { streamline: true } : {})\n\t\t\t\t})\n\t\t},\n\t\t{\n\t\t\t...base,\n\t\t\tid: `${prefix}listBrushes`,\n\t\t\tlabel: 'List Freehand Brushes',\n\t\t\tkeywords: ['brushes', 'presets', 'paint', 'pencil', 'ink'],\n\t\t\tdescription: 'Read-only: the dry paint presets canvas.drawFreehand accepts as `brush`, as { id, name, category, size } (size is the preset\\'s own diameter, which a brushed stroke uses unless `width` is given).',\n\t\t\tparams: { type: 'object', additionalProperties: false, properties: {} },\n\t\t\treadOnly: true,\n\t\t\trun: async () => ({ brushes: await target.listBrushes() })\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"],"mappings":"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","names":[]}

package/dist/{chunk-6S6362D2.js → chunk-OV7253FC.js}

@@ -18,7 +18,7 @@ import {
   unionBounds,
   vectorGradientPoints,
   widthProfileAt
-} from "./chunk-3D77LOBM.js";
+} from "./chunk-V45ZTW4R.js";
 import {
   segmentLength,
   segmentParamAtLength,
@@ -750,4 +750,4 @@ export {
   interpolateVectorPaths,
   evaluateVectorPathKeyframes
 };
-//# sourceMappingURL=chunk-6S6362D2.js.map
+//# sourceMappingURL=chunk-OV7253FC.js.map

package/dist/{chunk-5FSRTP6E.js → chunk-PQFVLOMR.js}

@@ -40,6 +40,73 @@ function hash2(x, y, salt) {
 function rand01(seed, index, stream) {
   return hash2(index, stream, seed);
 }
+function randSigned(seed, index, stream) {
+  return rand01(seed, index, stream) * 2 - 1;
+}
+function seedFromString(text) {
+  let h = 2166136261;
+  for (let i = 0; i < text.length; i++) {
+    h ^= text.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return mix32(h >>> 0);
+}
+var smooth = (t) => t * t * (3 - 2 * t);
+var Lattice = class {
+  constructor(px, py, salt) {
+    this.px = px;
+    this.py = py;
+    this.values = new Float32Array(px * py);
+    for (let j = 0; j < py; j++) for (let i = 0; i < px; i++) this.values[j * px + i] = hash2(i, j, salt);
+  }
+  px;
+  py;
+  values;
+  /** Value noise at (x, y) in lattice cells; wraps every `px` / `py` cells. */
+  at(x, y) {
+    const { px, py } = this;
+    const x0 = Math.floor(x);
+    const y0 = Math.floor(y);
+    const tx = smooth(x - x0);
+    const ty = smooth(y - y0);
+    const i0 = (x0 % px + px) % px;
+    const j0 = (y0 % py + py) % py;
+    const i1 = (i0 + 1) % px;
+    const j1 = (j0 + 1) % py;
+    const v = this.values;
+    const a = v[j0 * px + i0] + (v[j0 * px + i1] - v[j0 * px + i0]) * tx;
+    const b = v[j1 * px + i0] + (v[j1 * px + i1] - v[j1 * px + i0]) * tx;
+    return a + (b - a) * ty;
+  }
+};
+var TileableNoise = class {
+  constructor(size, cellsX, cellsY, octaves, salt) {
+    this.size = size;
+    let cx = Math.max(1, Math.round(cellsX));
+    let cy = Math.max(1, Math.round(cellsY));
+    for (let o = 0; o < octaves; o++) {
+      this.octaves.push(new Lattice(cx, cy, salt + o * 7919 | 0));
+      cx *= 2;
+      cy *= 2;
+    }
+  }
+  size;
+  octaves = [];
+  /** Fractal noise at pixel (x, y). */
+  at(x, y) {
+    let sum = 0;
+    let amp = 1;
+    let norm = 0;
+    const u = x / this.size;
+    const v = y / this.size;
+    for (const l of this.octaves) {
+      sum += l.at(u * l.px, v * l.py) * amp;
+      norm += amp;
+      amp *= 0.5;
+    }
+    return norm > 0 ? sum / norm : 0.5;
+  }
+};
 
 // src/paint/gradient-paint.ts
 var PAINT_GRADIENT_SPACES = ["pigment", "oklab", "srgb"];
@@ -1100,7 +1167,181 @@ function coverageTileCoord(key) {
   return tileCoord(key);
 }
 
+// src/paint/grain.ts
+var GRAIN_PATTERNS = ["smooth", "cold-pressed", "hot-pressed", "rough", "vellum", "laid", "ingres", "sanded", "canvas", "linen", "gesso"];
+var GRAIN_TILE = 256;
+var clamp01 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
+function patternHeights(pattern, n, seed) {
+  const out = new Float32Array(n * n);
+  const salt = Math.imul(seed | 0, 2654435761) + 17;
+  if (pattern === "smooth") return out.fill(1);
+  const noise = (cx, cy, oct, s = 0) => new TileableNoise(n, cx, cy, oct, salt + s);
+  const k = n / GRAIN_TILE;
+  switch (pattern) {
+    case "cold-pressed": {
+      const base = noise(20 * k, 20 * k, 4);
+      const fine = noise(64 * k, 64 * k, 2, 3);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) out[y * n + x] = clamp01((base.at(x, y) - 0.5) * 1.8 + 0.5 + (fine.at(x, y) - 0.5) * 0.5 + (hash2(x, y, salt) - 0.5) * 0.12);
+      break;
+    }
+    case "hot-pressed": {
+      const base = noise(40 * k, 40 * k, 3);
+      for (let y = 0; y < n; y++) for (let x = 0; x < n; x++) out[y * n + x] = clamp01((base.at(x, y) - 0.5) * 1.1 + 0.6 + (hash2(x, y, salt) - 0.5) * 0.08);
+      break;
+    }
+    case "rough": {
+      const base = noise(10 * k, 10 * k, 5);
+      const blot = noise(28 * k, 28 * k, 2, 5);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) out[y * n + x] = clamp01((base.at(x, y) - 0.5) * 2.4 + 0.5 + (blot.at(x, y) - 0.5) * 0.7 + (hash2(x, y, salt) - 0.5) * 0.15);
+      break;
+    }
+    case "vellum": {
+      const base = noise(40 * k, 40 * k, 3);
+      for (let y = 0; y < n; y++) for (let x = 0; x < n; x++) out[y * n + x] = clamp01((base.at(x, y) - 0.5) * 1.6 + 0.55 + (hash2(x, y, salt) - 0.5) * 0.2);
+      break;
+    }
+    case "laid": {
+      const pulp = noise(32 * k, 32 * k, 3);
+      const chain = n / 8;
+      for (let y = 0; y < n; y++) {
+        const laid = 0.5 + 0.5 * Math.cos(2 * Math.PI * y / 4);
+        for (let x = 0; x < n; x++) {
+          const c = Math.abs((x + 0.5) % chain - chain / 2) / (chain / 2);
+          const chainLine = c > 0.94 ? -0.35 : 0;
+          out[y * n + x] = clamp01(0.3 + 0.5 * laid + chainLine + (pulp.at(x, y) - 0.5) * 0.6);
+        }
+      }
+      break;
+    }
+    case "ingres": {
+      const fibres = noise(64 * k, 12 * k, 3);
+      const base = noise(16 * k, 16 * k, 3, 7);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) {
+          const g = hash2(x, y, salt ^ 85);
+          out[y * n + x] = clamp01((fibres.at(x, y) - 0.5) * 1.5 + (base.at(x, y) - 0.5) * 0.7 + 0.55 + (g < 0.1 ? -0.3 : 0));
+        }
+      break;
+    }
+    case "sanded": {
+      const grit = noise(96 * k, 96 * k, 2);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) {
+          const h = hash2(x, y, salt);
+          out[y * n + x] = clamp01((grit.at(x, y) - 0.5) * 2.4 + 0.5 + (h - 0.5) * 0.7);
+        }
+      break;
+    }
+    case "canvas":
+    case "linen": {
+      const period = (pattern === "canvas" ? 8 : 5) * k;
+      const threads = Math.max(2, 2 * Math.round(n / period / 2));
+      const p = n / threads;
+      const slub = noise(threads, threads, 2, 11);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) {
+          const fx = (x + 0.5) / p;
+          const fy = (y + 0.5) / p;
+          const cx = Math.floor(fx);
+          const cy = Math.floor(fy);
+          const warp = Math.sin(Math.PI * (fx - cx));
+          const weft = Math.sin(Math.PI * (fy - cy));
+          const top = (cx + cy) % 2 === 0 ? warp : weft;
+          const irregular = pattern === "linen" ? (slub.at(x, y) - 0.5) * 0.5 : 0;
+          out[y * n + x] = clamp01(0.2 + 0.7 * top + irregular + (hash2(x, y, salt) - 0.5) * 0.15);
+        }
+      break;
+    }
+    case "gesso": {
+      const streaks = noise(2 * k, 28 * k, 3);
+      const tooth = noise(64 * k, 64 * k, 2, 13);
+      for (let y = 0; y < n; y++)
+        for (let x = 0; x < n; x++) out[y * n + x] = clamp01((streaks.at(x, y) - 0.5) * 1.8 + (tooth.at(x, y) - 0.5) * 0.9 + 0.55);
+      break;
+    }
+  }
+  return out;
+}
+var rawCache = /* @__PURE__ */ new Map();
+function grainHeights(pattern, seed, size = GRAIN_TILE) {
+  const key = `${pattern}:${seed}:${size}`;
+  let h = rawCache.get(key);
+  if (!h) {
+    h = patternHeights(pattern, size, seed);
+    if (rawCache.size > 32) rawCache.delete(rawCache.keys().next().value);
+    rawCache.set(key, h);
+  }
+  return h;
+}
+var PaperGrain = class {
+  size = GRAIN_TILE;
+  heights;
+  scale;
+  mirror;
+  flat;
+  constructor(paper, media = "dry") {
+    const raw = grainHeights(paper.pattern, paper.seed);
+    const t = paper[media];
+    this.flat = paper.pattern === "smooth";
+    if (t.contrast === 1 && !t.invert) this.heights = raw;
+    else {
+      const out = new Float32Array(raw.length);
+      for (let i = 0; i < raw.length; i++) {
+        const v = clamp01((raw[i] - 0.5) * t.contrast + 0.5);
+        out[i] = t.invert ? 1 - v : v;
+      }
+      this.heights = out;
+    }
+    this.scale = paper.scale;
+    this.mirror = paper.tiling === "mirror";
+  }
+  /** Tile cell index for a coordinate in grain pixels (mirrored on odd tiles when mirroring). */
+  wrap(v) {
+    const n = this.size;
+    if (!this.mirror) return (v % n + n) % n;
+    const p = (v % (2 * n) + 2 * n) % (2 * n);
+    return p < n ? p : 2 * n - 1 - p;
+  }
+  /** Height 0..1 at document position (x, y). */
+  at(x, y) {
+    const u = x / this.scale - 0.5;
+    const v = y / this.scale - 0.5;
+    const x0 = Math.floor(u);
+    const y0 = Math.floor(v);
+    const fx = u - x0;
+    const fy = v - y0;
+    const n = this.size;
+    const h = this.heights;
+    const a = this.wrap(x0);
+    const b = this.wrap(x0 + 1);
+    const c = this.wrap(y0) * n;
+    const d = this.wrap(y0 + 1) * n;
+    const top = h[c + a] + (h[c + b] - h[c + a]) * fx;
+    const bot = h[d + a] + (h[d + b] - h[d + a]) * fx;
+    return top + (bot - top) * fy;
+  }
+};
+function grainCatch(h, depth, pressure) {
+  if (depth <= 0) return 1;
+  const t = depth * (0.75 - 0.65 * Math.min(1, Math.max(0, pressure)));
+  const u = clamp01((h - t + 0.18) / 0.36);
+  return 1 - depth + depth * u * u * (3 - 2 * u);
+}
+function strokeGrainCatch(h, depth, pressure) {
+  if (depth <= 0) return 1;
+  const p = Math.min(1, Math.max(0, pressure));
+  const amount = Math.min(1, depth * (1.4 - 0.6 * p));
+  const u = clamp01((h - 0.2 - 0.25 * (1 - p)) / 0.5);
+  return 1 - amount + amount * u * u * (3 - 2 * u);
+}
+
 // src/paint/path-stroke.ts
+var JITTER_SIZE = 1;
+var JITTER_ANGLE = 2;
+var JITTER_OPACITY = 3;
+var JITTER_SCATTER = 4;
 function lean(s) {
   if (typeof s.altitude === "number" && Number.isFinite(s.altitude)) {
     return { amount: 1 - Math.min(1, Math.max(0, s.altitude / (Math.PI / 2))), azimuth: s.azimuth ?? 0 };
@@ -1132,8 +1373,22 @@ function pathStrokeDabs(samples, options) {
     if (tilt.followAzimuth && l) angle = -l.azimuth;
     const roundness = Math.max(0.05, brush.roundness * (1 - 0.85 * (tilt.roundness ?? 0) * lean0));
     const op = brush.pressureOpacity ? pr : 1;
-    const params = { travel, index: index++, pressure: pr, lean: lean0, speed, direction: dir, time: time === null || t0 === null ? null : time - t0 };
-    return { x, y, radius: Math.max(0.5, size / 2), alpha: brush.flow, opacity: brush.opacity * op, angle, roundness, params };
+    const i = index++;
+    const params = { travel, index: i, pressure: pr, lean: lean0, speed, direction: dir, time: time === null || t0 === null ? null : time - t0 };
+    let diameter = size;
+    let opacity = brush.opacity * op;
+    const j = options.jitter;
+    if (j) {
+      if (j.size) diameter *= Math.max(0.05, 1 + j.size * randSigned(j.seed, i, JITTER_SIZE));
+      if (j.angle) angle += j.angle * Math.PI * randSigned(j.seed, i, JITTER_ANGLE);
+      if (j.opacity) opacity *= 1 - j.opacity * (randSigned(j.seed, i, JITTER_OPACITY) * 0.5 + 0.5);
+      if (j.scatter) {
+        const off = j.scatter * diameter * randSigned(j.seed, i, JITTER_SCATTER);
+        x += Math.sin(dir) * off;
+        y += Math.cos(dir) * off;
+      }
+    }
+    return { x, y, radius: Math.max(0.5, diameter / 2), alpha: brush.flow, opacity, angle, roundness, params };
   };
   const out = [];
   const pressure = (s) => typeof s.pressure === "number" && Number.isFinite(s.pressure) ? s.pressure : 1;
@@ -1202,6 +1457,17 @@ function pathStrokeCoverage(samples, options) {
       bounds = { x, y, width: Math.max(bounds.x + bounds.width, rect.x + rect.width) - x, height: Math.max(bounds.y + bounds.height, rect.y + rect.height) - y };
     }
   }
+  const grain = options.grain;
+  if (grain && grain.depth > 0 && dabs.length) {
+    const pressure = dabs.reduce((sum, d) => sum + (d.params?.pressure ?? 1), 0) / dabs.length;
+    for (const [key, t] of coverage.tiles) {
+      const { tx, ty } = tileCoord(key);
+      for (let y = 0, k = 0; y < TILE; y++) {
+        const gy = ty * TILE + y + 0.5;
+        for (let x = 0; x < TILE; x++, k++) if (t[k] > 0) t[k] *= strokeGrainCatch(grain.at(tx * TILE + x + 0.5, gy), grain.depth, pressure);
+      }
+    }
+  }
   return { coverage, bounds, dabs: dabs.length };
 }
 function paintPathStroke(surface, samples, options) {
@@ -1296,6 +1562,26 @@ function isBrushstrokeBrush(brush) {
   return !("tip" in brush) || !brush.tip || (brush.engine ?? "dab") === "dab";
 }
 var finite2 = (v) => typeof v === "number" && Number.isFinite(v);
+function brushCharacterOf(brush) {
+  if (!("tip" in brush) || !brush.tip) return { grain: 0, size: 0, angle: 0, opacity: 0, scatter: 0 };
+  const d = brush.dynamics ?? {};
+  const u = (v, hi = 1) => finite2(v) ? Math.min(hi, Math.max(0, v)) : 0;
+  return { grain: u(brush.grain), size: u(d.sizeJitter), angle: u(d.angleJitter), opacity: u(d.opacityJitter), scatter: u(d.scatter, 4) };
+}
+var papers = /* @__PURE__ */ new Map();
+function paperGrain(paper) {
+  const pattern = paper.pattern ?? "sanded";
+  const seed = finite2(paper.seed) ? Math.round(Math.abs(paper.seed)) : 1;
+  const scale = finite2(paper.scale) && paper.scale > 0 ? Math.min(8, Math.max(0.25, paper.scale)) : 1;
+  const key = `${pattern}:${seed}:${scale}`;
+  let g = papers.get(key);
+  if (!g) {
+    g = new PaperGrain({ pattern, seed, scale, tiling: "mirror", dry: { contrast: 1, invert: false }, wet: { contrast: 1, invert: false } });
+    if (papers.size > 16) papers.delete(papers.keys().next().value);
+    papers.set(key, g);
+  }
+  return g;
+}
 function renderBrushstroke(input, brush, options = {}) {
   const strokeOptions = brushstrokeStrokeOptions(brush);
   const samples = brushstrokeSamples(input);
@@ -1318,8 +1604,27 @@ function renderBrushstroke(input, brush, options = {}) {
   const area = (x1 - x0 + reach) * (y1 - y0 + reach);
   if (area * scale * scale > maxPixels) scale = Math.max(BRUSHSTROKE_MIN_SCALE, Math.sqrt(maxPixels / area));
   const scaled = samples.map((s) => ({ ...s, x: s.x * scale, y: s.y * scale }));
+  let character = {};
+  if (options.character) {
+    const c = brushCharacterOf(brush);
+    const ch = options.character;
+    const seed = finite2(ch.seed) ? ch.seed | 0 : hashString(JSON.stringify(input));
+    const jitter = c.size || c.angle || c.opacity || c.scatter ? { seed, size: c.size, angle: c.angle, opacity: c.opacity, scatter: c.scatter } : void 0;
+    const paper = ch.paper === null ? null : ch.paper ?? {};
+    const depth = paper ? Math.min(1, Math.max(0, (finite2(paper.depth) ? paper.depth : 0.5) * c.grain)) : 0;
+    let grain;
+    if (paper && depth > 0) {
+      const g = paperGrain(paper);
+      const ox = ch.origin?.x ?? 0;
+      const oy = ch.origin?.y ?? 0;
+      const k = (finite2(ch.unit) && ch.unit > 0 ? ch.unit : 1) / scale;
+      grain = { depth, at: (x, y) => g.at(ox + x * k, oy + y * k) };
+    }
+    character = { ...jitter ? { jitter } : {}, ...grain ? { grain } : {} };
+  }
   const { surface, bounds, dabs } = paintPathStroke(emptySurface(4), scaled, {
     ...strokeOptions,
+    ...character,
     brush: { ...tip, size: tip.size * scale },
     closed: options.closed ?? strokeOptions.closed,
     color,
@@ -1361,7 +1666,8 @@ function hashString(s, h = 2166136261) {
 function brushstrokeKey(input, brush, options = {}) {
   const path = JSON.stringify(input);
   const { brush: tip, ...rest } = brushstrokeStrokeOptions(brush);
-  const rest2 = JSON.stringify([tip, rest, options.paint ?? options.color ?? null, options.seed ?? 0, options.closed ?? false, options.maxPixels ?? null]);
+  const character = options.character ? [options.character, brushCharacterOf(brush)] : null;
+  const rest2 = JSON.stringify([tip, rest, options.paint ?? options.color ?? null, options.seed ?? 0, options.closed ?? false, options.maxPixels ?? null, ...character ? [character] : []]);
   const scale = finite2(options.scale) ? options.scale : 1;
   return `${hashString(path).toString(16)}:${path.length}:${hashString(rest2).toString(16)}:${scale}`;
 }
@@ -2012,6 +2318,9 @@ export {
   mix32,
   hash2,
   rand01,
+  randSigned,
+  seedFromString,
+  TileableNoise,
   PAINT_GRADIENT_SPACES,
   PAINT_GRADIENT_REPEATS,
   PAINT_GRADIENT_MAPPINGS,
@@ -2062,6 +2371,12 @@ export {
   applyStrokeToTile,
   applyStrokeToDeepTile,
   coverageTileCoord,
+  GRAIN_PATTERNS,
+  GRAIN_TILE,
+  grainHeights,
+  PaperGrain,
+  grainCatch,
+  strokeGrainCatch,
   pathStrokeDabs,
   pathStrokeCoverage,
   paintPathStroke,
@@ -2096,4 +2411,4 @@ export {
   cleanMixer,
   MixerStroke
 };
-//# sourceMappingURL=chunk-5FSRTP6E.js.map
+//# sourceMappingURL=chunk-PQFVLOMR.js.map