@yali-engine/render 0.0.0-stage → 0.4.0

package/dist/tonemap.js

@@ -0,0 +1,141 @@
+import { whiteBalance } from "./post-options.js";
+import { postTonemap } from "./shaders.gen.js";
+/** Each curve's number in the shaders. */
+export const CURVES = { neutral: 0, aces: 1, none: 2 };
+const sat = (x) => Math.min(1, Math.max(0, x));
+/**
+ * `tone_map` of `shaders/post/curves.wesl` in TS: linear `rgb` times `exposure`, through
+ * `curve`, sRGB-encoded, into `out`. For colours the CPU hands the display directly (the clear
+ * colour when the draw tone-maps inline, ADR-0071).
+ */
+export function toneMapColor(rgb, exposure, curve, out = [0, 0, 0]) {
+    const c = [0, 1, 2].map((k) => Math.max(0, rgb[k] * exposure));
+    if (curve === 'neutral') {
+        const x = Math.min(c[0], c[1], c[2]);
+        const offset = x < 0.08 ? x - 6.25 * x * x : 0.04;
+        for (let k = 0; k < 3; k++)
+            c[k] -= offset;
+        const peak = Math.max(c[0], c[1], c[2]);
+        const start = 0.76;
+        if (peak >= start) {
+            const d = 1 - start;
+            const np = 1 - (d * d) / (peak + d - start);
+            const g = 1 - 1 / (0.15 * (peak - np) + 1);
+            for (let k = 0; k < 3; k++)
+                c[k] = c[k] * (np / peak) * (1 - g) + np * g;
+        }
+    }
+    else if (curve === 'aces') {
+        for (let k = 0; k < 3; k++)
+            c[k] = sat((c[k] * (2.51 * c[k] + 0.03)) / (c[k] * (2.43 * c[k] + 0.59) + 0.14));
+    }
+    for (let k = 0; k < 3; k++) {
+        const v = sat(c[k]);
+        out[k] = v <= 0.0031308 ? v * 12.92 : 1.055 * v ** (1 / 2.4) - 0.055;
+    }
+    return out;
+}
+/** Bytes of `ToneParams` (`shaders/post/tonemap.wesl`). */
+export const TONE_PARAMS_BYTES = 80;
+/**
+ * Writes `ToneParams`: exposure and curve, the bloom's weight (0: none) and the grading
+ * (`grading.enabled` false: none, so the pass is the plain tone map).
+ */
+export function writeToneParams(out, exposure, curve, bloom, grading) {
+    out.setFloat32(0, exposure, true);
+    out.setUint32(4, CURVES[curve], true);
+    out.setFloat32(8, bloom, true);
+    const g = grading?.enabled ? grading : null;
+    out.setUint32(12, g ? 1 : 0, true);
+    if (!g)
+        return;
+    const wb = whiteBalance(g.temperature, g.tint);
+    const v3 = (at, v) => v.forEach((x, i) => out.setFloat32(at + 4 * i, x, true));
+    v3(16, wb);
+    out.setFloat32(28, g.contrast, true);
+    v3(32, g.lift);
+    out.setFloat32(44, g.saturation, true);
+    v3(48, g.gamma);
+    v3(64, g.gain);
+}
+/**
+ * The tone-mapping pass (M2 increment 5): reads the scene's linear HDR target and writes the
+ * swapchain through exposure, a curve (Khronos PBR Neutral by default) and the sRGB transfer
+ * function. One full-screen triangle; its bind group follows the graph's reallocations.
+ */
+export class ToneMapper {
+    device;
+    /** Linear multiplier before the curve. */
+    exposure = 1;
+    curve = 'neutral';
+    /** The bloom chain's weight (set by the post chain; 0 without bloom). */
+    bloom = 0;
+    /** Colour grading (ADR-0092), or null. */
+    grading = null;
+    #pipeline;
+    #params;
+    #data = new ArrayBuffer(TONE_PARAMS_BYTES);
+    #view = new DataView(this.#data);
+    #last = new Uint8Array(TONE_PARAMS_BYTES);
+    #bytes = new Uint8Array(this.#data);
+    #group = null;
+    #generation = -1;
+    #fresh = true;
+    #format;
+    #sampler;
+    /** Bound where there is no bloom chain (the shader skips it). */
+    #black;
+    constructor(device, format) {
+        this.device = device;
+        this.#format = format;
+        this.#params = device.createBuffer({ label: 'yali:tonemap:params', size: TONE_PARAMS_BYTES, usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST });
+        this.#sampler = device.createSampler({ label: 'yali:tonemap', magFilter: 'linear', minFilter: 'linear', addressModeU: 'clamp-to-edge', addressModeV: 'clamp-to-edge' });
+        this.#black = device.createTexture({ label: 'yali:tonemap:noBloom', size: [1, 1], format: 'rgba16float', usage: GPUTextureUsage.TEXTURE_BINDING });
+    }
+    async init(cache) {
+        this.#pipeline = await cache.render({
+            label: 'yali:tonemap',
+            vertex: { shader: postTonemap, entryPoint: 'vs' },
+            fragment: { shader: postTonemap, entryPoint: 'fs', targets: [{ format: this.#format }] },
+            primitive: { topology: 'triangle-list' },
+        });
+    }
+    /** Adds `post.tonemap`, reading `input` (and `bloom`'s chain, if any) and writing `output`. */
+    addPass(graph, input, output, bloom) {
+        graph.addPass({
+            name: 'post.tonemap',
+            kind: 'render',
+            reads: bloom ? [input, bloom] : [input],
+            color: { target: output, clear: { r: 0, g: 0, b: 0, a: 1 } },
+            execute: (pass, ctx) => {
+                if (ctx.generation !== this.#generation || !this.#group) {
+                    this.#group = this.device.createBindGroup({
+                        label: 'yali:tonemap',
+                        layout: this.#pipeline.getBindGroupLayout(0),
+                        entries: [
+                            { binding: 0, resource: ctx.view(input) },
+                            { binding: 1, resource: { buffer: this.#params } },
+                            { binding: 2, resource: bloom ? ctx.view(bloom) : this.#black.createView() },
+                            { binding: 3, resource: this.#sampler },
+                        ],
+                    });
+                    this.#generation = ctx.generation;
+                }
+                writeToneParams(this.#view, this.exposure, this.curve, bloom ? this.bloom : 0, this.grading);
+                if (this.#fresh || !this.#bytes.every((b, i) => b === this.#last[i])) {
+                    this.device.queue.writeBuffer(this.#params, 0, this.#data);
+                    this.#last.set(this.#bytes);
+                    this.#fresh = false;
+                }
+                pass.setPipeline(this.#pipeline);
+                pass.setBindGroup(0, this.#group);
+                pass.draw(3);
+            },
+        });
+    }
+    destroy() {
+        this.#params.destroy();
+        this.#black.destroy();
+    }
+}
+//# sourceMappingURL=tonemap.js.map

package/dist/tonemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonemap.js","sourceRoot":"","sources":["../src/tonemap.ts"],"names":[],"mappings":"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"}

package/dist/viewport.d.ts

@@ -0,0 +1,78 @@
+/** Sizing policy for the render target. */
+export interface ViewportOptions {
+    /** Highest device-pixel ratio rendered (default 2: a 3× phone renders at 2×). */
+    readonly maxDpr?: number;
+    /** Most pixels in the render target (default 3840×2160). */
+    readonly maxPixels?: number;
+    /** Initial render scale (dynamic resolution; the governor drives it, DESIGN.md §4). */
+    readonly renderScale?: number;
+}
+/** What the page knows about the canvas's size: pushed into a worker's viewport (`setSize`). */
+export interface ViewportSize {
+    readonly css: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly dpr: number;
+    /** Exact device pixels (devicePixelContentBoxSize), when the browser reports them. */
+    readonly device: {
+        readonly width: number;
+        readonly height: number;
+    } | null;
+}
+/** The render target size for a CSS size, DPR and policy. Pure, so it is unit-tested. */
+export declare function computeRenderSize(css: {
+    width: number;
+    height: number;
+}, devicePixels: {
+    width: number;
+    height: number;
+} | null, dpr: number, opts: {
+    maxDpr: number;
+    maxPixels: number;
+    renderScale: number;
+}): {
+    width: number;
+    height: number;
+    effectiveDpr: number;
+};
+/**
+ * Keeps the canvas's backing store at the right size (DESIGN.md §11). It follows layout and
+ * DPR changes through a ResizeObserver, using exact device pixels where the browser
+ * provides them, so the canvas is never blurred by a rounding error. It caps DPR and total
+ * pixels, and exposes `renderScale` as the dynamic-resolution knob.
+ *
+ * `update()` is cheap when nothing changed; it returns true when the size did.
+ */
+export declare class Viewport {
+    #private;
+    readonly canvas: HTMLCanvasElement | OffscreenCanvas;
+    /** The render size: the scene's targets. */
+    width: number;
+    height: number;
+    /** The output size: the canvas. The same as the render size unless `upscale`. */
+    outputWidth: number;
+    outputHeight: number;
+    /**
+     * Temporal upscaling (ADR-0135): the canvas stays at full size and `renderScale` scales only the
+     * render size, which TAA reconstructs up to the output. Off, `renderScale` scales the canvas itself.
+     */
+    get upscale(): boolean;
+    set upscale(on: boolean);
+    effectiveDpr: number;
+    constructor(canvas: HTMLCanvasElement | OffscreenCanvas, options?: ViewportOptions);
+    /** The dynamic-resolution scale (0.25–1). */
+    get renderScale(): number;
+    set renderScale(s: number);
+    /**
+     * Sets the size from outside (worker render mode: the page's ResizeObserver measures,
+     * `hostRenderWorker` forwards, `link.bind(app)` calls this). Applied on the next `update`.
+     */
+    setSize(size: ViewportSize): void;
+    /** Applies any pending size change to the canvas. Returns true if the size changed. */
+    update(): boolean;
+    /** Stops observing (counted by the leak check until called). */
+    dispose(): void;
+    /** Live observers (0 after dispose). */
+    get listeners(): number;
+}

package/dist/viewport.js

@@ -0,0 +1,130 @@
+/** The render target size for a CSS size, DPR and policy. Pure, so it is unit-tested. */
+export function computeRenderSize(css, devicePixels, dpr, opts) {
+    // Exact device pixels when the browser reports them (devicePixelContentBoxSize), else
+    // CSS × DPR. The DPR cap and the render scale apply on top.
+    const base = devicePixels ?? { width: css.width * dpr, height: css.height * dpr };
+    const capDpr = Math.min(1, opts.maxDpr / Math.max(dpr, 1e-6));
+    let scale = Math.min(capDpr, 1) * opts.renderScale;
+    const pixels = base.width * base.height * scale * scale;
+    if (pixels > opts.maxPixels)
+        scale *= Math.sqrt(opts.maxPixels / pixels);
+    const width = Math.max(1, Math.round(base.width * scale));
+    const height = Math.max(1, Math.round(base.height * scale));
+    return { width, height, effectiveDpr: css.width > 0 ? width / css.width : dpr };
+}
+/**
+ * Keeps the canvas's backing store at the right size (DESIGN.md §11). It follows layout and
+ * DPR changes through a ResizeObserver, using exact device pixels where the browser
+ * provides them, so the canvas is never blurred by a rounding error. It caps DPR and total
+ * pixels, and exposes `renderScale` as the dynamic-resolution knob.
+ *
+ * `update()` is cheap when nothing changed; it returns true when the size did.
+ */
+export class Viewport {
+    canvas;
+    /** The render size: the scene's targets. */
+    width = 1;
+    height = 1;
+    /** The output size: the canvas. The same as the render size unless `upscale`. */
+    outputWidth = 1;
+    outputHeight = 1;
+    /**
+     * Temporal upscaling (ADR-0135): the canvas stays at full size and `renderScale` scales only the
+     * render size, which TAA reconstructs up to the output. Off, `renderScale` scales the canvas itself.
+     */
+    get upscale() {
+        return this.#upscale;
+    }
+    set upscale(on) {
+        if (on !== this.#upscale) {
+            this.#upscale = on;
+            this.#dirty = true;
+        }
+    }
+    #upscale = false;
+    effectiveDpr = 1;
+    #opts;
+    #css = { width: 0, height: 0 };
+    #device = null;
+    #dirty = true;
+    #observer = null;
+    /** DPR pushed by `setSize` (a worker has no `devicePixelRatio` of its own). */
+    #dpr = null;
+    constructor(canvas, options = {}) {
+        this.canvas = canvas;
+        this.#opts = { maxDpr: options.maxDpr ?? 2, maxPixels: options.maxPixels ?? 3840 * 2160, renderScale: options.renderScale ?? 1 };
+        // An OffscreenCanvas (worker render mode) has no layout to observe: the page pushes
+        // its size with setSize. Until then it renders at the canvas's own size.
+        if (typeof OffscreenCanvas !== 'undefined' && canvas instanceof OffscreenCanvas) {
+            this.#css = { width: canvas.width, height: canvas.height };
+        }
+        else if (typeof ResizeObserver !== 'undefined') {
+            const element = canvas;
+            this.#observer = new ResizeObserver((entries) => {
+                const e = entries[entries.length - 1];
+                const box = e.contentBoxSize?.[0];
+                this.#css = box ? { width: box.inlineSize, height: box.blockSize } : { width: e.contentRect.width, height: e.contentRect.height };
+                const dev = e.devicePixelContentBoxSize?.[0];
+                this.#device = dev ? { width: dev.inlineSize, height: dev.blockSize } : null;
+                this.#dirty = true;
+            });
+            try {
+                this.#observer.observe(element, { box: 'device-pixel-content-box' });
+            }
+            catch {
+                this.#observer.observe(element); // Safari before device-pixel-content-box
+            }
+        }
+    }
+    /** The dynamic-resolution scale (0.25–1). */
+    get renderScale() {
+        return this.#opts.renderScale;
+    }
+    set renderScale(s) {
+        const v = Math.min(1, Math.max(0.25, s));
+        if (v !== this.#opts.renderScale) {
+            this.#opts.renderScale = v;
+            this.#dirty = true;
+        }
+    }
+    /**
+     * Sets the size from outside (worker render mode: the page's ResizeObserver measures,
+     * `hostRenderWorker` forwards, `link.bind(app)` calls this). Applied on the next `update`.
+     */
+    setSize(size) {
+        this.#css = { width: size.css.width, height: size.css.height };
+        this.#device = size.device ? { width: size.device.width, height: size.device.height } : null;
+        this.#dpr = size.dpr;
+        this.#dirty = true;
+    }
+    /** Applies any pending size change to the canvas. Returns true if the size changed. */
+    update() {
+        if (!this.#dirty)
+            return false;
+        this.#dirty = false;
+        if ((!this.#observer || this.#css.width === 0) && 'clientWidth' in this.canvas && this.#dpr === null) {
+            this.#css = { width: this.canvas.clientWidth, height: this.canvas.clientHeight };
+        }
+        const dpr = this.#dpr ?? (typeof devicePixelRatio === 'number' ? devicePixelRatio : 1);
+        const out = computeRenderSize(this.#css, this.#device, dpr, this.#upscale ? { ...this.#opts, renderScale: 1 } : this.#opts);
+        const s = this.#upscale ? { width: Math.max(1, Math.round(out.width * this.#opts.renderScale)), height: Math.max(1, Math.round(out.height * this.#opts.renderScale)) } : out;
+        this.effectiveDpr = out.effectiveDpr;
+        if (s.width === this.width && s.height === this.height && out.width === this.outputWidth && out.height === this.outputHeight)
+            return false;
+        this.width = s.width;
+        this.height = s.height;
+        this.outputWidth = this.canvas.width = out.width;
+        this.outputHeight = this.canvas.height = out.height;
+        return true;
+    }
+    /** Stops observing (counted by the leak check until called). */
+    dispose() {
+        this.#observer?.disconnect();
+        this.#observer = null;
+    }
+    /** Live observers (0 after dispose). */
+    get listeners() {
+        return this.#observer ? 1 : 0;
+    }
+}
+//# sourceMappingURL=viewport.js.map

package/dist/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"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"}

package/dist/webgl2/plugin.d.ts

@@ -0,0 +1,40 @@
+import { type AppBuilder, type Component, type World } from '@yali-engine/core';
+import type { OrbitCamera } from '../camera.ts';
+import type { DebugLines } from '../debug-lines.ts';
+import { type DeviceFilterRule, type Tier } from '../device-profile.ts';
+import type { InstanceExtractor } from '../extract.ts';
+import type { MaterialStore, MeshStore } from '../meshes.ts';
+import type { RenderContext, RenderPluginOptions } from '../render-plugin.ts';
+import type { Viewport } from '../viewport.ts';
+/** What the render plugin hands the WebGL2 backend: everything that outlives a context. */
+export interface WebGL2Start {
+    readonly b: AppBuilder;
+    readonly options: RenderPluginOptions;
+    readonly viewport: Viewport;
+    readonly camera: OrbitCamera;
+    readonly debug: DebugLines;
+    readonly store: MeshStore;
+    readonly materials: MaterialStore;
+    readonly world: World | null;
+    readonly Mesh: Component | null;
+    readonly Light: Component | null;
+    readonly extractor: InstanceExtractor | null;
+    readonly rules: readonly DeviceFilterRule[];
+    readonly tierSizes: {
+        readonly texture: Readonly<Record<Tier, number>>;
+        readonly shadows: Readonly<Record<Tier, {
+            cascades: number;
+            size: number;
+            distance: number;
+            filter: 'soft' | 'hard';
+        }>>;
+    };
+}
+/**
+ * The WebGL2 backend (ADR-0070): where the browser has no WebGPU, the render plugin imports
+ * this module (so a WebGPU page carries none of it) and draws the same frame with
+ * `GlRenderer`. Always tier T0 (or lower by the device filter), the CPU cull, the standard
+ * material for every material (node materials need WGSL); everything else as on WebGPU.
+ * A lost context is recovered when the browser restores it.
+ */
+export declare function startWebGL2(a: WebGL2Start): Promise<RenderContext>;

package/dist/webgl2/plugin.js

@@ -0,0 +1,190 @@
+import { YaliError } from '@yali-engine/core';
+import { collectDeviceProfile, selectTier } from "../device-profile.js";
+import { GpuHealth } from "../gpu-health.js";
+import { pickFamily, TextureStore } from "../textures.js";
+import { gradingDefaults } from "../post-options.js";
+import { GlRenderer } from "./renderer.js";
+import { glFamilies, glTextureBackend } from "./textures.js";
+const NO_BYTES = new Uint8Array(0);
+const NO_WORDS = new Uint32Array(0);
+/**
+ * The WebGL2 backend (ADR-0070): where the browser has no WebGPU, the render plugin imports
+ * this module (so a WebGPU page carries none of it) and draws the same frame with
+ * `GlRenderer`. Always tier T0 (or lower by the device filter), the CPU cull, the standard
+ * material for every material (node materials need WGSL); everything else as on WebGPU.
+ * A lost context is recovered when the browser restores it.
+ */
+export async function startWebGL2(a) {
+    const { b, options, viewport, camera, store, materials, world, Light, extractor } = a;
+    const lc = b.app.lifecycle;
+    const canvas = options.canvas;
+    const gl = canvas.getContext('webgl2', { antialias: false, depth: false, stencil: false, alpha: false, preserveDrawingBuffer: false, powerPreference: 'high-performance' });
+    if (!gl)
+        throw new YaliError('NO_GPU', 'This browser has neither WebGPU nor WebGL2.', 'Use a current Chrome, Edge, Safari or Firefox.');
+    const profile = await collectDeviceProfile(null);
+    const tier = selectTier('webgl2', profile, a.rules, options.tier);
+    const disable = new Set(tier.disable);
+    const features = glFamilies(gl);
+    const family = options.textureFamily ?? (disable.has('compressed-textures') ? 'rgba8' : pickFamily(features));
+    const textures = new TextureStore({ family, size: options.textureSize ?? a.tierSizes.texture[tier.tier] });
+    textures.attachBackend(glTextureBackend(gl));
+    const defaults = a.tierSizes.shadows[tier.tier];
+    const so = options.shadows === false || (options.shadows === undefined && disable.has('shadows')) ? null : (options.shadows ?? {});
+    const shadowConfig = so ? { cascades: so.cascades ?? defaults.cascades, size: so.size ?? defaults.size, distance: so.distance ?? defaults.distance, splitLambda: so.splitLambda ?? 0.75, pcfRadius: (so.filter ?? defaults.filter) === 'hard' ? 0 : 1 } : null;
+    const t0 = performance.now();
+    const make = () => {
+        // T0 tone-maps inline unless the app asks for the HDR target (ADR-0071).
+        const r = new GlRenderer(gl, store, materials, textures, options.capacity ?? 65_536, shadowConfig, options.hdr ?? (tier.tier !== 't0' || !!options.post?.grading), (options.dynamicShading ?? tier.tier === 't0') ? 3 : 1);
+        Object.assign(r.lighting, options.lighting ?? {});
+        r.curve = options.toneMapping ?? 'neutral';
+        r.exposure = options.exposure ?? 1;
+        r.grading = gradingDefaults(options.post?.grading);
+        if (options.sky)
+            r.setSky(options.sky);
+        r.debug = a.debug;
+        return r;
+    };
+    let r = make();
+    const shaderMs = performance.now() - t0;
+    lc.emit({ type: 'init:adapter', backend: 'webgl2', adapterInfo: { vendor: profile.gpu.vendor ?? '', description: profile.gpu.webglRenderer ?? '' } });
+    lc.emit({ type: 'init:capabilities', features: [...features, ...(r.hdr ? ['color-buffer-float'] : [])], limits: { maxTextureSize: gl.getParameter(gl.MAX_TEXTURE_SIZE), maxArrayTextureLayers: gl.getParameter(gl.MAX_ARRAY_TEXTURE_LAYERS) } });
+    lc.emit({ type: 'init:device-filter', matched: tier.matched });
+    lc.emit({ type: 'init:tier', tier: tier.tier, source: tier.source });
+    lc.emit({ type: 'init:shaders', pipelines: 5, ms: shaderMs });
+    if (!r.hdr)
+        console.warn('[yali render] WebGL2 without EXT_color_buffer_float: the scene renders to RGBA8, so highlights clip before the tone curve.');
+    const shadows = () => {
+        const cfg = r.shadows;
+        return {
+            enabled: !!cfg,
+            cascades: cfg?.cascades ?? 0,
+            size: cfg?.size ?? 1,
+            get distance() {
+                return cfg?.distance ?? 0;
+            },
+            set distance(v) {
+                if (cfg)
+                    cfg.distance = v;
+            },
+        };
+    };
+    let lost = false;
+    const ctx = {
+        backend: 'webgl2',
+        gpu: null,
+        scene: r,
+        tonemap: r,
+        // WebGL2 has no post chain (ADR-0092): grading only, in its tone-mapping pass.
+        post: {
+            bloom: false,
+            fxaa: false,
+            taa: false,
+            bloomIntensity: 0,
+            bloomThreshold: 0,
+            bloomKnee: 0,
+            bloomRadius: 0,
+            taaSharpen: 0,
+            motionBlur: 0,
+            taaBlend: 0,
+            get grading() {
+                return r.grading;
+            },
+            resetHistory() { },
+            readMotion: () => Promise.resolve(null),
+        },
+        environment: r,
+        lights: r.lights,
+        shadows: shadows(),
+        Light,
+        meshes: store,
+        materials,
+        textures,
+        Mesh: a.Mesh,
+        graph: null,
+        timer: null,
+        pipelines: null,
+        viewport,
+        camera,
+        debug: a.debug,
+        prepasses: [],
+        health: new GpuHealth(),
+        profile,
+        tier: tier.tier,
+        recoveries: 0,
+        submitMs: 0,
+        uploadMs: 0,
+        // WebGL2 blocks in the driver when it is behind: no cap needed (ADR-0129).
+        maxFramesInFlight: 0,
+        framesInFlight: 0,
+        skippedFrames: 0,
+        capture: () => r.capture(),
+        simulateDeviceLoss() {
+            // A real loss is restored by the browser; a simulated one must be restored by hand.
+            const ext = gl.getExtension('WEBGL_lose_context');
+            ext?.loseContext();
+            setTimeout(() => ext?.restoreContext(), 50);
+        },
+    };
+    const profiler = b.app.profiler;
+    const upload = profiler.scope('render.upload', 'Submit');
+    const encode = profiler.scope('render.encode', 'Submit');
+    b.system({
+        name: 'render.submit',
+        stage: 'Submit',
+        run: () => {
+            if (lost)
+                return; // recovering: draw nothing
+            const t = performance.now();
+            profiler.begin(upload);
+            textures.pump(1);
+            const core = extractor?.world.core;
+            r.upload(core?.heap.u8 ?? NO_BYTES, core?.heap.u32 ?? NO_WORDS, extractor, camera, viewport.width, viewport.height, world, Light);
+            profiler.end(upload);
+            ctx.uploadMs = performance.now() - t;
+            profiler.begin(encode);
+            r.render(viewport.width, viewport.height);
+            profiler.end(encode);
+            ctx.submitMs = performance.now() - t;
+            a.debug.clear();
+        },
+    });
+    // Context loss: report it, and rebuild when the browser restores the context.
+    let restored = () => { };
+    const onLost = (e) => {
+        e.preventDefault(); // allows the restore
+        lost = true;
+        void b.app.deviceLost({ reason: 'unknown', message: 'The WebGL2 context was lost.' });
+    };
+    const onRestored = () => restored();
+    canvas.addEventListener('webglcontextlost', onLost);
+    canvas.addEventListener('webglcontextrestored', onRestored);
+    b.recover(async () => {
+        if (gl.isContextLost())
+            await new Promise((resolve) => (restored = resolve));
+        const prev = r;
+        textures.attachBackend(glTextureBackend(gl));
+        r = make();
+        Object.assign(r.lighting, prev.lighting);
+        r.shadingLevel = prev.shadingLevel;
+        r.exposure = prev.exposure;
+        r.curve = prev.curve;
+        r.grading = prev.grading;
+        r.setSky(prev.sky);
+        if (r.shadows && prev.shadows)
+            r.shadows.distance = prev.shadows.distance;
+        Object.assign(ctx, { scene: r, tonemap: r, environment: r, lights: r.lights, shadows: shadows() });
+        lost = false;
+        ctx.recoveries++;
+        return { devices: 1, pipelines: 5, buffers: r.liveBuffers, timers: 0 };
+    });
+    b.leaks(() => ({ gpuResources: lost ? 0 : r.liveBuffers, listeners: viewport.listeners }));
+    b.onDispose(() => {
+        canvas.removeEventListener('webglcontextlost', onLost);
+        canvas.removeEventListener('webglcontextrestored', onRestored);
+        viewport.dispose();
+        textures.detach();
+        r.destroy();
+    });
+    return ctx;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/webgl2/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/webgl2/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAI3F,OAAO,EAAE,oBAAoB,EAAyB,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAE1G,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAuB,UAAU,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAsB7D,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,CAAc;IAC9C,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACtF,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;IAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAkC,CAAC;IAC7M,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,QAAQ,EAAE,6CAA6C,EAAE,gDAAgD,CAAC,CAAC;IACxI,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9G,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3G,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACnI,MAAM,YAAY,GAA0B,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEtR,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,GAAe,EAAE;QAC5B,yEAAyE;QACzE,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3N,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC;QAC3C,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,OAAO,CAAC,GAAG;YAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC;IACF,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IACf,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IACxC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACtJ,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,CAAW,EAAE,qBAAqB,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,wBAAwB,CAAW,EAAE,EAAE,CAAC,CAAC;IACrQ,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,CAAC,IAAI,CAAC,4HAA4H,CAAC,CAAC;IAEvJ,MAAM,OAAO,GAAG,GAAmB,EAAE;QACnC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,GAAG;YACd,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,CAAC;YAC5B,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC;YACpB,IAAI,QAAQ;gBACV,OAAO,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,QAAQ,CAAC,CAAS;gBACpB,IAAI,GAAG;oBAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;IACJ,CAAC,CAAC;IACF,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,GAAG,GAAkB;QACzB,OAAO,EAAE,QAAQ;QACjB,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,CAAC;QACV,+EAA+E;QAC/E,IAAI,EAAE;YACJ,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,KAAK;YACV,cAAc,EAAE,CAAC;YACjB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,CAAC;YACb,QAAQ,EAAE,CAAC;YACX,IAAI,OAAO;gBACT,OAAO,CAAC,CAAC,OAAQ,CAAC;YACpB,CAAC;YACD,YAAY,KAAI,CAAC;YACjB,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;SACxC;QACD,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,OAAO,EAAE;QAClB,KAAK;QACL,MAAM,EAAE,KAAK;QACb,SAAS;QACT,QAAQ;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,IAAI;QACf,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,SAAS,EAAE;QACvB,OAAO;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,2EAA2E;QAC3E,iBAAiB,EAAE,CAAC;QACpB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;QAC1B,kBAAkB;YAChB,oFAAoF;YACpF,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;YAClD,GAAG,EAAE,WAAW,EAAE,CAAC;YACnB,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,IAAI;gBAAE,OAAO,CAAC,2BAA2B;YAC7C,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC5B,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,MAAM,IAAI,GAAG,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC;YACnC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAClI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrB,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrB,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;IAEH,8EAA8E;IAC9E,IAAI,QAAQ,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,CAAC,CAAQ,EAAE,EAAE;QAC1B,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,qBAAqB;QACzC,IAAI,GAAG,IAAI,CAAC;QACZ,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACpC,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,MAAuB,CAAC,CAAC;IACrE,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QACnB,IAAI,EAAE,CAAC,aAAa,EAAE;YAAE,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;QACnF,MAAM,IAAI,GAAG,CAAC,CAAC;QACf,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC,GAAG,IAAI,EAAE,CAAC;QACX,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACnC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;YAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnG,IAAI,GAAG,KAAK,CAAC;QACb,GAAG,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;QACf,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,MAAuB,CAAC,CAAC;QACxE,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;QAC/D,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC,CAAC,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/webgl2/program.d.ts

@@ -0,0 +1,27 @@
+import type { GlslProgram } from './shaders.glsl.gen.ts';
+/** A texture bound at a WGSL binding: what GL target it is. */
+export interface GlTextureBinding {
+    readonly target: number;
+    readonly texture: WebGLTexture;
+}
+/** What a draw binds, by WGSL binding number (group 0): uniform buffers, textures, samplers. */
+export interface GlBindings {
+    readonly uniforms: ReadonlyMap<number, WebGLBuffer>;
+    readonly textures: ReadonlyMap<number, GlTextureBinding>;
+    readonly samplers: ReadonlyMap<number, WebGLSampler>;
+}
+/**
+ * A linked GLSL ES 3.00 program from `tools/glsl-gen.mjs` (ADR-0070). GLSL ES 3.00 has no
+ * binding qualifiers, so naga reports each uniform block's and combined sampler's name and
+ * the WGSL binding it came from: each uniform block is bound to the binding point equal to
+ * its WGSL binding (the vertex and fragment stages' blocks for one binding share it), and
+ * each combined sampler gets a texture unit, where `bind` puts the binding's texture and the
+ * sampler binding's sampler object.
+ */
+export declare class GlProgram {
+    #private;
+    readonly program: WebGLProgram;
+    constructor(gl: WebGL2RenderingContext, label: string, src: GlslProgram);
+    /** Makes the program current and binds `b`'s resources to its blocks and units. */
+    bind(gl: WebGL2RenderingContext, b: GlBindings): void;
+}