@loaders.gl/core 4.5.3 → 5.0.0-alpha.10

package/dist/dist.dev.js

@@ -10,7 +10,6 @@ var __exports__ = (() => {
   var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
   var __getOwnPropNames = Object.getOwnPropertyNames;
   var __hasOwnProp = Object.prototype.hasOwnProperty;
-  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
   var __export = (target, all) => {
     for (var name in all)
       __defProp(target, name, { get: all[name], enumerable: true });
@@ -24,10 +23,6 @@ var __exports__ = (() => {
     return to;
   };
   var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-  var __publicField = (obj, key, value) => {
-    __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-    return value;
-  };
 
   // bundle.ts
   var bundle_exports = {};
@@ -39,10 +34,11 @@ var __exports__ = (() => {
     RequestScheduler: () => RequestScheduler,
     _BrowserFileSystem: () => BrowserFileSystem,
     _fetchProgress: () => fetchProgress,
-    _selectSource: () => selectSource2,
+    _selectSource: () => selectSource,
     _unregisterLoaders: () => _unregisterLoaders,
     assert: () => assert,
     concatenateArrayBuffersAsync: () => concatenateArrayBuffersAsync,
+    coreApi: () => coreApi,
     createDataSource: () => createDataSource,
     document: () => document_,
     encode: () => encode,
@@ -78,8 +74,11 @@ var __exports__ = (() => {
     makeTextDecoderIterator: () => makeTextDecoderIterator,
     makeTextEncoderIterator: () => makeTextEncoderIterator,
     parse: () => parse,
+    parseFile: () => parseFile,
     parseInBatches: () => parseInBatches,
     parseSync: () => parseSync,
+    preload: () => preload,
+    preloadSync: () => preloadSync,
     readArrayBuffer: () => readArrayBuffer,
     registerLoaders: () => registerLoaders,
     resolvePath: () => resolvePath,
@@ -682,7 +681,7 @@ var __exports__ = (() => {
     }
     const options = { ...baseOptions };
     for (const [key, newValue] of Object.entries(newOptions)) {
-      if (newValue && typeof newValue === "object" && !Array.isArray(newValue)) {
+      if (isPureObject(newValue)) {
         options[key] = mergeOptionsRecursively(
           options[key] || {},
           newOptions[key],
@@ -706,16 +705,11 @@ var __exports__ = (() => {
   var NPM_TAG = "latest";
 
   // ../worker-utils/src/lib/env-utils/version.ts
-  var warningIssued = false;
   function getVersion() {
     if (!globalThis._loadersgl_?.version) {
       globalThis._loadersgl_ = globalThis._loadersgl_ || {};
-      if (typeof __VERSION__ === "undefined" && !warningIssued) {
-        console.warn(
-          "loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN."
-        );
+      if (typeof __VERSION__ === "undefined") {
         globalThis._loadersgl_.version = NPM_TAG;
-        warningIssued = true;
       } else {
         globalThis._loadersgl_.version = __VERSION__;
       }
@@ -785,7 +779,9 @@ var __exports__ = (() => {
      * Call to resolve the `result` Promise with the supplied value
      */
     done(value) {
-      assert3(this.isRunning);
+      if (!this.isRunning) {
+        return;
+      }
       this.isRunning = false;
       this._resolve(value);
     }
@@ -793,14 +789,42 @@ var __exports__ = (() => {
      * Call to reject the `result` Promise with the supplied error
      */
     error(error) {
-      assert3(this.isRunning);
+      if (!this.isRunning) {
+        return;
+      }
       this.isRunning = false;
       this._reject(error);
     }
+    /**
+     * Terminates the worker executing this job and rejects its result.
+     * @param reason Abort reason supplied by the caller, or a cross-runtime `AbortError`.
+     */
+    abort(reason) {
+      if (!this.isRunning) {
+        return;
+      }
+      const error = reason ?? createAbortError(`Worker job "${this.name}" was aborted`);
+      this.workerThread.destroy();
+      this.error(error);
+    }
   };
+  function createAbortError(message) {
+    const error = new Error(message);
+    error.name = "AbortError";
+    return error;
+  }
 
   // ../worker-utils/src/lib/node/worker_threads-browser.ts
   var NodeWorker = class {
+    /** Restores the native worker constructor when this browser shim is embedded in a Node bundle. */
+    constructor(...arguments_) {
+      const runtimeProcess = globalThis.process;
+      const WorkerConstructor = runtimeProcess?.getBuiltinModule?.("node:worker_threads").Worker;
+      if (WorkerConstructor) {
+        return new WorkerConstructor(...arguments_);
+      }
+    }
+    /** No-op browser fallback matching the native Worker API. */
     terminate() {
     }
   };
@@ -901,6 +925,10 @@ var __exports__ = (() => {
     name;
     source;
     url;
+    /** Lazily resolves the classic worker URL used as a fallback. */
+    getUrl;
+    /** Creates a browser Worker directly. */
+    loadWorker;
     terminated = false;
     worker;
     onMessage;
@@ -911,11 +939,13 @@ var __exports__ = (() => {
       return typeof Worker !== "undefined" && isBrowser3 || typeof NodeWorker !== "undefined" && !isBrowser3;
     }
     constructor(props) {
-      const { name, source, url } = props;
-      assert3(source || url);
+      const { name, source, url, getUrl, loadWorker } = props;
+      assert3(source || url || getUrl || loadWorker);
       this.name = name;
       this.source = source;
       this.url = url;
+      this.getUrl = getUrl;
+      this.loadWorker = loadWorker;
       this.onMessage = NOOP;
       this.onError = (error) => console.log(error);
       this.worker = isBrowser3 ? this._createBrowserWorker() : this._createNodeWorker();
@@ -930,6 +960,18 @@ var __exports__ = (() => {
       this.worker.terminate();
       this.terminated = true;
     }
+    /** Keeps this worker from preventing Node.js process exit while idle. */
+    unref() {
+      if (!isBrowser3 && typeof this.worker.unref === "function") {
+        this.worker.unref();
+      }
+    }
+    /** Keeps this worker alive while it is actively processing a job. */
+    ref() {
+      if (!isBrowser3 && typeof this.worker.ref === "function") {
+        this.worker.ref();
+      }
+    }
     get isRunning() {
       return Boolean(this.onMessage);
     }
@@ -949,7 +991,7 @@ var __exports__ = (() => {
      */
     _getErrorFromErrorEvent(event) {
       let message = "Failed to load ";
-      message += `worker ${this.name} from ${this.url}. `;
+      message += `worker ${this.name} from ${this.url || "built-in worker factory"}. `;
       if (event.message) {
         message += `${event.message} in `;
       }
@@ -962,8 +1004,25 @@ var __exports__ = (() => {
      * Creates a worker thread on the browser
      */
     _createBrowserWorker() {
-      this._loadableURL = getLoadableWorkerURL({ source: this.source, url: this.url });
+      if (this.loadWorker) {
+        try {
+          const worker2 = this.loadWorker();
+          if (worker2) {
+            return this._initializeBrowserWorker(worker2);
+          }
+        } catch (error) {
+          if (!this.source && !this.url && !this.getUrl) {
+            throw error;
+          }
+        }
+      }
+      const url = this.url || this.getUrl?.();
+      this._loadableURL = getLoadableWorkerURL({ source: this.source, url });
       const worker = new Worker(this._loadableURL, { name: this.name });
+      return this._initializeBrowserWorker(worker);
+    }
+    /** Attaches protocol handlers to a browser worker. */
+    _initializeBrowserWorker(worker) {
       worker.onmessage = (event) => {
         if (!event.data) {
           this.onError(new Error("No data received"));
@@ -987,8 +1046,9 @@ var __exports__ = (() => {
       if (this.url) {
         const absolute = this.url.includes(":/") || this.url.startsWith("/");
         const url = absolute ? this.url : `./${this.url}`;
+        const workerUrl = url.startsWith("file:") ? new URL(url) : url;
         const type = this.url.endsWith(".ts") || this.url.endsWith(".mjs") ? "module" : "commonjs";
-        worker = new NodeWorker(url, { eval: false, type });
+        worker = new NodeWorker(workerUrl, { eval: false, type });
       } else if (this.source) {
         worker = new NodeWorker(this.source, { eval: true });
       } else {
@@ -1000,7 +1060,7 @@ var __exports__ = (() => {
       worker.on("error", (error) => {
         this.onError(error);
       });
-      worker.on("exit", (code) => {
+      worker.on("exit", (_code) => {
       });
       return worker;
     }
@@ -1012,6 +1072,10 @@ var __exports__ = (() => {
     source;
     // | Function;
     url;
+    /** Lazily resolves a classic worker fallback URL. */
+    getUrl;
+    /** Creates a browser Worker directly. */
+    loadWorker;
     maxConcurrency = 1;
     maxMobileConcurrency = 1;
     onDebug = () => {
@@ -1020,6 +1084,7 @@ var __exports__ = (() => {
     props = {};
     jobQueue = [];
     idleQueue = [];
+    activeJobs = /* @__PURE__ */ new Set();
     count = 0;
     isDestroyed = false;
     /** Checks if workers are supported on this platform */
@@ -1033,13 +1098,19 @@ var __exports__ = (() => {
     constructor(props) {
       this.source = props.source;
       this.url = props.url;
+      this.getUrl = props.getUrl;
+      this.loadWorker = props.loadWorker;
       this.setProps(props);
     }
     /**
-     * Terminates all workers in the pool
+     * Terminates all workers in the pool and aborts active jobs.
+     * @param reason Optional error delivered to active jobs.
      * @note Can free up significant memory
      */
-    destroy() {
+    destroy(reason = new Error("Worker pool was destroyed")) {
+      this.activeJobs.forEach((job) => job.abort(reason));
+      const queuedJobs = this.jobQueue.splice(0);
+      queuedJobs.forEach((queuedJob) => queuedJob.onReject(reason));
       this.idleQueue.forEach((worker) => worker.destroy());
       this.isDestroyed = true;
     }
@@ -1061,9 +1132,12 @@ var __exports__ = (() => {
         this.onDebug = props.onDebug;
       }
     }
-    async startJob(name, onMessage3 = (job, type, data) => job.done(data), onError = (job, error) => job.error(error)) {
-      const startPromise = new Promise((onStart) => {
-        this.jobQueue.push({ name, onMessage: onMessage3, onError, onStart });
+    async startJob(name, onMessage2 = (job, type, data) => job.done(data), onError = (job, error) => job.error(error)) {
+      if (this.isDestroyed) {
+        return Promise.reject(new Error("Worker pool was destroyed"));
+      }
+      const startPromise = new Promise((onStart, onReject) => {
+        this.jobQueue.push({ name, onMessage: onMessage2, onError, onStart, onReject });
         return this;
       });
       this._startQueuedJob();
@@ -1091,14 +1165,16 @@ var __exports__ = (() => {
           backlog: this.jobQueue.length
         });
         const job = new WorkerJob(queuedJob.name, workerThread);
+        this.activeJobs.add(job);
+        workerThread.ref();
         workerThread.onMessage = (data) => queuedJob.onMessage(job, data.type, data.payload);
         workerThread.onError = (error) => queuedJob.onError(job, error);
         queuedJob.onStart(job);
         try {
           await job.result;
-        } catch (error) {
-          console.error(`Worker exception: ${error}`);
+        } catch {
         } finally {
+          this.activeJobs.delete(job);
           this.returnWorkerToQueue(workerThread);
         }
       }
@@ -1113,17 +1189,19 @@ var __exports__ = (() => {
      */
     returnWorkerToQueue(worker) {
       const shouldDestroyWorker = (
-        // Workers on Node.js prevent the process from exiting.
-        // Until we figure out how to close them before exit, we always destroy them
-        !isBrowser3 || // If the pool is destroyed, there is no reason to keep the worker around
+        // Aborted jobs terminate their worker immediately.
+        worker.terminated || // If the pool is destroyed, there is no reason to keep the worker around
         this.isDestroyed || // If the app has disabled worker reuse, any completed workers should be destroyed
         !this.reuseWorkers || // If concurrency has been lowered, this worker might be surplus to requirements
         this.count > this._getMaxConcurrency()
       );
       if (shouldDestroyWorker) {
-        worker.destroy();
+        if (!worker.terminated) {
+          worker.destroy();
+        }
         this.count--;
       } else {
+        worker.unref();
         this.idleQueue.push(worker);
       }
       if (!this.isDestroyed) {
@@ -1140,7 +1218,13 @@ var __exports__ = (() => {
       if (this.count < this._getMaxConcurrency()) {
         this.count++;
         const name = `${this.name.toLowerCase()} (#${this.count} of ${this.maxConcurrency})`;
-        return new WorkerThread({ name, source: this.source, url: this.url });
+        return new WorkerThread({
+          name,
+          source: this.source,
+          url: this.url,
+          getUrl: this.getUrl,
+          loadWorker: this.loadWorker
+        });
       }
       return null;
     }
@@ -1157,9 +1241,13 @@ var __exports__ = (() => {
     onDebug: () => {
     }
   };
-  var _WorkerFarm = class {
+  var loadWorkerIds = /* @__PURE__ */ new WeakMap();
+  var nextLoadWorkerId = 1;
+  var WorkerFarm = class _WorkerFarm {
     props;
     workerPools = /* @__PURE__ */ new Map();
+    // singleton
+    static _workerFarm;
     /** Checks if workers are supported on this platform */
     static isSupported() {
       return WorkerThread.isSupported();
@@ -1177,12 +1265,13 @@ var __exports__ = (() => {
       this.workerPools = /* @__PURE__ */ new Map();
     }
     /**
-     * Terminate all workers in the farm
+     * Terminate all workers in the farm and abort active jobs.
+     * @param reason Optional error delivered to active jobs.
      * @note Can free up significant memory
      */
-    destroy() {
+    destroy(reason) {
       for (const workerPool of this.workerPools.values()) {
-        workerPool.destroy();
+        workerPool.destroy(reason);
       }
       this.workerPools = /* @__PURE__ */ new Map();
     }
@@ -1198,24 +1287,28 @@ var __exports__ = (() => {
     }
     /**
      * Returns a worker pool for the specified worker
-     * @param options - only used first time for a specific worker name
-     * @param options.name - the name of the worker - used to identify worker pool
-     * @param options.url -
-     * @param options.source -
+     * @param options Worker target used to identify and initialize the pool.
+     * @param options.name Worker name used as the base pool identity.
+     * @param options.url Worker script URL.
+     * @param options.source Inline worker source.
+     * @param options.loadWorker Built-in browser worker factory.
      * @example
      *   const job = WorkerFarm.getWorkerFarm().getWorkerPool({name, url}).startJob(...);
      */
     getWorkerPool(options) {
-      const { name, source, url } = options;
-      let workerPool = this.workerPools.get(name);
+      const { name, source, url, getUrl, loadWorker } = options;
+      const workerPoolKey = getWorkerPoolKey(options);
+      let workerPool = this.workerPools.get(workerPoolKey);
       if (!workerPool) {
         workerPool = new WorkerPool({
           name,
           source,
-          url
+          url,
+          getUrl,
+          loadWorker
         });
         workerPool.setProps(this._getWorkerPoolProps());
-        this.workerPools.set(name, workerPool);
+        this.workerPools.set(workerPoolKey, workerPool);
       }
       return workerPool;
     }
@@ -1228,62 +1321,345 @@ var __exports__ = (() => {
       };
     }
   };
-  var WorkerFarm = _WorkerFarm;
-  // singleton
-  __publicField(WorkerFarm, "_workerFarm");
+  function getWorkerPoolKey(options) {
+    const { name, source, url, urlKey, loadWorker } = options;
+    const sourceKey = source ? `source:${source}` : "";
+    const urlKeyPart = url || urlKey ? `url:${url || urlKey}` : "";
+    const loadWorkerKey = loadWorker ? `loadWorker:${getLoadWorkerId(loadWorker)}` : "";
+    return [name, sourceKey, urlKeyPart, loadWorkerKey].filter(Boolean).join("|");
+  }
+  function getLoadWorkerId(loadWorker) {
+    let loadWorkerId = loadWorkerIds.get(loadWorker);
+    if (!loadWorkerId) {
+      loadWorkerId = nextLoadWorkerId++;
+      loadWorkerIds.set(loadWorker, loadWorkerId);
+    }
+    return loadWorkerId;
+  }
+
+  // ../worker-utils/src/lib/async-queue/async-queue.ts
+  var AsyncQueue = class {
+    _values;
+    _settlers;
+    _closed;
+    constructor() {
+      this._values = [];
+      this._settlers = [];
+      this._closed = false;
+    }
+    /** Return an async iterator for this queue */
+    [Symbol.asyncIterator]() {
+      return this;
+    }
+    /** Push a new value - the async iterator will yield a promise resolved to this value */
+    push(value) {
+      return this.enqueue(value);
+    }
+    /**
+     * Push a new value - the async iterator will yield a promise resolved to this value
+     * Add an error - the async iterator will yield a promise rejected with this value
+     */
+    enqueue(value) {
+      if (this._closed) {
+        throw new Error("Closed");
+      }
+      if (this._settlers.length > 0) {
+        if (this._values.length > 0) {
+          throw new Error("Illegal internal state");
+        }
+        const settler = this._settlers.shift();
+        if (value instanceof Error) {
+          settler.reject(value);
+        } else {
+          settler.resolve({ value });
+        }
+      } else {
+        this._values.push(value);
+      }
+    }
+    /** Indicate that we not waiting for more values - The async iterator will be done */
+    close() {
+      while (this._settlers.length > 0) {
+        const settler = this._settlers.shift();
+        settler.resolve({ done: true });
+      }
+      this._closed = true;
+    }
+    // ITERATOR IMPLEMENTATION
+    /** @returns a Promise for an IteratorResult */
+    next() {
+      if (this._values.length > 0) {
+        const value = this._values.shift();
+        if (value instanceof Error) {
+          return Promise.reject(value);
+        }
+        return Promise.resolve({ done: false, value });
+      }
+      if (this._closed) {
+        if (this._settlers.length > 0) {
+          throw new Error("Illegal internal state");
+        }
+        return Promise.resolve({ done: true, value: void 0 });
+      }
+      return new Promise((resolve2, reject) => {
+        this._settlers.push({ resolve: resolve2, reject });
+      });
+    }
+  };
 
   // ../worker-utils/src/lib/worker-api/get-worker-url.ts
+  var warnedWorkerVersionFallbacks = /* @__PURE__ */ new Set();
   function getWorkerName(worker) {
     const warning = worker.version !== VERSION3 ? ` (worker-utils@${VERSION3})` : "";
     return `${worker.name}@${worker.version}${warning}`;
   }
-  function getWorkerURL(worker, options = {}) {
+  function getCustomWorkerURL(worker, options = {}) {
     const workerOptions = options[worker.id] || {};
-    const workerFile = isBrowser3 ? worker.workerFile || `${worker.id}-worker.js` : `${worker.id}-worker-node.js`;
+    const workerFile = isBrowser3 ? worker.workerFile || `${worker.id}-worker.js` : worker.workerNode || `${worker.id}-worker-node.js`;
     let url = workerOptions.workerUrl;
     if (!url && worker.id === "compression") {
       url = options.workerUrl;
     }
     const workerType = options._workerType || options?.core?._workerType;
-    if (workerType === "test") {
+    if (!url && workerType === "test") {
       if (isBrowser3) {
         url = `modules/${worker.module}/dist/${workerFile}`;
       } else {
         url = `modules/${worker.module}/src/workers/${worker.id}-worker-node.ts`;
       }
     }
-    if (!url) {
-      let version2 = worker.version;
-      if (version2 === "latest") {
-        version2 = NPM_TAG;
-      }
-      const versionTag = version2 ? `@${version2}` : "";
-      url = `https://unpkg.com/@loaders.gl/${worker.module}${versionTag}/dist/${workerFile}`;
-    }
+    return url || null;
+  }
+  function getWorkerURL(worker, options = {}) {
+    const customWorkerUrl = getCustomWorkerURL(worker, options);
+    const descriptorWorkerUrl = typeof worker.worker === "string" ? worker.worker : null;
+    const url = customWorkerUrl || descriptorWorkerUrl || getDefaultWorkerURL(worker, true);
     assert3(url);
     return url;
   }
+  function getDefaultWorkerURL(worker, warn = false) {
+    const workerFile = isBrowser3 ? worker.workerFile || `${worker.id}-worker.js` : worker.workerNode || `${worker.id}-worker-node.js`;
+    let version2 = worker.version;
+    if (version2 === "latest") {
+      version2 = NPM_TAG;
+    }
+    const versionTag = version2 ? `@${version2}` : "";
+    const url = `https://unpkg.com/@loaders.gl/${worker.module}${versionTag}/dist/${workerFile}`;
+    if (warn) {
+      warnIfUsingNpmTagFallback(worker, url);
+    }
+    return url;
+  }
+  function warnIfUsingNpmTagFallback(worker, url) {
+    if (worker.version !== "latest") {
+      return;
+    }
+    const workerId = `${worker.module}:${worker.id}`;
+    if (warnedWorkerVersionFallbacks.has(workerId)) {
+      return;
+    }
+    warnedWorkerVersionFallbacks.add(workerId);
+    console.warn(
+      `loaders.gl: ${worker.name} loader worker version is "latest" because __VERSION__ was not injected. Fetching ${url} from CDN.`
+    );
+  }
 
   // ../worker-utils/src/lib/worker-api/process-on-worker.ts
-  async function processOnWorker(worker, data, options = {}, context = {}) {
+  function canProcessOnWorker(worker, options) {
+    if (!WorkerFarm.isSupported()) {
+      return false;
+    }
+    const workerOptions = options?.[worker.id];
+    return Boolean(
+      (worker.worker || worker.loadWorker || workerOptions?.workerUrl) && options?.worker
+    );
+  }
+  async function processOnWorker(worker, data, options = {}, context = {}, jobContext = {}) {
+    throwIfAborted(options.signal);
     const name = getWorkerName(worker);
     const workerFarm = WorkerFarm.getWorkerFarm(options);
-    const { source } = options;
-    const workerPoolProps = { name, source };
-    if (!source) {
-      workerPoolProps.url = getWorkerURL(worker, options);
-    }
-    const workerPool = workerFarm.getWorkerPool(workerPoolProps);
+    const workerPool = workerFarm.getWorkerPool(getWorkerPoolTarget(worker, options, name));
     const jobName = options.jobName || worker.name;
     const job = await workerPool.startJob(
       jobName,
       // eslint-disable-next-line
       onMessage.bind(null, context)
     );
-    const transferableOptions = getTransferListForWriter(options);
-    job.postMessage("process", { input: data, options: transferableOptions });
-    const result = await job.result;
-    return result.result;
+    const abortJob = () => job.abort(getAbortReason(options.signal));
+    options.signal?.addEventListener("abort", abortJob, { once: true });
+    if (options.signal?.aborted) {
+      abortJob();
+    }
+    try {
+      const { signal: _signal, ...workerOptions } = options;
+      const transferableOptions = getTransferListForWriter(workerOptions);
+      const transferableContext = getTransferListForWriter(jobContext);
+      if (job.isRunning) {
+        job.postMessage("process", {
+          input: data,
+          options: transferableOptions,
+          context: transferableContext
+        });
+      }
+      const result = await job.result;
+      return result.result;
+    } finally {
+      options.signal?.removeEventListener("abort", abortJob);
+    }
+  }
+  function processOnWorkerInBatches(worker, input, options = {}, context = {}, jobContext = {}) {
+    return processOnWorkerInBatchesIterator(worker, input, options, context, jobContext);
+  }
+  async function* processOnWorkerInBatchesIterator(worker, input, options, context, jobContext) {
+    throwIfAborted(options.signal);
+    const name = getWorkerName(worker);
+    const workerFarm = WorkerFarm.getWorkerFarm(options);
+    const workerPool = workerFarm.getWorkerPool(getWorkerPoolTarget(worker, options, name));
+    const outputBatches = new AsyncQueue();
+    const inputIterator = getAsyncIterator(input);
+    let outputFinished = false;
+    let inputFinished = false;
+    let inputRequest = Promise.resolve();
+    const batchJobFailed = new Error("Worker batch job failed");
+    const finishOutput = () => {
+      if (!outputFinished) {
+        outputFinished = true;
+        outputBatches.close();
+      }
+    };
+    const failOutput = (_error) => {
+      if (!outputFinished) {
+        outputFinished = true;
+        outputBatches.enqueue(batchJobFailed);
+        outputBatches.close();
+      }
+    };
+    const job = await workerPool.startJob(
+      options.jobName || worker.name,
+      (activeJob, type, payload) => {
+        switch (type) {
+          case "input-request":
+            inputRequest = inputRequest.then(async () => {
+              const nextBatch = await inputIterator.next();
+              if (!activeJob.isRunning) {
+                return;
+              }
+              if (nextBatch.done) {
+                inputFinished = true;
+                activeJob.postMessage("input-done", {});
+              } else {
+                activeJob.postMessage("input-batch", { input: nextBatch.value });
+              }
+            }).catch((error) => activeJob.abort(error));
+            break;
+          case "output-batch":
+            outputBatches.push(payload.result);
+            break;
+          case "done":
+            activeJob.done(payload);
+            finishOutput();
+            break;
+          case "error": {
+            const error = new Error(payload.error || "Worker batch processing failed");
+            activeJob.error(error);
+            failOutput(error);
+            break;
+          }
+          case "process":
+            void onMessage(context, activeJob, type, payload);
+            break;
+          default: {
+            const error = new Error(`Unexpected worker batch message: ${type}`);
+            activeJob.error(error);
+            failOutput(error);
+            break;
+          }
+        }
+      }
+    );
+    const abortJob = () => job.abort(getAbortReason(options.signal));
+    options.signal?.addEventListener("abort", abortJob, { once: true });
+    if (options.signal?.aborted) {
+      abortJob();
+    }
+    void job.result.catch(failOutput);
+    try {
+      const { signal: _signal, ...workerOptions } = options;
+      if (job.isRunning) {
+        job.postMessage("process-in-batches", {
+          options: getTransferListForWriter(workerOptions),
+          context: getTransferListForWriter(jobContext)
+        });
+      }
+      try {
+        for await (const outputBatch of outputBatches) {
+          yield outputBatch;
+          if (job.isRunning) {
+            job.postMessage("output-ack", {});
+          }
+        }
+      } catch (error) {
+        if (error === batchJobFailed) {
+          await job.result;
+        }
+        throw error;
+      }
+      await job.result;
+    } finally {
+      options.signal?.removeEventListener("abort", abortJob);
+      if (job.isRunning) {
+        job.abort(createAbortError2("Worker batch iterator was closed"));
+      }
+      if (!inputFinished) {
+        closeInputIterator(inputIterator);
+      }
+    }
+  }
+  function throwIfAborted(signal) {
+    if (!signal?.aborted) {
+      return;
+    }
+    throw getAbortReason(signal);
+  }
+  function getAbortReason(signal) {
+    return signal?.reason ?? createAbortError2("Worker job was aborted");
+  }
+  function createAbortError2(message) {
+    const error = new Error(message);
+    error.name = "AbortError";
+    return error;
+  }
+  function getAsyncIterator(input) {
+    if (Symbol.asyncIterator in input) {
+      return input[Symbol.asyncIterator]();
+    }
+    return (async function* iterateSynchronously() {
+      yield* input;
+    })();
+  }
+  function closeInputIterator(inputIterator) {
+    try {
+      void Promise.resolve(inputIterator.return?.()).catch(() => void 0);
+    } catch {
+    }
+  }
+  function getWorkerPoolTarget(worker, options, name) {
+    if (options.source) {
+      return { name, source: options.source };
+    }
+    const customWorkerUrl = getCustomWorkerURL(worker, options);
+    if (customWorkerUrl) {
+      return { name, url: customWorkerUrl };
+    }
+    if (isBrowser3 && worker.loadWorker) {
+      return {
+        name,
+        loadWorker: worker.loadWorker,
+        getUrl: () => getWorkerURL(worker, options),
+        urlKey: getDefaultWorkerURL(worker)
+      };
+    }
+    return { name, url: getWorkerURL(worker, options) };
   }
   async function onMessage(context, job, type, payload) {
     switch (type) {
@@ -1300,7 +1676,7 @@ var __exports__ = (() => {
             job.postMessage("error", { id, error: "Worker not set up to process on main thread" });
             return;
           }
-          const result = await context.process(input, options);
+          const result = await context.process(input, options, void 0, payload.context || {});
           job.postMessage("done", { id, result });
         } catch (error) {
           const message = error instanceof Error ? error.message : "unknown error";
@@ -1324,60 +1700,167 @@ var __exports__ = (() => {
 
   // ../loader-utils/src/lib/worker-loader-utils/parse-with-worker.ts
   function canParseWithWorker(loader, options) {
-    if (!WorkerFarm.isSupported()) {
+    if (options?.core?.credentials?.some(
+      (credential) => credential.type === "request" || "token" in credential && typeof credential.token === "function"
+    ))
       return false;
-    }
-    const nodeWorkers = options?._nodeWorkers ?? options?.core?._nodeWorkers;
+    const workerOptions = getWorkerOptions(options);
+    const nodeWorkers = workerOptions._nodeWorkers;
     if (!isBrowser3 && !nodeWorkers) {
       return false;
     }
-    const useWorkers = options?.worker ?? options?.core?.worker;
-    return Boolean(loader.worker && useWorkers);
-  }
-  async function parseWithWorker(loader, data, options, context, parseOnMainThread) {
-    const name = loader.id;
-    const url = getWorkerURL(loader, options);
-    const workerFarm = WorkerFarm.getWorkerFarm(options?.core);
-    const workerPool = workerFarm.getWorkerPool({ name, url });
-    options = JSON.parse(JSON.stringify(options || {}));
-    options._workerLoaderId = loader.id;
-    context = JSON.parse(JSON.stringify(context || {}));
-    const job = await workerPool.startJob(
-      "process-on-worker",
-      // @ts-expect-error
-      onMessage2.bind(null, parseOnMainThread)
-      // eslint-disable-line @typescript-eslint/no-misused-promises
+    if (loader.id === "las" && (options?.las?.shape ?? "arrow-table") === "arrow-table") {
+      return false;
+    }
+    if (loader.id === "csv" && !shouldParseCSVWithWorker(options)) {
+      return false;
+    }
+    return Boolean(canProcessOnWorker(loader, workerOptions));
+  }
+  function shouldParseWithWorker(loader, data, options, context, estimateLoader = loader) {
+    if (!canParseWithWorker(loader, options)) {
+      return false;
+    }
+    if (options?.core?.worker !== "auto" || !estimateLoader.getWorkerEstimate) {
+      return true;
+    }
+    try {
+      const estimate = estimateLoader.getWorkerEstimate(data, options, context);
+      if (estimate === void 0 || !Number.isFinite(estimate) || estimate < 0 || estimate > 1) {
+        return true;
+      }
+      return estimate >= (options.core?.workerThreshold ?? 0.1);
+    } catch {
+      return true;
+    }
+  }
+  async function parseWithWorker(loader, data, options, context, parseOnMainThread, signal) {
+    const workerSignal = signal || getWorkerAbortSignal(options);
+    const result = await processOnWorker(
+      loader,
+      data,
+      { ...getWorkerOptions(options, loader), signal: workerSignal },
+      {
+        process: async (input, processOptions, _workerContext, parseContext) => {
+          if (!parseOnMainThread) {
+            throw new Error("Worker not set up to parse on main thread");
+          }
+          const { _loaderIds, _loaderIsArray, ...workerParseContext } = parseContext || {};
+          const mainThreadContext = context || parseContext ? { ...context, ...workerParseContext } : void 0;
+          return await callParseOnMainThread(
+            parseOnMainThread,
+            input,
+            processOptions,
+            mainThreadContext,
+            resolveWorkerLoaders(loader, _loaderIds, _loaderIsArray, context, options)
+          );
+        }
+      },
+      getSerializableLoaderContext(context)
     );
-    job.postMessage("process", {
-      // @ts-ignore
-      input: data,
-      options,
-      context
-    });
-    const result = await job.result;
-    return await result.result;
+    return isLoaderWithWorkerResultDeserializer(loader) ? loader.deserializeWorkerResult(result, options, context) : result;
   }
-  async function onMessage2(parseOnMainThread, job, type, payload) {
-    switch (type) {
-      case "done":
-        job.done(payload);
-        break;
-      case "error":
-        job.error(new Error(payload.error));
-        break;
-      case "process":
-        const { id, input, options } = payload;
-        try {
-          const result = await parseOnMainThread(input, options);
-          job.postMessage("done", { id, result });
-        } catch (error) {
-          const message = error instanceof Error ? error.message : "unknown error";
-          job.postMessage("error", { id, error: message });
+  async function* parseWithWorkerInBatches(loader, inputIterator, options, context, parseOnMainThread, signal) {
+    const workerSignal = signal || getWorkerAbortSignal(options);
+    const outputIterator = processOnWorkerInBatches(
+      loader,
+      inputIterator,
+      { ...getWorkerOptions(options), signal: workerSignal },
+      {
+        process: async (input, processOptions, _workerContext, parseContext) => {
+          if (!parseOnMainThread) {
+            throw new Error("Worker not set up to parse on main thread");
+          }
+          const { _loaderIds, _loaderIsArray, ...workerParseContext } = parseContext || {};
+          const mainThreadContext = context || parseContext ? { ...context, ...workerParseContext } : void 0;
+          return await callParseOnMainThread(
+            parseOnMainThread,
+            input,
+            processOptions,
+            mainThreadContext,
+            resolveWorkerLoaders(loader, _loaderIds, _loaderIsArray, context, options)
+          );
         }
-        break;
-      default:
-        console.warn(`parse-with-worker unknown message ${type}`);
+      },
+      getSerializableLoaderContext(context)
+    );
+    for await (const batch of outputIterator) {
+      yield loader.deserializeWorkerBatch ? loader.deserializeWorkerBatch(batch, options, context) : batch;
+    }
+  }
+  function getWorkerAbortSignal(options) {
+    const parquetSignal = options?.parquet?.signal;
+    if (typeof AbortSignal !== "undefined" && parquetSignal instanceof AbortSignal) {
+      return parquetSignal;
+    }
+    return void 0;
+  }
+  function callParseOnMainThread(parseOnMainThread, input, options, context, loaders) {
+    if (!loaders && parseOnMainThread.length <= 2) {
+      return parseOnMainThread(input, options);
+    }
+    return parseOnMainThread(input, loaders, options, context);
+  }
+  function resolveWorkerLoaders(loader, loaderIds, loaderIsArray, context, options) {
+    if (!loaderIds) return void 0;
+    const availableLoaders = /* @__PURE__ */ new Map();
+    const visitedLoaders = /* @__PURE__ */ new Set();
+    for (const candidate of [loader, ...context?.loaders || []]) {
+      visitLoader(candidate);
+    }
+    const selectedLoaders = loaderIds.map((loaderId) => {
+      const selectedLoader = availableLoaders.get(loaderId);
+      if (!selectedLoader) {
+        throw new Error(
+          `Worker requested unknown loader "${loaderId}". Declare it in loader.subloaders or pass it in context.loaders.`
+        );
+      }
+      return selectedLoader;
+    });
+    return loaderIsArray ? selectedLoaders : selectedLoaders[0];
+    function visitLoader(candidate) {
+      if (visitedLoaders.has(candidate)) return;
+      visitedLoaders.add(candidate);
+      availableLoaders.set(candidate.id, candidate);
+      for (const [name, dependency] of Object.entries(candidate.subloaders || {})) {
+        const replacement = options?.core?.subloaders?.[name] || dependency;
+        visitLoader(replacement);
+        availableLoaders.set(dependency.id, replacement);
+      }
+    }
+  }
+  function getWorkerOptions(options = {}, loader) {
+    const serializedOptions = JSON.parse(
+      JSON.stringify({
+        ...options,
+        ...options.core ? { core: { ...options.core, authentications: void 0 } } : {}
+      })
+    );
+    const workerOptions = {
+      ...serializedOptions.core,
+      ...serializedOptions
+    };
+    if (workerOptions.worker === "auto") {
+      workerOptions.worker = true;
+    }
+    if (loader) {
+      workerOptions._workerLoaderId = loader.id;
+    }
+    return workerOptions;
+  }
+  function getSerializableLoaderContext(context) {
+    if (!context) {
+      return {};
     }
+    const { fetch: fetch2, loaders, coreApi: coreApi2, _parse, _parseSync, _parseInBatches, ...serializableContext } = context;
+    return JSON.parse(JSON.stringify(serializableContext));
+  }
+  function shouldParseCSVWithWorker(options) {
+    const csvOptions = options;
+    return (csvOptions?.csv?.shape ?? csvOptions?.core?.shape) === "arrow-table";
+  }
+  function isLoaderWithWorkerResultDeserializer(loader) {
+    return typeof loader.deserializeWorkerResult === "function";
   }
 
   // ../loader-utils/src/lib/worker-loader-utils/encode-with-worker.ts
@@ -1425,6 +1908,19 @@ var __exports__ = (() => {
     return result.buffer;
   }
 
+  // ../loader-utils/src/lib/binary-utils/encode-array-buffer-to-base64.ts
+  function encodeArrayBufferToBase64(arrayBuffer) {
+    const bytes = new Uint8Array(arrayBuffer);
+    const encodedChunks = [];
+    const chunkByteLength = 3 * 4096;
+    for (let byteOffset = 0; byteOffset < bytes.length; byteOffset += chunkByteLength) {
+      encodedChunks.push(
+        btoa(String.fromCharCode(...bytes.subarray(byteOffset, byteOffset + chunkByteLength)))
+      );
+    }
+    return encodedChunks.join("");
+  }
+
   // ../loader-utils/src/lib/iterators/text-iterators.ts
   async function* makeTextDecoderIterator(arrayBufferIterator, options = {}) {
     const textDecoder = new TextDecoder(void 0, options);
@@ -1443,10 +1939,12 @@ var __exports__ = (() => {
     for await (const textChunk of textIterator) {
       previous += textChunk;
       let eolIndex;
-      while ((eolIndex = previous.indexOf("\n")) >= 0) {
+      eolIndex = previous.indexOf("\n");
+      while (eolIndex >= 0) {
         const line = previous.slice(0, eolIndex + 1);
         previous = previous.slice(eolIndex + 1);
         yield line;
+        eolIndex = previous.indexOf("\n");
       }
     }
     if (previous.length > 0) {
@@ -1749,6 +2247,7 @@ var __exports__ = (() => {
     /** Tracks the number of active requests and prioritizes/cancels queued requests. */
     requestQueue = [];
     requestMap = /* @__PURE__ */ new Map();
+    /** Pending arrival debounce or next-tick refill; only new arrivals replace this timer. */
     updateTimer = null;
     constructor(props = {}) {
       this.props = { ...DEFAULT_PROPS2, ...props };
@@ -1816,22 +2315,27 @@ var __exports__ = (() => {
           isDone = true;
           this.requestMap.delete(handle);
           this.activeRequestCount--;
-          if (this.updateTimer === null) {
-            this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), 0);
-          }
+          this.scheduleRefill();
         }
       };
       this.activeRequestCount++;
       return resolve2 ? resolve2({ done }) : Promise.resolve({ done });
     }
-    /** We check requests asynchronously, to prevent multiple updates */
+    /** Refills freed slots on the next tick while preserving any pending arrival debounce. */
+    scheduleRefill() {
+      if (this.updateTimer !== null) {
+        return;
+      }
+      this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), 0);
+    }
+    /** Restarts the quiet period when a new request enters the queue. */
     _issueNewRequests() {
       if (this.updateTimer !== null) {
         clearTimeout(this.updateTimer);
       }
       this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), this.props.debounceTime);
     }
-    /** Refresh all requests  */
+    /** Clears timer ownership before updating priorities and dispatching queued requests. */
     _issueNewRequestsAsync() {
       if (this.updateTimer !== null) {
         clearTimeout(this.updateTimer);
@@ -1873,109 +2377,287 @@ var __exports__ = (() => {
     }
   };
 
-  // ../loader-utils/src/lib/path-utils/file-aliases.ts
-  var pathPrefix = "";
-  var fileAliases = {};
-  function setPathPrefix(prefix) {
-    pathPrefix = prefix;
+  // ../loader-utils/src/lib/request-utils/authentication.ts
+  function resolveCredentials(credentials, authentications = []) {
+    if (credentials.every(isAuthentication)) return credentials;
+    return credentials.map((credential, index) => {
+      if (isAuthentication(credential)) return credential;
+      const AuthenticationClass = authentications.find(
+        (authentication2) => authentication2.type === credential?.type
+      );
+      if (!AuthenticationClass) {
+        throw new Error(`No authentication class registered for credential at index ${index}.`);
+      }
+      let authentication;
+      try {
+        authentication = new AuthenticationClass(credential);
+      } catch {
+        throw new Error(`Invalid authentication configuration at index ${index}.`);
+      }
+      if (!isAuthentication(authentication)) {
+        throw new Error(`Authentication class returned an invalid credential at index ${index}.`);
+      }
+      return authentication;
+    });
   }
-  function getPathPrefix() {
-    return pathPrefix;
+  function resolveAuthenticationOptions(options) {
+    if (!options.core?.credentials?.length) return options;
+    const credentials = resolveCredentials(options.core.credentials, options.core.authentications);
+    if (credentials === options.core.credentials) return options;
+    return { ...options, core: { ...options.core, credentials } };
+  }
+  async function resolveLoaderAuthenticationOptions(loader, url, options) {
+    if (!options.core?.credentials?.length || options.core.credentials.every(isAuthentication)) {
+      return options;
+    }
+    const contributions = await loader?.getAuthentications?.(url, options);
+    if (!contributions?.length) return resolveAuthenticationOptions(options);
+    return resolveAuthenticationOptions({
+      ...options,
+      core: {
+        ...options.core,
+        authentications: [...options.core?.authentications || [], ...contributions]
+      }
+    });
   }
-  function resolvePath(filename2) {
-    for (const alias in fileAliases) {
-      if (filename2.startsWith(alias)) {
-        const replacement = fileAliases[alias];
-        filename2 = filename2.replace(alias, replacement);
+  function isAuthentication(credential) {
+    if (!credential || typeof credential !== "object") return false;
+    if (typeof credential.id !== "string" || !Array.isArray(credential.origins)) return false;
+    if (credential.type === "request") return typeof credential.authenticate === "function";
+    return (credential.type === "header" || credential.type === "query-parameter") && typeof credential.name === "string" && (typeof credential.token === "string" || typeof credential.token === "function") && Array.isArray(credential.refreshStatusCodes);
+  }
+
+  // ../loader-utils/src/lib/request-utils/request-credentials.ts
+  var AUTHENTICATED_FETCH = /* @__PURE__ */ Symbol("loaders.gl.authenticated-fetch");
+  var refreshPromises = /* @__PURE__ */ new WeakMap();
+  function createAuthenticatedFetch(options) {
+    const suppliedFetch = options.fetch || ((url, requestOptions) => fetch(url, requestOptions));
+    const existingMetadata = suppliedFetch[AUTHENTICATED_FETCH];
+    const credentialResolutions = new Map(existingMetadata?.credentialResolutions);
+    const resolvedCredentials = resolveCredentials(
+      options.credentials.map((credential) => credentialResolutions.get(credential) || credential),
+      options.authentications
+    );
+    options.credentials.forEach((credential, index) => {
+      credentialResolutions.set(credential, resolvedCredentials[index]);
+    });
+    if (!options.fetchOptions && (!resolvedCredentials.length || existingMetadata?.credentials.length === resolvedCredentials.length && resolvedCredentials.every(
+      (credential, index) => credential === existingMetadata.credentials[index]
+    )))
+      return suppliedFetch;
+    const baseFetch = existingMetadata?.fetch || suppliedFetch;
+    const credentials = existingMetadata ? [.../* @__PURE__ */ new Set([...resolvedCredentials, ...existingMetadata.credentials])] : resolvedCredentials;
+    const fetchOptions = mergeFetchOptions(
+      existingMetadata?.fetchOptions || {},
+      options.fetchOptions
+    );
+    const tokenCredentials = credentials.filter(
+      (credential) => credential.type !== "request"
+    );
+    const requestCredentials = credentials.filter(
+      (credential) => credential.type === "request"
+    );
+    for (const credential of requestCredentials) normalizeRequestOrigins(credential.origins);
+    const authenticatedFetch = async (url, requestOptions = {}) => {
+      requestOptions = mergeFetchOptions(fetchOptions, requestOptions);
+      if (requestOptions.signal?.aborted) throw createAbortError3();
+      if (!credentials.length) return baseFetch(url, requestOptions);
+      const resolvedURL = parseHTTPURL(url);
+      const authorization = resolvedURL ? await authorizeRequest(resolvedURL, requestOptions, tokenCredentials) : { url, options: requestOptions, credentials: [] };
+      const signedRequest = await authenticateRequest(authorization, requestCredentials, "request");
+      const response = await baseFetch(signedRequest.url, signedRequest.options);
+      const refreshableCredentials = [];
+      for (const resolvedCredential of authorization.credentials) {
+        const { credential } = resolvedCredential;
+        if (typeof credential.token === "function" && (isReplayableRequest(requestOptions) || credential.canReplayRequest?.(url, requestOptions)) && (isReplayableRequest(signedRequest.options) || credential.canReplayRequest?.(signedRequest.url, signedRequest.options)) && (credential.refreshStatusCodes.includes(response.status) || await credential.shouldRefresh?.(response)))
+          refreshableCredentials.push(resolvedCredential);
       }
+      const shouldRetrySignature = isReplayableRequest(requestOptions) && isReplayableRequest(signedRequest.options) && signedRequest.credentials.some(
+        (credential) => credential.refreshStatusCodes?.includes(response.status)
+      );
+      if (!refreshableCredentials.length && !shouldRetrySignature) return response;
+      if (requestOptions.signal?.aborted) throw createAbortError3();
+      const refreshedTokens = /* @__PURE__ */ new Map();
+      await Promise.all(
+        refreshableCredentials.map(async ({ credential }) => {
+          const token = await refreshCredential(credential, url, response);
+          if (token) refreshedTokens.set(credential, token);
+        })
+      );
+      if (!refreshedTokens.size && !shouldRetrySignature) return response;
+      await response.body?.cancel().catch(() => {
+      });
+      if (requestOptions.signal?.aborted) throw createAbortError3();
+      const replayAuthorization = resolvedURL ? await authorizeRequest(
+        resolvedURL,
+        requestOptions,
+        tokenCredentials,
+        refreshedTokens,
+        authorization.credentials
+      ) : { url, options: requestOptions };
+      const replayRequest = await authenticateRequest(
+        replayAuthorization,
+        requestCredentials,
+        "retry",
+        response
+      );
+      return baseFetch(replayRequest.url, replayRequest.options);
+    };
+    Object.defineProperty(authenticatedFetch, AUTHENTICATED_FETCH, {
+      value: {
+        fetch: baseFetch,
+        credentials,
+        credentialResolutions,
+        fetchOptions
+      }
+    });
+    return authenticatedFetch;
+  }
+  function mergeFetchOptions(defaultOptions, requestOptions) {
+    const mergedOptions = { ...defaultOptions, ...requestOptions };
+    if (defaultOptions.headers || requestOptions?.headers) {
+      const headers = new Headers(defaultOptions.headers);
+      new Headers(requestOptions?.headers).forEach((value, key) => headers.set(key, value));
+      mergedOptions.headers = headers;
     }
-    if (!filename2.startsWith("http://") && !filename2.startsWith("https://")) {
-      filename2 = `${pathPrefix}${filename2}`;
-    }
-    return filename2;
+    return mergedOptions;
   }
-
-  // ../loader-utils/src/json-loader.ts
-  var VERSION4 = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
-  var JSONLoader = {
-    dataType: null,
-    batchType: null,
-    name: "JSON",
-    id: "json",
-    module: "json",
-    version: VERSION4,
-    extensions: ["json", "geojson"],
-    mimeTypes: ["application/json"],
-    category: "json",
-    text: true,
-    parseTextSync,
-    parse: async (arrayBuffer) => parseTextSync(new TextDecoder().decode(arrayBuffer)),
-    options: {}
-  };
-  function parseTextSync(text) {
-    return JSON.parse(text);
+  async function authenticateRequest(request, credentials, reason, response) {
+    const appliedCredentials = [];
+    const signal = request.options.signal;
+    for (const credential of credentials) {
+      const origin = getRequestOrigin(request.url);
+      if (!origin || !normalizeRequestOrigins(credential.origins).includes(origin)) continue;
+      if (signal?.aborted) throw createAbortError3();
+      const authenticatedRequest = await credential.authenticate({
+        url: request.url,
+        options: { ...request.options, headers: new Headers(request.options.headers) },
+        reason,
+        response: response ? { status: response.status, headers: new Headers(response.headers) } : void 0
+      });
+      if (!authenticatedRequest || typeof authenticatedRequest.url !== "string" || !authenticatedRequest.options || typeof authenticatedRequest.options !== "object") {
+        throw new Error("Authentication callback returned an invalid request.");
+      }
+      request = {
+        url: authenticatedRequest.url,
+        options: { ...authenticatedRequest.options, ...signal ? { signal } : {} }
+      };
+      appliedCredentials.push(credential);
+    }
+    if (signal?.aborted) throw createAbortError3();
+    return { ...request, credentials: appliedCredentials };
   }
-
-  // ../loader-utils/src/lib/node/buffer.browser.ts
-  function toArrayBuffer(buffer) {
-    return buffer;
+  function getRequestOrigin(url) {
+    try {
+      const parsedURL = new URL(url);
+      if (!parsedURL.host || parsedURL.username || parsedURL.password) return null;
+      return parsedURL.origin !== "null" ? parsedURL.origin : `${parsedURL.protocol}//${parsedURL.host}`;
+    } catch {
+      return null;
+    }
   }
-
-  // ../loader-utils/src/lib/binary-utils/memory-conversion-utils.ts
-  function isBuffer(value) {
-    return value && typeof value === "object" && value.isBuffer;
+  function normalizeRequestOrigins(origins) {
+    if (!origins.length)
+      throw new Error("Request authentication requires at least one exact origin.");
+    return origins.map((origin) => {
+      const resolvedOrigin = getRequestOrigin(origin);
+      let url;
+      try {
+        url = new URL(origin);
+      } catch {
+        throw new Error("Invalid request authentication origin.");
+      }
+      if (!resolvedOrigin || url.pathname && url.pathname !== "/" || url.search || url.hash) {
+        throw new Error("Invalid request authentication origin.");
+      }
+      return resolvedOrigin;
+    });
   }
-  function toArrayBuffer2(data) {
-    if (isBuffer(data)) {
-      return toArrayBuffer(data);
-    }
-    if (data instanceof ArrayBuffer) {
-      return data;
-    }
-    if (isSharedArrayBuffer(data)) {
-      return copyToArrayBuffer2(data);
-    }
-    if (ArrayBuffer.isView(data)) {
-      const buffer = data.buffer;
-      if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
-        return buffer;
+  async function authorizeRequest(sourceURL, requestOptions, credentials, tokenOverrides = /* @__PURE__ */ new Map(), previousCredentials = []) {
+    const url = new URL(sourceURL);
+    const headers = new Headers(requestOptions.headers);
+    const resolvedCredentials = [];
+    const previousTokens = new Map(
+      previousCredentials.map(({ credential, token }) => [credential, token])
+    );
+    for (const credential of credentials) {
+      if (!credential.origins.includes(url.origin)) continue;
+      const overrideToken = tokenOverrides.get(credential);
+      const previousToken = previousTokens.get(credential);
+      const ownsQueryParameter = credential.type === "query-parameter" && previousToken !== void 0;
+      const ownsHeader = credential.type === "header" && previousToken !== void 0;
+      if (credential.type === "query-parameter" && url.searchParams.has(credential.name) && !ownsQueryParameter || credential.type === "header" && headers.has(credential.name) && !ownsHeader) {
+        continue;
       }
-      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;
-    }
-    if (data && typeof data === "object" && data._toArrayBuffer) {
-      return data._toArrayBuffer();
+      const token = overrideToken ?? previousToken ?? await resolveToken(credential.token, { url: sourceURL.toString(), reason: "request" });
+      if (!token) continue;
+      if (credential.type === "query-parameter") {
+        url.searchParams.set(credential.name, token);
+      } else {
+        headers.set(credential.name, `${credential.prefix || ""}${token}`);
+      }
+      resolvedCredentials.push({ credential, token });
     }
-    throw new Error("toArrayBuffer");
+    return {
+      url: url.toString(),
+      options: { ...requestOptions, headers },
+      credentials: resolvedCredentials
+    };
   }
-  function ensureArrayBuffer(bufferSource) {
-    if (bufferSource instanceof ArrayBuffer) {
-      return bufferSource;
-    }
-    if (isSharedArrayBuffer(bufferSource)) {
-      return copyToArrayBuffer2(bufferSource);
-    }
-    const { buffer, byteOffset, byteLength } = bufferSource;
-    if (buffer instanceof ArrayBuffer && byteOffset === 0 && byteLength === buffer.byteLength) {
-      return buffer;
+  async function refreshCredential(credential, url, response) {
+    const existingPromise = refreshPromises.get(credential);
+    if (existingPromise) return existingPromise;
+    const tokenProvider = credential.token;
+    const promise = Promise.resolve(
+      tokenProvider({
+        url,
+        reason: "refresh",
+        response: { status: response.status, headers: response.headers }
+      })
+    ).finally(() => refreshPromises.delete(credential));
+    refreshPromises.set(credential, promise);
+    return promise;
+  }
+  async function resolveToken(token, context) {
+    return typeof token === "function" ? token(context) : token;
+  }
+  function parseHTTPURL(url) {
+    try {
+      const parsedURL = new URL(url);
+      return ["http:", "https:"].includes(parsedURL.protocol) ? parsedURL : null;
+    } catch {
+      return null;
     }
-    return copyToArrayBuffer2(buffer, byteOffset, byteLength);
   }
-  function copyToArrayBuffer2(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;
+  function isReplayableRequest(options) {
+    const method = (options.method || "GET").toUpperCase();
+    if (!["GET", "HEAD", "OPTIONS", "PUT", "DELETE"].includes(method)) return false;
+    return !(options.body && typeof ReadableStream !== "undefined" && options.body instanceof ReadableStream);
   }
-  function toArrayBufferView(data) {
-    if (ArrayBuffer.isView(data)) {
-      return data;
+  function createAbortError3() {
+    return new DOMException("The operation was aborted.", "AbortError");
+  }
+
+  // ../loader-utils/src/lib/path-utils/file-aliases.ts
+  var pathPrefix = "";
+  var fileAliases = {};
+  function setPathPrefix(prefix) {
+    pathPrefix = prefix;
+  }
+  function getPathPrefix() {
+    return pathPrefix;
+  }
+  function resolvePath(filename2) {
+    for (const alias in fileAliases) {
+      if (filename2.startsWith(alias)) {
+        const replacement = fileAliases[alias];
+        filename2 = filename2.replace(alias, replacement);
+      }
     }
-    return new Uint8Array(data);
+    if (!filename2.startsWith("http://") && !filename2.startsWith("https://")) {
+      filename2 = `${pathPrefix}${filename2}`;
+    }
+    return filename2;
   }
 
   // ../loader-utils/src/lib/path-utils/path.ts
@@ -1992,7 +2674,7 @@ var __exports__ = (() => {
     if (typeof process !== "undefined" && typeof process.cwd !== "undefined") {
       return process.cwd();
     }
-    const pathname = window.location?.pathname;
+    const pathname = globalThis.location?.pathname;
     return pathname?.slice(0, pathname.lastIndexOf("/") + 1) || "";
   }
 
@@ -2121,6 +2803,91 @@ var __exports__ = (() => {
     return res;
   }
 
+  // ../loader-utils/src/json-loader.ts
+  var VERSION4 = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
+  var JSONLoader = {
+    dataType: null,
+    batchType: null,
+    name: "JSON",
+    id: "json",
+    module: "json",
+    version: VERSION4,
+    encoding: "json",
+    format: "json",
+    extensions: ["json", "geojson"],
+    mimeTypes: ["application/json"],
+    category: "json",
+    text: true,
+    parseTextSync,
+    parse: async (arrayBuffer) => parseTextSync(new TextDecoder().decode(arrayBuffer)),
+    options: {}
+  };
+  function parseTextSync(text) {
+    return JSON.parse(text);
+  }
+
+  // ../loader-utils/src/lib/node/buffer.browser.ts
+  function toArrayBuffer(buffer) {
+    return buffer;
+  }
+
+  // ../loader-utils/src/lib/binary-utils/memory-conversion-utils.ts
+  function isBuffer(value) {
+    return value && typeof value === "object" && value.isBuffer;
+  }
+  function toArrayBuffer2(data) {
+    if (isBuffer(data)) {
+      return toArrayBuffer(data);
+    }
+    if (data instanceof ArrayBuffer) {
+      return data;
+    }
+    if (isSharedArrayBuffer(data)) {
+      return copyToArrayBuffer2(data);
+    }
+    if (ArrayBuffer.isView(data)) {
+      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;
+    }
+    if (data && typeof data === "object" && data._toArrayBuffer) {
+      return data._toArrayBuffer();
+    }
+    throw new Error("toArrayBuffer");
+  }
+  function ensureArrayBuffer(bufferSource) {
+    if (bufferSource instanceof ArrayBuffer) {
+      return bufferSource;
+    }
+    if (isSharedArrayBuffer(bufferSource)) {
+      return copyToArrayBuffer2(bufferSource);
+    }
+    const { buffer, byteOffset, byteLength } = bufferSource;
+    if (buffer instanceof ArrayBuffer && byteOffset === 0 && byteLength === buffer.byteLength) {
+      return buffer;
+    }
+    return copyToArrayBuffer2(buffer, byteOffset, byteLength);
+  }
+  function copyToArrayBuffer2(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;
+  }
+  function toArrayBufferView(data) {
+    if (ArrayBuffer.isView(data)) {
+      return data;
+    }
+    return new Uint8Array(data);
+  }
+
   // ../loader-utils/src/lib/files/blob-file.ts
   var BlobFile = class {
     handle;
@@ -2142,8 +2909,14 @@ var __exports__ = (() => {
         isDirectory: false
       };
     }
-    async read(start, length) {
+    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;
     }
   };
@@ -2189,6 +2962,11 @@ var __exports__ = (() => {
     }
   };
 
+  // ../loader-utils/src/source-types.ts
+  function isSourceLoader(loader) {
+    return Boolean(loader && typeof loader === "object" && "createDataSource" in loader);
+  }
+
   // src/lib/fetch/fetch-error.ts
   var FetchError = class extends Error {
     constructor(message, info) {
@@ -2340,7 +3118,7 @@ var __exports__ = (() => {
     try {
       const contentType = response.headers.get("Content-Type");
       info.reason = !response.bodyUsed && contentType?.includes("application/json") ? await response.json() : await response.text();
-    } catch (error) {
+    } catch (_error) {
     }
     return new FetchError(message, info);
   }
@@ -2359,19 +3137,11 @@ var __exports__ = (() => {
     }
     if (resource instanceof ArrayBuffer) {
       const slice = resource.slice(0, INITIAL_DATA_LENGTH);
-      const base64 = arrayBufferToBase64(slice);
+      const base64 = encodeArrayBufferToBase64(slice);
       return `data:base64,${base64}`;
     }
     return null;
   }
-  function arrayBufferToBase64(buffer) {
-    let binary = "";
-    const bytes = new Uint8Array(buffer);
-    for (let i = 0; i < bytes.byteLength; i++) {
-      binary += String.fromCharCode(bytes[i]);
-    }
-    return btoa(binary);
-  }
 
   // src/lib/fetch/fetch-file.ts
   function isNodePath(url) {
@@ -2416,37 +3186,64 @@ var __exports__ = (() => {
   // src/lib/loader-utils/loggers.ts
   var probeLog = new ProbeLog({ id: "loaders.gl" });
   var NullLog = class {
+    /** Drops a log message. */
     log() {
       return () => {
       };
     }
+    /** Drops an info message. */
     info() {
       return () => {
       };
     }
+    /** Logs one message once; no-op for the null logger. */
+    once() {
+      return () => {
+      };
+    }
+    /** Drops a warning message. */
     warn() {
       return () => {
       };
     }
+    /** Drops an error message. */
     error() {
       return () => {
       };
     }
   };
   var ConsoleLog = class {
+    /** Console-like object used for message output. */
     console;
+    /** Messages already emitted through `once`. */
+    onceMessages = /* @__PURE__ */ new Set();
+    /** Creates a console-backed logger. */
     constructor() {
       this.console = console;
     }
+    /** Logs a message to the console. */
     log(...args) {
       return this.console.log.bind(this.console, ...args);
     }
+    /** Logs an informational message to the console. */
     info(...args) {
       return this.console.info.bind(this.console, ...args);
     }
+    /** Logs one message once to the console. */
+    once(...args) {
+      const message = String(args[0]);
+      if (this.onceMessages.has(message)) {
+        return () => {
+        };
+      }
+      this.onceMessages.add(message);
+      return this.console.info.bind(this.console, ...args);
+    }
+    /** Logs a warning message to the console. */
     warn(...args) {
       return this.console.warn.bind(this.console, ...args);
     }
+    /** Logs an error message to the console. */
     error(...args) {
       return this.console.error.bind(this.console, ...args);
     }
@@ -2454,6 +3251,7 @@ var __exports__ = (() => {
 
   // src/lib/loader-utils/option-defaults.ts
   var DEFAULT_LOADER_OPTIONS = {
+    searchParams: void 0,
     core: {
       baseUrl: void 0,
       // baseUrl
@@ -2462,12 +3260,15 @@ var __exports__ = (() => {
       fallbackMimeType: void 0,
       ignoreRegisteredLoaders: void 0,
       nothrow: false,
+      shape: void 0,
       log: new ConsoleLog(),
       // A probe.gl compatible (`log.log()()` syntax) that just logs to console
       useLocalLibraries: false,
+      subloaders: void 0,
       CDN: "https://unpkg.com/@loaders.gl",
       worker: true,
       // By default, use worker if provided by loader.
+      workerThreshold: 0.1,
       maxConcurrency: 3,
       // How many worker instances should be created for each loader.
       maxMobileConcurrency: 1,
@@ -2507,6 +3308,7 @@ var __exports__ = (() => {
     _worker: "core._workerType",
     limit: "core.limit",
     _limitMB: "core._limitMB",
+    shape: "core.shape",
     batchSize: "core.batchSize",
     batchDebounceMs: "core.batchDebounceMs",
     metadata: "core.metadata",
@@ -2542,18 +3344,42 @@ var __exports__ = (() => {
     "useLocalLibraries",
     "CDN",
     "worker",
+    "workerThreshold",
     "maxConcurrency",
     "maxMobileConcurrency",
     "reuseWorkers",
+    "workerTransferBufferCopy",
     "_nodeWorkers",
     "_workerType",
     "limit",
     "_limitMB",
+    "shape",
     "batchSize",
     "batchDebounceMs",
     "metadata",
     "transforms"
   ];
+  function applySearchParamsToUrl(url, options) {
+    const searchParams = options?.searchParams;
+    if (!searchParams || Object.keys(searchParams).length === 0 || /^(?:data|blob):/i.test(url)) {
+      return url;
+    }
+    const hashIndex = url.indexOf("#");
+    const hash = hashIndex >= 0 ? url.slice(hashIndex) : "";
+    const urlWithoutHash = hashIndex >= 0 ? url.slice(0, hashIndex) : url;
+    const queryIndex = urlWithoutHash.indexOf("?");
+    const path = queryIndex >= 0 ? urlWithoutHash.slice(0, queryIndex) : urlWithoutHash;
+    const query = queryIndex >= 0 ? urlWithoutHash.slice(queryIndex + 1) : "";
+    const existingSearchParams = new URLSearchParams(query);
+    const appendedSearchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(searchParams)) {
+      if (!existingSearchParams.has(key)) {
+        appendedSearchParams.set(key, String(value));
+      }
+    }
+    const serializedAppendedSearchParams = appendedSearchParams.toString();
+    return `${path}${queryIndex >= 0 ? `?${query}` : ""}${serializedAppendedSearchParams ? `${queryIndex >= 0 ? "&" : "?"}${serializedAppendedSearchParams}` : ""}${hash}`;
+  }
   function getGlobalLoaderState() {
     globalThis.loaders = globalThis.loaders || {};
     const { loaders } = globalThis;
@@ -2580,7 +3406,10 @@ var __exports__ = (() => {
     loaders = loaders || [];
     loaders = Array.isArray(loaders) ? loaders : [loaders];
     validateOptions(options, loaders);
-    return normalizeLoaderOptions(normalizeOptionsInternal(loader, options, url));
+    validateWorkerThreshold(options);
+    const normalizedOptions = normalizeLoaderOptions(normalizeOptionsInternal(loader, options, url));
+    validateWorkerThreshold(normalizedOptions);
+    return normalizedOptions;
   }
   function normalizeLoaderOptions(options) {
     const normalized = cloneLoaderOptions(options);
@@ -2604,6 +3433,12 @@ var __exports__ = (() => {
       validateOptionsObject(idOptions, loader.id, loaderOptions, deprecatedOptions, loaders);
     }
   }
+  function validateWorkerThreshold(options) {
+    const threshold = options.core?.workerThreshold;
+    if (threshold !== void 0 && (!Number.isFinite(threshold) || threshold < 0 || threshold > 1)) {
+      throw new Error("core.workerThreshold must be a finite number between 0 and 1");
+    }
+  }
   function validateOptionsObject(options, id, defaultOptions, deprecatedOptions, loaders) {
     const loaderName = id || "Top level";
     const prefix = id ? `${id}.` : "";
@@ -2659,10 +3494,34 @@ var __exports__ = (() => {
     mergeNestedFields(mergedOptions, normalizeLoaderOptions(getGlobalLoaderOptions()));
     const userOptions = normalizeLoaderOptions(options);
     mergeNestedFields(mergedOptions, userOptions);
+    applyCoreShapeDefault(mergedOptions, userOptions, loader);
     addUrlOptions(mergedOptions, url);
     addDeprecatedTopLevelOptions(mergedOptions);
     return mergedOptions;
   }
+  function applyCoreShapeDefault(mergedOptions, userOptions, loader) {
+    const coreShape = mergedOptions.core?.shape;
+    if (coreShape === void 0) {
+      return;
+    }
+    const loaderScopedDefaults = loader.options?.[loader.id];
+    if (!isPureObject(loaderScopedDefaults) || !("shape" in loaderScopedDefaults)) {
+      return;
+    }
+    const globalLoaderScopedOptions = getGlobalLoaderOptions()[loader.id];
+    if (isPureObject(globalLoaderScopedOptions) && "shape" in globalLoaderScopedOptions) {
+      return;
+    }
+    const userLoaderScopedOptions = userOptions[loader.id];
+    if (isPureObject(userLoaderScopedOptions) && "shape" in userLoaderScopedOptions) {
+      return;
+    }
+    const loaderScopedOptions = mergedOptions[loader.id];
+    mergedOptions[loader.id] = {
+      ...isPureObject(loaderScopedOptions) ? loaderScopedOptions : {},
+      shape: coreShape
+    };
+  }
   function mergeNestedFields(mergedOptions, options) {
     for (const key in options) {
       if (key in options) {
@@ -2704,7 +3563,8 @@ var __exports__ = (() => {
     }
     for (const key of CORE_LOADER_OPTION_KEYS) {
       if (options[key] !== void 0) {
-        const coreOptions = options.core = options.core || {};
+        options.core ||= {};
+        const coreOptions = options.core;
         const coreRecord = coreOptions;
         if (coreRecord[key] === void 0) {
           coreRecord[key] = options[key];
@@ -2864,16 +3724,27 @@ var __exports__ = (() => {
     const testUrl = stripQueryString(url) || context?.url;
     let loader = null;
     let reason = "";
+    const sourceType = options?.core && "type" in options.core ? options.core.type : void 0;
+    if (sourceType && sourceType !== "auto") {
+      loader = findSourceLoaderByType(loaders, sourceType);
+      reason = loader ? `match forced by supplied source type ${sourceType}` : "";
+    }
     if (options?.core?.mimeType) {
       loader = findLoaderByMIMEType(loaders, options?.core?.mimeType);
       reason = `match forced by supplied MIME type ${options?.core?.mimeType}`;
     }
+    loader = loader || findSourceLoaderByTestURL(loaders, testUrl);
+    reason = reason || (loader ? `matched source url ${testUrl}` : "");
     loader = loader || findLoaderByUrl(loaders, testUrl);
     reason = reason || (loader ? `matched url ${testUrl}` : "");
     loader = loader || findLoaderByMIMEType(loaders, type);
     reason = reason || (loader ? `matched MIME type ${type}` : "");
     loader = loader || findLoaderByInitialBytes(loaders, data);
     reason = reason || (loader ? `matched initial data ${getFirstCharacters(data)}` : "");
+    if (!loader && isBlob(data)) {
+      loader = findSourceLoaderByTestData(loaders, data);
+      reason = reason || (loader ? "matched source testData" : "");
+    }
     if (options?.core?.fallbackMimeType) {
       loader = loader || findLoaderByMIMEType(loaders, options?.core?.fallbackMimeType);
       reason = reason || (loader ? `matched fallback MIME type ${type}` : "");
@@ -2923,6 +3794,35 @@ var __exports__ = (() => {
     }
     return null;
   }
+  function findSourceLoaderByType(loaders, type) {
+    for (const loader of loaders) {
+      if (isSourceLoader(loader) && loader.type === type) {
+        return loader;
+      }
+    }
+    return null;
+  }
+  function findSourceLoaderByTestURL(loaders, url) {
+    if (!url) {
+      return null;
+    }
+    for (const loader of loaders) {
+      if (isSourceLoader(loader) && loader.testURL(url)) {
+        return loader;
+      }
+    }
+    return null;
+  }
+  function findSourceLoaderByTestData(loaders, data) {
+    for (const loader of loaders) {
+      if (isSourceLoader(loader)) {
+        if (loader.testData?.(data)) {
+          return loader;
+        }
+      }
+    }
+    return null;
+  }
   function findLoaderByMIMEType(loaders, mimeType) {
     for (const loader of loaders) {
       if (loader.mimeTypes?.some((mimeType1) => compareMIMETypes(mimeType, mimeType1))) {
@@ -3054,20 +3954,57 @@ var __exports__ = (() => {
   async function* makeBrowserStreamIterator(stream, options) {
     const reader = stream.getReader();
     let nextBatchPromise;
+    let streamFinished = false;
+    let streamReadFailed = false;
+    let iteratorFailed = false;
     try {
       while (true) {
         const currentBatchPromise = nextBatchPromise || reader.read();
-        if (options?._streamReadAhead) {
-          nextBatchPromise = reader.read();
+        nextBatchPromise = void 0;
+        let batch;
+        try {
+          batch = await currentBatchPromise;
+        } catch (error) {
+          streamReadFailed = true;
+          throw error;
         }
-        const { done, value } = await currentBatchPromise;
+        const { done, value } = batch;
         if (done) {
+          streamFinished = true;
           return;
         }
+        if (options?._streamReadAhead) {
+          nextBatchPromise = reader.read();
+          void nextBatchPromise.catch(() => {
+          });
+        }
         yield toArrayBuffer2(value);
       }
     } catch (error) {
-      reader.releaseLock();
+      iteratorFailed = true;
+      throw error;
+    } finally {
+      let cleanupFailed = false;
+      let cleanupError;
+      if (!streamFinished && !streamReadFailed) {
+        try {
+          await reader.cancel();
+        } catch (error) {
+          cleanupFailed = true;
+          cleanupError = error;
+        }
+      }
+      try {
+        reader.releaseLock();
+      } catch (error) {
+        if (!cleanupFailed) {
+          cleanupFailed = true;
+          cleanupError = error;
+        }
+      }
+      if (!iteratorFailed && cleanupFailed) {
+        throw cleanupError;
+      }
     }
   }
   async function* makeNodeStreamIterator(stream, options) {
@@ -3138,6 +4075,28 @@ var __exports__ = (() => {
     }
     throw new Error(ERR_DATA);
   }
+  async function getArrayBufferFromData(data, options) {
+    if (typeof data === "string") {
+      return new TextEncoder().encode(data).buffer;
+    }
+    if (isArrayBufferLike(data)) {
+      return toArrayBuffer2(toArrayBufferView(data));
+    }
+    if (isBlob(data)) {
+      data = await makeResponse(data);
+    }
+    if (isResponse(data)) {
+      await checkResponse(data);
+      return await data.arrayBuffer();
+    }
+    if (isReadableStream(data)) {
+      data = makeIterator(data, options);
+    }
+    if (isIterable(data) || isAsyncIterable(data)) {
+      return concatenateArrayBuffersAsync(data);
+    }
+    throw new Error(ERR_DATA);
+  }
   async function getAsyncIterableFromData(data, options) {
     if (isPromise(data)) {
       data = await data;
@@ -3166,14 +4125,14 @@ var __exports__ = (() => {
   }
   function getIterableFromData(data) {
     if (ArrayBuffer.isView(data)) {
-      return function* oneChunk() {
+      return (function* oneChunk() {
         yield toArrayBuffer2(data);
-      }();
+      })();
     }
     if (isArrayBufferLike(data)) {
-      return function* oneChunk() {
+      return (function* oneChunk() {
         yield toArrayBuffer2(data);
-      }();
+      })();
     }
     if (isIterator(data)) {
       return data;
@@ -3189,103 +4148,287 @@ var __exports__ = (() => {
     const globalOptions = getGlobalLoaderOptions();
     const loaderOptions = options || globalOptions;
     const fetchOption = loaderOptions.fetch ?? loaderOptions.core?.fetch;
+    let fetchFunction;
     if (typeof fetchOption === "function") {
-      return fetchOption;
+      fetchFunction = fetchOption;
+    } else if (isObject(fetchOption)) {
+      fetchFunction = context?.fetch || fetchFile;
+    } else if (context?.fetch) {
+      fetchFunction = context.fetch;
+    } else {
+      fetchFunction = fetchFile;
     }
-    if (isObject(fetchOption)) {
-      return (url) => fetchFile(url, fetchOption);
+    return createAuthenticatedFetch({
+      fetch: fetchFunction,
+      credentials: loaderOptions.core?.credentials || [],
+      authentications: loaderOptions.core?.authentications,
+      fetchOptions: isObject(fetchOption) ? fetchOption : void 0
+    });
+  }
+
+  // src/lib/api/load-loader.ts
+  var loaderImplementationPromises = /* @__PURE__ */ new Map();
+  var loaderImplementations = /* @__PURE__ */ new Map();
+  async function getLoaderImplementation(loader, options, url) {
+    if (isSourceLoader(loader)) {
+      const source = loader.preload ? await loader.preload(url || "", options) : loader;
+      if (!isSourceLoader(source)) {
+        throw new Error(
+          `${loader.id} source loader preload() did not return a runtime source loader`
+        );
+      }
+      return source;
     }
-    if (context?.fetch) {
-      return context?.fetch;
+    if (isLoaderWithParser(loader)) {
+      return loader;
+    }
+    const implementationCacheKey = getLoaderImplementationCacheKey(loader, options);
+    const loaderImplementation = loaderImplementations.get(loader)?.get(implementationCacheKey);
+    if (loaderImplementation) {
+      return loaderImplementation;
+    }
+    let loaderImplementationPromisesForLoader = loaderImplementationPromises.get(loader);
+    if (!loaderImplementationPromisesForLoader) {
+      loaderImplementationPromisesForLoader = /* @__PURE__ */ new Map();
+      loaderImplementationPromises.set(loader, loaderImplementationPromisesForLoader);
+    }
+    let loaderImplementationPromise = loaderImplementationPromisesForLoader.get(implementationCacheKey);
+    if (!loaderImplementationPromise) {
+      loaderImplementationPromise = resolveLoaderImplementation(loader, options, url).then((implementation) => {
+        let loaderImplementationsForLoader = loaderImplementations.get(loader);
+        if (!loaderImplementationsForLoader) {
+          loaderImplementationsForLoader = /* @__PURE__ */ new Map();
+          loaderImplementations.set(loader, loaderImplementationsForLoader);
+        }
+        loaderImplementationsForLoader.set(implementationCacheKey, implementation);
+        return implementation;
+      }).catch((error) => {
+        loaderImplementationPromisesForLoader.delete(implementationCacheKey);
+        if (loaderImplementationPromisesForLoader.size === 0) {
+          loaderImplementationPromises.delete(loader);
+        }
+        throw error;
+      });
+      loaderImplementationPromisesForLoader.set(implementationCacheKey, loaderImplementationPromise);
     }
-    return fetchFile;
+    return await loaderImplementationPromise;
   }
-
-  // src/lib/loader-utils/loader-context.ts
-  function getLoaderContext(context, options, parentContext) {
-    if (parentContext) {
-      return parentContext;
+  function getLoaderImplementationSync(loader) {
+    if (loader.subloaders && !preparedLoaders.has(loader)) {
+      const prepared = preparedDefaults.get(loader);
+      if (prepared) return prepared;
+      if (!isLoaderWithParser(loader)) return null;
     }
-    const newContext = {
-      fetch: getFetchFunction(options, context),
-      ...context
-    };
-    if (newContext.url) {
-      const baseUrl = stripQueryString(newContext.url);
-      newContext.baseUrl = baseUrl;
-      newContext.queryString = extractQueryString(newContext.url);
-      newContext.filename = path_exports.filename(baseUrl);
-      newContext.baseUrl = path_exports.dirname(baseUrl);
+    if (isLoaderWithParser(loader)) {
+      return loader;
     }
-    if (!Array.isArray(newContext.loaders)) {
-      newContext.loaders = null;
+    const implementationCacheKey = getLoaderImplementationCacheKey(loader);
+    return loaderImplementations.get(loader)?.get(implementationCacheKey) || null;
+  }
+  function isLoaderWithParser(loader) {
+    const candidate = loader;
+    return Boolean(
+      candidate.parse || candidate.parseSync || candidate.parseInBatches || candidate.parseText || candidate.parseTextSync || candidate.parseFile || candidate.parseFileInBatches
+    );
+  }
+  async function resolveLoaderImplementation(loader, options, url) {
+    if (loader.preload) {
+      const preloadedLoader = await loader.preload(url || "", options);
+      if (isLoaderWithParser(preloadedLoader)) {
+        return preloadedLoader;
+      }
+      throw new Error(`${loader.id} loader preload() did not return a parser-bearing loader`);
     }
-    return newContext;
+    const implementationSpecifier = getLoaderImplementationSpecifier(loader, options);
+    return await importLoaderImplementation(implementationSpecifier, loader.id);
   }
-  function getLoadersFromContext(loaders, context) {
-    if (loaders && !Array.isArray(loaders)) {
-      return loaders;
+  function getLoaderImplementationSpecifier(loader, options) {
+    const workerType = options?._workerType || options?.core?._workerType;
+    if (workerType === "test") {
+      const sourcePath = `modules/${loader.module}/src/${loader.id}-loader.ts`;
+      if (typeof window !== "undefined") {
+        return `/${sourcePath}`;
+      }
+      if (typeof process !== "undefined" && process.cwd) {
+        return new URL(sourcePath, `file://${process.cwd()}/`).toString();
+      }
+      return sourcePath;
     }
-    let candidateLoaders;
-    if (loaders) {
-      candidateLoaders = Array.isArray(loaders) ? loaders : [loaders];
+    throw new Error(
+      `${loader.id} loader does not provide a parser implementation. Import a parser-bearing loader directly, or use preload() before parse/load.`
+    );
+  }
+  function getLoaderImplementationCacheKey(loader, options) {
+    const loaderOptions = options?.[loader.id];
+    const defaultLoaderOptions = loader.options?.[loader.id];
+    return String(loaderOptions?.backend || defaultLoaderOptions?.backend || "");
+  }
+  async function importLoaderImplementation(implementationSpecifier, loaderId) {
+    const moduleExports = await import(
+      /* webpackIgnore: true */
+      /* @vite-ignore */
+      implementationSpecifier
+    );
+    for (const exportValue of Object.values(moduleExports)) {
+      if (exportValue && typeof exportValue === "object" && exportValue.id === loaderId && isLoaderWithParser(exportValue)) {
+        return exportValue;
+      }
     }
-    if (context && context.loaders) {
-      const contextLoaders = Array.isArray(context.loaders) ? context.loaders : [context.loaders];
-      candidateLoaders = candidateLoaders ? [...candidateLoaders, ...contextLoaders] : contextLoaders;
+    throw new Error(
+      `Could not find parser implementation for ${loaderId} in ${implementationSpecifier}`
+    );
+  }
+  var preparedLoaders = /* @__PURE__ */ new WeakSet();
+  var preparedDefaults = /* @__PURE__ */ new WeakMap();
+  var subloaderPreparations = /* @__PURE__ */ new WeakMap();
+  async function preloadLoaderDependencies(loader, options, url) {
+    if (preparedLoaders.has(loader)) return await getLoaderImplementation(loader, options, url);
+    validateSubloaderGraph(loader, options);
+    return await prepareLoaderDependencies(loader, options, url);
+  }
+  async function prepareLoaderDependencies(loader, options, url) {
+    if (!options) {
+      const cached = subloaderPreparations.get(loader);
+      if (cached) return await cached;
+    }
+    const preparation = bindSubloaders(loader, options, url);
+    if (!options) {
+      subloaderPreparations.set(loader, preparation);
+      void preparation.catch(() => subloaderPreparations.delete(loader));
+    }
+    const prepared = await preparation;
+    if (!options) preparedDefaults.set(loader, prepared);
+    return prepared;
+  }
+  function getSubloaders(loader, options) {
+    const overrides = options?.core?.subloaders || {};
+    return Object.fromEntries(
+      Object.entries(loader.subloaders || {}).map(([name, dependency]) => [
+        name,
+        Object.hasOwn(overrides, name) ? overrides[name] : dependency
+      ])
+    );
+  }
+  function validateSubloaderGraph(loader, options) {
+    visitLoader(loader, []);
+    function visitLoader(currentLoader, ancestors) {
+      if (ancestors.includes(currentLoader)) {
+        throw new Error(
+          `Subloader cycle: ${[...ancestors, currentLoader].map((value) => value.id).join(" -> ")}`
+        );
+      }
+      for (const dependency of Object.values(getSubloaders(currentLoader, options))) {
+        visitLoader(dependency, [...ancestors, currentLoader]);
+      }
     }
-    return candidateLoaders && candidateLoaders.length ? candidateLoaders : void 0;
+  }
+  async function bindSubloaders(loader, options, url) {
+    const [implementation, entries] = await Promise.all([
+      getLoaderImplementation(loader, options, url),
+      Promise.all(
+        Object.entries(getSubloaders(loader, options)).map(
+          async ([name, dependency]) => [name, await prepareLoaderDependencies(dependency, options, url)]
+        )
+      )
+    ]);
+    const subloaders = Object.fromEntries(entries);
+    const defaultOptions = mergeOptions(
+      implementation.options,
+      options || {}
+    );
+    defaultOptions.core = { ...defaultOptions.core, worker: false };
+    const prepared = { ...implementation, options: defaultOptions, subloaders };
+    delete prepared.preload;
+    prepared.worker = false;
+    for (const method of [
+      "parseBlob",
+      "createDataSource",
+      "parse",
+      "parseSync",
+      "parseText",
+      "parseTextSync",
+      "parseInBatches",
+      "parseFile",
+      "parseFileInBatches",
+      "parseUrl"
+    ]) {
+      const parser = implementation[method];
+      if (typeof parser === "function") {
+        prepared[method] = (data, parseOptions, context) => {
+          const forwardedOptions = mergeOptions(options, parseOptions || {});
+          return parser.call(
+            implementation,
+            data,
+            {
+              ...forwardedOptions,
+              core: {
+                ...forwardedOptions.core,
+                subloaders: options?.core?.subloaders || parseOptions?.core?.subloaders,
+                worker: false
+              },
+              [loader.id]: { ...forwardedOptions[loader.id], subloaders }
+            },
+            context
+          );
+        };
+      }
+    }
+    preparedLoaders.add(prepared);
+    return prepared;
   }
 
-  // src/lib/api/parse.ts
-  async function parse(data, loaders, options, context) {
+  // src/lib/api/parse-file.ts
+  async function parseFile(file, loaders, options, context) {
     if (loaders && !Array.isArray(loaders) && !isLoaderObject(loaders)) {
       context = void 0;
       options = loaders;
       loaders = void 0;
     }
-    data = await data;
     options = options || {};
-    const url = getResourceUrl(data);
+    const url = file.url || "";
     const typedLoaders = loaders;
     const candidateLoaders = getLoadersFromContext(typedLoaders, context);
-    const loader = await selectLoader(data, candidateLoaders, options);
+    const loader = await selectLoader(url, candidateLoaders, options);
     if (!loader) {
       return null;
     }
-    const strictOptions = normalizeOptions(options, loader, candidateLoaders, url);
+    if (isSourceLoader(loader)) {
+      throw new Error(
+        `${loader.id} is a SourceLoader. Use load() to create a runtime source object instead of parseFile().`
+      );
+    }
+    const normalizedOptions = normalizeOptions(options, loader, candidateLoaders, url);
+    const authenticationLoader = !loader.getAuthentications && normalizedOptions.core?.credentials?.length ? await getLoaderImplementation(loader, normalizedOptions, url || context?.url) : loader;
+    const strictOptions = await resolveLoaderAuthenticationOptions(
+      authenticationLoader,
+      url,
+      normalizedOptions
+    );
     context = getLoaderContext(
-      // @ts-expect-error
+      // @ts-expect-error candidateLoaders may be a single forced loader
       { url, _parse: parse, loaders: candidateLoaders },
       strictOptions,
       context || null
     );
-    return await parseWithLoader(loader, data, strictOptions, context);
+    return await parseFileWithLoader(loader, file, strictOptions, context);
   }
-  async function parseWithLoader(loader, data, options, context) {
+  async function parseFileWithLoader(loader, file, options, context) {
     validateWorkerVersion(loader);
     options = mergeOptions(loader.options, options);
-    if (isResponse(data)) {
-      const { ok, redirected, status, statusText, type, url } = data;
-      const headers = Object.fromEntries(data.headers.entries());
-      context.response = { headers, ok, redirected, status, statusText, type, url };
-    }
-    data = await getArrayBufferOrStringFromData(data, loader, options);
-    const loaderWithParser = loader;
-    if (loaderWithParser.parseTextSync && typeof data === "string") {
-      return loaderWithParser.parseTextSync(data, options, context);
-    }
-    if (canParseWithWorker(loader, options)) {
-      return await parseWithWorker(loader, data, options, context, parse);
-    }
-    if (loaderWithParser.parseText && typeof data === "string") {
-      return await loaderWithParser.parseText(data, options, context);
-    }
-    if (loaderWithParser.parse) {
-      return await loaderWithParser.parse(data, options, context);
+    const loaderWithParser = await getLoaderImplementation(loader, options, context.url);
+    if (loaderWithParser.parseFile) {
+      return await loaderWithParser.parseFile(file, options, context);
+    }
+    const parseFunction = loaderWithParser.parse;
+    if (parseFunction) {
+      const length = file.bigsize > 0n ? Number(file.bigsize) : file.size;
+      if (!length) {
+        throw new Error(`${loader.id} loader - cannot fall back to parse without a file size`);
+      }
+      const data = await file.read(0n, length);
+      return await parse(data, loaderWithParser, options, context);
     }
-    assert3(!loaderWithParser.parseSync);
-    throw new Error(`${loader.id} loader - no parser found and worker is disabled`);
+    throw new Error(`${loader.id} loader - no file parser found`);
   }
 
   // src/lib/api/parse-sync.ts
@@ -3302,6 +4445,11 @@ var __exports__ = (() => {
     if (!loader) {
       return null;
     }
+    if (isSourceLoader(loader)) {
+      throw new Error(
+        `${loader.id} is a SourceLoader. Use load() to create a runtime source object instead of parseSync().`
+      );
+    }
     const strictOptions = normalizeOptions(options, loader, candidateLoaders);
     const url = getResourceUrl(data);
     const parse2 = () => {
@@ -3312,7 +4460,13 @@ var __exports__ = (() => {
       strictOptions,
       context || null
     );
-    return parseWithLoaderSync(loader, data, strictOptions, context);
+    const loaderWithParser = getLoaderImplementationSync(loader);
+    return parseWithLoaderSync(
+      loaderWithParser || loader,
+      data,
+      strictOptions,
+      context
+    );
   }
   function parseWithLoaderSync(loader, data, options, context) {
     data = getArrayBufferOrStringFromDataSync(data, loader, options);
@@ -3322,6 +4476,11 @@ var __exports__ = (() => {
     if (loader.parseSync && data instanceof ArrayBuffer) {
       return loader.parseSync(data, options, context);
     }
+    if (loader.preload) {
+      throw new Error(
+        `${loader.name} loader: 'parseSync' requires a parser-bearing loader. Import the loader implementation directly, or call preload(loader) before parseSync(). ${context.url || ""}`
+      );
+    }
     throw new Error(
       `${loader.name} loader: 'parseSync' not supported by this loader, use 'parse' instead. ${context.url || ""}`
     );
@@ -3337,7 +4496,7 @@ var __exports__ = (() => {
       case "geojson-table":
         return Array.isArray(table.features);
       case "columnar-table":
-        return table.data && typeof table.data === "object";
+        return Boolean(table.data && typeof table.data === "object");
       case "arrow-table":
         return Boolean(table?.data?.numRows !== void 0);
       default:
@@ -3384,15 +4543,22 @@ var __exports__ = (() => {
     if (!loader) {
       return [];
     }
-    const strictOptions = normalizeOptions(options, loader, loaderArray, url);
+    const normalizedOptions = normalizeOptions(options, loader, loaderArray, url);
+    const authenticationLoader = !loader.getAuthentications && normalizedOptions.core?.credentials?.length ? await getLoaderImplementation(loader, normalizedOptions, url || context?.url) : loader;
+    const strictOptions = await resolveLoaderAuthenticationOptions(
+      authenticationLoader,
+      url || "",
+      normalizedOptions
+    );
     context = getLoaderContext(
       { url, _parseInBatches: parseInBatches, _parse: parse, loaders: loaderArray },
       strictOptions,
       context || null
     );
-    return await parseWithLoaderInBatches(loader, data, strictOptions, context);
+    const loaderWithParser = await getLoaderImplementation(loader, strictOptions, context.url);
+    return await parseWithLoaderInBatches(loader, loaderWithParser, data, strictOptions, context);
   }
-  async function parseWithLoaderInBatches(loader, data, options, context) {
+  async function parseWithLoaderInBatches(originalLoader, loader, data, options, context) {
     const outputIterator = await parseToOutputIterator(loader, data, options, context);
     if (!options?.core?.metadata) {
       return outputIterator;
@@ -3401,7 +4567,7 @@ var __exports__ = (() => {
       shape: "metadata",
       batchType: "metadata",
       metadata: {
-        _loader: loader,
+        _loader: originalLoader,
         _context: context
       },
       // Populate with some default fields to avoid crashing
@@ -3421,6 +4587,9 @@ var __exports__ = (() => {
       options?.core?.transforms || []
     );
     if (loader.parseInBatches) {
+      if (loader.id === "csv" && isBrowser && canParseWithWorker(loader, options)) {
+        return parseWithWorkerInBatches(loader, transformedIterator, options, context, parse);
+      }
       return loader.parseInBatches(transformedIterator, options, context);
     }
     return parseChunkInBatches(transformedIterator, loader, options, context);
@@ -3455,6 +4624,38 @@ var __exports__ = (() => {
     return iteratorChain;
   }
 
+  // src/lib/api/load-in-batches.ts
+  function loadInBatches(files, loaders, options, context) {
+    let loadersArray;
+    if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {
+      context = void 0;
+      options = loaders;
+      loadersArray = void 0;
+    } else {
+      loadersArray = loaders;
+    }
+    if (!Array.isArray(files)) {
+      return loadOneFileInBatches(files, loadersArray, options || {});
+    }
+    const promises = files.map((file) => loadOneFileInBatches(file, loadersArray, options || {}));
+    return promises;
+  }
+  async function loadOneFileInBatches(file, loaders, options) {
+    if (typeof file === "string") {
+      const url = file;
+      const loader = await selectLoader(url, loaders, {
+        ...options,
+        core: { ...options.core, nothrow: true }
+      });
+      const authenticationLoader = loader && !loader.getAuthentications && options.core?.credentials?.length ? await getLoaderImplementation(loader, options, url) : loader;
+      options = await resolveLoaderAuthenticationOptions(authenticationLoader, url, options);
+      const fetch2 = getFetchFunction(options);
+      const response = await fetch2(applySearchParamsToUrl(url, options));
+      return Array.isArray(loaders) ? await parseInBatches(response, loaders, options) : await parseInBatches(response, loaders, options);
+    }
+    return Array.isArray(loaders) ? await parseInBatches(file, loaders, options) : await parseInBatches(file, loaders, options);
+  }
+
   // src/lib/api/load.ts
   async function load(url, loaders, options, context) {
     let resolvedLoaders;
@@ -3467,10 +4668,100 @@ var __exports__ = (() => {
       resolvedLoaders = loaders;
       resolvedOptions = options;
     }
+    resolvedOptions ||= getGlobalLoaderOptions();
+    if (!Array.isArray(resolvedLoaders) && isSourceLoader(resolvedLoaders)) {
+      const sourceLoader = await resolveSourceLoader(resolvedLoaders, url, resolvedOptions);
+      resolvedOptions = await resolveLoaderAuthenticationOptions(
+        resolvedLoaders.getAuthentications ? resolvedLoaders : sourceLoader,
+        typeof url === "string" ? url : "",
+        resolvedOptions || {}
+      );
+      const runtimeCoreApi = {
+        fetchFile,
+        parse,
+        parseFile,
+        parseSync,
+        parseInBatches,
+        load,
+        loadInBatches
+      };
+      return sourceLoader.createDataSource(
+        url,
+        resolvedOptions || {},
+        runtimeCoreApi
+      );
+    }
+    if (Array.isArray(resolvedLoaders) && resolvedLoaders.length === 1 && isSourceLoader(resolvedLoaders[0])) {
+      const sourceLoader = await resolveSourceLoader(resolvedLoaders[0], url, resolvedOptions);
+      resolvedOptions = await resolveLoaderAuthenticationOptions(
+        resolvedLoaders[0].getAuthentications ? resolvedLoaders[0] : sourceLoader,
+        typeof url === "string" ? url : "",
+        resolvedOptions || {}
+      );
+      const runtimeCoreApi = {
+        fetchFile,
+        parse,
+        parseFile,
+        parseSync,
+        parseInBatches,
+        load,
+        loadInBatches
+      };
+      return sourceLoader.createDataSource(
+        url,
+        resolvedOptions || {},
+        runtimeCoreApi
+      );
+    }
+    if (typeof url === "string" || isBlob(url)) {
+      const selectedLoader = await selectLoader(url, resolvedLoaders, {
+        ...resolvedOptions,
+        core: { ...resolvedOptions?.core, nothrow: true }
+      });
+      if (selectedLoader && isSourceLoader(selectedLoader)) {
+        const sourceLoader = await resolveSourceLoader(selectedLoader, url, resolvedOptions);
+        resolvedOptions = await resolveLoaderAuthenticationOptions(
+          selectedLoader.getAuthentications ? selectedLoader : sourceLoader,
+          typeof url === "string" ? url : "",
+          resolvedOptions || {}
+        );
+        return sourceLoader.createDataSource(
+          url,
+          resolvedOptions || {},
+          {
+            fetchFile,
+            parse,
+            parseFile,
+            parseSync,
+            parseInBatches,
+            load,
+            loadInBatches
+          }
+        );
+      }
+      if (selectedLoader && typeof url === "string") {
+        const loaderImplementation = await getLoaderImplementation(
+          selectedLoader,
+          resolvedOptions,
+          url
+        );
+        resolvedOptions = await resolveLoaderAuthenticationOptions(
+          selectedLoader.getAuthentications ? selectedLoader : loaderImplementation,
+          url,
+          resolvedOptions || {}
+        );
+        const parseUrl = loaderImplementation.parseUrl;
+        if (parseUrl) {
+          const requestUrl = applySearchParamsToUrl(url, resolvedOptions);
+          return await parseUrl(requestUrl, resolvedOptions, context);
+        }
+      }
+    }
+    if (resolvedOptions) resolvedOptions = resolveAuthenticationOptions(resolvedOptions);
     const fetch2 = getFetchFunction(resolvedOptions);
     let data = url;
     if (typeof url === "string") {
-      data = await fetch2(url);
+      data = await fetch2(applySearchParamsToUrl(url, resolvedOptions));
     }
     if (isBlob(url)) {
       data = await fetch2(url);
@@ -3487,35 +4778,151 @@ var __exports__ = (() => {
         };
       }
     }
-    return Array.isArray(resolvedLoaders) ? await parse(data, resolvedLoaders, resolvedOptions) : await parse(data, resolvedLoaders, resolvedOptions);
+    return Array.isArray(resolvedLoaders) ? await parse(data, resolvedLoaders, resolvedOptions, context) : await parse(data, resolvedLoaders, resolvedOptions, context);
+  }
+  async function resolveSourceLoader(loader, url, options) {
+    if (!loader.preload) {
+      return loader;
+    }
+    const sourceLoader = await loader.preload(typeof url === "string" ? url : "", options);
+    if (!isSourceLoader(sourceLoader)) {
+      throw new Error(`${loader.id} source loader preload() did not return a runtime source loader`);
+    }
+    return sourceLoader;
   }
 
-  // src/lib/api/load-in-batches.ts
-  function loadInBatches(files, loaders, options, context) {
-    let loadersArray;
-    if (!Array.isArray(loaders) && !isLoaderObject(loaders)) {
+  // src/lib/api/core-api.ts
+  var coreApi = Object.freeze({
+    fetchFile,
+    parse,
+    parseFile,
+    parseSync,
+    parseInBatches,
+    load,
+    loadInBatches
+  });
+
+  // src/lib/loader-utils/loader-context.ts
+  function getLoaderContext(context, options, parentContext) {
+    if (parentContext) {
+      return {
+        ...parentContext,
+        coreApi: parentContext.coreApi || context.coreApi || coreApi,
+        _parse: parentContext._parse || context._parse,
+        fetch: getFetchFunction(options, parentContext)
+      };
+    }
+    const newContext = {
+      ...context,
+      fetch: getFetchFunction(options, context),
+      coreApi: context.coreApi || coreApi
+    };
+    if (newContext.url) {
+      const baseUrl = stripQueryString(newContext.url);
+      newContext.baseUrl = baseUrl;
+      newContext.queryString = extractQueryString(newContext.url);
+      newContext.filename = path_exports.filename(baseUrl);
+      newContext.baseUrl = path_exports.dirname(baseUrl);
+    }
+    if (!Array.isArray(newContext.loaders)) {
+      newContext.loaders = null;
+    }
+    return newContext;
+  }
+  function getLoadersFromContext(loaders, context) {
+    if (loaders && !Array.isArray(loaders)) {
+      return loaders;
+    }
+    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;
+    }
+    return candidateLoaders && candidateLoaders.length ? candidateLoaders : void 0;
+  }
+
+  // src/lib/api/parse.ts
+  async function parse(data, loaders, options, context) {
+    if (loaders && !Array.isArray(loaders) && !isLoaderObject(loaders)) {
       context = void 0;
       options = loaders;
-      loadersArray = void 0;
-    } else {
-      loadersArray = loaders;
+      loaders = void 0;
     }
-    const fetch2 = getFetchFunction(options || {});
-    if (!Array.isArray(files)) {
-      return loadOneFileInBatches(files, loadersArray, options || {}, fetch2);
+    data = await data;
+    options = options || {};
+    const url = getResourceUrl(data);
+    const typedLoaders = loaders;
+    const candidateLoaders = getLoadersFromContext(typedLoaders, context);
+    const loader = await selectLoader(data, candidateLoaders, options);
+    if (!loader) {
+      return null;
+    }
+    if (isSourceLoader(loader)) {
+      throw new Error(
+        `${loader.id} is a SourceLoader. Use load() to create a runtime source object instead of parse().`
+      );
     }
-    const promises = files.map(
-      (file) => loadOneFileInBatches(file, loadersArray, options || {}, fetch2)
+    const normalizedOptions = normalizeOptions(options, loader, candidateLoaders, url);
+    const authenticationLoader = !loader.getAuthentications && normalizedOptions.core?.credentials?.length ? await getLoaderImplementation(loader, normalizedOptions, url || context?.url) : loader;
+    const strictOptions = await resolveLoaderAuthenticationOptions(
+      authenticationLoader,
+      url || "",
+      normalizedOptions
     );
-    return promises;
+    context = getLoaderContext(
+      // @ts-expect-error
+      { url, _parse: parse, loaders: candidateLoaders },
+      strictOptions,
+      context || null
+    );
+    return await parseWithLoader(loader, data, strictOptions, context);
   }
-  async function loadOneFileInBatches(file, loaders, options, fetch2) {
-    if (typeof file === "string") {
-      const url = file;
-      const response = await fetch2(url);
-      return Array.isArray(loaders) ? await parseInBatches(response, loaders, options) : await parseInBatches(response, loaders, options);
+  async function parseWithLoader(loader, data, options, context) {
+    validateWorkerVersion(loader);
+    options = mergeOptions(loader.options, options);
+    if (isResponse(data)) {
+      const { ok, redirected, status, statusText, type, url } = data;
+      const headers = Object.fromEntries(data.headers.entries());
+      context.response = { headers, ok, redirected, status, statusText, type, url };
     }
-    return Array.isArray(loaders) ? await parseInBatches(file, loaders, options) : await parseInBatches(file, loaders, options);
+    const loaderWithParser = await getLoaderImplementation(loader, options, context.url);
+    if (shouldParseWithWorker(loaderWithParser, data, options, context, loader)) {
+      data = await getArrayBufferFromData(data, options);
+      return await parseWithWorker(loaderWithParser, data, options, context, parse);
+    }
+    if (isBlob(data) && loaderWithParser.parseBlob) {
+      return await loaderWithParser.parseBlob(data, options, context);
+    }
+    data = await getArrayBufferOrStringFromData(data, loader, options);
+    return await parseWithLoaderImplementation(loaderWithParser, data, options, context);
+  }
+  async function parseWithLoaderImplementation(loader, data, options, context) {
+    if (loader.parseText && typeof data === "string") {
+      return await loader.parseText(data, options, context);
+    }
+    if (loader.parseTextSync && typeof data === "string") {
+      return loader.parseTextSync(data, options, context);
+    }
+    if (loader.parse) {
+      return await loader.parse(data, options, context);
+    }
+    if (loader.parseSync) {
+      throw new Error(
+        `${loader.name} loader: 'parse' not available on parser-bearing sync loader. Add an async 'parse' function to this loader, or call preload(loader) before parseSync(). ${context.url || ""}`
+      );
+    }
+    throw new Error(`${loader.id} loader - no parser found and worker is disabled`);
+  }
+
+  // src/lib/api/preload.ts
+  async function preload(loader, options, url) {
+    return loader.subloaders ? await preloadLoaderDependencies(loader, options, url) : await getLoaderImplementation(loader, options, url);
+  }
+  function preloadSync(loader) {
+    return getLoaderImplementationSync(loader);
   }
 
   // src/lib/api/encode-table.ts
@@ -3640,21 +5047,41 @@ var __exports__ = (() => {
   }
 
   // src/lib/api/create-data-source.ts
-  function createDataSource(data, sources, options) {
-    const type = options?.core?.type || options.type || "auto";
-    const source = type === "auto" ? selectSource(data, sources) : getSourceOfType(type, sources);
+  function createDataSource(data, sources, options = {}) {
+    const resolvedOptions = options || {};
+    const type = resolvedOptions?.core?.type || resolvedOptions.type || "auto";
+    const source = sources.length === 1 ? sources[0] : type === "auto" ? selectLoaderSync(data, sources, {
+      // `createDataSource` supports non-fetch inputs such as in-memory tables.
+      // Selection remains best-effort for those cases.
+      ...resolvedOptions,
+      core: { ...resolvedOptions?.core, type: "auto" }
+    }) : getSourceOfType(type, sources);
     if (!source) {
       throw new Error("Not a valid source type");
     }
-    return source.createDataSource(data, options);
-  }
-  function selectSource(url, sources) {
-    for (const service of sources) {
-      if (service.testURL && service.testURL(url)) {
-        return service;
-      }
-    }
-    return null;
+    const contributions = resolvedOptions.core?.credentials?.length ? source.getAuthentications?.(typeof data === "string" ? data : "", resolvedOptions) : void 0;
+    if (contributions && "then" in contributions) {
+      void contributions.catch(() => {
+      });
+      throw new Error("Use load() with an asynchronous getAuthentications() hook.");
+    }
+    const authenticatedOptions = resolveAuthenticationOptions(
+      contributions?.length ? {
+        ...resolvedOptions,
+        core: {
+          ...resolvedOptions.core,
+          authentications: [
+            ...resolvedOptions.core?.authentications || [],
+            ...contributions || []
+          ]
+        }
+      } : resolvedOptions
+    );
+    return source.createDataSource(
+      data,
+      authenticatedOptions,
+      coreApi
+    );
   }
   function getSourceOfType(type, sources) {
     for (const service of sources) {
@@ -3666,15 +5093,11 @@ var __exports__ = (() => {
   }
 
   // src/lib/api/select-source.ts
-  function selectSource2(url, sources, options) {
+  function selectSource(url, sources, options) {
     const type = options?.type || "auto";
     let selectedSource = null;
     if (type === "auto") {
-      for (const source of sources) {
-        if (typeof url === "string" && source.testURL && source.testURL(url)) {
-          return source;
-        }
-      }
+      selectedSource = selectLoaderSync(url, sources, { core: { nothrow: true } });
     } else {
       selectedSource = getSourceOfType2(type, sources);
     }
@@ -3849,18 +5272,29 @@ var __exports__ = (() => {
       if (path.includes("://")) {
         return this._fetch(path, options);
       }
-      const file = this.files[path];
+      const file = this._getFile(path, true);
       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);
+      const bytes = range && /bytes=(\d+)-(\d+)/.exec(range);
       if (bytes) {
         const start = parseInt(bytes[1]);
-        const end = parseInt(bytes[2]);
-        const data = await file.slice(start, end).arrayBuffer();
-        const response2 = new Response(data);
+        const end = Math.min(parseInt(bytes[2]), file.size - 1);
+        if (start > end) {
+          const response3 = new Response(null, {
+            status: 416,
+            headers: { "Content-Range": `bytes */${file.size}` }
+          });
+          Object.defineProperty(response3, "url", { value: path });
+          return response3;
+        }
+        const data = await file.slice(start, end + 1).arrayBuffer();
+        const response2 = new Response(data, {
+          status: 206,
+          headers: { "Content-Range": `bytes ${start}-${end}/${file.size}` }
+        });
         Object.defineProperty(response2, "url", { value: path });
         return response2;
       }
@@ -3884,7 +5318,7 @@ var __exports__ = (() => {
      * Return information (size) about files in this file system
      */
     async stat(path, options) {
-      const file = this.files[path];
+      const file = this._getFile(path, false);
       if (!file) {
         throw new Error(path);
       }
@@ -3894,19 +5328,22 @@ var __exports__ = (() => {
      * Just removes the file from the list
      */
     async unlink(path) {
-      delete this.files[path];
-      delete this.lowerCaseFiles[path];
-      this.usedFiles[path] = true;
+      const file = this._getFile(path, false);
+      if (file) {
+        delete this.files[file.name];
+        delete this.lowerCaseFiles[file.name.toLowerCase()];
+        this.usedFiles[file.name] = true;
+      }
     }
     // implements IRandomAccessFileSystem
     // RANDOM ACCESS
     async openReadableFile(pathname, flags) {
-      return new BlobFile(this.files[pathname]);
+      return new BlobFile(this._getFile(pathname, true));
     }
     // PRIVATE
     // Supports case independent paths, and file usage tracking
     _getFile(path, used) {
-      const file = this.files[path] || this.lowerCaseFiles[path];
+      const file = this.files[path] || this.lowerCaseFiles[path.toLowerCase()];
       if (file && used) {
         this.usedFiles[path] = true;
       }