@datamoc/mw_games 0.44.2 → 0.45.0

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

@@ -1,193 +0,0 @@
-import { Easing, Tweener } from '../../core/Tween.js';
-import { reducedMotion } from '../../core/Motion.js';
-const NONE = { scaleX: 1, scaleY: 1, dy: 0, rotation: 0, skewX: 0 };
-const INERT = { done: Promise.resolve(), cancel() { } };
-/**
- * Squash, hop, bob, wobble, spin, shear and flip over a display object's transform, each
- * running through a `Tweener` so reduced motion is honoured once, here, instead of by every
- * game's own `scale`/`Math.sin` write.
- *
- * The object's transform at construction is its rest pose. Every running effect keeps its own
- * contribution and the transform is recomputed from the rest pose and all contributions, so
- * effects compose (a hop with a squash) and never accumulate drift: when one ends, is
- * cancelled, or the whole motion is destroyed, its share simply disappears. Rotation and
- * shear turn about the object's origin, so give a sprite a centred anchor (or pivot) first.
- * Sequence effects behind a game event by awaiting a handle's `done`.
- *
- * Which effect plays on which event, and how much, is the game's business; this only moves.
- *
- * @example
- * ```ts
- * import { SpriteMotion } from '@datamoc/mw_games/two-d/render';
- *
- * const rat = { x: 0, y: 0, rotation: 0, scale: { x: 1, y: 1 }, skew: { x: 0, y: 0 } };
- * const motion = new SpriteMotion(rat);
- *
- * motion.hop({ height: 6, duration: 0.3 }); // up and back down
- * motion.squash({ amount: 0.2, duration: 0.3 }); // composes with the hop
- * motion.flip('x'); // face the other way, composes with both
- * motion.update(1 / 60); // in the game loop
- *
- * motion.destroy(); // back to the rest pose, flip included
- * ```
- */
-export class SpriteMotion {
-    constructor(target, options = {}) {
-        this.contributions = new Map();
-        this.loops = new Set();
-        this.nextId = 0;
-        this.flipX = false;
-        this.flipY = false;
-        this.destroyed = false;
-        this.target = target;
-        this.tweener = options.tweener ?? new Tweener();
-        this.ownsTweener = options.tweener === undefined;
-        this.intent = options.intent ?? 'decorative';
-        this.rest = {
-            y: target.y,
-            rotation: target.rotation,
-            scaleX: target.scale.x,
-            scaleY: target.scale.y,
-            skewX: target.skew.x,
-        };
-    }
-    /** scale x and y in opposition and back: `amount` 0.2 is 20% wider and 20% shorter at the peak */
-    squash(options) {
-        const { amount, duration } = options;
-        return this.run(duration, (t) => {
-            const s = Math.sin(Math.PI * t) * amount;
-            return { scaleX: 1 + s, scaleY: 1 - s };
-        });
-    }
-    /** up `height` world units and back down (the rest pose is the ground) */
-    hop(options) {
-        const { height, duration } = options;
-        return this.run(duration, (t) => ({ dy: -Math.sin(Math.PI * t) * height }));
-    }
-    /**
-     * A sinusoidal vertical offset of `amplitude`. With `cycles` it plays that many periods and
-     * ends; without, it loops until cancelled (breathing, a floating item). Under reduced motion
-     * a looping bob holds still.
-     */
-    bob(options) {
-        const { amplitude, period, cycles } = options;
-        if (cycles !== undefined) {
-            return this.run(period * cycles, (t) => ({ dy: Math.sin(2 * Math.PI * cycles * t) * amplitude }));
-        }
-        return this.loop((elapsed) => ({ dy: Math.sin((2 * Math.PI * elapsed) / period) * amplitude }));
-    }
-    /** swings `angle` radians either side and settles, a jiggle that dies away */
-    wobble(options) {
-        const { angle, duration } = options;
-        return this.run(duration, (t) => ({ rotation: Math.sin(4 * Math.PI * t) * (1 - t) * angle }));
-    }
-    /** `turns` full turns about the origin, eased, ending exactly where it started */
-    spin(options) {
-        const { turns, duration } = options;
-        return this.run(duration, (t) => ({ rotation: Math.PI * 2 * turns * t }), Easing.easeInOutQuad);
-    }
-    /** leans by `amount` radians of skew and back, a hit-recoil or a lean into a step */
-    shear(options) {
-        const { amount, duration } = options;
-        return this.run(duration, (t) => ({ skewX: Math.sin(Math.PI * t) * amount }));
-    }
-    /**
-     * Mirrors along `axis` ('x' turns left to right). A state, not an animation: it composes
-     * with whatever is running and is undone by `destroy`. Pass `mirrored` to set it outright
-     * rather than toggle; returns the new state.
-     */
-    flip(axis, mirrored) {
-        if (axis === 'x')
-            this.flipX = mirrored ?? !this.flipX;
-        else
-            this.flipY = mirrored ?? !this.flipY;
-        this.write();
-        return axis === 'x' ? this.flipX : this.flipY;
-    }
-    /** advances the effects; call from the game loop (the tweener part is skipped for a shared one) */
-    update(dt) {
-        if (this.ownsTweener)
-            this.tweener.update(dt);
-        for (const advance of [...this.loops])
-            advance(dt);
-    }
-    /** true while any effect is still running */
-    get isBusy() {
-        return this.contributions.size > 0;
-    }
-    /** cancels every effect and puts the object back in its rest pose, flips included */
-    destroy() {
-        this.destroyed = true;
-        this.contributions.clear();
-        this.loops.clear();
-        this.flipX = this.flipY = false;
-        this.write();
-    }
-    run(duration, shape, ease = Easing.linear) {
-        if (this.destroyed)
-            return INERT;
-        const id = this.nextId++;
-        const finish = () => {
-            this.contributions.delete(id);
-            this.write();
-        };
-        this.contributions.set(id, NONE);
-        const done = this.tweener
-            .tween(duration, (t) => {
-            //a cancelled effect's tween still ticks to its end; it must not write again
-            if (!this.contributions.has(id))
-                return;
-            this.contributions.set(id, { ...NONE, ...shape(t) });
-            this.write();
-        }, { ease, intent: this.intent })
-            .then(finish);
-        return { done, cancel: finish };
-    }
-    loop(shape) {
-        if (this.destroyed)
-            return INERT;
-        const id = this.nextId++;
-        let elapsed = 0;
-        let resolve;
-        const done = new Promise((r) => (resolve = r));
-        const advance = (dt) => {
-            elapsed += dt;
-            //a decorative loop has no reason to move once the preference is on
-            const held = reducedMotion() && this.intent === 'decorative';
-            this.contributions.set(id, held ? NONE : { ...NONE, ...shape(elapsed) });
-            this.write();
-        };
-        this.contributions.set(id, NONE);
-        this.loops.add(advance);
-        return {
-            done,
-            cancel: () => {
-                this.loops.delete(advance);
-                this.contributions.delete(id);
-                this.write();
-                resolve();
-            },
-        };
-    }
-    write() {
-        let scaleX = 1;
-        let scaleY = 1;
-        let dy = 0;
-        let rotation = 0;
-        let skewX = 0;
-        for (const c of this.contributions.values()) {
-            scaleX *= c.scaleX;
-            scaleY *= c.scaleY;
-            dy += c.dy;
-            rotation += c.rotation;
-            skewX += c.skewX;
-        }
-        const { rest, target } = this;
-        target.y = rest.y + dy;
-        target.rotation = rest.rotation + rotation;
-        target.scale.x = rest.scaleX * scaleX * (this.flipX ? -1 : 1);
-        target.scale.y = rest.scaleY * scaleY * (this.flipY ? -1 : 1);
-        target.skew.x = rest.skewX + skewX;
-    }
-}
-//# sourceMappingURL=SpriteMotion.js.map

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

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

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

@@ -1,62 +0,0 @@
-import { type TextureRegion, type Texture2D } from './Types2D.ts';
-/**
- * A texture cut into numbered frames.
- *
- * Nearly every sheet in a tile-based game is a regular grid, so `grid` covers the common
- * case and `name` labels the frames that matter. Frames are cut once and cached: asking
- * for the same index twice returns the same Texture, so sprites sharing a frame also share
- * a texture and stay in one batch.
- *
- * The rest are not grids at all: a hand-packed icon atlas, a strip of bar segments, a
- * nine-patch's corners. Those declare their own rectangles with `rect`, and the sheet is
- * built with no frame size, which leaves it with no grid and only the frames declared.
- */
-export declare class SpriteSheet {
-    readonly texture: Texture2D;
-    readonly frameWidth: number;
-    readonly frameHeight: number;
-    readonly columns: number;
-    readonly rows: number;
-    private frames;
-    private names;
-    private constructor();
-    /**
-     * Cuts a loaded texture into a grid, numbered left to right then top to bottom, or, with
-     * no frame size, leaves the sheet with no grid for `rect` to fill in.
-     *
-     * @param path the asset path the texture was loaded with
-     */
-    static grid(path: string, frameWidth?: number, frameHeight?: number): SpriteSheet;
-    /**
-     * A horizontal strip of `frames` equal frames, the frame size taken from the texture: for
-     * packs whose sheets differ in size, where a hand-kept table of frame sizes goes stale.
-     */
-    static strip(path: string, frames: number): SpriteSheet;
-    static fromTexture(texture: Texture2D, frameWidth?: number, frameHeight?: number): SpriteSheet;
-    get count(): number;
-    /** gives a frame a name, so game code reads `sheet.get('door')` rather than `sheet.get(6)` */
-    name(name: string, index: number): this;
-    /** names several frames at once, from a plain object of name to index */
-    nameAll(names: Readonly<Record<string, number>>): this;
-    indexOf(name: string): number;
-    get(frame: number | string): Texture2D;
-    /**
-     * Cuts an arbitrary rectangle out of the texture, for a sheet that is not a grid: one
-     * hand-packed icon, two banner frames, the corners of a nine-patch.
-     *
-     * The rectangle is cached under `index` exactly like a grid frame, so `get`, `region`,
-     * `name` and `pick` all treat it as a frame and asking for it twice returns the same
-     * `Texture` rather than cutting a second one. Declaring a rect for an index the grid
-     * also covers replaces that frame, which is what a tightened sub-rect of a cell is:
-     * an item whose art is smaller than its 16 by 16 cell keeps its index and its name.
-     */
-    rect(index: number, x: number, y: number, width: number, height: number): this;
-    /** the texture and frame rectangle together, as plain MWG types rather than `pixi.js`'s
-     * `Texture`/`Rectangle` - for a game that needs the geometry, not just the cut texture */
-    region(frame: number | string): TextureRegion;
-    /** a run of consecutive frames, the usual way an animation is laid out */
-    range(from: number, to: number): Texture2D[];
-    /** specific frames, for an animation that holds or ping-pongs */
-    pick(...frames: Array<number | string>): Texture2D[];
-}
-//# sourceMappingURL=SpriteSheet.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"SpriteSheet.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/SpriteSheet.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,KAAK,CAA6B;IAE1C,OAAO,eAaN;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,SAAI,EAAE,WAAW,SAAa,GAAG,WAAW,CAE/E;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAItD;IAED,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,SAAI,EAAE,WAAW,SAAa,GAAG,WAAW,CAE5F;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,8FAA8F;IAC9F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGtC;IAED,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAGrD;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5B;IAED,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsBrC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI7E;IAED;8FAC0F;IAC1F,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAG5C;IAED,0EAA0E;IAC1E,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,CAI3C;IAED,iEAAiE;IACjE,IAAI,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,EAAE,CAEnD;CACD"}

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

@@ -1,122 +0,0 @@
-import { Rectangle, Texture } from 'pixi.js';
-import * as Resources from '../../assets/index.js';
-import { rectOf } from './Types2D.js';
-/**
- * A texture cut into numbered frames.
- *
- * Nearly every sheet in a tile-based game is a regular grid, so `grid` covers the common
- * case and `name` labels the frames that matter. Frames are cut once and cached: asking
- * for the same index twice returns the same Texture, so sprites sharing a frame also share
- * a texture and stay in one batch.
- *
- * The rest are not grids at all: a hand-packed icon atlas, a strip of bar segments, a
- * nine-patch's corners. Those declare their own rectangles with `rect`, and the sheet is
- * built with no frame size, which leaves it with no grid and only the frames declared.
- */
-export class SpriteSheet {
-    constructor(texture, frameWidth, frameHeight) {
-        this.frames = new Map();
-        this.names = new Map();
-        this.texture = texture;
-        this.frameWidth = frameWidth;
-        this.frameHeight = frameHeight;
-        this.columns = frameWidth > 0 ? Math.floor(texture.width / frameWidth) : 0;
-        this.rows = frameHeight > 0 ? Math.floor(texture.height / frameHeight) : 0;
-        //a frame size that does not divide the sheet cuts every frame after the first from the
-        //wrong place: silent distortion, so say it once, at construction
-        if (frameWidth > 0 && (texture.width % frameWidth !== 0 || texture.height % frameHeight !== 0)) {
-            console.warn(`sprite sheet ${texture.width}x${texture.height} is not a whole number of ${frameWidth}x${frameHeight} frames; the frames will be cut from the wrong places`);
-        }
-    }
-    /**
-     * Cuts a loaded texture into a grid, numbered left to right then top to bottom, or, with
-     * no frame size, leaves the sheet with no grid for `rect` to fill in.
-     *
-     * @param path the asset path the texture was loaded with
-     */
-    static grid(path, frameWidth = 0, frameHeight = frameWidth) {
-        return new SpriteSheet(Resources.texture(path), frameWidth, frameHeight);
-    }
-    /**
-     * A horizontal strip of `frames` equal frames, the frame size taken from the texture: for
-     * packs whose sheets differ in size, where a hand-kept table of frame sizes goes stale.
-     */
-    static strip(path, frames) {
-        if (!(frames > 0))
-            throw new Error('a sprite strip needs at least one frame');
-        const texture = Resources.texture(path);
-        return new SpriteSheet(texture, texture.width / frames, texture.height);
-    }
-    static fromTexture(texture, frameWidth = 0, frameHeight = frameWidth) {
-        return new SpriteSheet(texture, frameWidth, frameHeight);
-    }
-    get count() {
-        return this.columns * this.rows;
-    }
-    /** gives a frame a name, so game code reads `sheet.get('door')` rather than `sheet.get(6)` */
-    name(name, index) {
-        this.names.set(name, index);
-        return this;
-    }
-    /** names several frames at once, from a plain object of name to index */
-    nameAll(names) {
-        for (const [key, index] of Object.entries(names))
-            this.names.set(key, index);
-        return this;
-    }
-    indexOf(name) {
-        const index = this.names.get(name);
-        if (index === undefined)
-            throw new Error(`this sheet has no frame named "${name}"`);
-        return index;
-    }
-    get(frame) {
-        const index = typeof frame === 'string' ? this.indexOf(frame) : frame;
-        const cached = this.frames.get(index);
-        if (cached)
-            return cached;
-        if (index < 0 || index >= this.count) {
-            throw new Error(`frame ${index} is outside this sheet, which holds ${this.count}`);
-        }
-        const texture = new Texture({
-            source: this.texture.source,
-            frame: new Rectangle((index % this.columns) * this.frameWidth, Math.floor(index / this.columns) * this.frameHeight, this.frameWidth, this.frameHeight),
-        });
-        this.frames.set(index, texture);
-        return texture;
-    }
-    /**
-     * Cuts an arbitrary rectangle out of the texture, for a sheet that is not a grid: one
-     * hand-packed icon, two banner frames, the corners of a nine-patch.
-     *
-     * The rectangle is cached under `index` exactly like a grid frame, so `get`, `region`,
-     * `name` and `pick` all treat it as a frame and asking for it twice returns the same
-     * `Texture` rather than cutting a second one. Declaring a rect for an index the grid
-     * also covers replaces that frame, which is what a tightened sub-rect of a cell is:
-     * an item whose art is smaller than its 16 by 16 cell keeps its index and its name.
-     */
-    rect(index, x, y, width, height) {
-        if (width <= 0 || height <= 0)
-            throw new Error('a sprite sheet rect needs a positive width and height');
-        this.frames.set(index, new Texture({ source: this.texture.source, frame: new Rectangle(x, y, width, height) }));
-        return this;
-    }
-    /** the texture and frame rectangle together, as plain MWG types rather than `pixi.js`'s
-     * `Texture`/`Rectangle` - for a game that needs the geometry, not just the cut texture */
-    region(frame) {
-        const texture = this.get(frame);
-        return { texture, frame: rectOf(texture.frame) };
-    }
-    /** a run of consecutive frames, the usual way an animation is laid out */
-    range(from, to) {
-        const out = [];
-        for (let i = from; i <= to; i++)
-            out.push(this.get(i));
-        return out;
-    }
-    /** specific frames, for an animation that holds or ping-pongs */
-    pick(...frames) {
-        return frames.map((frame) => this.get(frame));
-    }
-}
-//# sourceMappingURL=SpriteSheet.js.map

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

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

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

@@ -1,86 +0,0 @@
-export interface TintTarget {
-    /** the packed additive colour, the same field `TintedSprite.colorAdd` is */
-    colorAdd: number;
-}
-export interface StatusVisualStyle {
-    /** colour this status contributes on top of every other active one */
-    color: number;
-    /** 0..1, how strongly this status's colour contributes at full intensity; defaults to 0.5 */
-    strength?: number;
-    /** cycles per second the strength oscillates between 0 and `strength`; omit for a steady contribution */
-    pulseRate?: number;
-}
-export interface StatusVisualsOptions {
-    /** each active status's own contribution; no ordering meaning, since every active one composes */
-    styles: Record<string, StatusVisualStyle>;
-}
-/**
- * Turns a set of active status-effect names into one additive colour on a sprite, so a game's
- * own `actors.applyStatusEffect` handles - which know nothing about rendering - can drive what
- * a character looks like without either side importing the other.
- *
- * Every active status composes over the additive channel (`TintedSprite.colorAdd`) rather than
- * one winning by declaration order: poisoned-and-burning sums both colours (each channel
- * clamped to 1, so an oversaturated combination clips rather than wrapping), instead of only
- * the first-declared style showing. This class never touches the multiply `tint`, so a
- * sprite's own identity tint (a team colour, say) rides underneath untouched - the composition
- * this class's own earlier version could not do, because writing both halves of `lerpTint` per
- * update meant the last status checked always overwrote whatever tint a caller had set. A
- * one-shot `flash` (a damage hit, a heal glow) layers its own decaying contribution on top of
- * whatever statuses are active, rather than needing a caller to juggle a separate colour write.
- *
- * `target` is any object shaped like `TintedSprite`'s own `colorAdd` field - duck-typed the way
- * `Projectile` takes a plain `{x, y}` rather than a real Pixi `Sprite`, so this is fully
- * testable without Pixi and works on any sprite subclass that exposes the same field.
- *
- * @example
- * ```ts
- * import { StatusVisuals, TintedSprite, type Texture2D } from '@datamoc/mw_games/two-d/render';
- *
- * declare const ratTexture: Texture2D;
- * const rat = new TintedSprite(ratTexture);
- * rat.tint = 0x8080ff; // a team colour, untouched by anything below
- *
- * const visuals = new StatusVisuals(rat, {
- * 	styles: {
- * 		poisoned: { color: 0x00ff00, strength: 0.5 },
- * 		burning: { color: 0xff6600, strength: 0.6, pulseRate: 2 },
- * 	},
- * });
- *
- * visuals.set('poisoned', true);
- * visuals.set('burning', true);
- * visuals.update(1 / 60); // both colours composed into rat.colorAdd; rat.tint is untouched
- * console.log(visuals.has('poisoned')); // true
- *
- * visuals.flash(0xffffff, 0.8, 0.2); // a bright hit-flash, decaying over 0.2s
- * visuals.update(1 / 60);
- *
- * visuals.set('poisoned', false);
- * visuals.set('burning', false);
- * visuals.update(1 / 60); // no status or flash left active: colorAdd back to 0
- * ```
- */
-export declare class StatusVisuals {
-    private target;
-    private styles;
-    private active;
-    private elapsed;
-    private flashColor;
-    private flashStrength;
-    private flashDuration;
-    private flashRemaining;
-    constructor(target: TintTarget, options: StatusVisualsOptions);
-    /** marks `kind` active or inactive; a `kind` with no matching style is tracked but never shown */
-    set(kind: string, active: boolean): void;
-    has(kind: string): boolean;
-    /**
-     * Layers a transient additive pulse on top of whatever statuses are active, linearly
-     * decaying `strength` to zero over `duration` seconds - a damage hit or a heal glow that
-     * needs no status of its own and no caller-managed timer.
-     */
-    flash(color: number, strength: number, duration: number): void;
-    /** advances any pulsing style and the flash decay, and repaints the sprite's additive channel */
-    update(dt: number): void;
-}
-//# sourceMappingURL=StatusVisuals.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"StatusVisuals.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/StatusVisuals.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IAC1B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACpC,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAK;IAE3B,YAAY,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,EAG5D;IAED,kGAAkG;IAClG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAGvC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK7D;IAED,iGAAiG;IACjG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CA6BvB;CACD"}

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

@@ -1,111 +0,0 @@
-import { packColorAdd } from './ColorTransformBatcher.js';
-/**
- * Turns a set of active status-effect names into one additive colour on a sprite, so a game's
- * own `actors.applyStatusEffect` handles - which know nothing about rendering - can drive what
- * a character looks like without either side importing the other.
- *
- * Every active status composes over the additive channel (`TintedSprite.colorAdd`) rather than
- * one winning by declaration order: poisoned-and-burning sums both colours (each channel
- * clamped to 1, so an oversaturated combination clips rather than wrapping), instead of only
- * the first-declared style showing. This class never touches the multiply `tint`, so a
- * sprite's own identity tint (a team colour, say) rides underneath untouched - the composition
- * this class's own earlier version could not do, because writing both halves of `lerpTint` per
- * update meant the last status checked always overwrote whatever tint a caller had set. A
- * one-shot `flash` (a damage hit, a heal glow) layers its own decaying contribution on top of
- * whatever statuses are active, rather than needing a caller to juggle a separate colour write.
- *
- * `target` is any object shaped like `TintedSprite`'s own `colorAdd` field - duck-typed the way
- * `Projectile` takes a plain `{x, y}` rather than a real Pixi `Sprite`, so this is fully
- * testable without Pixi and works on any sprite subclass that exposes the same field.
- *
- * @example
- * ```ts
- * import { StatusVisuals, TintedSprite, type Texture2D } from '@datamoc/mw_games/two-d/render';
- *
- * declare const ratTexture: Texture2D;
- * const rat = new TintedSprite(ratTexture);
- * rat.tint = 0x8080ff; // a team colour, untouched by anything below
- *
- * const visuals = new StatusVisuals(rat, {
- * 	styles: {
- * 		poisoned: { color: 0x00ff00, strength: 0.5 },
- * 		burning: { color: 0xff6600, strength: 0.6, pulseRate: 2 },
- * 	},
- * });
- *
- * visuals.set('poisoned', true);
- * visuals.set('burning', true);
- * visuals.update(1 / 60); // both colours composed into rat.colorAdd; rat.tint is untouched
- * console.log(visuals.has('poisoned')); // true
- *
- * visuals.flash(0xffffff, 0.8, 0.2); // a bright hit-flash, decaying over 0.2s
- * visuals.update(1 / 60);
- *
- * visuals.set('poisoned', false);
- * visuals.set('burning', false);
- * visuals.update(1 / 60); // no status or flash left active: colorAdd back to 0
- * ```
- */
-export class StatusVisuals {
-    constructor(target, options) {
-        this.active = new Set();
-        this.elapsed = 0;
-        this.flashColor = 0;
-        this.flashStrength = 0;
-        this.flashDuration = 0;
-        this.flashRemaining = 0;
-        this.target = target;
-        this.styles = options.styles;
-    }
-    /** marks `kind` active or inactive; a `kind` with no matching style is tracked but never shown */
-    set(kind, active) {
-        if (active)
-            this.active.add(kind);
-        else
-            this.active.delete(kind);
-    }
-    has(kind) {
-        return this.active.has(kind);
-    }
-    /**
-     * Layers a transient additive pulse on top of whatever statuses are active, linearly
-     * decaying `strength` to zero over `duration` seconds - a damage hit or a heal glow that
-     * needs no status of its own and no caller-managed timer.
-     */
-    flash(color, strength, duration) {
-        this.flashColor = color;
-        this.flashStrength = strength;
-        this.flashDuration = Math.max(duration, 1e-6);
-        this.flashRemaining = this.flashDuration;
-    }
-    /** advances any pulsing style and the flash decay, and repaints the sprite's additive channel */
-    update(dt) {
-        this.elapsed += dt;
-        if (this.flashRemaining > 0)
-            this.flashRemaining = Math.max(0, this.flashRemaining - dt);
-        let r = 0;
-        let g = 0;
-        let b = 0;
-        for (const kind of this.active) {
-            const style = this.styles[kind];
-            if (!style)
-                continue;
-            const peak = style.strength ?? 0.5;
-            const strength = style.pulseRate
-                ? peak * (0.5 + 0.5 * Math.sin(this.elapsed * style.pulseRate * Math.PI * 2))
-                : peak;
-            r += (((style.color >> 16) & 0xff) / 255) * strength;
-            g += (((style.color >> 8) & 0xff) / 255) * strength;
-            b += ((style.color & 0xff) / 255) * strength;
-        }
-        if (this.flashRemaining > 0) {
-            const flashT = this.flashRemaining / this.flashDuration;
-            const flashStrength = this.flashStrength * flashT;
-            r += (((this.flashColor >> 16) & 0xff) / 255) * flashStrength;
-            g += (((this.flashColor >> 8) & 0xff) / 255) * flashStrength;
-            b += ((this.flashColor & 0xff) / 255) * flashStrength;
-        }
-        this.target.colorAdd = packColorAdd(Math.min(1, r), Math.min(1, g), Math.min(1, b));
-    }
-}
-//# sourceMappingURL=StatusVisuals.js.map

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

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