@pixerate/editor 0.123.0 → 0.124.1

package/dist/tools-C7JtLYzo.d.ts

@@ -0,0 +1,126 @@
+import { A as AgentTool, a as AgentToolProvider } from './registry-D-4fit9C.js';
+import { J as JsonSchema } from './schema-Di0CS6Pe.js';
+import { E as EffectProvider, a as EffectUse } from './helpers-DX2_7L5t.js';
+
+/**
+ * The agent tools for provider effects, shared by every editor that takes an `EffectProvider`:
+ * `search_effects`, `describe_effect`, `list_applied_effects`, `apply_effect`, `update_effect` and
+ * `remove_effect`. An editor supplies an `EffectToolHost` (what its targets are and how to change
+ * them as one undo step each) and may add tools of its own (`extraTools`).
+ *
+ * Without a provider the read tools say so (and `list_applied_effects` still lists what a
+ * document holds), and the write tools refuse with the reason. On a read-only surface the write
+ * tools are hidden.
+ */
+
+/** One effect applied to a target, as the tools report it. */
+interface AppliedEffectInfo {
+    /** Its id on the target: what `update_effect` and `remove_effect` take. */
+    id: string;
+    effect: string;
+    name?: string;
+    provider?: string;
+    /** What it is on the target (e.g. `clip effect`, `effect clip`, `transition`, `smart filter`, `effect layer`). */
+    role: string;
+    enabled: boolean;
+    /** 0–1, or keyframes, where the role has an opacity. */
+    opacity?: unknown;
+    /** Its saved control values (numbers may be keyframes where the editor allows them). */
+    values: Record<string, unknown>;
+    /** Its place in the target's stack (0 = applied first), for stacked roles. */
+    index?: number;
+}
+interface EffectTargetEffects {
+    target: string;
+    /** A label for the target (a clip or layer name). */
+    name?: string;
+    effects: AppliedEffectInfo[];
+}
+interface EffectChangeResult {
+    target: string;
+    /** What was added, changed or removed. */
+    effect: AppliedEffectInfo;
+    /** The target's effects afterwards. */
+    effects: AppliedEffectInfo[];
+    /** Other things the change made (a new clip or layer id, ...). */
+    [extra: string]: unknown;
+}
+/** What an editor gives the shared effect tools. */
+interface EffectToolHost {
+    /** Provider id (unique per registry). */
+    id: string;
+    /** Always prefix tool names with `<namespace>__`. */
+    namespace?: string;
+    /** Words for the editor's targets, e.g. `{ noun: 'clip', id: 'A clip id from get_video_project (e.g. "c1").' }`. */
+    target: {
+        noun: string;
+        id: string;
+    };
+    /** The uses `apply_effect` takes on a target (others go through `extraTools`). */
+    applyUses: readonly EffectUse[];
+    /** Text added to `apply_effect`'s description: where the effect goes and how it is drawn. */
+    applyDetails: string;
+    /** The current provider, or `null`. */
+    provider(): EffectProvider | null;
+    /** Why edits are refused now (read-only), or `null`. */
+    readOnlyReason(): string | null;
+    /** Every target with effects, or one target (throws for an unknown id, naming valid ones). */
+    list(target?: string): EffectTargetEffects[];
+    apply(target: string, effect: string, args: {
+        values?: Record<string, unknown>;
+        index?: number;
+        enabled?: boolean;
+        opacity?: number;
+    }): Promise<EffectChangeResult>;
+    update(target: string, instance: string, changes: {
+        values?: Record<string, unknown>;
+        index?: number;
+        enabled?: boolean;
+        opacity?: number;
+    }): Promise<EffectChangeResult>;
+    remove(target: string, instance: string): Promise<EffectChangeResult>;
+    /** Editor-specific effect tools (transitions, effect clips, effect layers, keyframes). */
+    extraTools?: (context: EffectToolContext) => AgentTool[];
+    /** Lets the tool list follow the provider and read-only changes. */
+    subscribe?: (notify: () => void) => () => void;
+}
+/** Shared pieces for `extraTools`. */
+interface EffectToolContext {
+    /** The provider, or a thrown error saying none is registered. */
+    requireProvider(): EffectProvider;
+    /** The schema of a `values` argument. */
+    valuesSchema(what: string, keyframes?: boolean): JsonSchema;
+    /** The schema of an `effect` argument for effects with one of `uses`. */
+    effectIdSchema(uses: readonly EffectUse[]): JsonSchema;
+    readonly annotations: typeof ANNOTATIONS;
+}
+declare const ANNOTATIONS: {
+    readonly read: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly write: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly writeIdempotent: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly destructive: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
+};
+/** The agent tools for provider effects in one editor (see the module comment). */
+declare function createEffectToolProvider(host: EffectToolHost): AgentToolProvider;
+
+export { type AppliedEffectInfo as A, type EffectChangeResult as E, type EffectTargetEffects as a, type EffectToolContext as b, type EffectToolHost as c, createEffectToolProvider as d };

package/dist/tools-DHKGHiSK.d.cts

@@ -0,0 +1,126 @@
+import { A as AgentTool, a as AgentToolProvider } from './registry-BqA1AZt0.cjs';
+import { J as JsonSchema } from './schema-Di0CS6Pe.cjs';
+import { E as EffectProvider, a as EffectUse } from './helpers-777mC6dc.cjs';
+
+/**
+ * The agent tools for provider effects, shared by every editor that takes an `EffectProvider`:
+ * `search_effects`, `describe_effect`, `list_applied_effects`, `apply_effect`, `update_effect` and
+ * `remove_effect`. An editor supplies an `EffectToolHost` (what its targets are and how to change
+ * them as one undo step each) and may add tools of its own (`extraTools`).
+ *
+ * Without a provider the read tools say so (and `list_applied_effects` still lists what a
+ * document holds), and the write tools refuse with the reason. On a read-only surface the write
+ * tools are hidden.
+ */
+
+/** One effect applied to a target, as the tools report it. */
+interface AppliedEffectInfo {
+    /** Its id on the target: what `update_effect` and `remove_effect` take. */
+    id: string;
+    effect: string;
+    name?: string;
+    provider?: string;
+    /** What it is on the target (e.g. `clip effect`, `effect clip`, `transition`, `smart filter`, `effect layer`). */
+    role: string;
+    enabled: boolean;
+    /** 0–1, or keyframes, where the role has an opacity. */
+    opacity?: unknown;
+    /** Its saved control values (numbers may be keyframes where the editor allows them). */
+    values: Record<string, unknown>;
+    /** Its place in the target's stack (0 = applied first), for stacked roles. */
+    index?: number;
+}
+interface EffectTargetEffects {
+    target: string;
+    /** A label for the target (a clip or layer name). */
+    name?: string;
+    effects: AppliedEffectInfo[];
+}
+interface EffectChangeResult {
+    target: string;
+    /** What was added, changed or removed. */
+    effect: AppliedEffectInfo;
+    /** The target's effects afterwards. */
+    effects: AppliedEffectInfo[];
+    /** Other things the change made (a new clip or layer id, ...). */
+    [extra: string]: unknown;
+}
+/** What an editor gives the shared effect tools. */
+interface EffectToolHost {
+    /** Provider id (unique per registry). */
+    id: string;
+    /** Always prefix tool names with `<namespace>__`. */
+    namespace?: string;
+    /** Words for the editor's targets, e.g. `{ noun: 'clip', id: 'A clip id from get_video_project (e.g. "c1").' }`. */
+    target: {
+        noun: string;
+        id: string;
+    };
+    /** The uses `apply_effect` takes on a target (others go through `extraTools`). */
+    applyUses: readonly EffectUse[];
+    /** Text added to `apply_effect`'s description: where the effect goes and how it is drawn. */
+    applyDetails: string;
+    /** The current provider, or `null`. */
+    provider(): EffectProvider | null;
+    /** Why edits are refused now (read-only), or `null`. */
+    readOnlyReason(): string | null;
+    /** Every target with effects, or one target (throws for an unknown id, naming valid ones). */
+    list(target?: string): EffectTargetEffects[];
+    apply(target: string, effect: string, args: {
+        values?: Record<string, unknown>;
+        index?: number;
+        enabled?: boolean;
+        opacity?: number;
+    }): Promise<EffectChangeResult>;
+    update(target: string, instance: string, changes: {
+        values?: Record<string, unknown>;
+        index?: number;
+        enabled?: boolean;
+        opacity?: number;
+    }): Promise<EffectChangeResult>;
+    remove(target: string, instance: string): Promise<EffectChangeResult>;
+    /** Editor-specific effect tools (transitions, effect clips, effect layers, keyframes). */
+    extraTools?: (context: EffectToolContext) => AgentTool[];
+    /** Lets the tool list follow the provider and read-only changes. */
+    subscribe?: (notify: () => void) => () => void;
+}
+/** Shared pieces for `extraTools`. */
+interface EffectToolContext {
+    /** The provider, or a thrown error saying none is registered. */
+    requireProvider(): EffectProvider;
+    /** The schema of a `values` argument. */
+    valuesSchema(what: string, keyframes?: boolean): JsonSchema;
+    /** The schema of an `effect` argument for effects with one of `uses`. */
+    effectIdSchema(uses: readonly EffectUse[]): JsonSchema;
+    readonly annotations: typeof ANNOTATIONS;
+}
+declare const ANNOTATIONS: {
+    readonly read: {
+        readonly readOnlyHint: true;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly write: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly writeIdempotent: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly destructive: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
+};
+/** The agent tools for provider effects in one editor (see the module comment). */
+declare function createEffectToolProvider(host: EffectToolHost): AgentToolProvider;
+
+export { type AppliedEffectInfo as A, type EffectChangeResult as E, type EffectTargetEffects as a, type EffectToolContext as b, type EffectToolHost as c, createEffectToolProvider as d };

package/dist/{types-fuXEme9j.d.ts → types-BcX7sCsn.d.ts}

@@ -1,4 +1,4 @@
-import { C as CanvasGradientDef } from './bezier-DQZE5dxA.js';
+import { C as CanvasGradientDef } from './gradient-KDfCvhuj.js';
 import { W as WarpStyle, a as WarpMesh } from './types-CwMPoRMU.js';
 
 /** An affine matrix `[a, b, c, d, e, f]`: `x' = a·x + c·y + e`, `y' = b·x + d·y + f` (SVG order). */
@@ -990,4 +990,4 @@ type VectorFilter = {
     };
 }[VectorFilterType];
 
-export { type VectorAlign as $, type VectorTextNode as A, type VectorAnchorType as B, type VectorCornerKind as C, type VectorViewport as D, type VectorConnectorRoute as E, type VectorConnectorSide as F, type VectorConnectorEnd as G, type VectorConnector as H, type VectorConstraintKind as I, type VectorConstraint as J, type VectorCharacterStyle as K, type VectorTextRun as L, type VectorParagraphStyle as M, type VectorTextFrame as N, type VectorTransformHandle as O, type VectorAnchorRef as P, type VectorPathfinderOperation as Q, type VectorTool as R, type VectorDefaults as S, type VectorTextAlign as T, type VectorStyle as U, type VectorEffectType as V, type VectorHandleRef as W, type VectorSegmentRef as X, type VectorBlendOptions as Y, type VectorModifiers as Z, type VectorBlendMode as _, type VectorEffectParamsMap as a, type VectorDistribute as a0, type VectorArrange as a1, type VectorMaskType as a2, type VectorSymmetryMode as a3, type VectorSymmetry as a4, type VectorFreeformPoint as a5, type VectorMeshGradient as a6, type VectorFreeformGradient as a7, type VectorArrowhead as a8, type VectorResizing as a9, VECTOR_FILTER_TYPES as aA, VECTOR_GRADIENT_INTERPOLATIONS as aB, VECTOR_GRADIENT_SPREADS as aC, VECTOR_GRADIENT_TYPES as aD, VECTOR_HORIZONTAL_RESIZING as aE, VECTOR_MASK_TYPES as aF, VECTOR_MERGE_MODES as aG, VECTOR_PATHFINDER_OPERATIONS as aH, VECTOR_PATH_TEXT_BASELINES as aI, VECTOR_STROKE_GRADIENT_MODES as aJ, VECTOR_SYMMETRY_MODES as aK, VECTOR_TEXT_ALIGNS as aL, VECTOR_TOOLS as aM, VECTOR_TRANSFORM_HANDLES as aN, VECTOR_VERTICAL_RESIZING as aO, type VectorCorner as aP, type VectorGeomRef as aQ, type VectorLineCap as aR, type VectorPathTextBaseline as aS, type VectorStrokeLayerKind as aT, type VectorTextRunStyle as aU, type VectorWarpStyle as aV, type VectorFrame as aa, type VectorHorizontalResizing as ab, type VectorVerticalResizing as ac, type VectorMask as ad, type VectorAverageAxis as ae, type VectorSymbol as af, type VectorParameter as ag, type VectorBlendSpacing as ah, type VectorGradientInterpolation as ai, type VectorStrokeGradientMode as aj, type VectorArrowAlign as ak, type VectorPaintLayer as al, type VectorStrokeLayer as am, type VectorBlend as an, type VectorMergeMode as ao, type VectorLineJoin as ap, type VectorStrokeSettings as aq, type VectorInstanceOverrides as ar, VECTOR_ARROWHEADS as as, VECTOR_BLEND_MODES as at, VECTOR_BLEND_SPACINGS as au, VECTOR_CONNECTOR_ROUTES as av, VECTOR_CONNECTOR_SIDES as aw, VECTOR_CONSTRAINT_KINDS as ax, VECTOR_CORNER_KINDS as ay, VECTOR_EFFECT_TYPES as az, type VectorPathNode as b, type VectorFillRule as c, type VectorBooleanOperation as d, type VectorNode as e, type VectorEffect as f, type VectorGroupNode as g, type VectorBounds as h, type VectorWarpMesh as i, type VectorInstanceNode as j, type VectorFilterType as k, type VectorFilterParamsMap as l, type VectorFilter as m, type VectorGradient as n, type Vec2 as o, type VectorGradientUnits as p, type VectorGradientSpread as q, type VectorGradientType as r, type VectorPaint as s, type VectorMatrix as t, type VectorGradientStop as u, type VectorStrokeAlign as v, type VectorSubpath as w, type VectorDocument as x, type VectorWidthPoint as y, type VectorAnchor as z };
+export { type VectorAlign as $, type VectorTextNode as A, type VectorAnchorType as B, type VectorCornerKind as C, type VectorViewport as D, type VectorConnectorRoute as E, type VectorConnectorSide as F, type VectorConnectorEnd as G, type VectorConnector as H, type VectorConstraintKind as I, type VectorConstraint as J, type VectorCharacterStyle as K, type VectorTextRun as L, type VectorParagraphStyle as M, type VectorTextFrame as N, type VectorTransformHandle as O, type VectorAnchorRef as P, type VectorPathfinderOperation as Q, type VectorTool as R, type VectorDefaults as S, type VectorTextAlign as T, type VectorStyle as U, type VectorDocument as V, type VectorHandleRef as W, type VectorSegmentRef as X, type VectorBlendOptions as Y, type VectorModifiers as Z, type VectorBlendMode as _, type VectorEffectType as a, type VectorDistribute as a0, type VectorArrange as a1, type VectorMaskType as a2, type VectorSymmetryMode as a3, type VectorSymmetry as a4, type VectorFreeformPoint as a5, type VectorMeshGradient as a6, type VectorFreeformGradient as a7, type VectorArrowhead as a8, type VectorResizing as a9, VECTOR_FILTER_TYPES as aA, VECTOR_GRADIENT_INTERPOLATIONS as aB, VECTOR_GRADIENT_SPREADS as aC, VECTOR_GRADIENT_TYPES as aD, VECTOR_HORIZONTAL_RESIZING as aE, VECTOR_MASK_TYPES as aF, VECTOR_MERGE_MODES as aG, VECTOR_PATHFINDER_OPERATIONS as aH, VECTOR_PATH_TEXT_BASELINES as aI, VECTOR_STROKE_GRADIENT_MODES as aJ, VECTOR_SYMMETRY_MODES as aK, VECTOR_TEXT_ALIGNS as aL, VECTOR_TOOLS as aM, VECTOR_TRANSFORM_HANDLES as aN, VECTOR_VERTICAL_RESIZING as aO, type VectorCorner as aP, type VectorGeomRef as aQ, type VectorLineCap as aR, type VectorPathTextBaseline as aS, type VectorStrokeLayerKind as aT, type VectorTextRunStyle as aU, type VectorWarpStyle as aV, type VectorFrame as aa, type VectorHorizontalResizing as ab, type VectorVerticalResizing as ac, type VectorMask as ad, type VectorAverageAxis as ae, type VectorSymbol as af, type VectorParameter as ag, type VectorBlendSpacing as ah, type VectorGradientInterpolation as ai, type VectorStrokeGradientMode as aj, type VectorArrowAlign as ak, type VectorPaintLayer as al, type VectorStrokeLayer as am, type VectorBlend as an, type VectorMergeMode as ao, type VectorLineJoin as ap, type VectorStrokeSettings as aq, type VectorInstanceOverrides as ar, VECTOR_ARROWHEADS as as, VECTOR_BLEND_MODES as at, VECTOR_BLEND_SPACINGS as au, VECTOR_CONNECTOR_ROUTES as av, VECTOR_CONNECTOR_SIDES as aw, VECTOR_CONSTRAINT_KINDS as ax, VECTOR_CORNER_KINDS as ay, VECTOR_EFFECT_TYPES as az, type VectorEffectParamsMap as b, type VectorPathNode as c, type VectorFillRule as d, type VectorBooleanOperation as e, type VectorNode as f, type VectorEffect as g, type VectorGroupNode as h, type VectorBounds as i, type VectorWarpMesh as j, type VectorInstanceNode as k, type VectorFilterType as l, type VectorFilterParamsMap as m, type VectorFilter as n, type VectorGradient as o, type Vec2 as p, type VectorGradientUnits as q, type VectorGradientSpread as r, type VectorGradientType as s, type VectorPaint as t, type VectorMatrix as u, type VectorGradientStop as v, type VectorStrokeAlign as w, type VectorSubpath as x, type VectorWidthPoint as y, type VectorAnchor as z };

package/dist/{types-DJF3Ghn5.d.cts → types-CznabG7m.d.cts}

@@ -1,4 +1,4 @@
-import { C as CanvasGradientDef } from './bezier-C-W9LFyD.cjs';
+import { C as CanvasGradientDef } from './gradient-KDfCvhuj.cjs';
 import { W as WarpStyle, a as WarpMesh } from './types-CwMPoRMU.cjs';
 
 /** An affine matrix `[a, b, c, d, e, f]`: `x' = a·x + c·y + e`, `y' = b·x + d·y + f` (SVG order). */
@@ -990,4 +990,4 @@ type VectorFilter = {
     };
 }[VectorFilterType];
 
-export { type VectorAlign as $, type VectorTextNode as A, type VectorAnchorType as B, type VectorCornerKind as C, type VectorViewport as D, type VectorConnectorRoute as E, type VectorConnectorSide as F, type VectorConnectorEnd as G, type VectorConnector as H, type VectorConstraintKind as I, type VectorConstraint as J, type VectorCharacterStyle as K, type VectorTextRun as L, type VectorParagraphStyle as M, type VectorTextFrame as N, type VectorTransformHandle as O, type VectorAnchorRef as P, type VectorPathfinderOperation as Q, type VectorTool as R, type VectorDefaults as S, type VectorTextAlign as T, type VectorStyle as U, type VectorEffectType as V, type VectorHandleRef as W, type VectorSegmentRef as X, type VectorBlendOptions as Y, type VectorModifiers as Z, type VectorBlendMode as _, type VectorEffectParamsMap as a, type VectorDistribute as a0, type VectorArrange as a1, type VectorMaskType as a2, type VectorSymmetryMode as a3, type VectorSymmetry as a4, type VectorFreeformPoint as a5, type VectorMeshGradient as a6, type VectorFreeformGradient as a7, type VectorArrowhead as a8, type VectorResizing as a9, VECTOR_FILTER_TYPES as aA, VECTOR_GRADIENT_INTERPOLATIONS as aB, VECTOR_GRADIENT_SPREADS as aC, VECTOR_GRADIENT_TYPES as aD, VECTOR_HORIZONTAL_RESIZING as aE, VECTOR_MASK_TYPES as aF, VECTOR_MERGE_MODES as aG, VECTOR_PATHFINDER_OPERATIONS as aH, VECTOR_PATH_TEXT_BASELINES as aI, VECTOR_STROKE_GRADIENT_MODES as aJ, VECTOR_SYMMETRY_MODES as aK, VECTOR_TEXT_ALIGNS as aL, VECTOR_TOOLS as aM, VECTOR_TRANSFORM_HANDLES as aN, VECTOR_VERTICAL_RESIZING as aO, type VectorCorner as aP, type VectorGeomRef as aQ, type VectorLineCap as aR, type VectorPathTextBaseline as aS, type VectorStrokeLayerKind as aT, type VectorTextRunStyle as aU, type VectorWarpStyle as aV, type VectorFrame as aa, type VectorHorizontalResizing as ab, type VectorVerticalResizing as ac, type VectorMask as ad, type VectorAverageAxis as ae, type VectorSymbol as af, type VectorParameter as ag, type VectorBlendSpacing as ah, type VectorGradientInterpolation as ai, type VectorStrokeGradientMode as aj, type VectorArrowAlign as ak, type VectorPaintLayer as al, type VectorStrokeLayer as am, type VectorBlend as an, type VectorMergeMode as ao, type VectorLineJoin as ap, type VectorStrokeSettings as aq, type VectorInstanceOverrides as ar, VECTOR_ARROWHEADS as as, VECTOR_BLEND_MODES as at, VECTOR_BLEND_SPACINGS as au, VECTOR_CONNECTOR_ROUTES as av, VECTOR_CONNECTOR_SIDES as aw, VECTOR_CONSTRAINT_KINDS as ax, VECTOR_CORNER_KINDS as ay, VECTOR_EFFECT_TYPES as az, type VectorPathNode as b, type VectorFillRule as c, type VectorBooleanOperation as d, type VectorNode as e, type VectorEffect as f, type VectorGroupNode as g, type VectorBounds as h, type VectorWarpMesh as i, type VectorInstanceNode as j, type VectorFilterType as k, type VectorFilterParamsMap as l, type VectorFilter as m, type VectorGradient as n, type Vec2 as o, type VectorGradientUnits as p, type VectorGradientSpread as q, type VectorGradientType as r, type VectorPaint as s, type VectorMatrix as t, type VectorGradientStop as u, type VectorStrokeAlign as v, type VectorSubpath as w, type VectorDocument as x, type VectorWidthPoint as y, type VectorAnchor as z };
+export { type VectorAlign as $, type VectorTextNode as A, type VectorAnchorType as B, type VectorCornerKind as C, type VectorViewport as D, type VectorConnectorRoute as E, type VectorConnectorSide as F, type VectorConnectorEnd as G, type VectorConnector as H, type VectorConstraintKind as I, type VectorConstraint as J, type VectorCharacterStyle as K, type VectorTextRun as L, type VectorParagraphStyle as M, type VectorTextFrame as N, type VectorTransformHandle as O, type VectorAnchorRef as P, type VectorPathfinderOperation as Q, type VectorTool as R, type VectorDefaults as S, type VectorTextAlign as T, type VectorStyle as U, type VectorDocument as V, type VectorHandleRef as W, type VectorSegmentRef as X, type VectorBlendOptions as Y, type VectorModifiers as Z, type VectorBlendMode as _, type VectorEffectType as a, type VectorDistribute as a0, type VectorArrange as a1, type VectorMaskType as a2, type VectorSymmetryMode as a3, type VectorSymmetry as a4, type VectorFreeformPoint as a5, type VectorMeshGradient as a6, type VectorFreeformGradient as a7, type VectorArrowhead as a8, type VectorResizing as a9, VECTOR_FILTER_TYPES as aA, VECTOR_GRADIENT_INTERPOLATIONS as aB, VECTOR_GRADIENT_SPREADS as aC, VECTOR_GRADIENT_TYPES as aD, VECTOR_HORIZONTAL_RESIZING as aE, VECTOR_MASK_TYPES as aF, VECTOR_MERGE_MODES as aG, VECTOR_PATHFINDER_OPERATIONS as aH, VECTOR_PATH_TEXT_BASELINES as aI, VECTOR_STROKE_GRADIENT_MODES as aJ, VECTOR_SYMMETRY_MODES as aK, VECTOR_TEXT_ALIGNS as aL, VECTOR_TOOLS as aM, VECTOR_TRANSFORM_HANDLES as aN, VECTOR_VERTICAL_RESIZING as aO, type VectorCorner as aP, type VectorGeomRef as aQ, type VectorLineCap as aR, type VectorPathTextBaseline as aS, type VectorStrokeLayerKind as aT, type VectorTextRunStyle as aU, type VectorWarpStyle as aV, type VectorFrame as aa, type VectorHorizontalResizing as ab, type VectorVerticalResizing as ac, type VectorMask as ad, type VectorAverageAxis as ae, type VectorSymbol as af, type VectorParameter as ag, type VectorBlendSpacing as ah, type VectorGradientInterpolation as ai, type VectorStrokeGradientMode as aj, type VectorArrowAlign as ak, type VectorPaintLayer as al, type VectorStrokeLayer as am, type VectorBlend as an, type VectorMergeMode as ao, type VectorLineJoin as ap, type VectorStrokeSettings as aq, type VectorInstanceOverrides as ar, VECTOR_ARROWHEADS as as, VECTOR_BLEND_MODES as at, VECTOR_BLEND_SPACINGS as au, VECTOR_CONNECTOR_ROUTES as av, VECTOR_CONNECTOR_SIDES as aw, VECTOR_CONSTRAINT_KINDS as ax, VECTOR_CORNER_KINDS as ay, VECTOR_EFFECT_TYPES as az, type VectorEffectParamsMap as b, type VectorPathNode as c, type VectorFillRule as d, type VectorBooleanOperation as e, type VectorNode as f, type VectorEffect as g, type VectorGroupNode as h, type VectorBounds as i, type VectorWarpMesh as j, type VectorInstanceNode as k, type VectorFilterType as l, type VectorFilterParamsMap as m, type VectorFilter as n, type VectorGradient as o, type Vec2 as p, type VectorGradientUnits as q, type VectorGradientSpread as r, type VectorGradientType as s, type VectorPaint as t, type VectorMatrix as u, type VectorGradientStop as v, type VectorStrokeAlign as w, type VectorSubpath as x, type VectorWidthPoint as y, type VectorAnchor as z };

package/dist/types-D3-J3TFf.d.ts

@@ -0,0 +1,185 @@
+import { b as AnimationEasing } from './easing-lM0Xo9Ni.js';
+
+/**
+ * Types for the schema-driven parameters editor: the control panel of an effect, shader,
+ * generator or component. A `ParameterSchema` lists fields (optionally in groups); a
+ * `ParametersController` holds their values with validation, undo, presets and keyframes.
+ */
+/** A parameter's value. `number` / `int`: a number; `boolean`; `choice`: an option value;
+ * `color`: `#rrggbb` (or `#rrggbbaa` with `alpha`); `vector`: 2–4 numbers; `image` / `text`: a string. */
+type ParameterValue = number | boolean | string | number[];
+/** Parameter id → value. */
+type ParameterValues = Record<string, ParameterValue>;
+type ParameterFieldType = 'number' | 'int' | 'boolean' | 'choice' | 'color' | 'vector' | 'image' | 'text';
+/**
+ * One test in a `showIf` condition: a literal (equal to), an array (one of), or an object
+ * whose keys must all hold.
+ */
+type ParameterConditionTest = string | number | boolean | readonly (string | number | boolean)[] | {
+    eq?: ParameterValue;
+    ne?: ParameterValue;
+    in?: readonly (string | number | boolean)[];
+    notIn?: readonly (string | number | boolean)[];
+    gt?: number;
+    gte?: number;
+    lt?: number;
+    lte?: number;
+    /** `true`: the value is truthy (non-zero, non-empty); `false`: falsy. */
+    truthy?: boolean;
+};
+/**
+ * When a field or group is shown. An object maps other parameter ids to tests, all of which
+ * must hold (`{ mode: 'advanced', count: { gte: 2 } }`); a function gets every value.
+ * Hidden fields keep their values.
+ */
+type ParameterCondition = {
+    readonly [id: string]: ParameterConditionTest;
+} | ((values: Readonly<ParameterValues>) => boolean);
+interface ParameterFieldBase<TValue extends ParameterValue> {
+    /** Unique id across the schema (also the key in `values`). */
+    id: string;
+    /** Display name (default: the id made readable, `flowSpeed` → "Flow speed"). */
+    label?: string;
+    /** Help text shown under the label and given to agents. */
+    description?: string;
+    default: TValue;
+    showIf?: ParameterCondition;
+    /** Include in `randomize()` (default `true`; image and text fields are never randomised). */
+    randomize?: boolean;
+    /** Shown but not editable from the panel (agents and code can still set it). */
+    readOnly?: boolean;
+}
+interface NumberParameterField extends ParameterFieldBase<number> {
+    type: 'number' | 'int';
+    min?: number;
+    max?: number;
+    /** Slider / spinner step (default: 1 for `int`, 1/100 of the range otherwise). */
+    step?: number;
+    /** Unit shown after the value (`px`, `%`, `°`, `ms`). */
+    unit?: string;
+    /** `slider` (slider plus number box; the default when `min` and `max` are set) or `input` (number box only). */
+    control?: 'slider' | 'input';
+    /** Decimal places shown (default: from `step`). */
+    decimals?: number;
+}
+interface BooleanParameterField extends ParameterFieldBase<boolean> {
+    type: 'boolean';
+}
+interface ParameterChoiceOption {
+    value: string | number;
+    label?: string;
+    description?: string;
+}
+interface ChoiceParameterField extends ParameterFieldBase<string | number> {
+    type: 'choice';
+    options: readonly (string | number | ParameterChoiceOption)[];
+    /** `select` (dropdown, the default) or `segmented` (buttons; best for 2–4 options). */
+    control?: 'select' | 'segmented';
+}
+interface ColorParameterField extends ParameterFieldBase<string> {
+    type: 'color';
+    /** Values carry alpha as `#rrggbbaa` (default `false`: `#rrggbb`). */
+    alpha?: boolean;
+    /** Colours offered as swatches. */
+    swatches?: readonly string[];
+}
+interface VectorParameterField extends ParameterFieldBase<number[]> {
+    type: 'vector';
+    /** Number of components, 2–4 (default: the default's length). */
+    size?: 2 | 3 | 4;
+    /** Bounds for every component, or one per component. */
+    min?: number | readonly number[];
+    max?: number | readonly number[];
+    step?: number;
+    unit?: string;
+    /** Component labels (default `x`, `y`, `z`, `w`). */
+    labels?: readonly string[];
+    decimals?: number;
+}
+interface ParameterImageOption {
+    url: string;
+    label?: string;
+}
+interface ImageParameterField extends ParameterFieldBase<string> {
+    type: 'image';
+    /** Suggested assets shown as thumbnails. */
+    options?: readonly ParameterImageOption[];
+    /** File types offered by the picker's file button, e.g. `image/*`. */
+    accept?: string;
+}
+interface TextParameterField extends ParameterFieldBase<string> {
+    type: 'text';
+    multiline?: boolean;
+    maxLength?: number;
+    minLength?: number;
+    /** Regular expression (unicode) the whole value must match. */
+    pattern?: string;
+    placeholder?: string;
+}
+type ParameterField = NumberParameterField | BooleanParameterField | ChoiceParameterField | ColorParameterField | VectorParameterField | ImageParameterField | TextParameterField;
+/** A collapsible group of fields (groups may nest). */
+interface ParameterGroup {
+    type: 'group';
+    /** Unique id (used for its collapsed state). */
+    id: string;
+    label?: string;
+    description?: string;
+    /** Starts collapsed (default `false`). */
+    collapsed?: boolean;
+    showIf?: ParameterCondition;
+    fields: readonly ParameterSchemaItem[];
+}
+type ParameterSchemaItem = ParameterField | ParameterGroup;
+/** A named set of values. Fields a preset leaves out go back to their defaults when applied. */
+interface ParameterPreset {
+    name: string;
+    values: Partial<ParameterValues>;
+    description?: string;
+    /** Comes from the schema: cannot be overwritten or deleted. */
+    builtIn?: boolean;
+}
+interface ParameterSchema {
+    title?: string;
+    fields: readonly ParameterSchemaItem[];
+    /** Built-in presets. */
+    presets?: readonly ParameterPreset[];
+}
+/** One error, shaped like `validateJsonSchema`'s: `path` is `/<id>` (or `/<id>/<index>`). */
+interface ParameterError {
+    path: string;
+    /** The parameter's id. */
+    id: string;
+    /** A sentence naming the field, e.g. "Speed must be at most 4." */
+    message: string;
+}
+/** Easing of a keyframe segment (the `AnimationEasing` of `@pixerate/editor/animation`). */
+type ParameterEasing = AnimationEasing;
+/** One keyframe, shaped like `AnimationKeyframe` from `@pixerate/editor/animation`. */
+interface ParameterKeyframe<TValue = ParameterValue> {
+    /** Time in milliseconds. */
+    time: number;
+    value: TValue;
+    /** Easing of the segment leaving this keyframe. */
+    easing?: ParameterEasing;
+}
+/** A parameter's keyframes, shaped like `AnimationTrack` from `@pixerate/editor/animation` (which it accepts). */
+interface ParameterTrack<TValue = ParameterValue> {
+    keyframes: ParameterKeyframe<TValue>[];
+    enabled?: boolean;
+}
+/**
+ * Where a parameter's keyframes live: an effect document, a canvas node, or
+ * `createParameterKeyframeStore()`. The controller reads and writes whole tracks so a
+ * keyframe toggle is one undo step.
+ */
+interface ParameterKeyframes {
+    getTrack(id: string): ParameterTrack<any> | undefined;
+    /** Replaces a track; `undefined` (or no keyframes) removes it. */
+    setTrack(id: string, track: ParameterTrack<any> | undefined): void;
+    /** Called when tracks change from outside the controller. */
+    subscribe?(listener: () => void): () => void;
+}
+/** `keyed`: a keyframe sits at the current time; `animated`: keyframes elsewhere; `none`. */
+type ParameterKeyState = 'none' | 'animated' | 'keyed';
+
+export type { BooleanParameterField as B, ChoiceParameterField as C, ImageParameterField as I, NumberParameterField as N, ParameterField as P, TextParameterField as T, VectorParameterField as V, ParameterValue as a, ParameterError as b, ParameterSchema as c, ParameterChoiceOption as d, ParameterCondition as e, ParameterValues as f, ParameterSchemaItem as g, ParameterGroup as h, ParameterKeyframes as i, ParameterTrack as j, ParameterKeyState as k, ParameterKeyframe as l, ParameterPreset as m, ColorParameterField as n, ParameterConditionTest as o, ParameterEasing as p, ParameterFieldType as q, ParameterImageOption as r };

package/dist/types-DMcf_z4J.d.cts

@@ -0,0 +1,185 @@
+import { b as AnimationEasing } from './easing-lM0Xo9Ni.cjs';
+
+/**
+ * Types for the schema-driven parameters editor: the control panel of an effect, shader,
+ * generator or component. A `ParameterSchema` lists fields (optionally in groups); a
+ * `ParametersController` holds their values with validation, undo, presets and keyframes.
+ */
+/** A parameter's value. `number` / `int`: a number; `boolean`; `choice`: an option value;
+ * `color`: `#rrggbb` (or `#rrggbbaa` with `alpha`); `vector`: 2–4 numbers; `image` / `text`: a string. */
+type ParameterValue = number | boolean | string | number[];
+/** Parameter id → value. */
+type ParameterValues = Record<string, ParameterValue>;
+type ParameterFieldType = 'number' | 'int' | 'boolean' | 'choice' | 'color' | 'vector' | 'image' | 'text';
+/**
+ * One test in a `showIf` condition: a literal (equal to), an array (one of), or an object
+ * whose keys must all hold.
+ */
+type ParameterConditionTest = string | number | boolean | readonly (string | number | boolean)[] | {
+    eq?: ParameterValue;
+    ne?: ParameterValue;
+    in?: readonly (string | number | boolean)[];
+    notIn?: readonly (string | number | boolean)[];
+    gt?: number;
+    gte?: number;
+    lt?: number;
+    lte?: number;
+    /** `true`: the value is truthy (non-zero, non-empty); `false`: falsy. */
+    truthy?: boolean;
+};
+/**
+ * When a field or group is shown. An object maps other parameter ids to tests, all of which
+ * must hold (`{ mode: 'advanced', count: { gte: 2 } }`); a function gets every value.
+ * Hidden fields keep their values.
+ */
+type ParameterCondition = {
+    readonly [id: string]: ParameterConditionTest;
+} | ((values: Readonly<ParameterValues>) => boolean);
+interface ParameterFieldBase<TValue extends ParameterValue> {
+    /** Unique id across the schema (also the key in `values`). */
+    id: string;
+    /** Display name (default: the id made readable, `flowSpeed` → "Flow speed"). */
+    label?: string;
+    /** Help text shown under the label and given to agents. */
+    description?: string;
+    default: TValue;
+    showIf?: ParameterCondition;
+    /** Include in `randomize()` (default `true`; image and text fields are never randomised). */
+    randomize?: boolean;
+    /** Shown but not editable from the panel (agents and code can still set it). */
+    readOnly?: boolean;
+}
+interface NumberParameterField extends ParameterFieldBase<number> {
+    type: 'number' | 'int';
+    min?: number;
+    max?: number;
+    /** Slider / spinner step (default: 1 for `int`, 1/100 of the range otherwise). */
+    step?: number;
+    /** Unit shown after the value (`px`, `%`, `°`, `ms`). */
+    unit?: string;
+    /** `slider` (slider plus number box; the default when `min` and `max` are set) or `input` (number box only). */
+    control?: 'slider' | 'input';
+    /** Decimal places shown (default: from `step`). */
+    decimals?: number;
+}
+interface BooleanParameterField extends ParameterFieldBase<boolean> {
+    type: 'boolean';
+}
+interface ParameterChoiceOption {
+    value: string | number;
+    label?: string;
+    description?: string;
+}
+interface ChoiceParameterField extends ParameterFieldBase<string | number> {
+    type: 'choice';
+    options: readonly (string | number | ParameterChoiceOption)[];
+    /** `select` (dropdown, the default) or `segmented` (buttons; best for 2–4 options). */
+    control?: 'select' | 'segmented';
+}
+interface ColorParameterField extends ParameterFieldBase<string> {
+    type: 'color';
+    /** Values carry alpha as `#rrggbbaa` (default `false`: `#rrggbb`). */
+    alpha?: boolean;
+    /** Colours offered as swatches. */
+    swatches?: readonly string[];
+}
+interface VectorParameterField extends ParameterFieldBase<number[]> {
+    type: 'vector';
+    /** Number of components, 2–4 (default: the default's length). */
+    size?: 2 | 3 | 4;
+    /** Bounds for every component, or one per component. */
+    min?: number | readonly number[];
+    max?: number | readonly number[];
+    step?: number;
+    unit?: string;
+    /** Component labels (default `x`, `y`, `z`, `w`). */
+    labels?: readonly string[];
+    decimals?: number;
+}
+interface ParameterImageOption {
+    url: string;
+    label?: string;
+}
+interface ImageParameterField extends ParameterFieldBase<string> {
+    type: 'image';
+    /** Suggested assets shown as thumbnails. */
+    options?: readonly ParameterImageOption[];
+    /** File types offered by the picker's file button, e.g. `image/*`. */
+    accept?: string;
+}
+interface TextParameterField extends ParameterFieldBase<string> {
+    type: 'text';
+    multiline?: boolean;
+    maxLength?: number;
+    minLength?: number;
+    /** Regular expression (unicode) the whole value must match. */
+    pattern?: string;
+    placeholder?: string;
+}
+type ParameterField = NumberParameterField | BooleanParameterField | ChoiceParameterField | ColorParameterField | VectorParameterField | ImageParameterField | TextParameterField;
+/** A collapsible group of fields (groups may nest). */
+interface ParameterGroup {
+    type: 'group';
+    /** Unique id (used for its collapsed state). */
+    id: string;
+    label?: string;
+    description?: string;
+    /** Starts collapsed (default `false`). */
+    collapsed?: boolean;
+    showIf?: ParameterCondition;
+    fields: readonly ParameterSchemaItem[];
+}
+type ParameterSchemaItem = ParameterField | ParameterGroup;
+/** A named set of values. Fields a preset leaves out go back to their defaults when applied. */
+interface ParameterPreset {
+    name: string;
+    values: Partial<ParameterValues>;
+    description?: string;
+    /** Comes from the schema: cannot be overwritten or deleted. */
+    builtIn?: boolean;
+}
+interface ParameterSchema {
+    title?: string;
+    fields: readonly ParameterSchemaItem[];
+    /** Built-in presets. */
+    presets?: readonly ParameterPreset[];
+}
+/** One error, shaped like `validateJsonSchema`'s: `path` is `/<id>` (or `/<id>/<index>`). */
+interface ParameterError {
+    path: string;
+    /** The parameter's id. */
+    id: string;
+    /** A sentence naming the field, e.g. "Speed must be at most 4." */
+    message: string;
+}
+/** Easing of a keyframe segment (the `AnimationEasing` of `@pixerate/editor/animation`). */
+type ParameterEasing = AnimationEasing;
+/** One keyframe, shaped like `AnimationKeyframe` from `@pixerate/editor/animation`. */
+interface ParameterKeyframe<TValue = ParameterValue> {
+    /** Time in milliseconds. */
+    time: number;
+    value: TValue;
+    /** Easing of the segment leaving this keyframe. */
+    easing?: ParameterEasing;
+}
+/** A parameter's keyframes, shaped like `AnimationTrack` from `@pixerate/editor/animation` (which it accepts). */
+interface ParameterTrack<TValue = ParameterValue> {
+    keyframes: ParameterKeyframe<TValue>[];
+    enabled?: boolean;
+}
+/**
+ * Where a parameter's keyframes live: an effect document, a canvas node, or
+ * `createParameterKeyframeStore()`. The controller reads and writes whole tracks so a
+ * keyframe toggle is one undo step.
+ */
+interface ParameterKeyframes {
+    getTrack(id: string): ParameterTrack<any> | undefined;
+    /** Replaces a track; `undefined` (or no keyframes) removes it. */
+    setTrack(id: string, track: ParameterTrack<any> | undefined): void;
+    /** Called when tracks change from outside the controller. */
+    subscribe?(listener: () => void): () => void;
+}
+/** `keyed`: a keyframe sits at the current time; `animated`: keyframes elsewhere; `none`. */
+type ParameterKeyState = 'none' | 'animated' | 'keyed';
+
+export type { BooleanParameterField as B, ChoiceParameterField as C, ImageParameterField as I, NumberParameterField as N, ParameterField as P, TextParameterField as T, VectorParameterField as V, ParameterValue as a, ParameterError as b, ParameterSchema as c, ParameterChoiceOption as d, ParameterCondition as e, ParameterValues as f, ParameterSchemaItem as g, ParameterGroup as h, ParameterKeyframes as i, ParameterTrack as j, ParameterKeyState as k, ParameterKeyframe as l, ParameterPreset as m, ColorParameterField as n, ParameterConditionTest as o, ParameterEasing as p, ParameterFieldType as q, ParameterImageOption as r };