@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/two-d/render/Minimap.js

@@ -1,157 +0,0 @@
-import { Container, Graphics, RenderTexture, Sprite } from 'pixi.js';
-import { Game } from '../Game.js';
-import { hexToPixel } from '../../core/Hex.js';
-/** the cell indices in `explored` not yet baked into a minimap's texture - pure, so it can
- * be tested without a renderer
- *
- * @example
- * ```ts
- * import { newlyRevealed } from '@datamoc/mw_games/two-d/render';
- *
- * const explored = new Set([4, 9, 12]);
- * const alreadyDrawn = new Set([4]);
- *
- * console.log(newlyRevealed(explored, alreadyDrawn)); // [9, 12]
- * ```
- */
-export function newlyRevealed(explored, alreadyDrawn) {
-    const result = [];
-    for (const index of explored) {
-        if (!alreadyDrawn.has(index))
-            result.push(index);
-    }
-    return result;
-}
-/**
- * The minimap centre for a cell, useful for overlays that must share its topology.
- *
- * @example
- * ```ts
- * import { minimapCellCenter } from '@datamoc/mw_games/two-d/render';
- * const centre = minimapCellCenter(3, 2, 4, 'hex');
- * ```
- */
-export function minimapCellCenter(x, y, cellSize, shape = 'square') {
-    return shape === 'hex'
-        ? hexToPixel(x, y, cellSize, cellSize)
-        : { x: (x + 0.5) * cellSize, y: (y + 0.5) * cellSize };
-}
-/**
- * A downscaled picture of a level, built from exactly the data `roguelike.FieldOfView`
- * already tracks - `explored`, distinct from `visible` - plus a per-cell colour a game
- * supplies, since `mwg` has no opinion on what a wall or a floor should look like.
- *
- * The same widget serves both sizes a map screen comes in: a small corner HUD element at a
- * coarse `cellSize`, or a full, `Window`-sized pause-and-look screen at a larger one -
- * nothing here is specific to either. Quest markers or a tracked-quest location (see
- * `rpg.QuestLog.markerFor`/`trackedLocation`) are a game's own overlay on top of `world`,
- * same as they would be over any other rendered view.
- *
- * Revealed cells are painted once into a persistent `RenderTexture` and never revisited -
- * `sync` only rasterises what `newlyRevealed` reports as new, rather than redrawing the
- * whole map from scratch on every call, which is the one open engineering question this
- * item named: how an explored-cell set becomes a small texture without becoming a
- * per-frame cost that grows with how much of the level has been seen.
- *
- * @example
- * ```ts
- * import { Minimap } from '@datamoc/mw_games/two-d/render';
- *
- * const minimap = new Minimap({ widthInCells: 40, heightInCells: 24, cellSize: 2 });
- *
- * const explored = new Set([0, 1, 40]);
- * minimap.sync(explored, (x, y) => ((x + y) % 2 === 0 ? 0x3a3a2a : 0x2f5a2f));
- * minimap.setMarker(0, 0, Math.PI / 2); // the hero, facing down
- *
- * console.log(minimap.exploredCount); // 3
- * ```
- */
-export class Minimap extends Container {
-    constructor(options) {
-        super();
-        this.drawn = new Set();
-        this.marker = new Graphics();
-        this.widthInCells = options.widthInCells;
-        this.cellSize = options.cellSize ?? 2;
-        this.shape = options.shape ?? 'square';
-        this.renderTexture = RenderTexture.create({
-            width: this.shape === 'hex'
-                ? Math.ceil((options.widthInCells - 1) * this.cellSize * 0.75 + this.cellSize)
-                : options.widthInCells * this.cellSize,
-            height: this.shape === 'hex'
-                ? options.heightInCells * this.cellSize + this.cellSize / 2
-                : options.heightInCells * this.cellSize,
-        });
-        this.sprite = new Sprite(this.renderTexture);
-        this.addChild(this.sprite);
-        this.addChild(this.marker);
-    }
-    /** cells revealed since the last call, by width/height already given to the constructor */
-    get exploredCount() {
-        return this.drawn.size;
-    }
-    /**
-     * Bakes every cell in `explored` that has not been drawn yet, at whatever colour
-     * `colorFor` reports for it. A cell already baked is never revisited even if `colorFor`
-     * would now answer differently - explored terrain does not usually change colour, and a
-     * game that wants it to can `reset()` and resync from a clean texture.
-     */
-    sync(explored, colorFor) {
-        const cells = newlyRevealed(explored, this.drawn);
-        if (cells.length === 0)
-            return;
-        const patch = new Graphics();
-        for (const index of cells) {
-            this.drawn.add(index);
-            const x = index % this.widthInCells;
-            const y = Math.floor(index / this.widthInCells);
-            const center = minimapCellCenter(x, y, this.cellSize, this.shape);
-            if (this.shape === 'hex') {
-                const radius = this.cellSize / 2;
-                const points = [];
-                for (let corner = 0; corner < 6; corner++) {
-                    const angle = (Math.PI / 3) * corner;
-                    points.push(center.x + Math.cos(angle) * radius, center.y + Math.sin(angle) * radius);
-                }
-                patch.poly(points).fill({ color: colorFor(x, y) });
-            }
-            else {
-                patch
-                    .rect(center.x - this.cellSize / 2, center.y - this.cellSize / 2, this.cellSize, this.cellSize)
-                    .fill({ color: colorFor(x, y) });
-            }
-        }
-        Game.current.app.renderer.render({ container: patch, target: this.renderTexture, clear: false });
-        patch.destroy();
-    }
-    /** positions a marker at a cell, optionally pointing it in a facing direction (radians) */
-    setMarker(x, y, facing, color = 0xffffff) {
-        this.setMarkers([{ x, y, facing, color }]);
-    }
-    /** replaces the current overlay with zero or more unit/quest markers */
-    setMarkers(markers) {
-        this.marker.clear();
-        for (const marker of markers) {
-            const markerColor = marker.color ?? 0xffffff;
-            const center = minimapCellCenter(marker.x, marker.y, this.cellSize, this.shape);
-            this.marker.circle(center.x, center.y, Math.max(1, this.cellSize)).fill({ color: markerColor });
-            if (marker.facing !== undefined) {
-                const length = this.cellSize * 2;
-                this.marker
-                    .moveTo(center.x, center.y)
-                    .lineTo(center.x + Math.cos(marker.facing) * length, center.y + Math.sin(marker.facing) * length)
-                    .stroke({ color: markerColor, width: 1 });
-            }
-        }
-    }
-    /** forgets everything baked, so the next `sync` repaints from a clean texture - a fresh floor */
-    reset() {
-        this.drawn.clear();
-        Game.current.app.renderer.render({ container: new Container(), target: this.renderTexture, clear: true });
-    }
-    destroy(options) {
-        this.renderTexture.destroy(true);
-        super.destroy(options);
-    }
-}
-//# sourceMappingURL=Minimap.js.map

package/dist/two-d/render/Minimap.js.map

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

package/dist/two-d/render/NeonGlow.d.ts

@@ -1,100 +0,0 @@
-import { Sprite } from 'pixi.js';
-import { type MotionIntent } from '../../core/Motion.ts';
-/**
- * How much light a soft glow still carries at `distance` from its centre: 1 at the
- * centre, easing to exactly 0 at `radius`, 0 past it. Pure, so a sign's falloff is
- * checkable as arithmetic: the middle of a tube is always brighter than its rim.
- *
- * @example
- * ```ts
- * import { glowFalloff } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(glowFalloff(0, 24)); // 1 - the centre burns full
- * console.log(glowFalloff(24, 24)); // 0 - the rim carries nothing
- * console.log(glowFalloff(48, 24)); // 0 - past the rim stays dark
- * ```
- */
-export declare function glowFalloff(distance: number, radius: number): number;
-export interface GlowPaint {
-    /** glow colour as a hex number */
-    color: number;
-    /** light radius in pixels; must be above 0 */
-    radius: number;
-    /** peak strength, 0 (dark) to 1 (full); validated */
-    intensity: number;
-}
-/**
- * Paint a `size * size` radial glow (the sprite is square, `size` is odd) into `pixels`
- * as RGBA bytes. Centre pixels carry the colour at full intensity, rim pixels fade to
- * transparent, and intensity scales every channel linearly, so doubling it doubles the
- * light. Pure, like `paintFogPixels`.
- *
- * @example
- * ```ts
- * import { paintGlowPixels } from '@datamoc/mw_games/two-d/render';
- *
- * const size = 5;
- * const pixels = new Uint8ClampedArray(size * size * 4);
- * paintGlowPixels(pixels, size, { color: 0xff0000, radius: 2, intensity: 1 });
- * console.log(pixels[0] > pixels[pixels.length - 4]); // true - the centre burns redder than the rim
- * ```
- */
-export declare function paintGlowPixels(pixels: Uint8ClampedArray | Uint8Array, size: number, paint: GlowPaint): void;
-export interface NeonGlowOptions {
-    /** glow colour as a hex number */
-    color: number;
-    /** light radius in world pixels; must be above 0 */
-    radius: number;
-    /** peak strength, 0 to 1; default 1 */
-    intensity?: number;
-    /** slow breathing of the light; default none (a steady sign) */
-    flicker?: {
-        amount: number;
-        frequency: number;
-    };
-    /** what the flicker is for under reduced motion; default `decorative`, which holds the light steady */
-    intent?: MotionIntent;
-}
-/**
- * A soft neon glow from a shape or mask: a radial sprite drawn additively, the overlay
- * `Halo` already provides, with colour, radius, intensity and flicker (roadmap 426). A
- * global bloom stays out on purpose: one sprite per sign is cheaper, composes with
- * z-order like any other sprite, and never washes the whole scene. Mask a glow by
- * parenting it under the shape it lights, or leave it bare for a free halo around a sign.
- * Needs a DOM canvas; `paintGlowPixels` is the same falloff without one.
- *
- * @example
- * ```ts
- * import { NeonGlow } from '@datamoc/mw_games/two-d/render';
- *
- * const sign = new NeonGlow({ color: 0x37e0ff, radius: 48, flicker: { amount: 0.15, frequency: 2 } });
- * sign.position.set(200, 120);
- * sign.update(1 / 60); // the tube breathes; under reduced motion it holds steady instead
- * ```
- */
-export declare class NeonGlow extends Sprite {
-    private canvas;
-    private color;
-    private radius;
-    private peak;
-    private readonly flickerAmount;
-    private readonly flickerFrequency;
-    private readonly intent;
-    private clock;
-    constructor(options: NeonGlowOptions);
-    /** seconds of flicker accumulated so far */
-    get elapsed(): number;
-    /** swap the colour; repaints once */
-    setColor(color: number): void;
-    /** swap the radius; repaints once */
-    setRadius(radius: number): void;
-    /** swap the peak strength; applies on the next `update` without a repaint */
-    setIntensity(intensity: number): void;
-    /** advance the flicker; under reduced motion a decorative glow holds its peak instead */
-    update(dt: number): void;
-    private static paintCanvas;
-    private repaint;
-    /** the texture is generated for this glow alone, so it goes with it */
-    destroy(): void;
-}
-//# sourceMappingURL=NeonGlow.d.ts.map

package/dist/two-d/render/NeonGlow.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"NeonGlow.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/NeonGlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAW,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUxE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED,MAAM,WAAW,SAAS;IACzB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAwB5G;AAED,MAAM,WAAW,eAAe;IAC/B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,uGAAuG;IACvG,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,QAAS,SAAQ,MAAM;IACnC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,OAAO,EAAE,eAAe,EA8BnC;IAED,4CAA4C;IAC5C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI5B;IAED,qCAAqC;IACrC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAM9B;IAED,6EAA6E;IAC7E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKpC;IAED,yFAAyF;IACzF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAOvB;IAED,OAAO,CAAC,MAAM,CAAC,WAAW;IAa1B,OAAO,CAAC,OAAO;IAQf,uEAAuE;IAC9D,OAAO,IAAI,IAAI,CAEvB;CACD"}

package/dist/two-d/render/NeonGlow.js

@@ -1,184 +0,0 @@
-import { Sprite, Texture } from 'pixi.js';
-import { clamp } from '../../core/Math.js';
-import { reducedMotion } from '../../core/Motion.js';
-/** split a hex colour number into 0..255 channels; throws a RangeError outside `0x000000`-`0xffffff` */
-function splitColor(color) {
-    if (!Number.isInteger(color) || color < 0 || color > 0xffffff) {
-        throw new RangeError(`a glow needs an integer color between 0x000000 and 0xffffff, saw ${color}`);
-    }
-    return [(color >> 16) & 0xff, (color >> 8) & 0xff, color & 0xff];
-}
-/**
- * How much light a soft glow still carries at `distance` from its centre: 1 at the
- * centre, easing to exactly 0 at `radius`, 0 past it. Pure, so a sign's falloff is
- * checkable as arithmetic: the middle of a tube is always brighter than its rim.
- *
- * @example
- * ```ts
- * import { glowFalloff } from '@datamoc/mw_games/two-d/render';
- *
- * console.log(glowFalloff(0, 24)); // 1 - the centre burns full
- * console.log(glowFalloff(24, 24)); // 0 - the rim carries nothing
- * console.log(glowFalloff(48, 24)); // 0 - past the rim stays dark
- * ```
- */
-export function glowFalloff(distance, radius) {
-    if (!Number.isFinite(distance) || !Number.isFinite(radius) || radius <= 0) {
-        throw new RangeError(`a glow falloff needs a finite distance and a radius above 0, saw (${distance}, ${radius})`);
-    }
-    if (distance <= 0)
-        return 1;
-    if (distance >= radius)
-        return 0;
-    const t = 1 - (distance / radius) * (distance / radius);
-    return t * t;
-}
-/**
- * Paint a `size * size` radial glow (the sprite is square, `size` is odd) into `pixels`
- * as RGBA bytes. Centre pixels carry the colour at full intensity, rim pixels fade to
- * transparent, and intensity scales every channel linearly, so doubling it doubles the
- * light. Pure, like `paintFogPixels`.
- *
- * @example
- * ```ts
- * import { paintGlowPixels } from '@datamoc/mw_games/two-d/render';
- *
- * const size = 5;
- * const pixels = new Uint8ClampedArray(size * size * 4);
- * paintGlowPixels(pixels, size, { color: 0xff0000, radius: 2, intensity: 1 });
- * console.log(pixels[0] > pixels[pixels.length - 4]); // true - the centre burns redder than the rim
- * ```
- */
-export function paintGlowPixels(pixels, size, paint) {
-    if (!Number.isInteger(size) || size < 1) {
-        throw new RangeError(`a glow needs an integer size of at least 1, saw ${size}`);
-    }
-    if (!(pixels instanceof Uint8Array || pixels instanceof Uint8ClampedArray) || pixels.length !== size * size * 4) {
-        throw new RangeError(`a glow needs a pixel buffer of ${size * size * 4} bytes`);
-    }
-    if (!Number.isFinite(paint.radius) || paint.radius <= 0) {
-        throw new RangeError(`a glow needs a radius above 0, saw ${paint.radius}`);
-    }
-    if (!Number.isFinite(paint.intensity) || paint.intensity < 0 || paint.intensity > 1) {
-        throw new RangeError(`a glow needs intensity between 0 and 1, saw ${paint.intensity}`);
-    }
-    const [r, g, b] = splitColor(paint.color);
-    const centre = (size - 1) / 2;
-    for (let y = 0; y < size; y++) {
-        for (let x = 0; x < size; x++) {
-            const light = glowFalloff(Math.hypot(x - centre, y - centre), paint.radius) * paint.intensity;
-            pixels.set([Math.round(r * light), Math.round(g * light), Math.round(b * light), Math.round(255 * light)], (y * size + x) * 4);
-        }
-    }
-}
-/**
- * A soft neon glow from a shape or mask: a radial sprite drawn additively, the overlay
- * `Halo` already provides, with colour, radius, intensity and flicker (roadmap 426). A
- * global bloom stays out on purpose: one sprite per sign is cheaper, composes with
- * z-order like any other sprite, and never washes the whole scene. Mask a glow by
- * parenting it under the shape it lights, or leave it bare for a free halo around a sign.
- * Needs a DOM canvas; `paintGlowPixels` is the same falloff without one.
- *
- * @example
- * ```ts
- * import { NeonGlow } from '@datamoc/mw_games/two-d/render';
- *
- * const sign = new NeonGlow({ color: 0x37e0ff, radius: 48, flicker: { amount: 0.15, frequency: 2 } });
- * sign.position.set(200, 120);
- * sign.update(1 / 60); // the tube breathes; under reduced motion it holds steady instead
- * ```
- */
-export class NeonGlow extends Sprite {
-    constructor(options) {
-        if (!Number.isFinite(options.radius) || options.radius <= 0) {
-            throw new RangeError(`a glow needs a radius above 0, saw ${options.radius}`);
-        }
-        const intensity = options.intensity ?? 1;
-        if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1) {
-            throw new RangeError(`a glow needs intensity between 0 and 1, saw ${intensity}`);
-        }
-        const flicker = options.flicker ?? { amount: 0, frequency: 1 };
-        if (!Number.isFinite(flicker.amount) || flicker.amount < 0 || flicker.amount > 1) {
-            throw new RangeError(`a glow needs a flicker amount between 0 and 1, saw ${flicker.amount}`);
-        }
-        if (!Number.isFinite(flicker.frequency) || flicker.frequency <= 0) {
-            throw new RangeError(`a glow needs a flicker frequency above 0, saw ${flicker.frequency}`);
-        }
-        //paintCanvas validates the colour through paintGlowPixels before super() runs
-        const canvas = NeonGlow.paintCanvas(options.color, options.radius);
-        super(Texture.from(canvas));
-        this.clock = 0;
-        this.canvas = canvas;
-        this.color = options.color;
-        this.radius = options.radius;
-        this.peak = intensity;
-        this.flickerAmount = flicker.amount;
-        this.flickerFrequency = flicker.frequency;
-        this.intent = options.intent ?? 'decorative';
-        //additive like Halo: light adds, never covers
-        this.blendMode = 'add';
-        this.anchor.set(0.5);
-        this.eventMode = 'none';
-        this.alpha = this.peak;
-    }
-    /** seconds of flicker accumulated so far */
-    get elapsed() {
-        return this.clock;
-    }
-    /** swap the colour; repaints once */
-    setColor(color) {
-        splitColor(color);
-        this.color = color;
-        this.repaint();
-    }
-    /** swap the radius; repaints once */
-    setRadius(radius) {
-        if (!Number.isFinite(radius) || radius <= 0) {
-            throw new RangeError(`a glow needs a radius above 0, saw ${radius}`);
-        }
-        this.radius = radius;
-        this.repaint();
-    }
-    /** swap the peak strength; applies on the next `update` without a repaint */
-    setIntensity(intensity) {
-        if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1) {
-            throw new RangeError(`a glow needs intensity between 0 and 1, saw ${intensity}`);
-        }
-        this.peak = intensity;
-    }
-    /** advance the flicker; under reduced motion a decorative glow holds its peak instead */
-    update(dt) {
-        if (!Number.isFinite(dt) || dt < 0) {
-            throw new RangeError(`a glow update needs dt of at least 0, saw ${dt}`);
-        }
-        if (!reducedMotion() || this.intent !== 'decorative')
-            this.clock += dt;
-        const wave = 1 + this.flickerAmount * Math.sin(2 * Math.PI * this.flickerFrequency * this.clock);
-        this.alpha = clamp(this.peak * wave, 0, 1);
-    }
-    static paintCanvas(color, radius) {
-        const size = Math.ceil(radius) * 2 + 1;
-        const canvas = document.createElement('canvas');
-        canvas.width = size;
-        canvas.height = size;
-        const context = canvas.getContext('2d');
-        if (!context)
-            throw new Error('NeonGlow needs a 2D canvas context');
-        const image = context.createImageData(size, size);
-        paintGlowPixels(image.data, size, { color, radius, intensity: 1 });
-        context.putImageData(image, 0, 0);
-        return canvas;
-    }
-    repaint() {
-        //a radius change resizes the canvas, so the texture is rebuilt rather than updated
-        const old = this.texture;
-        this.canvas = NeonGlow.paintCanvas(this.color, this.radius);
-        this.texture = Texture.from(this.canvas);
-        old.destroy(true);
-    }
-    /** the texture is generated for this glow alone, so it goes with it */
-    destroy() {
-        super.destroy({ texture: true, textureSource: true });
-    }
-}
-//# sourceMappingURL=NeonGlow.js.map

package/dist/two-d/render/NeonGlow.js.map

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

package/dist/two-d/render/PaletteRemap.d.ts

@@ -1,154 +0,0 @@
-import { Texture } from 'pixi.js';
-/** A source palette colour and the colour it should become, both `0xRRGGBB`. */
-export interface PaletteMapping {
-    readonly from: readonly number[];
-    readonly to: readonly number[];
-}
-/**
- * How a pixel that is not an exact `from` colour is treated. `'exact'` (the default for
- * `remapPixels`/`recolorTexture`) leaves it untouched - the correct behaviour for a discrete
- * swap like `~RC`/`~PAL`, and for a `paletteRangeMapping` over a reference palette, where the
- * pixels that are not in the palette are the ones the artists deliberately left alone (shading,
- * outlines, anti-aliased edges). `'nearest'` repaints every opaque pixel with whichever `from`
- * entry it is closest to, which is what a palette that covers the whole image wants - a dense
- * generated ramp where every pixel is meant to be recoloured. Using `'nearest'` with a sparse
- * `from` list (an `~RC` pair or two, a three-colour reference palette) repaints the entire image
- * toward whichever entry happens to be closest, which is the bug this mode exists to prevent.
- */
-export type PaletteRemapMode = 'exact' | 'nearest';
-/**
- * The three-stop gradient a team colour (or any palette range) is built from. `mid` is the
- * shade the reference's own anchor colour becomes, `min` the one at the dark end of the range
- * and `max` the one at the bright end.
- */
-export interface PaletteRange {
-    readonly min: number;
-    readonly mid: number;
-    readonly max: number;
-}
-/**
- * Builds a `PaletteMapping` that recolours every entry of `reference` into a shade of the
- * `min -> mid -> max` gradient, the shape a team colour or any other `[color_range]`-style
- * remap is defined by. `reference` is the exact list of colours the art was painted with, so
- * pixels outside it - anti-aliased edges, shading, outlines - are left alone by an `'exact'`
- * remap, which is the mode this pairs with.
- *
- * The reference's *first* entry is its anchor, and it is the one colour whose shade is fixed by
- * the range alone: it becomes `mid`. Every other entry is placed by its own brightness rather
- * than by its position, so the *rest* of the list needs no order - a darker entry blends towards
- * `min` and a brighter one towards `max`, each in proportion to how its average compares with
- * the anchor's. That is what lets one mapping reproduce art as shaded as the reference it was
- * painted from, and what the first entry has to be: the base shade the art was built around.
- *
- * Brightness and the blend are computed the way the engine they mirror does, a floored integer
- * average and a truncated blend, which is what makes the shades equal the engine's byte for byte
- * rather than merely close. The engine's own black-and-white special cases fall out of the two
- * branches here rather than being spelled out: an anchor with an average of 0 has no ratio to
- * divide by, so every entry takes the brighter branch and `mid` is the top of the scale instead
- * of the middle of it, and a white anchor is at least as bright as everything, so every entry
- * takes the darker one.
- *
- * @example
- * ```ts
- * import { paletteRangeMapping, recolorTexture } from '@datamoc/mw_games/two-d/render';
- * import type { Texture2D } from '@datamoc/mw_games/two-d/render';
- *
- * declare const texture: Texture2D;
- * declare const magentaReference: readonly number[]; // the exact colours the art was painted with
- *
- * const redTeam = paletteRangeMapping(magentaReference, { min: 0x000000, mid: 0xff0000, max: 0xffffff });
- * const recolored = recolorTexture(texture, redTeam); // 'exact': only those pixels are repainted
- * ```
- */
-export declare function paletteRangeMapping(reference: readonly number[], range: PaletteRange): PaletteMapping;
-/**
- * The renderer-free core of a palette remap. In `'exact'` mode (the default) a pixel is
- * repainted only when it exactly matches one of `mapping.from`; every other pixel, including
- * one close but not identical to a `from` colour, passes through unchanged. In `'nearest'` mode
- * every opaque pixel is repainted with the `to` colour of whichever `from` entry it is nearest
- * to in RGB space. Alpha and fully transparent pixels are always left untouched. Exported on
- * its own so the remap logic is unit-testable without a canvas or a texture.
- *
- * @example
- * ```ts
- * import { remapPixels } from '@datamoc/mw_games/two-d/render';
- *
- * const pixels = new Uint8ClampedArray([255, 0, 255, 255, 10, 10, 10, 255]); // magenta, then dark grey
- * const out = remapPixels(pixels, { from: [0xff00ff], to: [0xff0000] }); // 'exact' by default
- * console.log([...out.slice(0, 4)]); // [255, 0, 0, 255] - the exact match repainted
- * console.log([...out.slice(4, 8)]); // [10, 10, 10, 255] - not a match, left alone
- * ```
- */
-export declare function remapPixels(pixels: Uint8ClampedArray, mapping: PaletteMapping, mode?: PaletteRemapMode): Uint8ClampedArray;
-/** The subset of `CanvasRenderingContext2D` a palette remap needs, so a test can fake it. */
-export interface RemapCanvasContext {
-    drawImage(image: unknown, dx: number, dy: number): void;
-    getImageData(sx: number, sy: number, sw: number, sh: number): {
-        data: Uint8ClampedArray;
-    };
-    putImageData(imageData: {
-        data: Uint8ClampedArray;
-        width: number;
-        height: number;
-    }, dx: number, dy: number): void;
-}
-export interface RemapCanvas {
-    width: number;
-    height: number;
-    getContext(kind: '2d'): RemapCanvasContext | null;
-}
-export interface RecolorProbe {
-    createCanvas?(width: number, height: number): RemapCanvas | null;
-}
-/**
- * Opens a canvas the size of `texture`, draws it in, and hands the 2D context to `paint` to
- * make whatever further edits it needs (a palette remap, a composited overlay, a rewritten
- * alpha channel); the result becomes the returned `Texture`. Shared by every texture-level
- * image modifier (`recolorTexture` here, `~BLIT`/`~MASK`/`~BLEND` in `ImageModifiers.ts`) so
- * each one only has to write its own pixel or compositing logic, not the canvas bookkeeping.
- * Returns `texture` unchanged if there is no usable 2D canvas.
- *
- * @example
- * ```ts
- * import { withTextureCanvas } from '@datamoc/mw_games/two-d/render';
- * import type { Texture2D } from '@datamoc/mw_games/two-d/render';
- *
- * declare const texture: Texture2D;
- *
- * // a minimal custom modifier: invert every pixel's RGB, alpha untouched
- * const inverted = withTextureCanvas(texture, {}, (context, width, height) => {
- * 	const { data } = context.getImageData(0, 0, width, height);
- * 	for (let i = 0; i < data.length; i += 4) {
- * 		data[i] = 255 - data[i];
- * 		data[i + 1] = 255 - data[i + 1];
- * 		data[i + 2] = 255 - data[i + 2];
- * 	}
- * 	context.putImageData({ data, width, height }, 0, 0);
- * });
- * ```
- */
-export declare function withTextureCanvas(texture: Texture, probe: RecolorProbe, paint: (context: RemapCanvasContext, width: number, height: number) => void): Texture;
-/**
- * Recolours a texture by palette remap: draws it to a canvas, runs `remapPixels` over the raw
- * pixel data, and returns a new `Texture` wrapping the result. The source texture is never
- * mutated, so the same base art recolours per team without extra copies kept around by the
- * caller. Needs a real 2D canvas context (unlike `remapPixels` itself), so pass `probe` in a
- * test or host integration with no DOM; omitting it uses `document.createElement('canvas')`.
- *
- * `mode` defaults to `'exact'`, correct for a discrete swap (`~RC`/`~PAL`'s short, specific
- * `from` list); a `paletteRangeMapping` gradient, meant to cover the whole reference palette a
- * team's art is drawn against, wants `'nearest'` instead - see `PaletteRemapMode`'s own doc for
- * why the wrong choice silently recolours far more of the image than intended.
- *
- * @example
- * ```ts
- * import { paletteRangeMapping, recolorTexture } from '@datamoc/mw_games/two-d/render';
- * import type { Texture2D } from '@datamoc/mw_games/two-d/render';
- *
- * declare const texture: Texture2D;
- * const mapping = paletteRangeMapping([0xffffff, 0x808080, 0x000000], { min: 0xffe0e0, mid: 0xc00000, max: 0x400000 });
- * const redTeam = recolorTexture(texture, mapping, {}, 'nearest');
- * ```
- */
-export declare function recolorTexture(texture: Texture, mapping: PaletteMapping, probe?: RecolorProbe, mode?: PaletteRemapMode): Texture;
-//# sourceMappingURL=PaletteRemap.d.ts.map

package/dist/two-d/render/PaletteRemap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PaletteRemap.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/PaletteRemap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,CAUrG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,gBAA0B,GAC9B,iBAAiB,CA4CnB;AAED,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,iBAAiB,CAAA;KAAE,CAAC;IAC1F,YAAY,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,iBAAiB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAClH;AAED,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACzE,OAAO,CAkCT;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,KAAK,GAAE,YAAiB,EACxB,IAAI,GAAE,gBAA0B,GAC9B,OAAO,CAMT"}