spryte 0.0.0-stage → 0.1.0

package/dist/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/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAGA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AAExC,4HAA4H;AAC5H,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,KAAK,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACpC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpF,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,IAAI,IAAI,CAAC;QAClC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAGD,IAAI,KAA+B,CAAC;AACpC,oFAAoF;AACpF,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACrH,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAiB,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,gCAAgC,CAAC,CAAC;IAC3F,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;IACzB,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAU,GAAG,CAAC;IACpD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,UAAU,CAAC;IAC7C,OAAO,QAAQ,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;AACpF,CAAC"}

package/dist/copies.d.ts

@@ -0,0 +1,45 @@
+import type { Matrix, TextureSource } from "./backend.js";
+/** Optional per-copy values for `draw.sprites`. Each array has one entry per copy. */
+export interface SpritesEach {
+    /** Uniform scale per copy, multiplied with `scaleX`/`scaleY`. */
+    scale?: ArrayLike<number>;
+    /** Radians per copy, added to `rotation`. */
+    rotation?: ArrayLike<number>;
+    /** `0xRRGGBBAA` per copy, multiplied with `tint` and `alpha`. A `Uint32Array`, uploaded as is. */
+    color?: Uint32Array;
+}
+/**
+ * Everything a backend needs to draw copies of one frame with per-copy values.
+ * @internal
+ */
+export interface CopySpec {
+    /** The current transform. */
+    m: Matrix;
+    positions: ArrayLike<number>;
+    count: number;
+    src: TextureSource;
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+    /** Anchor offset in frame pixels: -origin × size. */
+    ox: number;
+    oy: number;
+    /** Shared scale, flips folded in. */
+    scaleX: number;
+    scaleY: number;
+    rotation: number;
+    /** Shared 0xRRGGBBAA (tint × alpha × global alpha). */
+    color: number;
+    flash: number;
+    smooth: boolean;
+    /** Pixel art under a rotation-free transform: copies whose own rotation is zero snap to whole pixels. */
+    snap: boolean;
+    each: SpritesEach;
+}
+/**
+ * Copy `i`'s quad matrix (the same algebra as `draw.sprite`) and colour, for backends without a GPU path.
+ * Returns the colour; writes the matrix into `out`.
+ */
+export declare function copyAt(c: CopySpec, i: number, out: Matrix): number;
+//# sourceMappingURL=copies.d.ts.map

package/dist/copies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copies.d.ts","sourceRoot":"","sources":["../src/copies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B,kGAAkG;IAClG,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,aAAa,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,yGAAyG;IACzG,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAgClE"}

package/dist/copies.js

@@ -0,0 +1,43 @@
+/**
+ * Copy `i`'s quad matrix (the same algebra as `draw.sprite`) and colour, for backends without a GPU path.
+ * Returns the colour; writes the matrix into `out`.
+ */
+export function copyAt(c, i, out) {
+    const k = c.each.scale ? c.each.scale[i] : 1;
+    const r = c.rotation + (c.each.rotation ? c.each.rotation[i] : 0);
+    const sx = c.scaleX * k;
+    const sy = c.scaleY * k;
+    let a = sx;
+    let b = 0;
+    let cc = 0;
+    let d = sy;
+    if (r) {
+        const cos = Math.cos(r);
+        const sin = Math.sin(r);
+        a = cos * sx;
+        b = sin * sx;
+        cc = -sin * sy;
+        d = cos * sy;
+    }
+    const lx = a * c.ox + cc * c.oy + c.positions[i * 2];
+    const ly = b * c.ox + d * c.oy + c.positions[i * 2 + 1];
+    const m = c.m;
+    out[0] = (m[0] * a + m[2] * b) * c.sw;
+    out[1] = (m[1] * a + m[3] * b) * c.sw;
+    out[2] = (m[0] * cc + m[2] * d) * c.sh;
+    out[3] = (m[1] * cc + m[3] * d) * c.sh;
+    out[4] = m[0] * lx + m[2] * ly + m[4];
+    out[5] = m[1] * lx + m[3] * ly + m[5];
+    if (c.snap && !r) {
+        out[4] = Math.round(out[4]);
+        out[5] = Math.round(out[5]);
+    }
+    const each = c.each.color ? c.each.color[i] : 0xffffffff;
+    return each === 0xffffffff ? c.color : multiply(c.color, each);
+}
+/** Channel-wise product of two 0xRRGGBBAA colours. */
+function multiply(x, y) {
+    const ch = (shift) => Math.round((((x >>> shift) & 0xff) * ((y >>> shift) & 0xff)) / 255);
+    return ((ch(24) << 24) | (ch(16) << 16) | (ch(8) << 8) | ch(0)) >>> 0;
+}
+//# sourceMappingURL=copies.js.map

package/dist/copies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copies.js","sourceRoot":"","sources":["../src/copies.ts"],"names":[],"mappings":"AA0CA;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,CAAW,EAAE,CAAS,EAAE,GAAW;IACxD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,IAAI,CAAC,EAAE,CAAC;QACN,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;QACb,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;QACb,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACf,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC;IACf,CAAC;IACD,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,GAAI,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAY,CAAC;IACjE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,GAAI,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAY,CAAC;IACpE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACtC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACtC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACvC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACvC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;QACjB,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,sDAAsD;AACtD,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,MAAM,EAAE,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAClG,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/dist/draw.d.ts

@@ -0,0 +1,188 @@
+import type { Backend, BlendMode, Matrix, RawContext, TextureSource } from "./backend.js";
+import type { BitmapFont } from "./bitmap-font.js";
+import { type Color } from "./color.js";
+import type { SpritesEach } from "./copies.js";
+import { Shader } from "./shader.js";
+import { RenderTarget } from "./target.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: `draw.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;
+    /**
+     * Font for `text()` and `measure()` when none is given: a CSS font, a `BitmapFont`, or a function returning
+     * one (called on first use, so a font built from a canvas costs nothing until text is drawn).
+     */
+    font: string | BitmapFont | (() => string | BitmapFont);
+    /** 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 lastImage;
+    private lastFrame;
+    private readonly clips;
+    private shader;
+    /** The render target being drawn into, or null for the canvas. */
+    private target;
+    /** The canvas's logical size this frame, to switch back to after `into()`. */
+    private viewW;
+    private viewH;
+    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;
+    /**
+     * Resolves once the backend can draw. Immediate on WebGL2; on the Canvas 2D fallback, once its chunk has
+     * loaded (frames before that draw nothing). Rejects if the fallback fails to load.
+     */
+    ready: Promise<void>;
+    /** 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;
+    /**
+     * Draw one image frame at many positions in a single call: particles, bullets, swarms, starfields.
+     * `positions` holds x, y pairs (a `Float32Array` you reuse is ideal); `count` defaults to all of them.
+     * Every copy shares `options` (rotation, scale, tint, alpha…), so per-copy work is just the position.
+     * Much faster than calling `sprite()` in a loop, and allocation-free.
+     *
+     * ```ts
+     * const pos = new Float32Array(2 * MAX);
+     * // ...update pos...
+     * draw.sprites(spark, pos, live, { tint: "#ffd36b", alpha: 0.8 });
+     * ```
+     */
+    sprites(frame: Frame | TextureSource, positions: ArrayLike<number>, count?: number, o?: SpriteDrawOptions, each?: SpritesEach): void;
+    private spritesEach;
+    /** tmp = M · T(x, y) · R(rotation) · S(sx, sy) · T(ox, oy) · S(w, h), expanded by hand. Returns the frame. */
+    private place;
+    private spriteColor;
+    /** 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;
+    /** An offscreen image of `width × height` pixels to draw into with `into()`, then draw like any image. */
+    createTarget(width: number, height: number): RenderTarget;
+    /**
+     * Run `fn` with drawing going into `target` instead of the canvas, then switch back. Inside, units are the
+     * target's pixels from its top-left; the transform, clips and global alpha start fresh and are restored
+     * afterwards. `clear` fills the target first (default transparent); pass `null` to draw over what's there,
+     * for trails and accumulation. Nests.
+     *
+     * ```ts
+     * const glow = draw.createTarget(160, 90);
+     * draw.into(glow, () => draw.sprites(spark, sparks, n, { tint: "#ffd36b" }));
+     * draw.blend("add");
+     * draw.sprite(glow, 160, 90, { scaleX: 2, scaleY: 2, smooth: true });
+     * ```
+     */
+    into(target: RenderTarget, fn: () => void, clear?: Color | null): void;
+    /** A custom fragment effect: see `Shader`. Compiled on first use, so errors surface at the first `withShader` draw. */
+    createShader(source: string): Shader;
+    /** Run `fn` with everything drawn through `shader`, then restore the previous one. Nests. WebGL2 only (see `Shader`). */
+    withShader(shader: Shader, fn: () => void): void;
+    /** Free a target's GPU memory. Drawing it afterwards recreates it, blank. */
+    disposeTarget(target: RenderTarget): void;
+    /** True while the WebGL context is lost (e.g. a backgrounded mobile tab): frames draw nothing until it's restored. */
+    get contextLost(): boolean;
+    /** 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 defaultFont;
+    private withAlpha;
+    private circle64;
+}
+//# sourceMappingURL=draw.d.ts.map

package/dist/draw.d.ts.map

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