@connectorvol/chess-widgets 8.0.0 → 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,48 +1,67 @@
 <script lang="ts">
   import type { TGameAnalyzerProps } from "./types.js";
 
-  import { Chessboard, DEFAULT_BOARD_SETTINGS } from "@connectorvol/chessboard";
-  import { TreeViewer, TreeViewerPanelManager } from "@connectorvol/tree";
+  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,
+    boardAppearanceSettings = DEFAULT_BOARD_APPEARANCE_SETTINGS,
     editMode = true,
+    treeViewerTheme = TREE_VIEWER_LIGHT_THEME,
     class: className,
   }: TGameAnalyzerProps = $props();
 
-  
-  let game = $derived(new Game(
-    untrack(() => pgn),
-      {
-        ...DEFAULT_BOARD_SETTINGS,
-        ...boardAppearanceSettings,
-        boardSize: "auto",
-      },
+  let game = $derived(
+    new Game(
+      untrack(() => pgn),
+      boardAppearanceSettings?.play ?? {},
       "chess",
       boardTheme,
-    ))
+    ),
+  );
+
+  let boardSize = $derived(
+    game.chessboard.getBoard().settingsService.boardSize,
+  );
+  let isAutoSize = $derived(boardSize === "auto");
 
   function handleChangeDirty(_setIsDirty: (value: boolean) => void) {
-    console.log('handleChangeDirty')
+    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="lg:w-2/5">
-      <Chessboard facade={game.chessboard} />
+    <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="lg:w-3/5 flex lg:flex-col flex-col-reverse h-full">
+    <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)]"
@@ -51,8 +70,8 @@
           onDeleteVariant={game.onDeleteVariant}
           setChessFen={game.setChessFen}
           setChessboardFen={game.setChessboardFen}
-          pieceSet={game.chessboard.chessSet}
           {editMode}
+          theme={treeViewerTheme}
           onChangeDirty={handleChangeDirty}
         />
       </div>

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

@@ -1,5 +1,5 @@
 import { Color, calculatePly, generateId } from "@connectorvol/shared";
-import { CHESSBOARD_THEMES, createBoardApi, DEFAULT_BOARD_SETTINGS, 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;
-    constructor(pgn, chessBoardSettings = DEFAULT_BOARD_SETTINGS, variant = "chess", boardTheme) {
-        this.boardSettings = chessBoardSettings;
+    /** Возвращает активную тему доски, реактивный `$state` для биндинга в UI. */
+    theme = $state(CHESSBOARD_THEMES.blue);
+    constructor(pgn, chessBoardSettings, variant = "chess", boardTheme) {
+        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>;
+};
 /**
  * Представляет свойства компонента анализатора партии.
  */
@@ -28,6 +32,10 @@ export interface TGameAnalyzerProps {
      * Возвращает признак режима правки дерева (по умолчанию `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;

package/dist/puzzle/puzzleSolverForkAnnotations.js

@@ -23,31 +23,15 @@ function solverJustPlayedLastOnLine(fullFen, solverColor) {
     return sideToMoveFromFullFen(fullFen) !== solverColor;
 }
 /**
- * Представляет проверку линии решения задачи: метки ✓/✗ только на ходах из развилки,
- * запрет ✓/✗ ниже по дереву после ✗ на ходе решателя, разметка развилок со стороны
- * решателя и окончание вариантов на развилке соперника ходом решателя вне поддерева
- * после хода решателя с меткой «неверное решение».
+ * Представляет проверку линии решения задачи: разметка развилок со стороны решателя
+ * и окончание вариантов на развилке соперника ходом решателя.
  */
 export function validatePuzzleSolverForkAnnotations(tree, solverColor) {
-    function walk(node, parent, ancestorsContainWrongMarkedSolver) {
-        const puzzleForkNags = node.data.nags ?? [];
-        const hasPuzzleForkMarker = puzzleForkNags.includes(PUZZLE_BRANCH_CORRECT_NAG_ID) ||
-            puzzleForkNags.includes(PUZZLE_BRANCH_WRONG_NAG_ID);
-        if (hasPuzzleForkMarker && (!parent || parent.children.length <= 1)) {
-            return {
-                ok: false,
-                reason: "Метки верного или неверного хода задачи (✓ / ✗) можно ставить только на ход из развилки: у родительской позиции должно быть несколько вариантов хода.",
-            };
-        }
-        if (ancestorsContainWrongMarkedSolver && hasPuzzleForkMarker) {
-            return {
-                ok: false,
-                reason: "Внутри продолжения после хода решателя с меткой ✗ «неверное решение» не ставьте метки ✓ и ✗ на последующих развилках.",
-            };
-        }
+    function walk(node, ancestorsContainWrongMarkedSolver) {
         if (node.children.length > 1) {
             const mover = sideToMoveFromFullFen(node.data.fen);
             if (mover === solverColor && !ancestorsContainWrongMarkedSolver) {
+                let hasAnyCorrect = false;
                 for (const child of node.children) {
                     const nags = child.data.nags ?? [];
                     const markedCorrect = nags.includes(PUZZLE_BRANCH_CORRECT_NAG_ID);
@@ -59,6 +43,7 @@ export function validatePuzzleSolverForkAnnotations(tree, solverColor) {
                         };
                     }
                     if (markedCorrect) {
+                        hasAnyCorrect = true;
                         const leaf = tailAlongFirstVariation(child);
                         if (!solverJustPlayedLastOnLine(leaf.data.fen, solverColor)) {
                             return {
@@ -68,6 +53,12 @@ export function validatePuzzleSolverForkAnnotations(tree, solverColor) {
                         }
                     }
                 }
+                if (!hasAnyCorrect) {
+                    return {
+                        ok: false,
+                        reason: "На каждой развилке со стороны решателя хотя бы один вариант должен быть отмечен как верный ход (✓).",
+                    };
+                }
             }
             else if (mover !== solverColor && !ancestorsContainWrongMarkedSolver) {
                 for (const child of node.children) {
@@ -84,11 +75,11 @@ export function validatePuzzleSolverForkAnnotations(tree, solverColor) {
         const wrongMarkedAmongAncestorsForChildren = ancestorsContainWrongMarkedSolver ||
             (node.data.nags ?? []).includes(PUZZLE_BRANCH_WRONG_NAG_ID);
         for (const child of node.children) {
-            const sub = walk(child, node, wrongMarkedAmongAncestorsForChildren);
+            const sub = walk(child, wrongMarkedAmongAncestorsForChildren);
             if (!sub.ok)
                 return sub;
         }
         return { ok: true };
     }
-    return walk(tree.rootNode.moves, null, false);
+    return walk(tree.rootNode.moves, false);
 }

package/dist/puzzle/puzzleStepPreviewSolver.d.ts

@@ -28,7 +28,19 @@ export declare function puzzlePreviewFindChildIndexForPlayedSan(cursorFen: strin
 /**
  * Представляет классификацию хода решателя на развилке (или на единственном продолжении).
  */
-export declare function puzzlePreviewClassifySolverMove(cursorNode: ChessTreeNode, cursorFen: string, playedSan: string, solverColor: Color): TSolverMoveOutcome;
+export declare function puzzlePreviewClassifySolverMove(cursorNode: ChessTreeNode, cursorFen: string, playedSan: string, _solverColor: Color): TSolverMoveOutcome;
+/**
+ * Представляет сбор данных узла для произвольного неверного хода решателя (нет в PGN).
+ */
+export declare function puzzlePreviewBuildAdHocWrongMoveData(cursorFen: string, san: string): ChessTreeNode["data"] | null;
+/**
+ * Представляет добавление отсутствующего в PGN хода как новой ветки дерева решения с NAG ✗.
+ */
+export declare function puzzlePreviewAddAdHocWrongMoveToSolutionTree(solutionTree: ChessTree, cursorPath: number[], cursorFen: string, san: string): ChessTreeNode | null;
+/**
+ * Представляет пересчёт пути индексов после перестановки детей на развилках.
+ */
+export declare function puzzlePreviewRemapPathAfterReorder(rootMoves: ChessTreeNode, path: number[]): number[];
 /**
  * Представляет проверку: линия закончилась ключевым ходом решателя (ход соперника, лист дерева).
  */