@luma.gl/core 9.0.0 → 9.0.4

package/dist/dist.dev.js

@@ -97,39 +97,37 @@ var __exports__ = (() => {
     uid: () => uid
   });
 
+  // ../../node_modules/@probe.gl/env/dist/lib/globals.js
+  var window_ = globalThis;
+  var document_ = globalThis.document || {};
+  var process_ = globalThis.process || {};
+  var console_ = globalThis.console;
+  var navigator_ = globalThis.navigator || {};
+
   // ../../node_modules/@probe.gl/env/dist/lib/is-electron.js
   function isElectron(mockUserAgent) {
-    if (typeof window !== "undefined" && typeof window.process === "object" && window.process.type === "renderer") {
+    if (typeof window !== "undefined" && window.process?.type === "renderer") {
       return true;
     }
-    if (typeof process !== "undefined" && typeof process.versions === "object" && Boolean(process.versions["electron"])) {
+    if (typeof process !== "undefined" && Boolean(process.versions?.["electron"])) {
       return true;
     }
-    const realUserAgent = typeof navigator === "object" && typeof navigator.userAgent === "string" && navigator.userAgent;
+    const realUserAgent = typeof navigator !== "undefined" && navigator.userAgent;
     const userAgent = mockUserAgent || realUserAgent;
-    if (userAgent && userAgent.indexOf("Electron") >= 0) {
-      return true;
-    }
-    return false;
+    return Boolean(userAgent && userAgent.indexOf("Electron") >= 0);
   }
 
   // ../../node_modules/@probe.gl/env/dist/lib/is-browser.js
   function isBrowser() {
-    const isNode = typeof process === "object" && String(process) === "[object process]" && !process.browser;
+    const isNode = (
+      // @ts-expect-error
+      typeof process === "object" && String(process) === "[object process]" && !process?.browser
+    );
     return !isNode || isElectron();
   }
 
-  // ../../node_modules/@probe.gl/env/dist/lib/globals.js
-  var self_ = globalThis.self || globalThis.window || globalThis.global;
-  var window_ = globalThis.window || globalThis.self || globalThis.global;
-  var document_ = globalThis.document || {};
-  var process_ = globalThis.process || {};
-  var console_ = globalThis.console;
-  var navigator_ = globalThis.navigator || {};
-
-  // ../../node_modules/@probe.gl/env/dist/utils/globals.js
-  var VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "untranspiled source";
-  var isBrowser2 = isBrowser();
+  // ../../node_modules/@probe.gl/env/dist/index.js
+  var VERSION = true ? "4.0.7" : "untranspiled source";
 
   // ../../node_modules/@probe.gl/log/dist/utils/local-storage.js
   function getStorage(type) {
@@ -144,11 +142,7 @@ var __exports__ = (() => {
     }
   }
   var LocalStorage = class {
-    constructor(id, defaultConfig) {
-      let type = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : "sessionStorage";
-      this.storage = void 0;
-      this.id = void 0;
-      this.config = void 0;
+    constructor(id, defaultConfig, type = "sessionStorage") {
       this.storage = getStorage(type);
       this.id = id;
       this.config = defaultConfig;
@@ -164,6 +158,7 @@ var __exports__ = (() => {
         this.storage.setItem(this.id, serialized);
       }
     }
+    // Get config from persistent store, if available
     _loadConfiguration() {
       let configuration = {};
       if (this.storage) {
@@ -189,22 +184,10 @@ var __exports__ = (() => {
     }
     return formatted;
   }
-  function leftPad(string) {
-    let length = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 8;
+  function leftPad(string, length = 8) {
     const padLength = Math.max(length - string.length, 0);
     return `${" ".repeat(padLength)}${string}`;
   }
-  function formatImage(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:${Math.floor(height / 2)}px ${Math.floor(width / 2)}px;`, `line-height:${height}px;`, `background:url(${imageUrl});`, `background-size:${width}px ${height}px;`, "color:transparent;"].join("");
-    return [`${message} %c+`, style];
-  }
 
   // ../../node_modules/@probe.gl/log/dist/utils/color.js
   var COLOR;
@@ -249,8 +232,7 @@ var __exports__ = (() => {
   }
 
   // ../../node_modules/@probe.gl/log/dist/utils/autobind.js
-  function autobind(obj) {
-    let predefined = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : ["constructor"];
+  function autobind(obj, predefined = ["constructor"]) {
     const proto = Object.getPrototypeOf(obj);
     const propNames = Object.getOwnPropertyNames(proto);
     const object = obj;
@@ -275,11 +257,9 @@ var __exports__ = (() => {
   function getHiResTimestamp() {
     let timestamp;
     if (isBrowser() && window_.performance) {
-      var _window$performance, _window$performance$n;
-      timestamp = window_ === null || window_ === void 0 ? void 0 : (_window$performance = window_.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);
+      timestamp = window_?.performance?.now?.();
     } else if ("hrtime" in process_) {
-      var _process$hrtime;
-      const timeParts = process_ === null || process_ === void 0 ? void 0 : (_process$hrtime = process_.hrtime) === null || _process$hrtime === void 0 ? void 0 : _process$hrtime.call(process_);
+      const timeParts = process_?.hrtime?.();
       timestamp = timeParts[0] * 1e3 + timeParts[1] / 1e6;
     } else {
       timestamp = Date.now();
@@ -302,21 +282,12 @@ var __exports__ = (() => {
   function noop() {
   }
   var cache = {};
-  var ONCE = {
-    once: true
-  };
+  var ONCE = { once: true };
   var Log = class {
-    constructor() {
-      let {
-        id
-      } = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {
-        id: ""
-      };
-      this.id = void 0;
+    constructor({ id } = { id: "" }) {
       this.VERSION = VERSION;
       this._startTs = getHiResTimestamp();
       this._deltaTs = getHiResTimestamp();
-      this._storage = void 0;
       this.userData = {};
       this.LOG_THROTTLE_TIMEOUT = 0;
       this.id = id;
@@ -338,42 +309,44 @@ var __exports__ = (() => {
     getLevel() {
       return this._storage.config.level;
     }
+    /** @return milliseconds, with fractions */
     getTotal() {
       return Number((getHiResTimestamp() - this._startTs).toPrecision(10));
     }
+    /** @return milliseconds, with fractions */
     getDelta() {
       return Number((getHiResTimestamp() - this._deltaTs).toPrecision(10));
     }
+    /** @deprecated use logLevel */
     set priority(newPriority) {
       this.level = newPriority;
     }
+    /** @deprecated use logLevel */
     get priority() {
       return this.level;
     }
+    /** @deprecated use logLevel */
     getPriority() {
       return this.level;
     }
-    enable() {
-      let enabled = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : true;
-      this._storage.setConfiguration({
-        enabled
-      });
+    // Configure
+    enable(enabled = true) {
+      this._storage.setConfiguration({ enabled });
       return this;
     }
     setLevel(level) {
-      this._storage.setConfiguration({
-        level
-      });
+      this._storage.setConfiguration({ level });
       return this;
     }
+    /** return the current status of the setting */
     get(setting) {
       return this._storage.config[setting];
     }
+    // update the status of the setting
     set(setting, value) {
-      this._storage.setConfiguration({
-        [setting]: value
-      });
+      this._storage.setConfiguration({ [setting]: value });
     }
+    /** Logs the current settings as a table */
     settings() {
       if (console.table) {
         console.table(this._storage.config);
@@ -381,8 +354,11 @@ var __exports__ = (() => {
         console.log(this._storage.config);
       }
     }
+    // Unconditional logging
     assert(condition, message) {
-      assert(condition, message);
+      if (!condition) {
+        throw new Error(message || "Assertion failed");
+      }
     }
     warn(message) {
       return this._getLogFunction(0, message, originalConsole.warn, arguments, ONCE);
@@ -390,9 +366,11 @@ var __exports__ = (() => {
     error(message) {
       return this._getLogFunction(0, message, originalConsole.error, arguments);
     }
+    /** Print a deprecation warning */
     deprecated(oldUsage, newUsage) {
       return this.warn(`\`${oldUsage}\` is deprecated and will be removed in a later version. Use \`${newUsage}\` instead`);
     }
+    /** Print a removal warning */
     removed(oldUsage, newUsage) {
       return this.error(`\`${oldUsage}\` has been removed. Use \`${newUsage}\` instead`);
     }
@@ -411,6 +389,7 @@ var __exports__ = (() => {
     once(logLevel, message) {
       return this._getLogFunction(logLevel, message, originalConsole.debug || originalConsole.info, arguments, ONCE);
     }
+    /** Logs an object as a table */
     table(logLevel, table, columns) {
       if (table) {
         return this._getLogFunction(logLevel, table, console.table || noop, columns && [columns], {
@@ -419,27 +398,6 @@ var __exports__ = (() => {
       }
       return noop;
     }
-    image(_ref) {
-      let {
-        logLevel,
-        priority,
-        image,
-        message = "",
-        scale = 1
-      } = _ref;
-      if (!this._shouldLog(logLevel || priority)) {
-        return noop;
-      }
-      return isBrowser() ? logImageInBrowser({
-        image,
-        message,
-        scale
-      }) : logImageInNode({
-        image,
-        message,
-        scale
-      });
-    }
     time(logLevel, message) {
       return this._getLogFunction(logLevel, message, console.time ? console.time : console.info);
     }
@@ -449,30 +407,19 @@ var __exports__ = (() => {
     timeStamp(logLevel, message) {
       return this._getLogFunction(logLevel, message, console.timeStamp || noop);
     }
-    group(logLevel, message) {
-      let opts = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {
-        collapsed: false
-      };
-      const options = normalizeArguments({
-        logLevel,
-        message,
-        opts
-      });
-      const {
-        collapsed
-      } = opts;
+    group(logLevel, message, opts = { collapsed: false }) {
+      const options = normalizeArguments({ 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
-      }));
+    groupCollapsed(logLevel, message, opts = {}) {
+      return this.group(logLevel, message, Object.assign({}, opts, { collapsed: true }));
     }
     groupEnd(logLevel) {
       return this._getLogFunction(logLevel, "", console.groupEnd || noop);
     }
+    // EXPERIMENTAL
     withGroup(logLevel, message, func) {
       this.group(logLevel, message)();
       try {
@@ -486,17 +433,14 @@ var __exports__ = (() => {
         console.trace();
       }
     }
+    // PRIVATE METHODS
+    /** Deduces log level from a variety of arguments */
     _shouldLog(logLevel) {
       return this.isEnabled() && this.getLevel() >= normalizeLogLevel(logLevel);
     }
     _getLogFunction(logLevel, message, method, args, opts) {
       if (this._shouldLog(logLevel)) {
-        opts = normalizeArguments({
-          logLevel,
-          message,
-          args,
-          opts
-        });
+        opts = normalizeArguments({ logLevel, message, args, opts });
         method = method || opts.method;
         assert(method);
         opts.total = this.getTotal();
@@ -536,10 +480,7 @@ var __exports__ = (() => {
     return resolvedLevel;
   }
   function normalizeArguments(opts) {
-    const {
-      logLevel,
-      message
-    } = opts;
+    const { logLevel, message } = opts;
     opts.logLevel = normalizeLogLevel(logLevel);
     const args = opts.args ? Array.from(opts.args) : [];
     while (args.length && args.shift() !== message) {
@@ -562,9 +503,7 @@ var __exports__ = (() => {
     }
     const messageType = typeof opts.message;
     assert(messageType === "string" || messageType === "object");
-    return Object.assign(opts, {
-      args
-    }, opts.opts);
+    return Object.assign(opts, { args }, opts.opts);
   }
   function decorateMessage(id, message, opts) {
     if (typeof message === "string") {
@@ -574,43 +513,6 @@ var __exports__ = (() => {
     }
     return message;
   }
-  function logImageInNode(_ref2) {
-    let {
-      image,
-      message = "",
-      scale = 1
-    } = _ref2;
-    console.warn("removed");
-    return noop;
-  }
-  function logImageInBrowser(_ref3) {
-    let {
-      image,
-      message = "",
-      scale = 1
-    } = _ref3;
-    if (typeof image === "string") {
-      const img = new Image();
-      img.onload = () => {
-        const args = formatImage(img, message, scale);
-        console.log(...args);
-      };
-      img.src = image;
-      return noop;
-    }
-    const element = image.nodeName || "";
-    if (element.toLowerCase() === "img") {
-      console.log(...formatImage(image, message, scale));
-      return noop;
-    }
-    if (element.toLowerCase() === "canvas") {
-      const img = new Image();
-      img.onload = () => console.log(...formatImage(img, message, scale));
-      img.src = image.toDataURL();
-      return noop;
-    }
-    return noop;
-  }
   function getTableHeader(table) {
     for (const key in table) {
       for (const title in table[key]) {
@@ -620,10 +522,11 @@ var __exports__ = (() => {
     return "empty";
   }
 
+  // ../../node_modules/@probe.gl/log/dist/init.js
+  globalThis.probe = {};
+
   // ../../node_modules/@probe.gl/log/dist/index.js
-  var dist_default = new Log({
-    id: "@probe.gl/log"
-  });
+  var dist_default = new Log({ id: "@probe.gl/log" });
 
   // src/utils/log.ts
   var log = new Log({ id: "luma.gl" });
@@ -645,8 +548,6 @@ var __exports__ = (() => {
   // ../../node_modules/@probe.gl/stats/dist/lib/stat.js
   var Stat = class {
     constructor(name2, type) {
-      this.name = void 0;
-      this.type = void 0;
       this.sampleSize = 1;
       this.time = 0;
       this.count = 0;
@@ -681,26 +582,31 @@ var __exports__ = (() => {
       this.sampleSize = samples;
       return this;
     }
+    /** Call to increment count (+1) */
     incrementCount() {
       this.addCount(1);
       return this;
     }
+    /** Call to decrement count (-1) */
     decrementCount() {
       this.subtractCount(1);
       return this;
     }
+    /** Increase count */
     addCount(value) {
       this._count += value;
       this._samples++;
       this._checkSampling();
       return this;
     }
+    /** Decrease count */
     subtractCount(value) {
       this._count -= value;
       this._samples++;
       this._checkSampling();
       return this;
     }
+    /** Add an arbitrary timing and bump the count */
     addTime(time) {
       this._time += time;
       this.lastTiming = time;
@@ -708,11 +614,13 @@ var __exports__ = (() => {
       this._checkSampling();
       return this;
     }
+    /** Start a timer */
     timeStart() {
       this._startTime = getHiResTimestamp2();
       this._timerPending = true;
       return this;
     }
+    /** End a timer. Adds to time and bumps the timing count. */
     timeEnd() {
       if (!this._timerPending) {
         return this;
@@ -725,18 +633,22 @@ var __exports__ = (() => {
     getSampleAverageCount() {
       return this.sampleSize > 0 ? this.lastSampleCount / this.sampleSize : 0;
     }
+    /** Calculate average time / count for the previous window */
     getSampleAverageTime() {
       return this.sampleSize > 0 ? this.lastSampleTime / this.sampleSize : 0;
     }
+    /** Calculate counts per second for the previous window */
     getSampleHz() {
       return this.lastSampleTime > 0 ? this.sampleSize / (this.lastSampleTime / 1e3) : 0;
     }
     getAverageCount() {
       return this.samples > 0 ? this.count / this.samples : 0;
     }
+    /** Calculate average time / count */
     getAverageTime() {
       return this.samples > 0 ? this.time / this.samples : 0;
     }
+    /** Calculate counts per second */
     getHz() {
       return this.time > 0 ? this.samples / (this.time / 1e3) : 0;
     }
@@ -757,23 +669,20 @@ var __exports__ = (() => {
   // ../../node_modules/@probe.gl/stats/dist/lib/stats.js
   var Stats = class {
     constructor(options) {
-      this.id = void 0;
       this.stats = {};
       this.id = options.id;
       this.stats = {};
       this._initializeStats(options.stats);
       Object.seal(this);
     }
-    get(name2) {
-      let type = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "count";
-      return this._getOrCreate({
-        name: name2,
-        type
-      });
+    /** Acquire a stat. Create if it doesn't exist. */
+    get(name2, type = "count") {
+      return this._getOrCreate({ name: name2, type });
     }
     get size() {
       return Object.keys(this.stats).length;
     }
+    /** Reset all stats */
     reset() {
       for (const stat of Object.values(this.stats)) {
         stat.reset();
@@ -797,15 +706,11 @@ var __exports__ = (() => {
       });
       return table;
     }
-    _initializeStats() {
-      let stats = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : [];
+    _initializeStats(stats = []) {
       stats.forEach((stat) => this._getOrCreate(stat));
     }
     _getOrCreate(stat) {
-      const {
-        name: name2,
-        type
-      } = stat;
+      const { name: name2, type } = stat;
       let result = this.stats[name2];
       if (!result) {
         if (stat instanceof Stat) {
@@ -1371,51 +1276,76 @@ var __exports__ = (() => {
   }
 
   // src/lib/luma.ts
-  var deviceList = /* @__PURE__ */ new Map();
+  var deviceMap = /* @__PURE__ */ new Map();
   var luma = class {
     static registerDevices(deviceClasses) {
       for (const deviceClass of deviceClasses) {
         assert2(deviceClass.type && deviceClass.isSupported && deviceClass.create);
-        deviceList.set(deviceClass.type, deviceClass);
+        deviceMap.set(deviceClass.type, deviceClass);
       }
     }
     static getAvailableDevices() {
-      return Array.from(deviceList).map((Device2) => Device2.type);
+      return Array.from(deviceMap).map((Device2) => Device2.type);
     }
     static getSupportedDevices() {
-      return Array.from(deviceList).filter((Device2) => Device2.isSupported()).map((Device2) => Device2.type);
+      return Array.from(deviceMap).filter((Device2) => Device2.isSupported()).map((Device2) => Device2.type);
     }
     static setDefaultDeviceProps(props) {
       Object.assign(Device.defaultProps, props);
     }
+    /** Attach to an existing GPU API handle (WebGL2RenderingContext or GPUDevice). */
+    static async attachDevice(props) {
+      const devices = getDeviceMap(props.devices) || deviceMap;
+      if (props.handle instanceof WebGL2RenderingContext) {
+        const WebGLDevice = devices.get("webgl");
+        if (WebGLDevice) {
+          return await WebGLDevice.attach(props.handle);
+        }
+      }
+      if (props.handle === null) {
+        const UnknownDevice = devices.get("unknown");
+        if (UnknownDevice) {
+          return await UnknownDevice.attach(null);
+        }
+      }
+      throw new Error(
+        "Failed to attach device. Ensure `@luma.gl/webgl` and/or `@luma.gl/webgpu` modules are imported."
+      );
+    }
     /** Creates a device. Asynchronously. */
     static async createDevice(props = {}) {
       props = { ...Device.defaultProps, ...props };
       if (props.gl) {
         props.type = "webgl";
       }
-      let DeviceClass;
+      const devices = getDeviceMap(props.devices) || deviceMap;
       switch (props.type) {
         case "webgpu":
-          DeviceClass = deviceList.get("webgpu");
-          if (DeviceClass) {
-            return await DeviceClass.create(props);
+          let WebGPUDevice = devices.get("webgpu");
+          if (WebGPUDevice) {
+            return await WebGPUDevice.create(props);
           }
           break;
         case "webgl":
-          DeviceClass = deviceList.get("webgl");
-          if (DeviceClass) {
-            return await DeviceClass.create(props);
+          let WebGLDevice = devices.get("webgl");
+          if (WebGLDevice) {
+            return await WebGLDevice.create(props);
+          }
+          break;
+        case "unknown":
+          const UnknownDevice = devices.get("unknown");
+          if (UnknownDevice) {
+            return await UnknownDevice.create(props);
           }
           break;
         case "best-available":
-          DeviceClass = deviceList.get("webgpu");
-          if (DeviceClass && DeviceClass.isSupported()) {
-            return await DeviceClass.create(props);
+          WebGPUDevice = devices.get("webgpu");
+          if (WebGPUDevice?.isSupported?.()) {
+            return await WebGPUDevice.create(props);
           }
-          DeviceClass = deviceList.get("webgl");
-          if (DeviceClass && DeviceClass.isSupported()) {
-            return await DeviceClass.create(props);
+          WebGLDevice = devices.get("webgl");
+          if (WebGLDevice?.isSupported?.()) {
+            return await WebGLDevice.create(props);
           }
           break;
       }
@@ -1424,10 +1354,25 @@ var __exports__ = (() => {
       );
     }
   };
+  __publicField(luma, "defaultProps", {
+    ...Device.defaultProps,
+    type: "best-available",
+    devices: void 0
+  });
   /** Global stats for all devices */
   __publicField(luma, "stats", lumaStats);
   /** Global log */
   __publicField(luma, "log", log);
+  function getDeviceMap(deviceClasses) {
+    if (!deviceClasses || deviceClasses?.length === 0) {
+      return null;
+    }
+    const map = /* @__PURE__ */ new Map();
+    for (const deviceClass of deviceClasses) {
+      map.set(deviceClass.type, deviceClass);
+    }
+    return map;
+  }
 
   // src/adapter/canvas-context.ts
   var isPage = isBrowser() && typeof document !== "undefined";