@oh-just-another/renderer-canvas 0.57.0

package/dist/webgl2-stroke.js

@@ -0,0 +1,318 @@
+/**
+ * Maximum miter overshoot, in units of stroke width. Past this the
+ * miter falls back to a bevel — matches Canvas2D's `miterLimit` default
+ * of 10 and SVG's spec default.
+ */
+const MITER_LIMIT = 10;
+/** Round-join / round-cap fan segments per pi radians. 12 keeps each
+ *  segment ≈ 15°, smooth at any sensible zoom. */
+const ROUND_SEGMENTS_PER_PI = 12;
+/** Asserts a polyline index is in range (loop bounds guarantee it). */
+const req = (v) => {
+    if (v === undefined)
+        throw new Error("packages/renderer-canvas: polyline index out of range");
+    return v;
+};
+/**
+ * Module-level scratch buffers — reused across every
+ * `drawPolylineStroke` invocation so the hot path allocates zero
+ * `Float32Array`s per frame after warmup.
+ *
+ * Safe because WebGL is single-threaded and `drawPolylineStroke` is
+ * called serially from `WebGL2Target.stroke()`; multiple canvases on
+ * the same page share these buffers, which is fine.
+ *
+ * Initial caps cover a typical small stroke (≤32 segments) without a
+ * grow. `ensureNCapacity` / `ensureTrisCapacity` upsize to the next
+ * power of 2 on demand; capacity only ratchets up.
+ */
+let scratchNx = new Float32Array(64);
+let scratchNy = new Float32Array(64);
+let scratchTris = new Float32Array(1024);
+let scratchTrisLen = 0;
+const ensureNCapacity = (n) => {
+    if (scratchNx.length >= n)
+        return;
+    let cap = scratchNx.length;
+    while (cap < n)
+        cap *= 2;
+    scratchNx = new Float32Array(cap);
+    scratchNy = new Float32Array(cap);
+};
+const ensureTrisCapacity = (n) => {
+    if (scratchTris.length >= n)
+        return;
+    let cap = scratchTris.length;
+    while (cap < n)
+        cap *= 2;
+    const next = new Float32Array(cap);
+    // Carry over any values already pushed before the grow.
+    next.set(scratchTris.subarray(0, scratchTrisLen));
+    scratchTris = next;
+};
+const trisPush = (x, y) => {
+    if (scratchTrisLen + 2 > scratchTris.length) {
+        ensureTrisCapacity(scratchTrisLen + 2);
+    }
+    scratchTris[scratchTrisLen++] = x;
+    scratchTris[scratchTrisLen++] = y;
+};
+/**
+ * Compute one miter offset at the hinge between two unit normals.
+ * Returns `{ ox, oy }` along the bisector, clamped to MITER_LIMIT.
+ * Exported so `webgl2-target.ts` can reuse it for closed-polyline seam
+ * vertices.
+ */
+export const miterOffset = (n1x, n1y, n2x, n2y, half) => {
+    let bx = n1x + n2x;
+    let by = n1y + n2y;
+    const blen = Math.hypot(bx, by);
+    if (blen < 1e-6) {
+        return { ox: n1x * half, oy: n1y * half };
+    }
+    bx /= blen;
+    by /= blen;
+    const cos = bx * n1x + by * n1y;
+    const miterLen = cos > 1e-6 ? half / cos : half;
+    const clamped = Math.min(miterLen, half * MITER_LIMIT);
+    return { ox: bx * clamped, oy: by * clamped };
+};
+/**
+ * Build the stroke geometry for a polyline + style, upload to the
+ * caller's dynamic VBO, and draw. Identity uTransform — vertices are
+ * pre-projected into clip space here.
+ *
+ * The caller passes its solid program + cached `aPos` attribute
+ * location + its dynamic VBO. This function binds & sets up the
+ * attribute itself so it's self-contained — no implicit dependency on
+ * the previous draw's GL state.
+ */
+export const drawPolylineStroke = (gl, polyline, style, transform, size, program, uTransformLoc, uColorLoc, uOpacityLoc, dynamicVbo, aPosLoc, identityMat3) => {
+    if (style.width <= 0 || polyline.length < 2)
+        return;
+    const half = style.width / 2;
+    const segCount = polyline.length - 1;
+    // Reuse the module-level scratch nx/ny buffers — grow on demand.
+    ensureNCapacity(segCount);
+    const nx = scratchNx;
+    const ny = scratchNy;
+    for (let i = 0; i < segCount; i++) {
+        const a = req(polyline[i]);
+        const b = req(polyline[i + 1]);
+        const dx = b.x - a.x;
+        const dy = b.y - a.y;
+        const len = Math.hypot(dx, dy) || 1;
+        nx[i] = -dy / len;
+        ny[i] = dx / len;
+    }
+    const first = req(polyline[0]);
+    const last = req(polyline[polyline.length - 1]);
+    const closed = polyline.length >= 3 && first.x === last.x && first.y === last.y;
+    // Reset the scratch vertex stream length — world-space (x, y) pairs
+    // are pushed into `scratchTris` via `trisPush`, then projected
+    // in-place to clip space before the bufferData call.
+    scratchTrisLen = 0;
+    const push = trisPush;
+    // Render the segment band between vertex i and i+1 as two triangles.
+    // Both endpoints use the same side-offset; join geometry stitches the
+    // next segment on.
+    const band = (ax, ay, anx, any, bx, by, bnx, bny) => {
+        // Vertices:
+        //   A_left  = (ax + anx, ay + any)
+        //   A_right = (ax - anx, ay - any)
+        //   B_left  = (bx + bnx, by + bny)
+        //   B_right = (bx - bnx, by - bny)
+        push(ax + anx, ay + any);
+        push(ax - anx, ay - any);
+        push(bx + bnx, by + bny);
+        push(bx + bnx, by + bny);
+        push(ax - anx, ay - any);
+        push(bx - bnx, by - bny);
+    };
+    // Per-segment side offsets (the polyline endpoint offset, no
+    // bisector — joins add their own geometry between adjacent bands).
+    const segLeft = (i) => ({ ox: req(nx[i]) * half, oy: req(ny[i]) * half });
+    // Emit the rect bands for every segment.
+    for (let i = 0; i < segCount; i++) {
+        const a = req(polyline[i]);
+        const b = req(polyline[i + 1]);
+        const o = segLeft(i);
+        band(a.x, a.y, o.ox, o.oy, b.x, b.y, o.ox, o.oy);
+    }
+    // Emit join geometry at every interior vertex (and at the seam for
+    // closed polylines).
+    const emitJoin = (vertexX, vertexY, n1x, n1y, n2x, n2y) => {
+        if (style.join === "miter") {
+            const { ox, oy } = miterOffset(n1x, n1y, n2x, n2y, half);
+            // Outside-of-bend wedge: tip = vertex + offset on outer side.
+            // Outer side comes from the cross-product sign.
+            const cross = n1x * n2y - n1y * n2x;
+            if (Math.abs(cross) < 1e-9)
+                return; // colinear — no join needed
+            // Outer normal direction = cross < 0 → +offset; cross > 0 → -offset.
+            const sign = cross < 0 ? 1 : -1;
+            const outerTipX = vertexX + sign * ox;
+            const outerTipY = vertexY + sign * oy;
+            const innerNormal1X = sign * n1x * half;
+            const innerNormal1Y = sign * n1y * half;
+            const innerNormal2X = sign * n2x * half;
+            const innerNormal2Y = sign * n2y * half;
+            // Triangle: vertex, end of seg-1 outer-side, miter tip.
+            push(vertexX, vertexY);
+            push(vertexX + innerNormal1X, vertexY + innerNormal1Y);
+            push(outerTipX, outerTipY);
+            // Triangle: vertex, miter tip, start of seg-2 outer-side.
+            push(vertexX, vertexY);
+            push(outerTipX, outerTipY);
+            push(vertexX + innerNormal2X, vertexY + innerNormal2Y);
+        }
+        else if (style.join === "bevel") {
+            const cross = n1x * n2y - n1y * n2x;
+            if (Math.abs(cross) < 1e-9)
+                return;
+            const sign = cross < 0 ? 1 : -1;
+            const a1x = vertexX + sign * n1x * half;
+            const a1y = vertexY + sign * n1y * half;
+            const a2x = vertexX + sign * n2x * half;
+            const a2y = vertexY + sign * n2y * half;
+            // Single triangle fills the bevel gap.
+            push(vertexX, vertexY);
+            push(a1x, a1y);
+            push(a2x, a2y);
+        }
+        else {
+            // round join: fan triangles between the two outer-side offsets.
+            const cross = n1x * n2y - n1y * n2x;
+            if (Math.abs(cross) < 1e-9)
+                return;
+            const sign = cross < 0 ? 1 : -1;
+            const startAngle = Math.atan2(sign * n1y, sign * n1x);
+            const endAngle = Math.atan2(sign * n2y, sign * n2x);
+            // Pick the shortest angular sweep.
+            let delta = endAngle - startAngle;
+            while (delta > Math.PI)
+                delta -= 2 * Math.PI;
+            while (delta < -Math.PI)
+                delta += 2 * Math.PI;
+            const segs = Math.max(2, Math.ceil((Math.abs(delta) / Math.PI) * ROUND_SEGMENTS_PER_PI));
+            let prevX = vertexX + Math.cos(startAngle) * half;
+            let prevY = vertexY + Math.sin(startAngle) * half;
+            for (let s = 1; s <= segs; s++) {
+                const t = s / segs;
+                const angle = startAngle + delta * t;
+                const x = vertexX + Math.cos(angle) * half;
+                const y = vertexY + Math.sin(angle) * half;
+                push(vertexX, vertexY);
+                push(prevX, prevY);
+                push(x, y);
+                prevX = x;
+                prevY = y;
+            }
+        }
+    };
+    for (let i = 1; i < segCount; i++) {
+        const p = req(polyline[i]);
+        emitJoin(p.x, p.y, req(nx[i - 1]), req(ny[i - 1]), req(nx[i]), req(ny[i]));
+    }
+    if (closed) {
+        const p = req(polyline[0]);
+        emitJoin(p.x, p.y, req(nx[segCount - 1]), req(ny[segCount - 1]), req(nx[0]), req(ny[0]));
+    }
+    // Caps on open polylines (closed shapes don't have caps).
+    if (!closed) {
+        const capFirst = req(polyline[0]);
+        const second = req(polyline[1]);
+        emitCap(push, capFirst.x, capFirst.y, second.x, second.y, req(nx[0]), req(ny[0]), half, style.cap, true);
+        const lastVx = req(polyline[polyline.length - 1]);
+        const prevVx = req(polyline[polyline.length - 2]);
+        emitCap(push, lastVx.x, lastVx.y, prevVx.x, prevVx.y, req(nx[segCount - 1]), req(ny[segCount - 1]), half, style.cap, false);
+    }
+    if (scratchTrisLen === 0)
+        return;
+    // Project all triangle vertices into clip space in-place: read world
+    // (x, y) first, then overwrite the same indices with clip-space
+    // values.
+    const sx = 2 / size.width;
+    const sy = -2 / size.height;
+    for (let i = 0; i < scratchTrisLen; i += 2) {
+        const x = req(scratchTris[i]);
+        const y = req(scratchTris[i + 1]);
+        const wx = transform.a * x + transform.c * y + transform.e;
+        const wy = transform.b * x + transform.d * y + transform.f;
+        scratchTris[i] = wx * sx - 1;
+        scratchTris[i + 1] = wy * sy + 1;
+    }
+    gl.useProgram(program);
+    gl.bindBuffer(gl.ARRAY_BUFFER, dynamicVbo);
+    // subarray gives a view into the live scratch buffer — no copy.
+    gl.bufferData(gl.ARRAY_BUFFER, scratchTris.subarray(0, scratchTrisLen), gl.DYNAMIC_DRAW);
+    gl.enableVertexAttribArray(aPosLoc);
+    gl.vertexAttribPointer(aPosLoc, 2, gl.FLOAT, false, 0, 0);
+    gl.uniformMatrix3fv(uTransformLoc, false, identityMat3);
+    gl.uniform3f(uColorLoc, style.color[0], style.color[1], style.color[2]);
+    gl.uniform1f(uOpacityLoc, style.opacity);
+    gl.drawArrays(gl.TRIANGLES, 0, scratchTrisLen / 2);
+};
+/**
+ * Emit a cap at one endpoint of an open polyline. `start` indicates
+ * whether this is the leading (first) cap — the outward tangent
+ * direction reverses for the trailing cap.
+ *   `butt`   → nothing (the rect band already squared off the end).
+ *   `square` → extend the rect band by `half` along the tangent.
+ *   `round`  → half-circle fan.
+ */
+const emitCap = (push, vx, vy, otherX, otherY, nrmX, nrmY, half, cap, start) => {
+    if (cap === "butt")
+        return;
+    // Outward tangent direction: from vertex away from the polyline's
+    // interior. For `start`, it's vertex → -other (extending backward);
+    // for the trailing cap, it's vertex → +other (extending forward).
+    // Both point away from the next-vertex along the segment direction.
+    const dx = otherX - vx;
+    const dy = otherY - vy;
+    const len = Math.hypot(dx, dy) || 1;
+    const tx = -dx / len; // outward tangent
+    const ty = -dy / len;
+    // `start` cap points outward by reversing; the trailing cap already
+    // points outward (other is the previous vertex).
+    const sign = start ? 1 : -1;
+    const outX = sign * tx;
+    const outY = sign * ty;
+    if (cap === "square") {
+        // Extend the band by `half` along the outward tangent.
+        const A = { x: vx + nrmX * half, y: vy + nrmY * half };
+        const B = { x: vx - nrmX * half, y: vy - nrmY * half };
+        const Aext = { x: A.x + outX * half, y: A.y + outY * half };
+        const Bext = { x: B.x + outX * half, y: B.y + outY * half };
+        push(A.x, A.y);
+        push(Aext.x, Aext.y);
+        push(B.x, B.y);
+        push(B.x, B.y);
+        push(Aext.x, Aext.y);
+        push(Bext.x, Bext.y);
+        return;
+    }
+    // round cap: half-circle fan starting from +normal, sweeping through
+    // the outward tangent, ending at -normal.
+    const startAngle = Math.atan2(nrmY, nrmX);
+    const segs = ROUND_SEGMENTS_PER_PI;
+    // Sweep π radians in the outward direction. The sweep direction
+    // (CW vs CCW) depends on which side `out` is relative to the normal —
+    // use the cross-product sign.
+    const cross = nrmX * outY - nrmY * outX;
+    const sweepSign = cross >= 0 ? 1 : -1;
+    let prevX = vx + Math.cos(startAngle) * half;
+    let prevY = vy + Math.sin(startAngle) * half;
+    for (let s = 1; s <= segs; s++) {
+        const t = s / segs;
+        const angle = startAngle + sweepSign * Math.PI * t;
+        const x = vx + Math.cos(angle) * half;
+        const y = vy + Math.sin(angle) * half;
+        push(vx, vy);
+        push(prevX, prevY);
+        push(x, y);
+        prevX = x;
+        prevY = y;
+    }
+};
+//# sourceMappingURL=webgl2-stroke.js.map

package/dist/webgl2-stroke.js.map

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

package/dist/webgl2-target.d.ts

@@ -0,0 +1,311 @@
+import type { Bounds, Color, Transform, Vec2 } from "@oh-just-another/types";
+import type { FillRule, LineCap, LineJoin, RenderTarget, TextAlign, TextBaseline } from "@oh-just-another/renderer-core";
+/**
+ * WebGL2 RenderTarget. Implements clear, transform/state stack, path
+ * primitives (rect / polyline / ellipse / Bezier), fill, stroke, text
+ * (MSDF or OffscreenCanvas-bitmap fallback), and image drawing.
+ */
+export declare class WebGL2Target implements RenderTarget {
+    private readonly gl;
+    private readonly program;
+    /**
+     * Static unit-quad VBO ([0,0]–[1,1]) — used by every solid-fill rect
+     * draw. Filled once in the constructor with `STATIC_DRAW` and never
+     * re-written; the rect's world-space placement is done entirely via
+     * `uTransform`.
+     */
+    private readonly vbo;
+    /**
+     * Per-frame scratch VBO for polygon / triangle-fan / stroke vertex
+     * streams. Re-uploaded each draw with `DYNAMIC_DRAW`. Kept separate
+     * from `vbo` so the static unit quad never gets stomped.
+     */
+    private readonly dynamicVbo;
+    private readonly uTransformLoc;
+    private readonly uColorLoc;
+    private readonly uOpacityLoc;
+    /**
+     * Cached attribute location for the solid program. `getAttribLocation`
+     * is a string-keyed driver lookup; repeating it per draw is a real
+     * per-frame cost on integrated GPUs. Locations are stable once the
+     * program is linked, so they're read once in the constructor.
+     */
+    private readonly aPosLoc;
+    private readonly _size;
+    private fillColor;
+    private fillAlpha;
+    private strokeColor;
+    private strokeAlpha;
+    private fillColorString;
+    private strokeWidth;
+    private lineCap;
+    private lineJoin;
+    /** Dash pattern in WORLD units (matches Canvas2D, which dashes in the
+     *  world-space ctx transform). `null` = solid. */
+    private dashArray;
+    private opacity;
+    private currentPath;
+    private fontFamily;
+    private fontSize;
+    private fontWeight;
+    private fontStyle;
+    private textAlign;
+    private textBaseline;
+    /**
+     * Polyline path being assembled by moveTo / lineTo. Cleared on
+     * `beginPath()`; pushed to GPU on `stroke()`.
+     */
+    private currentPolyline;
+    /**
+     * Curve segments collected since the last `beginPath()`. Quadratic
+     * and cubic Bezier `*CurveTo` calls push here in addition to pushing
+     * the curve endpoint into `currentPolyline` — the polyline forms the
+     * polygon hull for `fill()` triangulation, and the curve list adds
+     * Loop-Blinn fragment-tested triangles on top so curve regions stay
+     * perfectly smooth at any zoom.
+     */
+    private currentCurves;
+    /**
+     * Ellipse parameters set by `ellipse()` — drives the fragment-SDF
+     * `EllipsePipeline` on `fill()`. Separate from the polygon path so
+     * `fill()` can skip the earcut pipeline entirely for ellipses (1 quad
+     * vs 24-512 segments). `stroke()` falls back to building a polyline
+     * lazily.
+     */
+    private currentEllipse;
+    private transform;
+    /**
+     * save() / restore() snapshot stack. Mirrors Canvas2D's `ctx.save/
+     * restore` contract: the full paint + text state is saved, not just
+     * the transform — otherwise `opacity` / fill / stroke set inside a
+     * save()…restore() block would leak onto everything drawn afterwards.
+     * The current PATH is excluded — Canvas2D's save/restore doesn't
+     * snapshot the path either.
+     */
+    private readonly stack;
+    constructor(canvas: HTMLCanvasElement | OffscreenCanvas, width: number, height: number);
+    get size(): {
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * Update the recorded CSS-pixel size after the host resizes the
+     * underlying canvas. Callers handle `setupHiDpi` / `gl.viewport`
+     * updates on the actual canvas; this keeps the target's `size` getter
+     * in sync so downstream renderers see the new dimensions.
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Free the underlying WebGL context immediately. Browsers cap the
+     * number of live WebGL contexts per page (~16 in Chrome); without
+     * `WEBGL_lose_context`, GC can take a while to collect old surfaces
+     * and runtime backend switches quickly hit the cap.
+     */
+    dispose(): void;
+    setFill(color: Color | null): void;
+    setOpacity(alpha: number): void;
+    save(): void;
+    restore(): void;
+    setTransform(t: Transform): void;
+    resetTransform(): void;
+    translate(dx: number, dy: number): void;
+    rotate(radians: number): void;
+    scale(sx: number, sy: number): void;
+    beginPath(): void;
+    rect(x: number, y: number, width: number, height: number): void;
+    private readonly _pathRect;
+    moveTo(x: number, y: number): void;
+    lineTo(x: number, y: number): void;
+    closePath(): void;
+    /**
+     * Stash the analytic ellipse — `fill()` draws it via the fragment-SDF
+     * `EllipsePipeline` (1 quad, perfect curve at any zoom). The polyline
+     * and polygon path are not populated up front; `stroke()` builds the
+     * polyline lazily if it's needed, saving the 24-512 vertex allocation
+     * when callers only fill.
+     */
+    ellipse(cx: number, cy: number, rx: number, ry: number): void;
+    /**
+     * Build a polyline approximation of `currentEllipse` for the stroke
+     * pipeline. Zoom-adaptive segment count keeps chord-to-arc error
+     * sub-pixel at any scale.
+     */
+    private buildEllipseStrokePolyline;
+    /**
+     * Quadratic Bezier. Pushed twice:
+     *   1. As a single `CurveSegment` into `currentCurves` for the
+     *      Loop-Blinn fill pass — a perfect curve edge at any zoom (one
+     *      fragment-tested triangle, no faceting).
+     *   2. As the curve endpoint into `currentPolyline` — keeps the
+     *      polygon hull intact so `fill()`'s earcut triangulation and
+     *      `stroke()`'s polyline math both see the chord.
+     *
+     * Strokes flatten to chord segments via the registered rasterizer
+     * (sub-pixel zoom-aware).
+     */
+    quadraticCurveTo(cx: number, cy: number, x: number, y: number): void;
+    /** Cubic Bezier — same dual-track approach as quadratic. */
+    bezierCurveTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): void;
+    /**
+     * World-unit tolerance that maps to ~`SCREEN_TOLERANCE_PX` on screen
+     * at the current transform. Used by every curve-flatten call so the
+     * polyline density tracks the zoom.
+     */
+    private currentFlattenTolerance;
+    /**
+     * Image rendering — uploads `image` to a freshly-created GL texture
+     * on first call, caches it by reference for subsequent frames. Drawn
+     * as a textured quad via a dedicated program created lazily on the
+     * first image call.
+     */
+    drawImage(image: unknown, dx: number, dy: number, dw: number, dh: number, dynamic?: boolean): void;
+    /** Lazy image program + its static unit quad+UV VBO. */
+    private imageProgram;
+    private imageQuadVbo;
+    /**
+     * `TexImageSource` → uploaded `WebGLTexture` cache. A plain `Map`
+     * with LRU eviction + explicit `gl.deleteTexture` (see
+     * `evictImageTexturesIfOverCap`) so the GPU texture is released
+     * deterministically rather than waiting for GC.
+     *
+     * `Map` preserves insertion order, so the head is least-recently
+     * used. `textureFor` touches a hit by delete + set (moves to tail).
+     */
+    private readonly textures;
+    private textureFor;
+    /**
+     * Trim `textures` down to `WEBGL2_IMAGE_TEXTURE_CACHE_CAP` entries by
+     * dropping least-recently-used keys and explicitly releasing the GPU
+     * texture for each evicted entry.
+     *
+     * Skips entries also held by `textBitmaps` — those are evicted through
+     * `evictTextBitmapsIfOverCap` instead, which already deletes the
+     * texture. Skipping here keeps the two cache layers from
+     * double-`gl.deleteTexture`'ing the same handle.
+     */
+    private evictImageTexturesIfOverCap;
+    fill(_rule?: FillRule): void;
+    private curvePipeline;
+    private ellipsePipeline;
+    /**
+     * Triangulate the polygon via earcut and emit one TRIANGLES draw.
+     * Vertices are pre-projected into clip space so the program's
+     * `uTransform` stays identity. Falls back to a triangle-fan when
+     * earcut returns an empty index list (degenerate self-intersecting
+     * polygon).
+     */
+    private fillPolygonEarcut;
+    private indexBuffer;
+    /**
+     * Convex / fallback path — triangle fan from polyline[0]. Renders
+     * convex polygons correctly; concave ones get a wrong silhouette (the
+     * earcut path handles those instead).
+     */
+    private drawTriangleFan;
+    /**
+     * Clear the canvas. With no `bounds` does a full backbuffer wipe; with
+     * `bounds` wipes only the rectangle the editor's dirty-rect pass
+     * identified. Honouring `bounds` is mandatory — when the scene
+     * reference doesn't change, the editor sends a zero-area dirty rect
+     * and expects the previous frame to survive untouched.
+     * `preserveDrawingBuffer: true` carries the persistent frame across
+     * composites.
+     *
+     * For bounded clears the implementation flips on a scissor box so the
+     * clear is confined to the dirty rect, mirroring Canvas2D's
+     * partial-clear semantics. The scissor box is in DPR-bitmap pixels
+     * with bottom-left origin (GL convention), translated from the
+     * caller's top-left CSS-pixel rect.
+     */
+    clear(bounds?: Bounds): void;
+    setStroke(color: Color | null): void;
+    setStrokeWidth(width: number): void;
+    stroke(): void;
+    setLineCap(cap: LineCap): void;
+    setLineJoin(join: LineJoin): void;
+    setDashArray(dash: readonly number[] | null): void;
+    setFont(family: string, size: number, options?: {
+        weight?: "normal" | "bold";
+        style?: "normal" | "italic";
+    }): void;
+    setTextAlign(align: TextAlign): void;
+    setTextBaseline(baseline: TextBaseline): void;
+    /**
+     * Text rendering with two paths:
+     *
+     *   1. MSDF (preferred) — when an `MsdfShaper`-compatible TextShaper
+     *      is registered. Builds per-glyph quads against a shared
+     *      `GlyphAtlas`, draws them with the bundled MSDF program so
+     *      letters stay crisp at any zoom (no bitmap re-rasterisation
+     *      when the user scales the view).
+     *
+     *   2. OffscreenCanvas fallback — used when no MSDF-capable shaper is
+     *      registered (older module, Safari without bundled wasm, etc.).
+     */
+    fillText(text: string, x: number, y: number, maxWidth?: number): void;
+    private msdfPipeline;
+    private glyphAtlas;
+    private glyphAtlasShaper;
+    /**
+     * Lazy-acquire the MSDF atlas — only when there's an
+     * `MsdfShaper`-compatible TextShaper registered via
+     * `setActiveTextShaper`. Held for the lifetime of the WebGL2Target;
+     * cleared on dispose.
+     *
+     * Re-creates the atlas if a different shaper instance gets registered
+     * later. Same shaper instance → reuses the existing cache, so
+     * steady-state cost is one map lookup.
+     */
+    private ensureGlyphAtlas;
+    /**
+     * MSDF path for `fillText`. Honours textAlign / textBaseline by
+     * measuring the string width upfront and shifting the cursor. Width
+     * measurement walks the atlas (advance from cached metrics), so it
+     * doesn't round-trip the WASM measure().
+     */
+    private fillTextMSDF;
+    /**
+     * Rebind the solid program + static unit-quad VBO + cached aPos
+     * pointer. Three GL calls, no allocation, no upload, no string-keyed
+     * driver lookup. Called after any draw that switched program or
+     * rebound the buffer (image, MSDF text, curves, polygon fill, triangle
+     * fan).
+     */
+    private restoreSolidProgram;
+    measureText(text: string): {
+        width: number;
+    };
+    /** Hidden Canvas2D context for measureText + bitmap rasterisation. */
+    private textCtx;
+    /**
+     * Per-string OffscreenCanvas cache for the fallback text path (no MSDF
+     * shaper registered). Keyed by `text|font|color`. Capped via
+     * `WEBGL2_TEXT_BITMAP_CACHE_CAP` LRU eviction.
+     *
+     * `Map` preserves insertion order, so the oldest entry is the iterator
+     * head. `rasteriseString` "touches" a hit by delete + set, which moves
+     * it to the tail.
+     */
+    private readonly textBitmaps;
+    private ensureTextCtx;
+    private textFontSpec;
+    private textMetrics;
+    private rasteriseString;
+    /**
+     * Trim `textBitmaps` down to `WEBGL2_TEXT_BITMAP_CACHE_CAP` entries by
+     * dropping least-recently-used keys. For each evicted OffscreenCanvas
+     * the associated GPU texture (uploaded lazily via `drawImage` →
+     * `textureFor`) is also deleted, otherwise the VRAM stays held until
+     * JS GC collects the canvas.
+     */
+    private evictTextBitmapsIfOverCap;
+}
+/**
+ * Split a polyline into the "on" dash runs for `pattern` ([on, off, on, …]),
+ * lengths in the polyline's own (world) units. Walks each segment, toggling
+ * on/off as the running distance crosses each pattern element, and emits the
+ * point lists of the drawn runs. Used by WebGL2 `stroke()` to render dashed /
+ * dotted lines (Canvas2D gets this for free from `ctx.setLineDash`).
+ */
+export declare const dashPolyline: (pts: readonly Vec2[], pattern: readonly number[]) => Vec2[][];
+//# sourceMappingURL=webgl2-target.d.ts.map

package/dist/webgl2-target.d.ts.map

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