@melonjs/spine-plugin 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 3.1.0 - _2026-06-14_
+
+### Added
+
+- `Spine.findConstraint(name)` — convenience wrapper around the unified 4.3 constraints list; matches the `findBone()`/`findSlot()` shape and resolves any constraint type (IK, transform, path, physics, Slider) by name. Return type is typed as a union of the five concrete constraint classes (`SpineConstraint` typedef) for `instanceof` narrowing without a cast
+- `Spine.getConstraintNames()` — list all constraint names defined on the skeleton (mirrors `getAnimationNames()`/`getSkinNames()`)
+- spine-core constraint classes re-exported from `@melonjs/spine-plugin` so `instanceof` narrowing of `findConstraint()` results doesn't require a second runtime import (the plugin already owns the spine-core re-export, so identity matches): the new 4.3 Slider classes (`Slider`, `SliderData`, `SliderTimeline`, `SliderMixTimeline`) plus the four pre-existing constraint classes (`IkConstraint`, `TransformConstraint`, `PathConstraint`, `PhysicsConstraint`)
+
+### Fixed
+
+- `setSkeleton()` actually loads binary `.skel` skeletons — was hardcoded to `SkeletonJson` for every input, so passing a `.skel` file (loaded as a `Uint8Array` by the asset manager) threw inside the JSON parser. Now dispatches to `SkeletonBinary` for `.skel` filenames and `SkeletonJson` otherwise. The README and JSDoc have claimed binary support since the original 1.x release; this is the first version where it works. The `spineboy` example in the live preview now loads from `spineboy-pro.skel` to give the binary path continuous coverage
+
+### Chore
+
+- dev deps: `tsx` ^4.21.0 → ^4.22.4, `typescript` ^6.0.2 → ^6.0.3 (no consumer impact — devDependencies aren't installed by npm consumers of the plugin)
+
 ## 3.0.0 - _2026-06-14_
 
 ### **BREAKING CHANGES**

package/README.md

@@ -20,7 +20,8 @@ A [Spine](http://en.esotericsoftware.com/spine-in-depth) 4.x runtime integration
 - **Clipping attachments** via melonJS masking (canvas) and Spine's SkeletonClipping (WebGL)
 - **Skin support** including mix-and-match skin combining via `setCombinedSkin()`
 - **Animation state events** (start, end, complete, event, interrupt, dispose)
-- **Skeleton introspection** — `findBone()`, `findSlot()`, `getAnimationNames()`, `getSkinNames()`
+- **Skeleton introspection** — `findBone()`, `findSlot()`, `findConstraint()`, `getAnimationNames()`, `getSkinNames()`
+- **Spine 4.3 Slider constraints** — full runtime support; all constraint classes (`Slider`/`SliderData`/`SliderTimeline`/`SliderMixTimeline`, plus `IkConstraint`, `TransformConstraint`, `PathConstraint`, `PhysicsConstraint`) re-exported for one-import `instanceof` narrowing of `findConstraint()` results
 - **Animation queuing** — `setAnimation()`, `addAnimation()`, `setEmptyAnimation()`
 - **Debug rendering** for bones, regions, meshes, and clipping areas
 - **Auto-detection** of mesh attachments for optimized canvas rendering (fast path for region-only skeletons)
@@ -109,9 +110,38 @@ me.loader.preload(DataManifest, function() {
 |---|---|
 | `findBone(boneName)` | Find a bone by name |
 | `findSlot(slotName)` | Find a slot by name |
+| `findConstraint(constraintName)` | Find a constraint by name (IK / Transform / Path / Physics / **Slider**) — added in 3.1.0 |
+| `getConstraintNames()` | Get the list of constraint names available in the skeleton — added in 3.1.0 |
 | `setToSetupPose()` | Reset skeleton to setup pose |
 | `setSkeleton(atlasFile, jsonFile)` | Load a skeleton (if not set via constructor) |
 
+### Spine 4.3 Slider constraints
+
+Spine 4.3 introduced [Slider constraints](https://esotericsoftware.com/blog/Spine-4.3-released#slider-constraints) — a pre-baked animation indexed by a numeric `time` value, optionally driven by a bone's rotation. The plugin re-exports the Spine runtime's Slider classes (and the four pre-existing constraint classes) alongside the default `Spine` export so consumers can do `instanceof Slider` (or `instanceof IkConstraint`, etc.) without a second import from `@esotericsoftware/spine-core`:
+
+```javascript
+import Spine, {
+    // 4.3 Slider classes
+    Slider, SliderData, SliderTimeline, SliderMixTimeline,
+    // other constraint classes — for narrowing findConstraint() results
+    IkConstraint, TransformConstraint, PathConstraint, PhysicsConstraint,
+} from "@melonjs/spine-plugin";
+
+const diamond = new Spine(750, 600, { atlasFile: "diamond-pma.atlas", jsonFile: "diamond-pro.json" });
+diamond.setAnimation(0, "idle-rotating", true);
+
+// query the "rotation" Slider constraint
+const slider = diamond.findConstraint("rotation");
+if (slider instanceof Slider) {
+    // scrub a slider manually (disable bone auto-driving first)
+    slider.bone = null;
+    slider.pose.time = 1.0;   // jump to t=1s in the slider's animation
+    slider.pose.mix = 1.0;    // 0..1 — how much of the slider pose to apply
+}
+```
+
+See the [diamond example](https://melonjs.github.io/melonJS/examples/#/spine) for an interactive demo.
+
 ### Transform
 | Method | Description |
 |---|---|
@@ -125,12 +155,12 @@ me.loader.preload(DataManifest, function() {
 
 | @melonjs/spine-plugin | melonJS | spine-runtime |
 |---|---|---|
-| v3.0.0 | v19.7.1 (or higher) | v4.3.x |
-| v2.2.0 | v18.3.0 (or higher) | v4.2.x |
-| v2.1.0 | v18.3.0 (or higher) | v4.2.x |
-| v2.0.1 | v18.2.1 (or higher) | v4.2.x |
-| v2.0.0 | v18.2.0 | v4.2.x |
-| v1.5.x | v15.12.x — v18.0.x | v4.1, v4.2-beta |
+| v3.x.x | v19.7.1 (or higher) | v4.3.x |
+| v2.2.x | v18.3.0 (or higher) | v4.2.x |
+| v2.1.x | v18.3.0 (or higher) | v4.2.x |
+| v2.0.x | v18.2.1 (or higher) | v4.2.x |
+| v2.0.0 | v18.2.0 (or higher) | v4.2.x |
+| v1.5.x | v15.12.0 (or higher)| v4.1, v4.2-beta |
 
 > **Note:** skeleton data is editor-version locked — plugin 3.x requires assets exported from a Spine **4.3** editor; 4.2 exports will not load (and vice-versa on plugin 2.x).
 

package/build/Spine.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Union of the five concrete constraint classes Spine 4.3 exposes via
+ * `skeleton.constraints` — returned by {@link Spine.findConstraint}.
+ * Narrow with `instanceof` against the corresponding re-export
+ * (`Slider`, `IkConstraint`, etc. from this plugin or
+ * `@esotericsoftware/spine-core`).
+ * @typedef {import("@esotericsoftware/spine-core").Slider
+ *   | import("@esotericsoftware/spine-core").IkConstraint
+ *   | import("@esotericsoftware/spine-core").TransformConstraint
+ *   | import("@esotericsoftware/spine-core").PathConstraint
+ *   | import("@esotericsoftware/spine-core").PhysicsConstraint
+ * } SpineConstraint
+ */
 /**
  * @classdesc
  * A renderable object to render Spine animated skeleton.
@@ -262,6 +275,29 @@ export default class Spine extends Renderable {
      * @returns {Slot|null} the slot, or null if not found
      */
     findSlot(slotName: string): Slot | null;
+    /**
+     * Find a constraint (Slider, IK, transform, path, or physics) by name.
+     * Convenience wrapper around the 4.3 unified constraints list — like
+     * {@link findBone}/{@link findSlot} but for any constraint type.
+     *
+     * Returns the constraint instance whose `data.name` matches; use
+     * `instanceof Slider` (etc., re-exported by this plugin) to narrow
+     * the type if you need the constraint's specific pose API.
+     * @param {string} constraintName - the constraint name
+     * @returns {SpineConstraint|null} the constraint, or null if not found
+     * @example
+     * // drive a Slider constraint manually (4.3+)
+     * const rot = spine.findConstraint("rotation");
+     * rot.pose.time = 1.5;   // animation seconds; loops if `loop: true`
+     * rot.pose.mix = 1.0;    // 0..1+ — blend toward the constrained pose
+     */
+    findConstraint(constraintName: string): SpineConstraint | null;
+    /**
+     * Get the list of constraint names available in this skeleton
+     * (Slider, IK, transform, path, physics — 4.3 unified list).
+     * @returns {string[]} array of constraint names
+     */
+    getConstraintNames(): string[];
     /**
      * Register a listener for animation state events.
      * @param {object} listener - an object with event handler methods
@@ -309,6 +345,14 @@ export default class Spine extends Renderable {
      */
     setToSetupPose(): void;
 }
+/**
+ * Union of the five concrete constraint classes Spine 4.3 exposes via
+ * `skeleton.constraints` — returned by {@link Spine.findConstraint}.
+ * Narrow with `instanceof` against the corresponding re-export
+ * (`Slider`, `IkConstraint`, etc. from this plugin or
+ * `@esotericsoftware/spine-core`).
+ */
+export type SpineConstraint = import("@esotericsoftware/spine-core").Slider | import("@esotericsoftware/spine-core").IkConstraint | import("@esotericsoftware/spine-core").TransformConstraint | import("@esotericsoftware/spine-core").PathConstraint | import("@esotericsoftware/spine-core").PhysicsConstraint;
 import { Renderable } from "melonjs";
 import * as spineWebGL from "@esotericsoftware/spine-webgl";
 import * as spineCanvas from "@esotericsoftware/spine-canvas";

package/build/Spine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Spine.d.ts","sourceRoot":"","sources":["../src/Spine.js"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH;IAkCC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,eApCW,MAAM,KACN,MAAM,YAEd;QAA0B,SAAS;QACT,QAAQ;QACR,OAAO;KACjC,EA6FF;IArID,gDAAQ;IACR,cAAS;IACT,0BAAO;IACP,oBAAe;IACf,iEAAiB;IACjB,UAAK;IACL,gCAAW;IACX,8BAAS;IACT;;;MAGE;IAEF;;;;;;;;;;;;;;;;;OAiBG;IACH,cAhBU,UAAU,CAgBP;IAmDZ,cAAc;IACd,iBAAyC;IAWxC,kBAAkD;IASlD,4CAA6D;IAC7D,6CAAuD;IACvD,oEAEC;IAmBF,gBAAsC;IAGrC,6BAAiC;IACjC,8BAAmC;IAcrC,0BANU,OAAO,EAQhB;IAXD;;;;OAIG;IACH,sBAFU,OAAO,CAIhB;IAMD;;;;;;;;;;;;;;;;;OAiBG;IACH,uBAfW,MAAM,YACN,MAAM,QAsDhB;IA9BA,wBAEE;IA8BH;;;;OAIG;IACH,aAHW,OAAO,GACL,KAAK,CASjB;IAED;;;;OAIG;IACH,aAHW,OAAO,GACL,KAAK,CASjB;IAED;;;;;OAKG;IACH,cAJW,MAAM,MACN,QAAQ,GAAC,kBAAkB,GACzB,KAAK,CAMjB;IAED;;;;;OAKG;IACH,SAJW,MAAM,MACN,MAAM,GACJ,KAAK,CAWjB;IAmFD;;;;;;OAMG;IACH,eAFW,cAAc,GAAC,aAAa,QA4CtC;IAED;;;OAGG;IACH,gBAMC;IAED;;;;OAIG;IACH,uBAEC;IAED;;;;;;OAMG;IACH,gCALW,MAAM,SACN,MAAM,SACN,OAAO,GACL,UAAU,CAYtB;IAED;;;;;;;;;OASG;IACH,yBARW,MAAM,QACN,MAAM,SACN,OAAO,GACL,UAAU,CAYtB;IAED;;;;;;;;OAQG;IACH,yBAPW,MAAM,GACJ,OAAO,CAWnB;IAED;;;;;;;OAOG;IACH,gCANW,MAAM,SACN,MAAM,SACN,OAAO,UACP,MAAM,GACJ,UAAU,CAatB;IAED;;;;;;;OAOG;IACH,yBANW,MAAM,QACN,MAAM,SACN,OAAO,UACP,MAAM,GACJ,UAAU,CAItB;IAED;;;OAGG;IACH,2BAFW,MAAM,QAIhB;IAED;;;;;OAKG;IACH,qCAJW,MAAM,mBACN,MAAM,WACN,MAAM,QAIhB;IAED;;;;;;;;;;;;;;;OAeG;IACH,wBAdW,MAAM,QAgBhB;IAED;;;;;;;OAOG;IACH,8BANW,MAAM,gBACH,MAAM,EAAA,QAkBnB;IAED;;;;;OAKG;IACH,8BAJW,MAAM,gBACN,MAAM,GACJ,UAAU,CAItB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,IAAI,GAAC,IAAI,CAIrB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,IAAI,GAAC,IAAI,CAIrB;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,+BAhBG;QAA4B,KAAK;QACL,SAAS;QACT,GAAG;QACH,OAAO;QACP,QAAQ;QACR,KAAK;KACjC,QAYF;IAED;;;OAGG;IACH,kCAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,qBAFa,MAAM,EAAE,CAMpB;IAED;;;OAGG;IACH,gBAFa,MAAM,EAAE,CAMpB;IAED;;OAEG;IACH,uBAUC;CACD;2BAxqBwC,SAAS;4BADtB,+BAA+B;6BAP9B,gCAAgC;uBAQpB,SAAS;6BAErB,uBAAuB"}
+{"version":3,"file":"Spine.d.ts","sourceRoot":"","sources":["../src/Spine.js"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -1,3 +1,4 @@
 export { SpinePlugin } from "./SpinePlugin.js";
+export { IkConstraint, PathConstraint, PhysicsConstraint, Slider, SliderData, SliderMixTimeline, SliderTimeline, TransformConstraint } from "@esotericsoftware/spine-core";
 export { default, default as Spine } from "./Spine.js";
 //# sourceMappingURL=index.d.ts.map

package/build/index.js

@@ -1,5 +1,5 @@
 /*!
- * melonJS Spine plugin - 3.0.0
+ * melonJS Spine plugin - 3.1.0
  * http://www.melonjs.org
  * @melonjs/spine-plugin is licensed under the MIT License.
  * http://www.opensource.org/licenses/mit-license
@@ -11,175 +11,6 @@ var __export = (target, all) => {
     __defProp(target, name2, { get: all[name2], enumerable: true });
 };
 
-// ../../node_modules/.pnpm/@esotericsoftware+spine-canvas@4.3.7/node_modules/@esotericsoftware/spine-canvas/dist/index.js
-var dist_exports = {};
-__export(dist_exports, {
-  ATTACH_RETAIN: () => ATTACH_RETAIN,
-  ATTACH_SETUP: () => ATTACH_SETUP,
-  AlphaTimeline: () => AlphaTimeline,
-  Animation: () => Animation,
-  AnimationState: () => AnimationState,
-  AnimationStateAdapter: () => AnimationStateAdapter,
-  AnimationStateData: () => AnimationStateData,
-  AssetCache: () => AssetCache,
-  AssetManager: () => AssetManager,
-  AssetManagerBase: () => AssetManagerBase,
-  AtlasAttachmentLoader: () => AtlasAttachmentLoader,
-  Attachment: () => Attachment,
-  AttachmentTimeline: () => AttachmentTimeline,
-  BinaryInput: () => BinaryInput,
-  BlendMode: () => BlendMode,
-  Bone: () => Bone,
-  BoneData: () => BoneData,
-  BonePose: () => BonePose,
-  BoneTimeline1: () => BoneTimeline1,
-  BoneTimeline2: () => BoneTimeline2,
-  BoundingBoxAttachment: () => BoundingBoxAttachment,
-  CURRENT: () => CURRENT,
-  CanvasTexture: () => CanvasTexture,
-  ClippingAttachment: () => ClippingAttachment,
-  Color: () => Color,
-  Constraint: () => Constraint,
-  ConstraintData: () => ConstraintData,
-  ConstraintTimeline1: () => ConstraintTimeline1,
-  CurveTimeline: () => CurveTimeline,
-  CurveTimeline1: () => CurveTimeline1,
-  DebugUtils: () => DebugUtils,
-  DeformTimeline: () => DeformTimeline,
-  Downloader: () => Downloader,
-  DrawOrder: () => DrawOrder,
-  DrawOrderFolderTimeline: () => DrawOrderFolderTimeline,
-  DrawOrderTimeline: () => DrawOrderTimeline,
-  Event: () => Event,
-  EventData: () => EventData,
-  EventQueue: () => EventQueue,
-  EventTimeline: () => EventTimeline,
-  EventType: () => EventType,
-  FIRST: () => FIRST,
-  FakeTexture: () => FakeTexture,
-  FromProperty: () => FromProperty,
-  FromRotate: () => FromRotate,
-  FromScaleX: () => FromScaleX,
-  FromScaleY: () => FromScaleY,
-  FromShearY: () => FromShearY,
-  FromX: () => FromX,
-  FromY: () => FromY,
-  HOLD: () => HOLD,
-  IkConstraint: () => IkConstraint,
-  IkConstraintData: () => IkConstraintData,
-  IkConstraintPose: () => IkConstraintPose,
-  IkConstraintTimeline: () => IkConstraintTimeline,
-  Inherit: () => Inherit,
-  InheritTimeline: () => InheritTimeline,
-  IntSet: () => IntSet,
-  Interpolation: () => Interpolation,
-  MODE: () => MODE,
-  MathUtils: () => MathUtils,
-  MeshAttachment: () => MeshAttachment,
-  MixFrom: () => MixFrom,
-  PathAttachment: () => PathAttachment,
-  PathConstraint: () => PathConstraint,
-  PathConstraintData: () => PathConstraintData,
-  PathConstraintMixTimeline: () => PathConstraintMixTimeline,
-  PathConstraintPose: () => PathConstraintPose,
-  PathConstraintPositionTimeline: () => PathConstraintPositionTimeline,
-  PathConstraintSpacingTimeline: () => PathConstraintSpacingTimeline,
-  Physics: () => Physics,
-  PhysicsConstraint: () => PhysicsConstraint,
-  PhysicsConstraintDampingTimeline: () => PhysicsConstraintDampingTimeline,
-  PhysicsConstraintData: () => PhysicsConstraintData,
-  PhysicsConstraintGravityTimeline: () => PhysicsConstraintGravityTimeline,
-  PhysicsConstraintInertiaTimeline: () => PhysicsConstraintInertiaTimeline,
-  PhysicsConstraintMassTimeline: () => PhysicsConstraintMassTimeline,
-  PhysicsConstraintMixTimeline: () => PhysicsConstraintMixTimeline,
-  PhysicsConstraintPose: () => PhysicsConstraintPose,
-  PhysicsConstraintResetTimeline: () => PhysicsConstraintResetTimeline,
-  PhysicsConstraintStrengthTimeline: () => PhysicsConstraintStrengthTimeline,
-  PhysicsConstraintTimeline: () => PhysicsConstraintTimeline,
-  PhysicsConstraintWindTimeline: () => PhysicsConstraintWindTimeline,
-  PointAttachment: () => PointAttachment,
-  Pool: () => Pool,
-  Posed: () => Posed,
-  PosedActive: () => PosedActive,
-  PosedData: () => PosedData,
-  PositionMode: () => PositionMode,
-  Pow: () => Pow,
-  PowOut: () => PowOut,
-  Property: () => Property,
-  RGB2Timeline: () => RGB2Timeline,
-  RGBA2Timeline: () => RGBA2Timeline,
-  RGBATimeline: () => RGBATimeline,
-  RGBTimeline: () => RGBTimeline,
-  RegionAttachment: () => RegionAttachment,
-  RotateMode: () => RotateMode,
-  RotateTimeline: () => RotateTimeline,
-  SETUP: () => SETUP,
-  ScaleTimeline: () => ScaleTimeline,
-  ScaleXTimeline: () => ScaleXTimeline,
-  ScaleYMode: () => ScaleYMode,
-  ScaleYTimeline: () => ScaleYTimeline,
-  Sequence: () => Sequence,
-  SequenceMode: () => SequenceMode,
-  SequenceModeValues: () => SequenceModeValues,
-  SequenceTimeline: () => SequenceTimeline,
-  ShearTimeline: () => ShearTimeline,
-  ShearXTimeline: () => ShearXTimeline,
-  ShearYTimeline: () => ShearYTimeline,
-  Skeleton: () => Skeleton,
-  SkeletonBinary: () => SkeletonBinary,
-  SkeletonBounds: () => SkeletonBounds,
-  SkeletonClipping: () => SkeletonClipping,
-  SkeletonData: () => SkeletonData,
-  SkeletonJson: () => SkeletonJson,
-  SkeletonRenderer: () => SkeletonRenderer,
-  SkeletonRendererCore: () => SkeletonRendererCore,
-  Skin: () => Skin,
-  SkinEntry: () => SkinEntry,
-  Slider: () => Slider,
-  SliderData: () => SliderData,
-  SliderMixTimeline: () => SliderMixTimeline,
-  SliderPose: () => SliderPose,
-  SliderTimeline: () => SliderTimeline,
-  Slot: () => Slot,
-  SlotCurveTimeline: () => SlotCurveTimeline,
-  SlotData: () => SlotData,
-  SlotPose: () => SlotPose,
-  SpacingMode: () => SpacingMode,
-  StringSet: () => StringSet,
-  Texture: () => Texture,
-  TextureAtlas: () => TextureAtlas,
-  TextureAtlasPage: () => TextureAtlasPage,
-  TextureAtlasRegion: () => TextureAtlasRegion,
-  TextureFilter: () => TextureFilter,
-  TextureRegion: () => TextureRegion,
-  TextureWrap: () => TextureWrap,
-  TimeKeeper: () => TimeKeeper,
-  Timeline: () => Timeline,
-  ToProperty: () => ToProperty,
-  ToRotate: () => ToRotate,
-  ToScaleX: () => ToScaleX,
-  ToScaleY: () => ToScaleY,
-  ToShearY: () => ToShearY,
-  ToX: () => ToX,
-  ToY: () => ToY,
-  TrackEntry: () => TrackEntry,
-  TransformConstraint: () => TransformConstraint,
-  TransformConstraintData: () => TransformConstraintData,
-  TransformConstraintPose: () => TransformConstraintPose,
-  TransformConstraintTimeline: () => TransformConstraintTimeline,
-  TranslateTimeline: () => TranslateTimeline,
-  TranslateXTimeline: () => TranslateXTimeline,
-  TranslateYTimeline: () => TranslateYTimeline,
-  Triangulator: () => Triangulator,
-  Utils: () => Utils,
-  Vector2: () => Vector2,
-  VertexAttachment: () => VertexAttachment,
-  WindowedMean: () => WindowedMean,
-  isBoneTimeline: () => isBoneTimeline,
-  isConstraintTimeline: () => isConstraintTimeline,
-  isSlotTimeline: () => isSlotTimeline
-});
-
 // ../../node_modules/.pnpm/@esotericsoftware+spine-core@4.3.7/node_modules/@esotericsoftware/spine-core/dist/Utils.js
 var IntSet = class {
   array = [];
@@ -13681,6 +13512,175 @@ var CommandPool = class {
   }
 };
 
+// ../../node_modules/.pnpm/@esotericsoftware+spine-canvas@4.3.7/node_modules/@esotericsoftware/spine-canvas/dist/index.js
+var dist_exports = {};
+__export(dist_exports, {
+  ATTACH_RETAIN: () => ATTACH_RETAIN,
+  ATTACH_SETUP: () => ATTACH_SETUP,
+  AlphaTimeline: () => AlphaTimeline,
+  Animation: () => Animation,
+  AnimationState: () => AnimationState,
+  AnimationStateAdapter: () => AnimationStateAdapter,
+  AnimationStateData: () => AnimationStateData,
+  AssetCache: () => AssetCache,
+  AssetManager: () => AssetManager,
+  AssetManagerBase: () => AssetManagerBase,
+  AtlasAttachmentLoader: () => AtlasAttachmentLoader,
+  Attachment: () => Attachment,
+  AttachmentTimeline: () => AttachmentTimeline,
+  BinaryInput: () => BinaryInput,
+  BlendMode: () => BlendMode,
+  Bone: () => Bone,
+  BoneData: () => BoneData,
+  BonePose: () => BonePose,
+  BoneTimeline1: () => BoneTimeline1,
+  BoneTimeline2: () => BoneTimeline2,
+  BoundingBoxAttachment: () => BoundingBoxAttachment,
+  CURRENT: () => CURRENT,
+  CanvasTexture: () => CanvasTexture,
+  ClippingAttachment: () => ClippingAttachment,
+  Color: () => Color,
+  Constraint: () => Constraint,
+  ConstraintData: () => ConstraintData,
+  ConstraintTimeline1: () => ConstraintTimeline1,
+  CurveTimeline: () => CurveTimeline,
+  CurveTimeline1: () => CurveTimeline1,
+  DebugUtils: () => DebugUtils,
+  DeformTimeline: () => DeformTimeline,
+  Downloader: () => Downloader,
+  DrawOrder: () => DrawOrder,
+  DrawOrderFolderTimeline: () => DrawOrderFolderTimeline,
+  DrawOrderTimeline: () => DrawOrderTimeline,
+  Event: () => Event,
+  EventData: () => EventData,
+  EventQueue: () => EventQueue,
+  EventTimeline: () => EventTimeline,
+  EventType: () => EventType,
+  FIRST: () => FIRST,
+  FakeTexture: () => FakeTexture,
+  FromProperty: () => FromProperty,
+  FromRotate: () => FromRotate,
+  FromScaleX: () => FromScaleX,
+  FromScaleY: () => FromScaleY,
+  FromShearY: () => FromShearY,
+  FromX: () => FromX,
+  FromY: () => FromY,
+  HOLD: () => HOLD,
+  IkConstraint: () => IkConstraint,
+  IkConstraintData: () => IkConstraintData,
+  IkConstraintPose: () => IkConstraintPose,
+  IkConstraintTimeline: () => IkConstraintTimeline,
+  Inherit: () => Inherit,
+  InheritTimeline: () => InheritTimeline,
+  IntSet: () => IntSet,
+  Interpolation: () => Interpolation,
+  MODE: () => MODE,
+  MathUtils: () => MathUtils,
+  MeshAttachment: () => MeshAttachment,
+  MixFrom: () => MixFrom,
+  PathAttachment: () => PathAttachment,
+  PathConstraint: () => PathConstraint,
+  PathConstraintData: () => PathConstraintData,
+  PathConstraintMixTimeline: () => PathConstraintMixTimeline,
+  PathConstraintPose: () => PathConstraintPose,
+  PathConstraintPositionTimeline: () => PathConstraintPositionTimeline,
+  PathConstraintSpacingTimeline: () => PathConstraintSpacingTimeline,
+  Physics: () => Physics,
+  PhysicsConstraint: () => PhysicsConstraint,
+  PhysicsConstraintDampingTimeline: () => PhysicsConstraintDampingTimeline,
+  PhysicsConstraintData: () => PhysicsConstraintData,
+  PhysicsConstraintGravityTimeline: () => PhysicsConstraintGravityTimeline,
+  PhysicsConstraintInertiaTimeline: () => PhysicsConstraintInertiaTimeline,
+  PhysicsConstraintMassTimeline: () => PhysicsConstraintMassTimeline,
+  PhysicsConstraintMixTimeline: () => PhysicsConstraintMixTimeline,
+  PhysicsConstraintPose: () => PhysicsConstraintPose,
+  PhysicsConstraintResetTimeline: () => PhysicsConstraintResetTimeline,
+  PhysicsConstraintStrengthTimeline: () => PhysicsConstraintStrengthTimeline,
+  PhysicsConstraintTimeline: () => PhysicsConstraintTimeline,
+  PhysicsConstraintWindTimeline: () => PhysicsConstraintWindTimeline,
+  PointAttachment: () => PointAttachment,
+  Pool: () => Pool,
+  Posed: () => Posed,
+  PosedActive: () => PosedActive,
+  PosedData: () => PosedData,
+  PositionMode: () => PositionMode,
+  Pow: () => Pow,
+  PowOut: () => PowOut,
+  Property: () => Property,
+  RGB2Timeline: () => RGB2Timeline,
+  RGBA2Timeline: () => RGBA2Timeline,
+  RGBATimeline: () => RGBATimeline,
+  RGBTimeline: () => RGBTimeline,
+  RegionAttachment: () => RegionAttachment,
+  RotateMode: () => RotateMode,
+  RotateTimeline: () => RotateTimeline,
+  SETUP: () => SETUP,
+  ScaleTimeline: () => ScaleTimeline,
+  ScaleXTimeline: () => ScaleXTimeline,
+  ScaleYMode: () => ScaleYMode,
+  ScaleYTimeline: () => ScaleYTimeline,
+  Sequence: () => Sequence,
+  SequenceMode: () => SequenceMode,
+  SequenceModeValues: () => SequenceModeValues,
+  SequenceTimeline: () => SequenceTimeline,
+  ShearTimeline: () => ShearTimeline,
+  ShearXTimeline: () => ShearXTimeline,
+  ShearYTimeline: () => ShearYTimeline,
+  Skeleton: () => Skeleton,
+  SkeletonBinary: () => SkeletonBinary,
+  SkeletonBounds: () => SkeletonBounds,
+  SkeletonClipping: () => SkeletonClipping,
+  SkeletonData: () => SkeletonData,
+  SkeletonJson: () => SkeletonJson,
+  SkeletonRenderer: () => SkeletonRenderer,
+  SkeletonRendererCore: () => SkeletonRendererCore,
+  Skin: () => Skin,
+  SkinEntry: () => SkinEntry,
+  Slider: () => Slider,
+  SliderData: () => SliderData,
+  SliderMixTimeline: () => SliderMixTimeline,
+  SliderPose: () => SliderPose,
+  SliderTimeline: () => SliderTimeline,
+  Slot: () => Slot,
+  SlotCurveTimeline: () => SlotCurveTimeline,
+  SlotData: () => SlotData,
+  SlotPose: () => SlotPose,
+  SpacingMode: () => SpacingMode,
+  StringSet: () => StringSet,
+  Texture: () => Texture,
+  TextureAtlas: () => TextureAtlas,
+  TextureAtlasPage: () => TextureAtlasPage,
+  TextureAtlasRegion: () => TextureAtlasRegion,
+  TextureFilter: () => TextureFilter,
+  TextureRegion: () => TextureRegion,
+  TextureWrap: () => TextureWrap,
+  TimeKeeper: () => TimeKeeper,
+  Timeline: () => Timeline,
+  ToProperty: () => ToProperty,
+  ToRotate: () => ToRotate,
+  ToScaleX: () => ToScaleX,
+  ToScaleY: () => ToScaleY,
+  ToShearY: () => ToShearY,
+  ToX: () => ToX,
+  ToY: () => ToY,
+  TrackEntry: () => TrackEntry,
+  TransformConstraint: () => TransformConstraint,
+  TransformConstraintData: () => TransformConstraintData,
+  TransformConstraintPose: () => TransformConstraintPose,
+  TransformConstraintTimeline: () => TransformConstraintTimeline,
+  TranslateTimeline: () => TranslateTimeline,
+  TranslateXTimeline: () => TranslateXTimeline,
+  TranslateYTimeline: () => TranslateYTimeline,
+  Triangulator: () => Triangulator,
+  Utils: () => Utils,
+  Vector2: () => Vector2,
+  VertexAttachment: () => VertexAttachment,
+  WindowedMean: () => WindowedMean,
+  isBoneTimeline: () => isBoneTimeline,
+  isConstraintTimeline: () => isConstraintTimeline,
+  isSlotTimeline: () => isSlotTimeline
+});
+
 // ../../node_modules/.pnpm/@esotericsoftware+spine-canvas@4.3.7/node_modules/@esotericsoftware/spine-canvas/dist/CanvasTexture.js
 var CanvasTexture = class extends Texture {
   constructor(image) {
@@ -17312,7 +17312,7 @@ import { plugin, registerTiledObjectClass } from "melonjs";
 
 // package.json
 var name = "@melonjs/spine-plugin";
-var version = "3.0.0";
+var version = "3.1.0";
 var homepage = "https://www.npmjs.com/package/@melonjs/spine-plugin";
 var peerDependencies = {
   melonjs: ">=19.7.1"
@@ -17608,8 +17608,9 @@ var Spine = class extends Renderable2 {
   setSkeleton(atlasFile, jsonFile) {
     const atlas = this.plugin.assetManager.require(atlasFile);
     const atlasLoader = new this.runtime.AtlasAttachmentLoader(atlas);
-    const skeletonJson = new this.runtime.SkeletonJson(atlasLoader);
-    const skeletonData = skeletonJson.readSkeletonData(
+    const isBinary = jsonFile.endsWith(".skel");
+    const skeletonReader = isBinary ? new this.runtime.SkeletonBinary(atlasLoader) : new this.runtime.SkeletonJson(atlasLoader);
+    const skeletonData = skeletonReader.readSkeletonData(
       this.plugin.assetManager.require(jsonFile)
     );
     this.premultipliedAlpha = atlas.pages.some((page) => {
@@ -17958,6 +17959,41 @@ var Spine = class extends Renderable2 {
   findSlot(slotName) {
     return this.skeleton.findSlot(slotName);
   }
+  /**
+   * Find a constraint (Slider, IK, transform, path, or physics) by name.
+   * Convenience wrapper around the 4.3 unified constraints list — like
+   * {@link findBone}/{@link findSlot} but for any constraint type.
+   *
+   * Returns the constraint instance whose `data.name` matches; use
+   * `instanceof Slider` (etc., re-exported by this plugin) to narrow
+   * the type if you need the constraint's specific pose API.
+   * @param {string} constraintName - the constraint name
+   * @returns {SpineConstraint|null} the constraint, or null if not found
+   * @example
+   * // drive a Slider constraint manually (4.3+)
+   * const rot = spine.findConstraint("rotation");
+   * rot.pose.time = 1.5;   // animation seconds; loops if `loop: true`
+   * rot.pose.mix = 1.0;    // 0..1+ — blend toward the constrained pose
+   */
+  findConstraint(constraintName) {
+    const constraints = this.skeleton.constraints;
+    for (let i = 0, n = constraints.length; i < n; i++) {
+      if (constraints[i].data.name === constraintName) {
+        return constraints[i];
+      }
+    }
+    return null;
+  }
+  /**
+   * Get the list of constraint names available in this skeleton
+   * (Slider, IK, transform, path, physics — 4.3 unified list).
+   * @returns {string[]} array of constraint names
+   */
+  getConstraintNames() {
+    return this.skeleton.constraints.map((c) => {
+      return c.data.name;
+    });
+  }
   /**
    * Register a listener for animation state events.
    * @param {object} listener - an object with event handler methods
@@ -18018,8 +18054,16 @@ var Spine = class extends Renderable2 {
   }
 };
 export {
+  IkConstraint,
+  PathConstraint,
+  PhysicsConstraint,
+  Slider,
+  SliderData,
+  SliderMixTimeline,
+  SliderTimeline,
   Spine,
   SpinePlugin,
+  TransformConstraint,
   Spine as default
 };
 //# sourceMappingURL=index.js.map