gigaboard 1.4.2 → 1.5.0

package/dist/{board-model-BMtkLQvL.d.cts → board-model-BIVxSCWC.d.cts}

@@ -42,6 +42,42 @@ declare function unpackMove(move: PackedMove | number): {
     to: SquareIndex;
     promo: number;
 };
+/**
+ * The null-move (pass) sentinel — a `u16` word of `0xffff` in the 16-bit
+ * Move2 wire format.
+ *
+ * @remarks
+ * CBH `moves2` streams store a pass turn as an ordinary move word, so the
+ * word itself has to be distinguishable from a real move. `0xffff` is
+ * unambiguous: a packed word only reaches it via `from = to = 63` with
+ * promotion code 15, and Move2 promotion codes are `0..4`. No legal word
+ * collides.
+ *
+ * Spellings: UCI is `"0000"`; PGN/SAN is `"--"` and also accepts `"Z0"`.
+ * See {@link NULL_MOVE_UCI}, {@link NULL_MOVE_SAN}, {@link isNullMoveUci}
+ * and {@link isNullMoveSan}.
+ *
+ * Gigaboard **tolerates** a pass but never originates one: no gesture,
+ * selection, or drag can produce this word. See {@link isNullMove}.
+ */
+declare const NULL_MOVE_WORD: PackedMove;
+/** UCI spelling of a pass. */
+declare const NULL_MOVE_UCI = "0000";
+/** PGN/SAN spelling of a pass. */
+declare const NULL_MOVE_SAN = "--";
+/** Accepted input spellings of a pass: the SAN form plus the legacy `Z0`. */
+declare const NULL_MOVE_SANS: readonly string[];
+/**
+ * `true` when `word` is the null-move (pass) sentinel.
+ *
+ * Callers gate on this **before** unpacking — `unpackMove` reads the
+ * sentinel as `from = to = 63, promo = 15`, which is meaningless.
+ */
+declare function isNullMove(word: PackedMove | number): boolean;
+/** `true` when `text` is the UCI spelling of a pass (`"0000"`). */
+declare function isNullMoveUci(text: string): boolean;
+/** `true` when `text` is an accepted PGN/SAN spelling of a pass (`"--"` or `"Z0"`). */
+declare function isNullMoveSan(text: string): boolean;
 /**
  * 64-bit Zobrist key represented as two 32-bit unsigned integers (zero-BigInt).
  */
@@ -331,8 +367,29 @@ interface EngineAdapter {
      * any square).
      */
     makeMove(from: SquareIndex, to: SquareIndex, promotion?: PieceType): PackedMove | null;
-    /** Undo the most recent move. Returns the undone move, or `null` if none. */
+    /**
+     * Undo the most recent move. Returns the undone move, or `null` if none.
+     *
+     * A pass undoes to {@link NULL_MOVE_WORD}, mirroring what
+     * {@link EngineAdapter.makeNullMove} produced.
+     */
     undo(): PackedMove | null;
+    /**
+     * Play a pass (null move): the position's pieces are untouched, the
+     * side to move flips, the en-passant square clears, and both clocks
+     * advance — a pass completes a **full** move, whoever passed, so the
+     * fullmove number always increments.
+     *
+     * Returns {@link NULL_MOVE_WORD} on success, or `null` when the pass is
+     * refused. A pass is legal **iff** the side to move is not in check: a
+     * pass answers no check, so a checked side cannot pass.
+     *
+     * @remarks
+     * Optional: an adapter that cannot represent a pass simply omits it and
+     * every pass attempt is refused. This is the tolerance path only —
+     * gigaboard never originates a pass from a user gesture.
+     */
+    makeNullMove?(): PackedMove | null;
     /**
      * Legal moves from a single origin square (`from` provided) or all legal
      * moves (`from` omitted). The returned array is fresh on every call; the
@@ -614,6 +671,20 @@ interface BoardModel {
     selectSquare(index: SquareIndex | null): void;
     /** Attempt a move. Returns the packed move on success, `null` on illegal. */
     tryMove(from: SquareIndex, to: SquareIndex, promotion?: PieceType): PackedMove | null;
+    /**
+     * Play a pass (null move) as a **tolerance** path: returns
+     * {@link NULL_MOVE_WORD} on success, or `null` when the adapter has no
+     * pass capability or the pass is illegal (the side to move is in check —
+     * a pass answers no check).
+     *
+     * @remarks
+     * A pass flips the side to move and advances both clocks, but it moves no
+     * piece, so it schedules **no** animation and leaves the board bytes
+     * untouched. No user gesture, selection, or drag routes here — this is
+     * only for feeding an externally supplied pass (e.g. a CBH `moves2`
+     * stream) into the board.
+     */
+    pass(): PackedMove | null;
     /** Undo the most recent move. */
     undo(): PackedMove | null;
     /** Redo the most recently undone move. */
@@ -700,4 +771,4 @@ interface BoardModel {
  */
 declare function createBoardModel(engine: EngineAdapter, options?: BoardModelOptions): BoardModel;
 
-export { createBoardStore as $, type AnimDescriptor as A, BOARD_CELL_BB as B, type CancelEvent as C, Color as D, type EngineAdapter as E, type DragController as F, type DragControllerOptions as G, type DragEvent as H, type DragMoveEvent as I, type DragStartEvent as J, type DragState as K, type DropEvent as L, type LegalMoveEntry as M, type LegalMoveIndex as N, type LegalMoveIndexOptions as O, type PackedMove as P, MOVE2_PROMO_BISHOP as Q, MOVE2_PROMO_KNIGHT as R, type SquareIndex as S, MOVE2_PROMO_NONE as T, MOVE2_PROMO_QUEEN as U, MOVE2_PROMO_ROOK as V, type PositionHash as W, type SyncPositionOptions as X, type Unsubscribe as Y, type ZobristKey as Z, createBoardModel as _, PieceType as a, createDragController as a0, createLegalMoveIndex as a1, encodeBoardCell as a2, isEmptyCell as a3, isSquareIndex as a4, packMove as a5, toSquareIndex as a6, unpackMove as a7, writeBoardCell as a8, type Arrow as b, colorOf as c, type Premove as d, type ArrowCustomSvg as e, type ArrowHeadStyle as f, type ArrowLabel as g, BOARD_CELL_BK as h, BOARD_CELL_BN as i, BOARD_CELL_BP as j, BOARD_CELL_BQ as k, BOARD_CELL_BR as l, BOARD_CELL_EMPTY as m, BOARD_CELL_WB as n, BOARD_CELL_WK as o, pieceTypeOf as p, BOARD_CELL_WN as q, BOARD_CELL_WP as r, BOARD_CELL_WQ as s, BOARD_CELL_WR as t, type BoardCell as u, type BoardModel as v, type BoardModelOptions as w, type BoardSnapshot as x, type BoardStore as y, type ClickEvent as z };
+export { type SyncPositionOptions as $, type AnimDescriptor as A, BOARD_CELL_BB as B, type CancelEvent as C, Color as D, type EngineAdapter as E, type DragController as F, type DragControllerOptions as G, type DragEvent as H, type DragMoveEvent as I, type DragStartEvent as J, type DragState as K, type DropEvent as L, type LegalMoveEntry as M, type LegalMoveIndex as N, type LegalMoveIndexOptions as O, type PackedMove as P, MOVE2_PROMO_BISHOP as Q, MOVE2_PROMO_KNIGHT as R, type SquareIndex as S, MOVE2_PROMO_NONE as T, MOVE2_PROMO_QUEEN as U, MOVE2_PROMO_ROOK as V, NULL_MOVE_SAN as W, NULL_MOVE_SANS as X, NULL_MOVE_UCI as Y, NULL_MOVE_WORD as Z, type PositionHash as _, PieceType as a, type Unsubscribe as a0, type ZobristKey as a1, createBoardModel as a2, createBoardStore as a3, createDragController as a4, createLegalMoveIndex as a5, encodeBoardCell as a6, isEmptyCell as a7, isNullMove as a8, isNullMoveSan as a9, isNullMoveUci as aa, isSquareIndex as ab, packMove as ac, toSquareIndex as ad, unpackMove as ae, writeBoardCell as af, type Arrow as b, colorOf as c, type Premove as d, type ArrowCustomSvg as e, type ArrowHeadStyle as f, type ArrowLabel as g, BOARD_CELL_BK as h, BOARD_CELL_BN as i, BOARD_CELL_BP as j, BOARD_CELL_BQ as k, BOARD_CELL_BR as l, BOARD_CELL_EMPTY as m, BOARD_CELL_WB as n, BOARD_CELL_WK as o, pieceTypeOf as p, BOARD_CELL_WN as q, BOARD_CELL_WP as r, BOARD_CELL_WQ as s, BOARD_CELL_WR as t, type BoardCell as u, type BoardModel as v, type BoardModelOptions as w, type BoardSnapshot as x, type BoardStore as y, type ClickEvent as z };

package/dist/{board-model-BMtkLQvL.d.ts → board-model-BIVxSCWC.d.ts}

@@ -42,6 +42,42 @@ declare function unpackMove(move: PackedMove | number): {
     to: SquareIndex;
     promo: number;
 };
+/**
+ * The null-move (pass) sentinel — a `u16` word of `0xffff` in the 16-bit
+ * Move2 wire format.
+ *
+ * @remarks
+ * CBH `moves2` streams store a pass turn as an ordinary move word, so the
+ * word itself has to be distinguishable from a real move. `0xffff` is
+ * unambiguous: a packed word only reaches it via `from = to = 63` with
+ * promotion code 15, and Move2 promotion codes are `0..4`. No legal word
+ * collides.
+ *
+ * Spellings: UCI is `"0000"`; PGN/SAN is `"--"` and also accepts `"Z0"`.
+ * See {@link NULL_MOVE_UCI}, {@link NULL_MOVE_SAN}, {@link isNullMoveUci}
+ * and {@link isNullMoveSan}.
+ *
+ * Gigaboard **tolerates** a pass but never originates one: no gesture,
+ * selection, or drag can produce this word. See {@link isNullMove}.
+ */
+declare const NULL_MOVE_WORD: PackedMove;
+/** UCI spelling of a pass. */
+declare const NULL_MOVE_UCI = "0000";
+/** PGN/SAN spelling of a pass. */
+declare const NULL_MOVE_SAN = "--";
+/** Accepted input spellings of a pass: the SAN form plus the legacy `Z0`. */
+declare const NULL_MOVE_SANS: readonly string[];
+/**
+ * `true` when `word` is the null-move (pass) sentinel.
+ *
+ * Callers gate on this **before** unpacking — `unpackMove` reads the
+ * sentinel as `from = to = 63, promo = 15`, which is meaningless.
+ */
+declare function isNullMove(word: PackedMove | number): boolean;
+/** `true` when `text` is the UCI spelling of a pass (`"0000"`). */
+declare function isNullMoveUci(text: string): boolean;
+/** `true` when `text` is an accepted PGN/SAN spelling of a pass (`"--"` or `"Z0"`). */
+declare function isNullMoveSan(text: string): boolean;
 /**
  * 64-bit Zobrist key represented as two 32-bit unsigned integers (zero-BigInt).
  */
@@ -331,8 +367,29 @@ interface EngineAdapter {
      * any square).
      */
     makeMove(from: SquareIndex, to: SquareIndex, promotion?: PieceType): PackedMove | null;
-    /** Undo the most recent move. Returns the undone move, or `null` if none. */
+    /**
+     * Undo the most recent move. Returns the undone move, or `null` if none.
+     *
+     * A pass undoes to {@link NULL_MOVE_WORD}, mirroring what
+     * {@link EngineAdapter.makeNullMove} produced.
+     */
     undo(): PackedMove | null;
+    /**
+     * Play a pass (null move): the position's pieces are untouched, the
+     * side to move flips, the en-passant square clears, and both clocks
+     * advance — a pass completes a **full** move, whoever passed, so the
+     * fullmove number always increments.
+     *
+     * Returns {@link NULL_MOVE_WORD} on success, or `null` when the pass is
+     * refused. A pass is legal **iff** the side to move is not in check: a
+     * pass answers no check, so a checked side cannot pass.
+     *
+     * @remarks
+     * Optional: an adapter that cannot represent a pass simply omits it and
+     * every pass attempt is refused. This is the tolerance path only —
+     * gigaboard never originates a pass from a user gesture.
+     */
+    makeNullMove?(): PackedMove | null;
     /**
      * Legal moves from a single origin square (`from` provided) or all legal
      * moves (`from` omitted). The returned array is fresh on every call; the
@@ -614,6 +671,20 @@ interface BoardModel {
     selectSquare(index: SquareIndex | null): void;
     /** Attempt a move. Returns the packed move on success, `null` on illegal. */
     tryMove(from: SquareIndex, to: SquareIndex, promotion?: PieceType): PackedMove | null;
+    /**
+     * Play a pass (null move) as a **tolerance** path: returns
+     * {@link NULL_MOVE_WORD} on success, or `null` when the adapter has no
+     * pass capability or the pass is illegal (the side to move is in check —
+     * a pass answers no check).
+     *
+     * @remarks
+     * A pass flips the side to move and advances both clocks, but it moves no
+     * piece, so it schedules **no** animation and leaves the board bytes
+     * untouched. No user gesture, selection, or drag routes here — this is
+     * only for feeding an externally supplied pass (e.g. a CBH `moves2`
+     * stream) into the board.
+     */
+    pass(): PackedMove | null;
     /** Undo the most recent move. */
     undo(): PackedMove | null;
     /** Redo the most recently undone move. */
@@ -700,4 +771,4 @@ interface BoardModel {
  */
 declare function createBoardModel(engine: EngineAdapter, options?: BoardModelOptions): BoardModel;
 
-export { createBoardStore as $, type AnimDescriptor as A, BOARD_CELL_BB as B, type CancelEvent as C, Color as D, type EngineAdapter as E, type DragController as F, type DragControllerOptions as G, type DragEvent as H, type DragMoveEvent as I, type DragStartEvent as J, type DragState as K, type DropEvent as L, type LegalMoveEntry as M, type LegalMoveIndex as N, type LegalMoveIndexOptions as O, type PackedMove as P, MOVE2_PROMO_BISHOP as Q, MOVE2_PROMO_KNIGHT as R, type SquareIndex as S, MOVE2_PROMO_NONE as T, MOVE2_PROMO_QUEEN as U, MOVE2_PROMO_ROOK as V, type PositionHash as W, type SyncPositionOptions as X, type Unsubscribe as Y, type ZobristKey as Z, createBoardModel as _, PieceType as a, createDragController as a0, createLegalMoveIndex as a1, encodeBoardCell as a2, isEmptyCell as a3, isSquareIndex as a4, packMove as a5, toSquareIndex as a6, unpackMove as a7, writeBoardCell as a8, type Arrow as b, colorOf as c, type Premove as d, type ArrowCustomSvg as e, type ArrowHeadStyle as f, type ArrowLabel as g, BOARD_CELL_BK as h, BOARD_CELL_BN as i, BOARD_CELL_BP as j, BOARD_CELL_BQ as k, BOARD_CELL_BR as l, BOARD_CELL_EMPTY as m, BOARD_CELL_WB as n, BOARD_CELL_WK as o, pieceTypeOf as p, BOARD_CELL_WN as q, BOARD_CELL_WP as r, BOARD_CELL_WQ as s, BOARD_CELL_WR as t, type BoardCell as u, type BoardModel as v, type BoardModelOptions as w, type BoardSnapshot as x, type BoardStore as y, type ClickEvent as z };
+export { type SyncPositionOptions as $, type AnimDescriptor as A, BOARD_CELL_BB as B, type CancelEvent as C, Color as D, type EngineAdapter as E, type DragController as F, type DragControllerOptions as G, type DragEvent as H, type DragMoveEvent as I, type DragStartEvent as J, type DragState as K, type DropEvent as L, type LegalMoveEntry as M, type LegalMoveIndex as N, type LegalMoveIndexOptions as O, type PackedMove as P, MOVE2_PROMO_BISHOP as Q, MOVE2_PROMO_KNIGHT as R, type SquareIndex as S, MOVE2_PROMO_NONE as T, MOVE2_PROMO_QUEEN as U, MOVE2_PROMO_ROOK as V, NULL_MOVE_SAN as W, NULL_MOVE_SANS as X, NULL_MOVE_UCI as Y, NULL_MOVE_WORD as Z, type PositionHash as _, PieceType as a, type Unsubscribe as a0, type ZobristKey as a1, createBoardModel as a2, createBoardStore as a3, createDragController as a4, createLegalMoveIndex as a5, encodeBoardCell as a6, isEmptyCell as a7, isNullMove as a8, isNullMoveSan as a9, isNullMoveUci as aa, isSquareIndex as ab, packMove as ac, toSquareIndex as ad, unpackMove as ae, writeBoardCell as af, type Arrow as b, colorOf as c, type Premove as d, type ArrowCustomSvg as e, type ArrowHeadStyle as f, type ArrowLabel as g, BOARD_CELL_BK as h, BOARD_CELL_BN as i, BOARD_CELL_BP as j, BOARD_CELL_BQ as k, BOARD_CELL_BR as l, BOARD_CELL_EMPTY as m, BOARD_CELL_WB as n, BOARD_CELL_WK as o, pieceTypeOf as p, BOARD_CELL_WN as q, BOARD_CELL_WP as r, BOARD_CELL_WQ as s, BOARD_CELL_WR as t, type BoardCell as u, type BoardModel as v, type BoardModelOptions as w, type BoardSnapshot as x, type BoardStore as y, type ClickEvent as z };

package/dist/{chunk-EJUGH25P.js → chunk-53XWDREK.js}

@@ -102,10 +102,11 @@ function parseFenPlacement(fen) {
   }
   return board;
 }
+var STARTING_FEN = "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1";
 
 // src/pieces/default-pieces.tsx
 var defaultPieces = neo;
 
-export { CSS_VARS, DEFAULT_ILLEGAL_FLASH_TINT, DEFAULT_PREMOVE_TINT, defaultArrowColors, defaultPieces, defaultTheme, parseFenPlacement };
-//# sourceMappingURL=chunk-EJUGH25P.js.map
-//# sourceMappingURL=chunk-EJUGH25P.js.map
+export { CSS_VARS, DEFAULT_ILLEGAL_FLASH_TINT, DEFAULT_PREMOVE_TINT, STARTING_FEN, defaultArrowColors, defaultPieces, defaultTheme, parseFenPlacement };
+//# sourceMappingURL=chunk-53XWDREK.js.map
+//# sourceMappingURL=chunk-53XWDREK.js.map

package/dist/chunk-53XWDREK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/default-theme.ts","../src/fen.ts","../src/pieces/default-pieces.tsx"],"names":[],"mappings":"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","file":"chunk-53XWDREK.js","sourcesContent":["import { green } from \"./themes/green.js\";\nimport type { Theme } from \"./types.js\";\n\n/** Keys every Gigaboard board understands. */\nexport const CSS_VARS = {\n  SQ_LIGHT: \"--gb-sq-light\",\n  SQ_DARK: \"--gb-sq-dark\",\n  SQ_LIGHT_IMAGE: \"--gb-sq-light-image\",\n  SQ_DARK_IMAGE: \"--gb-sq-dark-image\",\n  SQ_IMAGE_SIZE: \"--gb-sq-image-size\",\n  SQ_BLEND_MODE: \"--gb-sq-blend-mode\",\n  PIECE_FILTER_WHITE: \"--gb-piece-filter-white\",\n  PIECE_FILTER_BLACK: \"--gb-piece-filter-black\",\n  LAST_MOVE: \"--gb-last-move\",\n  SELECTED: \"--gb-selected\",\n  LEGAL_TARGET: \"--gb-legal-target\",\n  LEGAL_TARGET_CAPTURE: \"--gb-legal-target-capture\",\n  CHECK: \"--gb-check\",\n  COORDINATE_LIGHT: \"--gb-coord-light\",\n  COORDINATE_DARK: \"--gb-coord-dark\",\n  /**\n   * Opacity of the piece left behind at the drag origin while the ghost\n   * is in flight. Default `0.35` (lichess parity). Themes may override\n   * to `0` for a chess.com-style \"piece vanishes\" effect.\n   */\n  DRAG_GHOST_OPACITY: \"--gb-drag-ghost-opacity\",\n} as const;\n\nexport const defaultTheme: Theme = Object.freeze({\n  ...green,\n  [CSS_VARS.DRAG_GHOST_OPACITY]: \"0.35\",\n});\n\n/**\n * Default arrow-channel colours. Close to lichess's palette so arrows feel\n * familiar to players migrating over.\n */\nexport const defaultArrowColors = Object.freeze({\n  default: \"rgba(21, 120, 27, 0.8)\",\n  shift: \"rgba(153, 40, 40, 0.8)\",\n  alt: \"rgba(230, 160, 0, 0.8)\",\n  ctrl: \"rgba(0, 60, 130, 0.8)\",\n});\n\n/** Distinct blue tint used to preview pending premoves. */\nexport const DEFAULT_PREMOVE_TINT = \"rgba(30, 98, 255, 0.4)\";\n\n/** Red tint used to announce rejected moves. */\nexport const DEFAULT_ILLEGAL_FLASH_TINT = \"rgba(220, 40, 40, 0.55)\";\n","/**\n * FEN placement parsing — the one slice of FEN that both the server\n * `<StaticChessboard/>` and the client fallback-render path need.\n *\n * The parser is intentionally narrow: it only consumes the first\n * whitespace-delimited field of a FEN (piece placement) and returns a\n * 64-byte `Uint8Array` using our {@link BoardCell} encoding. Side-to-move,\n * castling, en-passant and the move clocks are the engine's business and\n * don't affect how the board is drawn.\n *\n * Kept in its own module so that:\n *\n * 1. `server.tsx` can import it without pulling a `\"use client\"` module.\n * 2. The client `<Chessboard/>`'s fallback path (`fallbackFen`) can reuse\n *    the exact same parser — one source of truth for FEN shape.\n *\n * Throws on malformed input so misconfiguration fails at render time\n * rather than silently producing a blank board.\n */\n\nimport type { BoardCell } from \"./core/index.js\";\n\n/** FEN piece letter → our 1..12 `BoardCell` code, or 0 for unknown. */\nfunction pieceCellFromFenChar(ch: string): BoardCell {\n  switch (ch) {\n    case \"P\":\n      return 1 as BoardCell;\n    case \"N\":\n      return 2 as BoardCell;\n    case \"B\":\n      return 3 as BoardCell;\n    case \"R\":\n      return 4 as BoardCell;\n    case \"Q\":\n      return 5 as BoardCell;\n    case \"K\":\n      return 6 as BoardCell;\n    case \"p\":\n      return 7 as BoardCell;\n    case \"n\":\n      return 8 as BoardCell;\n    case \"b\":\n      return 9 as BoardCell;\n    case \"r\":\n      return 10 as BoardCell;\n    case \"q\":\n      return 11 as BoardCell;\n    case \"k\":\n      return 12 as BoardCell;\n    default:\n      return 0 as BoardCell;\n  }\n}\n\n/**\n * Parse the piece-placement field of a FEN into a 64-byte `Uint8Array`\n * in LERF order (index 0 = a1, index 63 = h8).\n *\n * Only the first whitespace-delimited token is read; anything after it\n * is ignored. That means both a full FEN (`\"rnbq... w KQkq - 0 1\"`) and\n * a bare placement (`\"rnbq...\"`) are accepted.\n */\nexport function parseFenPlacement(fen: string): Uint8Array {\n  const placement = fen.trim().split(/\\s+/)[0];\n  if (placement === undefined) {\n    throw new Error(\"FEN is empty\");\n  }\n  const ranks = placement.split(\"/\");\n  if (ranks.length !== 8) {\n    throw new Error(`FEN must have 8 ranks, got ${ranks.length}`);\n  }\n  const board = new Uint8Array(64);\n  for (let r = 0; r < 8; r++) {\n    // FEN lists ranks 8→1; our LERF layout has rank 7 at top, 0 at bottom.\n    const rank = 7 - r;\n    const row = ranks[r];\n    if (row === undefined) throw new Error(`FEN rank ${rank + 1} missing`);\n    let file = 0;\n    for (const ch of row) {\n      if (file > 7) throw new Error(`FEN rank ${rank + 1} has too many files`);\n      const skip = Number.parseInt(ch, 10);\n      if (!Number.isNaN(skip)) {\n        file += skip;\n        continue;\n      }\n      const cell = pieceCellFromFenChar(ch);\n      if (cell === 0) throw new Error(`FEN contains unknown piece: ${ch}`);\n      board[rank * 8 + file] = cell;\n      file++;\n    }\n    if (file !== 8) {\n      throw new Error(`FEN rank ${rank + 1} ended at file ${file}, expected 8`);\n    }\n  }\n  return board;\n}\n\n/** Standard starting position FEN, re-exported for convenience. */\nexport const STARTING_FEN = \"rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1\";\n","import type { PieceRenderer } from \"../types.js\";\nimport { neo } from \"./sets/neo.js\";\n\nexport const defaultPieces: PieceRenderer = neo;\n"]}

package/dist/{chunk-SO6AOEFF.js → chunk-6F3FZAG7.js}

@@ -1,4 +1,4 @@
-import { ensureMagicTablesLoaded, ensureZobristLoaded, makeSan } from 'gigachess';
+import { ensureMagicTablesLoaded, ensureZobristLoaded, isEmpty, kingAttackers, opposite, makeSan } from 'gigachess';
 import { Chess } from 'gigachess/chessjs';
 
 // src/core/adapters/gigachess.ts
@@ -20,6 +20,19 @@ function unpackMove(move) {
     promo: w >>> 12 & 15
   };
 }
+var NULL_MOVE_WORD = 65535;
+var NULL_MOVE_UCI = "0000";
+var NULL_MOVE_SAN = "--";
+var NULL_MOVE_SANS = Object.freeze([NULL_MOVE_SAN, "Z0"]);
+function isNullMove(word) {
+  return (word & 65535) === 65535;
+}
+function isNullMoveUci(text) {
+  return text.trim().toLowerCase() === NULL_MOVE_UCI;
+}
+function isNullMoveSan(text) {
+  return NULL_MOVE_SANS.includes(text.trim());
+}
 var Color = {
   White: 0,
   Black: 1
@@ -121,6 +134,10 @@ function promoChar(piece) {
 }
 function createGigachessAdapter(fen) {
   const chess = fen === void 0 ? new Chess() : new Chess(fen);
+  const plyStack = [];
+  const clearPlyStack = () => {
+    plyStack.length = 0;
+  };
   const makeMove = (from, to, promotion) => {
     try {
       const fromAlg = algebraicOf(from);
@@ -132,6 +149,7 @@ function createGigachessAdapter(fen) {
         ...promo ? { promotion: promo } : {}
       });
       if (res === null) return null;
+      plyStack.push(null);
       if (res.flags.includes("k")) {
         return res.color === "w" ? packMove(4, 7, 0) : packMove(60, 63, 0);
       }
@@ -145,6 +163,19 @@ function createGigachessAdapter(fen) {
     }
   };
   const undo = () => {
+    const top = plyStack.pop();
+    if (top === void 0) return null;
+    if (top !== null) {
+      const board = chess.boardInstance;
+      board.turn = top.turn;
+      board.epSquare = top.epSquare;
+      board.halfmoves = top.halfmoves;
+      board.fullmoves = top.fullmoves;
+      board.checkers = { lo: top.checkersLo, hi: top.checkersHi };
+      board._zobristLo = top.zobristLo;
+      board._zobristHi = top.zobristHi;
+      return NULL_MOVE_WORD;
+    }
     const res = chess.undo();
     if (res === null) return null;
     if (res.flags.includes("k")) {
@@ -192,6 +223,30 @@ function createGigachessAdapter(fen) {
       }
     }
   };
+  const makeNullMove = () => {
+    const board = chess.boardInstance;
+    const us = board.turn;
+    if (!isEmpty(kingAttackers(board, us))) return null;
+    plyStack.push({
+      turn: us,
+      epSquare: board.epSquare,
+      halfmoves: board.halfmoves,
+      fullmoves: board.fullmoves,
+      checkersLo: board.checkers.lo,
+      checkersHi: board.checkers.hi,
+      zobristLo: board._zobristLo,
+      zobristHi: board._zobristHi
+    });
+    const them = opposite(us);
+    board.epSquare = null;
+    board.halfmoves = board.halfmoves + 1;
+    board.fullmoves = board.fullmoves + 1;
+    board.turn = them;
+    board._zobristLo = 0;
+    board._zobristHi = 0;
+    board.checkers = kingAttackers(board, them);
+    return NULL_MOVE_WORD;
+  };
   const san = (move) => {
     const { from, to, promo } = unpackMove(move);
     const role = promoRole(promo);
@@ -207,6 +262,7 @@ function createGigachessAdapter(fen) {
   return {
     makeMove,
     undo,
+    makeNullMove,
     legalMoves,
     readBoard,
     fen: () => chess.fen(),
@@ -215,9 +271,19 @@ function createGigachessAdapter(fen) {
     inCheck: () => chess.inCheck(),
     san,
     isGameOver: () => chess.isGameOver(),
-    load: (f) => chess.load(f),
-    reset: () => chess.reset(),
+    // Loading or resetting replaces the position and drops the engine's
+    // history, so the mirrored ply stack has to go with it — otherwise a
+    // later `undo()` would unmake a ply that no longer exists.
+    load: (f) => {
+      chess.load(f);
+      clearPlyStack();
+    },
+    reset: () => {
+      chess.reset();
+      clearPlyStack();
+    },
     dispose: () => {
+      clearPlyStack();
     }
   };
 }
@@ -242,6 +308,7 @@ function planAnimations(prev, next, move) {
     }
   }
   if (move !== null) {
+    if (isNullMove(move)) return [];
     return planFromMove(prev, next, move);
   }
   return planFromDiff(prev, next);
@@ -335,6 +402,9 @@ function planFromDiff(prev, next) {
   return descriptors;
 }
 function decodePackedMove(m) {
+  if (isNullMove(m)) {
+    return { from: 0, to: 0, kind: "pass", promotion: null };
+  }
   const from = m & MOVE_FROM_MASK;
   const to = m >> MOVE_TO_SHIFT & MOVE_TO_MASK;
   const promoCode = m >> MOVE_PROMO_SHIFT & MOVE_PROMO_MASK;
@@ -371,6 +441,19 @@ function freezeArrow(a) {
   return Object.freeze(out);
 }
 var EMPTY_ARROWS = Object.freeze([]);
+function labelsEqual(x, y) {
+  if (x === y) return true;
+  if (x === void 0 || y === void 0) return false;
+  return x.text === y.text && x.fill === y.fill && x.background === y.background && x.fontSize === y.fontSize && x.anchor === y.anchor && x.borderColor === y.borderColor && x.headStyle === y.headStyle && x.textRotation === y.textRotation && x.style3d === y.style3d;
+}
+function customSvgsEqual(x, y) {
+  if (x === y) return true;
+  if (x === void 0 || y === void 0) return false;
+  return x.html === y.html && x.center === y.center;
+}
+function arrowVisualsEqual(stored, incoming) {
+  return stored.managed === incoming.managed && labelsEqual(stored.label, incoming.label) && customSvgsEqual(stored.customSvg, incoming.customSvg);
+}
 function createArrowModel() {
   const byKey = /* @__PURE__ */ new Map();
   let changed = false;
@@ -434,7 +517,8 @@ function createArrowModel() {
       const key = arrowKey(marked);
       if (nextKeys.has(key)) continue;
       nextKeys.add(key);
-      if (!byKey.has(key)) {
+      const stored = byKey.get(key);
+      if (stored === void 0 || !arrowVisualsEqual(stored, marked)) {
         byKey.set(key, freezeArrow(marked));
         mutated = true;
       }
@@ -457,7 +541,8 @@ function createArrowModel() {
       const key = arrowKey(a);
       if (nextKeys.has(key)) continue;
       nextKeys.add(key);
-      if (!byKey.has(key)) {
+      const stored = byKey.get(key);
+      if (stored === void 0 || !arrowVisualsEqual(stored, a)) {
         byKey.set(key, freezeArrow(a));
         mutated = true;
       }
@@ -838,6 +923,7 @@ function createBoardModel(engine, options = {}) {
       m = engine.makeMove(from, to, promotion);
     }
     if (m === null) return null;
+    if (isNullMove(m)) return null;
     redoStack.length = 0;
     history.push(m);
     lastMove = m;
@@ -851,6 +937,17 @@ function createBoardModel(engine, options = {}) {
     }
     return m;
   };
+  const pass = () => {
+    if (engine.makeNullMove === void 0) return null;
+    const m = engine.makeNullMove();
+    if (m === null) return null;
+    redoStack.length = 0;
+    history.push(m);
+    lastMove = m;
+    selected = null;
+    commitWith(m);
+    return m;
+  };
   const undo = () => {
     const m = engine.undo();
     if (m === null) return null;
@@ -864,11 +961,7 @@ function createBoardModel(engine, options = {}) {
   const redo = () => {
     const m = redoStack.pop();
     if (m === void 0) return null;
-    const from = m & 63;
-    const to = moveTo(m);
-    const promoBits = m >> 12 & 15;
-    const promotion = promoBits > 0 ? promoBits : void 0;
-    const applied = engine.makeMove(from, to, promotion);
+    const applied = replayPackedMove(m);
     if (applied === null) {
       return null;
     }
@@ -878,6 +971,14 @@ function createBoardModel(engine, options = {}) {
     commitWith(applied);
     return applied;
   };
+  const replayPackedMove = (m) => {
+    if (isNullMove(m)) return engine.makeNullMove?.() ?? null;
+    const from = m & 63;
+    const to = moveTo(m);
+    const promoBits = m >> 12 & 15;
+    const promotion = promoBits > 0 ? promoBits : void 0;
+    return engine.makeMove(from, to, promotion);
+  };
   const goto = (ply) => {
     if (!Number.isInteger(ply) || ply < 0) return;
     const total = history.length + redoStack.length;
@@ -891,11 +992,7 @@ function createBoardModel(engine, options = {}) {
     while (history.length < ply) {
       const m = redoStack.pop();
       if (m === void 0) break;
-      const from = m & 63;
-      const to = moveTo(m);
-      const promoBits = m >> 12 & 15;
-      const promotion = promoBits > 0 ? promoBits : void 0;
-      const applied = engine.makeMove(from, to, promotion);
+      const applied = replayPackedMove(m);
       if (applied === null) break;
       history.push(applied);
     }
@@ -1069,6 +1166,7 @@ function createBoardModel(engine, options = {}) {
     subscribeSquare: (i, l) => store.subscribeSquare(i, l),
     selectSquare,
     tryMove,
+    pass,
     undo,
     redo,
     goto,
@@ -1105,6 +1203,6 @@ function writeBoardCell(out, index, cell) {
 // src/core/index.ts
 var PACKAGE_VERSION = "1.3.3";
 
-export { BOARD_CELL_BB, BOARD_CELL_BK, BOARD_CELL_BN, BOARD_CELL_BP, BOARD_CELL_BQ, BOARD_CELL_BR, BOARD_CELL_EMPTY, BOARD_CELL_WB, BOARD_CELL_WK, BOARD_CELL_WN, BOARD_CELL_WP, BOARD_CELL_WQ, BOARD_CELL_WR, Color, MOVE2_PROMO_BISHOP, MOVE2_PROMO_KNIGHT, MOVE2_PROMO_NONE, MOVE2_PROMO_QUEEN, MOVE2_PROMO_ROOK, PACKAGE_VERSION, PieceType, animationInspect, colorOf, createArrowModel, createBoardModel, createBoardStore, createDragController, createGigachessAdapter, createLegalMoveIndex, createPremoveBuffer, decodePackedMove, encodeBoardCell, isEmptyCell, isSquareIndex, makeArrow, makePremove, packMove, pieceTypeOf, planAnimations, preloadGigachessAdapter, toSquareIndex, unpackMove, writeBoardCell };
-//# sourceMappingURL=chunk-SO6AOEFF.js.map
-//# sourceMappingURL=chunk-SO6AOEFF.js.map
+export { BOARD_CELL_BB, BOARD_CELL_BK, BOARD_CELL_BN, BOARD_CELL_BP, BOARD_CELL_BQ, BOARD_CELL_BR, BOARD_CELL_EMPTY, BOARD_CELL_WB, BOARD_CELL_WK, BOARD_CELL_WN, BOARD_CELL_WP, BOARD_CELL_WQ, BOARD_CELL_WR, Color, MOVE2_PROMO_BISHOP, MOVE2_PROMO_KNIGHT, MOVE2_PROMO_NONE, MOVE2_PROMO_QUEEN, MOVE2_PROMO_ROOK, NULL_MOVE_SAN, NULL_MOVE_SANS, NULL_MOVE_UCI, NULL_MOVE_WORD, PACKAGE_VERSION, PieceType, animationInspect, colorOf, createArrowModel, createBoardModel, createBoardStore, createDragController, createGigachessAdapter, createLegalMoveIndex, createPremoveBuffer, decodePackedMove, encodeBoardCell, isEmptyCell, isNullMove, isNullMoveSan, isNullMoveUci, isSquareIndex, makeArrow, makePremove, packMove, pieceTypeOf, planAnimations, preloadGigachessAdapter, toSquareIndex, unpackMove, writeBoardCell };
+//# sourceMappingURL=chunk-6F3FZAG7.js.map
+//# sourceMappingURL=chunk-6F3FZAG7.js.map