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

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

@@ -0,0 +1,45 @@
+/**
+ * Interface for providing file data
+ */
+export interface FileProviderInterface {
+    /**
+     * Cleanup class data
+     */
+    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 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: 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 file of the view where to read the data.
+     */
+    getUint32(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 byte, from the file of the view 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.
+     */
+    length: bigint;
+}
+/**
+ * Check is the object has FileProvider members
+ * @param fileProvider - tested object
+ */
+export declare const isFileProvider: (fileProvider: unknown) => bigint;
+//# sourceMappingURL=file-provider-interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider-interface.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/file-provider-interface.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C;;;;OAIG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,OAAO,WAMnD,CAAC"}

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

@@ -0,0 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Check is the object has FileProvider members
+ * @param fileProvider - tested object
+ */
+export const isFileProvider = (fileProvider) => {
+    return (fileProvider?.getUint8 &&
+        fileProvider?.slice &&
+        fileProvider?.length);
+};
+//# sourceMappingURL=file-provider-interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider-interface.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/file-provider-interface.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AA+CpC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,YAAqB,EAAE,EAAE;IACtD,OAAO,CACJ,YAAsC,EAAE,QAAQ;QAChD,YAAsC,EAAE,KAAK;QAC7C,YAAsC,EAAE,MAAM,CAChD,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,57 @@
+import { ReadableFile } from "../files/file.js";
+import { FileProviderInterface } from "./file-provider-interface.js";
+/**
+ * Provides file data using range requests to the server
+ * @deprecated - will be replaced with ReadableFile
+ */
+export declare class FileProvider implements FileProviderInterface {
+    /** The File object from which data is provided */
+    private file;
+    private size;
+    /** Create a new BrowserFile */
+    private constructor();
+    static create(file: ReadableFile): Promise<FileProvider>;
+    /**
+     * 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 | number, endOffset: bigint | number): Promise<ArrayBuffer>;
+    /**
+     * the length (in bytes) of the data.
+     */
+    get length(): bigint;
+}
+//# sourceMappingURL=file-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-provider.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/file-provider/file-provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,YAAY,EAAC,yBAAsB;AAC3C,OAAO,EAAC,qBAAqB,EAAC,qCAAkC;AAEhE;;;GAGG;AACH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,kDAAkD;IAClD,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,IAAI,CAAS;IAErB,+BAA+B;IAC/B,OAAO;WAKM,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAc9D;;;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,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAU3F;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

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

@@ -0,0 +1,114 @@
+/**
+ * Provides file data using range requests to the server
+ * @deprecated - will be replaced with ReadableFile
+ */
+export class FileProvider {
+    /** The File object from which data is provided */
+    file;
+    size;
+    /** Create a new BrowserFile */
+    constructor(file, size) {
+        this.file = file;
+        this.size = BigInt(size);
+    }
+    static async create(file) {
+        let size = 0n;
+        if (file.bigsize > 0n) {
+            size = file.bigsize;
+        }
+        else if (file.size > 0) {
+            size = file.size;
+        }
+        else {
+            const stats = await file.stat?.();
+            size = stats?.bigsize ?? 0n;
+        }
+        return new FileProvider(file, size);
+    }
+    /**
+     * Truncates the file descriptor.
+     * @param length desired file lenght
+     */
+    async truncate(length) {
+        throw new Error('file loaded via range requests cannot be changed');
+    }
+    /**
+     * Append data to a file.
+     * @param buffer data to append
+     */
+    async append(buffer) {
+        throw new Error('file loaded via range requests cannot be changed');
+    }
+    /** Close file */
+    async destroy() {
+        throw new Error('file loaded via range requests cannot be changed');
+    }
+    /**
+     * 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 = BigInt(endOffset) - BigInt(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.size;
+    }
+}
+//# sourceMappingURL=file-provider.js.map

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

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

package/dist/loader-utils/lib/files/array-buffer-file.d.ts

@@ -0,0 +1,21 @@
+import type { ReadableFile, Stat } from "./file.js";
+/** Random-access file over an in-memory ArrayBuffer without routing reads through Blob. */
+export declare class ArrayBufferFile implements ReadableFile {
+    /** Complete in-memory file. */
+    readonly handle: ArrayBuffer;
+    /** File length in bytes. */
+    readonly size: number;
+    /** File length in bytes as a bigint. */
+    readonly bigsize: bigint;
+    /** In-memory files do not have a URL. */
+    readonly url = "";
+    /** Creates a random-access view of an in-memory file. */
+    constructor(arrayBuffer: ArrayBuffer);
+    /** Releases the file; in-memory buffers do not require cleanup. */
+    close(): Promise<void>;
+    /** Returns the in-memory file size. */
+    stat(): Promise<Stat>;
+    /** Copies one byte range from the in-memory file. */
+    read(start?: number | bigint, length?: number, signal?: AbortSignal): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=array-buffer-file.d.ts.map

package/dist/loader-utils/lib/files/array-buffer-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-buffer-file.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/array-buffer-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAE,IAAI,EAAC,kBAAe;AAE/C,2FAA2F;AAC3F,qBAAa,eAAgB,YAAW,YAAY;IAClD,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,MAAM;IAElB,yDAAyD;gBAC7C,WAAW,EAAE,WAAW;IAMpC,mEAAmE;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,qDAAqD;IAC/C,IAAI,CACR,KAAK,GAAE,MAAM,GAAG,MAAU,EAC1B,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC;CAQxB"}

package/dist/loader-utils/lib/files/array-buffer-file.js

@@ -0,0 +1,36 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Random-access file over an in-memory ArrayBuffer without routing reads through Blob. */
+export class ArrayBufferFile {
+    /** Complete in-memory file. */
+    handle;
+    /** File length in bytes. */
+    size;
+    /** File length in bytes as a bigint. */
+    bigsize;
+    /** In-memory files do not have a URL. */
+    url = '';
+    /** Creates a random-access view of an in-memory file. */
+    constructor(arrayBuffer) {
+        this.handle = arrayBuffer;
+        this.size = arrayBuffer.byteLength;
+        this.bigsize = BigInt(this.size);
+    }
+    /** Releases the file; in-memory buffers do not require cleanup. */
+    async close() { }
+    /** Returns the in-memory file size. */
+    async stat() {
+        return { size: this.size, bigsize: this.bigsize, isDirectory: false };
+    }
+    /** Copies one byte range from the in-memory file. */
+    async read(start = 0, length, signal) {
+        if (signal?.aborted) {
+            throw new Error('Request aborted');
+        }
+        const startOffset = Number(start);
+        const endOffset = length === undefined ? this.size : startOffset + length;
+        return this.handle.slice(startOffset, endOffset);
+    }
+}
+//# sourceMappingURL=array-buffer-file.js.map

package/dist/loader-utils/lib/files/array-buffer-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-buffer-file.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/array-buffer-file.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,2FAA2F;AAC3F,MAAM,OAAO,eAAe;IAC1B,+BAA+B;IACtB,MAAM,CAAc;IAC7B,4BAA4B;IACnB,IAAI,CAAS;IACtB,wCAAwC;IAC/B,OAAO,CAAS;IACzB,yCAAyC;IAChC,GAAG,GAAG,EAAE,CAAC;IAElB,yDAAyD;IACzD,YAAY,WAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,uCAAuC;IACvC,KAAK,CAAC,IAAI;QACR,OAAO,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAC,CAAC;IACtE,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,IAAI,CACR,QAAyB,CAAC,EAC1B,MAAe,EACf,MAAoB;QAEpB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/loader-utils/lib/files/blob-file.d.ts

@@ -0,0 +1,19 @@
+import { ReadableFile } from "./file.js";
+/**
+ * BlobFile provides a "file like interface" to the data in a Blob or File object
+ */
+export declare class BlobFile implements ReadableFile {
+    readonly handle: Blob;
+    readonly size: number;
+    readonly bigsize: bigint;
+    readonly url: string;
+    constructor(blob: Blob | File | ArrayBuffer);
+    close(): Promise<void>;
+    stat(): Promise<{
+        size: number;
+        bigsize: bigint;
+        isDirectory: boolean;
+    }>;
+    read(start?: number | bigint, length?: number, signal?: AbortSignal): Promise<ArrayBuffer>;
+}
+//# sourceMappingURL=blob-file.d.ts.map

package/dist/loader-utils/lib/files/blob-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-file.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/blob-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,kBAAe;AAEpC;;GAEG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,WAAW;IAOrC,KAAK;IAEL,IAAI;;;;;IAQJ,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAYjG"}

package/dist/loader-utils/lib/files/blob-file.js

@@ -0,0 +1,39 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * BlobFile provides a "file like interface" to the data in a Blob or File object
+ */
+export class BlobFile {
+    handle;
+    size;
+    bigsize;
+    url;
+    constructor(blob) {
+        this.handle = blob instanceof ArrayBuffer ? new Blob([blob]) : blob;
+        this.size = blob instanceof ArrayBuffer ? blob.byteLength : blob.size;
+        this.bigsize = BigInt(this.size);
+        this.url = blob instanceof File ? blob.name : '';
+    }
+    async close() { }
+    async stat() {
+        return {
+            size: this.handle.size,
+            bigsize: BigInt(this.handle.size),
+            isDirectory: false
+        };
+    }
+    async read(start, length, signal) {
+        if (signal?.aborted) {
+            throw new Error('Request aborted');
+        }
+        const arrayBuffer = await this.handle
+            .slice(Number(start), Number(start) + Number(length))
+            .arrayBuffer();
+        if (signal?.aborted) {
+            throw new Error('Request aborted');
+        }
+        return arrayBuffer;
+    }
+}
+//# sourceMappingURL=blob-file.js.map

package/dist/loader-utils/lib/files/blob-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-file.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/blob-file.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,OAAO,QAAQ;IACV,MAAM,CAAO;IACb,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,GAAG,CAAS;IAErB,YAAY,IAA+B;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACtE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,KAAK,KAAI,CAAC;IAEhB,KAAK,CAAC,IAAI;QACR,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACjC,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAuB,EAAE,MAAe,EAAE,MAAoB;QACvE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM;aAClC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;aACpD,WAAW,EAAE,CAAC;QACjB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/loader-utils/lib/files/file.d.ts

@@ -0,0 +1,33 @@
+export type Stat = {
+    size: number;
+    bigsize: bigint;
+    isDirectory: boolean;
+};
+export interface ReadableFile {
+    /** The underlying file handle (Blob, Node.js file descriptor etc) */
+    readonly handle: unknown;
+    /** Length of file in bytes, if available */
+    readonly size: number;
+    /** Length of file in bytes, if available */
+    readonly bigsize: bigint;
+    /** Url, if available */
+    readonly url: string;
+    /** Read data */
+    read(start?: number | bigint, length?: number, signal?: AbortSignal): Promise<ArrayBuffer>;
+    /** Read data */
+    fetchRange?(offset: number | bigint, length: number, signal?: AbortSignal): Promise<Response>;
+    /** Get information about file */
+    stat?(): Promise<Stat>;
+    /** Close the file */
+    close(): Promise<void>;
+}
+export interface WritableFile {
+    handle: unknown;
+    /** Write to file. The number of bytes written will be returned */
+    write: (arrayBuffer: ArrayBuffer, offset?: number | bigint, length?: number) => Promise<number>;
+    /** Get information about the file */
+    stat?(): Promise<Stat>;
+    /** Close the file */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/file.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,gBAAgB;IAChB,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3F,gBAAgB;IAChB,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9F,iCAAiC;IACjC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,qBAAqB;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChG,qCAAqC;IACrC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,qBAAqB;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/loader-utils/lib/files/file.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=file.js.map

package/dist/loader-utils/lib/files/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/file.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/loader-utils/lib/files/http-file-transport.d.ts

@@ -0,0 +1,37 @@
+import type { RangeRequestTransportResult } from "../request-utils/range-request-scheduler.js";
+import type { HttpFileIdentity, HttpFileOptions, HttpFileTelemetry } from "./http-file-types.js";
+/** Result of one validated HTTP range request. */
+export type HttpFileRangeResult = RangeRequestTransportResult & {
+    /** Identity observed or confirmed by the response. */
+    identity: HttpFileIdentity;
+};
+/** Owns HTTP request construction, response validation, identity checks, and transport telemetry. */
+export declare class HttpFileTransport {
+    /** Remote object URL. */
+    private readonly url;
+    /** Fetch implementation used for range requests. */
+    private readonly fetchFunction;
+    /** Persistent fetch options copied from the caller. */
+    private readonly fetchOptions?;
+    /** Validator enforcement mode. */
+    private readonly consistency;
+    /** Caller-supplied identity information. */
+    private readonly identityHints;
+    /** Failure objects already included in telemetry. */
+    private readonly countedFailures;
+    /** Mutable counters backing immutable telemetry snapshots. */
+    private readonly telemetry;
+    /** Creates the transport for one remote object. */
+    constructor(url: string, options: HttpFileOptions);
+    /** Returns an identity that is complete enough to avoid an opening request. */
+    getInitialIdentity(): HttpFileIdentity | null;
+    /** Returns an immutable point-in-time copy of the transport counters. */
+    getTelemetry(): HttpFileTelemetry;
+    /** Counts each failure object once even when it passes through several async layers. */
+    trackFailure(error: unknown): void;
+    /** Performs and validates one exact HTTP range request. */
+    requestRange(offset: number, length: number, signal: AbortSignal | undefined, expectedIdentity: HttpFileIdentity | null): Promise<HttpFileRangeResult>;
+    /** Validates and consumes the special empty-object identity response. */
+    private readEmptyIdentityProbe;
+}
+//# sourceMappingURL=http-file-transport.d.ts.map

package/dist/loader-utils/lib/files/http-file-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-file-transport.d.ts","sourceRoot":"","sources":["../../../../src/loader-utils/lib/files/http-file-transport.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,2BAA2B,EAAC,oDAAiD;AAC1F,OAAO,KAAK,EAGV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EAClB,6BAA0B;AAmC3B,kDAAkD;AAClD,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,GAAG;IAC9D,sDAAsD;IACtD,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,qGAAqG;AACrG,qBAAa,iBAAiB;IAC5B,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAc;IAC5C,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwB;IACtD,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,mDAAmD;gBACvC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;IAgBjD,+EAA+E;IAC/E,kBAAkB,IAAI,gBAAgB,GAAG,IAAI;IAW7C,yEAAyE;IACzE,YAAY,IAAI,iBAAiB;IAIjC,wFAAwF;IACxF,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAclC,2DAA2D;IACrD,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GACxC,OAAO,CAAC,mBAAmB,CAAC;IA2D/B,yEAAyE;YAC3D,sBAAsB;CAuBrC"}