@sudobility/sudojo_lib 0.0.4

package/dist/hooks/useLevelGame.js

@@ -0,0 +1,128 @@
+/**
+ * Hook for fetching and managing game board for a specific level
+ * Handles auth and subscription status with automatic refresh
+ */
+import { useEffect, useMemo, useRef } from 'react';
+import { useSudojoRandomBoard, } from '@sudobility/sudojo_client';
+import { useQueryClient } from '@tanstack/react-query';
+/** Check if response indicates auth is required */
+function isAuthRequired(response, error) {
+    if (response?.success === false &&
+        response.action?.type === 'auth_required') {
+        return true;
+    }
+    if (error && typeof error === 'object') {
+        const err = error;
+        if (err.message?.includes('Account required'))
+            return true;
+    }
+    return false;
+}
+/** Check if response indicates subscription is required */
+function isSubscriptionRequired(response, error) {
+    if (response?.success === false &&
+        response.action?.type === 'subscription_required') {
+        return true;
+    }
+    if (error && typeof error === 'object') {
+        const err = error;
+        if (err.message?.includes('Daily limit reached') ||
+            err.message?.includes('subscription')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Hook for fetching a game board for a specific level
+ *
+ * Automatically refetches when auth token or subscription status changes.
+ * Returns status indicating whether auth or subscription is required.
+ *
+ * @param options - Hook options
+ * @returns Game board data and status
+ *
+ * @example
+ * ```tsx
+ * function LevelPlayPage({ levelId }: { levelId: string }) {
+ *   const { board, status, refetch, nextPuzzle } = useLevelGame({
+ *     networkClient,
+ *     config,
+ *     auth,
+ *     levelId,
+ *     subscriptionActive: subscription.isActive,
+ *   });
+ *
+ *   if (status === 'loading') return <Loading />;
+ *   if (status === 'auth_required') return <AuthRequired onLogin={openAuthModal} />;
+ *   if (status === 'subscription_required') return <SubscriptionPaywall onSuccess={refetch} />;
+ *   if (status === 'error') return <Error />;
+ *
+ *   return <SudokuGame puzzle={board.board} solution={board.solution} />;
+ * }
+ * ```
+ */
+export function useLevelGame(options) {
+    const { networkClient, config, auth, levelId, subscriptionActive = false, enabled = true, } = options;
+    const queryClient = useQueryClient();
+    // Track previous state to detect changes
+    const prevStateRef = useRef({
+        authToken: auth.accessToken,
+        subscriptionActive,
+    });
+    const queryParams = useMemo(() => ({ level_uuid: levelId }), [levelId]);
+    const { data, isLoading, error, refetch } = useSudojoRandomBoard(networkClient, config, auth, queryParams, { enabled: enabled && !!levelId });
+    // Determine status based on response
+    // Cast to SudojoApiResponse to check for action field
+    const apiResponse = data;
+    const status = useMemo(() => {
+        if (isLoading)
+            return 'loading';
+        if (isAuthRequired(apiResponse, error))
+            return 'auth_required';
+        if (isSubscriptionRequired(apiResponse, error))
+            return 'subscription_required';
+        if (error)
+            return 'error';
+        if (apiResponse?.success && apiResponse.data)
+            return 'success';
+        return 'loading';
+    }, [isLoading, apiResponse, error]);
+    const board = useMemo(() => {
+        if (data?.success && data.data) {
+            return data.data;
+        }
+        return null;
+    }, [data]);
+    // Auto-refresh when auth token or subscription status changes
+    useEffect(() => {
+        const prev = prevStateRef.current;
+        const authChanged = prev.authToken !== auth.accessToken;
+        const subscriptionChanged = !prev.subscriptionActive && subscriptionActive;
+        if (authChanged || subscriptionChanged) {
+            queryClient.invalidateQueries({
+                queryKey: ['sudojo', 'boards', 'random'],
+            });
+            refetch();
+        }
+        // Update ref for next comparison
+        prevStateRef.current = { authToken: auth.accessToken, subscriptionActive };
+    }, [auth.accessToken, subscriptionActive, queryClient, refetch]);
+    const nextPuzzle = useMemo(() => {
+        return () => {
+            queryClient.invalidateQueries({
+                queryKey: ['sudojo', 'boards', 'random'],
+            });
+            refetch();
+        };
+    }, [queryClient, refetch]);
+    return {
+        board,
+        status,
+        isLoading,
+        error: error ?? null,
+        refetch: () => refetch(),
+        nextPuzzle,
+    };
+}
+//# sourceMappingURL=useLevelGame.js.map

package/dist/hooks/useLevelGame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLevelGame.js","sourceRoot":"","sources":["../../src/hooks/useLevelGame.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useLevels.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Hook for fetching and managing Sudoku difficulty levels
+ */
+import type { Level } from '@sudobility/sudojo_types';
+import type { NetworkClient } from '@sudobility/types';
+import { type SudojoAuth, type SudojoConfig } from '@sudobility/sudojo_client';
+export interface UseLevelsOptions {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Sudojo API configuration */
+    config: SudojoConfig;
+    /** Auth credentials (optional for public data) */
+    auth?: SudojoAuth;
+    /** Whether to enable the query */
+    enabled?: boolean;
+}
+export interface UseLevelsResult {
+    /** All available levels */
+    levels: Level[];
+    /** Whether levels are loading */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+    /** Refetch levels */
+    refetch: () => void;
+    /** Get level by UUID */
+    getLevelByUuid: (uuid: string) => Level | undefined;
+    /** Get level by index */
+    getLevelByIndex: (index: number) => Level | undefined;
+    /** Levels sorted by index */
+    sortedLevels: Level[];
+    /** Free levels (no subscription required) */
+    freeLevels: Level[];
+    /** Premium levels (subscription required) */
+    premiumLevels: Level[];
+}
+/**
+ * Hook for fetching and managing difficulty levels
+ *
+ * @param options - Hook options
+ * @returns Levels data and utilities
+ *
+ * @example
+ * ```tsx
+ * function LevelSelector() {
+ *   const { levels, isLoading, sortedLevels } = useLevels({
+ *     networkClient,
+ *     config: { baseUrl: 'https://api.sudojo.com' },
+ *   });
+ *
+ *   if (isLoading) return <Loading />;
+ *
+ *   return (
+ *     <ul>
+ *       {sortedLevels.map(level => (
+ *         <li key={level.uuid}>{level.title}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare function useLevels(options: UseLevelsOptions): UseLevelsResult;
+export interface UseLevelOptions {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Sudojo API configuration */
+    config: SudojoConfig;
+    /** Auth credentials (optional for public data) */
+    auth?: SudojoAuth;
+    /** Level UUID to fetch */
+    levelUuid: string;
+    /** Whether to enable the query */
+    enabled?: boolean;
+}
+export interface UseLevelResult {
+    /** The fetched level */
+    level: Level | null;
+    /** Whether level is loading */
+    isLoading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+    /** Refetch level */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching a single level by UUID
+ *
+ * @param options - Hook options
+ * @returns Level data
+ */
+export declare function useLevel(options: UseLevelOptions): UseLevelResult;
+//# sourceMappingURL=useLevels.d.ts.map

package/dist/hooks/useLevels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLevels.d.ts","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EAGlB,MAAM,2BAA2B,CAAC;AAKnC,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,kDAAkD;IAClD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qBAAqB;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,wBAAwB;IACxB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;IACpD,yBAAyB;IACzB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;IACtD,6BAA6B;IAC7B,YAAY,EAAE,KAAK,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,EAAE,KAAK,EAAE,CAAC;IACpB,6CAA6C;IAC7C,aAAa,EAAE,KAAK,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAuDpE;AAED,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,kDAAkD;IAClD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,wBAAwB;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgCjE"}

package/dist/hooks/useLevels.js

@@ -0,0 +1,98 @@
+/**
+ * Hook for fetching and managing Sudoku difficulty levels
+ */
+import { useMemo } from 'react';
+import { useSudojoLevel, useSudojoLevels, } from '@sudobility/sudojo_client';
+/** Default empty auth for public endpoints */
+const DEFAULT_AUTH = { accessToken: '' };
+/**
+ * Hook for fetching and managing difficulty levels
+ *
+ * @param options - Hook options
+ * @returns Levels data and utilities
+ *
+ * @example
+ * ```tsx
+ * function LevelSelector() {
+ *   const { levels, isLoading, sortedLevels } = useLevels({
+ *     networkClient,
+ *     config: { baseUrl: 'https://api.sudojo.com' },
+ *   });
+ *
+ *   if (isLoading) return <Loading />;
+ *
+ *   return (
+ *     <ul>
+ *       {sortedLevels.map(level => (
+ *         <li key={level.uuid}>{level.title}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export function useLevels(options) {
+    const { networkClient, config, auth = DEFAULT_AUTH, enabled = true, } = options;
+    const { data, isLoading, error, refetch } = useSudojoLevels(networkClient, config, auth, { enabled });
+    const levels = useMemo(() => {
+        if (!data?.success || !data.data)
+            return [];
+        return data.data;
+    }, [data]);
+    const sortedLevels = useMemo(() => {
+        return [...levels].sort((a, b) => a.index - b.index);
+    }, [levels]);
+    const freeLevels = useMemo(() => {
+        return sortedLevels.filter(level => !level.requires_subscription);
+    }, [sortedLevels]);
+    const premiumLevels = useMemo(() => {
+        return sortedLevels.filter(level => level.requires_subscription);
+    }, [sortedLevels]);
+    const getLevelByUuid = useMemo(() => {
+        const levelMap = new Map(levels.map(l => [l.uuid, l]));
+        return (uuid) => levelMap.get(uuid);
+    }, [levels]);
+    const getLevelByIndex = useMemo(() => {
+        const indexMap = new Map(levels.map(l => [l.index, l]));
+        return (index) => indexMap.get(index);
+    }, [levels]);
+    return {
+        levels,
+        isLoading,
+        error: error ?? null,
+        refetch: () => {
+            refetch();
+        },
+        getLevelByUuid,
+        getLevelByIndex,
+        sortedLevels,
+        freeLevels,
+        premiumLevels,
+    };
+}
+/**
+ * Hook for fetching a single level by UUID
+ *
+ * @param options - Hook options
+ * @returns Level data
+ */
+export function useLevel(options) {
+    const { networkClient, config, auth = DEFAULT_AUTH, levelUuid, enabled = true, } = options;
+    const { data, isLoading, error, refetch } = useSudojoLevel(networkClient, config, auth, levelUuid, {
+        enabled: enabled && !!levelUuid,
+    });
+    const level = useMemo(() => {
+        if (!data?.success || !data.data)
+            return null;
+        return data.data;
+    }, [data]);
+    return {
+        level,
+        isLoading,
+        error: error ?? null,
+        refetch: () => {
+            refetch();
+        },
+    };
+}
+//# sourceMappingURL=useLevels.js.map

package/dist/hooks/useLevels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLevels.js","sourceRoot":"","sources":["../../src/hooks/useLevels.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useLocalStorage.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generic localStorage hook with type safety
+ */
+/**
+ * Hook for persisting state to localStorage
+ *
+ * @param key - localStorage key
+ * @param initialValue - Default value if nothing in storage
+ * @returns [value, setValue, removeValue]
+ *
+ * @example
+ * ```tsx
+ * const [settings, setSettings, removeSettings] = useLocalStorage('app-settings', defaultSettings);
+ *
+ * // Update settings
+ * setSettings({ ...settings, theme: 'dark' });
+ *
+ * // Or use updater function
+ * setSettings(prev => ({ ...prev, theme: 'dark' }));
+ *
+ * // Clear settings
+ * removeSettings();
+ * ```
+ */
+export declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void, () => void];
+//# sourceMappingURL=useLocalStorage.d.ts.map

package/dist/hooks/useLocalStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,GACd,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,IAAI,CAAC,CAoDxD"}

package/dist/hooks/useLocalStorage.js

@@ -0,0 +1,75 @@
+/**
+ * Generic localStorage hook with type safety
+ */
+import { useCallback, useEffect, useState } from 'react';
+/**
+ * Hook for persisting state to localStorage
+ *
+ * @param key - localStorage key
+ * @param initialValue - Default value if nothing in storage
+ * @returns [value, setValue, removeValue]
+ *
+ * @example
+ * ```tsx
+ * const [settings, setSettings, removeSettings] = useLocalStorage('app-settings', defaultSettings);
+ *
+ * // Update settings
+ * setSettings({ ...settings, theme: 'dark' });
+ *
+ * // Or use updater function
+ * setSettings(prev => ({ ...prev, theme: 'dark' }));
+ *
+ * // Clear settings
+ * removeSettings();
+ * ```
+ */
+export function useLocalStorage(key, initialValue) {
+    // Get initial value from localStorage or use default
+    const [storedValue, setStoredValue] = useState(() => {
+        if (typeof window === 'undefined') {
+            return initialValue;
+        }
+        try {
+            const item = window.localStorage.getItem(key);
+            return item ? JSON.parse(item) : initialValue;
+        }
+        catch (error) {
+            console.warn(`Error reading localStorage key "${key}":`, error);
+            return initialValue;
+        }
+    });
+    // Update localStorage when value changes
+    useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        try {
+            window.localStorage.setItem(key, JSON.stringify(storedValue));
+        }
+        catch (error) {
+            console.warn(`Error writing localStorage key "${key}":`, error);
+        }
+    }, [key, storedValue]);
+    // Set value (supports updater function pattern)
+    const setValue = useCallback((value) => {
+        setStoredValue(prev => {
+            const newValue = value instanceof Function ? value(prev) : value;
+            return newValue;
+        });
+    }, []);
+    // Remove from localStorage
+    const removeValue = useCallback(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        try {
+            window.localStorage.removeItem(key);
+            setStoredValue(initialValue);
+        }
+        catch (error) {
+            console.warn(`Error removing localStorage key "${key}":`, error);
+        }
+    }, [key, initialValue]);
+    return [storedValue, setValue, removeValue];
+}
+//# sourceMappingURL=useLocalStorage.js.map

package/dist/hooks/useLocalStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.js","sourceRoot":"","sources":["../../src/hooks/useLocalStorage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,YAAe;IAEf,qDAAqD;IACrD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE;QACrD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;YAChE,OAAO,YAAY,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,yCAAyC;IACzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAEvB,gDAAgD;IAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,KAA2B,EAAE,EAAE;QAC3D,cAAc,CAAC,IAAI,CAAC,EAAE;YACpB,MAAM,QAAQ,GAAG,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACjE,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,2BAA2B;IAC3B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;QACnC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACpC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,oCAAoC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAExB,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC"}

package/dist/hooks/useSudoku.d.ts

@@ -0,0 +1,125 @@
+/**
+ * useSudoku hook - Main game state management
+ *
+ * Ported from renderable/sudokuschool/interactors/sudoku/SudokuInteractor.kt
+ *
+ * Handles:
+ * - Board initialization with scrambling
+ * - Cell selection
+ * - Value input (normal and pencil modes)
+ * - Error detection
+ * - Game completion detection
+ * - Undo functionality
+ * - Auto pencilmarks generation
+ */
+import { PlayingSource, SudokuAppSettings, SudokuBoard, SudokuCell, SudokuPlay } from '../types/sudoku';
+export interface UseSudokuOptions {
+    /** Initial app settings */
+    appSettings?: Partial<SudokuAppSettings>;
+}
+export interface UseSudokuResult {
+    /** Current play state (null if no board loaded) */
+    play: SudokuPlay | null;
+    /** Current board (shortcut to play.board) */
+    board: SudokuBoard | null;
+    /** Currently selected cell */
+    selectedCell: SudokuCell | null;
+    /** Selected cell index */
+    selectedIndex: number | null;
+    /** Whether pencil mode is active */
+    isPencilMode: boolean;
+    /** Whether game is completed */
+    isCompleted: boolean;
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** App settings */
+    appSettings: SudokuAppSettings;
+    /** Digit mapping (original -> scrambled) */
+    digitMapping: Map<number, number>;
+    /** Reverse digit mapping (scrambled -> original) */
+    reverseDigitMapping: Map<number, number>;
+    /** Cells with errors (when showErrors is enabled) */
+    errorCells: SudokuCell[];
+    /** Count of errors */
+    errorCount: number;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Cells with the same value as selected cell */
+    sameValueCells: SudokuCell[];
+    /** Related cells (same row, column, block) */
+    relatedCells: SudokuCell[];
+    /** Load a new board */
+    loadBoard: (puzzle: string, solution: string, options?: {
+        scramble?: boolean;
+        symmetrical?: boolean;
+        source?: PlayingSource;
+        levelUuid?: string;
+        boardUuid?: string;
+    }) => void;
+    /** Select a cell by index */
+    selectCell: (index: number) => void;
+    /** Select a cell by row and column */
+    selectCellAt: (row: number, column: number) => void;
+    /** Deselect the current cell */
+    deselectCell: () => void;
+    /** Input a value (1-9) into the selected cell */
+    input: (value: number) => void;
+    /** Erase the selected cell */
+    erase: () => void;
+    /** Toggle pencil mode */
+    togglePencilMode: () => void;
+    /** Set pencil mode */
+    setPencilMode: (enabled: boolean) => void;
+    /** Undo the last action */
+    undo: () => void;
+    /** Generate auto pencilmarks */
+    autoPencilmarks: () => void;
+    /** Update app settings */
+    updateSettings: (settings: Partial<SudokuAppSettings>) => void;
+    /** Reset the game to initial state */
+    reset: () => void;
+    /** Apply hint data from solver API response */
+    applyHintData: (userInput: string, pencilmarks: string | null, autoPencilmarks: boolean) => void;
+    /** Get board state as string */
+    getBoardString: () => string;
+    /** Get original puzzle string */
+    getOriginalPuzzle: () => string;
+    /** Get input string (user entries only) */
+    getInputString: () => string;
+    /** Get pencilmarks string */
+    getPencilmarksString: () => string;
+}
+/**
+ * Main Sudoku game hook
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   play,
+ *   board,
+ *   selectedCell,
+ *   isPencilMode,
+ *   isCompleted,
+ *   loadBoard,
+ *   selectCell,
+ *   input,
+ *   togglePencilMode,
+ *   undo,
+ * } = useSudoku();
+ *
+ * // Load a puzzle
+ * loadBoard(puzzleString, solutionString, { scramble: true });
+ *
+ * // Select a cell and enter a value
+ * selectCell(0);
+ * input(5);
+ *
+ * // Toggle pencil mode
+ * togglePencilMode();
+ * input(1); // Adds 1 as pencilmark
+ * input(2); // Adds 2 as pencilmark
+ * input(1); // Removes 1 from pencilmarks
+ * ```
+ */
+export declare function useSudoku(options?: UseSudokuOptions): UseSudokuResult;
+//# sourceMappingURL=useSudoku.d.ts.map

package/dist/hooks/useSudoku.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSudoku.d.ts","sourceRoot":"","sources":["../../src/hooks/useSudoku.ts"],"names":[],"mappings":"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"}