@sudobility/sudojo_lib 0.0.4

package/dist/utils/index.js

@@ -0,0 +1,23 @@
+/**
+ * Utility exports for Sudojo library
+ */
+// Board utilities (legacy - for useGame hook)
+export { BLOCK_SIZE, BOARD_SIZE, cloneBoard, countFilledCells, createGameBoard, getBlockCells, getBlockIndex, getBoardStateString, getColumnCells, getEmptyCells, getPencilmarksString, getRelatedCells, getRowCells, isValidPlacement, parseBoardString, stringifyBoard, TOTAL_CELLS, } from './board';
+// Scramble utilities (legacy - for useGame hook)
+export { noScramble, scrambleBoard } from './scramble';
+// Validation utilities (legacy - for useGame hook)
+export { autoRemovePencilmarks, clearHighlights, countMistakes, getIncorrectCells, getProgressPercentage, isBoardFilled, isCellCorrect, isGameComplete, isValueCorrect, updateCellErrors, updateCellHighlights, validateGameState, } from './validation';
+export { Scrambler, NonScrambler, scrambleBoard as scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, } from './sudokuScrambler';
+export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, } from './sudokuPresenter';
+// Time utilities
+export { formatTime, parseTime } from './time';
+// Progress utilities
+export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, } from './progress';
+// Auth utilities
+export { getFirebaseErrorMessage, getFirebaseErrorCode, formatFirebaseError, } from './auth';
+export { THEME_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './theme';
+// Subscription utilities
+export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, } from './subscription';
+// Technique utilities
+export { getTechniqueIconUrl, TECHNIQUE_TO_HELP_FILE, HELP_FILE_TO_TECHNIQUE, getHelpFileUrl, getTechniqueFromHelpFile, extractBodyContent, } from './technique';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,OAAO,EACL,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,iDAAiD;AACjD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvD,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,GAC1B,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;AAEpB,iBAAiB;AACjB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,QAAQ,CAAC;AAIhB,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,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

package/dist/utils/progress.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Progress calculation utilities
+ */
+import type { CompletedPuzzle, GameStats } from '../types/progress';
+/**
+ * Calculate game statistics from completed puzzles
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param newTime - Optional new time to include in calculations
+ * @returns Computed game statistics
+ */
+export declare function calculateStats(completedPuzzles: CompletedPuzzle[], newTime?: number): GameStats;
+/**
+ * Calculate daily streak based on completions
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param lastDailyDate - Date of last daily completion (YYYY-MM-DD)
+ * @returns Current streak count
+ */
+export declare function calculateStreak(completedPuzzles: CompletedPuzzle[], lastDailyDate: string | null): number;
+/**
+ * Check if a specific puzzle is completed
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param type - Puzzle type to check
+ * @param id - Puzzle ID to check
+ * @returns Whether the puzzle is completed
+ */
+export declare function isPuzzleCompleted(completedPuzzles: CompletedPuzzle[], type: 'daily' | 'level', id: string): boolean;
+/**
+ * Get completed level IDs
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @returns Array of completed level IDs
+ */
+export declare function getCompletedLevelIds(completedPuzzles: CompletedPuzzle[]): string[];
+/**
+ * Get completed daily dates
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @returns Array of completed daily dates (YYYY-MM-DD)
+ */
+export declare function getCompletedDailyDates(completedPuzzles: CompletedPuzzle[]): string[];
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,eAAe,EAAE,EACnC,OAAO,CAAC,EAAE,MAAM,GACf,SAAS,CAqCX;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,eAAe,EAAE,EACnC,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,CAoCR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,eAAe,EAAE,EACnC,IAAI,EAAE,OAAO,GAAG,OAAO,EACvB,EAAE,EAAE,MAAM,GACT,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,eAAe,EAAE,GAClC,MAAM,EAAE,CAEV;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,eAAe,EAAE,GAClC,MAAM,EAAE,CAEV"}

package/dist/utils/progress.js

@@ -0,0 +1,104 @@
+/**
+ * Progress calculation utilities
+ */
+/**
+ * Calculate game statistics from completed puzzles
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param newTime - Optional new time to include in calculations
+ * @returns Computed game statistics
+ */
+export function calculateStats(completedPuzzles, newTime) {
+    const puzzlesWithTime = completedPuzzles.filter(p => p.timeSeconds !== undefined);
+    // Calculate total time
+    const totalTimePlayed = puzzlesWithTime.reduce((sum, p) => sum + (p.timeSeconds ?? 0), 0) +
+        (newTime ?? 0);
+    // Calculate average time
+    const count = puzzlesWithTime.length + (newTime !== undefined ? 1 : 0);
+    const averageTime = count > 0 ? Math.round(totalTimePlayed / count) : null;
+    // Calculate best times by type
+    const dailyTimes = completedPuzzles
+        .filter((p) => p.type === 'daily' && p.timeSeconds !== undefined)
+        .map(p => p.timeSeconds);
+    const levelTimes = completedPuzzles
+        .filter((p) => p.type === 'level' && p.timeSeconds !== undefined)
+        .map(p => p.timeSeconds);
+    const bestDailyTime = dailyTimes.length > 0 ? Math.min(...dailyTimes) : null;
+    const bestLevelTime = levelTimes.length > 0 ? Math.min(...levelTimes) : null;
+    return {
+        bestDailyTime,
+        bestLevelTime,
+        averageTime,
+        totalTimePlayed,
+    };
+}
+/**
+ * Calculate daily streak based on completions
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param lastDailyDate - Date of last daily completion (YYYY-MM-DD)
+ * @returns Current streak count
+ */
+export function calculateStreak(completedPuzzles, lastDailyDate) {
+    if (!lastDailyDate)
+        return 0;
+    const today = new Date().toISOString().split('T')[0];
+    const yesterday = new Date(Date.now() - 86400000).toISOString().split('T')[0];
+    // If last daily wasn't today or yesterday, streak is broken
+    if (lastDailyDate !== today && lastDailyDate !== yesterday) {
+        return 0;
+    }
+    // Count consecutive days
+    const dailyDates = completedPuzzles
+        .filter(p => p.type === 'daily')
+        .map(p => p.id)
+        .sort()
+        .reverse();
+    let streak = 0;
+    let currentDate = lastDailyDate === today ? today : yesterday;
+    for (const date of dailyDates) {
+        if (currentDate === undefined)
+            break;
+        if (date === currentDate) {
+            streak++;
+            // Go back one day
+            const previousDay = new Date(currentDate);
+            previousDay.setDate(previousDay.getDate() - 1);
+            currentDate = previousDay.toISOString().split('T')[0];
+        }
+        else if (date < currentDate) {
+            break;
+        }
+    }
+    return streak;
+}
+/**
+ * Check if a specific puzzle is completed
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @param type - Puzzle type to check
+ * @param id - Puzzle ID to check
+ * @returns Whether the puzzle is completed
+ */
+export function isPuzzleCompleted(completedPuzzles, type, id) {
+    return completedPuzzles.some(p => p.type === type && p.id === id);
+}
+/**
+ * Get completed level IDs
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @returns Array of completed level IDs
+ */
+export function getCompletedLevelIds(completedPuzzles) {
+    return completedPuzzles.filter(p => p.type === 'level').map(p => p.id);
+}
+/**
+ * Get completed daily dates
+ *
+ * @param completedPuzzles - Array of completed puzzle records
+ * @returns Array of completed daily dates (YYYY-MM-DD)
+ */
+export function getCompletedDailyDates(completedPuzzles) {
+    return completedPuzzles.filter(p => p.type === 'daily').map(p => p.id);
+}
+//# sourceMappingURL=progress.js.map

package/dist/utils/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,gBAAmC,EACnC,OAAgB;IAEhB,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,SAAS,CACjC,CAAC;IAEF,uBAAuB;IACvB,MAAM,eAAe,GACnB,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAEjB,yBAAyB;IACzB,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3E,+BAA+B;IAC/B,MAAM,UAAU,GAAG,gBAAgB;SAChC,MAAM,CACL,CAAC,CAAC,EAAkD,EAAE,CACpD,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,CACpD;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3B,MAAM,UAAU,GAAG,gBAAgB;SAChC,MAAM,CACL,CAAC,CAAC,EAAkD,EAAE,CACpD,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,CACpD;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IAE3B,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE7E,OAAO;QACL,aAAa;QACb,aAAa;QACb,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,gBAAmC,EACnC,aAA4B;IAE5B,IAAI,CAAC,aAAa;QAAE,OAAO,CAAC,CAAC;IAE7B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,4DAA4D;IAC5D,IAAI,aAAa,KAAK,KAAK,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,gBAAgB;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACd,IAAI,EAAE;SACN,OAAO,EAAE,CAAC;IAEb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,WAAW,GACb,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM;QACrC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC;YACT,kBAAkB;YAClB,MAAM,WAAW,GAAS,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC;YAChD,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;YAC/C,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,IAAI,GAAG,WAAW,EAAE,CAAC;YAC9B,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAmC,EACnC,IAAuB,EACvB,EAAU;IAEV,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAmC;IAEnC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,gBAAmC;IAEnC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/utils/scramble.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Board scrambling utilities for creating visually different but equivalent puzzles
+ *
+ * Scrambling preserves the logical structure of a Sudoku puzzle while making it
+ * appear different. This is useful for:
+ * - Preventing players from recognizing puzzles they've seen before
+ * - Creating variety from a limited puzzle database
+ * - Making it harder to look up solutions online
+ */
+import type { ScrambleConfig, ScrambleResult } from '../types';
+/**
+ * Scrambles a Sudoku board while preserving its logical structure
+ *
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @param config - Scramble configuration (defaults to all transformations enabled)
+ * @returns Scramble result with scrambled puzzle, solution, and digit mapping
+ *
+ * @example
+ * ```typescript
+ * const result = scrambleBoard(puzzle, solution);
+ * console.log(result.puzzle);      // Scrambled puzzle
+ * console.log(result.solution);    // Scrambled solution
+ * console.log(result.digitMapping); // Map from original to scrambled digits
+ * ```
+ */
+export declare function scrambleBoard(puzzle: string, solution: string, config?: ScrambleConfig): ScrambleResult;
+/**
+ * Creates an identity scramble result (no scrambling)
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @returns ScrambleResult with identity mapping
+ */
+export declare function noScramble(puzzle: string, solution: string): ScrambleResult;
+//# sourceMappingURL=scramble.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scramble.d.ts","sourceRoot":"","sources":["../../src/utils/scramble.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA2G/D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAwC,GAC/C,cAAc,CA4JhB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAY3E"}

package/dist/utils/scramble.js

@@ -0,0 +1,270 @@
+/**
+ * Board scrambling utilities for creating visually different but equivalent puzzles
+ *
+ * Scrambling preserves the logical structure of a Sudoku puzzle while making it
+ * appear different. This is useful for:
+ * - Preventing players from recognizing puzzles they've seen before
+ * - Creating variety from a limited puzzle database
+ * - Making it harder to look up solutions online
+ */
+import { DEFAULT_SCRAMBLE_CONFIG } from '../types';
+import { BLOCK_SIZE, BOARD_SIZE, parseBoardString, stringifyBoard, } from './board';
+/**
+ * Fisher-Yates shuffle algorithm for arrays
+ * @param array - Array to shuffle in place
+ * @returns The shuffled array
+ */
+function shuffleArray(array) {
+    for (let i = array.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const temp = array[i];
+        array[i] = array[j];
+        array[j] = temp;
+    }
+    return array;
+}
+/**
+ * Creates a random digit mapping (1-9 -> 1-9)
+ * @returns Map from original digit to scrambled digit
+ */
+function createDigitMapping() {
+    const digits = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+    const shuffled = shuffleArray([...digits]);
+    const mapping = new Map();
+    for (let i = 0; i < digits.length; i++) {
+        mapping.set(digits[i], shuffled[i]);
+    }
+    return mapping;
+}
+/**
+ * Creates the reverse of a digit mapping
+ * @param mapping - Original digit mapping
+ * @returns Reverse mapping (scrambled -> original)
+ */
+function reverseDigitMapping(mapping) {
+    const reverse = new Map();
+    for (const [original, scrambled] of mapping) {
+        reverse.set(scrambled, original);
+    }
+    return reverse;
+}
+/**
+ * Applies digit mapping to a board
+ * @param board - 9x9 number array
+ * @param mapping - Digit mapping
+ * @returns New board with mapped digits
+ */
+function applyDigitMapping(board, mapping) {
+    return board.map(row => row.map(value => {
+        if (value === 0)
+            return 0;
+        return mapping.get(value) ?? value;
+    }));
+}
+/**
+ * Rotates the board 90 degrees clockwise
+ * @param board - Board to rotate
+ * @returns New rotated board
+ */
+function rotateBoard90(board) {
+    const rotated = [];
+    for (let col = 0; col < BOARD_SIZE; col++) {
+        const newRow = [];
+        for (let row = BOARD_SIZE - 1; row >= 0; row--) {
+            newRow.push(board[row]?.[col] ?? 0);
+        }
+        rotated.push(newRow);
+    }
+    return rotated;
+}
+/**
+ * Mirrors the board horizontally (left-right)
+ * @param board - Board to mirror
+ * @returns New mirrored board
+ */
+function mirrorHorizontally(board) {
+    return board.map(row => [...row].reverse());
+}
+/**
+ * Mirrors the board vertically (top-bottom)
+ * @param board - Board to mirror
+ * @returns New mirrored board
+ */
+function mirrorVertically(board) {
+    return [...board].reverse().map(row => [...row]);
+}
+/**
+ * Scrambles a Sudoku board while preserving its logical structure
+ *
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @param config - Scramble configuration (defaults to all transformations enabled)
+ * @returns Scramble result with scrambled puzzle, solution, and digit mapping
+ *
+ * @example
+ * ```typescript
+ * const result = scrambleBoard(puzzle, solution);
+ * console.log(result.puzzle);      // Scrambled puzzle
+ * console.log(result.solution);    // Scrambled solution
+ * console.log(result.digitMapping); // Map from original to scrambled digits
+ * ```
+ */
+export function scrambleBoard(puzzle, solution, config = DEFAULT_SCRAMBLE_CONFIG) {
+    // Parse the boards
+    let puzzleBoard = parseBoardString(puzzle);
+    let solutionBoard = parseBoardString(solution);
+    // Create digit mapping (applied to both puzzle and solution)
+    let digitMapping = new Map();
+    for (let i = 1; i <= 9; i++) {
+        digitMapping.set(i, i); // Identity mapping by default
+    }
+    if (config.scrambleDigits) {
+        digitMapping = createDigitMapping();
+        puzzleBoard = applyDigitMapping(puzzleBoard, digitMapping);
+        solutionBoard = applyDigitMapping(solutionBoard, digitMapping);
+    }
+    // Scramble rows within blocks
+    if (config.scrambleRows) {
+        // We need to apply the same transformation to both boards
+        // Generate the permutation first, then apply to both
+        const rowPermutations = [];
+        for (let blockRow = 0; blockRow < BLOCK_SIZE; blockRow++) {
+            rowPermutations.push(shuffleArray([0, 1, 2]));
+        }
+        const applyRowPermutation = (board) => {
+            for (let blockRow = 0; blockRow < BLOCK_SIZE; blockRow++) {
+                const startRow = blockRow * BLOCK_SIZE;
+                const perm = rowPermutations[blockRow];
+                const rowsCopy = [
+                    [...(board[startRow] ?? [])],
+                    [...(board[startRow + 1] ?? [])],
+                    [...(board[startRow + 2] ?? [])],
+                ];
+                for (let i = 0; i < BLOCK_SIZE; i++) {
+                    board[startRow + i] = rowsCopy[perm[i]];
+                }
+            }
+        };
+        applyRowPermutation(puzzleBoard);
+        applyRowPermutation(solutionBoard);
+    }
+    // Scramble columns within blocks
+    if (config.scrambleColumns) {
+        const colPermutations = [];
+        for (let blockCol = 0; blockCol < BLOCK_SIZE; blockCol++) {
+            colPermutations.push(shuffleArray([0, 1, 2]));
+        }
+        const applyColPermutation = (board) => {
+            for (let blockCol = 0; blockCol < BLOCK_SIZE; blockCol++) {
+                const startCol = blockCol * BLOCK_SIZE;
+                const perm = colPermutations[blockCol];
+                for (let row = 0; row < BOARD_SIZE; row++) {
+                    const boardRow = board[row];
+                    if (boardRow) {
+                        const colsCopy = [
+                            boardRow[startCol],
+                            boardRow[startCol + 1],
+                            boardRow[startCol + 2],
+                        ];
+                        for (let i = 0; i < BLOCK_SIZE; i++) {
+                            boardRow[startCol + i] = colsCopy[perm[i]];
+                        }
+                    }
+                }
+            }
+        };
+        applyColPermutation(puzzleBoard);
+        applyColPermutation(solutionBoard);
+    }
+    // Scramble row blocks
+    if (config.scrambleRowBlocks) {
+        const blockOrder = shuffleArray([0, 1, 2]);
+        const applyRowBlockPermutation = (board) => {
+            const allRows = board.map(row => [...row]);
+            const result = [];
+            for (let newBlockIndex = 0; newBlockIndex < BLOCK_SIZE; newBlockIndex++) {
+                const oldBlockIndex = blockOrder[newBlockIndex];
+                for (let i = 0; i < BLOCK_SIZE; i++) {
+                    result.push(allRows[oldBlockIndex * BLOCK_SIZE + i]);
+                }
+            }
+            return result;
+        };
+        puzzleBoard = applyRowBlockPermutation(puzzleBoard);
+        solutionBoard = applyRowBlockPermutation(solutionBoard);
+    }
+    // Scramble column blocks
+    if (config.scrambleColumnBlocks) {
+        const blockOrder = shuffleArray([0, 1, 2]);
+        const applyColBlockPermutation = (board) => {
+            const result = board.map(() => new Array(BOARD_SIZE).fill(0));
+            for (let newBlockIndex = 0; newBlockIndex < BLOCK_SIZE; newBlockIndex++) {
+                const oldBlockIndex = blockOrder[newBlockIndex];
+                for (let i = 0; i < BLOCK_SIZE; i++) {
+                    const oldCol = oldBlockIndex * BLOCK_SIZE + i;
+                    const newCol = newBlockIndex * BLOCK_SIZE + i;
+                    for (let row = 0; row < BOARD_SIZE; row++) {
+                        const resultRow = result[row];
+                        if (resultRow) {
+                            resultRow[newCol] = board[row]?.[oldCol] ?? 0;
+                        }
+                    }
+                }
+            }
+            return result;
+        };
+        puzzleBoard = applyColBlockPermutation(puzzleBoard);
+        solutionBoard = applyColBlockPermutation(solutionBoard);
+    }
+    // Rotate
+    if (config.rotate) {
+        const rotations = Math.floor(Math.random() * 4);
+        for (let i = 0; i < rotations; i++) {
+            puzzleBoard = rotateBoard90(puzzleBoard);
+            solutionBoard = rotateBoard90(solutionBoard);
+        }
+    }
+    // Mirror
+    if (config.mirror) {
+        const mirrorType = Math.floor(Math.random() * 4);
+        const applyMirror = (board) => {
+            switch (mirrorType) {
+                case 1:
+                    return mirrorHorizontally(board);
+                case 2:
+                    return mirrorVertically(board);
+                case 3:
+                    return mirrorVertically(mirrorHorizontally(board));
+                default:
+                    return board;
+            }
+        };
+        puzzleBoard = applyMirror(puzzleBoard);
+        solutionBoard = applyMirror(solutionBoard);
+    }
+    return {
+        puzzle: stringifyBoard(puzzleBoard),
+        solution: stringifyBoard(solutionBoard),
+        digitMapping,
+        reverseDigitMapping: reverseDigitMapping(digitMapping),
+    };
+}
+/**
+ * Creates an identity scramble result (no scrambling)
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @returns ScrambleResult with identity mapping
+ */
+export function noScramble(puzzle, solution) {
+    const identityMapping = new Map();
+    for (let i = 1; i <= 9; i++) {
+        identityMapping.set(i, i);
+    }
+    return {
+        puzzle,
+        solution,
+        digitMapping: identityMapping,
+        reverseDigitMapping: identityMapping,
+    };
+}
+//# sourceMappingURL=scramble.js.map

package/dist/utils/scramble.js.map

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

package/dist/utils/subscription.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Subscription utilities
+ *
+ * These functions work with RevenueCat SDK types to convert to our domain models.
+ * The RevenueCat types are passed as generics to avoid direct SDK dependency.
+ */
+import type { Product, Subscription } from '../types/subscription';
+/** RevenueCat Package shape (simplified) */
+interface RevenueCatPackage {
+    identifier: string;
+    rcBillingProduct?: {
+        identifier?: string;
+        title?: string;
+        description?: string;
+        currentPrice?: {
+            amountMicros?: number;
+            formattedPrice?: string;
+        };
+        normalPeriodDuration?: string;
+        defaultSubscriptionOption?: {
+            introPrice?: {
+                price?: {
+                    formattedPrice?: string;
+                };
+                periodDuration?: string;
+            };
+            trial?: {
+                periodDuration?: string;
+            };
+        };
+    };
+}
+/** RevenueCat CustomerInfo entitlement shape */
+interface RevenueCatEntitlement {
+    expirationDate?: number | null;
+    latestPurchaseDate?: number | null;
+    productIdentifier?: string;
+    willRenew?: boolean;
+}
+/** RevenueCat CustomerInfo shape (simplified) */
+interface RevenueCatCustomerInfo {
+    entitlements: {
+        active: Record<string, RevenueCatEntitlement>;
+    };
+}
+/**
+ * Convert RevenueCat package to our Product interface
+ *
+ * @param pkg - RevenueCat package
+ * @returns Product object
+ */
+export declare function convertPackageToProduct(pkg: RevenueCatPackage): Product;
+/**
+ * Parse RevenueCat CustomerInfo into our Subscription interface
+ *
+ * @param customerInfo - RevenueCat customer info
+ * @returns Subscription object
+ */
+export declare function parseCustomerInfo(customerInfo: RevenueCatCustomerInfo): Subscription;
+/**
+ * Get display name for subscription period
+ *
+ * @param period - ISO 8601 duration string (e.g., "P1M", "P1Y")
+ * @returns Human-readable period name
+ */
+export declare function getPeriodDisplayName(period: string | undefined): string;
+/**
+ * Check if a plan is the "best value" (typically annual plans)
+ *
+ * @param period - ISO 8601 duration string
+ * @returns Whether this is typically the best value option
+ */
+export declare function isBestValuePlan(period: string | undefined): boolean;
+/**
+ * Get RevenueCat purchase error message
+ *
+ * @param errorCode - RevenueCat error code
+ * @returns User-friendly error message
+ */
+export declare function getRevenueCatErrorMessage(errorCode: number): string;
+export {};
+//# sourceMappingURL=subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEnE,4CAA4C;AAC5C,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE;YACb,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,CAAC;QACF,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,yBAAyB,CAAC,EAAE;YAC1B,UAAU,CAAC,EAAE;gBACX,KAAK,CAAC,EAAE;oBACN,cAAc,CAAC,EAAE,MAAM,CAAC;iBACzB,CAAC;gBACF,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;YACF,KAAK,CAAC,EAAE;gBACN,cAAc,CAAC,EAAE,MAAM,CAAC;aACzB,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,gDAAgD;AAChD,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,UAAU,sBAAsB;IAC9B,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;KAC/C,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CA+BvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,sBAAsB,GACnC,YAAY,CA2Bd;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAavE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAanE"}