project-cpu-mcp 0.7.1

package/dist/map/reader.d.ts

@@ -0,0 +1,20 @@
+import { type AttentionReport, type CellInspection, type Cell, type MapChanges, type MapQuery, type MapQueryResult, type MapReaderOptions } from './types.js';
+export declare class MapReader {
+    private readonly store;
+    private readonly status;
+    private readonly appConfig;
+    constructor(options: MapReaderOptions);
+    query(query: MapQuery): Promise<MapQueryResult>;
+    inspectCell(tokenId: string, ownerAddress: string | null): Promise<CellInspection | null>;
+    readRevealCell(tokenId: string): Promise<Cell | null>;
+    getServerTime(): number;
+    attention(ownerAddress: string | null): Promise<AttentionReport>;
+    refresh(): Promise<void>;
+    getChanges(sinceVersion: number, ownerAddress: string | null): Promise<MapChanges>;
+    allCells(): Promise<Array<Cell>>;
+    private projector;
+    private projectorFor;
+    private enrich;
+    private nearestOwnedDistance;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/map/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/map/reader.ts"],"names":[],"mappings":"AAMA,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,IAAI,EAGT,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EAKxB,MAAM,YAAY,CAAC;AAQpB,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,OAAO,EAAE,gBAAgB;IAM/B,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB/C,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAmBzF,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS3D,aAAa,IAAI,MAAM;IAIjB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IActE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IAWlF,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAKxB,SAAS;IAIvB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,oBAAoB;CAe/B"}

package/dist/map/reader.js

@@ -0,0 +1,126 @@
+import { buildAttentionReport } from './attention.utils.js';
+import { toCell } from './cell-view.utils.js';
+import { WAREHOUSE_NEAR_FULL_PCT } from './constants.js';
+import { buildResourceIndex, classifyNeighbors, filterCells, summarizeMap } from './map.utils.js';
+import { buildingTypesOfKind, toProjectionConfig, toSettleConfig } from './reader.utils.js';
+import { MapReadiness, MapScope, } from './types.js';
+import { BuildingKind } from '../api/types.js';
+import { MAX_ROUTE_RADIUS } from '../geometry/constants.js';
+import { nearestDistanceWithin, tokenIdToPos } from '../geometry/token.utils.js';
+const LOADING_NOTE = 'Map is still loading; data may be incomplete. Retry shortly.';
+export class MapReader {
+    store;
+    status;
+    appConfig;
+    constructor(options) {
+        this.store = options.store;
+        this.status = options.status;
+        this.appConfig = options.appConfig;
+    }
+    async query(query) {
+        const project = await this.projector();
+        const rawOwned = query.ownerAddress === null ? null : this.store.getByOwner(query.ownerAddress);
+        const summary = summarizeMap({
+            readiness: this.status.getReadiness(),
+            socketConnected: this.status.isSocketConnected(),
+            version: this.store.getLatestUpdated(),
+            serverTime: this.store.getServerTime(),
+            totalCells: this.store.size(),
+            ownedCells: rawOwned === null ? null : rawOwned.map(project),
+        });
+        const resourceIndex = rawOwned === null ? null : buildResourceIndex(rawOwned);
+        const note = this.status.getReadiness() === MapReadiness.Loading ? LOADING_NOTE : null;
+        if (query.scope === MapScope.Summary) {
+            return { summary, scope: query.scope, resourceIndex, cells: [], returnedCells: 0, note };
+        }
+        const cells = filterCells(this.store.values(), query).map((cell) => this.enrich(project(cell), query.ownerAddress));
+        return { summary, scope: query.scope, resourceIndex, cells, returnedCells: cells.length, note };
+    }
+    async inspectCell(tokenId, ownerAddress) {
+        const raw = this.store.get(tokenId);
+        if (raw === null) {
+            return null;
+        }
+        const project = await this.projector();
+        const enriched = this.enrich(project(raw), ownerAddress);
+        const neighbors = [];
+        for (const ref of enriched.neighbors) {
+            const neighbor = this.store.get(ref.tokenId);
+            if (neighbor !== null) {
+                neighbors.push(project(neighbor));
+            }
+        }
+        return { cell: enriched, neighbors, distanceFromMine: this.nearestOwnedDistance(raw, ownerAddress) };
+    }
+    async readRevealCell(tokenId) {
+        const raw = this.store.get(tokenId);
+        if (raw === null) {
+            return null;
+        }
+        const project = await this.projector();
+        return project(raw);
+    }
+    getServerTime() {
+        return this.store.getServerTime();
+    }
+    async attention(ownerAddress) {
+        const config = await this.appConfig.load();
+        const project = this.projectorFor(toProjectionConfig(config));
+        const rawOwned = ownerAddress === null ? null : this.store.getByOwner(ownerAddress);
+        return buildAttentionReport({
+            ownedCells: rawOwned === null ? null : rawOwned.map(project),
+            version: this.store.getLatestUpdated(),
+            serverTime: this.store.getServerTime(),
+            nearFullPct: WAREHOUSE_NEAR_FULL_PCT,
+            ...toSettleConfig(config),
+            extractorBuildingTypes: buildingTypesOfKind(config, BuildingKind.Extractor),
+        });
+    }
+    refresh() {
+        return this.status.resyncNow();
+    }
+    async getChanges(sinceVersion, ownerAddress) {
+        const project = await this.projector();
+        const changed = this.store.changedSince(sinceVersion).map((cell) => this.enrich(project(cell), ownerAddress));
+        return {
+            version: this.store.getLatestUpdated(),
+            serverTime: this.store.getServerTime(),
+            changed,
+            changedCount: changed.length,
+        };
+    }
+    async allCells() {
+        const project = await this.projector();
+        return [...this.store.values()].map(project);
+    }
+    async projector() {
+        return this.projectorFor(toProjectionConfig(await this.appConfig.load()));
+    }
+    projectorFor(config) {
+        const serverTime = this.store.getServerTime();
+        return (raw) => toCell(raw, serverTime, config);
+    }
+    enrich(cell, ownerAddress) {
+        return {
+            ...cell,
+            pos: tokenIdToPos(cell.tokenId),
+            neighbors: classifyNeighbors(cell, (tokenId) => this.store.get(tokenId), ownerAddress),
+        };
+    }
+    nearestOwnedDistance(cell, ownerAddress) {
+        if (ownerAddress === null) {
+            return null;
+        }
+        const owned = new Set();
+        for (const ownedCell of this.store.getByOwner(ownerAddress)) {
+            if (ownedCell.tokenId !== cell.tokenId) {
+                owned.add(ownedCell.tokenId);
+            }
+        }
+        if (owned.size === 0) {
+            return null;
+        }
+        return nearestDistanceWithin(cell.tokenId, owned, MAX_ROUTE_RADIUS);
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/map/reader.js.map

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

package/dist/map/reader.utils.d.ts

@@ -0,0 +1,10 @@
+import type { SettleConfig } from './settle.utils.js';
+import type { CellProjectionConfig, ProcessOutput } from './types.js';
+import { BuildingKind } from '../api/types.js';
+import type { AppConfig } from '../services/types.js';
+export declare function buildingTypesOfKind(config: AppConfig, kind: BuildingKind): Set<string>;
+export declare function craftOutputsByRecipe(config: AppConfig): Record<string, Array<ProcessOutput>>;
+export declare function extractionShareBpByBuilding(config: AppConfig): Record<string, number>;
+export declare function toProjectionConfig(config: AppConfig): CellProjectionConfig;
+export declare function toSettleConfig(config: AppConfig): SettleConfig;
+//# sourceMappingURL=reader.utils.d.ts.map

package/dist/map/reader.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.utils.d.ts","sourceRoot":"","sources":["../../src/map/reader.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAEtF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAE5F;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAErF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,oBAAoB,CAM1E;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,YAAY,CAK9D"}

package/dist/map/reader.utils.js

@@ -0,0 +1,24 @@
+import { BuildingKind } from '../api/types.js';
+export function buildingTypesOfKind(config, kind) {
+    return new Set(config.buildings.filter((b) => b.kind === kind).map((b) => b.type));
+}
+export function craftOutputsByRecipe(config) {
+    return Object.fromEntries(config.recipes.map((r) => [r.id, r.outputs]));
+}
+export function extractionShareBpByBuilding(config) {
+    return Object.fromEntries(config.buildings.map((b) => [b.type, b.effects.extractionShareBp]));
+}
+export function toProjectionConfig(config) {
+    return {
+        hubStorageMultiplier: config.storage.hubStorageMultiplier,
+        hubBuildingTypes: buildingTypesOfKind(config, BuildingKind.Hub),
+        craftOutputsByRecipe: craftOutputsByRecipe(config),
+    };
+}
+export function toSettleConfig(config) {
+    return {
+        craftOutputsByRecipe: craftOutputsByRecipe(config),
+        extractionShareBpByBuilding: extractionShareBpByBuilding(config),
+    };
+}
+//# sourceMappingURL=reader.utils.js.map

package/dist/map/reader.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.utils.js","sourceRoot":"","sources":["../../src/map/reader.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,IAAkB;IACrE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IAClD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAkC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IACzD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAChD,OAAO;QACH,oBAAoB,EAAE,MAAM,CAAC,OAAO,CAAC,oBAAoB;QACzD,gBAAgB,EAAE,mBAAmB,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC;QAC/D,oBAAoB,EAAE,oBAAoB,CAAC,MAAM,CAAC;KACrD,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC5C,OAAO;QACH,oBAAoB,EAAE,oBAAoB,CAAC,MAAM,CAAC;QAClD,2BAA2B,EAAE,2BAA2B,CAAC,MAAM,CAAC;KACnE,CAAC;AACN,CAAC"}

package/dist/map/settle.utils.d.ts

@@ -0,0 +1,20 @@
+import { type ProcessProgress } from './process.utils.js';
+import { type Cell, type CellProcessView, type ProcessOutput } from './types.js';
+export declare function takePerCycle(creditPerCycle: number, extractionShareBp: number): number;
+export interface Settlement {
+    settledBatches: number;
+    minedUnits: bigint;
+    drainedUnits: bigint;
+    depleted: boolean;
+}
+export interface SettleConfig {
+    craftOutputsByRecipe: Record<string, Array<ProcessOutput>>;
+    extractionShareBpByBuilding: Record<string, number>;
+}
+export declare function settleCell(cell: Cell, maturedBatches: number, config: SettleConfig): Settlement;
+export interface CellProcessProgress {
+    progress: ProcessProgress;
+    settlement: Settlement;
+}
+export declare function cellProcessProgress(cell: Cell, process: CellProcessView, serverTime: number, config: SettleConfig): CellProcessProgress;
+//# sourceMappingURL=settle.utils.d.ts.map

package/dist/map/settle.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.utils.d.ts","sourceRoot":"","sources":["../../src/map/settle.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAA2D,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnH,OAAO,EAAmB,KAAK,IAAI,EAAE,KAAK,eAAe,EAAqB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAErH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAEtF;AAED,MAAM,WAAW,UAAU;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAoDD,MAAM,WAAW,YAAY;IACzB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IAC3D,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CA4B/F;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACrB,mBAAmB,CAoBrB"}

package/dist/map/settle.utils.js

@@ -0,0 +1,77 @@
+import { BASIS_POINTS } from './constants.js';
+import { computeBatchSchedule, processOutputs, toProcessProgress } from './process.utils.js';
+import { fitBatchesByRoom } from './storage.utils.js';
+import { CellProcessKind } from './types.js';
+export function takePerCycle(creditPerCycle, extractionShareBp) {
+    return Math.ceil((creditPerCycle * BASIS_POINTS) / extractionShareBp);
+}
+function settleMining({ resourceId, yieldPerCycle, takePerCycle, maturedBatches, depositRemaining, resources, }) {
+    const take = BigInt(takePerCycle);
+    const fitByRoom = fitBatchesByRoom([{ resourceId, amount: yieldPerCycle }], resources);
+    const fitByDeposit = Number((depositRemaining + take - 1n) / take);
+    const settledBatches = Math.min(maturedBatches, fitByRoom ?? maturedBatches, fitByDeposit);
+    const wouldDrain = BigInt(settledBatches) * take;
+    const drainedUnits = wouldDrain > depositRemaining ? depositRemaining : wouldDrain;
+    return {
+        settledBatches,
+        drainedUnits,
+        minedUnits: (drainedUnits * BigInt(yieldPerCycle)) / take,
+        depleted: depositRemaining - drainedUnits === 0n,
+    };
+}
+function settleCraft({ outputs, maturedBatches, resources }) {
+    const fitByRoom = fitBatchesByRoom(outputs, resources);
+    return {
+        settledBatches: Math.min(maturedBatches, fitByRoom ?? maturedBatches),
+        minedUnits: 0n,
+        drainedUnits: 0n,
+        depleted: false,
+    };
+}
+export function settleCell(cell, maturedBatches, config) {
+    const process = cell.process;
+    if (process === null) {
+        return { settledBatches: 0, minedUnits: 0n, drainedUnits: 0n, depleted: false };
+    }
+    const outputs = processOutputs(process, config.craftOutputsByRecipe);
+    if (process.kind !== CellProcessKind.Mining) {
+        return settleCraft({ outputs, maturedBatches, resources: cell.resources });
+    }
+    if (cell.building === null) {
+        throw new Error(`Cell ${cell.tokenId} is mining with no building; cannot derive its extraction share.`);
+    }
+    const extractionShareBp = config.extractionShareBpByBuilding[cell.building.type];
+    if (extractionShareBp === undefined) {
+        throw new Error(`Building type ${cell.building.type} has no extraction share in the config; cannot settle mining ` +
+            `on cell ${cell.tokenId}.`);
+    }
+    return settleMining({
+        resourceId: process.resource,
+        yieldPerCycle: process.yieldPerCycle,
+        takePerCycle: takePerCycle(process.yieldPerCycle, extractionShareBp),
+        maturedBatches,
+        depositRemaining: BigInt(cell.resources.find((r) => r.resourceId === process.resource)?.deposit ?? '0'),
+        resources: cell.resources,
+    });
+}
+export function cellProcessProgress(cell, process, serverTime, config) {
+    const schedule = computeBatchSchedule({
+        durationSec: process.durationSec,
+        batches: process.batches,
+        claimedBatches: process.claimedBatches,
+        startAtSec: process.startAt,
+        nowSec: serverTime,
+    });
+    const settlement = settleCell(cell, schedule.maturedBatches, config);
+    return {
+        progress: toProcessProgress({
+            schedule,
+            claimedBatches: process.claimedBatches,
+            settledBatches: settlement.settledBatches,
+            depleted: settlement.depleted,
+            stalled: process.stalled,
+        }),
+        settlement,
+    };
+}
+//# sourceMappingURL=settle.utils.js.map

package/dist/map/settle.utils.js.map

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

package/dist/map/socket.d.ts

@@ -0,0 +1,13 @@
+import type { CreateMapSocketInput, ISocketClient, SocketLifecycleHandlers } from './types.js';
+export declare class MapSocketClient implements ISocketClient {
+    private readonly baseUrl;
+    private readonly logger;
+    private socket;
+    constructor(input: CreateMapSocketInput);
+    connect(handlers: SocketLifecycleHandlers): void;
+    isConnected(): boolean;
+    reconnect(): void;
+    disconnect(): void;
+}
+export declare function createMapSocket(input: CreateMapSocketInput): ISocketClient;
+//# sourceMappingURL=socket.d.ts.map

package/dist/map/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/map/socket.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAO/F,qBAAa,eAAgB,YAAW,aAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,KAAK,EAAE,oBAAoB;IAKvC,OAAO,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAqBhD,WAAW,IAAI,OAAO;IAItB,SAAS,IAAI,IAAI;IAOjB,UAAU,IAAI,IAAI;CAOrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,aAAa,CAE1E"}

package/dist/map/socket.js

@@ -0,0 +1,54 @@
+import { io } from 'socket.io-client';
+import { CELL_UPDATE_EVENT, MAP_SOCKET_NAMESPACE, MAP_SOCKET_PATH } from './constants.js';
+import { parseCell } from './map.utils.js';
+function buildSocketUrl(baseUrl) {
+    return `${baseUrl.replace(/\/+$/, '')}${MAP_SOCKET_NAMESPACE}`;
+}
+export class MapSocketClient {
+    baseUrl;
+    logger;
+    socket = null;
+    constructor(input) {
+        this.baseUrl = input.baseUrl;
+        this.logger = input.logger;
+    }
+    connect(handlers) {
+        const socket = io(buildSocketUrl(this.baseUrl), {
+            path: MAP_SOCKET_PATH,
+            transports: ['websocket'],
+            reconnection: true,
+        });
+        this.socket = socket;
+        socket.on('connect', () => handlers.onConnect());
+        socket.on('disconnect', (reason) => handlers.onDisconnect(reason));
+        socket.on('connect_error', (error) => handlers.onError(error));
+        socket.on(CELL_UPDATE_EVENT, (raw) => {
+            const cell = parseCell(raw);
+            if (cell === null) {
+                this.logger.warn('dropped invalid cell update payload');
+                return;
+            }
+            handlers.onCellUpdate(cell);
+        });
+    }
+    isConnected() {
+        return this.socket?.connected ?? false;
+    }
+    reconnect() {
+        // socket.io won't auto-reconnect after a server-initiated disconnect (it unsubscribes the
+        // socket from the manager). A single connect() re-subscribes the socket and re-arms socket.io's
+        // own backoff loop, which then owns the retries; connect() is a no-op if already connected.
+        this.socket?.connect();
+    }
+    disconnect() {
+        if (this.socket !== null) {
+            this.socket.removeAllListeners();
+            this.socket.disconnect();
+            this.socket = null;
+        }
+    }
+}
+export function createMapSocket(input) {
+    return new MapSocketClient(input);
+}
+//# sourceMappingURL=socket.js.map

package/dist/map/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/map/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAe,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,SAAS,cAAc,CAAC,OAAe;IACnC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,oBAAoB,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,OAAO,eAAe;IACP,OAAO,CAAS;IAChB,MAAM,CAAU;IACzB,MAAM,GAAkB,IAAI,CAAC;IAErC,YAAY,KAA2B;QACnC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,QAAiC;QACrC,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC5C,IAAI,EAAE,eAAe;YACrB,UAAU,EAAE,CAAC,WAAW,CAAC;YACzB,YAAY,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,GAAY,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;gBACxD,OAAO;YACX,CAAC;YACD,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACP,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;IAED,SAAS;QACL,0FAA0F;QAC1F,gGAAgG;QAChG,4FAA4F;QAC5F,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,UAAU;QACN,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;IACL,CAAC;CACJ;AAED,MAAM,UAAU,eAAe,CAAC,KAA2B;IACvD,OAAO,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/map/storage.utils.d.ts

@@ -0,0 +1,7 @@
+import type { CellResource, CellResourceStorage, ProcessOutput } from './types.js';
+export declare function warehouseRoom(storage: CellResourceStorage | null): bigint | null;
+export declare function needByResource(outputs: ReadonlyArray<ProcessOutput>): Map<number, bigint>;
+export declare function fitBatchesByRoom(outputs: ReadonlyArray<ProcessOutput>, resources: ReadonlyArray<CellResource>): number | null;
+export declare function blockedResourceIds(outputs: ReadonlyArray<ProcessOutput>, resources: ReadonlyArray<CellResource>): Array<number>;
+export declare function isProcessStalled(outputs: ReadonlyArray<ProcessOutput>, resources: ReadonlyArray<CellResource>): boolean;
+//# sourceMappingURL=storage.utils.d.ts.map

package/dist/map/storage.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.utils.d.ts","sourceRoot":"","sources":["../../src/map/storage.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOhF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMzF;AAOD,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,EACrC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GACvC,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,EACrC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GACvC,KAAK,CAAC,MAAM,CAAC,CASf;AAED,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,EACrC,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,GACvC,OAAO,CAET"}

package/dist/map/storage.utils.js

@@ -0,0 +1,45 @@
+export function warehouseRoom(storage) {
+    if (storage === null || storage.cap === null) {
+        return null;
+    }
+    const used = BigInt(storage.used);
+    const cap = BigInt(storage.cap);
+    return cap > used ? cap - used : 0n;
+}
+export function needByResource(outputs) {
+    const need = new Map();
+    for (const output of outputs) {
+        need.set(output.resourceId, (need.get(output.resourceId) ?? 0n) + BigInt(output.amount));
+    }
+    return need;
+}
+function roomFor(resources, resourceId) {
+    const resource = resources.find((r) => r.resourceId === resourceId);
+    return resource === undefined ? null : warehouseRoom(resource.storage);
+}
+export function fitBatchesByRoom(outputs, resources) {
+    let fit = null;
+    for (const [resourceId, need] of needByResource(outputs)) {
+        const room = roomFor(resources, resourceId);
+        if (room === null) {
+            continue;
+        }
+        const batches = need > 0n ? room / need : room;
+        fit = fit === null || batches < fit ? batches : fit;
+    }
+    return fit === null ? null : Number(fit);
+}
+export function blockedResourceIds(outputs, resources) {
+    const blocked = [];
+    for (const [resourceId, need] of needByResource(outputs)) {
+        const room = roomFor(resources, resourceId);
+        if (need > 0n && room !== null && room < need) {
+            blocked.push(resourceId);
+        }
+    }
+    return blocked;
+}
+export function isProcessStalled(outputs, resources) {
+    return blockedResourceIds(outputs, resources).length > 0;
+}
+//# sourceMappingURL=storage.utils.js.map

package/dist/map/storage.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.utils.js","sourceRoot":"","sources":["../../src/map/storage.utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,OAAmC;IAC7D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAqC;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,SAAsC,EAAE,UAAkB;IACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACpE,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC5B,OAAqC,EACrC,SAAsC;IAEtC,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,SAAS;QACb,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,GAAG,GAAG,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAC9B,OAAqC,EACrC,SAAsC;IAEtC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,IAAI,GAAG,EAAE,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC5B,OAAqC,EACrC,SAAsC;IAEtC,OAAO,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7D,CAAC"}

package/dist/map/store.d.ts

@@ -0,0 +1,26 @@
+import type { MapSnapshotResponse, RawCell } from './types.js';
+/**
+ * In-memory map state. The single source of truth for every read; kept current by snapshot loads and
+ * realtime updates, which all funnel through `applyCell` so newer-wins holds between them. The one
+ * exception is `replaceAll`, which deliberately bypasses newer-wins to swap in a different world.
+ */
+export declare class MapStore {
+    private readonly nowSec;
+    private readonly cells;
+    private syncVersion;
+    private latestUpdated;
+    private serverTimeOffsetSec;
+    constructor(nowSec?: () => number);
+    applyCell(cell: RawCell): boolean;
+    applySnapshot(snapshot: MapSnapshotResponse): void;
+    replaceAll(snapshot: MapSnapshotResponse): void;
+    get(tokenId: string): RawCell | null;
+    getByOwner(owner: string): Array<RawCell>;
+    changedSince(version: number): Array<RawCell>;
+    values(): IterableIterator<RawCell>;
+    getSyncVersion(): number;
+    getLatestUpdated(): number;
+    getServerTime(): number;
+    size(): number;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/map/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/map/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,qBAAa,QAAQ;IAcL,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAIpD,OAAO,CAAC,WAAW,CAAK;IAGxB,OAAO,CAAC,aAAa,CAAK;IAG1B,OAAO,CAAC,mBAAmB,CAAuB;gBAGrB,MAAM,GAAE,MAAM,MAA4C;IAEvF,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;IAejC,aAAa,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAclD,UAAU,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAa/C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAIpC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IAWzC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC;IAU7C,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC;IAKnC,cAAc,IAAI,MAAM;IAKxB,gBAAgB,IAAI,MAAM;IAI1B,aAAa,IAAI,MAAM;IAIvB,IAAI,IAAI,MAAM;CAGjB"}

package/dist/map/store.js

@@ -0,0 +1,102 @@
+import { isNewer } from './map.utils.js';
+/**
+ * In-memory map state. The single source of truth for every read; kept current by snapshot loads and
+ * realtime updates, which all funnel through `applyCell` so newer-wins holds between them. The one
+ * exception is `replaceAll`, which deliberately bypasses newer-wins to swap in a different world.
+ */
+export class MapStore {
+    nowSec;
+    cells = new Map();
+    // Authoritative resync cursor for `?since`. Advanced ONLY by server responses (applySnapshot),
+    // never by a single realtime cell — otherwise the cursor races ahead of what we actually hold and
+    // a later `?since` skips changes the socket missed, losing them for good.
+    syncVersion = 0;
+    // Live high-water mark of cell.updated, advanced by every applied cell. Drives the local
+    // get_changes delta only — it never goes to the server, so it can't cause a `?since` skip.
+    latestUpdated = 0;
+    // Offset (serverTime − local seconds) captured at the last snapshot. getServerTime() projects it onto the
+    // live local clock, so "reference now" keeps advancing between resyncs instead of freezing at the snapshot.
+    serverTimeOffsetSec = null;
+    // `nowSec` is injectable so tests get a deterministic clock; production uses wall-clock seconds.
+    constructor(nowSec = () => Math.floor(Date.now() / 1000)) {
+        this.nowSec = nowSec;
+    }
+    applyCell(cell) {
+        const held = this.cells.get(cell.tokenId) ?? null;
+        if (!isNewer(cell, held)) {
+            return false;
+        }
+        this.cells.set(cell.tokenId, cell);
+        if (cell.updated > this.latestUpdated) {
+            this.latestUpdated = cell.updated;
+        }
+        return true;
+    }
+    // Merges (never replaces) so a freshly-arrived realtime cell isn't clobbered by an older snapshot.
+    // The server-provided version is the only thing allowed to move the resync cursor.
+    applySnapshot(snapshot) {
+        for (const cell of snapshot.cells) {
+            this.applyCell(cell);
+        }
+        // Keep the freshest (largest) offset so a late, out-of-order older snapshot can't rewind "now".
+        const offset = snapshot.serverTime - this.nowSec();
+        if (this.serverTimeOffsetSec === null || offset > this.serverTimeOffsetSec) {
+            this.serverTimeOffsetSec = offset;
+        }
+        if (snapshot.version > this.syncVersion) {
+            this.syncVersion = snapshot.version;
+        }
+    }
+    replaceAll(snapshot) {
+        this.cells.clear();
+        this.latestUpdated = 0;
+        for (const cell of snapshot.cells) {
+            this.cells.set(cell.tokenId, cell);
+            if (cell.updated > this.latestUpdated) {
+                this.latestUpdated = cell.updated;
+            }
+        }
+        this.syncVersion = snapshot.version;
+        this.serverTimeOffsetSec = snapshot.serverTime - this.nowSec();
+    }
+    get(tokenId) {
+        return this.cells.get(tokenId) ?? null;
+    }
+    getByOwner(owner) {
+        const lower = owner.toLowerCase();
+        const result = [];
+        for (const cell of this.cells.values()) {
+            if (cell.owner.toLowerCase() === lower) {
+                result.push(cell);
+            }
+        }
+        return result;
+    }
+    changedSince(version) {
+        const result = [];
+        for (const cell of this.cells.values()) {
+            if (cell.updated > version) {
+                result.push(cell);
+            }
+        }
+        return result;
+    }
+    values() {
+        return this.cells.values();
+    }
+    // Cursor to send as `?since` — the last version the server vouched for.
+    getSyncVersion() {
+        return this.syncVersion;
+    }
+    // Freshness / get_changes cursor — the newest cell.updated we currently hold.
+    getLatestUpdated() {
+        return this.latestUpdated;
+    }
+    getServerTime() {
+        return this.serverTimeOffsetSec === null ? 0 : this.nowSec() + this.serverTimeOffsetSec;
+    }
+    size() {
+        return this.cells.size;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/map/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/map/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IAcY;IAbZ,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACpD,+FAA+F;IAC/F,kGAAkG;IAClG,0EAA0E;IAClE,WAAW,GAAG,CAAC,CAAC;IACxB,yFAAyF;IACzF,2FAA2F;IACnF,aAAa,GAAG,CAAC,CAAC;IAC1B,0GAA0G;IAC1G,4GAA4G;IACpG,mBAAmB,GAAkB,IAAI,CAAC;IAElD,iGAAiG;IACjG,YAA6B,SAAuB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAA1D,WAAM,GAAN,MAAM,CAAoD;IAAG,CAAC;IAE3F,SAAS,CAAC,IAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,mGAAmG;IACnG,mFAAmF;IACnF,aAAa,CAAC,QAA6B;QACvC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,gGAAgG;QAChG,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,mBAAmB,KAAK,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC;QACtC,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QACxC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,QAA6B;QACpC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;YACtC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QACpC,IAAI,CAAC,mBAAmB,GAAG,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IACnE,CAAC;IAED,GAAG,CAAC,OAAe;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAED,UAAU,CAAC,KAAa;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,YAAY,CAAC,OAAe;QACxB,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,wEAAwE;IACxE,cAAc;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,mBAAmB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAC5F,CAAC;IAED,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;CACJ"}