@loaders.gl/core 3.1.4 → 3.1.8

package/dist/dist.min.js

@@ -2353,6 +2353,638 @@
     }
   });
 
+  // ../../node_modules/@probe.gl/env/dist/esm/lib/is-electron.js
+  function isElectron2(mockUserAgent) {
+    if (typeof window !== "undefined" && typeof window.process === "object" && window.process.type === "renderer") {
+      return true;
+    }
+    if (typeof process !== "undefined" && typeof process.versions === "object" && Boolean(process.versions.electron)) {
+      return true;
+    }
+    const realUserAgent = typeof navigator === "object" && typeof navigator.userAgent === "string" && navigator.userAgent;
+    const userAgent = mockUserAgent || realUserAgent;
+    if (userAgent && userAgent.indexOf("Electron") >= 0) {
+      return true;
+    }
+    return false;
+  }
+  var init_is_electron2 = __esm({
+    "../../node_modules/@probe.gl/env/dist/esm/lib/is-electron.js"() {
+    }
+  });
+
+  // ../../node_modules/@probe.gl/env/dist/esm/lib/is-browser.js
+  function isBrowser5() {
+    const isNode = typeof process === "object" && String(process) === "[object process]" && !process.browser;
+    return !isNode || isElectron2();
+  }
+  var init_is_browser2 = __esm({
+    "../../node_modules/@probe.gl/env/dist/esm/lib/is-browser.js"() {
+      init_is_electron2();
+    }
+  });
+
+  // ../../node_modules/@probe.gl/env/dist/esm/lib/globals.js
+  var globals4, self_4, window_4, document_4, process_2;
+  var init_globals5 = __esm({
+    "../../node_modules/@probe.gl/env/dist/esm/lib/globals.js"() {
+      globals4 = {
+        self: typeof self !== "undefined" && self,
+        window: typeof window !== "undefined" && window,
+        global: typeof global !== "undefined" && global,
+        document: typeof document !== "undefined" && document,
+        process: typeof process === "object" && process
+      };
+      self_4 = globals4.self || globals4.window || globals4.global;
+      window_4 = globals4.window || globals4.self || globals4.global;
+      document_4 = globals4.document || {};
+      process_2 = globals4.process || {};
+    }
+  });
+
+  // ../../node_modules/@probe.gl/env/dist/esm/utils/globals.js
+  var VERSION4, isBrowser6;
+  var init_globals6 = __esm({
+    "../../node_modules/@probe.gl/env/dist/esm/utils/globals.js"() {
+      init_is_browser2();
+      VERSION4 = typeof __VERSION__ !== "undefined" ? __VERSION__ : "untranspiled source";
+      isBrowser6 = isBrowser5();
+    }
+  });
+
+  // ../../node_modules/@probe.gl/env/dist/esm/index.js
+  var init_esm4 = __esm({
+    "../../node_modules/@probe.gl/env/dist/esm/index.js"() {
+      init_globals6();
+      init_globals5();
+      init_is_browser2();
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/local-storage.js
+  function getStorage2(type) {
+    try {
+      const storage = window[type];
+      const x = "__storage_test__";
+      storage.setItem(x, x);
+      storage.removeItem(x);
+      return storage;
+    } catch (e) {
+      return null;
+    }
+  }
+  var LocalStorage2;
+  var init_local_storage2 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/local-storage.js"() {
+      init_defineProperty();
+      LocalStorage2 = class {
+        constructor(id) {
+          let defaultSettings = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+          let type = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : "sessionStorage";
+          _defineProperty(this, "storage", void 0);
+          _defineProperty(this, "id", void 0);
+          _defineProperty(this, "config", {});
+          this.storage = getStorage2(type);
+          this.id = id;
+          this.config = {};
+          Object.assign(this.config, defaultSettings);
+          this._loadConfiguration();
+        }
+        getConfiguration() {
+          return this.config;
+        }
+        setConfiguration(configuration) {
+          this.config = {};
+          return this.updateConfiguration(configuration);
+        }
+        updateConfiguration(configuration) {
+          Object.assign(this.config, configuration);
+          if (this.storage) {
+            const serialized = JSON.stringify(this.config);
+            this.storage.setItem(this.id, serialized);
+          }
+          return this;
+        }
+        _loadConfiguration() {
+          let configuration = {};
+          if (this.storage) {
+            const serializedConfiguration = this.storage.getItem(this.id);
+            configuration = serializedConfiguration ? JSON.parse(serializedConfiguration) : {};
+          }
+          Object.assign(this.config, configuration);
+          return this;
+        }
+      };
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/formatters.js
+  function formatTime2(ms) {
+    let formatted;
+    if (ms < 10) {
+      formatted = "".concat(ms.toFixed(2), "ms");
+    } else if (ms < 100) {
+      formatted = "".concat(ms.toFixed(1), "ms");
+    } else if (ms < 1e3) {
+      formatted = "".concat(ms.toFixed(0), "ms");
+    } else {
+      formatted = "".concat((ms / 1e3).toFixed(2), "s");
+    }
+    return formatted;
+  }
+  function leftPad2(string) {
+    let length = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 8;
+    const padLength = Math.max(length - string.length, 0);
+    return "".concat(" ".repeat(padLength)).concat(string);
+  }
+  function formatImage2(image, message, scale) {
+    let maxWidth = arguments.length > 3 && arguments[3] !== void 0 ? arguments[3] : 600;
+    const imageUrl = image.src.replace(/\(/g, "%28").replace(/\)/g, "%29");
+    if (image.width > maxWidth) {
+      scale = Math.min(scale, maxWidth / image.width);
+    }
+    const width = image.width * scale;
+    const height = image.height * scale;
+    const style = ["font-size:1px;", "padding:".concat(Math.floor(height / 2), "px ").concat(Math.floor(width / 2), "px;"), "line-height:".concat(height, "px;"), "background:url(".concat(imageUrl, ");"), "background-size:".concat(width, "px ").concat(height, "px;"), "color:transparent;"].join("");
+    return ["".concat(message, " %c+"), style];
+  }
+  var init_formatters2 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/formatters.js"() {
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/color.js
+  function getColor2(color) {
+    return typeof color === "string" ? COLOR2[color.toUpperCase()] || COLOR2.WHITE : color;
+  }
+  function addColor2(string, color, background) {
+    if (!isBrowser5 && typeof string === "string") {
+      if (color) {
+        color = getColor2(color);
+        string = "[".concat(color, "m").concat(string, "");
+      }
+      if (background) {
+        color = getColor2(background);
+        string = "[".concat(background + 10, "m").concat(string, "");
+      }
+    }
+    return string;
+  }
+  var COLOR2;
+  var init_color2 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/color.js"() {
+      init_esm4();
+      (function(COLOR3) {
+        COLOR3[COLOR3["BLACK"] = 30] = "BLACK";
+        COLOR3[COLOR3["RED"] = 31] = "RED";
+        COLOR3[COLOR3["GREEN"] = 32] = "GREEN";
+        COLOR3[COLOR3["YELLOW"] = 33] = "YELLOW";
+        COLOR3[COLOR3["BLUE"] = 34] = "BLUE";
+        COLOR3[COLOR3["MAGENTA"] = 35] = "MAGENTA";
+        COLOR3[COLOR3["CYAN"] = 36] = "CYAN";
+        COLOR3[COLOR3["WHITE"] = 37] = "WHITE";
+        COLOR3[COLOR3["BRIGHT_BLACK"] = 90] = "BRIGHT_BLACK";
+        COLOR3[COLOR3["BRIGHT_RED"] = 91] = "BRIGHT_RED";
+        COLOR3[COLOR3["BRIGHT_GREEN"] = 92] = "BRIGHT_GREEN";
+        COLOR3[COLOR3["BRIGHT_YELLOW"] = 93] = "BRIGHT_YELLOW";
+        COLOR3[COLOR3["BRIGHT_BLUE"] = 94] = "BRIGHT_BLUE";
+        COLOR3[COLOR3["BRIGHT_MAGENTA"] = 95] = "BRIGHT_MAGENTA";
+        COLOR3[COLOR3["BRIGHT_CYAN"] = 96] = "BRIGHT_CYAN";
+        COLOR3[COLOR3["BRIGHT_WHITE"] = 97] = "BRIGHT_WHITE";
+      })(COLOR2 || (COLOR2 = {}));
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/autobind.js
+  function autobind2(obj) {
+    let predefined = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : ["constructor"];
+    const proto = Object.getPrototypeOf(obj);
+    const propNames = Object.getOwnPropertyNames(proto);
+    for (const key of propNames) {
+      if (typeof obj[key] === "function") {
+        if (!predefined.find((name) => key === name)) {
+          obj[key] = obj[key].bind(obj);
+        }
+      }
+    }
+  }
+  var init_autobind2 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/autobind.js"() {
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/assert.js
+  function assert4(condition, message) {
+    if (!condition) {
+      throw new Error(message || "Assertion failed");
+    }
+  }
+  var init_assert4 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/assert.js"() {
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/utils/hi-res-timestamp.js
+  function getHiResTimestamp4() {
+    let timestamp;
+    if (isBrowser5 && "performance" in window_4) {
+      var _window$performance, _window$performance$n;
+      timestamp = window_4 === null || window_4 === void 0 ? void 0 : (_window$performance = window_4.performance) === null || _window$performance === void 0 ? void 0 : (_window$performance$n = _window$performance.now) === null || _window$performance$n === void 0 ? void 0 : _window$performance$n.call(_window$performance);
+    } else if ("hrtime" in process_2) {
+      var _process$hrtime;
+      const timeParts = process_2 === null || process_2 === void 0 ? void 0 : (_process$hrtime = process_2.hrtime) === null || _process$hrtime === void 0 ? void 0 : _process$hrtime.call(process_2);
+      timestamp = timeParts[0] * 1e3 + timeParts[1] / 1e6;
+    } else {
+      timestamp = Date.now();
+    }
+    return timestamp;
+  }
+  var init_hi_res_timestamp4 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/utils/hi-res-timestamp.js"() {
+      init_esm4();
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/log.js
+  function noop2() {
+  }
+  function normalizeLogLevel2(logLevel) {
+    if (!logLevel) {
+      return 0;
+    }
+    let resolvedLevel;
+    switch (typeof logLevel) {
+      case "number":
+        resolvedLevel = logLevel;
+        break;
+      case "object":
+        resolvedLevel = logLevel.logLevel || logLevel.priority || 0;
+        break;
+      default:
+        return 0;
+    }
+    assert4(Number.isFinite(resolvedLevel) && resolvedLevel >= 0);
+    return resolvedLevel;
+  }
+  function normalizeArguments2(opts) {
+    const {
+      logLevel,
+      message
+    } = opts;
+    opts.logLevel = normalizeLogLevel2(logLevel);
+    const args = opts.args ? Array.from(opts.args) : [];
+    while (args.length && args.shift() !== message) {
+    }
+    switch (typeof logLevel) {
+      case "string":
+      case "function":
+        if (message !== void 0) {
+          args.unshift(message);
+        }
+        opts.message = logLevel;
+        break;
+      case "object":
+        Object.assign(opts, logLevel);
+        break;
+      default:
+    }
+    if (typeof opts.message === "function") {
+      opts.message = opts.message();
+    }
+    const messageType = typeof opts.message;
+    assert4(messageType === "string" || messageType === "object");
+    return Object.assign(opts, {
+      args
+    }, opts.opts);
+  }
+  function decorateMessage2(id, message, opts) {
+    if (typeof message === "string") {
+      const time = opts.time ? leftPad2(formatTime2(opts.total)) : "";
+      message = opts.time ? "".concat(id, ": ").concat(time, "  ").concat(message) : "".concat(id, ": ").concat(message);
+      message = addColor2(message, opts.color, opts.background);
+    }
+    return message;
+  }
+  function logImageInNode2(_ref2) {
+    let {
+      image,
+      message = "",
+      scale = 1
+    } = _ref2;
+    let asciify = null;
+    try {
+      asciify = module.require("asciify-image");
+    } catch (error) {
+    }
+    if (asciify) {
+      return () => asciify(image, {
+        fit: "box",
+        width: "".concat(Math.round(80 * scale), "%")
+      }).then((data) => console.log(data));
+    }
+    return noop2;
+  }
+  function logImageInBrowser2(_ref3) {
+    let {
+      image,
+      message = "",
+      scale = 1
+    } = _ref3;
+    if (typeof image === "string") {
+      const img = new Image();
+      img.onload = () => {
+        const args = formatImage2(img, message, scale);
+        console.log(...args);
+      };
+      img.src = image;
+      return noop2;
+    }
+    const element = image.nodeName || "";
+    if (element.toLowerCase() === "img") {
+      console.log(...formatImage2(image, message, scale));
+      return noop2;
+    }
+    if (element.toLowerCase() === "canvas") {
+      const img = new Image();
+      img.onload = () => console.log(...formatImage2(img, message, scale));
+      img.src = image.toDataURL();
+      return noop2;
+    }
+    return noop2;
+  }
+  function getTableHeader2(table) {
+    for (const key in table) {
+      for (const title in table[key]) {
+        return title || "untitled";
+      }
+    }
+    return "empty";
+  }
+  var originalConsole2, DEFAULT_SETTINGS2, cache2, ONCE2, Log2;
+  var init_log2 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/log.js"() {
+      init_defineProperty();
+      init_esm4();
+      init_local_storage2();
+      init_formatters2();
+      init_color2();
+      init_autobind2();
+      init_assert4();
+      init_hi_res_timestamp4();
+      originalConsole2 = {
+        debug: isBrowser5 ? console.debug || console.log : console.log,
+        log: console.log,
+        info: console.info,
+        warn: console.warn,
+        error: console.error
+      };
+      DEFAULT_SETTINGS2 = {
+        enabled: true,
+        level: 0
+      };
+      cache2 = {};
+      ONCE2 = {
+        once: true
+      };
+      Log2 = class {
+        constructor() {
+          let {
+            id
+          } = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {
+            id: ""
+          };
+          _defineProperty(this, "id", void 0);
+          _defineProperty(this, "VERSION", VERSION4);
+          _defineProperty(this, "_startTs", getHiResTimestamp4());
+          _defineProperty(this, "_deltaTs", getHiResTimestamp4());
+          _defineProperty(this, "_storage", void 0);
+          _defineProperty(this, "userData", {});
+          _defineProperty(this, "LOG_THROTTLE_TIMEOUT", 0);
+          this.id = id;
+          this._storage = new LocalStorage2("__probe-".concat(this.id, "__"), DEFAULT_SETTINGS2);
+          this.userData = {};
+          this.timeStamp("".concat(this.id, " started"));
+          autobind2(this);
+          Object.seal(this);
+        }
+        set level(newLevel) {
+          this.setLevel(newLevel);
+        }
+        get level() {
+          return this.getLevel();
+        }
+        isEnabled() {
+          return this._storage.config.enabled;
+        }
+        getLevel() {
+          return this._storage.config.level;
+        }
+        getTotal() {
+          return Number((getHiResTimestamp4() - this._startTs).toPrecision(10));
+        }
+        getDelta() {
+          return Number((getHiResTimestamp4() - this._deltaTs).toPrecision(10));
+        }
+        set priority(newPriority) {
+          this.level = newPriority;
+        }
+        get priority() {
+          return this.level;
+        }
+        getPriority() {
+          return this.level;
+        }
+        enable() {
+          let enabled = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : true;
+          this._storage.updateConfiguration({
+            enabled
+          });
+          return this;
+        }
+        setLevel(level) {
+          this._storage.updateConfiguration({
+            level
+          });
+          return this;
+        }
+        get(setting) {
+          return this._storage.config[setting];
+        }
+        set(setting, value) {
+          this._storage.updateConfiguration({
+            [setting]: value
+          });
+        }
+        settings() {
+          if (console.table) {
+            console.table(this._storage.config);
+          } else {
+            console.log(this._storage.config);
+          }
+        }
+        assert(condition, message) {
+          assert4(condition, message);
+        }
+        warn(message) {
+          return this._getLogFunction(0, message, originalConsole2.warn, arguments, ONCE2);
+        }
+        error(message) {
+          return this._getLogFunction(0, message, originalConsole2.error, arguments);
+        }
+        deprecated(oldUsage, newUsage) {
+          return this.warn("`".concat(oldUsage, "` is deprecated and will be removed in a later version. Use `").concat(newUsage, "` instead"));
+        }
+        removed(oldUsage, newUsage) {
+          return this.error("`".concat(oldUsage, "` has been removed. Use `").concat(newUsage, "` instead"));
+        }
+        probe(logLevel, message) {
+          return this._getLogFunction(logLevel, message, originalConsole2.log, arguments, {
+            time: true,
+            once: true
+          });
+        }
+        log(logLevel, message) {
+          return this._getLogFunction(logLevel, message, originalConsole2.debug, arguments);
+        }
+        info(logLevel, message) {
+          return this._getLogFunction(logLevel, message, console.info, arguments);
+        }
+        once(logLevel, message) {
+          for (var _len = arguments.length, args = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
+            args[_key - 2] = arguments[_key];
+          }
+          return this._getLogFunction(logLevel, message, originalConsole2.debug || originalConsole2.info, arguments, ONCE2);
+        }
+        table(logLevel, table, columns) {
+          if (table) {
+            return this._getLogFunction(logLevel, table, console.table || noop2, columns && [columns], {
+              tag: getTableHeader2(table)
+            });
+          }
+          return noop2;
+        }
+        image(_ref) {
+          let {
+            logLevel,
+            priority,
+            image,
+            message = "",
+            scale = 1
+          } = _ref;
+          if (!this._shouldLog(logLevel || priority)) {
+            return noop2;
+          }
+          return isBrowser5 ? logImageInBrowser2({
+            image,
+            message,
+            scale
+          }) : logImageInNode2({
+            image,
+            message,
+            scale
+          });
+        }
+        time(logLevel, message) {
+          return this._getLogFunction(logLevel, message, console.time ? console.time : console.info);
+        }
+        timeEnd(logLevel, message) {
+          return this._getLogFunction(logLevel, message, console.timeEnd ? console.timeEnd : console.info);
+        }
+        timeStamp(logLevel, message) {
+          return this._getLogFunction(logLevel, message, console.timeStamp || noop2);
+        }
+        group(logLevel, message) {
+          let opts = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {
+            collapsed: false
+          };
+          const options = normalizeArguments2({
+            logLevel,
+            message,
+            opts
+          });
+          const {
+            collapsed
+          } = opts;
+          options.method = (collapsed ? console.groupCollapsed : console.group) || console.info;
+          return this._getLogFunction(options);
+        }
+        groupCollapsed(logLevel, message) {
+          let opts = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+          return this.group(logLevel, message, Object.assign({}, opts, {
+            collapsed: true
+          }));
+        }
+        groupEnd(logLevel) {
+          return this._getLogFunction(logLevel, "", console.groupEnd || noop2);
+        }
+        withGroup(logLevel, message, func) {
+          this.group(logLevel, message)();
+          try {
+            func();
+          } finally {
+            this.groupEnd(logLevel)();
+          }
+        }
+        trace() {
+          if (console.trace) {
+            console.trace();
+          }
+        }
+        _shouldLog(logLevel) {
+          return this.isEnabled() && this.getLevel() >= normalizeLogLevel2(logLevel);
+        }
+        _getLogFunction(logLevel, message, method, args, opts) {
+          if (this._shouldLog(logLevel)) {
+            opts = normalizeArguments2({
+              logLevel,
+              message,
+              args,
+              opts
+            });
+            method = method || opts.method;
+            assert4(method);
+            opts.total = this.getTotal();
+            opts.delta = this.getDelta();
+            this._deltaTs = getHiResTimestamp4();
+            const tag = opts.tag || opts.message;
+            if (opts.once) {
+              if (!cache2[tag]) {
+                cache2[tag] = getHiResTimestamp4();
+              } else {
+                return noop2;
+              }
+            }
+            message = decorateMessage2(this.id, opts.message, opts);
+            return method.bind(console, message, ...opts.args);
+          }
+          return noop2;
+        }
+      };
+      _defineProperty(Log2, "VERSION", VERSION4);
+    }
+  });
+
+  // ../../node_modules/@probe.gl/log/dist/esm/index.js
+  var esm_default2;
+  var init_esm5 = __esm({
+    "../../node_modules/@probe.gl/log/dist/esm/index.js"() {
+      init_log2();
+      init_log2();
+      esm_default2 = new Log2({
+        id: "@probe.gl/log"
+      });
+    }
+  });
+
+  // src/lib/utils/log.ts
+  var log;
+  var init_log3 = __esm({
+    "src/lib/utils/log.ts"() {
+      init_esm5();
+      log = new Log2({ id: "loaders.gl" });
+    }
+  });
+
   // src/lib/api/select-loader.ts
   async function selectLoader(data, loaders = [], options, context) {
     if (!validHTTPResponse(data)) {
@@ -2396,13 +3028,22 @@
     const { url, type } = getResourceUrlAndType(data);
     const testUrl = url || context?.url;
     let loader = null;
+    let reason = "";
     if (options?.mimeType) {
       loader = findLoaderByMIMEType(loaders, options?.mimeType);
+      reason = `match forced by supplied MIME type ${options?.mimeType}`;
     }
     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)}` : "");
     loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);
+    reason = reason || (loader ? `matched fallback MIME type ${type}` : "");
+    if (reason) {
+      log.log(1, `selectLoader selected ${loader?.name}: ${reason}.`);
+    }
     return loader;
   }
   function validHTTPResponse(data) {
@@ -2529,6 +3170,7 @@
     "src/lib/api/select-loader.ts"() {
       init_src2();
       init_normalize_loader();
+      init_log3();
       init_resource_utils();
       init_register_loaders();
       init_is_type();
@@ -3148,15 +3790,15 @@
   });
 
   // src/null-loader.ts
-  var VERSION4, NullWorkerLoader, NullLoader;
+  var VERSION5, NullWorkerLoader, NullLoader;
   var init_null_loader = __esm({
     "src/null-loader.ts"() {
-      VERSION4 = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
+      VERSION5 = typeof __VERSION__ !== "undefined" ? __VERSION__ : "latest";
       NullWorkerLoader = {
         name: "Null loader",
         id: "null",
         module: "core",
-        version: VERSION4,
+        version: VERSION5,
         worker: true,
         mimeTypes: ["application/x.empty"],
         extensions: ["null"],
@@ -3169,7 +3811,7 @@
         name: "Null loader",
         id: "null",
         module: "core",
-        version: VERSION4,
+        version: VERSION5,
         mimeTypes: ["application/x.empty"],
         extensions: ["null"],
         parse: async (arrayBuffer) => arrayBuffer,

package/dist/es5/lib/api/select-loader.js

@@ -22,6 +22,8 @@ var _loaderUtils = require("@loaders.gl/loader-utils");
 
 var _normalizeLoader = require("../loader-utils/normalize-loader");
 
+var _log = require("../utils/log");
+
 var _resourceUtils = require("../utils/resource-utils");
 
 var _registerLoaders = require("./register-loaders");
@@ -154,15 +156,28 @@ function selectLoaderInternal(data, loaders, options, context) {
 
   var testUrl = url || (context === null || context === void 0 ? void 0 : context.url);
   var loader = null;
+  var reason = '';
 
   if (options !== null && options !== void 0 && options.mimeType) {
     loader = findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.mimeType);
+    reason = "match forced by supplied MIME type ".concat(options === null || options === void 0 ? void 0 : options.mimeType);
   }
 
   loader = loader || findLoaderByUrl(loaders, testUrl);
+  reason = reason || (loader ? "matched url ".concat(testUrl) : '');
   loader = loader || findLoaderByMIMEType(loaders, type);
+  reason = reason || (loader ? "matched MIME type ".concat(type) : '');
   loader = loader || findLoaderByInitialBytes(loaders, data);
+  reason = reason || (loader ? "matched initial data ".concat(getFirstCharacters(data)) : '');
   loader = loader || findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.fallbackMimeType);
+  reason = reason || (loader ? "matched fallback MIME type ".concat(type) : '');
+
+  if (reason) {
+    var _loader;
+
+    _log.log.log(1, "selectLoader selected ".concat((_loader = loader) === null || _loader === void 0 ? void 0 : _loader.name, ": ").concat(reason, "."));
+  }
+
   return loader;
 }
 

package/dist/es5/lib/api/select-loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/api/select-loader.ts"],"names":["EXT_PATTERN","selectLoader","data","loaders","options","context","validHTTPResponse","loader","selectLoaderSync","nothrow","slice","arrayBuffer","Error","getNoValidLoaderMessage","Array","isArray","candidateLoaders","concat","ignoreRegisteredLoaders","push","normalizeLoaders","selectLoaderInternal","url","type","testUrl","mimeType","findLoaderByMIMEType","findLoaderByUrl","findLoaderByInitialBytes","fallbackMimeType","Response","status","message","path","filename","firstCharacters","getFirstCharacters","match","exec","extension","findLoaderByExtension","toLowerCase","extensions","loaderExtension","mimeTypes","includes","id","testDataAgainstText","ArrayBuffer","isView","testDataAgainstBinary","buffer","byteOffset","testText","tests","some","test","startsWith","testBinary","byteLength","magic","getMagicString","length","dataView","DataView","i","String","fromCharCode","getUint8"],"mappings":"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","sourcesContent":["import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-utils';\nimport {compareArrayBuffers, path} from '@loaders.gl/loader-utils';\nimport {normalizeLoader} from '../loader-utils/normalize-loader';\nimport {getResourceUrlAndType} from '../utils/resource-utils';\nimport {getRegisteredLoaders} from './register-loaders';\nimport {isBlob} from '../../javascript-utils/is-type';\n\nconst EXT_PATTERN = /\\.([^.]+)$/;\n\n// TODO - Need a variant that peeks at streams for parseInBatches\n// TODO - Detect multiple matching loaders? Use heuristics to grade matches?\n// TODO - Allow apps to pass context to disambiguate between multiple matches (e.g. multiple .json formats)?\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport async function selectLoader(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Promise<Loader | null> {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // First make a sync attempt, disabling exceptions\n  let loader = selectLoaderSync(data, loaders, {...options, nothrow: true}, context);\n  if (loader) {\n    return loader;\n  }\n\n  // For Blobs and Files, try to asynchronously read a small initial slice and test again with that\n  // to see if we can detect by initial content\n  if (isBlob(data)) {\n    data = await (data as Blob).slice(0, 10).arrayBuffer();\n    loader = selectLoaderSync(data, loaders, options, context);\n  }\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport function selectLoaderSync(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Loader | null {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // eslint-disable-next-line complexity\n  // if only a single loader was provided (not as array), force its use\n  // TODO - Should this behavior be kept and documented?\n  if (loaders && !Array.isArray(loaders)) {\n    // TODO - remove support for legacy loaders\n    return normalizeLoader(loaders);\n  }\n\n  // Build list of candidate loaders that will be searched in order for a match\n  let candidateLoaders: Loader[] = [];\n  // First search supplied loaders\n  if (loaders) {\n    candidateLoaders = candidateLoaders.concat(loaders);\n  }\n  // Then fall back to registered loaders\n  if (!options?.ignoreRegisteredLoaders) {\n    candidateLoaders.push(...getRegisteredLoaders());\n  }\n\n  // TODO - remove support for legacy loaders\n  normalizeLoaders(candidateLoaders);\n\n  const loader = selectLoaderInternal(data, candidateLoaders, options, context);\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/** Implements loaders selection logic */\nfunction selectLoaderInternal(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[],\n  options?: LoaderOptions,\n  context?: LoaderContext\n) {\n  const {url, type} = getResourceUrlAndType(data);\n\n  const testUrl = url || context?.url;\n\n  let loader: Loader | null = null;\n\n  // if options.mimeType is supplied, it takes precedence\n  if (options?.mimeType) {\n    loader = findLoaderByMIMEType(loaders, options?.mimeType);\n  }\n  // Look up loader by url\n  loader = loader || findLoaderByUrl(loaders, testUrl);\n  // Look up loader by mime type\n  loader = loader || findLoaderByMIMEType(loaders, type);\n  // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)\n  loader = loader || findLoaderByInitialBytes(loaders, data);\n  // Look up loader by fallback mime type\n  loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);\n\n  return loader;\n}\n\n/** Check HTTP Response */\nfunction validHTTPResponse(data: any): boolean {\n  // HANDLE HTTP status\n  if (data instanceof Response) {\n    // 204 - NO CONTENT. This handles cases where e.g. a tile server responds with 204 for a missing tile\n    if (data.status === 204) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Generate a helpful message to help explain why loader selection failed. */\nfunction getNoValidLoaderMessage(data): string {\n  const {url, type} = getResourceUrlAndType(data);\n\n  let message = 'No valid loader found (';\n  message += url ? `${path.filename(url)}, ` : 'no url provided, ';\n  message += `MIME type: ${type ? `\"${type}\"` : 'not provided'}, `;\n  // First characters are only accessible when called on data (string or arrayBuffer).\n  const firstCharacters: string = data ? getFirstCharacters(data) : '';\n  message += firstCharacters ? ` first bytes: \"${firstCharacters}\"` : 'first bytes: not available';\n  message += ')';\n  return message;\n}\n\nfunction normalizeLoaders(loaders: Loader[]): void {\n  for (const loader of loaders) {\n    normalizeLoader(loader);\n  }\n}\n\n// TODO - Would be nice to support http://example.com/file.glb?parameter=1\n// E.g: x = new URL('http://example.com/file.glb?load=1'; x.pathname\nfunction findLoaderByUrl(loaders: Loader[], url?: string): Loader | null {\n  // Get extension\n  const match = url && EXT_PATTERN.exec(url);\n  const extension = match && match[1];\n  return extension ? findLoaderByExtension(loaders, extension) : null;\n}\n\nfunction findLoaderByExtension(loaders: Loader[], extension: string): Loader | null {\n  extension = extension.toLowerCase();\n\n  for (const loader of loaders) {\n    for (const loaderExtension of loader.extensions) {\n      if (loaderExtension.toLowerCase() === extension) {\n        return loader;\n      }\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByMIMEType(loaders, mimeType) {\n  for (const loader of loaders) {\n    if (loader.mimeTypes && loader.mimeTypes.includes(mimeType)) {\n      return loader;\n    }\n\n    // Support referring to loaders using the \"unregistered tree\"\n    // https://en.wikipedia.org/wiki/Media_type#Unregistered_tree\n    if (mimeType === `application/x.${loader.id}`) {\n      return loader;\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByInitialBytes(loaders, data) {\n  if (!data) {\n    return null;\n  }\n\n  for (const loader of loaders) {\n    if (typeof data === 'string') {\n      if (testDataAgainstText(data, loader)) {\n        return loader;\n      }\n    } else if (ArrayBuffer.isView(data)) {\n      // Typed Arrays can have offsets into underlying buffer\n      if (testDataAgainstBinary(data.buffer, data.byteOffset, loader)) {\n        return loader;\n      }\n    } else if (data instanceof ArrayBuffer) {\n      const byteOffset = 0;\n      if (testDataAgainstBinary(data, byteOffset, loader)) {\n        return loader;\n      }\n    }\n    // TODO Handle streaming case (requires creating a new AsyncIterator)\n  }\n  return null;\n}\n\nfunction testDataAgainstText(data, loader) {\n  if (loader.testText) {\n    return loader.testText(data);\n  }\n\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => data.startsWith(test));\n}\n\nfunction testDataAgainstBinary(data, byteOffset, loader) {\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => testBinary(data, byteOffset, loader, test));\n}\n\nfunction testBinary(data, byteOffset, loader, test) {\n  if (test instanceof ArrayBuffer) {\n    return compareArrayBuffers(test, data, test.byteLength);\n  }\n  switch (typeof test) {\n    case 'function':\n      return test(data, loader);\n\n    case 'string':\n      // Magic bytes check: If `test` is a string, check if binary data starts with that strings\n      const magic = getMagicString(data, byteOffset, test.length);\n      return test === magic;\n\n    default:\n      return false;\n  }\n}\n\nfunction getFirstCharacters(data, length: number = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    // Typed Arrays can have offsets into underlying buffer\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n  return '';\n}\n\nfunction getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength < byteOffset + length) {\n    return '';\n  }\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n  return magic;\n}\n"],"file":"select-loader.js"}
+{"version":3,"sources":["../../../../src/lib/api/select-loader.ts"],"names":["EXT_PATTERN","selectLoader","data","loaders","options","context","validHTTPResponse","loader","selectLoaderSync","nothrow","slice","arrayBuffer","Error","getNoValidLoaderMessage","Array","isArray","candidateLoaders","concat","ignoreRegisteredLoaders","push","normalizeLoaders","selectLoaderInternal","url","type","testUrl","reason","mimeType","findLoaderByMIMEType","findLoaderByUrl","findLoaderByInitialBytes","getFirstCharacters","fallbackMimeType","log","name","Response","status","message","path","filename","firstCharacters","match","exec","extension","findLoaderByExtension","toLowerCase","extensions","loaderExtension","mimeTypes","includes","id","testDataAgainstText","ArrayBuffer","isView","testDataAgainstBinary","buffer","byteOffset","testText","tests","some","test","startsWith","testBinary","byteLength","magic","getMagicString","length","dataView","DataView","i","String","fromCharCode","getUint8"],"mappings":"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","sourcesContent":["import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-utils';\nimport {compareArrayBuffers, path} from '@loaders.gl/loader-utils';\nimport {normalizeLoader} from '../loader-utils/normalize-loader';\nimport {log} from '../utils/log';\nimport {getResourceUrlAndType} from '../utils/resource-utils';\nimport {getRegisteredLoaders} from './register-loaders';\nimport {isBlob} from '../../javascript-utils/is-type';\n\nconst EXT_PATTERN = /\\.([^.]+)$/;\n\n// TODO - Need a variant that peeks at streams for parseInBatches\n// TODO - Detect multiple matching loaders? Use heuristics to grade matches?\n// TODO - Allow apps to pass context to disambiguate between multiple matches (e.g. multiple .json formats)?\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport async function selectLoader(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Promise<Loader | null> {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // First make a sync attempt, disabling exceptions\n  let loader = selectLoaderSync(data, loaders, {...options, nothrow: true}, context);\n  if (loader) {\n    return loader;\n  }\n\n  // For Blobs and Files, try to asynchronously read a small initial slice and test again with that\n  // to see if we can detect by initial content\n  if (isBlob(data)) {\n    data = await (data as Blob).slice(0, 10).arrayBuffer();\n    loader = selectLoaderSync(data, loaders, options, context);\n  }\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport function selectLoaderSync(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Loader | null {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // eslint-disable-next-line complexity\n  // if only a single loader was provided (not as array), force its use\n  // TODO - Should this behavior be kept and documented?\n  if (loaders && !Array.isArray(loaders)) {\n    // TODO - remove support for legacy loaders\n    return normalizeLoader(loaders);\n  }\n\n  // Build list of candidate loaders that will be searched in order for a match\n  let candidateLoaders: Loader[] = [];\n  // First search supplied loaders\n  if (loaders) {\n    candidateLoaders = candidateLoaders.concat(loaders);\n  }\n  // Then fall back to registered loaders\n  if (!options?.ignoreRegisteredLoaders) {\n    candidateLoaders.push(...getRegisteredLoaders());\n  }\n\n  // TODO - remove support for legacy loaders\n  normalizeLoaders(candidateLoaders);\n\n  const loader = selectLoaderInternal(data, candidateLoaders, options, context);\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/** Implements loaders selection logic */\nfunction selectLoaderInternal(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[],\n  options?: LoaderOptions,\n  context?: LoaderContext\n) {\n  const {url, type} = getResourceUrlAndType(data);\n\n  const testUrl = url || context?.url;\n\n  let loader: Loader | null = null;\n  let reason: string = '';\n\n  // if options.mimeType is supplied, it takes precedence\n  if (options?.mimeType) {\n    loader = findLoaderByMIMEType(loaders, options?.mimeType);\n    reason = `match forced by supplied MIME type ${options?.mimeType}`;\n  }\n\n  // Look up loader by url\n  loader = loader || findLoaderByUrl(loaders, testUrl);\n  reason = reason || (loader ? `matched url ${testUrl}` : '');\n\n  // Look up loader by mime type\n  loader = loader || findLoaderByMIMEType(loaders, type);\n  reason = reason || (loader ? `matched MIME type ${type}` : '');\n\n  // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)\n  loader = loader || findLoaderByInitialBytes(loaders, data);\n  reason = reason || (loader ? `matched initial data ${getFirstCharacters(data)}` : '');\n\n  // Look up loader by fallback mime type\n  loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);\n  reason = reason || (loader ? `matched fallback MIME type ${type}` : '');\n\n  if (reason) {\n    log.log(1, `selectLoader selected ${loader?.name}: ${reason}.`);\n  }\n\n  return loader;\n}\n\n/** Check HTTP Response */\nfunction validHTTPResponse(data: any): boolean {\n  // HANDLE HTTP status\n  if (data instanceof Response) {\n    // 204 - NO CONTENT. This handles cases where e.g. a tile server responds with 204 for a missing tile\n    if (data.status === 204) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Generate a helpful message to help explain why loader selection failed. */\nfunction getNoValidLoaderMessage(data): string {\n  const {url, type} = getResourceUrlAndType(data);\n\n  let message = 'No valid loader found (';\n  message += url ? `${path.filename(url)}, ` : 'no url provided, ';\n  message += `MIME type: ${type ? `\"${type}\"` : 'not provided'}, `;\n  // First characters are only accessible when called on data (string or arrayBuffer).\n  const firstCharacters: string = data ? getFirstCharacters(data) : '';\n  message += firstCharacters ? ` first bytes: \"${firstCharacters}\"` : 'first bytes: not available';\n  message += ')';\n  return message;\n}\n\nfunction normalizeLoaders(loaders: Loader[]): void {\n  for (const loader of loaders) {\n    normalizeLoader(loader);\n  }\n}\n\n// TODO - Would be nice to support http://example.com/file.glb?parameter=1\n// E.g: x = new URL('http://example.com/file.glb?load=1'; x.pathname\nfunction findLoaderByUrl(loaders: Loader[], url?: string): Loader | null {\n  // Get extension\n  const match = url && EXT_PATTERN.exec(url);\n  const extension = match && match[1];\n  return extension ? findLoaderByExtension(loaders, extension) : null;\n}\n\nfunction findLoaderByExtension(loaders: Loader[], extension: string): Loader | null {\n  extension = extension.toLowerCase();\n\n  for (const loader of loaders) {\n    for (const loaderExtension of loader.extensions) {\n      if (loaderExtension.toLowerCase() === extension) {\n        return loader;\n      }\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByMIMEType(loaders, mimeType) {\n  for (const loader of loaders) {\n    if (loader.mimeTypes && loader.mimeTypes.includes(mimeType)) {\n      return loader;\n    }\n\n    // Support referring to loaders using the \"unregistered tree\"\n    // https://en.wikipedia.org/wiki/Media_type#Unregistered_tree\n    if (mimeType === `application/x.${loader.id}`) {\n      return loader;\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByInitialBytes(loaders, data) {\n  if (!data) {\n    return null;\n  }\n\n  for (const loader of loaders) {\n    if (typeof data === 'string') {\n      if (testDataAgainstText(data, loader)) {\n        return loader;\n      }\n    } else if (ArrayBuffer.isView(data)) {\n      // Typed Arrays can have offsets into underlying buffer\n      if (testDataAgainstBinary(data.buffer, data.byteOffset, loader)) {\n        return loader;\n      }\n    } else if (data instanceof ArrayBuffer) {\n      const byteOffset = 0;\n      if (testDataAgainstBinary(data, byteOffset, loader)) {\n        return loader;\n      }\n    }\n    // TODO Handle streaming case (requires creating a new AsyncIterator)\n  }\n  return null;\n}\n\nfunction testDataAgainstText(data, loader) {\n  if (loader.testText) {\n    return loader.testText(data);\n  }\n\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => data.startsWith(test));\n}\n\nfunction testDataAgainstBinary(data, byteOffset, loader) {\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => testBinary(data, byteOffset, loader, test));\n}\n\nfunction testBinary(data, byteOffset, loader, test) {\n  if (test instanceof ArrayBuffer) {\n    return compareArrayBuffers(test, data, test.byteLength);\n  }\n  switch (typeof test) {\n    case 'function':\n      return test(data, loader);\n\n    case 'string':\n      // Magic bytes check: If `test` is a string, check if binary data starts with that strings\n      const magic = getMagicString(data, byteOffset, test.length);\n      return test === magic;\n\n    default:\n      return false;\n  }\n}\n\nfunction getFirstCharacters(data, length: number = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    // Typed Arrays can have offsets into underlying buffer\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n  return '';\n}\n\nfunction getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength < byteOffset + length) {\n    return '';\n  }\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n  return magic;\n}\n"],"file":"select-loader.js"}

package/dist/es5/lib/init.js

@@ -4,10 +4,20 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var version = typeof "3.1.4" !== 'undefined' ? "3.1.4" : '';
-globalThis.loaders = Object.assign(globalThis.loaders || {}, {
-  VERSION: version
-});
+
+var _log = require("./utils/log");
+
+var version = typeof "3.1.8" !== 'undefined' ? "3.1.8" : '';
+
+if (!globalThis.loaders) {
+  _log.log.log(1, "loaders.gl ".concat(version))();
+
+  globalThis.loaders = Object.assign(globalThis.loaders || {}, {
+    VERSION: version,
+    log: _log.log
+  });
+}
+
 var _default = globalThis.loaders;
 exports.default = _default;
 //# sourceMappingURL=init.js.map

package/dist/es5/lib/init.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/init.ts"],"names":["version","globalThis","loaders","Object","assign","VERSION"],"mappings":";;;;;;AACA,IAAMA,OAAO,GAAG,mBAAuB,WAAvB,aAAmD,EAAnE;AAGAC,UAAU,CAACC,OAAX,GAAqBC,MAAM,CAACC,MAAP,CAAcH,UAAU,CAACC,OAAX,IAAsB,EAApC,EAAwC;AAC3DG,EAAAA,OAAO,EAAEL;AADkD,CAAxC,CAArB;eAKeC,UAAU,CAACC,O","sourcesContent":["// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : '';\n\n// @ts-ignore\nglobalThis.loaders = Object.assign(globalThis.loaders || {}, {\n  VERSION: version\n});\n\n// @ts-ignore\nexport default globalThis.loaders;\n"],"file":"init.js"}
+{"version":3,"sources":["../../../src/lib/init.ts"],"names":["version","globalThis","loaders","log","Object","assign","VERSION"],"mappings":";;;;;;;AACA;;AAGA,IAAMA,OAAO,GAAG,mBAAuB,WAAvB,aAAmD,EAAnE;;AAGA,IAAI,CAACC,UAAU,CAACC,OAAhB,EAAyB;AACvBC,WAAIA,GAAJ,CAAQ,CAAR,uBAAyBH,OAAzB;;AAEAC,EAAAA,UAAU,CAACC,OAAX,GAAqBE,MAAM,CAACC,MAAP,CAAcJ,UAAU,CAACC,OAAX,IAAsB,EAApC,EAAwC;AAC3DI,IAAAA,OAAO,EAAEN,OADkD;AAE3DG,IAAAA,GAAG,EAAHA;AAF2D,GAAxC,CAArB;AAID;;eAEcF,UAAU,CAACC,O","sourcesContent":["// loaders.gl, MIT license\nimport {log} from './utils/log';\n\n// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : '';\n\n// @ts-ignore\nif (!globalThis.loaders) {\n  log.log(1, `loaders.gl ${version}`)();\n\n  globalThis.loaders = Object.assign(globalThis.loaders || {}, {\n    VERSION: version,\n    log\n  });\n}\n// @ts-ignore\nexport default globalThis.loaders;\n"],"file":"init.js"}

package/dist/es5/lib/utils/log.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.log = void 0;
+
+var _log = require("@probe.gl/log");
+
+var log = new _log.Log({
+  id: 'loaders.gl'
+});
+exports.log = log;
+//# sourceMappingURL=log.js.map

package/dist/es5/lib/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/utils/log.ts"],"names":["log","Log","id"],"mappings":";;;;;;;AACA;;AAEO,IAAMA,GAAG,GAAG,IAAIC,QAAJ,CAAQ;AAACC,EAAAA,EAAE,EAAE;AAAL,CAAR,CAAZ","sourcesContent":["// loaders.gl, MIT license\nimport {Log} from '@probe.gl/log';\n\nexport const log = new Log({id: 'loaders.gl'});\n"],"file":"log.js"}

package/dist/es5/null-loader.js

@@ -17,7 +17,7 @@ var _wrapAsyncGenerator2 = _interopRequireDefault(require("@babel/runtime/helper
 
 var _asyncIterator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncIterator"));
 
-var VERSION = typeof "3.1.4" !== 'undefined' ? "3.1.4" : 'latest';
+var VERSION = typeof "3.1.8" !== 'undefined' ? "3.1.8" : 'latest';
 var NullWorkerLoader = {
   name: 'Null loader',
   id: 'null',

package/dist/esm/lib/api/select-loader.js

@@ -1,5 +1,6 @@
 import { compareArrayBuffers, path } from '@loaders.gl/loader-utils';
 import { normalizeLoader } from '../loader-utils/normalize-loader';
+import { log } from '../utils/log';
 import { getResourceUrlAndType } from '../utils/resource-utils';
 import { getRegisteredLoaders } from './register-loaders';
 import { isBlob } from '../../javascript-utils/is-type';
@@ -64,15 +65,28 @@ function selectLoaderInternal(data, loaders, options, context) {
   } = getResourceUrlAndType(data);
   const testUrl = url || (context === null || context === void 0 ? void 0 : context.url);
   let loader = null;
+  let reason = '';
 
   if (options !== null && options !== void 0 && options.mimeType) {
     loader = findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.mimeType);
+    reason = "match forced by supplied MIME type ".concat(options === null || options === void 0 ? void 0 : options.mimeType);
   }
 
   loader = loader || findLoaderByUrl(loaders, testUrl);
+  reason = reason || (loader ? "matched url ".concat(testUrl) : '');
   loader = loader || findLoaderByMIMEType(loaders, type);
+  reason = reason || (loader ? "matched MIME type ".concat(type) : '');
   loader = loader || findLoaderByInitialBytes(loaders, data);
+  reason = reason || (loader ? "matched initial data ".concat(getFirstCharacters(data)) : '');
   loader = loader || findLoaderByMIMEType(loaders, options === null || options === void 0 ? void 0 : options.fallbackMimeType);
+  reason = reason || (loader ? "matched fallback MIME type ".concat(type) : '');
+
+  if (reason) {
+    var _loader;
+
+    log.log(1, "selectLoader selected ".concat((_loader = loader) === null || _loader === void 0 ? void 0 : _loader.name, ": ").concat(reason, "."));
+  }
+
   return loader;
 }
 

package/dist/esm/lib/api/select-loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/api/select-loader.ts"],"names":["compareArrayBuffers","path","normalizeLoader","getResourceUrlAndType","getRegisteredLoaders","isBlob","EXT_PATTERN","selectLoader","data","loaders","options","context","validHTTPResponse","loader","selectLoaderSync","nothrow","slice","arrayBuffer","Error","getNoValidLoaderMessage","Array","isArray","candidateLoaders","concat","ignoreRegisteredLoaders","push","normalizeLoaders","selectLoaderInternal","url","type","testUrl","mimeType","findLoaderByMIMEType","findLoaderByUrl","findLoaderByInitialBytes","fallbackMimeType","Response","status","message","filename","firstCharacters","getFirstCharacters","match","exec","extension","findLoaderByExtension","toLowerCase","loaderExtension","extensions","mimeTypes","includes","id","testDataAgainstText","ArrayBuffer","isView","testDataAgainstBinary","buffer","byteOffset","testText","tests","some","test","startsWith","testBinary","byteLength","magic","getMagicString","length","dataView","DataView","i","String","fromCharCode","getUint8"],"mappings":"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","sourcesContent":["import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-utils';\nimport {compareArrayBuffers, path} from '@loaders.gl/loader-utils';\nimport {normalizeLoader} from '../loader-utils/normalize-loader';\nimport {getResourceUrlAndType} from '../utils/resource-utils';\nimport {getRegisteredLoaders} from './register-loaders';\nimport {isBlob} from '../../javascript-utils/is-type';\n\nconst EXT_PATTERN = /\\.([^.]+)$/;\n\n// TODO - Need a variant that peeks at streams for parseInBatches\n// TODO - Detect multiple matching loaders? Use heuristics to grade matches?\n// TODO - Allow apps to pass context to disambiguate between multiple matches (e.g. multiple .json formats)?\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport async function selectLoader(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Promise<Loader | null> {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // First make a sync attempt, disabling exceptions\n  let loader = selectLoaderSync(data, loaders, {...options, nothrow: true}, context);\n  if (loader) {\n    return loader;\n  }\n\n  // For Blobs and Files, try to asynchronously read a small initial slice and test again with that\n  // to see if we can detect by initial content\n  if (isBlob(data)) {\n    data = await (data as Blob).slice(0, 10).arrayBuffer();\n    loader = selectLoaderSync(data, loaders, options, context);\n  }\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport function selectLoaderSync(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Loader | null {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // eslint-disable-next-line complexity\n  // if only a single loader was provided (not as array), force its use\n  // TODO - Should this behavior be kept and documented?\n  if (loaders && !Array.isArray(loaders)) {\n    // TODO - remove support for legacy loaders\n    return normalizeLoader(loaders);\n  }\n\n  // Build list of candidate loaders that will be searched in order for a match\n  let candidateLoaders: Loader[] = [];\n  // First search supplied loaders\n  if (loaders) {\n    candidateLoaders = candidateLoaders.concat(loaders);\n  }\n  // Then fall back to registered loaders\n  if (!options?.ignoreRegisteredLoaders) {\n    candidateLoaders.push(...getRegisteredLoaders());\n  }\n\n  // TODO - remove support for legacy loaders\n  normalizeLoaders(candidateLoaders);\n\n  const loader = selectLoaderInternal(data, candidateLoaders, options, context);\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/** Implements loaders selection logic */\nfunction selectLoaderInternal(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[],\n  options?: LoaderOptions,\n  context?: LoaderContext\n) {\n  const {url, type} = getResourceUrlAndType(data);\n\n  const testUrl = url || context?.url;\n\n  let loader: Loader | null = null;\n\n  // if options.mimeType is supplied, it takes precedence\n  if (options?.mimeType) {\n    loader = findLoaderByMIMEType(loaders, options?.mimeType);\n  }\n  // Look up loader by url\n  loader = loader || findLoaderByUrl(loaders, testUrl);\n  // Look up loader by mime type\n  loader = loader || findLoaderByMIMEType(loaders, type);\n  // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)\n  loader = loader || findLoaderByInitialBytes(loaders, data);\n  // Look up loader by fallback mime type\n  loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);\n\n  return loader;\n}\n\n/** Check HTTP Response */\nfunction validHTTPResponse(data: any): boolean {\n  // HANDLE HTTP status\n  if (data instanceof Response) {\n    // 204 - NO CONTENT. This handles cases where e.g. a tile server responds with 204 for a missing tile\n    if (data.status === 204) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Generate a helpful message to help explain why loader selection failed. */\nfunction getNoValidLoaderMessage(data): string {\n  const {url, type} = getResourceUrlAndType(data);\n\n  let message = 'No valid loader found (';\n  message += url ? `${path.filename(url)}, ` : 'no url provided, ';\n  message += `MIME type: ${type ? `\"${type}\"` : 'not provided'}, `;\n  // First characters are only accessible when called on data (string or arrayBuffer).\n  const firstCharacters: string = data ? getFirstCharacters(data) : '';\n  message += firstCharacters ? ` first bytes: \"${firstCharacters}\"` : 'first bytes: not available';\n  message += ')';\n  return message;\n}\n\nfunction normalizeLoaders(loaders: Loader[]): void {\n  for (const loader of loaders) {\n    normalizeLoader(loader);\n  }\n}\n\n// TODO - Would be nice to support http://example.com/file.glb?parameter=1\n// E.g: x = new URL('http://example.com/file.glb?load=1'; x.pathname\nfunction findLoaderByUrl(loaders: Loader[], url?: string): Loader | null {\n  // Get extension\n  const match = url && EXT_PATTERN.exec(url);\n  const extension = match && match[1];\n  return extension ? findLoaderByExtension(loaders, extension) : null;\n}\n\nfunction findLoaderByExtension(loaders: Loader[], extension: string): Loader | null {\n  extension = extension.toLowerCase();\n\n  for (const loader of loaders) {\n    for (const loaderExtension of loader.extensions) {\n      if (loaderExtension.toLowerCase() === extension) {\n        return loader;\n      }\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByMIMEType(loaders, mimeType) {\n  for (const loader of loaders) {\n    if (loader.mimeTypes && loader.mimeTypes.includes(mimeType)) {\n      return loader;\n    }\n\n    // Support referring to loaders using the \"unregistered tree\"\n    // https://en.wikipedia.org/wiki/Media_type#Unregistered_tree\n    if (mimeType === `application/x.${loader.id}`) {\n      return loader;\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByInitialBytes(loaders, data) {\n  if (!data) {\n    return null;\n  }\n\n  for (const loader of loaders) {\n    if (typeof data === 'string') {\n      if (testDataAgainstText(data, loader)) {\n        return loader;\n      }\n    } else if (ArrayBuffer.isView(data)) {\n      // Typed Arrays can have offsets into underlying buffer\n      if (testDataAgainstBinary(data.buffer, data.byteOffset, loader)) {\n        return loader;\n      }\n    } else if (data instanceof ArrayBuffer) {\n      const byteOffset = 0;\n      if (testDataAgainstBinary(data, byteOffset, loader)) {\n        return loader;\n      }\n    }\n    // TODO Handle streaming case (requires creating a new AsyncIterator)\n  }\n  return null;\n}\n\nfunction testDataAgainstText(data, loader) {\n  if (loader.testText) {\n    return loader.testText(data);\n  }\n\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => data.startsWith(test));\n}\n\nfunction testDataAgainstBinary(data, byteOffset, loader) {\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => testBinary(data, byteOffset, loader, test));\n}\n\nfunction testBinary(data, byteOffset, loader, test) {\n  if (test instanceof ArrayBuffer) {\n    return compareArrayBuffers(test, data, test.byteLength);\n  }\n  switch (typeof test) {\n    case 'function':\n      return test(data, loader);\n\n    case 'string':\n      // Magic bytes check: If `test` is a string, check if binary data starts with that strings\n      const magic = getMagicString(data, byteOffset, test.length);\n      return test === magic;\n\n    default:\n      return false;\n  }\n}\n\nfunction getFirstCharacters(data, length: number = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    // Typed Arrays can have offsets into underlying buffer\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n  return '';\n}\n\nfunction getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength < byteOffset + length) {\n    return '';\n  }\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n  return magic;\n}\n"],"file":"select-loader.js"}
+{"version":3,"sources":["../../../../src/lib/api/select-loader.ts"],"names":["compareArrayBuffers","path","normalizeLoader","log","getResourceUrlAndType","getRegisteredLoaders","isBlob","EXT_PATTERN","selectLoader","data","loaders","options","context","validHTTPResponse","loader","selectLoaderSync","nothrow","slice","arrayBuffer","Error","getNoValidLoaderMessage","Array","isArray","candidateLoaders","concat","ignoreRegisteredLoaders","push","normalizeLoaders","selectLoaderInternal","url","type","testUrl","reason","mimeType","findLoaderByMIMEType","findLoaderByUrl","findLoaderByInitialBytes","getFirstCharacters","fallbackMimeType","name","Response","status","message","filename","firstCharacters","match","exec","extension","findLoaderByExtension","toLowerCase","loaderExtension","extensions","mimeTypes","includes","id","testDataAgainstText","ArrayBuffer","isView","testDataAgainstBinary","buffer","byteOffset","testText","tests","some","test","startsWith","testBinary","byteLength","magic","getMagicString","length","dataView","DataView","i","String","fromCharCode","getUint8"],"mappings":"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","sourcesContent":["import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-utils';\nimport {compareArrayBuffers, path} from '@loaders.gl/loader-utils';\nimport {normalizeLoader} from '../loader-utils/normalize-loader';\nimport {log} from '../utils/log';\nimport {getResourceUrlAndType} from '../utils/resource-utils';\nimport {getRegisteredLoaders} from './register-loaders';\nimport {isBlob} from '../../javascript-utils/is-type';\n\nconst EXT_PATTERN = /\\.([^.]+)$/;\n\n// TODO - Need a variant that peeks at streams for parseInBatches\n// TODO - Detect multiple matching loaders? Use heuristics to grade matches?\n// TODO - Allow apps to pass context to disambiguate between multiple matches (e.g. multiple .json formats)?\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport async function selectLoader(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Promise<Loader | null> {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // First make a sync attempt, disabling exceptions\n  let loader = selectLoaderSync(data, loaders, {...options, nothrow: true}, context);\n  if (loader) {\n    return loader;\n  }\n\n  // For Blobs and Files, try to asynchronously read a small initial slice and test again with that\n  // to see if we can detect by initial content\n  if (isBlob(data)) {\n    data = await (data as Blob).slice(0, 10).arrayBuffer();\n    loader = selectLoaderSync(data, loaders, options, context);\n  }\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/**\n * Find a loader that matches file extension and/or initial file content\n * Search the loaders array argument for a loader that matches url extension or initial data\n * Returns: a normalized loader\n * @param data data to assist\n * @param loaders\n * @param options\n * @param context used internally, applications should not provide this parameter\n */\nexport function selectLoaderSync(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[] | Loader = [],\n  options?: LoaderOptions,\n  context?: LoaderContext\n): Loader | null {\n  if (!validHTTPResponse(data)) {\n    return null;\n  }\n\n  // eslint-disable-next-line complexity\n  // if only a single loader was provided (not as array), force its use\n  // TODO - Should this behavior be kept and documented?\n  if (loaders && !Array.isArray(loaders)) {\n    // TODO - remove support for legacy loaders\n    return normalizeLoader(loaders);\n  }\n\n  // Build list of candidate loaders that will be searched in order for a match\n  let candidateLoaders: Loader[] = [];\n  // First search supplied loaders\n  if (loaders) {\n    candidateLoaders = candidateLoaders.concat(loaders);\n  }\n  // Then fall back to registered loaders\n  if (!options?.ignoreRegisteredLoaders) {\n    candidateLoaders.push(...getRegisteredLoaders());\n  }\n\n  // TODO - remove support for legacy loaders\n  normalizeLoaders(candidateLoaders);\n\n  const loader = selectLoaderInternal(data, candidateLoaders, options, context);\n\n  // no loader available\n  if (!loader && !options?.nothrow) {\n    throw new Error(getNoValidLoaderMessage(data));\n  }\n\n  return loader;\n}\n\n/** Implements loaders selection logic */\nfunction selectLoaderInternal(\n  data: Response | Blob | ArrayBuffer | string,\n  loaders: Loader[],\n  options?: LoaderOptions,\n  context?: LoaderContext\n) {\n  const {url, type} = getResourceUrlAndType(data);\n\n  const testUrl = url || context?.url;\n\n  let loader: Loader | null = null;\n  let reason: string = '';\n\n  // if options.mimeType is supplied, it takes precedence\n  if (options?.mimeType) {\n    loader = findLoaderByMIMEType(loaders, options?.mimeType);\n    reason = `match forced by supplied MIME type ${options?.mimeType}`;\n  }\n\n  // Look up loader by url\n  loader = loader || findLoaderByUrl(loaders, testUrl);\n  reason = reason || (loader ? `matched url ${testUrl}` : '');\n\n  // Look up loader by mime type\n  loader = loader || findLoaderByMIMEType(loaders, type);\n  reason = reason || (loader ? `matched MIME type ${type}` : '');\n\n  // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)\n  loader = loader || findLoaderByInitialBytes(loaders, data);\n  reason = reason || (loader ? `matched initial data ${getFirstCharacters(data)}` : '');\n\n  // Look up loader by fallback mime type\n  loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);\n  reason = reason || (loader ? `matched fallback MIME type ${type}` : '');\n\n  if (reason) {\n    log.log(1, `selectLoader selected ${loader?.name}: ${reason}.`);\n  }\n\n  return loader;\n}\n\n/** Check HTTP Response */\nfunction validHTTPResponse(data: any): boolean {\n  // HANDLE HTTP status\n  if (data instanceof Response) {\n    // 204 - NO CONTENT. This handles cases where e.g. a tile server responds with 204 for a missing tile\n    if (data.status === 204) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Generate a helpful message to help explain why loader selection failed. */\nfunction getNoValidLoaderMessage(data): string {\n  const {url, type} = getResourceUrlAndType(data);\n\n  let message = 'No valid loader found (';\n  message += url ? `${path.filename(url)}, ` : 'no url provided, ';\n  message += `MIME type: ${type ? `\"${type}\"` : 'not provided'}, `;\n  // First characters are only accessible when called on data (string or arrayBuffer).\n  const firstCharacters: string = data ? getFirstCharacters(data) : '';\n  message += firstCharacters ? ` first bytes: \"${firstCharacters}\"` : 'first bytes: not available';\n  message += ')';\n  return message;\n}\n\nfunction normalizeLoaders(loaders: Loader[]): void {\n  for (const loader of loaders) {\n    normalizeLoader(loader);\n  }\n}\n\n// TODO - Would be nice to support http://example.com/file.glb?parameter=1\n// E.g: x = new URL('http://example.com/file.glb?load=1'; x.pathname\nfunction findLoaderByUrl(loaders: Loader[], url?: string): Loader | null {\n  // Get extension\n  const match = url && EXT_PATTERN.exec(url);\n  const extension = match && match[1];\n  return extension ? findLoaderByExtension(loaders, extension) : null;\n}\n\nfunction findLoaderByExtension(loaders: Loader[], extension: string): Loader | null {\n  extension = extension.toLowerCase();\n\n  for (const loader of loaders) {\n    for (const loaderExtension of loader.extensions) {\n      if (loaderExtension.toLowerCase() === extension) {\n        return loader;\n      }\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByMIMEType(loaders, mimeType) {\n  for (const loader of loaders) {\n    if (loader.mimeTypes && loader.mimeTypes.includes(mimeType)) {\n      return loader;\n    }\n\n    // Support referring to loaders using the \"unregistered tree\"\n    // https://en.wikipedia.org/wiki/Media_type#Unregistered_tree\n    if (mimeType === `application/x.${loader.id}`) {\n      return loader;\n    }\n  }\n  return null;\n}\n\nfunction findLoaderByInitialBytes(loaders, data) {\n  if (!data) {\n    return null;\n  }\n\n  for (const loader of loaders) {\n    if (typeof data === 'string') {\n      if (testDataAgainstText(data, loader)) {\n        return loader;\n      }\n    } else if (ArrayBuffer.isView(data)) {\n      // Typed Arrays can have offsets into underlying buffer\n      if (testDataAgainstBinary(data.buffer, data.byteOffset, loader)) {\n        return loader;\n      }\n    } else if (data instanceof ArrayBuffer) {\n      const byteOffset = 0;\n      if (testDataAgainstBinary(data, byteOffset, loader)) {\n        return loader;\n      }\n    }\n    // TODO Handle streaming case (requires creating a new AsyncIterator)\n  }\n  return null;\n}\n\nfunction testDataAgainstText(data, loader) {\n  if (loader.testText) {\n    return loader.testText(data);\n  }\n\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => data.startsWith(test));\n}\n\nfunction testDataAgainstBinary(data, byteOffset, loader) {\n  const tests = Array.isArray(loader.tests) ? loader.tests : [loader.tests];\n  return tests.some((test) => testBinary(data, byteOffset, loader, test));\n}\n\nfunction testBinary(data, byteOffset, loader, test) {\n  if (test instanceof ArrayBuffer) {\n    return compareArrayBuffers(test, data, test.byteLength);\n  }\n  switch (typeof test) {\n    case 'function':\n      return test(data, loader);\n\n    case 'string':\n      // Magic bytes check: If `test` is a string, check if binary data starts with that strings\n      const magic = getMagicString(data, byteOffset, test.length);\n      return test === magic;\n\n    default:\n      return false;\n  }\n}\n\nfunction getFirstCharacters(data, length: number = 5) {\n  if (typeof data === 'string') {\n    return data.slice(0, length);\n  } else if (ArrayBuffer.isView(data)) {\n    // Typed Arrays can have offsets into underlying buffer\n    return getMagicString(data.buffer, data.byteOffset, length);\n  } else if (data instanceof ArrayBuffer) {\n    const byteOffset = 0;\n    return getMagicString(data, byteOffset, length);\n  }\n  return '';\n}\n\nfunction getMagicString(arrayBuffer, byteOffset, length) {\n  if (arrayBuffer.byteLength < byteOffset + length) {\n    return '';\n  }\n  const dataView = new DataView(arrayBuffer);\n  let magic = '';\n  for (let i = 0; i < length; i++) {\n    magic += String.fromCharCode(dataView.getUint8(byteOffset + i));\n  }\n  return magic;\n}\n"],"file":"select-loader.js"}

package/dist/esm/lib/init.js

@@ -1,6 +1,13 @@
-const version = typeof "3.1.4" !== 'undefined' ? "3.1.4" : '';
-globalThis.loaders = Object.assign(globalThis.loaders || {}, {
-  VERSION: version
-});
+import { log } from './utils/log';
+const version = typeof "3.1.8" !== 'undefined' ? "3.1.8" : '';
+
+if (!globalThis.loaders) {
+  log.log(1, "loaders.gl ".concat(version))();
+  globalThis.loaders = Object.assign(globalThis.loaders || {}, {
+    VERSION: version,
+    log
+  });
+}
+
 export default globalThis.loaders;
 //# sourceMappingURL=init.js.map

package/dist/esm/lib/init.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/init.ts"],"names":["version","globalThis","loaders","Object","assign","VERSION"],"mappings":"AACA,MAAMA,OAAO,GAAG,mBAAuB,WAAvB,aAAmD,EAAnE;AAGAC,UAAU,CAACC,OAAX,GAAqBC,MAAM,CAACC,MAAP,CAAcH,UAAU,CAACC,OAAX,IAAsB,EAApC,EAAwC;AAC3DG,EAAAA,OAAO,EAAEL;AADkD,CAAxC,CAArB;AAKA,eAAeC,UAAU,CAACC,OAA1B","sourcesContent":["// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : '';\n\n// @ts-ignore\nglobalThis.loaders = Object.assign(globalThis.loaders || {}, {\n  VERSION: version\n});\n\n// @ts-ignore\nexport default globalThis.loaders;\n"],"file":"init.js"}
+{"version":3,"sources":["../../../src/lib/init.ts"],"names":["log","version","globalThis","loaders","Object","assign","VERSION"],"mappings":"AACA,SAAQA,GAAR,QAAkB,aAAlB;AAGA,MAAMC,OAAO,GAAG,mBAAuB,WAAvB,aAAmD,EAAnE;;AAGA,IAAI,CAACC,UAAU,CAACC,OAAhB,EAAyB;AACvBH,EAAAA,GAAG,CAACA,GAAJ,CAAQ,CAAR,uBAAyBC,OAAzB;AAEAC,EAAAA,UAAU,CAACC,OAAX,GAAqBC,MAAM,CAACC,MAAP,CAAcH,UAAU,CAACC,OAAX,IAAsB,EAApC,EAAwC;AAC3DG,IAAAA,OAAO,EAAEL,OADkD;AAE3DD,IAAAA;AAF2D,GAAxC,CAArB;AAID;;AAED,eAAeE,UAAU,CAACC,OAA1B","sourcesContent":["// loaders.gl, MIT license\nimport {log} from './utils/log';\n\n// @ts-ignore TS2304: Cannot find name '__VERSION__'.\nconst version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : '';\n\n// @ts-ignore\nif (!globalThis.loaders) {\n  log.log(1, `loaders.gl ${version}`)();\n\n  globalThis.loaders = Object.assign(globalThis.loaders || {}, {\n    VERSION: version,\n    log\n  });\n}\n// @ts-ignore\nexport default globalThis.loaders;\n"],"file":"init.js"}

package/dist/esm/lib/utils/log.js

@@ -0,0 +1,5 @@
+import { Log } from '@probe.gl/log';
+export const log = new Log({
+  id: 'loaders.gl'
+});
+//# sourceMappingURL=log.js.map

package/dist/esm/lib/utils/log.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/utils/log.ts"],"names":["Log","log","id"],"mappings":"AACA,SAAQA,GAAR,QAAkB,eAAlB;AAEA,OAAO,MAAMC,GAAG,GAAG,IAAID,GAAJ,CAAQ;AAACE,EAAAA,EAAE,EAAE;AAAL,CAAR,CAAZ","sourcesContent":["// loaders.gl, MIT license\nimport {Log} from '@probe.gl/log';\n\nexport const log = new Log({id: 'loaders.gl'});\n"],"file":"log.js"}

package/dist/esm/null-loader.js

@@ -1,4 +1,4 @@
-const VERSION = typeof "3.1.4" !== 'undefined' ? "3.1.4" : 'latest';
+const VERSION = typeof "3.1.8" !== 'undefined' ? "3.1.8" : 'latest';
 export const NullWorkerLoader = {
   name: 'Null loader',
   id: 'null',

package/dist/lib/api/select-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/api/select-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAanF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,MAAM,EAC5C,OAAO,GAAE,MAAM,EAAE,GAAG,MAAW,EAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,MAAM,EAC5C,OAAO,GAAE,MAAM,EAAE,GAAG,MAAW,EAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,GAAG,IAAI,CAmCf"}
+{"version":3,"file":"select-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/api/select-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAcnF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,MAAM,EAC5C,OAAO,GAAE,MAAM,EAAE,GAAG,MAAW,EAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,WAAW,GAAG,MAAM,EAC5C,OAAO,GAAE,MAAM,EAAE,GAAG,MAAW,EAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,GAAG,IAAI,CAmCf"}

package/dist/lib/api/select-loader.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.selectLoaderSync = exports.selectLoader = void 0;
 const loader_utils_1 = require("@loaders.gl/loader-utils");
 const normalize_loader_1 = require("../loader-utils/normalize-loader");
+const log_1 = require("../utils/log");
 const resource_utils_1 = require("../utils/resource-utils");
 const register_loaders_1 = require("./register-loaders");
 const is_type_1 = require("../../javascript-utils/is-type");
@@ -86,18 +87,27 @@ function selectLoaderInternal(data, loaders, options, context) {
     const { url, type } = (0, resource_utils_1.getResourceUrlAndType)(data);
     const testUrl = url || context?.url;
     let loader = null;
+    let reason = '';
     // if options.mimeType is supplied, it takes precedence
     if (options?.mimeType) {
         loader = findLoaderByMIMEType(loaders, options?.mimeType);
+        reason = `match forced by supplied MIME type ${options?.mimeType}`;
     }
     // Look up loader by url
     loader = loader || findLoaderByUrl(loaders, testUrl);
+    reason = reason || (loader ? `matched url ${testUrl}` : '');
     // Look up loader by mime type
     loader = loader || findLoaderByMIMEType(loaders, type);
+    reason = reason || (loader ? `matched MIME type ${type}` : '');
     // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)
     loader = loader || findLoaderByInitialBytes(loaders, data);
+    reason = reason || (loader ? `matched initial data ${getFirstCharacters(data)}` : '');
     // Look up loader by fallback mime type
     loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);
+    reason = reason || (loader ? `matched fallback MIME type ${type}` : '');
+    if (reason) {
+        log_1.log.log(1, `selectLoader selected ${loader?.name}: ${reason}.`);
+    }
     return loader;
 }
 /** Check HTTP Response */

package/dist/lib/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/lib/init.ts"],"names":[],"mappings":";AASA,wBAAkC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/lib/init.ts"],"names":[],"mappings":";AAgBA,wBAAkC"}

package/dist/lib/init.js

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

package/dist/lib/utils/log.d.ts

@@ -0,0 +1,3 @@
+import { Log } from '@probe.gl/log';
+export declare const log: Log;
+//# sourceMappingURL=log.d.ts.map

package/dist/lib/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/log.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,GAAG,EAAC,MAAM,eAAe,CAAC;AAElC,eAAO,MAAM,GAAG,KAA8B,CAAC"}

package/dist/lib/utils/log.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+// loaders.gl, MIT license
+const log_1 = require("@probe.gl/log");
+exports.log = new log_1.Log({ id: 'loaders.gl' });

package/dist/null-worker.js

@@ -152,7 +152,7 @@
   }
 
   // src/null-loader.ts
-  var VERSION = true ? "3.1.4" : "latest";
+  var VERSION = true ? "3.1.8" : "latest";
   var NullLoader = {
     name: "Null loader",
     id: "null",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/core",
-  "version": "3.1.4",
+  "version": "3.1.8",
   "description": "Framework-independent loaders for 3D graphics formats",
   "license": "MIT",
   "publishConfig": {
@@ -40,9 +40,10 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.3.1",
-    "@loaders.gl/loader-utils": "3.1.4",
-    "@loaders.gl/worker-utils": "3.1.4",
+    "@loaders.gl/loader-utils": "3.1.8",
+    "@loaders.gl/worker-utils": "3.1.8",
+    "@probe.gl/log": "^3.5.0",
     "probe.gl": "^3.4.0"
   },
-  "gitHead": "4d27d3ac6023e53b562dcad83b9254b198e81ee5"
+  "gitHead": "0ef07b4e9fc20f5a882224cf241c6fd1bad898d8"
 }

package/src/lib/api/select-loader.ts

@@ -1,6 +1,7 @@
 import type {LoaderContext, LoaderOptions, Loader} from '@loaders.gl/loader-utils';
 import {compareArrayBuffers, path} from '@loaders.gl/loader-utils';
 import {normalizeLoader} from '../loader-utils/normalize-loader';
+import {log} from '../utils/log';
 import {getResourceUrlAndType} from '../utils/resource-utils';
 import {getRegisteredLoaders} from './register-loaders';
 import {isBlob} from '../../javascript-utils/is-type';
@@ -114,19 +115,33 @@ function selectLoaderInternal(
   const testUrl = url || context?.url;
 
   let loader: Loader | null = null;
+  let reason: string = '';
 
   // if options.mimeType is supplied, it takes precedence
   if (options?.mimeType) {
     loader = findLoaderByMIMEType(loaders, options?.mimeType);
+    reason = `match forced by supplied MIME type ${options?.mimeType}`;
   }
+
   // Look up loader by url
   loader = loader || findLoaderByUrl(loaders, testUrl);
+  reason = reason || (loader ? `matched url ${testUrl}` : '');
+
   // Look up loader by mime type
   loader = loader || findLoaderByMIMEType(loaders, type);
+  reason = reason || (loader ? `matched MIME type ${type}` : '');
+
   // Look for loader via initial bytes (Note: not always accessible (e.g. Response, stream, async iterator)
   loader = loader || findLoaderByInitialBytes(loaders, data);
+  reason = reason || (loader ? `matched initial data ${getFirstCharacters(data)}` : '');
+
   // Look up loader by fallback mime type
   loader = loader || findLoaderByMIMEType(loaders, options?.fallbackMimeType);
+  reason = reason || (loader ? `matched fallback MIME type ${type}` : '');
+
+  if (reason) {
+    log.log(1, `selectLoader selected ${loader?.name}: ${reason}.`);
+  }
 
   return loader;
 }

package/src/lib/init.ts

@@ -1,10 +1,17 @@
+// loaders.gl, MIT license
+import {log} from './utils/log';
+
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const version = typeof __VERSION__ !== 'undefined' ? __VERSION__ : '';
 
 // @ts-ignore
-globalThis.loaders = Object.assign(globalThis.loaders || {}, {
-  VERSION: version
-});
+if (!globalThis.loaders) {
+  log.log(1, `loaders.gl ${version}`)();
 
+  globalThis.loaders = Object.assign(globalThis.loaders || {}, {
+    VERSION: version,
+    log
+  });
+}
 // @ts-ignore
 export default globalThis.loaders;

package/src/lib/utils/log.ts

@@ -0,0 +1,4 @@
+// loaders.gl, MIT license
+import {Log} from '@probe.gl/log';
+
+export const log = new Log({id: 'loaders.gl'});