@loaders.gl/scene 5.0.0-beta.1 → 5.0.0-beta.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loaders.gl/scene",
-  "version": "5.0.0-beta.1",
-  "description": "Framework-independent loaders for scene description formats",
+  "version": "5.0.0-beta.4",
+  "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",
@@ -30,9 +35,9 @@
       "require": "./dist/index.cjs"
     },
     "./usd-loader": {
-      "types": "./dist/usd/usd-loader.d.ts",
-      "import": "./dist/usd/usd-loader.js",
-      "require": "./dist/usd/usd-loader.cjs"
+      "types": "./dist/usd-loader.d.ts",
+      "import": "./dist/usd-loader.js",
+      "require": "./dist/usd-loader.cjs"
     },
     "./obj": {
       "types": "./dist/obj/index.d.ts",
@@ -54,35 +59,35 @@
       "import": "./dist/obj/mtl-format.js",
       "require": "./dist/obj/mtl-format.cjs"
     },
-    "./obj/mtl-loader-types": {
-      "types": "./dist/obj/mtl-loader-types.d.ts",
-      "import": "./dist/obj/mtl-loader-types.js",
-      "require": "./dist/obj/mtl-loader-types.cjs"
+    "./mtl-loader-types": {
+      "types": "./dist/mtl-loader-types.d.ts",
+      "import": "./dist/mtl-loader-types.js",
+      "require": "./dist/mtl-loader-types.cjs"
     },
-    "./obj/mtl-loader": {
-      "types": "./dist/obj/mtl-loader.d.ts",
-      "import": "./dist/obj/mtl-loader.js",
-      "require": "./dist/obj/mtl-loader.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/obj-loader-types": {
-      "types": "./dist/obj/obj-loader-types.d.ts",
-      "import": "./dist/obj/obj-loader-types.js",
-      "require": "./dist/obj/obj-loader-types.cjs"
+    "./obj-loader-types": {
+      "types": "./dist/obj-loader-types.d.ts",
+      "import": "./dist/obj-loader-types.js",
+      "require": "./dist/obj-loader-types.cjs"
     },
-    "./obj/obj-loader": {
-      "types": "./dist/obj/obj-loader.d.ts",
-      "import": "./dist/obj/obj-loader.js",
-      "require": "./dist/obj/obj-loader.cjs"
+    "./obj-loader": {
+      "types": "./dist/obj-loader.d.ts",
+      "import": "./dist/obj-loader.js",
+      "require": "./dist/obj-loader.cjs"
     },
-    "./obj/obj-writer": {
-      "types": "./dist/obj/obj-writer.d.ts",
-      "import": "./dist/obj/obj-writer.js",
-      "require": "./dist/obj/obj-writer.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",
@@ -99,45 +104,45 @@
       "import": "./dist/gltf/bundled.js",
       "require": "./dist/gltf/bundled.cjs"
     },
-    "./gltf/glb-loader-types": {
-      "types": "./dist/gltf/glb-loader-types.d.ts",
-      "import": "./dist/gltf/glb-loader-types.js",
-      "require": "./dist/gltf/glb-loader-types.cjs"
+    "./glb-loader-types": {
+      "types": "./dist/glb-loader-types.d.ts",
+      "import": "./dist/glb-loader-types.js",
+      "require": "./dist/glb-loader-types.cjs"
     },
-    "./gltf/glb-loader": {
-      "types": "./dist/gltf/glb-loader.d.ts",
-      "import": "./dist/gltf/glb-loader.js",
-      "require": "./dist/gltf/glb-loader.cjs"
+    "./glb-loader": {
+      "types": "./dist/glb-loader.d.ts",
+      "import": "./dist/glb-loader.js",
+      "require": "./dist/glb-loader.cjs"
     },
-    "./gltf/glb-writer": {
-      "types": "./dist/gltf/glb-writer.d.ts",
-      "import": "./dist/gltf/glb-writer.js",
-      "require": "./dist/gltf/glb-writer.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/gltf-loader-types": {
-      "types": "./dist/gltf/gltf-loader-types.d.ts",
-      "import": "./dist/gltf/gltf-loader-types.js",
-      "require": "./dist/gltf/gltf-loader-types.cjs"
+    "./gltf-loader-types": {
+      "types": "./dist/gltf-loader-types.d.ts",
+      "import": "./dist/gltf-loader-types.js",
+      "require": "./dist/gltf-loader-types.cjs"
     },
-    "./gltf/gltf-loader": {
-      "types": "./dist/gltf/gltf-loader.d.ts",
-      "import": "./dist/gltf/gltf-loader.js",
-      "require": "./dist/gltf/gltf-loader.cjs"
+    "./gltf-loader": {
+      "types": "./dist/gltf-loader.d.ts",
+      "import": "./dist/gltf-loader.js",
+      "require": "./dist/gltf-loader.cjs"
     },
-    "./gltf/gltf-source": {
-      "types": "./dist/gltf/gltf-source.d.ts",
-      "import": "./dist/gltf/gltf-source.js",
-      "require": "./dist/gltf/gltf-source.cjs"
+    "./gltf-source": {
+      "types": "./dist/gltf-source.d.ts",
+      "import": "./dist/gltf-source.js",
+      "require": "./dist/gltf-source.cjs"
     },
-    "./gltf/gltf-writer": {
-      "types": "./dist/gltf/gltf-writer.d.ts",
-      "import": "./dist/gltf/gltf-writer.js",
-      "require": "./dist/gltf/gltf-writer.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",
@@ -176,15 +181,66 @@
       "import": "./dist/usd/index.js",
       "require": "./dist/usd/index.cjs"
     },
-    "./usd/usd-loader-types": {
-      "types": "./dist/usd/usd-loader-types.d.ts",
-      "import": "./dist/usd/usd-loader-types.js",
-      "require": "./dist/usd/usd-loader-types.cjs"
+    "./usd-loader-types": {
+      "types": "./dist/usd-loader-types.d.ts",
+      "import": "./dist/usd-loader-types.js",
+      "require": "./dist/usd-loader-types.cjs"
     },
-    "./usd/usd-loader": {
-      "types": "./dist/usd/usd-loader.d.ts",
-      "import": "./dist/usd/usd-loader.js",
-      "require": "./dist/usd/usd-loader.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"
     }
   },
   "sideEffects": false,
@@ -197,30 +253,39 @@
     "bin",
     "LICENSE",
     "THIRD-PARTY-NOTICES.md",
-    "third-party-licenses"
+    "third-party-licenses",
+    "DRACO-README.md"
   ],
   "scripts": {
-    "pre-build": "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",
+    "pre-build": "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-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-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\\\""
   },
   "peerDependencies": {
     "@loaders.gl/core": "~5.0.0-alpha.0"
   },
   "dependencies": {
-    "@loaders.gl/draco": "5.0.0-beta.1",
-    "@loaders.gl/images": "5.0.0-beta.1",
-    "@loaders.gl/textures": "5.0.0-beta.1",
-    "@math.gl/core": "5.0.0-beta.1",
-    "@math.gl/geometry": "5.0.0-beta.1",
+    "@loaders.gl/documents": "5.0.0-beta.4",
+    "@loaders.gl/images": "5.0.0-beta.4",
+    "@math.gl/core": "5.0.0-beta.4",
+    "@math.gl/geometry": "5.0.0-beta.4",
     "zod": "^4.1.12"
   },
   "devDependencies": {
     "meshoptimizer": "1.3.0"
   },
-  "gitHead": "89312301ed9e8ec89a58501c052a38284d1570c1"
+  "optionalDependencies": {
+    "draco3d": "1.5.7"
+  },
+  "gitHead": "c9420f06e870fa353889d55b684e3588d24574c2"
 }

package/src/draco/bundled.ts

@@ -0,0 +1,10 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export type {DracoLoaderOptions} from './draco-loader-options';
+export {DracoWASMLoaderWithParser as DracoWorkerLoader} from './draco-wasm-loader-with-parser';
+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,26 @@
+// 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 {ArrowTable} from '@loaders.gl/core/schema';
+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(options), 'js'),
+      context
+    )
+} as const satisfies LoaderWithParser<DracoMesh | ArrowTable, 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-table';
+    /** 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-table',
+  decoderProfile: 'full'
+} as const;

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

@@ -0,0 +1,78 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {Loader, LoaderWithParser} from '@loaders.gl/core/loader-utils';
+import type {ArrowTable} from '@loaders.gl/core/schema';
+import type {DracoMesh} from './lib/draco-types';
+import {
+  deserializeArrowWorkerResult,
+  serializeArrowWorkerResult
+} from '@loaders.gl/core/schema-utils/arrow-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 | ArrowTable, 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 = {
+  dataType: null as unknown as DracoMesh | ArrowTable,
+  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 | ArrowTable, never, DracoLoaderOptions>;
+
+/** @deprecated Use DracoLoader. */
+export const DracoWorkerLoader = DracoLoader;
+
+/** 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;
+}

package/src/draco/draco-loader.ts

@@ -0,0 +1,45 @@
+// 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 {ArrowTable} from '@loaders.gl/core/schema';
+import type {DracoMesh} from './lib/draco-types';
+import {parseDraco} from './lib/parse-draco';
+import {loadDracoDecoderModule} from './lib/draco-module-loader';
+import {DracoLoader as DracoLoaderMetadata} from './draco-loader-types';
+import type {DracoLoaderOptions} from './draco-loader-options';
+
+const {preload: _DracoLoaderPreload, ...DracoLoaderMetadataWithoutPreload} = DracoLoaderMetadata;
+
+export type {DracoLoaderOptions} from './draco-loader-options';
+
+/**
+ * Loader for Draco3D compressed geometries
+ */
+export const DracoLoaderWithParser = {
+  ...DracoLoaderMetadataWithoutPreload,
+  parse
+} as const satisfies LoaderWithParser<DracoMesh | ArrowTable, never, DracoLoaderOptions>;
+
+/** Decodes compressed geometry through the selected Draco runtime. */
+async function parse(
+  arrayBuffer: ArrayBuffer,
+  options?: DracoLoaderOptions,
+  context?: LoaderContext
+): Promise<DracoMesh | ArrowTable> {
+  return await parseDraco(
+    arrayBuffer,
+    options,
+    async () =>
+      await loadDracoDecoderModule(
+        extractLoadLibraryOptions(options),
+        options?.draco?.backend === 'javascript' || options?.draco?.backend === 'js'
+          ? 'js'
+          : 'wasm',
+        options?.draco?.decoderProfile
+      ),
+    context
+  );
+}

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

@@ -0,0 +1,31 @@
+// 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 {ArrowTable} from '@loaders.gl/core/schema';
+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 WASM decoder. */
+export const DracoWASMLoaderWithParser = {
+  ...DracoLoaderMetadataWithoutPreload,
+  parse: async (arrayBuffer: ArrayBuffer, options?: DracoLoaderOptions, context?: LoaderContext) =>
+    await parseDraco(
+      arrayBuffer,
+      options,
+      async () =>
+        await loadDracoDecoderModule(
+          extractLoadLibraryOptions(options),
+          'wasm',
+          options?.draco?.decoderProfile
+        ),
+      context
+    )
+} as const satisfies LoaderWithParser<DracoMesh | ArrowTable, never, DracoLoaderOptions>;