@connectorvol/chess-widgets 8.0.0 → 9.0.0

package/dist/puzzle-creation/createPuzzleLineEditingBoard.js

@@ -1,6 +1,6 @@
-import { CHESSBOARD_THEMES, createBoardApi, DEFAULT_BOARD_SETTINGS, Draggable, } from "@connectorvol/chessboard";
+import { CHESSBOARD_THEMES, createBoardApi, DEFAULT_DESIGN_SETTINGS, Draggable, } from "@connectorvol/chessboard";
 import { Color } from "@connectorvol/shared";
-import { DEFAULT_EDITABLE_BOARD_SETTINGS } from "../constants/editable-board-settings.js";
+import { buildPuzzleWizardBoardSettings } from "./buildPuzzleWizardBoardSettings.js";
 /**
  * Представляет определение стороны хода по полному FEN.
  */
@@ -11,21 +11,25 @@ export function sideToMoveFromFullFen(fullFen) {
 /**
  * Представляет создание API доски для интерактивного построения линии (как в мастере задач):
  * ориентация и перетаскивание по стороне хода, фиксированный размер доски.
+ * Возвращает пару `{ api, design }` — `design` следует передать в `<Chessboard design={...} />`,
+ * чтобы доска разделяла снимок с превью/настройками через контекст.
  */
-export function createPuzzleLineEditingBoardApi(fullFen, actions, opts = {}) {
+export function createPuzzleLineEditingBoardApi(fullFen, actions, opts) {
     const side = sideToMoveFromFullFen(fullFen);
-    const { boardSize: _boardSize, orientation: _orientation, draggable: _draggable, ...appearanceSettings } = (opts.boardAppearanceSettings ?? {});
-    return createBoardApi({
+    const { play, design } = buildPuzzleWizardBoardSettings(opts.boardAppearanceSettings);
+    const api = createBoardApi({
         fen: fullFen,
-        settings: {
-            ...DEFAULT_BOARD_SETTINGS,
-            ...appearanceSettings,
-            boardSize: DEFAULT_EDITABLE_BOARD_SETTINGS.boardSize,
-            isResizable: false,
+        playSettings: {
+            ...play,
             orientation: side,
             draggable: side === Color.WHITE ? Draggable.WHITE : Draggable.BLACK,
         },
         actions,
-        theme: opts.boardTheme ?? CHESSBOARD_THEMES.blue,
     });
+    const finalDesign = {
+        ...DEFAULT_DESIGN_SETTINGS,
+        ...design,
+        theme: opts.boardTheme ?? CHESSBOARD_THEMES.blue,
+    };
+    return { api, design: finalDesign };
 }

package/dist/puzzle-creation/puzzleWizardState.d.ts

@@ -0,0 +1,35 @@
+import { type PuzzleData } from "../puzzle/puzzleData.js";
+import type { TPuzzleTags } from "../puzzle/puzzleCreatedPayload.js";
+import type { TWizardStep } from "@connectorvol/shared";
+/**
+ * Представляет базовый state мастера: поля, которые используют шаги 1–3.
+ */
+export type TPuzzleWizardCoreState = {
+    /** Возвращает данные задачи (FEN и главная линия SAN). */
+    puzzleData: PuzzleData;
+    /** Возвращает PGN дерева решения для превью на шаге 3. */
+    solutionPgn: string;
+};
+/**
+ * Представляет расширенный state мастера с полем тегов для шага `PuzzleWizardTagsStep`.
+ */
+export type TPuzzleWizardState = TPuzzleWizardCoreState & {
+    /** Возвращает выбранные теги задачи. */
+    puzzleTags: TPuzzleTags;
+};
+/** Возвращает базовые шаги мастера: позиция, ходы, превью. */
+export declare const PUZZLE_WIZARD_CORE_STEPS: readonly TWizardStep[];
+/** Возвращает описание опционального шага выбора тегов. */
+export declare const PUZZLE_WIZARD_TAGS_STEP: TWizardStep;
+/**
+ * Представляет создание базового state мастера из seed FEN.
+ */
+export declare function createInitialPuzzleWizardCoreState(seedFen: string | undefined): TPuzzleWizardCoreState;
+/**
+ * Представляет создание расширенного state мастера с тегами из seed FEN.
+ */
+export declare function createInitialPuzzleWizardState(seedFen: string | undefined): TPuzzleWizardState;
+/**
+ * Представляет нормализацию входного FEN (пустая строка трактуется как отсутствие значения).
+ */
+export declare function puzzleWizardSeedFen(prop: string | undefined): string | undefined;

package/dist/puzzle-creation/puzzleWizardState.js

@@ -0,0 +1,37 @@
+import { createInitialPuzzleData, } from "../puzzle/puzzleData.js";
+/** Возвращает базовые шаги мастера: позиция, ходы, превью. */
+export const PUZZLE_WIZARD_CORE_STEPS = [
+    { id: "position", title: "Позиция" },
+    { id: "moves", title: "Ходы" },
+    { id: "preview", title: "Превью" },
+];
+/** Возвращает описание опционального шага выбора тегов. */
+export const PUZZLE_WIZARD_TAGS_STEP = {
+    id: "tags",
+    title: "Теги",
+};
+/**
+ * Представляет создание базового state мастера из seed FEN.
+ */
+export function createInitialPuzzleWizardCoreState(seedFen) {
+    return {
+        puzzleData: createInitialPuzzleData(seedFen),
+        solutionPgn: "",
+    };
+}
+/**
+ * Представляет создание расширенного state мастера с тегами из seed FEN.
+ */
+export function createInitialPuzzleWizardState(seedFen) {
+    return {
+        ...createInitialPuzzleWizardCoreState(seedFen),
+        puzzleTags: { tactics: [] },
+    };
+}
+/**
+ * Представляет нормализацию входного FEN (пустая строка трактуется как отсутствие значения).
+ */
+export function puzzleWizardSeedFen(prop) {
+    const t = prop?.trim();
+    return t ? t : undefined;
+}

package/dist/puzzle-creation/types.d.ts

@@ -1,9 +1,15 @@
+import type { Snippet } from "svelte";
 import type { TPuzzleCreatedPayload } from "../puzzle/puzzleCreatedPayload.js";
-import type { ChessBoardSettings, ChessboardTheme } from "@connectorvol/chessboard";
+import type { TWizardStep, TWizardStepContext } from "@connectorvol/shared";
+import type { TPuzzleWizardCoreState } from "./puzzleWizardState.js";
+import type { ChessboardTheme, TChessBoardDesignSettings, TChessBoardPlaySettings } from "@connectorvol/chessboard";
 /**
  * Представляет тип визуальных настроек шахматной доски для мастера создания задачи.
  */
-export type TChessboardAppearanceSettings = Omit<Partial<ChessBoardSettings>, "boardSize" | "orientation" | "draggable">;
+export type TChessboardAppearanceSettings = {
+    play?: Omit<TChessBoardPlaySettings, "boardSize" | "orientation" | "draggable">;
+    design?: Partial<TChessBoardDesignSettings>;
+};
 /**
  * Представляет исход решения или ошибки в превью задачи для колбэка `onOutcome`.
  */
@@ -41,6 +47,14 @@ export interface TPuzzlePgnBoardTreeEditorProps {
      * Возвращает дополнительные визуальные настройки шахматной доски (кроме `boardSize`, `orientation`, `draggable`).
      */
     boardAppearanceSettings?: TChessboardAppearanceSettings;
+    /**
+     * Возвращает начальный размер доски в rem (применяется только при создании API доски).
+     */
+    boardSize?: number;
+    /**
+     * Возвращает колбэк после завершения изменения размера доски перетаскиванием ручки resize.
+     */
+    onResizeAction?: (size: number) => void;
     /**
      * Возвращает дополнительные классы Tailwind для корневого контейнера раскладки.
      */
@@ -49,11 +63,19 @@ export interface TPuzzlePgnBoardTreeEditorProps {
 /**
  * Представляет свойства компонента мастера создания шахматной задачи.
  */
-export interface TPuzzleCreationWizardProps {
+export type TPuzzleCreationWizardProps<S extends TPuzzleWizardCoreState = TPuzzleWizardCoreState> = {
     /**
-     * Возвращает функцию, вызываемую при завершении мастера с FEN и строкой ходов.
+     * Возвращает общий state визарда (двухсторонняя привязка; инициализация и сброс — на стороне родителя).
+     */
+    wizardState: S;
+    /**
+     * Возвращает функцию, вызываемую при завершении мастера с FEN и строкой ходов (шаг 3 без доп. шагов).
      */
     onPuzzleCreated: (payload: TPuzzleCreatedPayload) => void;
+    /**
+     * Возвращает колбэк завершения с финальным state (вызывается из `wizard.done()` на доп. шагах).
+     */
+    onDone?: (state: S) => void;
     /**
      * Возвращает начальный полный FEN для шага 1; если не задан — пустая доска.
      */
@@ -66,4 +88,12 @@ export interface TPuzzleCreationWizardProps {
      * Возвращает дополнительные визуальные настройки шахматной доски (кроме `boardSize`, `orientation`, `draggable`).
      */
     boardAppearanceSettings?: TChessboardAppearanceSettings;
-}
+    /**
+     * Возвращает дополнительные шаги после превью (для индикатора прогресса и навигации).
+     */
+    additionalSteps?: readonly TWizardStep[];
+    /**
+     * Возвращает snippet содержимого дополнительных шагов (вызывается при `currentStep > 3`).
+     */
+    additionalStep?: Snippet<[TWizardStepContext<S>]>;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connectorvol/chess-widgets",
-  "version": "8.0.0",
+  "version": "9.0.0",
   "private": false,
   "files": [
     "dist",
@@ -29,7 +29,7 @@
     "start": "vite",
     "dev": "vite",
     "build": "vite build",
-    "preview": "vite preview",
+    "preview": "bun build/index.js",
     "package": "svelte-kit sync && svelte-package && bun pm pack",
     "publish": "bun publish --access public",
     "prepublishOnly": "bun pm pack",
@@ -37,27 +37,28 @@
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "format": "oxfmt --write . && prettier --write \"**/*.svelte\"",
     "prettier": "prettier --write \"**/*.svelte\"",
-    "test": "",
+    "test": "vitest run",
     "test:e2e": "node node_modules/@playwright/test/cli.js test",
     "test:e2e:ui": "node node_modules/@playwright/test/cli.js test --ui"
   },
   "dependencies": {
-    "@connectorvol/chessboard": "8.0.0",
-    "@connectorvol/chessops": "8.0.0",
-    "@connectorvol/shared": "8.0.0",
-    "@connectorvol/tree": "8.0.0",
+    "@connectorvol/chessboard": "9.0.0",
+    "@connectorvol/chessops": "9.0.0",
+    "@connectorvol/shared": "9.0.0",
+    "@connectorvol/tree": "9.0.0",
     "bits-ui": "2.16.4",
-    "clsx": "^2.1.1",
-    "svelte-toolbelt": "^0.10.6",
+    "clsx": "2.1.1",
+    "svelte-toolbelt": "0.10.6",
     "tailwind-merge": "3.3.1",
-    "tailwind-variants": "^3.2.2"
+    "tailwind-variants": "3.2.2"
   },
   "devDependencies": {
+    "@connectorvol/chess-shadcn": "9.0.0",
     "@ianvs/prettier-plugin-sort-imports": "4.5.1",
-    "@lucide/svelte": "^1.16.0",
-    "@playwright/test": "1.54.1",
-    "@sveltejs/adapter-static": "3.0.10",
-    "@sveltejs/kit": "2.48.0",
+    "@lucide/svelte": "1.21.0",
+    "@testing-library/svelte": "5.3.1",
+    "@vitest/coverage-v8": "3.2.4",
+    "@sveltejs/kit": "2.49.1",
     "@sveltejs/package": "2.4.0",
     "@sveltejs/vite-plugin-svelte": "7.0.0",
     "@tailwindcss/forms": "0.5.10",
@@ -65,16 +66,18 @@
     "@tailwindcss/typography": "0.5.16",
     "@tailwindcss/vite": "4.1.11",
     "autoprefixer": "10.4.21",
-    "svelte-check": "4.3.2",
+    "svelte-adapter-bun": "^1.0.1",
+    "svelte-check": "4.6.0",
     "tailwindcss": "4.1.11",
     "tw-animate-css": "1.4.0",
     "typescript": "6.0.2",
+    "vitest": "4.0.17",
     "vite": "8.0.7",
     "vite-plugin-checker": "0.12.0",
     "vite-plugin-svelte-checker": "0.1.2"
   },
   "peerDependencies": {
-    "@lucide/svelte": "^1.16.0",
-    "svelte": "^5.53.12"
+    "@lucide/svelte": "1.21.0",
+    "svelte": "5.56.3"
   }
 }