@flighthq/skeleton2d 0.2.1-next.840.857425c

package/dist/applyAnimationClipToSkeleton2D.d.ts

@@ -0,0 +1,3 @@
+import type { AnimationClip, Skeleton2D } from '@flighthq/types';
+export declare function applyAnimationClipToSkeleton2D(clip: Readonly<AnimationClip>, skeleton: Skeleton2D, time: number): void;
+//# sourceMappingURL=applyAnimationClipToSkeleton2D.d.ts.map

package/dist/applyAnimationClipToSkeleton2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyAnimationClipToSkeleton2D.d.ts","sourceRoot":"","sources":["../src/applyAnimationClipToSkeleton2D.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAA6B,MAAM,iBAAiB,CAAC;AAU5F,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,MAAM,GACX,IAAI,CA+BN"}

package/dist/applyAnimationClipToSkeleton2D.js

@@ -0,0 +1,45 @@
+import { sampleAnimationTrack } from '@flighthq/animation';
+import { Skeleton2DAnimationPath } from '@flighthq/types';
+// Poses a Skeleton2D from an AnimationClip at `time`: for each channel whose `targetRef` is a
+// Skeleton2DAnimationTarget, samples the channel's track and writes the value into the target bone's local
+// setup-transform fields. The 2D-skeletal analogue of @flighthq/scene3d's `applyAnimationClipToScene3D`, over
+// `Bone2D` instead of a `Node3D`. It mutates only the bones' local pose — the caller runs
+// `computeSkeleton2DWorldTransforms` (then the deform) afterward, so a whole clip applies before one world
+// propagation. Module scratch, allocation-free. A channel whose target is foreign (not a
+// Skeleton2DAnimationTarget) or out of range is skipped (sentinel guard, no throw).
+export function applyAnimationClipToSkeleton2D(clip, skeleton, time) {
+    const channels = clip.channels;
+    const bones = skeleton.bones;
+    for (let i = 0; i < channels.length; i++) {
+        const channel = channels[i];
+        const target = channel.targetRef;
+        if (target === null || typeof target !== 'object' || typeof target.boneIndex !== 'number')
+            continue;
+        const boneIndex = target.boneIndex;
+        if (boneIndex < 0 || boneIndex >= bones.length)
+            continue;
+        sampleAnimationTrack(_scratch, channel.track, time);
+        const bone = bones[boneIndex];
+        switch (target.path) {
+            case Skeleton2DAnimationPath.Translation:
+                bone.x = _scratch[0];
+                bone.y = _scratch[1];
+                break;
+            case Skeleton2DAnimationPath.Rotation:
+                bone.rotation = _scratch[0];
+                break;
+            case Skeleton2DAnimationPath.Scale:
+                bone.scaleX = _scratch[0];
+                bone.scaleY = _scratch[1];
+                break;
+            case Skeleton2DAnimationPath.Shear:
+                bone.shearX = _scratch[0];
+                bone.shearY = _scratch[1];
+                break;
+            default:
+                break;
+        }
+    }
+}
+const _scratch = [0, 0, 0, 0];
+//# sourceMappingURL=applyAnimationClipToSkeleton2D.js.map

package/dist/applyAnimationClipToSkeleton2D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyAnimationClipToSkeleton2D.js","sourceRoot":"","sources":["../src/applyAnimationClipToSkeleton2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,8FAA8F;AAC9F,2GAA2G;AAC3G,8GAA8G;AAC9G,0FAA0F;AAC1F,2GAA2G;AAC3G,yFAAyF;AACzF,oFAAoF;AACpF,MAAM,UAAU,8BAA8B,CAC5C,IAA6B,EAC7B,QAAoB,EACpB,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,SAA6C,CAAC;QACrE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QACpG,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,KAAK,CAAC,MAAM;YAAE,SAAS;QACzD,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,uBAAuB,CAAC,WAAW;gBACtC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACrB,MAAM;YACR,KAAK,uBAAuB,CAAC,QAAQ;gBACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM;YACR,KAAK,uBAAuB,CAAC,KAAK;gBAChC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACR,KAAK,uBAAuB,CAAC,KAAK;gBAChC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/deformMeshAttachment2D.d.ts

@@ -0,0 +1,3 @@
+import type { MeshAttachment2D, Skeleton2D } from '@flighthq/types';
+export declare function deformSkeleton2DMeshAttachment(out: Float32Array, attachment: Readonly<MeshAttachment2D>, skeleton: Readonly<Skeleton2D>, boneIndex: number): void;
+//# sourceMappingURL=deformMeshAttachment2D.d.ts.map

package/dist/deformMeshAttachment2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deformMeshAttachment2D.d.ts","sourceRoot":"","sources":["../src/deformMeshAttachment2D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgBpE,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EACtC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,IAAI,CA4CN"}

package/dist/deformMeshAttachment2D.js

@@ -0,0 +1,59 @@
+// 6 floats per bone in the flat world-transform buffer (a, b, c, d, tx, ty).
+const MATRIX_STRIDE = 6;
+// Deforms a MeshAttachment2D's vertices into flat interleaved world positions `[x0, y0, x1, y1, …]` in
+// `out` (length ≥ 2 × attachment.vertexCount), for the display layer to draw. Requires
+// `computeSkeleton2DWorldTransforms` to have filled `skeleton.worldMatrices`. Out-parameter,
+// allocation-free.
+//
+//   WEIGHTED (attachment.skin non-null): each vertex is Σ weight · (boneWorld · (localX, localY)) over its
+//     Skin2D influences — the offsets are already in each bone's local space (they bake the bind pose), so
+//     this reads bone WORLD matrices directly, no palette. `boneIndex` is ignored.
+//   RIGID (attachment.skin null): the mesh's setup-pose local `vertices` are transformed by bone
+//     `boneIndex`'s (the slot's bone) world matrix. Alias-safe — each vertex is read into locals before its
+//     output is written, so `out` may be the same buffer as `attachment.vertices`.
+export function deformSkeleton2DMeshAttachment(out, attachment, skeleton, boneIndex) {
+    const world = skeleton.worldMatrices;
+    const skin = attachment.skin;
+    if (skin !== null && skin !== undefined) {
+        const counts = skin.influenceCounts;
+        const inf = skin.influences;
+        let vi = 0; // influence-stream cursor (stride 4: boneIndex, localX, localY, weight)
+        let oi = 0; // output cursor (stride 2)
+        for (let v = 0; v < counts.length; v++) {
+            let wx = 0;
+            let wy = 0;
+            const n = counts[v];
+            for (let k = 0; k < n; k++) {
+                const b = inf[vi] * MATRIX_STRIDE;
+                const lx = inf[vi + 1];
+                const ly = inf[vi + 2];
+                const weight = inf[vi + 3];
+                wx += weight * (world[b] * lx + world[b + 2] * ly + world[b + 4]);
+                wy += weight * (world[b + 1] * lx + world[b + 3] * ly + world[b + 5]);
+                vi += 4;
+            }
+            out[oi] = wx;
+            out[oi + 1] = wy;
+            oi += 2;
+        }
+        return;
+    }
+    // Rigid mesh: the whole attachment follows one bone's world transform.
+    const vertices = attachment.vertices;
+    if (vertices === null || vertices === undefined)
+        return;
+    const b = boneIndex * MATRIX_STRIDE;
+    const a = world[b];
+    const bb = world[b + 1];
+    const c = world[b + 2];
+    const d = world[b + 3];
+    const tx = world[b + 4];
+    const ty = world[b + 5];
+    for (let i = 0; i < vertices.length; i += 2) {
+        const vx = vertices[i];
+        const vy = vertices[i + 1];
+        out[i] = a * vx + c * vy + tx;
+        out[i + 1] = bb * vx + d * vy + ty;
+    }
+}
+//# sourceMappingURL=deformMeshAttachment2D.js.map

package/dist/deformMeshAttachment2D.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './skeleton2d';
+export * from './deformMeshAttachment2D';
+export * from './regionAttachment2D';
+export * from './applyAnimationClipToSkeleton2D';
+//# 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,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './skeleton2d';
+export * from './deformMeshAttachment2D';
+export * from './regionAttachment2D';
+export * from './applyAnimationClipToSkeleton2D';
+//# 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,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kCAAkC,CAAC"}

package/dist/regionAttachment2D.d.ts

@@ -0,0 +1,3 @@
+import type { RegionAttachment2D, Skeleton2D } from '@flighthq/types';
+export declare function computeSkeleton2DRegionAttachmentVertices(out: Float32Array, attachment: Readonly<RegionAttachment2D>, skeleton: Readonly<Skeleton2D>, boneIndex: number): void;
+//# sourceMappingURL=regionAttachment2D.d.ts.map

package/dist/regionAttachment2D.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionAttachment2D.d.ts","sourceRoot":"","sources":["../src/regionAttachment2D.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAUlF,wBAAgB,yCAAyC,CACvD,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EACxC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,IAAI,CAkCN"}

package/dist/regionAttachment2D.js

@@ -0,0 +1,42 @@
+import { matrixTransformPointXY, multiplyMatrix, setTransformMatrix } from '@flighthq/geometry';
+import { DEG_TO_RAD } from '@flighthq/math';
+// 6 floats per bone in the flat world-transform buffer (a, b, c, d, tx, ty).
+const MATRIX_STRIDE = 6;
+// Writes a RegionAttachment2D's four world corner positions into `out` as flat interleaved pairs — order
+// bottom-left, top-left, top-right, bottom-right (`[blx, bly, tlx, tly, trx, try, brx, bry]`, 8 floats).
+// The region's local rect (centered at its `x`/`y` offset, sized `width`×`height`, rotated/scaled by its
+// local transform) is transformed by the slot bone (`boneIndex`) world matrix. Requires
+// `computeSkeleton2DWorldTransforms` to have run. Out-parameter, allocation-free (module scratch).
+export function computeSkeleton2DRegionAttachmentVertices(out, attachment, skeleton, boneIndex) {
+    // Region local matrix (offset + rotation° + scale; regions carry no shear).
+    setTransformMatrix(_local, attachment.scaleX, attachment.scaleY, attachment.rotation * DEG_TO_RAD, attachment.x, attachment.y);
+    const b = boneIndex * MATRIX_STRIDE;
+    const world = skeleton.worldMatrices;
+    _bone.a = world[b];
+    _bone.b = world[b + 1];
+    _bone.c = world[b + 2];
+    _bone.d = world[b + 3];
+    _bone.tx = world[b + 4];
+    _bone.ty = world[b + 5];
+    // Combined = boneWorld × regionLocal: maps a corner in the region's own space to world.
+    multiplyMatrix(_combined, _bone, _local);
+    const hw = attachment.width / 2;
+    const hh = attachment.height / 2;
+    matrixTransformPointXY(_corner, _combined, -hw, -hh);
+    out[0] = _corner.x;
+    out[1] = _corner.y;
+    matrixTransformPointXY(_corner, _combined, -hw, hh);
+    out[2] = _corner.x;
+    out[3] = _corner.y;
+    matrixTransformPointXY(_corner, _combined, hw, hh);
+    out[4] = _corner.x;
+    out[5] = _corner.y;
+    matrixTransformPointXY(_corner, _combined, hw, -hh);
+    out[6] = _corner.x;
+    out[7] = _corner.y;
+}
+const _local = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+const _bone = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+const _combined = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+const _corner = { x: 0, y: 0 };
+//# sourceMappingURL=regionAttachment2D.js.map

package/dist/regionAttachment2D.js.map

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

package/dist/skeleton2d.d.ts

@@ -0,0 +1,12 @@
+import type { Bone2D, MatrixLike, Skeleton2D } from '@flighthq/types';
+export declare function cloneSkeleton2D(skeleton: Readonly<Skeleton2D>): Skeleton2D;
+export declare function computeSkeleton2DBoneMatrices(skeleton: Readonly<Skeleton2D>): void;
+export declare function computeSkeleton2DWorldTransforms(skeleton: Readonly<Skeleton2D>): void;
+export declare function createSkeleton2D(bones: Bone2D[], slots?: Skeleton2D['slots']): Skeleton2D;
+export declare function disposeSkeleton2D(skeleton: Skeleton2D): void;
+export declare function equalsSkeleton2D(a: Readonly<Skeleton2D>, b: Readonly<Skeleton2D>): boolean;
+export declare function getSkeleton2DBoneIndexByName(skeleton: Readonly<Skeleton2D>, name: string): number;
+export declare function getSkeleton2DBoneWorldMatrix(out: MatrixLike, skeleton: Readonly<Skeleton2D>, boneIndex: number): boolean;
+export declare function setSkeleton2DBindPose(skeleton: Readonly<Skeleton2D>): void;
+export declare function validateSkeleton2D(skeleton: Readonly<Skeleton2D>): string | null;
+//# sourceMappingURL=skeleton2d.d.ts.map

package/dist/skeleton2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton2d.d.ts","sourceRoot":"","sources":["../src/skeleton2d.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAStE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,UAAU,CAS1E;AAMD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAYlF;AAOD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAqFrF;AAOD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,UAAU,CAAC,OAAO,CAAQ,GAAG,UAAU,CAS/F;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAG5D;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,CAsB1F;AAGD,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjG;AAID,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,CAIT;AAMD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAU1E;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,CAiBhF"}

package/dist/skeleton2d.js

@@ -0,0 +1,253 @@
+import { createEntity } from '@flighthq/entity';
+import { inverseMatrix, multiplyMatrix } from '@flighthq/geometry';
+import { DEG_TO_RAD } from '@flighthq/math';
+import { TransformMode2D } from '@flighthq/types';
+// 6 floats per bone in the flat 2×3 affine buffers (a, b, c, d, tx, ty), matching the Matrix field order.
+const MATRIX_STRIDE = 6;
+// Deep-copies the bone array (each Bone2D cloned) and the transform buffers, producing an independently
+// posable skeleton. Slots and their attachments are SHARED (attachments are immutable setup data); use a
+// skin/slot editing layer for per-instance attachment swaps.
+export function cloneSkeleton2D(skeleton) {
+    return createEntity({
+        boneMatrices: skeleton.boneMatrices.slice(),
+        bones: skeleton.bones.map((bone) => ({ ...bone })),
+        inverseBindMatrices: skeleton.inverseBindMatrices.slice(),
+        slots: skeleton.slots === null || skeleton.slots === undefined ? skeleton.slots : skeleton.slots.map((s) => ({ ...s })),
+        worldMatrices: skeleton.worldMatrices.slice(),
+    });
+}
+// Fills the skin palette `boneMatrices[i] = worldMatrices[i] × inverseBindMatrices[i]` — the matrix that
+// takes a bind-pose (setup) mesh vertex to its posed position. Call after `computeSkeleton2DWorldTransforms`
+// and once `setSkeleton2DBindPose` has captured the inverse-bind. Out-parameter (writes `boneMatrices`),
+// allocation-free (module scratch).
+export function computeSkeleton2DBoneMatrices(skeleton) {
+    const world = skeleton.worldMatrices;
+    const invBind = skeleton.inverseBindMatrices;
+    const out = skeleton.boneMatrices;
+    const count = skeleton.bones.length;
+    for (let i = 0; i < count; i++) {
+        const o = i * MATRIX_STRIDE;
+        readMatrix(_scratchA, world, o);
+        readMatrix(_scratchB, invBind, o);
+        multiplyMatrix(_scratchC, _scratchA, _scratchB);
+        writeMatrix(out, o, _scratchC);
+    }
+}
+// Propagates each bone's world transform from its local setup transform (x/y/rotation/scale/shear) and its
+// parent's world transform, honoring the bone's inherit mode. One linear pass over the parent-before-child
+// ordered array (`worldMatrices[i]` reads `worldMatrices[parentIndex]`, already written). Out-parameter,
+// allocation-free. Angles are converted degrees→radians at this seam. Position always inherits fully (the
+// local origin is placed by the parent); the inherit mode only changes the linear (rotation/scale) part.
+export function computeSkeleton2DWorldTransforms(skeleton) {
+    const bones = skeleton.bones;
+    const world = skeleton.worldMatrices;
+    const count = bones.length;
+    for (let i = 0; i < count; i++) {
+        const bone = bones[i];
+        // Local linear part (Spine bone matrix, transposed b↔c into Flight's x'=a·x+c·y convention):
+        // a=cos(rot+shearX)·scaleX, b=sin(rot+shearX)·scaleX, c=cos(rot+90°+shearY)·scaleY, d=sin(…)·scaleY.
+        const rotX = (bone.rotation + bone.shearX) * DEG_TO_RAD;
+        const rotY = (bone.rotation + 90 + bone.shearY) * DEG_TO_RAD;
+        const la = Math.cos(rotX) * bone.scaleX;
+        const lb = Math.sin(rotX) * bone.scaleX;
+        const lc = Math.cos(rotY) * bone.scaleY;
+        const ld = Math.sin(rotY) * bone.scaleY;
+        const o = i * MATRIX_STRIDE;
+        if (bone.parentIndex < 0) {
+            world[o] = la;
+            world[o + 1] = lb;
+            world[o + 2] = lc;
+            world[o + 3] = ld;
+            world[o + 4] = bone.x;
+            world[o + 5] = bone.y;
+            continue;
+        }
+        const p = bone.parentIndex * MATRIX_STRIDE;
+        const pa = world[p];
+        const pb = world[p + 1];
+        const pc = world[p + 2];
+        const pd = world[p + 3];
+        // Local origin placed by the parent — the same for every inherit mode.
+        world[o + 4] = pa * bone.x + pc * bone.y + world[p + 4];
+        world[o + 5] = pb * bone.x + pd * bone.y + world[p + 5];
+        switch (bone.transformMode) {
+            case TransformMode2D.OnlyTranslation:
+                // Rotation/scale come from the bone's own local transform; only position inherits (set above).
+                world[o] = la;
+                world[o + 1] = lb;
+                world[o + 2] = lc;
+                world[o + 3] = ld;
+                break;
+            case TransformMode2D.NoRotationOrReflection: {
+                // Inherit the parent's SCALE (its column lengths) but strip rotation + reflection: compose the
+                // local transform with a diagonal, axis-aligned scale-only parent.
+                const psx = Math.hypot(pa, pb);
+                const psy = Math.hypot(pc, pd);
+                world[o] = psx * la;
+                world[o + 1] = psy * lb;
+                world[o + 2] = psx * lc;
+                world[o + 3] = psy * ld;
+                break;
+            }
+            case TransformMode2D.NoScale:
+            case TransformMode2D.NoScaleOrReflection: {
+                // Inherit the parent's ORIENTATION but not its scale: normalize the parent's columns to unit
+                // length, then compose with the local transform. NoScale keeps the parent's reflection (its
+                // normalized columns as-is); NoScaleOrReflection strips it, forcing the y-axis to the +90°
+                // rotation of the x-axis (det = +1) so the child never flips under a negatively-scaled parent.
+                const psx = Math.hypot(pa, pb) || 1;
+                const nax = pa / psx;
+                const nay = pb / psx;
+                let ncx;
+                let ncy;
+                if (bone.transformMode === TransformMode2D.NoScaleOrReflection) {
+                    ncx = -nay;
+                    ncy = nax;
+                }
+                else {
+                    const psy = Math.hypot(pc, pd) || 1;
+                    ncx = pc / psy;
+                    ncy = pd / psy;
+                }
+                world[o] = nax * la + ncx * lb;
+                world[o + 1] = nay * la + ncy * lb;
+                world[o + 2] = nax * lc + ncx * ld;
+                world[o + 3] = nay * lc + ncy * ld;
+                break;
+            }
+            default:
+                // Normal: full inherit — world linear part = parent × local.
+                world[o] = pa * la + pc * lb;
+                world[o + 1] = pb * la + pd * lb;
+                world[o + 2] = pa * lc + pc * ld;
+                world[o + 3] = pb * lc + pd * ld;
+                break;
+        }
+    }
+}
+// Allocates a Skeleton2D from a parent-before-child ordered bone array. Sizes the flat world/inverse-bind/
+// palette buffers to the bone count. `computeSkeleton2DWorldTransforms` fills `worldMatrices`;
+// `setSkeleton2DBindPose` captures `inverseBindMatrices`; `computeSkeleton2DBoneMatrices` fills the palette.
+// Pass `slots` for a drawable skeleton (null for a pure bone rig). Bones must be topologically ordered
+// (each bone's `parentIndex` < its own index); `validateSkeleton2D` checks this.
+export function createSkeleton2D(bones, slots = null) {
+    const count = bones.length;
+    return createEntity({
+        boneMatrices: new Float32Array(count * MATRIX_STRIDE),
+        bones,
+        inverseBindMatrices: new Float32Array(count * MATRIX_STRIDE),
+        slots,
+        worldMatrices: new Float32Array(count * MATRIX_STRIDE),
+    });
+}
+// Detaches bones/slots so the skeleton is GC-eligible. `dispose*` (not `destroy*`): a Skeleton2D owns no
+// GPU or native resource — its buffers are plain GC memory — so this only clears references.
+export function disposeSkeleton2D(skeleton) {
+    skeleton.bones = [];
+    skeleton.slots = null;
+}
+export function equalsSkeleton2D(a, b) {
+    if (a === b)
+        return true;
+    if (a.bones.length !== b.bones.length)
+        return false;
+    for (let i = 0; i < a.bones.length; i++) {
+        const x = a.bones[i];
+        const y = b.bones[i];
+        if (x.parentIndex !== y.parentIndex ||
+            x.x !== y.x ||
+            x.y !== y.y ||
+            x.rotation !== y.rotation ||
+            x.scaleX !== y.scaleX ||
+            x.scaleY !== y.scaleY ||
+            x.shearX !== y.shearX ||
+            x.shearY !== y.shearY ||
+            x.length !== y.length ||
+            x.transformMode !== y.transformMode) {
+            return false;
+        }
+    }
+    return true;
+}
+// Returns the index of the bone named `name`, or the sentinel -1 when no bone has that name.
+export function getSkeleton2DBoneIndexByName(skeleton, name) {
+    const bones = skeleton.bones;
+    for (let i = 0; i < bones.length; i++) {
+        if (bones[i].name === name)
+            return i;
+    }
+    return -1;
+}
+// Writes bone `boneIndex`'s world transform into `out`, returning true; returns the sentinel false (leaving
+// `out` untouched) when `boneIndex` is out of range. Requires `computeSkeleton2DWorldTransforms` to have run.
+export function getSkeleton2DBoneWorldMatrix(out, skeleton, boneIndex) {
+    if (boneIndex < 0 || boneIndex >= skeleton.bones.length)
+        return false;
+    readMatrix(out, skeleton.worldMatrices, boneIndex * MATRIX_STRIDE);
+    return true;
+}
+// Captures the current world transforms as the bind (setup) pose: `inverseBindMatrices[i] =
+// inverse(worldMatrices[i])`. Call after posing the bones to setup and running
+// `computeSkeleton2DWorldTransforms`. A non-invertible (degenerate, zero-scale) bone leaves its
+// inverse-bind at identity (`inverseMatrix` returns false) rather than producing NaNs.
+export function setSkeleton2DBindPose(skeleton) {
+    const world = skeleton.worldMatrices;
+    const out = skeleton.inverseBindMatrices;
+    const count = skeleton.bones.length;
+    for (let i = 0; i < count; i++) {
+        const o = i * MATRIX_STRIDE;
+        readMatrix(_scratchA, world, o);
+        if (!inverseMatrix(_scratchB, _scratchA))
+            setMatrixIdentityLocal(_scratchB);
+        writeMatrix(out, o, _scratchB);
+    }
+}
+// Checks the parent-before-child ordering invariant (each bone's parentIndex is -1 or < its own index) and
+// buffer sizing. Returns null when valid, or a message describing the first violation (sentinel over throw).
+export function validateSkeleton2D(skeleton) {
+    const count = skeleton.bones.length;
+    const expected = count * MATRIX_STRIDE;
+    if (skeleton.worldMatrices.length !== expected)
+        return `worldMatrices length ${skeleton.worldMatrices.length} != ${expected}`;
+    if (skeleton.inverseBindMatrices.length !== expected) {
+        return `inverseBindMatrices length ${skeleton.inverseBindMatrices.length} != ${expected}`;
+    }
+    if (skeleton.boneMatrices.length !== expected)
+        return `boneMatrices length ${skeleton.boneMatrices.length} != ${expected}`;
+    for (let i = 0; i < count; i++) {
+        const parentIndex = skeleton.bones[i].parentIndex;
+        if (parentIndex >= i)
+            return `bone ${i} parentIndex ${parentIndex} is not < its own index (bones must be parent-before-child ordered)`;
+        if (parentIndex < -1)
+            return `bone ${i} parentIndex ${parentIndex} < -1`;
+    }
+    return null;
+}
+function readMatrix(out, buffer, offset) {
+    out.a = buffer[offset];
+    out.b = buffer[offset + 1];
+    out.c = buffer[offset + 2];
+    out.d = buffer[offset + 3];
+    out.tx = buffer[offset + 4];
+    out.ty = buffer[offset + 5];
+}
+function setMatrixIdentityLocal(out) {
+    out.a = 1;
+    out.b = 0;
+    out.c = 0;
+    out.d = 1;
+    out.tx = 0;
+    out.ty = 0;
+}
+function writeMatrix(buffer, offset, source) {
+    buffer[offset] = source.a;
+    buffer[offset + 1] = source.b;
+    buffer[offset + 2] = source.c;
+    buffer[offset + 3] = source.d;
+    buffer[offset + 4] = source.tx;
+    buffer[offset + 5] = source.ty;
+}
+const _scratchA = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+const _scratchB = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+const _scratchC = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
+//# sourceMappingURL=skeleton2d.js.map

package/dist/skeleton2d.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@flighthq/skeleton2d",
+  "version": "0.2.1-next.840.857425c",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/skeleton2d"
+  },
+  "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/animation": "0.2.1-next.840.857425c",
+    "@flighthq/entity": "0.2.1-next.840.857425c",
+    "@flighthq/geometry": "0.2.1-next.840.857425c",
+    "@flighthq/math": "0.2.1-next.840.857425c",
+    "@flighthq/types": "0.2.1-next.840.857425c"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "2D skeleton: bone hierarchy with 2D affine transforms, world propagation, inverse-bind, and weighted CPU mesh deformation (Spine/DragonBones model)",
+  "sideEffects": false
+}

package/src/applyAnimationClipToSkeleton2D.test.ts

@@ -0,0 +1,74 @@
+import { createAnimationChannel, createAnimationClip, createAnimationTrack } from '@flighthq/animation';
+import type { Bone2D } from '@flighthq/types';
+import { AnimationInterpolationLinear, Skeleton2DAnimationPath, TransformMode2D } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { applyAnimationClipToSkeleton2D } from './applyAnimationClipToSkeleton2D';
+import { createSkeleton2D } from './skeleton2d';
+
+function makeBone(overrides: Partial<Bone2D> = {}): Bone2D {
+  return {
+    length: 0,
+    name: null,
+    parentIndex: -1,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    shearX: 0,
+    shearY: 0,
+    transformMode: TransformMode2D.Normal,
+    x: 0,
+    y: 0,
+    ...overrides,
+  };
+}
+
+function scalarTrack(times: number[], values: number[], components: number) {
+  return createAnimationTrack({ times, values, components, interpolation: AnimationInterpolationLinear });
+}
+
+describe('applyAnimationClipToSkeleton2D', () => {
+  it('samples a rotation track into the target bone at the given time', () => {
+    const s = createSkeleton2D([makeBone()]);
+    const clip = createAnimationClip([
+      createAnimationChannel(scalarTrack([0, 1], [0, 90], 1), { boneIndex: 0, path: Skeleton2DAnimationPath.Rotation }),
+    ]);
+    applyAnimationClipToSkeleton2D(clip, s, 0.5);
+    expect(s.bones[0].rotation).toBeCloseTo(45, 5); // linear 0→90 at t=0.5
+  });
+
+  it('drives translation, scale, and shear across their two-component paths', () => {
+    const s = createSkeleton2D([makeBone()]);
+    const clip = createAnimationClip([
+      createAnimationChannel(scalarTrack([0, 1], [0, 0, 10, 20], 2), {
+        boneIndex: 0,
+        path: Skeleton2DAnimationPath.Translation,
+      }),
+      createAnimationChannel(scalarTrack([0, 1], [1, 1, 3, 4], 2), {
+        boneIndex: 0,
+        path: Skeleton2DAnimationPath.Scale,
+      }),
+      createAnimationChannel(scalarTrack([0, 1], [0, 0, 5, 6], 2), {
+        boneIndex: 0,
+        path: Skeleton2DAnimationPath.Shear,
+      }),
+    ]);
+    applyAnimationClipToSkeleton2D(clip, s, 1);
+    expect(s.bones[0].x).toBeCloseTo(10, 5);
+    expect(s.bones[0].y).toBeCloseTo(20, 5);
+    expect(s.bones[0].scaleX).toBeCloseTo(3, 5);
+    expect(s.bones[0].scaleY).toBeCloseTo(4, 5);
+    expect(s.bones[0].shearX).toBeCloseTo(5, 5);
+    expect(s.bones[0].shearY).toBeCloseTo(6, 5);
+  });
+
+  it('skips a channel with a foreign target or an out-of-range bone (no throw, no mutation)', () => {
+    const s = createSkeleton2D([makeBone({ rotation: 7 })]);
+    const clip = createAnimationClip([
+      createAnimationChannel(scalarTrack([0, 1], [0, 90], 1), { someOtherTarget: true }),
+      createAnimationChannel(scalarTrack([0, 1], [0, 90], 1), { boneIndex: 9, path: Skeleton2DAnimationPath.Rotation }),
+    ]);
+    applyAnimationClipToSkeleton2D(clip, s, 1);
+    expect(s.bones[0].rotation).toBe(7); // untouched
+  });
+});

package/src/deformMeshAttachment2D.test.ts

@@ -0,0 +1,81 @@
+import type { Bone2D, MeshAttachment2D, Skin2D } from '@flighthq/types';
+import { MeshAttachment2DKind, TransformMode2D } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { deformSkeleton2DMeshAttachment } from './deformMeshAttachment2D';
+import { computeSkeleton2DWorldTransforms, createSkeleton2D } from './skeleton2d';
+
+function makeBone(overrides: Partial<Bone2D> = {}): Bone2D {
+  return {
+    length: 0,
+    name: null,
+    parentIndex: -1,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    shearX: 0,
+    shearY: 0,
+    transformMode: TransformMode2D.Normal,
+    x: 0,
+    y: 0,
+    ...overrides,
+  };
+}
+
+function weightedMesh(skin: Skin2D, vertexCount: number): MeshAttachment2D {
+  return {
+    kind: MeshAttachment2DKind,
+    skin,
+    triangles: new Uint16Array(),
+    uvs: new Float32Array(vertexCount * 2),
+    vertexCount,
+    vertices: null,
+  };
+}
+
+describe('deformSkeleton2DMeshAttachment', () => {
+  it('deforms a single-bone weighted vertex through the bone world transform', () => {
+    // One bone rotated 90° at (5,0). One vertex, one influence: offset (1,0) in the bone, weight 1.
+    const s = createSkeleton2D([makeBone({ x: 5, rotation: 90 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const mesh = weightedMesh({ influenceCounts: new Uint16Array([1]), influences: new Float32Array([0, 1, 0, 1]) }, 1);
+    const out = new Float32Array(2);
+    deformSkeleton2DMeshAttachment(out, mesh, s, 0);
+    // (1,0) rotated 90° = (0,1), + translation (5,0) → (5,1).
+    expect(out[0]).toBeCloseTo(5, 5);
+    expect(out[1]).toBeCloseTo(1, 5);
+  });
+
+  it('blends two bones by weight (0.5/0.5 → midpoint of their translations)', () => {
+    const s = createSkeleton2D([makeBone({ x: 0 }), makeBone({ x: 10 })]);
+    computeSkeleton2DWorldTransforms(s);
+    // Vertex at each bone's origin (0,0), weighted 0.5 to bone 0 and 0.5 to bone 1.
+    const skin: Skin2D = {
+      influenceCounts: new Uint16Array([2]),
+      influences: new Float32Array([0, 0, 0, 0.5, 1, 0, 0, 0.5]),
+    };
+    const out = new Float32Array(2);
+    deformSkeleton2DMeshAttachment(out, weightedMesh(skin, 1), s, 0);
+    expect(out[0]).toBeCloseTo(5, 5); // midpoint of x=0 and x=10
+    expect(out[1]).toBeCloseTo(0, 5);
+  });
+
+  it('transforms a rigid mesh by the slot bone world matrix (alias-safe in place)', () => {
+    const s = createSkeleton2D([makeBone({ x: 5, rotation: 90 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const verts = new Float32Array([2, 0]); // one vertex, local to the bone
+    const mesh: MeshAttachment2D = {
+      kind: MeshAttachment2DKind,
+      skin: null,
+      triangles: new Uint16Array(),
+      uvs: new Float32Array(2),
+      vertexCount: 1,
+      vertices: verts,
+    };
+    // Deform in place (out === vertices) to exercise alias safety.
+    deformSkeleton2DMeshAttachment(verts, mesh, s, 0);
+    // (2,0) rotated 90° = (0,2), + (5,0) → (5,2).
+    expect(verts[0]).toBeCloseTo(5, 5);
+    expect(verts[1]).toBeCloseTo(2, 5);
+  });
+});

package/src/regionAttachment2D.test.ts

@@ -0,0 +1,71 @@
+import type { Bone2D, RegionAttachment2D } from '@flighthq/types';
+import { RegionAttachment2DKind, TransformMode2D } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { computeSkeleton2DRegionAttachmentVertices } from './regionAttachment2D';
+import { computeSkeleton2DWorldTransforms, createSkeleton2D } from './skeleton2d';
+
+function makeBone(overrides: Partial<Bone2D> = {}): Bone2D {
+  return {
+    length: 0,
+    name: null,
+    parentIndex: -1,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    shearX: 0,
+    shearY: 0,
+    transformMode: TransformMode2D.Normal,
+    x: 0,
+    y: 0,
+    ...overrides,
+  };
+}
+
+function region(overrides: Partial<RegionAttachment2D> = {}): RegionAttachment2D {
+  return {
+    kind: RegionAttachment2DKind,
+    height: 2,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    width: 4,
+    x: 0,
+    y: 0,
+    ...overrides,
+  };
+}
+
+describe('computeSkeleton2DRegionAttachmentVertices', () => {
+  it('offsets a 4×2 region rect by the bone translation (BL, TL, TR, BR order)', () => {
+    const s = createSkeleton2D([makeBone({ x: 10, y: 5 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = new Float32Array(8);
+    computeSkeleton2DRegionAttachmentVertices(out, region(), s, 0);
+    // Corners (±2, ±1) shifted by (10,5): BL(8,4) TL(8,6) TR(12,6) BR(12,4).
+    expect(Array.from(out)).toEqual([8, 4, 8, 6, 12, 6, 12, 4]);
+  });
+
+  it('rotates the region rect through a 90° bone', () => {
+    const s = createSkeleton2D([makeBone({ rotation: 90 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = new Float32Array(8);
+    computeSkeleton2DRegionAttachmentVertices(out, region(), s, 0);
+    // BL local (-2,-1) rotated 90° CCW → (1,-2).
+    expect(out[0]).toBeCloseTo(1, 5);
+    expect(out[1]).toBeCloseTo(-2, 5);
+    // TR local (2,1) → (-1,2).
+    expect(out[4]).toBeCloseTo(-1, 5);
+    expect(out[5]).toBeCloseTo(2, 5);
+  });
+
+  it('applies the region local offset and scale on top of the bone', () => {
+    const s = createSkeleton2D([makeBone()]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = new Float32Array(8);
+    // Region offset to (3,0), doubled in x: half-width 2·2 = 4, so BL at (3-4, 0-1) = (-1,-1).
+    computeSkeleton2DRegionAttachmentVertices(out, region({ x: 3, scaleX: 2 }), s, 0);
+    expect(out[0]).toBeCloseTo(-1, 5);
+    expect(out[1]).toBeCloseTo(-1, 5);
+  });
+});

package/src/skeleton2d.test.ts

@@ -0,0 +1,234 @@
+import { createMatrix } from '@flighthq/geometry';
+import type { Bone2D } from '@flighthq/types';
+import { TransformMode2D } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import {
+  cloneSkeleton2D,
+  computeSkeleton2DBoneMatrices,
+  computeSkeleton2DWorldTransforms,
+  createSkeleton2D,
+  disposeSkeleton2D,
+  equalsSkeleton2D,
+  getSkeleton2DBoneIndexByName,
+  getSkeleton2DBoneWorldMatrix,
+  setSkeleton2DBindPose,
+  validateSkeleton2D,
+} from './skeleton2d';
+
+function makeBone(overrides: Partial<Bone2D> = {}): Bone2D {
+  return {
+    length: 0,
+    name: null,
+    parentIndex: -1,
+    rotation: 0,
+    scaleX: 1,
+    scaleY: 1,
+    shearX: 0,
+    shearY: 0,
+    transformMode: TransformMode2D.Normal,
+    x: 0,
+    y: 0,
+    ...overrides,
+  };
+}
+
+describe('cloneSkeleton2D', () => {
+  it('deep-copies bones so the clone poses independently', () => {
+    const s = createSkeleton2D([makeBone({ name: 'root', rotation: 30 })]);
+    const c = cloneSkeleton2D(s);
+    c.bones[0].rotation = 90;
+    expect(s.bones[0].rotation).toBe(30);
+    expect(c.bones[0].rotation).toBe(90);
+    // Buffers are distinct instances.
+    expect(c.worldMatrices).not.toBe(s.worldMatrices);
+  });
+});
+
+describe('computeSkeleton2DBoneMatrices', () => {
+  it('yields identity palettes at the captured bind pose and non-identity once posed', () => {
+    const s = createSkeleton2D([makeBone({ x: 10, rotation: 45 }), makeBone({ parentIndex: 0, x: 5 })]);
+    computeSkeleton2DWorldTransforms(s);
+    setSkeleton2DBindPose(s);
+    computeSkeleton2DBoneMatrices(s);
+    // At bind pose, palette = world × inverse(world) = identity for every bone.
+    for (let i = 0; i < s.bones.length; i++) {
+      const o = i * 6;
+      expect(s.boneMatrices[o]).toBeCloseTo(1, 4);
+      expect(s.boneMatrices[o + 1]).toBeCloseTo(0, 4);
+      expect(s.boneMatrices[o + 2]).toBeCloseTo(0, 4);
+      expect(s.boneMatrices[o + 3]).toBeCloseTo(1, 4);
+      expect(s.boneMatrices[o + 4]).toBeCloseTo(0, 4);
+      expect(s.boneMatrices[o + 5]).toBeCloseTo(0, 4);
+    }
+    // Repose the root; the palette leaves identity.
+    s.bones[0].rotation = 90;
+    computeSkeleton2DWorldTransforms(s);
+    computeSkeleton2DBoneMatrices(s);
+    const changed = Math.abs(s.boneMatrices[0] - 1) > 1e-3 || Math.abs(s.boneMatrices[1]) > 1e-3;
+    expect(changed).toBe(true);
+  });
+});
+
+describe('computeSkeleton2DWorldTransforms', () => {
+  it('rotates a root 90° into an (a=0,b=1,c=-1,d=0) world matrix at its translation', () => {
+    const s = createSkeleton2D([makeBone({ x: 10, y: 0, rotation: 90 })]);
+    computeSkeleton2DWorldTransforms(s);
+    expect(s.worldMatrices[0]).toBeCloseTo(0, 5); // a
+    expect(s.worldMatrices[1]).toBeCloseTo(1, 5); // b
+    expect(s.worldMatrices[2]).toBeCloseTo(-1, 5); // c
+    expect(s.worldMatrices[3]).toBeCloseTo(0, 5); // d
+    expect(s.worldMatrices[4]).toBeCloseTo(10, 5); // tx
+    expect(s.worldMatrices[5]).toBeCloseTo(0, 5); // ty
+  });
+
+  it('places a child at parent × local (2 units along a 90°-rotated parent maps to +y)', () => {
+    const s = createSkeleton2D([makeBone({ x: 10, y: 0, rotation: 90 }), makeBone({ parentIndex: 0, x: 2, y: 0 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    getSkeleton2DBoneWorldMatrix(out, s, 1);
+    expect(out.tx).toBeCloseTo(10, 5);
+    expect(out.ty).toBeCloseTo(2, 5);
+  });
+
+  it('OnlyTranslation inherits the parent position but not its rotation', () => {
+    const s = createSkeleton2D([
+      makeBone({ rotation: 90 }),
+      makeBone({ parentIndex: 0, x: 3, y: 0, transformMode: TransformMode2D.OnlyTranslation }),
+    ]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    getSkeleton2DBoneWorldMatrix(out, s, 1);
+    // Linear part is the child's own (identity), not the parent's 90° rotation.
+    expect(out.a).toBeCloseTo(1, 5);
+    expect(out.b).toBeCloseTo(0, 5);
+    expect(out.c).toBeCloseTo(0, 5);
+    expect(out.d).toBeCloseTo(1, 5);
+    // Position still follows the parent (3 along parent +x → +y in world).
+    expect(out.tx).toBeCloseTo(0, 5);
+    expect(out.ty).toBeCloseTo(3, 5);
+  });
+
+  it('NoScale strips the parent scale but keeps its rotation', () => {
+    const s = createSkeleton2D([
+      makeBone({ scaleX: 3, scaleY: 3 }),
+      makeBone({ parentIndex: 0, transformMode: TransformMode2D.NoScale }),
+    ]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    getSkeleton2DBoneWorldMatrix(out, s, 1);
+    // Parent's 3× scale removed → the child's world linear part is unit (identity here, no rotation).
+    expect(out.a).toBeCloseTo(1, 5);
+    expect(out.b).toBeCloseTo(0, 5);
+    expect(out.c).toBeCloseTo(0, 5);
+    expect(out.d).toBeCloseTo(1, 5);
+  });
+
+  it('NoRotationOrReflection keeps the parent scale but strips its rotation', () => {
+    const s = createSkeleton2D([
+      makeBone({ rotation: 90, scaleX: 2, scaleY: 2 }),
+      makeBone({ parentIndex: 0, transformMode: TransformMode2D.NoRotationOrReflection }),
+    ]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    getSkeleton2DBoneWorldMatrix(out, s, 1);
+    // Parent's 90° rotation removed, its 2× scale kept → axis-aligned 2× world.
+    expect(out.a).toBeCloseTo(2, 5);
+    expect(out.b).toBeCloseTo(0, 5);
+    expect(out.c).toBeCloseTo(0, 5);
+    expect(out.d).toBeCloseTo(2, 5);
+  });
+
+  it('NoScaleOrReflection never flips the child under a reflected parent', () => {
+    const s = createSkeleton2D([
+      makeBone({ scaleX: -2, scaleY: 2 }), // reflected (negative X scale)
+      makeBone({ parentIndex: 0, transformMode: TransformMode2D.NoScaleOrReflection }),
+    ]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    getSkeleton2DBoneWorldMatrix(out, s, 1);
+    // Determinant stays positive (no reflection) and unit magnitude (no scale).
+    const det = out.a * out.d - out.c * out.b;
+    expect(det).toBeCloseTo(1, 5);
+  });
+});
+
+describe('createSkeleton2D', () => {
+  it('sizes the flat buffers to 6 floats per bone', () => {
+    const s = createSkeleton2D([makeBone(), makeBone({ parentIndex: 0 })]);
+    expect(s.worldMatrices.length).toBe(12);
+    expect(s.inverseBindMatrices.length).toBe(12);
+    expect(s.boneMatrices.length).toBe(12);
+    expect(s.slots).toBeNull();
+  });
+});
+
+describe('disposeSkeleton2D', () => {
+  it('clears bones and slots for GC', () => {
+    const s = createSkeleton2D([makeBone()], []);
+    disposeSkeleton2D(s);
+    expect(s.bones.length).toBe(0);
+    expect(s.slots).toBeNull();
+  });
+});
+
+describe('equalsSkeleton2D', () => {
+  it('is true for a fresh clone and false after a bone edit', () => {
+    const s = createSkeleton2D([makeBone({ rotation: 15 })]);
+    const c = cloneSkeleton2D(s);
+    expect(equalsSkeleton2D(s, c)).toBe(true);
+    c.bones[0].rotation = 16;
+    expect(equalsSkeleton2D(s, c)).toBe(false);
+  });
+});
+
+describe('getSkeleton2DBoneIndexByName', () => {
+  it('finds a named bone and returns -1 for a miss', () => {
+    const s = createSkeleton2D([makeBone({ name: 'root' }), makeBone({ parentIndex: 0, name: 'arm' })]);
+    expect(getSkeleton2DBoneIndexByName(s, 'arm')).toBe(1);
+    expect(getSkeleton2DBoneIndexByName(s, 'leg')).toBe(-1);
+  });
+});
+
+describe('getSkeleton2DBoneWorldMatrix', () => {
+  it('writes the world matrix in range and returns false out of range', () => {
+    const s = createSkeleton2D([makeBone({ x: 7 })]);
+    computeSkeleton2DWorldTransforms(s);
+    const out = createMatrix();
+    expect(getSkeleton2DBoneWorldMatrix(out, s, 0)).toBe(true);
+    expect(out.tx).toBeCloseTo(7, 5);
+    expect(getSkeleton2DBoneWorldMatrix(out, s, 5)).toBe(false);
+    expect(getSkeleton2DBoneWorldMatrix(out, s, -1)).toBe(false);
+  });
+});
+
+describe('setSkeleton2DBindPose', () => {
+  it('captures the inverse of the current world so the palette is identity at bind', () => {
+    const s = createSkeleton2D([makeBone({ x: 4, rotation: 60, scaleX: 2 })]);
+    computeSkeleton2DWorldTransforms(s);
+    setSkeleton2DBindPose(s);
+    computeSkeleton2DBoneMatrices(s);
+    expect(s.boneMatrices[0]).toBeCloseTo(1, 4);
+    expect(s.boneMatrices[3]).toBeCloseTo(1, 4);
+    expect(s.boneMatrices[4]).toBeCloseTo(0, 4);
+    expect(s.boneMatrices[5]).toBeCloseTo(0, 4);
+  });
+});
+
+describe('validateSkeleton2D', () => {
+  it('returns null for a valid parent-before-child skeleton', () => {
+    const s = createSkeleton2D([makeBone(), makeBone({ parentIndex: 0 })]);
+    expect(validateSkeleton2D(s)).toBeNull();
+  });
+
+  it('reports a child whose parentIndex is not before it', () => {
+    const s = createSkeleton2D([makeBone({ parentIndex: 1 }), makeBone({ parentIndex: 0 })]);
+    expect(validateSkeleton2D(s)).toContain('parent-before-child');
+  });
+
+  it('reports a mis-sized buffer', () => {
+    const s = createSkeleton2D([makeBone()]);
+    s.worldMatrices = new Float32Array(3);
+    expect(validateSkeleton2D(s)).toContain('worldMatrices');
+  });
+});