@clipkit/runtime 1.0.0

package/dist/animation/expr.js

@@ -0,0 +1,236 @@
+// Tier-A expression evaluator (CKP/1.0 — see EXPRESSIONS-PLAN.md / PROTOCOL.md).
+//
+// A numeric property may be `{ expr: "<formula>" }` — a PURE function of the
+// element's local time `t` and its own index/params (`i`, `n`, `dur`, `value`).
+// No element references, no runtime inputs: it is deterministic across renderers,
+// bakeable to keyframes, and GPU-shaped.
+//
+// This is a real sandbox — a tokenizer + Pratt parser + tree-walk evaluator,
+// NOT eval()/Function(). It accepts ONLY the closed grammar below; an unknown
+// identifier, member access, assignment, statement, or string is a parse error,
+// and the caller falls back to the property's base value. There are no host
+// objects in scope and no loops, so evaluation is bounded and non-recursive.
+import { EXPR_VOCABULARY } from '@clipkit/protocol';
+import { noise1d, hash01 } from './noise1d.js';
+const CONSTS = { PI: Math.PI, TAU: Math.PI * 2, E: Math.E };
+// The variable set is the protocol vocabulary verbatim (single source of truth).
+const VARS = new Set(EXPR_VOCABULARY.vars);
+// Native functions: (args, scope) → number. Pure; `wiggle` reads scope.t.
+const FNS = {
+    sin: (a) => Math.sin(a[0]), cos: (a) => Math.cos(a[0]), tan: (a) => Math.tan(a[0]),
+    asin: (a) => Math.asin(a[0]), acos: (a) => Math.acos(a[0]), atan: (a) => Math.atan(a[0]),
+    atan2: (a) => Math.atan2(a[0], a[1]), sinh: (a) => Math.sinh(a[0]), cosh: (a) => Math.cosh(a[0]), tanh: (a) => Math.tanh(a[0]),
+    abs: (a) => Math.abs(a[0]), sign: (a) => Math.sign(a[0]), sqrt: (a) => Math.sqrt(a[0]), cbrt: (a) => Math.cbrt(a[0]),
+    pow: (a) => Math.pow(a[0], a[1]), exp: (a) => Math.exp(a[0]), log: (a) => Math.log(a[0]), log2: (a) => Math.log2(a[0]),
+    floor: (a) => Math.floor(a[0]), ceil: (a) => Math.ceil(a[0]), round: (a) => Math.round(a[0]), trunc: (a) => Math.trunc(a[0]),
+    fract: (a) => a[0] - Math.floor(a[0]), hypot: (a) => Math.hypot(...a),
+    min: (a) => Math.min(...a), max: (a) => Math.max(...a), mod: (a) => ((a[0] % a[1]) + a[1]) % a[1],
+    clamp: (a) => Math.min(Math.max(a[0], a[1]), a[2]),
+    lerp: (a) => a[0] + (a[1] - a[0]) * a[2],
+    mix: (a) => a[0] + (a[1] - a[0]) * a[2],
+    step: (a) => (a[1] < a[0] ? 0 : 1),
+    smoothstep: (a) => { const u = Math.min(Math.max((a[2] - a[0]) / (a[1] - a[0]), 0), 1); return u * u * (3 - 2 * u); },
+    // map x∈[x0,x1] → [y0,y1], clamped (linear) / cubic in-out (ease)
+    linear: (a) => { const u = clamp01((a[0] - a[1]) / (a[2] - a[1])); return a[3] + (a[4] - a[3]) * u; },
+    ease: (a) => { const u = clamp01((a[0] - a[1]) / (a[2] - a[1])); const e = u < 0.5 ? 4 * u * u * u : 1 - Math.pow(-2 * u + 2, 3) / 2; return a[3] + (a[4] - a[3]) * e; },
+    noise: (a) => 2 * noise1d(a[0], a[1] ?? 0) - 1,
+    wiggle: (a, s) => (a[1] ?? 0) * (2 * noise1d(s.t * (a[0] ?? 0), a[2] ?? 0) - 1),
+    random: (a) => hash01(a[0] ?? 0),
+};
+const clamp01 = (x) => Math.min(Math.max(x, 0), 1);
+const _exprVocabularyLock = true;
+void _exprVocabularyLock;
+// String-keyed views for eval-time lookup — the parser has already validated
+// every name against the closed vocabulary, so these accesses are total.
+const FN_TABLE = FNS;
+const CONST_TABLE = CONSTS;
+function lex(src) {
+    const out = [];
+    let i = 0;
+    while (i < src.length) {
+        const c = src[i];
+        if (c === ' ' || c === '\t' || c === '\n' || c === '\r') {
+            i++;
+            continue;
+        }
+        if ((c >= '0' && c <= '9') || (c === '.' && /[0-9]/.test(src[i + 1] ?? ''))) {
+            const m = /^[0-9]*\.?[0-9]+(?:[eE][+-]?[0-9]+)?/.exec(src.slice(i));
+            if (!m)
+                return null;
+            out.push({ t: 'num', v: parseFloat(m[0]) });
+            i += m[0].length;
+            continue;
+        }
+        if (/[A-Za-z_]/.test(c)) {
+            const m = /^[A-Za-z_][A-Za-z0-9_]*/.exec(src.slice(i));
+            out.push({ t: 'id', v: m[0] });
+            i += m[0].length;
+            continue;
+        }
+        const two = src.slice(i, i + 2);
+        if (['<=', '>=', '==', '!=', '&&', '||'].includes(two)) {
+            out.push({ t: 'op', v: two });
+            i += 2;
+            continue;
+        }
+        if ('+-*/%^()<>!?:,'.includes(c)) {
+            out.push({ t: 'op', v: c });
+            i++;
+            continue;
+        }
+        return null; // illegal character
+    }
+    return out;
+}
+// ── Pratt parser ─────────────────────────────────────────────────────────────
+// binding powers for binary operators (higher = tighter)
+const BP = {
+    '||': 2, '&&': 3, '==': 4, '!=': 4, '<': 5, '>': 5, '<=': 5, '>=': 5,
+    '+': 6, '-': 6, '*': 7, '/': 7, '%': 7, '^': 9,
+};
+function parse(toks) {
+    let p = 0;
+    const peek = () => toks[p];
+    const eat = () => toks[p++];
+    function primary() {
+        const tk = peek();
+        if (!tk)
+            return null;
+        if (tk.t === 'num') {
+            eat();
+            return { k: 'num', v: tk.v };
+        }
+        if (tk.t === 'op' && (tk.v === '-' || tk.v === '!')) {
+            eat();
+            const a = unary();
+            return a && { k: 'un', op: tk.v, a };
+        }
+        if (tk.t === 'op' && tk.v === '(') {
+            eat();
+            const e = expr(0);
+            if (!e || eat()?.v !== ')')
+                return null;
+            return e;
+        }
+        if (tk.t === 'id') {
+            eat();
+            if (peek()?.t === 'op' && peek()?.v === '(') { // function call
+                eat();
+                const args = [];
+                if (!(peek()?.t === 'op' && peek()?.v === ')')) {
+                    for (;;) {
+                        const a = expr(0);
+                        if (!a)
+                            return null;
+                        args.push(a);
+                        const s = peek();
+                        if (s?.v === ',') {
+                            eat();
+                            continue;
+                        }
+                        break;
+                    }
+                }
+                if (eat()?.v !== ')')
+                    return null;
+                if (!(tk.v in FNS))
+                    return null; // unknown function → reject
+                return { k: 'call', name: tk.v, args };
+            }
+            if (tk.v in CONSTS || VARS.has(tk.v))
+                return { k: 'var', name: tk.v };
+            return null; // unknown identifier → reject
+        }
+        return null;
+    }
+    function unary() { return primary(); }
+    function expr(min) {
+        let left = unary();
+        if (!left)
+            return null;
+        for (;;) {
+            const tk = peek();
+            if (tk?.t === 'op' && tk.v === '?') { // ternary (lowest, right-assoc)
+                if (min > 1)
+                    break;
+                eat();
+                const a = expr(0);
+                if (!a || eat()?.v !== ':')
+                    return null;
+                const b = expr(1);
+                if (!b)
+                    return null;
+                left = { k: 'tern', c: left, a, b };
+                continue;
+            }
+            if (tk?.t !== 'op' || !(tk.v in BP) || BP[tk.v] < min)
+                break;
+            eat();
+            const rbp = tk.v === '^' ? BP[tk.v] : BP[tk.v] + 1; // ^ right-assoc
+            const right = expr(rbp);
+            if (!right)
+                return null;
+            left = { k: 'bin', op: tk.v, a: left, b: right };
+        }
+        return left;
+    }
+    const root = expr(0);
+    return root && p === toks.length ? root : null;
+}
+// ── evaluate ─────────────────────────────────────────────────────────────────
+function evalNode(node, s) {
+    switch (node.k) {
+        case 'num': return node.v;
+        case 'var': return node.name in CONST_TABLE ? CONST_TABLE[node.name] : s[node.name];
+        case 'un': return node.op === '-' ? -evalNode(node.a, s) : evalNode(node.a, s) === 0 ? 1 : 0;
+        case 'tern': return evalNode(node.c, s) !== 0 ? evalNode(node.a, s) : evalNode(node.b, s);
+        case 'call': return FN_TABLE[node.name](node.args.map((a) => evalNode(a, s)), s);
+        case 'bin': {
+            const a = evalNode(node.a, s);
+            if (node.op === '&&')
+                return a !== 0 && evalNode(node.b, s) !== 0 ? 1 : 0;
+            if (node.op === '||')
+                return a !== 0 || evalNode(node.b, s) !== 0 ? 1 : 0;
+            const b = evalNode(node.b, s);
+            switch (node.op) {
+                case '+': return a + b;
+                case '-': return a - b;
+                case '*': return a * b;
+                case '/': return a / b;
+                case '%': return a % b;
+                case '^': return Math.pow(a, b);
+                case '<': return a < b ? 1 : 0;
+                case '>': return a > b ? 1 : 0;
+                case '<=': return a <= b ? 1 : 0;
+                case '>=': return a >= b ? 1 : 0;
+                case '==': return a === b ? 1 : 0;
+                case '!=': return a !== b ? 1 : 0;
+            }
+            return NaN;
+        }
+    }
+}
+// compile-once cache; null = parse error (poisoned so we don't retry)
+const CACHE = new Map();
+export function compileExpr(src) {
+    if (CACHE.has(src))
+        return CACHE.get(src);
+    const toks = lex(src);
+    const ast = toks ? parse(toks) : null;
+    CACHE.set(src, ast);
+    return ast;
+}
+/** True when a property value is an expression object `{ expr: string }`. */
+export function isExpr(v) {
+    return typeof v === 'object' && v !== null && typeof v.expr === 'string';
+}
+/** Evaluate `{expr}` in the given scope; returns NaN-guarded `scope.value` on
+ *  parse error or non-finite result. */
+export function evalExpr(value, scope) {
+    const ast = compileExpr(value.expr);
+    if (!ast)
+        return scope.value;
+    const r = evalNode(ast, scope);
+    return Number.isFinite(r) ? r : scope.value;
+}
+//# sourceMappingURL=expr.js.map

package/dist/animation/expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/animation/expr.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,6EAA6E;AAE7E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAmB/C,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAmC,CAAC;AAC7F,iFAAiF;AACjF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,eAAe,CAAC,IAAI,CAAC,CAAC;AAEnD,0EAA0E;AAC1E,MAAM,GAAG,GAAG;IACV,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IACrF,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3F,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IACnI,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IACxH,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3H,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,C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"}

package/dist/animation/keyframes.d.ts

@@ -0,0 +1,23 @@
+import type { Keyframe } from '@clipkit/protocol';
+import { type RGBA } from '../compositor/color.js';
+/**
+ * Interpolate a numeric keyframe sequence at a given time (seconds).
+ * Returns the start value before the first keyframe, and the end value
+ * after the last. Keyframes are assumed to be sorted by time.
+ */
+/**
+ * Fold local time for looping keyframe animations (§6.3): `true` wraps
+ * modulo the last keyframe's time; `'ping-pong'` reflects.
+ */
+export declare function foldKeyframeTime(keyframes: Keyframe[], loop: boolean | 'ping-pong' | undefined, t: number): number;
+export declare function interpolateKeyframes(keyframes: Keyframe[], time: number): number;
+/**
+ * Interpolate a COLOR keyframe sequence at a given time. Values are CSS
+ * color strings (hex / rgb / rgba); interpolation is componentwise in
+ * straight-alpha RGB space, easing taken from the destination keyframe
+ * (same convention as numeric keyframes). Returns straight-alpha RGBA.
+ */
+export declare function interpolateColorKeyframes(keyframes: Keyframe[], time: number): RGBA;
+/** True when every keyframe value parses as a color string. */
+export declare function isColorKeyframes(keyframes: Keyframe[]): boolean;
+//# sourceMappingURL=keyframes.d.ts.map

package/dist/animation/keyframes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/animation/keyframes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;GAIG;AACH;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,QAAQ,EAAE,EACrB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,EACvC,CAAC,EAAE,MAAM,GACR,MAAM,CAUR;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA8BnF;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAS/D"}

package/dist/animation/keyframes.js

@@ -0,0 +1,117 @@
+// Keyframe interpolation. Pure function — no caching, no state.
+// The previous v0 implementation had a frame cache keyed by time, which
+// meant every distinct frame was a cache miss. We drop the cache entirely
+// here; if profiling shows interpolation is hot, we add memoization later.
+import { applyEasing } from './easings.js';
+import { parseColor } from '../compositor/color.js';
+/**
+ * Interpolate a numeric keyframe sequence at a given time (seconds).
+ * Returns the start value before the first keyframe, and the end value
+ * after the last. Keyframes are assumed to be sorted by time.
+ */
+/**
+ * Fold local time for looping keyframe animations (§6.3): `true` wraps
+ * modulo the last keyframe's time; `'ping-pong'` reflects.
+ */
+export function foldKeyframeTime(keyframes, loop, t) {
+    if (!loop || keyframes.length < 2 || t <= 0)
+        return t;
+    const last = keyframes[keyframes.length - 1].time;
+    const span = typeof last === 'number' ? last : parseFloat(String(last));
+    if (!Number.isFinite(span) || span <= 0)
+        return t;
+    if (loop === 'ping-pong') {
+        const c = t % (2 * span);
+        return c <= span ? c : 2 * span - c;
+    }
+    return t % span;
+}
+export function interpolateKeyframes(keyframes, time) {
+    if (keyframes.length === 0)
+        return 0;
+    if (keyframes.length === 1)
+        return toNumber(keyframes[0].value);
+    const first = keyframes[0];
+    const last = keyframes[keyframes.length - 1];
+    if (time <= toNumber(first.time))
+        return toNumber(first.value);
+    if (time >= toNumber(last.time))
+        return toNumber(last.value);
+    for (let i = 0; i < keyframes.length - 1; i++) {
+        const a = keyframes[i];
+        const b = keyframes[i + 1];
+        const at = toNumber(a.time);
+        const bt = toNumber(b.time);
+        if (time >= at && time <= bt) {
+            const span = bt - at;
+            const localT = span > 0 ? (time - at) / span : 0;
+            const easedT = applyEasing(b.easing, localT);
+            const av = toNumber(a.value);
+            const bv = toNumber(b.value);
+            return av + (bv - av) * easedT;
+        }
+    }
+    // Unreachable given the sentinels above, but TS doesn't know that.
+    return toNumber(last.value);
+}
+/**
+ * Interpolate a COLOR keyframe sequence at a given time. Values are CSS
+ * color strings (hex / rgb / rgba); interpolation is componentwise in
+ * straight-alpha RGB space, easing taken from the destination keyframe
+ * (same convention as numeric keyframes). Returns straight-alpha RGBA.
+ */
+export function interpolateColorKeyframes(keyframes, time) {
+    if (keyframes.length === 0)
+        return [1, 1, 1, 1];
+    if (keyframes.length === 1)
+        return toColor(keyframes[0].value);
+    const first = keyframes[0];
+    const last = keyframes[keyframes.length - 1];
+    if (time <= toNumber(first.time))
+        return toColor(first.value);
+    if (time >= toNumber(last.time))
+        return toColor(last.value);
+    for (let i = 0; i < keyframes.length - 1; i++) {
+        const a = keyframes[i];
+        const b = keyframes[i + 1];
+        const at = toNumber(a.time);
+        const bt = toNumber(b.time);
+        if (time >= at && time <= bt) {
+            const span = bt - at;
+            const localT = span > 0 ? (time - at) / span : 0;
+            const easedT = applyEasing(b.easing, localT);
+            const av = toColor(a.value);
+            const bv = toColor(b.value);
+            return [
+                av[0] + (bv[0] - av[0]) * easedT,
+                av[1] + (bv[1] - av[1]) * easedT,
+                av[2] + (bv[2] - av[2]) * easedT,
+                av[3] + (bv[3] - av[3]) * easedT,
+            ];
+        }
+    }
+    return toColor(last.value);
+}
+/** True when every keyframe value parses as a color string. */
+export function isColorKeyframes(keyframes) {
+    return (keyframes.length > 0 &&
+        keyframes.every((k) => typeof k.value === 'string' &&
+            (k.value.startsWith('#') || k.value.trim().startsWith('rgb'))));
+}
+function toColor(v) {
+    return parseColor(typeof v === 'string' ? v : undefined);
+}
+/**
+ * Coerce a Keyframe.time or .value (which the schema allows as number or
+ * string e.g. "1.5s") to a number. Non-numeric strings yield 0.
+ */
+function toNumber(v) {
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : 0;
+    if (typeof v === 'string') {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+//# sourceMappingURL=keyframes.js.map

package/dist/animation/keyframes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.js","sourceRoot":"","sources":["../../src/animation/keyframes.ts"],"names":[],"mappings":"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"}

package/dist/animation/motion-path.d.ts

@@ -0,0 +1,18 @@
+import type { BaseElement } from '@clipkit/protocol';
+export interface MotionPathSample {
+    x: number;
+    y: number;
+    /** Path z for 3D paths (§6.7); null on 2D paths — element `z` untouched. */
+    z: number | null;
+    /** Path travel direction at the sample, degrees (atan2(dy, dx) — xy projection). */
+    angle: number;
+    /** Whether the animation requested auto-orientation. */
+    autoOrient: boolean;
+}
+/**
+ * Resolve the element's `position` motion path at element-local time.
+ * Returns null when the element has no position path. Endpoint clamps
+ * hold the first/last point with the adjacent segment's end tangent.
+ */
+export declare function resolveMotionPath(element: BaseElement, localTime: number): MotionPathSample | null;
+//# sourceMappingURL=motion-path.d.ts.map

package/dist/animation/motion-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-path.d.ts","sourceRoot":"","sources":["../../src/animation/motion-path.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,mBAAmB,CAAC;AAGlF,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,4EAA4E;IAC5E,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,UAAU,EAAE,OAAO,CAAC;CACrB;AA6LD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CA+CzB"}