@sudobility/sudojo_lib 0.0.4

package/dist/types/sudoku.js

@@ -0,0 +1,125 @@
+/**
+ * Sudoku game types - ported from renderable/sudokuschool
+ *
+ * Uses flat 81-cell array (indexed 0-80) matching Kotlin implementation
+ */
+/**
+ * Get row index (0-8) from cell index (0-80)
+ */
+export function rowOf(index) {
+    return Math.floor(index / 9);
+}
+/**
+ * Get column index (0-8) from cell index (0-80)
+ */
+export function columnOf(index) {
+    return index % 9;
+}
+/**
+ * Get block index (0-8) from cell index (0-80)
+ */
+export function blockOf(index) {
+    const blockY = Math.floor(rowOf(index) / 3);
+    const blockX = Math.floor(columnOf(index) / 3);
+    return blockY * 3 + blockX;
+}
+/**
+ * Get cell index from row and column
+ */
+export function cellIndex(row, column) {
+    return row * 9 + column;
+}
+// =============================================================================
+// Defaults
+// =============================================================================
+export const DEFAULT_PLAY_SETTINGS = {
+    pencilmarking: false,
+    autoPencilmarks: false,
+};
+export const DEFAULT_APP_SETTINGS = {
+    showErrors: true,
+    enableAnimations: true,
+    symmetrical: false,
+    display: 'NUMERIC',
+};
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create an empty cell
+ */
+export function createEmptyCell(index) {
+    return {
+        index,
+        solution: null,
+        given: null,
+        input: null,
+        pencilmarks: null,
+    };
+}
+/**
+ * Create an empty board (81 empty cells)
+ */
+export function createEmptyBoard() {
+    return {
+        cells: Array.from({ length: 81 }, (_, i) => createEmptyCell(i)),
+        completed: false,
+        entering: false,
+        enteringError: null,
+    };
+}
+/**
+ * Check if a cell has an error (input doesn't match solution)
+ */
+export function cellHasError(cell) {
+    if (cell.given !== null)
+        return false; // Clue cells can't have errors
+    if (cell.input === null)
+        return false; // Empty cells can't have errors
+    if (cell.solution === null)
+        return false; // No solution to compare
+    return cell.input !== cell.solution;
+}
+/**
+ * Get all cell indices in the same row
+ */
+export function getRowIndices(index) {
+    const row = rowOf(index);
+    return Array.from({ length: 9 }, (_, col) => row * 9 + col);
+}
+/**
+ * Get all cell indices in the same column
+ */
+export function getColumnIndices(index) {
+    const col = columnOf(index);
+    return Array.from({ length: 9 }, (_, row) => row * 9 + col);
+}
+/**
+ * Get all cell indices in the same block
+ */
+export function getBlockIndices(index) {
+    const blockIndex = blockOf(index);
+    const blockX = blockIndex % 3;
+    const blockY = Math.floor(blockIndex / 3);
+    const indices = [];
+    for (let i = 0; i < 9; i++) {
+        const cellX = i % 3;
+        const cellY = Math.floor(i / 3);
+        const x = blockX * 3 + cellX;
+        const y = blockY * 3 + cellY;
+        indices.push(y * 9 + x);
+    }
+    return indices;
+}
+/**
+ * Get all related cell indices (same row, column, or block)
+ */
+export function getRelatedIndices(index) {
+    const rowIndices = getRowIndices(index);
+    const colIndices = getColumnIndices(index);
+    const blockIndices = getBlockIndices(index);
+    const allIndices = new Set([...rowIndices, ...colIndices, ...blockIndices]);
+    allIndices.delete(index); // Remove the cell itself
+    return Array.from(allIndices);
+}
+//# sourceMappingURL=sudoku.js.map

package/dist/types/sudoku.js.map

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

package/dist/utils/auth.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Authentication utilities
+ */
+/**
+ * Get user-friendly error message from Firebase error code
+ *
+ * @param code - Firebase error code (e.g., 'auth/user-not-found')
+ * @returns User-friendly error message
+ */
+export declare function getFirebaseErrorMessage(code: string): string;
+/**
+ * Extract error code from Firebase error
+ *
+ * @param error - Error object from Firebase
+ * @returns Error code string or empty string if not found
+ */
+export declare function getFirebaseErrorCode(error: unknown): string;
+/**
+ * Get user-friendly message from Firebase error object
+ *
+ * @param error - Error object from Firebase
+ * @returns User-friendly error message
+ */
+export declare function formatFirebaseError(error: unknown): string;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK3D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG1D"}

package/dist/utils/auth.js

@@ -0,0 +1,47 @@
+/**
+ * Authentication utilities
+ */
+/** Map of Firebase auth error codes to user-friendly messages */
+const FIREBASE_ERROR_MESSAGES = {
+    'auth/user-not-found': 'No account found with this email',
+    'auth/wrong-password': 'Incorrect password',
+    'auth/invalid-email': 'Invalid email address',
+    'auth/invalid-credential': 'Invalid email or password',
+    'auth/email-already-in-use': 'An account with this email already exists',
+    'auth/weak-password': 'Password must be at least 6 characters',
+    'auth/too-many-requests': 'Too many attempts. Please try again later.',
+    'auth/network-request-failed': 'Network error. Please check your connection.',
+    'auth/popup-closed-by-user': 'Sign in cancelled',
+};
+/**
+ * Get user-friendly error message from Firebase error code
+ *
+ * @param code - Firebase error code (e.g., 'auth/user-not-found')
+ * @returns User-friendly error message
+ */
+export function getFirebaseErrorMessage(code) {
+    return (FIREBASE_ERROR_MESSAGES[code] ?? 'Something went wrong. Please try again.');
+}
+/**
+ * Extract error code from Firebase error
+ *
+ * @param error - Error object from Firebase
+ * @returns Error code string or empty string if not found
+ */
+export function getFirebaseErrorCode(error) {
+    if (error && typeof error === 'object' && 'code' in error) {
+        return error.code;
+    }
+    return '';
+}
+/**
+ * Get user-friendly message from Firebase error object
+ *
+ * @param error - Error object from Firebase
+ * @returns User-friendly error message
+ */
+export function formatFirebaseError(error) {
+    const code = getFirebaseErrorCode(error);
+    return getFirebaseErrorMessage(code);
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iEAAiE;AACjE,MAAM,uBAAuB,GAA2B;IACtD,qBAAqB,EAAE,kCAAkC;IACzD,qBAAqB,EAAE,oBAAoB;IAC3C,oBAAoB,EAAE,uBAAuB;IAC7C,yBAAyB,EAAE,2BAA2B;IACtD,2BAA2B,EAAE,2CAA2C;IACxE,oBAAoB,EAAE,wCAAwC;IAC9D,wBAAwB,EAAE,4CAA4C;IACtE,6BAA6B,EAAE,8CAA8C;IAC7E,2BAA2B,EAAE,mBAAmB;CACjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,CACL,uBAAuB,CAAC,IAAI,CAAC,IAAI,yCAAyC,CAC3E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC1D,OAAQ,KAA0B,CAAC,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/utils/board.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Board utilities for parsing, stringifying, and manipulating Sudoku boards
+ */
+import type { GameBoard } from '../types';
+/**
+ * Board size constants
+ */
+export declare const BOARD_SIZE = 9;
+export declare const BLOCK_SIZE = 3;
+export declare const TOTAL_CELLS: number;
+/**
+ * Parses an 81-character board string into a 2D array of numbers
+ * @param boardString - 81-character string where '0' or '.' represents empty cells
+ * @returns 9x9 array of numbers (0 = empty, 1-9 = filled)
+ */
+export declare function parseBoardString(boardString: string): number[][];
+/**
+ * Converts a 2D number array back to an 81-character string
+ * @param board - 9x9 array of numbers
+ * @returns 81-character string
+ */
+export declare function stringifyBoard(board: number[][]): string;
+/**
+ * Creates an initial GameBoard from puzzle and solution strings
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @returns GameBoard with initialized cell states
+ */
+export declare function createGameBoard(puzzle: string, solution: string): GameBoard;
+/**
+ * Gets the current board state as a string (user's current progress)
+ * @param board - GameBoard
+ * @returns 81-character string representing current state
+ */
+export declare function getBoardStateString(board: GameBoard): string;
+/**
+ * Gets the pencilmarks as a comma-separated string for the solver API
+ * @param board - GameBoard
+ * @returns Comma-separated string of pencilmarks for each cell
+ */
+export declare function getPencilmarksString(board: GameBoard): string;
+/**
+ * Gets the block index (0-8) for a cell position
+ * @param row - Row index (0-8)
+ * @param col - Column index (0-8)
+ * @returns Block index (0-8)
+ */
+export declare function getBlockIndex(row: number, col: number): number;
+/**
+ * Gets all cells in the same row
+ * @param row - Row index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export declare function getRowCells(row: number): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Gets all cells in the same column
+ * @param col - Column index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export declare function getColumnCells(col: number): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Gets all cells in the same block
+ * @param blockIndex - Block index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export declare function getBlockCells(blockIndex: number): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Gets all related cells (same row, column, or block)
+ * @param row - Row index
+ * @param col - Column index
+ * @returns Array of {row, column} positions (excluding the cell itself)
+ */
+export declare function getRelatedCells(row: number, col: number): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Checks if a value is valid for a cell position (not checking solution, just Sudoku rules)
+ * @param board - GameBoard
+ * @param row - Row index
+ * @param col - Column index
+ * @param value - Value to check (1-9)
+ * @returns true if the value doesn't conflict with existing values
+ */
+export declare function isValidPlacement(board: GameBoard, row: number, col: number, value: number): boolean;
+/**
+ * Clones a GameBoard (deep copy)
+ * @param board - GameBoard to clone
+ * @returns New GameBoard with copied values
+ */
+export declare function cloneBoard(board: GameBoard): GameBoard;
+/**
+ * Gets all empty cells in the board
+ * @param board - GameBoard
+ * @returns Array of {row, column} positions
+ */
+export declare function getEmptyCells(board: GameBoard): Array<{
+    row: number;
+    column: number;
+}>;
+/**
+ * Counts the number of filled cells
+ * @param board - GameBoard
+ * @returns Number of filled cells
+ */
+export declare function countFilledCells(board: GameBoard): number;
+//# sourceMappingURL=board.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,WAAW,QAA0B,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAyBhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAuBxD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CA0B3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAaxC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BxC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CA+BT;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAOtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,GACf,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAUzD"}

package/dist/utils/board.js

@@ -0,0 +1,291 @@
+/**
+ * Board utilities for parsing, stringifying, and manipulating Sudoku boards
+ */
+/**
+ * Board size constants
+ */
+export const BOARD_SIZE = 9;
+export const BLOCK_SIZE = 3;
+export const TOTAL_CELLS = BOARD_SIZE * BOARD_SIZE;
+/**
+ * Parses an 81-character board string into a 2D array of numbers
+ * @param boardString - 81-character string where '0' or '.' represents empty cells
+ * @returns 9x9 array of numbers (0 = empty, 1-9 = filled)
+ */
+export function parseBoardString(boardString) {
+    if (boardString.length !== TOTAL_CELLS) {
+        throw new Error(`Invalid board string length: expected ${TOTAL_CELLS}, got ${boardString.length}`);
+    }
+    const board = [];
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        const rowArray = [];
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            const index = row * BOARD_SIZE + col;
+            const char = boardString[index];
+            if (char === undefined) {
+                throw new Error(`Missing character at position ${index}`);
+            }
+            const value = char === '.' ? 0 : parseInt(char, 10);
+            if (isNaN(value) || value < 0 || value > 9) {
+                throw new Error(`Invalid character at position ${index}: '${char}'`);
+            }
+            rowArray.push(value);
+        }
+        board.push(rowArray);
+    }
+    return board;
+}
+/**
+ * Converts a 2D number array back to an 81-character string
+ * @param board - 9x9 array of numbers
+ * @returns 81-character string
+ */
+export function stringifyBoard(board) {
+    if (board.length !== BOARD_SIZE) {
+        throw new Error(`Invalid board rows: expected ${BOARD_SIZE}, got ${board.length}`);
+    }
+    let result = '';
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        if (board[row]?.length !== BOARD_SIZE) {
+            throw new Error(`Invalid row ${row} length: expected ${BOARD_SIZE}, got ${board[row]?.length}`);
+        }
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            const value = board[row]?.[col];
+            if (value === undefined || value < 0 || value > 9) {
+                throw new Error(`Invalid value at (${row}, ${col}): ${value}`);
+            }
+            result += value.toString();
+        }
+    }
+    return result;
+}
+/**
+ * Creates an initial GameBoard from puzzle and solution strings
+ * @param puzzle - 81-character puzzle string
+ * @param solution - 81-character solution string
+ * @returns GameBoard with initialized cell states
+ */
+export function createGameBoard(puzzle, solution) {
+    const puzzleArray = parseBoardString(puzzle);
+    // Validate solution string (will throw if invalid)
+    parseBoardString(solution);
+    const board = [];
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        const rowArray = [];
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            const puzzleValue = puzzleArray[row]?.[col] ?? 0;
+            const isClue = puzzleValue !== 0;
+            rowArray.push({
+                row,
+                column: col,
+                value: isClue ? puzzleValue : null,
+                isClue,
+                isError: false,
+                pencilmarks: new Set(),
+                isSelected: false,
+                isHighlighted: false,
+                isSameValue: false,
+            });
+        }
+        board.push(rowArray);
+    }
+    return board;
+}
+/**
+ * Gets the current board state as a string (user's current progress)
+ * @param board - GameBoard
+ * @returns 81-character string representing current state
+ */
+export function getBoardStateString(board) {
+    let result = '';
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            const cell = board[row]?.[col];
+            result += cell?.value?.toString() ?? '0';
+        }
+    }
+    return result;
+}
+/**
+ * Gets the pencilmarks as a comma-separated string for the solver API
+ * @param board - GameBoard
+ * @returns Comma-separated string of pencilmarks for each cell
+ */
+export function getPencilmarksString(board) {
+    const pencilmarks = [];
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            const cell = board[row]?.[col];
+            if (cell && cell.pencilmarks.size > 0) {
+                const sorted = Array.from(cell.pencilmarks).sort((a, b) => a - b);
+                pencilmarks.push(sorted.join(''));
+            }
+            else {
+                pencilmarks.push('');
+            }
+        }
+    }
+    return pencilmarks.join(',');
+}
+/**
+ * Gets the block index (0-8) for a cell position
+ * @param row - Row index (0-8)
+ * @param col - Column index (0-8)
+ * @returns Block index (0-8)
+ */
+export function getBlockIndex(row, col) {
+    const blockRow = Math.floor(row / BLOCK_SIZE);
+    const blockCol = Math.floor(col / BLOCK_SIZE);
+    return blockRow * BLOCK_SIZE + blockCol;
+}
+/**
+ * Gets all cells in the same row
+ * @param row - Row index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export function getRowCells(row) {
+    const cells = [];
+    for (let col = 0; col < BOARD_SIZE; col++) {
+        cells.push({ row, column: col });
+    }
+    return cells;
+}
+/**
+ * Gets all cells in the same column
+ * @param col - Column index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export function getColumnCells(col) {
+    const cells = [];
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        cells.push({ row, column: col });
+    }
+    return cells;
+}
+/**
+ * Gets all cells in the same block
+ * @param blockIndex - Block index (0-8)
+ * @returns Array of {row, column} positions
+ */
+export function getBlockCells(blockIndex) {
+    const cells = [];
+    const blockRow = Math.floor(blockIndex / BLOCK_SIZE);
+    const blockCol = blockIndex % BLOCK_SIZE;
+    const startRow = blockRow * BLOCK_SIZE;
+    const startCol = blockCol * BLOCK_SIZE;
+    for (let r = 0; r < BLOCK_SIZE; r++) {
+        for (let c = 0; c < BLOCK_SIZE; c++) {
+            cells.push({ row: startRow + r, column: startCol + c });
+        }
+    }
+    return cells;
+}
+/**
+ * Gets all related cells (same row, column, or block)
+ * @param row - Row index
+ * @param col - Column index
+ * @returns Array of {row, column} positions (excluding the cell itself)
+ */
+export function getRelatedCells(row, col) {
+    const related = new Map();
+    // Add row cells
+    for (const cell of getRowCells(row)) {
+        if (cell.row !== row || cell.column !== col) {
+            related.set(`${cell.row},${cell.column}`, cell);
+        }
+    }
+    // Add column cells
+    for (const cell of getColumnCells(col)) {
+        if (cell.row !== row || cell.column !== col) {
+            related.set(`${cell.row},${cell.column}`, cell);
+        }
+    }
+    // Add block cells
+    const blockIndex = getBlockIndex(row, col);
+    for (const cell of getBlockCells(blockIndex)) {
+        if (cell.row !== row || cell.column !== col) {
+            related.set(`${cell.row},${cell.column}`, cell);
+        }
+    }
+    return Array.from(related.values());
+}
+/**
+ * Checks if a value is valid for a cell position (not checking solution, just Sudoku rules)
+ * @param board - GameBoard
+ * @param row - Row index
+ * @param col - Column index
+ * @param value - Value to check (1-9)
+ * @returns true if the value doesn't conflict with existing values
+ */
+export function isValidPlacement(board, row, col, value) {
+    if (value < 1 || value > 9) {
+        return false;
+    }
+    // Check row
+    for (let c = 0; c < BOARD_SIZE; c++) {
+        if (c !== col && board[row]?.[c]?.value === value) {
+            return false;
+        }
+    }
+    // Check column
+    for (let r = 0; r < BOARD_SIZE; r++) {
+        if (r !== row && board[r]?.[col]?.value === value) {
+            return false;
+        }
+    }
+    // Check block
+    const blockStartRow = Math.floor(row / BLOCK_SIZE) * BLOCK_SIZE;
+    const blockStartCol = Math.floor(col / BLOCK_SIZE) * BLOCK_SIZE;
+    for (let r = blockStartRow; r < blockStartRow + BLOCK_SIZE; r++) {
+        for (let c = blockStartCol; c < blockStartCol + BLOCK_SIZE; c++) {
+            if ((r !== row || c !== col) && board[r]?.[c]?.value === value) {
+                return false;
+            }
+        }
+    }
+    return true;
+}
+/**
+ * Clones a GameBoard (deep copy)
+ * @param board - GameBoard to clone
+ * @returns New GameBoard with copied values
+ */
+export function cloneBoard(board) {
+    return board.map(row => row.map(cell => ({
+        ...cell,
+        pencilmarks: new Set(cell.pencilmarks),
+    })));
+}
+/**
+ * Gets all empty cells in the board
+ * @param board - GameBoard
+ * @returns Array of {row, column} positions
+ */
+export function getEmptyCells(board) {
+    const emptyCells = [];
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            if (board[row]?.[col]?.value === null) {
+                emptyCells.push({ row, column: col });
+            }
+        }
+    }
+    return emptyCells;
+}
+/**
+ * Counts the number of filled cells
+ * @param board - GameBoard
+ * @returns Number of filled cells
+ */
+export function countFilledCells(board) {
+    let count = 0;
+    for (let row = 0; row < BOARD_SIZE; row++) {
+        for (let col = 0; col < BOARD_SIZE; col++) {
+            if (board[row]?.[col]?.value !== null) {
+                count++;
+            }
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=board.js.map

package/dist/utils/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,IAAI,WAAW,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,yCAAyC,WAAW,SAAS,WAAW,CAAC,MAAM,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,GAAG,GAAG,CAAC;YACrC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,MAAM,IAAI,GAAG,CAAC,CAAC;YACvE,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,gCAAgC,UAAU,SAAS,KAAK,CAAC,MAAM,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,eAAe,GAAG,qBAAqB,UAAU,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAC/E,CAAC;QACJ,CAAC;QACD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,QAAgB;IAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC7C,mDAAmD;IACnD,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAE3B,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAgB,EAAE,CAAC;QACjC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,WAAW,KAAK,CAAC,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,GAAG;gBACH,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI;gBAClC,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,IAAI,GAAG,EAAU;gBAC9B,UAAU,EAAE,KAAK;gBACjB,aAAa,EAAE,KAAK;gBACpB,WAAW,EAAE,KAAK;aACnB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,IAAI,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAgB;IACnD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,GAAW;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;IAC9C,OAAO,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW;IAEX,MAAM,KAAK,GAA2C,EAAE,CAAC;IACzD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAW;IAEX,MAAM,KAAK,GAA2C,EAAE,CAAC;IACzD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB;IAElB,MAAM,KAAK,GAA2C,EAAE,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvC,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,GAAW;IAEX,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2C,CAAC;IAEnE,gBAAgB;IAChB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAgB,EAChB,GAAW,EACX,GAAW,EACX,KAAa;IAEb,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,eAAe;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;IAChE,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAChE,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YAChE,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC/D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CACrB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,GAAG,IAAI;QACP,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;KACvC,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAgB;IAEhB,MAAM,UAAU,GAA2C,EAAE,CAAC;IAC9D,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;gBACtC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,IAAI,EAAE,CAAC;gBACtC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,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;AAGjB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvD,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,GAC1B,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,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,QAAQ,CAAC;AAGhB,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,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC"}