@glissade/scene 0.21.0 → 0.22.0-pre.1

package/dist/describe.js

@@ -22,7 +22,7 @@ import { easings, listValueTypes } from "@glissade/core";
 * never pulled onto the base embed path — a scene that never calls `describe()`
 * pays zero bytes for it.
 */
-const RAW_VERSION = "0.21.0";
+const RAW_VERSION = "0.22.0-pre.1";
 const PACKAGE_VERSION = RAW_VERSION.includes("GLISSADE_".concat("VERSION")) ? "0.0.0-dev" : RAW_VERSION;
 /** Arity of a value type's numeric repr: vec2/vec2-arc → 2, number → 1; others (color/paint/path/string/boolean) carry no scalar arity. */
 function arityOf(type) {
@@ -74,6 +74,7 @@ const CONSTRUCTION_PROP_META = {
 		fontStyle: { type: "'normal'|'italic'" },
 		align: { type: "'left'|'center'|'right'" },
 		lineHeight: { type: "number" },
+		letterSpacing: { type: "number" },
 		fontVariationSettings: { type: "string" }
 	},
 	Image: { assetId: {

package/dist/displayList.d.ts

@@ -58,6 +58,16 @@ interface FontSpec {
    * hard-throws `UnboundTargetError` (no signal resolves to it).
    */
   fontVariationSettings?: string;
+  /**
+   * Letter-spacing (tracking) in **px**, applied between glyphs. Maps 1:1 to
+   * `ctx.letterSpacing` on the canvas/Skia path (both `@napi-rs/canvas` and the
+   * modern browser 2D context honor it — and it affects `measureText`, so
+   * wrapping stays correct) and to CSS `letter-spacing` on the DOM backend.
+   * OMITTED for default Text, so a node without tracking emits a byte-identical
+   * FontSpec (the golden corpus depends on this). For em-relative tracking pass
+   * `em * fontSize` (px is the engine's unit everywhere else).
+   */
+  letterSpacing?: number;
 }
 /**
  * Group filters (§3.4): a CLOSED union — validated data, never a CSS

package/dist/index.js

@@ -1243,6 +1243,8 @@ var Raster2D = class {
 				case "fillText": {
 					const ctx = ctxOf();
 					ctx.font = fontString(cmd.font);
+					const ls = cmd.font.letterSpacing;
+					if (ls !== void 0 && "letterSpacing" in ctx) ctx.letterSpacing = `${ls}px`;
 					const axes = cmd.font.fontVariationSettings;
 					if (axes !== void 0) {
 						if ("fontVariationSettings" in ctx) ctx.fontVariationSettings = axes;
@@ -1265,6 +1267,7 @@ var Raster2D = class {
 					} catch {
 						top().unbounded = true;
 					}
+					if (ls !== void 0 && "letterSpacing" in ctx) ctx.letterSpacing = "0px";
 					break;
 				}
 				case "drawImage": {

package/dist/nodes.d.ts

@@ -671,6 +671,15 @@ interface TextProps extends NodeProps {
   width?: PropInit<number>;
   /** Line height as a multiple of fontSize; default 1.25. */
   lineHeight?: number;
+  /**
+   * Letter-spacing (tracking) in **px** between glyphs; unset = none (0). STATIC
+   * passthrough threaded into the FontSpec — applied 1:1 by every backend
+   * (`ctx.letterSpacing` on canvas/Skia, CSS `letter-spacing` on DOM) and it
+   * affects measurement, so wrapping stays correct. Not a registered target (no
+   * animatable tracking in 0.21); when unset the FontSpec omits it, so default
+   * Text stays byte-identical. For em-relative tracking pass `em * fontSize`.
+   */
+  letterSpacing?: number;
   /**
    * Typewriter reveal: how many graphemes of the laid-out text are shown,
    * left-to-right. Default Infinity = fully shown (byte-identical to no
@@ -705,6 +714,8 @@ declare class Text extends Node {
   readonly align: 'left' | 'center' | 'right';
   readonly width: BindableSignal<number>;
   readonly lineHeight: number;
+  /** Static letter-spacing (tracking) in px; undefined = none. */
+  readonly letterSpacing: number | undefined;
   readonly reveal: BindableSignal<number>;
   /**
    * Reveal fraction in [0, 1]; NaN (the default) means "unset" so plain `reveal`

package/dist/nodes.js

@@ -722,7 +722,8 @@ const NODE_CONSTRUCTION_PROP_NAMES = {
 		"fontStyle",
 		"align",
 		"lineHeight",
-		"fontVariationSettings"
+		"fontVariationSettings",
+		"letterSpacing"
 	],
 	Image: ["assetId"],
 	Video: [
@@ -1830,6 +1831,8 @@ var Text = class Text extends Node {
 	align;
 	width;
 	lineHeight;
+	/** Static letter-spacing (tracking) in px; undefined = none. */
+	letterSpacing;
 	reveal;
 	/**
 	* Reveal fraction in [0, 1]; NaN (the default) means "unset" so plain `reveal`
@@ -1849,6 +1852,7 @@ var Text = class Text extends Node {
 		this.align = props.align ?? "left";
 		this.width = initProp(signal(0), props.width);
 		this.lineHeight = props.lineHeight ?? 1.25;
+		this.letterSpacing = props.letterSpacing;
 		this.reveal = initProp(signal(Number.POSITIVE_INFINITY), props.reveal);
 		this.revealFraction = initProp(signal(NaN), props.revealFraction);
 		this.registerTarget("width", this.width, "number");
@@ -1872,7 +1876,8 @@ var Text = class Text extends Node {
 			size: this.fontSize(),
 			weight: this.fontWeight,
 			...this.fontStyle === "italic" ? { style: "italic" } : {},
-			...this.fontVariationSettings !== void 0 ? { fontVariationSettings: this.fontVariationSettings } : {}
+			...this.fontVariationSettings !== void 0 ? { fontVariationSettings: this.fontVariationSettings } : {},
+			...this.letterSpacing !== void 0 ? { letterSpacing: this.letterSpacing } : {}
 		};
 	}
 	/**

package/dist/type.js

@@ -59,7 +59,8 @@ function splitText(source, opts = {}) {
 		fontWeight: text.fontWeight,
 		fontStyle: text.fontStyle,
 		fill: text.fill(),
-		lineHeight: text.lineHeight
+		lineHeight: text.lineHeight,
+		letterSpacing: text.letterSpacing
 	};
 	const step = quantize(font.fontSize * font.lineHeight);
 	const boxes = by === "line" ? text.lineBoxes(m).map((b, i) => ({
@@ -98,6 +99,7 @@ function splitText(source, opts = {}) {
 			fontWeight: font.fontWeight,
 			...font.fontStyle === "italic" ? { fontStyle: "italic" } : {},
 			lineHeight: font.lineHeight,
+			...font.letterSpacing !== void 0 ? { letterSpacing: font.letterSpacing } : {},
 			align: "left",
 			position: [b.x, b.line * step]
 		});

package/package.json

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