@scriptonita/chess-football-ui 0.3.0 → 0.4.1

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { Side, Piece } from '@scriptonita/chess-football-engine';
+import { Side, Piece, PieceShortKey, PieceLongKey } from '@scriptonita/chess-football-engine';
 import { ClassValue } from 'clsx';
 
 interface GameBoardProps {
@@ -78,7 +78,7 @@ declare function StaticGameBoard(): react.JSX.Element;
 
 interface TurnBannerProps {
     isMyTurn: boolean;
-    /** Override for the "not my turn" label (e.g. "IA pensando…" in training mode). */
+    /** Override for the "not my turn" label (e.g. "Bot pensando…" in training mode). */
     waitingLabel?: string;
     className?: string;
 }
@@ -87,7 +87,7 @@ interface TurnBannerProps {
  * - My turn:  accent-green background + "TU TURNO" + AP counter
  * - Opponent: neutral background + waiting label
  *
- * Absorbs the floating "IA pensando…" toast in training mode when waitingLabel is set.
+ * Absorbs the floating "Bot pensando…" toast in training mode when waitingLabel is set.
  */
 declare function TurnBanner({ isMyTurn, waitingLabel, className }: TurnBannerProps): react.JSX.Element | null;
 
@@ -147,12 +147,33 @@ interface ConfirmDialogProps {
 declare function ConfirmDialog({ open, title, description, confirmLabel, cancelLabel, onConfirm, onCancel }: ConfirmDialogProps): react.JSX.Element | null;
 
 /**
- * A translator scoped to the `game` namespace: `t('turn')`, `t('whiteToMove')`, …
+ * A translator scoped to the `game` namespace: `t('yourTurn')`, `t('move')`, …
  * Each host app supplies one bound to its own i18n library:
  *   - Next.js (next-intl):   const t = useTranslations('game')
  *   - Vite (react-i18next):  (key) => t(`game.${key}`)
  */
 type GameTranslator = (key: string, values?: Record<string, unknown>) => string;
+/**
+ * Static leaf keys the package's components read via `useGameT` with a literal `t('…')` call.
+ * Keep in sync with those call sites — recipe:
+ *   grep -rhoE "t\('[a-zA-Z0-9_.]+'" src/components | sed -E "s/t\('//;s/'//" | sort -u
+ * (the dynamic `pieces.*` / `eventToast.*` families are derived separately below).
+ */
+declare const STATIC_I18N_KEYS: readonly ["actionPointsAriaLabel", "actionPointsShort", "endTurn", "endTurnConfirm", "endTurnConfirmDescription", "endTurnConfirmYes", "endTurnKeepPlaying", "history.empty", "history.goal", "history.interception", "history.move", "history.offside", "history.pass", "history.tackle", "history.title", "history.turn", "history.viewAll", "move", "offsideWarning", "pass", "selectedPiece.alreadyMoved", "selectedPiece.atSquare", "selectedPiece.empty", "selectedPiece.hasBall", "teamBlack", "teamWhite", "waitingRival", "yourTurn"];
+/** `pieces.*` — one key per short and long piece label the engine exposes (move-history, selected-piece-detail). */
+type PieceI18nKey = `pieces.${PieceShortKey | PieceLongKey}`;
+/** `eventToast.*` — one key per toastable event (see `ToastEvent` in `event-toast.tsx`). */
+type EventToastI18nKey = `eventToast.${'interception' | 'offside' | 'tackle'}`;
+/** Union of every `game`-namespace key the package reads. */
+type GameI18nKey = (typeof STATIC_I18N_KEYS)[number] | PieceI18nKey | EventToastI18nKey;
+/**
+ * Manifest of every `game`-namespace key the package's components read via `useGameT`.
+ * Host apps use it to assert their translation catalogs cover the package (AD-4).
+ * The `pieces.*` family is derived from the engine's `SHORT_KEY`/`LONG_KEY` so it can't
+ * drift when a piece is added; static keys and `eventToast.*` are listed above.
+ * No key names an automated-opponent brand — the roster owns opponent identity.
+ */
+declare const GAME_I18N_KEYS: readonly GameI18nKey[];
 declare function GameI18nProvider({ t, children }: {
     t: GameTranslator;
     children: ReactNode;
@@ -162,4 +183,4 @@ declare function useGameT(): GameTranslator;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, type ButtonProps, ConfirmDialog, EventToast, Football, GameBoard, GameControls, GameI18nProvider, GamePiece, type GameTranslator, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };
+export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, type ButtonProps, ConfirmDialog, EventToast, Football, GAME_I18N_KEYS, GameBoard, GameControls, type GameI18nKey, GameI18nProvider, GamePiece, type GameTranslator, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { Side, Piece } from '@scriptonita/chess-football-engine';
+import { Side, Piece, PieceShortKey, PieceLongKey } from '@scriptonita/chess-football-engine';
 import { ClassValue } from 'clsx';
 
 interface GameBoardProps {
@@ -78,7 +78,7 @@ declare function StaticGameBoard(): react.JSX.Element;
 
 interface TurnBannerProps {
     isMyTurn: boolean;
-    /** Override for the "not my turn" label (e.g. "IA pensando…" in training mode). */
+    /** Override for the "not my turn" label (e.g. "Bot pensando…" in training mode). */
     waitingLabel?: string;
     className?: string;
 }
@@ -87,7 +87,7 @@ interface TurnBannerProps {
  * - My turn:  accent-green background + "TU TURNO" + AP counter
  * - Opponent: neutral background + waiting label
  *
- * Absorbs the floating "IA pensando…" toast in training mode when waitingLabel is set.
+ * Absorbs the floating "Bot pensando…" toast in training mode when waitingLabel is set.
  */
 declare function TurnBanner({ isMyTurn, waitingLabel, className }: TurnBannerProps): react.JSX.Element | null;
 
@@ -147,12 +147,33 @@ interface ConfirmDialogProps {
 declare function ConfirmDialog({ open, title, description, confirmLabel, cancelLabel, onConfirm, onCancel }: ConfirmDialogProps): react.JSX.Element | null;
 
 /**
- * A translator scoped to the `game` namespace: `t('turn')`, `t('whiteToMove')`, …
+ * A translator scoped to the `game` namespace: `t('yourTurn')`, `t('move')`, …
  * Each host app supplies one bound to its own i18n library:
  *   - Next.js (next-intl):   const t = useTranslations('game')
  *   - Vite (react-i18next):  (key) => t(`game.${key}`)
  */
 type GameTranslator = (key: string, values?: Record<string, unknown>) => string;
+/**
+ * Static leaf keys the package's components read via `useGameT` with a literal `t('…')` call.
+ * Keep in sync with those call sites — recipe:
+ *   grep -rhoE "t\('[a-zA-Z0-9_.]+'" src/components | sed -E "s/t\('//;s/'//" | sort -u
+ * (the dynamic `pieces.*` / `eventToast.*` families are derived separately below).
+ */
+declare const STATIC_I18N_KEYS: readonly ["actionPointsAriaLabel", "actionPointsShort", "endTurn", "endTurnConfirm", "endTurnConfirmDescription", "endTurnConfirmYes", "endTurnKeepPlaying", "history.empty", "history.goal", "history.interception", "history.move", "history.offside", "history.pass", "history.tackle", "history.title", "history.turn", "history.viewAll", "move", "offsideWarning", "pass", "selectedPiece.alreadyMoved", "selectedPiece.atSquare", "selectedPiece.empty", "selectedPiece.hasBall", "teamBlack", "teamWhite", "waitingRival", "yourTurn"];
+/** `pieces.*` — one key per short and long piece label the engine exposes (move-history, selected-piece-detail). */
+type PieceI18nKey = `pieces.${PieceShortKey | PieceLongKey}`;
+/** `eventToast.*` — one key per toastable event (see `ToastEvent` in `event-toast.tsx`). */
+type EventToastI18nKey = `eventToast.${'interception' | 'offside' | 'tackle'}`;
+/** Union of every `game`-namespace key the package reads. */
+type GameI18nKey = (typeof STATIC_I18N_KEYS)[number] | PieceI18nKey | EventToastI18nKey;
+/**
+ * Manifest of every `game`-namespace key the package's components read via `useGameT`.
+ * Host apps use it to assert their translation catalogs cover the package (AD-4).
+ * The `pieces.*` family is derived from the engine's `SHORT_KEY`/`LONG_KEY` so it can't
+ * drift when a piece is added; static keys and `eventToast.*` are listed above.
+ * No key names an automated-opponent brand — the roster owns opponent identity.
+ */
+declare const GAME_I18N_KEYS: readonly GameI18nKey[];
 declare function GameI18nProvider({ t, children }: {
     t: GameTranslator;
     children: ReactNode;
@@ -162,4 +183,4 @@ declare function useGameT(): GameTranslator;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, type ButtonProps, ConfirmDialog, EventToast, Football, GameBoard, GameControls, GameI18nProvider, GamePiece, type GameTranslator, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };
+export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, type ButtonProps, ConfirmDialog, EventToast, Football, GAME_I18N_KEYS, GameBoard, GameControls, type GameI18nKey, GameI18nProvider, GamePiece, type GameTranslator, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };

package/dist/index.js

@@ -1,5 +1,5 @@
 import { useGameStore, getInitialBoardState } from './chunk-N24LGLLO.js';
-import { getValidMoves, getValidPasses, isInEnemyArea, RANK_LABELS, FILE_LABELS, LONG_KEY, squareName, SHORT_KEY } from '@scriptonita/chess-football-engine';
+import { SHORT_KEY, LONG_KEY, getValidMoves, getValidPasses, isInEnemyArea, RANK_LABELS, FILE_LABELS, squareName } from '@scriptonita/chess-football-engine';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { MotionConfig, AnimatePresence, motion } from 'framer-motion';
@@ -125,6 +125,49 @@ var Football = ({ className }) => {
     }
   );
 };
+var STATIC_I18N_KEYS = [
+  "actionPointsAriaLabel",
+  "actionPointsShort",
+  "endTurn",
+  "endTurnConfirm",
+  "endTurnConfirmDescription",
+  "endTurnConfirmYes",
+  "endTurnKeepPlaying",
+  "history.empty",
+  "history.goal",
+  "history.interception",
+  "history.move",
+  "history.offside",
+  "history.pass",
+  "history.tackle",
+  "history.title",
+  "history.turn",
+  "history.viewAll",
+  "move",
+  "offsideWarning",
+  "pass",
+  "selectedPiece.alreadyMoved",
+  "selectedPiece.atSquare",
+  "selectedPiece.empty",
+  "selectedPiece.hasBall",
+  "teamBlack",
+  "teamWhite",
+  "waitingRival",
+  "yourTurn"
+];
+var PIECE_I18N_KEYS = [...Object.values(SHORT_KEY), ...Object.values(LONG_KEY)].map(
+  (label) => `pieces.${label}`
+);
+var EVENT_TOAST_I18N_KEYS = [
+  "eventToast.interception",
+  "eventToast.offside",
+  "eventToast.tackle"
+];
+var GAME_I18N_KEYS = [
+  ...STATIC_I18N_KEYS,
+  ...PIECE_I18N_KEYS,
+  ...EVENT_TOAST_I18N_KEYS
+];
 var fallback = (key) => key;
 var GameI18nContext = createContext(fallback);
 function GameI18nProvider({ t, children }) {
@@ -335,7 +378,14 @@ function GameBoard({ userSide, showCoordinates = false, keyboardNav = true }) {
                 isDisambiguateTarget && selectedPieceId && /* @__PURE__ */ jsxs(
                   "div",
                   {
-                    className: "absolute z-50 bottom-full mb-1 left-1/2 -translate-x-1/2 flex gap-1 bg-bg-secondary border border-border-subtle rounded-md p-1 shadow-xl pointer-events-auto whitespace-nowrap",
+                    className: cn(
+                      "absolute z-50 flex gap-1 bg-bg-secondary border border-border-subtle rounded-md p-1 shadow-xl pointer-events-auto whitespace-nowrap",
+                      // The board container is `overflow-hidden` (for its rounded
+                      // corners), so a popover that spills past an edge gets clipped.
+                      // Anchor it inside the board on edge columns / the top row.
+                      y === ROWS - 1 ? "top-full mt-1" : "bottom-full mb-1",
+                      x === 0 ? "left-0" : x === COLS - 1 ? "right-0" : "left-1/2 -translate-x-1/2"
+                    ),
                     onClick: (e) => e.stopPropagation(),
                     children: [
                       /* @__PURE__ */ jsxs(
@@ -1277,6 +1327,6 @@ function HistoryChip({ lastMove, onClick, className }) {
   );
 }
 
-export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, ConfirmDialog, EventToast, Football, GameBoard, GameControls, GameI18nProvider, GamePiece, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };
+export { ActionPoints, Avatar, AvatarFallback, AvatarImage, Button, ConfirmDialog, EventToast, Football, GAME_I18N_KEYS, GameBoard, GameControls, GameI18nProvider, GamePiece, MiniScoreboard, MobileHistory, MoveHistory, Scoreboard, SelectedPieceDetail, StaticGameBoard, TurnBanner, cn, useGameT };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map