@debuffjp/core 0.9.0 → 0.9.1

package/dist/render/backend.d.ts

@@ -0,0 +1,48 @@
+/** 2D affine matrix `[a, b, c, d, e, f]`: x' = a·x + c·y + e, y' = b·x + d·y + f (Canvas order). */
+export type Matrix = [number, number, number, number, number, number];
+export type BlendMode = "normal" | "add";
+export interface ClipRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** Raw access for advanced users. The backends are not interchangeable at this level. */
+export type RawContext = {
+    kind: "webgl2";
+    gl: WebGL2RenderingContext;
+} | {
+    kind: "2d";
+    ctx: CanvasRenderingContext2D;
+};
+/** Image sources the renderer can draw. Textures are cached per source object. */
+export type TextureSource = HTMLImageElement | HTMLCanvasElement | OffscreenCanvas | ImageBitmap;
+/**
+ * What a rendering backend implements. Everything is expressed as quads: a transform that maps the
+ * unit square onto logical space, an optional source rectangle, and an RGBA colour (tint).
+ * @internal
+ */
+export interface Backend {
+    readonly kind: "webgl2" | "2d";
+    readonly raw: RawContext;
+    /** GPU draw calls submitted so far this frame, where the backend batches (WebGL2). */
+    readonly drawCalls?: number;
+    /** Begin a frame: clear to `clear` (0xRRGGBBAA) at the given logical size and backing scale. */
+    begin(clear: number, width: number, height: number, scale: number): void;
+    /**
+     * Draw the unit square transformed by `m`. `src` null draws solid `color`.
+     * `sx, sy, sw, sh` is the source rect in source pixels (ignored when `src` is null). `flash` (0..1) mixes the texture toward white.
+     * `smooth` selects linear filtering for this source.
+     */
+    quad(m: Matrix, src: TextureSource | null, sx: number, sy: number, sw: number, sh: number, color: number, flash: number, smooth: boolean): void;
+    setBlend(mode: BlendMode): void;
+    /** Restrict drawing to a rectangle in backing-store pixels (top-left origin), or remove the clip. */
+    setClip(rect: ClipRect | null): void;
+    /** Submit everything queued this frame. */
+    end(): void;
+    resize(backingWidth: number, backingHeight: number): void;
+    /** Drop cached GPU data for a source whose pixels changed. */
+    invalidate(src: TextureSource): void;
+    dispose(): void;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/render/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/render/backend.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,yFAAyF;AACzF,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,sBAAsB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAExH,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,eAAe,GAAG,WAAW,CAAC;AAEjG;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzE;;;;OAIG;IACH,IAAI,CACF,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,IAAI,CAAC;IACR,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,qGAAqG;IACrG,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,2CAA2C;IAC3C,GAAG,IAAI,IAAI,CAAC;IACZ,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/render/backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/render/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/render/backend.ts"],"names":[],"mappings":""}

package/dist/render/bitmap-font.d.ts

@@ -0,0 +1,55 @@
+import type { Frame } from "./draw.js";
+export interface BitmapFontOptions {
+    /** One frame per glyph, in the order of `chars`: usually `assets.frames("font")` from a `font@WxH.png` grid. */
+    frames: readonly Frame[];
+    /** The characters the frames hold, in order. */
+    chars: string;
+    /**
+     * Advance per glyph in pixels. Default: measured from each glyph's rightmost opaque column, so a
+     * grid drawn in Aseprite becomes a proportional font. Pass a number for a monospaced font.
+     */
+    widths?: readonly number[] | number;
+    /** Pixels between glyphs. Default 1. */
+    spacing?: number;
+    /** Advance for a space (and any glyph that measures empty). Default a third of the cell height, rounded. */
+    spaceWidth?: number;
+    /** Pixels from one line's top to the next. Default the cell height + 1. */
+    lineHeight?: number;
+    /** Drawn for characters the font lacks. Default "?" if present, else nothing. */
+    fallback?: string;
+}
+export interface Glyph {
+    frame: Frame;
+    /** Pixels to advance after drawing, before spacing. */
+    advance: number;
+}
+/**
+ * A pixel font from a sprite sheet. Pass it as `font` to `draw.text` and `draw.measure`: glyphs land
+ * on whole pixels, so it stays crisp at any integer scale.
+ *
+ * ```ts
+ * // assets/font@6x9.png: glyphs on a 6×9 grid, exported from Aseprite
+ * const font = new BitmapFont({ frames: assets.frames("font"), chars: BitmapFont.ASCII });
+ * draw.text("coins 3", 4, 4, { font, color: "#fbbf24" });
+ * ```
+ */
+export declare class BitmapFont {
+    /** Printable ASCII from space to "~", the order most font sheets use. */
+    static readonly ASCII: string;
+    /** Cell height in pixels. */
+    readonly height: number;
+    readonly lineHeight: number;
+    readonly spacing: number;
+    private readonly glyphs;
+    private readonly fallback;
+    constructor(o: BitmapFontOptions);
+    glyph(ch: string): Glyph | undefined;
+    /** Size of `text` in pixels. Lines split on "\n". */
+    measure(text: string): {
+        w: number;
+        h: number;
+    };
+    /** Width of one line, without trailing spacing. */
+    lineWidth(line: string): number;
+}
+//# sourceMappingURL=bitmap-font.d.ts.map

package/dist/render/bitmap-font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmap-font.d.ts","sourceRoot":"","sources":["../../src/render/bitmap-font.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,gHAAgH;IAChH,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,yEAAyE;IACzE,MAAM,CAAC,QAAQ,CAAC,KAAK,SAA8E;IAEnG,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C,YAAY,CAAC,EAAE,iBAAiB,EAiB/B;IAED,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEnC;IAED,qDAAqD;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAM9C;IAED,mDAAmD;IACnD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU9B;CACF"}

package/dist/render/bitmap-font.js

@@ -0,0 +1,103 @@
+/**
+ * A pixel font from a sprite sheet. Pass it as `font` to `draw.text` and `draw.measure`: glyphs land
+ * on whole pixels, so it stays crisp at any integer scale.
+ *
+ * ```ts
+ * // assets/font@6x9.png: glyphs on a 6×9 grid, exported from Aseprite
+ * const font = new BitmapFont({ frames: assets.frames("font"), chars: BitmapFont.ASCII });
+ * draw.text("coins 3", 4, 4, { font, color: "#fbbf24" });
+ * ```
+ */
+export class BitmapFont {
+    /** Printable ASCII from space to "~", the order most font sheets use. */
+    static ASCII = Array.from({ length: 95 }, (_, i) => String.fromCharCode(32 + i)).join("");
+    /** Cell height in pixels. */
+    height;
+    lineHeight;
+    spacing;
+    glyphs = new Map();
+    fallback;
+    constructor(o) {
+        const first = o.frames[0];
+        if (!first)
+            throw new Error("BitmapFont needs at least one frame");
+        const chars = [...o.chars];
+        if (chars.length > o.frames.length)
+            throw new Error(`BitmapFont has ${chars.length} chars but only ${o.frames.length} frames; check the grid size in the file name`);
+        this.height = first.h;
+        this.lineHeight = o.lineHeight ?? first.h + 1;
+        this.spacing = o.spacing ?? 1;
+        const space = o.spaceWidth ?? Math.max(1, Math.round(first.h / 3));
+        const measured = o.widths === undefined ? measureWidths(o.frames.slice(0, chars.length)) : undefined;
+        chars.forEach((ch, i) => {
+            const frame = o.frames[i];
+            const w = typeof o.widths === "number" ? o.widths : (o.widths?.[i] ?? measured?.[i] ?? frame.w);
+            this.glyphs.set(ch, { frame, advance: w > 0 ? w : space });
+        });
+        this.fallback = this.glyphs.get(o.fallback ?? "?");
+    }
+    glyph(ch) {
+        return this.glyphs.get(ch) ?? this.fallback;
+    }
+    /** Size of `text` in pixels. Lines split on "\n". */
+    measure(text) {
+        if (!text)
+            return { w: 0, h: 0 };
+        const lines = text.split("\n");
+        let w = 0;
+        for (const line of lines)
+            w = Math.max(w, this.lineWidth(line));
+        return { w, h: (lines.length - 1) * this.lineHeight + this.height };
+    }
+    /** Width of one line, without trailing spacing. */
+    lineWidth(line) {
+        let w = 0;
+        let n = 0;
+        for (const ch of line) {
+            const g = this.glyph(ch);
+            if (!g)
+                continue;
+            w += g.advance;
+            n++;
+        }
+        return n ? w + (n - 1) * this.spacing : 0;
+    }
+}
+/** Rightmost opaque column + 1 for each frame; 0 for empty ones. Falls back to the frame width without a 2D canvas. */
+function measureWidths(frames) {
+    const cache = new Map();
+    return frames.map((f) => {
+        let img = cache.get(f.image);
+        if (img === undefined) {
+            img = readPixels(f.image);
+            cache.set(f.image, img);
+        }
+        if (!img)
+            return f.w;
+        for (let x = f.w - 1; x >= 0; x--)
+            for (let y = 0; y < f.h; y++)
+                if ((img.data[((f.y + y) * img.width + f.x + x) * 4 + 3] ?? 0) > 0)
+                    return x + 1;
+        return 0;
+    });
+}
+function readPixels(src) {
+    const w = "naturalWidth" in src ? src.naturalWidth : src.width;
+    const h = "naturalHeight" in src ? src.naturalHeight : src.height;
+    if (!w || !h)
+        return null;
+    try {
+        const canvas = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(w, h) : document.createElement("canvas");
+        canvas.width = w;
+        canvas.height = h;
+        const ctx = canvas.getContext("2d");
+        if (!ctx)
+            return null;
+        ctx.drawImage(src, 0, 0);
+        return { data: ctx.getImageData(0, 0, w, h).data, width: w };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=bitmap-font.js.map

package/dist/render/bitmap-font.js.map

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

package/dist/render/canvas2d.d.ts

@@ -0,0 +1,30 @@
+import type { Backend, BlendMode, ClipRect, Matrix, RawContext, TextureSource } from "./backend.js";
+/**
+ * Canvas 2D fallback for the `draw` API. Same output for solid shapes, sprites, text and alpha.
+ * Canvas 2D has no per-draw tint, so tinted textures (text, bitmap fonts, `tint`) go through a scratch
+ * canvas: slower than WebGL2, but only when a tint other than white is asked for.
+ */
+export declare class Canvas2DBackend implements Backend {
+    readonly kind: "2d";
+    readonly raw: RawContext;
+    private readonly ctx;
+    private scale;
+    private smoothing;
+    private scratch;
+    private clipped;
+    private blendMode;
+    constructor(ctx: CanvasRenderingContext2D);
+    begin(clear: number, width: number, height: number, scale: number): void;
+    quad(m: Matrix, src: TextureSource | null, sx: number, sy: number, sw: number, sh: number, color: number, flash: number, smooth: boolean): void;
+    setBlend(mode: BlendMode): void;
+    setClip(rect: ClipRect | null): void;
+    end(): void;
+    resize(): void;
+    invalidate(): void;
+    dispose(): void;
+    /** The source region multiplied by `color`'s RGB, keeping the source's alpha. */
+    private tinted;
+    private scratchCanvas;
+    private whiteSilhouette;
+}
+//# sourceMappingURL=canvas2d.d.ts.map

package/dist/render/canvas2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas2d.d.ts","sourceRoot":"","sources":["../../src/render/canvas2d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGpG;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAU;IAC9B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAC/C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,OAAO,CAAkD;IACjE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IAExC,YAAY,GAAG,EAAE,wBAAwB,EAGxC;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQvE;IAED,IAAI,CACF,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,aAAa,GAAG,IAAI,EACzB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,GACd,IAAI,CAqBN;IAED,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAG9B;IAED,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAenC;IAED,GAAG,IAAI,IAAI,CAIV;IAED,MAAM,IAAI,IAAI,CAGb;IAED,UAAU,IAAI,IAAI,CAEjB;IAED,OAAO,IAAI,IAAI,CAAG;IAElB,iFAAiF;IACjF,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,eAAe;CAYxB"}

package/dist/render/canvas2d.js

@@ -0,0 +1,128 @@
+import { rgbaToCss } from "./color.js";
+/**
+ * Canvas 2D fallback for the `draw` API. Same output for solid shapes, sprites, text and alpha.
+ * Canvas 2D has no per-draw tint, so tinted textures (text, bitmap fonts, `tint`) go through a scratch
+ * canvas: slower than WebGL2, but only when a tint other than white is asked for.
+ */
+export class Canvas2DBackend {
+    kind = "2d";
+    raw;
+    ctx;
+    scale = 1;
+    smoothing;
+    scratch;
+    clipped = false;
+    blendMode = "normal";
+    constructor(ctx) {
+        this.ctx = ctx;
+        this.raw = { kind: "2d", ctx };
+    }
+    begin(clear, width, height, scale) {
+        this.scale = scale;
+        const ctx = this.ctx;
+        ctx.setTransform(scale, 0, 0, scale, 0, 0);
+        ctx.globalAlpha = 1;
+        ctx.globalCompositeOperation = "source-over";
+        ctx.fillStyle = rgbaToCss(clear);
+        ctx.fillRect(0, 0, width, height);
+    }
+    quad(m, src, sx, sy, sw, sh, color, flash, smooth) {
+        const ctx = this.ctx;
+        const s = this.scale;
+        ctx.setTransform(m[0] * s, m[1] * s, m[2] * s, m[3] * s, m[4] * s, m[5] * s);
+        if (!src) {
+            ctx.globalAlpha = 1;
+            ctx.fillStyle = rgbaToCss(color);
+            ctx.fillRect(0, 0, 1, 1);
+            return;
+        }
+        if (this.smoothing !== smooth) {
+            ctx.imageSmoothingEnabled = smooth;
+            this.smoothing = smooth;
+        }
+        ctx.globalAlpha = (color & 0xff) / 255;
+        if (color >>> 8 === 0xffffff)
+            ctx.drawImage(src, sx, sy, sw, sh, 0, 0, 1, 1);
+        else
+            ctx.drawImage(this.tinted(src, sx, sy, sw, sh, color), 0, 0, sw, sh, 0, 0, 1, 1);
+        if (flash > 0) {
+            ctx.globalAlpha *= Math.min(1, flash);
+            ctx.drawImage(this.whiteSilhouette(src, sx, sy, sw, sh), 0, 0, sw, sh, 0, 0, 1, 1);
+        }
+    }
+    setBlend(mode) {
+        this.blendMode = mode;
+        this.ctx.globalCompositeOperation = mode === "add" ? "lighter" : "source-over";
+    }
+    setClip(rect) {
+        const ctx = this.ctx;
+        // Canvas clips only shrink, so each change restores to the unclipped state first.
+        if (this.clipped) {
+            ctx.restore();
+            this.clipped = false;
+            this.setBlend(this.blendMode);
+        }
+        if (!rect)
+            return;
+        ctx.save();
+        ctx.setTransform(1, 0, 0, 1, 0, 0);
+        ctx.beginPath();
+        ctx.rect(rect.x, rect.y, rect.w, rect.h);
+        ctx.clip();
+        this.clipped = true;
+    }
+    end() {
+        this.setClip(null);
+        this.ctx.setTransform(1, 0, 0, 1, 0, 0);
+        this.ctx.globalAlpha = 1;
+    }
+    resize() {
+        // Canvas resize resets context state; it's reapplied in begin().
+        this.smoothing = undefined;
+    }
+    invalidate() {
+        // Canvas 2D reads sources directly; nothing is cached.
+    }
+    dispose() { }
+    /** The source region multiplied by `color`'s RGB, keeping the source's alpha. */
+    tinted(src, x, y, w, h, color) {
+        const scratch = this.scratchCanvas(w, h);
+        const sctx = scratch.getContext("2d");
+        if (!sctx)
+            return scratch;
+        sctx.clearRect(0, 0, w, h);
+        sctx.globalCompositeOperation = "source-over";
+        sctx.drawImage(src, x, y, w, h, 0, 0, w, h);
+        sctx.globalCompositeOperation = "multiply";
+        sctx.fillStyle = rgbaToCss(color | 0xff);
+        sctx.fillRect(0, 0, w, h);
+        // multiply filled the transparent pixels too; cut back to the source's shape.
+        sctx.globalCompositeOperation = "destination-in";
+        sctx.drawImage(src, x, y, w, h, 0, 0, w, h);
+        sctx.globalCompositeOperation = "source-over";
+        return scratch;
+    }
+    scratchCanvas(w, h) {
+        if (!this.scratch)
+            this.scratch = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(w, h) : document.createElement("canvas");
+        if (this.scratch.width < w)
+            this.scratch.width = w;
+        if (this.scratch.height < h)
+            this.scratch.height = h;
+        return this.scratch;
+    }
+    whiteSilhouette(src, x, y, w, h) {
+        const scratch = this.scratchCanvas(w, h);
+        const sctx = scratch.getContext("2d");
+        if (!sctx)
+            return scratch;
+        sctx.clearRect(0, 0, w, h);
+        sctx.globalCompositeOperation = "source-over";
+        sctx.drawImage(src, x, y, w, h, 0, 0, w, h);
+        sctx.globalCompositeOperation = "source-in";
+        sctx.fillStyle = "#fff";
+        sctx.fillRect(0, 0, w, h);
+        return scratch;
+    }
+}
+//# sourceMappingURL=canvas2d.js.map

package/dist/render/canvas2d.js.map

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

package/dist/render/color.d.ts

@@ -0,0 +1,7 @@
+/** A colour: CSS hex string (`#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`) or a number `0xRRGGBBAA`. */
+export type Color = string | number;
+/** Normalise a colour to `0xRRGGBBAA` (unsigned). Hex strings are cached; other CSS colours resolve through the browser. */
+export declare function toRGBA(color: Color): number;
+/** `0xRRGGBBAA` to a CSS colour string. */
+export declare function rgbaToCss(rgba: number, alphaScale?: number): string;
+//# sourceMappingURL=color.d.ts.map

package/dist/render/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/render/color.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAIpC,4HAA4H;AAC5H,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAQ3C;AA8BD,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAI,GAAG,MAAM,CAG9D"}

package/dist/render/color.js

@@ -0,0 +1,49 @@
+const cache = new Map();
+/** Normalise a colour to `0xRRGGBBAA` (unsigned). Hex strings are cached; other CSS colours resolve through the browser. */
+export function toRGBA(color) {
+    if (typeof color === "number")
+        return color >>> 0;
+    const hit = cache.get(color);
+    if (hit !== undefined)
+        return hit;
+    const value = parse(color);
+    if (cache.size > 512)
+        cache.clear();
+    cache.set(color, value);
+    return value;
+}
+function parse(input) {
+    let hex = input.trim();
+    if (hex.startsWith("#")) {
+        hex = hex.slice(1);
+        if (hex.length === 3 || hex.length === 4)
+            hex = [...hex].map((c) => c + c).join("");
+        if (hex.length === 6)
+            hex += "ff";
+        if (hex.length === 8 && /^[0-9a-f]{8}$/i.test(hex))
+            return Number.parseInt(hex, 16) >>> 0;
+    }
+    return parseCss(input);
+}
+let probe;
+/** Any other CSS colour (named, rgb(), hsl()…): let the browser resolve it once. */
+function parseCss(input) {
+    if (probe === undefined) {
+        const canvas = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(1, 1) : document.createElement("canvas");
+        probe = canvas.getContext("2d", { willReadFrequently: true });
+    }
+    if (!probe)
+        throw new Error(`Cannot parse colour "${input}" without a 2D canvas; use hex`);
+    probe.clearRect(0, 0, 1, 1);
+    probe.fillStyle = "#000";
+    probe.fillStyle = input;
+    probe.fillRect(0, 0, 1, 1);
+    const [r = 0, g = 0, b = 0, a = 0] = probe.getImageData(0, 0, 1, 1).data;
+    return ((r << 24) | (g << 16) | (b << 8) | a) >>> 0;
+}
+/** `0xRRGGBBAA` to a CSS colour string. */
+export function rgbaToCss(rgba, alphaScale = 1) {
+    const a = ((rgba & 0xff) / 255) * alphaScale;
+    return `rgba(${rgba >>> 24},${(rgba >>> 16) & 0xff},${(rgba >>> 8) & 0xff},${a})`;
+}
+//# sourceMappingURL=color.js.map

package/dist/render/color.js.map

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

package/dist/render/draw.d.ts

@@ -0,0 +1,125 @@
+import type { Backend, BlendMode, Matrix, RawContext, TextureSource } from "./backend.js";
+import type { BitmapFont } from "./bitmap-font.js";
+import { type Color } from "./color.js";
+/** A rectangular region of an image, in source pixels. */
+export interface Frame {
+    image: TextureSource;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface SpriteDrawOptions {
+    /** Anchor as a fraction of the frame size. Default [0.5, 0.5] (centre). */
+    origin?: readonly [number, number];
+    scaleX?: number;
+    scaleY?: number;
+    /** Radians. */
+    rotation?: number;
+    flipX?: boolean;
+    flipY?: boolean;
+    /** Multiplied with the global alpha. */
+    alpha?: number;
+    /** Colour multiplier. Default white. */
+    tint?: Color;
+    /** 0..1 mix toward white, e.g. hit flashes. */
+    flash?: number;
+    /** Linear filtering for this sprite. Default: the game's setting (off when `pixelArt`). */
+    smooth?: boolean;
+}
+export interface TextDrawOptions {
+    /** A `BitmapFont`, or a CSS font such as "16px monospace". Default: debuff sans, the built-in pixel font. */
+    font?: string | BitmapFont | undefined;
+    color?: Color;
+    align?: "left" | "center" | "right";
+    baseline?: "top" | "middle" | "bottom";
+    alpha?: number;
+}
+/**
+ * Immediate-mode drawing in logical units, the same API on WebGL2 and Canvas 2D (ADR 0007).
+ * Everything batches automatically; call order is draw order.
+ */
+export declare class Draw {
+    private backend;
+    /** Default filtering for images (false for pixel art). */
+    smooth: boolean;
+    /** Global alpha multiplier for subsequent draws. */
+    alpha: number;
+    /** Quads (sprites, rects, glyph runs…) submitted this frame. Reset each frame; for diagnostics. */
+    quads: number;
+    /** Preallocated transform stack: push/pop copy six numbers and never allocate. */
+    private readonly stack;
+    private depth;
+    private readonly m;
+    private readonly frames;
+    private readonly clips;
+    private readonly tmp;
+    private readonly textCache;
+    private circleTexture;
+    private backingW;
+    private backingH;
+    /** @internal */
+    constructor(backend: Backend, 
+    /** Default filtering for images (false for pixel art). */
+    smooth: boolean);
+    /** Which backend is active. */
+    get kind(): "webgl2" | "2d";
+    /** Draw calls this frame: batched GPU calls on WebGL2, one per quad on Canvas 2D. */
+    get drawCalls(): number;
+    /** Raw `WebGL2RenderingContext` or `CanvasRenderingContext2D`. Mixing raw calls with `draw` calls requires care. */
+    get raw(): RawContext;
+    push(): void;
+    pop(): void;
+    translate(x: number, y: number): void;
+    scale(x: number, y?: number): void;
+    rotate(radians: number): void;
+    /**
+     * Run `fn` with drawing restricted to a rectangle (in current units), then restore. Nested clips
+     * intersect. Clips are axis-aligned on screen: under rotation the rectangle's screen bounds are used.
+     */
+    clip(x: number, y: number, w: number, h: number, fn: () => void): void;
+    /** Run `fn` with the camera's view applied, then restore. */
+    withCamera(camera: {
+        view(): Matrix;
+    }, fn: () => void): void;
+    blend(mode: BlendMode): void;
+    rect(x: number, y: number, w: number, h: number, color: Color): void;
+    /** Filled circle (antialiased). */
+    circle(x: number, y: number, radius: number, color: Color): void;
+    line(x1: number, y1: number, x2: number, y2: number, width: number, color: Color): void;
+    /** Draw an image frame (or a whole image) at `x, y`, anchored by `origin`. Allocation-free hot path. */
+    sprite(frame: Frame | TextureSource, x: number, y: number, o?: SpriteDrawOptions): void;
+    /** Text, rasterised once and cached as a texture (crisp at the current render scale). */
+    text(text: string, x: number, y: number, o?: TextDrawOptions): void;
+    /**
+     * The logical box `text()` fills for this string and font, so layouts can align and centre without
+     * guessing. Same cache as `text()`, so measuring then drawing rasterises once.
+     */
+    measure(text: string, font?: string | BitmapFont): {
+        w: number;
+        h: number;
+    };
+    private bitmapText;
+    /** Re-upload a source whose pixels changed (e.g. a canvas you draw into). */
+    invalidate(src: TextureSource): void;
+    /** @internal */
+    renderScale: number;
+    /** @internal */
+    begin(clear: Color, width: number, height: number, scale: number): void;
+    /** @internal Reset transform and blend between scene and afterRender hooks. */
+    reset(): void;
+    /** @internal */
+    end(): void;
+    /** @internal Release GPU resources and listeners. */
+    dispose(): void;
+    /** @internal */
+    resize(w: number, h: number): void;
+    /** @internal Switch to a backend that finished loading (the Canvas 2D fallback), at the current size. */
+    setBackend(backend: Backend): void;
+    /** tmp = current matrix × (translate(x, y) · scale(w, h)): maps the unit square to the rect. */
+    private local;
+    private wholeImage;
+    private withAlpha;
+    private circle64;
+}
+//# sourceMappingURL=draw.d.ts.map

package/dist/render/draw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draw.d.ts","sourceRoot":"","sources":["../../src/render/draw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAY,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,KAAK,EAAU,MAAM,YAAY,CAAC;AAGhD,0DAA0D;AAC1D,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,6GAA6G;IAC7G,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;GAGG;AACH,qBAAa,IAAI;IAoBb,OAAO,CAAC,OAAO;IACf,0DAA0D;IACnD,MAAM,EAAE,OAAO;IArBxB,oDAAoD;IACpD,KAAK,SAAK;IACV,mGAAmG;IACnG,KAAK,SAAK;IACV,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA8B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,aAAa,CAAkD;IAEvE,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IAErB,gBAAgB;IAChB,YACU,OAAO,EAAE,OAAO;IACxB,0DAA0D;IACnD,MAAM,EAAE,OAAO,EACpB;IAEJ,+BAA+B;IAC/B,IAAI,IAAI,IAAI,QAAQ,GAAG,IAAI,CAE1B;IAED,qFAAqF;IACrF,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,oHAAoH;IACpH,IAAI,GAAG,IAAI,UAAU,CAEpB;IAID,IAAI,IAAI,IAAI,CAQX;IAED,GAAG,IAAI,IAAI,CAIV;IAED,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpC;IAED,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,IAAI,CAM5B;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ5B;IAED;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAoCrE;IAED,6DAA6D;IAC7D,UAAU,CAAC,MAAM,EAAE;QAAE,IAAI,IAAI,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAgB3D;IAID,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAE3B;IAED,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAInE;IAED,mCAAmC;IACnC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAK/D;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAUtF;IAED,wGAAwG;IACxG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,iBAA8B,GAAG,IAAI,CA2ClG;IAED,yFAAyF;IACzF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,eAAoB,GAAG,IAAI,CAatE;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,GAAG,UAAyB,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAKxF;IAED,OAAO,CAAC,UAAU;IAsBlB,6EAA6E;IAC7E,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAEnC;IAID,gBAAgB;IAChB,WAAW,SAAK;IAEhB,gBAAgB;IAChB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAStE;IAED,+EAA+E;IAC/E,KAAK,IAAI,IAAI,CASZ;IAED,gBAAgB;IAChB,GAAG,IAAI,IAAI,CAEV;IAED,qDAAqD;IACrD,OAAO,IAAI,IAAI,CAEd;IAED,gBAAgB;IAChB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAIjC;IAED,yGAAyG;IACzG,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIjC;IAID,gGAAgG;IAChG,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,QAAQ;CAcjB"}