@needle-tools/three-animation-pointer 1.0.0-next.3b7dc2f → 1.0.0-next.6ca715c

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+All notable changes to this package will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-08-27
+- Initial release

package/README.md

@@ -2,6 +2,34 @@
 
 This package adds a [three.js](https://github.com/mrdoob/three.js) GLTFLoader plugin for [KHR_animation_pointer](https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_animation_pointer) support.
 
+### Usage
+
+Install the package:   
+`npm i @needle-tools/three-animation-pointer`
+
+
+Register the plugin on your GLTFLoader:  
+
+```js
+import { GLTFAnimationPointerExtension } from "@needle-tools/three-animation-pointer"
+
+const loader = new GLTFLoader();
+loader.register(p => {
+    return new GLTFAnimationPointerExtension(p);
+}
+```
+
 ## Links
 
-- [three.js PR #24108](https://github.com/mrdoob/three.js/pull/24108)
+- [Khronos KHR_animation_pointer spec](https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_animation_pointer)
+- [three.js repository PR #24108](https://github.com/mrdoob/three.js/pull/24108)
+
+
+
+# Contact ✒️
+<b>[🌵 Needle](https://needle.tools)</b> • 
+[Github](https://github.com/needle-tools) • 
+[Twitter](https://twitter.com/NeedleTools) • 
+[Discord](https://discord.needle.tools) • 
+[Forum](https://forum.needle.tools) • 
+[Youtube](https://www.youtube.com/@needle-tools)

package/index.js

@@ -0,0 +1,5 @@
+import { GLTFAnimationPointerExtension } from "./src/GLTFLoaderAnimationPointer.js"
+
+export * from "./src/GLTFLoaderAnimationPointer.js"
+
+export default GLTFAnimationPointerExtension;

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@needle-tools/three-animation-pointer",
-  "version": "1.0.0-next.3b7dc2f",
+  "version": "1.0.0-next.6ca715c",
   "description": "KHR_animation_pointer support for three.js",
   "type": "module",
-  "main": "src/index.js",
+  "main": "index.js",
   "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./index.js",
+      "require": "./index.js"
+    }
+  },
   "files": [
     "src",
     "types",
@@ -19,7 +25,7 @@
     "url": "https://needle.tools/"
   },
   "repository": {
-    "url": "https://github.com/needle-tools/three-animationpointer"
+    "url": "https://github.com/needle-tools/three-animation-pointer"
   },
   "license": "MIT",
   "devDependencies": {

package/src/GLTFLoaderAnimationPointer.js

@@ -11,7 +11,7 @@ import {
 } from 'three';
 
 /** 
- * @typedef {import("three/examples/jsm/loaders/GLTFLoader").GLTFLoaderPlugin} GLTFLoaderPlugin 
+ * @typedef {import("..").GLTFAnimationPointerExtension} PluginType 
  */
 
 // DUPLICATED from GLTFLoader.js
@@ -41,7 +41,7 @@ const _animationPointerDebug = false;
  *
  * Draft Specification: https://github.com/ux3d/glTF/tree/extensions/KHR_animation_pointer/extensions/2.0/Khronos/KHR_animation_pointer
  * 
- * @implements {GLTFLoaderPlugin}
+ * @implements {PluginType}
  */
 export class GLTFAnimationPointerExtension {
 
@@ -339,7 +339,7 @@ export class GLTFAnimationPointerExtension {
 
 		}
 
-		if ( targetId === null || isNaN( targetId ) ) {
+		if ( targetId === null || targetId === undefined || isNaN( targetId ) ) {
 
 			console.warn( 'Failed resolving animation node id: ' + targetId, target );
 			return;
@@ -442,6 +442,11 @@ export class GLTFAnimationPointerExtension {
 
 			}
 
+			if( !TypedKeyframeTrack ) {
+				console.warn( 'Unsupported output accessor format', outputAccessor );
+				return;
+			}
+
 			const interpolation = sampler.interpolation !== undefined ? INTERPOLATION[ sampler.interpolation ] : InterpolateLinear;
 
 			let outputArray = parser._getArrayFromAccessor( outputAccessor );

package/types/index.d.ts

@@ -1,5 +1,13 @@
-
+import { GLTFLoaderPlugin } from "three/examples/jsm/loaders/GLTFLoader.js";
 
 export type AnimationPointerResolver = {
     resolvePath(path: string): string | null;
+}
+
+export declare class GLTFAnimationPointerExtension implements GLTFLoaderPlugin {
+    name: string;
+    parser: any;
+    constructor(parser: any);
+    setAnimationPointerResolver(resolver: AnimationPointerResolver | null): GLTFAnimationPointerExtension;
+    loadAnimation(animationIndex: number): Promise<any>;
 }

package/src/index.js

@@ -1 +0,0 @@
-export * from "./GLTFLoaderAnimationPointer.js"