warp12-engine 0.1.0

package/dist/lib/ai/actions.d.ts

@@ -0,0 +1,32 @@
+import { GameAction, LegalMove } from '../types/actions.js';
+import { PlayerId } from '../types/player.js';
+import { QFlashEffectKind } from '../types/q-continuum.js';
+/**
+ * The AI's action space, mirroring the moves a captain can declare. `chart`
+ * wraps an engine {@link LegalMove}; the rest map 1:1 onto control actions.
+ * Custom variants can extend behavior with new heuristics/generators rather
+ * than new kinds, since these already cover every legal Warp 12 action.
+ */
+export type WarpAiAction = {
+    readonly kind: 'chart';
+    readonly move: LegalMove;
+} | {
+    readonly kind: 'draw';
+} | {
+    readonly kind: 'deploy-beacon';
+} | {
+    readonly kind: 'pass-red-alert';
+} | {
+    readonly kind: 'pass-turn';
+} | {
+    readonly kind: 'declare-treaty';
+} | {
+    readonly kind: 'invoke-q-flash';
+    readonly effect: QFlashEffectKind;
+} | {
+    readonly kind: 'resolve-q-gamble';
+    readonly keepIndex: 0 | 1;
+};
+/** Lowers an AI action into the engine {@link GameAction} for `applyAction`. */
+export declare function toGameAction(action: WarpAiAction, playerId: PlayerId): GameAction;
+//# sourceMappingURL=actions.d.ts.map

package/dist/lib/ai/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAA;CAAE,CAAC;AAErE,gFAAgF;AAChF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,QAAQ,GACjB,UAAU,CA4BZ"}

package/dist/lib/ai/candidate-generator.d.ts

@@ -0,0 +1,20 @@
+import { WarpAiAction } from './actions.js';
+import { WarpAiObservation } from './observation.js';
+/**
+ * Builds the considered actions for a Warp 12 turn, deferring all rules gating
+ * (Distress Beacon access, Red Alert cover, Subspace Fracture stabilization) to
+ * the engine's {@link getLegalMoves}. Precedence:
+ *
+ * 1. Q-Flash / Q's gamble resolution when pending.
+ * 2. Impulse-drop obligation (round winner must drop to impulse) overrides everything.
+ * 3. Any legal chart move → chart candidates (canonical "play if you can").
+ * 4. Otherwise draw (if Uncharted Sectors remain).
+ * 5. Otherwise pass the Red Alert (if responsible) or deploy the Distress Beacon.
+ *
+ * House-rule variants can replace this generator wholesale.
+ */
+export declare function warpCandidateGenerator(obs: WarpAiObservation, options?: {
+    captains?: readonly import('../types/player.js').Captain[];
+    rng?: () => number;
+}): WarpAiAction[];
+//# sourceMappingURL=candidate-generator.d.ts.map

package/dist/lib/ai/candidate-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/candidate-generator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,SAAS,OAAO,oBAAoB,EAAE,OAAO,EAAE,CAAC;IAC3D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GACA,YAAY,EAAE,CAmDhB"}

package/dist/lib/ai/context.d.ts

@@ -0,0 +1,19 @@
+import { Rng } from 'doubletwelve';
+import { Coordinate } from '../types/coordinate.js';
+import { ChartRoute } from '../types/actions.js';
+import { RoundState, TableState } from '../types/game-state.js';
+import { WarpAiObservation } from './observation.js';
+/** Shared, pre-computed turn data handed to every Warp heuristic. */
+export interface WarpEvalContext {
+    readonly obs: WarpAiObservation;
+    readonly hand: readonly Coordinate[];
+    /** Coordinates neither in this captain's hand nor already on the table. */
+    readonly unseen: readonly Coordinate[];
+    readonly rng: Rng;
+}
+/** Every coordinate currently visible on the table (spacedock, trails, zone, fracture). */
+export declare function collectPlacedCoordinates(table: TableState): Coordinate[];
+/** Open pip value a coordinate must match to chart onto the given route. */
+export declare function connectingValueForRoute(round: RoundState, route: ChartRoute): number | null;
+export declare function buildWarpContext(obs: WarpAiObservation, rng: Rng): WarpEvalContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/lib/ai/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CACnB;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,CAoBxE;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,MAAM,GAAG,IAAI,CAuBf;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,GAAG,GACP,eAAe,CAejB"}

package/dist/lib/ai/create-warp-ai.d.ts

@@ -0,0 +1,49 @@
+import { GenericHeuristic, Rng, SkillProfile } from 'doubletwelve';
+import { GameAction } from '../types/actions.js';
+import { GameState } from '../types/game-state.js';
+import { GameObjective } from '../types/objective.js';
+import { PlayerId } from '../types/player.js';
+import { WarpAiAction } from './actions.js';
+import { WarpEvalContext } from './context.js';
+import { WarpAiObservation } from './observation.js';
+/**
+ * Turns on "gaming it out": instead of scoring the current options with
+ * heuristics, the bot simulates each move forward with the engine, samples the
+ * hidden hands/draw a few times, and looks `depth` plies ahead. More expensive,
+ * but it reasons about consequences (e.g. setting up an opponent to go out).
+ */
+export interface LookaheadOptions {
+    /** Plies to search, including the bot's own move (>= 1). */
+    depth: number;
+    /** Hidden-world samples per move for imperfect-information averaging (default 6). */
+    determinizations?: number;
+    /** Cap candidate moves expanded per node, best-first (default 6). */
+    maxBranch?: number;
+}
+export interface CreateWarpAiPlayerOptions {
+    skill: SkillProfile;
+    /** Defaults to {@link DEFAULT_WARP_HEURISTICS}. Append your own for house tactics. */
+    heuristics?: ReadonlyArray<GenericHeuristic<WarpAiAction, WarpEvalContext>>;
+    /** Defaults to {@link warpCandidateGenerator}. Replace for house access rules. */
+    generateCandidates?: (obs: WarpAiObservation) => WarpAiAction[];
+    /** Opt into forward-simulating lookahead. Omit for the fast greedy policy. */
+    lookahead?: LookaheadOptions;
+    /** Victory condition the bot optimizes for (defaults to `penalty`). */
+    objective?: GameObjective;
+    /** Defaults to `Math.random`. Inject a seeded RNG for reproducible games/tests. */
+    rng?: Rng;
+}
+export interface WarpAiPlayer {
+    /** Choose an AI action for an explicit observation. */
+    decide(obs: WarpAiObservation): WarpAiAction;
+    /** Choose and lower to an engine action for `applyAction`; null if no round. */
+    decideGameAction(state: GameState, playerId: PlayerId): GameAction | null;
+}
+/**
+ * An offline, heuristic Warp 12 captain. It runs entirely on Warp12-lib's own
+ * engine (so all of RULES.md — Distress Beacons, Red Alerts, Subspace Fractures,
+ * the Neutral Zone, treaties, modules — is honored) while reusing DoubleTwelve's
+ * model-agnostic decision policy for skill, scoring, and selection.
+ */
+export declare function createWarpAiPlayer(options: CreateWarpAiPlayerOptions): WarpAiPlayer;
+//# sourceMappingURL=create-warp-ai.d.ts.map

package/dist/lib/ai/create-warp-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-warp-ai.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/create-warp-ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACR,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAQjD,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMnE;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,YAAY,CAAC;IACpB,sFAAsF;IACtF,UAAU,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;IAC5E,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,YAAY,EAAE,CAAC;IAChE,8EAA8E;IAC9E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,uEAAuE;IACvE,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,mFAAmF;IACnF,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAC7C,gFAAgF;IAChF,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,YAAY,CAqEd"}

package/dist/lib/ai/explain-action.d.ts

@@ -0,0 +1,8 @@
+import { GameState } from '../types/game-state.js';
+import { PlayerId } from '../types/player.js';
+import { WarpAiAction } from './actions.js';
+/** Human-readable factors that favor a suggested advisor move (heuristic layer). */
+export declare function explainWarpAiAction(state: GameState, playerId: PlayerId, action: WarpAiAction, options?: {
+    maxReasons?: number;
+}): string[];
+//# sourceMappingURL=explain-action.d.ts.map

package/dist/lib/ai/explain-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-action.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/explain-action.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAiMjD,oFAAoF;AACpF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,MAAM,EAAE,CAwDV"}

package/dist/lib/ai/heuristics.d.ts

@@ -0,0 +1,21 @@
+import { GenericHeuristic } from 'doubletwelve';
+import { WarpAiAction } from './actions.js';
+import { WarpEvalContext } from './context.js';
+export type WarpHeuristic = GenericHeuristic<WarpAiAction, WarpEvalContext>;
+/** Stable ids for referencing/overriding Warp heuristics in skill profiles. */
+export declare const WARP_HEURISTIC_IDS: {
+    readonly preferChart: "prefer-chart";
+    readonly dumpPips: "dump-pips";
+    readonly doublesEarly: "play-doubles-early";
+    readonly ownTrail: "own-trail";
+    readonly coverRelief: "cover-relief";
+    readonly redAlertSafe: "red-alert-safe";
+    readonly handFlexibility: "hand-flexibility";
+    readonly defensiveShared: "defensive-shared";
+    readonly salamanderDump: "salamander-dump";
+    readonly qContinuum: "q-continuum";
+    readonly goOutWin: "go-out-win";
+};
+/** The stock Warp 12 heuristic set. Append/replace by `id` to add house tactics. */
+export declare const DEFAULT_WARP_HEURISTICS: WarpHeuristic[];
+//# sourceMappingURL=heuristics.d.ts.map

package/dist/lib/ai/heuristics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heuristics.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/heuristics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AASrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAE5E,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;CAYrB,CAAC;AAkMX,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,EAAE,aAAa,EAYlD,CAAC"}

package/dist/lib/ai/index.d.ts

@@ -0,0 +1,19 @@
+export type { WarpAiAction } from './actions.js';
+export { toGameAction } from './actions.js';
+export type { WarpAiObservation } from './observation.js';
+export { observe } from './observation.js';
+export type { WarpEvalContext } from './context.js';
+export { buildWarpContext, collectPlacedCoordinates, connectingValueForRoute, } from './context.js';
+export { warpCandidateGenerator } from './candidate-generator.js';
+export type { WarpHeuristic } from './heuristics.js';
+export { WARP_HEURISTIC_IDS, DEFAULT_WARP_HEURISTICS } from './heuristics.js';
+export type { WarpSkillLevel } from './skill.js';
+export { WARP_SKILL_PRESETS, getWarpSkillProfile } from './skill.js';
+export type { CreateWarpAiPlayerOptions, LookaheadOptions, WarpAiPlayer, } from './create-warp-ai.js';
+export { createWarpAiPlayer } from './create-warp-ai.js';
+export { explainWarpAiAction } from './explain-action.js';
+export { chooseQFlashEffect, chooseQGambleKeepIndex } from './q-flash.js';
+export { createWarpSearchModel, observationToState, warpLeafEval, handPips, } from './search-model.js';
+export type { SelfPlaySeat, PlaySelfPlayGameOptions, SelfPlayGameResult, SelfPlayMatchResult, } from './self-play.js';
+export { playSelfPlayGame, runSelfPlayMatch } from './self-play.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE,YAAY,EACV,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/ai/observation.d.ts

@@ -0,0 +1,20 @@
+import { GameState, RoundState } from '../types/game-state.js';
+import { GameModules } from '../types/modules.js';
+import { GameObjective } from '../types/objective.js';
+import { Captain, PlayerId } from '../types/player.js';
+/**
+ * What a Warp 12 bot is allowed to see this turn: the public round state, which
+ * captain it is, and the active opt-in modules (so module-aware heuristics like
+ * Salamander and Q-Continuum can adjust). Opponent hands are intentionally
+ * excluded — only their hand counts/placed tiles are knowable.
+ */
+export interface WarpAiObservation {
+    readonly round: RoundState;
+    readonly playerId: PlayerId;
+    readonly modules: GameModules;
+    readonly objective: GameObjective;
+    readonly captains: readonly Captain[];
+}
+/** Builds an observation for `playerId` from a game state, or null if no round. */
+export declare function observe(state: GameState, playerId: PlayerId): WarpAiObservation | null;
+//# sourceMappingURL=observation.d.ts.map

package/dist/lib/ai/observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/observation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,mFAAmF;AACnF,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GACjB,iBAAiB,GAAG,IAAI,CAW1B"}

package/dist/lib/ai/q-flash.d.ts

@@ -0,0 +1,11 @@
+import { Captain } from '../types/player.js';
+import { QFlashEffectKind } from '../types/q-continuum.js';
+import { WarpAiObservation } from './observation.js';
+export interface ChooseQFlashOptions {
+    readonly rng?: () => number;
+}
+/** Pick the best available Q-Flash for the invoker. */
+export declare function chooseQFlashEffect(obs: WarpAiObservation, captains: readonly Captain[], options?: ChooseQFlashOptions): QFlashEffectKind;
+/** Keep the stronger tile from Q's gamble. */
+export declare function chooseQGambleKeepIndex(obs: WarpAiObservation, options?: ChooseQFlashOptions): 0 | 1;
+//# sourceMappingURL=q-flash.d.ts.map

package/dist/lib/ai/q-flash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"q-flash.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/q-flash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AA+CD,uDAAuD;AACvD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,OAAO,GAAE,mBAAwB,GAChC,gBAAgB,CAiBlB;AAED,8CAA8C;AAC9C,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,mBAAwB,GAChC,CAAC,GAAG,CAAC,CAYP"}

package/dist/lib/ai/search-model.d.ts

@@ -0,0 +1,33 @@
+import { PlayerRef, SearchModel } from 'doubletwelve';
+import { Coordinate } from '../types/coordinate.js';
+import { GameState } from '../types/game-state.js';
+import { GameModules } from '../types/modules.js';
+import { GameObjective } from '../types/objective.js';
+import { WarpAiAction } from './actions.js';
+import { WarpAiObservation } from './observation.js';
+/** Penalty weight of a hand, honoring the Salamander module's 24-point 12-12. */
+export declare function handPips(hand: readonly Coordinate[], modules: GameModules, roundNumber: number): number;
+/** Tile count in hand — the go-out objective cares about this, not pip weight. */
+export declare function handTileCount(hand: readonly Coordinate[]): number;
+/**
+ * Leaf evaluation for the penalty-scoring campaign: minimize held pips, maximize
+ * what opponents are stuck with, treat going out as decisive.
+ */
+export declare function warpLeafEvalPenalty(state: GameState, perspective: PlayerRef): number;
+/**
+ * Leaf evaluation for first-out-wins: minimize tiles held, maximize opponent
+ * hand sizes; pip weight and Salamander are irrelevant.
+ */
+export declare function warpLeafEvalGoOut(state: GameState, perspective: PlayerRef): number;
+/** @deprecated Use {@link warpLeafEvalPenalty} or {@link warpLeafEvalGoOut}. */
+export declare function warpLeafEval(state: GameState, perspective: PlayerRef): number;
+/** Build a Game State wrapper around an observation for the forward model. */
+export declare function observationToState(obs: WarpAiObservation): GameState;
+/**
+ * A {@link SearchModel} over Warp12's own engine, in {@link WarpAiAction} space.
+ * Hidden information (opponent hands + the draw order) is resampled by
+ * `determinize`, so the search plays honestly rather than peeking at the
+ * authoritative round state.
+ */
+export declare function createWarpSearchModel(objective?: GameObjective): SearchModel<GameState, WarpAiAction>;
+//# sourceMappingURL=search-model.d.ts.map

package/dist/lib/ai/search-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-model.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/search-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAO,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAG/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,iFAAiF;AACjF,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,CAYR;AAED,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,SAAS,GACrB,MAAM,CAyBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,SAAS,GACrB,MAAM,CAoBR;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,GAAG,MAAM,CAI7E;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,SAAS,CAgBpE;AAyBD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,aAAyB,GACnC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CA4FtC"}

package/dist/lib/ai/self-play.d.ts

@@ -0,0 +1,50 @@
+import { GameState } from '../types/game-state.js';
+import { GameModuleConfig } from '../types/modules.js';
+import { PlayerId } from '../types/player.js';
+import { WarpAiPlayer } from './create-warp-ai.js';
+export interface SelfPlaySeat {
+    id: PlayerId;
+    displayName?: string;
+    player: WarpAiPlayer;
+}
+export interface PlaySelfPlayGameOptions {
+    seats: readonly SelfPlaySeat[];
+    seed?: number;
+    modules?: GameModuleConfig;
+    /** Safety cap so a blocked round can't loop forever (default 20000). */
+    maxSteps?: number;
+}
+export interface SelfPlayGameResult {
+    /** Lowest cumulative penalty at completion; null if the game didn't finish. */
+    winnerId: PlayerId | null;
+    completed: boolean;
+    completedRounds: number;
+    steps: number;
+    penalties: Record<PlayerId, number>;
+    finalState: GameState;
+}
+/**
+ * Plays one full game between the supplied AI seats, driving the engine
+ * directly: act on the active captain, and tally rounds via `scoreRound` when a
+ * round ends. Deterministic for a given `seed` (and seeded players).
+ */
+export declare function playSelfPlayGame(options: PlaySelfPlayGameOptions): SelfPlayGameResult;
+export interface SelfPlayMatchResult {
+    games: number;
+    completed: number;
+    /** Games each seat id won (completed games only). */
+    wins: Record<PlayerId, number>;
+    /** Cumulative penalty each seat id accrued across all games (lower = better). */
+    penalties: Record<PlayerId, number>;
+}
+/**
+ * Runs a series of games and aggregates wins and accrued penalties per seat id.
+ * `makeSeats(gameIndex)` is called per game so callers can rebuild freshly
+ * seeded players and/or rotate seating to cancel first-mover advantage.
+ */
+export declare function runSelfPlayMatch(makeSeats: (gameIndex: number) => readonly SelfPlaySeat[], options: {
+    games: number;
+    seed?: number;
+    modules?: GameModuleConfig;
+}): SelfPlayMatchResult;
+//# sourceMappingURL=self-play.d.ts.map

package/dist/lib/ai/self-play.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-play.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/self-play.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,SAAS,CAAC;CACvB;AAqCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,kBAAkB,CAoGpB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,SAAS,YAAY,EAAE,EACzD,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACpE,mBAAmB,CA0BrB"}

package/dist/lib/ai/skill.d.ts

@@ -0,0 +1,8 @@
+import { SkillProfile } from 'doubletwelve';
+import { GameObjective } from '../types/objective.js';
+declare const PENALTY_PRESETS: Record<'beginner' | 'intermediate' | 'advanced', SkillProfile>;
+export declare const WARP_SKILL_PRESETS: Record<"beginner" | "intermediate" | "advanced", SkillProfile>;
+export type WarpSkillLevel = keyof typeof PENALTY_PRESETS;
+export declare function getWarpSkillProfile(level: WarpSkillLevel, objective?: GameObjective): SkillProfile;
+export {};
+//# sourceMappingURL=skill.d.ts.map

package/dist/lib/ai/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,QAAA,MAAM,eAAe,EAAE,MAAM,CAC3B,UAAU,GAAG,cAAc,GAAG,UAAU,EACxC,YAAY,CAsDb,CAAC;AA8DF,eAAO,MAAM,kBAAkB,gEAAkB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,eAAe,CAAC;AAE1D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,SAAS,GAAE,aAAyB,GACnC,YAAY,CAGd"}

package/dist/lib/ai/test-fixtures.d.ts

@@ -0,0 +1,18 @@
+import { normalizeCoordinate, Coordinate } from '../types/coordinate.js';
+import { RoundState, TableState } from '../types/game-state.js';
+import { GameModules } from '../types/modules.js';
+import { GameObjective } from '../types/objective.js';
+import { WarpAiObservation } from './observation.js';
+export declare const N: typeof normalizeCoordinate;
+export declare const TURN: readonly ["a", "b"];
+export declare const TEST_CAPTAINS: {
+    id: string;
+    displayName: string;
+    penaltyScore: number;
+}[];
+export declare function makeRound(over: Partial<RoundState>): RoundState;
+export declare function tableWithNeutralOpen(value: number): TableState;
+export declare function tableWithOwnTrail(playerId: string, trailTile: Coordinate, openValue: number): TableState;
+export declare function obsFor(round: RoundState, modules?: GameModules, objective?: GameObjective, playerId?: string): WarpAiObservation;
+export declare function modulesWithQ(): GameModules;
+//# sourceMappingURL=test-fixtures.d.ts.map

package/dist/lib/ai/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../../../src/lib/ai/test-fixtures.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,CAAC,4BAAsB,CAAC;AAErC,eAAO,MAAM,IAAI,qBAAsB,CAAC;AAExC,eAAO,MAAM,aAAa;;;;GAIzB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAuB/D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,UAAU,EACrB,SAAS,EAAE,MAAM,GAChB,UAAU,CAaZ;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,WAA6B,EACtC,SAAS,GAAE,aAAsC,EACjD,QAAQ,SAAM,GACb,iBAAiB,CAQnB;AAED,wBAAgB,YAAY,IAAI,WAAW,CAE1C"}

package/dist/lib/constants/setup.d.ts

@@ -0,0 +1,15 @@
+/** Hand sizes by fleet size (RULES.md §II). */
+export declare const HAND_SIZE_BY_PLAYER_COUNT: Readonly<Record<number, number>>;
+/** Total coordinates in a double-twelve set. */
+export declare const DOUBLE_TWELVE_SET_SIZE = 91;
+/** Highest pip value in a double-twelve set. */
+export declare const DOUBLE_TWELVE_MAX_PIPS = 12;
+/** Starting Spacedock double for round 1. */
+export declare const INITIAL_SPACEDOCK_VALUE = 12;
+/** Standard Salamander penalty multiplier for the 12-12 tile. */
+export declare const SALAMANDER_PENALTY_TILE_VALUE = 24;
+export declare function handSizeForPlayerCount(playerCount: number): number;
+export declare function spacedockValueForRound(roundNumber: number): number;
+/** 12-12 is set aside as Spacedock in round 1; Salamander applies from round 2 onward. */
+export declare function salamanderPenaltyApplies(roundNumber: number): boolean;
+//# sourceMappingURL=setup.d.ts.map

package/dist/lib/constants/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/lib/constants/setup.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQtE,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,iEAAiE;AACjE,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAEhD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,0FAA0F;AAC1F,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/lib/domino/coordinates.d.ts

@@ -0,0 +1,13 @@
+import { Coordinate } from '../types/coordinate.js';
+/** Every unique coordinate in a double-twelve set (91 tiles). */
+export declare function generateCoordinateSet(maxPips?: number): Coordinate[];
+export declare function assertCoordinateSetSize(coordinates: readonly Coordinate[], expected?: number): void;
+/** Fisher–Yates shuffle. Pass a seeded rng for deterministic tests. */
+export declare function shuffleCoordinates(coordinates: readonly Coordinate[], random?: () => number): Coordinate[];
+export declare function findCoordinateInHand(hand: readonly Coordinate[], target: Coordinate): number;
+export declare function removeCoordinateFromHand(hand: readonly Coordinate[], target: Coordinate): {
+    hand: Coordinate[];
+    removed: Coordinate | null;
+};
+export declare function handContains(hand: readonly Coordinate[], target: Coordinate): boolean;
+//# sourceMappingURL=coordinates.d.ts.map

package/dist/lib/domino/coordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../../src/lib/domino/coordinates.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAGhC,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,OAAO,SAAK,GAAG,UAAU,EAAE,CAQhE;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,QAAQ,SAAyB,GAChC,IAAI,CAWN;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,MAAM,GAAE,MAAM,MAAoB,GACjC,UAAU,EAAE,CAOd;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,UAAU,GACjB,MAAM,CAGR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,UAAU,GACjB;IAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,CAQpD;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,UAAU,GACjB,OAAO,CAET"}

package/dist/lib/engine/apply-action.d.ts

@@ -0,0 +1,7 @@
+import { GameAction, ActionResult } from '../types/actions.js';
+import { GameState, RoundState } from '../types/game-state.js';
+import { getLegalMoves } from './legal-moves.js';
+declare function advanceTurn(round: RoundState): RoundState;
+export declare function applyAction(state: GameState, action: GameAction): ActionResult;
+export { getLegalMoves, advanceTurn };
+//# sourceMappingURL=apply-action.d.ts.map

package/dist/lib/engine/apply-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-action.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/apply-action.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAc,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,wBAAwB,CAAC;AAmChF,OAAO,EAAE,aAAa,EAA2B,MAAM,kBAAkB,CAAC;AA4S1E,iBAAS,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAUlD;AA2TD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,YAAY,CAgK9E;AAED,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC"}

package/dist/lib/engine/beacon.d.ts

@@ -0,0 +1,30 @@
+import { RoundState } from '../types/game-state.js';
+import { PlayerId } from '../types/player.js';
+/** Captain has charted at least one coordinate on their own warp trail. */
+export declare function hasEstablishedWarpTrail(round: RoundState, playerId: PlayerId): boolean;
+/** Must draw from Uncharted Sectors before passing when tiles remain. */
+export declare function mustDrawBeforePassing(round: RoundState, playerId: PlayerId): boolean;
+/**
+ * Deploy the Distress Beacon (shields down).
+ *
+ * Forced only: no legal chart moves and the draw pile is empty (or after
+ * drawing on a Red Alert pass). Matches standard Mexican Train — the marker
+ * is not deployed voluntarily while other routes are available.
+ */
+export declare function canDeployDistressBeacon(round: RoundState, playerId: PlayerId, options?: {
+    afterDraw?: boolean;
+}): boolean;
+/**
+ * End the turn without charting when shields are already down and no other
+ * resolution applies (draw pile empty, no Red Alert pass pending).
+ */
+export declare function canPassTurn(round: RoundState, playerId: PlayerId, options?: {
+    afterDraw?: boolean;
+}): boolean;
+/** Pass a blocking Red Alert to the next captain (also deploys your beacon). */
+export declare function canPassRedAlert(round: RoundState, playerId: PlayerId, options?: {
+    afterDraw?: boolean;
+}): boolean;
+/** Shields rise only by charting on your own warp trail while the beacon is active. */
+export declare function canRaiseShieldsByCharting(round: RoundState, playerId: PlayerId): boolean;
+//# sourceMappingURL=beacon.d.ts.map

package/dist/lib/engine/beacon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/beacon.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAET;AAkBD,yEAAyE;AACzE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAKT;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAuBT;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAoBT;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAiBT;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAQT"}

package/dist/lib/engine/dead-red-alert.d.ts

@@ -0,0 +1,4 @@
+import { RoundState } from '../types/game-state.js';
+/** Clear Red Alert when the double pip is exhausted (Mexican Train dead double). */
+export declare function resolveDeadRedAlert(round: RoundState): RoundState;
+//# sourceMappingURL=dead-red-alert.d.ts.map

package/dist/lib/engine/dead-red-alert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-red-alert.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/dead-red-alert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAQjE"}

package/dist/lib/engine/helpers.d.ts

@@ -0,0 +1,12 @@
+import { GameState, RoundState } from '../types/game-state.js';
+import { ActionViolation } from '../types/actions.js';
+export declare function fail(violation: ActionViolation): {
+    ok: false;
+    violation: ActionViolation;
+};
+export declare function requireActiveRound(state: GameState): RoundState | ActionViolation;
+export declare function requirePlayerTurn(round: RoundState, playerId: string): true | ActionViolation;
+export declare function nextPlayerId(turnOrder: readonly string[], currentPlayerId: string): string;
+export declare function withRound(state: GameState, round: RoundState): GameState;
+export declare function withRoundAndCaptains(state: GameState, round: RoundState, captains: GameState['captains']): GameState;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/lib/engine/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG;IAChD,EAAE,EAAE,KAAK,CAAC;IACV,SAAS,EAAE,eAAe,CAAC;CAC5B,CAEA;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,GACf,UAAU,GAAG,eAAe,CAQ9B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,IAAI,GAAG,eAAe,CAKxB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,eAAe,EAAE,MAAM,GACtB,MAAM,CAGR;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,UAAU,GAChB,SAAS,CAEX;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,GAC9B,SAAS,CAEX"}

package/dist/lib/engine/legal-moves.d.ts

@@ -0,0 +1,10 @@
+import { Coordinate, PlacedCoordinate } from '../types/coordinate.js';
+import { ChartRoute, LegalMove } from '../types/actions.js';
+import { RoundState } from '../types/game-state.js';
+import { PlayerId } from '../types/player.js';
+declare function placedTile(coordinate: Coordinate, index: number, connectingValue: number): PlacedCoordinate | null;
+declare function canStabilizeFracture(round: RoundState, coordinate: Coordinate): boolean;
+export declare function getLegalMoves(round: RoundState, playerId: PlayerId): LegalMove[];
+export declare function isLegalMove(round: RoundState, playerId: PlayerId, coordinate: Coordinate, route: ChartRoute): boolean;
+export { placedTile, canStabilizeFracture };
+//# sourceMappingURL=legal-moves.d.ts.map

package/dist/lib/engine/legal-moves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal-moves.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/legal-moves.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAenD,iBAAS,UAAU,CACjB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GACtB,gBAAgB,GAAG,IAAI,CAMzB;AAoDD,iBAAS,oBAAoB,CAC3B,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,UAAU,GACrB,OAAO,CAMT;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,GACjB,SAAS,EAAE,CA6Gb;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAOT;AAwBD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/lib/engine/q-continuum.d.ts

@@ -0,0 +1,25 @@
+import { Captain, PlayerId } from '../types/player.js';
+import { GameState, RoundState } from '../types/game-state.js';
+import { QFlashEffect, QFlashEffectKind, QGamblePending, QRoundEffects } from '../types/q-continuum.js';
+declare function mergeQEffects(current: QRoundEffects | null, patch: Partial<QRoundEffects>): QRoundEffects;
+export declare function turnOrderReversed(round: RoundState): boolean;
+export declare function consumeSkipForPlayer(effects: QRoundEffects | null, playerId: PlayerId): QRoundEffects | null;
+export declare function nextActivePlayerId(round: RoundState, currentPlayerId: PlayerId): PlayerId;
+export declare function advanceActivePlayer(round: RoundState): RoundState;
+export declare function lowestPenaltyCaptainId(captains: readonly Captain[]): PlayerId | null;
+export declare function highestPenaltyCaptainId(captains: readonly Captain[], excludeId?: PlayerId): PlayerId | null;
+export declare function buildQFlashEffect(kind: QFlashEffectKind, state: GameState, round: RoundState, invokerId: PlayerId): QFlashEffect | null;
+export declare function applyQFlashEffect(round: RoundState, effect: QFlashEffect, invokerId: PlayerId): {
+    round: RoundState;
+    gamble: QGamblePending | null;
+};
+export declare function clearTemporalInversionOnDouble(round: RoundState): RoundState;
+export declare function consumeFractureImmunity(round: RoundState): {
+    round: RoundState;
+    consumed: boolean;
+};
+export declare function resolveQGamble(round: RoundState, playerId: PlayerId, keepIndex: 0 | 1): RoundState;
+export declare function treatyRequiredForWin(round: RoundState, routeKind: import('../types/actions.js').ChartRoute['kind']): boolean;
+export declare function trailsOpenToOthers(round: RoundState, trailPlayerId: PlayerId): boolean;
+export { mergeQEffects };
+//# sourceMappingURL=q-continuum.d.ts.map

package/dist/lib/engine/q-continuum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"q-continuum.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/q-continuum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACd,MAAM,yBAAyB,CAAC;AAGjC,iBAAS,aAAa,CACpB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,aAAa,CAsBf;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAM5D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,QAAQ,EAAE,QAAQ,GACjB,aAAa,GAAG,IAAI,CAOtB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,QAAQ,GACxB,QAAQ,CAgBV;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAOjE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAC3B,QAAQ,GAAG,IAAI,CAOjB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,SAAS,CAAC,EAAE,QAAQ,GACnB,QAAQ,GAAG,IAAI,CAUjB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,QAAQ,GAClB,YAAY,GAAG,IAAI,CAgCrB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,QAAQ,GAClB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CAuFtD;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,UAAU,GAChB,UAAU,CAQZ;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAChB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAW1C;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,CAAC,GAAG,CAAC,GACf,UAAU,CAkBZ;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,OAAO,qBAAqB,EAAE,UAAU,CAAC,MAAM,CAAC,GAC1D,OAAO,CAKT;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,GAAG,OAAO,CAKtF;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/lib/engine/round-resolution.d.ts

@@ -0,0 +1,13 @@
+import { ChartRoute } from '../types/actions.js';
+import { RoundState } from '../types/game-state.js';
+/** Draw pile empty and no captain can chart anywhere (after dead-double resolution). */
+export declare function isRoundBlocked(round: RoundState): boolean;
+export declare function endBlockedRound(round: RoundState): RoundState;
+export declare function maybeEndBlockedRound(round: RoundState): RoundState;
+export interface PendingRoundWin {
+    readonly playerId: string;
+    readonly routeKind: ChartRoute['kind'];
+}
+export declare function applyPendingRoundWin(round: RoundState): RoundState;
+export declare function finalizeRoundWinAfterQ(round: RoundState): RoundState;
+//# sourceMappingURL=round-resolution.d.ts.map

package/dist/lib/engine/round-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-resolution.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/round-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAKzD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CA4BzD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAW7D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAMlE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAelE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAMpE"}

package/dist/lib/engine/scoring.d.ts

@@ -0,0 +1,9 @@
+import { GameState, RoundState } from '../types/game-state.js';
+import { ActionResult } from '../types/actions.js';
+/** Pip penalty for tiles still in hand (same rules as end-of-round scoring). */
+export declare function handPenaltyPoints(hand: readonly {
+    low: number;
+    high: number;
+}[], salamanderEnabled: boolean, roundNumber: number): number;
+export declare function scoreRound(state: GameState, round: RoundState, random?: () => number): ActionResult;
+//# sourceMappingURL=scoring.d.ts.map

package/dist/lib/engine/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../../src/lib/engine/scoring.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAsCxD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC9C,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAiED,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,UAAU,EACjB,MAAM,GAAE,MAAM,MAAoB,GACjC,YAAY,CAgEd"}