@js-gamifications/word-search-react 1.0.1

package/README.md

@@ -0,0 +1,28 @@
+# @js-gamifications/word-search-react
+
+React adapter for the word search core package.
+
+## Install
+
+```bash
+npm i @js-gamifications/word-search-react
+```
+
+`@js-gamifications/word-search-core` is installed automatically as a dependency.
+
+## Usage
+
+```tsx
+import { WordSearchBoard } from "@js-gamifications/word-search-react";
+
+export function App() {
+  return (
+    <WordSearchBoard
+      rows={10}
+      cols={10}
+      words={["react", "hooks", "state"]}
+      allowDiagonal
+    />
+  );
+}
+```

package/dist/index.d.mts

@@ -0,0 +1,35 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { WordSearchPuzzle } from '@js-gamifications/word-search-core';
+
+interface WordSearchCompletionReport {
+    elapsedSeconds: number;
+    foundWords: number;
+    totalWords: number;
+    rows: number;
+    cols: number;
+    allowDiagonal: boolean;
+    completedAt: string;
+}
+interface WordSearchBoardProps {
+    /** Number of rows in the generated puzzle grid. */
+    rows: number;
+    /** Number of columns in the generated puzzle grid. */
+    cols: number;
+    /** Input words to place in the puzzle. */
+    words: string[];
+    /** Enables diagonal word placement in the generator. */
+    allowDiagonal?: boolean;
+    /** Optional className applied to the root container. */
+    className?: string;
+    /** Callback fired whenever a new puzzle is generated. */
+    onGenerated?: (puzzle: WordSearchPuzzle) => void;
+    /** Callback fired when the player completes the puzzle. */
+    onCompleted?: (report: WordSearchCompletionReport) => void;
+}
+/**
+ * Interactive word-search board component with drag selection,
+ * progress tracking, timer, sounds, and localized labels.
+ */
+declare function WordSearchBoard(props: WordSearchBoardProps): react_jsx_runtime.JSX.Element;
+
+export { WordSearchBoard, type WordSearchBoardProps };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { WordSearchPuzzle } from '@js-gamifications/word-search-core';
+
+interface WordSearchCompletionReport {
+    elapsedSeconds: number;
+    foundWords: number;
+    totalWords: number;
+    rows: number;
+    cols: number;
+    allowDiagonal: boolean;
+    completedAt: string;
+}
+interface WordSearchBoardProps {
+    /** Number of rows in the generated puzzle grid. */
+    rows: number;
+    /** Number of columns in the generated puzzle grid. */
+    cols: number;
+    /** Input words to place in the puzzle. */
+    words: string[];
+    /** Enables diagonal word placement in the generator. */
+    allowDiagonal?: boolean;
+    /** Optional className applied to the root container. */
+    className?: string;
+    /** Callback fired whenever a new puzzle is generated. */
+    onGenerated?: (puzzle: WordSearchPuzzle) => void;
+    /** Callback fired when the player completes the puzzle. */
+    onCompleted?: (report: WordSearchCompletionReport) => void;
+}
+/**
+ * Interactive word-search board component with drag selection,
+ * progress tracking, timer, sounds, and localized labels.
+ */
+declare function WordSearchBoard(props: WordSearchBoardProps): react_jsx_runtime.JSX.Element;
+
+export { WordSearchBoard, type WordSearchBoardProps };