@flighthq/node 0.2.0 → 0.2.1-next.410.a23f189

package/dist/transform3d.d.ts

@@ -1,6 +1,13 @@
-import type { Matrix4Like, Transform3DNode, Vector3Like } from '@flighthq/types';
+import type { Matrix4Like, Transform3DLike, 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>;
+export declare function ensureNodeLocalMatrix4<Traits extends object>(target: Transform3DNode<Traits>): void;
+export declare function ensureNodeWorldMatrix4<Traits extends object>(target: Transform3DNode<Traits>): void;
+export declare function getNodeLocalMatrix4<Traits extends object>(target: Transform3DNode<Traits>): Readonly<Matrix4Like>;
+export declare function getNodeTransform3D<Traits extends object>(out: Transform3DLike, source: Transform3DNode<Traits>): void;
+export declare function getNodeWorldMatrix4<Traits extends object>(target: Transform3DNode<Traits>): Readonly<Matrix4Like>;
+export declare function isNodeLocalMatrix4Detached<Traits extends object>(target: Transform3DNode<Traits>): boolean;
+export declare function setNodeLocalMatrix4<Traits extends object>(target: Transform3DNode<Traits>, source: Readonly<Matrix4Like>): void;
+export declare function setNodeTransform3D<Traits extends object>(target: Transform3DNode<Traits>, source: Readonly<Transform3DLike>): void;
+export declare function syncNodeTransform3DFromMatrix4<Traits extends object>(target: Transform3DNode<Traits>): void;
 //# sourceMappingURL=transform3d.d.ts.map

package/dist/transform3d.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"transform3d.d.ts","sourceRoot":"","sources":["../src/transform3d.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,WAAW,EAEX,eAAe,EACf,eAAe,EACf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAIzB,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;AAKD,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAKnG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAmBnG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAGjH;AAKD,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAIrH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAGjH;AAKD,wBAAgB,0BAA0B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,OAAO,CAG1G;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EACvD,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC5B,IAAI,CAON;AAID,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,MAAM,EACtD,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,GAChC,IAAI,CAKN;AAKD,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI,CAK3G"}

package/dist/transform3d.js

@@ -1,23 +1,32 @@
 import { getEntityRuntime } from '@flighthq/entity';
-import { acquireMatrix4, copyMatrix4, createMatrix4, inverseMatrix4, matrix4TransformPoint, multiplyMatrix4, releaseMatrix4, } from '@flighthq/geometry';
-import { computeNodeWorldTransformRevision } from './revision';
+import { acquireMatrix4, composeMatrix4, copyMatrix4, copyQuaternion, copyVector3, createMatrix4, decomposeMatrix4, inverseMatrix4, matrix4TransformPoint, multiplyMatrix4, releaseMatrix4, } from '@flighthq/geometry';
+import { computeNodeWorldTransformRevision, invalidateNodeLocalTransform } 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));
+    inverseMatrix4(inv, getNodeWorldMatrix4(source));
     matrix4TransformPoint(out, inv, point);
     releaseMatrix4(inv);
 }
 export function convertNodeVector3LocalToGlobal(out, source, point) {
-    matrix4TransformPoint(out, getNodeWorldTransformMatrix4(source), point);
+    matrix4TransformPoint(out, getNodeWorldMatrix4(source), point);
 }
-export function ensureNodeWorldTransformMatrix4(target) {
+// Ensures the cached local matrix is current. Recomposes it from translation/rotation/scale when the
+// local transform is dirty — unless it was set directly (setNodeLocalMatrix4 pre-satisfies the dirty
+// check so the detached matrix survives).
+export function ensureNodeLocalMatrix4(target) {
+    const runtime = getEntityRuntime(target);
+    if (runtime.localMatrix4 === null || runtime.localTransformUsingLocalTransformId !== runtime.localTransformId) {
+        recomputeLocalTransform3D(target, runtime);
+    }
+}
+export function ensureNodeWorldMatrix4(target) {
     const runtime = getEntityRuntime(target);
     const parent = runtime.parent;
     let parentRuntime;
     let parentWorldTransformId = 0;
     if (parent !== null) {
-        ensureNodeWorldTransformMatrix4(parent);
+        ensureNodeWorldMatrix4(parent);
         parentRuntime = getEntityRuntime(parent);
         parentWorldTransformId = parentRuntime.worldTransformId;
     }
@@ -26,19 +35,76 @@ export function ensureNodeWorldTransformMatrix4(target) {
         recomputeWorldTransform3D(target, runtime, parentRuntime);
     }
 }
-export function getNodeWorldTransformMatrix4(target) {
-    ensureNodeWorldTransformMatrix4(target);
-    return getEntityRuntime(target).worldMatrix;
+export function getNodeLocalMatrix4(target) {
+    ensureNodeLocalMatrix4(target);
+    return getEntityRuntime(target).localMatrix4;
+}
+// Reads the node's decomposed local transform (translation/rotation/scale) into `out`. When the local
+// matrix is detached (set directly), these fields are dormant; call syncNodeTransform3DFromMatrix4
+// first to reflect the matrix.
+export function getNodeTransform3D(out, source) {
+    copyVector3(out.position, source.position);
+    copyQuaternion(out.rotation, source.rotation);
+    copyVector3(out.scale, source.scale);
+}
+export function getNodeWorldMatrix4(target) {
+    ensureNodeWorldMatrix4(target);
+    return getEntityRuntime(target).worldMatrix4;
+}
+// True when the local matrix was set directly (setNodeLocalMatrix4) and the translation/rotation/scale
+// fields have not since been reattached by a TRS write or syncNodeTransform3DFromMatrix4. Diagnostic.
+// Resolves the local matrix first so a pending TRS write reports as reattached rather than stale.
+export function isNodeLocalMatrix4Detached(target) {
+    ensureNodeLocalMatrix4(target);
+    return getEntityRuntime(target).localMatrix4Detached;
+}
+// Sets the node's local matrix directly, bypassing translation/rotation/scale. The matrix is copied
+// (the node owns its storage) and marked detached: the TRS fields go dormant and are not recomposed
+// over it until a TRS write or syncNodeTransform3DFromMatrix4. Bumps the local transform revision so
+// world and render refresh, then pre-satisfies the local recompute so the set matrix survives.
+export function setNodeLocalMatrix4(target, source) {
+    const runtime = getEntityRuntime(target);
+    if (runtime.localMatrix4 === null)
+        runtime.localMatrix4 = createMatrix4();
+    copyMatrix4(runtime.localMatrix4, source);
+    invalidateNodeLocalTransform(target);
+    runtime.localTransformUsingLocalTransformId = runtime.localTransformId;
+    runtime.localMatrix4Detached = true;
+}
+// Sets the node's local transform from a decomposed carrier, reattaching TRS authoring (clears the
+// detached state via the recompute) and rebuilding the matrix cache from the fields.
+export function setNodeTransform3D(target, source) {
+    copyVector3(target.position, source.position);
+    copyQuaternion(target.rotation, source.rotation);
+    copyVector3(target.scale, source.scale);
+    invalidateNodeLocalTransform(target);
+}
+// Reattaches the TRS fields to a directly-set matrix by decomposing it into translation/rotation/scale
+// (best-effort: lossy on shear). Non-destructive — the matrix cache is unchanged and stays authoritative
+// until a subsequent TRS write. Clears the detached state.
+export function syncNodeTransform3DFromMatrix4(target) {
+    const runtime = getEntityRuntime(target);
+    ensureNodeLocalMatrix4(target);
+    decomposeMatrix4(target.position, target.rotation, target.scale, runtime.localMatrix4);
+    runtime.localMatrix4Detached = false;
+}
+function recomputeLocalTransform3D(target, runtime) {
+    if (runtime.localMatrix4 === null)
+        runtime.localMatrix4 = createMatrix4();
+    composeMatrix4(runtime.localMatrix4, target.position, target.rotation, target.scale);
+    runtime.localMatrix4Detached = false;
+    runtime.localTransformUsingLocalTransformId = runtime.localTransformId;
 }
 function recomputeWorldTransform3D(target, runtime, parentRuntime) {
-    if (runtime.worldMatrix === null) {
-        runtime.worldMatrix = createMatrix4();
+    if (runtime.worldMatrix4 === null) {
+        runtime.worldMatrix4 = createMatrix4();
     }
+    ensureNodeLocalMatrix4(target);
     if (parentRuntime !== undefined) {
-        multiplyMatrix4(runtime.worldMatrix, parentRuntime.worldMatrix, target.localMatrix);
+        multiplyMatrix4(runtime.worldMatrix4, parentRuntime.worldMatrix4, runtime.localMatrix4);
     }
     else {
-        copyMatrix4(runtime.worldMatrix, target.localMatrix);
+        copyMatrix4(runtime.worldMatrix4, runtime.localMatrix4);
     }
     computeNodeWorldTransformRevision(runtime, parentRuntime);
 }

package/dist/transform3d.js.map

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

package/dist/viewport.d.ts.map

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

@@ -1,3 +1,4 @@
+import { createEntity } from '@flighthq/entity';
 import { createRectangle } from '@flighthq/geometry';
 import { getNodeRuntime } from './node';
 export function computeViewportAlignX(scaledContentWidth, viewWidth, align) {
@@ -68,11 +69,11 @@ export function computeViewportRenderTransform(out, scene, viewWidth, viewHeight
     out.ty = computeViewportAlignY(contentHeight * sy, viewHeight, scene.align);
 }
 export function createViewport(obj) {
-    return {
+    return createEntity({
         align: obj?.align ?? 'topleft',
         root: obj?.root ?? null,
         scaleMode: obj?.scaleMode ?? 'noscale',
-    };
+    });
 }
 const _tempRectangle = createRectangle();
 //# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/node",
-  "version": "0.2.0",
+  "version": "0.2.1-next.410.a23f189",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -32,10 +32,10 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/entity": "0.2.0",
-    "@flighthq/geometry": "0.2.0",
-    "@flighthq/signals": "0.2.0",
-    "@flighthq/types": "0.2.0"
+    "@flighthq/entity": "0.2.1-next.410.a23f189",
+    "@flighthq/geometry": "0.2.1-next.410.a23f189",
+    "@flighthq/signals": "0.2.1-next.410.a23f189",
+    "@flighthq/types": "0.2.1-next.410.a23f189"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/boundsRectangle.test.ts

@@ -9,7 +9,7 @@ import {
 import {
   addNodeChild,
   createNode,
-  ensureNodeLocalTransformMatrix,
+  ensureNodeLocalMatrix,
   initTransform2DRuntimeTrait,
   initTransform2DTrait,
   invalidateNodeLocalTransform,
@@ -332,7 +332,7 @@ describe('ensureNodeWorldBoundsRectangle', () => {
     const cache = cloneRectangle(runtime.worldBoundsRectangle!);
     parent.scaleX = 2;
     invalidateNodeLocalTransform(parent);
-    ensureNodeLocalTransformMatrix(parent);
+    ensureNodeLocalMatrix(parent);
     ensureNodeWorldBoundsRectangle(child);
     expect(runtime.worldBoundsRectangle).not.toEqual(cache);
     expect(equalsRectangle(runtime.worldBoundsRectangle, { x: 0, y: 0, width: 20, height: 0 })).toBe(true);

package/src/hasAppearance.test.ts

@@ -1,5 +1,4 @@
 import type { HasAppearance } from '@flighthq/types';
-import { BlendMode } from '@flighthq/types';
 
 import { initAppearanceTrait } from './hasAppearance';
 import { createNode } from './node';
@@ -17,7 +16,6 @@ describe('initAppearanceTrait', () => {
     initAppearanceTrait(target);
 
     expect(target.alpha).toBe(1);
-    expect(target.blendMode).toBeNull();
     expect(target.visible).toBe(true);
   });
 
@@ -27,14 +25,6 @@ describe('initAppearanceTrait', () => {
 
     expect(target.alpha).toBe(0.5);
     expect(target.visible).toBe(false);
-    expect(target.blendMode).toBeNull();
-  });
-
-  it('applies blendMode override', () => {
-    const target = makeTarget();
-    initAppearanceTrait(target, { blendMode: BlendMode.Add });
-
-    expect(target.blendMode).toBe(BlendMode.Add);
   });
 
   it('overwrites existing values', () => {

package/src/hasBlendMode.test.ts

@@ -0,0 +1,25 @@
+import type { HasBlendMode } from '@flighthq/types';
+import { BlendMode } from '@flighthq/types';
+
+import { initBlendModeTrait } from './hasBlendMode';
+import { createNode } from './node';
+
+const TestKind = 'Test';
+
+function makeTarget(): HasBlendMode {
+  return createNode(TestKind) as unknown as HasBlendMode;
+}
+
+describe('initBlendModeTrait', () => {
+  it('defaults blendMode to null', () => {
+    const target = makeTarget();
+    initBlendModeTrait(target);
+    expect(target.blendMode).toBeNull();
+  });
+
+  it('applies a blendMode override', () => {
+    const target = makeTarget();
+    initBlendModeTrait(target, { blendMode: BlendMode.Add });
+    expect(target.blendMode).toBe(BlendMode.Add);
+  });
+});

package/src/hasTransform2d.test.ts

@@ -13,11 +13,11 @@ describe('initTransform2DRuntimeTrait', () => {
   it('initializes default values', () => {
     initTransform2DRuntimeTrait(runtime);
 
-    expect(runtime.localTransform2D).toBeNull();
+    expect(runtime.localMatrix).toBeNull();
     expect(runtime.rotationAngle).toStrictEqual(0);
     expect(runtime.rotationCosine).toStrictEqual(1);
     expect(runtime.rotationSine).toStrictEqual(0);
-    expect(runtime.worldTransform2D).toBeNull();
+    expect(runtime.worldMatrix).toBeNull();
 
     // inherited graph runtime fields
     expect(runtime.appearanceId).toStrictEqual(0);

package/src/hasTransform3d.test.ts

@@ -1,37 +1,36 @@
-import type { HasTransform3D, HasTransform3DRuntime, Matrix4 } from '@flighthq/types';
+import { createQuaternion, createVector3 } from '@flighthq/geometry';
+import type { HasTransform3D, HasTransform3DRuntime } from '@flighthq/types';
 import { describe, expect, it } from 'vitest';
 
 import { initTransform3DRuntimeTrait, initTransform3DTrait } from './hasTransform3d';
 
 describe('initTransform3DRuntimeTrait', () => {
-  it('sets worldMatrix to null', () => {
+  it('nulls the matrix caches and clears the detached flag', () => {
     const runtime = {} as HasTransform3DRuntime;
     initTransform3DRuntimeTrait(runtime);
-    expect(runtime.worldMatrix).toBeNull();
+    expect(runtime.localMatrix4).toBeNull();
+    expect(runtime.worldMatrix4).toBeNull();
+    expect(runtime.localMatrix4Detached).toBe(false);
   });
 });
 
 describe('initTransform3DTrait', () => {
-  it('creates an identity localMatrix by default', () => {
+  it('defaults to identity position/rotation/scale', () => {
     const node = {} as HasTransform3D;
     initTransform3DTrait(node);
-    expect(node.localMatrix).toBeDefined();
-    const m = node.localMatrix.m;
-    expect(m[0]).toBe(1);
-    expect(m[5]).toBe(1);
-    expect(m[10]).toBe(1);
-    expect(m[15]).toBe(1);
-    expect(m[12]).toBe(0);
-    expect(m[13]).toBe(0);
-    expect(m[14]).toBe(0);
+    expect(node.position).toMatchObject({ x: 0, y: 0, z: 0 });
+    expect(node.rotation).toMatchObject({ x: 0, y: 0, z: 0, w: 1 });
+    expect(node.scale).toMatchObject({ x: 1, y: 1, z: 1 });
   });
 
-  it('accepts an existing localMatrix', () => {
+  it('accepts existing position/rotation/scale', () => {
     const node = {} as HasTransform3D;
-    const existing = { m: new Float32Array(16) } as unknown as Matrix4;
-    existing.m[12] = 7;
-    initTransform3DTrait(node, { localMatrix: existing });
-    expect(node.localMatrix).toBe(existing);
-    expect(node.localMatrix.m[12]).toBe(7);
+    const position = createVector3(7, 0, 0);
+    const rotation = createQuaternion();
+    const scale = createVector3(2, 2, 2);
+    initTransform3DTrait(node, { position, rotation, scale });
+    expect(node.position).toBe(position);
+    expect(node.rotation).toBe(rotation);
+    expect(node.scale).toBe(scale);
   });
 });

package/src/hierarchy.test.ts

@@ -31,7 +31,7 @@ import {
 } from './hierarchy';
 import { createNode, enableNodeSignals, getNodeRuntime } from './node';
 import { invalidateNodeLocalTransform } from './revision';
-import { getNodeWorldTransformMatrix } from './transform2d';
+import { getNodeWorldMatrix } from './transform2d';
 
 let container: Node<NodeTraits>;
 let childA: Node<NodeTraits>;
@@ -650,7 +650,7 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(child);
     addNodeChild(parentA, child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const parentB = createTransformNode();
     parentB.x = 200;
@@ -658,7 +658,7 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(parentB);
 
     reparentNode(child, parentB);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);
@@ -680,13 +680,13 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(child);
     addNodeChild(parentA, child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const parentB = createTransformNode();
     invalidateNodeLocalTransform(parentB);
 
     reparentNode(child, parentB);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);
@@ -733,14 +733,14 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(child);
     addNodeChild(parentA, child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const parentB = createTransformNode();
     parentB.x = 200;
     invalidateNodeLocalTransform(parentB);
 
     reparentNode(child, parentB);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);
@@ -758,7 +758,7 @@ describe('reparentNode', () => {
     child.scaleX = 1.5;
     invalidateNodeLocalTransform(child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const parentB = createTransformNode();
     parentB.x = 50;
@@ -767,7 +767,7 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(parentB);
 
     reparentNode(child, parentB);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);
@@ -789,14 +789,14 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(child);
     addNodeChild(parentA, child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const parentB = createTransformNode();
     parentB.x = 100;
     invalidateNodeLocalTransform(parentB);
 
     reparentNode(child, parentB);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);
@@ -821,13 +821,13 @@ describe('reparentNode', () => {
     invalidateNodeLocalTransform(child);
     addNodeChild(parentA, child);
 
-    const before = cloneMatrix(getNodeWorldTransformMatrix(child));
+    const before = cloneMatrix(getNodeWorldMatrix(child));
 
     const identityParent = createTransformNode();
     invalidateNodeLocalTransform(identityParent);
 
     reparentNode(child, identityParent);
-    const after = getNodeWorldTransformMatrix(child);
+    const after = getNodeWorldMatrix(child);
 
     expect(after.a).toBeCloseTo(before.a, 10);
     expect(after.b).toBeCloseTo(before.b, 10);