react-chess-puzzle-kit 1.0.0

package/dist/stories/AnalysisBoard.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { AnalysisBoard } from '../features/analysis/defaults/AnalysisBoard';
+declare const meta: Meta<typeof AnalysisBoard>;
+export default meta;
+type Story = StoryObj<typeof AnalysisBoard>;
+export declare const Default: Story;
+export declare const LightTheme: Story;
+/** Requires `npm run copy:stockfish` so WASM is served from `public/stockfish/`. */
+export declare const WithStockfishEngine: Story;

package/dist/stories/HighlightChessboard.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { HighlightChessboard } from 'react-chess-core';
+declare const meta: Meta<typeof HighlightChessboard>;
+export default meta;
+type Story = StoryObj<typeof HighlightChessboard>;
+export declare const Default: Story;
+export declare const KingInCheck: Story;
+export declare const WithHint: Story;
+export declare const IncorrectMove: Story;

package/dist/stories/PuzzleBoard.stories.d.ts

@@ -0,0 +1,6 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { PuzzleBoard } from '../features/board/PuzzleBoard';
+declare const meta: Meta<typeof PuzzleBoard>;
+export default meta;
+type Story = StoryObj<typeof PuzzleBoard>;
+export declare const Default: Story;

package/dist/stories/PuzzleBoardWithControls.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { PuzzleBoardWithControls } from '../features/board/PuzzleBoardWithControls';
+declare const meta: Meta<typeof PuzzleBoardWithControls>;
+export default meta;
+type Story = StoryObj<typeof PuzzleBoardWithControls>;
+export declare const Default: Story;
+export declare const MultiplePuzzles: Story;
+/** Default controls + default analysis modal, sidebar, and engine panel. */
+export declare const AllLibraryDefaults: Story;

package/dist/stories/analysisFixtures.d.ts

@@ -0,0 +1,4 @@
+export declare const samplePuzzleFen = "r6k/pp2r2p/4Rp1Q/3p4/8/1N1P2R1/PqP2bPP/7K b - - 0 24";
+export declare const samplePuzzleMoves: string[];
+/** Completed puzzle snapshot for analysis stories. */
+export declare const createSampleAnalysisContext: () => import("../features/analysis/core/analysisContext").PuzzleAnalysisContext;

package/dist/stories/regressions/PuzzleRegressions.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta } from '@storybook/react';
+import { PuzzleBoardWithControls, PuzzleBoardWithControlsProps } from '../../features/board/PuzzleBoardWithControls';
+declare const meta: Meta<typeof PuzzleBoardWithControls>;
+export default meta;
+export declare const WrongLegalCaptureShouldFail: import("@storybook/csf").StoryAnnotations<import("@storybook/react").ReactRenderer, PuzzleBoardWithControlsProps>;
+export declare const DualCheckmateAccepted: import("@storybook/csf").StoryAnnotations<import("@storybook/react").ReactRenderer, PuzzleBoardWithControlsProps>;
+export declare const WrongCaptureWhileInCheckShouldFail: import("@storybook/csf").StoryAnnotations<import("@storybook/react").ReactRenderer, PuzzleBoardWithControlsProps>;

package/dist/stories/regressions/StockfishAnalysisRegressions.stories.d.ts

@@ -0,0 +1,7 @@
+import { Meta, StoryObj } from '@storybook/react';
+import { AnalysisBoard } from '../../features/analysis/defaults/AnalysisBoard';
+declare const meta: Meta<typeof AnalysisBoard>;
+export default meta;
+type Story = StoryObj<typeof AnalysisBoard>;
+/** Puzzle 66abad1bcb8d6163fd6e172a — rapid clicks through every main-line move. */
+export declare const Move3Ke6DuringAnalysis: Story;

package/dist/stories/regressions/fixtures.d.ts

@@ -0,0 +1,18 @@
+export interface PuzzleRegression {
+    /** Story name shown in Storybook. */
+    name: string;
+    /** The edge case and the expected behavior, for the story docs. */
+    description: string;
+    /** Source puzzle id (endchess) for traceability. */
+    sourceId: string;
+    /** Starting FEN as stored for the puzzle. */
+    fen: string;
+    /** Space-separated UCI solution moves (first move is played automatically). */
+    moves: string;
+}
+/**
+ * Real puzzles that previously exposed bugs, captured so the scenarios can be
+ * reproduced in Storybook. Add an entry here and a matching story export in
+ * `PuzzleRegressions.stories.tsx`.
+ */
+export declare const PUZZLE_REGRESSIONS: Record<string, PuzzleRegression>;

package/dist/stories/regressions/regressionAnalysisContext.d.ts

@@ -0,0 +1,5 @@
+import { PuzzleRegression } from './fixtures';
+/** Main-line sidebar labels (`Start`, `1. e4`, …) for a regression puzzle. */
+export declare const getRegressionMainLineLabels: (regression: PuzzleRegression) => string[];
+/** Completed puzzle snapshot for analysis regression stories. */
+export declare const createRegressionAnalysisContext: (regression: PuzzleRegression) => import("../../features/analysis/core/analysisContext").PuzzleAnalysisContext;

package/dist/stories/storybookLayout.d.ts

@@ -0,0 +1,4 @@
+import { AnalysisLayoutConfig } from 'react-chess-core';
+/** Smaller boards for Storybook previews (production defaults stay at 480+). */
+export declare const STORYBOOK_BOARD_WIDTH = 360;
+export declare const STORYBOOK_ANALYSIS_LAYOUT: AnalysisLayoutConfig;

package/dist/stories/withChessboardDnD.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+/** Required by react-chessboard when rendering squares outside PuzzleBoard / AnalysisChessboardView. */
+declare const withChessboardDnD: (Story: React.ComponentType) => React.JSX.Element;
+export default withChessboardDnD;

package/dist/stories/withDefaultPuzzleControls.d.ts

@@ -0,0 +1,7 @@
+import { Decorator } from '@storybook/react';
+/**
+ * Supplies {@link defaultRenderControls} when a story omits `renderControls`.
+ * Use on `PuzzleBoardWithControls` stories for the library default button row.
+ */
+export declare const withDefaultPuzzleControls: Decorator;
+export default withDefaultPuzzleControls;

package/dist/stories/withThemeProvider.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const withThemeProvider: (Story: React.ComponentType, context: any) => React.JSX.Element;
+export default withThemeProvider;

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "react-chess-puzzle-kit",
+  "version": "1.0.0",
+  "description": "React chess puzzle kit: play, controls, analysis, and browser Stockfish for endchess.training and other apps",
+  "license": "MIT",
+  "author": "Robert Blackwell",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reblackwell3/react-chess-puzzle-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/reblackwell3/react-chess-puzzle-kit/issues"
+  },
+  "homepage": "https://github.com/reblackwell3/react-chess-puzzle-kit#readme",
+  "keywords": [
+    "react",
+    "chess",
+    "chess.js",
+    "chess puzzle",
+    "puzzle",
+    "analysis",
+    "stockfish",
+    "react-chessboard",
+    "chessboard",
+    "drag and drop"
+  ],
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "copy:stockfish": "node scripts/copy-stockfish.mjs",
+    "prepare": "rollup -c",
+    "prestorybook": "npm run copy:stockfish",
+    "test": "jest --config jest.config.cjs",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build",
+    "serve-storybook": "serve storybook-static",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chess.js": "^1.0.0-beta.8",
+    "rollup": "^4.22.2",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rollup-plugin-typescript2": "^0.36.0",
+    "typescript": "^5.6.2"
+  },
+  "peerDependencies": {
+    "chess.js": "^1.0.0-beta.8",
+    "react": "^18.3.1",
+    "react-chess-core": "^0.1.0",
+    "react-chessboard": "^4.7.1"
+  },
+  "devDependencies": {
+    "@chromatic-com/storybook": "^1.9.0",
+    "@rollup/plugin-commonjs": "^26.0.1",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@storybook/addon-essentials": "^8.2.9",
+    "@storybook/addon-interactions": "^8.2.9",
+    "@storybook/addon-links": "^8.2.9",
+    "@storybook/addon-onboarding": "^8.2.9",
+    "@storybook/blocks": "^8.2.9",
+    "@storybook/preset-typescript": "^3.0.0",
+    "@storybook/react": "^8.2.9",
+    "@storybook/react-vite": "^8.2.9",
+    "@storybook/test": "^8.2.9",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "chess.js": "^1.0.0-beta.8",
+    "jest": "^29.7.0",
+    "react": "^18.3.1",
+    "react-chess-core": "^0.1.0",
+    "react-chessboard": "^4.7.1",
+    "storybook": "^8.2.9",
+    "ts-jest": "^29.2.4",
+    "vite": "^5.4.11",
+    "vite-tsconfig-paths": "^5.0.1"
+  },
+  "optionalDependencies": {
+    "stockfish": "^18.0.7"
+  }
+}