@flighthq/node 0.1.0

package/dist/hierarchy.js

@@ -0,0 +1,396 @@
+import { acquireMatrix, copyMatrix, inverseMatrix, multiplyMatrix, releaseMatrix } from '@flighthq/geometry';
+import { emitSignal } from '@flighthq/signals';
+import { getNodeRuntime } from './node';
+import { invalidateNodeLocalTransform, invalidateNodeParentReference } from './revision';
+import { ensureNodeWorldTransformMatrix, getNodeWorldTransformMatrix } from './transform2d';
+/**
+ * Adds a child Node instance to this Node
+ * instance. The child is added to the front (top) of all other children in
+ * this Node instance.
+ **/
+export function addNodeChild(target, child) {
+    return addNodeChildAt(target, child, getNodeChildCount(target));
+}
+/**
+ * Adds a child Node instance to this Node
+ * instance. The child is added at the index position specified. An index of
+ * 0 represents the back (bottom) of the display list for this
+ * Node object.
+ **/
+export function addNodeChildAt(target, child, index) {
+    const targetRuntime = getNodeRuntime(target);
+    let children = targetRuntime.children;
+    if (!child) {
+        throw new TypeError('Parameter child must be non-null');
+    }
+    else if (child === target) {
+        throw new TypeError('An object cannot be added as a child of itself');
+    }
+    else if (index < 0 || (children !== null && index > children.length) || (children === null && index > 0)) {
+        throwOutOfBoundsError();
+    }
+    if (!targetRuntime.canAddChild(target, child)) {
+        throw new TypeError('The specified parent object cannot add this child');
+    }
+    if (children === null) {
+        children = targetRuntime.children = [];
+    }
+    const childRuntime = getNodeRuntime(child);
+    const parent = childRuntime.parent;
+    if (parent === target) {
+        const i = children.indexOf(child);
+        if (i !== -1) {
+            if (i === index)
+                return child;
+            children.splice(i, 1);
+        }
+    }
+    else {
+        if (parent !== null) {
+            removeNodeChild(parent, child);
+        }
+    }
+    children.splice(index, 0, child);
+    const targetSignals = targetRuntime.nodeSignals;
+    if (targetSignals !== null)
+        emitSignal(targetSignals.onChildrenChanged);
+    if (parent !== target) {
+        childRuntime.parent = target;
+        if (targetSignals !== null)
+            emitSignal(targetSignals.onChildAdded, child);
+        const childSignals = childRuntime.nodeSignals;
+        if (childSignals !== null)
+            emitSignal(childSignals.onParentChanged);
+        invalidateNodeParentReference(child);
+    }
+    return child;
+}
+/**
+ * Adds multiple children to `target` in order, appending each after the last. Equivalent to
+ * calling `addNodeChild` for each child but signals are still emitted per child.
+ */
+export function addNodeChildren(target, ...children) {
+    for (let i = 0; i < children.length; i++) {
+        addNodeChild(target, children[i]);
+    }
+}
+/**
+ * Determines whether the specified scene node is a child of the
+ * NodeContainer instance or the instance itself.
+ **/
+export function containsNodeChild(source, child) {
+    let current = child;
+    while (current !== source && current !== null) {
+        current = getNodeParent(current);
+    }
+    return current === source;
+}
+/**
+ * Calls `callback` for each direct child of `source` in index order (back to front).
+ * Stops early if `callback` returns `false`.
+ */
+export function forEachNodeChild(source, callback) {
+    const children = getNodeRuntime(source).children;
+    if (children === null)
+        return;
+    for (let i = 0; i < children.length; i++) {
+        if (callback(children[i], i) === false)
+            return;
+    }
+}
+/**
+ * Returns a read-only snapshot of all ancestors of `source`, from immediate parent toward the
+ * root. The source node itself is not included.
+ */
+export function getNodeAncestors(source) {
+    const result = [];
+    let current = getNodeParent(source);
+    while (current !== null) {
+        result.push(current);
+        current = getNodeParent(current);
+    }
+    return result;
+}
+/**
+ * Returns the child scene node instance that exists at the specified
+ * index.
+ **/
+export function getNodeChildAt(source, index) {
+    const children = getNodeRuntime(source).children;
+    if (children !== null && index >= 0 && index < children.length) {
+        return children[index];
+    }
+    return null;
+}
+/**
+ * Returns the child scene node that exists with the specified name. If
+ * more that one child scene node has the specified name, the method
+ * returns the first object found.
+ **/
+export function getNodeChildByName(source, name) {
+    const children = getNodeRuntime(source).children;
+    if (children !== null) {
+        for (let i = 0; i < children.length; i++) {
+            if (children[i].name === name)
+                return children[i];
+        }
+    }
+    return null;
+}
+export function getNodeChildCount(source) {
+    const children = getNodeRuntime(source).children;
+    return children !== null ? children.length : 0;
+}
+/**
+ * Returns the index position of a `child` Node instance.
+ **/
+export function getNodeChildIndex(source, child) {
+    const children = getNodeRuntime(source).children;
+    if (children !== null) {
+        for (let i = 0; i < children.length; i++) {
+            if (children[i] === child)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Returns the lowest common ancestor of `a` and `b`, or `null` if they share no common ancestor.
+ * If one node is an ancestor of the other, that ancestor is returned.
+ */
+export function getNodeCommonAncestor(a, b) {
+    // Build the ancestor set for `a`, then walk `b`'s chain to find the first match.
+    const aAncestors = new Set();
+    aAncestors.add(a);
+    let cur = getNodeParent(a);
+    while (cur !== null) {
+        aAncestors.add(cur);
+        cur = getNodeParent(cur);
+    }
+    let bCur = b;
+    while (bCur !== null) {
+        if (aAncestors.has(bCur))
+            return bCur;
+        bCur = getNodeParent(bCur);
+    }
+    return null;
+}
+export function getNodeParent(source) {
+    return getNodeRuntime(source).parent;
+}
+/**
+ * Returns the topmost ancestor of the node, or the node itself if it has no
+ * parent.
+ **/
+export function getNodeRoot(source) {
+    let current = source;
+    let parent = getNodeParent(current);
+    while (parent !== null) {
+        current = parent;
+        parent = getNodeParent(current);
+    }
+    return current;
+}
+/**
+ * Returns `true` if `ancestor` is the same node as `descendant` or is located above
+ * `descendant` in the hierarchy.
+ */
+export function isNodeAncestorOf(ancestor, descendant) {
+    let current = descendant;
+    while (current !== null) {
+        if (current === ancestor)
+            return true;
+        current = getNodeParent(current);
+    }
+    return false;
+}
+/**
+ * Removes the specified `child` Node instance from the
+ * child list of the Node instance. The `parent`
+ * property of the removed child is set to `null` , and the object
+ * is garbage collected if no other references to the child exist. The index
+ * positions of any scene nodes above the child in the
+ * Node are decreased by 1.
+ **/
+export function removeNodeChild(target, child) {
+    if (!child)
+        return child;
+    const targetRuntime = getNodeRuntime(target);
+    const childRuntime = getNodeRuntime(child);
+    const children = targetRuntime.children;
+    if (children !== null && childRuntime.parent === target) {
+        childRuntime.parent = null;
+        const childSignals = childRuntime.nodeSignals;
+        if (childSignals !== null)
+            emitSignal(childSignals.onParentChanged);
+        invalidateNodeParentReference(child);
+        const i = children.indexOf(child);
+        if (i !== -1) {
+            children.splice(i, 1);
+        }
+        const targetSignals = targetRuntime.nodeSignals;
+        if (targetSignals !== null) {
+            emitSignal(targetSignals.onChildRemoved, child);
+            emitSignal(targetSignals.onChildrenChanged);
+        }
+    }
+    return child;
+}
+/**
+ * Removes a child Node from the specified `index`
+ * position in the child list of the Node. The
+ * `parent` property of the removed child is set to
+ * `null`, and the object is garbage collected if no other
+ * references to the child exist. The index positions of any scene nodes
+ * above the child in the Node are decreased by 1.
+ **/
+export function removeNodeChildAt(target, index) {
+    const children = getNodeRuntime(target).children;
+    if (children !== null && index >= 0 && index < children.length) {
+        return removeNodeChild(target, children[index]);
+    }
+    return null;
+}
+/**
+ * Removes all `child` Node instances from the child list of the Node
+ * instance. The `parent` property of the removed children is set to `null`, and the objects are
+ * garbage collected if no other references to the children exist.
+ **/
+export function removeNodeChildren(target, beginIndex = 0, endIndex) {
+    const children = getNodeRuntime(target).children;
+    if (children === null)
+        return;
+    if (beginIndex > children.length - 1)
+        return;
+    if (endIndex === undefined) {
+        endIndex = children.length - 1;
+    }
+    if (endIndex < beginIndex || beginIndex < 0 || endIndex > children.length) {
+        throwOutOfBoundsError();
+    }
+    let numRemovals = endIndex - beginIndex;
+    while (numRemovals >= 0) {
+        removeNodeChildAt(target, beginIndex);
+        numRemovals--;
+    }
+}
+/**
+ * Moves a child to a new parent while preserving its world-space position.
+ * The child's local TRS fields (x, y, rotation, scaleX, scaleY) are recomputed
+ * so its visual position, rotation, and scale remain unchanged. Existing skewX/skewY
+ * values are preserved (skew is not decomposable from a general affine matrix).
+ *
+ * To reparent without preserving world position (keeping local TRS unchanged),
+ * use addNodeChild instead.
+ */
+export function reparentNode(child, newParent) {
+    ensureNodeWorldTransformMatrix(child);
+    const oldWorld = acquireMatrix();
+    const localM = acquireMatrix();
+    try {
+        copyMatrix(oldWorld, getNodeWorldTransformMatrix(child));
+        addNodeChild(newParent, child);
+        inverseMatrix(localM, getNodeWorldTransformMatrix(newParent));
+        multiplyMatrix(localM, localM, oldWorld);
+        const a = localM.a;
+        const b = localM.b;
+        const c = localM.c;
+        const d = localM.d;
+        child.scaleX = Math.sqrt(a * a + b * b);
+        child.scaleY = Math.sqrt(c * c + d * d);
+        if (a * d - b * c < 0) {
+            child.scaleY = -child.scaleY;
+        }
+        const skewYRad = child.skewY * DEG_TO_RAD;
+        child.rotation = (Math.atan2(b, a) - skewYRad) * RAD_TO_DEG;
+        child.x = localM.tx + (a * child.pivotX + c * child.pivotY);
+        child.y = localM.ty + (b * child.pivotX + d * child.pivotY);
+        invalidateNodeLocalTransform(child);
+    }
+    finally {
+        releaseMatrix(oldWorld);
+        releaseMatrix(localM);
+    }
+    return child;
+}
+/**
+ * Replaces `oldChild` with `newChild` at the same index position in `target`'s children. If
+ * `oldChild` is not a child of `target`, this is a no-op. If `newChild` is already a child of
+ * `target`, it is moved to `oldChild`'s index.
+ */
+export function replaceNodeChild(target, oldChild, newChild) {
+    const index = getNodeChildIndex(target, oldChild);
+    if (index === -1)
+        return;
+    removeNodeChild(target, oldChild);
+    addNodeChildAt(target, newChild, index);
+}
+/**
+ * Changes the position of an existing child in the scene node container.
+ * This affects the layering of child objects.
+ **/
+export function setNodeChildIndex(target, child, index) {
+    const targetRuntime = getNodeRuntime(target);
+    const children = targetRuntime.children;
+    if (children === null)
+        return;
+    if (index >= 0 && index <= children.length && getNodeParent(child) === target) {
+        const i = children.indexOf(child);
+        if (i !== -1 && i !== index) {
+            children.splice(i, 1);
+            children.splice(index, 0, child);
+            const targetSignals = targetRuntime.nodeSignals;
+            if (targetSignals !== null)
+                emitSignal(targetSignals.onChildrenOrderChanged);
+        }
+    }
+}
+/**
+ * Recursively stops the timeline execution of all MovieClips rooted at this object.
+ **/
+// static stopAllMovieClips(): void {}
+/**
+ * Swaps the z-order (front-to-back order) of the two specified child
+ * objects. All other child objects in the scene node container remain in
+ * the same index positions.
+ **/
+export function swapNodeChildren(target, child1, child2) {
+    const targetRuntime = getNodeRuntime(target);
+    const children = targetRuntime.children;
+    if (children !== null && getNodeParent(child1) === target && getNodeParent(child2) === target) {
+        const index1 = children.indexOf(child1);
+        const index2 = children.indexOf(child2);
+        children[index1] = child2;
+        children[index2] = child1;
+        const targetSignals = getNodeRuntime(target).nodeSignals;
+        if (targetSignals !== null)
+            emitSignal(targetSignals.onChildrenOrderChanged);
+    }
+}
+/**
+ * Swaps the z-order (front-to-back order) of the child objects at the two
+ * specified index positions in the child list. All other child objects in
+ * the scene node container remain in the same index positions.
+ **/
+export function swapNodeChildrenAt(target, index1, index2) {
+    const targetRuntime = getNodeRuntime(target);
+    const children = targetRuntime.children;
+    if (children === null || index1 === index2)
+        return;
+    const len = children.length;
+    if (index1 < 0 || index2 < 0 || index1 >= len || index2 >= len) {
+        throwOutOfBoundsError();
+    }
+    const swap = children[index1];
+    children[index1] = children[index2];
+    children[index2] = swap;
+    const targetSignals = targetRuntime.nodeSignals;
+    if (targetSignals !== null)
+        emitSignal(targetSignals.onChildrenOrderChanged);
+}
+function throwOutOfBoundsError() {
+    throw new RangeError('The supplied index is out of bounds.');
+}
+const DEG_TO_RAD = Math.PI / 180;
+const RAD_TO_DEG = 180 / Math.PI;
+//# sourceMappingURL=hierarchy.js.map

package/dist/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../src/hierarchy.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from './boundsRectangle';
+export * from './hasAppearance';
+export * from './hasBoundsRectangle';
+export * from './hasClip';
+export * from './hasMaterial';
+export * from './hasTransform2d';
+export * from './hasTransform3d';
+export * from './hierarchy';
+export * from './node';
+export * from './revision';
+export * from './transform2d';
+export * from './transform3d';
+export * from './traversal';
+export * from './viewport';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export * from './boundsRectangle';
+export * from './hasAppearance';
+export * from './hasBoundsRectangle';
+export * from './hasClip';
+export * from './hasMaterial';
+export * from './hasTransform2d';
+export * from './hasTransform3d';
+export * from './hierarchy';
+export * from './node';
+export * from './revision';
+export * from './transform2d';
+export * from './transform3d';
+export * from './traversal';
+export * from './viewport';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,21 @@
+import type { Kind, MethodsOf, Node, NodeData, NodeDataFactory, NodeRuntime, NodeRuntimeFactory, NodeSignals, NodeTraits, PartialNode } from '@flighthq/types';
+export declare function createNode<Traits extends object = NodeTraits, Data extends NodeData = NodeData, Runtime extends NodeRuntime<Traits> = NodeRuntime<Traits>>(nodeKind: Kind, obj?: Readonly<PartialNode<Node<Traits>>>, createData?: NodeDataFactory<Data>, createNodeRuntimeFactory?: NodeRuntimeFactory<Runtime>): Node<Traits> & Traits;
+export declare function createNodeRuntime<Traits extends object = NodeTraits>(methods?: Readonly<Partial<MethodsOf<NodeRuntime<Traits>>>>): NodeRuntime<Traits>;
+export declare function createNodeSignals(): NodeSignals;
+export declare function defaultNodeRuntimeCanAddChild<Traits extends object>(_target: Node<Traits>, _child: Node<Traits>): boolean;
+/**
+ * Detaches `target` from its parent, recursively removes all descendants, and clears the
+ * `nodeSignals` and `interactionSignals` registries so the node becomes eligible for garbage
+ * collection. After disposal, `target` must not be added to a graph.
+ *
+ * Nodes in this package own no non-GC resources (GPU textures, native handles); therefore no
+ * `destroyNode` counterpart exists at this tier. Higher-level packages that attach non-GC
+ * resources (render proxies, GPU textures) should call `disposeNode` first and then release those
+ * resources themselves.
+ */
+export declare function disposeNode<Traits extends object = NodeTraits>(target: Node<Traits>): void;
+export declare function enableNodeSignals<Traits extends object = NodeTraits>(source: Node<Traits>): NodeSignals;
+export declare function getNodeRuntime<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>): Readonly<NodeRuntime<Traits>>;
+export declare function getNodeSignals<Traits extends object = NodeTraits>(source: Node<Traits>): NodeSignals | null;
+export declare function setNodeEnabled<Traits extends object = NodeTraits>(target: Node<Traits>, value: boolean): void;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAMzB,wBAAgB,UAAU,CACxB,MAAM,SAAS,MAAM,GAAG,UAAU,EAClC,IAAI,SAAS,QAAQ,GAAG,QAAQ,EAChC,OAAO,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,EAEzD,QAAQ,EAAE,IAAI,EACd,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EACzC,UAAU,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,EAClC,wBAAwB,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,GACrD,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAUvB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAClE,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC1D,WAAW,CAAC,MAAM,CAAC,CAqBrB;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAQ/C;AAED,wBAAgB,6BAA6B,CAAC,MAAM,SAAS,MAAM,EACjE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GACnB,OAAO,CAET;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAqC1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAGvG;AAED,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAC/D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC7B,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAE/B;AAED,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,GAAG,IAAI,CAE3G;AAED,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAG7G"}

package/dist/node.js

@@ -0,0 +1,109 @@
+import { createEntityRuntime, getEntityRuntime } from '@flighthq/entity';
+import { clearSignal, createSignal } from '@flighthq/signals';
+import { EntityRuntimeKey } from '@flighthq/types';
+import { removeNodeChild } from './hierarchy';
+import { invalidateNode } from './revision';
+export function createNode(nodeKind, obj, createData, createNodeRuntimeFactory) {
+    const runtimeFactory = createNodeRuntimeFactory ?? createNodeRuntime;
+    const out = {
+        data: createData !== undefined ? createData(obj?.data) : null,
+        name: obj?.name ?? null,
+        kind: nodeKind,
+        [EntityRuntimeKey]: runtimeFactory(),
+    };
+    out.enabled = obj?.enabled ?? true;
+    return out;
+}
+export function createNodeRuntime(methods) {
+    const out = createEntityRuntime();
+    out.appearanceId = 0;
+    out.boundsUsingLocalBoundsId = -1;
+    out.boundsUsingLocalTransformId = -1;
+    out.canAddChild = methods?.canAddChild ?? defaultNodeRuntimeCanAddChild;
+    out.children = null;
+    out.nodeSignals = null;
+    out.interactionSignals = null;
+    out.localBoundsId = 0;
+    out.localBoundsUsingLocalBoundsId = -1;
+    out.localContentId = 0;
+    out.localTransformId = 0;
+    out.localTransformUsingLocalTransformId = -1;
+    out.parent = null;
+    out.worldBoundsUsingLocalBoundsId = -1;
+    out.worldBoundsUsingWorldTransformId = -1;
+    out.worldTransformId = 0;
+    out.worldTransformUsingLocalTransformId = -1;
+    out.worldTransformUsingParentTransformId = -1;
+    return out;
+}
+export function createNodeSignals() {
+    return {
+        onChildAdded: createSignal(),
+        onChildRemoved: createSignal(),
+        onChildrenChanged: createSignal(),
+        onChildrenOrderChanged: createSignal(),
+        onParentChanged: createSignal(),
+    };
+}
+export function defaultNodeRuntimeCanAddChild(_target, _child) {
+    return true;
+}
+/**
+ * Detaches `target` from its parent, recursively removes all descendants, and clears the
+ * `nodeSignals` and `interactionSignals` registries so the node becomes eligible for garbage
+ * collection. After disposal, `target` must not be added to a graph.
+ *
+ * Nodes in this package own no non-GC resources (GPU textures, native handles); therefore no
+ * `destroyNode` counterpart exists at this tier. Higher-level packages that attach non-GC
+ * resources (render proxies, GPU textures) should call `disposeNode` first and then release those
+ * resources themselves.
+ */
+export function disposeNode(target) {
+    const runtime = getEntityRuntime(target);
+    // Detach from parent first so the parent's children list stays consistent.
+    const parent = runtime.parent;
+    if (parent !== null) {
+        removeNodeChild(parent, target);
+    }
+    // Recursively dispose children bottom-up (snapshot the array before mutating).
+    const children = runtime.children;
+    if (children !== null) {
+        // Snapshot to avoid mutation during iteration.
+        const snapshot = children.slice();
+        for (let i = 0; i < snapshot.length; i++) {
+            disposeNode(snapshot[i]);
+        }
+        runtime.children = null;
+    }
+    // Clear all signal listeners so they cannot fire after disposal.
+    const nodeSignals = runtime.nodeSignals;
+    if (nodeSignals !== null) {
+        clearSignal(nodeSignals.onChildAdded);
+        clearSignal(nodeSignals.onChildRemoved);
+        clearSignal(nodeSignals.onChildrenChanged);
+        clearSignal(nodeSignals.onChildrenOrderChanged);
+        clearSignal(nodeSignals.onParentChanged);
+        runtime.nodeSignals = null;
+    }
+    const interactionSignals = runtime.interactionSignals;
+    if (interactionSignals !== null) {
+        // InteractionSignals fields are owned by the interaction package; we can only clear our
+        // reference so the owning package's signals are released via GC.
+        runtime.interactionSignals = null;
+    }
+}
+export function enableNodeSignals(source) {
+    const runtime = getEntityRuntime(source);
+    return (runtime.nodeSignals ??= createNodeSignals());
+}
+export function getNodeRuntime(source) {
+    return getEntityRuntime(source);
+}
+export function getNodeSignals(source) {
+    return getEntityRuntime(source).nodeSignals;
+}
+export function setNodeEnabled(target, value) {
+    target.enabled = value;
+    invalidateNode(target);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/revision.d.ts

@@ -0,0 +1,40 @@
+import type { Node, NodeRuntime } from '@flighthq/types';
+export declare function computeNodeWorldTransformRevision<Traits extends object>(runtime: NodeRuntime<Traits>, parentRuntime?: Readonly<NodeRuntime<Traits>>): void;
+export declare function getNodeAppearanceRevision<Traits extends object>(source: Readonly<Node<Traits>>): number;
+export declare function getNodeLocalBoundsRevision<Traits extends object>(source: Readonly<Node<Traits>>): number;
+export declare function getNodeLocalContentRevision<Traits extends object>(source: Readonly<Node<Traits>>): number;
+export declare function getNodeLocalTransformRevision<Traits extends object>(source: Readonly<Node<Traits>>): number;
+export declare function getNodeWorldTransformRevision<Traits extends object>(source: Readonly<Node<Traits>>): number;
+export declare function invalidateNode<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's appearance changed (excluding transforms).
+ */
+export declare function invalidateNodeAppearance<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's own dimensions (not including children) changed.
+ */
+export declare function invalidateNodeLocalBounds<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's own drawable surface changed (the rasterizable payload — shape commands, text,
+ * pixels — not its children and not how it is composited). Renderers re-rasterize on this; the walk
+ * and render caches re-examine the node. Distinct from appearance (compositing) and bounds (extent).
+ */
+export declare function invalidateNodeLocalContent<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's own transform (x, y, rotation, scaleX, scaleY) changed.
+ */
+export declare function invalidateNodeLocalTransform<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's parent changed.
+ */
+export declare function invalidateNodeParentReference<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's visual output changed (appearance or local transform).
+ * Use this when animating properties like alpha, x, y, scaleX, scaleY, rotation.
+ */
+export declare function invalidateNodeRender<Traits extends object>(target: Node<Traits>): void;
+/**
+ * Target object's child bounds have changed.
+ */
+export declare function invalidateNodeWorldBounds<Traits extends object>(target: Node<Traits>): void;
+//# sourceMappingURL=revision.d.ts.map

package/dist/revision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision.d.ts","sourceRoot":"","sources":["../src/revision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIzD,wBAAgB,iCAAiC,CAAC,MAAM,SAAS,MAAM,EACrE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAC5B,aAAa,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAC5C,IAAI,CAMN;AAED,wBAAgB,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAEvG;AAED,wBAAgB,0BAA0B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAExG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAEzG;AAED,wBAAgB,6BAA6B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAE3G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAE3G;AAED,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAOhF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAG1F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAG5F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAG9F;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAG/F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAGtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAI3F"}