@bigmistqke/view.gl 0.1.19 → 0.3.0

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 } 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\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  }\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    return {\n      program,\n      schema,\n      view: view(gl, program, schema),\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":";;;;;;;;;;AAsBO,SAAS,KACd,aACG,OACW;AACd,SAAO,EAAE,UAAU,OAAO,MAAM,OAAO;AACzC;AAEO,IAAM,UAAU,IAAI;AAAA,EACzB,CAAC;AAAA,EAGD;AAAA,IACE,IAAI,QAAQ,UAAU;AAEpB,UAAI,OAAO,aAAa,SAAU,QAAO,OAAO,QAAQ;AACxD,aAAO,CAAC,KAAa,aAA+C;AAAA,QAClE,MAAM;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,YAAY,IAAI;AAAA,EAC3B,CAAC;AAAA,EAGD;AAAA,IACE,IAAI,QAAQ,UAAU;AAEpB,UAAI,OAAO,aAAa,SAAU,QAAO,OAAO,QAAQ;AACxD,aAAO,CAAC,KAAa,aAAiD;AAAA,QACpE,MAAM;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,GAAG;AAAA,MACL;AAAA,IACF;AAAA,EACF;AACF;AAWO,SAAS,WAId,KAAW,QAAiB,EAAE,WAAW,OAAO,IAAuB,CAAC,GAAG;AAC3E,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA;AAAA,IAEA,QAAQ,OAAO,IAAI,CAAC,EAAE,KAAAA,MAAK,KAAK,OAAO;AAAA,MACrC,KAAAA;AAAA,MACA;AAAA,IACF,EAAE;AAAA,IACF,WAAW,CAAC,CAAC;AAAA,IACb;AAAA,EACF;AACF;AAaO,SAAS,QAKd,IACA,QACA,UACA,SACA;AACA,QAAM,UAAU,eAAe,QAAQ,OAAO;AAC9C,QAAM,YAAY,eAAe,UAAU,OAAO;AAElD,QAAM,SAAS;AAAA,IACb,UAAU;AAAA,MACR,GAAG,QAAQ,OAAO;AAAA,MAClB,GAAG,UAAU,OAAO;AAAA,IACtB;AAAA,IACA,YAAY;AAAA,MACV,GAAG,QAAQ,OAAO;AAAA,MAClB,GAAG,UAAU,OAAO;AAAA,IACtB;AAAA,IACA,uBAAuB;AAAA,MACrB,GAAG,QAAQ,OAAO;AAAA,MAClB,GAAG,UAAU,OAAO;AAAA,IACtB;AAAA,EACF;AAGA,aAAW,QAAQ,SAAS,QAAQ;AAClC,UAAM,aAAa,OAAO,IAA2B;AACrD,UAAM,mBAAmB,SAAS,OAAO,IAAI;AAE7C,eAAW,OAAO,kBAAkB;AAClC,iBAAW,GAAG,IAAI;AAAA,QAChB,GAAG,WAAW,GAAG;AAAA,QACjB,GAAG,iBAAiB,GAAG;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AACF,UAAM,UAAU,cAAc,IAAI,QAAQ,UAAU,UAAU,QAAQ;AAEtE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,MAAM,KAAK,IAAI,SAAS,MAAM;AAAA,MAC9B,QAAQ,QAAQ;AAAA,MAChB,UAAU,UAAU;AAAA,IACtB;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,kDAAkD,QAAQ,QAAQ;AAChF,YAAQ,MAAM,oDAAoD,UAAU,QAAQ;AAEpF,UAAM;AAAA,EACR;AACF;AAEA,SAAS,eAAkC,KAAW,SAAgC;AACpF,SAAO;AAAA,IACL,UAAU,QAAQ,SAAS,KAAK,OAAO;AAAA,IACvC,QAAQ,QAAQ,SAAS,GAAG;AAAA,EAC9B;AACF;AAEA,QAAQ,WAAW,SAA6B,KAAW;AACzD,QAAM,SAAS;AAAA,IACb,UAAU,CAAC;AAAA,IACX,YAAY,CAAC;AAAA,IACb,uBAAuB,CAAC;AAAA,EAC1B;AAEA,MAAI,MAAM,QAAQ,SAAS,WAAW,MAAgB;AACpD,QAAI,OAAO,SAAS,UAAU;AAC5B;AAAA,IACF;AAEA,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAK,QAAQ,UAAU;AACvB;AAAA,IACF;AAEA,QAAI,KAAK,SAAS,QAAQ;AACxB,YAAM,EAAE,UAAU,YAAY,sBAAsB,IAAI,QAAQ,SAAS,IAAI;AAE7E,aAAO,WAAW;AAAA,QAChB,GAAG,OAAO;AAAA,QACV,GAAG;AAAA,MACL;AACA,aAAO,aAAa;AAAA,QAClB,GAAG,OAAO;AAAA,QACV,GAAG;AAAA,MACL;AACA,aAAO,wBAAwB;AAAA,QAC7B,GAAG,OAAO;AAAA,QACV,GAAG;AAAA,MACL;AAEA;AAAA,IACF;AAEA,UAAM,EAAE,KAAK,MAAM,MAAM,GAAG,KAAK,IAAI;AAGrC,WAAO,GAAG,IAAI,GAAG,EAAE,IAAI,IAAI;AAAA,EAC7B,CAAC;AAED,SAAO;AACT;AAEA,QAAQ,WAAW,SACjB,EAAE,UAAU,CAAC,SAAS,GAAG,IAAI,GAAG,MAAM,GACtC,QACA;AACA,QAAM,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,WAAW,iBAAiB;AAEtE,MAAI,WAAW,WAAW;AAE1B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,gBAAY,GAAG,wBAAwB,MAAM,CAAC,GAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;AAAA,EACnE;AAEA,SAAO;AACT;AAEA,SAAS,wBAAwB,MAAgB,MAAuB;AACtE,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO,KAAK,IAAI;AAAA,EAClB;AAEA,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,WAAO,KAAK,IAAI,CAAAC,UAAQ,wBAAwBA,OAAM,IAAI,CAAC,EAAE,KAAK,EAAE;AAAA,EACtE;AAEA,UAAQ,KAAK,MAAM;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ,SAAS,IAAI;AAAA,IAC9B,KAAK;AACH,aAAO,KAAK,OAAO;AAAA,QACjB,CAAC,GAAG,MACF,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC;AAAA,IAAQ,GAAG,CAAC,aAAa,EAAE,IAAI,IAAI,KAAK,EAAE,GAAG,CAAC;AAAA;AAAA,QACtF;AAAA,MACF;AAAA,IACF,KAAK;AACH,UAAI,UAAU,MAAM;AAClB,eAAO,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI;AAAA,MACjE;AACA,aAAO,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC;AAAA,EACtD;AAEA,MAAI,KAAK,SAAS,aAAa;AAC7B,WAAO,GAAG,OAAO,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,CAAC;AAAA,EAClE;AAEA,QAAM,IAAI,MAAM,oBAAoB,KAAK,UAAU,IAAI,CAAC,EAAE;AAC5D;AAEA,IAAM,mBAAmB,IAAI,aAAa,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC;AACpF,IAAM,kBAAkB,gBAAgB,OAAwB;AAEhE,QAAQ,SAAS,SACf,IACA,UACA,SACA;AACA,QAAM,SAAS,gBAAgB,YAAY,IAAI,GAAG,aAAa,KAAK,EAAE,CAAC;AAEvE,QAAM,SAAS,SAAS,UAAU,SAAS,SAAS,CAAC,GAAG,WAAW,iBAAiB;AAEpF,QAAM,SAAS,SACX;AAAA;AAAA;AAAA,EAGJ,UAAU,KAAK,UAAU,EAAE,OAAO,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAQhC;AAAA;AAAA,EAEJ,UAAU,KAAK,UAAU,EAAE,OAAO,CAAC,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASpC,QAAM,SAAS,QAAQ,IAAI,QAAQ,UAAU,OAAO;AAGpD,SAAO,KAAK,WAAW,OAAO,IAAI,gBAAgB;AAElD,SAAO;AACT;","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 { 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  }\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"]}

package/dist/{types-DTSPQclW.d.mts → types-CNdqh7tB.d.mts}

@@ -210,13 +210,58 @@ type FormatToArray = {
     int8: Int8Array;
     uint8: Uint8Array;
 };
-interface AttributeMethods<T extends AttributeDefinition = AttributeDefinition> {
+/**
+ * What a participant contributes to a vertex array.
+ *
+ * `enableVertexAttribArray`, `vertexAttribPointer`, `vertexAttribDivisor` and
+ * the `ELEMENT_ARRAY_BUFFER` binding all write into whichever vertex array is
+ * bound when they run — they name no destination of their own. That is what
+ * makes them a participant in something rather than a property of themselves,
+ * and why `vao()` exists: it binds the array first, then asks each participant
+ * to write itself in.
+ *
+ * The returned function undoes the write. It is only used where there is no
+ * vertex array to hold the state — a WebGL1 context without
+ * `OES_vertex_array_object` — since a real vertex array is thrown away whole.
+ */
+interface VertexArrayParticipant {
+    applyToVertexArray(): () => void;
+    /**
+     * State the CONTEXT holds rather than the vertex array, re-applied on every
+     * bind because no array can keep it.
+     *
+     * There is exactly one such thing: the current generic vertex attribute
+     * values, which an attribute reads when its array is disabled. The enable
+     * flag saying to read them is vertex-array state; the values themselves are
+     * not. So a constant source splits across the two hooks — and the tempting
+     * optimisation of skipping this when nothing changed would let one draw's
+     * constants leak into the next.
+     */
+    applyToContext?(): void;
+}
+interface AttributeMethods<T extends AttributeDefinition = AttributeDefinition> extends VertexArrayParticipant {
     buffer: WebGLBuffer;
-    /** Binds the attribute, returning a disposer that restores the divisor */
+    /**
+     * Apply this attribute to the DEFAULT vertex array, returning a disposer.
+     *
+     * Explicitly the default one: these calls have no destination of their own,
+     * so without binding first this would edit whichever array happened to be
+     * bound — and a vertex array keeps what it is given, so the damage would
+     * outlive the call. Use `vao()` to build an array of your own.
+     */
     bind(): () => void;
     set(data: FormatToArray[ResolvedFormat<T>], usage?: GLUsage): {
         bind(): () => void;
     };
+    /**
+     * Delete the buffer, if this attribute is the one that made it.
+     *
+     * A buffer named by the schema came from somewhere else and is deleted by
+     * whoever made it — a shared buffer is the point of passing one in, and one
+     * view cannot know whether the others are done. So this is safe to call
+     * twice and safe to call on a borrowed buffer, and it is not a way to free
+     * one: dispose the view that created it.
+     */
     dispose(): void;
 }
 type AttributeView<T extends AttributeSchema> = {
@@ -235,11 +280,48 @@ interface InterleavedAttributeDefinition {
     instanced?: boolean;
 }
 type InterleavedAttributeSchema = Record<string | symbol, InterleavedAttributeDefinition>;
+/**
+ * A source is where one draw's values for a layout come from. Both kinds are
+ * participants, so either can go into a `vao()`.
+ */
+interface Source extends VertexArrayParticipant {
+    /**
+     * Apply this source to the DEFAULT vertex array, returning a disposer. See
+     * `AttributeMethods.bind` — and prefer `vao()`, which is the only way to get
+     * a source and its fellow participants into an array of their own.
+     */
+    bind(): () => void;
+}
+interface BufferSource extends Source {
+    /**
+     * The same buffer, stepped once per instance rather than once per vertex.
+     *
+     * A divisor is a property of the draw, not of the data — the same markers
+     * are an instanced fleet in one draw and a single mesh in the next — so it
+     * is chosen here rather than declared in the schema.
+     */
+    perInstance: Source;
+    set(data: Float32Array, usage?: GLUsage): void;
+}
+interface ConstantAttributeMethods {
+    set(...values: number[]): void;
+}
+/**
+ * Per-key setters over the same layout the buffer source uses — a constant
+ * attribute is a uniform in all but name, so it is written like one.
+ */
+type ConstantSource<T extends InterleavedAttributeLayout[]> = Source & {
+    [K in T[number] as K['key'] extends string ? K['key'] : never]: ConstantAttributeMethods;
+};
 interface InterleavedAttributeMethods<T extends InterleavedAttributeLayout[] = InterleavedAttributeLayout[]> {
+    buffer: BufferSource;
+    constant: ConstantSource<T>;
+    dispose(): void;
+}
+interface VertexArrayMethods {
     /** Binds the vertex array, returning a disposer that restores the previous one */
     bind(): () => void;
     unbind(): void;
-    set(data: Float32Array, usage?: GLUsage): void;
     dispose(): void;
 }
 type InterleavedAttributeView<T extends InterleavedAttributeSchema> = {
@@ -252,7 +334,7 @@ interface BufferDefinition {
     usage?: GLUsage;
 }
 type BufferSchema = Record<string | symbol, BufferDefinition>;
-interface BufferMethods {
+interface BufferMethods extends VertexArrayParticipant {
     set(data: Float32Array | Uint16Array | Uint32Array): void;
     /** Binds the buffer, returning a disposer that restores the previous binding */
     bind(): () => void;
@@ -285,6 +367,12 @@ interface TextureDefinition {
 interface Framebuffer {
     texture: WebGLTexture;
     framebuffer: WebGLFramebuffer;
+    /**
+     * Delete the framebuffer, and the texture only if `createFramebuffer` made
+     * it. A texture handed in belongs to whoever made it. Idempotent, and exactly
+     * what aborting the signal does.
+     */
+    dispose(): void;
 }
 /**********************************************************************************/
 /**********************************************************************************/
@@ -320,24 +408,44 @@ type TexImage2DOptions = {
 interface ViewOptions {
     signal?: AbortSignal;
 }
+/**
+ * What a program has names for. Buffers are absent on purpose: a buffer has no
+ * name in the source, so it cannot be resolved against a program the way a
+ * uniform or an attribute is, and its lifetime is rarely a program's. Build one
+ * with `bufferView` and pass it to `vao()` alongside the attributes.
+ */
 interface ViewSchema {
     uniforms?: UniformSchema;
     attributes?: AttributeSchema;
     interleavedAttributes?: InterleavedAttributeSchema;
-    buffers?: BufferSchema;
 }
 type PartialSchema<T> = T extends Record<string | symbol, infer V> ? Record<string | symbol, Partial<V>> : never;
 interface ViewSchemaPartial {
     uniforms?: PartialSchema<UniformSchema>;
     attributes?: PartialSchema<AttributeSchema>;
     interleavedAttributes?: PartialSchema<InterleavedAttributeSchema>;
-    buffers?: PartialSchema<BufferSchema>;
 }
 type View<T extends ViewSchema = ViewSchema> = {
     attributes: T['attributes'] extends AttributeSchema ? Prettify<AttributeView<T['attributes']>> : {};
     interleavedAttributes: T['interleavedAttributes'] extends InterleavedAttributeSchema ? Prettify<InterleavedAttributeView<T['interleavedAttributes']>> : {};
-    buffers: T['buffers'] extends BufferSchema ? Prettify<BufferView<T['buffers']>> : {};
     uniforms: T['uniforms'] extends UniformSchema ? Prettify<UniformView<T['uniforms']>> : {};
+    /**
+     * Build a vertex array from the participants one draw needs — its attributes,
+     * its interleaved layouts, its element buffer.
+     *
+     * This is the one member the schema cannot declare, because its input is the
+     * schema's own output. It is also the only place a vertex array is created:
+     * the participants no longer make one each, so which array they end up in is
+     * something you say rather than something you inherit from call order.
+     */
+    vao(participants: VertexArrayParticipant[]): VertexArrayMethods;
+    /**
+     * Delete everything the view made: the buffers behind its attributes and
+     * layouts, and any vertex array still held from `vao()`. Buffers named by the
+     * schema are left alone — those belong to whoever made them. Idempotent, and
+     * exactly what aborting the signal does.
+     */
+    dispose(): void;
 };
 /**********************************************************************************/
 /**********************************************************************************/
@@ -437,6 +545,11 @@ type CompileResult<TVertex extends GLSL, TFragment extends GLSL, TOverrideSchema
     view: Prettify<View<TSchema>>;
     vertex: string;
     fragment: string;
+    /**
+     * Delete the program and everything its view made. Idempotent, and
+     * exactly what aborting the signal does.
+     */
+    dispose(): void;
 } : never;
 
-export type { TexImage2DOptions as $, AttributeSchema as A, BufferSchema as B, AttributeMethods as C, InterleavedAttributeLayout as D, InterleavedAttributeDefinition as E, InterleavedAttributeMethods as F, GL as G, BufferDefinition as H, InterleavedAttributeSchema as I, BufferMethods as J, KIND_TO_UNIFORM_FN_NAME_MAP as K, FramebufferDefinition as L, Framebuffer as M, TextureTarget as N, TextureSchema as O, TextureMethods as P, TextureView as Q, RemoveSuffix as R, TextureParameterName as S, TextureDefinition as T, UniformSchema as U, ViewSchema as V, TextureParameterValue as W, TextureParameters as X, InternalFormat as Y, Format as Z, PixelType as _, ViewOptions as a, ViewSchemaPartial as a0, GLSLResult as a1, GLSLSlot as a2, GLSL as a3, UniformToken as a4, UniformTokenFn as a5, AttributeToken as a6, AttributeTokenFn as a7, InterleaveToken as a8, GLSLToSchema as a9, GLSLToView as aa, GLSLSlotsToSchema as ab, FlattenSlots as ac, MergeGLSLSchema as ad, CompileResult as ae, Prettify as af, View as b, UniformView as c, AttributeView as d, InterleavedAttributeView as e, BufferView as f, GLTarget as g, GLUsage as h, GLTextureTarget as i, GLTextureFormat as j, GLTextureType as k, GLTextureFilter as l, GLTextureWrap as m, KIND_TO_SIZE_MAP as n, UniformFnName as o, UniformKind as p, UniformKindMap as q, UniformDefinition as r, UniformElementMethods as s, UniformArrayMethods as t, UniformMethods as u, UniformValue as v, AttributeShortHand as w, AttributeKind as x, AttributeFormat as y, AttributeDefinition as z };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigmistqke/view.gl",
-  "version": "0.1.19",
+  "version": "0.3.0",
   "description": "👀 Utilities for managing WebGL resources.",
   "exports": {
     ".": {

package/src/gl.ts

@@ -1,5 +1,6 @@
 import { RemoveSuffix } from './type-utils'
-import type { GL } from './types'
+import type { GL, ViewOptions } from './types'
+import { once } from './utils'
 
 function isWebGL2RenderingContext(
   gl: WebGLRenderingContext | WebGL2RenderingContext,
@@ -37,7 +38,12 @@ export function createShader(gl: GL, type: number, source: string): WebGLShader
 /*                                                                                */
 /**********************************************************************************/
 
-export function createProgram(gl: GL, vertexSource: string, fragmentSource: string): WebGLProgram {
+export function createProgram(
+  gl: GL,
+  vertexSource: string,
+  fragmentSource: string,
+  { signal }: ViewOptions = {},
+): WebGLProgram {
   const program = gl.createProgram()
   if (!program) throw new Error('Failed to create WebGL program')
 
@@ -60,6 +66,11 @@ export function createProgram(gl: GL, vertexSource: string, fragmentSource: stri
   gl.deleteShader(vertexShader)
   gl.deleteShader(fragmentShader)
 
+  signal?.addEventListener(
+    'abort',
+    once(() => gl.deleteProgram(program)),
+  )
+
   return program
 }