@datamoc/mw_games 0.7.4 → 0.7.7

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

@@ -0,0 +1,60 @@
+/**
+ * Ties a second sprite's position to a first one's, with its own offset and its own optional
+ * lifetime - a shadow flat beneath a unit, a status icon floating above it, a shield glyph at a
+ * corner. `StatusVisuals` only tints a sprite that already exists; this is for a sprite that is
+ * its own thing, positioned relative to an owner rather than drawn as part of it.
+ *
+ * Renderer-neutral by the same design `Projectile` and `LightningArc` use: it takes any
+ * `{ x, y }` point (a real Pixi `Sprite`, a plain object, a test double) and only ever writes
+ * to it, so it needs no renderer to construct or test. Z-order and parenting stay the caller's,
+ * for the same reason `Halo` leaves them: whether a shadow is added before or after its unit is
+ * a per-game drawing decision, not something a framework should guess.
+ *
+ * @example
+ * ```ts
+ * import { SpriteAttachment } from '@datamoc/mw_games/two-d/render';
+ *
+ * declare const shadowSprite: { x: number; y: number };
+ * declare const statusIcon: { x: number; y: number };
+ *
+ * const shadow = new SpriteAttachment(shadowSprite, { offsetY: 4 });
+ * const poisoned = new SpriteAttachment(statusIcon, { offsetY: -20, duration: 3 });
+ *
+ * shadow.follow(100, 200);
+ * poisoned.follow(100, 200);
+ *
+ * const expired = poisoned.update(1 / 60);
+ * console.log(expired); // false - not yet 3 seconds in
+ * ```
+ */
+export class SpriteAttachment {
+    constructor(child, options = {}) {
+        this.elapsed = 0;
+        this.expired = false;
+        this.child = child;
+        this.offsetX = options.offsetX ?? 0;
+        this.offsetY = options.offsetY ?? 0;
+        this.duration = options.duration;
+    }
+    get done() {
+        return this.expired;
+    }
+    /** puts the attachment where its owner stands, with whatever offset it was built with */
+    follow(ownerX, ownerY) {
+        this.child.x = ownerX + this.offsetX;
+        this.child.y = ownerY + this.offsetY;
+        return this;
+    }
+    /** @returns true the instant `duration` elapses, so a caller can remove it exactly once; always false with no `duration` */
+    update(dt) {
+        if (this.expired || this.duration === undefined)
+            return false;
+        this.elapsed += dt;
+        if (this.elapsed >= this.duration) {
+            this.expired = true;
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=SpriteAttachment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteAttachment.js","sourceRoot":"","sources":["../../../src/two-d/render/SpriteAttachment.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,OAAO,gBAAgB;IAQ5B,YAAY,KAAsB,EAAE,OAAO,GAA4B,EAAE;QAHjE,YAAO,GAAG,CAAC,CAAC;QACZ,YAAO,GAAG,KAAK,CAAC;QAGvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,yFAAyF;IACzF,MAAM,CAAC,MAAc,EAAE,MAAc;QACpC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QACrC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,4HAA4H;IAC5H,MAAM,CAAC,EAAU;QAChB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC9D,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;YACpB,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

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

@@ -0,0 +1,142 @@
+import { Generator } from '../../core/Random.ts';
+/**
+ * One condition a rule tests against a neighbouring cell (or its own cell, at `dx=0, dy=0`):
+ * which flags that cell must carry, must not carry, or carry at least one of. `dx`/`dy` are in
+ * whatever unit the caller's grid uses - a square or isometric grid's own cell steps, or an
+ * axial hex offset for `hexRotate` - `resolveTerrainGraphics` never interprets them itself.
+ */
+export interface TerrainCondition {
+    readonly dx: number;
+    readonly dy: number;
+    readonly hasAll?: readonly string[];
+    readonly hasAny?: readonly string[];
+    readonly hasNone?: readonly string[];
+}
+/** One image a matched rule places, at an offset from the rule's own anchor cell. */
+export interface TerrainImage {
+    readonly image: string;
+    /** offset from the anchor cell, in the same pixel/cell unit the caller draws with */
+    readonly dx?: number;
+    readonly dy?: number;
+    /** draw order among a rule's own images and other rules matching the same cell; higher draws later (on top) */
+    readonly layer?: number;
+}
+/**
+ * One `[terrain_graphics]`-style transition rule: a set of neighbour conditions that must all
+ * hold, and the image or images to draw when they do. A rule with more conditions is more
+ * specific and wins over a less specific one covering the same cell, the same precedence a
+ * hand-authored rule set expects (a "this exact corner" rule beats a "any edge" rule); among
+ * rules tied on specificity, `probability` weights which one is picked, so a terrain can vary
+ * its look without every variant needing a different neighbourhood to key off of.
+ */
+export interface TerrainRule {
+    readonly id: string;
+    readonly conditions: readonly TerrainCondition[];
+    readonly images: readonly TerrainImage[];
+    /** relative weight among rules tied for most-specific at a cell; default 1 */
+    readonly probability?: number;
+    /**
+     * how many rotated copies of this rule to also try, each one `conditions`/`images` rotated
+     * by one more step of `rotate` (see `squareRotate`/`hexRotate`) - so one rule authored for
+     * one direction covers every direction a symmetric transition needs, instead of one rule
+     * per direction written out by hand. 0 or omitted tries only the rule as written.
+     */
+    readonly rotations?: number;
+}
+/** One resolved image placement: an absolute cell plus the rule's own image and offset. */
+export interface TerrainPlacement {
+    readonly x: number;
+    readonly y: number;
+    readonly ruleId: string;
+    readonly image: string;
+    readonly dx: number;
+    readonly dy: number;
+    readonly layer: number;
+}
+/** The flags present at a cell, or `undefined` for a cell with no terrain at all (e.g. off the map). */
+export type TerrainFlagsAt = (x: number, y: number) => ReadonlySet<string> | undefined;
+/** Rotates one condition/image offset by `rotationIndex` of `rotations` total steps around the cell. */
+export type TerrainRotate = (dx: number, dy: number, rotationIndex: number, rotations: number) => {
+    dx: number;
+    dy: number;
+};
+/**
+ * `TerrainRotate` for a square or isometric grid: exact 90-degree steps only (`rotations` must
+ * be a multiple of 4, or 0).
+ *
+ * @example
+ * ```ts
+ * import { squareRotate } from '@datamoc/mw_games/two-d/render';
+ *
+ * console.log(squareRotate(1, 0, 1, 4)); // { dx: 0, dy: 1 } - one 90-degree step
+ * ```
+ */
+export declare function squareRotate(dx: number, dy: number, rotationIndex: number, rotations: number): {
+    dx: number;
+    dy: number;
+};
+/**
+ * `TerrainRotate` for an axial hex grid: exact 60-degree steps (`rotations` must be a multiple
+ * of 6, or 0), via the standard cube-coordinate rotation (`q,r,s -> -r,-s,-q` per 60-degree step,
+ * `s = -q - r`).
+ *
+ * @example
+ * ```ts
+ * import { hexRotate } from '@datamoc/mw_games/two-d/render';
+ *
+ * console.log(hexRotate(1, 0, 1, 6)); // one 60-degree step of the axial offset (1, 0)
+ * ```
+ */
+export declare function hexRotate(dx: number, dy: number, rotationIndex: number, rotations: number): {
+    dx: number;
+    dy: number;
+};
+/**
+ * Whether `rule`, rotated by `rotationIndex` of `rotations` steps, matches the cell at `x, y`.
+ *
+ * @example
+ * ```ts
+ * import { matchTerrainRule } from '@datamoc/mw_games/two-d/render';
+ *
+ * const rule = { id: 'coast', conditions: [{ dx: 1, dy: 0, hasAll: ['water'] }], images: [] };
+ * const flagsAt = (x: number, y: number) => (x === 1 && y === 0 ? new Set(['water']) : new Set(['land']));
+ * console.log(matchTerrainRule(rule, 0, 0, flagsAt)); // true
+ * ```
+ */
+export declare function matchTerrainRule(rule: TerrainRule, x: number, y: number, flagsAt: TerrainFlagsAt, rotate?: TerrainRotate, rotationIndex?: number): boolean;
+export interface ResolveTerrainGraphicsOptions {
+    rotate?: TerrainRotate;
+    /** deterministic when given a seeded `Generator`; a fresh unseeded one otherwise */
+    random?: Generator;
+}
+/**
+ * Resolves a `[terrain_graphics]`-style rule set over a grid into the flat list of image
+ * placements a renderer draws, the generalisation `Autotile`'s 47-shape blob table cannot
+ * express: a rule can test flags rather than only "same terrain", key off any offset rather
+ * than only the 8 immediate neighbours, place more than one image (so a piece bigger than one
+ * cell, overlapping its neighbours, is one rule's `images` rather than something `TileMap`'s
+ * one-sprite-per-cell grid has to hold), and vary by rotation or probability.
+ *
+ * At each cell, every rule (at every rotation it declares) is tested; among the rules that
+ * match, the most specific (most conditions) wins, and `probability` breaks a tie among rules
+ * of equal specificity. A cell with no matching rule contributes nothing. The result is plain
+ * data - which cell, which rule, which image, at what offset and layer - a caller draws
+ * through `TileMap`, a custom `Sprite` pass, or anything else; this function never touches a
+ * renderer itself.
+ *
+ * @example
+ * ```ts
+ * import { resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
+ *
+ * const water = new Set(['water']);
+ * const land = new Set(['land']);
+ * const flagsAt = (x: number, y: number) => (x === 0 ? water : land);
+ *
+ * const placements = resolveTerrainGraphics(2, 1, [
+ * 	{ id: 'coast', conditions: [{ dx: 0, dy: 0, hasAll: ['land'] }, { dx: -1, dy: 0, hasAll: ['water'] }], images: [{ image: 'coast.png' }] },
+ * ], flagsAt);
+ * console.log(placements); // [{ x: 1, y: 0, ruleId: 'coast', image: 'coast.png', dx: 0, dy: 0, layer: 0 }]
+ * ```
+ */
+export declare function resolveTerrainGraphics(width: number, height: number, rules: readonly TerrainRule[], flagsAt: TerrainFlagsAt, options?: ResolveTerrainGraphicsOptions): TerrainPlacement[];
+//# sourceMappingURL=TerrainGraphics.d.ts.map

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

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

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

@@ -0,0 +1,161 @@
+import { Generator } from '../../core/Random.js';
+/**
+ * `TerrainRotate` for a square or isometric grid: exact 90-degree steps only (`rotations` must
+ * be a multiple of 4, or 0).
+ *
+ * @example
+ * ```ts
+ * import { squareRotate } from '@datamoc/mw_games/two-d/render';
+ *
+ * console.log(squareRotate(1, 0, 1, 4)); // { dx: 0, dy: 1 } - one 90-degree step
+ * ```
+ */
+export function squareRotate(dx, dy, rotationIndex, rotations) {
+    const steps = (rotationIndex * 4) / rotations;
+    let x = dx;
+    let y = dy;
+    for (let i = 0; i < steps; i += 1)
+        [x, y] = [-y, x];
+    return { dx: x || 0, dy: y || 0 };
+}
+/**
+ * `TerrainRotate` for an axial hex grid: exact 60-degree steps (`rotations` must be a multiple
+ * of 6, or 0), via the standard cube-coordinate rotation (`q,r,s -> -r,-s,-q` per 60-degree step,
+ * `s = -q - r`).
+ *
+ * @example
+ * ```ts
+ * import { hexRotate } from '@datamoc/mw_games/two-d/render';
+ *
+ * console.log(hexRotate(1, 0, 1, 6)); // one 60-degree step of the axial offset (1, 0)
+ * ```
+ */
+export function hexRotate(dx, dy, rotationIndex, rotations) {
+    const steps = (rotationIndex * 6) / rotations;
+    let q = dx;
+    let r = dy;
+    for (let i = 0; i < steps; i += 1) {
+        const s = -q - r;
+        [q, r] = [-r, -s];
+    }
+    return { dx: q || 0, dy: r || 0 };
+}
+function conditionMatches(condition, flags) {
+    const present = flags ?? new Set();
+    if (condition.hasAll && !condition.hasAll.every((flag) => present.has(flag)))
+        return false;
+    if (condition.hasAny && !condition.hasAny.some((flag) => present.has(flag)))
+        return false;
+    if (condition.hasNone && condition.hasNone.some((flag) => present.has(flag)))
+        return false;
+    return true;
+}
+/**
+ * Whether `rule`, rotated by `rotationIndex` of `rotations` steps, matches the cell at `x, y`.
+ *
+ * @example
+ * ```ts
+ * import { matchTerrainRule } from '@datamoc/mw_games/two-d/render';
+ *
+ * const rule = { id: 'coast', conditions: [{ dx: 1, dy: 0, hasAll: ['water'] }], images: [] };
+ * const flagsAt = (x: number, y: number) => (x === 1 && y === 0 ? new Set(['water']) : new Set(['land']));
+ * console.log(matchTerrainRule(rule, 0, 0, flagsAt)); // true
+ * ```
+ */
+export function matchTerrainRule(rule, x, y, flagsAt, rotate = squareRotate, rotationIndex = 0) {
+    const rotations = rule.rotations ?? 0;
+    return rule.conditions.every((condition) => {
+        const offset = rotations > 0 ? rotate(condition.dx, condition.dy, rotationIndex, rotations) : condition;
+        return conditionMatches(condition, flagsAt(x + offset.dx, y + offset.dy));
+    });
+}
+/**
+ * Resolves a `[terrain_graphics]`-style rule set over a grid into the flat list of image
+ * placements a renderer draws, the generalisation `Autotile`'s 47-shape blob table cannot
+ * express: a rule can test flags rather than only "same terrain", key off any offset rather
+ * than only the 8 immediate neighbours, place more than one image (so a piece bigger than one
+ * cell, overlapping its neighbours, is one rule's `images` rather than something `TileMap`'s
+ * one-sprite-per-cell grid has to hold), and vary by rotation or probability.
+ *
+ * At each cell, every rule (at every rotation it declares) is tested; among the rules that
+ * match, the most specific (most conditions) wins, and `probability` breaks a tie among rules
+ * of equal specificity. A cell with no matching rule contributes nothing. The result is plain
+ * data - which cell, which rule, which image, at what offset and layer - a caller draws
+ * through `TileMap`, a custom `Sprite` pass, or anything else; this function never touches a
+ * renderer itself.
+ *
+ * @example
+ * ```ts
+ * import { resolveTerrainGraphics } from '@datamoc/mw_games/two-d/render';
+ *
+ * const water = new Set(['water']);
+ * const land = new Set(['land']);
+ * const flagsAt = (x: number, y: number) => (x === 0 ? water : land);
+ *
+ * const placements = resolveTerrainGraphics(2, 1, [
+ * 	{ id: 'coast', conditions: [{ dx: 0, dy: 0, hasAll: ['land'] }, { dx: -1, dy: 0, hasAll: ['water'] }], images: [{ image: 'coast.png' }] },
+ * ], flagsAt);
+ * console.log(placements); // [{ x: 1, y: 0, ruleId: 'coast', image: 'coast.png', dx: 0, dy: 0, layer: 0 }]
+ * ```
+ */
+export function resolveTerrainGraphics(width, height, rules, flagsAt, options = {}) {
+    const rotate = options.rotate ?? squareRotate;
+    const random = options.random ?? new Generator();
+    const placements = [];
+    for (let y = 0; y < height; y += 1) {
+        for (let x = 0; x < width; x += 1) {
+            let bestSpecificity = -1;
+            let candidates = [];
+            for (const rule of rules) {
+                const rotations = rule.rotations ?? 0;
+                const steps = rotations > 0 ? rotations : 1;
+                for (let rotationIndex = 0; rotationIndex < steps; rotationIndex += 1) {
+                    if (!matchTerrainRule(rule, x, y, flagsAt, rotate, rotationIndex))
+                        continue;
+                    const specificity = rule.conditions.length;
+                    if (specificity > bestSpecificity) {
+                        bestSpecificity = specificity;
+                        candidates = [{ rule, rotationIndex }];
+                    }
+                    else if (specificity === bestSpecificity) {
+                        candidates.push({ rule, rotationIndex });
+                    }
+                }
+            }
+            if (candidates.length === 0)
+                continue;
+            const chosen = candidates.length === 1
+                ? candidates[0]
+                : candidates[weightedIndex(candidates.map((c) => c.rule.probability ?? 1), random)];
+            const rotations = chosen.rule.rotations ?? 0;
+            for (const image of chosen.rule.images) {
+                const offset = rotations > 0
+                    ? rotate(image.dx ?? 0, image.dy ?? 0, chosen.rotationIndex, rotations)
+                    : { dx: image.dx ?? 0, dy: image.dy ?? 0 };
+                placements.push({
+                    x,
+                    y,
+                    ruleId: chosen.rule.id,
+                    image: image.image,
+                    dx: offset.dx,
+                    dy: offset.dy,
+                    layer: image.layer ?? 0,
+                });
+            }
+        }
+    }
+    return placements;
+}
+function weightedIndex(weights, random) {
+    const total = weights.reduce((sum, weight) => sum + Math.max(0, weight), 0);
+    if (total <= 0)
+        return 0;
+    let roll = random.float() * total;
+    for (let index = 0; index < weights.length; index += 1) {
+        roll -= Math.max(0, weights[index]);
+        if (roll < 0)
+            return index;
+    }
+    return weights.length - 1;
+}
+//# sourceMappingURL=TerrainGraphics.js.map

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

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

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

@@ -1,10 +1,10 @@
 export { ColorTransformBatcher, packColorAdd, packTintAdd, NO_COLOR_ADD } from './ColorTransformBatcher.ts';
 export type { HasColorAdd } from './ColorTransformBatcher.ts';
 export { TintedSprite, registerColorTransform } from './TintedSprite.ts';
-export { applyImageModifiers, colorShiftMatrix, croppedTexture, imageModifier, parseImagePath, } from './ImageModifiers.ts';
-export type { ImageModifier, ParsedImagePath } from './ImageModifiers.ts';
+export { applyImageModifiers, applyTextureModifiers, blendMatrix, blendPixels, channelScaleMatrix, channelSwapMatrix, colorShiftMatrix, croppedTexture, imageModifier, maskPixels, parseColorPairs, parseImagePath, parsePaletteLists, rotatePixels, } from './ImageModifiers.ts';
+export type { ChannelSource, ImageModifier, ImageTextureProbe, ParsedImagePath, RotatedPixels } from './ImageModifiers.ts';
 export { AnimatedSprite, Animation } from './AnimatedSprite.ts';
-export type { AnimationOptions } from './AnimatedSprite.ts';
+export type { AnimationFrame, AnimationFrameInput, AnimationOptions } from './AnimatedSprite.ts';
 export { SpriteSheet } from './SpriteSheet.ts';
 export { Camera, createCamera, snapZoom } from './Camera.ts';
 export type { CameraOptions } from './Camera.ts';
@@ -19,6 +19,12 @@ export type { TileMapOptions } from './TileMap.ts';
 export { LayeredSprite } from './LayeredSprite.ts';
 export { Projectile } from './Projectile.ts';
 export type { ProjectilePoint, ProjectileOptions } from './Projectile.ts';
+export { LightningArc } from './LightningArc.ts';
+export type { LightningArcOptions, LightningArcPoint } from './LightningArc.ts';
+export { SpriteAttachment } from './SpriteAttachment.ts';
+export type { AttachmentPoint, SpriteAttachmentOptions } from './SpriteAttachment.ts';
+export { Halo, HALO_ANIMATION } from './Halo.ts';
+export type { HaloOptions } from './Halo.ts';
 export { ParticleEmitter } from './Particles.ts';
 export type { Particle, ParticleRange, ParticleEmitterOptions } from './Particles.ts';
 export { ScreenEffects } from './ScreenEffects.ts';
@@ -29,11 +35,15 @@ export { StatusVisuals } from './StatusVisuals.ts';
 export type { TintTarget, StatusVisualStyle, StatusVisualsOptions } from './StatusVisuals.ts';
 export { blobIndex, autotileFrames, BLOB_SHAPES } from './Autotile.ts';
 export type { NeighborMask } from './Autotile.ts';
+export { hexRotate, matchTerrainRule, resolveTerrainGraphics, squareRotate } from './TerrainGraphics.ts';
+export type { ResolveTerrainGraphicsOptions, TerrainCondition, TerrainFlagsAt, TerrainImage, TerrainPlacement, TerrainRotate, TerrainRule, } from './TerrainGraphics.ts';
 export { inspectGraphicsCapabilities, detectWebGpu, RENDERING_DECISIONS } from './Capabilities.ts';
 export type { GraphicsCapabilities, GraphicsProbe, GraphicsWorkload, RenderingDecision, WebGpuDetection, } from './Capabilities.ts';
 export { Container2D, Rectangle2D, Texture2D, rectOf } from './Types2D.ts';
 export type { Rect, TextureRegion } from './Types2D.ts';
 export { Node2D, Shape2D, Text2D, Sprite2D, TiledSprite, Gradient } from './Shape2D.ts';
+export { paletteRangeMapping, recolorTexture, remapPixels, withTextureCanvas } from './PaletteRemap.ts';
+export type { PaletteMapping, PaletteRange, PaletteRemapMode, RecolorProbe, RemapCanvas, RemapCanvasContext, } from './PaletteRemap.ts';
 export { loadTiledMap } from './TiledMap.ts';
 export type { TiledMapData, TiledTilesetData, TilesetSheet, LoadedTiledMap, TiledObject, TiledLayer, } from './TiledMap.ts';
 //# sourceMappingURL=index.d.ts.map

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

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

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

@@ -1,6 +1,6 @@
 export { ColorTransformBatcher, packColorAdd, packTintAdd, NO_COLOR_ADD } from './ColorTransformBatcher.js';
 export { TintedSprite, registerColorTransform } from './TintedSprite.js';
-export { applyImageModifiers, colorShiftMatrix, croppedTexture, imageModifier, parseImagePath, } from './ImageModifiers.js';
+export { applyImageModifiers, applyTextureModifiers, blendMatrix, blendPixels, channelScaleMatrix, channelSwapMatrix, colorShiftMatrix, croppedTexture, imageModifier, maskPixels, parseColorPairs, parseImagePath, parsePaletteLists, rotatePixels, } from './ImageModifiers.js';
 export { AnimatedSprite, Animation } from './AnimatedSprite.js';
 export { SpriteSheet } from './SpriteSheet.js';
 export { Camera, createCamera, snapZoom } from './Camera.js';
@@ -10,13 +10,18 @@ export { Minimap, newlyRevealed, minimapCellCenter } from './Minimap.js';
 export { TileMap, EMPTY, tileFrame, tileFrameSheet, tileFrameIndex } from './TileMap.js';
 export { LayeredSprite } from './LayeredSprite.js';
 export { Projectile } from './Projectile.js';
+export { LightningArc } from './LightningArc.js';
+export { SpriteAttachment } from './SpriteAttachment.js';
+export { Halo, HALO_ANIMATION } from './Halo.js';
 export { ParticleEmitter } from './Particles.js';
 export { ScreenEffects } from './ScreenEffects.js';
 export { ActorAnimator } from './ActorAnimator.js';
 export { StatusVisuals } from './StatusVisuals.js';
 export { blobIndex, autotileFrames, BLOB_SHAPES } from './Autotile.js';
+export { hexRotate, matchTerrainRule, resolveTerrainGraphics, squareRotate } from './TerrainGraphics.js';
 export { inspectGraphicsCapabilities, detectWebGpu, RENDERING_DECISIONS } from './Capabilities.js';
 export { Container2D, Rectangle2D, Texture2D, rectOf } from './Types2D.js';
 export { Node2D, Shape2D, Text2D, Sprite2D, TiledSprite, Gradient } from './Shape2D.js';
+export { paletteRangeMapping, recolorTexture, remapPixels, withTextureCanvas } from './PaletteRemap.js';
 export { loadTiledMap } from './TiledMap.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/two-d/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG5G,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASnG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/two-d/render/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG5G,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,YAAY,GACZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGvE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWzG,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AASnG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAUxG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/two-d/stage/StoryScreen.d.ts

@@ -0,0 +1,110 @@
+import { Container, Texture } from 'pixi.js';
+import { Signal } from '../../core/Signal.ts';
+/** One full-screen story beat: a backdrop image, a title, the text, and the music under it. */
+export interface StoryBeat {
+    text: string;
+    title?: string;
+    /** the backdrop image path, resolved by the screen's `textureFor` */
+    image?: string;
+    /** the music track to play while this beat is up */
+    music?: string;
+}
+/**
+ * The beats of a story screen and where the reader is in them, with no renderer attached - the
+ * same split `TabbedList` keeps, so the advance/back/skip rules are testable without a DOM.
+ *
+ * Music is reported as a signal rather than played: the sequence says *what* track a beat wants,
+ * and the game decides whether to crossfade, loop or ignore it. A beat with no `music` reports
+ * `null`, so a reader who turns the page to a silent beat gets the previous track stopped.
+ *
+ * @example
+ * ```ts
+ * import { StorySequence } from '@datamoc/mw_games/two-d/stage';
+ *
+ * const story = new StorySequence([
+ *   { title: 'Prologue', text: 'The war begins.', music: 'intro.ogg' },
+ *   { text: 'And so it went.' },
+ * ]);
+ * story.onMusic.add((track) => console.log(track)); // 'intro.ogg', then null
+ * story.advance();
+ * console.log(story.done); // true, only one page was left
+ * ```
+ */
+export declare class StorySequence {
+    readonly onChange: Signal<StoryBeat>;
+    readonly onMusic: Signal<string | null>;
+    private readonly beats;
+    private index;
+    constructor(beats: readonly StoryBeat[]);
+    get length(): number;
+    /** the beat on screen, 0 when empty */
+    get position(): number;
+    /** the beat on screen; `null` for an empty story */
+    get current(): StoryBeat | null;
+    /** whether the last beat is the one on screen */
+    get done(): boolean;
+    /** the music the current beat wants, or `null` for silence */
+    get music(): string | null;
+    /** moves to a beat, clamped to the ends; reports the beat and its music either way */
+    goTo(index: number): void;
+    /** turns one page; false when there was no next page */
+    advance(): boolean;
+    /** turns back one page; false when already at the first */
+    back(): boolean;
+    /** jumps to the last beat, the "skip" a player who has read it before reaches for */
+    skip(): void;
+    restart(): void;
+    private report;
+}
+export interface StoryScreenOptions {
+    sequence: StorySequence;
+    width: number;
+    height: number;
+    /** how a beat's `image` path becomes a texture; `null` when the path cannot be resolved */
+    textureFor?: (path: string) => Texture | null;
+    /** called with the current beat's music, or `null` for a silent beat */
+    playMusic?: (track: string | null) => void;
+}
+/**
+ * A full-screen story beat: a backdrop image, a title and the text over it, advanced by a click -
+ * the campaign interlude a scenario shows between maps.
+ *
+ * `DialogueStage` is the visual-novel model: characters standing on a backdrop, a box under them
+ * doing the talking. This is the other shape an interlude needs and that one is not - one page of
+ * prose filling the screen, no cast, page forward on any input - so it reuses the same `Label`
+ * everything else lays words out with and leaves the sequencing to `StorySequence`, the part worth
+ * testing without a renderer. Feeding it `MwlWorld.story` from an `.mwl` scenario is the intended
+ * use: both carry the same `{ text, title, image, music }` shape.
+ *
+ * @example
+ * ```ts
+ * import { StoryScreen, StorySequence } from '@datamoc/mw_games/two-d/stage';
+ *
+ * const sequence = new StorySequence([{ title: 'Prologue', text: 'The war begins.' }]);
+ * const screen = new StoryScreen({ sequence, width: 960, height: 540 });
+ * console.log(screen.current?.title); // 'Prologue'
+ * ```
+ */
+export declare class StoryScreen extends Container {
+    readonly sequence: StorySequence;
+    private readonly backdrop;
+    private readonly titleLabel;
+    private readonly textLabel;
+    private readonly textureFor;
+    private readonly playMusic;
+    private width_;
+    private height_;
+    constructor(options: StoryScreenOptions);
+    /** the beat on screen */
+    get current(): StoryBeat | null;
+    /** turns one page; false when the story is over, the caller's cue to change scene */
+    advance(): boolean;
+    /** jumps to the end, for a player who has already read it */
+    skip(): void;
+    resize(width: number, height: number): void;
+    private readonly handleAdvance;
+    private readonly handleBeat;
+    private applyBeat;
+    destroy(options?: Parameters<Container['destroy']>[0]): void;
+}
+//# sourceMappingURL=StoryScreen.d.ts.map

package/dist/two-d/stage/StoryScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StoryScreen.d.ts","sourceRoot":"","sources":["../../../src/two-d/stage/StoryScreen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C,+FAA+F;AAC/F,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IACzB,QAAQ,CAAC,QAAQ,oBAA2B;IAC5C,QAAQ,CAAC,OAAO,wBAA+B;IAE/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,KAAK,CAAK;IAElB,YAAY,KAAK,EAAE,SAAS,SAAS,EAAE,EAEtC;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,uCAAuC;IACvC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,SAAS,GAAG,IAAI,CAE9B;IAED,iDAAiD;IACjD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,8DAA8D;IAC9D,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxB;IAED,wDAAwD;IACxD,OAAO,IAAI,OAAO,CAIjB;IAED,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAId;IAED,qFAAqF;IACrF,IAAI,IAAI,IAAI,CAEX;IAED,OAAO,IAAI,IAAI,CAEd;IAED,OAAO,CAAC,MAAM;CAKd;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;IAC9C,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAElC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAC3D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,OAAO,EAAE,kBAAkB,EAsBtC;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,SAAS,GAAG,IAAI,CAE9B;IAED,qFAAqF;IACrF,OAAO,IAAI,OAAO,CAEjB;IAED,6DAA6D;IAC7D,IAAI,IAAI,IAAI,CAEX;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1C;IAED,OAAO,CAAC,QAAQ,CAAC,aAAa,CAE5B;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAEzB;IAEF,OAAO,CAAC,SAAS;IA0BR,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAIpE;CACD"}