@needle-tools/usd 0.0.1-alpha → 0.0.1-alpha.2

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).
+
+## [0.0.1-alpha.1] - 2025-05-14
+- initial release

package/README.md

@@ -1,6 +1,8 @@
 # Needle USD
 
-USD wasm runtime and three.js hydra delegate
+USD wasm runtime and three.js hydra delegate.   
+Developed & maintained by [Needle](https://needle.tools)  
+For commercial use please contact hi@needle.tools
 
 ## Install
 `npm install @needle-tools/usd`
@@ -68,4 +70,14 @@ driver.Draw();
 
 Uses Asyncify to handle async calls in emscripten.
 > A synchronous call in C that waits for an asynchronous operation in JS to complete.
-https://emscripten.org/docs/porting/asyncify.html
+https://emscripten.org/docs/porting/asyncify.html
+
+
+# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/usd",
-  "version": "0.0.1-alpha",
+  "version": "0.0.1-alpha.2",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "type": "module",
@@ -8,6 +8,10 @@
     ".": {
       "import": "./src/index.js",
       "require": "./src/index.cjs"
+    },
+    "./plugins": {
+      "import": "./src/plugins/index.js",
+      "require": "./src/plugins/index.cjs"
     }
   },
   "keywords": [

package/src/index.d.ts

@@ -1 +1,5 @@
-export * from "./types";
+export * from "./types";
+
+declare module '@needle-tools/usd/plugins' {
+    export * from './types/plugins';
+}

package/src/plugins/needle.js

@@ -1,22 +1,23 @@
 import { Loader, Object3D } from "three";
 import { createThreeHydra, getUsdModule } from "../index.js";
-import { addComponent, Behaviour, NeedleEngineModelLoader } from "@needle-tools/engine";
-
 
 
 /** @type {import("../types").addPluginForNeedleEngine} */
 export async function addPluginForNeedleEngine(options) {
-    console.debug("🐉 Adding USDZ plugin to Needle Engine");
-    return onAddNeedlePlugin(options)
+    if (options.debug) console.debug("🐉 Adding USDZ plugin to Needle Engine");
+    return import("@needle-tools/engine").then(module => {
+        return onAddNeedlePlugin(module, options);
+    })
 }
 
 
 /**
+ * @param {typeof import("@needle-tools/engine")} NEEDLE
  * @param {import("../types").PluginContext} opts
  */
-function onAddNeedlePlugin(opts) {
+function onAddNeedlePlugin(NEEDLE, opts) {
 
-    class NeedleUSDZHHandler extends Behaviour {
+    class NeedleUSDZHHandler extends NEEDLE.Behaviour {
         constructor() {
             super();
             /**
@@ -24,7 +25,6 @@ function onAddNeedlePlugin(opts) {
              */
             this.handle = null;
             this.root = new Object3D();
-            console.debug("Create root", this.root);
         }
 
         update() {
@@ -81,7 +81,7 @@ function onAddNeedlePlugin(opts) {
                 debug
                 // setURLModifier: USDLoadingManager.urlModifier,
             }).then(res => {
-                console.debug("🐉 USD HYDRA IS READY");
+                if (debug) console.debug("🐉 USD HYDRA IS READY");
                 return res;
             })
             const usd = await NeedleUSDZLoader.usdModule;
@@ -98,7 +98,7 @@ function onAddNeedlePlugin(opts) {
             });
             this.comp.handle = handle;
 
-            console.debug("Loaded", this.comp);
+            if (debug) console.debug("Loaded", this.comp);
 
             onProgress?.(new ProgressEvent("load", { lengthComputable: true, loaded: 1, total: 1 }));
 
@@ -115,7 +115,7 @@ function onAddNeedlePlugin(opts) {
 
 
 
-    const removeFiletype = NeedleEngineModelLoader.onDetermineModelMimetype(cb => {
+    const removeFiletype = NEEDLE.NeedleEngineModelLoader.onDetermineModelMimetype(cb => {
 
         if (cb.contentType === "application/vnd.usd") {
             return "model/vnd.usd";
@@ -135,11 +135,11 @@ function onAddNeedlePlugin(opts) {
     });
 
     const handlers = new Array();
-    const removeCustomLoader = NeedleEngineModelLoader.onCreateCustomModelLoader(cb => {
+    const removeCustomLoader = NEEDLE.NeedleEngineModelLoader.onCreateCustomModelLoader(cb => {
         if (cb.mimetype.startsWith("model/vnd.usd")) {
             const handler = new NeedleUSDZHHandler();
             handlers.push(handler);
-            addComponent(cb.context.scene, handler);
+            NEEDLE.addComponent(cb.context.scene, handler);
             return new NeedleUSDZLoader(handler);
         }
         return null;