@glissade/scene 0.18.0 → 0.19.0-pre.0

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.18.0";
+const RAW_VERSION = "0.19.0-pre.0";
 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) {
@@ -205,7 +205,11 @@ const BUILDER_METHODS = [
 	},
 	{
 		name: "stagger",
-		signature: "stagger<T>(targets, { to, from?, duration?, ease? }, { each: number | ((rank, count) => number), anchor?, at? }): TimelineBuilder"
+		signature: "stagger<T>(targets, { to: T | ((index, count) => T), from?: T | ((index, count) => T), duration?, ease? }, { each: number | ((rank, count) => number), anchor?, at? }): TimelineBuilder"
+	},
+	{
+		name: "tracks",
+		signature: "tracks(tracks: Track[]): TimelineBuilder"
 	},
 	{
 		name: "set",

package/dist/index.d.ts

@@ -457,6 +457,19 @@ declare function bindScene(scene: Scene, doc: Timeline): BindingCacheEntry;
  * caller's precondition.
  */
 declare function evaluate(scene: Scene, doc: Timeline, t: number): DisplayList;
+/**
+ * Controlled / imperative drive (0.19): `evaluate(scene)` with NO timeline —
+ * the host owns the clock. It evaluates against an EMPTY timeline at the
+ * scene's current playhead value (`peek()`, 0 by default), so values set
+ * imperatively via `node.set(...)` between frames survive into the DisplayList
+ * (no track clobbers them). See docs/controlled-drive.md for the loop and the
+ * `.set()`-vs-timeline precedence contract.
+ *
+ * PRECEDENCE: a timeline track ALWAYS overrides `.set()` on the prop it
+ * targets while that track is live — pass the timeline through the 3-arg form
+ * for animated props; reserve this overload for host-owned props.
+ */
+declare function evaluate(scene: Scene): DisplayList;
 //#endregion
 //#region src/cacheColdAudit.d.ts
 interface CacheColdResult {

package/dist/index.js

@@ -602,11 +602,17 @@ function bindScene(scene, doc) {
 	return entry;
 }
 /**
-* The non-negotiable contract (§2.5): same (scene, timeline, t) → identical
-* DisplayList, in any call order. Never awaits; asset readiness is the
-* caller's precondition.
+* 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).
 */
-function evaluate(scene, doc, t) {
+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 = {

package/package.json

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