@bigmistqke/view.gl 0.7.1 → 0.8.1

package/dist/tag.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/tag.ts"],"sourcesContent":["import { toID, view } from '.'\nimport { createProgram } from './gl'\nimport type { Prettify } from './type-utils'\nimport type {\n  AttributeDefinition,\n  AttributeKind,\n  AttributeTokenFn as AttributeTagMethod,\n  AttributeToken,\n  CompileResult,\n  GL,\n  GLSL,\n  GLSLSlot,\n  GLSLToSchema,\n  InterleaveToken,\n  UniformDefinition,\n  UniformKind,\n  UniformTokenFn as UniformTagMethod,\n  ViewSchema,\n  ViewSchemaPartial,\n} from './types'\nimport { createUpsertMap, once } from './utils'\n\nexport function glsl<TSlot extends GLSLSlot, const TSlots extends TSlot[]>(\n  template: TemplateStringsArray,\n  ...slots: [...TSlots]\n): GLSL<TSlots> {\n  return { template, slots, type: 'glsl' }\n}\n\nexport const uniform = new Proxy(\n  {} as {\n    [TKey in UniformKind]: UniformTagMethod<TKey>\n  },\n  {\n    get(target, property) {\n      // @ts-expect-error\n      if (typeof property === 'symbol') return target[property]\n      return (key: string, options?: Omit<UniformDefinition, 'kind'>) => ({\n        type: 'uniform',\n        key,\n        kind: property,\n        ...options,\n      })\n    },\n  },\n)\n\nexport const attribute = new Proxy(\n  {} as {\n    [TKey in AttributeKind]: AttributeTagMethod<TKey>\n  },\n  {\n    get(target, property) {\n      // @ts-expect-error\n      if (typeof property === 'symbol') return target[property]\n      return (key: string, options?: Omit<AttributeDefinition, 'kind'>) => ({\n        type: 'attribute',\n        key,\n        kind: property,\n        ...options,\n      })\n    },\n  },\n)\n\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n  const TOptions extends Omit<AttributeDefinition, 'kind'>,\n>(key: TKey, layout: TLayout, instanced: TOptions): InterleaveToken<TKey, TLayout, TOptions>\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n>(key: TKey, layout: TLayout): InterleaveToken<TKey, TLayout, { instanced: false }>\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n  const TOptions extends Omit<AttributeDefinition, 'kind'>,\n>(key: TKey, layout: TLayout, { instanced, buffer }: Partial<TOptions> = {}) {\n  return {\n    type: 'interleavedAttribute',\n    key,\n    // remove instanced- and type-property\n    layout: layout.map(({ key, kind }) => ({\n      key,\n      kind,\n    })),\n    instanced: !!instanced,\n    buffer,\n  } as unknown as InterleaveToken<TKey, TLayout, TOptions>\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                     Compile                                    */\n/*                                                                                */\n/**********************************************************************************/\n\nexport interface CompileOptions<TSchema extends ViewSchemaPartial> {\n  schema?: TSchema\n  webgl2?: boolean\n  /**\n   * Disposes what `compile` made: the program, and the buffers the view created\n   * for itself. Buffers named by the schema belong to whoever made them.\n   */\n  signal?: AbortSignal\n}\n\nexport function compile<\n  TVertex extends GLSL,\n  TFragment extends GLSL,\n  TSchema extends ViewSchemaPartial,\n>(\n  gl: WebGLRenderingContext,\n  vertex: TVertex,\n  fragment: TFragment,\n  options?: CompileOptions<TSchema> | undefined,\n) {\n  const _vertex = resolveGLSLTag(vertex, options) as { template: string; schema: ViewSchema }\n  const _fragment = resolveGLSLTag(fragment, options) as { template: string; schema: ViewSchema }\n\n  const schema = {\n    uniforms: {\n      ..._vertex.schema.uniforms,\n      ..._fragment.schema.uniforms,\n    },\n    attributes: {\n      ..._vertex.schema.attributes,\n      ..._fragment.schema.attributes,\n    },\n    interleavedAttributes: {\n      ..._vertex.schema.interleavedAttributes,\n      ..._fragment.schema.interleavedAttributes,\n    },\n    // Never produced by a tag — a buffer has no name in the source to be\n    // parsed out of one — but `options.schema` may name buffers for the view to\n    // own, and the deep merge below indexes this object by every key it finds\n    // there. Missing, that threw.\n    buffers: {} as NonNullable<ViewSchema['buffers']>,\n  }\n\n  // Deep merge options.schema with generated schema\n  for (const kind in options?.schema) {\n    const schemaKind = schema[kind as keyof typeof schema]\n    const configSchemaKind = options?.schema[kind]\n\n    for (const key in configSchemaKind) {\n      schemaKind[key] = {\n        ...schemaKind[key],\n        ...configSchemaKind[key],\n      }\n    }\n  }\n\n  try {\n    const program = createProgram(gl, _vertex.template, _fragment.template)\n\n    // The same rule the views follow: `compile` made this program, so `compile`\n    // is what deletes it. A program handed in from outside would not be ours to\n    // delete, and there is no way to hand one in.\n    const resolvedView = view(gl, program, schema)\n    const dispose = once(() => {\n      resolvedView.dispose()\n      gl.deleteProgram(program)\n    })\n    options?.signal?.addEventListener('abort', dispose)\n\n    return {\n      program,\n      schema,\n      view: resolvedView,\n      dispose,\n      vertex: _vertex.template,\n      fragment: _fragment.template,\n    } as unknown as Prettify<CompileResult<TVertex, TFragment, TSchema>>\n  } catch (error) {\n    console.error('Error while creating WebGLProgram - vertex\\n\\n', _vertex.template)\n    console.error('Error while creating WebGLProgram - fragment\\n\\n', _fragment.template)\n\n    throw error\n  }\n}\n\nfunction resolveGLSLTag<TTag extends GLSL>(tag: TTag, options?: { webgl2?: boolean }) {\n  return {\n    template: compile.toString(tag, options),\n    schema: compile.toSchema(tag),\n  }\n}\n\ncompile.toSchema = function <TTag extends GLSL>(tag: TTag) {\n  const result = {\n    uniforms: {},\n    attributes: {},\n    interleavedAttributes: {},\n  }\n\n  tag.slots.forEach(function handleSlot(slot: GLSLSlot) {\n    if (typeof slot !== 'object') {\n      return\n    }\n\n    if (Array.isArray(slot)) {\n      slot.forEach(handleSlot)\n      return\n    }\n\n    if (slot.type === 'glsl') {\n      const { uniforms, attributes, interleavedAttributes } = compile.toSchema(slot)\n\n      result.uniforms = {\n        ...result.uniforms,\n        ...uniforms,\n      }\n      result.attributes = {\n        ...result.attributes,\n        ...attributes,\n      }\n      result.interleavedAttributes = {\n        ...result.interleavedAttributes,\n        ...interleavedAttributes,\n      }\n\n      return\n    }\n\n    const { key: name, type, ...rest } = slot\n\n    // @ts-expect-error\n    result[`${type}s`][name] = rest\n  })\n\n  return result as unknown as Prettify<GLSLToSchema<TTag>>\n}\n\ncompile.toString = function <TTag extends GLSL>(\n  { template: [initial, ...rest], slots }: TTag,\n  config?: { webgl2?: boolean },\n) {\n  const v300 = config?.webgl2 ?? !!initial?.startsWith('#version 300 es')\n\n  let template = initial ?? ''\n\n  for (let i = 0; i < rest.length; i++) {\n    template += `${resolveGlslSlotToString(slots[i]!, v300)}${rest[i]}`\n  }\n\n  return template\n}\n\nfunction resolveGlslSlotToString(slot: GLSLSlot, v300: boolean): string {\n  if (typeof slot !== 'object') {\n    return toID(slot)\n  }\n\n  if (Array.isArray(slot)) {\n    return slot.map(slot => resolveGlslSlotToString(slot, v300)).join('')\n  }\n\n  switch (slot.type) {\n    case 'glsl':\n      return compile.toString(slot)\n    case 'interleavedAttribute':\n      return slot.layout.reduce(\n        (a, v) =>\n          v300 ? `${a}in ${v.kind} ${toID(v.key)};\\n` : `${a}attribute ${v.kind} ${toID(v.key)};\\n`,\n        '',\n      )\n    case 'uniform':\n      if ('size' in slot) {\n        return `${slot.type} ${slot.kind} ${toID(slot.key)}[${slot.size}];`\n      }\n      return `${slot.type} ${slot.kind} ${toID(slot.key)};`\n  }\n\n  if (slot.type === 'attribute') {\n    return `${v300 ? 'in' : slot.type} ${slot.kind} ${toID(slot.key)};`\n  }\n\n  throw new Error(`Unexpected slot: ${JSON.stringify(slot)}`)\n}\n\nconst QUAD_FLOAT_ARRAY = new Float32Array([-1, -1, 1, -1, -1, 1, -1, 1, 1, -1, 1, 1])\nconst QUAD_BUFFER_MAP = createUpsertMap(WeakMap<GL, WebGLBuffer>)\n\ncompile.toQuad = function <TFragment extends GLSL, TSchema extends ViewSchemaPartial>(\n  gl: GL,\n  fragment: TFragment,\n  options?: CompileOptions<TSchema>,\n) {\n  const buffer = QUAD_BUFFER_MAP.getOrInsert(gl, gl.createBuffer.bind(gl))\n\n  const webgl2 = options?.webgl2 ?? fragment.template[0]?.startsWith('#version 300 es')\n\n  const vertex = webgl2\n    ? glsl`#version 300 es\nprecision mediump float;\n\n${attribute.vec2('a_quad', { buffer })}\n\nout vec2 v_uv;\n\nvoid main() {\n  v_uv = a_quad;\n  gl_Position = vec4(v_uv, 0.0, 1.0);\n}`\n    : glsl`precision mediump float;\n\n${attribute.vec2('a_quad', { buffer })}\n\nvarying vec2 v_uv;\n\nvoid main() {\n  v_uv = a_quad;\n  gl_Position = vec4(v_uv, 0.0, 1.0);\n}`\n\n  const result = compile(gl, vertex, fragment, options)\n\n  // @ts-expect-error\n  result.view.attributes.a_quad.set(QUAD_FLOAT_ARRAY)\n\n  return result\n}\n"],"mappings":"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","names":["key","slot"]}
+{"version":3,"sources":["../src/tag.ts"],"sourcesContent":["import { toID, view } from '.'\nimport { createProgram } from './gl'\nimport type { Prettify } from './type-utils'\nimport type {\n  AttributeDefinition,\n  AttributeKind,\n  AttributeTokenFn as AttributeTagMethod,\n  AttributeToken,\n  CompileResult,\n  GL,\n  GLSL,\n  GLSLSlot,\n  GLSLToSchema,\n  InterleaveToken,\n  UniformDefinition,\n  UniformKind,\n  UniformTokenFn as UniformTagMethod,\n  ViewSchema,\n  ViewSchemaPartial,\n} from './types'\nimport { once } from './utils'\n\nexport function glsl<TSlot extends GLSLSlot, const TSlots extends TSlot[]>(\n  template: TemplateStringsArray,\n  ...slots: [...TSlots]\n): GLSL<TSlots> {\n  return { template, slots, type: 'glsl' }\n}\n\nexport const uniform = new Proxy(\n  {} as {\n    [TKey in UniformKind]: UniformTagMethod<TKey>\n  },\n  {\n    get(target, property) {\n      // @ts-expect-error\n      if (typeof property === 'symbol') return target[property]\n      return (key: string, options?: Omit<UniformDefinition, 'kind'>) => ({\n        type: 'uniform',\n        key,\n        kind: property,\n        ...options,\n      })\n    },\n  },\n)\n\nexport const attribute = new Proxy(\n  {} as {\n    [TKey in AttributeKind]: AttributeTagMethod<TKey>\n  },\n  {\n    get(target, property) {\n      // @ts-expect-error\n      if (typeof property === 'symbol') return target[property]\n      return (key: string, options?: Omit<AttributeDefinition, 'kind'>) => ({\n        type: 'attribute',\n        key,\n        kind: property,\n        ...options,\n      })\n    },\n  },\n)\n\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n  const TOptions extends Omit<AttributeDefinition, 'kind'>,\n>(key: TKey, layout: TLayout, instanced: TOptions): InterleaveToken<TKey, TLayout, TOptions>\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n>(key: TKey, layout: TLayout): InterleaveToken<TKey, TLayout, { instanced: false }>\nexport function interleave<\n  const TKey extends string | symbol,\n  const TLayout extends Array<AttributeToken<string | symbol, AttributeKind, undefined>>,\n  const TOptions extends Omit<AttributeDefinition, 'kind'>,\n>(key: TKey, layout: TLayout, { instanced, buffer }: Partial<TOptions> = {}) {\n  return {\n    type: 'interleavedAttribute',\n    key,\n    // remove instanced- and type-property\n    layout: layout.map(({ key, kind }) => ({\n      key,\n      kind,\n    })),\n    instanced: !!instanced,\n    buffer,\n  } as unknown as InterleaveToken<TKey, TLayout, TOptions>\n}\n\n/**********************************************************************************/\n/*                                                                                */\n/*                                     Compile                                    */\n/*                                                                                */\n/**********************************************************************************/\n\nexport interface CompileOptions<TSchema extends ViewSchemaPartial> {\n  schema?: TSchema\n  webgl2?: boolean\n  /**\n   * Disposes what `compile` made: the program, and the buffers the view created\n   * for itself. Buffers named by the schema belong to whoever made them.\n   */\n  signal?: AbortSignal\n}\n\nexport function compile<\n  TVertex extends GLSL,\n  TFragment extends GLSL,\n  TSchema extends ViewSchemaPartial,\n>(\n  gl: WebGLRenderingContext,\n  vertex: TVertex,\n  fragment: TFragment,\n  options?: CompileOptions<TSchema> | undefined,\n) {\n  const _vertex = resolveGLSLTag(vertex, options) as { template: string; schema: ViewSchema }\n  const _fragment = resolveGLSLTag(fragment, options) as { template: string; schema: ViewSchema }\n\n  const schema = {\n    uniforms: {\n      ..._vertex.schema.uniforms,\n      ..._fragment.schema.uniforms,\n    },\n    attributes: {\n      ..._vertex.schema.attributes,\n      ..._fragment.schema.attributes,\n    },\n    interleavedAttributes: {\n      ..._vertex.schema.interleavedAttributes,\n      ..._fragment.schema.interleavedAttributes,\n    },\n    // Never produced by a tag — a buffer has no name in the source to be\n    // parsed out of one — but `options.schema` may name buffers for the view to\n    // own, and the deep merge below indexes this object by every key it finds\n    // there. Missing, that threw.\n    buffers: {} as NonNullable<ViewSchema['buffers']>,\n  }\n\n  // Deep merge options.schema with generated schema\n  for (const kind in options?.schema) {\n    const schemaKind = schema[kind as keyof typeof schema]\n    const configSchemaKind = options?.schema[kind]\n\n    for (const key in configSchemaKind) {\n      schemaKind[key] = {\n        ...schemaKind[key],\n        ...configSchemaKind[key],\n      }\n    }\n  }\n\n  try {\n    const program = createProgram(gl, _vertex.template, _fragment.template)\n\n    // The same rule the views follow: `compile` made this program, so `compile`\n    // is what deletes it. A program handed in from outside would not be ours to\n    // delete, and there is no way to hand one in.\n    const resolvedView = view(gl, program, schema)\n    const dispose = once(() => {\n      resolvedView.dispose()\n      gl.deleteProgram(program)\n    })\n    options?.signal?.addEventListener('abort', dispose)\n\n    return {\n      program,\n      schema,\n      view: resolvedView,\n      dispose,\n      vertex: _vertex.template,\n      fragment: _fragment.template,\n    } as unknown as Prettify<CompileResult<TVertex, TFragment, TSchema>>\n  } catch (error) {\n    console.error('Error while creating WebGLProgram - vertex\\n\\n', _vertex.template)\n    console.error('Error while creating WebGLProgram - fragment\\n\\n', _fragment.template)\n\n    throw error\n  }\n}\n\nfunction resolveGLSLTag<TTag extends GLSL>(tag: TTag, options?: { webgl2?: boolean }) {\n  return {\n    template: compile.toString(tag, options),\n    schema: compile.toSchema(tag),\n  }\n}\n\ncompile.toSchema = function <TTag extends GLSL>(tag: TTag) {\n  const result = {\n    uniforms: {},\n    attributes: {},\n    interleavedAttributes: {},\n  }\n\n  tag.slots.forEach(function handleSlot(slot: GLSLSlot) {\n    if (typeof slot !== 'object') {\n      return\n    }\n\n    if (Array.isArray(slot)) {\n      slot.forEach(handleSlot)\n      return\n    }\n\n    if (slot.type === 'glsl') {\n      const { uniforms, attributes, interleavedAttributes } = compile.toSchema(slot)\n\n      result.uniforms = {\n        ...result.uniforms,\n        ...uniforms,\n      }\n      result.attributes = {\n        ...result.attributes,\n        ...attributes,\n      }\n      result.interleavedAttributes = {\n        ...result.interleavedAttributes,\n        ...interleavedAttributes,\n      }\n\n      return\n    }\n\n    const { key: name, type, ...rest } = slot\n\n    // @ts-expect-error\n    result[`${type}s`][name] = rest\n  })\n\n  return result as unknown as Prettify<GLSLToSchema<TTag>>\n}\n\ncompile.toString = function <TTag extends GLSL>(\n  { template: [initial, ...rest], slots }: TTag,\n  config?: { webgl2?: boolean },\n) {\n  const v300 = config?.webgl2 ?? !!initial?.startsWith('#version 300 es')\n\n  let template = initial ?? ''\n\n  for (let i = 0; i < rest.length; i++) {\n    template += `${resolveGlslSlotToString(slots[i]!, v300)}${rest[i]}`\n  }\n\n  return template\n}\n\nfunction resolveGlslSlotToString(slot: GLSLSlot, v300: boolean): string {\n  if (typeof slot !== 'object') {\n    return toID(slot)\n  }\n\n  if (Array.isArray(slot)) {\n    return slot.map(slot => resolveGlslSlotToString(slot, v300)).join('')\n  }\n\n  switch (slot.type) {\n    case 'glsl':\n      return compile.toString(slot)\n    case 'interleavedAttribute':\n      return slot.layout.reduce(\n        (a, v) =>\n          v300 ? `${a}in ${v.kind} ${toID(v.key)};\\n` : `${a}attribute ${v.kind} ${toID(v.key)};\\n`,\n        '',\n      )\n    case 'uniform':\n      if ('size' in slot) {\n        return `${slot.type} ${slot.kind} ${toID(slot.key)}[${slot.size}];`\n      }\n      return `${slot.type} ${slot.kind} ${toID(slot.key)};`\n  }\n\n  if (slot.type === 'attribute') {\n    return `${v300 ? 'in' : slot.type} ${slot.kind} ${toID(slot.key)};`\n  }\n\n  throw new Error(`Unexpected slot: ${JSON.stringify(slot)}`)\n}\n\nconst QUAD_FLOAT_ARRAY = new Float32Array([-1, -1, 1, -1, -1, 1, -1, 1, 1, -1, 1, 1])\n\ncompile.toQuad = function <TFragment extends GLSL, TSchema extends ViewSchemaPartial>(\n  gl: GL,\n  fragment: TFragment,\n  options?: CompileOptions<TSchema>,\n) {\n  const webgl2 = options?.webgl2 ?? fragment.template[0]?.startsWith('#version 300 es')\n\n  const vertex = webgl2\n    ? glsl`#version 300 es\nprecision mediump float;\n\n${attribute.vec2('a_quad')}\n\nout vec2 v_uv;\n\nvoid main() {\n  v_uv = a_quad;\n  gl_Position = vec4(v_uv, 0.0, 1.0);\n}`\n    : glsl`precision mediump float;\n\n${attribute.vec2('a_quad')}\n\nvarying vec2 v_uv;\n\nvoid main() {\n  v_uv = a_quad;\n  gl_Position = vec4(v_uv, 0.0, 1.0);\n}`\n\n  const result = compile(gl, vertex, fragment, options)\n\n  // @ts-expect-error\n  result.view.attributes.a_quad.set(QUAD_FLOAT_ARRAY)\n\n  return result\n}\n"],"mappings":"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","names":["key","slot"]}

package/dist/{types-DZbMcty2.d.mts → types-Cy9u5YKs.d.mts}

@@ -1,9 +1,6 @@
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
-type RemoveSuffix<T, S extends string> = {
-    [K in keyof T as K extends `${infer Prefix}${S}` ? Prefix : K]: 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;
@@ -450,10 +447,9 @@ interface ViewOptions {
  *
  * The other two lifetimes have their own spellings, and neither is this one. A
  * buffer that outlives the view, or is shared between views, is a standalone
- * `bufferView` — `compile.toQuad`'s per-context quad, a buffer handed from one
- * program's view to another's. A buffer that belongs to somebody else is NAMED
- * by an attribute schema, and is borrowed: the view uses it and never deletes
- * it.
+ * `bufferView` — a buffer handed from one program's view to another's. A
+ * buffer that belongs to somebody else is NAMED by an attribute schema, and is
+ * borrowed: the view uses it and never deletes it.
  */
 interface ViewSchema {
     uniforms?: UniformSchema;
@@ -596,4 +592,4 @@ type CompileResult<TVertex extends GLSL, TFragment extends GLSL, TOverrideSchema
     dispose(): void;
 } : never;
 
-export type { TextureParameterName as $, AttributeSchema as A, BufferSchema as B, AttributeFormat as C, AttributeDefinition as D, AttributeMethods as E, FramebufferDefinition as F, GL as G, InterleavedAttributeLayout as H, InterleavedAttributeSchema as I, InterleavedAttributeDefinition as J, KIND_TO_UNIFORM_FN_NAME_MAP as K, BufferSource as L, ConstantAttributeMethods as M, ConstantSource as N, InterleavedAttributeMethods as O, BufferDefinition as P, BufferMethods as Q, RemoveSuffix as R, Source as S, TextureDefinition as T, UniformSchema as U, ViewOptions as V, Framebuffer as W, TextureTarget as X, TextureSchema as Y, TextureMethods as Z, TextureView as _, ViewSchema as a, TextureParameterValue as a0, TextureParameters as a1, InternalFormat as a2, Format as a3, PixelType as a4, TexImage2DOptions as a5, ViewSchemaPartial as a6, GLSLResult as a7, GLSLSlot as a8, GLSL as a9, UniformToken as aa, UniformTokenFn as ab, AttributeToken as ac, AttributeTokenFn as ad, InterleaveToken as ae, GLSLToSchema as af, GLSLToView as ag, GLSLSlotsToSchema as ah, FlattenSlots as ai, MergeGLSLSchema as aj, CompileResult as ak, Prettify as al, View as b, VertexArrayParticipant as c, VertexArrayMethods as d, UniformView as e, AttributeView as f, InterleavedAttributeView as g, BufferView as h, GLTarget as i, GLUsage as j, GLTextureTarget as k, GLTextureFormat as l, GLTextureType as m, GLTextureFilter as n, GLTextureWrap as o, KIND_TO_SIZE_MAP as p, UniformFnName as q, UniformKind as r, UniformKindMap as s, UniformDefinition as t, UniformElementMethods as u, UniformArrayMethods as v, UniformMethods as w, UniformValue as x, AttributeShortHand as y, AttributeKind as z };
+export type { TextureParameterValue as $, AttributeSchema as A, BufferSchema as B, AttributeFormat as C, AttributeDefinition as D, AttributeMethods as E, FramebufferDefinition as F, GL as G, InterleavedAttributeLayout as H, InterleavedAttributeSchema as I, InterleavedAttributeDefinition as J, KIND_TO_UNIFORM_FN_NAME_MAP as K, BufferSource as L, ConstantAttributeMethods as M, ConstantSource as N, InterleavedAttributeMethods as O, BufferDefinition as P, BufferMethods as Q, Framebuffer as R, Source as S, TextureDefinition as T, UniformSchema as U, ViewOptions as V, TextureTarget as W, TextureSchema as X, TextureMethods as Y, TextureView as Z, TextureParameterName as _, ViewSchema as a, TextureParameters as a0, InternalFormat as a1, Format as a2, PixelType as a3, TexImage2DOptions as a4, ViewSchemaPartial as a5, GLSLResult as a6, GLSLSlot as a7, GLSL as a8, UniformToken as a9, UniformTokenFn as aa, AttributeToken as ab, AttributeTokenFn as ac, InterleaveToken as ad, GLSLToSchema as ae, GLSLToView as af, GLSLSlotsToSchema as ag, FlattenSlots as ah, MergeGLSLSchema as ai, CompileResult as aj, Prettify as ak, View as b, VertexArrayParticipant as c, VertexArrayMethods as d, UniformView as e, AttributeView as f, InterleavedAttributeView as g, BufferView as h, GLTarget as i, GLUsage as j, GLTextureTarget as k, GLTextureFormat as l, GLTextureType as m, GLTextureFilter as n, GLTextureWrap as o, KIND_TO_SIZE_MAP as p, UniformFnName as q, UniformKind as r, UniformKindMap as s, UniformDefinition as t, UniformElementMethods as u, UniformArrayMethods as v, UniformMethods as w, UniformValue as x, AttributeShortHand as y, AttributeKind as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigmistqke/view.gl",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "👀 Utilities for managing WebGL resources.",
   "exports": {
     ".": {
@@ -16,26 +16,11 @@
       "types": "./dist/gl.d.mts"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "bump": "bumpp",
-    "dev:build": "vite build dev",
-    "dev:preview": "vite preview dev",
-    "dev:watch": "concurrently \"pnpm dev:preview\" \"vite dev:build --watch\"",
-    "dev": "vite serve dev",
-    "format": "prettier -w \"src/**/*.{js,ts,json,css,tsx,jsx}\" \"dev/**/*.{js,ts,json,css,tsx,jsx}\"",
-    "lint:types": "tsc --noEmit",
-    "prepublishOnly": "pnpm test && pnpm build",
-    "test:coverage": "vitest run --coverage",
-    "test:ui": "vitest --ui",
-    "test": "vitest --run"
-  },
   "keywords": [
     "WebGL"
   ],
   "author": "",
   "license": "ISC",
-  "packageManager": "pnpm@10.5.1",
   "devDependencies": {
     "@vitest/ui": "^3.2.4",
     "bumpp": "^10.4.0",
@@ -47,5 +32,18 @@
     "vite": "^7.0.2",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsup",
+    "bump": "bumpp",
+    "dev:build": "vite build dev",
+    "dev:preview": "vite preview dev",
+    "dev:watch": "concurrently \"pnpm dev:preview\" \"vite dev:build --watch\"",
+    "dev": "vite serve dev",
+    "format": "prettier -w \"src/**/*.{js,ts,json,css,tsx,jsx}\" \"dev/**/*.{js,ts,json,css,tsx,jsx}\"",
+    "lint:types": "tsc --noEmit",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "test": "vitest --run"
   }
-}
+}

package/src/errors.ts

@@ -0,0 +1,58 @@
+/**
+ * A shader that did not compile. `infoLog` is what the driver answered, `null`
+ * and `''` kept apart; `glError` is `getError()` read at the failure.
+ */
+export class ShaderCompileError extends Error {
+  override name = 'ShaderCompileError'
+
+  constructor(
+    readonly stage: 'vertex' | 'fragment',
+    readonly infoLog: string | null,
+    readonly glError: number,
+  ) {
+    super(`Failed to compile ${stage} shader: ${infoLog}`)
+  }
+}
+
+/**
+ * A program that did not link. `infoLog` is what the driver answered, `null`
+ * and `''` kept apart; `glError` is `getError()` read at the failure.
+ */
+export class ProgramLinkError extends Error {
+  override name = 'ProgramLinkError'
+
+  constructor(
+    readonly infoLog: string | null,
+    readonly glError: number,
+  ) {
+    super(`Failed to link program: ${infoLog}`)
+  }
+}
+
+export type GLResource = 'shader' | 'program' | 'buffer' | 'vertexArray' | 'texture' | 'framebuffer'
+
+/** A `create*` call that answered `null`. */
+export class GLCreateError extends Error {
+  override name = 'GLCreateError'
+
+  constructor(readonly resource: GLResource) {
+    super(`Failed to create ${resource}`)
+  }
+}
+
+/** A program with no active attribute of that name: `getAttribLocation` answered -1. */
+export class AttributeNotFoundError extends Error {
+  override name = 'AttributeNotFoundError'
+
+  constructor(readonly attribute: string) {
+    super(`Attribute '${attribute}' not found`)
+  }
+}
+
+/** Throws a {@link GLCreateError} for a `create*` that answered `null`. */
+export function created<T>(value: T | null, resource: GLResource): T {
+  if (value === null) {
+    throw new GLCreateError(resource)
+  }
+  return value
+}

package/src/gl.ts

@@ -1,5 +1,5 @@
-import { RemoveSuffix } from './type-utils'
 import type { GL, ViewOptions } from './types'
+import { created, ProgramLinkError, ShaderCompileError } from './errors'
 import { once } from './utils'
 
 function isWebGL2RenderingContext(
@@ -15,18 +15,19 @@ function isWebGL2RenderingContext(
 /**********************************************************************************/
 
 export function createShader(gl: GL, type: number, source: string): WebGLShader {
-  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
@@ -44,8 +45,7 @@ export function createProgram(
   fragmentSource: string,
   { signal }: ViewOptions = {},
 ): WebGLProgram {
-  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)
@@ -55,11 +55,11 @@ export function createProgram(
   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
   }
 
   // Clean up shaders after linking
@@ -80,33 +80,18 @@ export function createProgram(
 /*                                                                                */
 /**********************************************************************************/
 
-const INSTANCED_ARRAYS_WRAPPER_MAP = new WeakMap<
-  GL,
-  RemoveSuffix<
-    Pick<
-      ANGLE_instanced_arrays,
-      'drawArraysInstancedANGLE' | 'drawElementsInstancedANGLE' | 'vertexAttribDivisorANGLE'
-    >,
-    'ANGLE'
-  > | null
->()
+/** Instancing on `gl`: the context on WebGL2, `ANGLE_instanced_arrays` on WebGL1, else `undefined`. */
 export function getInstancedArrays(gl: 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 undefined
 
-  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
 }
 
 /**********************************************************************************/
@@ -115,31 +100,16 @@ export function getInstancedArrays(gl: GL) {
 /*                                                                                */
 /**********************************************************************************/
 
-const VERTEX_ARRAY_OBJECT_WRAPPER_MAP = new WeakMap<
-  GL,
-  RemoveSuffix<
-    Pick<
-      OES_vertex_array_object,
-      'bindVertexArrayOES' | 'createVertexArrayOES' | 'deleteVertexArrayOES'
-    >,
-    'OES'
-  > | null
->()
+/** Vertex arrays on `gl`: the context on WebGL2, `OES_vertex_array_object` on WebGL1, else `null`. */
 export function getVertexArrayObject(gl: 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
 }

package/src/index.ts

@@ -1,3 +1,4 @@
+import { AttributeNotFoundError, created } from './errors'
 import { getInstancedArrays, getVertexArrayObject } from './gl'
 import type {
   AttributeFormat,
@@ -31,6 +32,7 @@ import {
   once,
 } from './utils'
 import { createUpsertMap, mapObject } from './utils'
+export * from './errors'
 export * from './types'
 // Documented under Utils but reachable from nowhere until now: utils is not a
 // build entry, and named rather than star so the internal helpers stay internal.
@@ -148,7 +150,7 @@ function bindDefaultVertexArray(gl: GL): () => void {
   if (!feature) {
     return () => {}
   }
-  const previous = gl.getParameter(VERTEX_ARRAY_BINDING) as WebGLVertexArrayObject | null
+  const previous = readVertexArrayBinding(gl)
   feature.bindVertexArray(null)
   return () => feature.bindVertexArray(previous)
 }
@@ -180,8 +182,8 @@ export function vaoView(
         dispose() {},
       }
     : (() => {
-        const vertexArray = assertedNotNullish(feature.createVertexArray())
-        const previous = gl.getParameter(VERTEX_ARRAY_BINDING) as WebGLVertexArrayObject | null
+        const vertexArray = created(feature.createVertexArray(), 'vertexArray')
+        const previous = readVertexArrayBinding(gl)
         feature.bindVertexArray(vertexArray)
         // Discarding the restorers is the point: the state lives in this array
         // now, and the array is thrown away whole.
@@ -192,9 +194,7 @@ export function vaoView(
 
         return {
           bind() {
-            const previousVertexArray = gl.getParameter(
-              VERTEX_ARRAY_BINDING,
-            ) as WebGLVertexArrayObject | null
+            const previousVertexArray = readVertexArrayBinding(gl)
             feature.bindVertexArray(vertexArray)
             // Context state the array cannot hold — see applyToContext.
             participants.forEach(participant => participant.applyToContext?.())
@@ -366,6 +366,12 @@ function handleAttribute(
 const VERTEX_ATTRIB_ARRAY_DIVISOR = 0x88fe
 const VERTEX_ARRAY_BINDING = 0x85b5
 
+// Anything but an array or null would make the restore throw a TypeError.
+function readVertexArrayBinding(gl: GL): WebGLVertexArrayObject | null {
+  const bound: unknown = gl.getParameter(VERTEX_ARRAY_BINDING)
+  return typeof bound === 'object' ? (bound as WebGLVertexArrayObject | null) : null
+}
+
 // Reads the divisor currently attached to a location, 0 where instancing is
 // unavailable and nothing can have set one
 function readDivisor(gl: GL, location: number): number {
@@ -389,14 +395,13 @@ export function attributeView<T extends AttributeSchema>(
       const name = toID(key)
 
       // Whoever made the buffer deletes it. A schema can name a buffer that
-      // belongs to another view — the quad `compile.toQuad` shares across every
-      // program on a context, an attribute two programs step over — and
+      // belongs to another view — an attribute two programs step over — and
       // deleting one of those would take it out from under its owner.
-      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)
@@ -551,7 +556,7 @@ export function interleavedAttributeView<T extends InterleavedAttributeSchema>(
       const location = gl.getAttribLocation(program, name)
 
       if (location < 0) {
-        throw new Error(`Attribute '${name}' not found`)
+        throw new AttributeNotFoundError(name)
       }
 
       locations.push(location)
@@ -582,7 +587,7 @@ export function interleavedAttributeView<T extends InterleavedAttributeSchema>(
     const stride = index
 
     // Create a buffer
-    const buffer = assertedNotNullish(gl.createBuffer())
+    const buffer = created(gl.createBuffer(), 'buffer')
 
     // This layout used to create a vertex array of its own, here, which is why
     // the other participants in a draw had to be bound after it to be included
@@ -670,7 +675,7 @@ export function bufferView<T extends BufferSchema>(
 ): BufferView<T> {
   // Initialize buffers
   const buffers = mapObject(schema, ({ target = 'ARRAY_BUFFER', usage = 'STATIC_DRAW' }) => {
-    const buffer = assertedNotNullish(gl.createBuffer())
+    const buffer = created(gl.createBuffer(), 'buffer')
 
     function applyToVertexArray() {
       // Snapshot before the change, restore in the disposer. Restoring the

package/src/tag.ts

@@ -18,7 +18,7 @@ import type {
   ViewSchema,
   ViewSchemaPartial,
 } from './types'
-import { createUpsertMap, once } from './utils'
+import { once } from './utils'
 
 export function glsl<TSlot extends GLSLSlot, const TSlots extends TSlot[]>(
   template: TemplateStringsArray,
@@ -281,22 +281,19 @@ function resolveGlslSlotToString(slot: GLSLSlot, v300: boolean): string {
 }
 
 const QUAD_FLOAT_ARRAY = new Float32Array([-1, -1, 1, -1, -1, 1, -1, 1, 1, -1, 1, 1])
-const QUAD_BUFFER_MAP = createUpsertMap(WeakMap<GL, WebGLBuffer>)
 
 compile.toQuad = function <TFragment extends GLSL, TSchema extends ViewSchemaPartial>(
   gl: GL,
   fragment: TFragment,
   options?: CompileOptions<TSchema>,
 ) {
-  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;
 
@@ -306,7 +303,7 @@ void main() {
 }`
     : glsl`precision mediump float;
 
-${attribute.vec2('a_quad', { buffer })}
+${attribute.vec2('a_quad')}
 
 varying vec2 v_uv;
 

package/src/types.ts

@@ -670,10 +670,9 @@ export interface ViewOptions {
  *
  * The other two lifetimes have their own spellings, and neither is this one. A
  * buffer that outlives the view, or is shared between views, is a standalone
- * `bufferView` — `compile.toQuad`'s per-context quad, a buffer handed from one
- * program's view to another's. A buffer that belongs to somebody else is NAMED
- * by an attribute schema, and is borrowed: the view uses it and never deletes
- * it.
+ * `bufferView` — a buffer handed from one program's view to another's. A
+ * buffer that belongs to somebody else is NAMED by an attribute schema, and is
+ * borrowed: the view uses it and never deletes it.
  */
 export interface ViewSchema {
   uniforms?: UniformSchema

package/src/utils.ts

@@ -1,3 +1,4 @@
+import { created } from './errors'
 import type {
   AttributeKind,
   FramebufferDefinition,
@@ -135,7 +136,7 @@ export function createTexture(
   data?: ArrayBufferView | null,
   { signal }: ViewOptions = {},
 ): WebGLTexture {
-  const texture = assertedNotNullish(gl.createTexture(), 'Failed to create texture')
+  const texture = created(gl.createTexture(), 'texture')
 
   function getTextureConstant(name: string) {
     if (!(name in gl)) {
@@ -217,7 +218,7 @@ export function createFramebuffer(
   const texture = providedTexture ?? createTexture(gl, definition)
 
   // Create framebuffer
-  const framebuffer = assertedNotNullish(gl.createFramebuffer(), 'Failed to create framebuffer')
+  const framebuffer = created(gl.createFramebuffer(), 'framebuffer')
 
   gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer)