@datamoc/mw_games 0.7.2 → 0.7.4

package/dist/simulation/Campaign.d.ts

@@ -0,0 +1,60 @@
+import type { StateValue } from '../core/State.ts';
+export type CampaignOutcome = 'completed' | 'failed' | 'abandoned';
+export interface CampaignLevel<State extends StateValue, Result extends StateValue = StateValue> {
+    readonly id: string;
+    readonly run: (state: State, context: {
+        readonly levelId: string;
+    }) => CampaignLevelResult<State, Result>;
+}
+export interface CampaignLevelResult<State extends StateValue, Result extends StateValue = StateValue> {
+    readonly outcome: CampaignOutcome;
+    readonly state: State;
+    readonly result?: Result;
+    readonly next?: string | null;
+    readonly reminders?: readonly string[];
+}
+export interface CampaignSnapshot<State extends StateValue, Result extends StateValue = StateValue> {
+    readonly currentLevel: string | null;
+    readonly state: State;
+    readonly reminders: readonly string[];
+    readonly results: Readonly<Record<string, Result>>;
+}
+/**
+ * Game-neutral level sequencing and carry-over state. A campaign adapter supplies the
+ * actual level runner and decides what a level result means; MWG only preserves order,
+ * transitions, reminders and serialisable state.
+ *
+ * @example
+ * ```ts
+ * import { Campaign } from '@datamoc/mw_games/simulation';
+ * const campaign = new Campaign({
+ *   levels: [{ id: 'intro', run: (state) => ({ outcome: 'completed', state, next: null }) }],
+ *   start: 'intro', state: { gold: 0 },
+ * });
+ * campaign.completeCurrent({ outcome: 'completed', state: { gold: 10 }, next: null });
+ * ```
+ */
+export declare class Campaign<State extends StateValue, Result extends StateValue = StateValue> {
+    private readonly levels;
+    private _currentLevel;
+    private _state;
+    private _reminders;
+    private _results;
+    constructor(options: {
+        readonly levels: readonly CampaignLevel<State, Result>[];
+        readonly start: string;
+        readonly state: State;
+    });
+    get currentLevel(): string | null;
+    get state(): State;
+    get reminders(): readonly string[];
+    get results(): Readonly<Record<string, Result>>;
+    /** Runs the current level and applies its carry-over state and transition. */
+    playCurrent(): CampaignLevelResult<State, Result>;
+    completeCurrent(result: CampaignLevelResult<State, Result>): CampaignLevelResult<State, Result>;
+    snapshot(): CampaignSnapshot<State, Result>;
+    static restore<State extends StateValue, Result extends StateValue = StateValue>(snapshot: CampaignSnapshot<State, Result>, options: {
+        readonly levels: readonly CampaignLevel<State, Result>[];
+    }): Campaign<State, Result>;
+}
+//# sourceMappingURL=Campaign.d.ts.map

package/dist/simulation/Campaign.d.ts.map

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

package/dist/simulation/Campaign.js

@@ -0,0 +1,85 @@
+/**
+ * Game-neutral level sequencing and carry-over state. A campaign adapter supplies the
+ * actual level runner and decides what a level result means; MWG only preserves order,
+ * transitions, reminders and serialisable state.
+ *
+ * @example
+ * ```ts
+ * import { Campaign } from '@datamoc/mw_games/simulation';
+ * const campaign = new Campaign({
+ *   levels: [{ id: 'intro', run: (state) => ({ outcome: 'completed', state, next: null }) }],
+ *   start: 'intro', state: { gold: 0 },
+ * });
+ * campaign.completeCurrent({ outcome: 'completed', state: { gold: 10 }, next: null });
+ * ```
+ */
+export class Campaign {
+    constructor(options) {
+        this._reminders = [];
+        this._results = {};
+        this.levels = new Map(options.levels.map((level) => [level.id, level]));
+        if (this.levels.size !== options.levels.length)
+            throw new Error('campaign level ids must be unique');
+        if (!this.levels.has(options.start))
+            throw new Error(`unknown campaign start level: ${options.start}`);
+        this._currentLevel = options.start;
+        this._state = structuredClone(options.state);
+    }
+    get currentLevel() {
+        return this._currentLevel;
+    }
+    get state() {
+        return structuredClone(this._state);
+    }
+    get reminders() {
+        return [...this._reminders];
+    }
+    get results() {
+        return structuredClone(this._results);
+    }
+    /** Runs the current level and applies its carry-over state and transition. */
+    playCurrent() {
+        if (!this._currentLevel)
+            throw new Error('campaign has no current level');
+        const level = this.levels.get(this._currentLevel);
+        return this.completeCurrent(level.run(this.state, { levelId: level.id }));
+    }
+    completeCurrent(result) {
+        if (!this._currentLevel)
+            throw new Error('campaign has no current level');
+        const completedId = this._currentLevel;
+        this._state = structuredClone(result.state);
+        if (result.result !== undefined)
+            this._results[completedId] = structuredClone(result.result);
+        this._reminders = [...(result.reminders ?? [])];
+        if (result.outcome !== 'completed')
+            this._currentLevel = null;
+        else if (result.next === undefined)
+            throw new Error(`campaign level ${completedId} did not choose a next level`);
+        else {
+            if (result.next !== null && !this.levels.has(result.next))
+                throw new Error(`unknown campaign transition: ${completedId} -> ${result.next}`);
+            this._currentLevel = result.next;
+        }
+        return { ...result, state: this.state };
+    }
+    snapshot() {
+        return {
+            currentLevel: this._currentLevel,
+            state: this.state,
+            reminders: this.reminders,
+            results: this.results,
+        };
+    }
+    static restore(snapshot, options) {
+        const start = snapshot.currentLevel ?? options.levels[0]?.id;
+        if (!start)
+            throw new Error('campaign restore requires at least one level');
+        const campaign = new Campaign({ levels: options.levels, start, state: snapshot.state });
+        campaign._currentLevel = snapshot.currentLevel;
+        campaign._reminders = [...snapshot.reminders];
+        campaign._results = structuredClone(snapshot.results);
+        return campaign;
+    }
+}
+//# sourceMappingURL=Campaign.js.map

package/dist/simulation/Campaign.js.map

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

package/dist/simulation/Harness.d.ts

@@ -0,0 +1,26 @@
+import { Generator } from '../core/Random.ts';
+import { type Scenario, type ScenarioResult } from './Scenario.ts';
+export interface HeadlessScenario<State, Command, Event> {
+    readonly seed: number;
+    readonly initialState: State;
+    readonly commands: readonly Command[];
+    readonly step: Scenario<State, Command, Event, Generator>['step'];
+    readonly status?: Scenario<State, Command, Event, Generator>['status'];
+}
+export interface HeadlessScenarioResult<State, Event> extends ScenarioResult<State, Event> {
+    readonly seed: number;
+    readonly random: readonly [number, number, number, number];
+}
+/**
+ * Execute a deterministic scenario without a renderer, returning state, outputs and RNG state for CI.
+ * @example
+ * ```ts
+ * import { runHeadlessScenario } from '@datamoc/mw_games/simulation';
+ * const result = runHeadlessScenario({
+ *   seed: 7, initialState: { score: 0 }, commands: [1],
+ *   step: (state, command) => ({ state: { score: state.score + command }, events: [], status: 'ready' }),
+ * });
+ * ```
+ */
+export declare function runHeadlessScenario<State, Command, Event>(scenario: HeadlessScenario<State, Command, Event>): HeadlessScenarioResult<State, Event>;
+//# sourceMappingURL=Harness.d.ts.map

package/dist/simulation/Harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Harness.d.ts","sourceRoot":"","sources":["../../src/simulation/Harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,WAAW,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,KAAK,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAE,SAAQ,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EACxD,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,GAC/C,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAUtC"}

package/dist/simulation/Harness.js

@@ -0,0 +1,25 @@
+import { Generator } from '../core/Random.js';
+import { runScenario } from './Scenario.js';
+/**
+ * Execute a deterministic scenario without a renderer, returning state, outputs and RNG state for CI.
+ * @example
+ * ```ts
+ * import { runHeadlessScenario } from '@datamoc/mw_games/simulation';
+ * const result = runHeadlessScenario({
+ *   seed: 7, initialState: { score: 0 }, commands: [1],
+ *   step: (state, command) => ({ state: { score: state.score + command }, events: [], status: 'ready' }),
+ * });
+ * ```
+ */
+export function runHeadlessScenario(scenario) {
+    const random = new Generator(scenario.seed);
+    const result = runScenario({
+        state: structuredClone(scenario.initialState),
+        commands: scenario.commands,
+        status: scenario.status,
+        random,
+        step: scenario.step,
+    });
+    return { ...result, seed: scenario.seed, random: random.getState() };
+}
+//# sourceMappingURL=Harness.js.map

package/dist/simulation/Harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Harness.js","sourceRoot":"","sources":["../../src/simulation/Harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAsC,MAAM,eAAe,CAAC;AAehF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAClC,QAAiD;IAEjD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,WAAW,CAAC;QAC1B,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC7C,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,MAAM;QACN,IAAI,EAAE,QAAQ,CAAC,IAAI;KACnB,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AACtE,CAAC"}

package/dist/simulation/index.d.ts

@@ -2,6 +2,10 @@ export { advanceToInput } from './Turns.ts';
 export type { ScheduledTurns, TurnRules, TurnResult } from './Turns.ts';
 export { runScenario } from './Scenario.ts';
 export type { SimulationStatus, SimulationStep, SimulationRule, Scenario, ScenarioResult } from './Scenario.ts';
+export { Campaign } from './Campaign.ts';
+export type { CampaignOutcome, CampaignLevel, CampaignLevelResult, CampaignSnapshot } from './Campaign.ts';
+export { runHeadlessScenario } from './Harness.ts';
+export type { HeadlessScenario, HeadlessScenarioResult } from './Harness.ts';
 export { SimulationRuntime } from './Runtime.ts';
 export type { SimulationContext, SimulationOutcome, SimulationRuntimeRule, SimulationSnapshot } from './Runtime.ts';
 /**

package/dist/simulation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/simulation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpH;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/simulation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAChH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3G,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEpH;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/simulation/index.js

@@ -1,5 +1,7 @@
 export { advanceToInput } from './Turns.js';
 export { runScenario } from './Scenario.js';
+export { Campaign } from './Campaign.js';
+export { runHeadlessScenario } from './Harness.js';
 export { SimulationRuntime } from './Runtime.js';
 /**
  * Re-exported from `roguelike` (its own home - it also drives FOV/pathfinding turn order

package/dist/simulation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/simulation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/simulation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,58 @@
+import { ColorMatrixFilter, Sprite, Texture } from 'pixi.js';
+/** A parsed `image~MOD(args)` path, usable by any MWG game content format. */
+export interface ImageModifier {
+    readonly name: string;
+    readonly args: readonly string[];
+}
+export interface ParsedImagePath {
+    readonly path: string;
+    readonly modifiers: readonly ImageModifier[];
+}
+/** Split top-level modifiers while keeping nested `~` paths inside arguments.
+ * @example
+ * ```ts
+ * import { parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const parsed = parseImagePath('hero.png~FL(horizontal)~GS');
+ * ```
+ */
+export declare function parseImagePath(value: string): ParsedImagePath;
+/** Return one named modifier from a parsed image path.
+ * @example
+ * ```ts
+ * import { imageModifier, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const flip = imageModifier(parseImagePath('hero.png~FL(horizontal)'), 'FL');
+ * ```
+ */
+export declare function imageModifier(path: ParsedImagePath, name: string): ImageModifier | undefined;
+/**
+ * Build the Pixi 5x4 colour-matrix for a Wesnoth `CS(r,g,b)` shift.
+ *
+ * @example
+ * ```ts
+ * import { colorShiftMatrix } from '@datamoc/mw_games/two-d/render';
+ * const matrix = colorShiftMatrix(-20, 0, 30);
+ * console.log(matrix.length); // 20
+ * ```
+ */
+export declare function colorShiftMatrix(red: number, green: number, blue: number): ColorMatrixFilter['matrix'];
+/** Apply the renderer-neutral subset supported by the Pixi backend. */
+/**
+ * @example
+ * ```ts
+ * import { Sprite } from 'pixi.js';
+ * import { applyImageModifiers, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * applyImageModifiers(new Sprite(), parseImagePath('hero.png~FL(horizontal)'));
+ * ```
+ */
+export declare function applyImageModifiers(sprite: Sprite, parsed: ParsedImagePath, scale?: number): void;
+/** Make a cropped view without mutating the shared source texture. */
+/**
+ * @example
+ * ```ts
+ * import { Texture } from 'pixi.js';
+ * import { croppedTexture, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const cropped = croppedTexture(Texture.EMPTY, parseImagePath('atlas.png~CROP(0,0,16,16)'));
+ * ```
+ */
+export declare function croppedTexture(texture: Texture, parsed: ParsedImagePath): Texture;
+//# sourceMappingURL=ImageModifiers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImageModifiers.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/ImageModifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAa,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAExE,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAyB7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAuBtG;AAED,uEAAuE;AACvE;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,SAAI,GAAG,IAAI,CA0B5F;AAED,sEAAsE;AACtE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAYjF"}

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

@@ -0,0 +1,145 @@
+import { ColorMatrixFilter, Rectangle, Sprite, Texture } from 'pixi.js';
+/** Split top-level modifiers while keeping nested `~` paths inside arguments.
+ * @example
+ * ```ts
+ * import { parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const parsed = parseImagePath('hero.png~FL(horizontal)~GS');
+ * ```
+ */
+export function parseImagePath(value) {
+    value = value.replace(/^"|"$/g, '');
+    const parts = [];
+    let start = 0;
+    let depth = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        if (value[index] === '(')
+            depth += 1;
+        else if (value[index] === ')')
+            depth = Math.max(0, depth - 1);
+        else if (value[index] === '~' && depth === 0) {
+            parts.push(value.slice(start, index));
+            start = index + 1;
+        }
+    }
+    parts.push(value.slice(start));
+    const path = (parts.shift() ?? '').trim();
+    const modifiers = [];
+    for (const source of parts) {
+        const match = /^([A-Za-z][A-Za-z0-9_-]*)(?:\((.*)\))?$/.exec(source.trim());
+        if (!match)
+            continue;
+        modifiers.push({
+            name: match[1].toUpperCase(),
+            args: match[2] === undefined ? [] : match[2].split(',').map((arg) => arg.trim()),
+        });
+    }
+    return { path, modifiers };
+}
+/** Return one named modifier from a parsed image path.
+ * @example
+ * ```ts
+ * import { imageModifier, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const flip = imageModifier(parseImagePath('hero.png~FL(horizontal)'), 'FL');
+ * ```
+ */
+export function imageModifier(path, name) {
+    return path.modifiers.find((entry) => entry.name === name.toUpperCase());
+}
+/**
+ * Build the Pixi 5x4 colour-matrix for a Wesnoth `CS(r,g,b)` shift.
+ *
+ * @example
+ * ```ts
+ * import { colorShiftMatrix } from '@datamoc/mw_games/two-d/render';
+ * const matrix = colorShiftMatrix(-20, 0, 30);
+ * console.log(matrix.length); // 20
+ * ```
+ */
+export function colorShiftMatrix(red, green, blue) {
+    return [
+        1,
+        0,
+        0,
+        0,
+        red / 255,
+        0,
+        1,
+        0,
+        0,
+        green / 255,
+        0,
+        0,
+        1,
+        0,
+        blue / 255,
+        0,
+        0,
+        0,
+        1,
+        0,
+    ];
+}
+/** Apply the renderer-neutral subset supported by the Pixi backend. */
+/**
+ * @example
+ * ```ts
+ * import { Sprite } from 'pixi.js';
+ * import { applyImageModifiers, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * applyImageModifiers(new Sprite(), parseImagePath('hero.png~FL(horizontal)'));
+ * ```
+ */
+export function applyImageModifiers(sprite, parsed, scale = 1) {
+    const flip = imageModifier(parsed, 'FL');
+    if (flip && (flip.args.length === 0 || flip.args.some((arg) => /horiz|horizontal|x/i.test(arg))))
+        sprite.scale.x *= -1;
+    if (flip?.args.some((arg) => /vert|vertical|y/i.test(arg)))
+        sprite.scale.y *= -1;
+    const size = imageModifier(parsed, 'SCALE');
+    if (size) {
+        const width = Number(size.args[0]);
+        const height = Number(size.args[1] ?? size.args[0]);
+        if (Number.isFinite(width) && width > 0)
+            sprite.width = width * scale;
+        if (Number.isFinite(height) && height > 0)
+            sprite.height = height * scale;
+    }
+    if (imageModifier(parsed, 'GS')) {
+        const filter = new ColorMatrixFilter();
+        filter.greyscale(1, false);
+        sprite.filters = [filter];
+    }
+    const shift = imageModifier(parsed, 'CS');
+    if (shift) {
+        const values = shift.args.slice(0, 3).map(Number);
+        if (values.length === 3 && values.every((value) => Number.isFinite(value))) {
+            const filter = new ColorMatrixFilter();
+            filter.matrix = colorShiftMatrix(values[0], values[1], values[2]);
+            sprite.filters = [...(sprite.filters ?? []), filter];
+        }
+    }
+}
+/** Make a cropped view without mutating the shared source texture. */
+/**
+ * @example
+ * ```ts
+ * import { Texture } from 'pixi.js';
+ * import { croppedTexture, parseImagePath } from '@datamoc/mw_games/two-d/render';
+ * const cropped = croppedTexture(Texture.EMPTY, parseImagePath('atlas.png~CROP(0,0,16,16)'));
+ * ```
+ */
+export function croppedTexture(texture, parsed) {
+    const crop = imageModifier(parsed, 'CROP');
+    if (!crop || crop.args.length < 4 || !texture.source)
+        return texture;
+    const values = crop.args.slice(0, 4).map(Number);
+    if (values.some((value) => !Number.isFinite(value)) || values[2] <= 0 || values[3] <= 0)
+        return texture;
+    const x = Math.max(0, values[0]);
+    const y = Math.max(0, values[1]);
+    const width = Math.min(values[2], Math.max(0, texture.width - x));
+    const height = Math.min(values[3], Math.max(0, texture.height - y));
+    return width > 0 && height > 0
+        ? new Texture({ source: texture.source, frame: new Rectangle(x, y, width, height) })
+        : texture;
+}
+//# sourceMappingURL=ImageModifiers.js.map

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

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

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

@@ -19,7 +19,28 @@ export interface MinimapOptions {
     heightInCells: number;
     /** screen pixels per cell; defaults to 2, small enough for an always-on-screen corner HUD */
     cellSize?: number;
+    /** cell topology; hex uses the same flat-top odd-q projection as `TileMap` */
+    shape?: 'square' | 'hex';
 }
+export interface MinimapMarker {
+    x: number;
+    y: number;
+    facing?: number;
+    color?: number;
+}
+/**
+ * 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 declare function minimapCellCenter(x: number, y: number, cellSize: number, shape?: 'square' | 'hex'): {
+    x: number;
+    y: number;
+};
 /**
  * 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
@@ -53,6 +74,7 @@ export interface MinimapOptions {
 export declare class Minimap extends Container {
     private readonly widthInCells;
     private readonly cellSize;
+    private readonly shape;
     private renderTexture;
     private sprite;
     private drawn;
@@ -69,6 +91,8 @@ export declare class Minimap extends Container {
     sync(explored: ReadonlySet<number>, colorFor: (x: number, y: number) => number): void;
     /** positions a marker at a cell, optionally pointing it in a facing direction (radians) */
     setMarker(x: number, y: number, facing?: number, color?: number): void;
+    /** replaces the current overlay with zero or more unit/quest markers */
+    setMarkers(markers: readonly MinimapMarker[]): void;
     /** forgets everything baked, so the next `sync` repaints from a clean texture - a fresh floor */
     reset(): void;
     destroy(options?: Parameters<Container['destroy']>[0]): void;

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

@@ -1 +1 @@
-{"version":3,"file":"Minimap.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/Minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmC,MAAM,SAAS,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAMxG;AAED,MAAM,WAAW,cAAc;IAC9B,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,OAAQ,SAAQ,SAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,MAAM,CAAkB;IAEhC,YAAY,OAAO,EAAE,cAAc,EAalC;IAED,2FAA2F;IAC3F,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAgBpF;IAED,2FAA2F;IAC3F,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,IAAI,CAcvE;IAED,iGAAiG;IACjG,KAAK,IAAI,IAAI,CAGZ;IAEQ,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGpE;CACD"}
+{"version":3,"file":"Minimap.d.ts","sourceRoot":"","sources":["../../../src/two-d/render/Minimap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmC,MAAM,SAAS,CAAC;AAIrE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAMxG;AAED,MAAM,WAAW,cAAc;IAC9B,kFAAkF;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IAEtB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,QAAQ,GAAG,KAAgB,GAChC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAI1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,OAAQ,SAAQ,SAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAqB;IAElC,OAAO,CAAC,MAAM,CAAkB;IAEhC,YAAY,OAAO,EAAE,cAAc,EAoBlC;IAED,2FAA2F;IAC3F,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CA2BpF;IAED,2FAA2F;IAC3F,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,IAAI,CAEvE;IAED,wEAAwE;IACxE,UAAU,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAelD;IAED,iGAAiG;IACjG,KAAK,IAAI,IAAI,CAGZ;IAEQ,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGpE;CACD"}

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

@@ -1,5 +1,6 @@
 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
  *
@@ -21,6 +22,20 @@ export function newlyRevealed(explored, alreadyDrawn) {
     }
     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
@@ -58,9 +73,14 @@ export class Minimap extends Container {
         this.marker = new Graphics();
         this.widthInCells = options.widthInCells;
         this.cellSize = options.cellSize ?? 2;
+        this.shape = options.shape ?? 'square';
         this.renderTexture = RenderTexture.create({
-            width: options.widthInCells * this.cellSize,
-            height: options.heightInCells * this.cellSize,
+            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);
@@ -85,26 +105,44 @@ export class Minimap extends Container {
             this.drawn.add(index);
             const x = index % this.widthInCells;
             const y = Math.floor(index / this.widthInCells);
-            patch
-                .rect(x * this.cellSize, y * this.cellSize, this.cellSize, this.cellSize)
-                .fill({ color: colorFor(x, y) });
+            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();
-        this.marker.circle(0, 0, Math.max(1, this.cellSize)).fill({ color });
-        if (facing !== undefined) {
-            const length = this.cellSize * 2;
-            this.marker
-                .moveTo(0, 0)
-                .lineTo(Math.cos(facing) * length, Math.sin(facing) * length)
-                .stroke({ color, width: 1 });
+        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 });
+            }
         }
-        this.marker.x = (x + 0.5) * this.cellSize;
-        this.marker.y = (y + 0.5) * this.cellSize;
     }
     /** forgets everything baked, so the next `sync` repaints from a clean texture - a fresh floor */
     reset() {