@futdevpro/fsm-dynamo 1.20.100 → 1.20.101

package/build/_modules/game/_models/input-action-registry.control-model.d.ts

@@ -0,0 +1,56 @@
+import { DyFM_InputAction_Definition, DyFM_InputApplyReport, DyFM_InputChord, DyFM_InputConflict, DyFM_InputContext, DyFM_InputFlatMap, DyFM_InputKeyEvent, DyFM_InputResolution } from './input-action.interface';
+/**
+ * BFR-WARFACTORY-017 — typed input-action registry: default bindings, per-binding `code` / `key` matching, three
+ * orthogonal guards, ONE resolution per event, conflict detection, reset, and a flat `slotId → chord` map for disk.
+ *
+ * Slot ids are `<actionId>#<index>` (the index in the definition's `bindings`) — stable across remaps; a remap only
+ * changes a slot's chord, never its payload.
+ */
+export declare class DyFM_InputActionRegistry_ControlModel {
+    private readonly actions;
+    private readonly slots;
+    /** Registers the actions; duplicate ids or an action without bindings throw `DYFM-INPUT-DEFINITION`. */
+    constructor(actions: DyFM_InputAction_Definition[]);
+    /** The chord string form: `ctrl+shift+code:KeyS` / `key:?` (modifiers in a fixed order). */
+    static formatChord(chord: DyFM_InputChord): string;
+    /** Parses a chord string; `null` when it is not one. */
+    static parseChord(text: string): DyFM_InputChord | null;
+    /**
+     * Resolves a key event to AT MOST ONE action: the matching slots whose guard is live in `context`, highest
+     * `priority` first, then definition order.
+     */
+    resolve(event: DyFM_InputKeyEvent, context: DyFM_InputContext): DyFM_InputResolution | null;
+    /** The current chord of a slot. */
+    chordOf(slotId: string): DyFM_InputChord | undefined;
+    /** Slots whose chord equals `chord` and whose guards can be live together with `slotId`'s action. */
+    findConflicts(slotId: string, chord: DyFM_InputChord): DyFM_InputConflict[];
+    /**
+     * Remaps a slot. A conflicting chord is REFUSED (the conflicts are returned) unless `force` — then the conflicting
+     * slots SWAP: they take this slot's previous chord (resetting them to their defaults would not help when a default
+     * is the contested chord itself).
+     */
+    rebind(slotId: string, chord: DyFM_InputChord, force?: boolean): {
+        ok: boolean;
+        conflicts: DyFM_InputConflict[];
+    };
+    /** Resets one slot, one action's slots, or (no argument) everything to the defaults. */
+    resetToDefault(slotOrActionId?: string): void;
+    /** ③ The flat on-disk form — ONLY the slots that differ from their defaults. */
+    toFlatMap(): DyFM_InputFlatMap;
+    /**
+     * ③ Applies a stored flat map on top of the defaults: unknown slots (an action the game removed) and unparsable
+     * chords are skipped and reported; a stored chord that now conflicts is NOT applied (reported) — a stale save
+     * cannot silently steal a key.
+     */
+    applyFlatMap(map: DyFM_InputFlatMap): DyFM_InputApplyReport;
+    private action;
+    private slot;
+    private static validChord;
+    /** ① code vs key, and the modifiers must match exactly (an unset modifier must not be held). */
+    private static matches;
+    /** ② The three predicates. */
+    private static guardAllows;
+    /** Can two actions be live in the same context? (phases intersect AND overlay conditions can hold together) */
+    private static guardsOverlap;
+}
+//# sourceMappingURL=input-action-registry.control-model.d.ts.map

package/build/_modules/game/_models/input-action-registry.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-action-registry.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/input-action-registry.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAE3B,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAElB,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAWlC;;;;;;GAMG;AACH,qBAAa,qCAAqC;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,wGAAwG;gBAC5F,OAAO,EAAE,2BAA2B,EAAE;IA4BlD,4FAA4F;IAC5F,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAOlD,wDAAwD;IACxD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAqBvD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,IAAI;IA4B3F,mCAAmC;IACnC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAMpD,qGAAqG;IACrG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,kBAAkB,EAAE;IAiB3E;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,GAAE,OAAe,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE;IAwBxH,wFAAwF;IACxF,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAS7C,gFAAgF;IAChF,SAAS,IAAI,iBAAiB;IAc9B;;;;OAIG;IACH,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,qBAAqB;IAyB3D,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM,CAAC,UAAU;IAIzB,gGAAgG;IAChG,OAAO,CAAC,MAAM,CAAC,OAAO;IAQtB,8BAA8B;IAC9B,OAAO,CAAC,MAAM,CAAC,WAAW;IAoB1B,+GAA+G;IAC/G,OAAO,CAAC,MAAM,CAAC,aAAa;CAoB7B"}

package/build/_modules/game/_models/input-action-registry.control-model.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_InputActionRegistry_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * BFR-WARFACTORY-017 — typed input-action registry: default bindings, per-binding `code` / `key` matching, three
+ * orthogonal guards, ONE resolution per event, conflict detection, reset, and a flat `slotId → chord` map for disk.
+ *
+ * Slot ids are `<actionId>#<index>` (the index in the definition's `bindings`) — stable across remaps; a remap only
+ * changes a slot's chord, never its payload.
+ */
+class DyFM_InputActionRegistry_ControlModel {
+    actions;
+    slots = [];
+    /** Registers the actions; duplicate ids or an action without bindings throw `DYFM-INPUT-DEFINITION`. */
+    constructor(actions) {
+        const seen = new Set();
+        for (const action of actions) {
+            if (!action?.actionId || seen.has(action.actionId) || !action.bindings?.length
+                || action.bindings.some((slot) => !DyFM_InputActionRegistry_ControlModel.validChord(slot?.chord))) {
+                throw new error_control_model_1.DyFM_Error({
+                    message: `DyFM_InputActionRegistry: action ids must be unique, with ≥ 1 valid binding (${action?.actionId})`,
+                    errorCode: 'DYFM-INPUT-DEFINITION',
+                    issuerService: 'DyFM_InputActionRegistry_ControlModel',
+                });
+            }
+            seen.add(action.actionId);
+        }
+        this.actions = actions.map((a) => ({ ...a }));
+        for (const action of this.actions) {
+            action.bindings.forEach((slot, index) => {
+                this.slots.push({
+                    slotId: `${action.actionId}#${index}`,
+                    actionId: action.actionId,
+                    defaultChord: { ...slot.chord },
+                    chord: { ...slot.chord },
+                    payload: slot.payload,
+                });
+            });
+        }
+    }
+    /** The chord string form: `ctrl+shift+code:KeyS` / `key:?` (modifiers in a fixed order). */
+    static formatChord(chord) {
+        const modifiers = ['ctrl', 'alt', 'shift', 'meta']
+            .filter((m) => chord[m] === true);
+        return [...modifiers, `${chord.match}:${chord.value}`].join('+');
+    }
+    /** Parses a chord string; `null` when it is not one. */
+    static parseChord(text) {
+        if (typeof text !== 'string' || !text) {
+            return null;
+        }
+        const parts = text.split('+');
+        const last = parts.pop();
+        const colon = last.indexOf(':');
+        const match = last.slice(0, colon);
+        const chord = { match: match, value: last.slice(colon + 1) };
+        for (const modifier of parts) {
+            if (!['ctrl', 'alt', 'shift', 'meta'].includes(modifier)) {
+                return null;
+            }
+            chord[modifier] = true;
+        }
+        return colon > 0 && DyFM_InputActionRegistry_ControlModel.validChord(chord) ? chord : null;
+    }
+    /**
+     * Resolves a key event to AT MOST ONE action: the matching slots whose guard is live in `context`, highest
+     * `priority` first, then definition order.
+     */
+    resolve(event, context) {
+        let best = null;
+        this.slots.forEach((slot) => {
+            const action = this.action(slot.actionId);
+            if (!DyFM_InputActionRegistry_ControlModel.matches(slot.chord, event)
+                || !DyFM_InputActionRegistry_ControlModel.guardAllows(action.guard, context)) {
+                return;
+            }
+            const priority = action.priority ?? 0;
+            const order = this.actions.indexOf(action);
+            if (!best || priority > best.priority || (priority === best.priority && order < best.order)) {
+                best = { slot: slot, priority: priority, order: order };
+            }
+        });
+        if (!best) {
+            return null;
+        }
+        const chosen = best.slot;
+        return { actionId: chosen.actionId, slotId: chosen.slotId, payload: chosen.payload };
+    }
+    /** The current chord of a slot. */
+    chordOf(slotId) {
+        const slot = this.slot(slotId);
+        return slot ? { ...slot.chord } : undefined;
+    }
+    /** Slots whose chord equals `chord` and whose guards can be live together with `slotId`'s action. */
+    findConflicts(slotId, chord) {
+        const own = this.slot(slotId);
+        if (!own) {
+            return [];
+        }
+        const text = DyFM_InputActionRegistry_ControlModel.formatChord(chord);
+        const ownGuard = this.action(own.actionId).guard;
+        return this.slots
+            .filter((other) => other.slotId !== slotId
+            && DyFM_InputActionRegistry_ControlModel.formatChord(other.chord) === text
+            && DyFM_InputActionRegistry_ControlModel.guardsOverlap(ownGuard, this.action(other.actionId).guard))
+            .map((other) => ({ slotId: slotId, otherSlotId: other.slotId, chord: text }));
+    }
+    /**
+     * Remaps a slot. A conflicting chord is REFUSED (the conflicts are returned) unless `force` — then the conflicting
+     * slots SWAP: they take this slot's previous chord (resetting them to their defaults would not help when a default
+     * is the contested chord itself).
+     */
+    rebind(slotId, chord, force = false) {
+        const slot = this.slot(slotId);
+        if (!slot || !DyFM_InputActionRegistry_ControlModel.validChord(chord)) {
+            return { ok: false, conflicts: [] };
+        }
+        const conflicts = this.findConflicts(slotId, chord);
+        if (conflicts.length && !force) {
+            return { ok: false, conflicts: conflicts };
+        }
+        const previous = { ...slot.chord };
+        for (const conflict of conflicts) {
+            const other = this.slot(conflict.otherSlotId);
+            other.chord = { ...previous };
+        }
+        slot.chord = { ...chord };
+        return { ok: true, conflicts: conflicts };
+    }
+    /** Resets one slot, one action's slots, or (no argument) everything to the defaults. */
+    resetToDefault(slotOrActionId) {
+        this.slots
+            .filter((slot) => !slotOrActionId || slot.slotId === slotOrActionId || slot.actionId === slotOrActionId)
+            .forEach((slot) => {
+            slot.chord = { ...slot.defaultChord };
+        });
+    }
+    /** ③ The flat on-disk form — ONLY the slots that differ from their defaults. */
+    toFlatMap() {
+        const map = {};
+        for (const slot of this.slots) {
+            const current = DyFM_InputActionRegistry_ControlModel.formatChord(slot.chord);
+            if (current !== DyFM_InputActionRegistry_ControlModel.formatChord(slot.defaultChord)) {
+                map[slot.slotId] = current;
+            }
+        }
+        return map;
+    }
+    /**
+     * ③ Applies a stored flat map on top of the defaults: unknown slots (an action the game removed) and unparsable
+     * chords are skipped and reported; a stored chord that now conflicts is NOT applied (reported) — a stale save
+     * cannot silently steal a key.
+     */
+    applyFlatMap(map) {
+        const report = { applied: [], unknownSlots: [], invalidChords: [], conflicts: [] };
+        this.resetToDefault();
+        for (const [slotId, text] of Object.entries(map ?? {})) {
+            const chord = DyFM_InputActionRegistry_ControlModel.parseChord(text);
+            if (!this.slot(slotId)) {
+                report.unknownSlots.push(slotId);
+            }
+            else if (!chord) {
+                report.invalidChords.push(slotId);
+            }
+            else {
+                const result = this.rebind(slotId, chord);
+                if (result.ok) {
+                    report.applied.push(slotId);
+                }
+                else {
+                    report.conflicts.push(...result.conflicts);
+                }
+            }
+        }
+        return report;
+    }
+    action(actionId) {
+        return this.actions.find((a) => a.actionId === actionId);
+    }
+    slot(slotId) {
+        return this.slots.find((s) => s.slotId === slotId);
+    }
+    static validChord(chord) {
+        return !!chord && (chord.match === 'code' || chord.match === 'key') && typeof chord.value === 'string' && chord.value.length > 0;
+    }
+    /** ① code vs key, and the modifiers must match exactly (an unset modifier must not be held). */
+    static matches(chord, event) {
+        const value = chord.match === 'code' ? event.code : event.key;
+        return value === chord.value
+            && !!chord.ctrl === !!event.ctrlKey && !!chord.alt === !!event.altKey
+            && !!chord.shift === !!event.shiftKey && !!chord.meta === !!event.metaKey;
+    }
+    /** ② The three predicates. */
+    static guardAllows(guard, context) {
+        if (context.interactiveTarget && !guard?.allowInInteractiveTarget) {
+            return false;
+        }
+        const overlays = guard?.overlays ?? 'none';
+        if (overlays === 'none' && context.openOverlay !== null) {
+            return false;
+        }
+        if (overlays === 'open' && context.openOverlay === null) {
+            return false;
+        }
+        if (Array.isArray(overlays) && (context.openOverlay === null || !overlays.includes(context.openOverlay))) {
+            return false;
+        }
+        return !guard?.phases || guard.phases.includes(context.phase);
+    }
+    /** Can two actions be live in the same context? (phases intersect AND overlay conditions can hold together) */
+    static guardsOverlap(a, b) {
+        const phasesOverlap = !a?.phases || !b?.phases || a.phases.some((p) => b.phases.includes(p));
+        const overlayA = a?.overlays ?? 'none';
+        const overlayB = b?.overlays ?? 'none';
+        let overlaysOverlap;
+        if (overlayA === 'any' || overlayB === 'any') {
+            overlaysOverlap = true;
+        }
+        else if (overlayA === 'none' || overlayB === 'none') {
+            // 'none' only overlaps 'none' (an open overlay excludes it)
+            overlaysOverlap = overlayA === overlayB;
+        }
+        else if (overlayA === 'open' || overlayB === 'open') {
+            // 'open' overlaps 'open' and any overlay list (both need an overlay on top)
+            overlaysOverlap = true;
+        }
+        else {
+            overlaysOverlap = overlayA.some((o) => overlayB.includes(o));
+        }
+        return phasesOverlap && overlaysOverlap;
+    }
+}
+exports.DyFM_InputActionRegistry_ControlModel = DyFM_InputActionRegistry_ControlModel;
+//# sourceMappingURL=input-action-registry.control-model.js.map

package/build/_modules/game/_models/input-action-registry.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-action-registry.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/input-action-registry.control-model.ts"],"names":[],"mappings":";;;AAAA,6FAAiF;AAuBjF;;;;;;GAMG;AACH,MAAa,qCAAqC;IAC/B,OAAO,CAAgC;IACvC,KAAK,GAA6B,EAAE,CAAC;IAEtD,wGAAwG;IACxG,YAAY,OAAsC;QAChD,MAAM,IAAI,GAAgB,IAAI,GAAG,EAAU,CAAC;QAE5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM;mBACzE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAgC,EAAW,EAAE,CAAC,CAAC,qCAAqC,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzI,MAAM,IAAI,gCAAU,CAAC;oBACnB,OAAO,EAAE,gFAAgF,MAAM,EAAE,QAAQ,GAAG;oBAC5G,SAAS,EAAE,uBAAuB;oBAClC,aAAa,EAAE,uCAAuC;iBACvD,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAA8B,EAA+B,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACxG,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAmD,EAAE,KAAa,EAAQ,EAAE;gBACnG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,EAAE;oBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,YAAY,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;oBAC/B,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE;oBACxB,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,4FAA4F;IAC5F,MAAM,CAAC,WAAW,CAAC,KAAsB;QACvC,MAAM,SAAS,GAAa,CAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAE;aAC3D,MAAM,CAAC,CAAC,CAAS,EAAW,EAAE,CAAE,KAA4C,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAE7F,OAAO,CAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAW,KAAK,CAAC,GAAG,EAAY,CAAC;QAC3C,MAAM,KAAK,GAAW,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAW,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAoB,EAAE,KAAK,EAAE,KAAiC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;QAE1G,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3D,OAAO,IAAI,CAAC;YACd,CAAC;YACA,KAA4C,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QACjE,CAAC;QAED,OAAO,KAAK,GAAG,CAAC,IAAI,qCAAqC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAyB,EAAE,OAA0B;QAC3D,IAAI,IAAI,GAA6E,IAAI,CAAC;QAE1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAA4B,EAAQ,EAAE;YACxD,MAAM,MAAM,GAAgC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAEvE,IAAI,CAAC,qCAAqC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;mBAChE,CAAC,qCAAqC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC/E,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAW,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAW,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAEnD,IAAI,CAAC,IAAI,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5F,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAA4B,IAAyC,CAAC,IAAI,CAAC;QAEvF,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACvF,CAAC;IAED,mCAAmC;IACnC,OAAO,CAAC,MAAc;QACpB,MAAM,IAAI,GAAuC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnE,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,CAAC;IAED,qGAAqG;IACrG,aAAa,CAAC,MAAc,EAAE,KAAsB;QAClD,MAAM,GAAG,GAAuC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAW,qCAAqC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAsC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;QAEpF,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,KAA6B,EAAW,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM;eACtE,qCAAqC,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;eACvE,qCAAqC,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC;aACrG,GAAG,CAAC,CAAC,KAA6B,EAAsB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9H,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc,EAAE,KAAsB,EAAE,QAAiB,KAAK;QACnE,MAAM,IAAI,GAAuC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnE,IAAI,CAAC,IAAI,IAAI,CAAC,qCAAqC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,SAAS,GAAyB,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAE1E,IAAI,SAAS,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC;QACD,MAAM,QAAQ,GAAoB,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAEpD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,KAAK,GAA2B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAA2B,CAAC;YAEhG,KAAK,CAAC,KAAK,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAE1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,wFAAwF;IACxF,cAAc,CAAC,cAAuB;QACpC,IAAI,CAAC,KAAK;aACP,MAAM,CAAC,CAAC,IAA4B,EAAW,EAAE,CAChD,CAAC,cAAc,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,IAAI,IAAI,CAAC,QAAQ,KAAK,cAAc,CAAC;aACvF,OAAO,CAAC,CAAC,IAA4B,EAAQ,EAAE;YAC9C,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,gFAAgF;IAChF,SAAS;QACP,MAAM,GAAG,GAAsB,EAAE,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAW,qCAAqC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEtF,IAAI,OAAO,KAAK,qCAAqC,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,GAAsB;QACjC,MAAM,MAAM,GAA0B,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;QAE1G,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,KAAK,MAAM,CAAE,MAAM,EAAE,IAAI,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAA2B,qCAAqC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAE7F,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAqD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAE5F,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACd,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9B,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAA8B,EAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAgC,CAAC;IAChI,CAAC;IAEO,IAAI,CAAC,MAAc;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAyB,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACtF,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,KAAkC;QAC1D,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACnI,CAAC;IAED,gGAAgG;IACxF,MAAM,CAAC,OAAO,CAAC,KAAsB,EAAE,KAAyB;QACtE,MAAM,KAAK,GAAW,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;QAEtE,OAAO,KAAK,KAAK,KAAK,CAAC,KAAK;eACvB,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM;eAClE,CAAC,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9E,CAAC;IAED,8BAA8B;IACtB,MAAM,CAAC,WAAW,CAAC,KAAwC,EAAE,OAA0B;QAC7F,IAAI,OAAO,CAAC,iBAAiB,IAAI,CAAC,KAAK,EAAE,wBAAwB,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAoC,KAAK,EAAE,QAAQ,IAAI,MAAM,CAAC;QAE5E,IAAI,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACzG,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,+GAA+G;IACvG,MAAM,CAAC,aAAa,CAAC,CAAoC,EAAE,CAAoC;QACrG,MAAM,aAAa,GAAY,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,CAAC,MAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACxH,MAAM,QAAQ,GAAoC,CAAC,EAAE,QAAQ,IAAI,MAAM,CAAC;QACxE,MAAM,QAAQ,GAAoC,CAAC,EAAE,QAAQ,IAAI,MAAM,CAAC;QACxE,IAAI,eAAwB,CAAC;QAE7B,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC7C,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtD,4DAA4D;YAC5D,eAAe,GAAG,QAAQ,KAAK,QAAQ,CAAC;QAC1C,CAAC;aAAM,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACtD,4EAA4E;YAC5E,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAW,EAAE,CAAE,QAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,CAAC;QAED,OAAO,aAAa,IAAI,eAAe,CAAC;IAC1C,CAAC;CACF;AA3QD,sFA2QC"}

package/build/_modules/game/_models/input-action.interface.d.ts

@@ -0,0 +1,84 @@
+/**
+ * BFR-WARFACTORY-017 — game input actions. The common layer owns the MECHANICS (bindings, guards, conflicts, flat
+ * persistence); the action ids and labels are the game's.
+ */
+/** ① What a binding matches on: the PHYSICAL key position (`code`, e.g. `KeyW` — layout-independent) or the produced
+ * character (`key`, e.g. `?`). Declared per binding. */
+export type DyFM_InputMatch_Type = 'code' | 'key';
+/** One physical input: the matched value + the required modifiers (unset = must NOT be held). */
+export interface DyFM_InputChord {
+    match: DyFM_InputMatch_Type;
+    value: string;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+    meta?: boolean;
+}
+/** ④ A binding slot of an action: the default chord + an optional PAYLOAD (e.g. speed hotkeys: `Digit3` → 3). */
+export interface DyFM_InputBindingSlot {
+    chord: DyFM_InputChord;
+    payload?: unknown;
+}
+/** ② The overlay condition of a guard. */
+export type DyFM_InputOverlayCondition_Type = 'none' | 'open' | 'any' | string[];
+/** ② When an action may fire — three ORTHOGONAL predicates instead of one `enabled` flag. */
+export interface DyFM_InputActionGuard {
+    /** Fire while an interactive element (input / textarea / button …) has focus? Default: `false` (typing wins). */
+    allowInInteractiveTarget?: boolean;
+    /**
+     * Overlay condition: `'none'` (no overlay open — default) · `'open'` (SOME overlay is open — e.g. close-overlay) ·
+     * `'any'` (open or not) · a list of overlay ids that must be on top.
+     */
+    overlays?: DyFM_InputOverlayCondition_Type;
+    /** Game phases the action is live in; unset = every phase. */
+    phases?: string[];
+}
+/** One action definition. */
+export interface DyFM_InputAction_Definition {
+    actionId: string;
+    label: string;
+    bindings: DyFM_InputBindingSlot[];
+    guard?: DyFM_InputActionGuard;
+    /** Higher wins when several actions match one event (tie → definition order). Default: `0`. */
+    priority?: number;
+}
+/** The runtime context a key event is resolved in. */
+export interface DyFM_InputContext {
+    /** An interactive element has focus. */
+    interactiveTarget: boolean;
+    /** The TOP open overlay id (`null` = none). */
+    openOverlay: string | null;
+    /** The current game phase. */
+    phase: string;
+}
+/** The subset of a `KeyboardEvent` the registry reads. */
+export interface DyFM_InputKeyEvent {
+    code: string;
+    key: string;
+    ctrlKey?: boolean;
+    altKey?: boolean;
+    shiftKey?: boolean;
+    metaKey?: boolean;
+}
+/** A resolved action — ONE per event (Escape never closes two layers). */
+export interface DyFM_InputResolution {
+    actionId: string;
+    slotId: string;
+    payload?: unknown;
+}
+/** A binding conflict: another slot has the same chord and their guards can be live at the same time. */
+export interface DyFM_InputConflict {
+    slotId: string;
+    otherSlotId: string;
+    chord: string;
+}
+/** ③ The flat, on-disk form: `slotId → chord string` (only the remapped chords; payloads stay in the definitions). */
+export type DyFM_InputFlatMap = Record<string, string>;
+/** What `applyFlatMap` did. */
+export interface DyFM_InputApplyReport {
+    applied: string[];
+    unknownSlots: string[];
+    invalidChords: string[];
+    conflicts: DyFM_InputConflict[];
+}
+//# sourceMappingURL=input-action.interface.d.ts.map

package/build/_modules/game/_models/input-action.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-action.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/input-action.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;wDACwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,KAAK,CAAC;AAElD,iGAAiG;AACjG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,iHAAiH;AACjH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,0CAA0C;AAC1C,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,EAAE,CAAC;AAEjF,6FAA6F;AAC7F,MAAM,WAAW,qBAAqB;IACpC,iHAAiH;IACjH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IAC3C,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yGAAyG;AACzG,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sHAAsH;AACtH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC"}

package/build/_modules/game/_models/input-action.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * BFR-WARFACTORY-017 — game input actions. The common layer owns the MECHANICS (bindings, guards, conflicts, flat
+ * persistence); the action ids and labels are the game's.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=input-action.interface.js.map

package/build/_modules/game/_models/input-action.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-action.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/input-action.interface.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/build/_modules/game/index.d.ts

@@ -18,6 +18,8 @@ export * from './_models/work-order-scheduler.control-model';
 export * from './_models/build-reservation.interface';
 export * from './_models/viewport.interface';
 export * from './_models/viewport.control-model';
+export * from './_models/input-action.interface';
+export * from './_models/input-action-registry.control-model';
 export * from './_collections/audio-mixer.util';
 export * from './_collections/audio-scale.util';
 export * from './_collections/game-save.util';

package/build/_modules/game/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AAGjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+CAA+C,CAAC;AAG9D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/build/_modules/game/index.js

@@ -23,6 +23,8 @@ tslib_1.__exportStar(require("./_models/work-order-scheduler.control-model"), ex
 tslib_1.__exportStar(require("./_models/build-reservation.interface"), exports);
 tslib_1.__exportStar(require("./_models/viewport.interface"), exports);
 tslib_1.__exportStar(require("./_models/viewport.control-model"), exports);
+tslib_1.__exportStar(require("./_models/input-action.interface"), exports);
+tslib_1.__exportStar(require("./_models/input-action-registry.control-model"), exports);
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/audio-mixer.util"), exports);
 tslib_1.__exportStar(require("./_collections/audio-scale.util"), exports);

package/build/_modules/game/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,iFAAuD;AACvD,mFAAyD;AACzD,gFAAsD;AACtD,8EAAoD;AACpD,0EAAgD;AAChD,kFAAwD;AACxD,gFAAsD;AACtD,qFAA2D;AAC3D,yFAA+D;AAC/D,4EAAkD;AAClD,gFAAsD;AACtD,+EAAqD;AACrD,mFAAyD;AACzD,wEAA8C;AAC9C,mFAAyD;AACzD,uFAA6D;AAC7D,gFAAsD;AACtD,uEAA6C;AAC7C,2EAAiD;AAEjD,cAAc;AACd,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,gFAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,iFAAuD;AACvD,mFAAyD;AACzD,gFAAsD;AACtD,8EAAoD;AACpD,0EAAgD;AAChD,kFAAwD;AACxD,gFAAsD;AACtD,qFAA2D;AAC3D,yFAA+D;AAC/D,4EAAkD;AAClD,gFAAsD;AACtD,+EAAqD;AACrD,mFAAyD;AACzD,wEAA8C;AAC9C,mFAAyD;AACzD,uFAA6D;AAC7D,gFAAsD;AACtD,uEAA6C;AAC7C,2EAAiD;AACjD,2EAAiD;AACjD,wFAA8D;AAE9D,cAAc;AACd,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,gFAAsD"}

package/build-esm/_modules/game/_models/input-action-registry.control-model.js

@@ -0,0 +1,230 @@
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+/**
+ * BFR-WARFACTORY-017 — typed input-action registry: default bindings, per-binding `code` / `key` matching, three
+ * orthogonal guards, ONE resolution per event, conflict detection, reset, and a flat `slotId → chord` map for disk.
+ *
+ * Slot ids are `<actionId>#<index>` (the index in the definition's `bindings`) — stable across remaps; a remap only
+ * changes a slot's chord, never its payload.
+ */
+export class DyFM_InputActionRegistry_ControlModel {
+    actions;
+    slots = [];
+    /** Registers the actions; duplicate ids or an action without bindings throw `DYFM-INPUT-DEFINITION`. */
+    constructor(actions) {
+        const seen = new Set();
+        for (const action of actions) {
+            if (!action?.actionId || seen.has(action.actionId) || !action.bindings?.length
+                || action.bindings.some((slot) => !DyFM_InputActionRegistry_ControlModel.validChord(slot?.chord))) {
+                throw new DyFM_Error({
+                    message: `DyFM_InputActionRegistry: action ids must be unique, with ≥ 1 valid binding (${action?.actionId})`,
+                    errorCode: 'DYFM-INPUT-DEFINITION',
+                    issuerService: 'DyFM_InputActionRegistry_ControlModel',
+                });
+            }
+            seen.add(action.actionId);
+        }
+        this.actions = actions.map((a) => ({ ...a }));
+        for (const action of this.actions) {
+            action.bindings.forEach((slot, index) => {
+                this.slots.push({
+                    slotId: `${action.actionId}#${index}`,
+                    actionId: action.actionId,
+                    defaultChord: { ...slot.chord },
+                    chord: { ...slot.chord },
+                    payload: slot.payload,
+                });
+            });
+        }
+    }
+    /** The chord string form: `ctrl+shift+code:KeyS` / `key:?` (modifiers in a fixed order). */
+    static formatChord(chord) {
+        const modifiers = ['ctrl', 'alt', 'shift', 'meta']
+            .filter((m) => chord[m] === true);
+        return [...modifiers, `${chord.match}:${chord.value}`].join('+');
+    }
+    /** Parses a chord string; `null` when it is not one. */
+    static parseChord(text) {
+        if (typeof text !== 'string' || !text) {
+            return null;
+        }
+        const parts = text.split('+');
+        const last = parts.pop();
+        const colon = last.indexOf(':');
+        const match = last.slice(0, colon);
+        const chord = { match: match, value: last.slice(colon + 1) };
+        for (const modifier of parts) {
+            if (!['ctrl', 'alt', 'shift', 'meta'].includes(modifier)) {
+                return null;
+            }
+            chord[modifier] = true;
+        }
+        return colon > 0 && DyFM_InputActionRegistry_ControlModel.validChord(chord) ? chord : null;
+    }
+    /**
+     * Resolves a key event to AT MOST ONE action: the matching slots whose guard is live in `context`, highest
+     * `priority` first, then definition order.
+     */
+    resolve(event, context) {
+        let best = null;
+        this.slots.forEach((slot) => {
+            const action = this.action(slot.actionId);
+            if (!DyFM_InputActionRegistry_ControlModel.matches(slot.chord, event)
+                || !DyFM_InputActionRegistry_ControlModel.guardAllows(action.guard, context)) {
+                return;
+            }
+            const priority = action.priority ?? 0;
+            const order = this.actions.indexOf(action);
+            if (!best || priority > best.priority || (priority === best.priority && order < best.order)) {
+                best = { slot: slot, priority: priority, order: order };
+            }
+        });
+        if (!best) {
+            return null;
+        }
+        const chosen = best.slot;
+        return { actionId: chosen.actionId, slotId: chosen.slotId, payload: chosen.payload };
+    }
+    /** The current chord of a slot. */
+    chordOf(slotId) {
+        const slot = this.slot(slotId);
+        return slot ? { ...slot.chord } : undefined;
+    }
+    /** Slots whose chord equals `chord` and whose guards can be live together with `slotId`'s action. */
+    findConflicts(slotId, chord) {
+        const own = this.slot(slotId);
+        if (!own) {
+            return [];
+        }
+        const text = DyFM_InputActionRegistry_ControlModel.formatChord(chord);
+        const ownGuard = this.action(own.actionId).guard;
+        return this.slots
+            .filter((other) => other.slotId !== slotId
+            && DyFM_InputActionRegistry_ControlModel.formatChord(other.chord) === text
+            && DyFM_InputActionRegistry_ControlModel.guardsOverlap(ownGuard, this.action(other.actionId).guard))
+            .map((other) => ({ slotId: slotId, otherSlotId: other.slotId, chord: text }));
+    }
+    /**
+     * Remaps a slot. A conflicting chord is REFUSED (the conflicts are returned) unless `force` — then the conflicting
+     * slots SWAP: they take this slot's previous chord (resetting them to their defaults would not help when a default
+     * is the contested chord itself).
+     */
+    rebind(slotId, chord, force = false) {
+        const slot = this.slot(slotId);
+        if (!slot || !DyFM_InputActionRegistry_ControlModel.validChord(chord)) {
+            return { ok: false, conflicts: [] };
+        }
+        const conflicts = this.findConflicts(slotId, chord);
+        if (conflicts.length && !force) {
+            return { ok: false, conflicts: conflicts };
+        }
+        const previous = { ...slot.chord };
+        for (const conflict of conflicts) {
+            const other = this.slot(conflict.otherSlotId);
+            other.chord = { ...previous };
+        }
+        slot.chord = { ...chord };
+        return { ok: true, conflicts: conflicts };
+    }
+    /** Resets one slot, one action's slots, or (no argument) everything to the defaults. */
+    resetToDefault(slotOrActionId) {
+        this.slots
+            .filter((slot) => !slotOrActionId || slot.slotId === slotOrActionId || slot.actionId === slotOrActionId)
+            .forEach((slot) => {
+            slot.chord = { ...slot.defaultChord };
+        });
+    }
+    /** ③ The flat on-disk form — ONLY the slots that differ from their defaults. */
+    toFlatMap() {
+        const map = {};
+        for (const slot of this.slots) {
+            const current = DyFM_InputActionRegistry_ControlModel.formatChord(slot.chord);
+            if (current !== DyFM_InputActionRegistry_ControlModel.formatChord(slot.defaultChord)) {
+                map[slot.slotId] = current;
+            }
+        }
+        return map;
+    }
+    /**
+     * ③ Applies a stored flat map on top of the defaults: unknown slots (an action the game removed) and unparsable
+     * chords are skipped and reported; a stored chord that now conflicts is NOT applied (reported) — a stale save
+     * cannot silently steal a key.
+     */
+    applyFlatMap(map) {
+        const report = { applied: [], unknownSlots: [], invalidChords: [], conflicts: [] };
+        this.resetToDefault();
+        for (const [slotId, text] of Object.entries(map ?? {})) {
+            const chord = DyFM_InputActionRegistry_ControlModel.parseChord(text);
+            if (!this.slot(slotId)) {
+                report.unknownSlots.push(slotId);
+            }
+            else if (!chord) {
+                report.invalidChords.push(slotId);
+            }
+            else {
+                const result = this.rebind(slotId, chord);
+                if (result.ok) {
+                    report.applied.push(slotId);
+                }
+                else {
+                    report.conflicts.push(...result.conflicts);
+                }
+            }
+        }
+        return report;
+    }
+    action(actionId) {
+        return this.actions.find((a) => a.actionId === actionId);
+    }
+    slot(slotId) {
+        return this.slots.find((s) => s.slotId === slotId);
+    }
+    static validChord(chord) {
+        return !!chord && (chord.match === 'code' || chord.match === 'key') && typeof chord.value === 'string' && chord.value.length > 0;
+    }
+    /** ① code vs key, and the modifiers must match exactly (an unset modifier must not be held). */
+    static matches(chord, event) {
+        const value = chord.match === 'code' ? event.code : event.key;
+        return value === chord.value
+            && !!chord.ctrl === !!event.ctrlKey && !!chord.alt === !!event.altKey
+            && !!chord.shift === !!event.shiftKey && !!chord.meta === !!event.metaKey;
+    }
+    /** ② The three predicates. */
+    static guardAllows(guard, context) {
+        if (context.interactiveTarget && !guard?.allowInInteractiveTarget) {
+            return false;
+        }
+        const overlays = guard?.overlays ?? 'none';
+        if (overlays === 'none' && context.openOverlay !== null) {
+            return false;
+        }
+        if (overlays === 'open' && context.openOverlay === null) {
+            return false;
+        }
+        if (Array.isArray(overlays) && (context.openOverlay === null || !overlays.includes(context.openOverlay))) {
+            return false;
+        }
+        return !guard?.phases || guard.phases.includes(context.phase);
+    }
+    /** Can two actions be live in the same context? (phases intersect AND overlay conditions can hold together) */
+    static guardsOverlap(a, b) {
+        const phasesOverlap = !a?.phases || !b?.phases || a.phases.some((p) => b.phases.includes(p));
+        const overlayA = a?.overlays ?? 'none';
+        const overlayB = b?.overlays ?? 'none';
+        let overlaysOverlap;
+        if (overlayA === 'any' || overlayB === 'any') {
+            overlaysOverlap = true;
+        }
+        else if (overlayA === 'none' || overlayB === 'none') {
+            // 'none' only overlaps 'none' (an open overlay excludes it)
+            overlaysOverlap = overlayA === overlayB;
+        }
+        else if (overlayA === 'open' || overlayB === 'open') {
+            // 'open' overlaps 'open' and any overlay list (both need an overlay on top)
+            overlaysOverlap = true;
+        }
+        else {
+            overlaysOverlap = overlayA.some((o) => overlayB.includes(o));
+        }
+        return phasesOverlap && overlaysOverlap;
+    }
+}

package/build-esm/_modules/game/_models/input-action.interface.js

@@ -0,0 +1,5 @@
+/**
+ * BFR-WARFACTORY-017 — game input actions. The common layer owns the MECHANICS (bindings, guards, conflicts, flat
+ * persistence); the action ids and labels are the game's.
+ */
+export {};

package/build-esm/_modules/game/index.js

@@ -20,6 +20,8 @@ export * from './_models/work-order-scheduler.control-model';
 export * from './_models/build-reservation.interface';
 export * from './_models/viewport.interface';
 export * from './_models/viewport.control-model';
+export * from './_models/input-action.interface';
+export * from './_models/input-action-registry.control-model';
 // COLLECTIONS
 export * from './_collections/audio-mixer.util';
 export * from './_collections/audio-scale.util';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "1.20.100",
+  "version": "1.20.101",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",