import type { GrowableBuffer } from "./utils.mjs";
export interface InstancedAttribute {
  buffer: GrowableBuffer;
  location: number;
  size: number;
  glType: GLenum;
  normalized: boolean;
}
/**
 * Creates a per-instance vertex attribute backed by a fresh grow-only GPU buffer.
 *
 * The caller MUST have the owning VAO bound when calling this — the
 * vertexAttribPointer + vertexAttribDivisor calls register the binding into
 * that VAO and the program then references it on each draw.
 */
export declare function createInstancedAttribute(gl: WebGL2RenderingContext, program: WebGLProgram, name: string, size: number, glType?: GLenum, normalized?: boolean): InstancedAttribute;
/**
 * Wires up a per-instance vertex attribute that reads from an existing GrowableBuffer.
 * Use this when the same buffer must back the same-named attribute in multiple
 * VAOs (e.g. two shader-program variants over the same data).
 *
 * The caller MUST have the owning VAO bound when calling this.
 *
 * If the attribute is missing from the program (typo, or optimized out by the
 * compiler), `getAttribLocation` returns -1. We skip the GL setup in that case to
 * avoid `INVALID_VALUE` errors from `enableVertexAttribArray(-1)` and warn in dev.
 */
export declare function bindInstancedAttribute(gl: WebGL2RenderingContext, program: WebGLProgram, name: string, buffer: GrowableBuffer, size: number, glType?: GLenum, normalized?: boolean): InstancedAttribute;