@bigmistqke/view.gl 0.1.5 → 0.1.7

package/dist/types-C4TRuvYh.d.mts

@@ -0,0 +1,477 @@
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type DeepMerge<A extends readonly [...any]> = A extends [infer L, ...infer R] ? DeepMergeTwo<L, DeepMerge<R>> : unknown;
+type DeepMergeTwo<TBase, TOverride> = {
+    [K in keyof TBase | keyof TOverride]: K extends keyof TOverride ? K extends keyof TBase ? ShallowMerge<[TBase[K], TOverride[K]]> : TOverride[K] : K extends keyof TBase ? TBase[K] : never;
+};
+type ShallowMerge<A extends readonly [...any]> = A extends [infer L, ...infer R] ? ShallowMergeTwo<L, ShallowMerge<R>> : unknown;
+type OptionalPropertyNames<T> = {
+    [K in keyof T]-?: {} extends {
+        [P in K]: T[K];
+    } ? K : never;
+}[keyof T];
+type SpreadProperties<L, R, K extends keyof L & keyof R> = {
+    [P in K]: L[P] | Exclude<R[P], undefined>;
+};
+type Id<T> = T extends infer U ? {
+    [K in keyof U]: U[K];
+} : never;
+type ShallowMergeTwo<L, R> = Id<Pick<L, Exclude<keyof L, keyof R>> & Pick<R, Exclude<keyof R, OptionalPropertyNames<R>>> & Pick<R, Exclude<OptionalPropertyNames<R>, keyof L>> & SpreadProperties<L, R, OptionalPropertyNames<R> & keyof L>>;
+
+type GL = WebGLRenderingContext | WebGL2RenderingContext;
+type GLTarget = 'ARRAY_BUFFER' | 'ELEMENT_ARRAY_BUFFER';
+type GLUsage = 'STATIC_DRAW' | 'DYNAMIC_DRAW' | 'STREAM_DRAW';
+type GLTextureTarget = 'TEXTURE_2D' | 'TEXTURE_CUBE_MAP';
+type GLTextureFormat = 'RGBA' | 'RGB' | 'RGBA32F' | 'RGB32F' | 'RGBA16F' | 'RGB16F';
+type GLTextureType = 'UNSIGNED_BYTE' | 'FLOAT' | 'HALF_FLOAT';
+type GLTextureFilter = 'NEAREST' | 'LINEAR';
+type GLTextureWrap = 'CLAMP_TO_EDGE' | 'REPEAT' | 'MIRRORED_REPEAT';
+interface KIND_TO_UNIFORM_FN_NAME_MAP {
+    float: '1f';
+    vec2: '2f';
+    vec3: '3f';
+    vec4: '4f';
+    int: '1i';
+    ivec2: '2i';
+    ivec3: '3i';
+    ivec4: '4i';
+    mat2: 'Matrix2fv';
+    mat3: 'Matrix3fv';
+    mat4: 'Matrix4fv';
+    uint: '1ui';
+    uvec2: '2ui';
+    uvec3: '3ui';
+    uvec4: '4ui';
+    mat2x3: 'Matrix2x3fv';
+    mat2x4: 'Matrix2x4fv';
+    mat3x2: 'Matrix3x2fv';
+    mat3x4: 'Matrix3x4fv';
+    mat4x2: 'Matrix4x2fv';
+    mat4x3: 'Matrix4x3fv';
+    bool: '1i';
+    bvec2: '2i';
+    bvec3: '3i';
+    bvec4: '4i';
+    sampler2D: '1i';
+    samplerCube: '1i';
+    sampler2DArray: '1i';
+    sampler3D: '1i';
+    sampler2DShadow: '1i';
+    samplerCubeShadow: '1i';
+    sampler2DArrayShadow: '1i';
+    isampler2D: '1i';
+    isampler3D: '1i';
+    isamplerCube: '1i';
+    isampler2DArray: '1i';
+    usampler2D: '1i';
+    usampler3D: '1i';
+    usamplerCube: '1i';
+    usampler2DArray: '1i';
+}
+interface KIND_TO_SIZE_MAP {
+    float: 1;
+    vec2: 2;
+    vec3: 3;
+    vec4: 4;
+    int: 1;
+    ivec2: 2;
+    ivec3: 3;
+    ivec4: 4;
+    bool: 1;
+    bvec2: 2;
+    bvec3: 3;
+    bvec4: 4;
+    uint: 1;
+    uvec2: 2;
+    uvec3: 3;
+    uvec4: 4;
+    mat2: 4;
+    mat3: 9;
+    mat4: 16;
+    mat2x3: 6;
+    mat2x4: 8;
+    mat3x2: 6;
+    mat3x4: 12;
+    mat4x2: 8;
+    mat4x3: 12;
+    sampler2D: 1;
+    samplerCube: 1;
+    sampler3D: 1;
+    sampler2DArray: 1;
+    sampler2DShadow: 1;
+    samplerCubeShadow: 1;
+    sampler2DArrayShadow: 1;
+    isampler2D: 1;
+    isampler3D: 1;
+    isamplerCube: 1;
+    isampler2DArray: 1;
+    usampler2D: 1;
+    usampler3D: 1;
+    usamplerCube: 1;
+    usampler2DArray: 1;
+}
+/**********************************************************************************/
+/**********************************************************************************/
+type UniformFnName = '1f' | '2f' | '3f' | '4f' | '1i' | '2i' | '3i' | '4i' | '1ui' | '2ui' | '3ui' | '4ui' | 'mat2' | 'mat3' | 'mat4' | 'mat2x3' | 'mat2x4' | 'mat3x2' | 'mat3x4' | 'mat4x2' | 'mat4x3' | 'sampler2D' | 'samplerCube' | 'sampler2DArray' | 'isampler2D' | 'isamplerCube' | 'isampler2DArray' | 'usampler2D' | 'usamplerCube' | 'usampler2DArray';
+type UniformKind = 'float' | 'vec2' | 'vec3' | 'vec4' | 'int' | 'ivec2' | 'ivec3' | 'ivec4' | 'bool' | 'bvec2' | 'bvec3' | 'bvec4' | 'mat2' | 'mat3' | 'mat4' | 'sampler2D' | 'samplerCube' | 'uint' | 'uvec2' | 'uvec3' | 'uvec4' | 'mat2x3' | 'mat2x4' | 'mat3x2' | 'mat3x4' | 'mat4x2' | 'mat4x3' | 'sampler3D' | 'sampler2DArray' | 'sampler2DShadow' | 'samplerCubeShadow' | 'sampler2DArrayShadow' | 'isampler2D' | 'isampler3D' | 'isamplerCube' | 'isampler2DArray' | 'usampler2D' | 'usampler3D' | 'usamplerCube' | 'usampler2DArray';
+interface UniformKindMap {
+    float: [number];
+    vec2: [number, number];
+    vec3: [number, number, number];
+    vec4: [number, number, number, number];
+    int: [number];
+    ivec2: [number, number];
+    ivec3: [number, number, number];
+    ivec4: [number, number, number, number];
+    bool: [number];
+    bvec2: [number, number];
+    bvec3: [number, number, number];
+    bvec4: [number, number, number, number];
+    uint: [number];
+    uvec2: [number, number];
+    uvec3: [number, number, number];
+    uvec4: [number, number, number, number];
+    mat2: [Float32Array] | [
+        number,
+        number,
+        number,
+        number
+    ];
+    mat3: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat4: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat2x3: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat2x4: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat3x2: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat3x4: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat4x2: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    mat4x3: [Float32Array] | [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    sampler2D: [number];
+    samplerCube: [number];
+    sampler3D: [number];
+    sampler2DArray: [number];
+    sampler2DShadow: [number];
+    samplerCubeShadow: [number];
+    sampler2DArrayShadow: [number];
+    isampler2D: [number];
+    isampler3D: [number];
+    isamplerCube: [number];
+    isampler2DArray: [number];
+    usampler2D: [number];
+    usampler3D: [number];
+    usamplerCube: [number];
+    usampler2DArray: [number];
+}
+interface UniformDefinition {
+    kind: UniformKind;
+    size?: number;
+}
+type UniformSchema = Record<string | symbol, UniformDefinition>;
+type UniformSchemaPartial = Record<string | symbol, Partial<UniformDefinition>>;
+type UniformMethods<TDefinition extends UniformDefinition> = TDefinition['size'] extends number ? {
+    set(arg: Float32Array): void;
+} : {
+    set(...args: UniformKindMap[TDefinition['kind']]): void;
+};
+type UniformView<T extends UniformSchema> = {
+    [K in keyof T]: UniformMethods<T[K]>;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+type AttributeShortHand = '1f' | '2f' | '3f' | '4f' | '1i' | '2i' | '3i' | '4i' | '1ui' | '2ui' | '3ui' | '4ui';
+type AttributeKind = 'float' | 'vec2' | 'vec3' | 'vec4' | 'mat2' | 'mat3' | 'mat4' | 'mat2x3' | 'mat2x4' | 'mat3x2' | 'mat3x4' | 'mat4x2' | 'mat4x3' | 'int' | 'ivec2' | 'ivec3' | 'ivec4' | 'uint' | 'uvec2' | 'uvec3' | 'uvec4';
+interface AttributeDefinition {
+    kind: AttributeKind;
+    instanced?: boolean;
+    buffer?: WebGLBuffer;
+}
+type AttributeSchema = Record<string | symbol, AttributeDefinition>;
+interface AttributeMethods<T = AttributeKind> {
+    buffer: WebGLBuffer;
+    bind(): void;
+    set(data: Float32Array, usage?: GLUsage): {
+        bind(): void;
+    };
+    dispose(): void;
+}
+type AttributeView<T extends AttributeSchema> = {
+    [K in keyof T]: AttributeMethods<T[K]['kind']>;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+interface InterleavedAttributeLayout {
+    key: string | symbol;
+    kind: AttributeKind;
+}
+interface InterleavedAttributeDefinition {
+    layout: InterleavedAttributeLayout[];
+    instanced?: boolean;
+}
+type InterleavedAttributeSchema = Record<string | symbol, InterleavedAttributeDefinition>;
+interface InterleavedAttributeMethods<T extends InterleavedAttributeLayout[] = InterleavedAttributeLayout[]> {
+    bind(): void;
+    unbind(): void;
+    set(data: Float32Array, usage?: GLUsage): void;
+    dispose(): void;
+}
+type InterleavedAttributeView<T extends InterleavedAttributeSchema> = {
+    [K in keyof T]: InterleavedAttributeMethods<T[K]['layout']>;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+interface BufferDefinition {
+    target?: GLTarget;
+    usage?: GLUsage;
+}
+type BufferSchema = Record<string | symbol, BufferDefinition>;
+interface BufferMethods {
+    set(data: Float32Array | Uint16Array | Uint32Array): void;
+    bind(): void;
+    dispose(): void;
+}
+type BufferView<T extends BufferSchema> = {
+    [K in keyof T]: BufferMethods;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+interface FramebufferDefinition extends Omit<TextureDefinition, 'data'> {
+    attachment: 'color' | 'depth' | 'stencil' | 'depthStencil';
+    texture?: WebGLTexture;
+}
+interface TextureDefinition {
+    target?: GLTextureTarget;
+    width: number;
+    height: number;
+    level?: number;
+    border?: number;
+    internalFormat?: GLTextureFormat;
+    format?: GLTextureFormat;
+    type?: GLTextureType;
+    minFilter?: GLTextureFilter;
+    magFilter?: GLTextureFilter;
+    wrapS?: GLTextureWrap;
+    wrapT?: GLTextureWrap;
+    data?: ArrayBufferView | null;
+}
+interface Framebuffer {
+    texture: WebGLTexture;
+    framebuffer: WebGLFramebuffer;
+}
+/**********************************************************************************/
+/**********************************************************************************/
+type TextureTarget = 'TEXTURE_2D' | 'TEXTURE_CUBE_MAP' | 'TEXTURE_3D' | 'TEXTURE_2D_ARRAY';
+type TextureSchema = Record<string | symbol, TextureDefinition>;
+interface TextureMethods {
+    texture: WebGLTexture;
+    dispose(): void;
+    bind(unit?: number): void;
+    set(data: ImageBufferSource | null, options?: Partial<TexImage2DOptions>): void;
+    parameters(params: Record<number, number>): void;
+}
+type TextureView<T extends TextureSchema> = {
+    [K in keyof T]: TextureMethods;
+};
+type TextureParameterName = 'TEXTURE_MIN_FILTER' | 'TEXTURE_MAG_FILTER' | 'TEXTURE_WRAP_S' | 'TEXTURE_WRAP_T' | 'TEXTURE_WRAP_R';
+type TextureParameterValue = 'NEAREST' | 'LINEAR' | 'NEAREST_MIPMAP_NEAREST' | 'LINEAR_MIPMAP_NEAREST' | 'NEAREST_MIPMAP_LINEAR' | 'LINEAR_MIPMAP_LINEAR' | 'CLAMP_TO_EDGE' | 'REPEAT' | 'MIRRORED_REPEAT';
+type TextureParameters = Partial<Record<TextureParameterName, TextureParameterValue>>;
+type InternalFormat = 'ALPHA' | 'RGB' | 'RGBA' | 'LUMINANCE' | 'LUMINANCE_ALPHA' | 'DEPTH_COMPONENT' | 'DEPTH_STENCIL' | 'R8' | 'RG8' | 'RGB8' | 'RGBA8' | 'DEPTH_COMPONENT16' | 'DEPTH_COMPONENT24' | 'DEPTH24_STENCIL8';
+type Format = 'ALPHA' | 'RGB' | 'RGBA' | 'LUMINANCE' | 'LUMINANCE_ALPHA' | 'DEPTH_COMPONENT' | 'DEPTH_STENCIL';
+type PixelType = 'UNSIGNED_BYTE' | 'UNSIGNED_SHORT_5_6_5' | 'UNSIGNED_SHORT_4_4_4_4' | 'UNSIGNED_SHORT_5_5_5_1' | 'FLOAT' | 'HALF_FLOAT' | 'UNSIGNED_INT_24_8' | 'UNSIGNED_INT' | 'BYTE' | 'SHORT' | 'INT';
+type TexImage2DOptions = {
+    level: number;
+    internalFormat: InternalFormat;
+    width: number;
+    height: number;
+    border: number;
+    format: Format;
+    type: PixelType;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+interface ViewOptions {
+    signal?: AbortSignal;
+}
+interface ViewSchema {
+    uniforms?: UniformSchema;
+    attributes?: AttributeSchema;
+    interleavedAttributes?: InterleavedAttributeSchema;
+    buffers?: BufferSchema;
+}
+interface ViewSchemaPartial {
+    uniforms?: Record<string | symbol, Partial<UniformDefinition>>;
+    attributes?: Record<string | symbol, Partial<AttributeDefinition>>;
+    interleavedAttributes?: Record<string | symbol, Partial<InterleavedAttributeDefinition>>;
+    buffers?: Record<string | symbol, Partial<BufferDefinition>>;
+}
+type View<T extends ViewSchema = ViewSchema> = {
+    attributes: T['attributes'] extends AttributeSchema ? AttributeView<T['attributes']> : undefined;
+    interleavedAttributes: T['interleavedAttributes'] extends InterleavedAttributeSchema ? InterleavedAttributeView<T['interleavedAttributes']> : undefined;
+    buffers: T['buffers'] extends BufferSchema ? BufferView<T['buffers']> : undefined;
+    uniforms: T['uniforms'] extends UniformSchema ? UniformView<T['uniforms']> : never;
+};
+/**********************************************************************************/
+/**********************************************************************************/
+interface GLSLResult {
+    program: WebGLProgram;
+    schema: ViewSchema;
+}
+type GLSLSlotItem = GLSLTag | UniformTag | AttributeTag | InterleaveTag | string | number | symbol;
+type GLSLSlot = GLSLSlotItem | Array<GLSLSlotItem>;
+interface GLSLTag<TSlots extends GLSLSlot[] = GLSLSlot[]> {
+    type: 'glsl';
+    template: TemplateStringsArray;
+    slots: TSlots;
+}
+type UniformTag<TKey extends string | symbol = string | symbol, TKind extends UniformKind = UniformKind, TDefinition extends Partial<UniformDefinition> = UniformDefinition> = TDefinition extends {
+    size: infer TSize;
+} ? {
+    type: 'uniform';
+    kind: TKind;
+    key: TKey;
+    size: TSize;
+} : {
+    type: 'uniform';
+    kind: TKind;
+    key: TKey;
+};
+interface UniformTagFn<TKind extends UniformKind> {
+    <const TKey extends string | symbol, const TDefinition extends Omit<UniformDefinition, 'kind'>>(key: TKey, TDefinition: TDefinition): Prettify<UniformTag<TKey, TKind, TDefinition>>;
+    <const TName extends string | symbol>(key: TName): Prettify<UniformTag<TName, TKind>>;
+}
+interface AttributeTag<TKey extends string | symbol = string | symbol, TKind extends AttributeKind = AttributeKind, TInstanced extends boolean | undefined = boolean | undefined> {
+    type: 'attribute';
+    kind: TKind;
+    instanced: TInstanced;
+    key: TKey;
+}
+interface AttributeTagFn<TKey extends AttributeKind> {
+    <TName extends string | symbol, TDefinition extends Omit<AttributeDefinition, 'kind'>>(key: TName, options: TDefinition): Prettify<AttributeTag<TName, TKey, TDefinition['instanced']>>;
+    <TName extends string | symbol>(key: TName): Prettify<AttributeTag<TName, TKey, undefined>>;
+}
+type InterleaveTag<TKey extends string | symbol = string | symbol, TLayout extends Array<AttributeTag<string | symbol, AttributeKind, undefined>> = Array<AttributeTag<string | symbol, AttributeKind, undefined>>, TDefinition extends Omit<AttributeDefinition, 'kind'> = Omit<AttributeDefinition, 'kind'>> = TDefinition & {
+    key: TKey;
+    type: 'interleavedAttribute';
+    layout: {
+        [TKey in keyof TLayout]: Prettify<Pick<TLayout[TKey], 'kind' | 'key'>>;
+    };
+};
+type GLSLTagToSchema<TTag extends GLSLTag> = FlattenSlots<TTag> extends infer TSlots ? TSlots extends Array<any> ? GLSLSlotsToSchema<TSlots> : never : never;
+type GLSLSlotsToSchema<TSlots extends Array<GLSLSlot>> = {
+    uniforms: {
+        [K in Extract<TSlots[number], UniformTag> as K['key']]: Prettify<Omit<K, 'name' | 'type'>>;
+    };
+    attributes: {
+        [K in Extract<TSlots[number], AttributeTag> as K['key']]: Prettify<Omit<K, 'name' | 'type'>>;
+    };
+    interleavedAttributes: {
+        [K in Extract<TSlots[number], InterleaveTag> as K['key']]: Prettify<Omit<K, 'name' | 'type'>>;
+    };
+};
+type FlattenSlots<T> = T extends GLSLTag<infer TSlots> ? _FlattenSlots<TSlots> : T extends Array<GLSLSlot> ? _FlattenSlots<T> : never;
+type _FlattenSlots<T extends Array<GLSLSlot>> = T extends [infer First, ...infer Rest] ? First extends GLSLTag ? [...FlattenSlots<First>, ...FlattenSlots<Rest>] : First extends unknown[] ? [...FlattenSlots<First>, ...FlattenSlots<Rest>] : [First, ...FlattenSlots<Rest>] : [];
+type MergeGLSLSchema<TVertex extends ViewSchema, TFragment extends ViewSchema, TOverrides extends ViewSchemaPartial = {}> = {
+    uniforms: DeepMerge<[
+        ShallowMerge<[TVertex['uniforms'], TFragment['uniforms']]>,
+        TOverrides['uniforms']
+    ]>;
+    attributes: DeepMerge<[
+        ShallowMerge<[TVertex['attributes'], TFragment['attributes']]>,
+        TOverrides['attributes']
+    ]>;
+    interleavedAttributes: DeepMerge<[
+        ShallowMerge<[TVertex['interleavedAttributes'], TFragment['interleavedAttributes']]>,
+        TOverrides['interleavedAttributes']
+    ]>;
+};
+type CompileResult<TVertex extends GLSLTag, TFragment extends GLSLTag, TOverrides extends ViewSchemaPartial> = MergeGLSLSchema<GLSLTagToSchema<TVertex>, GLSLTagToSchema<TFragment>, TOverrides> extends infer TSchema extends ViewSchema ? {
+    program: WebGLProgram;
+    schema: TSchema;
+    view: View<TSchema>;
+} : never;
+
+export type { UniformTag as $, AttributeSchema as A, BufferSchema as B, BufferDefinition as C, BufferMethods as D, Framebuffer as E, FramebufferDefinition as F, GL as G, TextureTarget as H, InterleavedAttributeSchema as I, TextureSchema as J, KIND_TO_UNIFORM_FN_NAME_MAP as K, TextureMethods as L, TextureView as M, TextureParameterName as N, TextureParameterValue as O, TextureParameters as P, InternalFormat as Q, Format as R, PixelType as S, TextureDefinition as T, UniformSchema as U, ViewSchema as V, TexImage2DOptions as W, ViewSchemaPartial as X, GLSLResult as Y, GLSLSlot as Z, GLSLTag as _, ViewOptions as a, UniformTagFn as a0, AttributeTag as a1, AttributeTagFn as a2, InterleaveTag as a3, GLSLTagToSchema as a4, GLSLSlotsToSchema as a5, MergeGLSLSchema as a6, CompileResult as a7, Prettify as a8, View as b, UniformView as c, AttributeView as d, InterleavedAttributeView as e, BufferView as f, GLTarget as g, GLUsage as h, GLTextureTarget as i, GLTextureFormat as j, GLTextureType as k, GLTextureFilter as l, GLTextureWrap as m, KIND_TO_SIZE_MAP as n, UniformFnName as o, UniformKind as p, UniformDefinition as q, UniformSchemaPartial as r, UniformMethods as s, AttributeShortHand as t, AttributeKind as u, AttributeDefinition as v, AttributeMethods as w, InterleavedAttributeLayout as x, InterleavedAttributeDefinition as y, InterleavedAttributeMethods as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bigmistqke/view.gl",
-  "version": "0.1.5",
-  "description": "🪟 Utilities for managing WebGL resources.",
+  "version": "0.1.7",
+  "description": "👀 Utilities for managing WebGL resources.",
   "exports": {
     ".": {
       "import": "./dist/index.mjs",

package/src/features.ts

@@ -1,4 +1,5 @@
-import type { GL, RemoveSuffix } from './types'
+import { RemoveSuffix } from './type-utils'
+import type { GL } from './types'
 
 const INSTANCED_ARRAYS_WRAPPER_MAP = new WeakMap<
   GL,

package/src/index.ts

@@ -24,6 +24,7 @@ import {
   kindToUniformFnName,
   ObjectUtils,
 } from './utils'
+export * from './types'
 
 /**********************************************************************************/
 /*                                                                                */
@@ -33,8 +34,12 @@ import {
 
 let index = 0
 const PREFIX = 'VIEW_GL_ALIAS'
+const IS_FIREFOX = navigator.userAgent.toLowerCase().indexOf('firefox') >= 0
 
-const SYMBOL_MAP = createUpsertMap(WeakMap<symbol, string>)
+// NOTE:  using symbol as key for WeakMap is currently broken in firefox
+//        see https://bugzilla.mozilla.org/show_bug.cgi?id=1710433
+//        fallback to Map will currently cause a memory leak.
+const SYMBOL_MAP = createUpsertMap(IS_FIREFOX ? Map<symbol, string> : WeakMap<symbol, string>)
 
 export function toID(key: string | number | symbol) {
   if (typeof key === 'string') {