@needle-tools/engine 4.5.0-alpha.1 → 4.5.0-alpha.3

package/lib/engine/engine_gltf_builtin_components.d.ts

@@ -1,7 +1,11 @@
 import "./codegen/register_types.js";
+import { Object3D } from "three";
 import { SerializationContext } from "./engine_serialization_core.js";
 import { Context } from "./engine_setup.js";
 import type { IComponent, SourceIdentifier, UIDProvider } from "./engine_types.js";
 import { NEEDLE_components } from "./extensions/NEEDLE_components.js";
+import { type GLTF } from "three/examples/jsm/loaders/GLTFLoader.js";
 export declare function writeBuiltinComponentData(comp: IComponent, context: SerializationContext): object | null;
-export declare function createBuiltinComponents(context: Context, gltfId: SourceIdentifier, gltf: any, seed?: number | null | UIDProvider, extension?: NEEDLE_components): Promise<void>;
+export declare function createBuiltinComponents(context: Context, gltfId: SourceIdentifier, gltf: GLTF & {
+    children?: Array<Object3D>;
+}, seed?: number | null | UIDProvider, extension?: NEEDLE_components): Promise<void>;

package/lib/engine/engine_gltf_builtin_components.js

@@ -59,6 +59,7 @@ export async function createBuiltinComponents(context, gltfId, gltf, seed = null
             await onCreateBuiltinComponents(serializationContext, scene, deserializeQueue, lateResolve);
         }
     }
+    // TODO: when is the gltf here an object3d?
     if (gltf.children) {
         for (const ch of gltf.children) {
             await onCreateBuiltinComponents(serializationContext, ch, deserializeQueue, lateResolve);
@@ -85,6 +86,7 @@ export async function createBuiltinComponents(context, gltfId, gltf, seed = null
             // TODO: should we do this after setup callbacks now?
             const guidsMap = {};
             const resolveGuids = [];
+            // TODO: when is the gltf here an object3d?
             recursiveCreateGuids(gltf, idProvider, guidsMap, resolveGuids);
             for (const scene of gltf.scenes)
                 recursiveCreateGuids(scene, idProvider, guidsMap, resolveGuids);
@@ -94,8 +96,6 @@ export async function createBuiltinComponents(context, gltfId, gltf, seed = null
             }
         }
     });
-    // tools.findAnimationsLate(context, gltf, context.new_scripts_pre_setup_callbacks);
-    // console.log("finished creating builtin components", gltf.scene?.name, gltf);
 }
 const originalComponentNameKey = Symbol("original-component-name");
 /**

package/lib/engine/engine_gltf_builtin_components.js.map

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

package/lib/engine/engine_loaders.callbacks.d.ts

@@ -0,0 +1,62 @@
+import { BufferGeometry, Object3D } from "three";
+import { Context } from "./engine_setup.js";
+import { CustomModel } from "./engine_types.js";
+import { type FileType } from "./engine_utils_format.js";
+export type ValidLoaderReturnType = CustomModel | Object3D | BufferGeometry;
+/** @internal */
+export type CustomLoader = {
+    /** The name of the loader. This is used for debugging purposes. */
+    name?: string;
+    /** Load the model from the given URL. This method should return a promise that resolves to the loaded model. */
+    loadAsync: (url: string, onProgress?: ((event: ProgressEvent<EventTarget>) => void) | undefined) => Promise<ValidLoaderReturnType>;
+    /** Load the model given a buffer. This method should return the loaded model. */
+    parse: (buffer: ArrayBuffer | string, path: string) => ValidLoaderReturnType;
+};
+type CustomLoaderCallback = (args: {
+    context: Context;
+    url: string;
+    filetype: FileType;
+}) => CustomLoader | null | undefined | void;
+/** @internal */
+export declare const registeredModelLoaderCallbacks: Array<CustomLoaderCallback>;
+type FileTypeCallback = (args: {
+    /** The URL of the file to load */
+    url: string;
+    /** The response of the range request with the first few bytes of the file (bytes are available in the 'args.bytes' property of this callback) */
+    response: Response;
+    /** The mimetype of the file as provided by the request header */
+    contentType: string | null;
+    /** The first few bytes of the file as a Uint8Array */
+    bytes: Uint8Array;
+}) => FileType | null;
+/** @internal */
+export declare const registeredFileTypeCallbacks: Array<FileTypeCallback>;
+/**
+ * NeedleEngineModelLoader is a namespace that provides functions to register custom model loaders and mimetype callbacks.
+ * It allows you to create custom loaders for specific file types and determine the mimetype of files based on their content.
+ */
+export declare namespace NeedleEngineModelLoader {
+    /**
+     * Register a custom loader callback. For every file that is requested this callback is called with the url and mimetype. It should return a custom loader or null if it does not want to handle the file.
+     * @param callback The callback to register
+     * @returns A function to unregister the callback
+     * @example
+     * ```ts
+     * import { onCreateModelLoader } from "@needle-tools/engine";
+     * const unregister = onCreateModelLoader((url, mimetype) => {
+     *     if (mimetype === "application/vnd.usdz+zip") {
+     *         return new CustomLoader();
+     *     }
+     *     return null;
+     * });
+     */
+    function onCreateCustomModelLoader(callback: CustomLoaderCallback): () => void;
+    /**
+     * Register a callback to determine the mimetype of a file. This is to support custom loaders. The callback will provide the URL of the file to load + a range request response with the first few bytes of the file. The callback should return a mimetype or null if it does not want to handle the file.
+     * @param callback The callback to register
+     * @returns A function to unregister the callback
+     *
+     */
+    function onDetermineModelFiletype(callback: FileTypeCallback): (() => void);
+}
+export {};

package/lib/engine/engine_loaders.callbacks.js

@@ -0,0 +1,56 @@
+/** @internal */
+export const registeredModelLoaderCallbacks = [];
+/** @internal */
+export const registeredFileTypeCallbacks = [];
+/**
+ * NeedleEngineModelLoader is a namespace that provides functions to register custom model loaders and mimetype callbacks.
+ * It allows you to create custom loaders for specific file types and determine the mimetype of files based on their content.
+ */
+export var NeedleEngineModelLoader;
+(function (NeedleEngineModelLoader) {
+    // export type ModelLoaderPlugin = {
+    //     name: string,
+    //     canLoad: (url: string, mimetype: string) => boolean,
+    // }
+    /**
+     * Register a custom loader callback. For every file that is requested this callback is called with the url and mimetype. It should return a custom loader or null if it does not want to handle the file.
+     * @param callback The callback to register
+     * @returns A function to unregister the callback
+     * @example
+     * ```ts
+     * import { onCreateModelLoader } from "@needle-tools/engine";
+     * const unregister = onCreateModelLoader((url, mimetype) => {
+     *     if (mimetype === "application/vnd.usdz+zip") {
+     *         return new CustomLoader();
+     *     }
+     *     return null;
+     * });
+     */
+    function onCreateCustomModelLoader(callback) {
+        registeredModelLoaderCallbacks.push(callback);
+        return () => {
+            const index = registeredModelLoaderCallbacks.indexOf(callback);
+            if (index >= 0) {
+                registeredModelLoaderCallbacks.splice(index, 1);
+            }
+        };
+    }
+    NeedleEngineModelLoader.onCreateCustomModelLoader = onCreateCustomModelLoader;
+    /**
+     * Register a callback to determine the mimetype of a file. This is to support custom loaders. The callback will provide the URL of the file to load + a range request response with the first few bytes of the file. The callback should return a mimetype or null if it does not want to handle the file.
+     * @param callback The callback to register
+     * @returns A function to unregister the callback
+     *
+     */
+    function onDetermineModelFiletype(callback) {
+        registeredFileTypeCallbacks.push(callback);
+        return () => {
+            const index = registeredFileTypeCallbacks.indexOf(callback);
+            if (index >= 0) {
+                registeredFileTypeCallbacks.splice(index, 1);
+            }
+        };
+    }
+    NeedleEngineModelLoader.onDetermineModelFiletype = onDetermineModelFiletype;
+})(NeedleEngineModelLoader || (NeedleEngineModelLoader = {}));
+//# sourceMappingURL=engine_loaders.callbacks.js.map

package/lib/engine/engine_loaders.callbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine_loaders.callbacks.js","sourceRoot":"","sources":["../../src/engine/engine_loaders.callbacks.ts"],"names":[],"mappings":"AAmBA,gBAAgB;AAChB,MAAM,CAAC,MAAM,8BAA8B,GAAgC,EAAE,CAAC;AAa9E,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAA4B,EAAE,CAAC;AAGvE;;;GAGG;AACH,MAAM,KAAW,uBAAuB,CA8CvC;AA9CD,WAAiB,uBAAuB;IAEpC,oCAAoC;IACpC,oBAAoB;IACpB,2DAA2D;IAC3D,IAAI;IAEJ;;;;;;;;;;;;;OAaG;IACH,SAAgB,yBAAyB,CAAC,QAA8B;QACpE,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,GAAG,EAAE;YACR,MAAM,KAAK,GAAG,8BAA8B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC/D,IAAI,KAAK,IAAI,CAAC,EAAE;gBACZ,8BAA8B,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;aACnD;QACL,CAAC,CAAA;IACL,CAAC;IARe,iDAAyB,4BAQxC,CAAA;IAED;;;;;OAKG;IACH,SAAgB,wBAAwB,CAAC,QAA0B;QAC/D,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE;YACR,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5D,IAAI,KAAK,IAAI,CAAC,EAAE;gBACZ,2BAA2B,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;aAChD;QACL,CAAC,CAAA;IACL,CAAC;IARe,gDAAwB,2BAQvC,CAAA;AACL,CAAC,EA9CgB,uBAAuB,KAAvB,uBAAuB,QA8CvC"}

package/lib/engine/engine_loaders.d.ts

@@ -1,13 +1,48 @@
+import { FBXLoader } from 'three/examples/jsm/loaders/FBXLoader.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
+import { USDZLoader } from 'three/examples/jsm/loaders/USDZLoader.js';
+import { type INeedleGltfLoader } from "./engine_gltf.js";
+import { CustomLoader } from "./engine_loaders.callbacks.js";
+import { SerializationContext } from "./engine_serialization_core.js";
 import { Context } from "./engine_setup.js";
-export declare function setDracoDecoderPath(path: string | undefined): void;
-export declare function setDracoDecoderType(type: string | undefined): void;
-export declare function setKtx2TranscoderPath(path: string): void;
-export declare function setMeshoptDecoder(_meshoptDecoder: any): void;
+import { Model, type UIDProvider } from "./engine_types.js";
+import { NEEDLE_components } from "./extensions/NEEDLE_components.js";
+/** @internal */
+export declare class NeedleLoader implements INeedleGltfLoader {
+    createBuiltinComponents(context: Context, gltfId: string, gltf: any, seed: number | UIDProvider | null, extension?: NEEDLE_components | undefined): Promise<void>;
+    writeBuiltinComponentData(comp: any, context: SerializationContext): object | null;
+    parseSync(context: Context, data: string | ArrayBuffer, path: string, seed: number | UIDProvider | null): Promise<Model | undefined>;
+    loadSync(context: Context, url: string, sourceId: string, seed: number | UIDProvider | null, prog?: ((ProgressEvent: any) => void) | undefined): Promise<Model | undefined>;
+}
+export declare function onCreateLoader(url: string, context: Context): Promise<CustomLoader | GLTFLoader | FBXLoader | USDZLoader | OBJLoader | null>;
 /**
- * Add Draco, Meshopt and KTX2 loaders to a GLTFLoader instance.
- * @param loader The GLTFLoader instance to add the loaders to.
- * @param context The context object containing the renderer.
- * @returns The GLTFLoader instance with the loaders added.
+ * Load a 3D model file from a remote URL
+ * @param url URL to glTF, FBX or OBJ file
+ * @param options
+ * @returns A promise that resolves to the loaded model or undefined if the loading failed
  */
-export declare function addDracoAndKTX2Loaders(loader: GLTFLoader, context: Pick<Context, "renderer">): GLTFLoader;
+export declare function loadAsset(url: string, options?: {
+    context?: Context;
+    path?: string;
+    seed?: number;
+    onprogress?: (evt: ProgressEvent) => void;
+}): Promise<Model | undefined>;
+/** Load a gltf file from a url. This is the core method used by Needle Engine to load gltf files. All known extensions are registered here.
+ * @param context The current context
+ * @param data The gltf data as string or ArrayBuffer
+ * @param path The path to the gltf file
+ * @param seed The seed for generating unique ids
+ * @returns The loaded gltf object
+ */
+export declare function parseSync(context: Context, data: string | ArrayBuffer, path: string, seed: number | UIDProvider | null): Promise<Model | undefined>;
+/**
+ * Load a gltf file from a url. This is the core method used by Needle Engine to load gltf files. All known extensions are registered here.
+ * @param context The current context
+ * @param url The url to the gltf file
+ * @param sourceId The source id of the gltf file - this is usually the url
+ * @param seed The seed for generating unique ids
+ * @param prog A progress callback
+ * @returns The loaded gltf object
+ */
+export declare function loadSync(context: Context, url: string, sourceId: string, seed: number | UIDProvider | null, prog?: (ProgressEvent: any) => void): Promise<Model | undefined>;

package/lib/engine/engine_loaders.gltf.d.ts

@@ -0,0 +1,13 @@
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { Context } from "./engine_setup.js";
+export declare function setDracoDecoderPath(path: string | undefined): void;
+export declare function setDracoDecoderType(type: string | undefined): void;
+export declare function setKtx2TranscoderPath(path: string): void;
+export declare function setMeshoptDecoder(_meshoptDecoder: any): void;
+/**
+ * Add Draco, Meshopt and KTX2 loaders to a GLTFLoader instance.
+ * @param loader The GLTFLoader instance to add the loaders to.
+ * @param context The context object containing the renderer.
+ * @returns The GLTFLoader instance with the loaders added.
+ */
+export declare function addDracoAndKTX2Loaders(loader: GLTFLoader, context: Pick<Context, "renderer">): GLTFLoader;

package/lib/engine/engine_loaders.gltf.js

@@ -0,0 +1,63 @@
+import { addDracoAndKTX2Loaders as addDracoAndKTX2LoadersGLTFProgressive, configureLoader, createLoaders, setDracoDecoderLocation, setKTX2TranscoderLocation } from '@needle-tools/gltf-progressive';
+import { getParam } from "./engine_utils.js";
+const debug = getParam("debugdecoders");
+let loaders = null;
+function ensureLoaders() {
+    if (!loaders) {
+        const res = createLoaders(null);
+        loaders = { dracoLoader: res.dracoLoader, ktx2Loader: res.ktx2Loader, meshoptDecoder: res.meshoptDecoder };
+    }
+    return loaders;
+}
+export function setDracoDecoderPath(path) {
+    if (path !== undefined && typeof path === "string") {
+        setDracoDecoderLocation(path);
+    }
+}
+export function setDracoDecoderType(type) {
+    if (type !== undefined && typeof type === "string") {
+        if (type !== "js") {
+            const loaders = ensureLoaders();
+            if (debug)
+                console.log("Setting draco decoder type to", type);
+            loaders.dracoLoader.setDecoderConfig({ type: type });
+        }
+    }
+}
+export function setKtx2TranscoderPath(path) {
+    if (path !== undefined && typeof path === "string") {
+        setKTX2TranscoderLocation(path);
+    }
+}
+export function setMeshoptDecoder(_meshoptDecoder) {
+    if (_meshoptDecoder !== undefined) {
+        const loaders = ensureLoaders();
+        loaders.meshoptDecoder = _meshoptDecoder;
+    }
+}
+/**
+ * Add Draco, Meshopt and KTX2 loaders to a GLTFLoader instance.
+ * @param loader The GLTFLoader instance to add the loaders to.
+ * @param context The context object containing the renderer.
+ * @returns The GLTFLoader instance with the loaders added.
+ */
+export function addDracoAndKTX2Loaders(loader, context) {
+    const loaders = ensureLoaders();
+    if (context.renderer) {
+        loaders.ktx2Loader.detectSupport(context.renderer);
+    }
+    else
+        console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures will probably fail");
+    addDracoAndKTX2LoadersGLTFProgressive(loader);
+    if (!loader.dracoLoader)
+        loader.setDRACOLoader(loaders.dracoLoader);
+    if (!loader.ktx2Loader)
+        loader.setKTX2Loader(loaders.ktx2Loader);
+    if (!loader.meshoptDecoder)
+        loader.setMeshoptDecoder(loaders.meshoptDecoder);
+    configureLoader(loader, {
+        progressive: true,
+    });
+    return loader;
+}
+//# sourceMappingURL=engine_loaders.gltf.js.map

package/lib/engine/engine_loaders.gltf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine_loaders.gltf.js","sourceRoot":"","sources":["../../src/engine/engine_loaders.gltf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,IAAI,qCAAqC,EAAE,eAAe,EAAE,aAAa,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAOrM,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;AAExC,IAAI,OAAO,GAAuG,IAAI,CAAC;AAEvH,SAAS,aAAa;IAClB,IAAI,CAAC,OAAO,EAAE;QACV,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC;KAC9G;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IACxD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAChD,uBAAuB,CAAC,IAAI,CAAC,CAAC;KACjC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAwB;IACxD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAChD,IAAI,IAAI,KAAK,IAAI,EAAE;YACf,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;YAChC,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC;YAC9D,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;SACxD;KACJ;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAC9C,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;QAChD,yBAAyB,CAAC,IAAI,CAAC,CAAC;KACnC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,eAAoB;IAClD,IAAI,eAAe,KAAK,SAAS,EAAE;QAC/B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;QAChC,OAAO,CAAC,cAAc,GAAG,eAAe,CAAC;KAC5C;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAkB,EAAE,OAAkC;IAEzF,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,QAAQ,EAAE;QAClB,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;KACtD;;QAEG,OAAO,CAAC,IAAI,CAAC,wFAAwF,CAAC,CAAC;IAE3G,qCAAqC,CAAC,MAAM,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,CAAC,WAAW;QACnB,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAE,MAAc,CAAC,UAAU;QAC3B,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAE,MAAc,CAAC,cAAc;QAC/B,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAErD,eAAe,CAAC,MAAM,EAAE;QACpB,WAAW,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAClB,CAAC"}