@loaders.gl/scene 5.0.0-alpha.9 → 5.0.0-beta.10

package/dist/usd-loader.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/usd-loader.ts", "../src/usd/usd-loader.ts"],
+  "sourcesContent": ["export * from './usd/usd-loader.js';\n", "// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n// loaders.gl\n\nimport type {LoaderWithParser} from '@loaders.gl/core/loader-utils';\nimport {parseUSD} from './lib/parse-usd';\nimport type {USDLoaderOptions, USDStage} from './lib/usd-types';\nimport {USDLoader as USDLoaderMetadata} from './usd-loader-types';\n\nconst {preload: _USDLoaderPreload, ...USDLoaderMetadataWithoutPreload} = USDLoaderMetadata;\n\n/** Parser-bearing loader for OpenUSD ASCII, supported binary crate layers, and stored USDZ scenes. */\nexport const USDLoaderWithParser = {\n  ...USDLoaderMetadataWithoutPreload,\n  parse: parseUSD,\n  parseText\n} as const satisfies LoaderWithParser<USDStage, never, USDLoaderOptions>;\n\n/** Encodes USDA source text before using the shared binary parser. */\nasync function parseText(\n  text: string,\n  options?: USDLoaderOptions,\n  context?: Parameters<typeof parseUSD>[2]\n): Promise<USDStage> {\n  return parseUSD(new TextEncoder().encode(text).buffer, options, context);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,uBAAuB;AAEvB,8BAA6C;AAE7C,IAAM,EAAC,SAAS,mBAAmB,GAAG,gCAA+B,IAAI,wBAAAA;AAGlE,IAAM,sBAAsB;AAAA,EACjC,GAAG;AAAA,EACH,OAAO;AAAA,EACP;AACF;AAGA,eAAe,UACb,MACA,SACA,SACmB;AACnB,aAAO,2BAAS,IAAI,YAAY,EAAE,OAAO,IAAI,EAAE,QAAQ,SAAS,OAAO;AACzE;",
+  "names": ["USDLoaderMetadata"]
+}

package/dist/usd-loader.d.ts

@@ -1,30 +1,2 @@
-import { parseUSD } from "./lib/parse-usd.js";
-import type { USDLoaderOptions, USDStage } from "./lib/usd-types.js";
-/** Parser-bearing loader for OpenUSD ASCII and uncompressed USDZ scenes. */
-export declare const USDLoaderWithParser: {
-    readonly parse: typeof parseUSD;
-    readonly parseText: typeof parseText;
-    readonly dataType: USDStage;
-    readonly batchType: never;
-    readonly name: "Universal Scene Description";
-    readonly id: "usd";
-    readonly module: "scene";
-    readonly version: any;
-    readonly extensions: ["usd", "usda", "usdz"];
-    readonly mimeTypes: ["model/vnd.usd", "model/vnd.usda", "model/vnd.usdz+zip"];
-    readonly text: true;
-    readonly binary: true;
-    readonly tests: ["#usda", "PK"];
-    readonly options: {
-        readonly usd: {
-            readonly compose: true;
-            readonly loadReferences: true;
-            readonly maxReferenceDepth: 12;
-            readonly variantSelections: {};
-        };
-    };
-};
-/** Encodes USDA source text before using the shared binary parser. */
-declare function parseText(text: string, options?: USDLoaderOptions, context?: Parameters<typeof parseUSD>[2]): Promise<USDStage>;
-export {};
+export * from './usd/usd-loader.js';
 //# sourceMappingURL=usd-loader.d.ts.map

package/dist/usd-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usd-loader.d.ts","sourceRoot":"","sources":["../src/usd-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,QAAQ,EAAC,2BAAwB;AACzC,OAAO,KAAK,EAAC,gBAAgB,EAAE,QAAQ,EAAC,2BAAwB;AAKhE,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;CAIwC,CAAC;AAEzE,sEAAsE;AACtE,iBAAe,SAAS,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,gBAAgB,EAC1B,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,QAAQ,CAAC,CAEnB"}
+{"version":3,"file":"usd-loader.d.ts","sourceRoot":"","sources":["../src/usd-loader.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/usd-loader.js

@@ -1,17 +1,2 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-import { parseUSD } from "./lib/parse-usd.js";
-import { USDLoader as USDLoaderMetadata } from "./usd-loader-types.js";
-const { preload: _USDLoaderPreload, ...USDLoaderMetadataWithoutPreload } = USDLoaderMetadata;
-/** Parser-bearing loader for OpenUSD ASCII and uncompressed USDZ scenes. */
-export const USDLoaderWithParser = {
-    ...USDLoaderMetadataWithoutPreload,
-    parse: parseUSD,
-    parseText
-};
-/** Encodes USDA source text before using the shared binary parser. */
-async function parseText(text, options, context) {
-    return parseUSD(new TextEncoder().encode(text).buffer, options, context);
-}
+export * from './usd/usd-loader.js';
 //# sourceMappingURL=usd-loader.js.map

package/dist/usd-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"usd-loader.js","sourceRoot":"","sources":["../src/usd-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,QAAQ,EAAC,2BAAwB;AAEzC,OAAO,EAAC,SAAS,IAAI,iBAAiB,EAAC,8BAA2B;AAElE,MAAM,EAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,+BAA+B,EAAC,GAAG,iBAAiB,CAAC;AAE3F,4EAA4E;AAC5E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,+BAA+B;IAClC,KAAK,EAAE,QAAQ;IACf,SAAS;CAC6D,CAAC;AAEzE,sEAAsE;AACtE,KAAK,UAAU,SAAS,CACtB,IAAY,EACZ,OAA0B,EAC1B,OAAwC;IAExC,OAAO,QAAQ,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"usd-loader.js","sourceRoot":"","sources":["../src/usd-loader.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loaders.gl/scene",
-  "version": "5.0.0-alpha.9",
-  "description": "Framework-independent loaders for scene description formats",
+  "version": "5.0.0-beta.10",
+  "description": "glTF, GLB, OBJ, MTL, OpenUSD, and Draco geometry loaders and writers",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -18,7 +18,12 @@
     "OpenUSD",
     "USD",
     "USDA",
-    "USDZ"
+    "USDZ",
+    "loaders.gl",
+    "glTF",
+    "GLB",
+    "OBJ",
+    "MTL"
   ],
   "types": "dist/index.d.ts",
   "main": "dist/index.cjs",
@@ -31,25 +36,263 @@
     },
     "./usd-loader": {
       "types": "./dist/usd-loader.d.ts",
-      "import": "./dist/usd-loader.js"
+      "import": "./dist/usd-loader.js",
+      "require": "./dist/usd-loader.cjs"
+    },
+    "./obj": {
+      "types": "./dist/obj/index.d.ts",
+      "import": "./dist/obj/index.js",
+      "require": "./dist/obj/index.cjs"
+    },
+    "./obj/bundled": {
+      "types": "./dist/obj/bundled.d.ts",
+      "import": "./dist/obj/bundled.js",
+      "require": "./dist/obj/bundled.cjs"
+    },
+    "./obj/index": {
+      "types": "./dist/obj/index.d.ts",
+      "import": "./dist/obj/index.js",
+      "require": "./dist/obj/index.cjs"
+    },
+    "./obj/mtl-format": {
+      "types": "./dist/obj/mtl-format.d.ts",
+      "import": "./dist/obj/mtl-format.js",
+      "require": "./dist/obj/mtl-format.cjs"
+    },
+    "./mtl-loader-types": {
+      "types": "./dist/mtl-loader-types.d.ts",
+      "import": "./dist/mtl-loader-types.js",
+      "require": "./dist/mtl-loader-types.cjs"
+    },
+    "./mtl-loader": {
+      "types": "./dist/mtl-loader.d.ts",
+      "import": "./dist/mtl-loader.js",
+      "require": "./dist/mtl-loader.cjs"
+    },
+    "./obj/obj-format": {
+      "types": "./dist/obj/obj-format.d.ts",
+      "import": "./dist/obj/obj-format.js",
+      "require": "./dist/obj/obj-format.cjs"
+    },
+    "./obj-loader-types": {
+      "types": "./dist/obj-loader-types.d.ts",
+      "import": "./dist/obj-loader-types.js",
+      "require": "./dist/obj-loader-types.cjs"
+    },
+    "./obj-loader": {
+      "types": "./dist/obj-loader.d.ts",
+      "import": "./dist/obj-loader.js",
+      "require": "./dist/obj-loader.cjs"
+    },
+    "./obj-writer": {
+      "types": "./dist/obj-writer.d.ts",
+      "import": "./dist/obj-writer.js",
+      "require": "./dist/obj-writer.cjs"
+    },
+    "./obj/unbundled": {
+      "types": "./dist/obj/unbundled.d.ts",
+      "import": "./dist/obj/unbundled.js",
+      "require": "./dist/obj/unbundled.cjs"
+    },
+    "./gltf": {
+      "types": "./dist/gltf/index.d.ts",
+      "import": "./dist/gltf/index.js",
+      "require": "./dist/gltf/index.cjs"
+    },
+    "./gltf/bundled": {
+      "types": "./dist/gltf/bundled.d.ts",
+      "import": "./dist/gltf/bundled.js",
+      "require": "./dist/gltf/bundled.cjs"
+    },
+    "./glb-loader-types": {
+      "types": "./dist/glb-loader-types.d.ts",
+      "import": "./dist/glb-loader-types.js",
+      "require": "./dist/glb-loader-types.cjs"
+    },
+    "./glb-loader": {
+      "types": "./dist/glb-loader.d.ts",
+      "import": "./dist/glb-loader.js",
+      "require": "./dist/glb-loader.cjs"
+    },
+    "./glb-writer": {
+      "types": "./dist/glb-writer.d.ts",
+      "import": "./dist/glb-writer.js",
+      "require": "./dist/glb-writer.cjs"
+    },
+    "./gltf/gltf-format": {
+      "types": "./dist/gltf/gltf-format.d.ts",
+      "import": "./dist/gltf/gltf-format.js",
+      "require": "./dist/gltf/gltf-format.cjs"
+    },
+    "./gltf-loader-types": {
+      "types": "./dist/gltf-loader-types.d.ts",
+      "import": "./dist/gltf-loader-types.js",
+      "require": "./dist/gltf-loader-types.cjs"
+    },
+    "./gltf-loader": {
+      "types": "./dist/gltf-loader.d.ts",
+      "import": "./dist/gltf-loader.js",
+      "require": "./dist/gltf-loader.cjs"
+    },
+    "./gltf-source": {
+      "types": "./dist/gltf-source.d.ts",
+      "import": "./dist/gltf-source.js",
+      "require": "./dist/gltf-source.cjs"
+    },
+    "./gltf-writer": {
+      "types": "./dist/gltf-writer.d.ts",
+      "import": "./dist/gltf-writer.js",
+      "require": "./dist/gltf-writer.cjs"
+    },
+    "./gltf/index": {
+      "types": "./dist/gltf/index.d.ts",
+      "import": "./dist/gltf/index.js",
+      "require": "./dist/gltf/index.cjs"
+    },
+    "./gltf/mesh-arrow": {
+      "types": "./dist/gltf/mesh-arrow.d.ts",
+      "import": "./dist/gltf/mesh-arrow.js"
+    },
+    "./gltf/schema": {
+      "types": "./dist/gltf/schema.d.ts",
+      "import": "./dist/gltf/schema.js"
+    },
+    "./gltf/unbundled": {
+      "types": "./dist/gltf/unbundled.d.ts",
+      "import": "./dist/gltf/unbundled.js",
+      "require": "./dist/gltf/unbundled.cjs"
+    },
+    "./gltf/gltf.schema.json": "./dist/gltf/gltf.schema.json",
+    "./gltf/gltf-1.schema.json": "./dist/gltf/gltf-1.schema.json",
+    "./gltf/gltf-2.schema.json": "./dist/gltf/gltf-2.schema.json",
+    "./gltf/gltf-2.1.schema.json": "./dist/gltf/gltf-2.1.schema.json",
+    "./gltf/gltf-all.schema.json": "./dist/gltf/gltf-all.schema.json",
+    "./gltf/schemas/*": "./dist/gltf/schemas/*",
+    "./usd": {
+      "types": "./dist/usd/index.d.ts",
+      "import": "./dist/usd/index.js",
+      "require": "./dist/usd/index.cjs"
+    },
+    "./obj-worker.js": {
+      "import": "./dist/obj-worker.js"
+    },
+    "./usd/index": {
+      "types": "./dist/usd/index.d.ts",
+      "import": "./dist/usd/index.js",
+      "require": "./dist/usd/index.cjs"
+    },
+    "./usd-loader-types": {
+      "types": "./dist/usd-loader-types.d.ts",
+      "import": "./dist/usd-loader-types.js",
+      "require": "./dist/usd-loader-types.cjs"
+    },
+    "./draco-worker.js": {
+      "import": "./dist/draco-worker.js"
+    },
+    "./draco-worker-node.js": {
+      "import": "./dist/draco-worker-node.js"
+    },
+    "./draco-writer-worker.js": {
+      "import": "./dist/draco-writer-worker.js"
+    },
+    "./draco-writer-worker-node.js": {
+      "import": "./dist/draco-writer-worker-node.cjs",
+      "require": "./dist/draco-writer-worker-node.cjs"
+    },
+    "./draco-writer-worker-node.cjs": {
+      "require": "./dist/draco-writer-worker-node.cjs",
+      "default": "./dist/draco-writer-worker-node.cjs"
+    },
+    "./draco-loader": {
+      "types": "./dist/draco-loader.d.ts",
+      "import": "./dist/draco-loader.js",
+      "require": "./dist/draco-loader.cjs"
+    },
+    "./draco-loader-types": {
+      "types": "./dist/draco-loader-types.d.ts",
+      "import": "./dist/draco-loader-types.js",
+      "require": "./dist/draco-loader-types.cjs"
+    },
+    "./draco-wasm-loader": {
+      "types": "./dist/draco-wasm-loader.d.ts",
+      "import": "./dist/draco-wasm-loader.js",
+      "require": "./dist/draco-wasm-loader.cjs"
+    },
+    "./draco-javascript-loader": {
+      "types": "./dist/draco-javascript-loader.d.ts",
+      "import": "./dist/draco-javascript-loader.js",
+      "require": "./dist/draco-javascript-loader.cjs"
+    },
+    "./draco3d-loader": {
+      "types": "./dist/draco3d-loader.d.ts",
+      "import": "./dist/draco3d-loader.js",
+      "require": "./dist/draco3d-loader.cjs"
+    },
+    "./draco-writer": {
+      "types": "./dist/draco-writer.d.ts",
+      "import": "./dist/draco-writer.js",
+      "require": "./dist/draco-writer.cjs"
+    },
+    "./draco-library-options": {
+      "types": "./dist/draco-library-options.d.ts",
+      "import": "./dist/draco-library-options.js"
+    },
+    "./materialx-loader": {
+      "types": "./dist/materialx-loader.d.ts",
+      "import": "./dist/materialx-loader.js",
+      "require": "./dist/materialx-loader.cjs"
+    },
+    "./stl-loader": {
+      "types": "./dist/stl-loader.d.ts",
+      "import": "./dist/stl-loader.js",
+      "require": "./dist/stl-loader.cjs"
     }
   },
   "sideEffects": false,
   "files": [
     "src",
     "dist",
-    "README.md"
+    "README.md",
+    "OBJ-README.md",
+    "GLTF-README.md",
+    "bin",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md",
+    "third-party-licenses",
+    "DRACO-README.md"
   ],
   "scripts": {
-    "pre-build": "npm run build-bundle && npm run build-bundle-dev",
+    "pre-build": "npm run copy-libs-usd && npm run copy-libs-gltf && npm run build-worker-obj && npm run build-format-subpaths && npm run generate-gltf-schemas && npm run build-bundle && npm run build-bundle-dev && npm run copy-libs-draco && npm run build-draco-workers",
     "build-bundle": "ocular-bundle ./bundle.ts --output=dist/dist.min.js",
-    "build-bundle-dev": "ocular-bundle ./bundle.ts --env=dev --output=dist/dist.dev.js"
+    "build-bundle-dev": "ocular-bundle ./bundle.ts --env=dev --output=dist/dist.dev.js",
+    "build-worker-obj": "node ../../scripts/build-codec-worker.mjs src/obj/workers/obj-worker.ts --bundle --outfile=dist/obj-worker.js --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-format-subpaths": "node ../../scripts/build-format-subpaths.mjs",
+    "generate-gltf-schemas": "node scripts/gltf/generate-json-schema.mjs",
+    "copy-libs-gltf": "mkdir -p dist/gltf/libs && cp -rf src/gltf/libs/. dist/gltf/libs/",
+    "copy-libs-draco": "mkdir -p ./dist/libs && cp -rf ./src/draco/libs/. ./dist/libs && node ../../scripts/build-library-modules.mjs scene",
+    "build-draco-workers": "yarn build-draco-loader-worker && yarn build-draco-loader-worker-node && yarn build-draco-writer-worker && yarn build-draco-writer-worker-node",
+    "build-draco-loader-worker": "node ../../scripts/build-codec-worker.mjs src/draco/workers/draco-worker.ts --outfile=dist/draco-worker.js --target=esnext --bundle --sourcemap --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-draco-loader-worker-node": "node ../../scripts/build-codec-worker.mjs src/draco/workers/draco-worker-node.ts --outfile=dist/draco-worker-node.js --target=node16 --platform=node --bundle --sourcemap --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-draco-writer-worker": "node ../../scripts/build-codec-worker.mjs src/draco/workers/draco-writer-worker.ts --outfile=dist/draco-writer-worker.js --target=esnext --bundle --sourcemap --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "build-draco-writer-worker-node": "node ../../scripts/build-codec-worker.mjs src/draco/workers/draco-writer-worker-node.ts --outfile=dist/draco-writer-worker-node.cjs --target=node16 --platform=node --bundle --sourcemap --define:__VERSION__=\\\"$npm_package_version\\\"",
+    "copy-libs-usd": "mkdir -p dist/usd/libs && cp src/usd/libs/usdc-parser.js src/usd/libs/THREE-LICENSE src/usd/libs/README.md dist/usd/libs/"
+  },
+  "peerDependencies": {
+    "@loaders.gl/core": "~5.0.0-alpha.0",
+    "apache-arrow": ">= 17.0.0"
   },
   "dependencies": {
-    "@loaders.gl/loader-utils": "5.0.0-alpha.9"
+    "@loaders.gl/documents": "5.0.0-beta.10",
+    "@loaders.gl/images": "5.0.0-beta.10",
+    "@math.gl/core": "5.0.0-beta.10",
+    "@math.gl/geometry": "5.0.0-beta.10",
+    "zod": "^4.1.12"
   },
-  "peerDependencies": {
-    "@loaders.gl/core": "~5.0.0-alpha.0"
+  "devDependencies": {
+    "meshoptimizer": "1.3.0"
+  },
+  "optionalDependencies": {
+    "draco3d": "1.5.7"
   },
-  "gitHead": "c3be3766791d30e79a9aa1d9b326962f264cbbe7"
+  "gitHead": "efdd84034c25e2e5dbb41bc88b75af56cb2176da"
 }

package/src/draco/bundled.ts

@@ -0,0 +1,9 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {DracoLoaderOptions} from './draco-loader-options';
+export {DracoWASMLoaderWithParser as DracoLoader} from './draco-wasm-loader-with-parser';
+
+export {getDracoLibraryOptions} from './draco-library-options';
+export type {DracoLibraryOptions} from './draco-library-options';

package/src/draco/draco-format.ts

@@ -0,0 +1,20 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Format} from '@loaders.gl/core/loader-utils';
+
+/**
+ * Draco3D compressed geometries
+ */
+export const DracoFormat = {
+  name: 'Draco',
+  id: 'draco',
+  module: 'scene',
+  encoding: 'binary',
+  format: 'draco',
+  extensions: ['drc'],
+  mimeTypes: ['application/octet-stream'],
+  binary: true,
+  tests: ['DRACO']
+} as const satisfies Format;

package/src/draco/draco-javascript-loader-with-parser.ts

@@ -0,0 +1,30 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderWithParser, LoaderContext} from '@loaders.gl/core/loader-utils';
+import {extractLoadLibraryOptions} from '@loaders.gl/core/worker-utils';
+import type {Table} from 'apache-arrow';
+import type {DracoMesh} from './lib/draco-types';
+import {loadDracoDecoderModule} from './lib/draco-module-loader';
+import {parseDraco} from './lib/parse-draco';
+import {DracoLoader as DracoLoaderMetadata} from './draco-loader-types';
+import type {DracoLoaderOptions} from './draco-loader-options';
+
+const {preload: _DracoLoaderPreload, ...DracoLoaderMetadataWithoutPreload} = DracoLoaderMetadata;
+
+/** Parser-bearing Draco loader backed by the JavaScript fallback decoder. */
+export const DracoJavaScriptLoaderWithParser = {
+  ...DracoLoaderMetadataWithoutPreload,
+  parse: async (arrayBuffer: ArrayBuffer, options?: DracoLoaderOptions, context?: LoaderContext) =>
+    await parseDraco(
+      arrayBuffer,
+      options,
+      async () =>
+        await loadDracoDecoderModule(
+          extractLoadLibraryOptions({core: options?.core, modules: options?.modules}),
+          'js'
+        ),
+      context
+    )
+} as const satisfies LoaderWithParser<DracoMesh | Table, never, DracoLoaderOptions>;

package/src/draco/draco-libraries.ts

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+
+const DRACO_VERSION = '1.5.7';
+const DRACO_RELEASE_COMMIT = '8786740086a9f4d83f44aa83badfbea4dce7a1b5';
+const STATIC_DECODER_URL = `https://www.gstatic.com/draco/versioned/decoders/${DRACO_VERSION}`;
+const STATIC_ENCODER_URL = `https://cdn.jsdelivr.net/gh/google/draco@${DRACO_RELEASE_COMMIT}/javascript`;
+
+/** External Draco runtime assets understood by `loadLibrary`. */
+export const DRACO_EXTERNAL_LIBRARIES = {
+  /** WebAssembly decoder JavaScript wrapper. */
+  DECODER: 'draco_wasm_wrapper.js',
+  /** WebAssembly decoder binary. */
+  DECODER_WASM: 'draco_decoder.wasm',
+  /** glTF-profile WebAssembly decoder JavaScript wrapper. */
+  GLTF_DECODER: 'draco_wasm_wrapper_gltf.js',
+  /** glTF-profile WebAssembly decoder binary. */
+  GLTF_DECODER_WASM: 'draco_decoder_gltf.wasm',
+  /** JavaScript decoder fallback. */
+  FALLBACK_DECODER: 'draco_decoder.js',
+  /** WebAssembly encoder JavaScript wrapper. */
+  ENCODER: 'draco_encoder.js',
+  /** WebAssembly encoder binary. */
+  ENCODER_WASM: 'draco_encoder.wasm'
+} as const;
+
+/** Default versioned URLs for external Draco runtime assets. */
+export const DRACO_EXTERNAL_LIBRARY_URLS = {
+  [DRACO_EXTERNAL_LIBRARIES.DECODER]: `${STATIC_DECODER_URL}/${DRACO_EXTERNAL_LIBRARIES.DECODER}`,
+  [DRACO_EXTERNAL_LIBRARIES.DECODER_WASM]: `${STATIC_DECODER_URL}/${DRACO_EXTERNAL_LIBRARIES.DECODER_WASM}`,
+  [DRACO_EXTERNAL_LIBRARIES.GLTF_DECODER]: `${STATIC_DECODER_URL}/${DRACO_EXTERNAL_LIBRARIES.GLTF_DECODER}`,
+  [DRACO_EXTERNAL_LIBRARIES.GLTF_DECODER_WASM]: `${STATIC_DECODER_URL}/${DRACO_EXTERNAL_LIBRARIES.GLTF_DECODER_WASM}`,
+  [DRACO_EXTERNAL_LIBRARIES.FALLBACK_DECODER]: `${STATIC_DECODER_URL}/${DRACO_EXTERNAL_LIBRARIES.FALLBACK_DECODER}`,
+  [DRACO_EXTERNAL_LIBRARIES.ENCODER]: `${STATIC_ENCODER_URL}/${DRACO_EXTERNAL_LIBRARIES.ENCODER}`,
+  [DRACO_EXTERNAL_LIBRARIES.ENCODER_WASM]: `${STATIC_ENCODER_URL}/${DRACO_EXTERNAL_LIBRARIES.ENCODER_WASM}`
+} as const;

package/src/draco/draco-library-options.ts

@@ -0,0 +1,76 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoadLibraryOptions} from '@loaders.gl/core/worker-utils';
+import type {DracoDecoderProfile} from './lib/draco-module-loader';
+
+/** Bundled Draco runtime selection and optional application overrides. */
+export type DracoLibraryOptions = LoadLibraryOptions & {
+  /** Selects the full decoder or the smaller glTF-compatible subset. Defaults to full. */
+  decoderProfile?: DracoDecoderProfile;
+};
+
+/**
+ * Creates browser-bundler URL overrides for vendored Draco encoder and decoder runtimes.
+ * Classic and generated ESM assets live in the scene package’s dist/libs directory.
+ * Explicit application modules override the bundled defaults.
+ */
+export function getDracoLibraryOptions(
+  options: DracoLibraryOptions = {}
+): DracoLibraryOptions & {decoderProfile: DracoDecoderProfile} {
+  const decoderProfile = options.decoderProfile ?? 'full';
+  const decoderModules =
+    decoderProfile === 'gltf'
+      ? {
+          'draco_wasm_wrapper_gltf.js': new URL(
+            '../../dist/libs/draco_wasm_wrapper_gltf.js',
+            import.meta.url
+          ).href,
+          'draco_decoder_gltf.wasm': new URL(
+            '../../dist/libs/draco_decoder_gltf.wasm',
+            import.meta.url
+          ).href
+        }
+      : {
+          'draco_wasm_wrapper.js': new URL('../../dist/libs/draco_wasm_wrapper.js', import.meta.url)
+            .href,
+          'draco_decoder.wasm': new URL('../../dist/libs/draco_decoder.wasm', import.meta.url).href
+        };
+  const moduleLibraries: Record<string, string> = {
+    'draco_encoder.mjs': new URL('../../dist/libs/draco_encoder.mjs', import.meta.url).href,
+    'draco_decoder.mjs': new URL('../../dist/libs/draco_decoder.mjs', import.meta.url).href,
+    ...(decoderProfile === 'gltf'
+      ? {
+          'draco_wasm_wrapper_gltf.mjs': new URL(
+            '../../dist/libs/draco_wasm_wrapper_gltf.mjs',
+            import.meta.url
+          ).href
+        }
+      : {
+          'draco_wasm_wrapper.mjs': new URL(
+            '../../dist/libs/draco_wasm_wrapper.mjs',
+            import.meta.url
+          ).href
+        })
+  };
+  // Do not substitute bundled ESM assets for an application's classic-name override.
+  for (const libraryName of Object.keys(moduleLibraries)) {
+    const classicName = libraryName.replace(/\.mjs$/, '.js');
+    if (options.modules?.[classicName] !== undefined) {
+      delete moduleLibraries[libraryName];
+    }
+  }
+  return {
+    ...options,
+    decoderProfile,
+    modules: {
+      'draco_encoder.js': new URL('../../dist/libs/draco_encoder.js', import.meta.url).href,
+      'draco_encoder.wasm': new URL('../../dist/libs/draco_encoder.wasm', import.meta.url).href,
+      'draco_decoder.js': new URL('../../dist/libs/draco_decoder.js', import.meta.url).href,
+      ...decoderModules,
+      ...moduleLibraries,
+      ...options.modules
+    }
+  };
+}

package/src/draco/draco-loader-options.ts

@@ -0,0 +1,33 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {StrictLoaderOptions} from '@loaders.gl/core/loader-utils';
+import type {DracoParseOptions} from './lib/draco-parser';
+import type {DracoDecoderProfile} from './lib/draco-module-loader';
+
+/** Draco decoder backend selected by the metadata loader. */
+export type DracoDecoderBackend = 'wasm' | 'javascript' | 'draco3d';
+
+/** Options for the Draco loader. */
+export type DracoLoaderOptions = StrictLoaderOptions & {
+  draco?: DracoParseOptions & {
+    /** Decoder backend. Defaults to WASM when available and JavaScript otherwise. */
+    backend?: DracoDecoderBackend | 'js';
+    /** Selects mesh output or Apache Arrow output. */
+    shape?: 'mesh' | 'arrow';
+    /** Selects the full decoder or the smaller glTF-compatible decoder build. */
+    decoderProfile?: DracoDecoderProfile;
+    /** Override the URL to the worker bundle (by default loads from unpkg.com) */
+    workerUrl?: string;
+  };
+};
+
+/** Default option bag for the Draco loader. */
+export const DRACO_LOADER_DEFAULT_OPTIONS = {
+  backend: typeof WebAssembly === 'object' ? 'wasm' : 'javascript',
+  extraAttributes: {},
+  attributeNameEntry: undefined,
+  shape: 'arrow',
+  decoderProfile: 'full'
+} as const;

package/src/draco/draco-loader-types.ts

@@ -0,0 +1,77 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader, LoaderWithParser} from '@loaders.gl/core/loader-utils';
+import type {Table} from 'apache-arrow';
+import type {DracoMesh} from './lib/draco-types';
+import {
+  deserializeArrowWorkerResult,
+  serializeArrowWorkerResult
+} from '@loaders.gl/core/arrow-worker-transport';
+import {VERSION} from './lib/utils/version';
+import {DracoFormat} from './draco-format';
+import {
+  DRACO_LOADER_DEFAULT_OPTIONS,
+  type DracoDecoderBackend,
+  type DracoLoaderOptions
+} from './draco-loader-options';
+
+export type {DracoLoaderOptions} from './draco-loader-options';
+
+/** Preloads the parser-bearing Draco loader implementation. */
+async function preload(
+  _url: string,
+  options?: Record<string, unknown>
+): Promise<LoaderWithParser<DracoMesh | Table, never, DracoLoaderOptions>> {
+  const dracoLoaderOptions = options as DracoLoaderOptions | undefined;
+  switch (getDracoBackend(dracoLoaderOptions)) {
+    case 'wasm': {
+      const {DracoWASMLoaderWithParser} = await import('@loaders.gl/scene/draco-wasm-loader');
+      return DracoWASMLoaderWithParser;
+    }
+
+    case 'javascript': {
+      const {DracoJavaScriptLoaderWithParser} = await import(
+        '@loaders.gl/scene/draco-javascript-loader'
+      );
+      return DracoJavaScriptLoaderWithParser;
+    }
+
+    case 'draco3d': {
+      const {Draco3DLoaderWithParser} = await import('@loaders.gl/scene/draco3d-loader');
+      return Draco3DLoaderWithParser;
+    }
+
+    default:
+      throw new Error(`DracoLoader: unsupported backend "${dracoLoaderOptions?.draco?.backend}"`);
+  }
+}
+
+/** Metadata-only worker loader for Draco3D compressed geometries. */
+export const DracoLoader = {
+  defaultShape: 'arrow',
+  supportsNativeArrow: true,
+  dataType: null as unknown as DracoMesh | Table,
+  batchType: null as never,
+  ...DracoFormat,
+  // shapes: ['mesh'],
+  version: VERSION,
+  worker: true,
+  /** Node test workers live with the Draco implementation. */
+  workerSourceNode: 'draco/workers/draco-worker-node.ts',
+  serializeWorkerResult: serializeArrowWorkerResult,
+  deserializeWorkerResult: deserializeArrowWorkerResult,
+  options: {
+    draco: DRACO_LOADER_DEFAULT_OPTIONS
+  },
+  preload
+} as const satisfies Loader<DracoMesh | Table, never, DracoLoaderOptions>;
+
+/** Resolves the Draco decoder backend from loader options. */
+function getDracoBackend(options?: DracoLoaderOptions): DracoDecoderBackend {
+  if (options?.draco?.backend) {
+    return options.draco.backend === 'js' ? 'javascript' : options.draco.backend;
+  }
+  return DracoLoader.options.draco.backend;
+}