@connectorvol/chess-widgets 8.0.1 → 9.0.0

package/dist/constants/default-board-appearance-settings.d.ts

@@ -0,0 +1,9 @@
+import type { TChessBoardDesignSettings, TChessBoardPlaySettings } from "@connectorvol/chessboard";
+/**
+ * Представляет визуальные настройки шахматной доски по умолчанию для виджетов chess-widgets
+ * (без `boardSize`, `orientation`, `draggable` — их подставляет вызывающий код).
+ */
+export declare const DEFAULT_BOARD_APPEARANCE_SETTINGS: {
+    play: TChessBoardPlaySettings;
+    design: TChessBoardDesignSettings;
+};

package/dist/constants/default-board-appearance-settings.js

@@ -0,0 +1,30 @@
+import { DEFAULT_DESIGN_SETTINGS, Draggable, PieceInputMode } from "@connectorvol/chessboard";
+import { Color } from "@connectorvol/shared";
+/**
+ * Представляет визуальные настройки шахматной доски по умолчанию для виджетов chess-widgets
+ * (без `boardSize`, `orientation`, `draggable` — их подставляет вызывающий код).
+ */
+export const DEFAULT_BOARD_APPEARANCE_SETTINGS = {
+    play: {
+        isResizable: true,
+        orientation: Color.WHITE,
+        boardSize: 38,
+        draggable: Draggable.NONE,
+        pieceInputMode: PieceInputMode.SOURCE_DRAG,
+        allowPreMove: true,
+        clearMarkersOnLeftClick: true,
+        showSquareBadges: true,
+        animationTime: 300,
+        editSettings: null,
+        needBorderRadius: false,
+    },
+    design: {
+        ...DEFAULT_DESIGN_SETTINGS,
+        showBoardCoordinates: false,
+        autoQueenPromotion: false,
+        showPossibleMoveIndicators: true,
+        border: false,
+        woodTexture: false,
+        boardGradient: true,
+    },
+};

package/dist/constants/editable-board-settings.d.ts

@@ -1,26 +1,8 @@
-import { Draggable, PieceInputMode } from "@connectorvol/chessboard";
+import type { TChessBoardDesignSettings, TChessBoardPlaySettings } from "@connectorvol/chessboard";
 /**
  * Представляет настройки редактируемой доски по умолчанию для конструктора позиции и мастера задач.
  */
 export declare const DEFAULT_EDITABLE_BOARD_SETTINGS: {
-    autoQueenPromotion: false;
-    isResizable: true;
-    showBoardCoordinates: false;
-    orientation: "w";
-    boardSize: number;
-    draggable: Draggable.BOTH;
-    pieceInputMode: PieceInputMode.SOURCE_DRAG;
-    allowPreMove: true;
-    border: false;
-    allowDrawMarkers: false;
-    clearMarkersOnLeftClick: true;
-    showSquareBadges: true;
-    animationTime: number;
-    editSettings: {
-        mode: {
-            type: "delete";
-            piece: null;
-            color: null;
-        };
-    };
+    play: TChessBoardPlaySettings;
+    design: TChessBoardDesignSettings;
 };

package/dist/constants/editable-board-settings.js

@@ -1,27 +1,32 @@
-import { Draggable, PieceInputMode } from "@connectorvol/chessboard";
+import { DEFAULT_DESIGN_SETTINGS, Draggable, PieceInputMode } from "@connectorvol/chessboard";
 import { Color } from "@connectorvol/shared";
 /**
  * Представляет настройки редактируемой доски по умолчанию для конструктора позиции и мастера задач.
  */
 export const DEFAULT_EDITABLE_BOARD_SETTINGS = {
-    autoQueenPromotion: false,
-    isResizable: true,
-    showBoardCoordinates: false,
-    orientation: Color.WHITE,
-    boardSize: 38,
-    draggable: Draggable.BOTH,
-    pieceInputMode: PieceInputMode.SOURCE_DRAG,
-    allowPreMove: true,
-    border: false,
-    allowDrawMarkers: false,
-    clearMarkersOnLeftClick: true,
-    showSquareBadges: true,
-    animationTime: 300,
-    editSettings: {
-        mode: {
-            type: "delete",
-            piece: null,
-            color: null,
+    play: {
+        isResizable: true,
+        orientation: Color.WHITE,
+        boardSize: 38,
+        draggable: Draggable.BOTH,
+        pieceInputMode: PieceInputMode.SOURCE_DRAG,
+        allowPreMove: true,
+        clearMarkersOnLeftClick: true,
+        showSquareBadges: true,
+        animationTime: 300,
+        editSettings: {
+            mode: {
+                type: "delete",
+                piece: null,
+                color: null,
+            },
         },
+        needBorderRadius: false,
+    },
+    design: {
+        ...DEFAULT_DESIGN_SETTINGS,
+        border: false,
+        showBoardCoordinates: false,
+        markerConfig: null,
     },
 };

package/dist/game-analyzer/GameAnalyzer.svelte

@@ -1,83 +1,87 @@
 <script lang="ts">
-    import type { TGameAnalyzerProps } from "./types.js";
+  import type { TGameAnalyzerProps } from "./types.js";
 
-    import { Chessboard } from "@connectorvol/chessboard";
-    import { TreeViewer, TreeViewerPanelManager } from "@connectorvol/tree";
-    import { Game } from "./gameAnalyzer.svelte.js";
-    import { untrack } from "svelte";
+  import { Chessboard } from "@connectorvol/chessboard";
+  import {
+    TREE_VIEWER_LIGHT_THEME,
+    TreeViewer,
+    TreeViewerPanelManager,
+  } from "@connectorvol/tree";
+  import { Game } from "./gameAnalyzer.svelte.js";
+  import { untrack } from "svelte";
+  import { DEFAULT_BOARD_APPEARANCE_SETTINGS } from "../constants/default-board-appearance-settings.js";
 
-    let {
-        pgn,
-        onChangePGN,
-        boardTheme,
-        boardAppearanceSettings,
-        editMode = true,
-        class: className,
-    }: TGameAnalyzerProps = $props();
+  let {
+    pgn,
+    onChangePGN,
+    boardTheme,
+    boardAppearanceSettings = DEFAULT_BOARD_APPEARANCE_SETTINGS,
+    editMode = true,
+    treeViewerTheme = TREE_VIEWER_LIGHT_THEME,
+    class: className,
+  }: TGameAnalyzerProps = $props();
 
-    let game = $derived(
-        new Game(
-            untrack(() => pgn),
-            {
-                ...boardAppearanceSettings,
-            },
-            "chess",
-            boardTheme,
-        ),
-    );
+  let game = $derived(
+    new Game(
+      untrack(() => pgn),
+      boardAppearanceSettings?.play ?? {},
+      "chess",
+      boardTheme,
+    ),
+  );
 
-    let boardSize = $derived(
-        game.chessboard.getBoard().settingsService.boardSize,
-    );
-    let isAutoSize = $derived(boardSize === "auto");
+  let boardSize = $derived(
+    game.chessboard.getBoard().settingsService.boardSize,
+  );
+  let isAutoSize = $derived(boardSize === "auto");
 
-    function handleChangeDirty(_setIsDirty: (value: boolean) => void) {
-        console.log("handleChangeDirty");
-        const exported = game.exportPgn();
-        onChangePGN?.(exported);
-    }
+  function handleChangeDirty(_setIsDirty: (value: boolean) => void) {
+    console.log("handleChangeDirty");
+    const exported = game.exportPgn();
+    onChangePGN?.(exported);
+  }
 </script>
 
 <div class={["mx-4 lg:container lg:mx-auto gap-4", className]}>
-    <div class="flex justify-center relative lg:gap-4 flex-col lg:flex-row">
-        <div
-            class={[
-                "w-full",
-                isAutoSize ? "lg:w-2/5" : "lg:w-auto lg:min-w-[3.75rem]",
-            ]}
-            style={!isAutoSize && typeof boardSize === "number"
-                ? `flex-basis: ${boardSize}rem;`
-                : ""}
-        >
-            <Chessboard facade={game.chessboard} />
-        </div>
+  <div class="flex justify-center relative lg:gap-4 flex-col lg:flex-row">
+    <div
+      class={[
+        "w-full",
+        isAutoSize ? "lg:w-2/5" : "lg:w-auto lg:min-w-[3.75rem]",
+      ]}
+      style={!isAutoSize && typeof boardSize === "number"
+        ? `flex-basis: ${boardSize}rem;`
+        : ""}
+    >
+      <Chessboard facade={game.chessboard} design={{ theme: game.theme }} />
+    </div>
 
-        <div
-            class={[
-                "w-full flex lg:flex-col flex-col-reverse h-full",
-                isAutoSize ? "lg:w-3/5" : "lg:flex-1 lg:min-w-[20rem]",
-            ]}
-        >
-            <div class="h-full">
-                <TreeViewer
-                    className="h-[calc(100dvh-8rem)]"
-                    chessTree={game.chessTree}
-                    onSelectNode={game.onSelectNode}
-                    onDeleteVariant={game.onDeleteVariant}
-                    setChessFen={game.setChessFen}
-                    setChessboardFen={game.setChessboardFen}
-                    pieceSet={game.chessboard.chessSet}
-                    {editMode}
-                    onChangeDirty={handleChangeDirty}
-                />
-            </div>
+    <div
+      class={[
+        "w-full flex lg:flex-col flex-col-reverse h-full",
+        isAutoSize ? "lg:w-3/5" : "lg:flex-1 lg:min-w-[20rem]",
+      ]}
+    >
+      <div class="h-full">
+        <TreeViewer
+          className="h-[calc(100dvh-8rem)]"
+          chessTree={game.chessTree}
+          onSelectNode={game.onSelectNode}
+          onDeleteVariant={game.onDeleteVariant}
+          setChessFen={game.setChessFen}
+          setChessboardFen={game.setChessboardFen}
+          {editMode}
+          theme={treeViewerTheme}
+          onChangeDirty={handleChangeDirty}
+        />
+      </div>
 
-            <TreeViewerPanelManager
-                className="flex w-full justify-center select-none col-span-1 my-4"
-                chessTree={game.chessTree}
-                setChessFen={game.setChessFen}
-                setChessboardFen={game.setChessboardFen}
-            />
-        </div>
+      <TreeViewerPanelManager
+        className="flex w-full justify-center select-none col-span-1 my-4"
+        chessTree={game.chessTree}
+        setChessFen={game.setChessFen}
+        setChessboardFen={game.setChessboardFen}
+      />
     </div>
+  </div>
 </div>

package/dist/game-analyzer/gameAnalyzer.svelte.js

@@ -1,5 +1,5 @@
 import { Color, calculatePly, generateId } from "@connectorvol/shared";
-import { CHESSBOARD_THEMES, createBoardApi, Draggable, syncMoveEvaluationNagBadge, } from "@connectorvol/chessboard";
+import { CHESSBOARD_THEMES, createBoardApi, DEFAULT_PLAY_SETTINGS, Draggable, syncMoveEvaluationNagBadge, } from "@connectorvol/chessboard";
 import { PgnOps } from "@connectorvol/chessops/pgnOps.svelte";
 import { transformPgnToChessNode, createPgnFromTree } from "@connectorvol/tree";
 import { ChessTree } from "@connectorvol/tree";
@@ -9,23 +9,25 @@ export class Game {
     chessboard;
     chessTree;
     previousNode;
-    boardSettings;
+    playSettings;
     variant;
     boardTheme;
+    /** Возвращает активную тему доски, реактивный `$state` для биндинга в UI. */
+    theme = $state(CHESSBOARD_THEMES.blue);
     constructor(pgn, chessBoardSettings, variant = "chess", boardTheme) {
-        this.boardSettings = chessBoardSettings;
+        this.playSettings = { ...DEFAULT_PLAY_SETTINGS, ...chessBoardSettings };
         this.variant = variant;
         this.boardTheme = boardTheme ?? CHESSBOARD_THEMES.blue;
+        this.theme = this.boardTheme;
         const { rootNode, initialFen: position } = transformPgnToChessNode(pgn);
         this.chessTree = new ChessTree(rootNode);
         this.chess = new PgnOps(position, variant);
         this.chessboard = createBoardApi({
             fen: this.chess.fen(),
-            settings: {
-                ...this.boardSettings,
+            playSettings: {
+                ...this.playSettings,
                 draggable: this.chess.turn() === Color.WHITE ? Draggable.WHITE : Draggable.BLACK,
             },
-            theme: this.boardTheme,
         });
         this.chessboard.setActions(this.buildActions());
         this.previousNode = this.chessTree.currentNode;

package/dist/game-analyzer/types.d.ts

@@ -1,9 +1,13 @@
 import type { ChessboardTheme } from "@connectorvol/chessboard";
-import type { ChessBoardSettings } from "@connectorvol/chessboard";
+import type { TChessBoardDesignSettings, TChessBoardPlaySettings } from "@connectorvol/chessboard";
+import type { TTreeViewerTheme } from "@connectorvol/tree";
 /**
  * Представляет тип визуальных настроек шахматной доски для анализатора партии.
  */
-export type TChessboardAppearanceSettings = Omit<Partial<ChessBoardSettings>, "boardSize" | "orientation" | "draggable">;
+export type TChessboardAppearanceSettings = {
+    play?: Omit<TChessBoardPlaySettings, "boardSize" | "orientation" | "draggable">;
+    design?: Partial<TChessBoardDesignSettings>;
+};
 /**
  * Представляет свойства компонента анализатора партии.
  */
@@ -23,11 +27,15 @@ export interface TGameAnalyzerProps {
     /**
      * Возвращает дополнительные визуальные настройки шахматной доски (кроме `boardSize`, `orientation`, `draggable`).
      */
-    boardAppearanceSettings: TChessboardAppearanceSettings;
+    boardAppearanceSettings?: TChessboardAppearanceSettings;
     /**
      * Возвращает признак режима правки дерева (по умолчанию `true`).
      */
     editMode?: boolean;
+    /**
+     * Возвращает тему `TreeViewer` (фон, границы, текст). По умолчанию `TREE_VIEWER_LIGHT_THEME`.
+     */
+    treeViewerTheme?: TTreeViewerTheme;
     /**
      * Возвращает дополнительные классы Tailwind для корневого контейнера.
      */

package/dist/index.d.ts

@@ -1,13 +1,21 @@
 export { default as PuzzleCreationWizard } from "./puzzle-creation/PuzzleCreationWizard.svelte";
+export { default as PuzzleWizardTagsStep } from "./puzzle-creation/PuzzleWizardTagsStep.svelte";
 export { default as PuzzlePgnBoardTreeEditor } from "./puzzle-creation/PuzzlePgnBoardTreeEditor.svelte";
 export type { TPuzzleCreationWizardProps, TPuzzlePgnBoardTreeEditorOutcome, TPuzzlePgnBoardTreeEditorProps, } from "./puzzle-creation/types.js";
-export type { TPuzzleCreatedPayload } from "./puzzle/puzzleCreatedPayload.js";
+export type { TPuzzleWizardCoreState, TPuzzleWizardState, } from "./puzzle-creation/puzzleWizardState.js";
+export { PUZZLE_WIZARD_CORE_STEPS, PUZZLE_WIZARD_TAGS_STEP, createInitialPuzzleWizardCoreState, createInitialPuzzleWizardState, puzzleWizardSeedFen, } from "./puzzle-creation/puzzleWizardState.js";
+export type { TWizardStep, TWizardStepContext, } from "@connectorvol/shared";
+export { Wizard, getWizardContext, setWizardContext } from "@connectorvol/shared";
+export type { TPuzzleCreatedPayload, TPuzzleTags } from "./puzzle/puzzleCreatedPayload.js";
 export { puzzlePartsFromFullPgn } from "./puzzle/puzzleCreatedPayload.js";
 export type { PuzzleData } from "./puzzle/puzzleData.js";
 export { PUZZLE_EMPTY_BOARD_FEN, createInitialPuzzleData, createEmptyTreeFromFen, getMainLineFromTree, } from "./puzzle/puzzleData.js";
 export type { TSolverMoveOutcome } from "./puzzle/puzzleStepPreviewSolver.js";
 export { PREVIEW_WRONG_NO_VARIANT_MESSAGE } from "./puzzle/puzzlePreviewConstants.js";
+export { validatePuzzleSolverForkAnnotations } from "./puzzle/puzzleSolverForkAnnotations.js";
+export { normalizePuzzleTreeMainLine, syncPuzzleBranchNags, syncPuzzleBranchNagsOnTree, } from "./puzzle/syncPuzzleBranchNags.js";
 export { DEFAULT_EDITABLE_BOARD_SETTINGS } from "./constants/editable-board-settings.js";
+export { DEFAULT_BOARD_APPEARANCE_SETTINGS } from "./constants/default-board-appearance-settings.js";
 export { default as EditFen } from "./position-editor/EditFen.svelte";
 export { default as EditMove } from "./position-editor/EditMove.svelte";
 export { default as EditPanel } from "./position-editor/EditPanel.svelte";

package/dist/index.js

@@ -1,9 +1,15 @@
 export { default as PuzzleCreationWizard } from "./puzzle-creation/PuzzleCreationWizard.svelte";
+export { default as PuzzleWizardTagsStep } from "./puzzle-creation/PuzzleWizardTagsStep.svelte";
 export { default as PuzzlePgnBoardTreeEditor } from "./puzzle-creation/PuzzlePgnBoardTreeEditor.svelte";
+export { PUZZLE_WIZARD_CORE_STEPS, PUZZLE_WIZARD_TAGS_STEP, createInitialPuzzleWizardCoreState, createInitialPuzzleWizardState, puzzleWizardSeedFen, } from "./puzzle-creation/puzzleWizardState.js";
+export { Wizard, getWizardContext, setWizardContext } from "@connectorvol/shared";
 export { puzzlePartsFromFullPgn } from "./puzzle/puzzleCreatedPayload.js";
 export { PUZZLE_EMPTY_BOARD_FEN, createInitialPuzzleData, createEmptyTreeFromFen, getMainLineFromTree, } from "./puzzle/puzzleData.js";
 export { PREVIEW_WRONG_NO_VARIANT_MESSAGE } from "./puzzle/puzzlePreviewConstants.js";
+export { validatePuzzleSolverForkAnnotations } from "./puzzle/puzzleSolverForkAnnotations.js";
+export { normalizePuzzleTreeMainLine, syncPuzzleBranchNags, syncPuzzleBranchNagsOnTree, } from "./puzzle/syncPuzzleBranchNags.js";
 export { DEFAULT_EDITABLE_BOARD_SETTINGS } from "./constants/editable-board-settings.js";
+export { DEFAULT_BOARD_APPEARANCE_SETTINGS } from "./constants/default-board-appearance-settings.js";
 export { default as EditFen } from "./position-editor/EditFen.svelte";
 export { default as EditMove } from "./position-editor/EditMove.svelte";
 export { default as EditPanel } from "./position-editor/EditPanel.svelte";

package/dist/position-editor/EditPanel.svelte

@@ -1,5 +1,6 @@
 <script lang="ts">
   import type { BoardApi } from "@connectorvol/chessboard";
+  import { CHESSBOARD_PIECE_SETS } from "@connectorvol/chessboard";
 
   interface Props {
     color: "w" | "b";
@@ -8,6 +9,8 @@
 
   const { color, api }: Props = $props();
 
+  const pieceSet = $derived(CHESSBOARD_PIECE_SETS[api.chessSet]);
+
   function onSelect(
     promotion: "q" | "r" | "b" | "n" | "k" | "p" | "delete" | "drag"
   ) {
@@ -78,7 +81,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("p")}
       >
-        {@render api.chessSet?.pawn(color === "w" ? "w" : "b")}
+        {@render pieceSet.pawn(color === "w" ? "w" : "b")}
       </button>
       <button
         data-testid="edit-panel-knight-{color}"
@@ -89,7 +92,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("n")}
       >
-        {@render api.chessSet?.knight(color)}
+        {@render pieceSet.knight(color)}
       </button>
       <button
         data-testid="edit-panel-bishop-{color}"
@@ -100,7 +103,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("b")}
       >
-        {@render api.chessSet?.bishop(color)}
+        {@render pieceSet.bishop(color)}
       </button>
       <button
         data-testid="edit-panel-rook-{color}"
@@ -111,7 +114,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("r")}
       >
-        {@render api.chessSet?.rook(color)}
+        {@render pieceSet.rook(color)}
       </button>
       <button
         data-testid="edit-panel-queen-{color}"
@@ -122,7 +125,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("q")}
       >
-        {@render api.chessSet?.queen(color)}
+        {@render pieceSet.queen(color)}
       </button>
       <button
         data-testid="edit-panel-king-{color}"
@@ -133,7 +136,7 @@
         class="flex aspect-square w-1/8"
         onclick={() => onSelect("k")}
       >
-        {@render api.chessSet?.king(color)}
+        {@render pieceSet.king(color)}
       </button>
       <button
         aria-label="Delete piece"

package/dist/puzzle/puzzleCreatedPayload.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Представляет выбранные теги задачи (дебют и тактические приёмы).
+ */
+export interface TPuzzleTags {
+    /**
+     * Возвращает идентификатор выбранного дебютного тега или `undefined`, если дебют не выбран.
+     */
+    opening?: string;
+    /**
+     * Возвращает идентификаторы выбранных тактических тегов (не более трёх).
+     */
+    tactics: string[];
+}
 /**
  * Представляет данные задачи, передаваемые колбэку после завершения мастера.
  */
@@ -10,6 +23,10 @@ export interface TPuzzleCreatedPayload {
      * Возвращает начальный FEN задачи (из тега FEN или начальная позиция по умолчанию).
      */
     fen: string;
+    /**
+     * Возвращает выбранные теги задачи, если в мастере включён шаг тегов.
+     */
+    tags?: TPuzzleTags;
 }
 /**
  * Представляет разбор полного PGN из дерева задачи на FEN и чистую строку ходов.

package/dist/puzzle/puzzleData.d.ts

@@ -25,6 +25,10 @@ export declare function createInitialPuzzleData(initialFen?: string): PuzzleData
  * Возвращает корень дерева (TChessTree) для использования в ChessTree.
  */
 export declare function createEmptyTreeFromFen(initialFen: string): TChessTree;
+/**
+ * Представляет создание дерева превью для ученика с опциональным вступительным комментарием PGN до первого хода.
+ */
+export declare function createStudentPreviewTreeFromFen(initialFen: string, introComments?: string[]): TChessTree;
 /**
  * Представляет извлечение главной линии (первого варианта) из дерева ходов.
  * Возвращает массив ходов в нотации SAN.

package/dist/puzzle/puzzleData.js

@@ -35,6 +35,16 @@ export function createEmptyTreeFromFen(initialFen) {
         headers,
     };
 }
+/**
+ * Представляет создание дерева превью для ученика с опциональным вступительным комментарием PGN до первого хода.
+ */
+export function createStudentPreviewTreeFromFen(initialFen, introComments) {
+    const tree = createEmptyTreeFromFen(initialFen);
+    if (introComments !== undefined && introComments.length > 0) {
+        tree.comments = [...introComments];
+    }
+    return tree;
+}
 /**
  * Представляет извлечение главной линии (первого варианта) из дерева ходов.
  * Возвращает массив ходов в нотации SAN.

package/dist/puzzle/puzzlePreviewConstants.d.ts

@@ -2,3 +2,7 @@
  * Представляет текст сообщения «нет такого продолжения» для превью задачи (как на шаге 3).
  */
 export declare const PREVIEW_WRONG_NO_VARIANT_MESSAGE = "\u0422\u0430\u043A\u043E\u0433\u043E \u043F\u0440\u043E\u0434\u043E\u043B\u0436\u0435\u043D\u0438\u044F \u043D\u0435\u0442 \u0441\u0440\u0435\u0434\u0438 \u0432\u0430\u0440\u0438\u0430\u043D\u0442\u043E\u0432 \u0437\u0430\u0434\u0430\u0447\u0438.";
+/**
+ * Представляет задержку (мс) перед откатом ошибочного хода на доске после показа NAG ✗.
+ */
+export declare const PREVIEW_WRONG_MOVE_REVEAL_MS = 700;

package/dist/puzzle/puzzlePreviewConstants.js

@@ -2,3 +2,7 @@
  * Представляет текст сообщения «нет такого продолжения» для превью задачи (как на шаге 3).
  */
 export const PREVIEW_WRONG_NO_VARIANT_MESSAGE = "Такого продолжения нет среди вариантов задачи.";
+/**
+ * Представляет задержку (мс) перед откатом ошибочного хода на доске после показа NAG ✗.
+ */
+export const PREVIEW_WRONG_MOVE_REVEAL_MS = 700;

package/dist/puzzle/puzzlePreviewPathNags.d.ts

@@ -0,0 +1,6 @@
+import type { ChessTree } from "@connectorvol/tree";
+import type { Color } from "@connectorvol/shared";
+/**
+ * Представляет синхронизацию NAG ✓ ходов решателя в дереве решения по пройденному пути превью.
+ */
+export declare function applyPlayedSolverNagsAlongPath(solution: ChessTree, path: number[], solverColor: Color): boolean;

package/dist/puzzle/puzzlePreviewPathNags.js

@@ -0,0 +1,35 @@
+import { PUZZLE_BRANCH_CORRECT_NAG_ID, PUZZLE_BRANCH_WRONG_NAG_ID, } from "@connectorvol/shared";
+import { puzzlePreviewSideToMoveFromFen } from "./puzzleStepPreviewSolver.js";
+/**
+ * Представляет синхронизацию NAG ✓ ходов решателя в дереве решения по пройденному пути превью.
+ */
+export function applyPlayedSolverNagsAlongPath(solution, path, solverColor) {
+    let src = solution.rootNode.moves;
+    let changed = false;
+    for (const idx of path) {
+        const next = src.children[idx];
+        if (!next)
+            break;
+        const mover = puzzlePreviewSideToMoveFromFen(src.data.fen);
+        const isSolverMove = mover === solverColor;
+        if (isSolverMove) {
+            let nags = next.data.nags ? [...next.data.nags] : [];
+            if (!nags.includes(PUZZLE_BRANCH_CORRECT_NAG_ID)) {
+                nags.push(PUZZLE_BRANCH_CORRECT_NAG_ID);
+            }
+            nags = nags.filter((n) => n !== PUZZLE_BRANCH_WRONG_NAG_ID);
+            const normalizedNags = nags.length > 0 ? nags : undefined;
+            const prevKey = JSON.stringify(next.data.nags ?? []);
+            const nextKey = JSON.stringify(normalizedNags ?? []);
+            if (prevKey !== nextKey) {
+                next.data.nags = normalizedNags ? [...normalizedNags] : undefined;
+                changed = true;
+            }
+        }
+        src = next;
+    }
+    if (changed) {
+        solution.mutationVersion++;
+    }
+    return changed;
+}

package/dist/puzzle/puzzleSolverForkAnnotations.d.ts

@@ -1,10 +1,8 @@
 import type { ChessTree } from "@connectorvol/tree";
 import { Color } from "@connectorvol/shared";
 /**
- * Представляет проверку линии решения задачи: метки ✓/✗ только на ходах из развилки,
- * запрет ✓/✗ ниже по дереву после ✗ на ходе решателя, разметка развилок со стороны
- * решателя и окончание вариантов на развилке соперника ходом решателя вне поддерева
- * после хода решателя с меткой «неверное решение».
+ * Представляет проверку линии решения задачи: разметка развилок со стороны решателя
+ * и окончание вариантов на развилке соперника ходом решателя.
  */
 export declare function validatePuzzleSolverForkAnnotations(tree: ChessTree, solverColor: Color): {
     ok: true;