@sudobility/sudojo_lib 0.0.94 → 0.0.96

package/dist/index.d.ts

@@ -8,42 +8,495 @@
  * - Level, technique, and learning data hooks
  * - Teaching/hint integration with solver
  * - Legacy useGame hook for backward compatibility
+ *
+ * ## Hook Architecture
+ *
+ * The hooks form a layered composition pattern:
+ *
+ * **Data hooks** (fetch and cache server data):
+ * - `useLevels` / `useLevel` - Difficulty level data
+ * - `useTechniques` / `useTechnique` - Solving technique data
+ * - `useLearning` / `useLearningItem` - Learning material data
+ *
+ * **Game fetching hooks** (handle auth, subscription, and puzzle loading):
+ * - `useLevelGame` - Fetch a random board for a specific level
+ * - `useDailyGame` - Fetch today's daily puzzle
+ *
+ * **Game state hooks** (manage board state and user interaction):
+ * - `useSudoku` - Primary game state (flat 81-cell array, modern API)
+ * - `useGame` - Legacy game state (2D array, deprecated)
+ * - `useBoardEntry` - Manual puzzle entry mode
+ *
+ * **Feature hooks** (provide specific game features):
+ * - `useHint` - Solver integration for hints (matches Kotlin HintInteractor)
+ * - `useGameTeaching` - Step-by-step teaching with solver
+ * - `useGameTimer` - Elapsed time tracking via ref (no re-renders)
+ * - `useGamePersistence` / `useAutoSave` - localStorage game save/restore
+ * - `useLocalStorage` - Generic typed localStorage hook
+ *
+ * **Orchestration hooks** (combine multiple hooks for app-level features):
+ * - `useGamePlay` - Current game management with Zustand store (daily/play slots)
+ * - `useGameSession` - Server-side gamification (start/finish, points, badges)
+ *
+ * ## Migration Guide
+ *
+ * Legacy exports (prefixed with "Legacy" comments) use the 2D `GameBoard` type
+ * from `useGame`. New code should use `useSudoku` with its flat 81-cell
+ * `SudokuBoard` type. See `@deprecated` tags on legacy exports.
+ */
+/**
+ * @deprecated Use `SudokuCell` instead. Part of the legacy `useGame` 2D board API.
  */
 export type { CellPosition, CellState, GameBoard, GameHint, GameMove, GameSettings, GameState, GameStatus, TeachingState, } from './types';
+/** @deprecated Use `DEFAULT_APP_SETTINGS` / `DEFAULT_PLAY_SETTINGS` instead. */
 export { DEFAULT_GAME_SETTINGS } from './types';
-export type { SudokuCell, SudokuBoard, SudokuPlay, SudokuPlaySettings, SudokuAppSettings, SudokuGameState, SudokuDisplay, PlayingSource, } from './types';
-export { DEFAULT_PLAY_SETTINGS, DEFAULT_APP_SETTINGS, createEmptyCell, createEmptyBoard, cellHasError, rowOf, columnOf, blockOf, cellIndex, getRowIndices, getColumnIndices, getBlockIndices, getRelatedIndices, } from './types';
-export type { HintArea, HintCell, HintCellActions, DisplayHintStep, CellDisplayState, PencilmarkDisplayState, UIColorPalette, LinkType, DisplayLink, DisplayCellGroup, } from './types';
+/** Core Sudoku cell and board types using flat 81-cell array representation. */
+export type { 
+/** A single cell in the Sudoku board (indexed 0-80). */
+SudokuCell, 
+/** The Sudoku board containing all 81 cells. */
+SudokuBoard, 
+/** Current play state including board, settings, and selection. */
+SudokuPlay, 
+/** Session settings that can change during play (pencilmarking, auto-pencilmarks). */
+SudokuPlaySettings, 
+/** App-level settings persisted across sessions (showErrors, display format). */
+SudokuAppSettings, 
+/** Full game state including source, history, and digit mapping. */
+SudokuGameState, 
+/** Display modes for Sudoku digits ('NUMERIC' | 'KANJI' | 'COLORS' | 'EMOJIS'). */
+SudokuDisplay, 
+/** Source of the puzzle ('DAILY' | 'CHALLENGE' | 'LEVEL' | 'ENTERED'). */
+PlayingSource, } from './types';
+/** Default settings and cell/board helper functions for the modern Sudoku API. */
+export { 
+/** Default session play settings (pencilmarking off, auto-pencilmarks off). */
+DEFAULT_PLAY_SETTINGS, 
+/** Default app settings (showErrors on, animations on, numeric display). */
+DEFAULT_APP_SETTINGS, 
+/** Create an empty SudokuCell at the given index. */
+createEmptyCell, 
+/** Create an empty 81-cell SudokuBoard. */
+createEmptyBoard, 
+/** Check if a cell has an error (input does not match solution). */
+cellHasError, 
+/** Get row index (0-8) from cell index (0-80). */
+rowOf, 
+/** Get column index (0-8) from cell index (0-80). */
+columnOf, 
+/** Get block index (0-8) from cell index (0-80). */
+blockOf, 
+/** Get cell index (0-80) from row and column. */
+cellIndex, 
+/** Get all cell indices in the same row as the given index. */
+getRowIndices, 
+/** Get all cell indices in the same column as the given index. */
+getColumnIndices, 
+/** Get all cell indices in the same block as the given index. */
+getBlockIndices, 
+/** Get all related cell indices (same row, column, or block) excluding the cell itself. */
+getRelatedIndices, } from './types';
+/** Display and hint visualization types matching the Kotlin renderable layer. */
+export type { 
+/** Highlighted area in a hint (row, column, or block). */
+HintArea, 
+/** Cell display information in a hint step. */
+HintCell, 
+/** Actions to perform on a cell during hint visualization. */
+HintCellActions, 
+/** A single hint step with title, text, areas, cells, links, and groups. */
+DisplayHintStep, 
+/** Complete display state for a single cell (colors, digit, pencilmarks). */
+CellDisplayState, 
+/** Display state for a single pencilmark (digit and color). */
+PencilmarkDisplayState, 
+/** UI color palette with system colors for light or dark mode. */
+UIColorPalette, 
+/** Link type for chain visualization ('strong' | 'weak'). */
+LinkType, 
+/** A link between two cells in a chain (display format). */
+DisplayLink, 
+/** A group of cells for pattern visualization (display format). */
+DisplayCellGroup, } from './types';
+/** Theme and color enums plus predefined light/dark palettes. */
 export { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';
-export type { CompletedPuzzle, GameStats, UserProgress } from './types';
-export { DEFAULT_PROGRESS, PROGRESS_STORAGE_KEY } from './types';
-export type { DigitDisplay, AppSettings } from './types';
-export { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from './types';
-export type { Product, Subscription } from './types';
+/** Types for tracking user puzzle completion and statistics. */
+export type { 
+/** Record of a completed puzzle (id, type, time). */
+CompletedPuzzle, 
+/** Computed game statistics (best times, averages). */
+GameStats, 
+/** Full user progress data (completed puzzles, streak, stats). */
+UserProgress, } from './types';
+export { 
+/** Default empty user progress state. */
+DEFAULT_PROGRESS, 
+/** localStorage key for progress data ('sudojo-progress'). */
+PROGRESS_STORAGE_KEY, } from './types';
+/** Types for application settings. */
+export type { 
+/** Digit display format ('numeric' | 'kanji' | 'emojis'). */
+DigitDisplay, 
+/** Application settings (showErrors, symmetrical, display). */
+AppSettings, } from './types';
+export { 
+/** Default application settings. */
+DEFAULT_SETTINGS, 
+/** localStorage key for settings ('sudojo-settings'). */
+SETTINGS_STORAGE_KEY, } from './types';
+/** Types for RevenueCat subscription management. */
+export type { 
+/** Subscription product information (price, period, trial). */
+Product, 
+/** User subscription status (active, expiration, renewal). */
+Subscription, } from './types';
+/** Default inactive subscription state. */
 export { DEFAULT_SUBSCRIPTION } from './types';
-export type { SavedGameState, GamePersistenceKey } from './types';
-export { GAME_STORAGE_PREFIX, getGameStorageKey } from './types';
-export type { GameSource, CurrentGameMeta, CurrentGame, GameSlot, } from './types';
-export { cloneBoard, countFilledCells, createGameBoard, getBlockCells, getBlockIndex, getBoardStateString, getColumnCells, getEmptyCells, getPencilmarksString, getRelatedCells, getRowCells, isValidPlacement, autoRemovePencilmarks, clearHighlights, countMistakes, getIncorrectCells, getProgressPercentage, isBoardFilled, isCellCorrect, isGameComplete, isValueCorrect, updateCellErrors, updateCellHighlights, validateGameState, } from './utils';
-export type { ScramblerProtocol, SudokuScrambleResult } from './utils';
-export { Scrambler, NonScrambler, scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, } from './utils';
-export type { PresentBoardOptions } from './utils';
-export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, } from './utils';
-export { formatTime, parseTime } from './utils';
-export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, } from './utils';
-export type { ThemePreference, ResolvedTheme } from './utils';
-export { THEME_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './utils';
-export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, } from './utils';
-export { getTechniqueIconUrl } from './utils';
-export { generateDetailedExplanation, getHintActionSummary } from './utils';
-export type { TranslateFunction } from './utils';
-export { getLocalizedHintText } from './utils';
-export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './utils';
-export { displayDigit } from './utils';
-export { useLevel, useLevels, useTechnique, useTechniques, useLearning, useLearningItem, useGame, useSudoku, useGameTeaching, useLevelGame, useDailyGame, useGameTimer, useGamePersistence, useAutoSave, useLocalStorage, useHint, useGamePlay, useBoardEntry, useGameSession, } from './hooks';
-export type { UseLevelOptions, UseLevelResult, UseLevelsOptions, UseLevelsResult, UseTechniqueOptions, UseTechniqueResult, UseTechniquesOptions, UseTechniquesResult, UseLearningItemOptions, UseLearningItemResult, UseLearningOptions, UseLearningResult, UseGameOptions, UseGameResult, UseSudokuOptions, UseSudokuResult, UseGameTeachingOptions, UseGameTeachingResult, UseLevelGameOptions, UseLevelGameResult, UseDailyGameOptions, UseDailyGameResult, GameFetchStatus, UseGameTimerOptions, UseGameTimerResult, UseGamePersistenceOptions, UseGamePersistenceResult, UseHintOptions, UseHintResult, HintBoardData, HintReceivedData, HintAccessError, UseGamePlayOptions, UseGamePlayResult, UseBoardEntryOptions, UseBoardEntryReturn, ValidatedPuzzle, UseGameSessionOptions, GameSessionResult, GameFinishResult, } from './hooks';
+/** Types for saving and restoring game progress to localStorage. */
+export type { 
+/** Saved game state (input, pencilmarks, mode, timestamp). */
+SavedGameState, 
+/** Key identifying a game to persist (type + id). */
+GamePersistenceKey, } from './types';
+export { 
+/** localStorage key prefix for game saves ('sudojo_game_'). */
+GAME_STORAGE_PREFIX, 
+/** Generate a localStorage key from a GamePersistenceKey. */
+getGameStorageKey, } from './types';
+/** Types for the Zustand-backed current game store. */
+export type { 
+/** Source of the current game ('daily' | 'level' | 'entered'). */
+GameSource, 
+/** Navigation metadata for resuming a game (date, level, board info). */
+CurrentGameMeta, 
+/** Full current game state stored in Zustand (puzzle, progress, timing). */
+CurrentGame, 
+/** Which store slot a game lives in ('daily' | 'play'). */
+GameSlot, } from './types';
+/**
+ * @deprecated These utilities work with the legacy 2D `GameBoard` type.
+ * For new code, use `useSudoku` with its flat 81-cell board and the
+ * scrambler/presenter utilities below.
+ */
+export { 
+/** @deprecated Clone a 2D GameBoard. Use useSudoku's immutable state instead. */
+cloneBoard, 
+/** @deprecated Count filled cells in a 2D GameBoard. */
+countFilledCells, 
+/** @deprecated Create a 2D GameBoard from puzzle/solution strings. */
+createGameBoard, 
+/** @deprecated Get cells in a block by block index (2D API). */
+getBlockCells, 
+/** @deprecated Get block index from row/col (2D API). Use blockOf() instead. */
+getBlockIndex, 
+/** @deprecated Get 2D board state as string. Use cellsToStateString() instead. */
+getBoardStateString, 
+/** @deprecated Get cells in a column (2D API). Use getColumnIndices() instead. */
+getColumnCells, 
+/** @deprecated Get empty cells from a 2D GameBoard. */
+getEmptyCells, 
+/** @deprecated Get pencilmarks string from 2D GameBoard. Use cellsToPencilmarksString() instead. */
+getPencilmarksString, 
+/** @deprecated Get related cells (2D API). Use getRelatedIndices() instead. */
+getRelatedCells, 
+/** @deprecated Get cells in a row (2D API). Use getRowIndices() instead. */
+getRowCells, 
+/** @deprecated Check if placement is valid (2D API). */
+isValidPlacement, 
+/** @deprecated Auto-remove pencilmarks (2D API). useSudoku handles this internally. */
+autoRemovePencilmarks, 
+/** @deprecated Clear highlights (2D API). useSudoku handles this via presentBoard(). */
+clearHighlights, 
+/** @deprecated Count mistakes (2D API). Use useSudoku's errorCount instead. */
+countMistakes, 
+/** @deprecated Get incorrect cells (2D API). Use useSudoku's errorCells instead. */
+getIncorrectCells, 
+/** @deprecated Get progress percentage (2D API). Use useSudoku's progress instead. */
+getProgressPercentage, 
+/** @deprecated Check if board is filled (2D API). */
+isBoardFilled, 
+/** @deprecated Check if cell is correct (2D API). Use cellHasError() instead. */
+isCellCorrect, 
+/** @deprecated Check if game is complete (2D API). Use useSudoku's isCompleted instead. */
+isGameComplete, 
+/** @deprecated Check if value is correct (2D API). */
+isValueCorrect, 
+/** @deprecated Update cell errors (2D API). useSudoku handles this automatically. */
+updateCellErrors, 
+/** @deprecated Update cell highlights (2D API). Use presentBoard() instead. */
+updateCellHighlights, 
+/** @deprecated Validate entire game state (2D API). */
+validateGameState, } from './utils';
+/** Types for board scrambling. */
+export type { 
+/** Protocol for board scramblers (Scrambler and NonScrambler implement this). */
+ScramblerProtocol, 
+/** Result of scrambling a board (cells + digit mappings). */
+SudokuScrambleResult, } from './utils';
+/** Board scrambling and puzzle string conversion utilities. */
+export { 
+/** Scrambler that permutes rows, columns, and digits to create unique puzzles. */
+Scrambler, 
+/** Identity scrambler that returns the board unchanged. */
+NonScrambler, 
+/** Scramble a board using a ScramblerProtocol implementation. */
+scrambleSudokuBoard, 
+/** Parse an 81-character puzzle string into SudokuCell array. */
+parsePuzzleString, 
+/** Convert SudokuCell array to puzzle string (given values only). */
+cellsToPuzzleString, 
+/** Convert SudokuCell array to state string (given + input values). */
+cellsToStateString, 
+/** Convert SudokuCell array to input-only string. */
+cellsToInputString, 
+/** Convert SudokuCell array to comma-separated pencilmarks string. */
+cellsToPencilmarksString, } from './utils';
+/** Options type for the presentBoard function. */
+export type { 
+/** Options for generating cell display states (cells, selection, errors, hints). */
+PresentBoardOptions, } from './utils';
+/** Board presentation and color utilities matching the Kotlin renderable layer. */
+export { 
+/** Generate display states for all 81 cells (colors, digits, pencilmarks, hints). */
+presentBoard, 
+/** Process hint step areas and cells into a map of cell hints by index. */
+calculateCellHints, 
+/** Convert a ThemeColor to an actual CSS color string using a palette. */
+themeColorToCSS, 
+/** Get the UIColorPalette for light or dark mode. */
+getColorPalette, 
+/** Get indices of cells containing a specific digit (given or input). */
+getCellsWithDigit, 
+/** Get the digit to highlight based on the selected cell (given or correct input). */
+getSelectedDigit, 
+/** Compute the set of cell indices with the same digit as the selected cell. */
+computeSelectedDigitCells, 
+/** Convert a solver link (row/col pairs) to display format (flat indices). */
+convertSolverLink, 
+/** Convert a solver cell group to display format with ThemeColor. */
+convertSolverCellGroup, 
+/** Convert SudokuColor enum to ThemeColor enum. */
+sudokuColorToTheme, } from './utils';
+/** Time formatting and parsing utilities. */
+export { 
+/** Format seconds into MM:SS or HH:MM:SS string. */
+formatTime, 
+/** Parse a MM:SS or HH:MM:SS string back to total seconds. */
+parseTime, } from './utils';
+/** User progress calculation utilities. */
+export { 
+/** Calculate game statistics (best times, averages) from completed puzzles. */
+calculateStats, 
+/** Calculate current daily streak from completion history. */
+calculateStreak, 
+/** Check if a specific puzzle (by type and id) has been completed. */
+isPuzzleCompleted, 
+/** Get all completed level IDs from completion history. */
+getCompletedLevelIds, 
+/** Get all completed daily dates (YYYY-MM-DD) from completion history. */
+getCompletedDailyDates, } from './utils';
+/** Types for theme preference management. */
+export type { 
+/** Theme preference: 'light' | 'dark' | 'system'. */
+ThemePreference, 
+/** Resolved theme without system option: 'light' | 'dark'. */
+ResolvedTheme, } from './utils';
+/** Theme detection and resolution utilities. */
+export { 
+/** localStorage key for theme preference ('sudojo-theme'). */
+THEME_STORAGE_KEY, 
+/** Detect the system color scheme preference (light/dark). */
+getSystemTheme, 
+/** Resolve a ThemePreference to an actual theme using the system theme. */
+resolveTheme, 
+/** Type guard: check if a value is a valid ThemePreference. */
+isValidThemePreference, } from './utils';
+/** RevenueCat subscription conversion and display utilities. */
+export { 
+/** Convert a RevenueCat package to a Product domain model. */
+convertPackageToProduct, 
+/** Parse RevenueCat CustomerInfo into a Subscription domain model. */
+parseCustomerInfo, 
+/** Get human-readable name for an ISO 8601 subscription period (e.g., 'P1M' -> 'Monthly'). */
+getPeriodDisplayName, 
+/** Check if a subscription period is the "best value" option (annual plans). */
+isBestValuePlan, 
+/** Get a user-friendly error message for a RevenueCat error code. */
+getRevenueCatErrorMessage, } from './utils';
+/** Technique display utilities. */
+export { 
+/** Get the icon URL for a solving technique by its path slug. */
+getTechniqueIconUrl, } from './utils';
+/** Hint explanation generation utilities for teaching users solving techniques. */
+export { 
+/** Generate a detailed explanation for a hint step based on the technique. */
+generateDetailedExplanation, 
+/** Get a short action summary for a hint step (e.g., 'Place 5 in R1C3'). */
+getHintActionSummary, } from './utils';
+/** Types for hint text localization. */
+export type { 
+/** Translation function compatible with i18next's `t` function. */
+TranslateFunction, } from './utils';
+/** Hint localization utilities. */
+export { 
+/** Get localized text for a hint step using a translation function. */
+getLocalizedHintText, } from './utils';
+/** Internationalization key generation and localization utilities. */
+export { 
+/** Get i18n key for a belt name (e.g., 'belts.1.name'). */
+getBeltKey, 
+/** Get localized belt name using a translation function. */
+getLocalizedBeltName, 
+/** Get i18n key for a belt label (e.g., 'belts.1.label'). */
+getBeltLabelKey, 
+/** Get localized belt label (e.g., 'White Belt'). */
+getLocalizedBeltLabel, 
+/** Get i18n key for a level title (e.g., 'levels.3'). */
+getLevelKey, 
+/** Get localized level title using a translation function. */
+getLocalizedLevelTitle, 
+/** Get i18n key for a technique name (e.g., 'techniques.full-house.title'). */
+getTechniqueKey, 
+/** Get localized technique name using a translation function. */
+getLocalizedTechniqueName, } from './utils';
+/** Digit display format conversion. */
+export { 
+/** Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). */
+displayDigit, } from './utils';
+export { 
+/** Fetch a single difficulty level by number. */
+useLevel, 
+/** Fetch all difficulty levels with sorting and filtering utilities. */
+useLevels, 
+/** Fetch a single solving technique by number. */
+useTechnique, 
+/** Fetch all solving techniques with grouping utilities. */
+useTechniques, 
+/** Fetch learning materials with filtering by technique and language. */
+useLearning, 
+/** Fetch a single learning item by UUID. */
+useLearningItem, 
+/**
+ * @deprecated Use `useSudoku` instead. `useGame` uses a legacy 2D array board
+ * representation, while `useSudoku` uses a flat 81-cell array consistent with
+ * the Kotlin renderable layer and the rest of the codebase.
+ */
+useGame, 
+/** Primary game state hook with flat 81-cell board, pencil mode, and scrambling. */
+useSudoku, 
+/** Teaching/hint integration with the solver API (legacy GameHint format). */
+useGameTeaching, 
+/** Fetch a random board for a specific level with auth/subscription handling. */
+useLevelGame, 
+/** Fetch today's daily puzzle with auth/subscription handling. */
+useDailyGame, 
+/** Game timer using refs to avoid re-renders every second. */
+useGameTimer, 
+/** Persist individual game progress to localStorage. */
+useGamePersistence, 
+/** Auto-save game state with debouncing. */
+useAutoSave, 
+/** Generic typed localStorage hook with SSR safety. */
+useLocalStorage, 
+/** Solver hint integration matching Kotlin HintInteractor behavior. */
+useHint, 
+/** Current game management with Zustand store (daily/play slots). */
+useGamePlay, 
+/** Manual puzzle entry mode with solver validation. */
+useBoardEntry, 
+/** Server-side game session management for gamification (points, badges). */
+useGameSession, } from './hooks';
+export type { 
+/** Options for useLevel hook. */
+UseLevelOptions, 
+/** Result type for useLevel hook. */
+UseLevelResult, 
+/** Options for useLevels hook. */
+UseLevelsOptions, 
+/** Result type for useLevels hook. */
+UseLevelsResult, 
+/** Options for useTechnique hook. */
+UseTechniqueOptions, 
+/** Result type for useTechnique hook. */
+UseTechniqueResult, 
+/** Options for useTechniques hook. */
+UseTechniquesOptions, 
+/** Result type for useTechniques hook. */
+UseTechniquesResult, 
+/** Options for useLearningItem hook. */
+UseLearningItemOptions, 
+/** Result type for useLearningItem hook. */
+UseLearningItemResult, 
+/** Options for useLearning hook. */
+UseLearningOptions, 
+/** Result type for useLearning hook. */
+UseLearningResult, 
+/** @deprecated Options for legacy useGame hook. Use UseSudokuOptions instead. */
+UseGameOptions, 
+/** @deprecated Result type for legacy useGame hook. Use UseSudokuResult instead. */
+UseGameResult, 
+/** Options for useSudoku hook (initial app settings). */
+UseSudokuOptions, 
+/** Result type for useSudoku hook (state, computed values, actions, utilities). */
+UseSudokuResult, 
+/** Options for useGameTeaching hook (network client, URL, token). */
+UseGameTeachingOptions, 
+/** Result type for useGameTeaching hook (teaching state, hint actions). */
+UseGameTeachingResult, 
+/** Options for useLevelGame hook (network, auth, level number). */
+UseLevelGameOptions, 
+/** Result type for useLevelGame hook (board data, fetch status). */
+UseLevelGameResult, 
+/** Options for useDailyGame hook (network, auth). */
+UseDailyGameOptions, 
+/** Result type for useDailyGame hook (daily data, fetch status). */
+UseDailyGameResult, 
+/** Status of a game fetch: 'loading' | 'success' | 'auth_required' | 'subscription_required' | 'error'. */
+GameFetchStatus, 
+/** Options for useGameTimer hook (autoStart, initialTime). */
+UseGameTimerOptions, 
+/** Result type for useGameTimer hook (elapsedRef, controls). */
+UseGameTimerResult, 
+/** Options for useGamePersistence hook (puzzleKey, autoSave). */
+UseGamePersistenceOptions, 
+/** Result type for useGamePersistence hook (load, save, clear, hasSaved). */
+UseGamePersistenceResult, 
+/** Options for useHint hook (network, puzzle state, technique filter). */
+UseHintOptions, 
+/** Result type for useHint hook (hint steps, navigation, apply). */
+UseHintResult, 
+/** Board data returned when applying a hint (user input, pencilmarks). */
+HintBoardData, 
+/** Data passed to onHintReceived callback (hint, board data, technique info). */
+HintReceivedData, 
+/** Access denied error info when hint level exceeds subscription tier. */
+HintAccessError, 
+/** Options for useGamePlay hook (slot selection, auto-save delay). */
+UseGamePlayOptions, 
+/** Result type for useGamePlay hook (current game, start, update, clear). */
+UseGamePlayResult, 
+/** Options for useBoardEntry hook (network client, URL, token). */
+UseBoardEntryOptions, 
+/** Result type for useBoardEntry hook (cells, validation, actions). */
+UseBoardEntryReturn, 
+/** Validated puzzle data from solver (puzzle + solution strings). */
+ValidatedPuzzle, 
+/** Options for useGameSession hook (network, auth, userId). */
+UseGameSessionOptions, 
+/** Result of starting a game session (sessionStarted, sessionId). */
+GameSessionResult, 
+/** Result of finishing a game session (leveledUp, badges, points). */
+GameFinishResult, } from './hooks';
+/** Zustand store for current game state with daily/play slots and localStorage persistence. */
 export { useGamePlayStore } from './stores/gamePlayStore';
+/** State shape for the game play Zustand store. */
 export type { GamePlayState } from './stores/gamePlayStore';
-export type { AuthProviderType, AuthProvidersConfig } from './config';
+/** Authentication provider configuration types. */
+export type { 
+/** Available auth provider types: 'google' | 'apple' | 'email'. */
+AuthProviderType, 
+/** Configuration for which auth providers are enabled. */
+AuthProvidersConfig, } from './config';
+/** Default auth providers configuration (Google + Email, anonymous fallback). */
 export { DEFAULT_AUTH_PROVIDERS } from './config';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -8,69 +8,337 @@
  * - Level, technique, and learning data hooks
  * - Teaching/hint integration with solver
  * - Legacy useGame hook for backward compatibility
+ *
+ * ## Hook Architecture
+ *
+ * The hooks form a layered composition pattern:
+ *
+ * **Data hooks** (fetch and cache server data):
+ * - `useLevels` / `useLevel` - Difficulty level data
+ * - `useTechniques` / `useTechnique` - Solving technique data
+ * - `useLearning` / `useLearningItem` - Learning material data
+ *
+ * **Game fetching hooks** (handle auth, subscription, and puzzle loading):
+ * - `useLevelGame` - Fetch a random board for a specific level
+ * - `useDailyGame` - Fetch today's daily puzzle
+ *
+ * **Game state hooks** (manage board state and user interaction):
+ * - `useSudoku` - Primary game state (flat 81-cell array, modern API)
+ * - `useGame` - Legacy game state (2D array, deprecated)
+ * - `useBoardEntry` - Manual puzzle entry mode
+ *
+ * **Feature hooks** (provide specific game features):
+ * - `useHint` - Solver integration for hints (matches Kotlin HintInteractor)
+ * - `useGameTeaching` - Step-by-step teaching with solver
+ * - `useGameTimer` - Elapsed time tracking via ref (no re-renders)
+ * - `useGamePersistence` / `useAutoSave` - localStorage game save/restore
+ * - `useLocalStorage` - Generic typed localStorage hook
+ *
+ * **Orchestration hooks** (combine multiple hooks for app-level features):
+ * - `useGamePlay` - Current game management with Zustand store (daily/play slots)
+ * - `useGameSession` - Server-side gamification (start/finish, points, badges)
+ *
+ * ## Migration Guide
+ *
+ * Legacy exports (prefixed with "Legacy" comments) use the 2D `GameBoard` type
+ * from `useGame`. New code should use `useSudoku` with its flat 81-cell
+ * `SudokuBoard` type. See `@deprecated` tags on legacy exports.
  */
+/** @deprecated Use `DEFAULT_APP_SETTINGS` / `DEFAULT_PLAY_SETTINGS` instead. */
 export { DEFAULT_GAME_SETTINGS } from './types';
-export { DEFAULT_PLAY_SETTINGS, DEFAULT_APP_SETTINGS, createEmptyCell, createEmptyBoard, cellHasError, rowOf, columnOf, blockOf, cellIndex, getRowIndices, getColumnIndices, getBlockIndices, getRelatedIndices, } from './types';
+/** Default settings and cell/board helper functions for the modern Sudoku API. */
+export { 
+/** Default session play settings (pencilmarking off, auto-pencilmarks off). */
+DEFAULT_PLAY_SETTINGS, 
+/** Default app settings (showErrors on, animations on, numeric display). */
+DEFAULT_APP_SETTINGS, 
+/** Create an empty SudokuCell at the given index. */
+createEmptyCell, 
+/** Create an empty 81-cell SudokuBoard. */
+createEmptyBoard, 
+/** Check if a cell has an error (input does not match solution). */
+cellHasError, 
+/** Get row index (0-8) from cell index (0-80). */
+rowOf, 
+/** Get column index (0-8) from cell index (0-80). */
+columnOf, 
+/** Get block index (0-8) from cell index (0-80). */
+blockOf, 
+/** Get cell index (0-80) from row and column. */
+cellIndex, 
+/** Get all cell indices in the same row as the given index. */
+getRowIndices, 
+/** Get all cell indices in the same column as the given index. */
+getColumnIndices, 
+/** Get all cell indices in the same block as the given index. */
+getBlockIndices, 
+/** Get all related cell indices (same row, column, or block) excluding the cell itself. */
+getRelatedIndices, } from './types';
+/** Theme and color enums plus predefined light/dark palettes. */
 export { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';
-export { DEFAULT_PROGRESS, PROGRESS_STORAGE_KEY } from './types';
-export { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from './types';
+export { 
+/** Default empty user progress state. */
+DEFAULT_PROGRESS, 
+/** localStorage key for progress data ('sudojo-progress'). */
+PROGRESS_STORAGE_KEY, } from './types';
+export { 
+/** Default application settings. */
+DEFAULT_SETTINGS, 
+/** localStorage key for settings ('sudojo-settings'). */
+SETTINGS_STORAGE_KEY, } from './types';
+/** Default inactive subscription state. */
 export { DEFAULT_SUBSCRIPTION } from './types';
-export { GAME_STORAGE_PREFIX, getGameStorageKey } from './types';
+export { 
+/** localStorage key prefix for game saves ('sudojo_game_'). */
+GAME_STORAGE_PREFIX, 
+/** Generate a localStorage key from a GamePersistenceKey. */
+getGameStorageKey, } from './types';
+// ============================================================================
 // Legacy Utilities (useGame hook)
+// ============================================================================
+/**
+ * @deprecated These utilities work with the legacy 2D `GameBoard` type.
+ * For new code, use `useSudoku` with its flat 81-cell board and the
+ * scrambler/presenter utilities below.
+ */
+export { 
+/** @deprecated Clone a 2D GameBoard. Use useSudoku's immutable state instead. */
+cloneBoard, 
+/** @deprecated Count filled cells in a 2D GameBoard. */
+countFilledCells, 
+/** @deprecated Create a 2D GameBoard from puzzle/solution strings. */
+createGameBoard, 
+/** @deprecated Get cells in a block by block index (2D API). */
+getBlockCells, 
+/** @deprecated Get block index from row/col (2D API). Use blockOf() instead. */
+getBlockIndex, 
+/** @deprecated Get 2D board state as string. Use cellsToStateString() instead. */
+getBoardStateString, 
+/** @deprecated Get cells in a column (2D API). Use getColumnIndices() instead. */
+getColumnCells, 
+/** @deprecated Get empty cells from a 2D GameBoard. */
+getEmptyCells, 
+/** @deprecated Get pencilmarks string from 2D GameBoard. Use cellsToPencilmarksString() instead. */
+getPencilmarksString, 
+/** @deprecated Get related cells (2D API). Use getRelatedIndices() instead. */
+getRelatedCells, 
+/** @deprecated Get cells in a row (2D API). Use getRowIndices() instead. */
+getRowCells, 
+/** @deprecated Check if placement is valid (2D API). */
+isValidPlacement, 
+/** @deprecated Auto-remove pencilmarks (2D API). useSudoku handles this internally. */
+autoRemovePencilmarks, 
+/** @deprecated Clear highlights (2D API). useSudoku handles this via presentBoard(). */
+clearHighlights, 
+/** @deprecated Count mistakes (2D API). Use useSudoku's errorCount instead. */
+countMistakes, 
+/** @deprecated Get incorrect cells (2D API). Use useSudoku's errorCells instead. */
+getIncorrectCells, 
+/** @deprecated Get progress percentage (2D API). Use useSudoku's progress instead. */
+getProgressPercentage, 
+/** @deprecated Check if board is filled (2D API). */
+isBoardFilled, 
+/** @deprecated Check if cell is correct (2D API). Use cellHasError() instead. */
+isCellCorrect, 
+/** @deprecated Check if game is complete (2D API). Use useSudoku's isCompleted instead. */
+isGameComplete, 
+/** @deprecated Check if value is correct (2D API). */
+isValueCorrect, 
+/** @deprecated Update cell errors (2D API). useSudoku handles this automatically. */
+updateCellErrors, 
+/** @deprecated Update cell highlights (2D API). Use presentBoard() instead. */
+updateCellHighlights, 
+/** @deprecated Validate entire game state (2D API). */
+validateGameState, } from './utils';
+/** Board scrambling and puzzle string conversion utilities. */
 export { 
-// Board utilities
-cloneBoard, countFilledCells, createGameBoard, getBlockCells, getBlockIndex, getBoardStateString, getColumnCells, getEmptyCells, getPencilmarksString, getRelatedCells, getRowCells, isValidPlacement, 
-// Validation utilities
-autoRemovePencilmarks, clearHighlights, countMistakes, getIncorrectCells, getProgressPercentage, isBoardFilled, isCellCorrect, isGameComplete, isValueCorrect, updateCellErrors, updateCellHighlights, validateGameState, } from './utils';
-export { Scrambler, NonScrambler, scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, } from './utils';
-export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, } from './utils';
+/** Scrambler that permutes rows, columns, and digits to create unique puzzles. */
+Scrambler, 
+/** Identity scrambler that returns the board unchanged. */
+NonScrambler, 
+/** Scramble a board using a ScramblerProtocol implementation. */
+scrambleSudokuBoard, 
+/** Parse an 81-character puzzle string into SudokuCell array. */
+parsePuzzleString, 
+/** Convert SudokuCell array to puzzle string (given values only). */
+cellsToPuzzleString, 
+/** Convert SudokuCell array to state string (given + input values). */
+cellsToStateString, 
+/** Convert SudokuCell array to input-only string. */
+cellsToInputString, 
+/** Convert SudokuCell array to comma-separated pencilmarks string. */
+cellsToPencilmarksString, } from './utils';
+/** Board presentation and color utilities matching the Kotlin renderable layer. */
+export { 
+/** Generate display states for all 81 cells (colors, digits, pencilmarks, hints). */
+presentBoard, 
+/** Process hint step areas and cells into a map of cell hints by index. */
+calculateCellHints, 
+/** Convert a ThemeColor to an actual CSS color string using a palette. */
+themeColorToCSS, 
+/** Get the UIColorPalette for light or dark mode. */
+getColorPalette, 
+/** Get indices of cells containing a specific digit (given or input). */
+getCellsWithDigit, 
+/** Get the digit to highlight based on the selected cell (given or correct input). */
+getSelectedDigit, 
+/** Compute the set of cell indices with the same digit as the selected cell. */
+computeSelectedDigitCells, 
+/** Convert a solver link (row/col pairs) to display format (flat indices). */
+convertSolverLink, 
+/** Convert a solver cell group to display format with ThemeColor. */
+convertSolverCellGroup, 
+/** Convert SudokuColor enum to ThemeColor enum. */
+sudokuColorToTheme, } from './utils';
+// ============================================================================
 // Time Utilities
-export { formatTime, parseTime } from './utils';
+// ============================================================================
+/** Time formatting and parsing utilities. */
+export { 
+/** Format seconds into MM:SS or HH:MM:SS string. */
+formatTime, 
+/** Parse a MM:SS or HH:MM:SS string back to total seconds. */
+parseTime, } from './utils';
+// ============================================================================
 // Progress Utilities
-export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, } from './utils';
-export { THEME_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './utils';
+// ============================================================================
+/** User progress calculation utilities. */
+export { 
+/** Calculate game statistics (best times, averages) from completed puzzles. */
+calculateStats, 
+/** Calculate current daily streak from completion history. */
+calculateStreak, 
+/** Check if a specific puzzle (by type and id) has been completed. */
+isPuzzleCompleted, 
+/** Get all completed level IDs from completion history. */
+getCompletedLevelIds, 
+/** Get all completed daily dates (YYYY-MM-DD) from completion history. */
+getCompletedDailyDates, } from './utils';
+/** Theme detection and resolution utilities. */
+export { 
+/** localStorage key for theme preference ('sudojo-theme'). */
+THEME_STORAGE_KEY, 
+/** Detect the system color scheme preference (light/dark). */
+getSystemTheme, 
+/** Resolve a ThemePreference to an actual theme using the system theme. */
+resolveTheme, 
+/** Type guard: check if a value is a valid ThemePreference. */
+isValidThemePreference, } from './utils';
+// ============================================================================
 // Subscription Utilities
-export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, } from './utils';
+// ============================================================================
+/** RevenueCat subscription conversion and display utilities. */
+export { 
+/** Convert a RevenueCat package to a Product domain model. */
+convertPackageToProduct, 
+/** Parse RevenueCat CustomerInfo into a Subscription domain model. */
+parseCustomerInfo, 
+/** Get human-readable name for an ISO 8601 subscription period (e.g., 'P1M' -> 'Monthly'). */
+getPeriodDisplayName, 
+/** Check if a subscription period is the "best value" option (annual plans). */
+isBestValuePlan, 
+/** Get a user-friendly error message for a RevenueCat error code. */
+getRevenueCatErrorMessage, } from './utils';
+// ============================================================================
 // Technique Utilities
-export { getTechniqueIconUrl } from './utils';
+// ============================================================================
+/** Technique display utilities. */
+export { 
+/** Get the icon URL for a solving technique by its path slug. */
+getTechniqueIconUrl, } from './utils';
+// ============================================================================
 // Hint Explanation Utilities
-export { generateDetailedExplanation, getHintActionSummary } from './utils';
-export { getLocalizedHintText } from './utils';
+// ============================================================================
+/** Hint explanation generation utilities for teaching users solving techniques. */
+export { 
+/** Generate a detailed explanation for a hint step based on the technique. */
+generateDetailedExplanation, 
+/** Get a short action summary for a hint step (e.g., 'Place 5 in R1C3'). */
+getHintActionSummary, } from './utils';
+/** Hint localization utilities. */
+export { 
+/** Get localized text for a hint step using a translation function. */
+getLocalizedHintText, } from './utils';
+// ============================================================================
 // i18n Key Utilities
-export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './utils';
+// ============================================================================
+/** Internationalization key generation and localization utilities. */
+export { 
+/** Get i18n key for a belt name (e.g., 'belts.1.name'). */
+getBeltKey, 
+/** Get localized belt name using a translation function. */
+getLocalizedBeltName, 
+/** Get i18n key for a belt label (e.g., 'belts.1.label'). */
+getBeltLabelKey, 
+/** Get localized belt label (e.g., 'White Belt'). */
+getLocalizedBeltLabel, 
+/** Get i18n key for a level title (e.g., 'levels.3'). */
+getLevelKey, 
+/** Get localized level title using a translation function. */
+getLocalizedLevelTitle, 
+/** Get i18n key for a technique name (e.g., 'techniques.full-house.title'). */
+getTechniqueKey, 
+/** Get localized technique name using a translation function. */
+getLocalizedTechniqueName, } from './utils';
+// ============================================================================
 // Digit Display Utilities
-export { displayDigit } from './utils';
+// ============================================================================
+/** Digit display format conversion. */
+export { 
+/** Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). */
+displayDigit, } from './utils';
+// ============================================================================
 // Hooks
+// ============================================================================
 export { 
-// Levels
-useLevel, useLevels, 
-// Techniques
-useTechnique, useTechniques, 
-// Learning
-useLearning, useLearningItem, 
-// Game (legacy)
+// Data hooks
+/** Fetch a single difficulty level by number. */
+useLevel, 
+/** Fetch all difficulty levels with sorting and filtering utilities. */
+useLevels, 
+/** Fetch a single solving technique by number. */
+useTechnique, 
+/** Fetch all solving techniques with grouping utilities. */
+useTechniques, 
+/** Fetch learning materials with filtering by technique and language. */
+useLearning, 
+/** Fetch a single learning item by UUID. */
+useLearningItem, 
+/**
+ * @deprecated Use `useSudoku` instead. `useGame` uses a legacy 2D array board
+ * representation, while `useSudoku` uses a flat 81-cell array consistent with
+ * the Kotlin renderable layer and the rest of the codebase.
+ */
 useGame, 
-// Sudoku (ported from renderable)
+/** Primary game state hook with flat 81-cell board, pencil mode, and scrambling. */
 useSudoku, 
-// Teaching
+/** Teaching/hint integration with the solver API (legacy GameHint format). */
 useGameTeaching, 
-// Game fetching (with auth/subscription handling)
-useLevelGame, useDailyGame, 
-// Game timer
+/** Fetch a random board for a specific level with auth/subscription handling. */
+useLevelGame, 
+/** Fetch today's daily puzzle with auth/subscription handling. */
+useDailyGame, 
+/** Game timer using refs to avoid re-renders every second. */
 useGameTimer, 
-// Game persistence
-useGamePersistence, useAutoSave, 
-// Local storage
+/** Persist individual game progress to localStorage. */
+useGamePersistence, 
+/** Auto-save game state with debouncing. */
+useAutoSave, 
+/** Generic typed localStorage hook with SSR safety. */
 useLocalStorage, 
-// Hint
+/** Solver hint integration matching Kotlin HintInteractor behavior. */
 useHint, 
-// Game play (current game management)
+/** Current game management with Zustand store (daily/play slots). */
 useGamePlay, 
-// Board entry
+/** Manual puzzle entry mode with solver validation. */
 useBoardEntry, 
-// Game session
+/** Server-side game session management for gamification (points, badges). */
 useGameSession, } from './hooks';
+// ============================================================================
 // Stores
+// ============================================================================
+/** Zustand store for current game state with daily/play slots and localStorage persistence. */
 export { useGamePlayStore } from './stores/gamePlayStore';
+/** Default auth providers configuration (Google + Email, anonymous fallback). */
 export { DEFAULT_AUTH_PROVIDERS } from './config';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @sudobility/sudojo_lib - Business logic library for Sudojo app\n *\n * This library provides:\n * - Game state management with useSudoku hook (ported from renderable)\n * - Board scrambling utilities\n * - Game validation (mistakes, completion)\n * - Level, technique, and learning data hooks\n * - Teaching/hint integration with solver\n * - Legacy useGame hook for backward compatibility\n */\n\n// Legacy Types (useGame hook)\nexport type {\n  CellPosition,\n  CellState,\n  GameBoard,\n  GameHint,\n  GameMove,\n  GameSettings,\n  GameState,\n  GameStatus,\n  TeachingState,\n} from './types';\n\nexport { DEFAULT_GAME_SETTINGS } from './types';\n\n// Sudoku Types (useSudoku hook - ported from renderable)\nexport type {\n  SudokuCell,\n  SudokuBoard,\n  SudokuPlay,\n  SudokuPlaySettings,\n  SudokuAppSettings,\n  SudokuGameState,\n  SudokuDisplay,\n  PlayingSource,\n} from './types';\n\nexport {\n  DEFAULT_PLAY_SETTINGS,\n  DEFAULT_APP_SETTINGS,\n  createEmptyCell,\n  createEmptyBoard,\n  cellHasError,\n  rowOf,\n  columnOf,\n  blockOf,\n  cellIndex,\n  getRowIndices,\n  getColumnIndices,\n  getBlockIndices,\n  getRelatedIndices,\n} from './types';\n\n// Display types (for rendering - matches Kotlin renderable)\nexport type {\n  HintArea,\n  HintCell,\n  HintCellActions,\n  DisplayHintStep,\n  CellDisplayState,\n  PencilmarkDisplayState,\n  UIColorPalette,\n  // Link and group types for chain visualization\n  LinkType,\n  DisplayLink,\n  DisplayCellGroup,\n} from './types';\n\nexport { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';\n\n// Progress Types (for user progress tracking)\nexport type { CompletedPuzzle, GameStats, UserProgress } from './types';\nexport { DEFAULT_PROGRESS, PROGRESS_STORAGE_KEY } from './types';\n\n// Settings Types (for app settings)\nexport type { DigitDisplay, AppSettings } from './types';\nexport { DEFAULT_SETTINGS, SETTINGS_STORAGE_KEY } from './types';\n\n// Subscription Types (for subscription management)\nexport type { Product, Subscription } from './types';\nexport { DEFAULT_SUBSCRIPTION } from './types';\n\n// Game Persistence Types (for saving/loading game state)\nexport type { SavedGameState, GamePersistenceKey } from './types';\nexport { GAME_STORAGE_PREFIX, getGameStorageKey } from './types';\n\n// Current Game Types (for current game feature)\nexport type {\n  GameSource,\n  CurrentGameMeta,\n  CurrentGame,\n  GameSlot,\n} from './types';\n\n// Legacy Utilities (useGame hook)\nexport {\n  // Board utilities\n  cloneBoard,\n  countFilledCells,\n  createGameBoard,\n  getBlockCells,\n  getBlockIndex,\n  getBoardStateString,\n  getColumnCells,\n  getEmptyCells,\n  getPencilmarksString,\n  getRelatedCells,\n  getRowCells,\n  isValidPlacement,\n  // Validation utilities\n  autoRemovePencilmarks,\n  clearHighlights,\n  countMistakes,\n  getIncorrectCells,\n  getProgressPercentage,\n  isBoardFilled,\n  isCellCorrect,\n  isGameComplete,\n  isValueCorrect,\n  updateCellErrors,\n  updateCellHighlights,\n  validateGameState,\n} from './utils';\n\n// Sudoku Utilities (useSudoku hook - ported from renderable)\nexport type { ScramblerProtocol, SudokuScrambleResult } from './utils';\nexport {\n  Scrambler,\n  NonScrambler,\n  scrambleSudokuBoard,\n  parsePuzzleString,\n  cellsToPuzzleString,\n  cellsToStateString,\n  cellsToInputString,\n  cellsToPencilmarksString,\n} from './utils';\n\n// Presenter utilities (for rendering - matches Kotlin renderable)\nexport type { PresentBoardOptions } from './utils';\nexport {\n  presentBoard,\n  calculateCellHints,\n  themeColorToCSS,\n  getColorPalette,\n  getCellsWithDigit,\n  getSelectedDigit,\n  computeSelectedDigitCells,\n  convertSolverLink,\n  convertSolverCellGroup,\n  sudokuColorToTheme,\n} from './utils';\n\n// Time Utilities\nexport { formatTime, parseTime } from './utils';\n\n// Progress Utilities\nexport {\n  calculateStats,\n  calculateStreak,\n  isPuzzleCompleted,\n  getCompletedLevelIds,\n  getCompletedDailyDates,\n} from './utils';\n\n// Theme Utilities\nexport type { ThemePreference, ResolvedTheme } from './utils';\nexport {\n  THEME_STORAGE_KEY,\n  getSystemTheme,\n  resolveTheme,\n  isValidThemePreference,\n} from './utils';\n\n// Subscription Utilities\nexport {\n  convertPackageToProduct,\n  parseCustomerInfo,\n  getPeriodDisplayName,\n  isBestValuePlan,\n  getRevenueCatErrorMessage,\n} from './utils';\n\n// Technique Utilities\nexport { getTechniqueIconUrl } from './utils';\n\n// Hint Explanation Utilities\nexport { generateDetailedExplanation, getHintActionSummary } from './utils';\n\n// Localized Hint Utilities\nexport type { TranslateFunction } from './utils';\nexport { getLocalizedHintText } from './utils';\n\n// i18n Key Utilities\nexport {\n  getBeltKey,\n  getLocalizedBeltName,\n  getBeltLabelKey,\n  getLocalizedBeltLabel,\n  getLevelKey,\n  getLocalizedLevelTitle,\n  getTechniqueKey,\n  getLocalizedTechniqueName,\n} from './utils';\n\n// Digit Display Utilities\nexport { displayDigit } from './utils';\n\n// Hooks\nexport {\n  // Levels\n  useLevel,\n  useLevels,\n  // Techniques\n  useTechnique,\n  useTechniques,\n  // Learning\n  useLearning,\n  useLearningItem,\n  // Game (legacy)\n  useGame,\n  // Sudoku (ported from renderable)\n  useSudoku,\n  // Teaching\n  useGameTeaching,\n  // Game fetching (with auth/subscription handling)\n  useLevelGame,\n  useDailyGame,\n  // Game timer\n  useGameTimer,\n  // Game persistence\n  useGamePersistence,\n  useAutoSave,\n  // Local storage\n  useLocalStorage,\n  // Hint\n  useHint,\n  // Game play (current game management)\n  useGamePlay,\n  // Board entry\n  useBoardEntry,\n  // Game session\n  useGameSession,\n} from './hooks';\n\nexport type {\n  // Levels\n  UseLevelOptions,\n  UseLevelResult,\n  UseLevelsOptions,\n  UseLevelsResult,\n  // Techniques\n  UseTechniqueOptions,\n  UseTechniqueResult,\n  UseTechniquesOptions,\n  UseTechniquesResult,\n  // Learning\n  UseLearningItemOptions,\n  UseLearningItemResult,\n  UseLearningOptions,\n  UseLearningResult,\n  // Game (legacy)\n  UseGameOptions,\n  UseGameResult,\n  // Sudoku (ported from renderable)\n  UseSudokuOptions,\n  UseSudokuResult,\n  // Teaching\n  UseGameTeachingOptions,\n  UseGameTeachingResult,\n  // Game fetching (with auth/subscription handling)\n  UseLevelGameOptions,\n  UseLevelGameResult,\n  UseDailyGameOptions,\n  UseDailyGameResult,\n  GameFetchStatus,\n  // Game timer\n  UseGameTimerOptions,\n  UseGameTimerResult,\n  // Game persistence\n  UseGamePersistenceOptions,\n  UseGamePersistenceResult,\n  // Hint\n  UseHintOptions,\n  UseHintResult,\n  HintBoardData,\n  HintReceivedData,\n  HintAccessError,\n  // Game play (current game management)\n  UseGamePlayOptions,\n  UseGamePlayResult,\n  // Board entry\n  UseBoardEntryOptions,\n  UseBoardEntryReturn,\n  ValidatedPuzzle,\n  // Game session\n  UseGameSessionOptions,\n  GameSessionResult,\n  GameFinishResult,\n} from './hooks';\n\n// Stores\nexport { useGamePlayStore } from './stores/gamePlayStore';\nexport type { GamePlayState } from './stores/gamePlayStore';\n\n// Config\nexport type { AuthProviderType, AuthProvidersConfig } from './config';\nexport { DEFAULT_AUTH_PROVIDERS } from './config';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @sudobility/sudojo_lib - Business logic library for Sudojo app\n *\n * This library provides:\n * - Game state management with useSudoku hook (ported from renderable)\n * - Board scrambling utilities\n * - Game validation (mistakes, completion)\n * - Level, technique, and learning data hooks\n * - Teaching/hint integration with solver\n * - Legacy useGame hook for backward compatibility\n *\n * ## Hook Architecture\n *\n * The hooks form a layered composition pattern:\n *\n * **Data hooks** (fetch and cache server data):\n * - `useLevels` / `useLevel` - Difficulty level data\n * - `useTechniques` / `useTechnique` - Solving technique data\n * - `useLearning` / `useLearningItem` - Learning material data\n *\n * **Game fetching hooks** (handle auth, subscription, and puzzle loading):\n * - `useLevelGame` - Fetch a random board for a specific level\n * - `useDailyGame` - Fetch today's daily puzzle\n *\n * **Game state hooks** (manage board state and user interaction):\n * - `useSudoku` - Primary game state (flat 81-cell array, modern API)\n * - `useGame` - Legacy game state (2D array, deprecated)\n * - `useBoardEntry` - Manual puzzle entry mode\n *\n * **Feature hooks** (provide specific game features):\n * - `useHint` - Solver integration for hints (matches Kotlin HintInteractor)\n * - `useGameTeaching` - Step-by-step teaching with solver\n * - `useGameTimer` - Elapsed time tracking via ref (no re-renders)\n * - `useGamePersistence` / `useAutoSave` - localStorage game save/restore\n * - `useLocalStorage` - Generic typed localStorage hook\n *\n * **Orchestration hooks** (combine multiple hooks for app-level features):\n * - `useGamePlay` - Current game management with Zustand store (daily/play slots)\n * - `useGameSession` - Server-side gamification (start/finish, points, badges)\n *\n * ## Migration Guide\n *\n * Legacy exports (prefixed with \"Legacy\" comments) use the 2D `GameBoard` type\n * from `useGame`. New code should use `useSudoku` with its flat 81-cell\n * `SudokuBoard` type. See `@deprecated` tags on legacy exports.\n */\n\n// ============================================================================\n// Legacy Types (useGame hook)\n// ============================================================================\n\n/**\n * @deprecated Use `SudokuCell` instead. Part of the legacy `useGame` 2D board API.\n */\nexport type {\n  CellPosition,\n  CellState,\n  GameBoard,\n  GameHint,\n  GameMove,\n  GameSettings,\n  GameState,\n  GameStatus,\n  TeachingState,\n} from './types';\n\n/** @deprecated Use `DEFAULT_APP_SETTINGS` / `DEFAULT_PLAY_SETTINGS` instead. */\nexport { DEFAULT_GAME_SETTINGS } from './types';\n\n// ============================================================================\n// Sudoku Types (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/** Core Sudoku cell and board types using flat 81-cell array representation. */\nexport type {\n  /** A single cell in the Sudoku board (indexed 0-80). */\n  SudokuCell,\n  /** The Sudoku board containing all 81 cells. */\n  SudokuBoard,\n  /** Current play state including board, settings, and selection. */\n  SudokuPlay,\n  /** Session settings that can change during play (pencilmarking, auto-pencilmarks). */\n  SudokuPlaySettings,\n  /** App-level settings persisted across sessions (showErrors, display format). */\n  SudokuAppSettings,\n  /** Full game state including source, history, and digit mapping. */\n  SudokuGameState,\n  /** Display modes for Sudoku digits ('NUMERIC' | 'KANJI' | 'COLORS' | 'EMOJIS'). */\n  SudokuDisplay,\n  /** Source of the puzzle ('DAILY' | 'CHALLENGE' | 'LEVEL' | 'ENTERED'). */\n  PlayingSource,\n} from './types';\n\n/** Default settings and cell/board helper functions for the modern Sudoku API. */\nexport {\n  /** Default session play settings (pencilmarking off, auto-pencilmarks off). */\n  DEFAULT_PLAY_SETTINGS,\n  /** Default app settings (showErrors on, animations on, numeric display). */\n  DEFAULT_APP_SETTINGS,\n  /** Create an empty SudokuCell at the given index. */\n  createEmptyCell,\n  /** Create an empty 81-cell SudokuBoard. */\n  createEmptyBoard,\n  /** Check if a cell has an error (input does not match solution). */\n  cellHasError,\n  /** Get row index (0-8) from cell index (0-80). */\n  rowOf,\n  /** Get column index (0-8) from cell index (0-80). */\n  columnOf,\n  /** Get block index (0-8) from cell index (0-80). */\n  blockOf,\n  /** Get cell index (0-80) from row and column. */\n  cellIndex,\n  /** Get all cell indices in the same row as the given index. */\n  getRowIndices,\n  /** Get all cell indices in the same column as the given index. */\n  getColumnIndices,\n  /** Get all cell indices in the same block as the given index. */\n  getBlockIndices,\n  /** Get all related cell indices (same row, column, or block) excluding the cell itself. */\n  getRelatedIndices,\n} from './types';\n\n// ============================================================================\n// Display types (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/** Display and hint visualization types matching the Kotlin renderable layer. */\nexport type {\n  /** Highlighted area in a hint (row, column, or block). */\n  HintArea,\n  /** Cell display information in a hint step. */\n  HintCell,\n  /** Actions to perform on a cell during hint visualization. */\n  HintCellActions,\n  /** A single hint step with title, text, areas, cells, links, and groups. */\n  DisplayHintStep,\n  /** Complete display state for a single cell (colors, digit, pencilmarks). */\n  CellDisplayState,\n  /** Display state for a single pencilmark (digit and color). */\n  PencilmarkDisplayState,\n  /** UI color palette with system colors for light or dark mode. */\n  UIColorPalette,\n  /** Link type for chain visualization ('strong' | 'weak'). */\n  LinkType,\n  /** A link between two cells in a chain (display format). */\n  DisplayLink,\n  /** A group of cells for pattern visualization (display format). */\n  DisplayCellGroup,\n} from './types';\n\n/** Theme and color enums plus predefined light/dark palettes. */\nexport { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';\n\n// ============================================================================\n// Progress Types (for user progress tracking)\n// ============================================================================\n\n/** Types for tracking user puzzle completion and statistics. */\nexport type {\n  /** Record of a completed puzzle (id, type, time). */\n  CompletedPuzzle,\n  /** Computed game statistics (best times, averages). */\n  GameStats,\n  /** Full user progress data (completed puzzles, streak, stats). */\n  UserProgress,\n} from './types';\n\nexport {\n  /** Default empty user progress state. */\n  DEFAULT_PROGRESS,\n  /** localStorage key for progress data ('sudojo-progress'). */\n  PROGRESS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Settings Types (for app settings)\n// ============================================================================\n\n/** Types for application settings. */\nexport type {\n  /** Digit display format ('numeric' | 'kanji' | 'emojis'). */\n  DigitDisplay,\n  /** Application settings (showErrors, symmetrical, display). */\n  AppSettings,\n} from './types';\n\nexport {\n  /** Default application settings. */\n  DEFAULT_SETTINGS,\n  /** localStorage key for settings ('sudojo-settings'). */\n  SETTINGS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Subscription Types (for subscription management)\n// ============================================================================\n\n/** Types for RevenueCat subscription management. */\nexport type {\n  /** Subscription product information (price, period, trial). */\n  Product,\n  /** User subscription status (active, expiration, renewal). */\n  Subscription,\n} from './types';\n\n/** Default inactive subscription state. */\nexport { DEFAULT_SUBSCRIPTION } from './types';\n\n// ============================================================================\n// Game Persistence Types (for saving/loading game state)\n// ============================================================================\n\n/** Types for saving and restoring game progress to localStorage. */\nexport type {\n  /** Saved game state (input, pencilmarks, mode, timestamp). */\n  SavedGameState,\n  /** Key identifying a game to persist (type + id). */\n  GamePersistenceKey,\n} from './types';\n\nexport {\n  /** localStorage key prefix for game saves ('sudojo_game_'). */\n  GAME_STORAGE_PREFIX,\n  /** Generate a localStorage key from a GamePersistenceKey. */\n  getGameStorageKey,\n} from './types';\n\n// ============================================================================\n// Current Game Types (for current game feature)\n// ============================================================================\n\n/** Types for the Zustand-backed current game store. */\nexport type {\n  /** Source of the current game ('daily' | 'level' | 'entered'). */\n  GameSource,\n  /** Navigation metadata for resuming a game (date, level, board info). */\n  CurrentGameMeta,\n  /** Full current game state stored in Zustand (puzzle, progress, timing). */\n  CurrentGame,\n  /** Which store slot a game lives in ('daily' | 'play'). */\n  GameSlot,\n} from './types';\n\n// ============================================================================\n// Legacy Utilities (useGame hook)\n// ============================================================================\n\n/**\n * @deprecated These utilities work with the legacy 2D `GameBoard` type.\n * For new code, use `useSudoku` with its flat 81-cell board and the\n * scrambler/presenter utilities below.\n */\nexport {\n  /** @deprecated Clone a 2D GameBoard. Use useSudoku's immutable state instead. */\n  cloneBoard,\n  /** @deprecated Count filled cells in a 2D GameBoard. */\n  countFilledCells,\n  /** @deprecated Create a 2D GameBoard from puzzle/solution strings. */\n  createGameBoard,\n  /** @deprecated Get cells in a block by block index (2D API). */\n  getBlockCells,\n  /** @deprecated Get block index from row/col (2D API). Use blockOf() instead. */\n  getBlockIndex,\n  /** @deprecated Get 2D board state as string. Use cellsToStateString() instead. */\n  getBoardStateString,\n  /** @deprecated Get cells in a column (2D API). Use getColumnIndices() instead. */\n  getColumnCells,\n  /** @deprecated Get empty cells from a 2D GameBoard. */\n  getEmptyCells,\n  /** @deprecated Get pencilmarks string from 2D GameBoard. Use cellsToPencilmarksString() instead. */\n  getPencilmarksString,\n  /** @deprecated Get related cells (2D API). Use getRelatedIndices() instead. */\n  getRelatedCells,\n  /** @deprecated Get cells in a row (2D API). Use getRowIndices() instead. */\n  getRowCells,\n  /** @deprecated Check if placement is valid (2D API). */\n  isValidPlacement,\n  /** @deprecated Auto-remove pencilmarks (2D API). useSudoku handles this internally. */\n  autoRemovePencilmarks,\n  /** @deprecated Clear highlights (2D API). useSudoku handles this via presentBoard(). */\n  clearHighlights,\n  /** @deprecated Count mistakes (2D API). Use useSudoku's errorCount instead. */\n  countMistakes,\n  /** @deprecated Get incorrect cells (2D API). Use useSudoku's errorCells instead. */\n  getIncorrectCells,\n  /** @deprecated Get progress percentage (2D API). Use useSudoku's progress instead. */\n  getProgressPercentage,\n  /** @deprecated Check if board is filled (2D API). */\n  isBoardFilled,\n  /** @deprecated Check if cell is correct (2D API). Use cellHasError() instead. */\n  isCellCorrect,\n  /** @deprecated Check if game is complete (2D API). Use useSudoku's isCompleted instead. */\n  isGameComplete,\n  /** @deprecated Check if value is correct (2D API). */\n  isValueCorrect,\n  /** @deprecated Update cell errors (2D API). useSudoku handles this automatically. */\n  updateCellErrors,\n  /** @deprecated Update cell highlights (2D API). Use presentBoard() instead. */\n  updateCellHighlights,\n  /** @deprecated Validate entire game state (2D API). */\n  validateGameState,\n} from './utils';\n\n// ============================================================================\n// Sudoku Utilities (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/** Types for board scrambling. */\nexport type {\n  /** Protocol for board scramblers (Scrambler and NonScrambler implement this). */\n  ScramblerProtocol,\n  /** Result of scrambling a board (cells + digit mappings). */\n  SudokuScrambleResult,\n} from './utils';\n\n/** Board scrambling and puzzle string conversion utilities. */\nexport {\n  /** Scrambler that permutes rows, columns, and digits to create unique puzzles. */\n  Scrambler,\n  /** Identity scrambler that returns the board unchanged. */\n  NonScrambler,\n  /** Scramble a board using a ScramblerProtocol implementation. */\n  scrambleSudokuBoard,\n  /** Parse an 81-character puzzle string into SudokuCell array. */\n  parsePuzzleString,\n  /** Convert SudokuCell array to puzzle string (given values only). */\n  cellsToPuzzleString,\n  /** Convert SudokuCell array to state string (given + input values). */\n  cellsToStateString,\n  /** Convert SudokuCell array to input-only string. */\n  cellsToInputString,\n  /** Convert SudokuCell array to comma-separated pencilmarks string. */\n  cellsToPencilmarksString,\n} from './utils';\n\n// ============================================================================\n// Presenter utilities (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/** Options type for the presentBoard function. */\nexport type {\n  /** Options for generating cell display states (cells, selection, errors, hints). */\n  PresentBoardOptions,\n} from './utils';\n\n/** Board presentation and color utilities matching the Kotlin renderable layer. */\nexport {\n  /** Generate display states for all 81 cells (colors, digits, pencilmarks, hints). */\n  presentBoard,\n  /** Process hint step areas and cells into a map of cell hints by index. */\n  calculateCellHints,\n  /** Convert a ThemeColor to an actual CSS color string using a palette. */\n  themeColorToCSS,\n  /** Get the UIColorPalette for light or dark mode. */\n  getColorPalette,\n  /** Get indices of cells containing a specific digit (given or input). */\n  getCellsWithDigit,\n  /** Get the digit to highlight based on the selected cell (given or correct input). */\n  getSelectedDigit,\n  /** Compute the set of cell indices with the same digit as the selected cell. */\n  computeSelectedDigitCells,\n  /** Convert a solver link (row/col pairs) to display format (flat indices). */\n  convertSolverLink,\n  /** Convert a solver cell group to display format with ThemeColor. */\n  convertSolverCellGroup,\n  /** Convert SudokuColor enum to ThemeColor enum. */\n  sudokuColorToTheme,\n} from './utils';\n\n// ============================================================================\n// Time Utilities\n// ============================================================================\n\n/** Time formatting and parsing utilities. */\nexport {\n  /** Format seconds into MM:SS or HH:MM:SS string. */\n  formatTime,\n  /** Parse a MM:SS or HH:MM:SS string back to total seconds. */\n  parseTime,\n} from './utils';\n\n// ============================================================================\n// Progress Utilities\n// ============================================================================\n\n/** User progress calculation utilities. */\nexport {\n  /** Calculate game statistics (best times, averages) from completed puzzles. */\n  calculateStats,\n  /** Calculate current daily streak from completion history. */\n  calculateStreak,\n  /** Check if a specific puzzle (by type and id) has been completed. */\n  isPuzzleCompleted,\n  /** Get all completed level IDs from completion history. */\n  getCompletedLevelIds,\n  /** Get all completed daily dates (YYYY-MM-DD) from completion history. */\n  getCompletedDailyDates,\n} from './utils';\n\n// ============================================================================\n// Theme Utilities\n// ============================================================================\n\n/** Types for theme preference management. */\nexport type {\n  /** Theme preference: 'light' | 'dark' | 'system'. */\n  ThemePreference,\n  /** Resolved theme without system option: 'light' | 'dark'. */\n  ResolvedTheme,\n} from './utils';\n\n/** Theme detection and resolution utilities. */\nexport {\n  /** localStorage key for theme preference ('sudojo-theme'). */\n  THEME_STORAGE_KEY,\n  /** Detect the system color scheme preference (light/dark). */\n  getSystemTheme,\n  /** Resolve a ThemePreference to an actual theme using the system theme. */\n  resolveTheme,\n  /** Type guard: check if a value is a valid ThemePreference. */\n  isValidThemePreference,\n} from './utils';\n\n// ============================================================================\n// Subscription Utilities\n// ============================================================================\n\n/** RevenueCat subscription conversion and display utilities. */\nexport {\n  /** Convert a RevenueCat package to a Product domain model. */\n  convertPackageToProduct,\n  /** Parse RevenueCat CustomerInfo into a Subscription domain model. */\n  parseCustomerInfo,\n  /** Get human-readable name for an ISO 8601 subscription period (e.g., 'P1M' -> 'Monthly'). */\n  getPeriodDisplayName,\n  /** Check if a subscription period is the \"best value\" option (annual plans). */\n  isBestValuePlan,\n  /** Get a user-friendly error message for a RevenueCat error code. */\n  getRevenueCatErrorMessage,\n} from './utils';\n\n// ============================================================================\n// Technique Utilities\n// ============================================================================\n\n/** Technique display utilities. */\nexport {\n  /** Get the icon URL for a solving technique by its path slug. */\n  getTechniqueIconUrl,\n} from './utils';\n\n// ============================================================================\n// Hint Explanation Utilities\n// ============================================================================\n\n/** Hint explanation generation utilities for teaching users solving techniques. */\nexport {\n  /** Generate a detailed explanation for a hint step based on the technique. */\n  generateDetailedExplanation,\n  /** Get a short action summary for a hint step (e.g., 'Place 5 in R1C3'). */\n  getHintActionSummary,\n} from './utils';\n\n// ============================================================================\n// Localized Hint Utilities\n// ============================================================================\n\n/** Types for hint text localization. */\nexport type {\n  /** Translation function compatible with i18next's `t` function. */\n  TranslateFunction,\n} from './utils';\n\n/** Hint localization utilities. */\nexport {\n  /** Get localized text for a hint step using a translation function. */\n  getLocalizedHintText,\n} from './utils';\n\n// ============================================================================\n// i18n Key Utilities\n// ============================================================================\n\n/** Internationalization key generation and localization utilities. */\nexport {\n  /** Get i18n key for a belt name (e.g., 'belts.1.name'). */\n  getBeltKey,\n  /** Get localized belt name using a translation function. */\n  getLocalizedBeltName,\n  /** Get i18n key for a belt label (e.g., 'belts.1.label'). */\n  getBeltLabelKey,\n  /** Get localized belt label (e.g., 'White Belt'). */\n  getLocalizedBeltLabel,\n  /** Get i18n key for a level title (e.g., 'levels.3'). */\n  getLevelKey,\n  /** Get localized level title using a translation function. */\n  getLocalizedLevelTitle,\n  /** Get i18n key for a technique name (e.g., 'techniques.full-house.title'). */\n  getTechniqueKey,\n  /** Get localized technique name using a translation function. */\n  getLocalizedTechniqueName,\n} from './utils';\n\n// ============================================================================\n// Digit Display Utilities\n// ============================================================================\n\n/** Digit display format conversion. */\nexport {\n  /** Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). */\n  displayDigit,\n} from './utils';\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\nexport {\n  // Data hooks\n  /** Fetch a single difficulty level by number. */\n  useLevel,\n  /** Fetch all difficulty levels with sorting and filtering utilities. */\n  useLevels,\n  /** Fetch a single solving technique by number. */\n  useTechnique,\n  /** Fetch all solving techniques with grouping utilities. */\n  useTechniques,\n  /** Fetch learning materials with filtering by technique and language. */\n  useLearning,\n  /** Fetch a single learning item by UUID. */\n  useLearningItem,\n\n  /**\n   * @deprecated Use `useSudoku` instead. `useGame` uses a legacy 2D array board\n   * representation, while `useSudoku` uses a flat 81-cell array consistent with\n   * the Kotlin renderable layer and the rest of the codebase.\n   */\n  useGame,\n\n  /** Primary game state hook with flat 81-cell board, pencil mode, and scrambling. */\n  useSudoku,\n\n  /** Teaching/hint integration with the solver API (legacy GameHint format). */\n  useGameTeaching,\n\n  /** Fetch a random board for a specific level with auth/subscription handling. */\n  useLevelGame,\n  /** Fetch today's daily puzzle with auth/subscription handling. */\n  useDailyGame,\n\n  /** Game timer using refs to avoid re-renders every second. */\n  useGameTimer,\n\n  /** Persist individual game progress to localStorage. */\n  useGamePersistence,\n  /** Auto-save game state with debouncing. */\n  useAutoSave,\n\n  /** Generic typed localStorage hook with SSR safety. */\n  useLocalStorage,\n\n  /** Solver hint integration matching Kotlin HintInteractor behavior. */\n  useHint,\n\n  /** Current game management with Zustand store (daily/play slots). */\n  useGamePlay,\n\n  /** Manual puzzle entry mode with solver validation. */\n  useBoardEntry,\n\n  /** Server-side game session management for gamification (points, badges). */\n  useGameSession,\n} from './hooks';\n\nexport type {\n  // Data hook types\n  /** Options for useLevel hook. */\n  UseLevelOptions,\n  /** Result type for useLevel hook. */\n  UseLevelResult,\n  /** Options for useLevels hook. */\n  UseLevelsOptions,\n  /** Result type for useLevels hook. */\n  UseLevelsResult,\n  /** Options for useTechnique hook. */\n  UseTechniqueOptions,\n  /** Result type for useTechnique hook. */\n  UseTechniqueResult,\n  /** Options for useTechniques hook. */\n  UseTechniquesOptions,\n  /** Result type for useTechniques hook. */\n  UseTechniquesResult,\n  /** Options for useLearningItem hook. */\n  UseLearningItemOptions,\n  /** Result type for useLearningItem hook. */\n  UseLearningItemResult,\n  /** Options for useLearning hook. */\n  UseLearningOptions,\n  /** Result type for useLearning hook. */\n  UseLearningResult,\n\n  // Game hook types (legacy)\n  /** @deprecated Options for legacy useGame hook. Use UseSudokuOptions instead. */\n  UseGameOptions,\n  /** @deprecated Result type for legacy useGame hook. Use UseSudokuResult instead. */\n  UseGameResult,\n\n  // Sudoku hook types\n  /** Options for useSudoku hook (initial app settings). */\n  UseSudokuOptions,\n  /** Result type for useSudoku hook (state, computed values, actions, utilities). */\n  UseSudokuResult,\n\n  // Teaching hook types\n  /** Options for useGameTeaching hook (network client, URL, token). */\n  UseGameTeachingOptions,\n  /** Result type for useGameTeaching hook (teaching state, hint actions). */\n  UseGameTeachingResult,\n\n  // Game fetching hook types\n  /** Options for useLevelGame hook (network, auth, level number). */\n  UseLevelGameOptions,\n  /** Result type for useLevelGame hook (board data, fetch status). */\n  UseLevelGameResult,\n  /** Options for useDailyGame hook (network, auth). */\n  UseDailyGameOptions,\n  /** Result type for useDailyGame hook (daily data, fetch status). */\n  UseDailyGameResult,\n  /** Status of a game fetch: 'loading' | 'success' | 'auth_required' | 'subscription_required' | 'error'. */\n  GameFetchStatus,\n\n  // Timer hook types\n  /** Options for useGameTimer hook (autoStart, initialTime). */\n  UseGameTimerOptions,\n  /** Result type for useGameTimer hook (elapsedRef, controls). */\n  UseGameTimerResult,\n\n  // Persistence hook types\n  /** Options for useGamePersistence hook (puzzleKey, autoSave). */\n  UseGamePersistenceOptions,\n  /** Result type for useGamePersistence hook (load, save, clear, hasSaved). */\n  UseGamePersistenceResult,\n\n  // Hint hook types\n  /** Options for useHint hook (network, puzzle state, technique filter). */\n  UseHintOptions,\n  /** Result type for useHint hook (hint steps, navigation, apply). */\n  UseHintResult,\n  /** Board data returned when applying a hint (user input, pencilmarks). */\n  HintBoardData,\n  /** Data passed to onHintReceived callback (hint, board data, technique info). */\n  HintReceivedData,\n  /** Access denied error info when hint level exceeds subscription tier. */\n  HintAccessError,\n\n  // Game play hook types\n  /** Options for useGamePlay hook (slot selection, auto-save delay). */\n  UseGamePlayOptions,\n  /** Result type for useGamePlay hook (current game, start, update, clear). */\n  UseGamePlayResult,\n\n  // Board entry hook types\n  /** Options for useBoardEntry hook (network client, URL, token). */\n  UseBoardEntryOptions,\n  /** Result type for useBoardEntry hook (cells, validation, actions). */\n  UseBoardEntryReturn,\n  /** Validated puzzle data from solver (puzzle + solution strings). */\n  ValidatedPuzzle,\n\n  // Game session hook types\n  /** Options for useGameSession hook (network, auth, userId). */\n  UseGameSessionOptions,\n  /** Result of starting a game session (sessionStarted, sessionId). */\n  GameSessionResult,\n  /** Result of finishing a game session (leveledUp, badges, points). */\n  GameFinishResult,\n} from './hooks';\n\n// ============================================================================\n// Stores\n// ============================================================================\n\n/** Zustand store for current game state with daily/play slots and localStorage persistence. */\nexport { useGamePlayStore } from './stores/gamePlayStore';\n/** State shape for the game play Zustand store. */\nexport type { GamePlayState } from './stores/gamePlayStore';\n\n// ============================================================================\n// Config\n// ============================================================================\n\n/** Authentication provider configuration types. */\nexport type {\n  /** Available auth provider types: 'google' | 'apple' | 'email'. */\n  AuthProviderType,\n  /** Configuration for which auth providers are enabled. */\n  AuthProvidersConfig,\n} from './config';\n\n/** Default auth providers configuration (Google + Email, anonymous fallback). */\nexport { DEFAULT_AUTH_PROVIDERS } from './config';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sudojo_lib",
-  "version": "0.0.94",
+  "version": "0.0.96",
   "description": "Business logic library for Sudojo app",
   "type": "module",
   "main": "dist/index.js",