warp12-react 0.1.0

package/README.md

@@ -0,0 +1,24 @@
+# warp12-react
+
+React adapters for Warp 12 — `RoundState` to DoubleTwelve trains, tactical advisor, hand layout.
+
+Published on npm as **`warp12-react`**.
+
+## Install
+
+```bash
+npm install warp12-react warp12-engine doubletwelve react react-dom
+```
+
+## Usage
+
+```ts
+import { gameStateToTrains, getCoachSuggestion, useHandLayout } from 'warp12-react';
+```
+
+## Build
+
+```bash
+yarn build:react
+yarn test:react
+```

package/dist/adapters/game-to-trains.d.ts

@@ -0,0 +1,12 @@
+import { Coordinate, PlacedCoordinate, RoundState } from '../../../engine/src/index.ts';
+import { TrainData, DominoValue } from '../../../../vendor/DoubleTwelve/dist/index.js';
+/** Hub arm reserved for the Neutral Zone (8-spoke layout). */
+export declare const NEUTRAL_ZONE_SLOT = 7;
+/** Map engine placement to domino halves with value1 toward the connecting end. */
+export declare function placedToDomino(placed: PlacedCoordinate, connectValue?: number): DominoValue;
+/** Walk a trail so each tile's value1 faces the hub or previous open end. */
+export declare function tilesToDominoChain(tiles: readonly PlacedCoordinate[], hubValue: number): DominoValue[];
+export declare function gameStateToTrains(round: RoundState, hubSlots?: number): TrainData[];
+export declare function coordinatesEqual(a: Coordinate, b: Coordinate): boolean;
+export declare function routeLabel(route: import('../../../engine/src/index.ts').ChartRoute, captainNames: Readonly<Record<string, string>>): string;
+//# sourceMappingURL=game-to-trains.d.ts.map

package/dist/adapters/game-to-trains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-to-trains.d.ts","sourceRoot":"","sources":["../../src/adapters/game-to-trains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,mFAAmF;AACnF,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CAiBb;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAClC,QAAQ,EAAE,MAAM,GACf,WAAW,EAAE,CAWf;AAiCD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,SAAI,GACX,SAAS,EAAE,CAkDb;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAEtE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,eAAe,EAAE,UAAU,EACzC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC7C,MAAM,CAgBR"}

package/dist/adapters/table-focus.d.ts

@@ -0,0 +1,35 @@
+import { RoundState } from '../../../engine/src/index.ts';
+export type ChartSite = {
+    kind: 'warp-trail';
+    captainId: string;
+    tileIndex: number;
+} | {
+    kind: 'neutral-zone';
+    tileIndex: number;
+} | {
+    kind: 'fracture-stabilizer';
+    trailPlayerId: string;
+};
+export interface TableFocusPoint {
+    x: number;
+    y: number;
+    key: string;
+}
+export interface TableFocusOptions {
+    round: RoundState;
+    site: ChartSite;
+    layoutStyle: 'offset' | 'linear';
+    centerX: number;
+    centerY: number;
+    hubRadius: number;
+    hubSlots: number;
+}
+/** Detect where a new coordinate was charted between two round snapshots. */
+export declare function detectNewChart(previous: RoundState | null, next: RoundState): ChartSite | null;
+export declare function computeTableFocusPoint(options: TableFocusOptions): TableFocusPoint | null;
+/** Pan offset so content point sits at the viewport center at the given scale. */
+export declare function panToCenterContentPoint(viewportWidth: number, viewportHeight: number, scale: number, contentX: number, contentY: number): {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=table-focus.d.ts.map

package/dist/adapters/table-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-focus.d.ts","sourceRoot":"","sources":["../../src/adapters/table-focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAYhD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,GAAG,IAAI,EAC3B,IAAI,EAAE,UAAU,GACf,SAAS,GAAG,IAAI,CAwClB;AAyBD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,GACzB,eAAe,GAAG,IAAI,CAoExB;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}

package/dist/adapters/trail-access.d.ts

@@ -0,0 +1,14 @@
+import { RoundState } from '../../../engine/src/index.ts';
+export type TrailAccessState = 'open' | 'shields' | 'neutral' | 'red-alert';
+export interface TrailSpokeStatus {
+    readonly slot: number;
+    readonly captainId: string | null;
+    readonly label: string;
+    readonly state: TrailAccessState;
+    readonly connectValue: number;
+}
+/** Whether other captains may chart on this warp trail. */
+export declare function isWarpTrailOpenToOthers(round: RoundState, captainId: string): boolean;
+export declare function buildTrailSpokeStatuses(round: RoundState, names: Readonly<Record<string, string>>, hubSlots: number): TrailSpokeStatus[];
+export declare function openTrailCaptainNames(statuses: readonly TrailSpokeStatus[]): string[];
+//# sourceMappingURL=trail-access.d.ts.map

package/dist/adapters/trail-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail-access.d.ts","sourceRoot":"","sources":["../../src/adapters/trail-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAIvB,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,2DAA2D;AAC3D,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAET;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACvC,QAAQ,EAAE,MAAM,GACf,gBAAgB,EAAE,CAmDpB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,MAAM,EAAE,CAIV"}

package/dist/coach/warp-coach.d.ts

@@ -0,0 +1,14 @@
+import { ChartRoute, GameAction, GameState, PlayerId, WarpAiAction } from '../../../engine/src/index.ts';
+export interface CoachSuggestion {
+    readonly action: WarpAiAction;
+    readonly gameAction: GameAction;
+    readonly reasons: readonly string[];
+}
+export declare function getCoachSuggestion(state: GameState, playerId: PlayerId): CoachSuggestion | null;
+export declare function formatCoachSuggestion(action: WarpAiAction, names: Readonly<Record<string, string>>): string;
+export declare function coachChartMove(action: WarpAiAction): {
+    coordinate: import('../../../engine/src/index.ts').Coordinate;
+    route: ChartRoute;
+} | null;
+export declare function coachActionKind(action: WarpAiAction): WarpAiAction['kind'];
+//# sourceMappingURL=warp-coach.d.ts.map

package/dist/coach/warp-coach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-coach.d.ts","sourceRoot":"","sources":["../../src/coach/warp-coach.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GACjB,eAAe,GAAG,IAAI,CAkBxB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACtC,MAAM,CAqBR;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IACpD,UAAU,EAAE,OAAO,eAAe,EAAE,UAAU,CAAC;IAC/C,KAAK,EAAE,UAAU,CAAC;CACnB,GAAG,IAAI,CAKP;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAE1E"}

package/dist/hand/action-log.d.ts

@@ -0,0 +1,20 @@
+import { GameAction } from '../../../engine/src/index.ts';
+export type ActionLogSource = 'human' | 'ai' | 'auto';
+export interface ActionLogEntry {
+    at: string;
+    playerId: string;
+    action: GameAction;
+    ok: boolean | null;
+    violation?: string;
+    source: ActionLogSource;
+}
+export interface ActionLog {
+    append(entry: Omit<ActionLogEntry, 'at'> & {
+        at?: string;
+    }): void;
+    snapshot(): readonly ActionLogEntry[];
+    clear(): void;
+}
+export declare function playerIdForAction(action: GameAction): string;
+export declare function createActionLog(): ActionLog;
+//# sourceMappingURL=action-log.d.ts.map

package/dist/hand/action-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-log.d.ts","sourceRoot":"","sources":["../../src/hand/action-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,QAAQ,IAAI,SAAS,cAAc,EAAE,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAK5D;AAED,wBAAgB,eAAe,IAAI,SAAS,CAiB3C"}

package/dist/hand/hand-layout.d.ts

@@ -0,0 +1,30 @@
+import { Coordinate } from '../../../engine/src/index.ts';
+export type HandSortMode = 'custom' | 'pips-desc' | 'pips-asc' | 'low-first' | 'doubles-first' | 'best-train';
+export declare function coordinateKey(coordinate: Coordinate): string;
+export declare function pipValue(coordinate: Coordinate): number;
+/** Keep the player's custom order; append newly drawn tiles at the end. */
+export declare function mergeHandOrder(previousOrder: readonly string[], hand: readonly Coordinate[]): string[];
+export declare function sortHand(hand: readonly Coordinate[], mode: HandSortMode): string[];
+/** Order and orient the hand as the longest chain from the given open end. */
+export declare function bestTrainLayout(hand: readonly Coordinate[], connectValue: number): StoredHandLayout;
+export declare function reorderHand(order: readonly string[], fromKey: string, toKey: string): string[];
+export declare function orderHand(hand: readonly Coordinate[], order: readonly string[]): Coordinate[];
+export declare function handLayoutStorageKey(gameId: string, playerId: string): string;
+export interface StoredHandLayout {
+    order: string[];
+    flipped?: Record<string, boolean>;
+}
+export declare function mergeFlippedKeys(previous: Readonly<Record<string, boolean>>, hand: readonly Coordinate[]): Record<string, boolean>;
+export declare function toggleFlippedKey(flipped: Readonly<Record<string, boolean>>, key: string): Record<string, boolean>;
+export declare function isCoordinateFlipped(flipped: Readonly<Record<string, boolean>>, key: string): boolean;
+export declare function displayCoordinateValues(coordinate: Coordinate, flipped: boolean): {
+    top: number;
+    bottom: number;
+};
+export declare function readStoredHandLayout(gameId: string, playerId: string): StoredHandLayout | null;
+export declare function writeStoredHandLayout(gameId: string, playerId: string, layout: StoredHandLayout): void;
+/** @deprecated Use readStoredHandLayout */
+export declare function readStoredHandOrder(gameId: string, playerId: string): string[] | null;
+/** @deprecated Use writeStoredHandLayout */
+export declare function writeStoredHandOrder(gameId: string, playerId: string, order: readonly string[]): void;
+//# sourceMappingURL=hand-layout.d.ts.map

package/dist/hand/hand-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hand-layout.d.ts","sourceRoot":"","sources":["../../src/hand/hand-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,WAAW,GACX,eAAe,GACf,YAAY,CAAC;AAEjB,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE5D;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEvD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,IAAI,EAAE,SAAS,UAAU,EAAE,GAC1B,MAAM,EAAE,CAUV;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,CA8ClF;AA8FD,8EAA8E;AAC9E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,YAAY,EAAE,MAAM,GACnB,gBAAgB,CA+BlB;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAWV;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,EAAE,CAKd;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAKD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,IAAI,EAAE,SAAS,UAAU,EAAE,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1C,GAAG,EAAE,MAAM,GACV,OAAO,CAET;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,GACf;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAIjC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,GAAG,IAAI,CAuBzB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CASN;AAED,2CAA2C;AAC3C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,GAAG,IAAI,CAEjB;AAED,4CAA4C;AAC5C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,IAAI,CAEN"}

package/dist/hand/use-hand-layout.d.ts

@@ -0,0 +1,14 @@
+import { Coordinate } from '../../../engine/src/index.ts';
+import { HandSortMode } from './hand-layout.js';
+export declare function useHandLayout(gameId: string, playerId: string, hand: readonly Coordinate[]): {
+    orderedHand: Coordinate[];
+    applySort: (mode: HandSortMode, connectValue?: number) => void;
+    toggleFlip: (key: string) => void;
+    isFlipped: (key: string) => boolean;
+    onDragStart: (key: string, event: React.DragEvent<HTMLButtonElement>) => void;
+    onDragEnd: () => void;
+    onDragOver: (event: React.DragEvent) => void;
+    onDrop: (targetKey: string) => void;
+    shouldIgnoreClick: () => boolean;
+};
+//# sourceMappingURL=use-hand-layout.d.ts.map

package/dist/hand/use-hand-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-hand-layout.d.ts","sourceRoot":"","sources":["../../src/hand/use-hand-layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAYL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAe1B,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,SAAS,UAAU,EAAE;;sBAkClB,YAAY,iBAAiB,MAAM;sBAYP,MAAM;qBAKnC,MAAM;uBAKN,MAAM,SAAS,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC;;wBAiBlB,KAAK,CAAC,SAAS;wBAKf,MAAM;;EAoB9C"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './adapters/game-to-trains.js';
+export * from './adapters/trail-access.js';
+export * from './adapters/table-focus.js';
+export * from './coach/warp-coach.js';
+export * from './hand/hand-layout.js';
+export * from './hand/use-hand-layout.js';
+export * from './hand/action-log.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,457 @@
+import { createWarpAiPlayer as e, explainWarpAiAction as t, getWarpSkillProfile as n, neutralZoneOpenValue as r, observe as i, toGameAction as a, trailOpenValue as o, trailsOpenToOthers as s } from "warp12-engine";
+import { computeTrainTree as c, flattenSegments as l, hubTrainStartDistance as u } from "doubletwelve";
+import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h } from "react";
+//#region libs/react/src/adapters/game-to-trains.ts
+var g = 7;
+function _(e, t) {
+	let { coordinate: n } = e;
+	if (t !== void 0) {
+		if (n.low === t) return {
+			value1: n.low,
+			value2: n.high
+		};
+		if (n.high === t) return {
+			value1: n.high,
+			value2: n.low
+		};
+	}
+	let { openValue: r } = e;
+	return {
+		value1: n.low === r ? n.high : n.low,
+		value2: r
+	};
+}
+function v(e, t) {
+	let n = t, r = [];
+	for (let t of e) {
+		let e = _(t, n);
+		r.push(e), n = t.openValue;
+	}
+	return r;
+}
+function y(e, t) {
+	let n = e.table.subspaceFracture;
+	if (!n || n.stabilizers.length === 0) return;
+	let r = e.table.warpTrails[t].tiles.findIndex((e) => e.index === n.anchor.index);
+	if (r === -1) return;
+	let i = n.stabilizers.slice(0, 2).map((e) => ({ dominoes: [_(e, n.requiredValue)] }));
+	if (i.length !== 0) return { [r]: i };
+}
+function b(e, t = 8) {
+	let n = [], r = e.spacedockValue, i = new Map(e.turnOrder.map((e, t) => [e, t]));
+	for (let t of e.turnOrder) {
+		let a = i.get(t), o = e.table.warpTrails[t], c = v(o.tiles, r), l = e.table.subspaceFracture;
+		if (l && l.stabilizers.length >= 3 && e.turnOrder.find((t) => e.table.warpTrails[t].tiles.some((e) => e.index === l.anchor.index)) === t) {
+			let e = l.anchor.index, t = l.stabilizers[2], n = c.slice(0, e + 1), r = _(t, l.requiredValue), i = v(o.tiles.slice(e + 1), t.openValue);
+			c = [
+				...n,
+				r,
+				...i
+			];
+		}
+		n.push({
+			playerId: a,
+			isPublic: s(e, t),
+			dominoes: c,
+			feet: y(e, t)
+		});
+	}
+	return (e.table.neutralZone.tiles.length > 0 || t > e.turnOrder.length) && n.push({
+		playerId: 7,
+		isPublic: !0,
+		dominoes: v(e.table.neutralZone.tiles, r)
+	}), n;
+}
+function ee(e, t) {
+	return e.low === t.low && e.high === t.high;
+}
+function x(e, t) {
+	switch (e.kind) {
+		case "warp-trail": return `Warp trail · ${t[e.playerId] ?? e.playerId}`;
+		case "neutral-zone": return "Neutral zone";
+		case "fracture-stabilizer": return "Stabilize fracture";
+		case "red-alert-cover": {
+			if (e.neutralZone) return "Cover red alert · Neutral zone";
+			let n = e.trailPlayerId ?? "fleet";
+			return `Cover red alert · ${t[n] ?? n}`;
+		}
+	}
+}
+//#endregion
+//#region libs/react/src/adapters/trail-access.ts
+function S(e, t) {
+	return s(e, t);
+}
+function te(e, t, n) {
+	let i = new Map(e.turnOrder.map((e, t) => [e, t])), a = [];
+	for (let s = 0; s < n; s += 1) {
+		if (s === 7) {
+			a.push({
+				slot: s,
+				captainId: null,
+				label: "Neutral",
+				state: "neutral",
+				connectValue: r(e.table.neutralZone, e.spacedockValue)
+			});
+			continue;
+		}
+		let n = e.turnOrder.find((e) => i.get(e) === s);
+		if (!n) continue;
+		let c = e.table.warpTrails[n], l = o(c, e.spacedockValue), u = e.table.redAlert?.active && e.table.redAlert.trailPlayerId === n, d = "shields";
+		u ? d = "red-alert" : S(e, n) && (d = "open"), a.push({
+			slot: s,
+			captainId: n,
+			label: t[n] ?? n,
+			state: d,
+			connectValue: l
+		});
+	}
+	return a;
+}
+function C(e) {
+	return e.filter((e) => e.state === "open" && e.captainId).map((e) => e.label);
+}
+//#endregion
+//#region libs/react/src/adapters/table-focus.ts
+var w = 60;
+function T(e, t) {
+	if (!e || e.roundNumber !== t.roundNumber) return null;
+	let n = e.table.subspaceFracture, r = t.table.subspaceFracture;
+	if (r && (n?.stabilizers.length ?? 0) < r.stabilizers.length) {
+		for (let e of t.turnOrder) if (t.table.warpTrails[e].tiles.some((e) => e.index === r.anchor.index)) return {
+			kind: "fracture-stabilizer",
+			trailPlayerId: e
+		};
+	}
+	let i = e.table.neutralZone.tiles.length, a = t.table.neutralZone.tiles.length;
+	if (a > i) return {
+		kind: "neutral-zone",
+		tileIndex: a - 1
+	};
+	for (let n of t.turnOrder) {
+		let r = e.table.warpTrails[n]?.tiles.length ?? 0, i = t.table.warpTrails[n]?.tiles.length ?? 0;
+		if (i > r) return {
+			kind: "warp-trail",
+			captainId: n,
+			tileIndex: i - 1
+		};
+	}
+	return null;
+}
+function E(e, t, n, r, i, a) {
+	let o = e * 360 / t, s = o * Math.PI / 180, c = u(t, i, w, a);
+	return {
+		startX: n + c * Math.cos(s),
+		startY: r + c * Math.sin(s),
+		angle: o
+	};
+}
+function D(e) {
+	let t = b(e.round, e.hubSlots), { site: n, layoutStyle: r, centerX: i, centerY: a, hubRadius: o, hubSlots: s } = e, u, d;
+	switch (n.kind) {
+		case "warp-trail":
+			u = e.round.turnOrder.indexOf(n.captainId), d = n.tileIndex;
+			break;
+		case "neutral-zone":
+			u = 7, d = n.tileIndex;
+			break;
+		case "fracture-stabilizer":
+			u = e.round.turnOrder.indexOf(n.trailPlayerId), d = null;
+			break;
+		default: return null;
+	}
+	if (u < 0) return null;
+	let f = t.find((e) => e.playerId === u);
+	if (!f) return null;
+	let p = E(u, s, i, a, o, r), m = l(c({
+		startX: p.startX,
+		startY: p.startY,
+		angle: p.angle,
+		branch: {
+			dominoes: f.dominoes,
+			feet: f.feet
+		},
+		layoutStyle: r
+	})), h = d != null && d >= 0 ? m[d] ?? m.at(-1) : m.at(-1);
+	if (!h) return null;
+	let g = n.kind === "warp-trail" ? `warp:${n.captainId}:${n.tileIndex}` : n.kind === "neutral-zone" ? `neutral:${n.tileIndex}` : `fracture:${n.trailPlayerId}:${e.round.table.subspaceFracture?.stabilizers.length ?? 0}`;
+	return {
+		x: h.x,
+		y: h.y,
+		key: g
+	};
+}
+function O(e, t, n, r, i) {
+	return {
+		x: e / 2 - r * n,
+		y: t / 2 - i * n
+	};
+}
+//#endregion
+//#region libs/react/src/coach/warp-coach.ts
+function k(r, o) {
+	let s = i(r, o);
+	if (!s) return null;
+	let c = e({
+		skill: n("advanced", r.objective),
+		objective: r.objective,
+		lookahead: {
+			depth: 2,
+			determinizations: 6,
+			maxBranch: 6
+		}
+	}).decide(s);
+	return {
+		action: c,
+		gameAction: a(c, o),
+		reasons: t(r, o, c)
+	};
+}
+function A(e, t) {
+	switch (e.kind) {
+		case "chart": {
+			let { low: n, high: r } = e.move.coordinate;
+			return `Chart ${n}-${r} · ${x(e.move.route, t)}`;
+		}
+		case "draw": return "Draw from Uncharted Sectors";
+		case "deploy-beacon": return "Deploy Distress Beacon (shields down)";
+		case "pass-red-alert": return "Pass Red Alert to the next captain";
+		case "pass-turn": return "Pass turn (voluntary shields down)";
+		case "declare-treaty": return "Drop to impulse · Neutral Zone win";
+		case "invoke-q-flash": return `Invoke Q-Flash · ${e.effect.replaceAll("-", " ")}`;
+		case "resolve-q-gamble": return `Keep gamble tile ${e.keepIndex + 1}`;
+	}
+}
+function j(e) {
+	return e.kind === "chart" ? e.move : null;
+}
+function M(e) {
+	return e.kind;
+}
+//#endregion
+//#region libs/react/src/hand/hand-layout.ts
+function N(e) {
+	return `${e.low}-${e.high}`;
+}
+function P(e) {
+	return e.low + e.high;
+}
+function F(e, t) {
+	let n = new Set(t.map(N)), r = e.filter((e) => n.has(e));
+	for (let e of t) {
+		let t = N(e);
+		r.includes(t) || r.push(t);
+	}
+	return r;
+}
+function I(e, t) {
+	let n = e.map((e) => ({
+		key: N(e),
+		coordinate: e
+	}));
+	switch (t) {
+		case "pips-desc":
+			n.sort((e, t) => P(t.coordinate) - P(e.coordinate) || e.coordinate.low - t.coordinate.low || e.coordinate.high - t.coordinate.high);
+			break;
+		case "pips-asc":
+			n.sort((e, t) => P(e.coordinate) - P(t.coordinate) || e.coordinate.low - t.coordinate.low || e.coordinate.high - t.coordinate.high);
+			break;
+		case "low-first":
+			n.sort((e, t) => e.coordinate.low - t.coordinate.low || e.coordinate.high - t.coordinate.high);
+			break;
+		case "doubles-first":
+			n.sort((e, t) => (e.coordinate.low === e.coordinate.high ? 0 : 1) - (t.coordinate.low === t.coordinate.high ? 0 : 1) || P(t.coordinate) - P(e.coordinate) || e.coordinate.low - t.coordinate.low);
+			break;
+		default: break;
+	}
+	return n.map((e) => e.key);
+}
+function L(e, t) {
+	return e.low === t || e.high === t;
+}
+function R(e, t) {
+	return e.low === t ? e.high : e.low;
+}
+function z(e, t) {
+	return e.low === t ? !1 : e.high === t;
+}
+function B(e, t, n) {
+	if (e.length !== t.length) return e.length - t.length;
+	let r = (e) => e.reduce((e, t) => e + P(n.get(t.key) ?? {
+		low: 0,
+		high: 0
+	}), 0), i = r(e) - r(t);
+	return i === 0 ? e.map((e) => e.key).join(",").localeCompare(t.map((e) => e.key).join(",")) : i;
+}
+function V(e, t) {
+	let n = e.map((e) => ({
+		key: N(e),
+		coordinate: e
+	})), r = new Map(n.map((e) => [e.key, e.coordinate])), i = n.length, a = [], o = (e, t, s) => {
+		if (B(s, a, r) > 0 && (a = s.slice()), !(s.length + (i - s.length) <= a.length)) for (let r = 0; r < i; r += 1) {
+			if (t[r]) continue;
+			let { key: i, coordinate: a } = n[r];
+			L(a, e) && (t[r] = !0, s.push({
+				key: i,
+				connectOn: e
+			}), o(R(a, e), t, s), s.pop(), t[r] = !1);
+		}
+	};
+	return o(t, Array.from({ length: i }, () => !1), []), a;
+}
+function H(e, t) {
+	let n = e.map((e) => ({
+		key: N(e),
+		coordinate: e
+	})), r = new Map(n.map((e) => [e.key, e.coordinate])), i = V(e, t), a = new Set(i.map((e) => e.key)), o = {};
+	for (let e of i) {
+		let t = r.get(e.key);
+		t && z(t, e.connectOn) && (o[e.key] = !0);
+	}
+	let s = n.filter((e) => !a.has(e.key)).sort((e, t) => P(t.coordinate) - P(e.coordinate) || e.coordinate.low - t.coordinate.low || e.coordinate.high - t.coordinate.high).map((e) => e.key);
+	return {
+		order: [...i.map((e) => e.key), ...s],
+		flipped: q(o, e)
+	};
+}
+function U(e, t, n) {
+	if (t === n) return [...e];
+	let r = e.filter((e) => e !== t), i = r.indexOf(n);
+	return i === -1 ? [...e] : (r.splice(i, 0, t), r);
+}
+function W(e, t) {
+	let n = new Map(e.map((e) => [N(e), e]));
+	return t.map((e) => n.get(e)).filter((e) => e !== void 0);
+}
+function G(e, t) {
+	return `warp12-hand-layout:${e}:${t}`;
+}
+var K = (e, t) => `warp12-hand-order:${e}:${t}`;
+function q(e, t) {
+	let n = new Set(t.map(N)), r = {};
+	for (let [t, i] of Object.entries(e)) n.has(t) && i && (r[t] = !0);
+	return r;
+}
+function J(e, t) {
+	if (e[t]) {
+		let n = { ...e };
+		return delete n[t], n;
+	}
+	return {
+		...e,
+		[t]: !0
+	};
+}
+function Y(e, t) {
+	return e[t] ?? !1;
+}
+function X(e, t) {
+	return t ? {
+		top: e.high,
+		bottom: e.low
+	} : {
+		top: e.low,
+		bottom: e.high
+	};
+}
+function Z(e, t) {
+	try {
+		let n = localStorage.getItem(G(e, t)) ?? localStorage.getItem(K(e, t));
+		if (!n) return null;
+		let r = JSON.parse(n);
+		return Array.isArray(r) && r.every((e) => typeof e == "string") ? { order: r } : r && typeof r == "object" && "order" in r && Array.isArray(r.order) && r.order.every((e) => typeof e == "string") ? r : null;
+	} catch {
+		return null;
+	}
+}
+function Q(e, t, n) {
+	try {
+		localStorage.setItem(G(e, t), JSON.stringify(n));
+	} catch {}
+}
+function ne(e, t) {
+	return Z(e, t)?.order ?? null;
+}
+function re(e, t, n) {
+	Q(e, t, { order: [...n] });
+}
+//#endregion
+//#region libs/react/src/hand/use-hand-layout.ts
+var ie = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7", $ = null;
+function ae() {
+	return $ || ($ = new Image(), $.src = ie), $;
+}
+function oe(e, t, n) {
+	let r = p(() => n.map(N).sort().join("|"), [n]), [i, a] = h(() => F(Z(e, t)?.order ?? n.map(N), n)), [o, s] = h(() => q(Z(e, t)?.flipped ?? {}, n)), c = m(null), l = m(!1);
+	return f(() => {
+		a((e) => F(e, n)), s((e) => q(e, n));
+	}, [
+		e,
+		t,
+		r
+	]), f(() => {
+		Q(e, t, {
+			order: i,
+			flipped: o
+		});
+	}, [
+		e,
+		t,
+		i,
+		o
+	]), {
+		orderedHand: p(() => W(n, i), [n, i]),
+		applySort: d((e, t) => {
+			if (e === "best-train" && t !== void 0) {
+				let e = H(n, t);
+				a(e.order), s(e.flipped ?? {});
+				return;
+			}
+			a(I(n, e));
+		}, [n]),
+		toggleFlip: d((e) => {
+			s((t) => J(t, e));
+		}, []),
+		isFlipped: d((e) => Y(o, e), [o]),
+		onDragStart: d((e, t) => {
+			c.current = e, l.current = !0, t.dataTransfer.effectAllowed = "move", t.dataTransfer.setData("text/plain", e), t.dataTransfer.setDragImage(ae(), 0, 0);
+		}, []),
+		onDragEnd: d(() => {
+			c.current = null, window.setTimeout(() => {
+				l.current = !1;
+			}, 0);
+		}, []),
+		onDragOver: d((e) => {
+			e.preventDefault(), e.dataTransfer.dropEffect = "move";
+		}, []),
+		onDrop: d((e) => {
+			let t = c.current;
+			t && (a((n) => U(n, t, e)), c.current = null);
+		}, []),
+		shouldIgnoreClick: d(() => l.current, [])
+	};
+}
+//#endregion
+//#region libs/react/src/hand/action-log.ts
+function se(e) {
+	return e.type === "END_ROUND" ? e.winnerId ?? "" : e.playerId;
+}
+function ce() {
+	let e = [];
+	return {
+		append(t) {
+			e.push({
+				...t,
+				at: t.at ?? (/* @__PURE__ */ new Date()).toISOString()
+			});
+		},
+		snapshot() {
+			return [...e];
+		},
+		clear() {
+			e.length = 0;
+		}
+	};
+}
+//#endregion
+export { g as NEUTRAL_ZONE_SLOT, H as bestTrainLayout, te as buildTrailSpokeStatuses, M as coachActionKind, j as coachChartMove, D as computeTableFocusPoint, N as coordinateKey, ee as coordinatesEqual, ce as createActionLog, T as detectNewChart, X as displayCoordinateValues, A as formatCoachSuggestion, b as gameStateToTrains, k as getCoachSuggestion, G as handLayoutStorageKey, Y as isCoordinateFlipped, S as isWarpTrailOpenToOthers, q as mergeFlippedKeys, F as mergeHandOrder, C as openTrailCaptainNames, W as orderHand, O as panToCenterContentPoint, P as pipValue, _ as placedToDomino, se as playerIdForAction, Z as readStoredHandLayout, ne as readStoredHandOrder, U as reorderHand, x as routeLabel, I as sortHand, v as tilesToDominoChain, J as toggleFlippedKey, oe as useHandLayout, Q as writeStoredHandLayout, re as writeStoredHandOrder };

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "warp12-react",
+  "version": "0.1.0",
+  "description": "React adapters for Warp 12 — state to trains, coach, hand layout",
+  "license": "MIT",
+  "author": "Jessica Mulein",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@warp12/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "warp12",
+    "react",
+    "mexican-train",
+    "dominoes",
+    "game"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Digital-Defiance/Warp12.git",
+    "directory": "libs/react"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "prepublishOnly": "cd ../.. && yarn build:react && yarn test:react"
+  },
+  "peerDependencies": {
+    "doubletwelve": ">=0.3.0",
+    "react": ">=18.0.0",
+    "warp12-engine": ">=0.1.0"
+  },
+  "devDependencies": {
+    "doubletwelve": "workspace:*",
+    "react": "^19.0.0",
+    "warp12-engine": "workspace:*"
+  }
+}