@glissade/scene 0.14.0-pre.0 → 0.14.0-pre.1

package/dist/index.d.ts

@@ -653,6 +653,15 @@ declare function tokenHighlight(text: Text, props: Omit<TokenHighlightProps, 'te
 //#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
@@ -664,6 +673,13 @@ 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
@@ -876,4 +892,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, 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, 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

@@ -931,7 +931,7 @@ var TokenHighlight = class extends Node {
 			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`, r.offset, ["vec2", "vec2-arc"]);
 			this.registerTarget(`${id}/offset.x`, r.offset.x, "number");
 			this.registerTarget(`${id}/offset.y`, r.offset.y, "number");
 			return r;
@@ -1073,6 +1073,35 @@ function collectTextUsages(scene) {
 	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`
@@ -1082,7 +1111,7 @@ function collectTextUsages(scene) {
 async function validateSceneFonts(scene, doc, loadBytes, options = {}) {
 	const mode = options.mode ?? "dev";
 	const registry = buildFontRegistry(doc.assets);
-	const usages = collectTextUsages(scene);
+	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();
@@ -1821,4 +1850,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, 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, 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/layoutEngine.d.ts

@@ -299,9 +299,11 @@ interface BindablePropTarget {
   unbindSource(): void;
   /**
    * The value type(s) this prop accepts — bindTimeline hard-throws a mismatched
-   * track (§2.2). An array for a polymorphic prop (a Shape `fill` is color|paint).
+   * track (§2.2). An array for a polymorphic prop (a Shape `fill` is color|paint,
+   * a vec2 prop is vec2|vec2-arc). UNDEFINED for an untagged target (the 2-arg
+   * registerTarget form): bindTimeline skips the guard (0.13 back-compat seam).
    */
-  readonly expects: ValueTypeId | readonly ValueTypeId[];
+  readonly expects: ValueTypeId | readonly ValueTypeId[] | undefined;
 }
 /** Node-local hit-shape override (v2 §C.3) — fat targets for thin strokes. */
 type HitArea = {
@@ -355,11 +357,17 @@ declare abstract class Node {
    * signal accepts (§2.2). The stamp is what bindTimeline's bind-time guard
    * reads to reject a mismatched track (a scalar on a vec2, a number on a paint
    * prop, …) instead of silently sampling to NaN/undefined.
+   *
+   * `expects` is OPTIONAL: omitting it (the 2-arg form) leaves the target
+   * UNtagged — bindTimeline then skips the type guard for it, which is the
+   * back-compat seam for external `Custom`/`Node` subclasses (DESIGN.md §329)
+   * and prebuilt 0.13 nodes that called the 2-arg form (0.13 had no guard). A
+   * built-in node opts INTO the guard by tagging.
    */
   protected registerTarget(path: string, sig: {
     bindSource(fn: () => unknown): void;
     unbindSource(): void;
-  }, expects: ValueTypeId | readonly ValueTypeId[]): void;
+  }, expects?: ValueTypeId | readonly ValueTypeId[]): void;
   resolveTarget(path: string): BindablePropTarget | undefined;
   /** Subclass drawing: emit own commands (and children for containers). */
   protected abstract draw(out: DisplayListBuilder, ctx: EvalContext): void;

package/dist/layoutEngine.js

@@ -560,11 +560,11 @@ var Node = class {
 			]);
 		}, { equals: matEquals });
 		this.worldMatrix = computed(() => this.parent ? multiply(this.parent.worldMatrix(), this.localMatrix()) : this.localMatrix(), { equals: matEquals });
-		this.registerTarget("position", this.position, "vec2");
+		this.registerTarget("position", this.position, ["vec2", "vec2-arc"]);
 		this.registerTarget("position.x", this.position.x, "number");
 		this.registerTarget("position.y", this.position.y, "number");
 		this.registerTarget("rotation", this.rotation, "number");
-		this.registerTarget("scale", this.scale, "vec2");
+		this.registerTarget("scale", this.scale, ["vec2", "vec2-arc"]);
 		this.registerTarget("scale.x", this.scale.x, "number");
 		this.registerTarget("scale.y", this.scale.y, "number");
 		this.registerTarget("opacity", this.opacity, "number");
@@ -575,6 +575,12 @@ var Node = class {
 	* signal accepts (§2.2). The stamp is what bindTimeline's bind-time guard
 	* reads to reject a mismatched track (a scalar on a vec2, a number on a paint
 	* prop, …) instead of silently sampling to NaN/undefined.
+	*
+	* `expects` is OPTIONAL: omitting it (the 2-arg form) leaves the target
+	* UNtagged — bindTimeline then skips the type guard for it, which is the
+	* back-compat seam for external `Custom`/`Node` subclasses (DESIGN.md §329)
+	* and prebuilt 0.13 nodes that called the 2-arg form (0.13 had no guard). A
+	* built-in node opts INTO the guard by tagging.
 	*/
 	registerTarget(path, sig, expects) {
 		sig.expects = expects;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glissade/scene",
-  "version": "0.14.0-pre.0",
+  "version": "0.14.0-pre.1",
   "description": "glissade scene graph: nodes, transforms, DisplayList emission. Renderer-agnostic; zero DOM/Node dependencies.",
   "license": "Apache-2.0",
   "engines": {
@@ -23,7 +23,7 @@
   ],
   "dependencies": {
     "yoga-layout": "^3.2.1",
-    "@glissade/core": "0.14.0-pre.0"
+    "@glissade/core": "0.14.0-pre.1"
   },
   "repository": {
     "type": "git",