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

package/dist/gltf/gltf-source.cjs

@@ -0,0 +1,236 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/gltf/gltf-source.ts
+var gltf_source_exports = {};
+__export(gltf_source_exports, {
+  GLTFSource: () => GLTFSource
+});
+module.exports = __toCommonJS(gltf_source_exports);
+var GLTFSource = class _GLTFSource {
+  /** Canonical URL of the root document, including redirects. */
+  url;
+  /** Parsed container and lazily resolved resources. */
+  gltf;
+  /** Original glTF JSON without extension decoding. */
+  json;
+  /** Fetch implementation used for lazy requests. */
+  fetcher;
+  /** Maximum traversal depth relative to each scene root. */
+  maxDepth;
+  /** Requests shared by canonical resource URL. */
+  pending = /* @__PURE__ */ new Map();
+  /** Downloaded bytes shared by canonical resource URL. */
+  cache = /* @__PURE__ */ new Map();
+  /** Cancellation signal shared by resource requests. */
+  controller = new AbortController();
+  /** Whether this source has been closed. */
+  closed = false;
+  /** Initialize an open source around the parsed container. */
+  constructor(url, gltf, options) {
+    this.url = url;
+    this.gltf = gltf;
+    this.json = gltf.json;
+    this.fetcher = options.fetch || globalThis.fetch.bind(globalThis);
+    this.maxDepth = options.maxDepth ?? 256;
+  }
+  /** Load the root JSON or GLB container without fetching external resources. */
+  static async open(url, options = {}) {
+    if (options.maxDepth !== void 0 && (!Number.isSafeInteger(options.maxDepth) || options.maxDepth < 0)) {
+      throw new Error("maxDepth must be a nonnegative safe integer");
+    }
+    const fetcher = options.fetch || globalThis.fetch.bind(globalThis);
+    const response = await fetcher(url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch glTF ${url}: HTTP ${response.status}`);
+    }
+    const bytes = await response.arrayBuffer();
+    url = response.url || url;
+    const baseUrl = new URL(".", url).href;
+    const { parse: parseGLTF } = await import("./gltf-loader.cjs");
+    const { EXTENSIONS } = await import("./lib/api/gltf-extensions.cjs");
+    const gltf = await parseGLTF(
+      bytes,
+      {
+        core: { baseUrl },
+        gltf: {
+          normalize: false,
+          excludeExtensions: EXTENSIONS.map((extension) => extension.name),
+          loadBuffers: false,
+          loadImages: false,
+          loadAudio: false,
+          loadFiles: false,
+          loadExternalAssets: false,
+          decompressMeshes: false
+        }
+      },
+      { url, fetch: fetcher }
+    );
+    return new _GLTFSource(url, gltf, options);
+  }
+  /** Return an unmodified glTF scene definition. */
+  getScene(index = this.json.scene ?? 0) {
+    this.assertOpen();
+    const scene = this.json.scenes?.[index];
+    if (!scene) throw new Error(`Invalid glTF scene index ${index}`);
+    return scene;
+  }
+  /** Return an unmodified glTF node definition. */
+  getNode(index) {
+    this.assertOpen();
+    const node = this.json.nodes?.[index];
+    if (!node) throw new Error(`Invalid glTF node index ${index}`);
+    return node;
+  }
+  /** Traverse a scene's native node indices in depth-first order. */
+  *traverse(sceneIndex = this.json.scene ?? 0) {
+    const scene = this.getScene(sceneIndex);
+    const active = /* @__PURE__ */ new Set();
+    const visit = function* (source, index, depth) {
+      if (depth > source.maxDepth) throw new Error("glTF node traversal depth exceeded");
+      if (active.has(index)) throw new Error(`Cycle in glTF node hierarchy at index ${index}`);
+      const node = source.getNode(index);
+      active.add(index);
+      try {
+        yield { index, node };
+        for (const child of node.children || []) yield* visit(source, child, depth + 1);
+      } finally {
+        active.delete(index);
+      }
+    };
+    for (const index of scene.nodes || []) yield* visit(this, index, 0);
+  }
+  /** Fetch an external or data-URI buffer, or return an embedded GLB buffer. */
+  async resolveBuffer(index) {
+    this.assertOpen();
+    const definition = this.json.buffers?.[index];
+    if (!definition) throw new Error(`Invalid glTF buffer index ${index}`);
+    const embedded = this.gltf.buffers[index];
+    if (embedded) {
+      if (embedded.byteLength < definition.byteLength)
+        throw new Error(`Truncated glTF buffer ${index}`);
+      embedded.byteLength = definition.byteLength;
+      return embedded;
+    }
+    if (!definition.uri) throw new Error(`glTF buffer ${index} has no embedded data or URI`);
+    const data = await this.fetchBytes(definition.uri);
+    if (data.byteLength < definition.byteLength) throw new Error(`Truncated glTF buffer ${index}`);
+    this.assertOpen();
+    const buffer = { arrayBuffer: data, byteOffset: 0, byteLength: definition.byteLength };
+    this.gltf.buffers[index] = buffer;
+    return buffer;
+  }
+  /** Resolve a glTF 2.1 file entry without loading unrelated resources. */
+  async resolveFile(index) {
+    this.assertOpen();
+    const definition = this.json.files?.[index];
+    if (!definition) throw new Error(`Invalid glTF file index ${index}`);
+    const existing = this.gltf.files?.[index];
+    if (existing) return existing;
+    if (!definition.mimeType) throw new Error(`glTF file ${index} lacks mimeType`);
+    if (definition.uri === void 0 === (definition.bufferView === void 0)) {
+      throw new Error(`glTF file ${index} must specify exactly one of uri or bufferView`);
+    }
+    let arrayBuffer;
+    let byteOffset = 0;
+    let byteLength;
+    if (definition.uri !== void 0) {
+      arrayBuffer = await this.fetchBytes(definition.uri);
+      byteLength = arrayBuffer.byteLength;
+    } else {
+      const view = this.json.bufferViews?.[definition.bufferView];
+      if (!view) throw new Error(`Invalid glTF file bufferView ${definition.bufferView}`);
+      const buffer = await this.resolveBuffer(view.buffer);
+      arrayBuffer = buffer.arrayBuffer;
+      const viewOffset = view.byteOffset ?? 0;
+      byteOffset = buffer.byteOffset + viewOffset;
+      byteLength = view.byteLength;
+      if (!Number.isSafeInteger(viewOffset) || viewOffset < 0 || !Number.isSafeInteger(byteLength) || byteLength < 0 || viewOffset + byteLength > buffer.byteLength || byteOffset + byteLength > arrayBuffer.byteLength) {
+        throw new Error("glTF file bufferView exceeds buffer");
+      }
+    }
+    this.assertOpen();
+    const result = {
+      arrayBuffer,
+      byteOffset,
+      byteLength,
+      mimeType: definition.mimeType,
+      name: definition.name,
+      ...definition.uri ? { url: new URL(definition.uri, this.url).href } : {}
+    };
+    this.gltf.files ||= new Array(this.json.files?.length || 0).fill(null);
+    this.gltf.files[index] = result;
+    return result;
+  }
+  /** Release source-owned cached bytes and cancel outstanding fetches. */
+  close() {
+    if (this.closed) return;
+    this.closed = true;
+    this.controller.abort();
+    this.cache.clear();
+    this.pending.clear();
+    this.gltf.buffers.length = 0;
+    if (this.gltf.files) this.gltf.files.length = 0;
+    Reflect.deleteProperty(this.gltf, "_glb");
+    delete this.gltf.binary;
+  }
+  /** Reject operations after close. */
+  assertOpen() {
+    if (this.closed) throw new Error("GLTFSource is closed");
+  }
+  /** Fetch bytes once per URL, allowing failed requests to be retried. */
+  async fetchBytes(uri) {
+    this.assertOpen();
+    const key = new URL(uri, this.url).href;
+    const cached = this.cache.get(key);
+    if (cached) return cached;
+    const inFlight = this.pending.get(key);
+    if (inFlight) return inFlight;
+    const promise = (async () => {
+      const response = await this.fetcher(key, { signal: this.controller.signal });
+      if (!response.ok)
+        throw new Error(`Failed to fetch glTF resource ${key}: HTTP ${response.status}`);
+      const data = await response.arrayBuffer();
+      this.assertOpen();
+      this.cache.set(key, data);
+      return data;
+    })();
+    this.pending.set(key, promise);
+    try {
+      return await promise;
+    } finally {
+      this.pending.delete(key);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GLTFSource
+});
+//# sourceMappingURL=gltf-source.cjs.map

package/dist/gltf/gltf-source.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gltf/gltf-source.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {GLTF, GLTFNode, GLTFScene} from './lib/types/gltf-json-schema';\nimport type {GLTFExternalBuffer, GLTFExternalFile, GLTFWithBuffers} from './lib/types/gltf-types';\n\n/** Options for a persistent, CPU-only glTF source. */\nexport type GLTFSourceOptions = {\n  /** Override the platform fetch implementation. */\n  fetch?: typeof fetch;\n  /** Maximum number of nested node references traversed. */\n  maxDepth?: number;\n};\n\n/**\n * Persistent, schema-preserving access to a glTF document and its resources.\n *\n * Opening reads the root document, but does not fetch external buffers, images or assets.\n * The source owns its resource cache and outstanding requests. No GPU resources are created.\n */\nexport class GLTFSource {\n  /** Canonical URL of the root document, including redirects. */\n  readonly url: string;\n  /** Parsed container and lazily resolved resources. */\n  readonly gltf: GLTFWithBuffers;\n  /** Original glTF JSON without extension decoding. */\n  readonly json: GLTF;\n  /** Fetch implementation used for lazy requests. */\n  private readonly fetcher: typeof fetch;\n  /** Maximum traversal depth relative to each scene root. */\n  private readonly maxDepth: number;\n  /** Requests shared by canonical resource URL. */\n  private readonly pending = new Map<string, Promise<ArrayBuffer>>();\n  /** Downloaded bytes shared by canonical resource URL. */\n  private readonly cache = new Map<string, ArrayBuffer>();\n  /** Cancellation signal shared by resource requests. */\n  private readonly controller = new AbortController();\n  /** Whether this source has been closed. */\n  private closed = false;\n\n  /** Initialize an open source around the parsed container. */\n  private constructor(url: string, gltf: GLTFWithBuffers, options: GLTFSourceOptions) {\n    this.url = url;\n    this.gltf = gltf;\n    this.json = gltf.json;\n    this.fetcher = options.fetch || globalThis.fetch.bind(globalThis);\n    this.maxDepth = options.maxDepth ?? 256;\n  }\n\n  /** Load the root JSON or GLB container without fetching external resources. */\n  static async open(url: string, options: GLTFSourceOptions = {}): Promise<GLTFSource> {\n    if (\n      options.maxDepth !== undefined &&\n      (!Number.isSafeInteger(options.maxDepth) || options.maxDepth < 0)\n    ) {\n      throw new Error('maxDepth must be a nonnegative safe integer');\n    }\n    const fetcher = options.fetch || globalThis.fetch.bind(globalThis);\n    const response = await fetcher(url);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch glTF ${url}: HTTP ${response.status}`);\n    }\n    const bytes = await response.arrayBuffer();\n    url = response.url || url;\n    const baseUrl = new URL('.', url).href;\n    const {parse: parseGLTF} = await import('./gltf-loader');\n    const {EXTENSIONS} = await import('./lib/api/gltf-extensions');\n    const gltf = await parseGLTF(\n      bytes,\n      {\n        core: {baseUrl},\n        gltf: {\n          normalize: false,\n          excludeExtensions: EXTENSIONS.map(extension => extension.name),\n          loadBuffers: false,\n          loadImages: false,\n          loadAudio: false,\n          loadFiles: false,\n          loadExternalAssets: false,\n          decompressMeshes: false\n        }\n      },\n      {url, fetch: fetcher}\n    );\n    return new GLTFSource(url, gltf, options);\n  }\n\n  /** Return an unmodified glTF scene definition. */\n  getScene(index: number = this.json.scene ?? 0): GLTFScene {\n    this.assertOpen();\n    const scene = this.json.scenes?.[index];\n    if (!scene) throw new Error(`Invalid glTF scene index ${index}`);\n    return scene;\n  }\n\n  /** Return an unmodified glTF node definition. */\n  getNode(index: number): GLTFNode {\n    this.assertOpen();\n    const node = this.json.nodes?.[index];\n    if (!node) throw new Error(`Invalid glTF node index ${index}`);\n    return node;\n  }\n\n  /** Traverse a scene's native node indices in depth-first order. */\n  *traverse(\n    sceneIndex: number = this.json.scene ?? 0\n  ): IterableIterator<{index: number; node: GLTFNode}> {\n    const scene = this.getScene(sceneIndex);\n    const active = new Set<number>();\n    /** Visit one node while tracking only the current ancestry path. */\n    const visit = function* (\n      source: GLTFSource,\n      index: number,\n      depth: number\n    ): IterableIterator<{index: number; node: GLTFNode}> {\n      if (depth > source.maxDepth) throw new Error('glTF node traversal depth exceeded');\n      if (active.has(index)) throw new Error(`Cycle in glTF node hierarchy at index ${index}`);\n      const node = source.getNode(index);\n      active.add(index);\n      try {\n        yield {index, node};\n        for (const child of node.children || []) yield* visit(source, child, depth + 1);\n      } finally {\n        active.delete(index);\n      }\n    };\n    for (const index of scene.nodes || []) yield* visit(this, index, 0);\n  }\n\n  /** Fetch an external or data-URI buffer, or return an embedded GLB buffer. */\n  async resolveBuffer(index: number): Promise<GLTFExternalBuffer> {\n    this.assertOpen();\n    const definition = this.json.buffers?.[index];\n    if (!definition) throw new Error(`Invalid glTF buffer index ${index}`);\n    const embedded = this.gltf.buffers[index];\n    if (embedded) {\n      if (embedded.byteLength < definition.byteLength)\n        throw new Error(`Truncated glTF buffer ${index}`);\n      embedded.byteLength = definition.byteLength;\n      return embedded;\n    }\n    if (!definition.uri) throw new Error(`glTF buffer ${index} has no embedded data or URI`);\n    const data = await this.fetchBytes(definition.uri);\n    if (data.byteLength < definition.byteLength) throw new Error(`Truncated glTF buffer ${index}`);\n    this.assertOpen();\n    const buffer = {arrayBuffer: data, byteOffset: 0, byteLength: definition.byteLength};\n    this.gltf.buffers[index] = buffer;\n    return buffer;\n  }\n\n  /** Resolve a glTF 2.1 file entry without loading unrelated resources. */\n  async resolveFile(index: number): Promise<GLTFExternalFile> {\n    this.assertOpen();\n    const definition = this.json.files?.[index];\n    if (!definition) throw new Error(`Invalid glTF file index ${index}`);\n    const existing = this.gltf.files?.[index];\n    if (existing) return existing;\n    if (!definition.mimeType) throw new Error(`glTF file ${index} lacks mimeType`);\n    if ((definition.uri === undefined) === (definition.bufferView === undefined)) {\n      throw new Error(`glTF file ${index} must specify exactly one of uri or bufferView`);\n    }\n    let arrayBuffer: ArrayBuffer;\n    let byteOffset = 0;\n    let byteLength: number;\n    if (definition.uri !== undefined) {\n      arrayBuffer = await this.fetchBytes(definition.uri);\n      byteLength = arrayBuffer.byteLength;\n    } else {\n      const view = this.json.bufferViews?.[definition.bufferView!];\n      if (!view) throw new Error(`Invalid glTF file bufferView ${definition.bufferView}`);\n      const buffer = await this.resolveBuffer(view.buffer);\n      arrayBuffer = buffer.arrayBuffer;\n      const viewOffset = view.byteOffset ?? 0;\n      byteOffset = buffer.byteOffset + viewOffset;\n      byteLength = view.byteLength;\n      if (\n        !Number.isSafeInteger(viewOffset) ||\n        viewOffset < 0 ||\n        !Number.isSafeInteger(byteLength) ||\n        byteLength < 0 ||\n        viewOffset + byteLength > buffer.byteLength ||\n        byteOffset + byteLength > arrayBuffer.byteLength\n      ) {\n        throw new Error('glTF file bufferView exceeds buffer');\n      }\n    }\n    this.assertOpen();\n    const result: GLTFExternalFile = {\n      arrayBuffer,\n      byteOffset,\n      byteLength,\n      mimeType: definition.mimeType,\n      name: definition.name,\n      ...(definition.uri ? {url: new URL(definition.uri, this.url).href} : {})\n    };\n    this.gltf.files ||= new Array(this.json.files?.length || 0).fill(null);\n    this.gltf.files[index] = result;\n    return result;\n  }\n\n  /** Release source-owned cached bytes and cancel outstanding fetches. */\n  close(): void {\n    if (this.closed) return;\n    this.closed = true;\n    this.controller.abort();\n    this.cache.clear();\n    this.pending.clear();\n    this.gltf.buffers.length = 0;\n    if (this.gltf.files) this.gltf.files.length = 0;\n    Reflect.deleteProperty(this.gltf, '_glb');\n    delete this.gltf.binary;\n  }\n\n  /** Reject operations after close. */\n  private assertOpen(): void {\n    if (this.closed) throw new Error('GLTFSource is closed');\n  }\n\n  /** Fetch bytes once per URL, allowing failed requests to be retried. */\n  private async fetchBytes(uri: string): Promise<ArrayBuffer> {\n    this.assertOpen();\n    const key = new URL(uri, this.url).href;\n    const cached = this.cache.get(key);\n    if (cached) return cached;\n    const inFlight = this.pending.get(key);\n    if (inFlight) return inFlight;\n    const promise = (async () => {\n      const response = await this.fetcher(key, {signal: this.controller.signal});\n      if (!response.ok)\n        throw new Error(`Failed to fetch glTF resource ${key}: HTTP ${response.status}`);\n      const data = await response.arrayBuffer();\n      this.assertOpen();\n      this.cache.set(key, data);\n      return data;\n    })();\n    this.pending.set(key, promise);\n    try {\n      return await promise;\n    } finally {\n      this.pending.delete(key);\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/gltf-source.d.ts

@@ -0,0 +1,59 @@
+import type { GLTF, GLTFNode, GLTFScene } from "./lib/types/gltf-json-schema.js";
+import type { GLTFExternalBuffer, GLTFExternalFile, GLTFWithBuffers } from "./lib/types/gltf-types.js";
+/** Options for a persistent, CPU-only glTF source. */
+export type GLTFSourceOptions = {
+    /** Override the platform fetch implementation. */
+    fetch?: typeof fetch;
+    /** Maximum number of nested node references traversed. */
+    maxDepth?: number;
+};
+/**
+ * Persistent, schema-preserving access to a glTF document and its resources.
+ *
+ * Opening reads the root document, but does not fetch external buffers, images or assets.
+ * The source owns its resource cache and outstanding requests. No GPU resources are created.
+ */
+export declare class GLTFSource {
+    /** Canonical URL of the root document, including redirects. */
+    readonly url: string;
+    /** Parsed container and lazily resolved resources. */
+    readonly gltf: GLTFWithBuffers;
+    /** Original glTF JSON without extension decoding. */
+    readonly json: GLTF;
+    /** Fetch implementation used for lazy requests. */
+    private readonly fetcher;
+    /** Maximum traversal depth relative to each scene root. */
+    private readonly maxDepth;
+    /** Requests shared by canonical resource URL. */
+    private readonly pending;
+    /** Downloaded bytes shared by canonical resource URL. */
+    private readonly cache;
+    /** Cancellation signal shared by resource requests. */
+    private readonly controller;
+    /** Whether this source has been closed. */
+    private closed;
+    /** Initialize an open source around the parsed container. */
+    private constructor();
+    /** Load the root JSON or GLB container without fetching external resources. */
+    static open(url: string, options?: GLTFSourceOptions): Promise<GLTFSource>;
+    /** Return an unmodified glTF scene definition. */
+    getScene(index?: number): GLTFScene;
+    /** Return an unmodified glTF node definition. */
+    getNode(index: number): GLTFNode;
+    /** Traverse a scene's native node indices in depth-first order. */
+    traverse(sceneIndex?: number): IterableIterator<{
+        index: number;
+        node: GLTFNode;
+    }>;
+    /** Fetch an external or data-URI buffer, or return an embedded GLB buffer. */
+    resolveBuffer(index: number): Promise<GLTFExternalBuffer>;
+    /** Resolve a glTF 2.1 file entry without loading unrelated resources. */
+    resolveFile(index: number): Promise<GLTFExternalFile>;
+    /** Release source-owned cached bytes and cancel outstanding fetches. */
+    close(): void;
+    /** Reject operations after close. */
+    private assertOpen;
+    /** Fetch bytes once per URL, allowing failed requests to be retried. */
+    private fetchBytes;
+}
+//# sourceMappingURL=gltf-source.d.ts.map

package/dist/gltf/gltf-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-source.d.ts","sourceRoot":"","sources":["../../src/gltf/gltf-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAC,wCAAqC;AAC5E,OAAO,KAAK,EAAC,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAC,kCAA+B;AAElG,sDAAsD;AACtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,2CAA2C;IAC3C,OAAO,CAAC,MAAM,CAAS;IAEvB,6DAA6D;IAC7D,OAAO;IAQP,+EAA+E;WAClE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqCpF,kDAAkD;IAClD,QAAQ,CAAC,KAAK,GAAE,MAA6B,GAAG,SAAS;IAOzD,iDAAiD;IACjD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ;IAOhC,mEAAmE;IAClE,QAAQ,CACP,UAAU,GAAE,MAA6B,GACxC,gBAAgB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAC,CAAC;IAuBpD,8EAA8E;IACxE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoB/D,yEAAyE;IACnE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiD3D,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAYb,qCAAqC;IACrC,OAAO,CAAC,UAAU;IAIlB,wEAAwE;YAC1D,UAAU;CAuBzB"}

package/dist/gltf/gltf-source.js

@@ -0,0 +1,230 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Persistent, schema-preserving access to a glTF document and its resources.
+ *
+ * Opening reads the root document, but does not fetch external buffers, images or assets.
+ * The source owns its resource cache and outstanding requests. No GPU resources are created.
+ */
+export class GLTFSource {
+    /** Canonical URL of the root document, including redirects. */
+    url;
+    /** Parsed container and lazily resolved resources. */
+    gltf;
+    /** Original glTF JSON without extension decoding. */
+    json;
+    /** Fetch implementation used for lazy requests. */
+    fetcher;
+    /** Maximum traversal depth relative to each scene root. */
+    maxDepth;
+    /** Requests shared by canonical resource URL. */
+    pending = new Map();
+    /** Downloaded bytes shared by canonical resource URL. */
+    cache = new Map();
+    /** Cancellation signal shared by resource requests. */
+    controller = new AbortController();
+    /** Whether this source has been closed. */
+    closed = false;
+    /** Initialize an open source around the parsed container. */
+    constructor(url, gltf, options) {
+        this.url = url;
+        this.gltf = gltf;
+        this.json = gltf.json;
+        this.fetcher = options.fetch || globalThis.fetch.bind(globalThis);
+        this.maxDepth = options.maxDepth ?? 256;
+    }
+    /** Load the root JSON or GLB container without fetching external resources. */
+    static async open(url, options = {}) {
+        if (options.maxDepth !== undefined &&
+            (!Number.isSafeInteger(options.maxDepth) || options.maxDepth < 0)) {
+            throw new Error('maxDepth must be a nonnegative safe integer');
+        }
+        const fetcher = options.fetch || globalThis.fetch.bind(globalThis);
+        const response = await fetcher(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch glTF ${url}: HTTP ${response.status}`);
+        }
+        const bytes = await response.arrayBuffer();
+        url = response.url || url;
+        const baseUrl = new URL('.', url).href;
+        const { parse: parseGLTF } = await import("./gltf-loader.js");
+        const { EXTENSIONS } = await import("./lib/api/gltf-extensions.js");
+        const gltf = await parseGLTF(bytes, {
+            core: { baseUrl },
+            gltf: {
+                normalize: false,
+                excludeExtensions: EXTENSIONS.map(extension => extension.name),
+                loadBuffers: false,
+                loadImages: false,
+                loadAudio: false,
+                loadFiles: false,
+                loadExternalAssets: false,
+                decompressMeshes: false
+            }
+        }, { url, fetch: fetcher });
+        return new GLTFSource(url, gltf, options);
+    }
+    /** Return an unmodified glTF scene definition. */
+    getScene(index = this.json.scene ?? 0) {
+        this.assertOpen();
+        const scene = this.json.scenes?.[index];
+        if (!scene)
+            throw new Error(`Invalid glTF scene index ${index}`);
+        return scene;
+    }
+    /** Return an unmodified glTF node definition. */
+    getNode(index) {
+        this.assertOpen();
+        const node = this.json.nodes?.[index];
+        if (!node)
+            throw new Error(`Invalid glTF node index ${index}`);
+        return node;
+    }
+    /** Traverse a scene's native node indices in depth-first order. */
+    *traverse(sceneIndex = this.json.scene ?? 0) {
+        const scene = this.getScene(sceneIndex);
+        const active = new Set();
+        /** Visit one node while tracking only the current ancestry path. */
+        const visit = function* (source, index, depth) {
+            if (depth > source.maxDepth)
+                throw new Error('glTF node traversal depth exceeded');
+            if (active.has(index))
+                throw new Error(`Cycle in glTF node hierarchy at index ${index}`);
+            const node = source.getNode(index);
+            active.add(index);
+            try {
+                yield { index, node };
+                for (const child of node.children || [])
+                    yield* visit(source, child, depth + 1);
+            }
+            finally {
+                active.delete(index);
+            }
+        };
+        for (const index of scene.nodes || [])
+            yield* visit(this, index, 0);
+    }
+    /** Fetch an external or data-URI buffer, or return an embedded GLB buffer. */
+    async resolveBuffer(index) {
+        this.assertOpen();
+        const definition = this.json.buffers?.[index];
+        if (!definition)
+            throw new Error(`Invalid glTF buffer index ${index}`);
+        const embedded = this.gltf.buffers[index];
+        if (embedded) {
+            if (embedded.byteLength < definition.byteLength)
+                throw new Error(`Truncated glTF buffer ${index}`);
+            embedded.byteLength = definition.byteLength;
+            return embedded;
+        }
+        if (!definition.uri)
+            throw new Error(`glTF buffer ${index} has no embedded data or URI`);
+        const data = await this.fetchBytes(definition.uri);
+        if (data.byteLength < definition.byteLength)
+            throw new Error(`Truncated glTF buffer ${index}`);
+        this.assertOpen();
+        const buffer = { arrayBuffer: data, byteOffset: 0, byteLength: definition.byteLength };
+        this.gltf.buffers[index] = buffer;
+        return buffer;
+    }
+    /** Resolve a glTF 2.1 file entry without loading unrelated resources. */
+    async resolveFile(index) {
+        this.assertOpen();
+        const definition = this.json.files?.[index];
+        if (!definition)
+            throw new Error(`Invalid glTF file index ${index}`);
+        const existing = this.gltf.files?.[index];
+        if (existing)
+            return existing;
+        if (!definition.mimeType)
+            throw new Error(`glTF file ${index} lacks mimeType`);
+        if ((definition.uri === undefined) === (definition.bufferView === undefined)) {
+            throw new Error(`glTF file ${index} must specify exactly one of uri or bufferView`);
+        }
+        let arrayBuffer;
+        let byteOffset = 0;
+        let byteLength;
+        if (definition.uri !== undefined) {
+            arrayBuffer = await this.fetchBytes(definition.uri);
+            byteLength = arrayBuffer.byteLength;
+        }
+        else {
+            const view = this.json.bufferViews?.[definition.bufferView];
+            if (!view)
+                throw new Error(`Invalid glTF file bufferView ${definition.bufferView}`);
+            const buffer = await this.resolveBuffer(view.buffer);
+            arrayBuffer = buffer.arrayBuffer;
+            const viewOffset = view.byteOffset ?? 0;
+            byteOffset = buffer.byteOffset + viewOffset;
+            byteLength = view.byteLength;
+            if (!Number.isSafeInteger(viewOffset) ||
+                viewOffset < 0 ||
+                !Number.isSafeInteger(byteLength) ||
+                byteLength < 0 ||
+                viewOffset + byteLength > buffer.byteLength ||
+                byteOffset + byteLength > arrayBuffer.byteLength) {
+                throw new Error('glTF file bufferView exceeds buffer');
+            }
+        }
+        this.assertOpen();
+        const result = {
+            arrayBuffer,
+            byteOffset,
+            byteLength,
+            mimeType: definition.mimeType,
+            name: definition.name,
+            ...(definition.uri ? { url: new URL(definition.uri, this.url).href } : {})
+        };
+        this.gltf.files ||= new Array(this.json.files?.length || 0).fill(null);
+        this.gltf.files[index] = result;
+        return result;
+    }
+    /** Release source-owned cached bytes and cancel outstanding fetches. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.controller.abort();
+        this.cache.clear();
+        this.pending.clear();
+        this.gltf.buffers.length = 0;
+        if (this.gltf.files)
+            this.gltf.files.length = 0;
+        Reflect.deleteProperty(this.gltf, '_glb');
+        delete this.gltf.binary;
+    }
+    /** Reject operations after close. */
+    assertOpen() {
+        if (this.closed)
+            throw new Error('GLTFSource is closed');
+    }
+    /** Fetch bytes once per URL, allowing failed requests to be retried. */
+    async fetchBytes(uri) {
+        this.assertOpen();
+        const key = new URL(uri, this.url).href;
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const inFlight = this.pending.get(key);
+        if (inFlight)
+            return inFlight;
+        const promise = (async () => {
+            const response = await this.fetcher(key, { signal: this.controller.signal });
+            if (!response.ok)
+                throw new Error(`Failed to fetch glTF resource ${key}: HTTP ${response.status}`);
+            const data = await response.arrayBuffer();
+            this.assertOpen();
+            this.cache.set(key, data);
+            return data;
+        })();
+        this.pending.set(key, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.pending.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=gltf-source.js.map

package/dist/gltf/gltf-source.js.map

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

package/dist/gltf/gltf-writer.cjs

@@ -0,0 +1,67 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/gltf/gltf-writer.ts
+var gltf_writer_exports = {};
+__export(gltf_writer_exports, {
+  GLTFWriter: () => GLTFWriter
+});
+module.exports = __toCommonJS(gltf_writer_exports);
+var import_version = require("./lib/utils/version.cjs");
+var import_encode_gltf = require("./lib/encoders/encode-gltf.cjs");
+var import_encode_gltf_draco = require("./lib/encoders/encode-gltf-draco.cjs");
+var import_gltf_extensions = require("./lib/api/gltf-extensions.cjs");
+var import_gltf_format = require("./gltf-format.cjs");
+var GLTFWriter = {
+  dataType: null,
+  batchType: null,
+  ...import_gltf_format.GLTFFormat,
+  version: import_version.VERSION,
+  options: {
+    gltf: {}
+  },
+  encode: async (gltf, options = {}) => {
+    const compressed = await (0, import_encode_gltf_draco.compressGLTFWithDraco)(gltf, options);
+    const encodeOptions = { ...options };
+    encodeOptions.gltf = options.gltf ? { ...options.gltf, draco: void 0 } : void 0;
+    return encodeSync(compressed, encodeOptions);
+  },
+  encodeSync
+};
+function encodeSync(gltf, options = {}) {
+  if (options.gltf?.draco?.enabled) {
+    throw new Error(
+      "GLTFWriter Draco compression is asynchronous; use encode() instead of encodeSync()"
+    );
+  }
+  const { byteOffset = 0 } = options;
+  const gltfToEncode = (0, import_gltf_extensions.encodeExtensions)(gltf);
+  gltf.buffers = gltfToEncode.buffers;
+  gltf.binary = gltfToEncode.binary;
+  const byteLength = (0, import_encode_gltf.encodeGLTFSync)(gltfToEncode, null, byteOffset, options);
+  const arrayBuffer = new ArrayBuffer(byteLength);
+  const dataView = new DataView(arrayBuffer);
+  (0, import_encode_gltf.encodeGLTFSync)(gltfToEncode, dataView, byteOffset, options);
+  return arrayBuffer;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GLTFWriter
+});
+//# sourceMappingURL=gltf-writer.cjs.map

package/dist/gltf/gltf-writer.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gltf/gltf-writer.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport type {WriterOptions, WriterWithEncoder} from '@loaders.gl/core/loader-utils';\nimport {VERSION} from './lib/utils/version';\nimport {encodeGLTFSync} from './lib/encoders/encode-gltf';\nimport type {GLTFWithBuffers} from './lib/types/gltf-types';\nimport {compressGLTFWithDraco, type GLTFDracoWriterOptions} from './lib/encoders/encode-gltf-draco';\nimport {encodeExtensions} from './lib/api/gltf-extensions';\nimport {GLTFFormat} from './gltf-format';\n\nexport type GLTFWriterOptions = WriterOptions & {\n  gltf?: {\n    /** Optional glTF-specific encoding features. */\n    draco?: GLTFDracoWriterOptions;\n  };\n  byteOffset?: number;\n};\n\n/**\n * GLTF exporter\n */\nexport const GLTFWriter = {\n  dataType: null as unknown as any,\n  batchType: null as never,\n\n  ...GLTFFormat,\n  version: VERSION,\n  options: {\n    gltf: {}\n  },\n\n  encode: async (gltf: GLTFWithBuffers, options: GLTFWriterOptions = {}) => {\n    const compressed = await compressGLTFWithDraco(gltf, options);\n    const encodeOptions = {...options};\n    encodeOptions.gltf = options.gltf ? {...options.gltf, draco: undefined} : undefined;\n    return encodeSync(compressed, encodeOptions);\n  },\n  encodeSync\n} as WriterWithEncoder<any, never, GLTFWriterOptions>;\n\nfunction encodeSync(gltf: GLTFWithBuffers, options: GLTFWriterOptions = {}) {\n  if (options.gltf?.draco?.enabled) {\n    throw new Error(\n      'GLTFWriter Draco compression is asynchronous; use encode() instead of encodeSync()'\n    );\n  }\n  const {byteOffset = 0} = options;\n  const gltfToEncode = encodeExtensions(gltf);\n  // Extension encoders repack JSON buffer references; keep the input container in sync.\n  gltf.buffers = gltfToEncode.buffers;\n  gltf.binary = gltfToEncode.binary;\n\n  // Calculate length, then create arraybuffer and encode\n  const byteLength = encodeGLTFSync(gltfToEncode, null, byteOffset, options);\n  const arrayBuffer = new ArrayBuffer(byteLength);\n  const dataView = new DataView(arrayBuffer);\n  encodeGLTFSync(gltfToEncode, dataView, byteOffset, options);\n\n  return arrayBuffer;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,qBAAsB;AACtB,yBAA6B;AAE7B,+BAAiE;AACjE,6BAA+B;AAC/B,yBAAyB;AAalB,IAAM,aAAa;AAAA,EACxB,UAAU;AAAA,EACV,WAAW;AAAA,EAEX,GAAG;AAAA,EACH,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM,CAAC;AAAA,EACT;AAAA,EAEA,QAAQ,OAAO,MAAuB,UAA6B,CAAC,MAAM;AACxE,UAAM,aAAa,UAAM,gDAAsB,MAAM,OAAO;AAC5D,UAAM,gBAAgB,EAAC,GAAG,QAAO;AACjC,kBAAc,OAAO,QAAQ,OAAO,EAAC,GAAG,QAAQ,MAAM,OAAO,OAAS,IAAI;AAC1E,WAAO,WAAW,YAAY,aAAa;AAAA,EAC7C;AAAA,EACA;AACF;AAEA,SAAS,WAAW,MAAuB,UAA6B,CAAC,GAAG;AAC1E,MAAI,QAAQ,MAAM,OAAO,SAAS;AAChC,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,EAAC,aAAa,EAAC,IAAI;AACzB,QAAM,mBAAe,yCAAiB,IAAI;AAE1C,OAAK,UAAU,aAAa;AAC5B,OAAK,SAAS,aAAa;AAG3B,QAAM,iBAAa,mCAAe,cAAc,MAAM,YAAY,OAAO;AACzE,QAAM,cAAc,IAAI,YAAY,UAAU;AAC9C,QAAM,WAAW,IAAI,SAAS,WAAW;AACzC,yCAAe,cAAc,UAAU,YAAY,OAAO;AAE1D,SAAO;AACT;",
+  "names": []
+}