@futdevpro/fsm-dynamo 1.20.97 → 1.20.100

package/build/_modules/game/_models/viewport.control-model.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_Viewport_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * BFR-WARFACTORY-013 — framework-independent zoom / pan viewport. It is deliberately NOT "the camera": the same model
+ * drives a world canvas and a DOM panel (e.g. a zoomable tech tree). Input handling (pointer, wheel, keys) belongs to
+ * a UI adapter that calls these methods.
+ *
+ * - `worldToScreen` / `screenToWorld` — the only transform; the screen centre shows `center`.
+ * - `zoomAt(screenPoint, factor)` — the world point UNDER the pointer stays under the pointer (wheel / pinch feel).
+ * - `panByScreen(dx, dy)` — drag: the content follows the pointer at any zoom.
+ * - `move(direction, speed, elapsedSeconds)` — elapsed-time keyboard panning; each step is capped
+ *   (`maxMoveStepSeconds`), so a hitch never makes the camera jump; speed is in SCREEN px/s (same feel at any zoom).
+ * - Zoom is clamped to [minZoom, maxZoom], the centre to `worldBounds`; non-finite input is ignored, never stored.
+ */
+class DyFM_Viewport_ControlModel {
+    screenWidth;
+    screenHeight;
+    minZoom;
+    maxZoom;
+    bounds;
+    stepFactor;
+    maxMoveStep;
+    centerPoint = { x: 0, y: 0 };
+    zoomValue = 1;
+    /** Creates the viewport; an invalid configuration throws `DYFM-VIEWPORT-CONFIG`. */
+    constructor(config) {
+        this.minZoom = config.minZoom ?? 0.25;
+        this.maxZoom = config.maxZoom ?? 4;
+        this.stepFactor = config.zoomStepFactor ?? 1.1;
+        this.maxMoveStep = config.maxMoveStepSeconds ?? 0.1;
+        this.bounds = config.worldBounds;
+        const positive = (value) => Number.isFinite(value) && value > 0;
+        if (!positive(config.screenWidth) || !positive(config.screenHeight) || !positive(this.minZoom)
+            || !(this.maxZoom >= this.minZoom) || !(this.stepFactor > 1) || !positive(this.maxMoveStep)
+            || (this.bounds && !(this.bounds.maxX >= this.bounds.minX && this.bounds.maxY >= this.bounds.minY))) {
+            throw new error_control_model_1.DyFM_Error({
+                message: 'DyFM_Viewport: needs a positive screen size, 0 < minZoom ≤ maxZoom, zoomStepFactor > 1, '
+                    + 'maxMoveStepSeconds > 0 and ordered worldBounds',
+                errorCode: 'DYFM-VIEWPORT-CONFIG',
+                issuerService: 'DyFM_Viewport_ControlModel',
+            });
+        }
+        this.screenWidth = config.screenWidth;
+        this.screenHeight = config.screenHeight;
+        this.zoomValue = this.clampZoom(1);
+        this.centerPoint = this.clampCenter({ x: 0, y: 0 });
+    }
+    /** The world point shown at the screen centre. */
+    get center() {
+        return { ...this.centerPoint };
+    }
+    /** Screen pixels per world unit. */
+    get zoom() {
+        return this.zoomValue;
+    }
+    /** World → screen pixels. */
+    worldToScreen(world) {
+        return {
+            x: (world.x - this.centerPoint.x) * this.zoomValue + this.screenWidth / 2,
+            y: (world.y - this.centerPoint.y) * this.zoomValue + this.screenHeight / 2,
+        };
+    }
+    /** Screen pixels → world. */
+    screenToWorld(screen) {
+        return {
+            x: (screen.x - this.screenWidth / 2) / this.zoomValue + this.centerPoint.x,
+            y: (screen.y - this.screenHeight / 2) / this.zoomValue + this.centerPoint.y,
+        };
+    }
+    /** Sets the zoom (clamped), keeping the centre. */
+    setZoom(zoom) {
+        if (Number.isFinite(zoom)) {
+            this.zoomValue = this.clampZoom(zoom);
+        }
+    }
+    /** Zooms by `factor` keeping the world point under `screenPoint` fixed on screen (then clamps). */
+    zoomAt(screenPoint, factor) {
+        if (!Number.isFinite(factor) || factor <= 0 || !Number.isFinite(screenPoint?.x) || !Number.isFinite(screenPoint?.y)) {
+            return;
+        }
+        const anchor = this.screenToWorld(screenPoint);
+        this.zoomValue = this.clampZoom(this.zoomValue * factor);
+        // re-centre so that `anchor` maps back to `screenPoint`
+        this.centerPoint = this.clampCenter({
+            x: anchor.x - (screenPoint.x - this.screenWidth / 2) / this.zoomValue,
+            y: anchor.y - (screenPoint.y - this.screenHeight / 2) / this.zoomValue,
+        });
+    }
+    /** `steps` notches (+ in, − out) at `screenPoint` (default: the screen centre). */
+    zoomStep(steps, screenPoint) {
+        if (Number.isFinite(steps) && steps !== 0) {
+            this.zoomAt(screenPoint ?? { x: this.screenWidth / 2, y: this.screenHeight / 2 }, this.stepFactor ** steps);
+        }
+    }
+    /** Drag by a screen delta: the content moves WITH the pointer. */
+    panByScreen(dx, dy) {
+        if (Number.isFinite(dx) && Number.isFinite(dy)) {
+            this.centerPoint = this.clampCenter({
+                x: this.centerPoint.x - dx / this.zoomValue,
+                y: this.centerPoint.y - dy / this.zoomValue,
+            });
+        }
+    }
+    /**
+     * Elapsed-time panning (keyboard): `direction` is normalised, `speedScreenPxPerSecond` is screen speed, the elapsed
+     * time is capped at `maxMoveStepSeconds` per call. Returns the world distance actually moved.
+     */
+    move(direction, speedScreenPxPerSecond, elapsedSeconds) {
+        const length = Math.hypot(direction?.x ?? NaN, direction?.y ?? NaN);
+        if (!Number.isFinite(length) || length === 0 || !Number.isFinite(speedScreenPxPerSecond)
+            || speedScreenPxPerSecond <= 0 || !Number.isFinite(elapsedSeconds) || elapsedSeconds <= 0) {
+            return 0;
+        }
+        const seconds = Math.min(elapsedSeconds, this.maxMoveStep);
+        const worldDistance = speedScreenPxPerSecond * seconds / this.zoomValue;
+        const before = this.centerPoint;
+        this.centerPoint = this.clampCenter({
+            x: before.x + direction.x / length * worldDistance,
+            y: before.y + direction.y / length * worldDistance,
+        });
+        return Math.hypot(this.centerPoint.x - before.x, this.centerPoint.y - before.y);
+    }
+    /** Centres on a world point (clamped). */
+    centerOn(world) {
+        if (Number.isFinite(world?.x) && Number.isFinite(world?.y)) {
+            this.centerPoint = this.clampCenter(world);
+        }
+    }
+    /** The screen changed size (e.g. a window resize); the centre stays. */
+    resize(screenWidth, screenHeight) {
+        if (Number.isFinite(screenWidth) && screenWidth > 0 && Number.isFinite(screenHeight) && screenHeight > 0) {
+            this.screenWidth = screenWidth;
+            this.screenHeight = screenHeight;
+        }
+    }
+    /** Save state. */
+    exportState() {
+        return { schemaVersion: 1, center: this.center, zoom: this.zoomValue };
+    }
+    /** Restore state (clamped to THIS viewport's limits); `false` and no change when unreadable. */
+    importState(state) {
+        const candidate = state && typeof state === 'object' ? state : null;
+        if (!candidate || candidate.schemaVersion !== 1 || !Number.isFinite(candidate.zoom)
+            || !Number.isFinite(candidate.center?.x) || !Number.isFinite(candidate.center?.y)) {
+            return false;
+        }
+        this.zoomValue = this.clampZoom(candidate.zoom);
+        this.centerPoint = this.clampCenter(candidate.center);
+        return true;
+    }
+    clampZoom(zoom) {
+        return Math.min(this.maxZoom, Math.max(this.minZoom, zoom));
+    }
+    clampCenter(point) {
+        if (!this.bounds) {
+            return { x: point.x, y: point.y };
+        }
+        return {
+            x: Math.min(this.bounds.maxX, Math.max(this.bounds.minX, point.x)),
+            y: Math.min(this.bounds.maxY, Math.max(this.bounds.minY, point.y)),
+        };
+    }
+}
+exports.DyFM_Viewport_ControlModel = DyFM_Viewport_ControlModel;
+//# sourceMappingURL=viewport.control-model.js.map

package/build/_modules/game/_models/viewport.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/viewport.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/game/_models/viewport.interface.d.ts

@@ -0,0 +1,35 @@
+/** BFR-WARFACTORY-013 — a 2D point (world units or screen pixels, depending on the call). */
+export interface DyFM_Viewport_Point {
+    x: number;
+    y: number;
+}
+/** BFR-WARFACTORY-013 — `DyFM_Viewport_ControlModel` configuration (one model for a world canvas AND a DOM panel). */
+export interface DyFM_Viewport_Config {
+    /** Screen size in pixels (update with `resize`). */
+    screenWidth: number;
+    screenHeight: number;
+    /** Zoom limits (1 = one world unit per pixel). Defaults: `0.25` .. `4`. */
+    minZoom?: number;
+    maxZoom?: number;
+    /** Optional world rectangle the CENTER is kept inside. */
+    worldBounds?: {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    };
+    /** Multiplicative zoom step for `zoomStep(±n)` (e.g. a wheel notch). Default: `1.1`. */
+    zoomStepFactor?: number;
+    /**
+     * Largest elapsed time one `move` step may use (seconds) — a frame hitch / tab switch must not become a camera
+     * JUMP. Default: `0.1`.
+     */
+    maxMoveStepSeconds?: number;
+}
+/** BFR-WARFACTORY-013 — the save / restore state. */
+export interface DyFM_Viewport_State {
+    schemaVersion: 1;
+    center: DyFM_Viewport_Point;
+    zoom: number;
+}
+//# sourceMappingURL=viewport.interface.d.ts.map

package/build/_modules/game/_models/viewport.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/viewport.interface.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,WAAW,mBAAmB;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,sHAAsH;AACtH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,wFAAwF;IACxF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd"}

package/build/_modules/game/_models/viewport.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=viewport.interface.js.map

package/build/_modules/game/_models/viewport.interface.js.map

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

package/build/_modules/game/_models/work-order-scheduler.control-model.d.ts

@@ -0,0 +1,55 @@
+import { DyFM_WorkOrder_State, DyFM_WorkOrderScheduler_AdvanceResult, DyFM_WorkOrderScheduler_CancelResult, DyFM_WorkOrderScheduler_Config, DyFM_WorkOrderScheduler_HealReport, DyFM_WorkOrderScheduler_State } from './work-order-scheduler.interface';
+/**
+ * BFR-WARFACTORY-012 — headless, cancel-safe scheduler of interchangeable workers over parallel work orders.
+ *
+ * Guarantees (each pinned by a spec):
+ * - **Release is structural, not a happy-path step:** an assignment exists only as `worker → order`; cancelling an
+ *   order, completing it or removing (destroying) a worker deletes the entry in the same call ⇒ no stranded worker.
+ * - **Every pending order gets ≥ 1 worker when possible:** idle workers first; if none is idle, one is moved from the
+ *   order that has the most (only from an order with > 1) — so one plan cannot starve the others ("frozen" plans).
+ * - **Stable least-assigned distribution:** extra workers go to the order with the fewest (tie → the earliest order);
+ *   existing assignments are not reshuffled.
+ * - **Self-healing import:** stale ownership (unknown worker / order, duplicates) is dropped and REPORTED; importing
+ *   the same state twice gives the same result.
+ * No clock, no RNG: time comes in through `advance(simulationSeconds)` (e.g. from `DyFM_SimulationClock_ControlModel`).
+ */
+export declare class DyFM_WorkOrderScheduler_ControlModel {
+    private readonly rate;
+    private orders;
+    private workerIds;
+    /** workerId → orderId (the ONLY ownership record). */
+    private assignments;
+    /** Creates the scheduler; an invalid rate throws `DYFM-WORK-ORDER-CONFIG`. */
+    constructor(config?: DyFM_WorkOrderScheduler_Config);
+    /** Adds a work order at the end of the FIFO; a duplicate id or non-positive work throws `DYFM-WORK-ORDER-INVALID`. */
+    addOrder(order: {
+        orderId: string;
+        work: number;
+        progress?: number;
+    }): void;
+    /** Adds an (idle) worker; duplicates are ignored. */
+    addWorker(workerId: string): void;
+    /** Removes (destroys) a worker; its assignment goes with it. Idempotent. */
+    removeWorker(workerId: string): void;
+    /** Cancels an order: removes it and releases its workers in the same call. Idempotent (unknown → found: false). */
+    cancel(orderId: string): DyFM_WorkOrderScheduler_CancelResult;
+    /** Advances every order by its workers × rate × seconds; completed orders leave and free their workers. */
+    advance(simulationSeconds: number): DyFM_WorkOrderScheduler_AdvanceResult;
+    /** The workers of an order, in assignment order. */
+    workersOf(orderId: string): string[];
+    /** The order a worker is on (`undefined` = idle). */
+    orderOf(workerId: string): string | undefined;
+    /** Current orders (copies, FIFO). */
+    getOrders(): DyFM_WorkOrder_State[];
+    /** The save/load snapshot. */
+    exportState(): DyFM_WorkOrderScheduler_State;
+    /**
+     * Restores a snapshot and HEALS stale ownership (assignments to unknown workers / orders, duplicates): dropped and
+     * reported, then the distribution rules re-apply. An unreadable snapshot throws `DYFM-WORK-ORDER-STATE`.
+     */
+    importState(state: DyFM_WorkOrderScheduler_State): DyFM_WorkOrderScheduler_HealReport;
+    /** Applies the distribution rules (stable: existing valid assignments are kept). */
+    private rebalance;
+    private static error;
+}
+//# sourceMappingURL=work-order-scheduler.control-model.d.ts.map

package/build/_modules/game/_models/work-order-scheduler.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,qCAAqC,EACrC,oCAAoC,EACpC,8BAA8B,EAC9B,kCAAkC,EAClC,6BAA6B,EAC9B,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,qBAAa,oCAAoC;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAAgB;IACjC,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAkC;IAErD,8EAA8E;gBAClE,MAAM,GAAE,8BAAmC;IASvD,sHAAsH;IACtH,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU3E,qDAAqD;IACrD,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOjC,4EAA4E;IAC5E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMpC,mHAAmH;IACnH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,oCAAoC;IAgB7D,2GAA2G;IAC3G,OAAO,CAAC,iBAAiB,EAAE,MAAM,GAAG,qCAAqC;IA0BzE,oDAAoD;IACpD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAKpC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI7C,qCAAqC;IACrC,SAAS,IAAI,oBAAoB,EAAE;IAInC,8BAA8B;IAC9B,WAAW,IAAI,6BAA6B;IAS5C;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,6BAA6B,GAAG,kCAAkC;IAmDrF,oFAAoF;IACpF,OAAO,CAAC,SAAS;IA0CjB,OAAO,CAAC,MAAM,CAAC,KAAK;CAOrB"}

package/build/_modules/game/_models/work-order-scheduler.control-model.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_WorkOrderScheduler_ControlModel = void 0;
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+/**
+ * BFR-WARFACTORY-012 — headless, cancel-safe scheduler of interchangeable workers over parallel work orders.
+ *
+ * Guarantees (each pinned by a spec):
+ * - **Release is structural, not a happy-path step:** an assignment exists only as `worker → order`; cancelling an
+ *   order, completing it or removing (destroying) a worker deletes the entry in the same call ⇒ no stranded worker.
+ * - **Every pending order gets ≥ 1 worker when possible:** idle workers first; if none is idle, one is moved from the
+ *   order that has the most (only from an order with > 1) — so one plan cannot starve the others ("frozen" plans).
+ * - **Stable least-assigned distribution:** extra workers go to the order with the fewest (tie → the earliest order);
+ *   existing assignments are not reshuffled.
+ * - **Self-healing import:** stale ownership (unknown worker / order, duplicates) is dropped and REPORTED; importing
+ *   the same state twice gives the same result.
+ * No clock, no RNG: time comes in through `advance(simulationSeconds)` (e.g. from `DyFM_SimulationClock_ControlModel`).
+ */
+class DyFM_WorkOrderScheduler_ControlModel {
+    rate;
+    orders = [];
+    workerIds = [];
+    /** workerId → orderId (the ONLY ownership record). */
+    assignments = new Map();
+    /** Creates the scheduler; an invalid rate throws `DYFM-WORK-ORDER-CONFIG`. */
+    constructor(config = {}) {
+        const rate = config.workPerWorkerPerSecond ?? 1;
+        if (!Number.isFinite(rate) || rate <= 0) {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-CONFIG', `workPerWorkerPerSecond must be > 0 (${rate})`);
+        }
+        this.rate = rate;
+    }
+    /** Adds a work order at the end of the FIFO; a duplicate id or non-positive work throws `DYFM-WORK-ORDER-INVALID`. */
+    addOrder(order) {
+        if (!order?.orderId || this.orders.some((o) => o.orderId === order.orderId)
+            || !Number.isFinite(order.work) || order.work <= 0) {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-INVALID', `order needs a unique orderId and work > 0 (${order?.orderId})`);
+        }
+        this.orders.push({ orderId: order.orderId, work: order.work, progress: Math.max(0, order.progress ?? 0) });
+        this.rebalance();
+    }
+    /** Adds an (idle) worker; duplicates are ignored. */
+    addWorker(workerId) {
+        if (workerId && !this.workerIds.includes(workerId)) {
+            this.workerIds.push(workerId);
+            this.rebalance();
+        }
+    }
+    /** Removes (destroys) a worker; its assignment goes with it. Idempotent. */
+    removeWorker(workerId) {
+        this.workerIds = this.workerIds.filter((id) => id !== workerId);
+        this.assignments.delete(workerId);
+        this.rebalance();
+    }
+    /** Cancels an order: removes it and releases its workers in the same call. Idempotent (unknown → found: false). */
+    cancel(orderId) {
+        const order = this.orders.find((o) => o.orderId === orderId);
+        if (!order) {
+            return { found: false, releasedWorkerIds: [], progressRatio: 0 };
+        }
+        const released = this.workersOf(orderId);
+        this.orders = this.orders.filter((o) => o.orderId !== orderId);
+        released.forEach((workerId) => this.assignments.delete(workerId));
+        this.rebalance();
+        return { found: true, releasedWorkerIds: released, progressRatio: Math.min(1, order.progress / order.work) };
+    }
+    /** Advances every order by its workers × rate × seconds; completed orders leave and free their workers. */
+    advance(simulationSeconds) {
+        if (!Number.isFinite(simulationSeconds) || simulationSeconds <= 0) {
+            return { completedOrderIds: [] };
+        }
+        const completed = [];
+        for (const order of this.orders) {
+            order.progress += this.workersOf(order.orderId).length * this.rate * simulationSeconds;
+            if (order.progress >= order.work) {
+                completed.push(order.orderId);
+            }
+        }
+        if (completed.length) {
+            this.orders = this.orders.filter((o) => !completed.includes(o.orderId));
+            for (const [workerId, orderId] of [...this.assignments]) {
+                if (completed.includes(orderId)) {
+                    this.assignments.delete(workerId);
+                }
+            }
+            this.rebalance();
+        }
+        return { completedOrderIds: completed };
+    }
+    /** The workers of an order, in assignment order. */
+    workersOf(orderId) {
+        return [...this.assignments].filter(([, id]) => id === orderId)
+            .map(([workerId]) => workerId);
+    }
+    /** The order a worker is on (`undefined` = idle). */
+    orderOf(workerId) {
+        return this.assignments.get(workerId);
+    }
+    /** Current orders (copies, FIFO). */
+    getOrders() {
+        return this.orders.map((o) => ({ ...o }));
+    }
+    /** The save/load snapshot. */
+    exportState() {
+        return {
+            schemaVersion: 1,
+            orders: this.getOrders(),
+            workerIds: [...this.workerIds],
+            assignments: Object.fromEntries(this.assignments),
+        };
+    }
+    /**
+     * Restores a snapshot and HEALS stale ownership (assignments to unknown workers / orders, duplicates): dropped and
+     * reported, then the distribution rules re-apply. An unreadable snapshot throws `DYFM-WORK-ORDER-STATE`.
+     */
+    importState(state) {
+        if (!state || state.schemaVersion !== 1 || !Array.isArray(state.orders) || !Array.isArray(state.workerIds)
+            || !state.assignments || typeof state.assignments !== 'object') {
+            throw DyFM_WorkOrderScheduler_ControlModel.error('DYFM-WORK-ORDER-STATE', 'unreadable scheduler snapshot');
+        }
+        const report = { droppedUnknownWorkers: [], droppedUnknownOrders: [], skippedDuplicates: [] };
+        const orders = [];
+        for (const order of state.orders) {
+            if (!order?.orderId || orders.some((o) => o.orderId === order.orderId)
+                || !Number.isFinite(order.work) || order.work <= 0) {
+                report.skippedDuplicates.push(String(order?.orderId));
+                continue;
+            }
+            if (Number(order.progress) >= order.work) {
+                continue; // a completed order is not "active" — its assignments heal below
+            }
+            orders.push({ orderId: order.orderId, work: order.work, progress: Math.max(0, Number(order.progress) || 0) });
+        }
+        const workerIds = [];
+        for (const workerId of state.workerIds) {
+            if (!workerId || workerIds.includes(workerId)) {
+                report.skippedDuplicates.push(String(workerId));
+                continue;
+            }
+            workerIds.push(workerId);
+        }
+        const assignments = new Map();
+        for (const [workerId, orderId] of Object.entries(state.assignments)) {
+            if (!workerIds.includes(workerId)) {
+                report.droppedUnknownWorkers.push(workerId);
+            }
+            else if (!orders.some((o) => o.orderId === orderId)) {
+                report.droppedUnknownOrders.push(`${workerId}→${orderId}`);
+            }
+            else {
+                assignments.set(workerId, orderId);
+            }
+        }
+        this.orders = orders;
+        this.workerIds = workerIds;
+        this.assignments = assignments;
+        this.rebalance();
+        return report;
+    }
+    /** Applies the distribution rules (stable: existing valid assignments are kept). */
+    rebalance() {
+        const count = (orderId) => this.workersOf(orderId).length;
+        const idle = () => this.workerIds.filter((id) => !this.assignments.has(id));
+        // 1) every order without a worker gets one: an idle worker, else one moved from the richest order (> 1)
+        for (const order of this.orders) {
+            if (count(order.orderId) > 0) {
+                continue;
+            }
+            const free = idle()[0];
+            if (free) {
+                this.assignments.set(free, order.orderId);
+                continue;
+            }
+            const donor = [...this.orders]
+                .filter((o) => count(o.orderId) > 1)
+                .sort((a, b) => count(b.orderId) - count(a.orderId) || this.orders.indexOf(b) - this.orders.indexOf(a))[0];
+            if (donor) {
+                const moved = this.workersOf(donor.orderId).slice(-1)[0];
+                this.assignments.set(moved, order.orderId);
+            }
+        }
+        // 2) the remaining idle workers go to the least-assigned order (tie → the earliest)
+        for (const workerId of idle()) {
+            const target = [...this.orders]
+                .sort((a, b) => count(a.orderId) - count(b.orderId) || this.orders.indexOf(a) - this.orders.indexOf(b))[0];
+            if (!target) {
+                return;
+            }
+            this.assignments.set(workerId, target.orderId);
+        }
+    }
+    static error(code, message) {
+        return new error_control_model_1.DyFM_Error({
+            message: `DyFM_WorkOrderScheduler: ${message}`,
+            errorCode: code,
+            issuerService: 'DyFM_WorkOrderScheduler_ControlModel',
+        });
+    }
+}
+exports.DyFM_WorkOrderScheduler_ControlModel = DyFM_WorkOrderScheduler_ControlModel;
+//# sourceMappingURL=work-order-scheduler.control-model.js.map

package/build/_modules/game/_models/work-order-scheduler.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/game/_models/work-order-scheduler.interface.d.ts

@@ -0,0 +1,43 @@
+/** BFR-WARFACTORY-012 — `DyFM_WorkOrderScheduler_ControlModel` configuration. */
+export interface DyFM_WorkOrderScheduler_Config {
+    /** Work units one worker does per simulation second. Default: `1`. */
+    workPerWorkerPerSecond?: number;
+}
+/** One work order (FIFO priority = insertion order). */
+export interface DyFM_WorkOrder_State {
+    orderId: string;
+    /** Total work units needed. */
+    work: number;
+    /** Work units done so far. */
+    progress: number;
+}
+/** The save/load snapshot (versioned). */
+export interface DyFM_WorkOrderScheduler_State {
+    schemaVersion: 1;
+    orders: DyFM_WorkOrder_State[];
+    workerIds: string[];
+    /** workerId → orderId. On import, stale entries are healed (dropped), never trusted. */
+    assignments: Record<string, string>;
+}
+/** What `importState` repaired — stale ownership is reported, not silently dropped. */
+export interface DyFM_WorkOrderScheduler_HealReport {
+    /** Assignments whose worker no longer exists. */
+    droppedUnknownWorkers: string[];
+    /** Assignments pointing at an order that no longer exists (or is complete). */
+    droppedUnknownOrders: string[];
+    /** Duplicate / invalid order or worker entries skipped. */
+    skippedDuplicates: string[];
+}
+/** What an `advance` completed. */
+export interface DyFM_WorkOrderScheduler_AdvanceResult {
+    /** Orders that reached their work this step (in FIFO order). Their workers were released. */
+    completedOrderIds: string[];
+}
+/** What a `cancel` released — atomically, with the progress so the game can refund proportionally. */
+export interface DyFM_WorkOrderScheduler_CancelResult {
+    found: boolean;
+    releasedWorkerIds: string[];
+    /** Progress ratio at cancel time (0..1) — e.g. the base of a refund percentage. */
+    progressRatio: number;
+}
+//# sourceMappingURL=work-order-scheduler.interface.d.ts.map

package/build/_modules/game/_models/work-order-scheduler.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.interface.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,WAAW,8BAA8B;IAC7C,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,uFAAuF;AACvF,MAAM,WAAW,kCAAkC;IACjD,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,+EAA+E;IAC/E,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,2DAA2D;IAC3D,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,mCAAmC;AACnC,MAAM,WAAW,qCAAqC;IACpD,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,sGAAsG;AACtG,MAAM,WAAW,oCAAoC;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/build/_modules/game/_models/work-order-scheduler.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=work-order-scheduler.interface.js.map

package/build/_modules/game/_models/work-order-scheduler.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-order-scheduler.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/work-order-scheduler.interface.ts"],"names":[],"mappings":""}

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

@@ -12,6 +12,14 @@ export * from './_models/flying-effect.interface';
 export * from './_models/flying-effect.control-model';
 export * from './_models/simulation-clock.interface';
 export * from './_models/simulation-clock.control-model';
+export * from './_models/game-save.interface';
+export * from './_models/work-order-scheduler.interface';
+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 './_collections/audio-mixer.util';
 export * from './_collections/audio-scale.util';
+export * from './_collections/game-save.util';
+export * from './_collections/build-reservation.util';
 //# sourceMappingURL=index.d.ts.map

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;AAGzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,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;AAGjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/build/_modules/game/index.js

@@ -17,7 +17,15 @@ tslib_1.__exportStar(require("./_models/flying-effect.interface"), exports);
 tslib_1.__exportStar(require("./_models/flying-effect.control-model"), exports);
 tslib_1.__exportStar(require("./_models/simulation-clock.interface"), exports);
 tslib_1.__exportStar(require("./_models/simulation-clock.control-model"), exports);
+tslib_1.__exportStar(require("./_models/game-save.interface"), exports);
+tslib_1.__exportStar(require("./_models/work-order-scheduler.interface"), exports);
+tslib_1.__exportStar(require("./_models/work-order-scheduler.control-model"), exports);
+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);
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/audio-mixer.util"), exports);
 tslib_1.__exportStar(require("./_collections/audio-scale.util"), exports);
+tslib_1.__exportStar(require("./_collections/game-save.util"), exports);
+tslib_1.__exportStar(require("./_collections/build-reservation.util"), exports);
 //# sourceMappingURL=index.js.map

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;AAEzD,cAAc;AACd,0EAAgD;AAChD,0EAAgD"}
+{"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"}