@scriptonita/chess-football-ui 0.8.0 → 0.10.0

package/README.md

@@ -52,9 +52,59 @@ expect(missing).toEqual([])
 ```
 
 **2. Design tokens.** Components emit Tailwind classes bound to tokens the app defines. A
-token that is missing fails silently — the rule simply does not apply. The board's
-`--last-move-highlight`, `--move-highlight`, `--pass-highlight`, `--accent-green`,
-`--accent-green-light` and `--accent-green-dark` are all required.
+token that is missing fails silently — Tailwind emits the rule, the variable resolves to
+nothing, and the declaration is dropped. That is how `--last-move-highlight` went missing
+in the CrazyGames SPA: the last-move highlight and the bot's turn replay never rendered,
+with no error anywhere. `REQUIRED_TOKENS` is the manifest; assert it the same way:
+
+```ts
+import { REQUIRED_TOKENS } from '@scriptonita/chess-football-ui'
+
+const css = readFileSync('src/index.css', 'utf8')
+expect(REQUIRED_TOKENS.filter(t => !css.includes(`${t}:`))).toEqual([])
+```
+
+`--field-frame` is new in 0.9.0: the board frame was hardcoded `#1a3317` in three places,
+hand-tuned for the webapp's grass and visibly wrong against the CrazyGames pitch.
+
+`--ball-color` joins the contract in 0.10.0: the ball was a hardcoded sky blue, the same
+hue as `--pass-highlight`, while both apps defined a `--ball-color` nobody read.
+
+## Bot turn
+
+`useBotTurn` owns a bot's turn end to end — entry gates (turn, pending goal, match over),
+timed replay, cancellation on unmount, error + retry, and skip. The app only says where the
+turn comes from, so the same hook serves a local search and a server call:
+
+```tsx
+import { useBotTurn } from '@scriptonita/chess-football-ui'
+import { playBotTurn } from '@scriptonita/chess-football-engine'
+
+const { botThinking, error, retry, skip } = useBotTurn({
+  boardState, botSide,
+  getTurn: (board, side) => playBotTurn(bot, board, side),       // local
+  // getTurn: (board) => fetch('/api/turn', …).then(r => r.json()), // server
+  onApplyState: setBoardState,
+  matchOver: !!matchResult,
+  goalPending: !!goalScored,
+})
+```
+
+Pacing is fixed in one place: `BOT_TURN_START_DELAY_MS` (400) before the first action,
+`BOT_TURN_STEP_MS` (900) between actions and `BOT_TURN_SETTLE_MS` (500) for the last one to
+land. The closing end-of-turn state takes no step of its own, so a full 5-AP turn lasts 4.5 s.
+
+## First-match hints
+
+`<GameHints userSide seen onSeen />` shows one dismissible sentence the first time each
+situation happens (`GAME_HINT_IDS`: first turn, selecting a piece, holding the ball, last
+action point). The texts are `hints.*` keys of `GAME_I18N_KEYS`. The app decides when to mount
+it and where `seen` is stored.
+
+## Forgiving taps
+
+`<GameBoard forgivingTaps />` resolves a touch on an empty square that borders exactly one
+legal target to that target. Opt-in, touch only, never when the tap is ambiguous.
 
 ## Peer dependencies
 

package/dist/{chunk-LTFNSTAQ.cjs → chunk-BSE4DUXM.cjs}

@@ -4,19 +4,31 @@ var zustand = require('zustand');
 var chessFootballEngine = require('@scriptonita/chess-football-engine');
 
 // src/store/use-game-store.ts
-var useGameStore = zustand.create((set) => ({
+var DEFAULT_MAX_AP = 5;
+var INITIAL = {
   boardState: null,
   selectedPieceId: null,
-  interactionMode: null,
+  interactionMode: null
+};
+var useGameStore = zustand.create((set) => ({
+  ...INITIAL,
   setBoardState: (state) => set({ boardState: state }),
   setSelectedPieceId: (id) => set({ selectedPieceId: id }),
   setInteractionMode: (mode) => set({ interactionMode: mode }),
+  /**
+   * The store is a module-global singleton, so a new match opens on the
+   * previous match's final board — which ended on a goal, and was therefore
+   * re-detected as a fresh goal (the bug behind webapp PR #42). Apps were
+   * each reaching for `useGameStore.setState({...})` by hand to work around
+   * it; this makes the intent explicit and keeps the shape in one place.
+   */
+  reset: () => set({ ...INITIAL }),
   resetTurn: () => set((state) => {
     if (!state.boardState) return state;
     return {
       boardState: {
         ...state.boardState,
-        actionPoints: state.boardState.maxActionPoints ?? 5,
+        actionPoints: state.boardState.maxActionPoints ?? DEFAULT_MAX_AP,
         pieces: state.boardState.pieces.map((p) => ({ ...p, hasMovedThisTurn: false }))
       }
     };
@@ -50,6 +62,7 @@ Object.defineProperty(exports, "getInitialBoardState", {
   enumerable: true,
   get: function () { return chessFootballEngine.getInitialBoardState; }
 });
+exports.DEFAULT_MAX_AP = DEFAULT_MAX_AP;
 exports.useGameStore = useGameStore;
-//# sourceMappingURL=chunk-LTFNSTAQ.cjs.map
-//# sourceMappingURL=chunk-LTFNSTAQ.cjs.map
+//# sourceMappingURL=chunk-BSE4DUXM.cjs.map
+//# sourceMappingURL=chunk-BSE4DUXM.cjs.map

package/dist/chunk-BSE4DUXM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store/use-game-store.ts"],"names":["create","applyMove","applyPass","applyEndTurn"],"mappings":"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","file":"chunk-BSE4DUXM.cjs","sourcesContent":["import { create } from 'zustand'\nimport type { BoardState, Position } from '@scriptonita/chess-football-engine'\nimport { applyMove, applyPass, applyEndTurn } from '@scriptonita/chess-football-engine'\n\n// The canonical kickoff position lives in the engine (rules-adjacent). Re-exported\n// here so app imports from `@scriptonita/chess-football-ui/store` keep working.\nexport { getInitialBoardState } from '@scriptonita/chess-football-engine'\n\n/**\n * Fallback when a board predates configurable action points. `maxActionPoints`\n * is optional on `BoardState`, and every consumer was inventing its own `?? 5`\n * — except `TurnBanner`, which had none and rendered \"3/\" on an old match.\n */\nexport const DEFAULT_MAX_AP = 5\n\ninterface GameStore {\n    boardState: BoardState | null\n    selectedPieceId: string | null\n    interactionMode: 'move' | 'pass' | null\n    setBoardState: (state: BoardState) => void\n    setSelectedPieceId: (id: string | null) => void\n    setInteractionMode: (mode: 'move' | 'pass' | null) => void\n    resetTurn: () => void\n    /** Return the store to its initial state. */\n    reset: () => void\n    movePiece: (pieceId: string, to: Position) => void\n    passBall: (to: Position) => void\n    endTurn: () => void\n}\n\nconst INITIAL = {\n    boardState: null,\n    selectedPieceId: null,\n    interactionMode: null,\n} satisfies Pick<GameStore, 'boardState' | 'selectedPieceId' | 'interactionMode'>\n\nexport const useGameStore = create<GameStore>((set) => ({\n    ...INITIAL,\n\n    setBoardState: (state) => set({ boardState: state }),\n    setSelectedPieceId: (id) => set({ selectedPieceId: id }),\n    setInteractionMode: (mode) => set({ interactionMode: mode }),\n\n    /**\n     * The store is a module-global singleton, so a new match opens on the\n     * previous match's final board — which ended on a goal, and was therefore\n     * re-detected as a fresh goal (the bug behind webapp PR #42). Apps were\n     * each reaching for `useGameStore.setState({...})` by hand to work around\n     * it; this makes the intent explicit and keeps the shape in one place.\n     */\n    reset: () => set({ ...INITIAL }),\n\n    resetTurn: () => set((state) => {\n        if (!state.boardState) return state\n        return {\n            boardState: {\n                ...state.boardState,\n                actionPoints: state.boardState.maxActionPoints ?? DEFAULT_MAX_AP,\n                pieces: state.boardState.pieces.map(p => ({ ...p, hasMovedThisTurn: false })),\n            },\n        }\n    }),\n\n    movePiece: (pieceId, to) => set((state) => {\n        if (!state.boardState || state.boardState.actionPoints <= 0) return state\n        const piece = state.boardState.pieces.find(p => p.id === pieceId)\n        if (!piece || piece.hasMovedThisTurn) return state\n\n        const { boardState } = applyMove(state.boardState, pieceId, to)\n        return { boardState, selectedPieceId: null, interactionMode: null }\n    }),\n\n    passBall: (to) => set((state) => {\n        if (!state.boardState || state.boardState.actionPoints <= 0 || !state.boardState.ball.holderId) return state\n        const holder = state.boardState.pieces.find(p => p.id === state.boardState!.ball.holderId)\n        if (!holder) return state\n\n        const { boardState, forcedTurnEnd } = applyPass(state.boardState, to)\n        const keepSelection = !forcedTurnEnd && boardState.ball.holderId\n        return {\n            boardState,\n            selectedPieceId: keepSelection ? boardState.ball.holderId : null,\n            interactionMode: keepSelection ? 'pass' : null,\n        }\n    }),\n\n    endTurn: () => set((state) => {\n        if (!state.boardState) return state\n        return { boardState: applyEndTurn(state.boardState) }\n    }),\n}))\n"]}

package/dist/{chunk-N24LGLLO.js → chunk-C5HCN7O5.js}

@@ -3,19 +3,31 @@ import { applyEndTurn, applyPass, applyMove } from '@scriptonita/chess-football-
 export { getInitialBoardState } from '@scriptonita/chess-football-engine';
 
 // src/store/use-game-store.ts
-var useGameStore = create((set) => ({
+var DEFAULT_MAX_AP = 5;
+var INITIAL = {
   boardState: null,
   selectedPieceId: null,
-  interactionMode: null,
+  interactionMode: null
+};
+var useGameStore = create((set) => ({
+  ...INITIAL,
   setBoardState: (state) => set({ boardState: state }),
   setSelectedPieceId: (id) => set({ selectedPieceId: id }),
   setInteractionMode: (mode) => set({ interactionMode: mode }),
+  /**
+   * The store is a module-global singleton, so a new match opens on the
+   * previous match's final board — which ended on a goal, and was therefore
+   * re-detected as a fresh goal (the bug behind webapp PR #42). Apps were
+   * each reaching for `useGameStore.setState({...})` by hand to work around
+   * it; this makes the intent explicit and keeps the shape in one place.
+   */
+  reset: () => set({ ...INITIAL }),
   resetTurn: () => set((state) => {
     if (!state.boardState) return state;
     return {
       boardState: {
         ...state.boardState,
-        actionPoints: state.boardState.maxActionPoints ?? 5,
+        actionPoints: state.boardState.maxActionPoints ?? DEFAULT_MAX_AP,
         pieces: state.boardState.pieces.map((p) => ({ ...p, hasMovedThisTurn: false }))
       }
     };
@@ -45,6 +57,6 @@ var useGameStore = create((set) => ({
   })
 }));
 
-export { useGameStore };
-//# sourceMappingURL=chunk-N24LGLLO.js.map
-//# sourceMappingURL=chunk-N24LGLLO.js.map
+export { DEFAULT_MAX_AP, useGameStore };
+//# sourceMappingURL=chunk-C5HCN7O5.js.map
+//# sourceMappingURL=chunk-C5HCN7O5.js.map

package/dist/chunk-C5HCN7O5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/store/use-game-store.ts"],"names":[],"mappings":"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","file":"chunk-C5HCN7O5.js","sourcesContent":["import { create } from 'zustand'\nimport type { BoardState, Position } from '@scriptonita/chess-football-engine'\nimport { applyMove, applyPass, applyEndTurn } from '@scriptonita/chess-football-engine'\n\n// The canonical kickoff position lives in the engine (rules-adjacent). Re-exported\n// here so app imports from `@scriptonita/chess-football-ui/store` keep working.\nexport { getInitialBoardState } from '@scriptonita/chess-football-engine'\n\n/**\n * Fallback when a board predates configurable action points. `maxActionPoints`\n * is optional on `BoardState`, and every consumer was inventing its own `?? 5`\n * — except `TurnBanner`, which had none and rendered \"3/\" on an old match.\n */\nexport const DEFAULT_MAX_AP = 5\n\ninterface GameStore {\n    boardState: BoardState | null\n    selectedPieceId: string | null\n    interactionMode: 'move' | 'pass' | null\n    setBoardState: (state: BoardState) => void\n    setSelectedPieceId: (id: string | null) => void\n    setInteractionMode: (mode: 'move' | 'pass' | null) => void\n    resetTurn: () => void\n    /** Return the store to its initial state. */\n    reset: () => void\n    movePiece: (pieceId: string, to: Position) => void\n    passBall: (to: Position) => void\n    endTurn: () => void\n}\n\nconst INITIAL = {\n    boardState: null,\n    selectedPieceId: null,\n    interactionMode: null,\n} satisfies Pick<GameStore, 'boardState' | 'selectedPieceId' | 'interactionMode'>\n\nexport const useGameStore = create<GameStore>((set) => ({\n    ...INITIAL,\n\n    setBoardState: (state) => set({ boardState: state }),\n    setSelectedPieceId: (id) => set({ selectedPieceId: id }),\n    setInteractionMode: (mode) => set({ interactionMode: mode }),\n\n    /**\n     * The store is a module-global singleton, so a new match opens on the\n     * previous match's final board — which ended on a goal, and was therefore\n     * re-detected as a fresh goal (the bug behind webapp PR #42). Apps were\n     * each reaching for `useGameStore.setState({...})` by hand to work around\n     * it; this makes the intent explicit and keeps the shape in one place.\n     */\n    reset: () => set({ ...INITIAL }),\n\n    resetTurn: () => set((state) => {\n        if (!state.boardState) return state\n        return {\n            boardState: {\n                ...state.boardState,\n                actionPoints: state.boardState.maxActionPoints ?? DEFAULT_MAX_AP,\n                pieces: state.boardState.pieces.map(p => ({ ...p, hasMovedThisTurn: false })),\n            },\n        }\n    }),\n\n    movePiece: (pieceId, to) => set((state) => {\n        if (!state.boardState || state.boardState.actionPoints <= 0) return state\n        const piece = state.boardState.pieces.find(p => p.id === pieceId)\n        if (!piece || piece.hasMovedThisTurn) return state\n\n        const { boardState } = applyMove(state.boardState, pieceId, to)\n        return { boardState, selectedPieceId: null, interactionMode: null }\n    }),\n\n    passBall: (to) => set((state) => {\n        if (!state.boardState || state.boardState.actionPoints <= 0 || !state.boardState.ball.holderId) return state\n        const holder = state.boardState.pieces.find(p => p.id === state.boardState!.ball.holderId)\n        if (!holder) return state\n\n        const { boardState, forcedTurnEnd } = applyPass(state.boardState, to)\n        const keepSelection = !forcedTurnEnd && boardState.ball.holderId\n        return {\n            boardState,\n            selectedPieceId: keepSelection ? boardState.ball.holderId : null,\n            interactionMode: keepSelection ? 'pass' : null,\n        }\n    }),\n\n    endTurn: () => set((state) => {\n        if (!state.boardState) return state\n        return { boardState: applyEndTurn(state.boardState) }\n    }),\n}))\n"]}