@glissade/scene 0.19.0-pre.4 → 0.19.0-pre.5

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.19.0-pre.4";
+const RAW_VERSION = "0.19.0-pre.5";
 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) {
@@ -209,7 +209,7 @@ const BUILDER_METHODS = [
 	},
 	{
 		name: "tracks",
-		signature: "tracks(tracks: Track[]): TimelineBuilder"
+		signature: "tracks(tracks: Track[] | { tracks: Track[] }): TimelineBuilder"
 	},
 	{
 		name: "set",

package/dist/type.d.ts

@@ -21,6 +21,12 @@ interface SplitTextOpts {
 }
 /** One part of a split, in the source Text's draw space (group-local coords). */
 interface SplitPart {
+  /**
+   * The part's registered node id — `${id}/${i}`, the SAME string the child
+   * Text was constructed with. Bind a track straight against it:
+   * `parts.map((p) => p.id + '/revealFraction')` (or use `result.targets(prop)`).
+   */
+  id: string;
   /** The part's text (a word, a full line, or a single grapheme). */
   text: string;
   /** The generated child node (a left-aligned Text positioned at the part). */
@@ -42,6 +48,12 @@ interface SplitTextResult {
   children: Text[];
   /** Per-part geometry + node, in reading order. */
   parts: SplitPart[];
+  /**
+   * Ready-to-bind track targets — `[`${id}/0/${prop}`, `${id}/1/${prop}`, …]`
+   * in reading order. The blessed kinetic-typography recipe is one line:
+   * `tl.stagger(result.targets('revealFraction'), { from: 0, to: 1 }, { each: 0.1 })`.
+   */
+  targets(prop: string): string[];
 }
 declare class SplitTextError extends Error {
   constructor(message: string);
@@ -51,12 +63,14 @@ declare class SplitTextError extends Error {
  * Texts — one per word / line / grapheme. PURE build-time expansion to ordinary
  * nodes; the part geometry is a STATIC snapshot of the source's current layout.
  *
- *   const split = splitText(title, { by: 'word', id: 'title' });
+ *   const split = splitText(title, { by: 'word', id: 'title', measurer });
  *   // scene children: [split.node]  (REPLACES the original title)
- *   // animate each word: split.children[i] / track('title/0/opacity', …)
+ *   // animate each word: split.targets('revealFraction') === ['title/0/revealFraction', …]
+ *   tl.stagger(split.targets('revealFraction'), { from: 0, to: 1 }, { each: 0.1 });
  *
- * Stagger a word-by-word reveal by fanning a clip across `split.children`, or
- * compose with `tl.stagger` over the `${id}/${i}` ids.
+ * Bind tracks against `split.targets(prop)` (ready ids, reading order) or
+ * `parts[i].id` / `parts[i].node` directly. `{ measurer }` is required for exact
+ * part geometry — see the dev-warning footgun below.
  */
 declare function splitText(source: Text | TextProps, opts?: SplitTextOpts): SplitTextResult;
 //#endregion

package/dist/type.js

@@ -32,12 +32,14 @@ var SplitTextError = class extends Error {
 * Texts — one per word / line / grapheme. PURE build-time expansion to ordinary
 * nodes; the part geometry is a STATIC snapshot of the source's current layout.
 *
-*   const split = splitText(title, { by: 'word', id: 'title' });
+*   const split = splitText(title, { by: 'word', id: 'title', measurer });
 *   // scene children: [split.node]  (REPLACES the original title)
-*   // animate each word: split.children[i] / track('title/0/opacity', …)
+*   // animate each word: split.targets('revealFraction') === ['title/0/revealFraction', …]
+*   tl.stagger(split.targets('revealFraction'), { from: 0, to: 1 }, { each: 0.1 });
 *
-* Stagger a word-by-word reveal by fanning a clip across `split.children`, or
-* compose with `tl.stagger` over the `${id}/${i}` ids.
+* Bind tracks against `split.targets(prop)` (ready ids, reading order) or
+* `parts[i].id` / `parts[i].node` directly. `{ measurer }` is required for exact
+* part geometry — see the dev-warning footgun below.
 */
 function splitText(source, opts = {}) {
 	const text = source instanceof Text ? source : new Text(source);
@@ -81,8 +83,9 @@ function splitText(source, opts = {}) {
 	const parts = [];
 	for (let i = 0; i < boxes.length; i++) {
 		const b = boxes[i];
+		const partId = `${id}/${i}`;
 		const node = new Text({
-			id: `${id}/${i}`,
+			id: partId,
 			text: b.text,
 			fill: font.fill,
 			fontFamily: font.fontFamily,
@@ -95,6 +98,7 @@ function splitText(source, opts = {}) {
 		});
 		children.push(node);
 		parts.push({
+			id: partId,
 			text: b.text,
 			node,
 			line: b.line,
@@ -107,14 +111,17 @@ function splitText(source, opts = {}) {
 		});
 	}
 	const [px, py] = text.position();
+	const node = new Group({
+		id,
+		children,
+		position: [px, py]
+	});
+	const targets = (prop) => parts.map((p) => `${p.id}/${prop}`);
 	return {
-		node: new Group({
-			id,
-			children,
-			position: [px, py]
-		}),
+		node,
 		children,
-		parts
+		parts,
+		targets
 	};
 }
 //#endregion

package/package.json

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