@babylonjs/lite-gl 0.1.0 → 0.2.0

package/index.js

@@ -1,263 +1,42 @@
-import { u as useEffect, c as createEffect, d as disposeEffect } from "./effect-BxxwfB_O.js";
-import { a, b, e, g, f, h, i, j, o, k, l, m, r, s, n, p, q, t, v, w, x, y, z, A, B, C, D, E, F, G, H } from "./effect-BxxwfB_O.js";
-import { a as applyGLStates } from "./state--j_ncWIi.js";
-import { b as b2, c, a as a2, d, e as e2, g as g2, l as l2, u, f as f2, h as h2 } from "./texture-DaMd1gGm.js";
-import { clearDynamicTextureSource, createDynamicTexture, updateDynamicTexture } from "./dynamic-texture.js";
-import { bindRenderTarget, createFloatRenderTarget, createPingPong, createRenderTarget, disposePingPong, disposeRenderTarget, generateRenderTargetMipMaps, readRenderTargetPixels, resizePingPong, resizeRenderTarget } from "./render-target.js";
-import { bindAttributes, bindIndexBuffer, bindMeshVao, createIndexBuffer, createMeshVao, createVertexBuffer, disposeBuffer, disposeMeshVao, drawIndexed, drawMesh, unbindInstanceAttributes, updateVertexBuffer } from "./mesh.js";
-import { G as G2, a as a3, c as c2, d as d2, b as b3, r as r2, s as s2, e as e3, f as f3 } from "./sprites--1oyVtJ3.js";
-import { clearEngine, generateRenderTargetStencil, setColorMask, setCullState, setDepthState, setStencilState } from "./depth-stencil.js";
-import { disableScissor, setScissor } from "./scissor.js";
-import { GLSamplingMode, createHtmlElementTexture, updateHtmlElementTexture } from "./html-texture.js";
-function runRenderLoop(engine, fn) {
-  if (engine._disposed) {
-    return;
-  }
-  if (engine._scheduleFrame === null) {
-    engine._scheduleFrame = scheduleFrame;
-  }
-  if (engine._loops.indexOf(fn) !== -1) {
-    return;
-  }
-  engine._loops.push(fn);
-  if (engine._rafId === 0 && !engine._isLost) {
-    scheduleFrame(engine);
-  }
-}
-function stopRenderLoop(engine, fn) {
-  if (fn === void 0) {
-    engine._loops.length = 0;
-  } else {
-    const i2 = engine._loops.indexOf(fn);
-    if (i2 !== -1) {
-      engine._loops.splice(i2, 1);
-    }
-  }
-  if (engine._loops.length === 0 && engine._rafId !== 0) {
-    cancelAnimationFrame(engine._rafId);
-    engine._rafId = 0;
-  }
-}
-function scheduleFrame(engine) {
-  engine._prevNow = performance.now();
-  engine._rafId = requestAnimationFrame((now) => tick(engine, now));
-}
-function tick(engine, now) {
-  engine._rafId = 0;
-  if (engine._disposed || engine._isLost || engine._loops.length === 0) {
-    return;
-  }
-  const dt = now - engine._prevNow;
-  engine._prevNow = now;
-  const loops = engine._loops.slice();
-  for (const cb of loops) {
-    try {
-      cb(dt);
-    } catch (err) {
-      console.error("lite-gl: render loop callback threw", err);
-    }
-  }
-  if (engine._loops.length > 0 && !engine._disposed && !engine._isLost) {
-    engine._rafId = requestAnimationFrame((nextNow) => tick(engine, nextNow));
-  }
-}
-const DEFAULT_FULLSCREEN_VERTEX_SOURCE = `#version 300 es
-layout(location = 0) in vec2 position;
-out vec2 vUv;
-void main() {
-    vUv = position * 0.5 + 0.5;
-    gl_Position = vec4(position, 0.0, 1.0);
-}`;
-function createEffectWrapper(engine, options) {
-  const name = options.name ?? "effect-wrapper";
-  const effect = createEffect(engine, {
-    name,
-    vertexSource: options.vertexSource ?? DEFAULT_FULLSCREEN_VERTEX_SOURCE,
-    fragmentSource: options.fragmentSource,
-    uniformNames: options.uniformNames ?? [],
-    samplerNames: options.samplerNames ?? [],
-    attributeNames: options.attributeNames,
-    defines: options.defines
-  });
-  return { name, effect, _engine: engine, _disposed: false };
-}
-function disposeEffectWrapper(wrapper) {
-  if (wrapper._disposed) {
-    return;
-  }
-  wrapper._disposed = true;
-  disposeEffect(wrapper._engine, wrapper.effect);
-}
-function setViewport(engine, viewport) {
-  if (engine._isLost || engine._disposed) {
-    return;
-  }
-  const x2 = (viewport == null ? void 0 : viewport.x) ?? 0;
-  const y2 = (viewport == null ? void 0 : viewport.y) ?? 0;
-  const w2 = (viewport == null ? void 0 : viewport.w) ?? engine.canvas.width;
-  const h3 = (viewport == null ? void 0 : viewport.h) ?? engine.canvas.height;
-  const s3 = engine._state;
-  if (s3.viewportX === x2 && s3.viewportY === y2 && s3.viewportW === w2 && s3.viewportH === h3) {
-    return;
-  }
-  s3.viewportX = x2;
-  s3.viewportY = y2;
-  s3.viewportW = w2;
-  s3.viewportH = h3;
-  engine.gl.viewport(x2, y2, w2, h3);
-}
-function applyEffectWrapper(wrapper) {
-  const engine = wrapper._engine;
-  if (engine._isLost || engine._disposed || wrapper._disposed) {
-    return;
-  }
-  ensureQuad(engine);
-  useEffect(engine, wrapper.effect);
-}
-function drawEffect(engine) {
-  if (engine._isLost || engine._disposed) {
-    return;
-  }
-  if (engine._state.currentProgram === null) {
-    return;
-  }
-  applyGLStates(engine);
-  engine.gl.drawElements(engine.gl.TRIANGLES, 6, engine.gl.UNSIGNED_SHORT, 0);
-}
-function ensureQuad(engine) {
-  const s3 = engine._state;
-  const gl = engine.gl;
-  if (s3.quadVao !== null) {
-    if (s3.boundVao !== s3.quadVao) {
-      gl.bindVertexArray(s3.quadVao);
-      s3.boundVao = s3.quadVao;
-    }
-    return;
-  }
-  const vao = gl.createVertexArray();
-  if (vao === null) {
-    throw new Error("lite-gl: gl.createVertexArray returned null");
-  }
-  s3.quadVao = vao;
-  gl.bindVertexArray(vao);
-  s3.boundVao = vao;
-  const vbo = gl.createBuffer();
-  if (vbo === null) {
-    throw new Error("lite-gl: gl.createBuffer returned null (VBO)");
-  }
-  s3.quadVbo = vbo;
-  gl.bindBuffer(gl.ARRAY_BUFFER, vbo);
-  s3.boundArrayBuffer = vbo;
-  gl.bufferData(gl.ARRAY_BUFFER, QUAD_POSITIONS, gl.STATIC_DRAW);
-  const ibo = gl.createBuffer();
-  if (ibo === null) {
-    throw new Error("lite-gl: gl.createBuffer returned null (IBO)");
-  }
-  s3.quadIbo = ibo;
-  gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, ibo);
-  s3.boundElementBuffer = ibo;
-  gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, QUAD_INDICES, gl.STATIC_DRAW);
-  gl.enableVertexAttribArray(0);
-  gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);
-}
-const QUAD_POSITIONS = new Float32Array([1, 1, -1, 1, -1, -1, 1, -1]);
-const QUAD_INDICES = new Uint16Array([0, 1, 2, 0, 2, 3]);
-export {
-  G2 as GLBlendEquation,
-  a3 as GLBlendMode,
-  GLSamplingMode,
-  applyEffectWrapper,
-  bindAttributes,
-  bindIndexBuffer,
-  bindMeshVao,
-  bindRenderTarget,
-  b2 as bindTexture,
-  clearDynamicTextureSource,
-  clearEngine,
-  createDynamicTexture,
-  createEffect,
-  createEffectWrapper,
-  createFloatRenderTarget,
-  c as createFloatTexture,
-  a as createGLEngine,
-  createHtmlElementTexture,
-  createIndexBuffer,
-  createMeshVao,
-  createPingPong,
-  a2 as createRawTexture,
-  createRenderTarget,
-  c2 as createSpriteRenderer,
-  d as createTextureFromHandle,
-  createVertexBuffer,
-  d2 as disableBlend,
-  disableScissor,
-  disposeBuffer,
-  disposeEffect,
-  disposeEffectWrapper,
-  b as disposeGLEngine,
-  disposeMeshVao,
-  disposePingPong,
-  disposeRenderTarget,
-  b3 as disposeSpriteRenderer,
-  e2 as disposeTexture,
-  drawEffect,
-  drawIndexed,
-  drawMesh,
-  e as executeWhenCompiled,
-  generateRenderTargetMipMaps,
-  generateRenderTargetStencil,
-  g2 as generateTextureMipMaps,
-  g as getHardwareScalingLevel,
-  f as getRenderHeight,
-  h as getRenderWidth,
-  i as getRenderingCanvas,
-  j as isEffectReady,
-  l2 as loadTexture2D,
-  o as offContextLost,
-  k as offContextRestored,
-  l as onContextLost,
-  m as onContextRestored,
-  readRenderTargetPixels,
-  r2 as renderSprites,
-  r as resizeGLEngine,
-  resizePingPong,
-  resizeRenderTarget,
-  runRenderLoop,
-  s2 as setBlendMode,
-  e3 as setBlendState,
-  setColorMask,
-  setCullState,
-  setDepthState,
-  s as setEffectColor3,
-  n as setEffectColor4,
-  p as setEffectDirectColor4,
-  q as setEffectFloat,
-  t as setEffectFloat2,
-  v as setEffectFloat3,
-  w as setEffectFloat4,
-  x as setEffectFloatArray,
-  y as setEffectFloatArray4,
-  z as setEffectInt,
-  A as setEffectIntArray,
-  B as setEffectMatrix,
-  C as setEffectMatrix3x3,
-  D as setEffectTexture,
-  E as setEffectVector2,
-  F as setGLEngineSize,
-  G as setHardwareScalingLevel,
-  setScissor,
-  f3 as setSpriteRendererTexture,
-  setStencilState,
-  setViewport,
-  stopRenderLoop,
-  unbindInstanceAttributes,
-  updateDynamicTexture,
-  updateHtmlElementTexture,
-  u as updateRawTexture,
-  f2 as updateTextureSamplingMode,
-  h2 as updateTextureWrapMode,
-  updateVertexBuffer,
-  useEffect,
-  H as wipeGLStateCache
-};
-//# sourceMappingURL=index.js.map
+// @babylonjs/lite-gl — Public API
+// Function-based, tree-shakeable WebGL2 micro-engine. Import only what you use.
+//
+// Convention (mirrors @babylonjs/lite): the public API is re-exported EXPLICITLY
+// by name — never `export *`. This keeps the public surface intentional and
+// reviewable, lets `export type` mark type-only re-exports (required under
+// `isolatedModules`), and keeps internal helpers (e.g. `bindTextureRaw`,
+// `bindTextureForUpload`) out of consumers' bundles + `.d.ts`.
+//
+// The package is `sideEffects: false` and no module has top-level side effects,
+// so a consumer that imports only the symbols it needs tree-shakes everything
+// else (sprites, html-texture, …) away.
+// ─── Engine / context ────────────────────────────────────────────────
+export { createGLEngine, disposeGLEngine, resizeGLEngine, setGLEngineSize, wipeGLStateCache, getRenderWidth, getRenderHeight, getHardwareScalingLevel, setHardwareScalingLevel, getRenderingCanvas, onContextLost, offContextLost, onContextRestored, offContextRestored, } from "./context.js";
+// ─── Render loop ─────────────────────────────────────────────────────
+export { runRenderLoop, stopRenderLoop } from "./render-loop.js";
+// ─── Effects ─────────────────────────────────────────────────────────
+export { createEffect, useEffect, isEffectReady, executeWhenCompiled, disposeEffect, setEffectFloat, setEffectFloat2, setEffectFloat3, setEffectFloat4, setEffectColor3, setEffectColor4, setEffectVector2, setEffectDirectColor4, setEffectInt, setEffectTexture, setEffectMatrix, setEffectMatrix3x3, setEffectFloatArray, setEffectFloatArray4, setEffectIntArray, } from "./effect.js";
+// ─── Effect renderer (fullscreen quad) ───────────────────────────────
+export { createEffectWrapper, applyEffectWrapper, drawEffect, setViewport, disposeEffectWrapper } from "./effect-renderer.js";
+// ─── Textures ────────────────────────────────────────────────────────
+export { createRawTexture, createFloatTexture, generateTextureMipMaps, loadTexture2D, bindTexture, disposeTexture, updateRawTexture, updateTextureSamplingMode, updateTextureWrapMode, createTextureFromHandle, } from "./texture.js";
+// ─── Dynamic textures ────────────────────────────────────────────────
+export { createDynamicTexture, updateDynamicTexture, clearDynamicTextureSource } from "./dynamic-texture.js";
+// ─── Render targets ──────────────────────────────────────────────────
+export { createRenderTarget, createFloatRenderTarget, bindRenderTarget, generateRenderTargetMipMaps, resizeRenderTarget, readRenderTargetPixels, disposeRenderTarget, createPingPong, resizePingPong, disposePingPong, } from "./render-target.js";
+// ─── Meshes / buffers / instancing ───────────────────────────────────
+export { createVertexBuffer, updateVertexBuffer, createIndexBuffer, disposeBuffer, bindIndexBuffer, bindAttributes, unbindInstanceAttributes, drawIndexed, createMeshVao, bindMeshVao, drawMesh, disposeMeshVao, } from "./mesh.js";
+// ─── Blend modes ─────────────────────────────────────────────────────
+// GLBlendMode / GLBlendEquation are const + same-name type; one value
+// re-export carries both.
+export { GLBlendMode, GLBlendEquation, setBlendMode, setBlendState, disableBlend } from "./blend.js";
+// ─── Depth / stencil / color-mask / clear ────────────────────────────
+export { setDepthState, setCullState, setStencilState, setColorMask, clearEngine, generateRenderTargetStencil } from "./depth-stencil.js";
+// ─── Scissor ─────────────────────────────────────────────────────────
+export { setScissor, disableScissor } from "./scissor.js";
+// ─── Sprites ─────────────────────────────────────────────────────────
+export { createSpriteRenderer, renderSprites, setSpriteRendererTexture, disposeSpriteRenderer } from "./sprites.js";
+// ─── HTML-element textures ───────────────────────────────────────────
+// GLSamplingMode is a const + same-name type; one value re-export carries both.
+export { createHtmlElementTexture, updateHtmlElementTexture, GLSamplingMode } from "./html-texture.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/render-loop.ts","../src/effect-renderer.ts"],"sourcesContent":["import { type GLEngineContext } from \"./context.js\";\n\n/** Register a per-frame callback. **No-op if `fn` is already registered**\n *  (matches Babylon `AbstractEngine.runRenderLoop`). Starts the rAF if this is\n *  the first registration. */\nexport function runRenderLoop(engine: GLEngineContext, fn: (dt: number) => void): void {\n    if (engine._disposed) {\n        return;\n    }\n    // Install the resume hook on the context (no module-level side effects).\n    if (engine._scheduleFrame === null) {\n        engine._scheduleFrame = scheduleFrame;\n    }\n    if (engine._loops.indexOf(fn) !== -1) {\n        return;\n    }\n    engine._loops.push(fn);\n    if (engine._rafId === 0 && !engine._isLost) {\n        scheduleFrame(engine);\n    }\n}\n\n/** Stop one (or all when omitted) registered callbacks. Cancels the rAF if\n *  no callbacks remain. */\nexport function stopRenderLoop(engine: GLEngineContext, fn?: (dt: number) => void): void {\n    if (fn === undefined) {\n        engine._loops.length = 0;\n    } else {\n        const i = engine._loops.indexOf(fn);\n        if (i !== -1) {\n            engine._loops.splice(i, 1);\n        }\n    }\n    if (engine._loops.length === 0 && engine._rafId !== 0) {\n        cancelAnimationFrame(engine._rafId);\n        engine._rafId = 0;\n    }\n}\n\nfunction scheduleFrame(engine: GLEngineContext): void {\n    engine._prevNow = performance.now();\n    engine._rafId = requestAnimationFrame((now) => tick(engine, now));\n}\n\nfunction tick(engine: GLEngineContext, now: number): void {\n    engine._rafId = 0;\n    if (engine._disposed || engine._isLost || engine._loops.length === 0) {\n        return;\n    }\n    const dt = now - engine._prevNow;\n    engine._prevNow = now;\n    // Snapshot — a callback may call stopRenderLoop on itself or others.\n    const loops = engine._loops.slice();\n    for (const cb of loops) {\n        try {\n            cb(dt);\n        } catch (err) {\n            console.error(\"lite-gl: render loop callback threw\", err);\n        }\n    }\n    if (engine._loops.length > 0 && !engine._disposed && !engine._isLost) {\n        engine._rafId = requestAnimationFrame((nextNow) => tick(engine, nextNow));\n    }\n}\n","import type { GLEngineContext } from \"./context.js\";\nimport { createEffect, disposeEffect, type GLEffect, useEffect } from \"./effect.js\";\nimport { applyGLStates } from \"./apply-states.js\";\n\n/** Built-in fullscreen-quad vertex shader, used when `GLEffectWrapperOptions`\n *  omits `vertexSource`. Maps the package's fullscreen-quad positions\n *  (attribute location 0) to clip space and forwards a 0..1 `vUv` varying —\n *  the WebGL counterpart of lite's default `vertexWGSL`, so callers can pass\n *  only `fragmentSource`. */\nconst DEFAULT_FULLSCREEN_VERTEX_SOURCE = `#version 300 es\nlayout(location = 0) in vec2 position;\nout vec2 vUv;\nvoid main() {\n    vUv = position * 0.5 + 0.5;\n    gl_Position = vec4(position, 0.0, 1.0);\n}`;\n\n/** Inputs to `createEffectWrapper`. Mirrors lite's `EffectWrapperOptions`: the\n *  wrapper compiles and OWNS the effect built from this shader source. */\nexport interface GLEffectWrapperOptions {\n    /** Human-readable label for the wrapper and its effect. Defaults to\n     *  `\"effect-wrapper\"`. */\n    name?: string;\n    /** GLSL ES 3.00 vertex source. Defaults to a built-in fullscreen-quad\n     *  vertex shader (exposing a `vUv` varying), mirroring lite's default\n     *  `vertexWGSL`. */\n    vertexSource?: string;\n    /** GLSL ES 3.00 fragment source (≙ lite's `fragmentWGSL`). Required. */\n    fragmentSource: string;\n    /** Declared uniform names. Defaults to none. */\n    uniformNames?: readonly string[];\n    /** Declared sampler names, in unit-assignment order. Defaults to none. */\n    samplerNames?: readonly string[];\n    /** Attribute names; the first is bound to location 0. Defaults to\n     *  `[\"position\"]`. */\n    attributeNames?: readonly string[];\n    /** Optional `#define` block prepended to both shader stages. */\n    defines?: string;\n}\n\n/** A reusable fullscreen effect that compiles and OWNS its `GLEffect` — the\n *  WebGL counterpart of lite's `EffectWrapper`. The wrapper retains the engine\n *  it was created for, so `disposeEffectWrapper` / `applyEffectWrapper` take\n *  only the wrapper. */\nexport interface GLEffectWrapper {\n    /** Name alias for the wrapper (and its effect). */\n    readonly name: string;\n    /** The compiled effect this wrapper owns. Exposed so the per-uniform\n     *  setters (`setEffectFloat`/`setEffectTexture`/…) can target it — the\n     *  WebGL divergence from lite's UBO-based `setEffectUniforms(wrapper, …)`. */\n    readonly effect: GLEffect;\n    /** @internal The engine the wrapper was created for. */\n    _engine: GLEngineContext;\n    /** @internal */\n    _disposed: boolean;\n}\n\n/** Compile a fullscreen effect from shader source and wrap it; the wrapper OWNS\n *  the resulting `GLEffect`. Mirrors lite's `createEffectWrapper(engine, options)`.\n *  When `vertexSource` is omitted, a built-in fullscreen-quad vertex shader is\n *  used, so callers can supply only `fragmentSource`. */\nexport function createEffectWrapper(engine: GLEngineContext, options: GLEffectWrapperOptions): GLEffectWrapper {\n    const name = options.name ?? \"effect-wrapper\";\n    const effect = createEffect(engine, {\n        name,\n        vertexSource: options.vertexSource ?? DEFAULT_FULLSCREEN_VERTEX_SOURCE,\n        fragmentSource: options.fragmentSource,\n        uniformNames: options.uniformNames ?? [],\n        samplerNames: options.samplerNames ?? [],\n        attributeNames: options.attributeNames,\n        defines: options.defines,\n    });\n    return { name, effect, _engine: engine, _disposed: false };\n}\n\n/** Dispose the wrapper and the effect it owns (idempotent). Mirrors lite's\n *  `disposeEffectWrapper(wrapper)`. */\nexport function disposeEffectWrapper(wrapper: GLEffectWrapper): void {\n    if (wrapper._disposed) {\n        return;\n    }\n    wrapper._disposed = true;\n    disposeEffect(wrapper._engine, wrapper.effect);\n}\n\n/** Pixel-space viewport rectangle passed to `setViewport`. */\nexport interface GLViewport {\n    /** Lower-left X origin in physical pixels. */\n    x: number;\n    /** Lower-left Y origin in physical pixels. */\n    y: number;\n    /** Width in physical pixels. */\n    w: number;\n    /** Height in physical pixels. */\n    h: number;\n}\n\n/** Cached `gl.viewport`. Defaults to the full canvas in pixel coordinates. */\nexport function setViewport(engine: GLEngineContext, viewport?: GLViewport): void {\n    if (engine._isLost || engine._disposed) {\n        return;\n    }\n    const x = viewport?.x ?? 0;\n    const y = viewport?.y ?? 0;\n    const w = viewport?.w ?? engine.canvas.width;\n    const h = viewport?.h ?? engine.canvas.height;\n    const s = engine._state;\n    if (s.viewportX === x && s.viewportY === y && s.viewportW === w && s.viewportH === h) {\n        return;\n    }\n    s.viewportX = x;\n    s.viewportY = y;\n    s.viewportW = w;\n    s.viewportH = h;\n    engine.gl.viewport(x, y, w, h);\n}\n\n/** Make `wrapper.effect` current and ensure the shared fullscreen quad VAO\n *  is bound. This MUST be called BEFORE any `setEffect*` call for the same\n *  effect in the current frame (uniform setters write to the currently bound\n *  program). */\nexport function applyEffectWrapper(wrapper: GLEffectWrapper): void {\n    const engine = wrapper._engine;\n    if (engine._isLost || engine._disposed || wrapper._disposed) {\n        return;\n    }\n    ensureQuad(engine);\n    useEffect(engine, wrapper.effect);\n}\n\n/** `gl.drawElements(TRIANGLES, 6, UNSIGNED_SHORT, 0)`. No-op when the\n *  context is lost or there is no current program. */\nexport function drawEffect(engine: GLEngineContext): void {\n    if (engine._isLost || engine._disposed) {\n        return;\n    }\n    if (engine._state.currentProgram === null) {\n        return;\n    }\n    applyGLStates(engine);\n    engine.gl.drawElements(engine.gl.TRIANGLES, 6, engine.gl.UNSIGNED_SHORT, 0);\n}\n\n/** Lazy fullscreen quad. Built on first call; thereafter the VAO is cached on\n *  `_state.quadVao` and rebinding is a single cached call. Cleared by\n *  `webglcontextlost` and transparently rebuilt by the next\n *  `applyEffectWrapper` after restore.\n *\n *  Position attribute is enabled at location 0 — every effect's\n *  `createEffect` calls `gl.bindAttribLocation(program, 0, attributeNames[0])`\n *  BEFORE link, so the shared VAO is correct across all programs. */\nfunction ensureQuad(engine: GLEngineContext): void {\n    const s = engine._state;\n    const gl = engine.gl;\n    if (s.quadVao !== null) {\n        if (s.boundVao !== s.quadVao) {\n            gl.bindVertexArray(s.quadVao);\n            s.boundVao = s.quadVao;\n        }\n        return;\n    }\n    const vao = gl.createVertexArray();\n    if (vao === null) {\n        throw new Error(\"lite-gl: gl.createVertexArray returned null\");\n    }\n    s.quadVao = vao;\n    gl.bindVertexArray(vao);\n    s.boundVao = vao;\n\n    const vbo = gl.createBuffer();\n    if (vbo === null) {\n        throw new Error(\"lite-gl: gl.createBuffer returned null (VBO)\");\n    }\n    s.quadVbo = vbo;\n    gl.bindBuffer(gl.ARRAY_BUFFER, vbo);\n    s.boundArrayBuffer = vbo;\n    gl.bufferData(gl.ARRAY_BUFFER, QUAD_POSITIONS, gl.STATIC_DRAW);\n\n    const ibo = gl.createBuffer();\n    if (ibo === null) {\n        throw new Error(\"lite-gl: gl.createBuffer returned null (IBO)\");\n    }\n    s.quadIbo = ibo;\n    gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, ibo);\n    s.boundElementBuffer = ibo;\n    gl.bufferData(gl.ELEMENT_ARRAY_BUFFER, QUAD_INDICES, gl.STATIC_DRAW);\n\n    gl.enableVertexAttribArray(0);\n    gl.vertexAttribPointer(0, 2, gl.FLOAT, false, 0, 0);\n}\n\n/** Typed-array literal — pure per bundler convention. Matches Babylon's\n *  `EffectRenderer` default geometry exactly. */\nconst QUAD_POSITIONS = new Float32Array([1, 1, -1, 1, -1, -1, 1, -1]);\nconst QUAD_INDICES = new Uint16Array([0, 1, 2, 0, 2, 3]);\n"],"names":["i","x","y","w","h","s"],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,gFAAgF;AAChF,EAAE;AACF,iFAAiF;AACjF,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,wCAAwC;AAExC,wEAAwE;AACxE,OAAO,EACH,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACrB,MAAM,cAAc,CAAC;AAGtB,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wEAAwE;AACxE,OAAO,EACH,YAAY,EACZ,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,aAAa,CAAC;AAGrB,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG9H,wEAAwE;AACxE,OAAO,EACH,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,cAAc,CAAC;AAGtB,wEAAwE;AACxE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAE7G,wEAAwE;AACxE,OAAO,EACH,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,GAClB,MAAM,oBAAoB,CAAC;AAG5B,wEAAwE;AACxE,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,WAAW,EACX,aAAa,EACb,WAAW,EACX,QAAQ,EACR,cAAc,GACjB,MAAM,WAAW,CAAC;AAGnB,wEAAwE;AACxE,sEAAsE;AACtE,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrG,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAG1I,wEAAwE;AACxE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE1D,wEAAwE;AACxE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGpH,wEAAwE;AACxE,gFAAgF;AAChF,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC","sourcesContent":["// @babylonjs/lite-gl — Public API\n// Function-based, tree-shakeable WebGL2 micro-engine. Import only what you use.\n//\n// Convention (mirrors @babylonjs/lite): the public API is re-exported EXPLICITLY\n// by name — never `export *`. This keeps the public surface intentional and\n// reviewable, lets `export type` mark type-only re-exports (required under\n// `isolatedModules`), and keeps internal helpers (e.g. `bindTextureRaw`,\n// `bindTextureForUpload`) out of consumers' bundles + `.d.ts`.\n//\n// The package is `sideEffects: false` and no module has top-level side effects,\n// so a consumer that imports only the symbols it needs tree-shakes everything\n// else (sprites, html-texture, …) away.\n\n// ─── Engine / context ────────────────────────────────────────────────\nexport {\n    createGLEngine,\n    disposeGLEngine,\n    resizeGLEngine,\n    setGLEngineSize,\n    wipeGLStateCache,\n    getRenderWidth,\n    getRenderHeight,\n    getHardwareScalingLevel,\n    setHardwareScalingLevel,\n    getRenderingCanvas,\n    onContextLost,\n    offContextLost,\n    onContextRestored,\n    offContextRestored,\n} from \"./context.js\";\nexport type { GLEngineOptions, GLEngineCaps, GLEngineContext } from \"./context.js\";\n\n// ─── Render loop ─────────────────────────────────────────────────────\nexport { runRenderLoop, stopRenderLoop } from \"./render-loop.js\";\n\n// ─── Effects ─────────────────────────────────────────────────────────\nexport {\n    createEffect,\n    useEffect,\n    isEffectReady,\n    executeWhenCompiled,\n    disposeEffect,\n    setEffectFloat,\n    setEffectFloat2,\n    setEffectFloat3,\n    setEffectFloat4,\n    setEffectColor3,\n    setEffectColor4,\n    setEffectVector2,\n    setEffectDirectColor4,\n    setEffectInt,\n    setEffectTexture,\n    setEffectMatrix,\n    setEffectMatrix3x3,\n    setEffectFloatArray,\n    setEffectFloatArray4,\n    setEffectIntArray,\n} from \"./effect.js\";\nexport type { GLEffectOptions, GLEffect } from \"./effect.js\";\n\n// ─── Effect renderer (fullscreen quad) ───────────────────────────────\nexport { createEffectWrapper, applyEffectWrapper, drawEffect, setViewport, disposeEffectWrapper } from \"./effect-renderer.js\";\nexport type { GLEffectWrapperOptions, GLEffectWrapper, GLViewport } from \"./effect-renderer.js\";\n\n// ─── Textures ────────────────────────────────────────────────────────\nexport {\n    createRawTexture,\n    createFloatTexture,\n    generateTextureMipMaps,\n    loadTexture2D,\n    bindTexture,\n    disposeTexture,\n    updateRawTexture,\n    updateTextureSamplingMode,\n    updateTextureWrapMode,\n    createTextureFromHandle,\n} from \"./texture.js\";\nexport type { GLTextureOptions, GLFloatTextureOptions, GLTexture } from \"./texture.js\";\n\n// ─── Dynamic textures ────────────────────────────────────────────────\nexport { createDynamicTexture, updateDynamicTexture, clearDynamicTextureSource } from \"./dynamic-texture.js\";\n\n// ─── Render targets ──────────────────────────────────────────────────\nexport {\n    createRenderTarget,\n    createFloatRenderTarget,\n    bindRenderTarget,\n    generateRenderTargetMipMaps,\n    resizeRenderTarget,\n    readRenderTargetPixels,\n    disposeRenderTarget,\n    createPingPong,\n    resizePingPong,\n    disposePingPong,\n} from \"./render-target.js\";\nexport type { GLRenderTarget, GLRenderTargetOptions, GLFloatRenderTargetOptions, GLPingPong } from \"./render-target.js\";\n\n// ─── Meshes / buffers / instancing ───────────────────────────────────\nexport {\n    createVertexBuffer,\n    updateVertexBuffer,\n    createIndexBuffer,\n    disposeBuffer,\n    bindIndexBuffer,\n    bindAttributes,\n    unbindInstanceAttributes,\n    drawIndexed,\n    createMeshVao,\n    bindMeshVao,\n    drawMesh,\n    disposeMeshVao,\n} from \"./mesh.js\";\nexport type { GLVertexBuffer, GLIndexBuffer, GLAttributeDescriptor, GLMeshVertexBuffer, GLMeshVao } from \"./mesh.js\";\n\n// ─── Blend modes ─────────────────────────────────────────────────────\n// GLBlendMode / GLBlendEquation are const + same-name type; one value\n// re-export carries both.\nexport { GLBlendMode, GLBlendEquation, setBlendMode, setBlendState, disableBlend } from \"./blend.js\";\nexport type { GLBlendState } from \"./blend.js\";\n\n// ─── Depth / stencil / color-mask / clear ────────────────────────────\nexport { setDepthState, setCullState, setStencilState, setColorMask, clearEngine, generateRenderTargetStencil } from \"./depth-stencil.js\";\nexport type { GLDepthState, GLStencilState, GLClearOptions } from \"./depth-stencil.js\";\n\n// ─── Scissor ─────────────────────────────────────────────────────────\nexport { setScissor, disableScissor } from \"./scissor.js\";\n\n// ─── Sprites ─────────────────────────────────────────────────────────\nexport { createSpriteRenderer, renderSprites, setSpriteRendererTexture, disposeSpriteRenderer } from \"./sprites.js\";\nexport type { GLSprite, GLSpriteColor, GLSpriteRendererOptions, GLSpriteRenderer } from \"./sprites.js\";\n\n// ─── HTML-element textures ───────────────────────────────────────────\n// GLSamplingMode is a const + same-name type; one value re-export carries both.\nexport { createHtmlElementTexture, updateHtmlElementTexture, GLSamplingMode } from \"./html-texture.js\";\nexport type { GLHtmlElementTextureOptions } from \"./html-texture.js\";\n"]}