@connectorvol/chess-widgets 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export { default as PuzzleCreationWizard } from "./puzzle-creation/PuzzleCreationWizard.svelte";
-export type { TPuzzleCreationWizardProps } from "./puzzle-creation/types.js";
+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 { 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 { DEFAULT_EDITABLE_BOARD_SETTINGS } from "./constants/editable-board-settings.js";
 export { default as EditFen } from "./position-editor/EditFen.svelte";
 export { default as EditMove } from "./position-editor/EditMove.svelte";

package/dist/index.js

@@ -1,6 +1,8 @@
 export { default as PuzzleCreationWizard } from "./puzzle-creation/PuzzleCreationWizard.svelte";
+export { default as PuzzlePgnBoardTreeEditor } from "./puzzle-creation/PuzzlePgnBoardTreeEditor.svelte";
 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 { DEFAULT_EDITABLE_BOARD_SETTINGS } from "./constants/editable-board-settings.js";
 export { default as EditFen } from "./position-editor/EditFen.svelte";
 export { default as EditMove } from "./position-editor/EditMove.svelte";

package/dist/puzzle/mergePgnWithSetupFen.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Представляет извлечение блока ходов из строки PGN без заголовков (только партия / варианты).
+ */
+export declare function stripPgnHeaders(movetextSource: string): string;
+/**
+ * Представляет сборку строки PGN с заголовком `[FEN "..."]` для парсера дерева при раздельной передаче FEN и текста ходов.
+ */
+export declare function mergePgnWithSetupFen(movetextOrFullPgn: string, fen: string): string;

package/dist/puzzle/mergePgnWithSetupFen.js

@@ -0,0 +1,28 @@
+/**
+ * Представляет извлечение блока ходов из строки PGN без заголовков (только партия / варианты).
+ */
+export function stripPgnHeaders(movetextSource) {
+    const lines = movetextSource.split("\n");
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i].trim();
+        if (line === "") {
+            i++;
+            continue;
+        }
+        if (line.startsWith("[")) {
+            i++;
+            continue;
+        }
+        break;
+    }
+    return lines.slice(i).join("\n").trim();
+}
+/**
+ * Представляет сборку строки PGN с заголовком `[FEN "..."]` для парсера дерева при раздельной передаче FEN и текста ходов.
+ */
+export function mergePgnWithSetupFen(movetextOrFullPgn, fen) {
+    const escaped = fen.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+    const body = stripPgnHeaders(movetextOrFullPgn);
+    return `[SetUp "1"]\n[FEN "${escaped}"]\n\n${body}`;
+}

package/dist/puzzle/puzzlePreviewConstants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Представляет текст сообщения «нет такого продолжения» для превью задачи (как на шаге 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.";

package/dist/puzzle/puzzlePreviewConstants.js

@@ -0,0 +1,4 @@
+/**
+ * Представляет текст сообщения «нет такого продолжения» для превью задачи (как на шаге 3).
+ */
+export const PREVIEW_WRONG_NO_VARIANT_MESSAGE = "Такого продолжения нет среди вариантов задачи.";

package/dist/puzzle-creation/PuzzleBoardTreeViewerPane.svelte

@@ -0,0 +1,106 @@
+<script lang="ts">
+  import type { Snippet } from "svelte";
+
+  import type { BoardApi } from "@connectorvol/chessboard";
+  import { Chessboard } from "@connectorvol/chessboard";
+  import type { ChessTree } from "@connectorvol/tree";
+  import { TreeViewer } from "@connectorvol/tree";
+  import { DEFAULT_PIECE_SET } from "@connectorvol/shared";
+
+  import { cn } from "../utils.js";
+
+  /**
+   * Представляет свойства панели разметки «доска и просмотр дерева партии».
+   */
+  interface Props {
+    /**
+     * Возвращает API шахматной доски для компонента `Chessboard`.
+     */
+    chessboard: BoardApi;
+    /**
+     * Возвращает экземпляр дерева ходов для `TreeViewer`.
+     */
+    chessTree: ChessTree;
+    /**
+     * Возвращает обработчик выбора узла в дереве.
+     */
+    onSelectNode: () => void;
+    /**
+     * Возвращает обработчик после удаления варианта.
+     */
+    onDeleteVariant: () => void;
+    /**
+     * Возвращает функцию установки FEN в движке партии.
+     */
+    setChessFen: (fen: string) => void;
+    /**
+     * Возвращает функцию синхронизации FEN и UI доски.
+     */
+    setChessboardFen: (animationTime?: number) => void;
+    /**
+     * Возвращает признак режима правки дерева (`TreeViewer.editMode`).
+     */
+    editMode?: boolean;
+    /**
+     * Возвращает признак возможности выбора узлов в дереве.
+     */
+    selectable?: boolean;
+    /**
+     * Возвращает дополнительные классы Tailwind для корневого контейнера.
+     */
+    class?: string;
+    /**
+     * Возвращает фрагмент разметки под шахматной доской (например сообщение об ошибке в превью).
+     */
+    belowChessboard?: Snippet;
+  }
+
+  const {
+    chessboard,
+    chessTree,
+    onSelectNode,
+    onDeleteVariant,
+    setChessFen,
+    setChessboardFen,
+    editMode = true,
+    selectable = true,
+    class: className,
+    belowChessboard,
+  }: Props = $props();
+</script>
+
+<div
+  class={cn(
+    "relative flex min-h-0 flex-col justify-start lg:flex-row lg:items-stretch lg:justify-start lg:gap-4",
+    className,
+  )}
+>
+  <div
+    class="order-2 flex min-h-48 w-full flex-1 flex-col gap-2 lg:order-2 lg:min-h-0 lg:min-w-0"
+  >
+    <div
+      class="flex min-h-28 min-w-0 flex-1 flex-col overflow-hidden rounded-md border border-border lg:min-h-0"
+    >
+      <TreeViewer
+        chessTree={chessTree}
+        {onSelectNode}
+        {onDeleteVariant}
+        {setChessFen}
+        {setChessboardFen}
+        pieceSet={DEFAULT_PIECE_SET}
+        className="min-h-0 flex-1 border-x-0 border-t-0"
+        {editMode}
+        {selectable}
+      />
+    </div>
+  </div>
+
+  <div
+    class="order-1 flex w-full max-w-[38rem] shrink-0 flex-col gap-2 lg:order-1 lg:min-h-0"
+  >
+    <div class="w-full shrink-0">
+      <Chessboard facade={chessboard} />
+    </div>
+    {@render belowChessboard?.()}
+  </div>
+</div>

package/dist/puzzle-creation/PuzzleBoardTreeViewerPane.svelte.d.ts

@@ -0,0 +1,51 @@
+import type { Snippet } from "svelte";
+import type { BoardApi } from "@connectorvol/chessboard";
+import type { ChessTree } from "@connectorvol/tree";
+/**
+ * Представляет свойства панели разметки «доска и просмотр дерева партии».
+ */
+interface Props {
+    /**
+     * Возвращает API шахматной доски для компонента `Chessboard`.
+     */
+    chessboard: BoardApi;
+    /**
+     * Возвращает экземпляр дерева ходов для `TreeViewer`.
+     */
+    chessTree: ChessTree;
+    /**
+     * Возвращает обработчик выбора узла в дереве.
+     */
+    onSelectNode: () => void;
+    /**
+     * Возвращает обработчик после удаления варианта.
+     */
+    onDeleteVariant: () => void;
+    /**
+     * Возвращает функцию установки FEN в движке партии.
+     */
+    setChessFen: (fen: string) => void;
+    /**
+     * Возвращает функцию синхронизации FEN и UI доски.
+     */
+    setChessboardFen: (animationTime?: number) => void;
+    /**
+     * Возвращает признак режима правки дерева (`TreeViewer.editMode`).
+     */
+    editMode?: boolean;
+    /**
+     * Возвращает признак возможности выбора узлов в дереве.
+     */
+    selectable?: boolean;
+    /**
+     * Возвращает дополнительные классы Tailwind для корневого контейнера.
+     */
+    class?: string;
+    /**
+     * Возвращает фрагмент разметки под шахматной доской (например сообщение об ошибке в превью).
+     */
+    belowChessboard?: Snippet;
+}
+declare const PuzzleBoardTreeViewerPane: import("svelte").Component<Props, {}, "">;
+type PuzzleBoardTreeViewerPane = ReturnType<typeof PuzzleBoardTreeViewerPane>;
+export default PuzzleBoardTreeViewerPane;

package/dist/puzzle-creation/PuzzleCreationWizard.svelte

@@ -8,7 +8,6 @@
   import StepMoves from "./StepMoves.svelte";
   import StepPosition from "./StepPosition.svelte";
   import StepPreview from "./StepPreview.svelte";
-  import { DEFAULT_EDITABLE_BOARD_SETTINGS } from "../constants/editable-board-settings.js";
   import type { TPuzzleCreationWizardProps } from "./types.js";
   import {
     createEmptyTreeFromFen,
@@ -17,15 +16,11 @@
   } from "../puzzle/puzzleData.js";
   import { PgnOps } from "@connectorvol/chessops/pgnOps.svelte";
   import { ChessTree, createPgnFromTree } from "@connectorvol/tree";
-  import {
-    CHESSBOARD_THEMES,
-    createBoardApi,
-    DEFAULT_BOARD_SETTINGS,
-    Draggable,
-    type IChessBoardActions,
-  } from "@connectorvol/chessboard";
+  import { CHESSBOARD_THEMES, Draggable, type IChessBoardActions } from "@connectorvol/chessboard";
   import { calculatePly, Color, Square } from "@connectorvol/shared";
 
+  import { createPuzzleLineEditingBoardApi } from "./createPuzzleLineEditingBoard.js";
+
   const {
     onPuzzleCreated,
     fen: fenProp,
@@ -41,14 +36,6 @@
     return t ? t : undefined;
   }
 
-  /**
-   * Представляет извлечение признака стороны, имеющей ход, из полной строки FEN.
-   */
-  function sideToMoveFromFullFen(fullFen: string): Color {
-    const token = fullFen.trim().split(/\s+/)[1];
-    return token === "b" ? Color.BLACK : Color.WHITE;
-  }
-
   let step = $state<1 | 2 | 3>(1);
   let puzzleData = $derived<PuzzleData>(
     createInitialPuzzleData(wizardSeedFen(fenProp)),
@@ -130,29 +117,9 @@
    * Представляет сборку доски для шага построения линии: позиция и ориентация по стороне хода в FEN.
    */
   function createMainChessboard(fullFen: string) {
-    const side = sideToMoveFromFullFen(fullFen);
-    const {
-      boardSize: _boardSize,
-      orientation: _orientation,
-      draggable: _draggable,
-      ...appearanceSettings
-    } = (boardAppearanceSettings ?? {}) as Record<string, unknown> & {
-      boardSize?: unknown;
-      orientation?: unknown;
-      draggable?: unknown;
-    };
-    return createBoardApi({
-      fen: fullFen,
-      settings: {
-        ...DEFAULT_BOARD_SETTINGS,
-        ...(appearanceSettings as typeof DEFAULT_BOARD_SETTINGS),
-        boardSize: DEFAULT_EDITABLE_BOARD_SETTINGS.boardSize,
-        isResizable: false,
-        orientation: side,
-        draggable: side === Color.WHITE ? Draggable.WHITE : Draggable.BLACK,
-      },
-      actions,
-      theme: boardTheme ?? CHESSBOARD_THEMES.blue,
+    return createPuzzleLineEditingBoardApi(fullFen, actions, {
+      boardTheme: boardTheme ?? CHESSBOARD_THEMES.blue,
+      boardAppearanceSettings,
     });
   }