frameyard 0.8.0 → 0.10.0

package/dist/templates.js

@@ -0,0 +1,186 @@
+const staticPoster = `<script type="application/json" data-fy="props">{
+  "title": "A quiet signal",
+  "subtitle": "Frameyard static poster",
+  "accent": "#ff7a45"
+}</script>
+<style>
+  html, body { margin: 0; width: 100%; height: 100%; }
+  .poster {
+    position: absolute;
+    inset: 0;
+    display: grid;
+    place-items: center;
+    background: radial-gradient(circle at 50% 35%, #1d2a44, #080d16 70%);
+    color: #f4f7fb;
+    font-family: system-ui, sans-serif;
+  }
+  .card { width: 78%; text-align: center; }
+  h1 {
+    margin: 0;
+    font-size: 8vmin;
+    line-height: 1.05;
+    color: var(--fy-prop-accent, #ff7a45);
+  }
+  p {
+    margin: 3vmin 0 0;
+    font-size: 3vmin;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    color: #9fb0c8;
+  }
+</style>
+<fy-composition>
+  <main class="poster">
+    <div class="card">
+      <h1 data-fy-text="title"></h1>
+      <p data-fy-text="subtitle"></p>
+    </div>
+  </main>
+</fy-composition>
+`;
+const titleCard = `<script type="application/json" data-fy="props">{
+  "title": "Chapter one",
+  "subtitle": "A deterministic title card"
+}</script>
+<style>
+  html, body { margin: 0; width: 100%; height: 100%; }
+  @keyframes rise {
+    from { opacity: 0; transform: translateY(4vmin); }
+    to { opacity: 1; transform: translateY(0); }
+  }
+  .stage {
+    position: absolute;
+    inset: 0;
+    display: grid;
+    place-items: center;
+    background: linear-gradient(135deg, #0c1220, #18243a);
+    color: #f4f7fb;
+    font-family: system-ui, sans-serif;
+    text-align: center;
+  }
+  h1 { margin: 0; font-size: 9vmin; line-height: 1.05; animation: rise 1s linear both; }
+  p { margin: 3vmin 0 0; font-size: 3vmin; color: #8fa4c4; animation: rise 1s linear both; }
+</style>
+<fy-composition duration-in-frames="150">
+  <main class="stage">
+    <div>
+      <h1 data-fy-text="title" data-fy-anim-start="0" data-fy-anim-duration="36"></h1>
+      <p data-fy-text="subtitle" data-fy-anim-start="18" data-fy-anim-duration="36"></p>
+    </div>
+  </main>
+</fy-composition>
+`;
+const lowerThird = `<script type="application/json" data-fy="props">{
+  "name": "Ada Lovelace",
+  "role": "Computing pioneer",
+  "accent": "#ff7a45"
+}</script>
+<style>
+  html, body { margin: 0; width: 100%; height: 100%; }
+  @keyframes slide {
+    from { opacity: 0; transform: translateX(-6vmin); }
+    to { opacity: 1; transform: translateX(0); }
+  }
+  .stage {
+    position: absolute;
+    inset: 0;
+    background: transparent;
+    font-family: system-ui, sans-serif;
+  }
+  .bar {
+    position: absolute;
+    left: 6vmin;
+    bottom: 9vmin;
+    padding: 2.4vmin 3.2vmin;
+    border-left: 0.8vmin solid var(--fy-prop-accent, #ff7a45);
+    background: color-mix(in srgb, #0c1220 88%, transparent);
+    color: #f4f7fb;
+    animation: slide 1s ease both;
+  }
+  strong { display: block; font-size: 4.2vmin; line-height: 1.1; }
+  span { display: block; margin-top: 0.8vmin; font-size: 2.4vmin; color: #9fb0c8; }
+</style>
+<fy-composition duration-in-frames="120">
+  <main class="stage">
+    <div class="bar" data-fy-anim-start="0" data-fy-anim-duration="30">
+      <strong data-fy-text="name"></strong>
+      <span data-fy-text="role"></span>
+    </div>
+  </main>
+</fy-composition>
+`;
+const slideshowTimeline = `{
+  "version": 1,
+  "tracks": [
+    { "id": "v1", "kind": "video" }
+  ],
+  "clips": [
+    {
+      "id": "slide-1",
+      "track": "v1",
+      "source": { "kind": "image", "src": "assets/slide-1.png" },
+      "start": 0,
+      "duration": 90
+    },
+    {
+      "id": "slide-2",
+      "track": "v1",
+      "source": { "kind": "image", "src": "assets/slide-2.png" },
+      "start": 90,
+      "duration": 90
+    },
+    {
+      "id": "slide-3",
+      "track": "v1",
+      "source": { "kind": "image", "src": "assets/slide-3.png" },
+      "start": 180,
+      "duration": 90
+    }
+  ],
+  "transitions": []
+}
+`;
+export const TEMPLATES = [
+    {
+        name: "static-poster",
+        kind: "composition",
+        description: "A timeless poster with title, subtitle, and accent props; renders to PNG.",
+        entry: (id) => `compositions/${id}.html`,
+        content: staticPoster,
+    },
+    {
+        name: "title-card",
+        kind: "composition",
+        description: "A 150-frame title card with staggered CSS entrance animations.",
+        entry: (id) => `compositions/${id}.html`,
+        content: titleCard,
+    },
+    {
+        name: "lower-third",
+        kind: "composition",
+        description: "A 120-frame lower third for a name and role.",
+        entry: (id) => `compositions/${id}.html`,
+        content: lowerThird,
+    },
+    {
+        name: "slideshow",
+        kind: "timeline",
+        description: "A three-slide image timeline with 90-frame clips.",
+        entry: (id) => `timelines/${id}.timeline.json`,
+        content: slideshowTimeline,
+        prerequisites: ["assets/slide-1.png", "assets/slide-2.png", "assets/slide-3.png"],
+    },
+];
+export function findTemplate(name) {
+    return TEMPLATES.find((template) => template.name === name);
+}
+export function listTemplates(kind) {
+    return TEMPLATES.filter((template) => kind === undefined || template.kind === kind);
+}
+export function templateRegistration(template, id) {
+    const entry = template.entry(id);
+    return template.kind === "composition"
+        ? { compositions: { [id]: `./${entry}` }, timelines: undefined }
+        : { compositions: undefined, timelines: { [id]: `./${entry}` } };
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAaA,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCpB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsClB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BzB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAA+B;IACnD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,2EAA2E;QACxF,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO;QACxC,OAAO,EAAE,YAAY;KACtB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,gEAAgE;QAC7E,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO;QACxC,OAAO,EAAE,SAAS;KACnB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO;QACxC,OAAO,EAAE,UAAU;KACpB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,mDAAmD;QAChE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,EAAE,gBAAgB;QAC9C,OAAO,EAAE,iBAAiB;QAC1B,aAAa,EAAE,CAAC,oBAAoB,EAAE,oBAAoB,EAAE,oBAAoB,CAAC;KAClF;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,EAAU;IAEV,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,IAAI,KAAK,aAAa;QACpC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;QAChE,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,EAAE,EAAE,EAAE,CAAC;AACrE,CAAC"}

package/dist/timeline/easing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser-safe CSS timing-function parsing and evaluation for timeline
+ * keyframes. This is the single source of truth shared by the preview, the
+ * static checker, and the FFmpeg expression builder.
+ */
+export interface CubicBezierEasing {
+    kind: "cubic-bezier";
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export type StepPosition = "jump-start" | "jump-end" | "jump-none" | "jump-both";
+export interface StepsEasing {
+    kind: "steps";
+    steps: number;
+    position: StepPosition;
+}
+export interface LinearEasing {
+    kind: "linear";
+}
+export type Easing = LinearEasing | CubicBezierEasing | StepsEasing;
+export declare const LINEAR_EASING: LinearEasing;
+/** Human-readable grammar used in diagnostics and documentation. */
+export declare const EASING_GRAMMAR = "linear, ease, ease-in, ease-out, ease-in-out, step-start, step-end, hold, cubic-bezier(x1, y1, x2, y2), or steps(n, jump-start|jump-end|jump-none|jump-both)";
+/** Parses a CSS timing function from the supported keyframe vocabulary. */
+export declare function parseEasing(value: string): Easing | null;
+/** Solves x(u) = progress for a CSS cubic-bezier and returns y(u). */
+export declare function cubicBezierProgress(easing: CubicBezierEasing, progress: number): number;
+/** dy/dx of a CSS cubic-bezier at x = progress, used by the Hermite approximation. */
+export declare function cubicBezierSlope(easing: CubicBezierEasing, progress: number): number;
+/** Evaluates a parsed easing at a normalized progress in `0..1`. */
+export declare function easeProgress(easing: Easing, progress: number): number;
+/** Caches parsing by the raw string; timelines often repeat the same easing. */
+export declare function easingFor(value: string | undefined): Easing;
+//# sourceMappingURL=easing.d.ts.map

package/dist/timeline/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/timeline/easing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,iBAAiB,GAAG,WAAW,CAAC;AAEpE,eAAO,MAAM,aAAa,EAAE,YAAiC,CAAC;AAE9D,oEAAoE;AACpE,eAAO,MAAM,cAAc,iKACqI,CAAC;AAwEjK,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6BxD;AAYD,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoCvF;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BpF;AAoBD,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUrE;AAID,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAW3D"}

package/dist/timeline/easing.js

@@ -0,0 +1,225 @@
+/**
+ * Browser-safe CSS timing-function parsing and evaluation for timeline
+ * keyframes. This is the single source of truth shared by the preview, the
+ * static checker, and the FFmpeg expression builder.
+ */
+export const LINEAR_EASING = { kind: "linear" };
+/** Human-readable grammar used in diagnostics and documentation. */
+export const EASING_GRAMMAR = "linear, ease, ease-in, ease-out, ease-in-out, step-start, step-end, hold, cubic-bezier(x1, y1, x2, y2), or steps(n, jump-start|jump-end|jump-none|jump-both)";
+const NAMED_EASINGS = {
+    ease: [0.25, 0.1, 0.25, 1],
+    "ease-in": [0.42, 0, 1, 1],
+    "ease-out": [0, 0, 0.58, 1],
+    "ease-in-out": [0.42, 0, 0.58, 1],
+};
+function parseNumber(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    const number = Number(trimmed);
+    return Number.isFinite(number) ? number : null;
+}
+function parseSteps(value) {
+    const match = /^steps\(([^)]*)\)$/i.exec(value);
+    if (!match) {
+        return null;
+    }
+    const parts = match[1].split(",").map((part) => part.trim());
+    if (parts.length < 1 || parts.length > 2) {
+        return null;
+    }
+    const count = parseNumber(parts[0]);
+    if (count === null || !Number.isInteger(count) || count <= 0) {
+        return null;
+    }
+    const positionValue = (parts[1] ?? "jump-end").toLowerCase();
+    const position = positionValue === "start"
+        ? "jump-start"
+        : positionValue === "end"
+            ? "jump-end"
+            : positionValue === "jump-start" ||
+                positionValue === "jump-end" ||
+                positionValue === "jump-none" ||
+                positionValue === "jump-both"
+                ? positionValue
+                : null;
+    if (position === null) {
+        return null;
+    }
+    if (position === "jump-none" && count < 2) {
+        return null;
+    }
+    return { kind: "steps", steps: count, position };
+}
+function parseCubicBezier(value) {
+    const match = /^cubic-bezier\(([^)]*)\)$/i.exec(value);
+    if (!match) {
+        return null;
+    }
+    const parts = match[1].split(",").map((part) => part.trim());
+    if (parts.length !== 4) {
+        return null;
+    }
+    const numbers = parts.map(parseNumber);
+    if (numbers.some((number) => number === null)) {
+        return null;
+    }
+    const [x1, y1, x2, y2] = numbers;
+    if (x1 < 0 || x1 > 1 || x2 < 0 || x2 > 1) {
+        return null;
+    }
+    return { kind: "cubic-bezier", x1, y1, x2, y2 };
+}
+/** Parses a CSS timing function from the supported keyframe vocabulary. */
+export function parseEasing(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    const lower = trimmed.toLowerCase();
+    if (lower === "linear") {
+        return LINEAR_EASING;
+    }
+    if (lower === "hold" || lower === "step-end") {
+        return { kind: "steps", steps: 1, position: "jump-end" };
+    }
+    if (lower === "step-start") {
+        return { kind: "steps", steps: 1, position: "jump-start" };
+    }
+    const named = NAMED_EASINGS[lower];
+    if (named) {
+        return { kind: "cubic-bezier", x1: named[0], y1: named[1], x2: named[2], y2: named[3] };
+    }
+    if (lower.startsWith("cubic-bezier(")) {
+        return parseCubicBezier(trimmed);
+    }
+    if (lower.startsWith("steps(")) {
+        return parseSteps(trimmed);
+    }
+    return null;
+}
+function cubicCoordinate(u, first, second) {
+    const inverse = 1 - u;
+    return 3 * inverse * inverse * u * first + 3 * inverse * u * u * second + u * u * u;
+}
+function cubicDerivative(u, first, second) {
+    const inverse = 1 - u;
+    return 3 * inverse * inverse * first + 6 * inverse * u * (second - first) + 3 * u * u * (1 - second);
+}
+/** Solves x(u) = progress for a CSS cubic-bezier and returns y(u). */
+export function cubicBezierProgress(easing, progress) {
+    const target = Math.max(0, Math.min(1, progress));
+    if (target === 0 || target === 1) {
+        return target;
+    }
+    let u = target;
+    for (let iteration = 0; iteration < 8; iteration += 1) {
+        const x = cubicCoordinate(u, easing.x1, easing.x2);
+        const difference = x - target;
+        if (Math.abs(difference) < 1e-9) {
+            return cubicCoordinate(u, easing.y1, easing.y2);
+        }
+        const derivative = cubicDerivative(u, easing.x1, easing.x2);
+        if (Math.abs(derivative) < 1e-9) {
+            break;
+        }
+        const next = u - difference / derivative;
+        if (!Number.isFinite(next) || next < 0 || next > 1) {
+            break;
+        }
+        u = next;
+    }
+    let low = 0;
+    let high = 1;
+    for (let iteration = 0; iteration < 48; iteration += 1) {
+        u = (low + high) / 2;
+        const x = cubicCoordinate(u, easing.x1, easing.x2);
+        if (x < target) {
+            low = u;
+        }
+        else {
+            high = u;
+        }
+    }
+    return cubicCoordinate((low + high) / 2, easing.y1, easing.y2);
+}
+/** dy/dx of a CSS cubic-bezier at x = progress, used by the Hermite approximation. */
+export function cubicBezierSlope(easing, progress) {
+    const target = Math.max(0, Math.min(1, progress));
+    let u = target;
+    if (target > 0 && target < 1) {
+        for (let iteration = 0; iteration < 8; iteration += 1) {
+            const x = cubicCoordinate(u, easing.x1, easing.x2);
+            const derivative = cubicDerivative(u, easing.x1, easing.x2);
+            if (Math.abs(derivative) < 1e-9) {
+                break;
+            }
+            const next = u - (x - target) / derivative;
+            if (!Number.isFinite(next) || next < 0 || next > 1) {
+                break;
+            }
+            u = next;
+        }
+    }
+    const dx = cubicDerivative(u, easing.x1, easing.x2);
+    const dy = cubicDerivative(u, easing.y1, easing.y2);
+    if (Math.abs(dx) > 1e-7) {
+        return dy / dx;
+    }
+    // Endpoint limits for curves with a vertical or degenerate tangent. Sample a
+    // tiny step on either side and use the secant slope.
+    const delta = 1e-5;
+    const low = Math.max(0, target - delta);
+    const high = Math.min(1, target + delta);
+    const lowY = cubicBezierProgress(easing, low);
+    const highY = cubicBezierProgress(easing, high);
+    return high === low ? 0 : (highY - lowY) / (high - low);
+}
+function stepsProgress(easing, progress) {
+    const p = Math.max(0, Math.min(1, progress));
+    if (p >= 1) {
+        return 1;
+    }
+    const n = easing.steps;
+    switch (easing.position) {
+        case "jump-start":
+            return Math.floor(p * n + 1) / n;
+        case "jump-end":
+            return Math.floor(p * n) / n;
+        case "jump-none":
+            return Math.floor(p * n) / (n - 1);
+        case "jump-both":
+            return (Math.floor(p * n) + 1) / (n + 1);
+    }
+}
+/** Evaluates a parsed easing at a normalized progress in `0..1`. */
+export function easeProgress(easing, progress) {
+    const p = Math.max(0, Math.min(1, progress));
+    switch (easing.kind) {
+        case "linear":
+            return p;
+        case "steps":
+            return stepsProgress(easing, p);
+        case "cubic-bezier":
+            return cubicBezierProgress(easing, p);
+    }
+}
+const easingCache = new Map();
+/** Caches parsing by the raw string; timelines often repeat the same easing. */
+export function easingFor(value) {
+    if (value === undefined) {
+        return LINEAR_EASING;
+    }
+    const cached = easingCache.get(value);
+    if (cached !== undefined) {
+        return cached ?? LINEAR_EASING;
+    }
+    const parsed = parseEasing(value);
+    easingCache.set(value, parsed);
+    return parsed ?? LINEAR_EASING;
+}
+//# sourceMappingURL=easing.js.map

package/dist/timeline/easing.js.map

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

package/dist/timeline/keyframes.d.ts

@@ -0,0 +1,23 @@
+import { type TimelineKeyframe, type TimelineKeyframeChannel, type TimelineKeyframes, type TimelineTransform } from "./schema.js";
+export type KeyframeChannel = TimelineKeyframeChannel;
+export interface PresentationValues {
+    x: number;
+    y: number;
+    scale: number;
+    rotation: number;
+    opacity: number;
+}
+/**
+ * Evaluates one channel at a clip-local frame. Keys are sorted and validated by
+ * the schema/resolver. Values before the first key and after the last key hold.
+ */
+export declare function evaluateKeyframeTrack(keys: readonly TimelineKeyframe[], frame: number): number;
+/** Resolves every presentation channel for a clip-local frame. */
+export declare function evaluatePresentation(transform: TimelineTransform, keyframes: TimelineKeyframes | undefined, localFrame: number): PresentationValues;
+export declare function keyframeMarkerFrames(keyframes: TimelineKeyframes | undefined): number[];
+export declare function keyframeChannelsAt(keyframes: TimelineKeyframes | undefined, frame: number): Array<{
+    channel: KeyframeChannel;
+    value: number;
+    easing?: string;
+}>;
+//# sourceMappingURL=keyframes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.d.ts","sourceRoot":"","sources":["../../src/timeline/keyframes.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAsB9F;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAqBpB;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,GAAG,SAAS,GAAG,MAAM,EAAE,CAWvF;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,GAAG,SAAS,EACxC,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBrE"}

package/dist/timeline/keyframes.js

@@ -0,0 +1,95 @@
+import { easeProgress, easingFor } from "./easing.js";
+import { KEYFRAME_CHANNELS, } from "./schema.js";
+function intervalIndex(keys, frame) {
+    let low = 0;
+    let high = keys.length - 1;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (keys[middle].frame <= frame) {
+            low = middle;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    return low;
+}
+/**
+ * Evaluates one channel at a clip-local frame. Keys are sorted and validated by
+ * the schema/resolver. Values before the first key and after the last key hold.
+ */
+export function evaluateKeyframeTrack(keys, frame) {
+    if (keys.length === 0) {
+        throw new Error("Cannot evaluate an empty keyframe track.");
+    }
+    const first = keys[0];
+    if (frame <= first.frame) {
+        return first.value;
+    }
+    const last = keys[keys.length - 1];
+    if (frame >= last.frame) {
+        return last.value;
+    }
+    const index = intervalIndex(keys, frame);
+    const from = keys[index];
+    const to = keys[index + 1];
+    if (frame === from.frame) {
+        return from.value;
+    }
+    const progress = (frame - from.frame) / (to.frame - from.frame);
+    const eased = easeProgress(easingFor(from.easing), progress);
+    return from.value + (to.value - from.value) * eased;
+}
+/** Resolves every presentation channel for a clip-local frame. */
+export function evaluatePresentation(transform, keyframes, localFrame) {
+    const values = {
+        x: transform.x,
+        y: transform.y,
+        scale: transform.scale,
+        rotation: transform.rotation,
+        opacity: transform.opacity,
+    };
+    if (keyframes) {
+        for (const channel of KEYFRAME_CHANNELS) {
+            const track = keyframes[channel];
+            if (track !== undefined) {
+                values[channel] = evaluateKeyframeTrack(track, localFrame);
+            }
+        }
+    }
+    // Easing may overshoot. Alpha is clamped by CSS, and a negative scale would
+    // mirror a layer that the static schema forbids from being negative.
+    values.scale = Math.max(0, values.scale);
+    values.opacity = Math.min(1, Math.max(0, values.opacity));
+    return values;
+}
+export function keyframeMarkerFrames(keyframes) {
+    if (!keyframes) {
+        return [];
+    }
+    const frames = new Set();
+    for (const channel of KEYFRAME_CHANNELS) {
+        for (const key of keyframes[channel] ?? []) {
+            frames.add(key.frame);
+        }
+    }
+    return [...frames].sort((left, right) => left - right);
+}
+export function keyframeChannelsAt(keyframes, frame) {
+    if (!keyframes) {
+        return [];
+    }
+    const channels = [];
+    for (const channel of KEYFRAME_CHANNELS) {
+        const key = keyframes[channel]?.find((entry) => entry.frame === frame);
+        if (key) {
+            channels.push({
+                channel,
+                value: key.value,
+                ...(key.easing !== undefined ? { easing: key.easing } : {}),
+            });
+        }
+    }
+    return channels;
+}
+//# sourceMappingURL=keyframes.js.map

package/dist/timeline/keyframes.js.map

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

package/dist/timeline/plan.d.ts

@@ -1,9 +1,5 @@
-import type { ResolvedTimeline, ResolvedTimelineClip } from "./resolve.js";
-export interface TimelineRenderLayer {
-    clip: ResolvedTimelineClip;
-    /** Source frame used at the segment's first timeline frame. */
-    sourceStart: number;
-}
+import type { ResolvedTimeline, ResolvedTimelineSource } from "./resolve.js";
+import { type TimelineSceneLayer } from "./scene.js";
 export interface TimelineRenderSegment {
     index: number;
     /** Inclusive first timeline frame. */
@@ -12,17 +8,15 @@ export interface TimelineRenderSegment {
     end: number;
     frames: number;
     /** Visual layers from bottom to top. */
-    layers: TimelineRenderLayer[];
+    layers: TimelineSceneLayer<ResolvedTimelineSource>[];
 }
 export interface TimelineRenderPlan {
-    timeline: ResolvedTimeline;
-    maxSegmentFrames: number;
     segments: TimelineRenderSegment[];
 }
 /**
- * Splits a resolved timeline at visual clip boundaries and a maximum segment
- * duration. Every segment has a fixed set of visual layers; audio is mixed
- * globally and never appears here.
+ * Splits a resolved timeline into independently renderable segments. Segment
+ * boundaries fall on visual clip starts and ends, so every segment has a fixed
+ * scene projection; audio is mixed globally and never appears here.
  */
 export declare function planTimelineRender(timeline: ResolvedTimeline, options?: {
     maxSegmentFrames?: number;

package/dist/timeline/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/timeline/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,kBAAkB,CAiEpB"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/timeline/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClF,kBAAkB,CAqDpB"}