@sudobility/sudojo_lib 0.0.119 → 0.0.121

package/dist/index.d.ts

@@ -363,6 +363,14 @@ getLocalizedTechniqueName, } from './utils';
 export { 
 /** Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). */
 displayDigit, } from './utils';
+/** Types for share URL building and parsing. */
+export type { ShareUrlParams, ParsedShareParams } from './utils';
+/** Build a share URL from game state. */
+export { buildShareUrl } from './utils';
+/** Parse share URL query parameters into game state. */
+export { parseShareParams } from './utils';
+/** Derive web app URL from API base URL. */
+export { getWebUrl } from './utils';
 export { 
 /** Fetch a single difficulty level by number. */
 useLevel, 

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

@@ -287,6 +287,12 @@ getLocalizedTechniqueName, } from './utils';
 export { 
 /** Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). */
 displayDigit, } from './utils';
+/** Build a share URL from game state. */
+export { buildShareUrl } from './utils';
+/** Parse share URL query parameters into game state. */
+export { parseShareParams } from './utils';
+/** Derive web app URL from API base URL. */
+export { getWebUrl } from './utils';
 // ============================================================================
 // Hooks
 // ============================================================================

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 * ## 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\n  /** Check whether a level is enabled for the current user's entitlements. */\n  useLevelEnabled,\n  /** Check whether a technique is enabled for the current user's entitlements. */\n  useTechniqueEnabled,\n\n  /** Convert internal user level (0-indexed) to display values (1-indexed + belt). */\n  useDisplayLevel,\n\n  /** Compute cumulative puzzle distribution across entitlement tiers. */\n  usePuzzleDistribution,\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' | 'entitlement_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\n  // Display level hook types\n  /** Result type for useDisplayLevel hook. */\n  UseDisplayLevelResult,\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\n// ============================================================================\n// Entitlement Context\n// ============================================================================\n\n/** Provider that supplies entitlements to useLevelEnabled / useTechniqueEnabled. */\nexport { EntitlementProvider } from './context';\n/** React context for entitlements (for advanced use). */\nexport { EntitlementContext, useEntitlementContext } from './context';\n\n// ============================================================================\n// Entitlement Utilities (re-exported from sudojo_types)\n// ============================================================================\n\n/** Parse a comma-delimited entitlement string into an array. */\nexport { parseEntitlements } from '@sudobility/sudojo_types';\n\n/** Check if a user has the required entitlement for a level. */\nexport { hasRequiredEntitlement } from '@sudobility/sudojo_types';\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// Share URL Utilities\n// ============================================================================\n\n/** Types for share URL building and parsing. */\nexport type { ShareUrlParams, ParsedShareParams } from './utils';\n\n/** Build a share URL from game state. */\nexport { buildShareUrl } from './utils';\n\n/** Parse share URL query parameters into game state. */\nexport { parseShareParams } from './utils';\n\n/** Derive web app URL from API base URL. */\nexport { getWebUrl } 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\n  /** Check whether a level is enabled for the current user's entitlements. */\n  useLevelEnabled,\n  /** Check whether a technique is enabled for the current user's entitlements. */\n  useTechniqueEnabled,\n\n  /** Convert internal user level (0-indexed) to display values (1-indexed + belt). */\n  useDisplayLevel,\n\n  /** Compute cumulative puzzle distribution across entitlement tiers. */\n  usePuzzleDistribution,\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' | 'entitlement_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\n  // Display level hook types\n  /** Result type for useDisplayLevel hook. */\n  UseDisplayLevelResult,\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\n// ============================================================================\n// Entitlement Context\n// ============================================================================\n\n/** Provider that supplies entitlements to useLevelEnabled / useTechniqueEnabled. */\nexport { EntitlementProvider } from './context';\n/** React context for entitlements (for advanced use). */\nexport { EntitlementContext, useEntitlementContext } from './context';\n\n// ============================================================================\n// Entitlement Utilities (re-exported from sudojo_types)\n// ============================================================================\n\n/** Parse a comma-delimited entitlement string into an array. */\nexport { parseEntitlements } from '@sudobility/sudojo_types';\n\n/** Check if a user has the required entitlement for a level. */\nexport { hasRequiredEntitlement } from '@sudobility/sudojo_types';\n"]}

package/dist/utils/index.d.ts

@@ -18,4 +18,6 @@ export type { TranslateFunction } from './localizedHint';
 export { getLocalizedHintText } from './localizedHint';
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 export { displayDigit } from './digitDisplay';
+export type { ShareUrlParams, ParsedShareParams } from './shareUrl';
+export { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,iBAAiB,EACjB,cAAc,IAAI,oBAAoB,GACvC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG/C,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/index.js

@@ -23,4 +23,5 @@ export { getLocalizedHintText } from './localizedHint';
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 // Digit display utilities
 export { displayDigit } from './digitDisplay';
+export { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE/C,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["/**\n * Utility exports for Sudojo library\n */\n\n// Board utilities (legacy - for useGame hook)\nexport {\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} from './board';\n\n// Validation utilities (legacy - for useGame hook)\nexport {\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 './validation';\n\n// Sudoku scrambler utilities (for useSudoku hook - ported from renderable)\nexport type {\n  ScramblerProtocol,\n  ScrambleResult as SudokuScrambleResult,\n} from './sudokuScrambler';\nexport {\n  Scrambler,\n  NonScrambler,\n  scrambleBoard as scrambleSudokuBoard,\n  parsePuzzleString,\n  cellsToPuzzleString,\n  cellsToStateString,\n  cellsToInputString,\n  cellsToPencilmarksString,\n} from './sudokuScrambler';\n\n// Sudoku presenter (for rendering - matches Kotlin renderable)\nexport type { PresentBoardOptions } from './sudokuPresenter';\nexport {\n  presentBoard,\n  calculateCellHints,\n  themeColorToCSS,\n  getColorPalette,\n  getCellsWithDigit,\n  getSelectedDigit,\n  computeSelectedDigitCells,\n  convertSolverLink,\n  convertSolverCellGroup,\n  sudokuColorToTheme,\n} from './sudokuPresenter';\n\n// Time utilities\nexport { formatTime, parseTime } from './time';\n\n// Progress utilities\nexport {\n  calculateStats,\n  calculateStreak,\n  isPuzzleCompleted,\n  getCompletedLevelIds,\n  getCompletedDailyDates,\n} from './progress';\n\n// Theme utilities\nexport type { ThemePreference, ResolvedTheme } from './theme';\nexport {\n  THEME_STORAGE_KEY,\n  getSystemTheme,\n  resolveTheme,\n  isValidThemePreference,\n} from './theme';\n\n// Subscription utilities\nexport {\n  convertPackageToProduct,\n  parseCustomerInfo,\n  getPeriodDisplayName,\n  isBestValuePlan,\n  getRevenueCatErrorMessage,\n} from './subscription';\n\n// Technique utilities\nexport { getTechniqueIconUrl } from './technique';\n\n// Hint explanation utilities\nexport {\n  generateDetailedExplanation,\n  getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type { TranslateFunction } from './localizedHint';\nexport { getLocalizedHintText } from './localizedHint';\n\n// i18n key utilities\nexport {\n  getBeltKey,\n  getLocalizedBeltName,\n  getBeltLabelKey,\n  getLocalizedBeltLabel,\n  getLevelKey,\n  getLocalizedLevelTitle,\n  getTechniqueKey,\n  getLocalizedTechniqueName,\n} from './i18nKeys';\n\n// Digit display utilities\nexport { displayDigit } from './digitDisplay';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE/C,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC","sourcesContent":["/**\n * Utility exports for Sudojo library\n */\n\n// Board utilities (legacy - for useGame hook)\nexport {\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} from './board';\n\n// Validation utilities (legacy - for useGame hook)\nexport {\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 './validation';\n\n// Sudoku scrambler utilities (for useSudoku hook - ported from renderable)\nexport type {\n  ScramblerProtocol,\n  ScrambleResult as SudokuScrambleResult,\n} from './sudokuScrambler';\nexport {\n  Scrambler,\n  NonScrambler,\n  scrambleBoard as scrambleSudokuBoard,\n  parsePuzzleString,\n  cellsToPuzzleString,\n  cellsToStateString,\n  cellsToInputString,\n  cellsToPencilmarksString,\n} from './sudokuScrambler';\n\n// Sudoku presenter (for rendering - matches Kotlin renderable)\nexport type { PresentBoardOptions } from './sudokuPresenter';\nexport {\n  presentBoard,\n  calculateCellHints,\n  themeColorToCSS,\n  getColorPalette,\n  getCellsWithDigit,\n  getSelectedDigit,\n  computeSelectedDigitCells,\n  convertSolverLink,\n  convertSolverCellGroup,\n  sudokuColorToTheme,\n} from './sudokuPresenter';\n\n// Time utilities\nexport { formatTime, parseTime } from './time';\n\n// Progress utilities\nexport {\n  calculateStats,\n  calculateStreak,\n  isPuzzleCompleted,\n  getCompletedLevelIds,\n  getCompletedDailyDates,\n} from './progress';\n\n// Theme utilities\nexport type { ThemePreference, ResolvedTheme } from './theme';\nexport {\n  THEME_STORAGE_KEY,\n  getSystemTheme,\n  resolveTheme,\n  isValidThemePreference,\n} from './theme';\n\n// Subscription utilities\nexport {\n  convertPackageToProduct,\n  parseCustomerInfo,\n  getPeriodDisplayName,\n  isBestValuePlan,\n  getRevenueCatErrorMessage,\n} from './subscription';\n\n// Technique utilities\nexport { getTechniqueIconUrl } from './technique';\n\n// Hint explanation utilities\nexport {\n  generateDetailedExplanation,\n  getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type { TranslateFunction } from './localizedHint';\nexport { getLocalizedHintText } from './localizedHint';\n\n// i18n key utilities\nexport {\n  getBeltKey,\n  getLocalizedBeltName,\n  getBeltLabelKey,\n  getLocalizedBeltLabel,\n  getLevelKey,\n  getLocalizedLevelTitle,\n  getTechniqueKey,\n  getLocalizedTechniqueName,\n} from './i18nKeys';\n\n// Digit display utilities\nexport { displayDigit } from './digitDisplay';\n\n// Share URL utilities\nexport type { ShareUrlParams, ParsedShareParams } from './shareUrl';\nexport { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';\n"]}

package/dist/utils/shareUrl.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Share URL builder and parser for Sudojo puzzle sharing.
+ *
+ * - Daily puzzles share just `/daily`
+ * - Level/enter puzzles share `/play/puzzle?level=...&original=...&user=...&autopencilmarks=...&pencilmarks=...&hint=...`
+ *
+ * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)
+ * to keep URLs readable.
+ */
+export interface ShareUrlParams {
+    type: 'daily' | 'puzzle';
+    /** 81-char original puzzle string */
+    original?: string;
+    /** 81-char user input string */
+    user?: string;
+    /** Comma-separated pencilmarks string (81 cells, 80 commas) */
+    pencilmarks?: string;
+    /** Whether auto-pencilmarks are enabled */
+    autopencilmarks?: boolean;
+    /** Difficulty level (1-based) */
+    level?: number;
+    /** Hint step index (0-based). Only included when hint is active. */
+    hint?: number;
+    /** Base domain (default: https://sudojo.com) */
+    domain?: string;
+}
+export interface ParsedShareParams {
+    original: string;
+    user: string;
+    pencilmarks: string;
+    autopencilmarks: boolean;
+    level?: number;
+    hint?: number;
+}
+/**
+ * Build a share URL from game state.
+ *
+ * Pencilmarks are appended directly to the URL (without URLSearchParams
+ * encoding) so commas remain as literal commas.
+ */
+export declare function buildShareUrl(params: ShareUrlParams): string;
+/**
+ * Parse share URL query parameters into game state.
+ * Returns null if required params (original, user) are missing.
+ */
+export declare function parseShareParams(params: URLSearchParams): ParsedShareParams | null;
+/**
+ * Derive the web app URL from an API base URL.
+ *
+ * - Localhost: kept as-is (web app and API share the same server in dev)
+ * - Production: strips the `api.` subdomain
+ *   (e.g. `https://api.sudojo.com` → `https://sudojo.com`)
+ */
+export declare function getWebUrl(apiBaseUrl: string): string;
+//# sourceMappingURL=shareUrl.d.ts.map

package/dist/utils/shareUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shareUrl.d.ts","sourceRoot":"","sources":["../../src/utils/shareUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAiC5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,GACtB,iBAAiB,GAAG,IAAI,CA2B1B;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAUpD"}

package/dist/utils/shareUrl.js

@@ -0,0 +1,94 @@
+/**
+ * Share URL builder and parser for Sudojo puzzle sharing.
+ *
+ * - Daily puzzles share just `/daily`
+ * - Level/enter puzzles share `/play/puzzle?level=...&original=...&user=...&autopencilmarks=...&pencilmarks=...&hint=...`
+ *
+ * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)
+ * to keep URLs readable.
+ */
+const DEFAULT_DOMAIN = 'https://sudojo.com';
+/**
+ * Build a share URL from game state.
+ *
+ * Pencilmarks are appended directly to the URL (without URLSearchParams
+ * encoding) so commas remain as literal commas.
+ */
+export function buildShareUrl(params) {
+    const domain = params.domain ?? DEFAULT_DOMAIN;
+    if (params.type === 'daily') {
+        return `${domain}/daily`;
+    }
+    const searchParams = new URLSearchParams();
+    if (params.level != null) {
+        searchParams.set('level', String(params.level));
+    }
+    if (params.original) {
+        searchParams.set('original', params.original);
+    }
+    if (params.user) {
+        searchParams.set('user', params.user);
+    }
+    if (params.autopencilmarks != null) {
+        searchParams.set('autopencilmarks', String(params.autopencilmarks));
+    }
+    let url = `${domain}/play/puzzle?${searchParams.toString()}`;
+    // Append pencilmarks raw (commas don't need encoding in URLs)
+    if (params.pencilmarks != null) {
+        url += `&pencilmarks=${params.pencilmarks}`;
+    }
+    // Append hint step
+    if (params.hint != null) {
+        url += `&hint=${params.hint}`;
+    }
+    return url;
+}
+/**
+ * Parse share URL query parameters into game state.
+ * Returns null if required params (original, user) are missing.
+ */
+export function parseShareParams(params) {
+    const original = params.get('original');
+    const user = params.get('user');
+    if (!original || !user) {
+        return null;
+    }
+    const levelStr = params.get('level');
+    const hintStr = params.get('hint');
+    const result = {
+        original,
+        user,
+        pencilmarks: params.get('pencilmarks') ?? '',
+        autopencilmarks: params.get('autopencilmarks') === 'true',
+    };
+    if (levelStr) {
+        result.level = Number(levelStr);
+    }
+    if (hintStr != null) {
+        const hintNum = Number(hintStr);
+        if (!isNaN(hintNum) && hintNum >= 0) {
+            result.hint = hintNum;
+        }
+    }
+    return result;
+}
+/**
+ * Derive the web app URL from an API base URL.
+ *
+ * - Localhost: kept as-is (web app and API share the same server in dev)
+ * - Production: strips the `api.` subdomain
+ *   (e.g. `https://api.sudojo.com` → `https://sudojo.com`)
+ */
+export function getWebUrl(apiBaseUrl) {
+    try {
+        const url = new URL(apiBaseUrl);
+        if (url.hostname !== 'localhost' && url.hostname.startsWith('api.')) {
+            url.hostname = url.hostname.replace(/^api\./, '');
+        }
+        return url.origin;
+    }
+    catch {
+        return DEFAULT_DOMAIN;
+    }
+}
+//# sourceMappingURL=shareUrl.js.map

package/dist/utils/shareUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shareUrl.js","sourceRoot":"","sources":["../../src/utils/shareUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,cAAc,GAAG,oBAAoB,CAAC;AA6B5C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAE/C,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,MAAM,QAAQ,CAAC;IAC3B,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,MAAM,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;QACnC,YAAY,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,GAAG,GAAG,GAAG,MAAM,gBAAgB,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;IAE7D,8DAA8D;IAC9D,IAAI,MAAM,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAC/B,GAAG,IAAI,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC;IAC9C,CAAC;IACD,mBAAmB;IACnB,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,GAAG,IAAI,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAuB;IAEvB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAsB;QAChC,QAAQ;QACR,IAAI;QACJ,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE;QAC5C,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,MAAM;KAC1D,CAAC;IACF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Share URL builder and parser for Sudojo puzzle sharing.\n *\n * - Daily puzzles share just `/daily`\n * - Level/enter puzzles share `/play/puzzle?level=...&original=...&user=...&autopencilmarks=...&pencilmarks=...&hint=...`\n *\n * Pencilmarks are appended as a raw comma-separated string (not URL-encoded)\n * to keep URLs readable.\n */\n\nconst DEFAULT_DOMAIN = 'https://sudojo.com';\n\nexport interface ShareUrlParams {\n  type: 'daily' | 'puzzle';\n  /** 81-char original puzzle string */\n  original?: string;\n  /** 81-char user input string */\n  user?: string;\n  /** Comma-separated pencilmarks string (81 cells, 80 commas) */\n  pencilmarks?: string;\n  /** Whether auto-pencilmarks are enabled */\n  autopencilmarks?: boolean;\n  /** Difficulty level (1-based) */\n  level?: number;\n  /** Hint step index (0-based). Only included when hint is active. */\n  hint?: number;\n  /** Base domain (default: https://sudojo.com) */\n  domain?: string;\n}\n\nexport interface ParsedShareParams {\n  original: string;\n  user: string;\n  pencilmarks: string;\n  autopencilmarks: boolean;\n  level?: number;\n  hint?: number;\n}\n\n/**\n * Build a share URL from game state.\n *\n * Pencilmarks are appended directly to the URL (without URLSearchParams\n * encoding) so commas remain as literal commas.\n */\nexport function buildShareUrl(params: ShareUrlParams): string {\n  const domain = params.domain ?? DEFAULT_DOMAIN;\n\n  if (params.type === 'daily') {\n    return `${domain}/daily`;\n  }\n\n  const searchParams = new URLSearchParams();\n  if (params.level != null) {\n    searchParams.set('level', String(params.level));\n  }\n  if (params.original) {\n    searchParams.set('original', params.original);\n  }\n  if (params.user) {\n    searchParams.set('user', params.user);\n  }\n  if (params.autopencilmarks != null) {\n    searchParams.set('autopencilmarks', String(params.autopencilmarks));\n  }\n\n  let url = `${domain}/play/puzzle?${searchParams.toString()}`;\n\n  // Append pencilmarks raw (commas don't need encoding in URLs)\n  if (params.pencilmarks != null) {\n    url += `&pencilmarks=${params.pencilmarks}`;\n  }\n  // Append hint step\n  if (params.hint != null) {\n    url += `&hint=${params.hint}`;\n  }\n\n  return url;\n}\n\n/**\n * Parse share URL query parameters into game state.\n * Returns null if required params (original, user) are missing.\n */\nexport function parseShareParams(\n  params: URLSearchParams\n): ParsedShareParams | null {\n  const original = params.get('original');\n  const user = params.get('user');\n\n  if (!original || !user) {\n    return null;\n  }\n\n  const levelStr = params.get('level');\n  const hintStr = params.get('hint');\n\n  const result: ParsedShareParams = {\n    original,\n    user,\n    pencilmarks: params.get('pencilmarks') ?? '',\n    autopencilmarks: params.get('autopencilmarks') === 'true',\n  };\n  if (levelStr) {\n    result.level = Number(levelStr);\n  }\n  if (hintStr != null) {\n    const hintNum = Number(hintStr);\n    if (!isNaN(hintNum) && hintNum >= 0) {\n      result.hint = hintNum;\n    }\n  }\n  return result;\n}\n\n/**\n * Derive the web app URL from an API base URL.\n *\n * - Localhost: kept as-is (web app and API share the same server in dev)\n * - Production: strips the `api.` subdomain\n *   (e.g. `https://api.sudojo.com` → `https://sudojo.com`)\n */\nexport function getWebUrl(apiBaseUrl: string): string {\n  try {\n    const url = new URL(apiBaseUrl);\n    if (url.hostname !== 'localhost' && url.hostname.startsWith('api.')) {\n      url.hostname = url.hostname.replace(/^api\\./, '');\n    }\n    return url.origin;\n  } catch {\n    return DEFAULT_DOMAIN;\n  }\n}\n"]}

package/package.json

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