@clipkit/runtime 1.0.0

package/dist/compositor/render-context.d.ts

@@ -0,0 +1,194 @@
+import type { Backend, RenderTarget, Texture } from '../backend/backend.js';
+import type { AssetCache } from '../assets/cache.js';
+import type { Mp4FrameSource } from '../assets/mp4-frame-source.js';
+import type { FontAtlas } from '../text/font-atlas.js';
+import type { CanvasDimensions } from './unit.js';
+import type { ResolvedEnvironment, ResolvedLight } from './lighting.js';
+export interface ImageAsset {
+    bitmap: ImageBitmap;
+    texture: Texture;
+}
+export interface VideoAsset {
+    /**
+     * The decoding element when the runtime owns playback via the DOM
+     * (page contexts). Null in worker contexts.
+     */
+    video: HTMLVideoElement | null;
+    /**
+     * Deterministic WebCodecs decode path (fetch + demux + VideoDecoder)
+     * — the primary video source in worker contexts, where
+     * HTMLVideoElement doesn't exist. `runtime.prepareVideoFrames(t)`
+     * pulls the exact frame for each render time and uploads it before
+     * the synchronous frame() pass.
+     */
+    frameSource: Mp4FrameSource | null;
+    texture: Texture;
+    /**
+     * Element-backed: video.currentTime at last upload. FrameSource-
+     * backed: the µs timestamp of the last uploaded frame. Externally
+     * pumped: unused (uploads happen at push time).
+     */
+    lastUploadedTime: number;
+    /** Natural media width in pixels (videoWidth for element-backed assets). */
+    width: number;
+    /** Natural media height in pixels. */
+    height: number;
+}
+export interface SvgRasterAsset {
+    canvas: OffscreenCanvas;
+    ctx: OffscreenCanvasRenderingContext2D;
+    texture: Texture;
+    /**
+     * Pixel signature — frame-to-frame compared in renderPathShape
+     * so a static (or unchanged) SVG can skip the expensive raster +
+     * GPU upload and just redraw the cached texture. Big win for the
+     * common case where an SVG sits on screen after its path-draw
+     * animation has settled at progress=1.
+     *
+     * undefined when the cache entry was just created (forces first
+     * raster pass).
+     */
+    lastSignature?: SvgRasterSignature;
+}
+export interface SvgRasterSignature {
+    /** Resolved trim window per path: flat [start, end, offset] triples. */
+    trims: number[];
+    /** Resolved d-string per path (morphing makes these time-varying). */
+    ds: string[];
+    /** Reference to element.paths array — changes only on source edits. */
+    pathsRef: unknown;
+    /** Reference to element.gradients — same. */
+    gradientsRef: unknown;
+    /** Raster canvas dimensions used. Changes if displayed size shifts. */
+    rasterW: number;
+    rasterH: number;
+}
+export interface MaskedTextAsset {
+    canvas: OffscreenCanvas;
+    ctx: OffscreenCanvasRenderingContext2D;
+    texture: Texture;
+}
+/** Parsed .cube LUT, packed as an N²×N 2D atlas texture (§4.7 `lut`). */
+export interface LutAsset {
+    texture: Texture;
+    /** Lattice size N (LUT_3D_SIZE). */
+    size: number;
+}
+/** Per-group offscreen layer for `clip: true`, keyed by element id. */
+export interface GroupClipTarget {
+    target: RenderTarget;
+    /** Logical dims the target was allocated at (recreated on change). */
+    width: number;
+    height: number;
+    /**
+     * Frame index (RenderContext.frameIndex) this entry was last acquired.
+     * Drives frame-boundary LRU eviction of the offscreen-FBO pool: after
+     * endFrame(), entries NOT touched this frame are the only eviction
+     * candidates, dropped least-recently-touched first to bound peak GPU memory
+     * on SwiftShader. Undefined only between create and first stamp.
+     */
+    lastTouched?: number;
+}
+/**
+ * 4×4 transform matrix (CKP/1.0 §4.4), column-major f64 — see
+ * compositor/mat4.ts for the element layout and operations.
+ *
+ * `aff` marks a pure 2D affine embedded in the 4×4 (trivial z/w rows
+ * and columns): affine×affine operations run the exact CKP/1.0 float
+ * expressions, keeping 2D documents byte-identical. The flag is load-
+ * bearing for that guarantee — never construct a Mat4 with `aff: true`
+ * unless the extra slots really are trivial.
+ */
+export interface Mat4 {
+    /** 16 elements, column-major: e[col * 4 + row]. */
+    e: number[];
+    /** True when the matrix is a 2D affine embedded in 4×4. */
+    aff: boolean;
+}
+export declare const MAT4_IDENTITY: Mat4;
+export interface RenderContext {
+    backend: Backend;
+    canvas: CanvasDimensions;
+    /** Global time in seconds. Used for animation evaluation. */
+    time: number;
+    /**
+     * Total duration of the current source in seconds. Used to resolve
+     * `duration: "auto"` and `time: "end"` for elements and animations.
+     */
+    sourceDuration: number;
+    /**
+     * Monotonic eviction epoch from the runtime (NOT a 1:1 output-frame count).
+     * Stamped onto every acquired groupTargets pool entry so post-endFrame LRU
+     * eviction can tell which entries were touched this frame (never evicted)
+     * from stale ones. Constant across all motion-blur sub-frame samples of one
+     * output frame (makeContext does not bump it).
+     */
+    frameIndex: number;
+    images: AssetCache<ImageAsset>;
+    videos: AssetCache<VideoAsset>;
+    fontAtlases: AssetCache<FontAtlas>;
+    /**
+     * Per-element rasterization caches for elements that draw to an
+     * OffscreenCanvas each frame and upload to a single texture. Keyed by
+     * element.id (or a synthesized key when id is absent).
+     */
+    svgRasters: AssetCache<SvgRasterAsset>;
+    maskedTexts: AssetCache<MaskedTextAsset>;
+    /** Offscreen layers for clipped groups. */
+    groupTargets: AssetCache<GroupClipTarget>;
+    /** Parsed .cube LUT atlases, keyed by source URL. */
+    luts: AssetCache<LutAsset>;
+    /**
+     * Current model matrix. Identity at the root; group elements push their
+     * own transform onto this when rendering children, and pop afterwards.
+     * Element renderers read this and apply it to their computed positions
+     * before emitting draw calls.
+     */
+    modelMatrix: Mat4;
+    /**
+     * §4.8 lighting: the cumulative transform WITHOUT the scene camera —
+     * identity at the root, group locals multiply in (parallel to
+     * modelMatrix). An element's world-space placement for lighting is
+     * `worldMatrix · localQuad`; combined with `eye`, that gives the
+     * view-dependent specular that sweeps as the camera moves. (modelMatrix
+     * bakes in the camera P·V, so it can't be used for world-space shading.)
+     */
+    worldMatrix: Mat4;
+    /** Resolved scene lights at this frame (§4.8). Empty ⇒ unlit. */
+    lights: ResolvedLight[];
+    /** Camera eye in world space (§4.8); view-vector origin for specular. */
+    eye: [number, number, number];
+    /** Resolved scene environment (§4.8); reflective materials sample it. Null ⇒ no reflections. */
+    environment: ResolvedEnvironment | null;
+    /**
+     * §4.4.3 2.5D depth sort. When set, sibling draw lists (top-level
+     * elements and the children of plain, non-flattened groups) paint
+     * back-to-front by depth (eye-space `z`) instead of pure `track`
+     * order. `z` orders always — true unless `camera.sort: 'paint'`, or
+     * (with no camera) the doc has no depth fields at all, in which case
+     * it stays plain track order, byte-identical to a 2D document.
+     */
+    depthSort: boolean;
+    /**
+     * Cumulative opacity factor in [0, 1]. Group elements multiply their
+     * own opacity into this when rendering children. Element renderers
+     * multiply their own opacity by this before computing tints.
+     */
+    opacityFactor: number;
+    /**
+     * Time offset applied to children of a group, in seconds. Children's
+     * `time` is interpreted relative to this offset (so a child with
+     * `time: 0` inside a group at `time: 3` fires at global time 3).
+     */
+    timeOffset: number;
+    /**
+     * LOGICAL dimensions of the surface currently receiving draws — the
+     * canvas at the root, a group's box while rendering into its
+     * clip/mask layers. Filtered elements (blur_radius / brightness /
+     * contrast / saturation) allocate their offscreen layers at exactly
+     * this size so the 1:1 composite back is exact at any nesting depth.
+     */
+    surfaceWidth: number;
+    surfaceHeight: number;
+}
+//# sourceMappingURL=render-context.d.ts.map

package/dist/compositor/render-context.d.ts.map

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

package/dist/compositor/render-context.js

@@ -0,0 +1,10 @@
+// Shared context object threaded through element renderers.
+//
+// The runtime populates this once per frame and hands it to each
+// renderElement(...) call. Renderers read what they need and call into
+// the backend to emit draw commands.
+export const MAT4_IDENTITY = {
+    e: [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1],
+    aff: true,
+};
+//# sourceMappingURL=render-context.js.map

package/dist/compositor/render-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.js","sourceRoot":"","sources":["../../src/compositor/render-context.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,iEAAiE;AACjE,uEAAuE;AACvE,qCAAqC;AAsHrC,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,GAAG,EAAE,IAAI;CACV,CAAC"}

package/dist/compositor/resolve.d.ts

@@ -0,0 +1,80 @@
+import type { BaseElement, Element } from '@clipkit/protocol';
+import type { RenderContext } from './render-context.js';
+/**
+ * Apply animations to a property's static value. Returns the static value
+ * unchanged if no animation targets this property at the current time.
+ */
+export declare function applyAnimation(element: BaseElement, property: string, staticValue: number, ctx: RenderContext): number;
+/**
+ * Resolve the element's CKP/1.0 3D transform (§4.4.1) at the current
+ * time. Returns null when the element carries none of the 3D fields —
+ * the renderer's signal to stay on the byte-stable 2D fast path.
+ * `z_rotation` is NOT 3D (it's the in-plane `rotation` alias, resolved
+ * through the normal rotation slot).
+ */
+export declare function resolve3D(element: BaseElement, ctx: RenderContext): {
+    xRot: number;
+    yRot: number;
+    z: number;
+} | null;
+/**
+ * §4.4.3 depth key: the EYE-SPACE z of the element's anchor under the
+ * current model matrix. The perspective matrix P leaves the z output row
+ * untouched (its row 2 is [0,0,1,0]), so the z component of `M·anchor`
+ * is the eye-space depth whether or not a camera/perspective is present —
+ * with no camera it is simply `element.z`. LARGER z = nearer the viewer.
+ * Resolved with the same `applyAnimation` / `resolve3D` path the renderer
+ * uses, so the sort matches what's drawn.
+ */
+export declare function cameraDepthZ(el: Element, ctx: RenderContext): number;
+/**
+ * Stable back-to-front order by depth (farthest painted first → nearest
+ * on top). `elements` MUST already be in `track` order; equal depths fall
+ * back to that order (the explicit index tiebreak keeps it stable across
+ * engines). Sorting by ascending eye-space z puts the farthest (smallest
+ * z) first. Used by the scene and plain-group child walkers when
+ * `ctx.depthSort` is set. With all z equal (e.g. a 2D doc) this is a
+ * stable no-op → pure track order.
+ */
+export declare function depthOrder(elements: readonly Element[], ctx: RenderContext): Element[];
+/**
+ * Resolve the element's effective per-axis scale at the current time:
+ * uniform `scale` (factor, default 1) multiplied with per-axis
+ * `x_scale` / `y_scale` (factor, or "N%" string). All three are
+ * animatable — via keyframe_animations or preset tweens (scale-in,
+ * squash, …).
+ *
+ * Renderers multiply their resolved width/height (and, for glyph-based
+ * renderers, glyph offsets around the pivot) by the returned factors.
+ */
+export declare function resolveScalePair(element: BaseElement, ctx: RenderContext): {
+    sx: number;
+    sy: number;
+};
+/**
+ * Derive the missing box dimension from `aspect_ratio` (width/height).
+ * Only applies when EXACTLY ONE of width/height is authored — both or
+ * neither leaves the resolved values untouched.
+ */
+export declare function applyAspectRatio(element: BaseElement, width: number, height: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Resolve a color property (fill_color, stroke_color, …) at the current
+ * time. When a keyframe_animation targets the property with color-string
+ * values, the colors are lerped componentwise in straight-alpha RGB
+ * space and returned as a CSS rgba() string — so renderers consume the
+ * result through the exact same string paths as static schema values.
+ * Falls back to the static color otherwise.
+ */
+export declare function resolveColorProperty(element: BaseElement, property: string, staticColor: string | undefined, ctx: RenderContext): string | undefined;
+/**
+ * Resolve the element's shear angles (degrees, CSS skewX/skewY
+ * semantics) at the current time. Animatable like any other property.
+ */
+export declare function resolveSkewPair(element: BaseElement, ctx: RenderContext): {
+    skewX: number;
+    skewY: number;
+};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/compositor/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/compositor/resolve.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAc9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,aAAa,GACjB,MAAM,CAoCR;AAgFD;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,aAAa,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBlD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAMpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,EAAE,CAKtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,aAAa,GACjB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAK5B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAUnC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,EAAE,aAAa,GACjB,MAAM,GAAG,SAAS,CAYpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,aAAa,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKlC"}

package/dist/compositor/resolve.js

@@ -0,0 +1,276 @@
+// Animation-aware property resolution.
+//
+// Each element renderer first resolves the static schema value (e.g.
+// `element.x → 100 pixels`), then calls applyAnimation() to overlay any
+// active keyframe animation or named-preset tween for that property.
+//
+// Precedence (highest wins):
+//   1. Keyframe animation matching the property
+//   2. Named-preset tween (relative = added to static, absolute = replaces)
+//   3. Static schema value (fallback)
+import { foldKeyframeTime, interpolateColorKeyframes, interpolateKeyframes, isColorKeyframes, } from '../animation/keyframes.js';
+import { noise1d } from '../animation/noise1d.js';
+import { isExpr, evalExpr } from '../animation/expr.js';
+import { resolveMotionPath } from '../animation/motion-path.js';
+import { compileAnimation } from '../animation/presets.js';
+import { applyEasing } from '../animation/easings.js';
+import { rgbaToCss } from './color.js';
+import { resolveLength } from './unit.js';
+/**
+ * Apply animations to a property's static value. Returns the static value
+ * unchanged if no animation targets this property at the current time.
+ */
+export function applyAnimation(element, property, staticValue, ctx) {
+    // Group children's `time` is relative to the group's start —
+    // ctx.timeOffset carries that base (0 at the root).
+    const elementStart = ctx.timeOffset + numberOrZero(element.time);
+    const elementDuration = parseDuration(element.duration, ctx.sourceDuration - elementStart);
+    // Clamp to the element's lifespan. The active-window check computes
+    // the element's end as start + duration while this computes
+    // time - start; at exact frame boundaries (the exporter samples
+    // N/framerate precisely) float asymmetry can make localTime land a
+    // hair PAST elementDuration while the element is still considered
+    // active — skipping every end-anchored tween for one frame and
+    // flashing the static value (the "fade-out flickers back" export
+    // bug). An element's local time can't exceed its own duration.
+    const localTime = Math.min(ctx.time - elementStart, elementDuration);
+    // 0. A spatial motion path (§6.7) drives x and y — and z on 3D
+    //    paths — and, with auto_orient, adds the xy travel direction to
+    //    rotation (in-plane only; dz never orients).
+    if (property === 'x' || property === 'y' || property === 'z' || property === 'rotation') {
+        const path = resolveMotionPath(element, localTime);
+        if (path) {
+            if (property === 'x')
+                return path.x;
+            if (property === 'y')
+                return path.y;
+            if (property === 'z' && path.z !== null)
+                return path.z;
+            if (property === 'rotation' && path.autoOrient) {
+                // Resolve the element's own rotation normally, then orient.
+                const base = scalarAnimation(element, 'rotation', staticValue, localTime, elementDuration);
+                return base + path.angle;
+            }
+        }
+    }
+    return scalarAnimation(element, property, staticValue, localTime, elementDuration);
+}
+/** The scalar resolution chain (expression → keyframes → presets → static). */
+function scalarAnimation(element, property, staticValue, localTime, elementDuration) {
+    // 0. A Tier-A expression on the property (§Expressions) — a pure function of
+    //    `t`/`i`/`n`/`dur`/`value` — overrides everything. `z_rotation` shares the
+    //    `rotation` slot.
+    const raw = element[property]
+        ?? (property === 'rotation' ? element.z_rotation : undefined);
+    if (isExpr(raw)) {
+        return evalExpr(raw, { t: localTime, dur: elementDuration, i: 0, n: 1, value: staticValue });
+    }
+    // 1. Keyframe animations override the static value. `z_rotation` is
+    //    the same slot as `rotation` (§4.4) — accept either spelling.
+    const keyframeAnims = element.keyframe_animations;
+    if (keyframeAnims) {
+        for (const kf of keyframeAnims) {
+            if (kf.property === property || (property === 'rotation' && kf.property === 'z_rotation')) {
+                return interpolateKeyframes(kf.keyframes, foldKeyframeTime(kf.keyframes, kf.loop, localTime));
+            }
+        }
+    }
+    // 2. Named animations apply tweens. Relative tweens add to static,
+    //    absolute tweens replace.
+    const namedAnims = element.animations;
+    if (namedAnims && namedAnims.length > 0) {
+        let result = staticValue;
+        let modified = false;
+        for (const anim of namedAnims) {
+            const tweens = compileAnimation(anim, elementDuration);
+            for (const tween of tweens) {
+                if (tween.property !== property)
+                    continue;
+                const tweenEnd = tween.startTime + tween.duration;
+                if (localTime < tween.startTime) {
+                    // Before the window: fill-backward tweens (entrance presets)
+                    // hold their `from` value so a delayed entrance stays hidden at
+                    // frame 0; everything else releases back to the static value.
+                    if (!tween.fillBackwards)
+                        continue;
+                    result = tween.relative ? staticValue + tween.from : tween.from;
+                    modified = true;
+                    continue;
+                }
+                // Past the window: fill-forward tweens keep applying their end
+                // value; everything else releases back to the static value.
+                if (localTime > tweenEnd && !tween.hold)
+                    continue;
+                const span = tween.duration > 0 ? Math.min(1, (localTime - tween.startTime) / tween.duration) : 1;
+                const easedT = applyEasing(tween.easing, span);
+                let tweenValue = tween.from + (tween.to - tween.from) * easedT;
+                if (tween.oscillate) {
+                    // from/to define the amplitude envelope; the value oscillates
+                    // around 0 so oscillating tweens are inherently relative.
+                    const ot = localTime - tween.startTime;
+                    tweenValue *= tween.oscillate.noise
+                        ? (noise1d(tween.oscillate.frequency * ot, tween.oscillate.noise.seed) - 0.5) * 2
+                        : Math.sin(2 * Math.PI * tween.oscillate.frequency * ot + (tween.oscillate.phase ?? 0));
+                }
+                result = tween.relative ? staticValue + tweenValue : tweenValue;
+                modified = true;
+            }
+        }
+        if (modified)
+            return result;
+    }
+    return staticValue;
+}
+/**
+ * Resolve the element's CKP/1.0 3D transform (§4.4.1) at the current
+ * time. Returns null when the element carries none of the 3D fields —
+ * the renderer's signal to stay on the byte-stable 2D fast path.
+ * `z_rotation` is NOT 3D (it's the in-plane `rotation` alias, resolved
+ * through the normal rotation slot).
+ */
+export function resolve3D(element, ctx) {
+    const el = element;
+    const has = el.x_rotation !== undefined || el.y_rotation !== undefined || el.z !== undefined ||
+        element.keyframe_animations?.some((k) => k.property === 'x_rotation' || k.property === 'y_rotation' || k.property === 'z' ||
+            // A 3D position path (§6.7) drives z, so it puts the element
+            // on the matrix path even with no 3D fields authored.
+            (k.property === 'position' &&
+                k.keyframes.some((kf) => Array.isArray(kf.value) && kf.value.length === 3)));
+    if (!has)
+        return null;
+    return {
+        xRot: applyAnimation(element, 'x_rotation', staticNumber(el.x_rotation), ctx),
+        yRot: applyAnimation(element, 'y_rotation', staticNumber(el.y_rotation), ctx),
+        z: applyAnimation(element, 'z', staticNumber(el.z), ctx),
+    };
+}
+function staticNumber(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : 0;
+}
+/**
+ * §4.4.3 depth key: the EYE-SPACE z of the element's anchor under the
+ * current model matrix. The perspective matrix P leaves the z output row
+ * untouched (its row 2 is [0,0,1,0]), so the z component of `M·anchor`
+ * is the eye-space depth whether or not a camera/perspective is present —
+ * with no camera it is simply `element.z`. LARGER z = nearer the viewer.
+ * Resolved with the same `applyAnimation` / `resolve3D` path the renderer
+ * uses, so the sort matches what's drawn.
+ */
+export function cameraDepthZ(el, ctx) {
+    const m = ctx.modelMatrix.e;
+    const x = applyAnimation(el, 'x', resolveLength(el.x, ctx.canvas.width, ctx.canvas), ctx);
+    const y = applyAnimation(el, 'y', resolveLength(el.y, ctx.canvas.height, ctx.canvas), ctx);
+    const z = resolve3D(el, ctx)?.z ?? 0;
+    return m[2] * x + m[6] * y + m[10] * z + m[14];
+}
+/**
+ * Stable back-to-front order by depth (farthest painted first → nearest
+ * on top). `elements` MUST already be in `track` order; equal depths fall
+ * back to that order (the explicit index tiebreak keeps it stable across
+ * engines). Sorting by ascending eye-space z puts the farthest (smallest
+ * z) first. Used by the scene and plain-group child walkers when
+ * `ctx.depthSort` is set. With all z equal (e.g. a 2D doc) this is a
+ * stable no-op → pure track order.
+ */
+export function depthOrder(elements, ctx) {
+    return elements
+        .map((el, i) => ({ el, i, z: cameraDepthZ(el, ctx) }))
+        .sort((a, b) => a.z - b.z || a.i - b.i)
+        .map((o) => o.el);
+}
+/**
+ * Resolve the element's effective per-axis scale at the current time:
+ * uniform `scale` (factor, default 1) multiplied with per-axis
+ * `x_scale` / `y_scale` (factor, or "N%" string). All three are
+ * animatable — via keyframe_animations or preset tweens (scale-in,
+ * squash, …).
+ *
+ * Renderers multiply their resolved width/height (and, for glyph-based
+ * renderers, glyph offsets around the pivot) by the returned factors.
+ */
+export function resolveScalePair(element, ctx) {
+    const uniform = applyAnimation(element, 'scale', scaleOr(element.scale, 1), ctx);
+    const xs = applyAnimation(element, 'x_scale', scaleOr(element.x_scale, 1), ctx);
+    const ys = applyAnimation(element, 'y_scale', scaleOr(element.y_scale, 1), ctx);
+    return { sx: uniform * xs, sy: uniform * ys };
+}
+/**
+ * Derive the missing box dimension from `aspect_ratio` (width/height).
+ * Only applies when EXACTLY ONE of width/height is authored — both or
+ * neither leaves the resolved values untouched.
+ */
+export function applyAspectRatio(element, width, height) {
+    const ar = element.aspect_ratio;
+    if (typeof ar !== 'number' || !(ar > 0))
+        return { width, height };
+    if (element.width !== undefined && element.height === undefined) {
+        return { width, height: width / ar };
+    }
+    if (element.height !== undefined && element.width === undefined) {
+        return { width: height * ar, height };
+    }
+    return { width, height };
+}
+/**
+ * Resolve a color property (fill_color, stroke_color, …) at the current
+ * time. When a keyframe_animation targets the property with color-string
+ * values, the colors are lerped componentwise in straight-alpha RGB
+ * space and returned as a CSS rgba() string — so renderers consume the
+ * result through the exact same string paths as static schema values.
+ * Falls back to the static color otherwise.
+ */
+export function resolveColorProperty(element, property, staticColor, ctx) {
+    const keyframeAnims = element.keyframe_animations;
+    if (keyframeAnims) {
+        for (const kf of keyframeAnims) {
+            if (kf.property === property && isColorKeyframes(kf.keyframes)) {
+                const elementStart = ctx.timeOffset + numberOrZero(element.time);
+                const localTime = foldKeyframeTime(kf.keyframes, kf.loop, ctx.time - elementStart);
+                return rgbaToCss(interpolateColorKeyframes(kf.keyframes, localTime));
+            }
+        }
+    }
+    return staticColor;
+}
+/**
+ * Resolve the element's shear angles (degrees, CSS skewX/skewY
+ * semantics) at the current time. Animatable like any other property.
+ */
+export function resolveSkewPair(element, ctx) {
+    return {
+        skewX: applyAnimation(element, 'x_skew', numberOrZero(element.x_skew), ctx),
+        skewY: applyAnimation(element, 'y_skew', numberOrZero(element.y_skew), ctx),
+    };
+}
+/** Parse a scale factor: number as-is, "150%" → 1.5, anything else → fallback. */
+function scaleOr(v, fallback) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string') {
+        const n = parseFloat(v);
+        if (Number.isFinite(n))
+            return v.trim().endsWith('%') ? n / 100 : n;
+    }
+    return fallback;
+}
+function numberOrZero(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string') {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : 0;
+    }
+    return 0;
+}
+function parseDuration(v, fallback) {
+    if (v === 'auto' || v === 'end' || v == null)
+        return fallback;
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string') {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : fallback;
+    }
+    return fallback;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/compositor/resolve.js.map

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

package/dist/compositor/scene.d.ts

@@ -0,0 +1,10 @@
+import type { Source } from '@clipkit/protocol';
+import type { RenderContext } from './render-context.js';
+/**
+ * Render one frame of the source at the given time.
+ * Caller is responsible for backend.beginFrame() / endFrame() — this lets
+ * the runtime use the same scene-render code for preview and export
+ * without worrying about who controls the frame lifecycle.
+ */
+export declare function renderSourceFrame(source: Source, ctx: RenderContext): void;
+//# sourceMappingURL=scene.d.ts.map

package/dist/compositor/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/compositor/scene.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAmF,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAoBjI,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA2B1E"}