@pixerate/editor 0.227.0 → 0.228.0

package/dist/agent/index.cjs

@@ -5,7 +5,7 @@
 var _chunkSOSBOS5Tcjs = require('../chunk-SOSBOS5T.cjs');
 
 
-var _chunk53GOGBTMcjs = require('../chunk-53GOGBTM.cjs');
+var _chunkCHAWTXBEcjs = require('../chunk-CHAWTXBE.cjs');
 
 
 
@@ -14,7 +14,7 @@ var _chunk53GOGBTMcjs = require('../chunk-53GOGBTM.cjs');
 
 
 var _chunkEL4PSKFTcjs = require('../chunk-EL4PSKFT.cjs');
-require('../chunk-4EFNS2HV.cjs');
+require('../chunk-T7QSEKDY.cjs');
 
 
 
@@ -2112,7 +2112,7 @@ function createCanvasComponentToolProvider(controller, options = { id: "canvas-c
       ({ id }) => check(controller.restoreMainComponent(id))
     )
   ];
-  if (_chunk53GOGBTMcjs.hasVariantCommands.call(void 0, controller)) {
+  if (_chunkCHAWTXBEcjs.hasVariantCommands.call(void 0, controller)) {
     const SET = { type: "string", description: "Component set, or one of its variants (default: the selection\u2019s set)." };
     const VARIANT = { type: "string", description: "Variant id (default: the first selected variant)." };
     const VALUES = { type: "object", additionalProperties: { type: "string" }, description: 'Variant property \u2192 value, e.g. { "Size": "Medium" }.' };

package/dist/agent/index.js

@@ -5,7 +5,7 @@ import {
 } from "../chunk-GOBOCZZI.js";
 import {
   hasVariantCommands
-} from "../chunk-ZPJEH456.js";
+} from "../chunk-XVIK73LS.js";
 import {
   createNodeLookup,
   ensureLayout,
@@ -14,7 +14,7 @@ import {
   placeBeside,
   placeInView
 } from "../chunk-U4VE4UI2.js";
-import "../chunk-7KZ2HKKC.js";
+import "../chunk-LPFQHVCO.js";
 import {
   callEvalTool,
   createStyleResolver,

package/dist/animation-editor/index.cjs

@@ -48,7 +48,7 @@ require('../chunk-NM3G4VQT.cjs');
 
 
 
-var _chunkABQ2VGUBcjs = require('../chunk-ABQ2VGUB.cjs');
+var _chunk5MQOBTNPcjs = require('../chunk-5MQOBTNP.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 require('../chunk-PQ3H2AAN.cjs');
 require('../chunk-YQGCPL5X.cjs');
@@ -3828,7 +3828,7 @@ var AnimationEditorController = (_class = class {
   
   
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init() {this.effects = new (0, _chunkABQ2VGUBcjs.EffectsSlot)()}
+  __init() {this.effects = new (0, _chunk5MQOBTNPcjs.EffectsSlot)()}
   
   
   __init2() {this.selection = null}
@@ -4013,7 +4013,7 @@ var AnimationEditorController = (_class = class {
     try {
       plan = await work();
     } catch (error) {
-      if (_chunkABQ2VGUBcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
+      if (_chunk5MQOBTNPcjs.isEffectError.call(void 0, error) || error instanceof Error) return this.refuse(error.message);
       throw error;
     }
     const r = this.apply({ op: "replace_scene", scene: plan.scene }, plan.label, { merge });
@@ -4024,11 +4024,11 @@ var AnimationEditorController = (_class = class {
   }
   async describeFor(effect, kinds) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`${provider.name} has no vector or motion effects.`);
     const d = await provider.describe(effect);
     if (!kinds.includes(d.kind)) {
       const hint = d.kind === "motion" ? "apply it to nodes with apply_effect" : d.kind === "vector" ? "add it with add_vector_effect" : "it draws pixels, which scenes cannot hold";
-      throw new (0, _chunkABQ2VGUBcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
+      throw new (0, _chunk5MQOBTNPcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect: ${hint}.`, d.id);
     }
     return d;
   }
@@ -4049,7 +4049,7 @@ var AnimationEditorController = (_class = class {
     return this.effectEdit(async () => {
       this.knownNodes(targets);
       const d = await this.describeFor(effect, ["motion"]);
-      const values = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, d, options.values);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, { svg: motionArtworkSvg(this.scene.artwork), nodeIds: [...targets] }, values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
@@ -4071,7 +4071,7 @@ var AnimationEditorController = (_class = class {
   addVectorEffect(effect, options = {}) {
     return this.effectEdit(async () => {
       const d = await this.describeFor(effect, ["vector"]);
-      const values = _chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, d, options.values);
+      const values = _chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, d, options.values);
       const instance = _nullishCoalesce(options.instance, () => ( nextMotionEffectInstance(this.scene)));
       const motion = await this.effects.require().applyVectorEffect(d.id, motionArtworkSvg(this.scene.artwork), values);
       const source = { instance, effect: d.id, provider: this.effects.require().id, name: d.name, values };
@@ -4095,7 +4095,7 @@ var AnimationEditorController = (_class = class {
         else if (k in d.controls.properties) base[k] = d.defaults[k];
         else throw new Error(`"${k}" is not a control of "${d.id}"; its controls are ${Object.keys(d.controls.properties).join(", ")}.`);
       }
-      const merged = { ...base, ..._chunkABQ2VGUBcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
+      const merged = { ...base, ..._chunk5MQOBTNPcjs.resolveEffectValues.call(void 0, { ...d, defaults: base }, given) };
       const { scene: bare, place } = withoutMotionEffect(this.scene, instance);
       const provider = this.effects.require();
       const source = { instance, effect: d.id, provider: provider.id, name: d.name, values: merged };
@@ -5868,7 +5868,7 @@ function createAnimationEffectsToolProvider(controller, options = {}) {
     if (!r.ok) throw new Error(r.error);
     return { target, effect: info(r.effect), effects: controller.appliedEffects().filter((e) => e.targets.includes(target)).map(info), ...r.notes.length ? { notes: r.notes } : {} };
   };
-  return withAnimationPlayback(_chunkABQ2VGUBcjs.createEffectToolProvider.call(void 0, {
+  return withAnimationPlayback(_chunk5MQOBTNPcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "animation-effects")),
     namespace: options.namespace,
     title: "Animation effects",

package/dist/animation-editor/index.js

@@ -48,7 +48,7 @@ import {
   createEffectToolProvider,
   isEffectError,
   resolveEffectValues
-} from "../chunk-7DZ55AIE.js";
+} from "../chunk-UGYUGZE2.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-2PBZBRP5.js";
 import "../chunk-ODBT55Q7.js";

package/dist/canvas/drawController.d.cts

@@ -62,6 +62,12 @@ export declare function createCanvasDrawController<TNode extends CanvasNode = Ca
     cancelStroke: () => void;
     eraseAt: (point: Point, radius?: number) => TNode[];
     drawStroke: (input: DrawStrokeInput) => Promise<DrawStrokeResult<TNode>>;
+    nodeBounds: (id: string) => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
     /** The dry paint presets a stroke can be brushed with (loads the paint engine). */
     listBrushes: typeof listCanvasBrushes;
 };

package/dist/canvas/drawController.d.ts

@@ -62,6 +62,12 @@ export declare function createCanvasDrawController<TNode extends CanvasNode = Ca
     cancelStroke: () => void;
     eraseAt: (point: Point, radius?: number) => TNode[];
     drawStroke: (input: DrawStrokeInput) => Promise<DrawStrokeResult<TNode>>;
+    nodeBounds: (id: string) => {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
     /** The dry paint presets a stroke can be brushed with (loads the paint engine). */
     listBrushes: typeof listCanvasBrushes;
 };

package/dist/canvas/effects.d.cts

@@ -24,6 +24,22 @@ export declare const CANVAS_EFFECT_PLACES: {
 export type CanvasEffectPlace = keyof typeof CANVAS_EFFECT_PLACES;
 /** The shape effect of a node, if it has one. */
 export declare function canvasNodeEffect(node: CanvasNode): CanvasShapeEffect | undefined;
+/** Whether a saved effect can be drawn with `provider`, and if not, why. */
+export type CanvasEffectStatus = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Whether `provider` can draw `effect`: an effect keeps the id of the provider it came from, and
+ * another provider (e.g. after switching libraries) does not know its effect ids.
+ */
+export declare function canvasEffectStatus(effect: Pick<CanvasShapeEffect, 'effect' | 'provider' | 'name'>, provider: EffectProvider | null | undefined): CanvasEffectStatus;
+/** Why a render of `effect` failed, for the placeholder drawn instead. */
+export declare function canvasEffectErrorReason(effect: Pick<CanvasShapeEffect, 'effect' | 'name'>, error: unknown): string;
+/** The CSS background of the placeholder drawn for an effect that cannot be drawn: a faint hatch. */
+export declare const CANVAS_EFFECT_MISSING_PATTERN = "repeating-linear-gradient(45deg, rgba(128,128,128,0.28) 0 2px, transparent 2px 8px)";
 export interface CanvasEffectsControllerOptions<TNode extends CanvasNode = CanvasNode> {
     getNodes: () => TNode[];
     setNodes: (nodes: TNode[]) => void;
@@ -45,6 +61,8 @@ export declare function createCanvasEffectsController<TNode extends CanvasNode =
     setEffectsProvider(provider: EffectProvider | null): void;
     /** Registers `provider` and returns a function that removes it again. */
     useEffects(provider: EffectProvider): () => void;
+    /** Whether the registered provider can draw `effect` (see `canvasEffectStatus`). */
+    status(effect: CanvasShapeEffect): CanvasEffectStatus;
     /** The shape nodes that carry effects (or one node's). */
     list(nodeId?: string): {
         nodeId: string;

package/dist/canvas/effects.d.ts

@@ -24,6 +24,22 @@ export declare const CANVAS_EFFECT_PLACES: {
 export type CanvasEffectPlace = keyof typeof CANVAS_EFFECT_PLACES;
 /** The shape effect of a node, if it has one. */
 export declare function canvasNodeEffect(node: CanvasNode): CanvasShapeEffect | undefined;
+/** Whether a saved effect can be drawn with `provider`, and if not, why. */
+export type CanvasEffectStatus = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Whether `provider` can draw `effect`: an effect keeps the id of the provider it came from, and
+ * another provider (e.g. after switching libraries) does not know its effect ids.
+ */
+export declare function canvasEffectStatus(effect: Pick<CanvasShapeEffect, 'effect' | 'provider' | 'name'>, provider: EffectProvider | null | undefined): CanvasEffectStatus;
+/** Why a render of `effect` failed, for the placeholder drawn instead. */
+export declare function canvasEffectErrorReason(effect: Pick<CanvasShapeEffect, 'effect' | 'name'>, error: unknown): string;
+/** The CSS background of the placeholder drawn for an effect that cannot be drawn: a faint hatch. */
+export declare const CANVAS_EFFECT_MISSING_PATTERN = "repeating-linear-gradient(45deg, rgba(128,128,128,0.28) 0 2px, transparent 2px 8px)";
 export interface CanvasEffectsControllerOptions<TNode extends CanvasNode = CanvasNode> {
     getNodes: () => TNode[];
     setNodes: (nodes: TNode[]) => void;
@@ -45,6 +61,8 @@ export declare function createCanvasEffectsController<TNode extends CanvasNode =
     setEffectsProvider(provider: EffectProvider | null): void;
     /** Registers `provider` and returns a function that removes it again. */
     useEffects(provider: EffectProvider): () => void;
+    /** Whether the registered provider can draw `effect` (see `canvasEffectStatus`). */
+    status(effect: CanvasShapeEffect): CanvasEffectStatus;
     /** The shape nodes that carry effects (or one node's). */
     list(nodeId?: string): {
         nodeId: string;

package/dist/canvas/gestures.d.cts

@@ -0,0 +1,87 @@
+/**
+ * Hand-drawn annotation gestures (`canvas.circle`, `canvas.underline`, `canvas.arrow`,
+ * `canvas.bracket`, `canvas.strike`, `canvas.cross`, `canvas.check`): stroke points in canvas
+ * coordinates, generated with a seeded human wobble (overshoot, slightly open loops, uneven
+ * pressure). Pure geometry with no imports, so the command layer can use it.
+ */
+export type GesturePoint = [number, number];
+export interface GestureRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A generated gesture: one stroke, as `drawStroke` takes it. */
+export interface GestureStroke {
+    points: GesturePoint[];
+    /** Uneven pen pressure along the stroke (only applied to brushed strokes). */
+    pressure: number[];
+}
+/** Seeded random numbers in [0, 1) (mulberry32). */
+export declare function gestureRandom(seed: number): () => number;
+/** A stable 32-bit seed for any JSON value (FNV-1a over its JSON), so equal requests draw equal marks. */
+export declare function gestureSeed(value: unknown): number;
+/** The box around several rects. */
+export declare function gestureUnion(rects: readonly GestureRect[]): GestureRect;
+export interface CircleGestureOptions {
+    /** Space between the rect and the loop, about this many canvas units at the ends of its axes (default 8). */
+    padding?: number;
+}
+/**
+ * A loose, slightly open ellipse around `rect`: it starts near the top left, goes round once
+ * and overshoots past its start on a slightly wider path, so the ends never quite meet. It
+ * never cuts into the rect.
+ */
+export declare function circleGesture(rect: GestureRect, seed: number, options?: CircleGestureOptions): GestureStroke;
+export interface UnderlineGestureOptions {
+    /** Gap below the rect's bottom edge, canvas units (default 4). */
+    offset?: number;
+    /** A wavy underline instead of a straight one (default false). */
+    wave?: boolean;
+}
+/** A stroke under the rect's bottom edge, a little longer or shorter than it, never touching it. */
+export declare function underlineGesture(rect: GestureRect, seed: number, options?: UnderlineGestureOptions): GestureStroke;
+/** Where the line from the rect's centre towards `toward` leaves the rect, pushed out by `gap`. */
+export declare function gestureEdgePoint(rect: GestureRect, toward: GesturePoint, gap?: number): GesturePoint;
+export type GestureEnd = GesturePoint | GestureRect;
+export interface ArrowGestureOptions {
+    /** Bend of the shaft, −1..1: how far its middle bulges, as a fraction of half its length (+ bends left of travel). Default: a gentle seeded bend. */
+    curve?: number;
+    /** Space left between a rect end and the arrow, canvas units (default 6). */
+    gap?: number;
+}
+/**
+ * A curved arrow from `from` to `to` with a hand-drawn head. A rect end is reached at its
+ * nearest edge (on the line between the two ends' centres), `gap` units clear of it; a point
+ * end is used as it is. The head is drawn in the same stroke: tip, one barb, back to the tip,
+ * the other barb.
+ */
+export declare function arrowGesture(from: GestureEnd, to: GestureEnd, seed: number, options?: ArrowGestureOptions): GestureStroke;
+export type GestureSide = 'left' | 'right' | 'top' | 'bottom';
+export interface BracketGestureOptions {
+    /** `curly` (default) or `square`. */
+    shape?: 'curly' | 'square';
+    /** Gap between the rect and the bracket, canvas units (default 8). */
+    padding?: number;
+    /** How far the bracket reaches out from its ends, canvas units (default: from its span, 6..20). */
+    depth?: number;
+}
+/**
+ * A curly or square bracket on one `side` of `rect`, spanning it end to end. Its ends point at
+ * the rect; a curly bracket's middle point faces away from it. It never enters the rect.
+ */
+export declare function bracketGesture(rect: GestureRect, side: GestureSide, seed: number, options?: BracketGestureOptions): GestureStroke;
+/** A line struck through the middle of `rect`, slightly past both ends. */
+export declare function strikeGesture(rect: GestureRect, seed: number): GestureStroke;
+/**
+ * A cross over `rect`, corner to corner and a little past. It is one stroke, so after the first
+ * diagonal the pen runs back along it to the middle and up the second one before drawing it
+ * (the retraced part overlaps itself).
+ */
+export declare function crossGesture(rect: GestureRect, seed: number): GestureStroke;
+export interface CheckGestureOptions {
+    /** Height of the tick, canvas units (default: 60% of the rect's smaller side, 12..48; 20 at a point). */
+    size?: number;
+}
+/** A tick mark centred on a point, or in the middle of a rect. */
+export declare function checkGesture(at: GestureEnd, seed: number, options?: CheckGestureOptions): GestureStroke;

package/dist/canvas/gestures.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Hand-drawn annotation gestures (`canvas.circle`, `canvas.underline`, `canvas.arrow`,
+ * `canvas.bracket`, `canvas.strike`, `canvas.cross`, `canvas.check`): stroke points in canvas
+ * coordinates, generated with a seeded human wobble (overshoot, slightly open loops, uneven
+ * pressure). Pure geometry with no imports, so the command layer can use it.
+ */
+export type GesturePoint = [number, number];
+export interface GestureRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A generated gesture: one stroke, as `drawStroke` takes it. */
+export interface GestureStroke {
+    points: GesturePoint[];
+    /** Uneven pen pressure along the stroke (only applied to brushed strokes). */
+    pressure: number[];
+}
+/** Seeded random numbers in [0, 1) (mulberry32). */
+export declare function gestureRandom(seed: number): () => number;
+/** A stable 32-bit seed for any JSON value (FNV-1a over its JSON), so equal requests draw equal marks. */
+export declare function gestureSeed(value: unknown): number;
+/** The box around several rects. */
+export declare function gestureUnion(rects: readonly GestureRect[]): GestureRect;
+export interface CircleGestureOptions {
+    /** Space between the rect and the loop, about this many canvas units at the ends of its axes (default 8). */
+    padding?: number;
+}
+/**
+ * A loose, slightly open ellipse around `rect`: it starts near the top left, goes round once
+ * and overshoots past its start on a slightly wider path, so the ends never quite meet. It
+ * never cuts into the rect.
+ */
+export declare function circleGesture(rect: GestureRect, seed: number, options?: CircleGestureOptions): GestureStroke;
+export interface UnderlineGestureOptions {
+    /** Gap below the rect's bottom edge, canvas units (default 4). */
+    offset?: number;
+    /** A wavy underline instead of a straight one (default false). */
+    wave?: boolean;
+}
+/** A stroke under the rect's bottom edge, a little longer or shorter than it, never touching it. */
+export declare function underlineGesture(rect: GestureRect, seed: number, options?: UnderlineGestureOptions): GestureStroke;
+/** Where the line from the rect's centre towards `toward` leaves the rect, pushed out by `gap`. */
+export declare function gestureEdgePoint(rect: GestureRect, toward: GesturePoint, gap?: number): GesturePoint;
+export type GestureEnd = GesturePoint | GestureRect;
+export interface ArrowGestureOptions {
+    /** Bend of the shaft, −1..1: how far its middle bulges, as a fraction of half its length (+ bends left of travel). Default: a gentle seeded bend. */
+    curve?: number;
+    /** Space left between a rect end and the arrow, canvas units (default 6). */
+    gap?: number;
+}
+/**
+ * A curved arrow from `from` to `to` with a hand-drawn head. A rect end is reached at its
+ * nearest edge (on the line between the two ends' centres), `gap` units clear of it; a point
+ * end is used as it is. The head is drawn in the same stroke: tip, one barb, back to the tip,
+ * the other barb.
+ */
+export declare function arrowGesture(from: GestureEnd, to: GestureEnd, seed: number, options?: ArrowGestureOptions): GestureStroke;
+export type GestureSide = 'left' | 'right' | 'top' | 'bottom';
+export interface BracketGestureOptions {
+    /** `curly` (default) or `square`. */
+    shape?: 'curly' | 'square';
+    /** Gap between the rect and the bracket, canvas units (default 8). */
+    padding?: number;
+    /** How far the bracket reaches out from its ends, canvas units (default: from its span, 6..20). */
+    depth?: number;
+}
+/**
+ * A curly or square bracket on one `side` of `rect`, spanning it end to end. Its ends point at
+ * the rect; a curly bracket's middle point faces away from it. It never enters the rect.
+ */
+export declare function bracketGesture(rect: GestureRect, side: GestureSide, seed: number, options?: BracketGestureOptions): GestureStroke;
+/** A line struck through the middle of `rect`, slightly past both ends. */
+export declare function strikeGesture(rect: GestureRect, seed: number): GestureStroke;
+/**
+ * A cross over `rect`, corner to corner and a little past. It is one stroke, so after the first
+ * diagonal the pen runs back along it to the middle and up the second one before drawing it
+ * (the retraced part overlaps itself).
+ */
+export declare function crossGesture(rect: GestureRect, seed: number): GestureStroke;
+export interface CheckGestureOptions {
+    /** Height of the tick, canvas units (default: 60% of the rect's smaller side, 12..48; 20 at a point). */
+    size?: number;
+}
+/** A tick mark centred on a point, or in the middle of a rect. */
+export declare function checkGesture(at: GestureEnd, seed: number, options?: CheckGestureOptions): GestureStroke;