@flighthq/skeleton2d 0.3.0-next.906.07cea63 → 0.3.1-next.209.43ef1bc

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/dist/applyAnimationClipToSkeleton2D.d.ts +1 -1
  2. package/dist/applyAnimationClipToSkeleton2D.d.ts.map +1 -1
  3. package/dist/applyAnimationClipToSkeleton2D.js +35 -36
  4. package/dist/applyAnimationClipToSkeleton2D.js.map +1 -1
  5. package/dist/boundingBoxAttachment2D.d.ts +3 -0
  6. package/dist/boundingBoxAttachment2D.d.ts.map +1 -0
  7. package/dist/boundingBoxAttachment2D.js +14 -0
  8. package/dist/boundingBoxAttachment2D.js.map +1 -0
  9. package/dist/clippingAttachment2D.d.ts +7 -0
  10. package/dist/clippingAttachment2D.d.ts.map +1 -0
  11. package/dist/clippingAttachment2D.js +26 -0
  12. package/dist/clippingAttachment2D.js.map +1 -0
  13. package/dist/contract.d.ts +17 -0
  14. package/dist/contract.d.ts.map +1 -1
  15. package/dist/contract.js +17 -0
  16. package/dist/contract.js.map +1 -1
  17. package/dist/deformAnimationTarget2D.d.ts +2 -0
  18. package/dist/deformAnimationTarget2D.d.ts.map +1 -0
  19. package/dist/deformAnimationTarget2D.js +40 -0
  20. package/dist/deformAnimationTarget2D.js.map +1 -0
  21. package/dist/deformMeshAttachment2D.d.ts +1 -1
  22. package/dist/deformMeshAttachment2D.d.ts.map +1 -1
  23. package/dist/deformMeshAttachment2D.js +16 -46
  24. package/dist/deformMeshAttachment2D.js.map +1 -1
  25. package/dist/deformPathAttachment2D.d.ts +3 -0
  26. package/dist/deformPathAttachment2D.d.ts.map +1 -0
  27. package/dist/deformPathAttachment2D.js +36 -0
  28. package/dist/deformPathAttachment2D.js.map +1 -0
  29. package/dist/enableSkeleton2DGuards.d.ts +22 -0
  30. package/dist/enableSkeleton2DGuards.d.ts.map +1 -0
  31. package/dist/enableSkeleton2DGuards.js +42 -0
  32. package/dist/enableSkeleton2DGuards.js.map +1 -0
  33. package/dist/explainSkeleton2DChannel.d.ts +20 -0
  34. package/dist/explainSkeleton2DChannel.d.ts.map +1 -0
  35. package/dist/explainSkeleton2DChannel.js +33 -0
  36. package/dist/explainSkeleton2DChannel.js.map +1 -0
  37. package/dist/explainSkeleton2DDeformLength.d.ts +3 -0
  38. package/dist/explainSkeleton2DDeformLength.d.ts.map +1 -0
  39. package/dist/explainSkeleton2DDeformLength.js +23 -0
  40. package/dist/explainSkeleton2DDeformLength.js.map +1 -0
  41. package/dist/ikConstraint2D.d.ts +4 -0
  42. package/dist/ikConstraint2D.d.ts.map +1 -0
  43. package/dist/ikConstraint2D.js +162 -0
  44. package/dist/ikConstraint2D.js.map +1 -0
  45. package/dist/index.d.ts +1 -1
  46. package/dist/index.d.ts.map +1 -1
  47. package/dist/index.js +1 -1
  48. package/dist/index.js.map +1 -1
  49. package/dist/pathConstraint2D.d.ts +4 -0
  50. package/dist/pathConstraint2D.d.ts.map +1 -0
  51. package/dist/pathConstraint2D.js +171 -0
  52. package/dist/pathConstraint2D.js.map +1 -0
  53. package/dist/pointAttachment2D.d.ts +4 -0
  54. package/dist/pointAttachment2D.d.ts.map +1 -0
  55. package/dist/pointAttachment2D.js +34 -0
  56. package/dist/pointAttachment2D.js.map +1 -0
  57. package/dist/skeleton2d.d.ts +4 -1
  58. package/dist/skeleton2d.d.ts.map +1 -1
  59. package/dist/skeleton2d.js +113 -67
  60. package/dist/skeleton2d.js.map +1 -1
  61. package/dist/skeleton2dAnimationTarget.d.ts +15 -0
  62. package/dist/skeleton2dAnimationTarget.d.ts.map +1 -0
  63. package/dist/skeleton2dAnimationTarget.js +173 -0
  64. package/dist/skeleton2dAnimationTarget.js.map +1 -0
  65. package/dist/skeleton2dConstraint.d.ts +6 -0
  66. package/dist/skeleton2dConstraint.d.ts.map +1 -0
  67. package/dist/skeleton2dConstraint.js +37 -0
  68. package/dist/skeleton2dConstraint.js.map +1 -0
  69. package/dist/skeleton2dDrawOrderTarget.d.ts +38 -0
  70. package/dist/skeleton2dDrawOrderTarget.d.ts.map +1 -0
  71. package/dist/skeleton2dDrawOrderTarget.js +107 -0
  72. package/dist/skeleton2dDrawOrderTarget.js.map +1 -0
  73. package/dist/skeleton2dGuards.d.ts +16 -0
  74. package/dist/skeleton2dGuards.d.ts.map +1 -0
  75. package/dist/skeleton2dGuards.js +29 -0
  76. package/dist/skeleton2dGuards.js.map +1 -0
  77. package/dist/skinAttachment2DPoints.d.ts +3 -0
  78. package/dist/skinAttachment2DPoints.d.ts.map +1 -0
  79. package/dist/skinAttachment2DPoints.js +85 -0
  80. package/dist/skinAttachment2DPoints.js.map +1 -0
  81. package/dist/slotDeform2D.d.ts +4 -0
  82. package/dist/slotDeform2D.d.ts.map +1 -0
  83. package/dist/slotDeform2D.js +38 -0
  84. package/dist/slotDeform2D.js.map +1 -0
  85. package/dist/transformConstraint2D.d.ts +4 -0
  86. package/dist/transformConstraint2D.d.ts.map +1 -0
  87. package/dist/transformConstraint2D.js +113 -0
  88. package/dist/transformConstraint2D.js.map +1 -0
  89. package/package.json +11 -6
  90. package/src/applyAnimationClipToSkeleton2D.test.ts +230 -33
  91. package/src/boundingBoxAttachment2D.test.ts +84 -0
  92. package/src/clippingAttachment2D.test.ts +76 -0
  93. package/src/deformAnimationTarget2D.test.ts +143 -0
  94. package/src/deformMeshAttachment2D.test.ts +85 -1
  95. package/src/deformPathAttachment2D.test.ts +193 -0
  96. package/src/enableSkeleton2DGuards.test.ts +88 -0
  97. package/src/explainSkeleton2DChannel.test.ts +45 -0
  98. package/src/explainSkeleton2DDeformLength.test.ts +55 -0
  99. package/src/ikConstraint2D.test.ts +221 -0
  100. package/src/pathConstraint2D.test.ts +239 -0
  101. package/src/pointAttachment2D.test.ts +81 -0
  102. package/src/skeleton2d.test.ts +221 -2
  103. package/src/skeleton2dAnimationTarget.test.ts +160 -0
  104. package/src/skeleton2dConstraint.test.ts +119 -0
  105. package/src/skeleton2dDrawOrderTarget.test.ts +213 -0
  106. package/src/skeleton2dGuards.test.ts +80 -0
  107. package/src/skinAttachment2DPoints.test.ts +138 -0
  108. package/src/slotDeform2D.test.ts +132 -0
  109. package/src/transformConstraint2D.test.ts +178 -0
@@ -0,0 +1,23 @@
1
+ // Answers, as plain data, why a deform offset stream was applied or ignored — the shakeable query paired
2
+ // with the silent sentinel in `skinSkeleton2DAttachmentPoints`. The guard reports THAT a mismatch happened;
3
+ // this reports what the length should have been, which is what a caller needs in order to fix it.
4
+ //
5
+ // It takes the SAME two inputs the skinning primitive dispatches on — the skin and the setup vertices —
6
+ // rather than an attachment. That is deliberate: every deformable attachment reduces to those two, so this
7
+ // cannot drift as attachment kinds are added, and it answers the question for a kind it has never heard of.
8
+ //
9
+ // The number that surprises is the weighted one: offsets are addressed PER INFLUENCE, not per vertex, so a
10
+ // mesh whose vertices average three bones needs three times the stream a per-vertex reading predicts. An
11
+ // importer sizing from vertex count is the mistake this exists to name.
12
+ export function explainSkeleton2DDeformLength(skin, vertices, deform) {
13
+ const weighted = skin !== null && skin !== undefined;
14
+ const addressed = weighted ? skin.influences.length / 2 : (vertices?.length ?? 0);
15
+ const offsets = deform === null ? 0 : deform.length;
16
+ return {
17
+ accepted: deform !== null && offsets >= addressed,
18
+ addressed,
19
+ addressing: weighted ? 'weighted' : 'rigid',
20
+ offsets,
21
+ };
22
+ }
23
+ //# sourceMappingURL=explainSkeleton2DDeformLength.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"explainSkeleton2DDeformLength.js","sourceRoot":"","sources":["../src/explainSkeleton2DDeformLength.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,4GAA4G;AAC5G,kGAAkG;AAClG,EAAE;AACF,wGAAwG;AACxG,2GAA2G;AAC3G,4GAA4G;AAC5G,EAAE;AACF,2GAA2G;AAC3G,yGAAyG;AACzG,wEAAwE;AACxE,MAAM,UAAU,6BAA6B,CAC3C,IAAyC,EACzC,QAAmD,EACnD,MAAqC;IAErC,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC;IACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IACpD,OAAO;QACL,QAAQ,EAAE,MAAM,KAAK,IAAI,IAAI,OAAO,IAAI,SAAS;QACjD,SAAS;QACT,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;QAC3C,OAAO;KACR,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Skeleton2D, Skeleton2DConstraint } from '@flighthq/types/contract';
2
+ export declare function registerSkeleton2DIkConstraintSolver(): void;
3
+ export declare function solveSkeleton2DIkConstraint(skeleton: Skeleton2D, constraint: Readonly<Skeleton2DConstraint>): void;
4
+ //# sourceMappingURL=ikConstraint2D.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ikConstraint2D.d.ts","sourceRoot":"","sources":["../src/ikConstraint2D.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAA0B,MAAM,0BAA0B,CAAC;AAWzG,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAQD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAelH"}
@@ -0,0 +1,162 @@
1
+ import { RAD_TO_DEG } from '@flighthq/math/contract';
2
+ import { Skeleton2DConstraintKind } from '@flighthq/types/contract';
3
+ import { computeSkeleton2DBoneWorldTransform } from './skeleton2d';
4
+ import { registerSkeleton2DConstraintSolver } from './skeleton2dConstraint';
5
+ // 6 floats per bone in the flat world-transform buffer (a, b, c, d, tx, ty).
6
+ const MATRIX_STRIDE = 6;
7
+ // Opts a bundle into IK. Nothing registers itself, so a rig that never solves IK sheds this whole module —
8
+ // which is the reason constraints are a registry rather than a switch.
9
+ export function registerSkeleton2DIkConstraintSolver() {
10
+ registerSkeleton2DConstraintSolver(Skeleton2DConstraintKind.Ik, solveSkeleton2DIkConstraint);
11
+ }
12
+ // Rotates a one- or two-bone chain so its tip reaches the target bone's world position, writing bone LOCAL
13
+ // rotations (and scales, when stretching or compressing) and refreshing the world matrix of each bone it
14
+ // moves. Descendants below the chain are left for the caller's world pass — see solveSkeleton2DConstraints.
15
+ //
16
+ // A chain of any other length, or an index out of range, is skipped: a rig can carry a constraint this
17
+ // solver does not cover without the whole pose failing.
18
+ export function solveSkeleton2DIkConstraint(skeleton, constraint) {
19
+ const ik = constraint;
20
+ const bones = skeleton.bones;
21
+ const world = skeleton.worldMatrices;
22
+ const target = ik.targetBoneIndex;
23
+ if (target < 0 || target >= bones.length)
24
+ return;
25
+ const targetX = world[target * MATRIX_STRIDE + 4];
26
+ const targetY = world[target * MATRIX_STRIDE + 5];
27
+ const chain = ik.boneIndices;
28
+ if (chain.length === 1) {
29
+ solveSkeleton2DIkChain1(skeleton, chain[0], targetX, targetY, ik);
30
+ return;
31
+ }
32
+ if (chain.length === 2)
33
+ solveSkeleton2DIkChain2(skeleton, chain[0], chain[1], targetX, targetY, ik);
34
+ }
35
+ // One bone: aim its local +x axis at the target. The target's world position is pulled back into the
36
+ // bone's PARENT space, because a bone's rotation field is local — the parent's own rotation is already
37
+ // accounted for by the basis it is expressed in, and comparing world angles instead would double-count it.
38
+ function solveSkeleton2DIkChain1(skeleton, boneIndex, targetX, targetY, ik) {
39
+ const bones = skeleton.bones;
40
+ if (boneIndex < 0 || boneIndex >= bones.length)
41
+ return;
42
+ const bone = bones[boneIndex];
43
+ const local = toSkeleton2DParentSpace(skeleton, boneIndex, targetX, targetY);
44
+ if (local === null)
45
+ return;
46
+ const dx = local.x - bone.x;
47
+ const dy = local.y - bone.y;
48
+ // The shear is subtracted because it is baked into the bone's drawn x axis: the axis points along
49
+ // rotation + shearX, so aiming the AXIS at the target means solving for the rotation behind it.
50
+ const rotation = Math.atan2(dy, dx) * RAD_TO_DEG - bone.shearX;
51
+ bone.rotation += wrapSkeleton2DAngle(rotation - bone.rotation) * ik.mix;
52
+ if (ik.stretch || ik.compress) {
53
+ const reach = Math.hypot(dx, dy);
54
+ const length = bone.length * Math.abs(bone.scaleX);
55
+ if (length > 0) {
56
+ const wanted = reach / length;
57
+ // Stretch only lengthens and compress only shortens, so a chain that already reaches is untouched by
58
+ // either. Both blend by `mix`, so a half-applied constraint stretches half as far.
59
+ if ((wanted > 1 && ik.stretch) || (wanted < 1 && ik.compress)) {
60
+ const scale = 1 + (wanted - 1) * ik.mix;
61
+ bone.scaleX *= scale;
62
+ bone.scaleY *= scale;
63
+ }
64
+ }
65
+ }
66
+ computeSkeleton2DBoneWorldTransform(skeleton, boneIndex);
67
+ }
68
+ // Two bones: place the parent so the child's tip lands on the target — the elbow/knee solve. Both bone
69
+ // lengths are known, so this is the law of cosines rather than an iterative fit: the triangle formed by the
70
+ // parent's origin, the joint and the target has all three sides, so the two interior angles follow
71
+ // directly and `bendPositive` picks which of the two mirror solutions to take.
72
+ function solveSkeleton2DIkChain2(skeleton, parentIndex, childIndex, targetX, targetY, ik) {
73
+ const bones = skeleton.bones;
74
+ if (parentIndex < 0 || parentIndex >= bones.length || childIndex < 0 || childIndex >= bones.length)
75
+ return;
76
+ const parent = bones[parentIndex];
77
+ const child = bones[childIndex];
78
+ const parentLength = parent.length * Math.abs(parent.scaleX);
79
+ const childLength = child.length * Math.abs(child.scaleX);
80
+ if (parentLength <= 0 || childLength <= 0)
81
+ return;
82
+ const local = toSkeleton2DParentSpace(skeleton, parentIndex, targetX, targetY);
83
+ if (local === null)
84
+ return;
85
+ const dx = local.x - parent.x;
86
+ const dy = local.y - parent.y;
87
+ let reach = Math.hypot(dx, dy);
88
+ if (reach <= 0)
89
+ return;
90
+ const span = parentLength + childLength;
91
+ // Out of reach: the chain straightens and points at the target. Stretching scales both bones so the tip
92
+ // lands on it anyway; without stretch the chain simply falls short, which is what a real limb does.
93
+ let bendAngle;
94
+ if (reach >= span) {
95
+ bendAngle = 0;
96
+ // Only the PARENT is scaled. The child inherits its parent's scale, so scaling both would compound —
97
+ // a chain stretched to twice its reach would extend four times as far on its second bone.
98
+ if (ik.stretch) {
99
+ const scale = 1 + (reach / span - 1) * ik.mix;
100
+ parent.scaleX *= scale;
101
+ parent.scaleY *= scale;
102
+ }
103
+ }
104
+ else if (reach <= Math.abs(parentLength - childLength)) {
105
+ // Inside the dead zone the chain folds as far as it can and the tip still cannot reach.
106
+ bendAngle = Math.PI;
107
+ reach = Math.abs(parentLength - childLength);
108
+ }
109
+ else {
110
+ // Law of cosines on the joint angle, measured as the deviation from straight.
111
+ const cosJoint = (parentLength * parentLength + childLength * childLength - reach * reach) / (2 * parentLength * childLength);
112
+ bendAngle = Math.PI - Math.acos(Math.min(1, Math.max(-1, cosJoint)));
113
+ }
114
+ // The parent turns off the straight-at-target direction by the triangle's other interior angle.
115
+ const cosParent = (parentLength * parentLength + reach * reach - childLength * childLength) / (2 * parentLength * reach);
116
+ const parentOffset = reach >= span ? 0 : Math.acos(Math.min(1, Math.max(-1, cosParent)));
117
+ const direction = ik.bendPositive ? 1 : -1;
118
+ const aim = Math.atan2(dy, dx);
119
+ const parentRotation = (aim + parentOffset * direction) * RAD_TO_DEG - parent.shearX;
120
+ parent.rotation += wrapSkeleton2DAngle(parentRotation - parent.rotation) * ik.mix;
121
+ computeSkeleton2DBoneWorldTransform(skeleton, parentIndex);
122
+ // The child's rotation is local to the parent it has just been given, so it is the bend angle directly
123
+ // rather than a world angle — which is why the parent has to be refreshed first. It bends BACK toward
124
+ // the target, opposite the way the parent was swung off the aim line, which is what the negation is.
125
+ const childRotation = -bendAngle * direction * RAD_TO_DEG - child.shearX;
126
+ child.rotation += wrapSkeleton2DAngle(childRotation - child.rotation) * ik.mix;
127
+ computeSkeleton2DBoneWorldTransform(skeleton, childIndex);
128
+ }
129
+ // A world point in the space a bone's local transform is expressed in — its parent's. A root bone's local
130
+ // space IS world space. Returns null for a parent basis with no inverse, which is a bone collapsed to zero
131
+ // scale: there is no meaningful direction to aim along, so the constraint is skipped rather than producing
132
+ // infinities.
133
+ function toSkeleton2DParentSpace(skeleton, boneIndex, x, y) {
134
+ const parentIndex = skeleton.bones[boneIndex].parentIndex;
135
+ if (parentIndex < 0)
136
+ return { x, y };
137
+ const world = skeleton.worldMatrices;
138
+ const p = parentIndex * MATRIX_STRIDE;
139
+ const a = world[p];
140
+ const b = world[p + 1];
141
+ const c = world[p + 2];
142
+ const d = world[p + 3];
143
+ const determinant = a * d - c * b;
144
+ if (Math.abs(determinant) < MINIMUM_DETERMINANT)
145
+ return null;
146
+ const wx = x - world[p + 4];
147
+ const wy = y - world[p + 5];
148
+ return { x: (d * wx - c * wy) / determinant, y: (a * wy - b * wx) / determinant };
149
+ }
150
+ // The shortest signed way round from one angle to another, in degrees. Blending a raw difference would
151
+ // take the long way whenever a solve crosses ±180°, which reads as a limb spinning the wrong way for one
152
+ // frame.
153
+ function wrapSkeleton2DAngle(degrees) {
154
+ let value = degrees % 360;
155
+ if (value > 180)
156
+ value -= 360;
157
+ else if (value < -180)
158
+ value += 360;
159
+ return value;
160
+ }
161
+ const MINIMUM_DETERMINANT = 1e-9;
162
+ //# sourceMappingURL=ikConstraint2D.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ikConstraint2D.js","sourceRoot":"","sources":["../src/ikConstraint2D.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export { applyAnimationClipToSkeleton2D, cloneSkeleton2D, computeSkeleton2DBoneMatrices, computeSkeleton2DRegionAttachmentVertices, computeSkeleton2DWorldTransforms, createSkeleton2D, deformSkeleton2DMeshAttachment, disposeSkeleton2D, equalsSkeleton2D, getSkeleton2DBoneIndexByName, getSkeleton2DBoneWorldMatrix, setSkeleton2DBindPose, validateSkeleton2D, } from './contract';
1
+ export { applyAnimationClipToSkeleton2D, cloneSkeleton2D, computeSkeleton2DBoneMatrices, computeSkeleton2DBoneWorldTransform, computeSkeleton2DBoundingBoxAttachmentVertices, computeSkeleton2DClippingAttachmentVertices, computeSkeleton2DPointAttachmentPosition, computeSkeleton2DPointAttachmentRotation, computeSkeleton2DRegionAttachmentVertices, computeSkeleton2DWorldTransforms, createSkeleton2D, createSkeleton2DBoneAnimationTarget, createSkeleton2DSlotAnimationTarget, deformSkeleton2DMeshAttachment, deformSkeleton2DPathAttachment, disposeSkeleton2D, explainSkeleton2DDeformLength, equalsSkeleton2D, getSkeleton2DBoneIndexByName, getSkeleton2DBoneWorldMatrix, getSkeleton2DClippingAttachmentSlotRange, getSkeleton2DSlotDeformOffsets, registerSkeleton2DAnimationTargetBinder, registerSkeleton2DConstraintSolver, registerSkeleton2DDeformAnimationTarget, registerSkeleton2DIkConstraintSolver, registerSkeleton2DPathConstraintSolver, registerSkeleton2DTransformConstraintSolver, setSkeleton2DBindPose, setSkeleton2DSlotDeform, solveSkeleton2DConstraints, validateSkeleton2D, } from './contract';
2
2
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,6BAA6B,EAC7B,yCAAyC,EACzC,gCAAgC,EAChC,gBAAgB,EAChB,8BAA8B,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,6BAA6B,EAC7B,mCAAmC,EACnC,8CAA8C,EAC9C,2CAA2C,EAC3C,wCAAwC,EACxC,wCAAwC,EACxC,yCAAyC,EACzC,gCAAgC,EAChC,gBAAgB,EAChB,mCAAmC,EACnC,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,EAC7B,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,wCAAwC,EACxC,8BAA8B,EAC9B,uCAAuC,EACvC,kCAAkC,EAClC,uCAAuC,EACvC,oCAAoC,EACpC,sCAAsC,EACtC,2CAA2C,EAC3C,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- export { applyAnimationClipToSkeleton2D, cloneSkeleton2D, computeSkeleton2DBoneMatrices, computeSkeleton2DRegionAttachmentVertices, computeSkeleton2DWorldTransforms, createSkeleton2D, deformSkeleton2DMeshAttachment, disposeSkeleton2D, equalsSkeleton2D, getSkeleton2DBoneIndexByName, getSkeleton2DBoneWorldMatrix, setSkeleton2DBindPose, validateSkeleton2D, } from './contract';
1
+ export { applyAnimationClipToSkeleton2D, cloneSkeleton2D, computeSkeleton2DBoneMatrices, computeSkeleton2DBoneWorldTransform, computeSkeleton2DBoundingBoxAttachmentVertices, computeSkeleton2DClippingAttachmentVertices, computeSkeleton2DPointAttachmentPosition, computeSkeleton2DPointAttachmentRotation, computeSkeleton2DRegionAttachmentVertices, computeSkeleton2DWorldTransforms, createSkeleton2D, createSkeleton2DBoneAnimationTarget, createSkeleton2DSlotAnimationTarget, deformSkeleton2DMeshAttachment, deformSkeleton2DPathAttachment, disposeSkeleton2D, explainSkeleton2DDeformLength, equalsSkeleton2D, getSkeleton2DBoneIndexByName, getSkeleton2DBoneWorldMatrix, getSkeleton2DClippingAttachmentSlotRange, getSkeleton2DSlotDeformOffsets, registerSkeleton2DAnimationTargetBinder, registerSkeleton2DConstraintSolver, registerSkeleton2DDeformAnimationTarget, registerSkeleton2DIkConstraintSolver, registerSkeleton2DPathConstraintSolver, registerSkeleton2DTransformConstraintSolver, setSkeleton2DBindPose, setSkeleton2DSlotDeform, solveSkeleton2DConstraints, validateSkeleton2D, } from './contract';
2
2
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,6BAA6B,EAC7B,yCAAyC,EACzC,gCAAgC,EAChC,gBAAgB,EAChB,8BAA8B,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,8BAA8B,EAC9B,eAAe,EACf,6BAA6B,EAC7B,mCAAmC,EACnC,8CAA8C,EAC9C,2CAA2C,EAC3C,wCAAwC,EACxC,wCAAwC,EACxC,yCAAyC,EACzC,gCAAgC,EAChC,gBAAgB,EAChB,mCAAmC,EACnC,mCAAmC,EACnC,8BAA8B,EAC9B,8BAA8B,EAC9B,iBAAiB,EACjB,6BAA6B,EAC7B,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,wCAAwC,EACxC,8BAA8B,EAC9B,uCAAuC,EACvC,kCAAkC,EAClC,uCAAuC,EACvC,oCAAoC,EACpC,sCAAsC,EACtC,2CAA2C,EAC3C,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Skeleton2D, Skeleton2DConstraint } from '@flighthq/types/contract';
2
+ export declare function registerSkeleton2DPathConstraintSolver(): void;
3
+ export declare function solveSkeleton2DPathConstraint(skeleton: Skeleton2D, constraint: Readonly<Skeleton2DConstraint>): void;
4
+ //# sourceMappingURL=pathConstraint2D.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pathConstraint2D.d.ts","sourceRoot":"","sources":["../src/pathConstraint2D.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,UAAU,EACV,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAsBlC,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAWD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAiFpH"}
@@ -0,0 +1,171 @@
1
+ import { RAD_TO_DEG } from '@flighthq/math/contract';
2
+ import { getPathLength, getPathPositionAtDistance } from '@flighthq/path/contract';
3
+ import { PathAttachment2DKind, Skeleton2DConstraintKind, Skeleton2DPathPositionMode, Skeleton2DPathRotateMode, Skeleton2DPathSpacingMode, } from '@flighthq/types/contract';
4
+ import { deformSkeleton2DPathAttachment } from './deformPathAttachment2D';
5
+ import { computeSkeleton2DBoneWorldTransform } from './skeleton2d';
6
+ import { registerSkeleton2DConstraintSolver } from './skeleton2dConstraint';
7
+ // 6 floats per bone in the flat world-transform buffer (a, b, c, d, tx, ty).
8
+ const MATRIX_STRIDE = 6;
9
+ // Opts a bundle into path constraints. This is the only module in skeleton2d that reaches for
10
+ // `@flighthq/path`, and a consumer that never calls this registrar never imports it — measured, not
11
+ // assumed: a rig bundle importing skeleton2d and nothing path-related is byte-identical (2051 gzip bytes)
12
+ // with and without this module and its package edge present. A package.json edge is a RESOLUTION fact, not
13
+ // a bundle fact, which is why path constraints live here beside the other solvers rather than in a
14
+ // separate cell.
15
+ export function registerSkeleton2DPathConstraintSolver() {
16
+ registerSkeleton2DConstraintSolver(Skeleton2DConstraintKind.Path, solveSkeleton2DPathConstraint);
17
+ }
18
+ // Lays a bone chain along the path attached to the constraint's target slot, writing bone LOCAL
19
+ // transforms and refreshing each bone it moves. Descendants are left for the caller's world pass.
20
+ //
21
+ // The path is deformed into world space first, through the same deformer the display layer uses, so the
22
+ // bones follow the path AS POSED rather than as authored — a path that is itself skinned to bones drags
23
+ // the chain with it, which is the whole point of attaching one to a slot.
24
+ //
25
+ // A missing slot, a non-path attachment, or a zero-length path is skipped: a rig carrying a constraint
26
+ // whose target is not currently wearing a path is an expected state, not an error.
27
+ export function solveSkeleton2DPathConstraint(skeleton, constraint) {
28
+ const pathConstraint = constraint;
29
+ const attachment = resolveSkeleton2DPathAttachment(skeleton, pathConstraint.targetSlotIndex);
30
+ if (attachment === null)
31
+ return;
32
+ const slot = skeleton.slots[pathConstraint.targetSlotIndex];
33
+ deformSkeleton2DPathAttachment(_path, attachment, skeleton, slot.boneIndex);
34
+ const total = getPathLength(_path);
35
+ if (!(total > 0))
36
+ return;
37
+ const bones = skeleton.bones;
38
+ const chain = pathConstraint.boneIndices;
39
+ const mix = pathConstraint.mix;
40
+ const rotateMix = pathConstraint.mixRotate * mix;
41
+ const translateXMix = pathConstraint.mixX * mix;
42
+ const translateYMix = pathConstraint.mixY * mix;
43
+ let distance = pathConstraint.positionMode === Skeleton2DPathPositionMode.Percent
44
+ ? pathConstraint.position * total
45
+ : pathConstraint.position;
46
+ // Chain rotation needs the NEXT bone's position, so every position is sampled before any bone moves.
47
+ // Sampling and writing in one pass would have each bone aim at a sibling that had already been
48
+ // displaced, which bends the chain progressively rather than laying it along the path.
49
+ const count = chain.length;
50
+ if (count === 0)
51
+ return;
52
+ ensureSkeleton2DPathScratch(count);
53
+ for (let i = 0; i < count; i++) {
54
+ const boneIndex = chain[i];
55
+ getPathPositionAtDistance(_path, clampSkeleton2DPathDistance(distance, total), _point, _tangent);
56
+ _positions[i * 2] = _point.x;
57
+ _positions[i * 2 + 1] = _point.y;
58
+ _tangents[i * 2] = _tangent.x;
59
+ _tangents[i * 2 + 1] = _tangent.y;
60
+ distance += resolveSkeleton2DPathSpacing(pathConstraint, boneIndex >= 0 && boneIndex < bones.length ? bones[boneIndex].length : 0, total);
61
+ }
62
+ for (let i = 0; i < count; i++) {
63
+ const boneIndex = chain[i];
64
+ if (boneIndex < 0 || boneIndex >= bones.length)
65
+ continue;
66
+ const bone = bones[boneIndex];
67
+ const o = boneIndex * MATRIX_STRIDE;
68
+ if (translateXMix !== 0 || translateYMix !== 0) {
69
+ const wantedX = world(skeleton, o + 4) + (_positions[i * 2] - world(skeleton, o + 4)) * translateXMix;
70
+ const wantedY = world(skeleton, o + 5) + (_positions[i * 2 + 1] - world(skeleton, o + 5)) * translateYMix;
71
+ const local = toSkeleton2DParentSpace(skeleton, boneIndex, wantedX, wantedY);
72
+ if (local !== null) {
73
+ bone.x = local.x;
74
+ bone.y = local.y;
75
+ }
76
+ computeSkeleton2DBoneWorldTransform(skeleton, boneIndex);
77
+ }
78
+ if (rotateMix !== 0) {
79
+ // Tangent follows the path's own direction; Chain aims at where the next bone was sampled, and the
80
+ // last bone of a chain has no next, so it falls back to the tangent rather than keeping a stale angle.
81
+ let dirX;
82
+ let dirY;
83
+ if (pathConstraint.rotateMode === Skeleton2DPathRotateMode.Chain && i + 1 < count) {
84
+ dirX = _positions[(i + 1) * 2] - _positions[i * 2];
85
+ dirY = _positions[(i + 1) * 2 + 1] - _positions[i * 2 + 1];
86
+ if (dirX === 0 && dirY === 0) {
87
+ dirX = _tangents[i * 2];
88
+ dirY = _tangents[i * 2 + 1];
89
+ }
90
+ }
91
+ else {
92
+ dirX = _tangents[i * 2];
93
+ dirY = _tangents[i * 2 + 1];
94
+ }
95
+ const current = Math.atan2(world(skeleton, o + 1), world(skeleton, o)) * RAD_TO_DEG;
96
+ const wanted = Math.atan2(dirY, dirX) * RAD_TO_DEG;
97
+ bone.rotation += wrapSkeleton2DAngle(wanted - current) * rotateMix;
98
+ computeSkeleton2DBoneWorldTransform(skeleton, boneIndex);
99
+ }
100
+ }
101
+ }
102
+ // Grows the sample buffers to fit a chain, reusing them across calls so a per-frame solve allocates
103
+ // nothing once the longest chain in the rig has been seen.
104
+ function ensureSkeleton2DPathScratch(count) {
105
+ if (_positions.length >= count * 2)
106
+ return;
107
+ _positions = new Float64Array(count * 2);
108
+ _tangents = new Float64Array(count * 2);
109
+ }
110
+ // Clamps rather than wraps: a chain that runs off the end of an open path piles up at the endpoint, which
111
+ // is what a real linkage does, where wrapping would teleport its tail to the other end.
112
+ function clampSkeleton2DPathDistance(distance, total) {
113
+ return distance < 0 ? 0 : distance > total ? total : distance;
114
+ }
115
+ // The slot's attachment when it is a path, or null for a missing slot, an empty slot, or one wearing
116
+ // something else.
117
+ function resolveSkeleton2DPathAttachment(skeleton, slotIndex) {
118
+ const slots = skeleton.slots;
119
+ if (slots === undefined || slots === null)
120
+ return null;
121
+ if (slotIndex < 0 || slotIndex >= slots.length)
122
+ return null;
123
+ const attachment = slots[slotIndex].attachment;
124
+ if (attachment === undefined || attachment === null)
125
+ return null;
126
+ return attachment.kind === PathAttachment2DKind ? attachment : null;
127
+ }
128
+ function resolveSkeleton2DPathSpacing(constraint, boneLength, total) {
129
+ if (constraint.spacingMode === Skeleton2DPathSpacingMode.Percent)
130
+ return constraint.spacing * total;
131
+ if (constraint.spacingMode === Skeleton2DPathSpacingMode.Length)
132
+ return constraint.spacing * boneLength;
133
+ return constraint.spacing;
134
+ }
135
+ // A world point in the space a bone's local transform is expressed in — its parent's.
136
+ function toSkeleton2DParentSpace(skeleton, boneIndex, x, y) {
137
+ const parentIndex = skeleton.bones[boneIndex].parentIndex;
138
+ if (parentIndex < 0)
139
+ return { x, y };
140
+ const matrices = skeleton.worldMatrices;
141
+ const p = parentIndex * MATRIX_STRIDE;
142
+ const a = matrices[p];
143
+ const b = matrices[p + 1];
144
+ const c = matrices[p + 2];
145
+ const d = matrices[p + 3];
146
+ const determinant = a * d - c * b;
147
+ if (Math.abs(determinant) < MINIMUM_DETERMINANT)
148
+ return null;
149
+ const wx = x - matrices[p + 4];
150
+ const wy = y - matrices[p + 5];
151
+ return { x: (d * wx - c * wy) / determinant, y: (a * wy - b * wx) / determinant };
152
+ }
153
+ function world(skeleton, offset) {
154
+ return skeleton.worldMatrices[offset];
155
+ }
156
+ // The shortest signed way round from one angle to another, in degrees.
157
+ function wrapSkeleton2DAngle(degrees) {
158
+ let value = degrees % 360;
159
+ if (value > 180)
160
+ value -= 360;
161
+ else if (value < -180)
162
+ value += 360;
163
+ return value;
164
+ }
165
+ const MINIMUM_DETERMINANT = 1e-9;
166
+ const _path = { commands: [], data: [], winding: 'nonZero' };
167
+ const _point = { x: 0, y: 0 };
168
+ const _tangent = { x: 0, y: 0 };
169
+ let _positions = new Float64Array(0);
170
+ let _tangents = new Float64Array(0);
171
+ //# sourceMappingURL=pathConstraint2D.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pathConstraint2D.js","sourceRoot":"","sources":["../src/pathConstraint2D.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { PointAttachment2D, Skeleton2D, Vector2Like } from '@flighthq/types/contract';
2
+ export declare function computeSkeleton2DPointAttachmentPosition(out: Vector2Like, attachment: Readonly<PointAttachment2D>, skeleton: Readonly<Skeleton2D>, boneIndex: number): void;
3
+ export declare function computeSkeleton2DPointAttachmentRotation(attachment: Readonly<PointAttachment2D>, skeleton: Readonly<Skeleton2D>, boneIndex: number): number;
4
+ //# sourceMappingURL=pointAttachment2D.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pointAttachment2D.d.ts","sourceRoot":"","sources":["../src/pointAttachment2D.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO3F,wBAAgB,wCAAwC,CACtD,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACvC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,IAAI,CAQN;AAOD,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACvC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,CAUR"}
@@ -0,0 +1,34 @@
1
+ import { DEG_TO_RAD, RAD_TO_DEG } from '@flighthq/math/contract';
2
+ // 6 floats per bone in the flat world-transform buffer (a, b, c, d, tx, ty).
3
+ const MATRIX_STRIDE = 6;
4
+ // Writes a point attachment's world position into `out`. Requires `computeSkeleton2DWorldTransforms` to
5
+ // have filled `skeleton.worldMatrices`. Out-parameter, allocation-free.
6
+ export function computeSkeleton2DPointAttachmentPosition(out, attachment, skeleton, boneIndex) {
7
+ const world = skeleton.worldMatrices;
8
+ if (boneIndex < 0 || boneIndex * MATRIX_STRIDE >= world.length)
9
+ return;
10
+ const b = boneIndex * MATRIX_STRIDE;
11
+ const x = attachment.x;
12
+ const y = attachment.y;
13
+ out.x = world[b] * x + world[b + 2] * y + world[b + 4];
14
+ out.y = world[b + 1] * x + world[b + 3] * y + world[b + 5];
15
+ }
16
+ // The point's world direction in DEGREES — its local rotation carried through the bone's world basis.
17
+ //
18
+ // It is derived from the bone's transformed X AXIS rather than by adding the bone's world rotation,
19
+ // because those differ the moment a bone carries non-uniform scale or shear: the axis is where the bone
20
+ // actually points, and the rotation angle is only where it would point if the basis were square. A point
21
+ // naming a muzzle direction on a squashed limb has to follow the axis.
22
+ export function computeSkeleton2DPointAttachmentRotation(attachment, skeleton, boneIndex) {
23
+ const world = skeleton.worldMatrices;
24
+ if (boneIndex < 0 || boneIndex * MATRIX_STRIDE >= world.length)
25
+ return attachment.rotation;
26
+ const b = boneIndex * MATRIX_STRIDE;
27
+ const radians = attachment.rotation * DEG_TO_RAD;
28
+ const cos = Math.cos(radians);
29
+ const sin = Math.sin(radians);
30
+ const x = world[b] * cos + world[b + 2] * sin;
31
+ const y = world[b + 1] * cos + world[b + 3] * sin;
32
+ return Math.atan2(y, x) * RAD_TO_DEG;
33
+ }
34
+ //# sourceMappingURL=pointAttachment2D.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pointAttachment2D.js","sourceRoot":"","sources":["../src/pointAttachment2D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGjE,6EAA6E;AAC7E,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,wGAAwG;AACxG,wEAAwE;AACxE,MAAM,UAAU,wCAAwC,CACtD,GAAgB,EAChB,UAAuC,EACvC,QAA8B,EAC9B,SAAiB;IAEjB,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC;IACrC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,aAAa,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO;IACvE,MAAM,CAAC,GAAG,SAAS,GAAG,aAAa,CAAC;IACpC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACvB,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AACD,sGAAsG;AACtG,EAAE;AACF,oGAAoG;AACpG,wGAAwG;AACxG,yGAAyG;AACzG,uEAAuE;AACvE,MAAM,UAAU,wCAAwC,CACtD,UAAuC,EACvC,QAA8B,EAC9B,SAAiB;IAEjB,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC;IACrC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,aAAa,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC3F,MAAM,CAAC,GAAG,SAAS,GAAG,aAAa,CAAC;IACpC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAC9C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;AACvC,CAAC"}
@@ -1,12 +1,15 @@
1
- import type { Bone2D, MatrixLike, Skeleton2D } from '@flighthq/types/contract';
1
+ import type { AttachmentSkin2D, Bone2D, MatrixLike, Skeleton2D } from '@flighthq/types/contract';
2
2
  export declare function cloneSkeleton2D(skeleton: Readonly<Skeleton2D>): Skeleton2D;
3
3
  export declare function computeSkeleton2DBoneMatrices(skeleton: Readonly<Skeleton2D>): void;
4
+ export declare function computeSkeleton2DBoneWorldTransform(skeleton: Readonly<Skeleton2D>, boneIndex: number): void;
4
5
  export declare function computeSkeleton2DWorldTransforms(skeleton: Readonly<Skeleton2D>): void;
5
6
  export declare function createSkeleton2D(bones: Bone2D[], slots?: Skeleton2D['slots']): Skeleton2D;
6
7
  export declare function disposeSkeleton2D(skeleton: Skeleton2D): void;
7
8
  export declare function equalsSkeleton2D(a: Readonly<Skeleton2D>, b: Readonly<Skeleton2D>): boolean;
8
9
  export declare function getSkeleton2DBoneIndexByName(skeleton: Readonly<Skeleton2D>, name: string): number;
9
10
  export declare function getSkeleton2DBoneWorldMatrix(out: MatrixLike, skeleton: Readonly<Skeleton2D>, boneIndex: number): boolean;
11
+ export declare function getSkeleton2DSkin(skeleton: Readonly<Skeleton2D>, name: string): AttachmentSkin2D | null;
10
12
  export declare function setSkeleton2DBindPose(skeleton: Readonly<Skeleton2D>): void;
13
+ export declare function setSkeleton2DSkin(skeleton: Skeleton2D, skin: Readonly<AttachmentSkin2D>): void;
11
14
  export declare function validateSkeleton2D(skeleton: Readonly<Skeleton2D>): string | null;
12
15
  //# sourceMappingURL=skeleton2d.d.ts.map
@@ -1 +1 @@
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,0BAA0B,CAAC;AAS/E,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"}
1
+ {"version":3,"file":"skeleton2d.d.ts","sourceRoot":"","sources":["../src/skeleton2d.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQjG,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,mCAAmC,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoF3G;AAOD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAGrF;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,CAyB1F;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;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAOvG;AAGD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAU1E;AAeD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAM9F;AAID,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,CAiBhF"}