@glissade/scene 0.10.0-pre.0 → 0.10.0

package/dist/index.js

@@ -371,8 +371,8 @@ function createScene(init) {
 	});
 	const nodes = /* @__PURE__ */ new Map();
 	const playhead = createPlayhead();
-	let measurer = null;
-	indexNodes(root, nodes, () => measurer ?? fallbackMeasurer());
+	const measurer = signal(null);
+	indexNodes(root, nodes, () => measurer() ?? fallbackMeasurer());
 	return {
 		root,
 		nodes,
@@ -384,10 +384,10 @@ function createScene(init) {
 			return nodes.get(target.slice(0, slash))?.resolveTarget(target.slice(slash + 1));
 		},
 		setTextMeasurer: (m) => {
-			measurer = m;
+			measurer.set(m);
 		},
 		get textMeasurer() {
-			return measurer ?? fallbackMeasurer();
+			return measurer.peek() ?? fallbackMeasurer();
 		}
 	};
 }

package/dist/layout.js

@@ -95,6 +95,7 @@ var Layout = class extends Group {
 			justify: this.justify,
 			align: this.align
 		};
+		this.trackStructure();
 		const flowable = [];
 		const absolute = [];
 		this.children.forEach((child, index) => {

package/dist/layoutEngine.d.ts

@@ -287,6 +287,15 @@ interface NodeProps {
    * (the cache key folds in the inherited device transform, so a stale CTM can
    * never blit). OFF by default: a scene that never sets it emits ZERO extra
    * groups and is byte-identical to before. Best for expensive STATIC subtrees.
+   *
+   * CAVEAT (when it does NOT help): the key folds in the inherited device
+   * transform, so a subtree that itself DRIFTS — e.g. animated on sub-pixel
+   * float positions — misses the cache every frame; cache a static subtree
+   * under a *moving parent*, not a subtree that moves itself. And a `filter`
+   * is a LIVE composite parameter applied on the blit, never baked into the
+   * cached bitmap, so `cache:true` on a filter-declaring (e.g. blurred) group
+   * does not cache the filter cost. For per-frame-cheap drift, prefer
+   * eliminating the work (a cheaper Paint/effect) over caching it.
    */
   cache?: boolean;
 }
@@ -476,11 +485,17 @@ declare function sketchStrokes(segs: readonly PathSeg[], style: SketchStyle, see
 /** Rounded-rect path segments — Rect's outline, shared with Highlight. */
 declare function roundedRectSegs(x: number, y: number, w: number, h: number, r: number): PathSeg[];
 declare class Group extends Node {
+  #private;
   readonly children: Node[];
   constructor(props?: NodeProps & {
     children?: Node[];
   });
+  /** Record the structural version as a dependency — call inside a computed
+   * that walks `children` so add()/remove() invalidate it. */
+  protected trackStructure(): void;
   add(child: Node): this;
+  /** Remove a child (the reactive counterpart to add()); no-op if absent. */
+  remove(child: Node): this;
   protected draw(out: DisplayListBuilder, ctx: EvalContext): void;
 }
 interface ShapeProps extends NodeProps {

package/dist/layoutEngine.js

@@ -910,14 +910,34 @@ function roundedRectSegs(x, y, w, h, r) {
 }
 var Group = class extends Node {
 	children;
+	/** Version bumped on structural child mutation, so a dependency-tracked memo
+	* (e.g. Layout's computed) re-runs when the child SET changes — not only when
+	* a participating prop signal does. */
+	#structure = signal(0);
 	constructor(props = {}) {
 		super(props);
 		this.children = props.children ?? [];
 		for (const child of this.children) child.parent = this;
 	}
+	/** Record the structural version as a dependency — call inside a computed
+	* that walks `children` so add()/remove() invalidate it. */
+	trackStructure() {
+		this.#structure();
+	}
 	add(child) {
 		child.parent = this;
 		this.children.push(child);
+		this.#structure.set(this.#structure.peek() + 1);
+		return this;
+	}
+	/** Remove a child (the reactive counterpart to add()); no-op if absent. */
+	remove(child) {
+		const i = this.children.indexOf(child);
+		if (i >= 0) {
+			this.children.splice(i, 1);
+			if (child.parent === this) child.parent = null;
+			this.#structure.set(this.#structure.peek() + 1);
+		}
 		return this;
 	}
 	draw(out, ctx) {

package/package.json

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