@sudobility/sudojo_lib 0.0.4

package/dist/utils/subscription.js

@@ -0,0 +1,117 @@
+/**
+ * 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.
+ */
+/**
+ * Convert RevenueCat package to our Product interface
+ *
+ * @param pkg - RevenueCat package
+ * @returns Product object
+ */
+export function convertPackageToProduct(pkg) {
+    const product = pkg.rcBillingProduct;
+    const subscriptionOption = product?.defaultSubscriptionOption;
+    const result = {
+        identifier: pkg.identifier,
+        price: product?.currentPrice?.amountMicros
+            ? (product.currentPrice.amountMicros / 1000000).toFixed(2)
+            : '0',
+        priceString: product?.currentPrice?.formattedPrice ?? '$0',
+        title: product?.title ?? pkg.identifier,
+        description: product?.description ?? '',
+    };
+    if (product?.identifier !== undefined) {
+        result.productId = product.identifier;
+    }
+    if (product?.normalPeriodDuration !== undefined) {
+        result.period = product.normalPeriodDuration;
+    }
+    if (subscriptionOption?.introPrice?.price?.formattedPrice !== undefined) {
+        result.introPrice = subscriptionOption.introPrice.price.formattedPrice;
+    }
+    if (subscriptionOption?.introPrice?.periodDuration !== undefined) {
+        result.introPricePeriod = subscriptionOption.introPrice.periodDuration;
+    }
+    if (subscriptionOption?.trial?.periodDuration !== undefined) {
+        result.freeTrialPeriod = subscriptionOption.trial.periodDuration;
+    }
+    return result;
+}
+/**
+ * Parse RevenueCat CustomerInfo into our Subscription interface
+ *
+ * @param customerInfo - RevenueCat customer info
+ * @returns Subscription object
+ */
+export function parseCustomerInfo(customerInfo) {
+    const hasActiveEntitlement = Object.keys(customerInfo.entitlements.active).length > 0;
+    const activeEntitlement = Object.values(customerInfo.entitlements.active)[0];
+    if (hasActiveEntitlement && activeEntitlement) {
+        const subscription = { isActive: true };
+        if (activeEntitlement.expirationDate != null) {
+            subscription.expirationDate = new Date(activeEntitlement.expirationDate);
+        }
+        if (activeEntitlement.latestPurchaseDate != null) {
+            subscription.purchaseDate = new Date(activeEntitlement.latestPurchaseDate);
+        }
+        if (activeEntitlement.productIdentifier !== undefined) {
+            subscription.productIdentifier = activeEntitlement.productIdentifier;
+        }
+        if (activeEntitlement.willRenew !== undefined) {
+            subscription.willRenew = activeEntitlement.willRenew;
+        }
+        return subscription;
+    }
+    return { isActive: false };
+}
+/**
+ * Get display name for subscription period
+ *
+ * @param period - ISO 8601 duration string (e.g., "P1M", "P1Y")
+ * @returns Human-readable period name
+ */
+export function getPeriodDisplayName(period) {
+    if (!period)
+        return '';
+    const periodMap = {
+        P1W: 'Weekly',
+        P1M: 'Monthly',
+        P3M: 'Quarterly',
+        P6M: 'Semi-Annual',
+        P1Y: 'Annual',
+        P12M: 'Annual',
+    };
+    return periodMap[period] ?? period;
+}
+/**
+ * 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 function isBestValuePlan(period) {
+    return period === 'P1Y' || period === 'P12M';
+}
+/**
+ * Get RevenueCat purchase error message
+ *
+ * @param errorCode - RevenueCat error code
+ * @returns User-friendly error message
+ */
+export function getRevenueCatErrorMessage(errorCode) {
+    switch (errorCode) {
+        case 1:
+            return 'Purchase cancelled';
+        case 2:
+            return 'Store problem occurred. Please try again later.';
+        case 3:
+            return 'Purchase not allowed on this device';
+        case 7:
+            return 'Network error. Please check your connection.';
+        default:
+            return 'Purchase failed. Please try again.';
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/utils/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"","sources":["../../src/utils/subscription.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAsB;IAC5D,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC;IACrC,MAAM,kBAAkB,GAAG,OAAO,EAAE,yBAAyB,CAAC;IAE9D,MAAM,MAAM,GAAY;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY;YACxC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC,GAAG;QACP,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,IAAI,IAAI;QAC1D,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,UAAU;QACvC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;KACxC,CAAC;IAEF,IAAI,OAAO,EAAE,UAAU,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,EAAE,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAC/C,CAAC;IACD,IAAI,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QACxE,MAAM,CAAC,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC;IACzE,CAAC;IACD,IAAI,kBAAkB,EAAE,UAAU,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QACjE,MAAM,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,UAAU,CAAC,cAAc,CAAC;IACzE,CAAC;IACD,IAAI,kBAAkB,EAAE,KAAK,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,CAAC,eAAe,GAAG,kBAAkB,CAAC,KAAK,CAAC,cAAc,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoC;IAEpC,MAAM,oBAAoB,GACxB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7E,IAAI,oBAAoB,IAAI,iBAAiB,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAEtD,IAAI,iBAAiB,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;YAC7C,YAAY,CAAC,cAAc,GAAG,IAAI,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,iBAAiB,CAAC,kBAAkB,IAAI,IAAI,EAAE,CAAC;YACjD,YAAY,CAAC,YAAY,GAAG,IAAI,IAAI,CAClC,iBAAiB,CAAC,kBAAkB,CACrC,CAAC;QACJ,CAAC;QACD,IAAI,iBAAiB,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACtD,YAAY,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC;QACvE,CAAC;QACD,IAAI,iBAAiB,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC9C,YAAY,CAAC,SAAS,GAAG,iBAAiB,CAAC,SAAS,CAAC;QACvD,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA0B;IAC7D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,MAAM,SAAS,GAA2B;QACxC,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE,SAAS;QACd,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,aAAa;QAClB,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,QAAQ;KACf,CAAC;IAEF,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAA0B;IACxD,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,CAAC;YACJ,OAAO,oBAAoB,CAAC;QAC9B,KAAK,CAAC;YACJ,OAAO,iDAAiD,CAAC;QAC3D,KAAK,CAAC;YACJ,OAAO,qCAAqC,CAAC;QAC/C,KAAK,CAAC;YACJ,OAAO,8CAA8C,CAAC;QACxD;YACE,OAAO,oCAAoC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/utils/sudokuPresenter.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Sudoku presenter - port of renderable/SudokuPresenter.kt
+ *
+ * Handles all display logic for the Sudoku board including:
+ * - Cell background colors based on selection state
+ * - Cell border colors for selected cells
+ * - Text colors (given, input, hint actions)
+ * - Hint visualization (areas, cells)
+ * - Pencilmark coloring
+ */
+import type { SudokuCell } from '../types/sudoku';
+import { type CellDisplayState, type HintCell, type HintStep, ThemeColor, type UIColorPalette } from '../types/display';
+/**
+ * Convert ThemeColor to actual CSS color - matches RendererColor.color
+ */
+export declare function themeColorToCSS(palette: UIColorPalette, themeColor: ThemeColor | null): string | null;
+/**
+ * Get the color palette for the current theme
+ */
+export declare function getColorPalette(isDarkMode: boolean): UIColorPalette;
+/**
+ * Process hint areas and cells into a map of cell hints
+ * Matches BoardPresenter.calculateCellHints
+ */
+export declare function calculateCellHints(hintStep: HintStep | null): Map<number, HintCell> | null;
+export interface PresentBoardOptions {
+    /** The 81 cells of the board */
+    cells: SudokuCell[];
+    /** Currently selected cell index (0-80) or null */
+    selectedIndex: number | null;
+    /** Whether to show errors (compare input vs solution) */
+    showErrors: boolean;
+    /** Current hint step (if any) */
+    hintStep?: HintStep | null;
+    /** Set of cell indices with the selected digit (for digit highlighting) */
+    selectedDigitCells?: Set<number> | null;
+}
+/**
+ * Generate display states for all cells
+ * This is the main presenter function that matches the Kotlin renderable behavior
+ */
+export declare function presentBoard(options: PresentBoardOptions): CellDisplayState[];
+/**
+ * Get indices of cells that contain a specific digit (given or input)
+ * Used for digit highlighting mode
+ */
+export declare function getCellsWithDigit(cells: SudokuCell[], digit: number): Set<number>;
+/**
+ * Get the selected digit for digit highlighting mode
+ * Matches Kotlin SudokuInteractor.selectedDigit logic:
+ * - If selected cell has a given value: return given
+ * - If selected cell has a CORRECT input (input === solution): return input
+ * - Otherwise: return null (no digit highlighting)
+ */
+export declare function getSelectedDigit(cells: SudokuCell[], selectedIndex: number | null): number | null;
+/**
+ * Compute selectedDigitCells based on selected cell
+ * Returns Set of cell indices that have the same digit as selected cell
+ * Returns null if selected cell doesn't have a highlightable digit
+ */
+export declare function computeSelectedDigitCells(cells: SudokuCell[], selectedIndex: number | null): Set<number> | null;
+//# sourceMappingURL=sudokuPresenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sudokuPresenter.d.ts","sourceRoot":"","sources":["../../src/utils/sudokuPresenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,QAAQ,EAGb,UAAU,EAGV,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AA0F1B;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,UAAU,GAAG,IAAI,GAC5B,MAAM,GAAG,IAAI,CA4Bf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,CAEnE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GACxB,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAoC9B;AAuMD,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,2EAA2E;IAC3E,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,EAAE,CAuF7E;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,CAAC,CAQb;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,MAAM,GAAG,IAAI,CAiBf;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAIpB"}

package/dist/utils/sudokuPresenter.js

@@ -0,0 +1,403 @@
+/**
+ * Sudoku presenter - port of renderable/SudokuPresenter.kt
+ *
+ * Handles all display logic for the Sudoku board including:
+ * - Cell background colors based on selection state
+ * - Cell border colors for selected cells
+ * - Text colors (given, input, hint actions)
+ * - Hint visualization (areas, cells)
+ * - Pencilmark coloring
+ */
+import { blockOf, columnOf, rowOf } from '../types/sudoku';
+import { SudokuColor, ThemeColor, UIColorDark, UIColorLight, } from '../types/display';
+// =============================================================================
+// Block Definition (matches PlayBoard.blocks)
+// =============================================================================
+/**
+ * Block class - matches Kotlin Block class
+ */
+class Block {
+    constructor(index) {
+        this.index = index;
+        const blockRow = Math.floor(index / 3);
+        const blockCol = index % 3;
+        this.cellIndices = [];
+        for (let r = 0; r < 3; r++) {
+            for (let c = 0; c < 3; c++) {
+                const row = blockRow * 3 + r;
+                const col = blockCol * 3 + c;
+                this.cellIndices.push(row * 9 + col);
+            }
+        }
+    }
+}
+/**
+ * Row class - matches Kotlin Row class
+ */
+class Row {
+    constructor(index) {
+        this.index = index;
+        this.cellIndices = Array.from({ length: 9 }, (_, col) => index * 9 + col);
+    }
+}
+/**
+ * Column class - matches Kotlin Column class
+ */
+class Column {
+    constructor(index) {
+        this.index = index;
+        this.cellIndices = Array.from({ length: 9 }, (_, row) => row * 9 + index);
+    }
+}
+// =============================================================================
+// Color Conversion (matches CellPresenter.colorOf)
+// =============================================================================
+/**
+ * Convert SudokuColor to ThemeColor - matches CellPresenter.colorOf
+ */
+function sudokuColorToTheme(sudokuColor) {
+    switch (sudokuColor) {
+        case SudokuColor.BLUE:
+            return ThemeColor.SELECTED;
+        case SudokuColor.GREEN:
+            return ThemeColor.SUCCESS;
+        case SudokuColor.YELLOW:
+            return ThemeColor.WARNING_SECONDARY;
+        case SudokuColor.ORANGE:
+            return ThemeColor.WARNING;
+        case SudokuColor.RED:
+            return ThemeColor.ERROR;
+        case SudokuColor.WHITE:
+            return ThemeColor.BACKGROUND;
+        case SudokuColor.LIGHT_GRAY:
+            return ThemeColor.BACKGROUND_SECONDARY;
+        case SudokuColor.BLACK:
+            return ThemeColor.LABEL;
+        case SudokuColor.GRAY:
+            return ThemeColor.LABEL_SECONDARY;
+        case SudokuColor.CLEAR:
+            return ThemeColor.CLEAR;
+        default:
+            return null;
+    }
+}
+/**
+ * Convert ThemeColor to actual CSS color - matches RendererColor.color
+ */
+export function themeColorToCSS(palette, themeColor) {
+    switch (themeColor) {
+        case ThemeColor.NONE:
+        case ThemeColor.CLEAR:
+            return palette.clear;
+        case ThemeColor.SELECTED:
+            return palette.systemPurple;
+        case ThemeColor.SUCCESS:
+            return palette.systemBlue;
+        case ThemeColor.WARNING_SECONDARY:
+            return palette.systemYellow;
+        case ThemeColor.WARNING:
+            return palette.systemOrange;
+        case ThemeColor.ERROR:
+            return palette.systemRed;
+        case ThemeColor.BACKGROUND:
+            return palette.systemBackground;
+        case ThemeColor.BACKGROUND_SECONDARY:
+            return palette.secondarySystemBackground;
+        case ThemeColor.LABEL:
+            return palette.label;
+        case ThemeColor.LABEL_SECONDARY:
+            return palette.secondaryLabel;
+        case ThemeColor.DISABLED:
+            return palette.systemGray;
+        default:
+            return null;
+    }
+}
+/**
+ * Get the color palette for the current theme
+ */
+export function getColorPalette(isDarkMode) {
+    return isDarkMode ? UIColorDark : UIColorLight;
+}
+// =============================================================================
+// Hint Processing (matches BoardPresenter.calculateCellHints)
+// =============================================================================
+/**
+ * Process hint areas and cells into a map of cell hints
+ * Matches BoardPresenter.calculateCellHints
+ */
+export function calculateCellHints(hintStep) {
+    if (!hintStep)
+        return null;
+    const hintsCell = new Map();
+    // Process areas first
+    hintStep.areas?.forEach(area => {
+        let cellIndices;
+        switch (area.type) {
+            case 'block':
+                cellIndices = new Block(area.index).cellIndices;
+                break;
+            case 'row':
+                cellIndices = new Row(area.index).cellIndices;
+                break;
+            case 'column':
+                cellIndices = new Column(area.index).cellIndices;
+                break;
+        }
+        cellIndices.forEach(index => {
+            hintsCell.set(index, {
+                index,
+                color: area.color,
+                fill: true, // Areas always use fill
+            });
+        });
+    });
+    // Process cells (overrides areas)
+    hintStep.cells?.forEach(cell => {
+        hintsCell.set(cell.index, cell);
+    });
+    return hintsCell;
+}
+/**
+ * Determine background and border colors for a cell
+ * Matches BlockPresenter.color exactly
+ */
+function getCellColors(cellIndex, cellBlockIndex, cellRowIndex, cellColumnIndex, cellHasValue, selectedIndex, selectedBlockIndex, selectedRowIndex, selectedColumnIndex, selectedDigitCells) {
+    // Default background based on block (checkerboard pattern)
+    const defaultBackgroundColor = cellBlockIndex % 2 === 0
+        ? ThemeColor.BACKGROUND_SECONDARY
+        : ThemeColor.BACKGROUND;
+    if (selectedIndex === null) {
+        return { backgroundColor: defaultBackgroundColor, borderColor: null };
+    }
+    if (selectedDigitCells !== null) {
+        // Digit highlighting mode
+        if (selectedDigitCells.has(cellIndex)) {
+            // Highlighted cells (have the same digit)
+            return { backgroundColor: ThemeColor.SELECTED, borderColor: null };
+        }
+        // Check if this cell is "impossible" (in same row/col/block as highlighted cells)
+        let isImpossible = cellHasValue;
+        if (!isImpossible) {
+            for (const highlightedIndex of selectedDigitCells) {
+                const hRow = rowOf(highlightedIndex);
+                const hCol = columnOf(highlightedIndex);
+                const hBlock = blockOf(highlightedIndex);
+                if (cellRowIndex === hRow ||
+                    cellColumnIndex === hCol ||
+                    cellBlockIndex === hBlock) {
+                    isImpossible = true;
+                    break;
+                }
+            }
+        }
+        if (isImpossible) {
+            return { backgroundColor: ThemeColor.LABEL_SECONDARY, borderColor: null };
+        }
+        // Possible cells
+        return { backgroundColor: defaultBackgroundColor, borderColor: null };
+    }
+    // Normal selection mode
+    if (selectedIndex === cellIndex) {
+        // Selected cell: default background + SELECTED border
+        return {
+            backgroundColor: defaultBackgroundColor,
+            borderColor: ThemeColor.SELECTED,
+        };
+    }
+    if (selectedBlockIndex === cellBlockIndex ||
+        selectedRowIndex === cellRowIndex ||
+        selectedColumnIndex === cellColumnIndex) {
+        // Same row, column or block: SELECTED background
+        return { backgroundColor: ThemeColor.SELECTED, borderColor: null };
+    }
+    // Other cells
+    return { backgroundColor: defaultBackgroundColor, borderColor: null };
+}
+/**
+ * Determine what digit and color to display in a cell
+ * Matches CellPresenter.present logic
+ */
+function getCellText(cell, showErrors, hintCell) {
+    // Hint select action takes priority
+    if (hintCell?.actions?.select != null) {
+        return {
+            digit: hintCell.actions.select,
+            textColor: ThemeColor.SELECTED,
+            isGiven: false,
+        };
+    }
+    // Hint unselect action (wrong digit to remove)
+    if (hintCell?.actions?.unselect != null) {
+        return {
+            digit: hintCell.actions.unselect,
+            textColor: ThemeColor.ERROR,
+            isGiven: false,
+        };
+    }
+    // User input
+    if (cell.input !== null) {
+        let textColor;
+        if (showErrors) {
+            textColor =
+                cell.input === cell.solution ? ThemeColor.SUCCESS : ThemeColor.ERROR;
+        }
+        else {
+            textColor = ThemeColor.LABEL_SECONDARY;
+        }
+        return { digit: cell.input, textColor, isGiven: false };
+    }
+    // Given (original)
+    if (cell.given !== null) {
+        return { digit: cell.given, textColor: ThemeColor.LABEL, isGiven: true };
+    }
+    return { digit: null, textColor: null, isGiven: false };
+}
+// =============================================================================
+// Pencilmark Logic (matches CellPresenter.present pencilmark section)
+// =============================================================================
+/**
+ * Get pencilmark display states
+ * Matches CellPresenter.present pencilmark logic
+ */
+function getPencilmarks(cell, hintCell) {
+    const cellPencilmarks = cell.pencilmarks
+        ? new Set(cell.pencilmarks)
+        : new Set();
+    const adding = hintCell?.actions?.add ? new Set(hintCell.actions.add) : null;
+    const removing = hintCell?.actions?.remove
+        ? new Set(hintCell.actions.remove)
+        : null;
+    const highlighting = hintCell?.actions?.highlight
+        ? new Set(hintCell.actions.highlight)
+        : null;
+    const result = [];
+    for (let pencilmark = 1; pencilmark <= 9; pencilmark++) {
+        let color = null;
+        if (highlighting?.has(pencilmark)) {
+            color = ThemeColor.SELECTED;
+        }
+        else if (adding?.has(pencilmark)) {
+            color = ThemeColor.SUCCESS;
+        }
+        else if (removing?.has(pencilmark)) {
+            color = ThemeColor.ERROR;
+        }
+        else if (cellPencilmarks.has(pencilmark)) {
+            color = ThemeColor.LABEL_SECONDARY;
+        }
+        if (color !== null) {
+            result.push({ digit: pencilmark, color });
+        }
+    }
+    return result;
+}
+/**
+ * Generate display states for all cells
+ * This is the main presenter function that matches the Kotlin renderable behavior
+ */
+export function presentBoard(options) {
+    const { cells, selectedIndex, showErrors, hintStep = null, selectedDigitCells = null, } = options;
+    // Calculate hint cell map
+    const cellHints = calculateCellHints(hintStep);
+    // Get selected cell properties (if any)
+    const _selectedCell = selectedIndex !== null ? cells[selectedIndex] : null;
+    void _selectedCell; // Reserved for future use
+    const selectedBlockIndex = selectedIndex !== null ? blockOf(selectedIndex) : null;
+    const selectedRowIndex = selectedIndex !== null ? rowOf(selectedIndex) : null;
+    const selectedColumnIndex = selectedIndex !== null ? columnOf(selectedIndex) : null;
+    // Generate display state for each cell
+    return cells.map((cell, index) => {
+        const cellBlockIndex = blockOf(index);
+        const cellRowIndex = rowOf(index);
+        const cellColumnIndex = columnOf(index);
+        const cellHasValue = cell.input !== null || cell.given !== null;
+        // Get hint for this cell
+        const hintCell = cellHints?.get(index) ?? null;
+        // Get base colors
+        const { backgroundColor, borderColor } = getCellColors(index, cellBlockIndex, cellRowIndex, cellColumnIndex, cellHasValue, selectedIndex, selectedBlockIndex, selectedRowIndex, selectedColumnIndex, selectedDigitCells);
+        // Apply hint colors if present
+        let finalBgColor = backgroundColor;
+        let finalBorderColor = borderColor;
+        if (hintCell) {
+            if (hintCell.fill) {
+                // Hint uses fill: override background
+                const hintBgColor = sudokuColorToTheme(hintCell.color);
+                if (hintBgColor !== null) {
+                    finalBgColor = hintBgColor;
+                }
+            }
+            else {
+                // Hint uses border
+                const hintBdrColor = sudokuColorToTheme(hintCell.color ?? SudokuColor.BLUE);
+                if (hintBdrColor !== null) {
+                    finalBorderColor = hintBdrColor;
+                }
+            }
+        }
+        // Get text info
+        const { digit, textColor, isGiven } = getCellText(cell, showErrors, hintCell);
+        // Get pencilmarks if no digit
+        const pencilmarks = digit === null ? getPencilmarks(cell, hintCell) : [];
+        return {
+            index,
+            backgroundColor: finalBgColor,
+            borderColor: finalBorderColor,
+            textColor,
+            digit,
+            isGiven,
+            pencilmarks,
+        };
+    });
+}
+// =============================================================================
+// Utility: Get cells with a specific digit
+// =============================================================================
+/**
+ * Get indices of cells that contain a specific digit (given or input)
+ * Used for digit highlighting mode
+ */
+export function getCellsWithDigit(cells, digit) {
+    const result = new Set();
+    cells.forEach((cell, index) => {
+        if (cell.given === digit || cell.input === digit) {
+            result.add(index);
+        }
+    });
+    return result;
+}
+/**
+ * Get the selected digit for digit highlighting mode
+ * Matches Kotlin SudokuInteractor.selectedDigit logic:
+ * - If selected cell has a given value: return given
+ * - If selected cell has a CORRECT input (input === solution): return input
+ * - Otherwise: return null (no digit highlighting)
+ */
+export function getSelectedDigit(cells, selectedIndex) {
+    if (selectedIndex === null)
+        return null;
+    const cell = cells[selectedIndex];
+    if (!cell)
+        return null;
+    // Given value takes priority
+    if (cell.given !== null) {
+        return cell.given;
+    }
+    // Only correct input triggers digit highlighting
+    if (cell.input !== null && cell.input === cell.solution) {
+        return cell.input;
+    }
+    return null;
+}
+/**
+ * Compute selectedDigitCells based on selected cell
+ * Returns Set of cell indices that have the same digit as selected cell
+ * Returns null if selected cell doesn't have a highlightable digit
+ */
+export function computeSelectedDigitCells(cells, selectedIndex) {
+    const selectedDigit = getSelectedDigit(cells, selectedIndex);
+    if (selectedDigit === null)
+        return null;
+    return getCellsWithDigit(cells, selectedDigit);
+}
+//# sourceMappingURL=sudokuPresenter.js.map

package/dist/utils/sudokuPresenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sudokuPresenter.js","sourceRoot":"","sources":["../../src/utils/sudokuPresenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAKL,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAChF,8CAA8C;AAC9C,gFAAgF;AAEhF;;GAEG;AACH,MAAM,KAAK;IAIT,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC7B,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC7B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,GAAG;IAIP,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAC5E,CAAC;CACF;AAED;;GAEG;AACH,MAAM,MAAM;IAIV,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC5E,CAAC;CACF;AAED,gFAAgF;AAChF,mDAAmD;AACnD,gFAAgF;AAEhF;;GAEG;AACH,SAAS,kBAAkB,CACzB,WAA+B;IAE/B,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,WAAW,CAAC,IAAI;YACnB,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC7B,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,UAAU,CAAC,iBAAiB,CAAC;QACtC,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,KAAK,WAAW,CAAC,GAAG;YAClB,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,UAAU,CAAC,UAAU,CAAC;QAC/B,KAAK,WAAW,CAAC,UAAU;YACzB,OAAO,UAAU,CAAC,oBAAoB,CAAC;QACzC,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,KAAK,WAAW,CAAC,IAAI;YACnB,OAAO,UAAU,CAAC,eAAe,CAAC;QACpC,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,UAA6B;IAE7B,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,IAAI,CAAC;QACrB,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,OAAO,CAAC,KAAK,CAAC;QACvB,KAAK,UAAU,CAAC,QAAQ;YACtB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,KAAK,UAAU,CAAC,OAAO;YACrB,OAAO,OAAO,CAAC,UAAU,CAAC;QAC5B,KAAK,UAAU,CAAC,iBAAiB;YAC/B,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,KAAK,UAAU,CAAC,OAAO;YACrB,OAAO,OAAO,CAAC,YAAY,CAAC;QAC9B,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,OAAO,CAAC,SAAS,CAAC;QAC3B,KAAK,UAAU,CAAC,UAAU;YACxB,OAAO,OAAO,CAAC,gBAAgB,CAAC;QAClC,KAAK,UAAU,CAAC,oBAAoB;YAClC,OAAO,OAAO,CAAC,yBAAyB,CAAC;QAC3C,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,OAAO,CAAC,KAAK,CAAC;QACvB,KAAK,UAAU,CAAC,eAAe;YAC7B,OAAO,OAAO,CAAC,cAAc,CAAC;QAChC,KAAK,UAAU,CAAC,QAAQ;YACtB,OAAO,OAAO,CAAC,UAAU,CAAC;QAC5B;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAAmB;IACjD,OAAO,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,8DAA8D;AAC9D,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAyB;IAEzB,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE9C,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;QAC7B,IAAI,WAAqB,CAAC;QAE1B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,WAAW,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;gBAChD,MAAM;YACR,KAAK,KAAK;gBACR,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;gBAC9C,MAAM;YACR,KAAK,QAAQ;gBACX,WAAW,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;gBACjD,MAAM;QACV,CAAC;QAED,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC1B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;gBACnB,KAAK;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,EAAE,wBAAwB;aACrC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE;QAC7B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAWD;;;GAGG;AACH,SAAS,aAAa,CACpB,SAAiB,EACjB,cAAsB,EACtB,YAAoB,EACpB,eAAuB,EACvB,YAAqB,EACrB,aAA4B,EAC5B,kBAAiC,EACjC,gBAA+B,EAC/B,mBAAkC,EAClC,kBAAsC;IAEtC,2DAA2D;IAC3D,MAAM,sBAAsB,GAC1B,cAAc,GAAG,CAAC,KAAK,CAAC;QACtB,CAAC,CAAC,UAAU,CAAC,oBAAoB;QACjC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAE5B,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;IAED,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,0BAA0B;QAC1B,IAAI,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,0CAA0C;YAC1C,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACrE,CAAC;QAED,kFAAkF;QAClF,IAAI,YAAY,GAAG,YAAY,CAAC;QAChC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,KAAK,MAAM,gBAAgB,IAAI,kBAAkB,EAAE,CAAC;gBAClD,MAAM,IAAI,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBACxC,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;gBACzC,IACE,YAAY,KAAK,IAAI;oBACrB,eAAe,KAAK,IAAI;oBACxB,cAAc,KAAK,MAAM,EACzB,CAAC;oBACD,YAAY,GAAG,IAAI,CAAC;oBACpB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC5E,CAAC;QAED,iBAAiB;QACjB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;IAED,wBAAwB;IACxB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,sDAAsD;QACtD,OAAO;YACL,eAAe,EAAE,sBAAsB;YACvC,WAAW,EAAE,UAAU,CAAC,QAAQ;SACjC,CAAC;IACJ,CAAC;IAED,IACE,kBAAkB,KAAK,cAAc;QACrC,gBAAgB,KAAK,YAAY;QACjC,mBAAmB,KAAK,eAAe,EACvC,CAAC;QACD,iDAAiD;QACjD,OAAO,EAAE,eAAe,EAAE,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IAED,cAAc;IACd,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACxE,CAAC;AAYD;;;GAGG;AACH,SAAS,WAAW,CAClB,IAAgB,EAChB,UAAmB,EACnB,QAAyB;IAEzB,oCAAoC;IACpC,IAAI,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;YAC9B,SAAS,EAAE,UAAU,CAAC,QAAQ;YAC9B,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ;YAChC,SAAS,EAAE,UAAU,CAAC,KAAK;YAC3B,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,aAAa;IACb,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxB,IAAI,SAAqB,CAAC;QAC1B,IAAI,UAAU,EAAE,CAAC;YACf,SAAS;gBACP,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;QACzE,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;IAED,mBAAmB;IACnB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,gFAAgF;AAChF,sEAAsE;AACtE,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,cAAc,CACrB,IAAgB,EAChB,QAAyB;IAEzB,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW;QACtC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IACtB,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,MAAM,QAAQ,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM;QACxC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,YAAY,GAAG,QAAQ,EAAE,OAAO,EAAE,SAAS;QAC/C,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,MAAM,GAA6B,EAAE,CAAC;IAE5C,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC;QACvD,IAAI,KAAK,GAAsB,IAAI,CAAC;QAEpC,IAAI,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC9B,CAAC;aAAM,IAAI,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC;QAC7B,CAAC;aAAM,IAAI,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC3B,CAAC;aAAM,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC;QACrC,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAmBD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EACJ,KAAK,EACL,aAAa,EACb,UAAU,EACV,QAAQ,GAAG,IAAI,EACf,kBAAkB,GAAG,IAAI,GAC1B,GAAG,OAAO,CAAC;IAEZ,0BAA0B;IAC1B,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE/C,wCAAwC;IACxC,MAAM,aAAa,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,KAAK,aAAa,CAAC,CAAC,0BAA0B;IAC9C,MAAM,kBAAkB,GACtB,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,MAAM,gBAAgB,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,mBAAmB,GACvB,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,uCAAuC;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;QAEhE,yBAAyB;QACzB,MAAM,QAAQ,GAAG,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAE/C,kBAAkB;QAClB,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,GAAG,aAAa,CACpD,KAAK,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,CACnB,CAAC;QAEF,+BAA+B;QAC/B,IAAI,YAAY,GAAG,eAAe,CAAC;QACnC,IAAI,gBAAgB,GAAG,WAAW,CAAC;QAEnC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,sCAAsC;gBACtC,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACvD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACzB,YAAY,GAAG,WAAW,CAAC;gBAC7B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,MAAM,YAAY,GAAG,kBAAkB,CACrC,QAAQ,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,CACnC,CAAC;gBACF,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC1B,gBAAgB,GAAG,YAAY,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,WAAW,CAC/C,IAAI,EACJ,UAAU,EACV,QAAQ,CACT,CAAC;QAEF,8BAA8B;QAC9B,MAAM,WAAW,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzE,OAAO;YACL,KAAK;YACL,eAAe,EAAE,YAAY;YAC7B,WAAW,EAAE,gBAAgB;YAC7B,SAAS;YACT,KAAK;YACL,OAAO;YACP,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAmB,EACnB,aAA4B;IAE5B,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,6BAA6B;IAC7B,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,iDAAiD;IACjD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAmB,EACnB,aAA4B;IAE5B,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7D,IAAI,aAAa,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,iBAAiB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC"}

package/dist/utils/sudokuScrambler.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 { type SudokuCell } from '../types/sudoku';
+export interface ScramblerProtocol {
+    scramble9(symmetrical: boolean): number[];
+}
+/**
+ * Scrambler implementation that matches the Kotlin version
+ */
+export declare const Scrambler: ScramblerProtocol;
+/**
+ * Non-scrambler that returns identity permutation
+ */
+export declare const NonScrambler: ScramblerProtocol;
+export interface ScrambleResult {
+    /** Scrambled cells array */
+    cells: SudokuCell[];
+    /** Digit mapping from original (1-9) to scrambled (1-9) */
+    digitMapping: Map<number, number>;
+    /** Reverse digit mapping from scrambled to original */
+    reverseDigitMapping: Map<number, number>;
+}
+/**
+ * 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 declare function scrambleBoard(scrambler: ScramblerProtocol, cells: SudokuCell[], symmetrical?: boolean): ScrambleResult;
+/**
+ * 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 declare function parsePuzzleString(puzzle: string, solution?: string): SudokuCell[];
+/**
+ * Convert cells to puzzle string
+ */
+export declare function cellsToPuzzleString(cells: SudokuCell[]): string;
+/**
+ * Convert cells to current state string (given + input)
+ */
+export declare function cellsToStateString(cells: SudokuCell[]): string;
+/**
+ * Convert cells to input-only string
+ */
+export declare function cellsToInputString(cells: SudokuCell[]): string;
+/**
+ * Convert cells to pencilmarks string (comma-separated)
+ * Matches Kotlin: pencilmarksParam - returns empty string for null pencilmarks
+ */
+export declare function cellsToPencilmarksString(cells: SudokuCell[]): string;
+//# sourceMappingURL=sudokuScrambler.d.ts.map