@loaders.gl/core 5.0.0-alpha.12 → 5.0.0-alpha.13

package/dist/loader-utils/lib/binary-utils/memory-conversion-utils.js

@@ -0,0 +1,82 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { isSharedArrayBuffer } from "../javascript-utils/is-type.js";
+import * as node from "../node/buffer.js";
+/**
+ * Check for Node.js `Buffer` (without triggering bundler to include Buffer polyfill on browser)
+ */
+export function isBuffer(value) {
+    return value && typeof value === 'object' && value.isBuffer;
+}
+/**
+ * Converts to Node.js `Buffer` (without triggering bundler to include Buffer polyfill on browser)
+ * @todo better data type
+ */
+export function toBuffer(data) {
+    return node.toBuffer ? node.toBuffer(data) : data;
+}
+/**
+ * Convert an object to an array buffer. Handles SharedArrayBuffers.
+ */
+export function toArrayBuffer(data) {
+    // Note: Should be called first, Buffers can trigger other detections below
+    if (isBuffer(data)) {
+        return node.toArrayBuffer(data);
+    }
+    if (data instanceof ArrayBuffer) {
+        return data;
+    }
+    if (isSharedArrayBuffer(data)) {
+        return copyToArrayBuffer(data);
+    }
+    // Node Buffers look like Uint8Arrays (Check isBuffer first)
+    if (ArrayBuffer.isView(data)) {
+        // TODO - ArrayBufferLike type mess
+        const buffer = data.buffer;
+        if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
+            return buffer;
+        }
+        return buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+    }
+    if (typeof data === 'string') {
+        const text = data;
+        const uint8Array = new TextEncoder().encode(text);
+        return uint8Array.buffer;
+    }
+    // HACK to support Blob polyfill
+    if (data && typeof data === 'object' && data._toArrayBuffer) {
+        return data._toArrayBuffer();
+    }
+    throw new Error('toArrayBuffer');
+}
+/** Ensure that SharedArrayBuffers are copied into ArrayBuffers */
+export function ensureArrayBuffer(bufferSource) {
+    if (bufferSource instanceof ArrayBuffer) {
+        return bufferSource;
+    }
+    if (isSharedArrayBuffer(bufferSource)) {
+        return copyToArrayBuffer(bufferSource);
+    }
+    const { buffer, byteOffset, byteLength } = bufferSource;
+    if (buffer instanceof ArrayBuffer && byteOffset === 0 && byteLength === buffer.byteLength) {
+        return buffer;
+    }
+    return copyToArrayBuffer(buffer, byteOffset, byteLength);
+}
+/** Copies an ArrayBuffer or a section of an ArrayBuffer to a new ArrayBuffer, handles SharedArrayBuffers */
+export function copyToArrayBuffer(buffer, byteOffset = 0, byteLength = buffer.byteLength - byteOffset) {
+    const view = new Uint8Array(buffer, byteOffset, byteLength);
+    const copy = new Uint8Array(view.length);
+    copy.set(view);
+    return copy.buffer;
+}
+/** Convert an object to an ArrayBufferView, handles SharedArrayBuffers */
+export function toArrayBufferView(data) {
+    if (ArrayBuffer.isView(data)) {
+        return data;
+    }
+    // Create a view to support ArrayBufferLike sources such as SharedArrayBuffer
+    return new Uint8Array(data);
+}
+//# sourceMappingURL=memory-conversion-utils.js.map

package/dist/loader-utils/lib/binary-utils/memory-conversion-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-conversion-utils.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/binary-utils/memory-conversion-utils.ts"],"names":[],"mappings":"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"}

package/dist/loader-utils/lib/binary-utils/memory-copy-utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Calculate new size of an arrayBuffer to be aligned to an n-byte boundary
+ * This function increases `byteLength` by the minimum delta,
+ * allowing the total length to be divided by `padding`
+ * @param byteLength
+ * @param padding
+ */
+export declare function padToNBytes(byteLength: number, padding: number): number;
+/**
+ * Creates a new Uint8Array based on two different ArrayBuffers
+ * @param targetBuffer The first buffer.
+ * @param sourceBuffer The second buffer.
+ * @return The new ArrayBuffer created out of the two.
+ */
+export declare function copyArrayBuffer(targetBuffer: ArrayBuffer, sourceBuffer: ArrayBuffer, byteOffset: number, byteLength?: number): ArrayBuffer;
+/**
+ * Copy from source to target at the targetOffset
+ *
+ * @param source - The data to copy
+ * @param target - The destination to copy data into
+ * @param targetOffset - The start offset into target to place the copied data
+ * @returns the new offset taking into account proper padding
+ */
+export declare function copyToArray(source: ArrayBuffer | any, target: any, targetOffset: number): number;
+//# sourceMappingURL=memory-copy-utils.d.ts.map

package/dist/loader-utils/lib/binary-utils/memory-copy-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-copy-utils.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/binary-utils/memory-copy-utils.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,WAAW,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAgC,GAC3C,WAAW,CAKb;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAuBhG"}

package/dist/loader-utils/lib/binary-utils/memory-copy-utils.js

@@ -0,0 +1,59 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { assert } from "../env-utils/assert.js";
+/**
+ * Calculate new size of an arrayBuffer to be aligned to an n-byte boundary
+ * This function increases `byteLength` by the minimum delta,
+ * allowing the total length to be divided by `padding`
+ * @param byteLength
+ * @param padding
+ */
+export function padToNBytes(byteLength, padding) {
+    assert(byteLength >= 0); // `Incorrect 'byteLength' value: ${byteLength}`
+    assert(padding > 0); // `Incorrect 'padding' value: ${padding}`
+    return (byteLength + (padding - 1)) & ~(padding - 1);
+}
+/**
+ * Creates a new Uint8Array based on two different ArrayBuffers
+ * @param targetBuffer The first buffer.
+ * @param sourceBuffer The second buffer.
+ * @return The new ArrayBuffer created out of the two.
+ */
+export function copyArrayBuffer(targetBuffer, sourceBuffer, byteOffset, byteLength = sourceBuffer.byteLength) {
+    const targetArray = new Uint8Array(targetBuffer, byteOffset, byteLength);
+    const sourceArray = new Uint8Array(sourceBuffer);
+    targetArray.set(sourceArray);
+    return targetBuffer;
+}
+/**
+ * Copy from source to target at the targetOffset
+ *
+ * @param source - The data to copy
+ * @param target - The destination to copy data into
+ * @param targetOffset - The start offset into target to place the copied data
+ * @returns the new offset taking into account proper padding
+ */
+export function copyToArray(source, target, targetOffset) {
+    let sourceArray;
+    if (source instanceof ArrayBuffer) {
+        sourceArray = new Uint8Array(source);
+    }
+    else {
+        // Pack buffer onto the big target array
+        //
+        // 'source.data.buffer' could be a view onto a larger buffer.
+        // We MUST use this constructor to ensure the byteOffset and byteLength is
+        // set to correct values from 'source.data' and not the underlying
+        // buffer for target.set() to work properly.
+        const srcByteOffset = source.byteOffset;
+        const srcByteLength = source.byteLength;
+        // In gltf parser it is set as "arrayBuffer" instead of "buffer"
+        // https://github.com/visgl/loaders.gl/blob/1e3a82a0a65d7b6a67b1e60633453e5edda2960a/modules/gltf/src/lib/parse-gltf.js#L85
+        sourceArray = new Uint8Array(source.buffer || source.arrayBuffer, srcByteOffset, srcByteLength);
+    }
+    // Pack buffer onto the big target array
+    target.set(sourceArray, targetOffset);
+    return targetOffset + padToNBytes(sourceArray.byteLength, 4);
+}
+//# sourceMappingURL=memory-copy-utils.js.map

package/dist/loader-utils/lib/binary-utils/memory-copy-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-copy-utils.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/binary-utils/memory-copy-utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,MAAM,EAAC,+BAA4B;AAE3C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,OAAe;IAC7D,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,gDAAgD;IACzE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,0CAA0C;IAC/D,OAAO,CAAC,UAAU,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAyB,EACzB,YAAyB,EACzB,UAAkB,EAClB,aAAqB,YAAY,CAAC,UAAU;IAE5C,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC;IACjD,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyB,EAAE,MAAW,EAAE,YAAoB;IACtF,IAAI,WAAW,CAAC;IAEhB,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;QAClC,WAAW,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,wCAAwC;QACxC,EAAE;QACF,6DAA6D;QAC7D,0EAA0E;QAC1E,kEAAkE;QAClE,4CAA4C;QAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC;QACxC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC;QACxC,gEAAgE;QAChE,2HAA2H;QAC3H,WAAW,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAClG,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAEtC,OAAO,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/dist/loader-utils/lib/crs/crs-reprojection.d.ts

@@ -0,0 +1,31 @@
+import type { ReadonlyCRSDefinition } from '@math.gl/geospatial/crs';
+/**
+ * Common opt-in coordinate transformation options for vector loaders.
+ *
+ * Loader geometry and bounds use `xy` order (x/easting or longitude first), regardless of the
+ * authoritative axis order advertised by a CRS. The CRS definition itself is preserved separately
+ * in metadata. When `reproject` is true, `targetCrs` defaults to WGS84 for compatibility.
+ */
+export type CRSReprojectionOptions = {
+    /** Transform decoded coordinates into the requested output CRS. Defaults to `false`. */
+    reproject?: boolean;
+    /** CRS of returned coordinates. Defaults to `WGS84` when reprojection is enabled. */
+    targetCrs?: ReadonlyCRSDefinition;
+};
+/** Stable categories for failures while an opt-in CRS transformation is being prepared. */
+export type CRSReprojectionErrorCode = 'missing-source-crs' | 'unsupported-source-crs' | 'unsupported-target-crs' | 'transformation-failed';
+/** Error thrown when a requested CRS transformation cannot be performed. */
+export declare class CRSReprojectionError extends Error {
+    /** Machine-readable reason for the failed transformation request. */
+    readonly code: CRSReprojectionErrorCode;
+    /** Source CRS when it was discovered or supplied. */
+    readonly sourceCrs?: ReadonlyCRSDefinition;
+    /** Requested output CRS when it was supplied. */
+    readonly targetCrs?: ReadonlyCRSDefinition;
+    constructor(code: CRSReprojectionErrorCode, message: string, options?: {
+        sourceCrs?: ReadonlyCRSDefinition;
+        targetCrs?: ReadonlyCRSDefinition;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=crs-reprojection.d.ts.map

package/dist/loader-utils/lib/crs/crs-reprojection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-reprojection.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/crs/crs-reprojection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,wBAAwB,GACxB,wBAAwB,GACxB,uBAAuB,CAAC;AAE5B,4EAA4E;AAC5E,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;gBAGzC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,qBAAqB,CAAC;QAClC,SAAS,CAAC,EAAE,qBAAqB,CAAC;QAClC,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAQT"}

package/dist/loader-utils/lib/crs/crs-reprojection.js

@@ -0,0 +1,20 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Error thrown when a requested CRS transformation cannot be performed. */
+export class CRSReprojectionError extends Error {
+    /** Machine-readable reason for the failed transformation request. */
+    code;
+    /** Source CRS when it was discovered or supplied. */
+    sourceCrs;
+    /** Requested output CRS when it was supplied. */
+    targetCrs;
+    constructor(code, message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = 'CRSReprojectionError';
+        this.code = code;
+        this.sourceCrs = options.sourceCrs;
+        this.targetCrs = options.targetCrs;
+    }
+}
+//# sourceMappingURL=crs-reprojection.js.map

package/dist/loader-utils/lib/crs/crs-reprojection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-reprojection.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/crs/crs-reprojection.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAyBpC,4EAA4E;AAC5E,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,qEAAqE;IAC5D,IAAI,CAA2B;IACxC,qDAAqD;IAC5C,SAAS,CAAyB;IAC3C,iDAAiD;IACxC,SAAS,CAAyB;IAE3C,YACE,IAA8B,EAC9B,OAAe,EACf,UAII,EAAE;QAEN,KAAK,CAAC,OAAO,EAAE,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;CACF"}

package/dist/loader-utils/lib/env-utils/assert.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Throws an `Error` with the optional `message` if `condition` is falsy
+ * @note Replacement for the external assert method to reduce bundle size
+ */
+export declare function assert(condition: any, message?: string): void;
+//# sourceMappingURL=assert.d.ts.map

package/dist/loader-utils/lib/env-utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/env-utils/assert.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAI7D"}

package/dist/loader-utils/lib/env-utils/assert.js

@@ -0,0 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Throws an `Error` with the optional `message` if `condition` is falsy
+ * @note Replacement for the external assert method to reduce bundle size
+ */
+export function assert(condition, message) {
+    if (!condition) {
+        throw new Error(message || 'loader assertion failed.');
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/loader-utils/lib/env-utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/env-utils/assert.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,SAAc,EAAE,OAAgB;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,0BAA0B,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/loader-utils/lib/env-utils/globals.d.ts

@@ -0,0 +1,15 @@
+type obj = {
+    [key: string]: any;
+};
+declare const self_: obj;
+declare const window_: obj;
+declare const global_: obj;
+declare const document_: obj;
+export { self_ as self, window_ as window, global_ as global, document_ as document };
+/** true if running in a browser */
+export declare const isBrowser: boolean;
+/** true if running in a worker thread */
+export declare const isWorker: boolean;
+/** Major Node version (as a number) */
+export declare const nodeVersion: number;
+//# sourceMappingURL=globals.d.ts.map

package/dist/loader-utils/lib/env-utils/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/env-utils/globals.ts"],"names":[],"mappings":"AAeA,KAAK,GAAG,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAC,CAAC;AAChC,QAAA,MAAM,KAAK,EAAE,GAA4D,CAAC;AAC1E,QAAA,MAAM,OAAO,EAAE,GAA4D,CAAC;AAC5E,QAAA,MAAM,OAAO,EAAE,GAA4D,CAAC;AAC5E,QAAA,MAAM,SAAS,EAAE,GAA4B,CAAC;AAE9C,OAAO,EAAC,KAAK,IAAI,IAAI,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,SAAS,IAAI,QAAQ,EAAC,CAAC;AAEpF,mCAAmC;AACnC,eAAO,MAAM,SAAS,EAAE,OAE2E,CAAC;AAEpG,yCAAyC;AACzC,eAAO,MAAM,QAAQ,EAAE,OAA6C,CAAC;AAKrE,uCAAuC;AACvC,eAAO,MAAM,WAAW,EAAE,MAAiD,CAAC"}

package/dist/loader-utils/lib/env-utils/globals.js

@@ -0,0 +1,28 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+// Purpose: include this in your module to avoid
+// dependencies on micro modules like 'global' and 'is-browser';
+/* eslint-disable no-restricted-globals */
+const globals = {
+    self: typeof self !== 'undefined' && self,
+    window: typeof window !== 'undefined' && window,
+    global: typeof global !== 'undefined' && global,
+    document: typeof document !== 'undefined' && document
+};
+const self_ = globals.self || globals.window || globals.global || {};
+const window_ = globals.window || globals.self || globals.global || {};
+const global_ = globals.global || globals.self || globals.window || {};
+const document_ = globals.document || {};
+export { self_ as self, window_ as window, global_ as global, document_ as document };
+/** true if running in a browser */
+export const isBrowser = 
+// @ts-ignore process does not exist on browser
+Boolean(typeof process !== 'object' || String(process) !== '[object process]' || process.browser);
+/** true if running in a worker thread */
+export const isWorker = typeof importScripts === 'function';
+// Extract node major version
+const matches = typeof process !== 'undefined' && process.version && /v([0-9]*)/.exec(process.version);
+/** Major Node version (as a number) */
+export const nodeVersion = (matches && parseFloat(matches[1])) || 0;
+//# sourceMappingURL=globals.js.map

package/dist/loader-utils/lib/env-utils/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/env-utils/globals.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,gDAAgD;AAChD,gEAAgE;AAEhE,0CAA0C;AAC1C,MAAM,OAAO,GAAG;IACd,IAAI,EAAE,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI;IACzC,MAAM,EAAE,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM;IAC/C,MAAM,EAAE,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM;IAC/C,QAAQ,EAAE,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ;CACtD,CAAC;AAGF,MAAM,KAAK,GAAQ,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;AAC1E,MAAM,OAAO,GAAQ,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;AAC5E,MAAM,OAAO,GAAQ,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;AAC5E,MAAM,SAAS,GAAQ,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;AAE9C,OAAO,EAAC,KAAK,IAAI,IAAI,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,SAAS,IAAI,QAAQ,EAAC,CAAC;AAEpF,mCAAmC;AACnC,MAAM,CAAC,MAAM,SAAS;AACpB,+CAA+C;AAC/C,OAAO,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpG,yCAAyC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAY,OAAO,aAAa,KAAK,UAAU,CAAC;AAErE,6BAA6B;AAC7B,MAAM,OAAO,GACX,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACzF,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAW,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/loader-utils/lib/file-provider/data-view-file.d.ts

@@ -0,0 +1,40 @@
+import { FileProviderInterface } from "./file-provider-interface.js";
+/**
+ * Provides file data using DataView
+ * @deprecated - will be replaced with ReadableFile
+ */
+export declare class DataViewFile implements FileProviderInterface {
+    /** The DataView from which data is provided */
+    private file;
+    constructor(file: DataView);
+    destroy(): Promise<void>;
+    /**
+     * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint8(offset: bigint): Promise<number>;
+    /**
+     * Gets an unsigned 16-bit intege at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint16(offset: bigint): Promise<number>;
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint32(offset: bigint): Promise<number>;
+    /**
+     * Gets an unsigned 64-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getBigUint64(offset: bigint): Promise<bigint>;
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in bytes, from the start of the file where to start reading the data.
+     * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+     */
+    slice(startOffset: bigint, endOffset: bigint): Promise<ArrayBuffer>;
+    /** the length (in bytes) of the data. */
+    get length(): bigint;
+}
+//# sourceMappingURL=data-view-file.d.ts.map

package/dist/loader-utils/lib/file-provider/data-view-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-view-file.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/data-view-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,qBAAqB,EAAC,qCAAkC;AAehE;;;GAGG;AACH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,+CAA+C;IAC/C,OAAO,CAAC,IAAI,CAAW;gBAEX,IAAI,EAAE,QAAQ;IAIpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAE9B;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/C;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAInD;;;;OAIG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQzE,yCAAyC;IACzC,IAAI,MAAM,WAET;CACF"}

package/dist/loader-utils/lib/file-provider/data-view-file.js

@@ -0,0 +1,68 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { copyToArrayBuffer } from "../binary-utils/memory-conversion-utils.js";
+/**
+ * Checks if bigint can be converted to number and convert it if possible
+ * @param bigint bigint to be converted
+ * @returns number
+ */
+const toNumber = (bigint) => {
+    if (bigint > Number.MAX_SAFE_INTEGER) {
+        throw new Error('Offset is out of bounds');
+    }
+    return Number(bigint);
+};
+/**
+ * Provides file data using DataView
+ * @deprecated - will be replaced with ReadableFile
+ */
+export class DataViewFile {
+    /** The DataView from which data is provided */
+    file;
+    constructor(file) {
+        this.file = file;
+    }
+    async destroy() { }
+    /**
+     * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint8(offset) {
+        return this.file.getUint8(toNumber(offset));
+    }
+    /**
+     * Gets an unsigned 16-bit intege at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint16(offset) {
+        return this.file.getUint16(toNumber(offset), true);
+    }
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint32(offset) {
+        return this.file.getUint32(toNumber(offset), true);
+    }
+    /**
+     * Gets an unsigned 64-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getBigUint64(offset) {
+        return this.file.getBigUint64(toNumber(offset), true);
+    }
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in bytes, from the start of the file where to start reading the data.
+     * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+     */
+    async slice(startOffset, endOffset) {
+        return copyToArrayBuffer(this.file.buffer, toNumber(startOffset + BigInt(this.file.byteOffset)), toNumber(endOffset - startOffset));
+    }
+    /** the length (in bytes) of the data. */
+    get length() {
+        return BigInt(this.file.byteLength);
+    }
+}
+//# sourceMappingURL=data-view-file.js.map

package/dist/loader-utils/lib/file-provider/data-view-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-view-file.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/data-view-file.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,iBAAiB,EAAC,mDAAgD;AAE1E;;;;GAIG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE;IAClC,IAAI,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,+CAA+C;IACvC,IAAI,CAAW;IAEvB,YAAY,IAAc;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,KAAmB,CAAC;IAEjC;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,MAAc;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,WAAmB,EAAE,SAAiB;QAChD,OAAO,iBAAiB,CACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAChB,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,EACpD,QAAQ,CAAC,SAAS,GAAG,WAAW,CAAC,CAClC,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,IAAI,MAAM;QACR,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/loader-utils/lib/file-provider/file-handle-file.d.ts

@@ -0,0 +1,54 @@
+import { FileProviderInterface } from "./file-provider-interface.js";
+/**
+ * Provides file data using node fs library
+ * @deprecated - will be replaced with ReadableFile
+ */
+export declare class FileHandleFile implements FileProviderInterface {
+    /** The FileHandle from which data is provided */
+    private file;
+    /** Create a new FileHandleFile */
+    constructor(path: string, append?: boolean);
+    /**
+     * Truncates the file descriptor.
+     * @param length desired file lenght
+     */
+    truncate(length: number): Promise<void>;
+    /**
+     * Append data to a file.
+     * @param buffer data to append
+     */
+    append(buffer: Uint8Array): Promise<void>;
+    /** Close file */
+    destroy(): Promise<void>;
+    /**
+     * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint8(offset: number | bigint): Promise<number>;
+    /**
+     * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint16(offset: number | bigint): Promise<number>;
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getUint32(offset: number | bigint): Promise<number>;
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    getBigUint64(offset: number | bigint): Promise<bigint>;
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
+     * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+     */
+    slice(startOffset: bigint, endOffset: bigint): Promise<ArrayBuffer>;
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length(): bigint;
+}
+//# sourceMappingURL=file-handle-file.d.ts.map

package/dist/loader-utils/lib/file-provider/file-handle-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-handle-file.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/file-handle-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,qBAAqB,EAAC,qCAAkC;AAGhE;;;GAGG;AACH,qBAAa,cAAe,YAAW,qBAAqB;IAC1D,iDAAiD;IACjD,OAAO,CAAC,IAAI,CAAW;IAEvB,kCAAkC;gBACtB,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe;IAIjD;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,iBAAiB;IACX,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASxD;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASzD;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASzD;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS5D;;;;OAIG;IACG,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASzE;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/loader-utils/lib/file-provider/file-handle-file.js

@@ -0,0 +1,102 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { NodeFileFacade as NodeFile } from "../files/node-file-facade.js";
+/**
+ * Provides file data using node fs library
+ * @deprecated - will be replaced with ReadableFile
+ */
+export class FileHandleFile {
+    /** The FileHandle from which data is provided */
+    file;
+    /** Create a new FileHandleFile */
+    constructor(path, append = false) {
+        this.file = new NodeFile(path, append ? 'a+' : 'r');
+    }
+    /**
+     * Truncates the file descriptor.
+     * @param length desired file lenght
+     */
+    async truncate(length) {
+        await this.file.truncate(length);
+    }
+    /**
+     * Append data to a file.
+     * @param buffer data to append
+     */
+    async append(buffer) {
+        await this.file.append(buffer);
+    }
+    /** Close file */
+    async destroy() {
+        await this.file.close();
+    }
+    /**
+     * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint8(offset) {
+        const arrayBuffer = await this.file.read(offset, 1);
+        const val = new Uint8Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint16(offset) {
+        const arrayBuffer = await this.file.read(offset, 2);
+        const val = new Uint16Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getUint32(offset) {
+        const arrayBuffer = await this.file.read(offset, 4);
+        const val = new Uint32Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+     * @param offset The offset, in bytes, from the start of the file where to read the data.
+     */
+    async getBigUint64(offset) {
+        const arrayBuffer = await this.file.read(offset, 8);
+        const val = new BigInt64Array(arrayBuffer).at(0);
+        if (val === undefined) {
+            throw new Error('something went wrong');
+        }
+        return val;
+    }
+    /**
+     * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+     * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
+     * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+     */
+    async slice(startOffset, endOffset) {
+        const bigLength = endOffset - startOffset;
+        if (bigLength > Number.MAX_SAFE_INTEGER) {
+            throw new Error('too big slice');
+        }
+        const length = Number(bigLength);
+        return await this.file.read(startOffset, length);
+    }
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length() {
+        return this.file.bigsize;
+    }
+}
+//# sourceMappingURL=file-handle-file.js.map

package/dist/loader-utils/lib/file-provider/file-handle-file.js.map

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