@glissade/scene 0.56.0 → 0.57.0

package/dist/index.d.ts

@@ -3,9 +3,9 @@ import { $ as isEstimatingMeasurer, A as hachureLines, B as Node, C as HachureSp
 import { t as collapseReplacer } from "./collapseReplacer.js";
 import { a as SceneModule, c as evaluate, i as SceneInit, n as ReservedNodeIdError, o as bindScene, r as Scene, s as createScene, t as DuplicateNodeIdError } from "./scene.js";
 import { a as typewriter, c as textCursor, i as TypewriterResult, n as StepMark, o as TextCursor, r as TypeEdit, s as TextCursorProps, t as EditMark } from "./typewriter.js";
+import { a as EachLayout, c as EachResult, i as EachError, l as Place, n as EachContext, o as EachMotion, r as EachDistribute, s as EachOpts, t as EachBox, u as each } from "./each.js";
 import { a as LayoutEngineMissingError, c as requireLayoutEngine, i as LayoutEngine, l as setLayoutEngine, n as LayoutChildSpec, r as LayoutContainerSpec, s as getLayoutEngine, t as LayoutBox } from "./layoutEngine.js";
-import { BindableSignal, CoverageReport, EaseSpec, FontMode, FontUsage, MeshPaint as MeshPaint$1, Rng, Timeline, Track } from "@glissade/core";
-import { ChannelOverride, Clip } from "@glissade/core/clips";
+import { BindableSignal, EaseSpec, MeshPaint as MeshPaint$1, Track } from "@glissade/core";
 
 //#region src/taxonomy.d.ts
 
@@ -51,125 +51,6 @@ declare class Highlight extends Node {
 /** `children: [highlight(title, { color: '#ffe066' }), title]` — marker behind the text. */
 declare function highlight(text: Text, props?: Omit<HighlightProps, 'text'>): Highlight;
 //#endregion
-//#region src/each.d.ts
-/** An aspect-fraction placement: [fx, fy], each conventionally in [0, 1]. */
-type Place = readonly [number, number];
-/**
- * Built-in layouts (a discriminated union — NOT factory fns) plus the escape
- * hatch `(i, n) => [fx, fy]`. Every built-in is PURE arithmetic in aspect
- * fractions; mapping to px happens only when `box` is given (see `places`).
- */
-type EachLayout = {
-  kind: 'row';
-  gap?: number;
-  align?: number;
-} | {
-  kind: 'column';
-  gap?: number;
-  align?: number;
-} | {
-  kind: 'grid';
-  cols: number;
-  rows?: number;
-  gapX?: number;
-  gapY?: number;
-  order?: 'row' | 'column';
-} | {
-  kind: 'ring';
-  radius?: number;
-  center?: Place;
-  startAngle?: number;
-  sweep?: number;
-} | ((i: number, n: number) => Place);
-/** How a `stagger` delay distributes across the clones. */
-type EachDistribute = 'delay' | 'from-center' | 'from-edges';
-/** Per-index motion: a clip fanned across the clones with stagger + jitter. */
-interface EachMotion {
-  /** The motion clip applied to every clone (TYPE: `Clip` from core/clips). */
-  clip: Clip;
-  /** Wall-clock start second of the first clone. Default 0. */
-  startSec?: number;
-  /** Per-index delay (seconds) or a function of the index. Default 0. */
-  stagger?: number | ((i: number) => number);
-  /**
-   * Shape a numeric `stagger` gap into a distribution. `from-center` ramps the
-   * delay outward from the middle clone, `from-edges` inward toward it; `delay`
-   * (the default) is the plain `i * gap` ramp. Ignored when `stagger` is a fn.
-   */
-  distribute?: EachDistribute;
-  /** Per-index clip overrides, seeded — `(i, rng, n) => overrides`. */
-  jitter?: (i: number, rng: Rng, n: number) => Record<string, ChannelOverride>;
-  /** Clip speed (passed straight to `clip.apply`). */
-  speed?: number;
-}
-/** Pixel box for mapping aspect-fraction places to a concrete coordinate frame. */
-interface EachBox {
-  w: number;
-  h: number;
-  /** Top-left of the box in scene coords; default [0, 0]. */
-  origin?: Place;
-}
-interface EachOpts {
-  /** Stable id prefix; clones are `${id}/${i}`, the wrapping group is `${id}`. */
-  id: string;
-  layout: EachLayout;
-  motion?: EachMotion;
-  /** Seed for per-clone RNG; defaults to a stable hash of `id`. */
-  seed?: number;
-  /** When given, `places` also carries the px-mapped points (see EachResult). */
-  box?: EachBox;
-}
-/** The per-clone authoring context handed to the factory. */
-interface EachContext {
-  /** Clone index, 0..n-1. */
-  i: number;
-  /** Total clone count. */
-  n: number;
-  /** This clone's id (`${opts.id}/${i}`). */
-  id: string;
-  /** Aspect-fraction placement [fx, fy] — ALWAYS a fraction (px is separate). */
-  place: Place;
-  /** Seeded generator for this clone: `random(mix(seed, i))`. */
-  rng: Rng;
-  /** The resolved base seed (`opts.seed ?? hash(id)`). */
-  seed: number;
-}
-interface EachResult {
-  /** The wrapping group (`id: opts.id`) holding every generated child. */
-  node: Group;
-  /** The generated children, in index order. */
-  children: Node[];
-  /** The compiled motion tracks (empty when no `motion`). */
-  tracks: Track[];
-  /** Max child clip end (== startSec when no motion). */
-  end: number;
-  /**
-   * Per-clone placement. `frac` is the aspect-fraction [fx, fy] every layout
-   * produces; `px` is present only when `opts.box` was given (frac mapped into
-   * the box). Authoring a `box` once here is the single place fraction→px lives.
-   */
-  places: {
-    frac: Place;
-    px?: Place;
-  }[];
-}
-declare class EachError extends Error {
-  constructor(message: string);
-}
-/**
- * Generate `n` clones from `factory`, lay them out, and (optionally) stagger a
- * motion clip across them.
- *
- *   const grid = each(9, (i) => new Rect({ width: 40, height: 40, fill: '#9ef0c0' }), {
- *     id: 'card',
- *     layout: { kind: 'grid', cols: 3 },
- *     box: { w: 600, h: 360 },
- *     motion: { clip: popIn(), stagger: 0.08, distribute: 'from-center' },
- *   });
- *   // scene children: [grid.node]; timeline tracks: [...grid.tracks]
- */
-declare function each(n: number, factory: (i: number, ctx: EachContext) => Node, opts: EachOpts): EachResult;
-//#endregion
 //#region src/drawOn.d.ts
 interface DrawOnOptions {
   /** when the stroke-on starts, seconds; default 0 */
@@ -277,45 +158,6 @@ interface RenderBackend extends TextMeasurer {
   dispose(): void;
 }
 //#endregion
-//#region src/fontUsage.d.ts
-/** Walk `scene` for Text nodes; one usage per node carrying its full text. */
-declare function collectTextUsages(scene: Scene): FontUsage[];
-/**
- * Collect font usages from the POST-localize document's STRING tracks (FIX 3,
- * 0.14 canary). For every `'string'` track whose target node is a Text node,
- * emit one usage per distinct localized KEY VALUE under that node's fontFamily —
- * so a localized CJK message bound to a Latin-only font surfaces as an uncovered
- * glyph. `collectTextUsages` only sees the authored BASE `node.text()`, which is
- * resolved BEFORE the localized string tracks bind, so it misses this.
- */
-declare function collectLocalizedTextUsages(scene: Scene, doc: Timeline): FontUsage[];
-/**
- * Caller-supplied I/O: fetch the raw bytes for a font face URL (the export
- * paths read a file / fetch a URL; this keeps core pure). Returning undefined
- * means "could not load" — that family contributes no coverage, surfacing as
- * missing glyphs (strict) / a dev warning, never a hang.
- */
-type FontByteLoader = (url: string) => Promise<ArrayBuffer | undefined>;
-interface ValidateSceneFontsOptions {
-  mode?: FontMode;
-  /** OS-installed families to treat as registered (case-insensitive). */
-  osFamilies?: ReadonlySet<string> | undefined;
-  /**
-   * Additional usages to validate alongside the scene's authored Text (FIX 3):
-   * the POST-localize document's localized string-track values, which the
-   * scene-walk can't see (they bind AFTER `node.text()` is read). Build them
-   * with `collectLocalizedTextUsages(scene, localizedDoc)`.
-   */
-  extraUsages?: readonly FontUsage[] | undefined;
-}
-/**
- * Run §3.6 font validation for a scene + its timeline document. Builds the
- * registry from `doc.assets`, loads each registered face's cmap via `loadBytes`
- * (once per family — the first face's URL is enough for coverage), and runs the
- * pure `validateFonts`. Strict mode throws FontValidationError; dev warns.
- */
-declare function validateSceneFonts(scene: Scene, doc: Timeline, loadBytes: FontByteLoader, options?: ValidateSceneFontsOptions): Promise<CoverageReport>;
-//#endregion
 //#region src/shaderEffect.d.ts
 interface ShaderEffectProps extends NodeProps {
   children?: Node[];
@@ -651,4 +493,4 @@ declare function meshRasterSize(bw: number, bh: number): {
   h: number;
 };
 //#endregion
-export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type Bounds, type CanvasLike, Circle, type ClipRegion, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, Echo, type EchoProps, type EditMark, type EvalContext, type FilterKind, type FilterSpec, FilterValidationError, type FontByteLoader, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayerCacheEntry, type LayerStore, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, MotionBlur, type MotionBlurProps, NODE_TAXONOMY, Node, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, TrackMatte, type TrackMatteProps, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, type WrappedTextMetrics, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, trackMatte, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type Bounds, type CanvasLike, Circle, type ClipRegion, ColdAssetError, type Ctx2DLike, Custom, DeterminismViolationError, type DisplayList, type DisplayListBuilder, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, Echo, type EchoProps, type EditMark, type EvalContext, type FilterKind, type FilterSpec, FilterValidationError, type FontSpec, type GraphemeBox, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, type LayerCacheEntry, type LayerStore, type LayoutBox, type LayoutChildSpec, type LayoutContainerSpec, type LayoutEngine, LayoutEngineMissingError, type LineBox, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, type Mat2x3, type MeshInterpolation, type MeshPaint, type MeshPoint, MotionBlur, type MotionBlurProps, NODE_TAXONOMY, Node, NodeConstructionError, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSeg, type Place, type Polyline, type PropInit, Raster2D, type Raster2DHost, Rect, type Rect$1 as RectShape, type RenderBackend, ReservedNodeIdError, type ResolvedSketch, type Resource, type ResourceId, type RevealMark, type Scene, type SceneInit, type SceneModule, type ShaderCaps, ShaderEffect, type ShaderEffectProps, type ShaderRef, type ShapeProps, type SketchStyle, SketchValidationError, type StepMark, type StrokeStyle, Text, TextCursor, type TextCursorProps, type TextMeasurer, type TextMetricsLite, type TextProps, TrackMatte, type TrackMatteProps, type TypeEdit, type TypewriterResult, Video, type VideoFrameSource, type VideoProps, type WordBox, type WrappedTextMetrics, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, trackMatte, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };

package/dist/index.js

@@ -1,9 +1,10 @@
-import { $ as multiply, A as __resetEstimateWarnings, B as setDefaultMeasurer, C as Node, F as isEstimatingMeasurer, G as glow, H as FilterValidationError, I as measureWrappedText, J as IDENTITY, K as validateFilters, L as quantize, M as breakLines, N as estimatingMeasurer, Q as matEquals, R as segmentGraphemes, S as validateSketch, T as resolveAnchor, U as createDisplayListBuilder, W as filtersToCanvasFilter, X as fromTRS, Y as applyToPoint, Z as invert, _ as hashStr, a as Path, b as sketchStrokes, c as Video, d as revealSchedule, f as roundedRectSegs, g as hachureLines, h as flatten, i as ImageNode, j as assertFiniteFontSize, k as MEASURE_QUANTUM_PX, l as coercePathData, m as arcLength, n as Custom, o as Rect, p as SketchValidationError, q as collapseReplacer, r as Group, s as Text, t as Circle, u as pathFromSegs, v as resolveSketch, w as NodeConstructionError, x as validateHachure, y as roughen, z as segmentWords } from "./nodes.js";
+import { $ as multiply, A as __resetEstimateWarnings, B as setDefaultMeasurer, C as Node, F as isEstimatingMeasurer, G as glow, H as FilterValidationError, I as measureWrappedText, J as IDENTITY, K as validateFilters, L as quantize, M as breakLines, N as estimatingMeasurer, Q as matEquals, R as segmentGraphemes, S as validateSketch, T as resolveAnchor, U as createDisplayListBuilder, W as filtersToCanvasFilter, X as fromTRS, Y as applyToPoint, Z as invert, a as Path, b as sketchStrokes, c as Video, d as revealSchedule, f as roundedRectSegs, g as hachureLines, h as flatten, i as ImageNode, j as assertFiniteFontSize, k as MEASURE_QUANTUM_PX, l as coercePathData, m as arcLength, n as Custom, o as Rect, p as SketchValidationError, q as collapseReplacer, r as Group, s as Text, t as Circle, u as pathFromSegs, v as resolveSketch, w as NodeConstructionError, x as validateHachure, y as roughen, z as segmentWords } from "./nodes.js";
 import { a as evaluate, i as createScene, n as ReservedNodeIdError, r as bindScene, t as DuplicateNodeIdError } from "./scene.js";
 import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
 import { n as TextCursor, r as textCursor, t as typewriter } from "./typewriter.js";
 import { i as echo, n as motionBlur, r as Echo, t as MotionBlur } from "./motionBlur.js";
-import { buildFontRegistry, emitDevWarning, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts } from "@glissade/core";
+import { n as each, t as EachError } from "./each.js";
+import { emitDevWarning, key, lerpColor, oklabToRgba, parseColor, rgbaToOklab, signal, stagger, track } from "@glissade/core";
 //#region src/taxonomy.ts
 /**
 * The CLOSED node taxonomy (DESIGN.md §3.1): exactly nine built-in node TYPES.
@@ -108,171 +109,6 @@ function init(sig, v) {
 	return sig;
 }
 //#endregion
-//#region src/each.ts
-/**
-* `each()` — deterministic parametric instancing (0.13 clip-tier sugar). Pure
-* BUILD-TIME fan-out: it generates N scene nodes from a factory, lays them out
-* in aspect-fraction space, and (optionally) staggers a motion `clip` across
-* them — compiling to ordinary keyed `Track[]` plus a `Group` of children with
-* stable `${id}/${i}` ids. Nothing executes at play time; the emitted tracks are
-* byte-indistinguishable from hand-authored ones, so goldens hold by
-* construction and every `--workers` export shard reconstructs the same id set.
-*
-* The clip runtime is imported TYPE-ONLY (the `Clip` instance the author passes
-* carries its own `apply`), so `each` adds no clip bytes to the embed: the
-* `@glissade/core/clips` runtime lands in the consumer's bundle, never scene's.
-*/
-var EachError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "EachError";
-	}
-};
-/**
-* Fold a base seed and an index into a fresh per-clone seed. splitmix-style
-* avalanche so adjacent indices decorrelate (a bare `seed + i` would hand
-* near-identical streams to neighbours).
-*/
-function mix(seed, i) {
-	let h = (seed ^ Math.imul(i + 1, 2654435769)) >>> 0;
-	h = Math.imul(h ^ h >>> 16, 569420461);
-	h = Math.imul(h ^ h >>> 15, 1935289751);
-	return (h ^ h >>> 15) >>> 0;
-}
-/**
-* Salt folded into the motion-jitter seed so the per-index jitter rng
-* decorrelates from `ctx.rng` (the factory rng). Both axes derive from
-* `mix(baseSeed, i)`; without a distinct salt they would be the SAME stream,
-* so a factory that draws from `ctx.rng` and a `jitter` callback would see
-* correlated "independent" randomness. An arbitrary fixed odd constant.
-*/
-const JITTER_SALT = 1779033703;
-/** Resolve a built-in layout (or call the escape-hatch fn) to a fraction. */
-function placeAt(layout, i, n) {
-	if (typeof layout === "function") return layout(i, n);
-	switch (layout.kind) {
-		case "row": {
-			const gap = layout.gap ?? (n > 1 ? 1 / (n - 1) : 0);
-			const align = layout.align ?? .5;
-			const x0 = .5 - gap * (n - 1) / 2;
-			return [n === 1 ? .5 : x0 + gap * i, align];
-		}
-		case "column": {
-			const gap = layout.gap ?? (n > 1 ? 1 / (n - 1) : 0);
-			const align = layout.align ?? .5;
-			const y0 = .5 - gap * (n - 1) / 2;
-			return [align, n === 1 ? .5 : y0 + gap * i];
-		}
-		case "grid": {
-			const cols = layout.cols;
-			if (!(cols >= 1)) throw new EachError(`grid layout needs cols >= 1 (got ${cols})`);
-			const rows = layout.rows ?? Math.ceil(n / cols);
-			const order = layout.order ?? "row";
-			const col = order === "row" ? i % cols : Math.floor(i / rows);
-			const row = order === "row" ? Math.floor(i / cols) : i % rows;
-			const gapX = layout.gapX ?? (cols > 1 ? 1 / (cols - 1) : 0);
-			const gapY = layout.gapY ?? (rows > 1 ? 1 / (rows - 1) : 0);
-			const spanX = gapX * (cols - 1);
-			const spanY = gapY * (rows - 1);
-			return [cols === 1 ? .5 : .5 - spanX / 2 + gapX * col, rows === 1 ? .5 : .5 - spanY / 2 + gapY * row];
-		}
-		case "ring": {
-			const radius = layout.radius ?? .5;
-			const [cx, cy] = layout.center ?? [.5, .5];
-			const theta = (layout.startAngle ?? -Math.PI / 2) + (layout.sweep ?? Math.PI * 2) * (n === 0 ? 0 : i / n);
-			return [cx + radius * Math.cos(theta), cy + radius * Math.sin(theta)];
-		}
-	}
-}
-/** Compile a `distribute` mode + numeric gap into a stagger delay fn. */
-function distributeFn(distribute, gap, n) {
-	const mid = (n - 1) / 2;
-	switch (distribute) {
-		case "from-center": return (i) => Math.abs(i - mid) * gap;
-		case "from-edges": return (i) => (mid - Math.abs(i - mid)) * gap;
-		case "delay": return (i) => i * gap;
-	}
-}
-/** Resolve the motion's per-index delay into a plain `(i) => seconds` fn. */
-function staggerFn(motion, n) {
-	const s = motion.stagger ?? 0;
-	if (typeof s === "function") return s;
-	return distributeFn(motion.distribute ?? "delay", s, n);
-}
-/**
-* Generate `n` clones from `factory`, lay them out, and (optionally) stagger a
-* motion clip across them.
-*
-*   const grid = each(9, (i) => new Rect({ width: 40, height: 40, fill: '#9ef0c0' }), {
-*     id: 'card',
-*     layout: { kind: 'grid', cols: 3 },
-*     box: { w: 600, h: 360 },
-*     motion: { clip: popIn(), stagger: 0.08, distribute: 'from-center' },
-*   });
-*   // scene children: [grid.node]; timeline tracks: [...grid.tracks]
-*/
-function each(n, factory, opts) {
-	if (!Number.isInteger(n) || n < 0) throw new EachError(`each() count must be a non-negative integer (got ${n})`);
-	const baseSeed = (opts.seed ?? hashStr(opts.id)) >>> 0;
-	const box = opts.box;
-	const [ox, oy] = box?.origin ?? [0, 0];
-	const children = [];
-	const places = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (let i = 0; i < n; i++) {
-		const id = `${opts.id}/${i}`;
-		const frac = placeAt(opts.layout, i, n);
-		const ctx = {
-			i,
-			n,
-			id,
-			place: frac,
-			rng: random(mix(baseSeed, i)),
-			seed: baseSeed
-		};
-		const child = factory(i, ctx);
-		if (!(child instanceof Node)) throw new EachError(`each() factory must return a Node for index ${i} (got ${typeof child})`);
-		if (seen.has(child)) throw new EachError(`each() factory returned the same Node instance for index ${i} — the factory must construct a new node per index (it is called once per clone)`);
-		seen.add(child);
-		if (child.id === void 0) child.id = id;
-		else if (child.id !== id) throw new EachError(`each() factory set id '${child.id}' on index ${i}, but each owns the id namespace — leave it unset so it becomes '${id}'`);
-		children.push(child);
-		places.push(box ? {
-			frac,
-			px: [ox + frac[0] * box.w, oy + frac[1] * box.h]
-		} : { frac });
-	}
-	const node = new Group({
-		id: opts.id,
-		children
-	});
-	const tracks = [];
-	let end = opts.motion?.startSec ?? 0;
-	if (opts.motion) {
-		const m = opts.motion;
-		const start = m.startSec ?? 0;
-		const at = staggerFn(m, n);
-		for (let i = 0; i < n; i++) {
-			const rngI = random(mix(mix(baseSeed, i), JITTER_SALT));
-			const overrides = m.jitter?.(i, rngI, n);
-			const applyOpts = {
-				...overrides !== void 0 ? { overrides } : {},
-				...m.speed !== void 0 ? { speed: m.speed } : {}
-			};
-			const r = m.clip.apply(`${opts.id}/${i}`, start + at(i), applyOpts);
-			tracks.push(...r.tracks);
-			if (r.end > end) end = r.end;
-		}
-	}
-	return {
-		node,
-		children,
-		tracks,
-		end,
-		places
-	};
-}
-//#endregion
 //#region src/drawOn.ts
 /**
 * Whiteboard kit: one-call "draw this shape on" tracks. A stroked or sketched
@@ -388,84 +224,6 @@ const ALL_FILTER_KINDS = new Set([
 	"saturate"
 ]);
 //#endregion
-//#region src/fontUsage.ts
-/**
-* Scene → font-validation bridge (DESIGN.md §3.6). Core owns the AssetRef,
-* FontRegistry, cmap reader, and the pure validation; this module owns the
-* node-walk (which only `scene` can do) and the I/O seam that loads a font
-* face's bytes so core stays DOM/Node-free.
-*
-* `collectTextUsages` walks every Text node and reads the FULL `.text()` (not
-* the reveal-masked prefix) — coverage is a property of the authored content,
-* independent of the playhead, so it stays out of the pure evaluate() path.
-*/
-/** Walk `scene` for Text nodes; one usage per node carrying its full text. */
-function collectTextUsages(scene) {
-	const out = [];
-	const visit = (node) => {
-		if (node instanceof Text) {
-			const text = node.text();
-			if (text) out.push({
-				family: node.fontFamily,
-				text
-			});
-		}
-		if (node instanceof Group) for (const child of node.children) visit(child);
-	};
-	visit(scene.root);
-	return out;
-}
-/** The node-id of a track target ('<nodeId>/<prop.path>' → '<nodeId>'). */
-function nodeIdOf(target) {
-	const slash = target.indexOf("/");
-	return slash >= 0 ? target.slice(0, slash) : target;
-}
-/**
-* Collect font usages from the POST-localize document's STRING tracks (FIX 3,
-* 0.14 canary). For every `'string'` track whose target node is a Text node,
-* emit one usage per distinct localized KEY VALUE under that node's fontFamily —
-* so a localized CJK message bound to a Latin-only font surfaces as an uncovered
-* glyph. `collectTextUsages` only sees the authored BASE `node.text()`, which is
-* resolved BEFORE the localized string tracks bind, so it misses this.
-*/
-function collectLocalizedTextUsages(scene, doc) {
-	const out = [];
-	for (const tr of doc.tracks) {
-		if (tr.type !== "string") continue;
-		const node = scene.nodes.get(nodeIdOf(tr.target));
-		if (!(node instanceof Text)) continue;
-		for (const k of tr.keys) {
-			const value = k.value;
-			if (typeof value === "string" && value) out.push({
-				family: node.fontFamily,
-				text: value
-			});
-		}
-	}
-	return out;
-}
-/**
-* Run §3.6 font validation for a scene + its timeline document. Builds the
-* registry from `doc.assets`, loads each registered face's cmap via `loadBytes`
-* (once per family — the first face's URL is enough for coverage), and runs the
-* pure `validateFonts`. Strict mode throws FontValidationError; dev warns.
-*/
-async function validateSceneFonts(scene, doc, loadBytes, options = {}) {
-	const mode = options.mode ?? "dev";
-	const registry = buildFontRegistry(doc.assets);
-	const usages = [...collectTextUsages(scene), ...options.extraUsages ?? []];
-	const wanted = /* @__PURE__ */ new Set();
-	for (const u of usages) if (registry.has(u.family)) for (const f of registry.fallbackChain(u.family)) wanted.add(f);
-	const cmaps = /* @__PURE__ */ new Map();
-	for (const family of wanted) {
-		const face = registry.resolveFace(family);
-		if (!face) continue;
-		const bytes = await loadBytes(face.url);
-		if (bytes) cmaps.set(family, parseCmap(bytes));
-	}
-	return validateFonts(usages, registry, cmaps, mode, { ...options.osFamilies !== void 0 ? { osFamilies: options.osFamilies } : {} });
-}
-//#endregion
 //#region src/assets.ts
 var ColdAssetError = class extends Error {
 	assetId;
@@ -1310,4 +1068,4 @@ var Raster2D = class {
 	}
 };
 //#endregion
-export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DeterminismViolationError, DuplicateNodeIdError, EachError, Echo, FilterValidationError, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, MotionBlur, NODE_TAXONOMY, Node, NodeConstructionError, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TrackMatte, Video, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, trackMatte, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DeterminismViolationError, DuplicateNodeIdError, EachError, Echo, FilterValidationError, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, MotionBlur, NODE_TAXONOMY, Node, NodeConstructionError, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TrackMatte, Video, __resetEstimateWarnings, applyToPoint, arcLength, assertFiniteFontSize, bindScene, breakLines, coercePathData, collapseReplacer, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, echo, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, measureWrappedText, meshRasterSize, motionBlur, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, trackMatte, typewriter, validateFilters, validateHachure, validateSketch, withDeterminismGuards };