@glissade/scene 0.17.0 → 0.17.1

package/dist/displayList.d.ts

@@ -0,0 +1,194 @@
+import { MeshInterpolation, MeshPaint as MeshPaint$1, MeshPoint, Paint, Vec2 } from "@glissade/core";
+
+//#region src/matrix.d.ts
+
+type Mat2x3 = readonly [number, number, number, number, number, number];
+declare const IDENTITY: Mat2x3;
+declare function multiply(m1: Mat2x3, m2: Mat2x3): Mat2x3;
+/** Compose translate × rotate × scale (rotation in degrees). */
+declare function fromTRS(position: Vec2, rotationDeg: number, scale: Vec2): Mat2x3;
+/** Inverse affine: [A | t]⁻¹ = [A⁻¹ | −A⁻¹t]; null when degenerate (det 0). */
+declare function invert(m: Mat2x3): Mat2x3 | null;
+declare function applyToPoint(m: Mat2x3, p: Vec2): Vec2;
+declare function matEquals(a: Mat2x3, b: Mat2x3): boolean;
+//#endregion
+//#region src/displayList.d.ts
+type ResourceId = number;
+/**
+ * Path data as plain segments (JSON-serializable; backends build Path2D/SkPath):
+ *   M/L: point; C: cubic; Q: quadratic; Z: close
+ *   E: ellipse arc — cx, cy, rx, ry, rotationRad, startAngleRad, endAngleRad
+ */
+type PathSeg = ['M', number, number] | ['L', number, number] | ['C', number, number, number, number, number, number] | ['Q', number, number, number, number] | ['E', number, number, number, number, number, number, number] | ['Z'];
+type Resource = {
+  kind: 'path';
+  segs: PathSeg[];
+} | {
+  kind: 'image';
+  assetId: string;
+}
+/** One source-grid video frame: backends resolve via their VideoFrameSource registry (§3.8). */ | {
+  kind: 'videoFrame';
+  assetId: string;
+  mediaT: number;
+};
+type BlendMode = 'source-over' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten';
+interface StrokeStyle {
+  width: number;
+  cap?: 'butt' | 'round' | 'square';
+  join?: 'miter' | 'round' | 'bevel';
+  miterLimit?: number;
+  dash?: number[];
+  dashOffset?: number;
+}
+interface FontSpec {
+  family: string;
+  size: number;
+  weight?: number;
+  style?: 'normal' | 'italic';
+}
+/**
+ * Group filters (§3.4): a CLOSED union — validated data, never a CSS
+ * passthrough string — limited to effects both rasterizers implement
+ * faithfully. Cross-backend parity is perceptual (SSIM), not byte-exact:
+ * filters are where rasterizers diverge most. Per-backend output stays
+ * deterministic on the pinned toolchain (golden-tested on Skia).
+ */
+type FilterSpec = {
+  kind: 'blur'; /** Gaussian stdDeviation, px; ≥ 0. */
+  radius: number;
+} | {
+  kind: 'drop-shadow';
+  dx: number;
+  dy: number; /** ≥ 0 */
+  blur: number;
+  color: string;
+} | {
+  kind: 'brightness'; /** 1 = identity; ≥ 0. */
+  amount: number;
+} | {
+  kind: 'contrast'; /** 1 = identity; ≥ 0. */
+  amount: number;
+} | {
+  kind: 'saturate'; /** 1 = identity; ≥ 0. */
+  amount: number;
+};
+declare class FilterValidationError extends Error {
+  constructor(message: string);
+}
+/** Document-layer validation: reject unknown kinds and out-of-range params loudly. */
+declare function validateFilters(filters: readonly FilterSpec[]): void;
+/**
+ * Compile the validated union to the canvas 2D `ctx.filter` syntax — both
+ * backends speak it (browser canvas and @napi-rs/canvas/Skia). This is the
+ * ONLY place the CSS-like syntax appears; documents never carry it.
+ */
+declare function filtersToCanvasFilter(filters: readonly FilterSpec[]): string;
+/**
+ * Outer glow as stacked zero-offset drop-shadows — the classic recipe, fully
+ * deterministic on both backends (it is just filters). intensity stacks more
+ * layers; pair with a signal binding to follow an animated fill.
+ */
+declare function glow(color: string, radius?: number, intensity?: number): FilterSpec[];
+interface Rect {
+  x: number;
+  y: number;
+  w: number;
+  h: number;
+}
+/**
+ * Shader effect pass (§3.7): runs over the group's rasterized texture.
+ * EXPLICITLY outside the determinism guarantee — GPU/driver per-pixel
+ * variance breaks distributed reproducibility; export with shaders is
+ * best-effort, single machine. Uniform VALUES are resolved at emit time
+ * (they ride on signals), so the IR stays a plain serializable snapshot.
+ */
+interface ShaderRef {
+  /** WGSL fragment module: declare `struct Uniforms` + `@fragment fn effect(@location(0) uv: vec2f) -> @location(0) vec4f`. */
+  wgsl: string;
+  /** Scalar uniforms, packed as f32 in SORTED KEY ORDER into the Uniforms struct. */
+  uniforms: Record<string, number>;
+  /** Named texture inputs: binding name → image/video asset id (the source canvas is binding 0). Reserved for multi-input passes. */
+  textures?: Record<string, string>;
+}
+type DrawCommand = {
+  op: 'save';
+} | {
+  op: 'restore';
+} | {
+  op: 'transform';
+  m: Mat2x3;
+} | {
+  op: 'clip';
+  path: ResourceId;
+  rule?: 'nonzero' | 'evenodd';
+} | {
+  op: 'fillPath';
+  path: ResourceId;
+  paint: Paint;
+} | {
+  op: 'strokePath';
+  path: ResourceId;
+  paint: Paint;
+  stroke: StrokeStyle;
+} | {
+  op: 'fillText';
+  text: string;
+  font: FontSpec;
+  paint: Paint;
+  x: number;
+  y: number;
+  align?: 'left' | 'center' | 'right';
+} | {
+  op: 'drawImage';
+  image: ResourceId;
+  src?: Rect;
+  dst: Rect;
+  smoothing?: boolean;
+} | {
+  op: 'pushGroup';
+  opacity: number;
+  blend: BlendMode;
+  filters: FilterSpec[];
+  shader?: ShaderRef;
+  cacheKey?: string;
+} | {
+  op: 'popGroup';
+};
+interface DisplayList {
+  commands: DrawCommand[];
+  resources: Resource[];
+  size: {
+    w: number;
+    h: number;
+  };
+}
+interface DisplayListBuilder {
+  push(cmd: DrawCommand): void;
+  resource(res: Resource): ResourceId;
+  /**
+   * §3.5 cacheKey seam — OPTIONAL so non-cache emits and lightweight mock
+   * builders never need them. `createDisplayListBuilder` supplies all three;
+   * `Node.emit` calls them only for `cache:true` nodes when present.
+   */
+  /** Count of commands emitted so far — a markpoint for cacheKey ranges. */
+  mark?(): number;
+  /**
+   * A stable hash of the command slice [start, end) plus the FULL content of
+   * every resource those commands reference (not just ids — interned ids are a
+   * per-list detail). Pure function of the slice; identical slices at two times
+   * hash equal, so a static subtree caches. Opaque buffers collapse to a length
+   * marker (mirrors cacheColdAudit's serializer). Undefined for an empty slice.
+   */
+  cacheKey?(start: number, end: number): string | undefined;
+  /** Stamp a cacheKey onto the pushGroup already emitted at index `i`. */
+  patchCacheKey?(i: number, key: string): void;
+}
+declare function createDisplayListBuilder(size: {
+  w: number;
+  h: number;
+}): DisplayListBuilder & {
+  finish(): DisplayList;
+};
+//#endregion
+export { Mat2x3 as C, matEquals as D, invert as E, multiply as O, IDENTITY as S, fromTRS as T, StrokeStyle as _, FilterSpec as a, glow as b, MeshInterpolation as c, Paint as d, PathSeg as f, ShaderRef as g, ResourceId as h, DrawCommand as i, MeshPaint$1 as l, Resource as m, DisplayList as n, FilterValidationError as o, Rect as p, DisplayListBuilder as r, FontSpec as s, BlendMode as t, MeshPoint as u, createDisplayListBuilder as v, applyToPoint as w, validateFilters as x, filtersToCanvasFilter as y };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { $ as breakLines, A as Polyline, At as invert, B as validateHachure, C as Video, Ct as filtersToCanvasFilter, D as revealSchedule, Dt as Mat2x3, E as pathFromSegs, Et as IDENTITY, F as flatten, G as HitArea, H as AnchorSpec, I as hachureLines, J as PropInit, K as Node, L as resolveSketch, M as SketchStyle, Mt as multiply, N as SketchValidationError, O as roundedRectSegs, Ot as applyToPoint, P as arcLength, Q as TextMetricsLite, R as roughen, S as TextProps, St as createDisplayListBuilder, T as WordBox, Tt as validateFilters, U as BindablePropTarget, V as validateSketch, W as EvalContext, X as MEASURE_QUANTUM_PX, Y as resolveAnchor, Z as TextMeasurer, _ as PathProps, _t as Rect$1, a as LayoutEngineMissingError, at as BlendMode, b as ShapeProps, bt as ShaderRef, c as requireLayoutEngine, ct as DrawCommand, d as Custom, dt as FontSpec, et as estimatingMeasurer, f as Group, ft as MeshInterpolation, g as Path, gt as PathSeg, h as LineBox, ht as Paint, i as LayoutEngine, it as setDefaultMeasurer, j as ResolvedSketch, jt as matEquals, k as HachureSpec, kt as fromTRS, l as setLayoutEngine, lt as FilterSpec, m as ImageProps, mt as MeshPoint, n as LayoutChildSpec, nt as segmentGraphemes, ot as DisplayList, p as ImageNode, pt as MeshPaint, q as NodeProps, r as LayoutContainerSpec, rt as segmentWords, s as getLayoutEngine, st as DisplayListBuilder, t as LayoutBox, tt as quantize, u as Circle, ut as FilterValidationError, v as Rect, vt as Resource, w as VideoProps, wt as glow, x as Text, xt as StrokeStyle, y as RevealMark, yt as ResourceId, z as sketchStrokes } from "./layoutEngine.js";
+import { C as Mat2x3, D as matEquals, E as invert, O as multiply, S as IDENTITY, T as fromTRS, _ as StrokeStyle, a as FilterSpec, b as glow, c as MeshInterpolation, d as Paint, f as PathSeg, g as ShaderRef, h as ResourceId, i as DrawCommand, l as MeshPaint, m as Resource, n as DisplayList, o as FilterValidationError, p as Rect$1, r as DisplayListBuilder, s as FontSpec, t as BlendMode, u as MeshPoint, v as createDisplayListBuilder, w as applyToPoint, x as validateFilters, y as filtersToCanvasFilter } from "./displayList.js";
+import { $ as TextMetricsLite, A as HachureSpec, B as sketchStrokes, C as Video, D as pathFromSegs, E as coercePathData, F as arcLength, G as EvalContext, H as validateSketch, I as flatten, J as NodeProps, K as HitArea, L as hachureLines, M as ResolvedSketch, N as SketchStyle, O as revealSchedule, P as SketchValidationError, Q as TextMeasurer, R as resolveSketch, S as TextProps, T as WordBox, U as AnchorSpec, V as validateHachure, W as BindablePropTarget, X as resolveAnchor, Y as PropInit, Z as MEASURE_QUANTUM_PX, _ as PathProps, a as LayoutEngineMissingError, at as setDefaultMeasurer, b as ShapeProps, c as requireLayoutEngine, d as Custom, et as breakLines, f as Group, g as Path, h as LineBox, i as LayoutEngine, it as segmentWords, j as Polyline, k as roundedRectSegs, l as setLayoutEngine, m as ImageProps, n as LayoutChildSpec, nt as quantize, p as ImageNode, q as Node, r as LayoutContainerSpec, rt as segmentGraphemes, s as getLayoutEngine, t as LayoutBox, tt as estimatingMeasurer, u as Circle, v as Rect, w as VideoProps, x as Text, y as RevealMark, z as roughen } from "./layoutEngine.js";
 import { BindableSignal, BoundTimeline, CompiledTimeline, CoverageReport, EaseSpec, FontMode, FontUsage, MeshPaint as MeshPaint$1, PathValue, Playhead, Rng, Timeline, Track, Vec2 } from "@glissade/core";
 import { ChannelOverride, Clip } from "@glissade/core/clips";
 
@@ -892,4 +893,4 @@ declare function meshRasterSize(bw: number, bh: number): {
   h: number;
 };
 //#endregion
-export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type CommandDelta, type Ctx2DLike, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, type DisplayDiff, type DisplayList, type DisplayListBuilder, type DlSnapshot, DlSnapshotError, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, type EditMark, type EvalContext, type FieldChange, type FilterKind, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontByteLoader, type FontSpec, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, 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, NODE_TAXONOMY, Node, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSampler, 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, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, type AnchorSpec, type BackendCaps, type BindablePropTarget, type BlendMode, type CacheColdResult, type CanvasLike, Circle, ColdAssetError, type CommandDelta, type Ctx2DLike, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, type DisplayDiff, type DisplayList, type DisplayListBuilder, type DlSnapshot, DlSnapshotError, type DrawCommand, type DrawOnEachOptions, type DrawOnOptions, DuplicateNodeIdError, type EachBox, type EachContext, type EachDistribute, EachError, type EachLayout, type EachMotion, type EachOpts, type EachResult, type EditMark, type EvalContext, type FieldChange, type FilterKind, type FilterSpec, FilterValidationError, FollowPath, type FollowPathProps, type FontByteLoader, type FontSpec, Group, type GuardMode, type HachureSpec, Highlight, type HighlightProps, type HitArea, IDENTITY, ImageNode as Image, ImageNode, type ImageDataLike, type ImageHandle, type ImageProps, 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, NODE_TAXONOMY, Node, type NodeProps, type NodeTypeName, type Paint, Path, type PathLike, type PathProps, type PathSampler, 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, TokenHighlight, type TokenHighlightProps, TokenMatchError, type TokenRange, type TypeEdit, type TypewriterResult, type ValidateSceneFontsOptions, Video, type VideoFrameSource, type VideoProps, type WordBox, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/index.js

@@ -1,4 +1,5 @@
-import { $ as multiply, A as estimatingMeasurer, B as validateFilters, C as sketchStrokes, D as resolveAnchor, E as Node, F as setDefaultMeasurer, G as formatDisplayDiff, H as DlSnapshotError, I as FilterValidationError, J as IDENTITY, K as parseDisplaySnapshot, L as createDisplayListBuilder, M as quantize, N as segmentGraphemes, O as MEASURE_QUANTUM_PX, P as segmentWords, Q as matEquals, R as filtersToCanvasFilter, S as roughen, T as validateSketch, U as collapseReplacer, V as DL_SNAPSHOT_VERSION, W as diffDisplayLists, X as fromTRS, Y as applyToPoint, Z as invert, _ as arcLength, a as Circle, b as hashStr, c as ImageNode, d as Text, f as Video, g as SketchValidationError, h as roundedRectSegs, i as setLayoutEngine, j as fallbackMeasurer, k as breakLines, l as Path, m as revealSchedule, n as getLayoutEngine, o as Custom, p as pathFromSegs, q as serializeDisplayList, r as requireLayoutEngine, s as Group, t as LayoutEngineMissingError, u as Rect, v as flatten, w as validateHachure, x as resolveSketch, y as hachureLines, z as glow } from "./layoutEngine.js";
+import { A as segmentGraphemes, B as collapseReplacer, C as Node, D as estimatingMeasurer, E as breakLines, F as filtersToCanvasFilter, G as IDENTITY, H as formatDisplayDiff, I as glow, J as invert, K as applyToPoint, L as validateFilters, M as setDefaultMeasurer, N as FilterValidationError, O as fallbackMeasurer, P as createDisplayListBuilder, R as DL_SNAPSHOT_VERSION, S as validateSketch, T as MEASURE_QUANTUM_PX, U as parseDisplaySnapshot, V as diffDisplayLists, W as serializeDisplayList, X as multiply, Y as matEquals, _ 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 segmentWords, k as quantize, l as coercePathData, m as arcLength, n as Custom, o as Rect, p as SketchValidationError, q as fromTRS, r as Group, s as Text, t as Circle, u as pathFromSegs, v as resolveSketch, w as resolveAnchor, x as validateHachure, y as roughen, z as DlSnapshotError } from "./nodes.js";
+import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
 import { bindTimeline, buildFontRegistry, compileTimeline, createPlayhead, emitDevWarning, evaluateAt, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts, vec2Signal } from "@glissade/core";
 //#region src/taxonomy.ts
 /**
@@ -1850,4 +1851,4 @@ var Raster2D = class {
 	}
 };
 //#endregion
-export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, DlSnapshotError, DuplicateNodeIdError, EachError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, NODE_TAXONOMY, Node, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };
+export { ALL_FILTER_KINDS, Circle, ColdAssetError, Custom, DL_SNAPSHOT_VERSION, DeterminismViolationError, DlSnapshotError, DuplicateNodeIdError, EachError, FilterValidationError, FollowPath, Group, Highlight, IDENTITY, ImageNode as Image, ImageNode, LayoutEngineMissingError, MEASURE_QUANTUM_PX, MESH_DOWNSCALE, MESH_SHEPARD_POWER, MESH_SIGMA, NODE_TAXONOMY, Node, Path, Raster2D, Rect, ReservedNodeIdError, ShaderEffect, SketchValidationError, Text, TextCursor, TokenHighlight, TokenMatchError, Video, applyToPoint, arcLength, auditCacheCold, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, diffDisplayLists, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, followPath, fontString, formatDisplayDiff, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, matEquals, matchTokenRun, meshRasterSize, motionPath, multiply, parseDisplaySnapshot, pathFromSegs, pathLength, pointAtLength, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, serializeDisplayList, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, tokenHighlight, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };

package/dist/layout.d.ts

@@ -1,4 +1,5 @@
-import { J as PropInit, K as Node, W as EvalContext, Z as TextMeasurer, a as LayoutEngineMissingError, f as Group, i as LayoutEngine, l as setLayoutEngine, n as LayoutChildSpec, o as LayoutResult, q as NodeProps, r as LayoutContainerSpec, s as getLayoutEngine, st as DisplayListBuilder, t as LayoutBox } from "./layoutEngine.js";
+import { r as DisplayListBuilder } from "./displayList.js";
+import { G as EvalContext, J as NodeProps, Q as TextMeasurer, Y as PropInit, a as LayoutEngineMissingError, f as Group, i as LayoutEngine, l as setLayoutEngine, n as LayoutChildSpec, o as LayoutResult, q as Node, r as LayoutContainerSpec, s as getLayoutEngine, t as LayoutBox } from "./layoutEngine.js";
 import { BindableSignal } from "@glissade/core";
 
 //#region src/layout.d.ts

package/dist/layout.js

@@ -1,4 +1,5 @@
-import { i as setLayoutEngine, j as fallbackMeasurer, n as getLayoutEngine, r as requireLayoutEngine, s as Group, t as LayoutEngineMissingError } from "./layoutEngine.js";
+import { O as fallbackMeasurer, r as Group } from "./nodes.js";
+import { i as setLayoutEngine, n as getLayoutEngine, r as requireLayoutEngine, t as LayoutEngineMissingError } from "./layoutEngine.js";
 import { computed, signal } from "@glissade/core";
 //#region src/layout.ts
 /**

package/dist/layoutEngine.d.ts

@@ -1,197 +1,8 @@
-import { BindableSignal, MeshInterpolation, MeshPaint as MeshPaint$1, MeshPoint, Paint, PathValue, ReadonlySignal, Rng, Track, ValueTypeId, Vec2, Vec2Signal } from "@glissade/core";
+import { C as Mat2x3, a as FilterSpec, d as Paint, f as PathSeg, g as ShaderRef, r as DisplayListBuilder, s as FontSpec, t as BlendMode } from "./displayList.js";
+import { BindableSignal, PathValue, ReadonlySignal, Rng, Track, ValueTypeId, Vec2, Vec2Signal } from "@glissade/core";
 
-//#region src/matrix.d.ts
-
-type Mat2x3 = readonly [number, number, number, number, number, number];
-declare const IDENTITY: Mat2x3;
-declare function multiply(m1: Mat2x3, m2: Mat2x3): Mat2x3;
-/** Compose translate × rotate × scale (rotation in degrees). */
-declare function fromTRS(position: Vec2, rotationDeg: number, scale: Vec2): Mat2x3;
-/** Inverse affine: [A | t]⁻¹ = [A⁻¹ | −A⁻¹t]; null when degenerate (det 0). */
-declare function invert(m: Mat2x3): Mat2x3 | null;
-declare function applyToPoint(m: Mat2x3, p: Vec2): Vec2;
-declare function matEquals(a: Mat2x3, b: Mat2x3): boolean;
-//#endregion
-//#region src/displayList.d.ts
-type ResourceId = number;
-/**
- * Path data as plain segments (JSON-serializable; backends build Path2D/SkPath):
- *   M/L: point; C: cubic; Q: quadratic; Z: close
- *   E: ellipse arc — cx, cy, rx, ry, rotationRad, startAngleRad, endAngleRad
- */
-type PathSeg = ['M', number, number] | ['L', number, number] | ['C', number, number, number, number, number, number] | ['Q', number, number, number, number] | ['E', number, number, number, number, number, number, number] | ['Z'];
-type Resource = {
-  kind: 'path';
-  segs: PathSeg[];
-} | {
-  kind: 'image';
-  assetId: string;
-}
-/** One source-grid video frame: backends resolve via their VideoFrameSource registry (§3.8). */ | {
-  kind: 'videoFrame';
-  assetId: string;
-  mediaT: number;
-};
-type BlendMode = 'source-over' | 'multiply' | 'screen' | 'overlay' | 'darken' | 'lighten';
-interface StrokeStyle {
-  width: number;
-  cap?: 'butt' | 'round' | 'square';
-  join?: 'miter' | 'round' | 'bevel';
-  miterLimit?: number;
-  dash?: number[];
-  dashOffset?: number;
-}
-interface FontSpec {
-  family: string;
-  size: number;
-  weight?: number;
-  style?: 'normal' | 'italic';
-}
-/**
- * Group filters (§3.4): a CLOSED union — validated data, never a CSS
- * passthrough string — limited to effects both rasterizers implement
- * faithfully. Cross-backend parity is perceptual (SSIM), not byte-exact:
- * filters are where rasterizers diverge most. Per-backend output stays
- * deterministic on the pinned toolchain (golden-tested on Skia).
- */
-type FilterSpec = {
-  kind: 'blur'; /** Gaussian stdDeviation, px; ≥ 0. */
-  radius: number;
-} | {
-  kind: 'drop-shadow';
-  dx: number;
-  dy: number; /** ≥ 0 */
-  blur: number;
-  color: string;
-} | {
-  kind: 'brightness'; /** 1 = identity; ≥ 0. */
-  amount: number;
-} | {
-  kind: 'contrast'; /** 1 = identity; ≥ 0. */
-  amount: number;
-} | {
-  kind: 'saturate'; /** 1 = identity; ≥ 0. */
-  amount: number;
-};
-declare class FilterValidationError extends Error {
-  constructor(message: string);
-}
-/** Document-layer validation: reject unknown kinds and out-of-range params loudly. */
-declare function validateFilters(filters: readonly FilterSpec[]): void;
-/**
- * Compile the validated union to the canvas 2D `ctx.filter` syntax — both
- * backends speak it (browser canvas and @napi-rs/canvas/Skia). This is the
- * ONLY place the CSS-like syntax appears; documents never carry it.
- */
-declare function filtersToCanvasFilter(filters: readonly FilterSpec[]): string;
-/**
- * Outer glow as stacked zero-offset drop-shadows — the classic recipe, fully
- * deterministic on both backends (it is just filters). intensity stacks more
- * layers; pair with a signal binding to follow an animated fill.
- */
-declare function glow(color: string, radius?: number, intensity?: number): FilterSpec[];
-interface Rect$1 {
-  x: number;
-  y: number;
-  w: number;
-  h: number;
-}
-/**
- * Shader effect pass (§3.7): runs over the group's rasterized texture.
- * EXPLICITLY outside the determinism guarantee — GPU/driver per-pixel
- * variance breaks distributed reproducibility; export with shaders is
- * best-effort, single machine. Uniform VALUES are resolved at emit time
- * (they ride on signals), so the IR stays a plain serializable snapshot.
- */
-interface ShaderRef {
-  /** WGSL fragment module: declare `struct Uniforms` + `@fragment fn effect(@location(0) uv: vec2f) -> @location(0) vec4f`. */
-  wgsl: string;
-  /** Scalar uniforms, packed as f32 in SORTED KEY ORDER into the Uniforms struct. */
-  uniforms: Record<string, number>;
-  /** Named texture inputs: binding name → image/video asset id (the source canvas is binding 0). Reserved for multi-input passes. */
-  textures?: Record<string, string>;
-}
-type DrawCommand = {
-  op: 'save';
-} | {
-  op: 'restore';
-} | {
-  op: 'transform';
-  m: Mat2x3;
-} | {
-  op: 'clip';
-  path: ResourceId;
-  rule?: 'nonzero' | 'evenodd';
-} | {
-  op: 'fillPath';
-  path: ResourceId;
-  paint: Paint;
-} | {
-  op: 'strokePath';
-  path: ResourceId;
-  paint: Paint;
-  stroke: StrokeStyle;
-} | {
-  op: 'fillText';
-  text: string;
-  font: FontSpec;
-  paint: Paint;
-  x: number;
-  y: number;
-  align?: 'left' | 'center' | 'right';
-} | {
-  op: 'drawImage';
-  image: ResourceId;
-  src?: Rect$1;
-  dst: Rect$1;
-  smoothing?: boolean;
-} | {
-  op: 'pushGroup';
-  opacity: number;
-  blend: BlendMode;
-  filters: FilterSpec[];
-  shader?: ShaderRef;
-  cacheKey?: string;
-} | {
-  op: 'popGroup';
-};
-interface DisplayList {
-  commands: DrawCommand[];
-  resources: Resource[];
-  size: {
-    w: number;
-    h: number;
-  };
-}
-interface DisplayListBuilder {
-  push(cmd: DrawCommand): void;
-  resource(res: Resource): ResourceId;
-  /**
-   * §3.5 cacheKey seam — OPTIONAL so non-cache emits and lightweight mock
-   * builders never need them. `createDisplayListBuilder` supplies all three;
-   * `Node.emit` calls them only for `cache:true` nodes when present.
-   */
-  /** Count of commands emitted so far — a markpoint for cacheKey ranges. */
-  mark?(): number;
-  /**
-   * A stable hash of the command slice [start, end) plus the FULL content of
-   * every resource those commands reference (not just ids — interned ids are a
-   * per-list detail). Pure function of the slice; identical slices at two times
-   * hash equal, so a static subtree caches. Opaque buffers collapse to a length
-   * marker (mirrors cacheColdAudit's serializer). Undefined for an empty slice.
-   */
-  cacheKey?(start: number, end: number): string | undefined;
-  /** Stamp a cacheKey onto the pushGroup already emitted at index `i`. */
-  patchCacheKey?(i: number, key: string): void;
-}
-declare function createDisplayListBuilder(size: {
-  w: number;
-  h: number;
-}): DisplayListBuilder & {
-  finish(): DisplayList;
-};
-//#endregion
 //#region src/text.d.ts
+
 interface TextMetricsLite {
   width: number;
   ascent: number;
@@ -560,6 +371,15 @@ declare abstract class Shape extends Node {
    * The seed is consumed fresh each draw, so re-evaluation is byte-identical. */
   private drawSketch;
 }
+/**
+ * Coerce a `Path.data` init to a `PathValue`: an array of contour objects
+ * passes through; anything else (a string, a number, …) is a construction-time
+ * error. SVG `d` strings are NOT parsed here — that parser lives on the
+ * tree-shakeable `@glissade/scene/path` subpath (kept off the base embed), so a
+ * string `data` throws a clear error pointing at `pathFromSvg(d)`. Returns `[]`
+ * for `undefined` (the empty-path default).
+ */
+declare function coercePathData(data: unknown): PathValue;
 /**
  * `PathSeg[]` → `PathValue` (Lottie vertex contours) — the inverse of
  * `Path.pathSegs`, so geometry from `roundedRectSegs` / `sketchStrokes` /
@@ -597,8 +417,15 @@ declare class Circle extends Shape {
   protected pathSegs(): PathSeg[];
 }
 interface PathProps extends ShapeProps {
-  /** The geometry (§2.2 'path' value): bezier contours in vertex form, animatable via a track on '<id>/d'. */
-  data?: PropInit<PathValue>;
+  /**
+   * The geometry (§2.2 'path' value): bezier contours in vertex form,
+   * animatable via a track on '<id>/d'. Accepts a `PathValue` directly or a
+   * computed `() => PathValue`. For an SVG `d` STRING, parse it first with
+   * `pathFromSvg(d)` from the tree-shakeable `@glissade/scene/path` subpath
+   * (off the base embed) — passing a bare string throws a clear construction
+   * error rather than dragging the parser onto every embed.
+   */
+  data?: PropInit<PathValue> | string;
 }
 /**
  * Arbitrary bezier geometry — the Lottie-import landing spot and the target
@@ -874,4 +701,4 @@ declare function setLayoutEngine(e: LayoutEngine): void;
 declare function getLayoutEngine(): LayoutEngine | null;
 declare function requireLayoutEngine(): LayoutEngine;
 //#endregion
-export { breakLines as $, Polyline as A, invert as At, validateHachure as B, Video as C, filtersToCanvasFilter as Ct, revealSchedule as D, Mat2x3 as Dt, pathFromSegs as E, IDENTITY as Et, flatten as F, HitArea as G, AnchorSpec as H, hachureLines as I, PropInit as J, Node as K, resolveSketch as L, SketchStyle as M, multiply as Mt, SketchValidationError as N, roundedRectSegs as O, applyToPoint as Ot, arcLength as P, TextMetricsLite as Q, roughen as R, TextProps as S, createDisplayListBuilder as St, WordBox as T, validateFilters as Tt, BindablePropTarget as U, validateSketch as V, EvalContext as W, MEASURE_QUANTUM_PX as X, resolveAnchor as Y, TextMeasurer as Z, PathProps as _, Rect$1 as _t, LayoutEngineMissingError as a, BlendMode as at, ShapeProps as b, ShaderRef as bt, requireLayoutEngine as c, DrawCommand as ct, Custom as d, FontSpec as dt, estimatingMeasurer as et, Group as f, MeshInterpolation as ft, Path as g, PathSeg as gt, LineBox as h, Paint as ht, LayoutEngine as i, setDefaultMeasurer as it, ResolvedSketch as j, matEquals as jt, HachureSpec as k, fromTRS as kt, setLayoutEngine as l, FilterSpec as lt, ImageProps as m, MeshPoint as mt, LayoutChildSpec as n, segmentGraphemes as nt, LayoutResult as o, DisplayList as ot, ImageNode as p, MeshPaint$1 as pt, NodeProps as q, LayoutContainerSpec as r, segmentWords as rt, getLayoutEngine as s, DisplayListBuilder as st, LayoutBox as t, quantize as tt, Circle as u, FilterValidationError as ut, Rect as v, Resource as vt, VideoProps as w, glow as wt, Text as x, StrokeStyle as xt, RevealMark as y, ResourceId as yt, sketchStrokes as z };
+export { TextMetricsLite as $, HachureSpec as A, sketchStrokes as B, Video as C, pathFromSegs as D, coercePathData as E, arcLength as F, EvalContext as G, validateSketch as H, flatten as I, NodeProps as J, HitArea as K, hachureLines as L, ResolvedSketch as M, SketchStyle as N, revealSchedule as O, SketchValidationError as P, TextMeasurer as Q, resolveSketch as R, TextProps as S, WordBox as T, AnchorSpec as U, validateHachure as V, BindablePropTarget as W, resolveAnchor as X, PropInit as Y, MEASURE_QUANTUM_PX as Z, PathProps as _, LayoutEngineMissingError as a, setDefaultMeasurer as at, ShapeProps as b, requireLayoutEngine as c, Custom as d, breakLines as et, Group as f, Path as g, LineBox as h, LayoutEngine as i, segmentWords as it, Polyline as j, roundedRectSegs as k, setLayoutEngine as l, ImageProps as m, LayoutChildSpec as n, quantize as nt, LayoutResult as o, ImageNode as p, Node as q, LayoutContainerSpec as r, segmentGraphemes as rt, getLayoutEngine as s, LayoutBox as t, estimatingMeasurer as tt, Circle as u, Rect as v, VideoProps as w, Text as x, RevealMark as y, roughen as z };