@luma.gl/core 9.2.6 → 9.3.0-alpha.10

package/dist/shadertypes/vertex-types/vertex-format-decoder.js

@@ -0,0 +1,106 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { dataTypeDecoder } from "../data-types/data-type-decoder.js";
+export class VertexFormatDecoder {
+    /**
+     * Decodes a vertex format, returning type, components, byte  length and flags (integer, signed, normalized)
+     */
+    getVertexFormatInfo(format) {
+        // Strip the -webgl ending if present
+        let webglOnly;
+        if (format.endsWith('-webgl')) {
+            format.replace('-webgl', '');
+            webglOnly = true;
+        }
+        // split components from type
+        const [type_, count] = format.split('x');
+        const type = type_;
+        const components = (count ? parseInt(count) : 1);
+        // decode the type
+        const decodedType = dataTypeDecoder.getDataTypeInfo(type);
+        const result = {
+            type,
+            components,
+            byteLength: decodedType.byteLength * components,
+            integer: decodedType.integer,
+            signed: decodedType.signed,
+            normalized: decodedType.normalized
+        };
+        if (webglOnly) {
+            result.webglOnly = true;
+        }
+        return result;
+    }
+    /** Build a vertex format from a signed data type and a component */
+    makeVertexFormat(signedDataType, components, normalized) {
+        const dataType = normalized
+            ? dataTypeDecoder.getNormalizedDataType(signedDataType)
+            : signedDataType;
+        switch (dataType) {
+            // TODO - Special cases for WebGL (not supported on WebGPU), overrides the check below
+            case 'unorm8':
+                if (components === 1) {
+                    return 'unorm8';
+                }
+                if (components === 3) {
+                    return 'unorm8x3-webgl';
+                }
+                return `${dataType}x${components}`;
+            case 'snorm8':
+            case 'uint8':
+            case 'sint8':
+            // WebGPU 8 bit formats must be aligned to 16 bit boundaries');
+            // fall through
+            case 'uint16':
+            case 'sint16':
+            case 'unorm16':
+            case 'snorm16':
+            case 'float16':
+                // WebGPU 16 bit formats must be aligned to 32 bit boundaries
+                if (components === 1 || components === 3) {
+                    throw new Error(`size: ${components}`);
+                }
+                return `${dataType}x${components}`;
+            default:
+                return components === 1 ? dataType : `${dataType}x${components}`;
+        }
+    }
+    /** Get the vertex format for an attribute with TypedArray and size */
+    getVertexFormatFromAttribute(typedArray, size, normalized) {
+        if (!size || size > 4) {
+            throw new Error(`size ${size}`);
+        }
+        const components = size;
+        const signedDataType = dataTypeDecoder.getDataType(typedArray);
+        return this.makeVertexFormat(signedDataType, components, normalized);
+    }
+    /**
+     * Return a "default" vertex format for a certain shader data type
+     * The simplest vertex format that matches the shader attribute's data type
+     */
+    getCompatibleVertexFormat(opts) {
+        let vertexType;
+        switch (opts.primitiveType) {
+            case 'f32':
+                vertexType = 'float32';
+                break;
+            case 'i32':
+                vertexType = 'sint32';
+                break;
+            case 'u32':
+                vertexType = 'uint32';
+                break;
+            case 'f16':
+                return opts.components <= 2 ? 'float16x2' : 'float16x4';
+        }
+        // TODO logic does not work for float16
+        if (opts.components === 1) {
+            return vertexType;
+        }
+        return `${vertexType}x${opts.components}`;
+    }
+}
+/** Decoder for luma.gl vertex types */
+export const vertexFormatDecoder = new VertexFormatDecoder();
+//# sourceMappingURL=vertex-format-decoder.js.map

package/dist/shadertypes/vertex-types/vertex-format-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-format-decoder.js","sourceRoot":"","sources":["../../../src/shadertypes/vertex-types/vertex-format-decoder.ts"],"names":[],"mappings":"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"}

package/dist/shadertypes/vertex-types/vertex-formats.d.ts

@@ -0,0 +1,50 @@
+import { DataTypeIsIntegerT, DataTypeIsNormalizedT, DataTypeIsSignedT } from "../data-types/data-types.js";
+/**
+ * Describes the **memory format** and interpretation (normalization) of a buffer that will be supplied to vertex attributes
+ * @note Must be compatible with the AttributeShaderType of the shaders, see documentation.
+ * @note This is a superset of WebGPU vertex formats to allow for some flexibility for WebGL only applications
+ * @todo Add device.isVertexFormatSupported() method?
+ */
+export type VertexFormat = 'uint8' | 'uint8x2' | 'uint8x4' | 'sint8' | 'sint8x2' | 'sint8x4' | 'unorm8' | 'unorm8x2' | 'unorm8x3-webgl' | 'unorm8x4' | 'unorm8x4-bgra' | 'unorm10-10-10-2' | 'snorm8' | 'snorm8x2' | 'snorm8x3-webgl' | 'snorm8x4' | 'uint16' | 'sint16' | 'unorm16' | 'snorm16' | 'uint16x2' | 'uint16x4' | 'sint16x2' | 'sint16x4' | 'unorm16x2' | 'unorm16x4' | 'snorm16x2' | 'snorm16x4' | 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4' | 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4' | 'float16' | 'float16x2' | 'float16x4' | 'float32' | 'float32x2' | 'float32x3' | 'float32x4';
+/**
+ * @type Information about a vertex format
+ */
+export type VertexFormatInfo<T extends VertexFormat = VertexFormat> = {
+    /** Type of each component */
+    type: VertexFormatDataTypeT<T>;
+    /** Number of components per vertex / row */
+    components: VertexFormatComponentsT<T>;
+    /** Is this an integer format (normalized integer formats are not integer) */
+    integer: DataTypeIsIntegerT<VertexFormatDataTypeT<T>>;
+    /** Is this a signed format? */
+    signed: DataTypeIsSignedT<VertexFormatDataTypeT<T>>;
+    /** Is this a normalized format? */
+    normalized: DataTypeIsNormalizedT<VertexFormatDataTypeT<T>>;
+    /** Length in bytes */
+    byteLength: number;
+    /** Is this a bgra format? */
+    bgra?: boolean;
+    /** Is this a webgl only format? */
+    webglOnly?: boolean;
+};
+/** @type the NormalizedDataType of the components in a VertexFormat */
+export type VertexFormatDataTypeT<T extends VertexFormat> = T extends VertexFormatUint8 ? 'uint8' : T extends VertexFormatSint8 ? 'sint8' : T extends VertexFormatUnorm8 ? 'unorm8' : T extends VertexFormatSnorm8 ? 'snorm8' : T extends VertexFormatUint16 ? 'uint16' : T extends VertexFormatSint16 ? 'sint16' : T extends VertexFormatUnorm16 ? 'unorm16' : T extends VertexFormatSnorm16 ? 'snorm16' : T extends VertexFormatUint32 ? 'uint32' : T extends VertexFormatSint32 ? 'sint32' : T extends VertexFormatFloat16 ? 'float16' : T extends VertexFormatFloat32 ? 'float32' : never;
+/** @type number - the number of components in a VertexFormat */
+export type VertexFormatComponentsT<T extends VertexFormat> = T extends VertexFormat2Components ? 2 : T extends VertexFormat3Components ? 3 : T extends VertexFormat4Components ? 4 : 1;
+type VertexFormatUint8 = 'uint8' | 'uint8x2' | 'uint8x4';
+type VertexFormatSint8 = 'sint8' | 'sint8x2' | 'sint8x4';
+type VertexFormatUnorm8 = 'unorm8' | 'unorm8x2' | 'unorm8x3-webgl' | 'unorm8x4' | 'unorm8x4-bgra' | 'unorm10-10-10-2';
+type VertexFormatSnorm8 = 'snorm8' | 'snorm8x2' | 'snorm8x3-webgl' | 'snorm8x4';
+type VertexFormatUint16 = 'uint16' | 'uint16x2' | 'uint16x4';
+type VertexFormatSint16 = 'sint16' | 'sint16x2' | 'sint16x4';
+type VertexFormatUnorm16 = 'unorm16' | 'unorm16x2' | 'unorm16x4';
+type VertexFormatSnorm16 = 'snorm16' | 'snorm16x2' | 'snorm16x4';
+type VertexFormatUint32 = 'uint32' | 'uint32x2' | 'uint32x3' | 'uint32x4';
+type VertexFormatSint32 = 'sint32' | 'sint32x2' | 'sint32x3' | 'sint32x4';
+type VertexFormatFloat16 = 'float16' | 'float16x2' | 'float16x4';
+type VertexFormatFloat32 = 'float32' | 'float32x2' | 'float32x3' | 'float32x4';
+type VertexFormat2Components = 'uint8x2' | 'sint8x2' | 'unorm8x2' | 'snorm8x2' | 'uint16x2' | 'sint16x2' | 'unorm16x2' | 'snorm16x2' | 'uint32x2' | 'sint32x2' | 'float16x2' | 'float32x2';
+type VertexFormat3Components = 'unorm8x3-webgl' | 'uint32x3' | 'sint32x3' | 'float32x3';
+type VertexFormat4Components = 'uint8x4' | 'sint8x4' | 'unorm8x4' | 'unorm8x4-bgra' | 'unorm10-10-10-2' | 'snorm8x4' | 'uint16x4' | 'sint16x4' | 'unorm16x4' | 'snorm16x4' | 'uint32x4' | 'sint32x4' | 'float16x4' | 'float32x4';
+export {};
+//# sourceMappingURL=vertex-formats.d.ts.map

package/dist/shadertypes/vertex-types/vertex-formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-formats.d.ts","sourceRoot":"","sources":["../../../src/shadertypes/vertex-types/vertex-formats.ts"],"names":[],"mappings":"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"}

package/dist/shadertypes/vertex-types/vertex-formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-formats.js","sourceRoot":"","sources":["../../../src/shadertypes/vertex-types/vertex-formats.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC"}

package/dist/utils/array-equal.d.ts

@@ -1,4 +1,4 @@
-/** Test if two arrays are deep equal, with a length limit that defaults to 16 */
+/** Test if two arrays are deep equal, with a small-array length limit that defaults to 16 */
 export declare function arrayEqual(a: unknown, b: unknown, limit?: number): boolean;
 /** Copy a value */
 export declare function arrayCopy<T>(a: T): T;

package/dist/utils/array-equal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-equal.d.ts","sourceRoot":"","sources":["../../src/utils/array-equal.ts"],"names":[],"mappings":"AAMA,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,MAAW,WAiBpE;AAED,mBAAmB;AACnB,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAKpC"}
+{"version":3,"file":"array-equal.d.ts","sourceRoot":"","sources":["../../src/utils/array-equal.ts"],"names":[],"mappings":"AAQA,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,GAAE,MAAW,WA2BpE;AAED,mBAAmB;AACnB,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAKpC"}

package/dist/utils/array-equal.js

@@ -2,21 +2,27 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 import { isNumberArray } from "./is-array.js";
-/** Test if two arrays are deep equal, with a length limit that defaults to 16 */
+const MAX_ELEMENTWISE_ARRAY_COMPARE_LENGTH = 128;
+/** Test if two arrays are deep equal, with a small-array length limit that defaults to 16 */
 export function arrayEqual(a, b, limit = 16) {
-    if (a !== b) {
-        return false;
+    if (a === b) {
+        return true;
     }
     const arrayA = a;
     const arrayB = b;
-    if (!isNumberArray(arrayA)) {
+    if (!isNumberArray(arrayA) || !isNumberArray(arrayB)) {
+        return false;
+    }
+    if (arrayA.length !== arrayB.length) {
+        return false;
+    }
+    const maxCompareLength = Math.min(limit, MAX_ELEMENTWISE_ARRAY_COMPARE_LENGTH);
+    if (arrayA.length > maxCompareLength) {
         return false;
     }
-    if (isNumberArray(arrayB) && arrayA.length === arrayB.length) {
-        for (let i = 0; i < arrayA.length; ++i) {
-            if (arrayB[i] !== arrayA[i]) {
-                return false;
-            }
+    for (let i = 0; i < arrayA.length; ++i) {
+        if (arrayB[i] !== arrayA[i]) {
+            return false;
         }
     }
     return true;

package/dist/utils/array-equal.js.map

@@ -1 +1 @@
-{"version":3,"file":"array-equal.js","sourceRoot":"","sources":["../../src/utils/array-equal.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,aAAa,EAAC,sBAAmB;AAEzC,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,CAAU,EAAE,QAAgB,EAAE;IACnE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,SAAS,CAAI,CAAI;IAC/B,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,KAAK,EAAO,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"array-equal.js","sourceRoot":"","sources":["../../src/utils/array-equal.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,aAAa,EAAC,sBAAmB;AAEzC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,CAAU,EAAE,CAAU,EAAE,QAAgB,EAAE;IACnE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;IAC/E,IAAI,MAAM,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,SAAS,CAAI,CAAI;IAC/B,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,KAAK,EAAO,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/utils/assert.d.ts

@@ -0,0 +1,5 @@
+/** Throws if condition is true and narrows type */
+export declare function assert(condition: unknown, message?: string): asserts condition;
+/** Throws if value is not defined, narrows type */
+export declare function assertDefined<T>(value: T | undefined, message?: string): T;
+//# sourceMappingURL=assert.d.ts.map

package/dist/utils/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAIA,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAM9E;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAG1E"}

package/dist/utils/assert.js

@@ -0,0 +1,17 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Throws if condition is true and narrows type */
+export function assert(condition, message) {
+    if (!condition) {
+        const error = new Error(message ?? 'luma.gl assertion failed.');
+        Error.captureStackTrace?.(error, assert);
+        throw error;
+    }
+}
+/** Throws if value is not defined, narrows type */
+export function assertDefined(value, message) {
+    assert(value, message);
+    return value;
+}
+//# sourceMappingURL=assert.js.map

package/dist/utils/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/utils/assert.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,mDAAmD;AACnD,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAgB;IACzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC;QAChE,KAAK,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAI,KAAoB,EAAE,OAAgB;IACrE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/stats-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats-manager.d.ts","sourceRoot":"","sources":["../../src/utils/stats-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAEtC;;GAEG;AACH,qBAAa,YAAY;IACvB,KAAK,gBAAa;IAElB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAI7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;CAOzB;AAED,2CAA2C;AAC3C,eAAO,MAAM,SAAS,EAAE,YAAiC,CAAC"}
+{"version":3,"file":"stats-manager.d.ts","sourceRoot":"","sources":["../../src/utils/stats-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAO,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAwB5C;;GAEG;AACH,qBAAa,YAAY;IACvB,KAAK,gBAAa;IAElB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAI7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;CAYzB;AAED,2CAA2C;AAC3C,eAAO,MAAM,SAAS,EAAE,YAAiC,CAAC"}

package/dist/utils/stats-manager.js

@@ -2,6 +2,24 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 import { Stats } from '@probe.gl/stats';
+const GPU_TIME_AND_MEMORY_STATS = 'GPU Time and Memory';
+const GPU_TIME_AND_MEMORY_STAT_ORDER = [
+    'Adapter',
+    'GPU',
+    'GPU Type',
+    'GPU Backend',
+    'Frame Rate',
+    'CPU Time',
+    'GPU Time',
+    'GPU Memory',
+    'Buffer Memory',
+    'Texture Memory',
+    'Referenced Buffer Memory',
+    'Referenced Texture Memory',
+    'Swap Chain Texture'
+];
+const ORDERED_STATS_CACHE = new WeakMap();
+const ORDERED_STAT_NAME_SET_CACHE = new WeakMap();
 /**
  * Helper class managing a collection of probe.gl stats objects
  */
@@ -14,9 +32,51 @@ export class StatsManager {
         if (!this.stats.has(name)) {
             this.stats.set(name, new Stats({ id: name }));
         }
-        return this.stats.get(name);
+        const stats = this.stats.get(name);
+        if (name === GPU_TIME_AND_MEMORY_STATS) {
+            initializeStats(stats, GPU_TIME_AND_MEMORY_STAT_ORDER);
+        }
+        return stats;
     }
 }
 /** Global stats for all luma.gl devices */
 export const lumaStats = new StatsManager();
+function initializeStats(stats, orderedStatNames) {
+    const statsMap = stats.stats;
+    let addedOrderedStat = false;
+    for (const statName of orderedStatNames) {
+        if (!statsMap[statName]) {
+            stats.get(statName);
+            addedOrderedStat = true;
+        }
+    }
+    const statCount = Object.keys(statsMap).length;
+    const cachedStats = ORDERED_STATS_CACHE.get(stats);
+    if (!addedOrderedStat &&
+        cachedStats?.orderedStatNames === orderedStatNames &&
+        cachedStats.statCount === statCount) {
+        return;
+    }
+    const reorderedStats = {};
+    let orderedStatNamesSet = ORDERED_STAT_NAME_SET_CACHE.get(orderedStatNames);
+    if (!orderedStatNamesSet) {
+        orderedStatNamesSet = new Set(orderedStatNames);
+        ORDERED_STAT_NAME_SET_CACHE.set(orderedStatNames, orderedStatNamesSet);
+    }
+    for (const statName of orderedStatNames) {
+        if (statsMap[statName]) {
+            reorderedStats[statName] = statsMap[statName];
+        }
+    }
+    for (const [statName, stat] of Object.entries(statsMap)) {
+        if (!orderedStatNamesSet.has(statName)) {
+            reorderedStats[statName] = stat;
+        }
+    }
+    for (const statName of Object.keys(statsMap)) {
+        delete statsMap[statName];
+    }
+    Object.assign(statsMap, reorderedStats);
+    ORDERED_STATS_CACHE.set(stats, { orderedStatNames, statCount });
+}
 //# sourceMappingURL=stats-manager.js.map

package/dist/utils/stats-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats-manager.js","sourceRoot":"","sources":["../../src/utils/stats-manager.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAC;AAEtC;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IAElB,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,EAAC,EAAE,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAiB,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"stats-manager.js","sourceRoot":"","sources":["../../src/utils/stats-manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luma.gl/core",
-  "version": "9.2.6",
+  "version": "9.3.0-alpha.10",
   "description": "The luma.gl core Device API",
   "license": "MIT",
   "type": "module",
@@ -41,10 +41,10 @@
   },
   "dependencies": {
     "@math.gl/types": "^4.1.0",
-    "@probe.gl/env": "^4.0.8",
-    "@probe.gl/log": "^4.0.8",
-    "@probe.gl/stats": "^4.0.8",
-    "@types/offscreencanvas": "^2019.6.4"
+    "@probe.gl/env": "^4.1.1",
+    "@probe.gl/log": "^4.1.1",
+    "@probe.gl/stats": "^4.1.1",
+    "@types/offscreencanvas": "^2019.7.3"
   },
-  "gitHead": "9c7a3adc09c7b23800df3f916762445ebc1fa924"
+  "gitHead": "ca3a841517106f8608ce392440fa7f324863a84f"
 }