@pixerate/editor 0.57.0 → 0.59.0

package/dist/chunk-ZCNLBRT6.cjs

@@ -0,0 +1,122 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/animation/behavior.ts
+var MOTION_BEHAVIORS = ["pulse", "oscillate", "wriggle", "overshoot"];
+var WRIGGLE_EDGE = 0.15;
+function wave(kind, angle) {
+  switch (kind) {
+    case "square":
+      return Math.sin(angle) >= 0 ? 1 : -1;
+    case "triangle":
+      return 2 / Math.PI * Math.asin(Math.sin(angle));
+    case "sawtooth": {
+      const norm = angle / (2 * Math.PI) % 1;
+      return 2 * (norm < 0 ? norm + 1 : norm) - 1;
+    }
+    default:
+      return Math.sin(angle);
+  }
+}
+function behaviorProgress(behavior, t, index = 0, ms = 800) {
+  const time = Math.max(0, t);
+  switch (behavior.type) {
+    case "pulse":
+      return 0.5 + 0.5 * Math.sin(2 * Math.PI * (_nullishCoalesce(behavior.count, () => ( 1))) * time - Math.PI / 2);
+    case "oscillate": {
+      const w = wave(behavior.wave, 2 * Math.PI * (_nullishCoalesce(behavior.count, () => ( 1))) * time);
+      const decay = _nullishCoalesce(behavior.decay, () => ( 0));
+      return decay > 0 ? w * Math.max(0, 1 - t) ** decay : w;
+    }
+    case "wriggle": {
+      const edge = quinticFade(Math.min(1, Math.max(0, Math.min(t, 1 - t) / WRIGGLE_EDGE)));
+      if (edge === 0) return 0;
+      return edge * fractalWiggle(_nullishCoalesce(behavior.frequency, () => ( 2)), 1, _nullishCoalesce(behavior.octaves, () => ( 2)), 0.5, t * ms / 1e3, _nullishCoalesce(behavior.seed, () => ( 42)), index);
+    }
+    case "overshoot": {
+      const p = Math.min(1, time);
+      if (p >= 1) return 1;
+      return 1 - Math.exp(-(_nullishCoalesce(behavior.damping, () => ( 4))) * p) * Math.cos((_nullishCoalesce(behavior.cycles, () => ( 3))) * Math.PI * p);
+    }
+  }
+}
+function isMotionBehavior(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const b = value;
+  const positive = (k) => b[k] === void 0 || typeof b[k] === "number" && Number.isFinite(b[k]) && b[k] > 0;
+  const atLeastZero = (k) => b[k] === void 0 || typeof b[k] === "number" && Number.isFinite(b[k]) && b[k] >= 0;
+  switch (b.type) {
+    case "pulse":
+      return positive("count");
+    case "oscillate":
+      return positive("count") && atLeastZero("decay") && (b.wave === void 0 || ["sine", "triangle", "square", "sawtooth"].includes(b.wave));
+    case "wriggle":
+      return positive("frequency") && positive("octaves") && (b.seed === void 0 || Number.isInteger(b.seed));
+    case "overshoot":
+      return positive("cycles") && atLeastZero("damping");
+    default:
+      return false;
+  }
+}
+function motionSeedFromId(id) {
+  let h = 2166136261;
+  for (let i = 0; i < id.length; i++) h = Math.imul(h ^ id.charCodeAt(i), 16777619);
+  return (h >>> 0) % 2147483647 || 1;
+}
+var GOLDEN_GAMMA = 0x9e3779b97f4a7c15n;
+var MULT1 = 0xbf58476d1ce4e5b9n;
+var MULT2 = 0x94d049bb133111ebn;
+var MASK64 = 0xffffffffffffffffn;
+var BASE_MIX = 0x2545f4914f6cdd1dn;
+var POW2_53 = 9007199254740992;
+function hash64(x) {
+  let v = x + GOLDEN_GAMMA & MASK64;
+  v = (v ^ v >> 30n) * MULT1 & MASK64;
+  v = (v ^ v >> 27n) * MULT2 & MASK64;
+  return (v ^ v >> 31n) & MASK64;
+}
+function mixSeeds(parts) {
+  let h = BASE_MIX;
+  for (const p of parts) {
+    const val = typeof p === "bigint" ? p : BigInt(Math.floor(p));
+    h = hash64(h ^ hash64(val & MASK64));
+  }
+  return h;
+}
+function unitFloat(seed) {
+  return Number(hash64(seed) >> 11n) / POW2_53;
+}
+function quinticFade(t) {
+  return t * t * t * (t * (t * 6 - 15) + 10);
+}
+function noise1d(seed, x) {
+  if (!Number.isFinite(x)) return 0;
+  const floorX = Math.floor(x);
+  const u = quinticFade(x - floorX);
+  const i = BigInt(floorX);
+  const a = unitFloat(seed ^ hash64(i & MASK64)) * 2 - 1;
+  const b = unitFloat(seed ^ hash64(i + 1n & MASK64)) * 2 - 1;
+  return a + (b - a) * u;
+}
+function fractalWiggle(freq, amp, octaves = 3, ampMult = 0.5, t = 0, seed = 42, dimension = 0) {
+  const oct = Math.max(1, Math.min(16, Math.floor(octaves)));
+  let currentAmp = amp;
+  let currentFreq = freq;
+  let sum = 0;
+  const baseSeed = BigInt(Math.floor(seed));
+  for (let k = 0; k < oct; k++) {
+    const s = mixSeeds([baseSeed, BigInt(dimension), BigInt(k)]);
+    const phaseOffset = unitFloat(s) * 1e3;
+    sum += currentAmp * noise1d(s, currentFreq * t + phaseOffset);
+    currentAmp *= ampMult;
+    currentFreq *= 2;
+  }
+  return sum;
+}
+
+
+
+
+
+
+
+
+exports.MOTION_BEHAVIORS = MOTION_BEHAVIORS; exports.behaviorProgress = behaviorProgress; exports.isMotionBehavior = isMotionBehavior; exports.motionSeedFromId = motionSeedFromId; exports.quinticFade = quinticFade; exports.fractalWiggle = fractalWiggle;
+//# sourceMappingURL=chunk-ZCNLBRT6.cjs.map

package/dist/chunk-ZCNLBRT6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/editor/editor/packages/core/dist/chunk-ZCNLBRT6.cjs","../src/animation/behavior.ts"],"names":[],"mappings":"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","file":"/home/runner/work/editor/editor/packages/core/dist/chunk-ZCNLBRT6.cjs","sourcesContent":[null,"/**\n * Behaviours: how a change gets from `from` to `to` other than straight along its ease (a\n * pulse there and back, an oscillation, a seeded wriggle, a springy overshoot). Ported from\n * `@pixerate/flair` (MIT): `SvgBehavior` and `behaviorProgress` in `vector/motion.ts`, the\n * oscillate and overshoot evaluators in `scene/behavior.ts` and the noise in `time/noise.ts`.\n * The numbers must stay identical to Flair's, so a behaviour exported to Flair plays the same\n * frames there as here (the animation editor writes them as Flair `behavior`s, Flair ≥ 0.38).\n */\n\n/**\n * A behaviour: its progress `u` at each moment, where 0 is `from`, 1 is `to`, and numbers go\n * past either. `t` is the change's time, 0–1, through its ease (linear unless given).\n *\n * - `pulse`: there and back `count` times (default 1): u = sin²(π·count·t).\n * - `oscillate`: swings round `from`, out to `to` and as far the other way, `count` times\n *   (default 1), dying away by (1 − t)^`decay` (default 0, no decay).\n * - `wriggle`: wanders round `from` by up to about `to − from`, as seeded smooth fractal noise\n *   at `frequency` Hz (default 2) with `octaves` layers (default 2); each number in a value\n *   wanders on its own channel. It eases out of and back to rest over the first and last 15%\n *   of its time. The same `seed` (default 42) gives the same wander.\n * - `overshoot`: goes to `to`, past it and back, settling like a spring:\n *   u = 1 − e^(−damping·t)·cos(cycles·π·t) (default 3 cycles, damping 4).\n */\nexport type MotionBehavior =\n\t| { type: 'pulse'; count?: number }\n\t| { type: 'oscillate'; count?: number; decay?: number; wave?: 'sine' | 'triangle' | 'square' | 'sawtooth' }\n\t| { type: 'wriggle'; frequency?: number; octaves?: number; seed?: number }\n\t| { type: 'overshoot'; cycles?: number; damping?: number };\n\n/** Every `MotionBehavior` type. */\nexport const MOTION_BEHAVIORS = ['pulse', 'oscillate', 'wriggle', 'overshoot'] as const;\n\n/** Share of a wriggle's time spent easing out of and back to rest, at each end. */\nconst WRIGGLE_EDGE = 0.15;\n\nfunction wave(kind: 'sine' | 'triangle' | 'square' | 'sawtooth' | undefined, angle: number): number {\n\tswitch (kind) {\n\t\tcase 'square':\n\t\t\treturn Math.sin(angle) >= 0 ? 1 : -1;\n\t\tcase 'triangle':\n\t\t\treturn (2 / Math.PI) * Math.asin(Math.sin(angle));\n\t\tcase 'sawtooth': {\n\t\t\tconst norm = (angle / (2 * Math.PI)) % 1;\n\t\t\treturn 2 * (norm < 0 ? norm + 1 : norm) - 1;\n\t\t}\n\t\tdefault:\n\t\t\treturn Math.sin(angle);\n\t}\n}\n\n/**\n * A behaviour's progress at `t` (0–1, eased) of a change lasting `ms`, for the `index`-th number\n * in a value (only a wriggle tells numbers apart).\n */\nexport function behaviorProgress(behavior: MotionBehavior, t: number, index = 0, ms = 800): number {\n\tconst time = Math.max(0, t);\n\tswitch (behavior.type) {\n\t\tcase 'pulse':\n\t\t\t// sin²(πct) = (1 − cos 2πct) / 2: written as Flair writes it, so the numbers match.\n\t\t\treturn 0.5 + 0.5 * Math.sin(2 * Math.PI * (behavior.count ?? 1) * time - Math.PI / 2);\n\t\tcase 'oscillate': {\n\t\t\tconst w = wave(behavior.wave, 2 * Math.PI * (behavior.count ?? 1) * time);\n\t\t\tconst decay = behavior.decay ?? 0;\n\t\t\treturn decay > 0 ? w * Math.max(0, 1 - t) ** decay : w;\n\t\t}\n\t\tcase 'wriggle': {\n\t\t\tconst edge = quinticFade(Math.min(1, Math.max(0, Math.min(t, 1 - t) / WRIGGLE_EDGE)));\n\t\t\tif (edge === 0) return 0;\n\t\t\treturn edge * fractalWiggle(behavior.frequency ?? 2, 1, behavior.octaves ?? 2, 0.5, (t * ms) / 1000, behavior.seed ?? 42, index);\n\t\t}\n\t\tcase 'overshoot': {\n\t\t\tconst p = Math.min(1, time);\n\t\t\tif (p >= 1) return 1;\n\t\t\treturn 1 - Math.exp(-(behavior.damping ?? 4) * p) * Math.cos((behavior.cycles ?? 3) * Math.PI * p);\n\t\t}\n\t}\n}\n\n/** Whether `value` is a well-formed `MotionBehavior`. */\nexport function isMotionBehavior(value: unknown): value is MotionBehavior {\n\tif (typeof value !== 'object' || value === null) return false;\n\tconst b = value as Record<string, unknown>;\n\tconst positive = (k: string) => b[k] === undefined || (typeof b[k] === 'number' && Number.isFinite(b[k]) && (b[k] as number) > 0);\n\tconst atLeastZero = (k: string) => b[k] === undefined || (typeof b[k] === 'number' && Number.isFinite(b[k]) && (b[k] as number) >= 0);\n\tswitch (b.type) {\n\t\tcase 'pulse':\n\t\t\treturn positive('count');\n\t\tcase 'oscillate':\n\t\t\treturn positive('count') && atLeastZero('decay') && (b.wave === undefined || ['sine', 'triangle', 'square', 'sawtooth'].includes(b.wave as string));\n\t\tcase 'wriggle':\n\t\t\treturn positive('frequency') && positive('octaves') && (b.seed === undefined || Number.isInteger(b.seed));\n\t\tcase 'overshoot':\n\t\t\treturn positive('cycles') && atLeastZero('damping');\n\t\tdefault:\n\t\t\treturn false;\n\t}\n}\n\n/** A seed from an id (FNV-1a), so each element wriggles its own way: Flair's `seedOf`. */\nexport function motionSeedFromId(id: string): number {\n\tlet h = 0x811c9dc5;\n\tfor (let i = 0; i < id.length; i++) h = Math.imul(h ^ id.charCodeAt(i), 0x01000193);\n\treturn (h >>> 0) % 2147483647 || 1;\n}\n\n// ── Noise (SplitMix64 hashing, quintic value noise), as Flair's `time/noise.ts` ─────────────\n\nconst GOLDEN_GAMMA = 0x9e3779b97f4a7c15n;\nconst MULT1 = 0xbf58476d1ce4e5b9n;\nconst MULT2 = 0x94d049bb133111ebn;\nconst MASK64 = 0xffffffffffffffffn;\nconst BASE_MIX = 0x2545f4914f6cdd1dn;\nconst POW2_53 = 9007199254740992;\n\nfunction hash64(x: bigint): bigint {\n\tlet v = (x + GOLDEN_GAMMA) & MASK64;\n\tv = ((v ^ (v >> 30n)) * MULT1) & MASK64;\n\tv = ((v ^ (v >> 27n)) * MULT2) & MASK64;\n\treturn (v ^ (v >> 31n)) & MASK64;\n}\n\nfunction mixSeeds(parts: (bigint | number)[]): bigint {\n\tlet h = BASE_MIX;\n\tfor (const p of parts) {\n\t\tconst val = typeof p === 'bigint' ? p : BigInt(Math.floor(p));\n\t\th = hash64(h ^ hash64(val & MASK64));\n\t}\n\treturn h;\n}\n\nfunction unitFloat(seed: bigint): number {\n\treturn Number(hash64(seed) >> 11n) / POW2_53;\n}\n\n/** 6t⁵ − 15t⁴ + 10t³: zero slope and curvature at 0 and 1. */\nexport function quinticFade(t: number): number {\n\treturn t * t * t * (t * (t * 6.0 - 15.0) + 10.0);\n}\n\nfunction noise1d(seed: bigint, x: number): number {\n\tif (!Number.isFinite(x)) return 0;\n\tconst floorX = Math.floor(x);\n\tconst u = quinticFade(x - floorX);\n\tconst i = BigInt(floorX);\n\tconst a = unitFloat(seed ^ hash64(i & MASK64)) * 2 - 1;\n\tconst b = unitFloat(seed ^ hash64((i + 1n) & MASK64)) * 2 - 1;\n\treturn a + (b - a) * u;\n}\n\n/**\n * Multi-octave smooth noise (After Effects' `wiggle`): the sum over `octaves` of\n * amp·ampMult^k · noise(freq·2^k·t), each octave and `dimension` seeded apart. `t` in seconds.\n */\nexport function fractalWiggle(freq: number, amp: number, octaves = 3, ampMult = 0.5, t = 0, seed = 42, dimension = 0): number {\n\tconst oct = Math.max(1, Math.min(16, Math.floor(octaves)));\n\tlet currentAmp = amp;\n\tlet currentFreq = freq;\n\tlet sum = 0;\n\tconst baseSeed = BigInt(Math.floor(seed));\n\tfor (let k = 0; k < oct; k++) {\n\t\tconst s = mixSeeds([baseSeed, BigInt(dimension), BigInt(k)]);\n\t\tconst phaseOffset = unitFloat(s) * 1000.0;\n\t\tsum += currentAmp * noise1d(s, currentFreq * t + phaseOffset);\n\t\tcurrentAmp *= ampMult;\n\t\tcurrentFreq *= 2.0;\n\t}\n\treturn sum;\n}\n"]}

package/dist/{easing-CNGk-W6d.d.ts → easing-lM0Xo9Ni.d.cts}

@@ -8,7 +8,7 @@
  * - `spring` is a damped spring settling on the next value (it may overshoot).
  */
 /** Named easing presets. */
-type AnimationEasingPreset = 'linear' | 'hold' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'ease-in-back' | 'ease-out-back' | 'ease-out-elastic' | 'ease-in-elastic' | 'ease-in-out-elastic' | 'elastic' | 'spring';
+type AnimationEasingPreset = 'linear' | 'hold' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'ease-in-back' | 'ease-out-back' | 'ease-out-elastic' | 'ease-in-elastic' | 'ease-in-out-elastic' | 'elastic' | 'spring' | 'spring-gentle' | 'spring-quick' | 'spring-bouncy' | 'spring-slow';
 interface CubicBezierEasing {
     type: 'cubic-bezier';
     x1: number;
@@ -43,6 +43,18 @@ declare const ANIMATION_EASING_PRESETS: readonly AnimationEasingPreset[];
 declare const ANIMATION_EASING_LABELS: Readonly<Record<AnimationEasingPreset, string>>;
 /** The CSS control points of the bezier presets (CSS Easing Functions Level 1 values for the CSS keywords). */
 declare const CUBIC_BEZIER_PRESETS: Readonly<Record<string, readonly [number, number, number, number]>>;
+/**
+ * Figma's named springs (mass 1): gentle 100 / 15, quick 300 / 20, bouncy 600 / 15, slow 80 / 20
+ * (stiffness / damping). Each plays until it settles (see `springSettleMs`).
+ */
+declare const SPRING_PRESETS: Readonly<Record<'spring-gentle' | 'spring-quick' | 'spring-bouncy' | 'spring-slow', Required<Omit<SpringEasing, 'type'>>>>;
+/**
+ * How long a spring takes to settle within 0.1% of its target, in ms (clamped to 50–10000):
+ * 6.9 / (ζ·ω₀) s when under-damped, else 9.2 / its slowest rate.
+ */
+declare function springSettleMs(spring: Omit<SpringEasing, 'type'>): number;
+/** The same curve run backwards in time (`1 − e(1 − u)`) for a cubic-bezier, or null for other easings. */
+declare function reverseCubicBezier(easing: AnimationEasing | string | undefined | null): CubicBezierEasing | null;
 /**
  * Normalised position for a parametric elastic oscillation curve (as used in Rive and Penner curves).
  * Amplitude controls the overshoot intensity; period controls the wave frequency across normalized progress `t` (0–1).
@@ -85,4 +97,4 @@ declare function easingToCss(easing: AnimationEasing | string | undefined | null
 /** Short label for an easing (a preset's label, or `Custom` / `Spring` / `Elastic`). */
 declare function easingLabel(easing: AnimationEasing | undefined | null): string;
 
-export { ANIMATION_EASING_LABELS as A, CUBIC_BEZIER_PRESETS as C, type ElasticEasing as E, type SpringEasing as S, ANIMATION_EASING_PRESETS as a, type AnimationEasing as b, type AnimationEasingPreset as c, type CubicBezierEasing as d, cubicBezierAt as e, easingFromInfluence as f, easingLabel as g, easingToCss as h, elasticAt as i, evaluateEasing as j, isAnimationEasing as k, parseCssEasing as p, resolveEasing as r, springAt as s };
+export { ANIMATION_EASING_LABELS as A, CUBIC_BEZIER_PRESETS as C, type ElasticEasing as E, SPRING_PRESETS as S, ANIMATION_EASING_PRESETS as a, type AnimationEasing as b, type AnimationEasingPreset as c, type CubicBezierEasing as d, type SpringEasing as e, cubicBezierAt as f, easingFromInfluence as g, easingLabel as h, easingToCss as i, elasticAt as j, evaluateEasing as k, isAnimationEasing as l, reverseCubicBezier as m, springSettleMs as n, parseCssEasing as p, resolveEasing as r, springAt as s };

package/dist/{easing-CNGk-W6d.d.cts → easing-lM0Xo9Ni.d.ts}

@@ -8,7 +8,7 @@
  * - `spring` is a damped spring settling on the next value (it may overshoot).
  */
 /** Named easing presets. */
-type AnimationEasingPreset = 'linear' | 'hold' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'ease-in-back' | 'ease-out-back' | 'ease-out-elastic' | 'ease-in-elastic' | 'ease-in-out-elastic' | 'elastic' | 'spring';
+type AnimationEasingPreset = 'linear' | 'hold' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out' | 'ease-in-back' | 'ease-out-back' | 'ease-out-elastic' | 'ease-in-elastic' | 'ease-in-out-elastic' | 'elastic' | 'spring' | 'spring-gentle' | 'spring-quick' | 'spring-bouncy' | 'spring-slow';
 interface CubicBezierEasing {
     type: 'cubic-bezier';
     x1: number;
@@ -43,6 +43,18 @@ declare const ANIMATION_EASING_PRESETS: readonly AnimationEasingPreset[];
 declare const ANIMATION_EASING_LABELS: Readonly<Record<AnimationEasingPreset, string>>;
 /** The CSS control points of the bezier presets (CSS Easing Functions Level 1 values for the CSS keywords). */
 declare const CUBIC_BEZIER_PRESETS: Readonly<Record<string, readonly [number, number, number, number]>>;
+/**
+ * Figma's named springs (mass 1): gentle 100 / 15, quick 300 / 20, bouncy 600 / 15, slow 80 / 20
+ * (stiffness / damping). Each plays until it settles (see `springSettleMs`).
+ */
+declare const SPRING_PRESETS: Readonly<Record<'spring-gentle' | 'spring-quick' | 'spring-bouncy' | 'spring-slow', Required<Omit<SpringEasing, 'type'>>>>;
+/**
+ * How long a spring takes to settle within 0.1% of its target, in ms (clamped to 50–10000):
+ * 6.9 / (ζ·ω₀) s when under-damped, else 9.2 / its slowest rate.
+ */
+declare function springSettleMs(spring: Omit<SpringEasing, 'type'>): number;
+/** The same curve run backwards in time (`1 − e(1 − u)`) for a cubic-bezier, or null for other easings. */
+declare function reverseCubicBezier(easing: AnimationEasing | string | undefined | null): CubicBezierEasing | null;
 /**
  * Normalised position for a parametric elastic oscillation curve (as used in Rive and Penner curves).
  * Amplitude controls the overshoot intensity; period controls the wave frequency across normalized progress `t` (0–1).
@@ -85,4 +97,4 @@ declare function easingToCss(easing: AnimationEasing | string | undefined | null
 /** Short label for an easing (a preset's label, or `Custom` / `Spring` / `Elastic`). */
 declare function easingLabel(easing: AnimationEasing | undefined | null): string;
 
-export { ANIMATION_EASING_LABELS as A, CUBIC_BEZIER_PRESETS as C, type ElasticEasing as E, type SpringEasing as S, ANIMATION_EASING_PRESETS as a, type AnimationEasing as b, type AnimationEasingPreset as c, type CubicBezierEasing as d, cubicBezierAt as e, easingFromInfluence as f, easingLabel as g, easingToCss as h, elasticAt as i, evaluateEasing as j, isAnimationEasing as k, parseCssEasing as p, resolveEasing as r, springAt as s };
+export { ANIMATION_EASING_LABELS as A, CUBIC_BEZIER_PRESETS as C, type ElasticEasing as E, SPRING_PRESETS as S, ANIMATION_EASING_PRESETS as a, type AnimationEasing as b, type AnimationEasingPreset as c, type CubicBezierEasing as d, type SpringEasing as e, cubicBezierAt as f, easingFromInfluence as g, easingLabel as h, easingToCss as i, elasticAt as j, evaluateEasing as k, isAnimationEasing as l, reverseCubicBezier as m, springSettleMs as n, parseCssEasing as p, resolveEasing as r, springAt as s };

package/dist/parameters/index.cjs

@@ -3,7 +3,7 @@
 var _chunkQKLRAA4Tcjs = require('../chunk-QKLRAA4T.cjs');
 
 
-var _chunkXZ4L3R4Kcjs = require('../chunk-XZ4L3R4K.cjs');
+var _chunk2FHLHZALcjs = require('../chunk-2FHLHZAL.cjs');
 
 // src/parameters/schema.ts
 function humanizeParameterId(id) {
@@ -1259,7 +1259,7 @@ function createRangeMapper(options = {}) {
       if (typeof easing === "function") {
         progress = easing(normalized);
       } else {
-        progress = _chunkXZ4L3R4Kcjs.evaluateEasing.call(void 0, easing, normalized);
+        progress = _chunk2FHLHZALcjs.evaluateEasing.call(void 0, easing, normalized);
       }
     }
     return outMin + progress * outSpan;

package/dist/parameters/index.d.cts

@@ -1,4 +1,4 @@
-import { b as AnimationEasing } from '../easing-CNGk-W6d.cjs';
+import { b as AnimationEasing } from '../easing-lM0Xo9Ni.cjs';
 import { J as JsonSchema } from '../schema-Di0CS6Pe.cjs';
 import { H as HistoryManager } from '../HistoryManager-DeQQMBCj.cjs';
 import { C as CommandSpec } from '../registry-CaR7LC6W.cjs';

package/dist/parameters/index.d.ts

@@ -1,4 +1,4 @@
-import { b as AnimationEasing } from '../easing-CNGk-W6d.js';
+import { b as AnimationEasing } from '../easing-lM0Xo9Ni.js';
 import { J as JsonSchema } from '../schema-Di0CS6Pe.js';
 import { H as HistoryManager } from '../HistoryManager-DWSLd6Tf.js';
 import { C as CommandSpec } from '../registry-rVtFJjRM.js';

package/dist/parameters/index.js

@@ -3,7 +3,7 @@ import {
 } from "../chunk-QVZZGT4X.js";
 import {
   evaluateEasing
-} from "../chunk-UB2OY7FD.js";
+} from "../chunk-AGR4P4UZ.js";
 
 // src/parameters/schema.ts
 function humanizeParameterId(id) {

package/dist/{player-W-5DX3Go.d.ts → player-DV4Jujdq.d.ts}

@@ -1,4 +1,4 @@
-import { b as AnimationEasing } from './easing-CNGk-W6d.js';
+import { b as AnimationEasing } from './easing-lM0Xo9Ni.js';
 
 /**
  * Keyframe tracks, independent of what they animate: each track is a list of keyframes

package/dist/{player-Dg0FT0UI.d.cts → player-DrcP2xqj.d.cts}

@@ -1,4 +1,4 @@
-import { b as AnimationEasing } from './easing-CNGk-W6d.cjs';
+import { b as AnimationEasing } from './easing-lM0Xo9Ni.cjs';
 
 /**
  * Keyframe tracks, independent of what they animate: each track is a list of keyframes

package/dist/{svg-CPK82TtU.d.ts → svg-Dh17jCyA.d.ts}

@@ -780,6 +780,27 @@ interface VectorSvgExportOptions {
      * one filled path of the area the stroke paints.
      */
     strokes?: 'clip' | 'outline';
+    /**
+     * Groups to write round nodes, by node id, outermost first: to move a node from outside it
+     * or clip it (the animation editor's reveals and its Flair export use this).
+     */
+    wrap?: Readonly<Record<string, readonly VectorSvgWrapper[]>>;
+}
+/** A group written round a node (see `VectorSvgExportOptions.wrap`). */
+interface VectorSvgWrapper {
+    id?: string;
+    /** An SVG `transform` attribute. */
+    transform?: string;
+    /**
+     * Clips the group through a rect (`x`, `y`, `width`, `height`) or circle (`cx`, `cy`, `r`) in
+     * the units of the group's own box (`clipPathUnits="objectBoundingBox"`: 0–1 across it).
+     */
+    clip?: {
+        id: string;
+        shape: 'rect' | 'circle';
+        shapeId?: string;
+        attrs: Readonly<Record<string, number>>;
+    };
 }
 /** `data-vector-corners`: the live corners of subpaths as `subpath.index:radius[:kind]`, space separated. */
 declare function vectorCornersAttribute(subpaths: readonly VectorSubpath[], precision?: number): string;
@@ -844,4 +865,4 @@ declare function parseSvgTransform(value: string | undefined): AffineMatrix;
 /** Parses SVG markup into a vector document. Throws when there is no `<svg>` element. */
 declare function parseVectorSvg(svg: string, options?: VectorSvgImportOptions): VectorDocument;
 
-export { VECTOR_BLEND_SPACINGS as $, type VectorDefaults as A, type VectorStyle as B, type VectorHandleRef as C, type VectorSegmentRef as D, type VectorBlendOptions as E, type VectorModifiers as F, type VectorGradientPatch as G, type VectorAlign as H, type VectorDistribute as I, type VectorArrange as J, type VectorAverageAxis as K, type VectorArrowhead as L, type VectorBlendSpacing as M, type VectorGradientInterpolation as N, type VectorGradientSpread as O, type VectorGradientType as P, type VectorStrokeAlign as Q, type VectorStrokeGradientMode as R, type VectorRenderStrokeParts as S, type VectorPaintDef as T, type VectorArrowAlign as U, type VectorDocument as V, type VectorBlend as W, type VectorMergeMode as X, type VectorLineJoin as Y, type VectorWarpStyle as Z, VECTOR_ARROWHEADS as _, type VectorNode as a, vectorGradientFocalParam as a$, VECTOR_CORNER_KINDS as a0, VECTOR_EFFECT_TYPES as a1, VECTOR_GRADIENT_INTERPOLATIONS as a2, VECTOR_GRADIENT_MAX_PERIODS as a3, VECTOR_GRADIENT_MIN_STOPS as a4, VECTOR_GRADIENT_SPREADS as a5, VECTOR_GRADIENT_TYPES as a6, VECTOR_MERGE_MODES as a7, VECTOR_PATHFINDER_OPERATIONS as a8, VECTOR_STROKE_GRADIENT_MODES as a9, mapVectorGradient as aA, mapVectorPaint as aB, moveVectorGradientHandle as aC, moveVectorGradientStop as aD, parseSvgTransform as aE, parseVectorColor as aF, parseVectorSvg as aG, patternAttrs as aH, periodicVectorGradientStops as aI, pinVectorGradient as aJ, removeVectorGradientStop as aK, reverseVectorGradient as aL, samplePlainStops as aM, sampleVectorGradient as aN, sampleVectorGradientAt as aO, sampleVectorPaintDefAt as aP, sanitizeVectorGradient as aQ, setVectorGradientVector as aR, sortedVectorGradientStops as aS, spanVectorGradientStops as aT, transformVectorGradient as aU, transformVectorPaint as aV, vectorBoxMatrix as aW, vectorCornersAttribute as aX, vectorDocumentToSvg as aY, vectorGradientArea as aZ, vectorGradientAspect as a_, VECTOR_TOOLS as aa, VECTOR_TRANSFORM_HANDLES as ab, type VectorCorner as ac, type VectorGradientPoints as ad, type VectorGradientRamp as ae, type VectorGradientSvgOptions as af, type VectorGradientUnits as ag, type VectorLineCap as ah, type VectorMatrix as ai, type VectorPaintSvgOptions as aj, type VectorRgba as ak, type VectorSvgImportOptions as al, type VectorSvgPatternDef as am, applyVectorCornersAttribute as an, applyVectorGradientPatch as ao, applyVectorGradientSpread as ap, convertVectorGradient as aq, defaultVectorGradient as ar, expandVectorGradientSpread as as, expandVectorGradientStops as at, explicitVectorGradient as au, gradientMidpointRemap as av, hasExplicitGradientGeometry as aw, insertVectorGradientStop as ax, isCentredVectorGradient as ay, isVectorGradient as az, type VectorBounds as b, vectorGradientHandles as b0, vectorGradientMatrix as b1, vectorGradientMidpointFromPosition as b2, vectorGradientMidpointPosition as b3, vectorGradientNeedsExpansion as b4, vectorGradientParam as b5, vectorGradientPoints as b6, vectorGradientRamp as b7, vectorGradientSvgDefs as b8, vectorGradientTAt as b9, vectorGradientUnitsMatrix as ba, vectorPaintToSvg as bb, vectorPathLocalBounds as bc, vectorStrokeSvgParts as bd, widthProfileFromAttribute as be, widthProfileToAttribute as bf, type VectorSvgExportOptions as c, type Vec2 as d, type VectorSubpath as e, type VectorAnchor as f, type VectorPathNode as g, type VectorAnchorType as h, type VectorPaint as i, type VectorGroupNode as j, type VectorCornerKind as k, type VectorWidthPoint as l, type VectorGradientHandle as m, type VectorGradient as n, type VectorGradientStop as o, type VectorViewport as p, type VectorEffectType as q, type VectorEffectParamsMap as r, type VectorFillRule as s, type VectorBooleanOperation as t, type VectorEffect as u, type VectorWarpMesh as v, type VectorTransformHandle as w, type VectorAnchorRef as x, type VectorPathfinderOperation as y, type VectorTool as z };
+export { VECTOR_BLEND_SPACINGS as $, type VectorDefaults as A, type VectorStyle as B, type VectorHandleRef as C, type VectorSegmentRef as D, type VectorBlendOptions as E, type VectorModifiers as F, type VectorGradientPatch as G, type VectorAlign as H, type VectorDistribute as I, type VectorArrange as J, type VectorAverageAxis as K, type VectorArrowhead as L, type VectorBlendSpacing as M, type VectorGradientInterpolation as N, type VectorGradientSpread as O, type VectorGradientType as P, type VectorStrokeAlign as Q, type VectorStrokeGradientMode as R, type VectorRenderStrokeParts as S, type VectorPaintDef as T, type VectorArrowAlign as U, type VectorDocument as V, type VectorBlend as W, type VectorMergeMode as X, type VectorLineJoin as Y, type VectorWarpStyle as Z, VECTOR_ARROWHEADS as _, type VectorNode as a, vectorGradientAspect as a$, VECTOR_CORNER_KINDS as a0, VECTOR_EFFECT_TYPES as a1, VECTOR_GRADIENT_INTERPOLATIONS as a2, VECTOR_GRADIENT_MAX_PERIODS as a3, VECTOR_GRADIENT_MIN_STOPS as a4, VECTOR_GRADIENT_SPREADS as a5, VECTOR_GRADIENT_TYPES as a6, VECTOR_MERGE_MODES as a7, VECTOR_PATHFINDER_OPERATIONS as a8, VECTOR_STROKE_GRADIENT_MODES as a9, isVectorGradient as aA, mapVectorGradient as aB, mapVectorPaint as aC, moveVectorGradientHandle as aD, moveVectorGradientStop as aE, parseSvgTransform as aF, parseVectorColor as aG, parseVectorSvg as aH, patternAttrs as aI, periodicVectorGradientStops as aJ, pinVectorGradient as aK, removeVectorGradientStop as aL, reverseVectorGradient as aM, samplePlainStops as aN, sampleVectorGradient as aO, sampleVectorGradientAt as aP, sampleVectorPaintDefAt as aQ, sanitizeVectorGradient as aR, setVectorGradientVector as aS, sortedVectorGradientStops as aT, spanVectorGradientStops as aU, transformVectorGradient as aV, transformVectorPaint as aW, vectorBoxMatrix as aX, vectorCornersAttribute as aY, vectorDocumentToSvg as aZ, vectorGradientArea as a_, VECTOR_TOOLS as aa, VECTOR_TRANSFORM_HANDLES as ab, type VectorCorner as ac, type VectorGradientPoints as ad, type VectorGradientRamp as ae, type VectorGradientSvgOptions as af, type VectorGradientUnits as ag, type VectorLineCap as ah, type VectorMatrix as ai, type VectorPaintSvgOptions as aj, type VectorRgba as ak, type VectorSvgImportOptions as al, type VectorSvgPatternDef as am, type VectorSvgWrapper as an, applyVectorCornersAttribute as ao, applyVectorGradientPatch as ap, applyVectorGradientSpread as aq, convertVectorGradient as ar, defaultVectorGradient as as, expandVectorGradientSpread as at, expandVectorGradientStops as au, explicitVectorGradient as av, gradientMidpointRemap as aw, hasExplicitGradientGeometry as ax, insertVectorGradientStop as ay, isCentredVectorGradient as az, type VectorBounds as b, vectorGradientFocalParam as b0, vectorGradientHandles as b1, vectorGradientMatrix as b2, vectorGradientMidpointFromPosition as b3, vectorGradientMidpointPosition as b4, vectorGradientNeedsExpansion as b5, vectorGradientParam as b6, vectorGradientPoints as b7, vectorGradientRamp as b8, vectorGradientSvgDefs as b9, vectorGradientTAt as ba, vectorGradientUnitsMatrix as bb, vectorPaintToSvg as bc, vectorPathLocalBounds as bd, vectorStrokeSvgParts as be, widthProfileFromAttribute as bf, widthProfileToAttribute as bg, type VectorSvgExportOptions as c, type Vec2 as d, type VectorSubpath as e, type VectorAnchor as f, type VectorPathNode as g, type VectorAnchorType as h, type VectorPaint as i, type VectorGroupNode as j, type VectorCornerKind as k, type VectorWidthPoint as l, type VectorGradientHandle as m, type VectorGradient as n, type VectorGradientStop as o, type VectorViewport as p, type VectorEffectType as q, type VectorEffectParamsMap as r, type VectorFillRule as s, type VectorBooleanOperation as t, type VectorEffect as u, type VectorWarpMesh as v, type VectorTransformHandle as w, type VectorAnchorRef as x, type VectorPathfinderOperation as y, type VectorTool as z };

package/dist/{svg-CLg2zqZA.d.cts → svg-ymShkNtu.d.cts}

@@ -780,6 +780,27 @@ interface VectorSvgExportOptions {
      * one filled path of the area the stroke paints.
      */
     strokes?: 'clip' | 'outline';
+    /**
+     * Groups to write round nodes, by node id, outermost first: to move a node from outside it
+     * or clip it (the animation editor's reveals and its Flair export use this).
+     */
+    wrap?: Readonly<Record<string, readonly VectorSvgWrapper[]>>;
+}
+/** A group written round a node (see `VectorSvgExportOptions.wrap`). */
+interface VectorSvgWrapper {
+    id?: string;
+    /** An SVG `transform` attribute. */
+    transform?: string;
+    /**
+     * Clips the group through a rect (`x`, `y`, `width`, `height`) or circle (`cx`, `cy`, `r`) in
+     * the units of the group's own box (`clipPathUnits="objectBoundingBox"`: 0–1 across it).
+     */
+    clip?: {
+        id: string;
+        shape: 'rect' | 'circle';
+        shapeId?: string;
+        attrs: Readonly<Record<string, number>>;
+    };
 }
 /** `data-vector-corners`: the live corners of subpaths as `subpath.index:radius[:kind]`, space separated. */
 declare function vectorCornersAttribute(subpaths: readonly VectorSubpath[], precision?: number): string;
@@ -844,4 +865,4 @@ declare function parseSvgTransform(value: string | undefined): AffineMatrix;
 /** Parses SVG markup into a vector document. Throws when there is no `<svg>` element. */
 declare function parseVectorSvg(svg: string, options?: VectorSvgImportOptions): VectorDocument;
 
-export { VECTOR_BLEND_SPACINGS as $, type VectorDefaults as A, type VectorStyle as B, type VectorHandleRef as C, type VectorSegmentRef as D, type VectorBlendOptions as E, type VectorModifiers as F, type VectorGradientPatch as G, type VectorAlign as H, type VectorDistribute as I, type VectorArrange as J, type VectorAverageAxis as K, type VectorArrowhead as L, type VectorBlendSpacing as M, type VectorGradientInterpolation as N, type VectorGradientSpread as O, type VectorGradientType as P, type VectorStrokeAlign as Q, type VectorStrokeGradientMode as R, type VectorRenderStrokeParts as S, type VectorPaintDef as T, type VectorArrowAlign as U, type VectorDocument as V, type VectorBlend as W, type VectorMergeMode as X, type VectorLineJoin as Y, type VectorWarpStyle as Z, VECTOR_ARROWHEADS as _, type VectorNode as a, vectorGradientFocalParam as a$, VECTOR_CORNER_KINDS as a0, VECTOR_EFFECT_TYPES as a1, VECTOR_GRADIENT_INTERPOLATIONS as a2, VECTOR_GRADIENT_MAX_PERIODS as a3, VECTOR_GRADIENT_MIN_STOPS as a4, VECTOR_GRADIENT_SPREADS as a5, VECTOR_GRADIENT_TYPES as a6, VECTOR_MERGE_MODES as a7, VECTOR_PATHFINDER_OPERATIONS as a8, VECTOR_STROKE_GRADIENT_MODES as a9, mapVectorGradient as aA, mapVectorPaint as aB, moveVectorGradientHandle as aC, moveVectorGradientStop as aD, parseSvgTransform as aE, parseVectorColor as aF, parseVectorSvg as aG, patternAttrs as aH, periodicVectorGradientStops as aI, pinVectorGradient as aJ, removeVectorGradientStop as aK, reverseVectorGradient as aL, samplePlainStops as aM, sampleVectorGradient as aN, sampleVectorGradientAt as aO, sampleVectorPaintDefAt as aP, sanitizeVectorGradient as aQ, setVectorGradientVector as aR, sortedVectorGradientStops as aS, spanVectorGradientStops as aT, transformVectorGradient as aU, transformVectorPaint as aV, vectorBoxMatrix as aW, vectorCornersAttribute as aX, vectorDocumentToSvg as aY, vectorGradientArea as aZ, vectorGradientAspect as a_, VECTOR_TOOLS as aa, VECTOR_TRANSFORM_HANDLES as ab, type VectorCorner as ac, type VectorGradientPoints as ad, type VectorGradientRamp as ae, type VectorGradientSvgOptions as af, type VectorGradientUnits as ag, type VectorLineCap as ah, type VectorMatrix as ai, type VectorPaintSvgOptions as aj, type VectorRgba as ak, type VectorSvgImportOptions as al, type VectorSvgPatternDef as am, applyVectorCornersAttribute as an, applyVectorGradientPatch as ao, applyVectorGradientSpread as ap, convertVectorGradient as aq, defaultVectorGradient as ar, expandVectorGradientSpread as as, expandVectorGradientStops as at, explicitVectorGradient as au, gradientMidpointRemap as av, hasExplicitGradientGeometry as aw, insertVectorGradientStop as ax, isCentredVectorGradient as ay, isVectorGradient as az, type VectorBounds as b, vectorGradientHandles as b0, vectorGradientMatrix as b1, vectorGradientMidpointFromPosition as b2, vectorGradientMidpointPosition as b3, vectorGradientNeedsExpansion as b4, vectorGradientParam as b5, vectorGradientPoints as b6, vectorGradientRamp as b7, vectorGradientSvgDefs as b8, vectorGradientTAt as b9, vectorGradientUnitsMatrix as ba, vectorPaintToSvg as bb, vectorPathLocalBounds as bc, vectorStrokeSvgParts as bd, widthProfileFromAttribute as be, widthProfileToAttribute as bf, type VectorSvgExportOptions as c, type Vec2 as d, type VectorSubpath as e, type VectorAnchor as f, type VectorPathNode as g, type VectorAnchorType as h, type VectorPaint as i, type VectorGroupNode as j, type VectorCornerKind as k, type VectorWidthPoint as l, type VectorGradientHandle as m, type VectorGradient as n, type VectorGradientStop as o, type VectorViewport as p, type VectorEffectType as q, type VectorEffectParamsMap as r, type VectorFillRule as s, type VectorBooleanOperation as t, type VectorEffect as u, type VectorWarpMesh as v, type VectorTransformHandle as w, type VectorAnchorRef as x, type VectorPathfinderOperation as y, type VectorTool as z };
+export { VECTOR_BLEND_SPACINGS as $, type VectorDefaults as A, type VectorStyle as B, type VectorHandleRef as C, type VectorSegmentRef as D, type VectorBlendOptions as E, type VectorModifiers as F, type VectorGradientPatch as G, type VectorAlign as H, type VectorDistribute as I, type VectorArrange as J, type VectorAverageAxis as K, type VectorArrowhead as L, type VectorBlendSpacing as M, type VectorGradientInterpolation as N, type VectorGradientSpread as O, type VectorGradientType as P, type VectorStrokeAlign as Q, type VectorStrokeGradientMode as R, type VectorRenderStrokeParts as S, type VectorPaintDef as T, type VectorArrowAlign as U, type VectorDocument as V, type VectorBlend as W, type VectorMergeMode as X, type VectorLineJoin as Y, type VectorWarpStyle as Z, VECTOR_ARROWHEADS as _, type VectorNode as a, vectorGradientAspect as a$, VECTOR_CORNER_KINDS as a0, VECTOR_EFFECT_TYPES as a1, VECTOR_GRADIENT_INTERPOLATIONS as a2, VECTOR_GRADIENT_MAX_PERIODS as a3, VECTOR_GRADIENT_MIN_STOPS as a4, VECTOR_GRADIENT_SPREADS as a5, VECTOR_GRADIENT_TYPES as a6, VECTOR_MERGE_MODES as a7, VECTOR_PATHFINDER_OPERATIONS as a8, VECTOR_STROKE_GRADIENT_MODES as a9, isVectorGradient as aA, mapVectorGradient as aB, mapVectorPaint as aC, moveVectorGradientHandle as aD, moveVectorGradientStop as aE, parseSvgTransform as aF, parseVectorColor as aG, parseVectorSvg as aH, patternAttrs as aI, periodicVectorGradientStops as aJ, pinVectorGradient as aK, removeVectorGradientStop as aL, reverseVectorGradient as aM, samplePlainStops as aN, sampleVectorGradient as aO, sampleVectorGradientAt as aP, sampleVectorPaintDefAt as aQ, sanitizeVectorGradient as aR, setVectorGradientVector as aS, sortedVectorGradientStops as aT, spanVectorGradientStops as aU, transformVectorGradient as aV, transformVectorPaint as aW, vectorBoxMatrix as aX, vectorCornersAttribute as aY, vectorDocumentToSvg as aZ, vectorGradientArea as a_, VECTOR_TOOLS as aa, VECTOR_TRANSFORM_HANDLES as ab, type VectorCorner as ac, type VectorGradientPoints as ad, type VectorGradientRamp as ae, type VectorGradientSvgOptions as af, type VectorGradientUnits as ag, type VectorLineCap as ah, type VectorMatrix as ai, type VectorPaintSvgOptions as aj, type VectorRgba as ak, type VectorSvgImportOptions as al, type VectorSvgPatternDef as am, type VectorSvgWrapper as an, applyVectorCornersAttribute as ao, applyVectorGradientPatch as ap, applyVectorGradientSpread as aq, convertVectorGradient as ar, defaultVectorGradient as as, expandVectorGradientSpread as at, expandVectorGradientStops as au, explicitVectorGradient as av, gradientMidpointRemap as aw, hasExplicitGradientGeometry as ax, insertVectorGradientStop as ay, isCentredVectorGradient as az, type VectorBounds as b, vectorGradientFocalParam as b0, vectorGradientHandles as b1, vectorGradientMatrix as b2, vectorGradientMidpointFromPosition as b3, vectorGradientMidpointPosition as b4, vectorGradientNeedsExpansion as b5, vectorGradientParam as b6, vectorGradientPoints as b7, vectorGradientRamp as b8, vectorGradientSvgDefs as b9, vectorGradientTAt as ba, vectorGradientUnitsMatrix as bb, vectorPaintToSvg as bc, vectorPathLocalBounds as bd, vectorStrokeSvgParts as be, widthProfileFromAttribute as bf, widthProfileToAttribute as bg, type VectorSvgExportOptions as c, type Vec2 as d, type VectorSubpath as e, type VectorAnchor as f, type VectorPathNode as g, type VectorAnchorType as h, type VectorPaint as i, type VectorGroupNode as j, type VectorCornerKind as k, type VectorWidthPoint as l, type VectorGradientHandle as m, type VectorGradient as n, type VectorGradientStop as o, type VectorViewport as p, type VectorEffectType as q, type VectorEffectParamsMap as r, type VectorFillRule as s, type VectorBooleanOperation as t, type VectorEffect as u, type VectorWarpMesh as v, type VectorTransformHandle as w, type VectorAnchorRef as x, type VectorPathfinderOperation as y, type VectorTool as z };