@loaders.gl/loader-utils 4.3.4 → 4.4.0-alpha.10

package/dist/index.cjs

@@ -27,16 +27,12 @@ var dist_exports = {};
 __export(dist_exports, {
   BlobFile: () => BlobFile,
   DataSource: () => DataSource,
-  DataViewFile: () => DataViewFile,
-  FileHandleFile: () => FileHandleFile,
-  FileProvider: () => FileProvider,
   HttpFile: () => HttpFile,
   ImageSource: () => ImageSource,
   JSONLoader: () => JSONLoader,
   NodeFile: () => NodeFileFacade,
   NodeFilesystem: () => NodeFileSystemFacade,
   RequestScheduler: () => RequestScheduler,
-  VectorSource: () => VectorSource,
   _addAliases: () => addAliases,
   assert: () => assert,
   canEncodeWithWorker: () => canEncodeWithWorker,
@@ -53,25 +49,44 @@ __export(dist_exports, {
   copyPaddedStringToDataView: () => copyPaddedStringToDataView,
   copyStringToDataView: () => copyStringToDataView,
   copyToArray: () => copyToArray,
+  copyToArrayBuffer: () => copyToArrayBuffer2,
   createLoaderWorker: () => createLoaderWorker,
   document: () => document_,
+  ensureArrayBuffer: () => ensureArrayBuffer,
   forEach: () => forEach,
   getFirstCharacters: () => getFirstCharacters,
   getJSModule: () => getJSModule,
   getJSModuleOrNull: () => getJSModuleOrNull,
   getMagicString: () => getMagicString,
   getPathPrefix: () => getPathPrefix,
+  getRequiredOptions: () => getRequiredOptions,
   global: () => global_,
+  isArrayBuffer: () => isArrayBuffer,
+  isArrayBufferLike: () => isArrayBufferLike,
+  isAsyncIterable: () => isAsyncIterable,
+  isBlob: () => isBlob,
   isBrowser: () => isBrowser,
   isBuffer: () => isBuffer,
-  isFileProvider: () => isFileProvider,
+  isFile: () => isFile,
+  isIterable: () => isIterable,
+  isIterator: () => isIterator,
+  isObject: () => isObject,
+  isPromise: () => isPromise,
+  isPureObject: () => isPureObject,
+  isReadableDOMStream: () => isReadableDOMStream,
+  isReadableNodeStream: () => isReadableNodeStream,
+  isReadableStream: () => isReadableStream,
+  isResponse: () => isResponse,
   isWorker: () => isWorker,
+  isWritableDOMStream: () => isWritableDOMStream,
+  isWritableNodeStream: () => isWritableNodeStream,
+  isWritableStream: () => isWritableStream,
   log: () => log,
   makeLineIterator: () => makeLineIterator,
   makeNumberedLineIterator: () => makeNumberedLineIterator,
   makeTextDecoderIterator: () => makeTextDecoderIterator,
   makeTextEncoderIterator: () => makeTextEncoderIterator,
-  mergeLoaderOptions: () => mergeLoaderOptions,
+  mergeOptions: () => mergeOptions,
   nodeVersion: () => nodeVersion,
   padStringToByteAlignment: () => padStringToByteAlignment,
   padToNBytes: () => padToNBytes,
@@ -90,6 +105,8 @@ __export(dist_exports, {
   sliceArrayBuffer: () => sliceArrayBuffer,
   stream: () => stream_browser_exports,
   toArrayBuffer: () => toArrayBuffer2,
+  toArrayBufferIterator: () => toArrayBufferIterator,
+  toArrayBufferView: () => toArrayBufferView,
   toBuffer: () => toBuffer2,
   window: () => window_
 });
@@ -140,7 +157,7 @@ var nodeVersion = matches && parseFloat(matches[1]) || 0;
 
 // dist/lib/log-utils/log.js
 var import_log = require("@probe.gl/log");
-var VERSION = true ? "4.3.3" : "latest";
+var VERSION = true ? "4.4.0-alpha.10" : "latest";
 var version = VERSION[0] >= "0" && VERSION[0] <= "9" ? `v${VERSION}` : "";
 function createLog() {
   const log2 = new import_log.Log({ id: "loaders.gl" });
@@ -153,8 +170,33 @@ function createLog() {
 }
 var log = createLog();
 
-// dist/lib/option-utils/merge-loader-options.js
-function mergeLoaderOptions(baseOptions, newOptions) {
+// dist/lib/javascript-utils/is-type.js
+var isBoolean = (value) => typeof value === "boolean";
+var isFunction = (value) => typeof value === "function";
+var isObject = (value) => value !== null && typeof value === "object";
+var isPureObject = (value) => isObject(value) && value.constructor === {}.constructor;
+var isArrayBuffer = (value) => typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer;
+var isSharedArrayBuffer = (value) => typeof SharedArrayBuffer !== "undefined" && value instanceof SharedArrayBuffer;
+var isArrayBufferLike = (value) => isObject(value) && typeof value.byteLength === "number" && typeof value.slice === "function";
+var isPromise = (value) => isObject(value) && "then" in value && isFunction(value.then);
+var isIterable = (value) => Boolean(value) && isFunction(value[Symbol.iterator]);
+var isAsyncIterable = (value) => Boolean(value) && isFunction(value[Symbol.asyncIterator]);
+var isIterator = (value) => Boolean(value) && isFunction(value.next);
+var isResponse = (value) => typeof Response !== "undefined" && value instanceof Response || isObject(value) && isFunction(value.arrayBuffer) && isFunction(value.text) && isFunction(value.json);
+var isFile = (value) => typeof File !== "undefined" && value instanceof File;
+var isBlob = (value) => typeof Blob !== "undefined" && value instanceof Blob;
+var isWritableDOMStream = (value) => isObject(value) && isFunction(value.abort) && isFunction(value.getWriter);
+var isReadableDOMStream = (value) => typeof ReadableStream !== "undefined" && value instanceof ReadableStream || isObject(value) && isFunction(value.tee) && isFunction(value.cancel) && isFunction(value.getReader);
+var isWritableNodeStream = (value) => isObject(value) && isFunction(value.end) && isFunction(value.write) && isBoolean(value.writable);
+var isReadableNodeStream = (value) => isObject(value) && isFunction(value.read) && isFunction(value.pipe) && isBoolean(value.readable);
+var isReadableStream = (value) => isReadableDOMStream(value) || isReadableNodeStream(value);
+var isWritableStream = (value) => isWritableDOMStream(value) || isWritableNodeStream(value);
+
+// dist/lib/option-utils/merge-options.js
+function getRequiredOptions(options) {
+  return options;
+}
+function mergeOptions(baseOptions, newOptions) {
   return mergeOptionsRecursively(baseOptions || {}, newOptions);
 }
 function mergeOptionsRecursively(baseOptions, newOptions, level = 0) {
@@ -271,7 +313,10 @@ async function parseData({ loader, arrayBuffer, options, context }) {
   options = {
     ...options,
     modules: loader && loader.options && loader.options.modules || {},
-    worker: false
+    core: {
+      ...options.core,
+      worker: false
+    }
   };
   return await parser(data, { ...options }, context, loader);
 }
@@ -279,18 +324,21 @@ async function parseData({ loader, arrayBuffer, options, context }) {
 // dist/lib/worker-loader-utils/parse-with-worker.js
 var import_worker_utils2 = require("@loaders.gl/worker-utils");
 function canParseWithWorker(loader, options) {
+  var _a, _b;
   if (!import_worker_utils2.WorkerFarm.isSupported()) {
     return false;
   }
-  if (!import_worker_utils2.isBrowser && !(options == null ? void 0 : options._nodeWorkers)) {
+  const nodeWorkers = (options == null ? void 0 : options._nodeWorkers) ?? ((_a = options == null ? void 0 : options.core) == null ? void 0 : _a._nodeWorkers);
+  if (!import_worker_utils2.isBrowser && !nodeWorkers) {
     return false;
   }
-  return loader.worker && (options == null ? void 0 : options.worker);
+  const useWorkers = (options == null ? void 0 : options.worker) ?? ((_b = options == null ? void 0 : options.core) == null ? void 0 : _b.worker);
+  return Boolean(loader.worker && useWorkers);
 }
 async function parseWithWorker(loader, data, options, context, parseOnMainThread2) {
   const name = loader.id;
   const url = (0, import_worker_utils2.getWorkerURL)(loader, options);
-  const workerFarm = import_worker_utils2.WorkerFarm.getWorkerFarm(options);
+  const workerFarm = import_worker_utils2.WorkerFarm.getWorkerFarm(options == null ? void 0 : options.core);
   const workerPool = workerFarm.getWorkerPool({ name, url });
   options = JSON.parse(JSON.stringify(options));
   context = JSON.parse(JSON.stringify(context || {}));
@@ -335,13 +383,16 @@ async function onMessage(parseOnMainThread2, job, type, payload) {
 // dist/lib/worker-loader-utils/encode-with-worker.js
 var import_worker_utils3 = require("@loaders.gl/worker-utils");
 function canEncodeWithWorker(writer, options) {
+  var _a, _b;
   if (!import_worker_utils3.WorkerFarm.isSupported()) {
     return false;
   }
-  if (!isBrowser && !(options == null ? void 0 : options._nodeWorkers)) {
+  const nodeWorkers = (options == null ? void 0 : options._nodeWorkers) ?? ((_a = options == null ? void 0 : options.core) == null ? void 0 : _a._nodeWorkers);
+  const useWorkers = (options == null ? void 0 : options.worker) ?? ((_b = options == null ? void 0 : options.core) == null ? void 0 : _b.worker);
+  if (!isBrowser && !nodeWorkers) {
     return false;
   }
-  return writer.worker && (options == null ? void 0 : options.worker);
+  return Boolean(writer.worker && useWorkers);
 }
 
 // dist/lib/binary-utils/get-first-characters.js
@@ -510,7 +561,7 @@ async function* makeTextDecoderIterator(arrayBufferIterator, options = {}) {
 async function* makeTextEncoderIterator(textIterator) {
   const textEncoder = new TextEncoder();
   for await (const text of textIterator) {
-    yield typeof text === "string" ? textEncoder.encode(text) : text;
+    yield typeof text === "string" ? textEncoder.encode(text).buffer : text;
   }
 }
 async function* makeLineIterator(textIterator) {
@@ -537,11 +588,14 @@ async function* makeNumberedLineIterator(lineIterator) {
 }
 
 // dist/lib/iterators/async-iteration.js
-async function forEach(iterator, visitor) {
+async function forEach(iterable, visitor) {
+  const iterator = toAsyncIterator(iterable);
   while (true) {
     const { done, value } = await iterator.next();
     if (done) {
-      iterator.return();
+      if (iterator.return) {
+        iterator.return();
+      }
       return;
     }
     const cancel = visitor(value);
@@ -553,10 +607,60 @@ async function forEach(iterator, visitor) {
 async function concatenateArrayBuffersAsync(asyncIterator) {
   const arrayBuffers = [];
   for await (const chunk of asyncIterator) {
-    arrayBuffers.push(chunk);
+    arrayBuffers.push(copyToArrayBuffer(chunk));
   }
   return concatenateArrayBuffers(...arrayBuffers);
 }
+async function* toArrayBufferIterator(asyncIterator) {
+  for await (const chunk of asyncIterator) {
+    yield copyToArrayBuffer(chunk);
+  }
+}
+function copyToArrayBuffer(chunk) {
+  if (chunk instanceof ArrayBuffer) {
+    return chunk;
+  }
+  if (ArrayBuffer.isView(chunk)) {
+    const { buffer, byteOffset, byteLength } = chunk;
+    return copyFromBuffer(buffer, byteOffset, byteLength);
+  }
+  return copyFromBuffer(chunk);
+}
+function copyFromBuffer(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 toAsyncIterator(iterable) {
+  if (typeof iterable[Symbol.asyncIterator] === "function") {
+    return iterable[Symbol.asyncIterator]();
+  }
+  if (typeof iterable[Symbol.iterator] === "function") {
+    const iterator = iterable[Symbol.iterator]();
+    return iteratorToAsyncIterator(iterator);
+  }
+  return iterable;
+}
+function iteratorToAsyncIterator(iterator) {
+  return {
+    next(value) {
+      return Promise.resolve(iterator.next(value));
+    },
+    return(value) {
+      if (typeof iterator.return === "function") {
+        return Promise.resolve(iterator.return(value));
+      }
+      return Promise.resolve({ done: true, value });
+    },
+    throw(error) {
+      if (typeof iterator.throw === "function") {
+        return Promise.resolve(iterator.throw(error));
+      }
+      return Promise.reject(error);
+    }
+  };
+}
 
 // dist/lib/request-utils/request-scheduler.js
 var import_stats = require("@probe.gl/stats");
@@ -594,6 +698,20 @@ var RequestScheduler = class {
     this.stats.get(STAT_QUEUED_REQUESTS_EVER);
     this.stats.get(STAT_ACTIVE_REQUESTS_EVER);
   }
+  /**
+   * Update scheduler props. Preserves active and queued requests.
+   */
+  setProps(props) {
+    if (props.throttleRequests !== void 0) {
+      this.props.throttleRequests = props.throttleRequests;
+    }
+    if (props.maxRequests !== void 0) {
+      this.props.maxRequests = props.maxRequests;
+    }
+    if (props.debounceTime !== void 0) {
+      this.props.debounceTime = props.debounceTime;
+    }
+  }
   /**
    * Called by an application that wants to issue a request, without having it deeply queued by the browser
    *
@@ -718,7 +836,7 @@ function resolvePath(filename2) {
 }
 
 // dist/json-loader.js
-var VERSION2 = true ? "4.3.3" : "latest";
+var VERSION2 = true ? "4.4.0-alpha.10" : "latest";
 var JSONLoader = {
   dataType: null,
   batchType: null,
@@ -760,11 +878,15 @@ function toArrayBuffer2(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 data.buffer;
+      return buffer;
     }
-    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+    return buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
   }
   if (typeof data === "string") {
     const text = data;
@@ -776,6 +898,31 @@ function toArrayBuffer2(data) {
   }
   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);
+}
 
 // dist/lib/node/promisify.js
 function promisify1(fn) {
@@ -807,7 +954,7 @@ function getCWD() {
 // dist/lib/path-utils/path.js
 function filename(url) {
   const slashIndex = url ? url.lastIndexOf("/") : -1;
-  return slashIndex >= 0 ? url.substr(slashIndex + 1) : "";
+  return slashIndex >= 0 ? url.substr(slashIndex + 1) : url;
 }
 function dirname(url) {
   const slashIndex = url ? url.lastIndexOf("/") : -1;
@@ -1129,288 +1276,31 @@ var NodeFileSystemFacade = class {
   }
 };
 
-// dist/lib/file-provider/file-provider-interface.js
-var isFileProvider = (fileProvider) => {
-  return (fileProvider == null ? void 0 : fileProvider.getUint8) && (fileProvider == null ? void 0 : fileProvider.slice) && (fileProvider == null ? void 0 : fileProvider.length);
-};
-
-// dist/lib/file-provider/file-provider.js
-var FileProvider = class {
-  /** The File object from which data is provided */
-  file;
-  size;
-  /** Create a new BrowserFile */
-  constructor(file, size) {
-    this.file = file;
-    this.size = BigInt(size);
-  }
-  static async create(file) {
-    var _a;
-    let size = 0n;
-    if (file.bigsize > 0n) {
-      size = file.bigsize;
-    } else if (file.size > 0) {
-      size = file.size;
-    } else {
-      const stats = await ((_a = file.stat) == null ? void 0 : _a.call(file));
-      size = (stats == null ? void 0 : stats.bigsize) ?? 0n;
-    }
-    return new FileProvider(file, size);
-  }
-  /**
-   * Truncates the file descriptor.
-   * @param length desired file lenght
-   */
-  async truncate(length) {
-    throw new Error("file loaded via range requests cannot be changed");
-  }
-  /**
-   * Append data to a file.
-   * @param buffer data to append
-   */
-  async append(buffer) {
-    throw new Error("file loaded via range requests cannot be changed");
-  }
-  /** Close file */
-  async destroy() {
-    throw new Error("file loaded via range requests cannot be changed");
-  }
-  /**
-   * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint8(offset) {
-    const arrayBuffer = await this.file.read(offset, 1);
-    const val = new Uint8Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint16(offset) {
-    const arrayBuffer = await this.file.read(offset, 2);
-    const val = new Uint16Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint32(offset) {
-    const arrayBuffer = await this.file.read(offset, 4);
-    const val = new Uint32Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getBigUint64(offset) {
-    const arrayBuffer = await this.file.read(offset, 8);
-    const val = new BigInt64Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
-   * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
-   * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
-   */
-  async slice(startOffset, endOffset) {
-    const bigLength = BigInt(endOffset) - BigInt(startOffset);
-    if (bigLength > Number.MAX_SAFE_INTEGER) {
-      throw new Error("too big slice");
-    }
-    const length = Number(bigLength);
-    return await this.file.read(startOffset, length);
-  }
-  /**
-   * the length (in bytes) of the data.
-   */
-  get length() {
-    return this.size;
-  }
-};
-
-// dist/lib/file-provider/file-handle-file.js
-var FileHandleFile = class {
-  /** The FileHandle from which data is provided */
-  file;
-  /** Create a new FileHandleFile */
-  constructor(path, append = false) {
-    this.file = new NodeFileFacade(path, append ? "a+" : "r");
-  }
-  /**
-   * Truncates the file descriptor.
-   * @param length desired file lenght
-   */
-  async truncate(length) {
-    await this.file.truncate(length);
-  }
-  /**
-   * Append data to a file.
-   * @param buffer data to append
-   */
-  async append(buffer) {
-    await this.file.append(buffer);
-  }
-  /** Close file */
-  async destroy() {
-    await this.file.close();
-  }
-  /**
-   * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint8(offset) {
-    const arrayBuffer = await this.file.read(offset, 1);
-    const val = new Uint8Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint16(offset) {
-    const arrayBuffer = await this.file.read(offset, 2);
-    const val = new Uint16Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint32(offset) {
-    const arrayBuffer = await this.file.read(offset, 4);
-    const val = new Uint32Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getBigUint64(offset) {
-    const arrayBuffer = await this.file.read(offset, 8);
-    const val = new BigInt64Array(arrayBuffer).at(0);
-    if (val === void 0) {
-      throw new Error("something went wrong");
-    }
-    return val;
-  }
-  /**
-   * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
-   * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
-   * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
-   */
-  async slice(startOffset, endOffset) {
-    const bigLength = endOffset - startOffset;
-    if (bigLength > Number.MAX_SAFE_INTEGER) {
-      throw new Error("too big slice");
-    }
-    const length = Number(bigLength);
-    return await this.file.read(startOffset, length);
-  }
-  /**
-   * the length (in bytes) of the data.
-   */
-  get length() {
-    return this.file.bigsize;
-  }
-};
-
-// dist/lib/file-provider/data-view-file.js
-var toNumber = (bigint) => {
-  if (bigint > Number.MAX_SAFE_INTEGER) {
-    throw new Error("Offset is out of bounds");
-  }
-  return Number(bigint);
-};
-var DataViewFile = class {
-  /** The DataView from which data is provided */
-  file;
-  constructor(file) {
-    this.file = file;
-  }
-  async destroy() {
-  }
-  /**
-   * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint8(offset) {
-    return this.file.getUint8(toNumber(offset));
-  }
-  /**
-   * Gets an unsigned 16-bit intege at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint16(offset) {
-    return this.file.getUint16(toNumber(offset), true);
-  }
-  /**
-   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getUint32(offset) {
-    return this.file.getUint32(toNumber(offset), true);
-  }
-  /**
-   * Gets an unsigned 64-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the start of the file where to read the data.
-   */
-  async getBigUint64(offset) {
-    return this.file.getBigUint64(toNumber(offset), true);
-  }
-  /**
-   * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
-   * @param startOffset The offset, in bytes, from the start of the file where to start reading the data.
-   * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
-   */
-  async slice(startOffset, endOffset) {
-    return this.file.buffer.slice(toNumber(startOffset), toNumber(endOffset));
-  }
-  /** the length (in bytes) of the data. */
-  get length() {
-    return BigInt(this.file.byteLength);
-  }
-};
-
 // dist/lib/sources/data-source.js
-var DataSource = class {
-  /** A resolved fetch function extracted from loadOptions prop */
-  fetch;
+var _DataSource = class {
+  optionsType;
+  options;
+  data;
+  url;
   /** The actual load options, if calling a loaders.gl loader */
   loadOptions;
+  /** A resolved fetch function extracted from loadOptions prop */
+  fetch;
   _needsRefresh = true;
-  props;
-  constructor(props) {
-    this.props = { ...props };
-    this.loadOptions = { ...props.loadOptions };
+  constructor(data, options, defaultOptions) {
+    var _a;
+    if (defaultOptions) {
+      this.options = mergeOptions({ ...defaultOptions, core: _DataSource.defaultOptions }, options);
+    } else {
+      this.options = { ...options };
+    }
+    this.data = data;
+    this.url = typeof data === "string" ? resolvePath(data) : "";
+    this.loadOptions = { ...(_a = this.options.core) == null ? void 0 : _a.loadOptions };
     this.fetch = getFetchFunction(this.loadOptions);
   }
-  setProps(props) {
-    this.props = Object.assign(this.props, props);
+  setProps(options) {
+    this.options = Object.assign(this.options, options);
     this.setNeedsRefresh();
   }
   /** Mark this data source as needing a refresh (redraw) */
@@ -1429,8 +1319,18 @@ var DataSource = class {
     return needsRefresh;
   }
 };
+var DataSource = _DataSource;
+__publicField(DataSource, "defaultOptions", {
+  core: {
+    type: "auto",
+    attributions: [],
+    loadOptions: {},
+    loaders: []
+  }
+});
 function getFetchFunction(options) {
-  const fetchFunction = options == null ? void 0 : options.fetch;
+  var _a;
+  const fetchFunction = (_a = options == null ? void 0 : options.core) == null ? void 0 : _a.fetch;
   if (fetchFunction && typeof fetchFunction === "function") {
     return (url, fetchOptions2) => fetchFunction(url, fetchOptions2);
   }
@@ -1442,14 +1342,8 @@ function getFetchFunction(options) {
 }
 
 // dist/lib/sources/image-source.js
-var ImageSource = class extends DataSource {
+var ImageSource = class {
 };
 __publicField(ImageSource, "type", "template");
 __publicField(ImageSource, "testURL", (url) => false);
-
-// dist/lib/sources/vector-source.js
-var VectorSource = class extends DataSource {
-};
-__publicField(VectorSource, "type", "template");
-__publicField(VectorSource, "testURL", (url) => false);
 //# sourceMappingURL=index.cjs.map