@glissade/scene 0.19.0 → 0.20.0-pre.3

package/dist/index.js

@@ -1,6 +1,7 @@
-import { $ as multiply, A as hashStr, B as validateFilters, C as segmentWords, D as arcLength, E as SketchValidationError, F as validateSketch, G as formatDisplayDiff, H as DlSnapshotError, I as FilterValidationError, J as IDENTITY, K as parseDisplaySnapshot, L as createDisplayListBuilder, M as roughen, N as sketchStrokes, O as flatten, P as validateHachure, Q as matEquals, R as filtersToCanvasFilter, S as segmentGraphemes, U as collapseReplacer, V as DL_SNAPSHOT_VERSION, W as diffDisplayLists, X as fromTRS, Y as applyToPoint, Z as invert, _ as breakLines, a as Path, b as isEstimatingMeasurer, c as Video, d as revealSchedule, f as roundedRectSegs, g as __resetEstimateWarnings, h as MEASURE_QUANTUM_PX, i as ImageNode, j as resolveSketch, k as hachureLines, l as coercePathData, m as resolveAnchor, n as Custom, o as Rect, p as Node, q as serializeDisplayList, r as Group, s as Text, t as Circle, u as pathFromSegs, v as estimatingMeasurer, w as setDefaultMeasurer, x as quantize, y as fallbackMeasurer, z as glow } from "./nodes.js";
+import { A as hashStr, B as validateFilters, C as segmentWords, D as arcLength, E as SketchValidationError, F as validateSketch, G as invert, H as IDENTITY, I as FilterValidationError, K as matEquals, L as createDisplayListBuilder, M as roughen, N as sketchStrokes, O as flatten, P as validateHachure, R as filtersToCanvasFilter, S as segmentGraphemes, U as applyToPoint, V as collapseReplacer, W as fromTRS, _ as breakLines, a as Path, b as isEstimatingMeasurer, c as Video, d as revealSchedule, f as roundedRectSegs, g as __resetEstimateWarnings, h as MEASURE_QUANTUM_PX, i as ImageNode, j as resolveSketch, k as hachureLines, l as coercePathData, m as resolveAnchor, n as Custom, o as Rect, p as Node, q as multiply, r as Group, s as Text, t as Circle, u as pathFromSegs, v as estimatingMeasurer, w as setDefaultMeasurer, x as quantize, z as glow } 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 { bindTimeline, buildFontRegistry, compileTimeline, createPlayhead, emitDevWarning, evaluateAt, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts, vec2Signal } from "@glissade/core";
+import { buildFontRegistry, emitDevWarning, key, lerpColor, oklabToRgba, parseCmap, parseColor, random, rgbaToOklab, signal, stagger, track, validateFonts } from "@glissade/core";
 //#region src/taxonomy.ts
 /**
 * The CLOSED node taxonomy (DESIGN.md §3.1): exactly nine built-in node TYPES.
@@ -45,8 +46,8 @@ var Highlight = class extends Node {
 	constructor(props) {
 		super(props);
 		this.target = props.text;
-		this.color = init$2(signal("#ffe066"), props.color);
-		this.progress = init$2(signal(1), props.progress);
+		this.color = init$1(signal("#ffe066"), props.color);
+		this.progress = init$1(signal(1), props.progress);
 		this.padding = props.padding ?? [4, 2];
 		this.cornerRadius = props.cornerRadius ?? 4;
 		this.registerTarget("progress", this.progress, "number");
@@ -99,7 +100,7 @@ function highlight(text, props = {}) {
 		text
 	});
 }
-function init$2(sig, v) {
+function init$1(sig, v) {
 	if (typeof v === "function") sig.bindSource(v);
 	else if (v !== void 0) sig.set(v);
 	return sig;
@@ -132,7 +133,7 @@ var TextCursor = class extends Node {
 		this.blinkPhase = props.blinkPhase ?? 0;
 		this.solidWhileTyping = props.solidWhileTyping ?? true;
 		this.caretWidth = props.width ?? 2;
-		this.fill = init$1(signal(""), props.fill);
+		this.fill = init(signal(""), props.fill);
 		this.registerTarget("fill", this.fill, "color");
 	}
 	draw(out, ctx) {
@@ -173,7 +174,7 @@ function textCursor(text, props = {}) {
 		text
 	});
 }
-function init$1(sig, v) {
+function init(sig, v) {
 	if (typeof v === "function") sig.bindSource(v);
 	else if (v !== void 0) sig.set(v);
 	return sig;
@@ -528,164 +529,6 @@ function withDeterminismGuards(mode, fn) {
 	}
 }
 //#endregion
-//#region src/scene.ts
-/**
-* Scene assembly + the canonical evaluate(scene, timeline, t) (DESIGN.md §2.5,
-* §3.1): pure, total, deterministic — driver writes the playhead (sanctioned
-* entry write), then a pull-only read phase collects the DisplayList.
-*/
-var DuplicateNodeIdError = class extends Error {
-	constructor(id) {
-		super(`duplicate node id '${id}' — explicit ids must be unique (§3.1/§6.5)`);
-		this.name = "DuplicateNodeIdError";
-	}
-};
-var ReservedNodeIdError = class extends Error {
-	constructor(id) {
-		super(`node id '${id}' uses the reserved '~' prefix — that namespace is for structural fallback ids (§6.5), which are inspection-only and never track targets; choose another id`);
-		this.name = "ReservedNodeIdError";
-	}
-};
-function indexNodes(root, into, measurerSource) {
-	root.measurerSource = measurerSource;
-	if (root.id !== void 0) {
-		if (root.id.startsWith("~")) throw new ReservedNodeIdError(root.id);
-		if (into.has(root.id)) throw new DuplicateNodeIdError(root.id);
-		into.set(root.id, root);
-	}
-	if (root instanceof Group) for (const child of root.children) indexNodes(child, into, measurerSource);
-}
-function createScene(init) {
-	const root = new Group({
-		id: "__root",
-		children: init.children
-	});
-	const nodes = /* @__PURE__ */ new Map();
-	const playhead = createPlayhead();
-	const measurer = signal(null);
-	indexNodes(root, nodes, () => measurer() ?? fallbackMeasurer());
-	return {
-		root,
-		nodes,
-		size: init.size,
-		playhead,
-		resolveTarget: (target) => {
-			for (let slash = target.lastIndexOf("/"); slash > 0; slash = target.lastIndexOf("/", slash - 1)) {
-				const node = nodes.get(target.slice(0, slash));
-				if (node) return node.resolveTarget(target.slice(slash + 1));
-			}
-		},
-		setTextMeasurer: (m) => {
-			measurer.set(m);
-		},
-		get textMeasurer() {
-			return measurer.peek() ?? fallbackMeasurer();
-		}
-	};
-}
-const bindings = /* @__PURE__ */ new WeakMap();
-function bindScene(scene, doc) {
-	let perScene = bindings.get(scene);
-	if (!perScene) {
-		perScene = /* @__PURE__ */ new WeakMap();
-		bindings.set(scene, perScene);
-	}
-	let entry = perScene.get(doc);
-	if (!entry) {
-		const compiled = compileTimeline(doc);
-		entry = {
-			compiled,
-			bound: bindTimeline(compiled, scene.resolveTarget, scene.playhead)
-		};
-		perScene.set(doc, entry);
-	}
-	return entry;
-}
-/**
-* Empty timeline — zero tracks, so binding installs ZERO computed sources and
-* any imperative `node.set(...)` value survives evaluate untouched. Shared and
-* frozen so the WeakMap binding cache keys on a single stable document across
-* the whole controlled-drive loop (one bind, reused every frame).
-*/
-const EMPTY_TIMELINE = Object.freeze({
-	version: 1,
-	tracks: []
-});
-function evaluate(scene, doc, t = 0) {
-	if (doc === void 0) return evaluate(scene, EMPTY_TIMELINE, scene.playhead.peek());
-	bindScene(scene, doc);
-	const fps = doc.fps;
-	const ctx = {
-		time: t,
-		frame: fps !== void 0 ? Math.round(t * fps) : -1,
-		measurer: scene.textMeasurer
-	};
-	return evaluateAt(scene.playhead, t, () => {
-		const out = createDisplayListBuilder(scene.size);
-		scene.root.emit(out, ctx);
-		return out.finish();
-	});
-}
-//#endregion
-//#region src/cacheColdAudit.ts
-/** Stable string of a DisplayList for comparison (opaque resources collapse to a marker). */
-function hashDisplayList(dl) {
-	return JSON.stringify(dl, collapseReplacer);
-}
-/**
-* Evaluate two fresh scenes from `createScene` at `t` and confirm the
-* DisplayLists are byte-identical. Returns `{ ok: true }` for a pure scene, or
-* `{ ok: false, node }` naming the first divergent node. DEV-only — never on
-* the render hot path.
-*/
-function auditCacheCold(createScene, doc, t) {
-	const warm = createScene();
-	const cold = createScene();
-	const a = evaluate(warm, doc, t);
-	const b = evaluate(cold, doc, t);
-	if (hashDisplayList(a) === hashDisplayList(b)) return { ok: true };
-	const frame = doc.fps !== void 0 ? Math.round(t * doc.fps) : -1;
-	const ctxA = {
-		time: t,
-		frame,
-		measurer: warm.textMeasurer
-	};
-	const ctxB = {
-		time: t,
-		frame,
-		measurer: cold.textMeasurer
-	};
-	let groupFallback;
-	for (const [id, nodeA] of warm.nodes) {
-		const nodeB = cold.nodes.get(id);
-		if (!nodeB) return {
-			ok: false,
-			node: id
-		};
-		const ea = createDisplayListBuilder(warm.size);
-		nodeA.emit(ea, ctxA);
-		const eb = createDisplayListBuilder(cold.size);
-		nodeB.emit(eb, ctxB);
-		const dlA = ea.finish();
-		const dlB = eb.finish();
-		if (hashDisplayList(dlA) === hashDisplayList(dlB)) continue;
-		if (nodeA instanceof Group) {
-			groupFallback ??= id;
-			continue;
-		}
-		const first = diffDisplayLists(dlA, dlB).deltas[0];
-		return {
-			ok: false,
-			node: id,
-			...first !== void 0 ? { delta: first } : {}
-		};
-	}
-	return {
-		ok: false,
-		...groupFallback !== void 0 ? { node: groupFallback } : {}
-	};
-}
-//#endregion
 //#region src/renderBackend.ts
 /** Every filter kind the shared Raster2D interpreter rasterizes (§3.4). */
 const ALL_FILTER_KINDS = new Set([
@@ -696,363 +539,6 @@ const ALL_FILTER_KINDS = new Set([
 	"saturate"
 ]);
 //#endregion
-//#region src/motionPath.ts
-/**
-* Motion along a path: sample a point (and tangent) at an arc-length position on
-* a PathValue, and drive a node along it over time. The Path node draws/morphs
-* geometry; this is the companion that makes another node — a cursor, a dot, an
-* arrow — *travel* that geometry.
-*
-* Sampling is arc-length parameterized (constant speed), so progress 0→1 moves
-* evenly instead of bunching at the control points. Pure and deterministic: the
-* table is built once from a static PathValue and `atProgress` is a pure
-* function of progress, so evaluate() stays pure and goldens are byte-stable.
-*/
-const clamp01 = (v) => v < 0 ? 0 : v > 1 ? 1 : v;
-function cubicPoint(p0, p1, p2, p3, t) {
-	const mt = 1 - t;
-	const a = mt * mt * mt;
-	const b = 3 * mt * mt * t;
-	const c = 3 * mt * t * t;
-	const d = t * t * t;
-	return [a * p0[0] + b * p1[0] + c * p2[0] + d * p3[0], a * p0[1] + b * p1[1] + c * p2[1] + d * p3[1]];
-}
-/** PathValue contours → cubic segments, same v/in/out math as Path.pathSegs. */
-function toCubics(path) {
-	const out = [];
-	for (const ct of path) {
-		const n = ct.v.length;
-		for (let i = 0; i < n - 1; i++) out.push([
-			ct.v[i],
-			[ct.v[i][0] + ct.out[i][0], ct.v[i][1] + ct.out[i][1]],
-			[ct.v[i + 1][0] + ct.in[i + 1][0], ct.v[i + 1][1] + ct.in[i + 1][1]],
-			ct.v[i + 1]
-		]);
-		if (ct.closed && n > 1) out.push([
-			ct.v[n - 1],
-			[ct.v[n - 1][0] + ct.out[n - 1][0], ct.v[n - 1][1] + ct.out[n - 1][1]],
-			[ct.v[0][0] + ct.in[0][0], ct.v[0][1] + ct.in[0][1]],
-			ct.v[0]
-		]);
-	}
-	return out;
-}
-/**
-* Build a reusable arc-length sampler. Densely samples each cubic into a
-* cumulative-length polyline (samplesPerSegment, default 32) so `at`/`tangent`
-* are simple span lerps — smooth enough for motion, no per-call bezier solve.
-*/
-function motionPath(path, opts = {}) {
-	const steps = Math.max(1, Math.floor(opts.samplesPerSegment ?? 32));
-	const cubics = toCubics(path);
-	const pts = [];
-	const cum = [];
-	if (cubics.length > 0) {
-		let prev = cubicPoint(...cubics[0], 0);
-		pts.push(prev);
-		cum.push(0);
-		let acc = 0;
-		for (const cub of cubics) for (let k = 1; k <= steps; k++) {
-			const p = cubicPoint(...cub, k / steps);
-			acc += Math.hypot(p[0] - prev[0], p[1] - prev[1]);
-			pts.push(p);
-			cum.push(acc);
-			prev = p;
-		}
-	} else {
-		const first = path[0]?.v[0];
-		pts.push(first ? [first[0], first[1]] : [0, 0]);
-		cum.push(0);
-	}
-	const total = cum[cum.length - 1];
-	const locate = (s) => {
-		if (total <= 0 || s <= 0) return {
-			i: 0,
-			f: 0
-		};
-		if (s >= total) return {
-			i: pts.length - 2,
-			f: 1
-		};
-		let i = 0;
-		while (i < cum.length - 1 && cum[i + 1] < s) i++;
-		const span = cum[i + 1] - cum[i];
-		return {
-			i,
-			f: span > 0 ? (s - cum[i]) / span : 0
-		};
-	};
-	const at = (s) => {
-		if (pts.length === 1) return [pts[0][0], pts[0][1]];
-		const { i, f } = locate(s);
-		const a = pts[i];
-		const b = pts[i + 1];
-		return [a[0] + (b[0] - a[0]) * f, a[1] + (b[1] - a[1]) * f];
-	};
-	const tangentAt = (s) => {
-		if (pts.length === 1) return [1, 0];
-		const { i } = locate(s);
-		const a = pts[i];
-		const b = pts[i + 1];
-		const dx = b[0] - a[0];
-		const dy = b[1] - a[1];
-		const len = Math.hypot(dx, dy);
-		return len > 0 ? [dx / len, dy / len] : [1, 0];
-	};
-	return {
-		length: total,
-		at,
-		tangentAt,
-		atProgress: (u) => at(clamp01(u) * total),
-		tangentAtProgress: (u) => tangentAt(clamp01(u) * total)
-	};
-}
-/** Total arc length of a path. */
-function pathLength(path) {
-	return motionPath(path).length;
-}
-/** Point at arc-length s along a path (clamped to [0, length]). */
-function pointAtLength(path, s) {
-	return motionPath(path).at(s);
-}
-/**
-* A companion node that drives `target` along `path` as `progress` animates.
-* Owns the target's `position` (and `rotation` when `orient`) via pull-based
-* binding, so there's no eval-order side effect. Add it to the scene (its
-* `progress` is the animatable target); it draws nothing itself.
-*/
-var FollowPath = class extends Node {
-	target;
-	progress;
-	constructor(props) {
-		super(props);
-		this.target = props.target;
-		this.progress = signal(1);
-		if (typeof props.progress === "function") this.progress.bindSource(props.progress);
-		else if (props.progress !== void 0) this.progress.set(props.progress);
-		this.registerTarget("progress", this.progress, "number");
-		const sOpts = props.samplesPerSegment !== void 0 ? { samplesPerSegment: props.samplesPerSegment } : {};
-		const getPath = props.path instanceof Path ? () => props.path.data() : () => props.path;
-		let cachedPath = getPath();
-		let cachedSampler = motionPath(cachedPath, sOpts);
-		const sampler = () => {
-			const pv = getPath();
-			if (pv !== cachedPath) {
-				cachedPath = pv;
-				cachedSampler = motionPath(pv, sOpts);
-			}
-			return cachedSampler;
-		};
-		props.target.position.bindSource(() => sampler().atProgress(this.progress()));
-		if (props.orient) {
-			const offset = props.orientOffset ?? 0;
-			props.target.rotation.bindSource(() => {
-				const t = sampler().tangentAtProgress(this.progress());
-				return Math.atan2(t[1], t[0]) * 180 / Math.PI + offset;
-			});
-		}
-	}
-	draw() {}
-};
-/** `children: [route, cursor, followPath(cursor, route, { orient: true })]` — cursor traces the route.
-* Pass the Path *node* to follow it as it morphs; pass a PathValue for a fixed route. */
-function followPath(target, path, props = {}) {
-	return new FollowPath({
-		...props,
-		target,
-		path
-	});
-}
-//#endregion
-//#region src/tokenHighlight.ts
-/**
-* Multi-range token highlight: sub-line ranges over a Text node's wordBoxes,
-* each with its OWN animatable fill/opacity/progress/scale — four-color
-* category passes, per-token flips, karaoke-with-color. Design answers from
-* downstream production (the NNDL verification ritual):
-*  - ranges VALIDATE at construction and THROW on copy drift at draw — the
-*    throw is load-bearing (it catches edited copy that no longer matches);
-*    `rematch: true` opts animated text into per-frame re-resolution.
-*  - a range spanning a wrap produces one rect per line segment.
-*  - string matches are whitespace-stripped consecutive box runs and must end
-*    boundary-exact (mid-segment end = error listing the actual segments);
-*    `[wordIndex, wordIndex]` ranges sidestep matching entirely.
-*/
-var TokenMatchError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "TokenMatchError";
-	}
-};
-const stripWs = (s) => s.replace(/\s+/g, "");
-/**
-* Find the Nth whitespace-stripped consecutive run of boxes equal to token.
-* Boundary-exact: a run that diverges mid-segment is not a match; ending
-* mid-segment throws (with the real segment list) rather than half-boxing.
-*/
-function matchTokenRun(boxes, token, occurrence = 1) {
-	const want = stripWs(token);
-	if (want.length === 0) throw new TokenMatchError("empty token");
-	let seen = 0;
-	for (let i = 0; i < boxes.length; i++) {
-		let acc = "";
-		for (let j = i; j < boxes.length; j++) {
-			acc += stripWs(boxes[j].text);
-			if (acc === want) {
-				seen++;
-				if (seen === occurrence) return [i, j];
-				break;
-			}
-			if (!want.startsWith(acc)) break;
-		}
-	}
-	throw new TokenMatchError(`no match for token '${token}'${occurrence > 1 ? ` (occurrence ${occurrence})` : ""} — segments are [${boxes.map((b) => `'${b.text}'`).join(", ")}]`);
-}
-var TokenHighlight = class extends Node {
-	target;
-	padding;
-	cornerRadius;
-	rematch;
-	ranges;
-	constructor(props) {
-		super(props);
-		this.target = props.text;
-		this.padding = props.padding ?? [4, 2];
-		this.cornerRadius = props.cornerRadius ?? 4;
-		this.rematch = props.rematch ?? false;
-		const boxes = this.target.wordBoxes();
-		this.ranges = props.ranges.map((spec, index) => {
-			const run = this.resolveRun(boxes, spec);
-			const id = spec.id ?? `r${index}`;
-			const r = {
-				spec,
-				fill: init(signal("#ffe066"), spec.fill),
-				opacity: init(signal(1), spec.opacity),
-				progress: init(signal(1), spec.progress),
-				scale: init(signal(1), spec.scale),
-				offset: initVec(vec2Signal([0, 0]), spec.offset),
-				run,
-				bound: runText(boxes, run)
-			};
-			this.registerTarget(`${id}/fill`, r.fill, "color");
-			this.registerTarget(`${id}/opacity`, r.opacity, "number");
-			this.registerTarget(`${id}/progress`, r.progress, "number");
-			this.registerTarget(`${id}/scale`, r.scale, "number");
-			this.registerTarget(`${id}/offset`, r.offset, "vec2");
-			this.registerTarget(`${id}/offset.x`, r.offset.x, "number");
-			this.registerTarget(`${id}/offset.y`, r.offset.y, "number");
-			return r;
-		});
-	}
-	resolveRun(boxes, spec) {
-		if (typeof spec.match !== "string") {
-			const [from, to] = spec.match;
-			if (from < 0 || to >= boxes.length || from > to) throw new TokenMatchError(`word index range [${from}, ${to}] out of bounds (${boxes.length} boxes)`);
-			return [from, to];
-		}
-		return matchTokenRun(boxes, spec.match, spec.occurrence ?? 1);
-	}
-	draw(out, ctx) {
-		const boxes = this.target.wordBoxes(ctx.measurer);
-		if (boxes.length === 0) return;
-		const tm = this.target.localMatrix();
-		const [px, py] = this.padding;
-		let pushedTransform = false;
-		for (const r of this.ranges) {
-			const opacity = r.opacity();
-			if (opacity <= 0) continue;
-			const progress = Math.min(1, Math.max(0, r.progress()));
-			if (progress <= 0) continue;
-			let run = r.run;
-			if (this.rematch && typeof r.spec.match === "string") run = matchTokenRun(boxes, r.spec.match, r.spec.occurrence ?? 1);
-			else if (runText(boxes, run) !== r.bound) throw new TokenMatchError(`bound token '${r.bound}' no longer matches boxes [${run[0]}, ${run[1]}] — the text changed (segments now [${boxes.slice(run[0], run[1] + 1).map((b) => `'${b.text}'`).join(", ")}]); pass rematch: true for animated text`);
-			const lineRects = [];
-			for (let i = run[0]; i <= run[1]; i++) {
-				const b = boxes[i];
-				const last = lineRects[lineRects.length - 1];
-				const cur = i > run[0] && boxes[i - 1].line === b.line ? last : void 0;
-				if (cur) {
-					cur.w = b.x + b.w + px - cur.x;
-					cur.y = Math.min(cur.y, b.y - py);
-					cur.h = Math.max(cur.h, b.y + b.h + py - cur.y);
-				} else lineRects.push({
-					x: b.x - px,
-					y: b.y - py,
-					w: b.w + 2 * px,
-					h: b.h + 2 * py
-				});
-			}
-			if (!pushedTransform && !matEquals(tm, IDENTITY)) {
-				out.push({
-					op: "transform",
-					m: tm
-				});
-				pushedTransform = true;
-			}
-			const grouped = opacity < 1;
-			if (grouped) out.push({
-				op: "pushGroup",
-				opacity,
-				blend: "source-over",
-				filters: []
-			});
-			const fill = r.fill();
-			const scale = r.scale();
-			const [ox, oy] = r.offset();
-			let remaining = progress * lineRects.reduce((sum, q) => sum + q.w, 0);
-			for (const q of lineRects) {
-				const fillW = Math.min(q.w, remaining);
-				remaining -= fillW;
-				if (fillW <= 0) break;
-				const cx = q.x + q.w / 2 + ox;
-				const cy = q.y + q.h / 2 + oy;
-				const w = fillW * scale;
-				const h = q.h * scale;
-				const x = cx - q.w / 2 * scale;
-				const y = cy - h / 2;
-				const rad = Math.min(this.cornerRadius, w / 2, h / 2);
-				const path = out.resource({
-					kind: "path",
-					segs: roundedRectSegs(x, y, w, h, rad)
-				});
-				out.push({
-					op: "fillPath",
-					path,
-					paint: {
-						kind: "color",
-						color: fill
-					}
-				});
-				if (remaining <= 0) break;
-			}
-			if (grouped) out.push({ op: "popGroup" });
-		}
-	}
-};
-function runText(boxes, run) {
-	return boxes.slice(run[0], run[1] + 1).map((b) => stripWs(b.text)).join("");
-}
-/**
-* `children: [tokenHighlight(para, { ranges: [{ match: '$48,200', fill: cat.money }] }), para]`
-* — each range animates independently via '<id>/<rangeId>/fill|opacity|progress|scale'.
-*/
-function tokenHighlight(text, props) {
-	return new TokenHighlight({
-		...props,
-		text
-	});
-}
-function init(sig, v) {
-	if (typeof v === "function") sig.bindSource(v);
-	else if (v !== void 0) sig.set(v);
-	return sig;
-}
-function initVec(sig, v) {
-	if (typeof v === "function") sig.bindSource(v);
-	else if (v !== void 0) sig.set(v);
-	return sig;
-}
-//#endregion
 //#region src/fontUsage.ts
 /**
 * Scene → font-validation bridge (DESIGN.md §3.6). Core owns the AssetRef,
@@ -1488,6 +974,7 @@ var Raster2D = class {
 	images = /* @__PURE__ */ new Map();
 	videos = /* @__PURE__ */ new Map();
 	warnedShaders = false;
+	warnedFontVariation = false;
 	/**
 	* §3.5 bitmap LRU: device-transform-qualified cacheKey → rasterized layer.
 	* A Map preserves insertion order, so the oldest key is `keys().next()` —
@@ -1756,10 +1243,19 @@ var Raster2D = class {
 				case "fillText": {
 					const ctx = ctxOf();
 					ctx.font = fontString(cmd.font);
+					const axes = cmd.font.fontVariationSettings;
+					if (axes !== void 0) {
+						if ("fontVariationSettings" in ctx) ctx.fontVariationSettings = axes;
+						else if (!this.warnedFontVariation) {
+							this.warnedFontVariation = true;
+							emitDevWarning("fontVariationSettings ('" + axes + "') is not applied here: this 2D context has no fontVariationSettings property (the browser DOM canvas) — variable-font axes render on the Skia/export path; use the discrete fontWeight named instances for a browser weight (§3.6)");
+						}
+					}
 					ctx.fillStyle = resolveFill(ctx, cmd.paint, null);
 					ctx.textBaseline = "alphabetic";
 					ctx.textAlign = cmd.align ?? "left";
 					ctx.fillText(cmd.text, cmd.x, cmd.y);
+					if (axes !== void 0 && "fontVariationSettings" in ctx) ctx.fontVariationSettings = "normal";
 					try {
 						const width = ctx.measureText(cmd.text).width;
 						const align = cmd.align ?? "left";
@@ -1857,4 +1353,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, __resetEstimateWarnings, 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, isEstimatingMeasurer, 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, DeterminismViolationError, DuplicateNodeIdError, EachError, FilterValidationError, 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, Video, __resetEstimateWarnings, applyToPoint, arcLength, bindScene, breakLines, coercePathData, collapseReplacer, collectLocalizedTextUsages, collectTextUsages, createDisplayListBuilder, createScene, drawOn, drawOnEach, each, estimatingMeasurer, evaluate, filtersToCanvasFilter, flatten, fontString, fromTRS, getLayoutEngine, glow, hachureLines, highlight, invert, isEstimatingMeasurer, matEquals, meshRasterSize, multiply, pathFromSegs, quantize, rasterizeMesh, requireLayoutEngine, resolveAnchor, resolveSketch, revealSchedule, roughen, roundedRectSegs, segmentGraphemes, segmentWords, setDefaultMeasurer, setLayoutEngine, sketchStrokes, textCursor, typewriter, validateFilters, validateHachure, validateSceneFonts, validateSketch, withDeterminismGuards };