@sudobility/sudojo_lib 0.0.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"sudokuScrambler.d.ts","sourceRoot":"","sources":["../../src/utils/sudokuScrambler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMnE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;CAC3C;AA2BD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,iBAsBvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,iBAI1B,CAAC;AAsBF,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,2DAA2D;IAC3D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uDAAuD;IACvD,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,UAAU,EAAE,EACnB,WAAW,GAAE,OAAe,GAC3B,cAAc,CAuChB;AAkCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,EAAE,CA2Bd;AAYD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAUpE"}

package/dist/utils/sudokuScrambler.js

@@ -0,0 +1,223 @@
+/**
+ * Sudoku board scrambler - ported from renderable/utils/Scrambler.kt
+ *
+ * Generates permutations for rows, columns, and digits to create unique puzzles
+ * while preserving Sudoku validity.
+ */
+import { columnOf, rowOf } from '../types/sudoku';
+// =============================================================================
+// Random Utilities
+// =============================================================================
+/**
+ * Simple seeded random number generator
+ */
+class SeededRandom {
+    constructor(seed) {
+        this.seed = seed;
+    }
+    nextInt() {
+        // Linear congruential generator
+        this.seed = (this.seed * 1664525 + 1013904223) >>> 0;
+        return this.seed;
+    }
+}
+// =============================================================================
+// Main Scrambler
+// =============================================================================
+/**
+ * Scrambler implementation that matches the Kotlin version
+ */
+export const Scrambler = {
+    scramble9(symmetrical) {
+        const random = new SeededRandom(Math.floor(Date.now() / 1000));
+        const block0 = scramble3(symmetrical, random);
+        const block1 = scramble3(symmetrical, random);
+        const block2 = symmetrical ? block0 : scramble3(symmetrical, random);
+        const blocks = [block0, block1, block2];
+        const board = scramble3(symmetrical, random);
+        const result = [];
+        for (let i = 0; i < 3; i++) {
+            const target = board[i] ?? 0;
+            const block = blocks[i] ?? [0, 1, 2];
+            for (let j = 0; j < 3; j++) {
+                result.push(target * 3 + (block[j] ?? 0));
+            }
+        }
+        return result;
+    },
+};
+/**
+ * Non-scrambler that returns identity permutation
+ */
+export const NonScrambler = {
+    scramble9(_symmetrical) {
+        return [0, 1, 2, 3, 4, 5, 6, 7, 8];
+    },
+};
+/**
+ * Generates a permutation of [0, 1, 2]
+ */
+function scramble3(symmetrical, random) {
+    if (symmetrical) {
+        const seed = random.nextInt();
+        // 50% chance for identity or reverse
+        return seed % 2 === 0 ? [0, 1, 2] : [2, 1, 0];
+    }
+    else {
+        // Generate 3 random values and sort to get permutation
+        const values = [random.nextInt(), random.nextInt(), random.nextInt()];
+        const sorted = [...values].sort((a, b) => a - b);
+        return sorted.map(v => values.indexOf(v));
+    }
+}
+/**
+ * Scramble a board using the given scrambler
+ *
+ * @param scrambler - Scrambler protocol implementation
+ * @param cells - Original 81 cells
+ * @param symmetrical - Whether to use symmetrical scrambling
+ * @returns Scrambled cells and digit mapping
+ */
+export function scrambleBoard(scrambler, cells, symmetrical = false) {
+    const rows = scrambler.scramble9(symmetrical);
+    const columns = scrambler.scramble9(symmetrical);
+    const numbers = scrambler.scramble9(symmetrical);
+    // Create digit mapping (1-based to 1-based)
+    const digitMapping = new Map();
+    const reverseDigitMapping = new Map();
+    for (let i = 0; i < 9; i++) {
+        const original = i + 1;
+        const scrambled = (numbers[i] ?? i) + 1;
+        digitMapping.set(original, scrambled);
+        reverseDigitMapping.set(scrambled, original);
+    }
+    const scrambledCells = Array.from({ length: 81 }, (_, index) => {
+        const x = columnOf(index);
+        const y = rowOf(index);
+        const scrambledY = rows[y] ?? y;
+        const scrambledX = columns[x] ?? x;
+        const existing = cells[scrambledY * 9 + scrambledX];
+        if (!existing) {
+            throw new Error(`Missing cell at index ${scrambledY * 9 + scrambledX}`);
+        }
+        return {
+            index,
+            solution: mapDigit(existing.solution, numbers),
+            given: mapDigit(existing.given, numbers),
+            input: mapDigit(existing.input, numbers),
+            pencilmarks: mapPencilmarks(existing.pencilmarks, numbers),
+        };
+    });
+    return {
+        cells: scrambledCells,
+        digitMapping,
+        reverseDigitMapping,
+    };
+}
+/**
+ * Map a digit using the lookup array
+ * @param digit - Original digit (1-9) or null
+ * @param lookup - Permutation array (0-indexed, returns 0-indexed)
+ * @returns Mapped digit (1-9) or null
+ */
+function mapDigit(digit, lookup) {
+    if (digit === null || digit === 0)
+        return null;
+    // digit is 1-based, lookup is 0-indexed
+    const mapped = lookup[digit - 1];
+    return mapped !== undefined ? mapped + 1 : digit;
+}
+/**
+ * Map pencilmarks array using the lookup array
+ * Matches Kotlin: map(digits: Array<Int>?, lookup: Array<Int>?): Array<Int>?
+ */
+function mapPencilmarks(pencilmarks, lookup) {
+    if (pencilmarks === null)
+        return null;
+    return pencilmarks
+        .map(digit => mapDigit(digit, lookup))
+        .filter((d) => d !== null)
+        .sort((a, b) => a - b);
+}
+// =============================================================================
+// Board Parsing
+// =============================================================================
+/**
+ * Parse a puzzle string (81 chars of 0-9 or .) into cells
+ *
+ * @param puzzle - 81 character string
+ * @param solution - 81 character solution string (optional)
+ * @returns Array of 81 cells
+ */
+export function parsePuzzleString(puzzle, solution) {
+    if (puzzle.length !== 81) {
+        throw new Error(`Invalid puzzle string length: ${puzzle.length}`);
+    }
+    if (solution && solution.length !== 81) {
+        throw new Error(`Invalid solution string length: ${solution.length}`);
+    }
+    return Array.from({ length: 81 }, (_, index) => {
+        const givenChar = puzzle[index];
+        if (givenChar === undefined) {
+            throw new Error(`Missing puzzle character at index ${index}`);
+        }
+        const givenDigit = parseDigit(givenChar);
+        const solutionChar = solution?.[index];
+        const solutionDigit = solutionChar ? parseDigit(solutionChar) : null;
+        return {
+            index,
+            solution: solutionDigit,
+            given: givenDigit,
+            input: null,
+            pencilmarks: null,
+        };
+    });
+}
+/**
+ * Parse a character to a digit (1-9) or null
+ */
+function parseDigit(char) {
+    if (char === '0' || char === '.')
+        return null;
+    const digit = parseInt(char, 10);
+    if (digit >= 1 && digit <= 9)
+        return digit;
+    return null;
+}
+/**
+ * Convert cells to puzzle string
+ */
+export function cellsToPuzzleString(cells) {
+    return cells.map(cell => cell.given?.toString() ?? '0').join('');
+}
+/**
+ * Convert cells to current state string (given + input)
+ */
+export function cellsToStateString(cells) {
+    return cells
+        .map(cell => (cell.given ?? cell.input)?.toString() ?? '0')
+        .join('');
+}
+/**
+ * Convert cells to input-only string
+ */
+export function cellsToInputString(cells) {
+    return cells.map(cell => cell.input?.toString() ?? '0').join('');
+}
+/**
+ * Convert cells to pencilmarks string (comma-separated)
+ * Matches Kotlin: pencilmarksParam - returns empty string for null pencilmarks
+ */
+export function cellsToPencilmarksString(cells) {
+    return cells
+        .map(cell => {
+        if (cell.pencilmarks !== null) {
+            return cell.pencilmarks.join('');
+        }
+        else {
+            return '';
+        }
+    })
+        .join(',');
+}
+//# sourceMappingURL=sudokuScrambler.js.map

package/dist/utils/sudokuScrambler.js.map

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

package/dist/utils/technique.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Technique-related utilities
+ */
+/**
+ * Convert technique title to icon filename
+ *
+ * @param title - Technique title (e.g., "Full House", "X-Wing")
+ * @returns Icon URL path
+ *
+ * @example
+ * getTechniqueIconUrl("Full House") // "/technique.full.house.svg"
+ * getTechniqueIconUrl("X-Wing") // "/technique.x.wing.svg"
+ * getTechniqueIconUrl("XY-Wing") // "/technique.xy.wing.svg"
+ */
+export declare function getTechniqueIconUrl(title: string): string;
+/** Map technique titles to HTML help file paths */
+export declare const TECHNIQUE_TO_HELP_FILE: Record<string, string>;
+/** Reverse mapping: HTML file name (lowercase) -> technique title */
+export declare const HELP_FILE_TO_TECHNIQUE: Record<string, string>;
+/**
+ * Get help file URL for a technique
+ *
+ * @param techniqueTitle - Technique title
+ * @returns Help file URL path or generated path if not in mapping
+ */
+export declare function getHelpFileUrl(techniqueTitle: string): string;
+/**
+ * Get technique title from help file name
+ *
+ * @param fileName - Help file name (e.g., "Full_House.html")
+ * @returns Technique title or undefined if not found
+ */
+export declare function getTechniqueFromHelpFile(fileName: string): string | undefined;
+/**
+ * Extract body content from HTML and clean up navigation links
+ *
+ * @param html - Raw HTML string
+ * @returns Cleaned HTML body content
+ */
+export declare function extractBodyContent(html: string): string;
+//# sourceMappingURL=technique.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"technique.d.ts","sourceRoot":"","sources":["../../src/utils/technique.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyBzD,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBvD"}

package/dist/utils/technique.js

@@ -0,0 +1,106 @@
+/**
+ * Technique-related utilities
+ */
+/**
+ * Convert technique title to icon filename
+ *
+ * @param title - Technique title (e.g., "Full House", "X-Wing")
+ * @returns Icon URL path
+ *
+ * @example
+ * getTechniqueIconUrl("Full House") // "/technique.full.house.svg"
+ * getTechniqueIconUrl("X-Wing") // "/technique.x.wing.svg"
+ * getTechniqueIconUrl("XY-Wing") // "/technique.xy.wing.svg"
+ */
+export function getTechniqueIconUrl(title) {
+    const normalized = title
+        .toLowerCase()
+        .replace(/\s+/g, '.') // spaces to dots
+        .replace(/-/g, '.'); // hyphens to dots
+    return `/technique.${normalized}.svg`;
+}
+/** Map technique titles to HTML help file paths */
+export const TECHNIQUE_TO_HELP_FILE = {
+    'Full House': 'Full_House.html',
+    'Naked Single': 'Naked_Single.html',
+    'Hidden Single': 'Hidden_Single.html',
+    'Naked Pair': 'Naked_Pair.html',
+    'Hidden Pair': 'Hidden_Pair.html',
+    'Locked Candidates': 'Locked_Candidates.html',
+    'Naked Triple': 'Naked_Triple.html',
+    'Hidden Triple': 'Hidden_Triple.html',
+    'Naked Quad': 'Nakded_Quad.html', // Note: typo in original file name
+    'Hidden Quad': 'Hidden_Quad.html',
+    'X-Wing': 'X-Wing.html',
+    Swordfish: 'Swordfish.html',
+    Jellyfish: 'Jellyfish.html',
+    Squirmbag: 'Squirmbag.html',
+    'XY-Wing': 'XY-Wing.html',
+    'XYZ-Wing': 'XYZ-Wing.html',
+    'WXYZ-Wing': 'WXYZ-Wing.html',
+    'Finned X-Wing': 'Finned_X-Wing.html',
+    'Finned Swordfish': 'Finned_Swordfish.html',
+    'Finned Jellyfish': 'Finned_Jellyfish.html',
+    'Finned Squirmbag': 'Finned_Squirmbag.html',
+    'Almost Locked Sets': 'Almost_Locked_Sets.html',
+    'ALS Chain': 'ALS-Chain.html',
+    'ALS-Chain': 'ALS-Chain.html',
+};
+/** Reverse mapping: HTML file name (lowercase) -> technique title */
+export const HELP_FILE_TO_TECHNIQUE = Object.entries(TECHNIQUE_TO_HELP_FILE).reduce((acc, [title, file]) => {
+    acc[file.toLowerCase()] = title;
+    return acc;
+}, {});
+/**
+ * Get help file URL for a technique
+ *
+ * @param techniqueTitle - Technique title
+ * @returns Help file URL path or generated path if not in mapping
+ */
+export function getHelpFileUrl(techniqueTitle) {
+    const fileName = TECHNIQUE_TO_HELP_FILE[techniqueTitle];
+    if (fileName) {
+        return `/help/${fileName}`;
+    }
+    // Try to generate file name from title (spaces to underscores, preserve hyphens)
+    const generatedFileName = `${techniqueTitle.replace(/\s+/g, '_')}.html`;
+    return `/help/${generatedFileName}`;
+}
+/**
+ * Get technique title from help file name
+ *
+ * @param fileName - Help file name (e.g., "Full_House.html")
+ * @returns Technique title or undefined if not found
+ */
+export function getTechniqueFromHelpFile(fileName) {
+    return HELP_FILE_TO_TECHNIQUE[fileName.toLowerCase()];
+}
+/**
+ * Extract body content from HTML and clean up navigation links
+ *
+ * @param html - Raw HTML string
+ * @returns Cleaned HTML body content
+ */
+export function extractBodyContent(html) {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(html, 'text/html');
+    // Remove "Back to Course Catalog" links
+    const links = doc.querySelectorAll('a[href="index.html"]');
+    links.forEach(link => {
+        const parent = link.closest('tr') ?? link.closest('td') ?? link.parentElement;
+        if (parent) {
+            parent.remove();
+        }
+    });
+    // Fix image paths - convert relative paths to absolute /help/ paths
+    const images = doc.querySelectorAll('img');
+    images.forEach(img => {
+        const src = img.getAttribute('src');
+        if (src && !src.startsWith('/') && !src.startsWith('http')) {
+            img.setAttribute('src', `/help/${src}`);
+        }
+    });
+    // Get the body content
+    return doc.body.innerHTML;
+}
+//# sourceMappingURL=technique.js.map

package/dist/utils/technique.js.map

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

package/dist/utils/theme.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Theme utilities
+ */
+/** Available theme options */
+export type ThemePreference = 'light' | 'dark' | 'system';
+/** Resolved theme (without system option) */
+export type ResolvedTheme = 'light' | 'dark';
+/** Storage key for theme preference */
+export declare const THEME_STORAGE_KEY = "sudojo-theme";
+/**
+ * Detect system color scheme preference
+ *
+ * @returns 'dark' if system prefers dark mode, 'light' otherwise
+ */
+export declare function getSystemTheme(): ResolvedTheme;
+/**
+ * Resolve theme preference to actual theme
+ *
+ * @param preference - User's theme preference
+ * @param systemTheme - Current system theme
+ * @returns Resolved theme ('light' or 'dark')
+ */
+export declare function resolveTheme(preference: ThemePreference, systemTheme: ResolvedTheme): ResolvedTheme;
+/**
+ * Check if a value is a valid theme preference
+ *
+ * @param value - Value to check
+ * @returns Whether value is a valid theme preference
+ */
+export declare function isValidThemePreference(value: unknown): value is ThemePreference;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,uCAAuC;AACvC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAK9C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,aAAa,GACzB,aAAa,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,eAAe,CAE1B"}

package/dist/utils/theme.js

@@ -0,0 +1,40 @@
+/**
+ * Theme utilities
+ */
+/** Storage key for theme preference */
+export const THEME_STORAGE_KEY = 'sudojo-theme';
+/**
+ * Detect system color scheme preference
+ *
+ * @returns 'dark' if system prefers dark mode, 'light' otherwise
+ */
+export function getSystemTheme() {
+    if (typeof window === 'undefined')
+        return 'light';
+    return window.matchMedia('(prefers-color-scheme: dark)').matches
+        ? 'dark'
+        : 'light';
+}
+/**
+ * Resolve theme preference to actual theme
+ *
+ * @param preference - User's theme preference
+ * @param systemTheme - Current system theme
+ * @returns Resolved theme ('light' or 'dark')
+ */
+export function resolveTheme(preference, systemTheme) {
+    if (preference === 'system') {
+        return systemTheme;
+    }
+    return preference;
+}
+/**
+ * Check if a value is a valid theme preference
+ *
+ * @param value - Value to check
+ * @returns Whether value is a valid theme preference
+ */
+export function isValidThemePreference(value) {
+    return value === 'light' || value === 'dark' || value === 'system';
+}
+//# sourceMappingURL=theme.js.map

package/dist/utils/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/utils/theme.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,uCAAuC;AACvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO;QAC9D,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA2B,EAC3B,WAA0B;IAE1B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAc;IAEd,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,CAAC;AACrE,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Time formatting utilities
+ */
+/**
+ * Format seconds into MM:SS or HH:MM:SS string
+ *
+ * @param seconds - Total seconds to format
+ * @returns Formatted time string
+ *
+ * @example
+ * formatTime(65) // "1:05"
+ * formatTime(3665) // "1:01:05"
+ */
+export declare function formatTime(seconds: number): string;
+/**
+ * Parse a time string back to seconds
+ *
+ * @param timeString - Time string in MM:SS or HH:MM:SS format
+ * @returns Total seconds
+ */
+export declare function parseTime(timeString: string): number;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASlD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWpD"}

package/dist/utils/time.js

@@ -0,0 +1,41 @@
+/**
+ * Time formatting utilities
+ */
+/**
+ * Format seconds into MM:SS or HH:MM:SS string
+ *
+ * @param seconds - Total seconds to format
+ * @returns Formatted time string
+ *
+ * @example
+ * formatTime(65) // "1:05"
+ * formatTime(3665) // "1:01:05"
+ */
+export function formatTime(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = seconds % 60;
+    if (hours > 0) {
+        return `${hours}:${minutes.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+    }
+    return `${minutes}:${secs.toString().padStart(2, '0')}`;
+}
+/**
+ * Parse a time string back to seconds
+ *
+ * @param timeString - Time string in MM:SS or HH:MM:SS format
+ * @returns Total seconds
+ */
+export function parseTime(timeString) {
+    const parts = timeString.split(':').map(Number);
+    if (parts.length === 2) {
+        const [minutes, secs] = parts;
+        return (minutes ?? 0) * 60 + (secs ?? 0);
+    }
+    if (parts.length === 3) {
+        const [hours, minutes, secs] = parts;
+        return (hours ?? 0) * 3600 + (minutes ?? 0) * 60 + (secs ?? 0);
+    }
+    return 0;
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC;IAE1B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC/F,CAAC;IACD,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QAC9B,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;QACrC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Game validation utilities for checking mistakes, completion, and game state
+ */
+import type { GameBoard, GameState } from '../types';
+/**
+ * Checks if a cell value matches the solution
+ * @param board - GameBoard
+ * @param solution - 81-character solution string
+ * @param row - Row index
+ * @param col - Column index
+ * @returns true if the cell value matches the solution (or is empty)
+ */
+export declare function isCellCorrect(board: GameBoard, solution: string, row: number, col: number): boolean;
+/**
+ * Checks if a specific value would be correct for a cell
+ * @param solution - 81-character solution string
+ * @param row - Row index
+ * @param col - Column index
+ * @param value - Value to check (1-9)
+ * @returns true if the value matches the solution
+ */
+export declare function isValueCorrect(solution: string, row: number, col: number, value: number): boolean;
+/**
+ * Gets all cells with incorrect values
+ * @param board - GameBoard
+ * @param solution - 81-character solution string
+ * @returns Array of {row, column} positions with incorrect values
+ */
+export declare function getIncorrectCells(board: GameBoard, solution: string): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Updates the error state of all cells based on the solution
+ * @param board - GameBoard to update
+ * @param solution - 81-character solution string
+ * @param showErrors - Whether to show errors
+ * @returns Updated GameBoard
+ */
+export declare function updateCellErrors(board: GameBoard, solution: string, showErrors: boolean): GameBoard;
+/**
+ * Checks if the game is complete (all cells filled correctly)
+ * @param board - GameBoard
+ * @param solution - 81-character solution string
+ * @returns true if all cells are filled with correct values
+ */
+export declare function isGameComplete(board: GameBoard, solution: string): boolean;
+/**
+ * Checks if the board is fully filled (regardless of correctness)
+ * @param board - GameBoard
+ * @returns true if all cells have values
+ */
+export declare function isBoardFilled(board: GameBoard): boolean;
+/**
+ * Counts the number of mistakes in the current board
+ * @param board - GameBoard
+ * @param solution - 81-character solution string
+ * @returns Number of incorrect cells
+ */
+export declare function countMistakes(board: GameBoard, solution: string): number;
+/**
+ * Updates highlight state for all cells based on selected cell
+ * @param board - GameBoard
+ * @param selectedRow - Selected row (or null if nothing selected)
+ * @param selectedCol - Selected column (or null if nothing selected)
+ * @param highlightRelated - Whether to highlight related cells
+ * @param highlightSameValue - Whether to highlight cells with same value
+ * @returns Updated GameBoard
+ */
+export declare function updateCellHighlights(board: GameBoard, selectedRow: number | null, selectedCol: number | null, highlightRelated: boolean, highlightSameValue: boolean): GameBoard;
+/**
+ * Clears all highlights from the board
+ * @param board - GameBoard
+ * @returns Board with no highlights
+ */
+export declare function clearHighlights(board: GameBoard): GameBoard;
+/**
+ * Auto-removes pencilmarks from related cells when a value is placed
+ * @param board - GameBoard
+ * @param row - Row where value was placed
+ * @param col - Column where value was placed
+ * @param value - Value that was placed
+ * @returns Updated GameBoard with pencilmarks removed
+ */
+export declare function autoRemovePencilmarks(board: GameBoard, row: number, col: number, value: number): GameBoard;
+/**
+ * Gets the progress percentage (filled cells / total empty cells in original puzzle)
+ * @param board - GameBoard
+ * @returns Progress percentage (0-100)
+ */
+export declare function getProgressPercentage(board: GameBoard): number;
+/**
+ * Validates the entire game state
+ * @param state - GameState
+ * @returns Object with validation results
+ */
+export declare function validateGameState(state: GameState): {
+    isComplete: boolean;
+    isFilled: boolean;
+    mistakeCount: number;
+    progressPercentage: number;
+    incorrectCells: Array<{
+        row: number;
+        column: number;
+    }>;
+};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBxC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAClB,SAAS,CAoBX;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAe1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CASvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,gBAAgB,EAAE,OAAO,EACzB,kBAAkB,EAAE,OAAO,GAC1B,SAAS,CA2CX;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAS3D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,SAAS,CAwBX;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAqB9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD,CAQA"}