@flighthq/node 0.1.0

package/dist/revision.js

@@ -0,0 +1,85 @@
+import { getNodeRuntime } from './node';
+export function computeNodeWorldTransformRevision(runtime, parentRuntime) {
+    const localTransformId = runtime.localTransformId;
+    const parentWorldTransformId = parentRuntime ? parentRuntime.worldTransformId : 0;
+    runtime.worldTransformUsingLocalTransformId = localTransformId;
+    runtime.worldTransformUsingParentTransformId = parentWorldTransformId;
+    runtime.worldTransformId = (localTransformId << 16) | (parentWorldTransformId & 0xffff);
+}
+export function getNodeAppearanceRevision(source) {
+    return getNodeRuntime(source).appearanceId;
+}
+export function getNodeLocalBoundsRevision(source) {
+    return getNodeRuntime(source).localBoundsId;
+}
+export function getNodeLocalContentRevision(source) {
+    return getNodeRuntime(source).localContentId;
+}
+export function getNodeLocalTransformRevision(source) {
+    return getNodeRuntime(source).localTransformId;
+}
+export function getNodeWorldTransformRevision(source) {
+    return getNodeRuntime(source).worldTransformId;
+}
+export function invalidateNode(target) {
+    invalidateNodeAppearance(target);
+    invalidateNodeLocalBounds(target);
+    invalidateNodeLocalContent(target);
+    invalidateNodeLocalTransform(target);
+    invalidateNodeParentReference(target);
+    invalidateNodeWorldBounds(target);
+}
+/**
+ * Target object's appearance changed (excluding transforms).
+ */
+export function invalidateNodeAppearance(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.appearanceId = (runtime.appearanceId + 1) >>> 0;
+}
+/**
+ * Target object's own dimensions (not including children) changed.
+ */
+export function invalidateNodeLocalBounds(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.localBoundsId = (runtime.localBoundsId + 1) >>> 0;
+}
+/**
+ * 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 function invalidateNodeLocalContent(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.localContentId = (runtime.localContentId + 1) >>> 0;
+}
+/**
+ * Target object's own transform (x, y, rotation, scaleX, scaleY) changed.
+ */
+export function invalidateNodeLocalTransform(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.localTransformId = (runtime.localTransformId + 1) >>> 0;
+}
+/**
+ * Target object's parent changed.
+ */
+export function invalidateNodeParentReference(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.worldTransformUsingParentTransformId = -1;
+}
+/**
+ * Target object's visual output changed (appearance or local transform).
+ * Use this when animating properties like alpha, x, y, scaleX, scaleY, rotation.
+ */
+export function invalidateNodeRender(target) {
+    invalidateNodeAppearance(target);
+    invalidateNodeLocalTransform(target);
+}
+/**
+ * Target object's child bounds have changed.
+ */
+export function invalidateNodeWorldBounds(target) {
+    const runtime = getNodeRuntime(target);
+    runtime.worldBoundsUsingWorldTransformId = -1;
+    runtime.worldBoundsUsingLocalBoundsId = -1;
+}
+//# sourceMappingURL=revision.js.map

package/dist/revision.js.map

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

package/dist/transform2d.d.ts

@@ -0,0 +1,16 @@
+import type { Matrix, Transform2DNode, Vector2Like } from '@flighthq/types';
+/**
+ * Converts the `vector` object from the Stage (global) coordinates
+ * to the display object's (local) coordinates.
+ **/
+export declare function convertNodeVector2GlobalToLocal<Traits extends object>(out: Vector2Like, source: Transform2DNode<Traits>, vector: Readonly<Vector2Like>): void;
+/**
+ * Converts the `vector` object from the display object's (local)
+ * coordinates to world coordinates.
+ **/
+export declare function convertNodeVector2LocalToGlobal<Traits extends object>(out: Vector2Like, source: Transform2DNode<Traits>, vector: Readonly<Vector2Like>): void;
+export declare function ensureNodeLocalTransformMatrix<Traits extends object>(target: Transform2DNode<Traits>): void;
+export declare function ensureNodeWorldTransformMatrix<Traits extends object>(target: Transform2DNode<Traits>): void;
+export declare function getNodeLocalTransformMatrix<Traits extends object>(target: Transform2DNode<Traits>): Readonly<Matrix>;
+export declare function getNodeWorldTransformMatrix<Traits extends object>(target: Transform2DNode<Traits>): Readonly<Matrix>;
+//# sourceMappingURL=transform2d.d.ts.map

package/dist/transform2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform2d.d.ts","sourceRoot":"","sources":["../src/transform2d.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAyB,MAAM,EAAe,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhH;;;IAGI;AACJ,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,MAAM,EACnE,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAEN;AAED;;;IAGI;AACJ,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,MAAM,EACnE,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAK3G;AAED,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAmB3G;AAED,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAGpH;AAED,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAGpH"}

package/dist/transform2d.js

@@ -0,0 +1,99 @@
+import { getEntityRuntime } from '@flighthq/entity';
+import { copyMatrix, createMatrix, inverseMatrixTransformPointXY, matrixTransformPointXY, multiplyMatrix, } from '@flighthq/geometry';
+import { computeNodeWorldTransformRevision } from '@flighthq/node';
+/**
+ * Converts the `vector` object from the Stage (global) coordinates
+ * to the display object's (local) coordinates.
+ **/
+export function convertNodeVector2GlobalToLocal(out, source, vector) {
+    inverseMatrixTransformPointXY(out, getNodeWorldTransformMatrix(source), vector.x, vector.y);
+}
+/**
+ * Converts the `vector` object from the display object's (local)
+ * coordinates to world coordinates.
+ **/
+export function convertNodeVector2LocalToGlobal(out, source, vector) {
+    matrixTransformPointXY(out, getNodeWorldTransformMatrix(source), vector.x, vector.y);
+}
+export function ensureNodeLocalTransformMatrix(target) {
+    const runtime = getEntityRuntime(target);
+    if (runtime.localTransformUsingLocalTransformId !== runtime.localTransformId) {
+        recomputeLocalTransform2D(target, runtime);
+    }
+}
+export function ensureNodeWorldTransformMatrix(target) {
+    const runtime = getEntityRuntime(target);
+    const parent = runtime.parent;
+    let parentRuntime;
+    let parentWorldTransformId = 0;
+    if (parent !== null) {
+        ensureNodeWorldTransformMatrix(parent);
+        parentRuntime = getEntityRuntime(parent);
+        parentWorldTransformId = parentRuntime.worldTransformId;
+    }
+    if (runtime.worldTransformUsingLocalTransformId !== runtime.localTransformId ||
+        runtime.worldTransformUsingParentTransformId !== parentWorldTransformId) {
+        recomputeWorldTransform2D(target, runtime, parentRuntime);
+    }
+}
+export function getNodeLocalTransformMatrix(target) {
+    ensureNodeLocalTransformMatrix(target);
+    return getEntityRuntime(target).localTransform2D;
+}
+export function getNodeWorldTransformMatrix(target) {
+    ensureNodeWorldTransformMatrix(target);
+    return getEntityRuntime(target).worldTransform2D;
+}
+function recomputeLocalTransform2D(target, runtime) {
+    if (target.rotation !== runtime.rotationAngle) {
+        // Normalize from -180 to 180
+        let angle = target.rotation % 360.0;
+        if (angle > 180.0) {
+            angle -= 360.0;
+        }
+        else if (angle < -180.0) {
+            angle += 360.0;
+        }
+        const rad = angle * DEG_TO_RAD;
+        const sin = Math.sin(rad);
+        const cos = Math.cos(rad);
+        runtime.rotationAngle = angle;
+        runtime.rotationSine = sin;
+        runtime.rotationCosine = cos;
+    }
+    if (runtime.localTransform2D === null)
+        runtime.localTransform2D = createMatrix();
+    const matrix = runtime.localTransform2D;
+    if (target.skewX === 0 && target.skewY === 0) {
+        matrix.a = runtime.rotationCosine * target.scaleX;
+        matrix.b = runtime.rotationSine * target.scaleX;
+        matrix.c = -runtime.rotationSine * target.scaleY;
+        matrix.d = runtime.rotationCosine * target.scaleY;
+    }
+    else {
+        const radY = (runtime.rotationAngle + target.skewY) * DEG_TO_RAD;
+        const radX = (runtime.rotationAngle + target.skewX) * DEG_TO_RAD;
+        matrix.a = Math.cos(radY) * target.scaleX;
+        matrix.b = Math.sin(radY) * target.scaleX;
+        matrix.c = -Math.sin(radX) * target.scaleY;
+        matrix.d = Math.cos(radX) * target.scaleY;
+    }
+    // Pivot: the local point (pivotX, pivotY) maps to (x, y). With pivot 0,0 this reduces to tx=x, ty=y.
+    matrix.tx = target.x - (matrix.a * target.pivotX + matrix.c * target.pivotY);
+    matrix.ty = target.y - (matrix.b * target.pivotX + matrix.d * target.pivotY);
+    runtime.localTransformUsingLocalTransformId = runtime.localTransformId;
+}
+function recomputeWorldTransform2D(target, runtime, parentRuntime) {
+    if (runtime.worldTransform2D === null)
+        runtime.worldTransform2D = createMatrix();
+    ensureNodeLocalTransformMatrix(target);
+    if (parentRuntime !== undefined) {
+        multiplyMatrix(runtime.worldTransform2D, parentRuntime.worldTransform2D, runtime.localTransform2D);
+    }
+    else {
+        copyMatrix(runtime.worldTransform2D, runtime.localTransform2D);
+    }
+    computeNodeWorldTransformRevision(runtime, parentRuntime);
+}
+const DEG_TO_RAD = Math.PI / 180;
+//# sourceMappingURL=transform2d.js.map

package/dist/transform2d.js.map

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

package/dist/transform3d.d.ts

@@ -0,0 +1,6 @@
+import type { Matrix4Like, Transform3DNode, Vector3Like } from '@flighthq/types';
+export declare function convertNodeVector3GlobalToLocal<Traits extends object>(out: Vector3Like, source: Transform3DNode<Traits>, point: Readonly<Vector3Like>): void;
+export declare function convertNodeVector3LocalToGlobal<Traits extends object>(out: Vector3Like, source: Transform3DNode<Traits>, point: Readonly<Vector3Like>): void;
+export declare function ensureNodeWorldTransformMatrix4<Traits extends object>(target: Transform3DNode<Traits>): void;
+export declare function getNodeWorldTransformMatrix4<Traits extends object>(target: Transform3DNode<Traits>): Readonly<Matrix4Like>;
+//# sourceMappingURL=transform3d.d.ts.map

package/dist/transform3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform3d.d.ts","sourceRoot":"","sources":["../src/transform3d.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAyB,WAAW,EAAe,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIrH,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,MAAM,EACnE,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC3B,IAAI,CAMN;AAED,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,MAAM,EACnE,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC3B,IAAI,CAEN;AAED,wBAAgB,+BAA+B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAmB5G;AAED,wBAAgB,4BAA4B,CAAC,MAAM,SAAS,MAAM,EAChE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAC9B,QAAQ,CAAC,WAAW,CAAC,CAGvB"}

package/dist/transform3d.js

@@ -0,0 +1,45 @@
+import { getEntityRuntime } from '@flighthq/entity';
+import { acquireMatrix4, copyMatrix4, createMatrix4, inverseMatrix4, matrix4TransformPoint, multiplyMatrix4, releaseMatrix4, } from '@flighthq/geometry';
+import { computeNodeWorldTransformRevision } from './revision';
+export function convertNodeVector3GlobalToLocal(out, source, point) {
+    // Acquire from pool instead of allocating to avoid hot-path GC pressure.
+    const inv = acquireMatrix4();
+    inverseMatrix4(inv, getNodeWorldTransformMatrix4(source));
+    matrix4TransformPoint(out, inv, point);
+    releaseMatrix4(inv);
+}
+export function convertNodeVector3LocalToGlobal(out, source, point) {
+    matrix4TransformPoint(out, getNodeWorldTransformMatrix4(source), point);
+}
+export function ensureNodeWorldTransformMatrix4(target) {
+    const runtime = getEntityRuntime(target);
+    const parent = runtime.parent;
+    let parentRuntime;
+    let parentWorldTransformId = 0;
+    if (parent !== null) {
+        ensureNodeWorldTransformMatrix4(parent);
+        parentRuntime = getEntityRuntime(parent);
+        parentWorldTransformId = parentRuntime.worldTransformId;
+    }
+    if (runtime.worldTransformUsingLocalTransformId !== runtime.localTransformId ||
+        runtime.worldTransformUsingParentTransformId !== parentWorldTransformId) {
+        recomputeWorldTransform3D(target, runtime, parentRuntime);
+    }
+}
+export function getNodeWorldTransformMatrix4(target) {
+    ensureNodeWorldTransformMatrix4(target);
+    return getEntityRuntime(target).worldMatrix;
+}
+function recomputeWorldTransform3D(target, runtime, parentRuntime) {
+    if (runtime.worldMatrix === null) {
+        runtime.worldMatrix = createMatrix4();
+    }
+    if (parentRuntime !== undefined) {
+        multiplyMatrix4(runtime.worldMatrix, parentRuntime.worldMatrix, target.localMatrix);
+    }
+    else {
+        copyMatrix4(runtime.worldMatrix, target.localMatrix);
+    }
+    computeNodeWorldTransformRevision(runtime, parentRuntime);
+}
+//# sourceMappingURL=transform3d.js.map

package/dist/transform3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform3d.js","sourceRoot":"","sources":["../src/transform3d.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,UAAU,+BAA+B,CAC7C,GAAgB,EAChB,MAA+B,EAC/B,KAA4B;IAE5B,yEAAyE;IACzE,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,cAAc,CAAC,GAAG,EAAE,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,cAAc,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,GAAgB,EAChB,MAA+B,EAC/B,KAA4B;IAE5B,qBAAqB,CAAC,GAAG,EAAE,4BAA4B,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAwB,MAA+B;IACpG,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAgD,CAAC;IACxF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAwC,CAAC;IAEhE,IAAI,aAAwE,CAAC;IAC7E,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAE/B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,+BAA+B,CAAC,MAAM,CAAC,CAAC;QACxC,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAgD,CAAC;QACxF,sBAAsB,GAAG,aAAa,CAAC,gBAAgB,CAAC;IAC1D,CAAC;IAED,IACE,OAAO,CAAC,mCAAmC,KAAK,OAAO,CAAC,gBAAgB;QACxE,OAAO,CAAC,oCAAoC,KAAK,sBAAsB,EACvE,CAAC;QACD,yBAAyB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,MAA+B;IAE/B,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACxC,OAAQ,gBAAgB,CAAC,MAAM,CAAiD,CAAC,WAAY,CAAC;AAChG,CAAC;AAED,SAAS,yBAAyB,CAChC,MAA+B,EAC/B,OAAoD,EACpD,aAAqE;IAErE,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,CAAC,WAAW,GAAG,aAAa,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,WAAY,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACvF,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,iCAAiC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC5D,CAAC"}

package/dist/traversal.d.ts

@@ -0,0 +1,51 @@
+import type { Node, NodeDescendantVisitor, NodeOf, NodeTraits } from '@flighthq/types';
+/**
+ * Finds the first descendant of `source` (depth-first pre-order) that satisfies `predicate`.
+ * Returns `null` if no descendant matches.
+ */
+export declare function findNode<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>, predicate: (node: Node<Traits>) => boolean): NodeOf<Traits> | null;
+/**
+ * Finds the first descendant of `source` (depth-first pre-order) with the given `name`. Searches
+ * the full subtree recursively, unlike `getNodeChildByName` which only checks direct children.
+ * Returns `null` if no descendant matches.
+ */
+export declare function findNodeByName<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>, name: string): NodeOf<Traits> | null;
+/**
+ * Walks upward from `source` toward the root, calling `callback` for each ancestor. If `callback`
+ * returns `false`, the walk stops early. The source node itself is not visited.
+ */
+export declare function forEachNodeAncestor<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>, callback: (node: Node<Traits>) => boolean): void;
+/**
+ * Calls `callback` for every descendant of `source` in depth-first pre-order. Unlike
+ * `walkNodeDescendants`, this variant never stops early — every descendant is visited regardless
+ * of the callback's return value.
+ */
+export declare function forEachNodeDescendant<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>, callback: (node: Node<Traits>) => void): void;
+/**
+ * Returns a read-only snapshot of the direct children of `source`. Returns an empty array if the
+ * node has no children. The returned array is a copy and safe to iterate while the graph mutates.
+ */
+export declare function getNodeChildren<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>): readonly NodeOf<Traits>[];
+/**
+ * Returns the depth of `source` in the tree: 0 for a root node (no parent), 1 for a direct child
+ * of the root, and so on.
+ */
+export declare function getNodeDepth<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>): number;
+/**
+ * Returns the next sibling of `source` (the child immediately after it in its parent's children
+ * array), or `null` if `source` is the last child or has no parent.
+ */
+export declare function getNodeNextSibling<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>): NodeOf<Traits> | null;
+/**
+ * Returns the previous sibling of `source` (the child immediately before it in its parent's
+ * children array), or `null` if `source` is the first child or has no parent.
+ */
+export declare function getNodePreviousSibling<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>): NodeOf<Traits> | null;
+/**
+ * Walks the descendants of `source` in depth-first pre-order, calling `visit` for each node.
+ * If `visit` returns `false`, the walk stops early (neither the current node's subtree nor any
+ * remaining siblings are visited). Returns `true` if the walk completed without early termination,
+ * `false` if it was cut short.
+ */
+export declare function walkNodeDescendants<Traits extends object = NodeTraits>(source: Readonly<Node<Traits>>, visit: NodeDescendantVisitor<Traits>): boolean;
+//# sourceMappingURL=traversal.d.ts.map

package/dist/traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal.d.ts","sourceRoot":"","sources":["../src/traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKvF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACzD,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,OAAO,GACzC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAUvB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAC/D,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAEvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACpE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,OAAO,GACxC,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACtE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,GACrC,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAChE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC7B,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,CAI3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAQvG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACnE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAQvB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACvE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAQvB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EACpE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAC9B,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC,GACnC,OAAO,CAST"}

package/dist/traversal.js

@@ -0,0 +1,130 @@
+import { getNodeParent } from './hierarchy';
+import { getNodeRuntime } from './node';
+/**
+ * Finds the first descendant of `source` (depth-first pre-order) that satisfies `predicate`.
+ * Returns `null` if no descendant matches.
+ */
+export function findNode(source, predicate) {
+    const children = getNodeRuntime(source).children;
+    if (children === null)
+        return null;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        if (predicate(child))
+            return child;
+        const found = findNode(child, predicate);
+        if (found !== null)
+            return found;
+    }
+    return null;
+}
+/**
+ * Finds the first descendant of `source` (depth-first pre-order) with the given `name`. Searches
+ * the full subtree recursively, unlike `getNodeChildByName` which only checks direct children.
+ * Returns `null` if no descendant matches.
+ */
+export function findNodeByName(source, name) {
+    return findNode(source, (node) => node.name === name);
+}
+/**
+ * Walks upward from `source` toward the root, calling `callback` for each ancestor. If `callback`
+ * returns `false`, the walk stops early. The source node itself is not visited.
+ */
+export function forEachNodeAncestor(source, callback) {
+    let current = getNodeParent(source);
+    while (current !== null) {
+        if (!callback(current))
+            return;
+        current = getNodeParent(current);
+    }
+}
+/**
+ * Calls `callback` for every descendant of `source` in depth-first pre-order. Unlike
+ * `walkNodeDescendants`, this variant never stops early — every descendant is visited regardless
+ * of the callback's return value.
+ */
+export function forEachNodeDescendant(source, callback) {
+    const children = getNodeRuntime(source).children;
+    if (children === null)
+        return;
+    for (let i = 0; i < children.length; i++) {
+        callback(children[i]);
+        forEachNodeDescendant(children[i], callback);
+    }
+}
+/**
+ * Returns a read-only snapshot of the direct children of `source`. Returns an empty array if the
+ * node has no children. The returned array is a copy and safe to iterate while the graph mutates.
+ */
+export function getNodeChildren(source) {
+    const children = getNodeRuntime(source).children;
+    if (children === null)
+        return _emptyChildren;
+    return children.slice();
+}
+/**
+ * Returns the depth of `source` in the tree: 0 for a root node (no parent), 1 for a direct child
+ * of the root, and so on.
+ */
+export function getNodeDepth(source) {
+    let depth = 0;
+    let current = getNodeParent(source);
+    while (current !== null) {
+        depth++;
+        current = getNodeParent(current);
+    }
+    return depth;
+}
+/**
+ * Returns the next sibling of `source` (the child immediately after it in its parent's children
+ * array), or `null` if `source` is the last child or has no parent.
+ */
+export function getNodeNextSibling(source) {
+    const parent = getNodeParent(source);
+    if (parent === null)
+        return null;
+    const siblings = getNodeRuntime(parent).children;
+    if (siblings === null)
+        return null;
+    const idx = siblings.indexOf(source);
+    if (idx === -1 || idx === siblings.length - 1)
+        return null;
+    return siblings[idx + 1];
+}
+/**
+ * Returns the previous sibling of `source` (the child immediately before it in its parent's
+ * children array), or `null` if `source` is the first child or has no parent.
+ */
+export function getNodePreviousSibling(source) {
+    const parent = getNodeParent(source);
+    if (parent === null)
+        return null;
+    const siblings = getNodeRuntime(parent).children;
+    if (siblings === null)
+        return null;
+    const idx = siblings.indexOf(source);
+    if (idx <= 0)
+        return null;
+    return siblings[idx - 1];
+}
+/**
+ * Walks the descendants of `source` in depth-first pre-order, calling `visit` for each node.
+ * If `visit` returns `false`, the walk stops early (neither the current node's subtree nor any
+ * remaining siblings are visited). Returns `true` if the walk completed without early termination,
+ * `false` if it was cut short.
+ */
+export function walkNodeDescendants(source, visit) {
+    const children = getNodeRuntime(source).children;
+    if (children === null)
+        return true;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        if (!visit(child))
+            return false;
+        if (!walkNodeDescendants(child, visit))
+            return false;
+    }
+    return true;
+}
+const _emptyChildren = [];
+//# sourceMappingURL=traversal.js.map

package/dist/traversal.js.map

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

package/dist/viewport.d.ts

@@ -0,0 +1,8 @@
+import type { MatrixLike, NodeTraits, Viewport, ViewportAlign } from '@flighthq/types';
+export declare function computeViewportAlignX(scaledContentWidth: number, viewWidth: number, align: ViewportAlign): number;
+export declare function computeViewportAlignY(scaledContentHeight: number, viewHeight: number, align: ViewportAlign): number;
+export declare function computeViewportFillScale(contentWidth: number, contentHeight: number, viewWidth: number, viewHeight: number): number;
+export declare function computeViewportFitScale(contentWidth: number, contentHeight: number, viewWidth: number, viewHeight: number): number;
+export declare function computeViewportRenderTransform<Traits extends object = NodeTraits>(out: MatrixLike, scene: Viewport<Traits>, viewWidth: number, viewHeight: number): void;
+export declare function createViewport<Traits extends object = NodeTraits>(obj?: Readonly<Partial<Viewport<Traits>>>): Viewport<Traits>;
+//# sourceMappingURL=viewport.d.ts.map

package/dist/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,UAAU,EAEV,QAAQ,EACR,aAAa,EACd,MAAM,iBAAiB,CAAC;AAIzB,wBAAgB,qBAAqB,CAAC,kBAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAIjH;AAED,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAInH;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAC/E,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CA+CN;AAED,wBAAgB,cAAc,CAAC,MAAM,SAAS,MAAM,GAAG,UAAU,EAC/D,GAAG,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GACxC,QAAQ,CAAC,MAAM,CAAC,CAMlB"}

package/dist/viewport.js

@@ -0,0 +1,78 @@
+import { createRectangle } from '@flighthq/geometry';
+import { getNodeRuntime } from './node';
+export function computeViewportAlignX(scaledContentWidth, viewWidth, align) {
+    if (align.includes('left'))
+        return 0;
+    if (align.includes('right'))
+        return viewWidth - scaledContentWidth;
+    return (viewWidth - scaledContentWidth) / 2;
+}
+export function computeViewportAlignY(scaledContentHeight, viewHeight, align) {
+    if (align.includes('top'))
+        return 0;
+    if (align.includes('bottom'))
+        return viewHeight - scaledContentHeight;
+    return (viewHeight - scaledContentHeight) / 2;
+}
+export function computeViewportFillScale(contentWidth, contentHeight, viewWidth, viewHeight) {
+    return Math.max(viewWidth / contentWidth, viewHeight / contentHeight);
+}
+export function computeViewportFitScale(contentWidth, contentHeight, viewWidth, viewHeight) {
+    return Math.min(viewWidth / contentWidth, viewHeight / contentHeight);
+}
+export function computeViewportRenderTransform(out, scene, viewWidth, viewHeight) {
+    let contentWidth = 0;
+    let contentHeight = 0;
+    if (scene.root !== null) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const runtime = getNodeRuntime(scene.root);
+        if (runtime?.computeLocalBoundsRectangle !== undefined) {
+            _tempRectangle.width = 0;
+            _tempRectangle.height = 0;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            runtime.computeLocalBoundsRectangle(_tempRectangle, scene.root);
+            contentWidth = _tempRectangle.width;
+            contentHeight = _tempRectangle.height;
+        }
+    }
+    if (contentWidth === 0 || contentHeight === 0) {
+        out.a = 1;
+        out.b = 0;
+        out.c = 0;
+        out.d = 1;
+        out.tx = 0;
+        out.ty = 0;
+        return;
+    }
+    let sx;
+    let sy;
+    if (scene.scaleMode === 'noscale') {
+        sx = 1;
+        sy = 1;
+    }
+    else if (scene.scaleMode === 'exactfit') {
+        sx = viewWidth / contentWidth;
+        sy = viewHeight / contentHeight;
+    }
+    else if (scene.scaleMode === 'showall') {
+        sx = sy = computeViewportFitScale(contentWidth, contentHeight, viewWidth, viewHeight);
+    }
+    else {
+        sx = sy = computeViewportFillScale(contentWidth, contentHeight, viewWidth, viewHeight);
+    }
+    out.a = sx;
+    out.b = 0;
+    out.c = 0;
+    out.d = sy;
+    out.tx = computeViewportAlignX(contentWidth * sx, viewWidth, scene.align);
+    out.ty = computeViewportAlignY(contentHeight * sy, viewHeight, scene.align);
+}
+export function createViewport(obj) {
+    return {
+        align: obj?.align ?? 'topleft',
+        root: obj?.root ?? null,
+        scaleMode: obj?.scaleMode ?? 'noscale',
+    };
+}
+const _tempRectangle = createRectangle();
+//# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@flighthq/node",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Base scene graph: transform hierarchy, bounds, appearance traits, child management",
+  "sideEffects": false
+}