@loaders.gl/loader-utils 4.2.0-alpha.4 → 4.2.0-alpha.6

package/dist/index.cjs

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 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 });
@@ -16,10 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   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;
+};
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
+// dist/index.js
+var dist_exports = {};
+__export(dist_exports, {
   BlobFile: () => BlobFile,
   DataSource: () => DataSource,
   DataViewFile: () => DataViewFile,
@@ -81,9 +86,9 @@ __export(src_exports, {
   toBuffer: () => toBuffer2,
   window: () => window_
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(dist_exports);
 
-// src/loader-types.ts
+// dist/loader-types.js
 async function parseFromContext(data, loaders, options, context) {
   return context._parse(data, loaders, options, context);
 }
@@ -100,14 +105,14 @@ async function parseInBatchesFromContext(data, loader, options, context) {
   return context._parseInBatches(data, loader, options, context);
 }
 
-// src/lib/env-utils/assert.ts
+// dist/lib/env-utils/assert.js
 function assert(condition, message) {
   if (!condition) {
     throw new Error(message || "loader assertion failed.");
   }
 }
 
-// src/lib/env-utils/globals.ts
+// dist/lib/env-utils/globals.js
 var globals = {
   self: typeof self !== "undefined" && self,
   window: typeof window !== "undefined" && window,
@@ -126,7 +131,7 @@ var isWorker = typeof importScripts === "function";
 var matches = typeof process !== "undefined" && process.version && /v([0-9]*)/.exec(process.version);
 var nodeVersion = matches && parseFloat(matches[1]) || 0;
 
-// src/lib/option-utils/merge-loader-options.ts
+// dist/lib/option-utils/merge-loader-options.js
 function mergeLoaderOptions(baseOptions, newOptions) {
   return mergeOptionsRecursively(baseOptions || {}, newOptions);
 }
@@ -137,11 +142,7 @@ function mergeOptionsRecursively(baseOptions, newOptions, level = 0) {
   const options = { ...baseOptions };
   for (const [key, newValue] of Object.entries(newOptions)) {
     if (newValue && typeof newValue === "object" && !Array.isArray(newValue)) {
-      options[key] = mergeOptionsRecursively(
-        options[key] || {},
-        newOptions[key],
-        level + 1
-      );
+      options[key] = mergeOptionsRecursively(options[key] || {}, newOptions[key], level + 1);
     } else {
       options[key] = newOptions[key];
     }
@@ -149,7 +150,7 @@ function mergeOptionsRecursively(baseOptions, newOptions, level = 0) {
   return options;
 }
 
-// src/lib/worker-loader-utils/create-loader-worker.ts
+// dist/lib/worker-loader-utils/create-loader-worker.js
 var import_worker_utils = require("@loaders.gl/worker-utils");
 var requestId = 0;
 async function createLoaderWorker(loader) {
@@ -205,12 +206,7 @@ function parseOnMainThread(arrayBuffer, loader, options, context) {
     import_worker_utils.WorkerBody.postMessage("process", payload);
   });
 }
-async function parseData({
-  loader,
-  arrayBuffer,
-  options,
-  context
-}) {
+async function parseData({ loader, arrayBuffer, options, context }) {
   let data;
   let parser;
   if (loader.parseSync || loader.parse) {
@@ -231,7 +227,7 @@ async function parseData({
   return await parser(data, { ...options }, context, loader);
 }
 
-// src/lib/worker-loader-utils/parse-with-worker.ts
+// dist/lib/worker-loader-utils/parse-with-worker.js
 var import_worker_utils2 = require("@loaders.gl/worker-utils");
 var import_worker_utils3 = require("@loaders.gl/worker-utils");
 function canParseWithWorker(loader, options) {
@@ -288,7 +284,7 @@ async function onMessage(parseOnMainThread2, job, type, payload) {
   }
 }
 
-// src/lib/worker-loader-utils/encode-with-worker.ts
+// dist/lib/worker-loader-utils/encode-with-worker.js
 var import_worker_utils4 = require("@loaders.gl/worker-utils");
 function canEncodeWithWorker(writer, options) {
   if (!import_worker_utils4.WorkerFarm.isSupported()) {
@@ -300,7 +296,7 @@ function canEncodeWithWorker(writer, options) {
   return writer.worker && (options == null ? void 0 : options.worker);
 }
 
-// src/lib/binary-utils/get-first-characters.ts
+// dist/lib/binary-utils/get-first-characters.js
 function getFirstCharacters(data, length = 5) {
   if (typeof data === "string") {
     return data.slice(0, length);
@@ -324,7 +320,7 @@ function getMagicString(arrayBuffer, byteOffset, length) {
   return magic;
 }
 
-// src/lib/parser-utils/parse-json.ts
+// dist/lib/parser-utils/parse-json.js
 function parseJSON(string) {
   try {
     return JSON.parse(string);
@@ -333,7 +329,7 @@ function parseJSON(string) {
   }
 }
 
-// src/lib/binary-utils/array-buffer-utils.ts
+// dist/lib/binary-utils/array-buffer-utils.js
 function compareArrayBuffers(arrayBuffer1, arrayBuffer2, byteLength) {
   byteLength = byteLength || arrayBuffer1.byteLength;
   if (arrayBuffer1.byteLength < byteLength || arrayBuffer2.byteLength < byteLength) {
@@ -352,9 +348,7 @@ function concatenateArrayBuffers(...sources) {
   return concatenateArrayBuffersFromArray(sources);
 }
 function concatenateArrayBuffersFromArray(sources) {
-  const sourceArrays = sources.map(
-    (source2) => source2 instanceof ArrayBuffer ? new Uint8Array(source2) : source2
-  );
+  const sourceArrays = sources.map((source2) => source2 instanceof ArrayBuffer ? new Uint8Array(source2) : source2);
   const byteLength = sourceArrays.reduce((length, typedArray) => length + typedArray.byteLength, 0);
   const result = new Uint8Array(byteLength);
   let offset = 0;
@@ -368,9 +362,7 @@ function concatenateTypedArrays(...typedArrays) {
   const arrays = typedArrays;
   const TypedArrayConstructor = arrays && arrays.length > 1 && arrays[0].constructor || null;
   if (!TypedArrayConstructor) {
-    throw new Error(
-      '"concatenateTypedArrays" - incorrect quantity of arguments or arguments have incompatible data types'
-    );
+    throw new Error('"concatenateTypedArrays" - incorrect quantity of arguments or arguments have incompatible data types');
   }
   const sumLength = arrays.reduce((acc, value) => acc + value.length, 0);
   const result = new TypedArrayConstructor(sumLength);
@@ -387,7 +379,7 @@ function sliceArrayBuffer(arrayBuffer, byteOffset, byteLength) {
   return arrayCopy.buffer;
 }
 
-// src/lib/binary-utils/memory-copy-utils.ts
+// dist/lib/binary-utils/memory-copy-utils.js
 function padToNBytes(byteLength, padding) {
   assert(byteLength >= 0);
   assert(padding > 0);
@@ -412,7 +404,7 @@ function copyToArray(source, target, targetOffset) {
   return targetOffset + padToNBytes(sourceArray.byteLength, 4);
 }
 
-// src/lib/binary-utils/dataview-copy-utils.ts
+// dist/lib/binary-utils/dataview-copy-utils.js
 function padStringToByteAlignment(string, byteAlignment) {
   const length = string.length;
   const paddedLength = Math.ceil(length / byteAlignment) * byteAlignment;
@@ -443,11 +435,7 @@ function copyPaddedArrayBufferToDataView(dataView, byteOffset, sourceBuffer, pad
   const paddedLength = padToNBytes(sourceBuffer.byteLength, padding);
   const padLength = paddedLength - sourceBuffer.byteLength;
   if (dataView) {
-    const targetArray = new Uint8Array(
-      dataView.buffer,
-      dataView.byteOffset + byteOffset,
-      sourceBuffer.byteLength
-    );
+    const targetArray = new Uint8Array(dataView.buffer, dataView.byteOffset + byteOffset, sourceBuffer.byteLength);
     const sourceArray = new Uint8Array(sourceBuffer);
     targetArray.set(sourceArray);
     for (let i = 0; i < padLength; ++i) {
@@ -464,7 +452,7 @@ function copyPaddedStringToDataView(dataView, byteOffset, string, padding) {
   return byteOffset;
 }
 
-// src/lib/iterators/text-iterators.ts
+// dist/lib/iterators/text-iterators.js
 async function* makeTextDecoderIterator(arrayBufferIterator, options = {}) {
   const textDecoder = new TextDecoder(void 0, options);
   for await (const arrayBuffer of arrayBufferIterator) {
@@ -500,7 +488,7 @@ async function* makeNumberedLineIterator(lineIterator) {
   }
 }
 
-// src/lib/iterators/async-iteration.ts
+// dist/lib/iterators/async-iteration.js
 async function forEach(iterator, visitor) {
   while (true) {
     const { done, value } = await iterator.next();
@@ -522,7 +510,7 @@ async function concatenateArrayBuffersAsync(asyncIterator) {
   return concatenateArrayBuffers(...arrayBuffers);
 }
 
-// src/lib/request-utils/request-scheduler.ts
+// dist/lib/request-utils/request-scheduler.js
 var import_stats = require("@probe.gl/stats");
 var STAT_QUEUED_REQUESTS = "Queued Requests";
 var STAT_ACTIVE_REQUESTS = "Active Requests";
@@ -531,18 +519,25 @@ var STAT_QUEUED_REQUESTS_EVER = "Queued Requests Ever";
 var STAT_ACTIVE_REQUESTS_EVER = "Active Requests Ever";
 var DEFAULT_PROPS = {
   id: "request-scheduler",
-  // Specifies if the request scheduler should throttle incoming requests, mainly for comparative testing
+  /** Specifies if the request scheduler should throttle incoming requests, mainly for comparative testing. */
   throttleRequests: true,
-  // The maximum number of simultaneous active requests. Un-throttled requests do not observe this limit.
-  maxRequests: 6
+  /** The maximum number of simultaneous active requests. Un-throttled requests do not observe this limit. */
+  maxRequests: 6,
+  /**
+   * Specifies a debounce time, in milliseconds. All requests are queued, until no new requests have
+   * been added to the queue for this amount of time.
+   */
+  debounceTime: 0
 };
 var RequestScheduler = class {
+  props;
+  stats;
+  activeRequestCount = 0;
+  /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+  requestQueue = [];
+  requestMap = /* @__PURE__ */ new Map();
+  updateTimer = null;
   constructor(props = {}) {
-    this.activeRequestCount = 0;
-    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
-    this.requestQueue = [];
-    this.requestMap = /* @__PURE__ */ new Map();
-    this.deferredUpdate = null;
     this.props = { ...DEFAULT_PROPS, ...props };
     this.stats = new import_stats.Stats({ id: this.props.id });
     this.stats.get(STAT_QUEUED_REQUESTS);
@@ -602,13 +597,17 @@ var RequestScheduler = class {
   }
   /** We check requests asynchronously, to prevent multiple updates */
   _issueNewRequests() {
-    if (!this.deferredUpdate) {
-      this.deferredUpdate = setTimeout(() => this._issueNewRequestsAsync(), 0);
+    if (this.updateTimer !== null) {
+      clearTimeout(this.updateTimer);
     }
+    this.updateTimer = setTimeout(() => this._issueNewRequestsAsync(), this.props.debounceTime);
   }
   /** Refresh all requests  */
   _issueNewRequestsAsync() {
-    this.deferredUpdate = null;
+    if (this.updateTimer !== null) {
+      clearTimeout(this.updateTimer);
+    }
+    this.updateTimer = null;
     const freeSlots = Math.max(this.props.maxRequests - this.activeRequestCount, 0);
     if (freeSlots === 0) {
       return;
@@ -645,7 +644,7 @@ var RequestScheduler = class {
   }
 };
 
-// src/lib/path-utils/file-aliases.ts
+// dist/lib/path-utils/file-aliases.js
 var pathPrefix = "";
 var fileAliases = {};
 function setPathPrefix(prefix) {
@@ -670,8 +669,8 @@ function resolvePath(filename2) {
   return filename2;
 }
 
-// src/json-loader.ts
-var VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
+// dist/json-loader.js
+var VERSION = true ? "4.2.0-alpha.5" : "latest";
 var JSONLoader = {
   name: "JSON",
   id: "json",
@@ -689,7 +688,7 @@ function parseTextSync(text) {
   return JSON.parse(text);
 }
 
-// src/lib/node/buffer.browser.ts
+// dist/lib/node/buffer.browser.js
 function toArrayBuffer(buffer) {
   return buffer;
 }
@@ -697,7 +696,7 @@ function toBuffer(binaryData) {
   throw new Error("Buffer not supported in browser");
 }
 
-// src/lib/binary-utils/memory-conversion-utils.ts
+// dist/lib/binary-utils/memory-conversion-utils.js
 function isBuffer(value) {
   return value && typeof value === "object" && value.isBuffer;
 }
@@ -728,19 +727,15 @@ function toArrayBuffer2(data) {
   throw new Error("toArrayBuffer");
 }
 
-// src/lib/node/promisify.ts
+// dist/lib/node/promisify.js
 function promisify1(fn) {
-  return (args) => new Promise(
-    (resolve2, reject) => fn(args, (error, callbackArgs) => error ? reject(error) : resolve2(callbackArgs))
-  );
+  return (args) => new Promise((resolve2, reject) => fn(args, (error, callbackArgs) => error ? reject(error) : resolve2(callbackArgs)));
 }
 function promisify2(fn) {
-  return (arg1, arg2) => new Promise(
-    (resolve2, reject) => fn(arg1, arg2, (error, callbackArgs) => error ? reject(error) : resolve2(callbackArgs))
-  );
+  return (arg1, arg2) => new Promise((resolve2, reject) => fn(arg1, arg2, (error, callbackArgs) => error ? reject(error) : resolve2(callbackArgs)));
 }
 
-// src/lib/path-utils/path.ts
+// dist/lib/path-utils/path.js
 var path_exports = {};
 __export(path_exports, {
   dirname: () => dirname,
@@ -749,7 +744,7 @@ __export(path_exports, {
   resolve: () => resolve
 });
 
-// src/lib/path-utils/get-cwd.ts
+// dist/lib/path-utils/get-cwd.js
 function getCWD() {
   var _a;
   if (typeof process !== "undefined" && typeof process.cwd !== "undefined") {
@@ -759,7 +754,7 @@ function getCWD() {
   return (pathname == null ? void 0 : pathname.slice(0, pathname.lastIndexOf("/") + 1)) || "";
 }
 
-// src/lib/path-utils/path.ts
+// dist/lib/path-utils/path.js
 function filename(url) {
   const slashIndex = url ? url.lastIndexOf("/") : -1;
   return slashIndex >= 0 ? url.substr(slashIndex + 1) : "";
@@ -884,15 +879,19 @@ function normalizeStringPosix(path, allowAboveRoot) {
   return res;
 }
 
-// src/lib/node/stream.browser.ts
+// dist/lib/node/stream.browser.js
 var stream_browser_exports = {};
 __export(stream_browser_exports, {
   isSupported: () => isSupported
 });
 var isSupported = false;
 
-// src/lib/files/blob-file.ts
+// dist/lib/files/blob-file.js
 var BlobFile = class {
+  handle;
+  size;
+  bigsize;
+  url;
   constructor(blob) {
     this.handle = blob instanceof ArrayBuffer ? new Blob([blob]) : blob;
     this.size = blob instanceof ArrayBuffer ? blob.byteLength : blob.size;
@@ -914,11 +913,13 @@ var BlobFile = class {
   }
 };
 
-// src/lib/files/http-file.ts
+// dist/lib/files/http-file.js
 var HttpFile = class {
+  handle;
+  size = 0;
+  bigsize = 0n;
+  url;
   constructor(url) {
-    this.size = 0;
-    this.bigsize = 0n;
     this.handle = url;
     this.url = url;
   }
@@ -972,9 +973,7 @@ var HttpFile = class {
           if (controller) {
             controller.abort();
           }
-          throw Error(
-            "content-length header missing or exceeding request. Server must support HTTP Byte Serving."
-          );
+          throw Error("content-length header missing or exceeding request. Server must support HTTP Byte Serving.");
         }
       case 416:
         if (offset === 0) {
@@ -998,13 +997,14 @@ var HttpFile = class {
   }
 };
 
-// src/lib/files/node-file-facade.ts
+// dist/lib/files/node-file-facade.js
 var NOT_IMPLEMENTED = new Error("Not implemented");
 var NodeFileFacade = class {
+  handle;
+  size = 0;
+  bigsize = 0n;
+  url = "";
   constructor(url, flags, mode) {
-    this.size = 0;
-    this.bigsize = 0n;
-    this.url = "";
     var _a;
     if ((_a = globalThis.loaders) == null ? void 0 : _a.NodeFile) {
       return new globalThis.loaders.NodeFile(url, flags, mode);
@@ -1039,15 +1039,11 @@ var NodeFileFacade = class {
   }
 };
 
-// src/lib/filesystems/node-filesystem-facade.ts
+// dist/lib/filesystems/node-filesystem-facade.js
 var NOT_IMPLEMENTED2 = new Error("Not implemented");
 var NodeFileSystemFacade = class {
   // implements FileSystem
   constructor(options) {
-    // DUMMY IMPLEMENTATION, not used (constructor returns a real NodeFileSystem instance)
-    // implements RandomAccessReadFileSystem
-    this.readable = true;
-    this.writable = true;
     var _a;
     if ((_a = globalThis.loaders) == null ? void 0 : _a.NodeFileSystem) {
       return new globalThis.loaders.NodeFileSystem(options);
@@ -1055,10 +1051,12 @@ var NodeFileSystemFacade = class {
     if (isBrowser) {
       throw new Error("Can't instantiate NodeFileSystem in browser.");
     }
-    throw new Error(
-      "Can't instantiate NodeFileSystem. Make sure to import @loaders.gl/polyfills first."
-    );
+    throw new Error("Can't instantiate NodeFileSystem. Make sure to import @loaders.gl/polyfills first.");
   }
+  // DUMMY IMPLEMENTATION, not used (constructor returns a real NodeFileSystem instance)
+  // implements RandomAccessReadFileSystem
+  readable = true;
+  writable = true;
   async openReadableFile(path, flags) {
     throw NOT_IMPLEMENTED2;
   }
@@ -1081,13 +1079,15 @@ var NodeFileSystemFacade = class {
   }
 };
 
-// src/lib/file-provider/file-provider.ts
+// dist/lib/file-provider/file-provider.js
 var isFileProvider = (fileProvider) => {
   return (fileProvider == null ? void 0 : fileProvider.getUint8) && (fileProvider == null ? void 0 : fileProvider.slice) && (fileProvider == null ? void 0 : fileProvider.length);
 };
 
-// src/lib/file-provider/file-handle-file.ts
+// 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");
@@ -1179,7 +1179,7 @@ var FileHandleFile = class {
   }
 };
 
-// src/lib/file-provider/data-view-file.ts
+// 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");
@@ -1187,6 +1187,8 @@ var toNumber = (bigint) => {
   return Number(bigint);
 };
 var DataViewFile = class {
+  /** The DataView from which data is provided */
+  file;
   constructor(file) {
     this.file = file;
   }
@@ -1234,10 +1236,15 @@ var DataViewFile = class {
   }
 };
 
-// src/lib/sources/data-source.ts
+// dist/lib/sources/data-source.js
 var DataSource = class {
+  /** A resolved fetch function extracted from loadOptions prop */
+  fetch;
+  /** The actual load options, if calling a loaders.gl loader */
+  loadOptions;
+  _needsRefresh = true;
+  props;
   constructor(props) {
-    this._needsRefresh = true;
     this.props = { ...props };
     this.loadOptions = { ...props.loadOptions };
     this.fetch = getFetchFunction(this.loadOptions);
@@ -1274,8 +1281,9 @@ function getFetchFunction(options) {
   return (url) => fetch(url);
 }
 
-// src/lib/sources/image-source.ts
+// dist/lib/sources/image-source.js
 var ImageSource = class extends DataSource {
 };
-ImageSource.type = "template";
-ImageSource.testURL = (url) => false;
+__publicField(ImageSource, "type", "template");
+__publicField(ImageSource, "testURL", (url) => false);
+//# sourceMappingURL=index.cjs.map