@bigmistqke/view.gl 0.7.1 → 0.8.1

package/README.md

@@ -39,6 +39,7 @@
   - 🏗️ [createProgram](#️-createprogram)
   - 🖼️ [createTexture](#️-createtexture)
   - 🖥️ [createFramebuffer](#️-createframebuffer)
+- 🚨 [Errors](#-errors)
 - 🔍 [WebGL Type Compatibility](#-webgl-type-compatibility)
   - 🎯 [Uniform Types](#-uniform-types)
   - 📝 [Attribute Types](#-attribute-types)
@@ -124,8 +125,8 @@ is a label for the reader. What putting it in the schema decides is its
 | belongs to somebody else | name it on an attribute | nobody — it is borrowed |
 
 An index buffer whose lifetime is its program's belongs in the schema, beside
-the attributes it is drawn with, on the one signal. A quad cached per context,
-or a buffer handed from one program's view to another's, is its own thing.
+the attributes it is drawn with, on the one signal. A buffer handed from one
+program's view to another's is its own thing.
 
 <details>
 <summary>TypeScript Types</summary>
@@ -910,6 +911,32 @@ Pass a `texture` to attach one you already have — ping-ponging a pair of
 framebuffers over shared textures, say. `dispose()` then deletes the framebuffer
 and leaves that texture alone, because it is not the framebuffer's to delete.
 
+## 🚨 Errors
+
+Every error view.gl throws for a GL call that failed is a class exported from `@bigmistqke/view.gl`, carrying what the GL answered:
+
+| Error | Thrown when | Carries |
+| --- | --- | --- |
+| `ShaderCompileError` | a shader does not compile | `stage`, `infoLog` (`string \| null`, as the driver answered it), `glError` |
+| `ProgramLinkError` | a program does not link | `infoLog` (`string \| null`), `glError` |
+| `GLCreateError` | a `create*` call answers `null` | `resource`: `'shader'`, `'program'`, `'buffer'`, `'vertexArray'`, `'texture'` or `'framebuffer'` |
+| `AttributeNotFoundError` | `getAttribLocation` answers -1 | `attribute` |
+
+A lost WebGL context answers calls with defaults: -1 for an attribute, `false` with an empty or `null` log for a compile or link, and `null` from a `create*` in engines that predate infallible object creation (current ones hand out an object, and the loss shows up at the compile or link). So an empty `infoLog` or a `GLCreateError` carries no cause, where a non-empty `infoLog` is the driver's own reason.
+
+```typescript
+import { createProgram } from '@bigmistqke/view.gl/gl'
+import { ShaderCompileError } from '@bigmistqke/view.gl'
+
+try {
+  createProgram(gl, vertex, fragment)
+} catch (error) {
+  if (error instanceof ShaderCompileError && error.infoLog?.trim()) {
+    console.error(`${error.stage} shader rejected:`, error.infoLog)
+  }
+}
+```
+
 ## 🔍 WebGL Type Compatibility
 
 ### 🎯 Uniform Types

package/dist/{chunk-YQ6SJAWS.mjs → chunk-6UTWQ36A.mjs}

@@ -1,6 +1,8 @@
 import {
+  AttributeNotFoundError,
   assertedNotNullish,
   createUpsertMap,
+  created,
   forEachObject,
   getInstancedArrays,
   getVertexArrayObject,
@@ -10,7 +12,7 @@ import {
   kindToUniformFnName,
   mapObject,
   once
-} from "./chunk-BZDGEIOT.mjs";
+} from "./chunk-BDNRC4WD.mjs";
 
 // src/index.ts
 var index = 0;
@@ -72,7 +74,7 @@ function bindDefaultVertexArray(gl) {
     return () => {
     };
   }
-  const previous = gl.getParameter(VERTEX_ARRAY_BINDING);
+  const previous = readVertexArrayBinding(gl);
   feature.bindVertexArray(null);
   return () => feature.bindVertexArray(previous);
 }
@@ -89,8 +91,8 @@ function vaoView(gl, participants, { signal } = {}) {
     dispose() {
     }
   } : (() => {
-    const vertexArray = assertedNotNullish(feature.createVertexArray());
-    const previous = gl.getParameter(VERTEX_ARRAY_BINDING);
+    const vertexArray = created(feature.createVertexArray(), "vertexArray");
+    const previous = readVertexArrayBinding(gl);
     feature.bindVertexArray(vertexArray);
     for (const participant of participants) {
       participant.applyToVertexArray();
@@ -98,9 +100,7 @@ function vaoView(gl, participants, { signal } = {}) {
     feature.bindVertexArray(previous);
     return {
       bind() {
-        const previousVertexArray = gl.getParameter(
-          VERTEX_ARRAY_BINDING
-        );
+        const previousVertexArray = readVertexArrayBinding(gl);
         feature.bindVertexArray(vertexArray);
         participants.forEach((participant) => participant.applyToContext?.());
         return once(() => feature.bindVertexArray(previousVertexArray));
@@ -203,6 +203,10 @@ function handleAttribute(gl, location, size, stride, offset, glType, isIntegerKi
 }
 var VERTEX_ATTRIB_ARRAY_DIVISOR = 35070;
 var VERTEX_ARRAY_BINDING = 34229;
+function readVertexArrayBinding(gl) {
+  const bound = gl.getParameter(VERTEX_ARRAY_BINDING);
+  return typeof bound === "object" ? bound : null;
+}
 function readDivisor(gl, location) {
   return getInstancedArrays(gl) ? gl.getVertexAttrib(location, VERTEX_ATTRIB_ARRAY_DIVISOR) : 0;
 }
@@ -211,10 +215,10 @@ function attributeView(gl, program, schema, { signal } = {}) {
     schema,
     ({ kind, format, normalized = false, instanced, buffer: providedBuffer }, key) => {
       const name = toID(key);
-      const buffer = providedBuffer ?? assertedNotNullish(gl.createBuffer());
+      const buffer = providedBuffer ?? created(gl.createBuffer(), "buffer");
       const location = gl.getAttribLocation(program, name);
       if (location < 0) {
-        throw new Error(`Attribute '${name}' not found`);
+        throw new AttributeNotFoundError(name);
       }
       const size = kindToSize(kind);
       const resolvedFormat = format ?? defaultFormat(kind);
@@ -325,7 +329,7 @@ function interleavedAttributeView(gl, program, schema, { signal } = {}) {
       const name = toID(layout2.key);
       const location = gl.getAttribLocation(program, name);
       if (location < 0) {
-        throw new Error(`Attribute '${name}' not found`);
+        throw new AttributeNotFoundError(name);
       }
       locations.push(location);
       const size = kindToSize(layout2.kind);
@@ -348,7 +352,7 @@ function interleavedAttributeView(gl, program, schema, { signal } = {}) {
       );
     });
     const stride = index2;
-    const buffer = assertedNotNullish(gl.createBuffer());
+    const buffer = created(gl.createBuffer(), "buffer");
     function applyToVertexArray(divisor) {
       const previousDivisors = locations.map(
         (location) => [location, readDivisor(gl, location)]
@@ -411,7 +415,7 @@ function interleavedAttributeView(gl, program, schema, { signal } = {}) {
 }
 function bufferView(gl, schema, { signal } = {}) {
   const buffers = mapObject(schema, ({ target = "ARRAY_BUFFER", usage = "STATIC_DRAW" }) => {
-    const buffer = assertedNotNullish(gl.createBuffer());
+    const buffer = created(gl.createBuffer(), "buffer");
     function applyToVertexArray() {
       const previousBuffer = gl.getParameter(gl[`${target}_BINDING`]);
       gl.bindBuffer(gl[target], buffer);
@@ -459,4 +463,4 @@ export {
   interleavedAttributeView,
   bufferView
 };
-//# sourceMappingURL=chunk-YQ6SJAWS.mjs.map
+//# sourceMappingURL=chunk-6UTWQ36A.mjs.map

package/dist/chunk-6UTWQ36A.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { AttributeNotFoundError, created } from './errors'\nimport { getInstancedArrays, getVertexArrayObject } from './gl'\nimport type {\n  AttributeFormat,\n  AttributeKind,\n  AttributeMethods,\n  AttributeSchema,\n  AttributeView,\n  BufferSchema,\n  BufferView,\n  GL,\n  UniformView as InferUniformView,\n  GLUsage,\n  InterleavedAttributeLayout,\n  InterleavedAttributeMethods,\n  InterleavedAttributeSchema,\n  InterleavedAttributeView,\n  UniformSchema,\n  VertexArrayMethods,\n  VertexArrayParticipant,\n  View,\n  ViewOptions,\n  ViewSchema,\n} from './types'\nimport {\n  isSamplerKind,\n  kindToUniformFnName,\n  isMatKind,\n  assertedNotNullish,\n  kindToSize,\n  forEachObject,\n  once,\n} from './utils'\nimport { createUpsertMap, mapObject } from './utils'\nexport * from './errors'\nexport * from './types'\n// Documented under Utils but reachable from nowhere until now: utils is not a\n// build entry, and named rather than star so the internal helpers stay internal.\nexport { createFramebuffer, createTexture } from './utils'\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                      To ID                                     */\n/*                                                                                */\n/**********************************************************************************/\n\nlet index = 0\nconst PREFIX = 'VIEW_GL_ALIAS'\n// Firefox has currently a bug where it can not handle symbol as WeakRef / key for WeakMap\n// see https://bugzilla.mozilla.org/show_bug.cgi?id=1710433\nconst HAS_WEAK_SYMBOL = (() => {\n  try {\n    const symbol = Symbol()\n    new WeakMap().set(symbol, '')\n    return true\n  } catch {\n    return false\n  }\n})()\n// NOTE:  fallback to Map will currently cause a minor memory leak.\nconst SYMBOL_MAP = createUpsertMap(HAS_WEAK_SYMBOL ? WeakMap<symbol, string> : Map<symbol, string>)\n\nexport function toID(key: string | number | symbol) {\n  if (typeof key === 'string') {\n    return key\n  }\n  if (typeof key === 'symbol') {\n    return SYMBOL_MAP.getOrInsert(key, () => `${PREFIX}_${index++}`)\n  }\n  return key.toString()\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                      View                                      */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function view<TSchema extends ViewSchema>(\n  gl: GL,\n  program: WebGLProgram,\n  schema: TSchema,\n  { signal }: ViewOptions = {},\n): View<TSchema> {\n  // The sub-views are built without the signal and the view wires disposal\n  // once, so that `dispose()` and aborting do the same thing rather than each\n  // doing half of it.\n  const attributes = !schema.attributes ? undefined : attributeView(gl, program, schema.attributes)\n  const interleavedAttributes = !schema.interleavedAttributes\n    ? undefined\n    : interleavedAttributeView(gl, program, schema.interleavedAttributes)\n  // Owned by the view, on the view's signal. This is the line the split was\n  // really about: it used to read `bufferView(gl, schema.buffers)` with the\n  // options dropped, so a view's buffers were the only resources that still\n  // needed disposing by hand. That was a missing argument rather than a wrong\n  // model — a buffer whose lifetime IS the view's belongs with it.\n  const buffers = !schema.buffers ? undefined : bufferView(gl, schema.buffers)\n\n  // Vertex arrays are made on demand rather than declared, so they are the one\n  // thing the view cannot dispose from the schema alone. Held until disposed —\n  // by the view or by the caller — and dropped either way, so a view that hands\n  // out an array per frame does not accumulate them.\n  const vertexArrays = new Set<VertexArrayMethods>()\n\n  const dispose = once(() => {\n    if (attributes) forEachObject(attributes, value => value.dispose())\n    if (interleavedAttributes) forEachObject(interleavedAttributes, value => value.dispose())\n    if (buffers) forEachObject(buffers, value => value.dispose())\n    vertexArrays.forEach(vertexArray => vertexArray.dispose())\n    vertexArrays.clear()\n  })\n\n  signal?.addEventListener('abort', dispose)\n\n  return {\n    uniforms: !schema.uniforms ? undefined : uniformView(gl, program, schema.uniforms),\n    attributes,\n    interleavedAttributes,\n    buffers,\n    vao(participants: VertexArrayParticipant[]) {\n      const vertexArray = vaoView(gl, participants)\n      vertexArrays.add(vertexArray)\n      return {\n        ...vertexArray,\n        dispose: once(() => {\n          vertexArrays.delete(vertexArray)\n          vertexArray.dispose()\n        }),\n      }\n    },\n    dispose,\n  } as View<TSchema>\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                    Vertex Array                                */\n/*                                                                                */\n/**********************************************************************************/\n\n/**\n * Bind the default vertex array, returning a disposer that puts the previous\n * one back. The pointer calls name no destination, so anything applied without\n * a vertex array of its own has to say which one it means — and a vertex array\n * keeps what it is given, so writing into a caller's array by accident would\n * outlive the call that did it.\n */\nfunction bindDefaultVertexArray(gl: GL): () => void {\n  const feature = getVertexArrayObject(gl)\n  if (!feature) {\n    return () => {}\n  }\n  const previous = readVertexArrayBinding(gl)\n  feature.bindVertexArray(null)\n  return () => feature.bindVertexArray(previous)\n}\n\n/**\n * A vertex array over the participants one draw needs.\n *\n * Where the context has vertex arrays, each participant writes itself in once,\n * here, and `bind()` is a single `bindVertexArray`. Where it does not — WebGL1\n * without `OES_vertex_array_object` — there is nowhere to keep the state, so\n * `bind()` re-applies every participant and the disposer puts back what they\n * displaced. Same contract, and the emulation is why the name still fits.\n */\nexport function vaoView(\n  gl: GL,\n  participants: VertexArrayParticipant[],\n  { signal }: ViewOptions = {},\n): VertexArrayMethods {\n  const feature = getVertexArrayObject(gl)\n\n  const methods: VertexArrayMethods = !feature\n    ? {\n        bind() {\n          const restores = participants.map(participant => participant.applyToVertexArray())\n          participants.forEach(participant => participant.applyToContext?.())\n          return once(() => restores.forEach(restore => restore()))\n        },\n        unbind() {},\n        dispose() {},\n      }\n    : (() => {\n        const vertexArray = created(feature.createVertexArray(), 'vertexArray')\n        const previous = readVertexArrayBinding(gl)\n        feature.bindVertexArray(vertexArray)\n        // Discarding the restorers is the point: the state lives in this array\n        // now, and the array is thrown away whole.\n        for (const participant of participants) {\n          participant.applyToVertexArray()\n        }\n        feature.bindVertexArray(previous)\n\n        return {\n          bind() {\n            const previousVertexArray = readVertexArrayBinding(gl)\n            feature.bindVertexArray(vertexArray)\n            // Context state the array cannot hold — see applyToContext.\n            participants.forEach(participant => participant.applyToContext?.())\n            return once(() => feature.bindVertexArray(previousVertexArray))\n          },\n          unbind() {\n            feature.bindVertexArray(null)\n          },\n          dispose: once(() => feature.deleteVertexArray(vertexArray)),\n        }\n      })()\n\n  signal?.addEventListener('abort', () => methods.dispose())\n\n  return methods\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                    Uniform View                                */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function uniformView<T extends UniformSchema>(\n  gl: GL,\n  program: WebGLProgram,\n  schema: T,\n): InferUniformView<T> {\n  // @ts-expect-error - conditional return type based on size is hard to infer\n  return mapObject(schema, ({ kind, size }, key) => {\n    const name = toID(key)\n\n    if (isSamplerKind(kind)) {\n      const location = gl.getUniformLocation(program, name)\n      return {\n        set(arg: number) {\n          gl.uniform1i(location, arg)\n        },\n      }\n    }\n\n    // Array uniform - support both bulk set and indexed access\n    if (size) {\n      const bulkFnName = `uniform${kindToUniformFnName(kind)}v`\n      // @ts-ignore FIX WEBGL/WEBGL2 TYPES\n      const bulkFn = gl[bulkFnName].bind(gl)\n      const bulkLocation = gl.getUniformLocation(program, name)\n\n      const elementFnName = `uniform${kindToUniformFnName(kind)}`\n      // @ts-ignore FIX WEBGL/WEBGL2 TYPES\n      const elementFn = gl[elementFnName].bind(gl)\n\n      // Build array of element setters\n      const elements: Array<{ set(...args: any[]): void }> = []\n      for (let i = 0; i < size; i++) {\n        const location = gl.getUniformLocation(program, `${name}[${i}]`)\n        elements[i] = {\n          set(...args: any[]) {\n            elementFn(location, ...args)\n          },\n        }\n      }\n\n      // Return array-like object with bulk set\n      return Object.assign(elements, {\n        set(arg: Float32Array) {\n          bulkFn(bulkLocation, arg)\n        },\n      })\n    }\n\n    // Non-array uniform\n    const location = gl.getUniformLocation(program, name)\n    const fnName = `uniform${kindToUniformFnName(kind)}`\n\n    // @ts-ignore FIX WEBGL/WEBGL2 TYPES\n    const fn = gl[fnName].bind(gl)\n\n    if (isMatKind(kind)) {\n      return {\n        set(...args: any[]) {\n          fn(location, false, args[0])\n        },\n      }\n    }\n\n    return {\n      set(...args: any[]) {\n        fn(location, ...args)\n      },\n    }\n  })\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                   Attribute View                               */\n/*                                                                                */\n/**********************************************************************************/\n\ntype GLType =\n  | 'FLOAT'\n  | 'INT'\n  | 'UNSIGNED_INT'\n  | 'SHORT'\n  | 'UNSIGNED_SHORT'\n  | 'BYTE'\n  | 'UNSIGNED_BYTE'\n\nconst FORMAT_TO_GL_TYPE: Record<AttributeFormat, GLType> = {\n  float32: 'FLOAT',\n  int32: 'INT',\n  uint32: 'UNSIGNED_INT',\n  int16: 'SHORT',\n  uint16: 'UNSIGNED_SHORT',\n  int8: 'BYTE',\n  uint8: 'UNSIGNED_BYTE',\n}\n\nconst FORMAT_BYTE_SIZE: Record<AttributeFormat, number> = {\n  float32: 4,\n  int32: 4,\n  uint32: 4,\n  int16: 2,\n  uint16: 2,\n  int8: 1,\n  uint8: 1,\n}\n\nfunction defaultFormat(kind: AttributeKind): AttributeFormat {\n  if (kind.startsWith('u')) return 'uint32'\n  if (kind.startsWith('i')) return 'int32'\n  return 'float32'\n}\n\n// Shared attribute helper functions\n// between attributeView and interleavedAttributeView\nfunction handleAttribute(\n  gl: GL,\n  location: number,\n  size: number,\n  stride: number,\n  offset: number,\n  glType: GLType,\n  isIntegerKind: boolean,\n  normalized: boolean,\n  instanced?: boolean,\n) {\n  gl.enableVertexAttribArray(location)\n  if (isIntegerKind) {\n    ;(gl as WebGL2RenderingContext).vertexAttribIPointer(location, size, gl[glType], stride, offset)\n  } else {\n    gl.vertexAttribPointer(location, size, gl[glType], normalized, stride, offset)\n  }\n\n  // Always stated, never inherited: the divisor belongs to the location rather\n  // than to the program, so a location left at 1 by an earlier instanced\n  // attribute would feed one value to every vertex here.\n  // Get instanced-arrays-feature: extension if webgl, gl if webgl2\n  const instancedArrays = getInstancedArrays(gl)\n  if (instanced) {\n    assertedNotNullish(instancedArrays).vertexAttribDivisor(location, 1)\n  } else if (instancedArrays) {\n    instancedArrays.vertexAttribDivisor(location, 0)\n  }\n}\n\n// Same enum in webgl2 and in the webgl1 extensions, which expose no constants\nconst VERTEX_ATTRIB_ARRAY_DIVISOR = 0x88fe\nconst VERTEX_ARRAY_BINDING = 0x85b5\n\n// Anything but an array or null would make the restore throw a TypeError.\nfunction readVertexArrayBinding(gl: GL): WebGLVertexArrayObject | null {\n  const bound: unknown = gl.getParameter(VERTEX_ARRAY_BINDING)\n  return typeof bound === 'object' ? (bound as WebGLVertexArrayObject | null) : null\n}\n\n// Reads the divisor currently attached to a location, 0 where instancing is\n// unavailable and nothing can have set one\nfunction readDivisor(gl: GL, location: number): number {\n  return getInstancedArrays(gl)\n    ? (gl.getVertexAttrib(location, VERTEX_ATTRIB_ARRAY_DIVISOR) as number)\n    : 0\n}\n\nexport function attributeView<T extends AttributeSchema>(\n  gl: GL,\n  program: WebGLProgram,\n  schema: T,\n  { signal }: ViewOptions = {},\n): AttributeView<T> {\n  const attributes = mapObject(\n    schema,\n    (\n      { kind, format, normalized = false, instanced, buffer: providedBuffer },\n      key,\n    ): AttributeMethods => {\n      const name = toID(key)\n\n      // Whoever made the buffer deletes it. A schema can name a buffer that\n      // belongs to another view — an attribute two programs step over — and\n      // deleting one of those would take it out from under its owner.\n      const buffer = providedBuffer ?? created(gl.createBuffer(), 'buffer')\n\n      const location = gl.getAttribLocation(program, name)\n      if (location < 0) {\n        throw new AttributeNotFoundError(name)\n      }\n\n      const size = kindToSize(kind)\n      const resolvedFormat = format ?? defaultFormat(kind)\n      const glType = FORMAT_TO_GL_TYPE[resolvedFormat]\n      const isIntKind = kind.startsWith('i') || kind.startsWith('u')\n\n      function applyToVertexArray() {\n        // Snapshot before the change, restore in the disposer\n        const previousDivisor = readDivisor(gl, location)\n        // vertexAttribPointer captures whatever is bound to ARRAY_BUFFER when\n        // it runs, so this binding is the setup for the pointer, not a lasting\n        // part of the vertex array's state.\n        gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n        handleAttribute(gl, location, size, 0, 0, glType, isIntKind, normalized, instanced)\n        return once(() => {\n          getInstancedArrays(gl)?.vertexAttribDivisor(location, previousDivisor)\n        })\n      }\n\n      return {\n        buffer,\n        applyToVertexArray,\n        bind() {\n          const restoreVertexArray = bindDefaultVertexArray(gl)\n          const restore = applyToVertexArray()\n          return once(() => {\n            restore()\n            restoreVertexArray()\n          })\n        },\n        dispose: once(() => {\n          if (!providedBuffer) {\n            gl.deleteBuffer(buffer)\n          }\n        }),\n        set(data, usage = 'STATIC_DRAW') {\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferData(gl.ARRAY_BUFFER, data, gl[usage])\n          return this\n        },\n        allocate(length, usage = 'STATIC_DRAW') {\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferData(gl.ARRAY_BUFFER, length * FORMAT_BYTE_SIZE[resolvedFormat], gl[usage])\n          return this\n        },\n        write(data, offset) {\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferSubData(gl.ARRAY_BUFFER, offset * FORMAT_BYTE_SIZE[resolvedFormat], data)\n          return this\n        },\n      }\n    },\n  )\n\n  signal?.addEventListener('abort', function dispose() {\n    forEachObject(attributes, value => value.dispose())\n  })\n\n  return attributes\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                               Interleaved Attribute View                       */\n/*                                                                                */\n/**********************************************************************************/\n\n/**\n * The other place an attribute's value can come from: not a buffer, but the\n * context's current generic vertex attribute values, which an attribute reads\n * for every vertex when its array is disabled.\n *\n * A constant is a uniform in all but name — one value for the whole draw, set\n * by a function chosen from the kind — so it gets the setters a uniform gets,\n * off the same layout the buffer source uses.\n *\n * `vertexAttrib*` tops out at four floats and has no matrix form, so a layout\n * key that is fine in a buffer can be impossible as a constant. That is a hard\n * limit of the API rather than a choice, and it is worth saying so out loud at\n * the point someone reaches for it.\n */\nfunction constantSource(gl: GL, layout: InterleavedAttributeLayout[], locations: number[]) {\n  const setters = layout.map((entry, index) => {\n    const size = kindToSize(entry.kind)\n    const name = toID(entry.key)\n    if (isMatKind(entry.kind) || size > 4) {\n      throw new Error(\n        `'${name}' is a ${entry.kind}, which cannot be a constant attribute: vertexAttrib* takes at most 4 floats and has no matrix form. Use the buffer source for it.`,\n      )\n    }\n    // The values are context state, not vertex-array state, so they are held\n    // here and written again on every bind — see applyToContext.\n    let values: number[] = []\n    const fn = gl[`vertexAttrib${size as 1 | 2 | 3 | 4}f`].bind(gl)\n    return {\n      name,\n      location: locations[index]!,\n      write: () => {\n        if (values.length) {\n          ;(fn as (location: number, ...args: number[]) => void)(locations[index]!, ...values)\n        }\n      },\n      methods: {\n        set(...args: number[]) {\n          values = args\n        },\n      },\n    }\n  })\n\n  return Object.assign(Object.fromEntries(setters.map(setter => [setter.name, setter.methods])), {\n    applyToVertexArray() {\n      const restores = setters.map(({ location }) => {\n        const wasEnabled = gl.getVertexAttrib(location, gl.VERTEX_ATTRIB_ARRAY_ENABLED) as boolean\n        gl.disableVertexAttribArray(location)\n        return () => (wasEnabled ? gl.enableVertexAttribArray(location) : undefined)\n      })\n      return once(() => restores.forEach(restore => restore()))\n    },\n    applyToContext() {\n      setters.forEach(setter => setter.write())\n    },\n    bind() {\n      const restoreVertexArray = bindDefaultVertexArray(gl)\n      const restore = this.applyToVertexArray()\n      this.applyToContext()\n      return once(() => {\n        restore()\n        restoreVertexArray()\n      })\n    },\n  })\n}\n\nexport function interleavedAttributeView<T extends InterleavedAttributeSchema>(\n  gl: GL,\n  program: WebGLProgram,\n  schema: T,\n  { signal }: ViewOptions = {},\n): InterleavedAttributeView<T> {\n  // Initialize interleaved attributes\n  const interleavedAttributes = mapObject(schema, ({ layout }) => {\n    // Increment number to keep track of offset\n    let index = 0\n\n    // Calculate layout information\n    const locations: number[] = []\n    const handles = layout.map(layout => {\n      const name = toID(layout.key)\n\n      const location = gl.getAttribLocation(program, name)\n\n      if (location < 0) {\n        throw new AttributeNotFoundError(name)\n      }\n\n      locations.push(location)\n\n      const size = kindToSize(layout.kind)\n      const offset = index\n      const resolvedFormat = layout.format ?? defaultFormat(layout.kind)\n      const glType = FORMAT_TO_GL_TYPE[resolvedFormat]\n      const isIntKind = layout.kind.startsWith('i') || layout.kind.startsWith('u')\n      const normalized = layout.normalized ?? false\n      index += size * FORMAT_BYTE_SIZE[resolvedFormat]\n\n      return (divisor: 0 | 1) =>\n        handleAttribute(\n          gl,\n          location,\n          size,\n          stride,\n          offset,\n          glType,\n          isIntKind,\n          normalized,\n          divisor === 1,\n        )\n    })\n\n    // Set stride to final index\n    const stride = index\n\n    // Create a buffer\n    const buffer = created(gl.createBuffer(), 'buffer')\n\n    // This layout used to create a vertex array of its own, here, which is why\n    // the other participants in a draw had to be bound after it to be included\n    // — the array they landed in was whichever one happened to be current.\n    // Arrays are `vao()`'s job now; a layout is a layout and a buffer.\n    function applyToVertexArray(divisor: 0 | 1) {\n      const previousDivisors = locations.map(\n        location => [location, readDivisor(gl, location)] as const,\n      )\n      gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n      for (const handle of handles) {\n        handle(divisor)\n      }\n      return once(() => {\n        const instancedArrays = getInstancedArrays(gl)\n        previousDivisors.forEach(([location, previous]) => {\n          instancedArrays?.vertexAttribDivisor(location, previous)\n        })\n      })\n    }\n\n    let constant: ReturnType<typeof constantSource> | undefined\n\n    /** One layout, one buffer, but a divisor per draw rather than per schema. */\n    function bufferSource(divisor: 0 | 1) {\n      const apply = () => applyToVertexArray(divisor)\n      return {\n        applyToVertexArray: apply,\n        bind() {\n          const restoreVertexArray = bindDefaultVertexArray(gl)\n          const restore = apply()\n          return once(() => {\n            restore()\n            restoreVertexArray()\n          })\n        },\n      }\n    }\n\n    return {\n      buffer: Object.assign(bufferSource(0), {\n        /** The same buffer, stepped once per instance instead of once per vertex. */\n        perInstance: bufferSource(1),\n        set(value: Float32Array, usage: GLUsage = 'STATIC_DRAW') {\n          // Uploading is storage, not binding: ARRAY_BUFFER is not vertex-array\n          // state, so this touches no array, whichever one is bound.\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferData(gl.ARRAY_BUFFER, value, gl[usage])\n        },\n        allocate(length: number, usage: GLUsage = 'STATIC_DRAW') {\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferData(gl.ARRAY_BUFFER, length * Float32Array.BYTES_PER_ELEMENT, gl[usage])\n        },\n        write(data: Float32Array, offset: number) {\n          gl.bindBuffer(gl.ARRAY_BUFFER, buffer)\n          gl.bufferSubData(gl.ARRAY_BUFFER, offset * Float32Array.BYTES_PER_ELEMENT, data)\n        },\n      }),\n      // Lazy: a layout key can be perfectly good in a buffer and impossible as\n      // a constant, and finding that out should wait until someone asks for one.\n      get constant() {\n        return (constant ??= constantSource(gl, layout, locations))\n      },\n      dispose: once(() => gl.deleteBuffer(buffer)),\n    } satisfies InterleavedAttributeMethods\n  })\n\n  signal?.addEventListener('abort', function dispose() {\n    forEachObject(interleavedAttributes, value => value.dispose())\n  })\n\n  return interleavedAttributes\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                     Buffer View                                */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function bufferView<T extends BufferSchema>(\n  gl: GL,\n  schema: T,\n  { signal }: ViewOptions = {},\n): BufferView<T> {\n  // Initialize buffers\n  const buffers = mapObject(schema, ({ target = 'ARRAY_BUFFER', usage = 'STATIC_DRAW' }) => {\n    const buffer = created(gl.createBuffer(), 'buffer')\n\n    function applyToVertexArray() {\n      // Snapshot before the change, restore in the disposer. Restoring the\n      // previous buffer rather than null matters for ELEMENT_ARRAY_BUFFER,\n      // whose binding is recorded in the bound vertex array: clearing it\n      // would strip the index buffer from an array the caller may not own.\n      const previousBuffer = gl.getParameter(gl[`${target}_BINDING`]) as WebGLBuffer | null\n      gl.bindBuffer(gl[target], buffer)\n      return once(() => {\n        gl.bindBuffer(gl[target], previousBuffer)\n      })\n    }\n\n    return {\n      applyToVertexArray,\n      bind() {\n        // ELEMENT_ARRAY_BUFFER's binding belongs to the bound vertex array, so\n        // like the attributes this has to say which array it means. ARRAY_BUFFER\n        // is context state and unaffected either way.\n        const restoreVertexArray = bindDefaultVertexArray(gl)\n        const restore = applyToVertexArray()\n        return once(() => {\n          restore()\n          restoreVertexArray()\n        })\n      },\n      dispose: once(() => gl.deleteBuffer(buffer)),\n      set(data: Float32Array) {\n        gl.bindBuffer(gl[target], buffer)\n        gl.bufferData(gl[target], data, gl[usage])\n      },\n      allocate(byteLength: number) {\n        gl.bindBuffer(gl[target], buffer)\n        gl.bufferData(gl[target], byteLength, gl[usage])\n      },\n      write(data: Float32Array | Uint16Array | Uint32Array, byteOffset: number) {\n        gl.bindBuffer(gl[target], buffer)\n        gl.bufferSubData(gl[target], byteOffset, data)\n      },\n    }\n  })\n\n  signal?.addEventListener('abort', function dispose() {\n    forEachObject(buffers, value => value.dispose())\n  })\n\n  return buffers\n}\n"],"mappings":"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","names":["location","index","layout"]}

package/dist/{chunk-BZDGEIOT.mjs → chunk-BDNRC4WD.mjs}

@@ -1,3 +1,42 @@
+// src/errors.ts
+var ShaderCompileError = class extends Error {
+  constructor(stage, infoLog, glError) {
+    super(`Failed to compile ${stage} shader: ${infoLog}`);
+    this.stage = stage;
+    this.infoLog = infoLog;
+    this.glError = glError;
+  }
+  name = "ShaderCompileError";
+};
+var ProgramLinkError = class extends Error {
+  constructor(infoLog, glError) {
+    super(`Failed to link program: ${infoLog}`);
+    this.infoLog = infoLog;
+    this.glError = glError;
+  }
+  name = "ProgramLinkError";
+};
+var GLCreateError = class extends Error {
+  constructor(resource) {
+    super(`Failed to create ${resource}`);
+    this.resource = resource;
+  }
+  name = "GLCreateError";
+};
+var AttributeNotFoundError = class extends Error {
+  constructor(attribute) {
+    super(`Attribute '${attribute}' not found`);
+    this.attribute = attribute;
+  }
+  name = "AttributeNotFoundError";
+};
+function created(value, resource) {
+  if (value === null) {
+    throw new GLCreateError(resource);
+  }
+  return value;
+}
+
 // src/utils.ts
 function assertedNotNullish(value, message) {
   if (value === void 0 || value === null) throw new Error(message);
@@ -67,7 +106,7 @@ function createTexture(gl, {
   width,
   height
 }, data, { signal } = {}) {
-  const texture = assertedNotNullish(gl.createTexture(), "Failed to create texture");
+  const texture = created(gl.createTexture(), "texture");
   function getTextureConstant(name) {
     if (!(name in gl)) {
       throw new Error(`Attempted to create webgl2-only texture (${name}) in webgl1`);
@@ -126,7 +165,7 @@ var FramebufferError = class extends Error {
 };
 function createFramebuffer(gl, { attachment, texture: providedTexture, ...definition }, { signal } = {}) {
   const texture = providedTexture ?? createTexture(gl, definition);
-  const framebuffer = assertedNotNullish(gl.createFramebuffer(), "Failed to create framebuffer");
+  const framebuffer = created(gl.createFramebuffer(), "framebuffer");
   gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
   gl.framebufferTexture2D(
     gl.FRAMEBUFFER,
@@ -191,33 +230,33 @@ function isWebGL2RenderingContext(gl) {
   return typeof WebGL2RenderingContext !== "undefined" && gl instanceof WebGL2RenderingContext;
 }
 function createShader(gl, type, source) {
-  const shader = gl.createShader(type);
-  if (!shader) throw new Error("Failed to create shader");
+  const shader = created(gl.createShader(type), "shader");
   gl.shaderSource(shader, source);
   gl.compileShader(shader);
   if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
-    const info = gl.getShaderInfoLog(shader);
-    gl.deleteShader(shader);
-    throw new Error(
-      `Failed to compile ${type === gl.VERTEX_SHADER ? "vertex" : "fragment"} shader: ${info}`
+    const error = new ShaderCompileError(
+      type === gl.VERTEX_SHADER ? "vertex" : "fragment",
+      gl.getShaderInfoLog(shader),
+      gl.getError()
     );
+    gl.deleteShader(shader);
+    throw error;
   }
   return shader;
 }
 function createProgram(gl, vertexSource, fragmentSource, { signal } = {}) {
-  const program = gl.createProgram();
-  if (!program) throw new Error("Failed to create WebGL program");
+  const program = created(gl.createProgram(), "program");
   const vertexShader = createShader(gl, gl.VERTEX_SHADER, vertexSource);
   const fragmentShader = createShader(gl, gl.FRAGMENT_SHADER, fragmentSource);
   gl.attachShader(program, vertexShader);
   gl.attachShader(program, fragmentShader);
   gl.linkProgram(program);
   if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
-    const info = gl.getProgramInfoLog(program);
+    const error = new ProgramLinkError(gl.getProgramInfoLog(program), gl.getError());
     gl.deleteProgram(program);
     gl.deleteShader(vertexShader);
     gl.deleteShader(fragmentShader);
-    throw new Error(`Failed to link program: ${info}`);
+    throw error;
   }
   gl.deleteShader(vertexShader);
   gl.deleteShader(fragmentShader);
@@ -227,38 +266,33 @@ function createProgram(gl, vertexSource, fragmentSource, { signal } = {}) {
   );
   return program;
 }
-var INSTANCED_ARRAYS_WRAPPER_MAP = /* @__PURE__ */ new WeakMap();
 function getInstancedArrays(gl) {
   if (isWebGL2RenderingContext(gl)) return gl;
-  const cached = INSTANCED_ARRAYS_WRAPPER_MAP.get(gl);
-  if (cached) return cached;
   const ext = gl.getExtension("ANGLE_instanced_arrays");
   if (!ext) return void 0;
-  const wrapper = {
+  return {
     drawArraysInstanced: ext.drawArraysInstancedANGLE.bind(ext),
     drawElementsInstanced: ext.drawElementsInstancedANGLE.bind(ext),
     vertexAttribDivisor: ext.vertexAttribDivisorANGLE.bind(ext)
   };
-  INSTANCED_ARRAYS_WRAPPER_MAP.set(gl, wrapper);
-  return wrapper;
 }
-var VERTEX_ARRAY_OBJECT_WRAPPER_MAP = /* @__PURE__ */ new WeakMap();
 function getVertexArrayObject(gl) {
   if (isWebGL2RenderingContext(gl)) return gl;
-  const cached = VERTEX_ARRAY_OBJECT_WRAPPER_MAP.get(gl);
-  if (cached) return cached;
   const ext = gl.getExtension("OES_vertex_array_object");
   if (!ext) return null;
-  const wrapper = {
+  return {
     bindVertexArray: ext.bindVertexArrayOES.bind(ext),
     createVertexArray: ext.createVertexArrayOES.bind(ext),
     deleteVertexArray: ext.deleteVertexArrayOES.bind(ext)
   };
-  VERTEX_ARRAY_OBJECT_WRAPPER_MAP.set(gl, wrapper);
-  return wrapper;
 }
 
 export {
+  ShaderCompileError,
+  ProgramLinkError,
+  GLCreateError,
+  AttributeNotFoundError,
+  created,
   assertedNotNullish,
   once,
   kindToUniformFnName,
@@ -275,4 +309,4 @@ export {
   getInstancedArrays,
   getVertexArrayObject
 };
-//# sourceMappingURL=chunk-BZDGEIOT.mjs.map
+//# sourceMappingURL=chunk-BDNRC4WD.mjs.map

package/dist/chunk-BDNRC4WD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/utils.ts","../src/gl.ts"],"sourcesContent":["/**\n * A shader that did not compile. `infoLog` is what the driver answered, `null`\n * and `''` kept apart; `glError` is `getError()` read at the failure.\n */\nexport class ShaderCompileError extends Error {\n  override name = 'ShaderCompileError'\n\n  constructor(\n    readonly stage: 'vertex' | 'fragment',\n    readonly infoLog: string | null,\n    readonly glError: number,\n  ) {\n    super(`Failed to compile ${stage} shader: ${infoLog}`)\n  }\n}\n\n/**\n * A program that did not link. `infoLog` is what the driver answered, `null`\n * and `''` kept apart; `glError` is `getError()` read at the failure.\n */\nexport class ProgramLinkError extends Error {\n  override name = 'ProgramLinkError'\n\n  constructor(\n    readonly infoLog: string | null,\n    readonly glError: number,\n  ) {\n    super(`Failed to link program: ${infoLog}`)\n  }\n}\n\nexport type GLResource = 'shader' | 'program' | 'buffer' | 'vertexArray' | 'texture' | 'framebuffer'\n\n/** A `create*` call that answered `null`. */\nexport class GLCreateError extends Error {\n  override name = 'GLCreateError'\n\n  constructor(readonly resource: GLResource) {\n    super(`Failed to create ${resource}`)\n  }\n}\n\n/** A program with no active attribute of that name: `getAttribLocation` answered -1. */\nexport class AttributeNotFoundError extends Error {\n  override name = 'AttributeNotFoundError'\n\n  constructor(readonly attribute: string) {\n    super(`Attribute '${attribute}' not found`)\n  }\n}\n\n/** Throws a {@link GLCreateError} for a `create*` that answered `null`. */\nexport function created<T>(value: T | null, resource: GLResource): T {\n  if (value === null) {\n    throw new GLCreateError(resource)\n  }\n  return value\n}\n","import { created } from './errors'\nimport type {\n  AttributeKind,\n  FramebufferDefinition,\n  GL,\n  KIND_TO_SIZE_MAP,\n  KIND_TO_UNIFORM_FN_NAME_MAP,\n  TextureDefinition,\n  UniformKind,\n  ViewOptions,\n} from './types'\n\nexport function assertedNotNullish<T>(value: T, message?: string): NonNullable<T> {\n  if (value === undefined || value === null) throw new Error(message)\n  return value\n}\n\n/**\n * Wraps a teardown so it runs once.\n *\n * Two reasons, and both bite. A disposer is per `bind()`, and undoing twice\n * would put back state a later `bind()` is relying on. And a `dispose()` that\n * deletes twice invalidates a handle someone else may still be holding — the\n * object survives while it is bound, so the fault surfaces later, somewhere\n * else. Idempotent is the only safe shape for either.\n */\nexport function once(teardown: () => void): () => void {\n  let done = false\n  return () => {\n    if (done) return\n    done = true\n    teardown()\n  }\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                              Kind To Uniform Name                              */\n/*                                                                                */\n/**********************************************************************************/\n\nexport const kindToUniformFnName = <T extends UniformKind>(\n  kind: T,\n): KIND_TO_UNIFORM_FN_NAME_MAP[T] => {\n  switch (kind[0]) {\n    // mat\n    case 'm':\n      return ('Matrix' + kind.slice(3) + 'fv') as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n    // sampler/booleans/integer\n    case 's':\n    case 'b':\n    case 'i':\n      return ((kind.match(/\\d/)?.[0] ?? '1') + 'i') as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n    // unsigned integers\n    case 'u':\n      return ((kind[4] || '1') + 'ui') as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n    // vec\n    case 'v':\n      return (kind[3] + 'f') as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n    default:\n      switch (kind) {\n        case 'float':\n          return '1f' as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n        case 'uint':\n          return '1ui' as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n        default:\n          return '1i' as KIND_TO_UNIFORM_FN_NAME_MAP[T]\n      }\n  }\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                   Kind To Size                                 */\n/*                                                                                */\n/**********************************************************************************/\n\nexport const kindToSize = <T extends UniformKind>(kind: T): KIND_TO_SIZE_MAP[T] => {\n  switch (kind[0]) {\n    case 'm':\n      const [a, b] = kind.match(/\\d+/g)!.map(Number) as [number, number?]\n      return (a * (b ?? a)) as KIND_TO_SIZE_MAP[T]\n    case 'v':\n    case 'i':\n    case 'b':\n    case 'u':\n      const match = kind.match(/\\d/) as [string] | undefined\n      return (match ? +match[0] : 1) as KIND_TO_SIZE_MAP[T]\n    default:\n      return 1 as KIND_TO_SIZE_MAP[T]\n  }\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                      Guards                                    */\n/*                                                                                */\n/**********************************************************************************/\n\nexport const isMatKind = <\n  T extends UniformKind | AttributeKind,\n  TPrefix extends string,\n  TPostfix extends string,\n>(\n  kind: T,\n): kind is T & `${TPrefix}mat${TPostfix}` => kind.includes('mat')\n\nexport const isSamplerKind = <TPrefix extends string, TPostfix extends string>(\n  kind: UniformKind,\n): kind is UniformKind & `${TPrefix}sampler${TPostfix}` => kind.includes('sampler')\n\nexport const isVecKind = <TPrefix extends string, TPostfix extends string>(\n  kind: UniformKind,\n): kind is UniformKind & `${TPrefix}vec${TPostfix}` => kind.includes('vec')\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                  Create Texture                                */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function createTexture(\n  gl: GL,\n  {\n    target = 'TEXTURE_2D',\n    internalFormat = 'RGBA',\n    format = 'RGBA',\n    type = 'UNSIGNED_BYTE',\n    minFilter = 'NEAREST',\n    magFilter = 'NEAREST',\n    wrapS = 'CLAMP_TO_EDGE',\n    wrapT = 'CLAMP_TO_EDGE',\n    width,\n    height,\n  }: TextureDefinition,\n  data?: ArrayBufferView | null,\n  { signal }: ViewOptions = {},\n): WebGLTexture {\n  const texture = created(gl.createTexture(), 'texture')\n\n  function getTextureConstant(name: string) {\n    if (!(name in gl)) {\n      throw new Error(`Attempted to create webgl2-only texture (${name}) in webgl1`)\n    }\n    return gl[name as keyof typeof gl] as any\n  }\n\n  gl.bindTexture(gl[target], texture)\n  gl.texImage2D(\n    gl[target],\n    0,\n    getTextureConstant(internalFormat),\n    width,\n    height,\n    0,\n    getTextureConstant(format),\n    getTextureConstant(type),\n    data ?? null,\n  )\n\n  // Set texture parameters\n  gl.texParameteri(gl[target], gl.TEXTURE_MIN_FILTER, gl[minFilter])\n  gl.texParameteri(gl[target], gl.TEXTURE_MAG_FILTER, gl[magFilter])\n  gl.texParameteri(gl[target], gl.TEXTURE_WRAP_S, gl[wrapS])\n  gl.texParameteri(gl[target], gl.TEXTURE_WRAP_T, gl[wrapT])\n\n  signal?.addEventListener(\n    'abort',\n    once(() => gl.deleteTexture(texture)),\n  )\n\n  return texture\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                               Create Framebuffer                               */\n/*                                                                                */\n/**********************************************************************************/\n\nconst FRAMEBUFFER_ATTACHMENT_MAP = {\n  color: 'COLOR_ATTACHMENT0',\n  depth: 'DEPTH_ATTACHMENT',\n  stencil: 'STENCIL_ATTACHMENT',\n  depthStencil: 'DEPTH_STENCIL_ATTACHMENT',\n} as const\n\nclass FramebufferError extends Error {\n  constructor(gl: GL, status: number) {\n    let errorMessage = 'Framebuffer not complete. Status: '\n    switch (status) {\n      case gl.FRAMEBUFFER_INCOMPLETE_ATTACHMENT:\n        errorMessage += 'FRAMEBUFFER_INCOMPLETE_ATTACHMENT'\n        break\n      case gl.FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT:\n        errorMessage += 'FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT'\n        break\n      case gl.FRAMEBUFFER_INCOMPLETE_DIMENSIONS:\n        errorMessage += 'FRAMEBUFFER_INCOMPLETE_DIMENSIONS'\n        break\n      case gl.FRAMEBUFFER_UNSUPPORTED:\n        errorMessage += 'FRAMEBUFFER_UNSUPPORTED'\n        break\n      default:\n        errorMessage += `Unknown (${status})`\n    }\n    super(errorMessage)\n  }\n}\n\nexport function createFramebuffer(\n  gl: GL,\n  { attachment, texture: providedTexture, ...definition }: FramebufferDefinition,\n  { signal }: ViewOptions = {},\n) {\n  // Create texture for the framebuffer, unless one was handed in. Which one it\n  // is decides who deletes it below — the same rule the attribute buffers follow.\n  const texture = providedTexture ?? createTexture(gl, definition)\n\n  // Create framebuffer\n  const framebuffer = created(gl.createFramebuffer(), 'framebuffer')\n\n  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer)\n\n  gl.framebufferTexture2D(\n    gl.FRAMEBUFFER,\n    // Determine attachment point based on attachment kind\n    gl[FRAMEBUFFER_ATTACHMENT_MAP[attachment]],\n    gl.TEXTURE_2D,\n    texture,\n    0,\n  )\n\n  // Check framebuffer completeness\n  const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER)\n  if (status !== gl.FRAMEBUFFER_COMPLETE) {\n    throw new FramebufferError(gl, status)\n  }\n\n  const dispose = once(() => {\n    gl.deleteFramebuffer(framebuffer)\n    // A texture handed in belongs to whoever made it — it commonly outlives the\n    // framebuffer, ping-ponged between two of them.\n    if (!providedTexture) {\n      gl.deleteTexture(texture)\n    }\n  })\n\n  signal?.addEventListener('abort', dispose)\n\n  return {\n    texture,\n    framebuffer,\n    dispose,\n  }\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                  Create Upsert                                 */\n/*                                                                                */\n/**********************************************************************************/\n\ntype UpsertMapKind<T, U> = Map<T, U> | (T extends WeakKey ? WeakMap<T, U> : never)\n\nexport function createUpsertMap<T extends UpsertMapKind<any, any> = Map<any, any>>(\n  constructor?: new () => T,\n) {\n  const map = new (constructor ?? Map)() as T\n  return Object.assign(map, {\n    getOrInsert(\n      key: T extends UpsertMapKind<infer U, any> ? U : never,\n      value: T extends UpsertMapKind<any, infer U> ? () => U : never,\n    ) {\n      let result = map.get(key)\n      if (result) {\n        return result\n      }\n      result = value()\n      map.set(key, result)\n      return result\n    },\n  })\n}\n\nexport function forEachObject<T extends Record<string, any>>(\n  value: T,\n  callback: (value: T[keyof T], key: keyof T, index: number) => void,\n) {\n  let index = 0\n  for (const key in value) {\n    callback(value[key], key, index)\n    index++\n  }\n  for (const key of Object.getOwnPropertySymbols(value)) {\n    callback(value[key as keyof T], key as keyof T, index)\n    index++\n  }\n}\n\nexport function mapObject<T extends Record<string, any>, TReturn>(\n  value: T,\n  callback: (value: T[keyof T], key: keyof T, index: number) => TReturn,\n): { [TKey in keyof T]: TReturn } {\n  const result = {} as { [TKey in keyof T]: TReturn }\n\n  forEachObject(value, (value, key, index) => {\n    result[key] = callback(value, key, index)\n  })\n\n  return result\n}\n","import type { GL, ViewOptions } from './types'\nimport { created, ProgramLinkError, ShaderCompileError } from './errors'\nimport { once } from './utils'\n\nfunction isWebGL2RenderingContext(\n  gl: WebGLRenderingContext | WebGL2RenderingContext,\n): gl is WebGL2RenderingContext {\n  return typeof WebGL2RenderingContext !== 'undefined' && gl instanceof WebGL2RenderingContext\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                 Create Shader                                  */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function createShader(gl: GL, type: number, source: string): WebGLShader {\n  const shader = created(gl.createShader(type), 'shader')\n\n  gl.shaderSource(shader, source)\n  gl.compileShader(shader)\n\n  if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {\n    const error = new ShaderCompileError(\n      type === gl.VERTEX_SHADER ? 'vertex' : 'fragment',\n      gl.getShaderInfoLog(shader),\n      gl.getError(),\n    )\n    gl.deleteShader(shader)\n    throw error\n  }\n\n  return shader\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                Create Program                                  */\n/*                                                                                */\n/**********************************************************************************/\n\nexport function createProgram(\n  gl: GL,\n  vertexSource: string,\n  fragmentSource: string,\n  { signal }: ViewOptions = {},\n): WebGLProgram {\n  const program = created(gl.createProgram(), 'program')\n\n  const vertexShader = createShader(gl, gl.VERTEX_SHADER, vertexSource)\n  const fragmentShader = createShader(gl, gl.FRAGMENT_SHADER, fragmentSource)\n\n  gl.attachShader(program, vertexShader)\n  gl.attachShader(program, fragmentShader)\n  gl.linkProgram(program)\n\n  if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {\n    const error = new ProgramLinkError(gl.getProgramInfoLog(program), gl.getError())\n    gl.deleteProgram(program)\n    gl.deleteShader(vertexShader)\n    gl.deleteShader(fragmentShader)\n    throw error\n  }\n\n  // Clean up shaders after linking\n  gl.deleteShader(vertexShader)\n  gl.deleteShader(fragmentShader)\n\n  signal?.addEventListener(\n    'abort',\n    once(() => gl.deleteProgram(program)),\n  )\n\n  return program\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                              Get Instanced Arrays                              */\n/*                                                                                */\n/**********************************************************************************/\n\n/** Instancing on `gl`: the context on WebGL2, `ANGLE_instanced_arrays` on WebGL1, else `undefined`. */\nexport function getInstancedArrays(gl: GL) {\n  if (isWebGL2RenderingContext(gl)) return gl\n\n  const ext = gl.getExtension('ANGLE_instanced_arrays')\n  if (!ext) return undefined\n\n  return {\n    drawArraysInstanced: ext.drawArraysInstancedANGLE.bind(ext),\n    drawElementsInstanced: ext.drawElementsInstancedANGLE.bind(ext),\n    vertexAttribDivisor: ext.vertexAttribDivisorANGLE.bind(ext),\n  }\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                             Get Vertex Array Object                            */\n/*                                                                                */\n/**********************************************************************************/\n\n/** Vertex arrays on `gl`: the context on WebGL2, `OES_vertex_array_object` on WebGL1, else `null`. */\nexport function getVertexArrayObject(gl: GL) {\n  if (isWebGL2RenderingContext(gl)) return gl\n\n  const ext = gl.getExtension('OES_vertex_array_object')\n  if (!ext) return null\n\n  return {\n    bindVertexArray: ext.bindVertexArrayOES.bind(ext),\n    createVertexArray: ext.createVertexArrayOES.bind(ext),\n    deleteVertexArray: ext.deleteVertexArrayOES.bind(ext),\n  }\n}\n"],"mappings":"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","names":["value"]}

package/dist/gl.d.mts

@@ -1,4 +1,4 @@
-import { G as GL, V as ViewOptions, R as RemoveSuffix } from './types-DZbMcty2.mjs';
+import { G as GL, V as ViewOptions } from './types-Cy9u5YKs.mjs';
 
 /**********************************************************************************/
 /**********************************************************************************/
@@ -6,7 +6,21 @@ declare function createShader(gl: GL, type: number, source: string): WebGLShader
 /**********************************************************************************/
 /**********************************************************************************/
 declare function createProgram(gl: GL, vertexSource: string, fragmentSource: string, { signal }?: ViewOptions): WebGLProgram;
-declare function getInstancedArrays(gl: GL): RemoveSuffix<Pick<ANGLE_instanced_arrays, "drawArraysInstancedANGLE" | "drawElementsInstancedANGLE" | "vertexAttribDivisorANGLE">, "ANGLE"> | undefined;
-declare function getVertexArrayObject(gl: GL): RemoveSuffix<Pick<OES_vertex_array_object, "bindVertexArrayOES" | "createVertexArrayOES" | "deleteVertexArrayOES">, "OES"> | null;
+/**********************************************************************************/
+/**********************************************************************************/
+/** Instancing on `gl`: the context on WebGL2, `ANGLE_instanced_arrays` on WebGL1, else `undefined`. */
+declare function getInstancedArrays(gl: GL): WebGL2RenderingContext | {
+    drawArraysInstanced: (mode: GLenum, first: GLint, count: GLsizei, primcount: GLsizei) => void;
+    drawElementsInstanced: (mode: GLenum, count: GLsizei, type: GLenum, offset: GLintptr, primcount: GLsizei) => void;
+    vertexAttribDivisor: (index: GLuint, divisor: GLuint) => void;
+} | undefined;
+/**********************************************************************************/
+/**********************************************************************************/
+/** Vertex arrays on `gl`: the context on WebGL2, `OES_vertex_array_object` on WebGL1, else `null`. */
+declare function getVertexArrayObject(gl: GL): WebGL2RenderingContext | {
+    bindVertexArray: (arrayObject: WebGLVertexArrayObjectOES | null) => void;
+    createVertexArray: () => WebGLVertexArrayObjectOES;
+    deleteVertexArray: (arrayObject: WebGLVertexArrayObjectOES | null) => void;
+} | null;
 
 export { createProgram, createShader, getInstancedArrays, getVertexArrayObject };

package/dist/gl.mjs

@@ -3,7 +3,7 @@ import {
   createShader,
   getInstancedArrays,
   getVertexArrayObject
-} from "./chunk-BZDGEIOT.mjs";
+} from "./chunk-BDNRC4WD.mjs";
 export {
   createProgram,
   createShader,

package/dist/index.d.mts

@@ -1,5 +1,42 @@
-import { G as GL, F as FramebufferDefinition, V as ViewOptions, T as TextureDefinition, a as ViewSchema, b as View, c as VertexArrayParticipant, d as VertexArrayMethods, U as UniformSchema, e as UniformView, A as AttributeSchema, f as AttributeView, I as InterleavedAttributeSchema, g as InterleavedAttributeView, B as BufferSchema, h as BufferView } from './types-DZbMcty2.mjs';
-export { D as AttributeDefinition, C as AttributeFormat, z as AttributeKind, E as AttributeMethods, y as AttributeShortHand, ac as AttributeToken, ad as AttributeTokenFn, P as BufferDefinition, Q as BufferMethods, L as BufferSource, ak as CompileResult, M as ConstantAttributeMethods, N as ConstantSource, ai as FlattenSlots, a3 as Format, W as Framebuffer, a9 as GLSL, a7 as GLSLResult, a8 as GLSLSlot, ah as GLSLSlotsToSchema, af as GLSLToSchema, ag as GLSLToView, i as GLTarget, n as GLTextureFilter, l as GLTextureFormat, k as GLTextureTarget, m as GLTextureType, o as GLTextureWrap, j as GLUsage, ae as InterleaveToken, J as InterleavedAttributeDefinition, H as InterleavedAttributeLayout, O as InterleavedAttributeMethods, a2 as InternalFormat, p as KIND_TO_SIZE_MAP, K as KIND_TO_UNIFORM_FN_NAME_MAP, aj as MergeGLSLSchema, a4 as PixelType, S as Source, a5 as TexImage2DOptions, Z as TextureMethods, $ as TextureParameterName, a0 as TextureParameterValue, a1 as TextureParameters, Y as TextureSchema, X as TextureTarget, _ as TextureView, v as UniformArrayMethods, t as UniformDefinition, u as UniformElementMethods, q as UniformFnName, r as UniformKind, s as UniformKindMap, w as UniformMethods, aa as UniformToken, ab as UniformTokenFn, x as UniformValue, a6 as ViewSchemaPartial } from './types-DZbMcty2.mjs';
+import { G as GL, F as FramebufferDefinition, V as ViewOptions, T as TextureDefinition, a as ViewSchema, b as View, c as VertexArrayParticipant, d as VertexArrayMethods, U as UniformSchema, e as UniformView, A as AttributeSchema, f as AttributeView, I as InterleavedAttributeSchema, g as InterleavedAttributeView, B as BufferSchema, h as BufferView } from './types-Cy9u5YKs.mjs';
+export { D as AttributeDefinition, C as AttributeFormat, z as AttributeKind, E as AttributeMethods, y as AttributeShortHand, ab as AttributeToken, ac as AttributeTokenFn, P as BufferDefinition, Q as BufferMethods, L as BufferSource, aj as CompileResult, M as ConstantAttributeMethods, N as ConstantSource, ah as FlattenSlots, a2 as Format, R as Framebuffer, a8 as GLSL, a6 as GLSLResult, a7 as GLSLSlot, ag as GLSLSlotsToSchema, ae as GLSLToSchema, af as GLSLToView, i as GLTarget, n as GLTextureFilter, l as GLTextureFormat, k as GLTextureTarget, m as GLTextureType, o as GLTextureWrap, j as GLUsage, ad as InterleaveToken, J as InterleavedAttributeDefinition, H as InterleavedAttributeLayout, O as InterleavedAttributeMethods, a1 as InternalFormat, p as KIND_TO_SIZE_MAP, K as KIND_TO_UNIFORM_FN_NAME_MAP, ai as MergeGLSLSchema, a3 as PixelType, S as Source, a4 as TexImage2DOptions, Y as TextureMethods, _ as TextureParameterName, $ as TextureParameterValue, a0 as TextureParameters, X as TextureSchema, W as TextureTarget, Z as TextureView, v as UniformArrayMethods, t as UniformDefinition, u as UniformElementMethods, q as UniformFnName, r as UniformKind, s as UniformKindMap, w as UniformMethods, a9 as UniformToken, aa as UniformTokenFn, x as UniformValue, a5 as ViewSchemaPartial } from './types-Cy9u5YKs.mjs';
+
+/**
+ * A shader that did not compile. `infoLog` is what the driver answered, `null`
+ * and `''` kept apart; `glError` is `getError()` read at the failure.
+ */
+declare class ShaderCompileError extends Error {
+    readonly stage: 'vertex' | 'fragment';
+    readonly infoLog: string | null;
+    readonly glError: number;
+    name: string;
+    constructor(stage: 'vertex' | 'fragment', infoLog: string | null, glError: number);
+}
+/**
+ * A program that did not link. `infoLog` is what the driver answered, `null`
+ * and `''` kept apart; `glError` is `getError()` read at the failure.
+ */
+declare class ProgramLinkError extends Error {
+    readonly infoLog: string | null;
+    readonly glError: number;
+    name: string;
+    constructor(infoLog: string | null, glError: number);
+}
+type GLResource = 'shader' | 'program' | 'buffer' | 'vertexArray' | 'texture' | 'framebuffer';
+/** A `create*` call that answered `null`. */
+declare class GLCreateError extends Error {
+    readonly resource: GLResource;
+    name: string;
+    constructor(resource: GLResource);
+}
+/** A program with no active attribute of that name: `getAttribLocation` answered -1. */
+declare class AttributeNotFoundError extends Error {
+    readonly attribute: string;
+    name: string;
+    constructor(attribute: string);
+}
+/** Throws a {@link GLCreateError} for a `create*` that answered `null`. */
+declare function created<T>(value: T | null, resource: GLResource): T;
 
 /**********************************************************************************/
 /**********************************************************************************/
@@ -33,4 +70,4 @@ declare function interleavedAttributeView<T extends InterleavedAttributeSchema>(
 /**********************************************************************************/
 declare function bufferView<T extends BufferSchema>(gl: GL, schema: T, { signal }?: ViewOptions): BufferView<T>;
 
-export { AttributeSchema, AttributeView, BufferSchema, BufferView, FramebufferDefinition, GL, InterleavedAttributeSchema, InterleavedAttributeView, TextureDefinition, UniformSchema, UniformView, VertexArrayMethods, VertexArrayParticipant, View, ViewOptions, ViewSchema, attributeView, bufferView, createFramebuffer, createTexture, interleavedAttributeView, toID, uniformView, vaoView, view };
+export { AttributeNotFoundError, AttributeSchema, AttributeView, BufferSchema, BufferView, FramebufferDefinition, GL, GLCreateError, type GLResource, InterleavedAttributeSchema, InterleavedAttributeView, ProgramLinkError, ShaderCompileError, TextureDefinition, UniformSchema, UniformView, VertexArrayMethods, VertexArrayParticipant, View, ViewOptions, ViewSchema, attributeView, bufferView, createFramebuffer, createTexture, created, interleavedAttributeView, toID, uniformView, vaoView, view };

package/dist/index.mjs

@@ -6,16 +6,26 @@ import {
   uniformView,
   vaoView,
   view
-} from "./chunk-YQ6SJAWS.mjs";
+} from "./chunk-6UTWQ36A.mjs";
 import {
+  AttributeNotFoundError,
+  GLCreateError,
+  ProgramLinkError,
+  ShaderCompileError,
   createFramebuffer,
-  createTexture
-} from "./chunk-BZDGEIOT.mjs";
+  createTexture,
+  created
+} from "./chunk-BDNRC4WD.mjs";
 export {
+  AttributeNotFoundError,
+  GLCreateError,
+  ProgramLinkError,
+  ShaderCompileError,
   attributeView,
   bufferView,
   createFramebuffer,
   createTexture,
+  created,
   interleavedAttributeView,
   toID,
   uniformView,

package/dist/tag.d.mts

@@ -1,4 +1,4 @@
-import { a8 as GLSLSlot, a9 as GLSL, ab as UniformTokenFn, ad as AttributeTokenFn, ac as AttributeToken, z as AttributeKind, D as AttributeDefinition, ae as InterleaveToken, a6 as ViewSchemaPartial, ak as CompileResult, al as Prettify, af as GLSLToSchema, G as GL } from './types-DZbMcty2.mjs';
+import { a7 as GLSLSlot, a8 as GLSL, aa as UniformTokenFn, ac as AttributeTokenFn, ab as AttributeToken, z as AttributeKind, D as AttributeDefinition, ad as InterleaveToken, a5 as ViewSchemaPartial, aj as CompileResult, ak as Prettify, ae as GLSLToSchema, G as GL } from './types-Cy9u5YKs.mjs';
 
 declare function glsl<TSlot extends GLSLSlot, const TSlots extends TSlot[]>(template: TemplateStringsArray, ...slots: [...TSlots]): GLSL<TSlots>;
 declare const uniform: {

package/dist/tag.mjs

@@ -1,12 +1,11 @@
 import {
   toID,
   view
-} from "./chunk-YQ6SJAWS.mjs";
+} from "./chunk-6UTWQ36A.mjs";
 import {
   createProgram,
-  createUpsertMap,
   once
-} from "./chunk-BZDGEIOT.mjs";
+} from "./chunk-BDNRC4WD.mjs";
 
 // src/tag.ts
 function glsl(template, ...slots) {
@@ -185,14 +184,12 @@ function resolveGlslSlotToString(slot, v300) {
   throw new Error(`Unexpected slot: ${JSON.stringify(slot)}`);
 }
 var QUAD_FLOAT_ARRAY = new Float32Array([-1, -1, 1, -1, -1, 1, -1, 1, 1, -1, 1, 1]);
-var QUAD_BUFFER_MAP = createUpsertMap(WeakMap);
 compile.toQuad = function(gl, fragment, options) {
-  const buffer = QUAD_BUFFER_MAP.getOrInsert(gl, gl.createBuffer.bind(gl));
   const webgl2 = options?.webgl2 ?? fragment.template[0]?.startsWith("#version 300 es");
   const vertex = webgl2 ? glsl`#version 300 es
 precision mediump float;
 
-${attribute.vec2("a_quad", { buffer })}
+${attribute.vec2("a_quad")}
 
 out vec2 v_uv;
 
@@ -201,7 +198,7 @@ void main() {
   gl_Position = vec4(v_uv, 0.0, 1.0);
 }` : glsl`precision mediump float;
 
-${attribute.vec2("a_quad", { buffer })}
+${attribute.vec2("a_quad")}
 
 varying vec2 v_uv;