@loaders.gl/core 3.4.11 → 3.4.12

package/dist/lib/filesystems/browser-filesystem.js

@@ -1,126 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * FileSystem adapter for a browser FileList.
- * Holds a list of browser 'File' objects.
- */
-class BrowserFileSystem {
-    /**
-     * A FileSystem API wrapper around a list of browser 'File' objects
-     * @param files
-     * @param options
-     */
-    constructor(files, options) {
-        this.files = {};
-        this.lowerCaseFiles = {};
-        this.usedFiles = {};
-        this._fetch = options?.fetch || fetch;
-        for (let i = 0; i < files.length; ++i) {
-            const file = files[i];
-            this.files[file.name] = file;
-            this.lowerCaseFiles[file.name.toLowerCase()] = file;
-            this.usedFiles[file.name] = false;
-        }
-        this.fetch = this.fetch.bind(this);
-    }
-    // implements IFileSystem
-    /**
-     * Implementation of fetch against this file system
-     * Delegates to global fetch for http{s}:// or data://
-     */
-    async fetch(path, options) {
-        // Fallback to handle https:/http:/data: etc fetches
-        if (path.includes('://')) {
-            return this._fetch(path, options);
-        }
-        // Local fetches are served from the list of files
-        const file = this.files[path];
-        if (!file) {
-            return new Response(path, { status: 400, statusText: 'NOT FOUND' });
-        }
-        const headers = new Headers(options?.headers);
-        const range = headers.get('Range');
-        const bytes = range && /bytes=($1)-($2)/.exec(range);
-        if (bytes) {
-            const start = parseInt(bytes[1]);
-            const end = parseInt(bytes[2]);
-            // The trick when reading File objects is to read successive "slices" of the File
-            // Per spec https://w3c.github.io/FileAPI/, slicing a File should only update the start and end fields
-            // Actually reading from file should happen in `readAsArrayBuffer` (and as far we can tell it does)
-            const data = await file.slice(start, end).arrayBuffer();
-            const response = new Response(data);
-            Object.defineProperty(response, 'url', { value: path });
-            return response;
-        }
-        // return makeResponse()
-        const response = new Response(file);
-        Object.defineProperty(response, 'url', { value: path });
-        return response;
-    }
-    /**
-     * List filenames in this filesystem
-     * @param dirname
-     * @returns
-     */
-    async readdir(dirname) {
-        const files = [];
-        for (const path in this.files) {
-            files.push(path);
-        }
-        // TODO filter by dirname
-        return files;
-    }
-    /**
-     * Return information (size) about files in this file system
-     */
-    async stat(path, options) {
-        const file = this.files[path];
-        if (!file) {
-            throw new Error(path);
-        }
-        return { size: file.size };
-    }
-    /**
-     * Just removes the file from the list
-     */
-    async unlink(path) {
-        delete this.files[path];
-        delete this.lowerCaseFiles[path];
-        this.usedFiles[path] = true;
-    }
-    // implements IRandomAccessFileSystem
-    // RANDOM ACCESS
-    async open(pathname, flags, mode) {
-        return this.files[pathname];
-    }
-    /**
-     * Read a range into a buffer
-     * @todo - handle position memory
-     * @param buffer is the buffer that the data (read from the fd) will be written to.
-     * @param offset is the offset in the buffer to start writing at.
-     * @param length is an integer specifying the number of bytes to read.
-     * @param position is an argument specifying where to begin reading from in the file. If position is null, data will be read from the current file position, and the file position will be updated. If position is an integer, the file position will remain unchanged.
-     */
-    async read(fd, buffer, offset = 0, length = buffer.byteLength, position = null) {
-        const file = fd;
-        const startPosition = 0; // position
-        const arrayBuffer = await file.slice(startPosition, startPosition + length).arrayBuffer();
-        // copy into target buffer
-        return { bytesRead: length, buffer: arrayBuffer };
-    }
-    async close(fd) {
-        // NO OP
-    }
-    // fstat(fd: number): Promise<object>; // Stat
-    // PRIVATE
-    // Supports case independent paths, and file usage tracking
-    _getFile(path, used) {
-        // Prefer case match, but fall back to case indepent.
-        const file = this.files[path] || this.lowerCaseFiles[path];
-        if (file && used) {
-            this.usedFiles[path] = true;
-        }
-        return file;
-    }
-}
-exports.default = BrowserFileSystem;

package/dist/lib/filesystems/filesystem.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/lib/filesystems/read-array-buffer.js

@@ -1,29 +0,0 @@
-"use strict";
-// Random-Access read
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readArrayBuffer = void 0;
-async function readArrayBuffer(file, start, length) {
-    if (file instanceof Blob) {
-        const slice = file.slice(start, start + length);
-        return await slice.arrayBuffer();
-    }
-    return await file.read(start, start + length);
-}
-exports.readArrayBuffer = readArrayBuffer;
-/**
- * Read a slice of a Blob or File, without loading the entire file into memory
- * The trick when reading File objects is to read successive "slices" of the File
- * Per spec https://w3c.github.io/FileAPI/, slicing a File only updates the start and end fields
- * Actually reading from file happens in `readAsArrayBuffer`
- * @param blob to read
- export async function readBlob(blob: Blob): Promise<ArrayBuffer> {
-  return await new Promise((resolve, reject) => {
-    const fileReader = new FileReader();
-    fileReader.onload = (event: ProgressEvent<FileReader>) =>
-      resolve(event?.target?.result as ArrayBuffer);
-    // TODO - reject with a proper Error
-    fileReader.onerror = (error: ProgressEvent<FileReader>) => reject(error);
-    fileReader.readAsArrayBuffer(blob);
-  });
-}
-*/

package/dist/lib/init.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-// loaders.gl, MIT license
-const log_1 = require("./utils/log");
-// @ts-ignore TS2304: Cannot find name '__VERSION__'.
-const version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
-// @ts-ignore
-if (!globalThis.loaders) {
-    log_1.log.log(1, `loaders.gl ${version}`)();
-    globalThis.loaders = Object.assign(globalThis.loaders || {}, {
-        VERSION: version,
-        log: log_1.log
-    });
-}
-// @ts-ignore
-exports.default = globalThis.loaders;

package/dist/lib/loader-utils/check-errors.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkFetchResponseStatusSync = exports.checkFetchResponseStatus = void 0;
-async function checkFetchResponseStatus(response) {
-    if (!response.ok) {
-        let errorMessage = `fetch failed ${response.status} ${response.statusText}`;
-        try {
-            const text = await response.text();
-            if (text) {
-                errorMessage += `: ${getErrorText(text)}`;
-            }
-        }
-        catch (error) {
-            // ignore error
-        }
-        throw new Error(errorMessage);
-    }
-}
-exports.checkFetchResponseStatus = checkFetchResponseStatus;
-function checkFetchResponseStatusSync(response) {
-    if (!response.ok) {
-        throw new Error(`fetch failed ${response.status}`);
-    }
-}
-exports.checkFetchResponseStatusSync = checkFetchResponseStatusSync;
-function getErrorText(text) {
-    // Look for HTML error texts
-    const matches = text.match('<pre>(.*)</pre>');
-    return matches ? matches[1] : ` ${text.slice(0, 10)}...`;
-}

package/dist/lib/loader-utils/get-data.js

@@ -1,129 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getReadableStream = exports.getAsyncIterableFromData = exports.getArrayBufferOrStringFromData = exports.getArrayBufferOrStringFromDataSync = void 0;
-const loader_utils_1 = require("@loaders.gl/loader-utils");
-const is_type_1 = require("../../javascript-utils/is-type");
-const make_iterator_1 = require("../../iterators/make-iterator/make-iterator");
-const response_utils_1 = require("../utils/response-utils");
-const ERR_DATA = 'Cannot convert supplied data type';
-// eslint-disable-next-line complexity
-function getArrayBufferOrStringFromDataSync(data, loader, options) {
-    if (loader.text && typeof data === 'string') {
-        return data;
-    }
-    if ((0, is_type_1.isBuffer)(data)) {
-        // @ts-ignore
-        data = data.buffer;
-    }
-    if (data instanceof ArrayBuffer) {
-        const arrayBuffer = data;
-        if (loader.text && !loader.binary) {
-            const textDecoder = new TextDecoder('utf8');
-            return textDecoder.decode(arrayBuffer);
-        }
-        return arrayBuffer;
-    }
-    // We may need to handle offsets
-    if (ArrayBuffer.isView(data)) {
-        // TextDecoder is invoked on typed arrays and will handle offsets
-        if (loader.text && !loader.binary) {
-            const textDecoder = new TextDecoder('utf8');
-            return textDecoder.decode(data);
-        }
-        let arrayBuffer = data.buffer;
-        // Since we are returning the underlying arrayBuffer, we must create a new copy
-        // if this typed array / Buffer is a partial view into the ArryayBuffer
-        // TODO - this is a potentially unnecessary copy
-        const byteLength = data.byteLength || data.length;
-        if (data.byteOffset !== 0 || byteLength !== arrayBuffer.byteLength) {
-            // console.warn(`loaders.gl copying arraybuffer of length ${byteLength}`);
-            arrayBuffer = arrayBuffer.slice(data.byteOffset, data.byteOffset + byteLength);
-        }
-        return arrayBuffer;
-    }
-    throw new Error(ERR_DATA);
-}
-exports.getArrayBufferOrStringFromDataSync = getArrayBufferOrStringFromDataSync;
-// Convert async iterator to a promise
-async function getArrayBufferOrStringFromData(data, loader, options) {
-    const isArrayBuffer = data instanceof ArrayBuffer || ArrayBuffer.isView(data);
-    if (typeof data === 'string' || isArrayBuffer) {
-        return getArrayBufferOrStringFromDataSync(data, loader, options);
-    }
-    // Blobs and files are FileReader compatible
-    if ((0, is_type_1.isBlob)(data)) {
-        data = await (0, response_utils_1.makeResponse)(data);
-    }
-    if ((0, is_type_1.isResponse)(data)) {
-        const response = data;
-        await (0, response_utils_1.checkResponse)(response);
-        return loader.binary ? await response.arrayBuffer() : await response.text();
-    }
-    if ((0, is_type_1.isReadableStream)(data)) {
-        // @ts-expect-error TS2559 options type
-        data = (0, make_iterator_1.makeIterator)(data, options);
-    }
-    if ((0, is_type_1.isIterable)(data) || (0, is_type_1.isAsyncIterable)(data)) {
-        // Assume arrayBuffer iterator - attempt to concatenate
-        return (0, loader_utils_1.concatenateArrayBuffersAsync)(data);
-    }
-    throw new Error(ERR_DATA);
-}
-exports.getArrayBufferOrStringFromData = getArrayBufferOrStringFromData;
-async function getAsyncIterableFromData(data, options) {
-    if ((0, is_type_1.isIterator)(data)) {
-        return data;
-    }
-    if ((0, is_type_1.isResponse)(data)) {
-        const response = data;
-        // Note Since this function is not async, we currently can't load error message, just status
-        await (0, response_utils_1.checkResponse)(response);
-        // TODO - bug in polyfill, body can be a Promise under Node.js
-        // eslint-disable-next-line @typescript-eslint/await-thenable
-        const body = await response.body;
-        // TODO - body can be null?
-        return (0, make_iterator_1.makeIterator)(body, options);
-    }
-    if ((0, is_type_1.isBlob)(data) || (0, is_type_1.isReadableStream)(data)) {
-        return (0, make_iterator_1.makeIterator)(data, options);
-    }
-    if ((0, is_type_1.isAsyncIterable)(data)) {
-        return data[Symbol.asyncIterator]();
-    }
-    return getIterableFromData(data);
-}
-exports.getAsyncIterableFromData = getAsyncIterableFromData;
-async function getReadableStream(data) {
-    if ((0, is_type_1.isReadableStream)(data)) {
-        return data;
-    }
-    if ((0, is_type_1.isResponse)(data)) {
-        // @ts-ignore
-        return data.body;
-    }
-    const response = await (0, response_utils_1.makeResponse)(data);
-    // @ts-ignore
-    return response.body;
-}
-exports.getReadableStream = getReadableStream;
-// HELPERS
-function getIterableFromData(data) {
-    // generate an iterator that emits a single chunk
-    if (ArrayBuffer.isView(data)) {
-        return (function* oneChunk() {
-            yield data.buffer;
-        })();
-    }
-    if (data instanceof ArrayBuffer) {
-        return (function* oneChunk() {
-            yield data;
-        })();
-    }
-    if ((0, is_type_1.isIterator)(data)) {
-        return data;
-    }
-    if ((0, is_type_1.isIterable)(data)) {
-        return data[Symbol.iterator]();
-    }
-    throw new Error(ERR_DATA);
-}

package/dist/lib/loader-utils/get-fetch-function.js

@@ -1,31 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFetchFunction = void 0;
-const is_type_1 = require("../../javascript-utils/is-type");
-const fetch_file_1 = require("../fetch/fetch-file");
-const option_utils_1 = require("./option-utils");
-/**
- * Gets the current fetch function from options and context
- * @param options
- * @param context
- */
-function getFetchFunction(options, context) {
-    const globalOptions = (0, option_utils_1.getGlobalLoaderOptions)();
-    const fetchOptions = options || globalOptions;
-    // options.fetch can be a function
-    if (typeof fetchOptions.fetch === 'function') {
-        return fetchOptions.fetch;
-    }
-    // options.fetch can be an options object
-    if ((0, is_type_1.isObject)(fetchOptions.fetch)) {
-        return (url) => (0, fetch_file_1.fetchFile)(url, fetchOptions);
-    }
-    // else refer to context (from parent loader) if available
-    if (context?.fetch) {
-        return context?.fetch;
-    }
-    // else return the default fetch function
-    return fetch_file_1.fetchFile;
-}
-exports.getFetchFunction = getFetchFunction;

package/dist/lib/loader-utils/loader-context.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLoadersFromContext = exports.getLoaderContext = void 0;
-const get_fetch_function_1 = require("./get-fetch-function");
-const url_utils_1 = require("../utils/url-utils");
-const loader_utils_1 = require("@loaders.gl/loader-utils");
-/**
- * "sub" loaders invoked by other loaders get a "context" injected on `this`
- * The context will inject core methods like `parse` and contain information
- * about loaders and options passed in to the top-level `parse` call.
- *
- * @param context
- * @param options
- * @param previousContext
- */
-function getLoaderContext(context, options, parentContext) {
-    // For recursive calls, we already have a context
-    // TODO - add any additional loaders to context?
-    if (parentContext) {
-        return parentContext;
-    }
-    const newContext = {
-        fetch: (0, get_fetch_function_1.getFetchFunction)(options, context),
-        ...context
-    };
-    // Parse URLs so that subloaders can easily generate correct strings
-    if (newContext.url) {
-        const baseUrl = (0, url_utils_1.stripQueryString)(newContext.url);
-        newContext.baseUrl = baseUrl;
-        newContext.queryString = (0, url_utils_1.extractQueryString)(newContext.url);
-        newContext.filename = loader_utils_1.path.filename(baseUrl);
-        newContext.baseUrl = loader_utils_1.path.dirname(baseUrl);
-    }
-    // Recursive loading does not use single loader
-    if (!Array.isArray(newContext.loaders)) {
-        newContext.loaders = null;
-    }
-    return newContext;
-}
-exports.getLoaderContext = getLoaderContext;
-// eslint-disable-next-line complexity
-function getLoadersFromContext(loaders, context) {
-    // A single non-array loader is force selected, but only on top-level (context === null)
-    if (!context && loaders && !Array.isArray(loaders)) {
-        return loaders;
-    }
-    // Create a merged list
-    let candidateLoaders;
-    if (loaders) {
-        candidateLoaders = Array.isArray(loaders) ? loaders : [loaders];
-    }
-    if (context && context.loaders) {
-        const contextLoaders = Array.isArray(context.loaders) ? context.loaders : [context.loaders];
-        candidateLoaders = candidateLoaders ? [...candidateLoaders, ...contextLoaders] : contextLoaders;
-    }
-    // If no loaders, return null to look in globally registered loaders
-    return candidateLoaders && candidateLoaders.length ? candidateLoaders : null;
-}
-exports.getLoadersFromContext = getLoadersFromContext;

package/dist/lib/loader-utils/loggers.js

@@ -1,41 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConsoleLog = exports.NullLog = exports.probeLog = void 0;
-// probe.gl Log compatible loggers
-const log_1 = require("@probe.gl/log");
-exports.probeLog = new log_1.Log({ id: 'loaders.gl' });
-// Logs nothing
-class NullLog {
-    log() {
-        return () => { };
-    }
-    info() {
-        return () => { };
-    }
-    warn() {
-        return () => { };
-    }
-    error() {
-        return () => { };
-    }
-}
-exports.NullLog = NullLog;
-// Logs to console
-class ConsoleLog {
-    constructor() {
-        this.console = console; // eslint-disable-line
-    }
-    log(...args) {
-        return this.console.log.bind(this.console, ...args);
-    }
-    info(...args) {
-        return this.console.info.bind(this.console, ...args);
-    }
-    warn(...args) {
-        return this.console.warn.bind(this.console, ...args);
-    }
-    error(...args) {
-        return this.console.error.bind(this.console, ...args);
-    }
-}
-exports.ConsoleLog = ConsoleLog;

package/dist/lib/loader-utils/normalize-loader.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeLoader = exports.isLoaderObject = void 0;
-const loader_utils_1 = require("@loaders.gl/loader-utils");
-function isLoaderObject(loader) {
-    if (!loader) {
-        return false;
-    }
-    if (Array.isArray(loader)) {
-        loader = loader[0];
-    }
-    const hasExtensions = Array.isArray(loader?.extensions);
-    /* Now handled by types and worker loaders do not have these
-    let hasParser =
-      loader.parseTextSync ||
-      loader.parseSync ||
-      loader.parse ||
-      loader.parseStream || // TODO Remove, Replace with parseInBatches
-      loader.parseInBatches;
-    */
-    return hasExtensions;
-}
-exports.isLoaderObject = isLoaderObject;
-function normalizeLoader(loader) {
-    // This error is fairly easy to trigger by mixing up import statements etc
-    // So we make an exception and add a developer error message for this case
-    // To help new users from getting stuck here
-    (0, loader_utils_1.assert)(loader, 'null loader');
-    (0, loader_utils_1.assert)(isLoaderObject(loader), 'invalid loader');
-    // NORMALIZE [LOADER, OPTIONS] => LOADER
-    // If [loader, options], create a new loaders object with options merged in
-    let options;
-    if (Array.isArray(loader)) {
-        options = loader[1];
-        loader = loader[0];
-        loader = {
-            ...loader,
-            options: { ...loader.options, ...options }
-        };
-    }
-    // NORMALIZE text and binary flags
-    // Ensure at least one of text/binary flags are properly set
-    // @ts-expect-error
-    if (loader?.parseTextSync || loader?.parseText) {
-        loader.text = true;
-    }
-    if (!loader.text) {
-        loader.binary = true;
-    }
-    return loader;
-}
-exports.normalizeLoader = normalizeLoader;

package/dist/lib/loader-utils/option-defaults.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.REMOVED_LOADER_OPTIONS = exports.DEFAULT_LOADER_OPTIONS = void 0;
-const loader_utils_1 = require("@loaders.gl/loader-utils");
-const loggers_1 = require("./loggers");
-exports.DEFAULT_LOADER_OPTIONS = {
-    // baseUri
-    fetch: null,
-    mimeType: undefined,
-    nothrow: false,
-    log: new loggers_1.ConsoleLog(),
-    CDN: 'https://unpkg.com/@loaders.gl',
-    worker: true,
-    maxConcurrency: 3,
-    maxMobileConcurrency: 1,
-    reuseWorkers: loader_utils_1.isBrowser,
-    _nodeWorkers: false,
-    _workerType: '',
-    limit: 0,
-    _limitMB: 0,
-    batchSize: 'auto',
-    batchDebounceMs: 0,
-    metadata: false,
-    transforms: []
-};
-exports.REMOVED_LOADER_OPTIONS = {
-    throws: 'nothrow',
-    dataType: '(no longer used)',
-    uri: 'baseUri',
-    // Warn if fetch options are used on top-level
-    method: 'fetch.method',
-    headers: 'fetch.headers',
-    body: 'fetch.body',
-    mode: 'fetch.mode',
-    credentials: 'fetch.credentials',
-    cache: 'fetch.cache',
-    redirect: 'fetch.redirect',
-    referrer: 'fetch.referrer',
-    referrerPolicy: 'fetch.referrerPolicy',
-    integrity: 'fetch.integrity',
-    keepalive: 'fetch.keepalive',
-    signal: 'fetch.signal'
-};