@sudobility/sudojo_lib 0.0.201 → 0.0.204

package/dist/utils/hintAccess.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Hint access gating (client side).
+ *
+ * The API serves every hint step to everyone (sudojo_api removed its hint
+ * tiers), so gating happens in useHint: without the level's entitlement only
+ * the first FREE_HINT_STEP_LIMIT steps are visible and `accessError` is set.
+ */
+import type { HintAccessUserState } from '@sudobility/sudojo_types';
+/** Number of hint steps shown for free before the paywall. */
+export declare const FREE_HINT_STEP_LIMIT = 2;
+/** What the hint-access panel's button does. */
+export type HintAccessAction = 
+/** Open sign-in over the game, then dismiss the panel */
+'sign_in'
+/** Go to the subscription screen */
+ | 'subscribe'
+/** Nothing to offer: just close the panel */
+ | 'dismiss';
+/** Which message the hint-access panel shows. */
+export type HintAccessVariant = 'login' | 'subscription' | 'upgrade' | 'unavailable';
+/** Panel behavior for one access state. */
+export interface HintAccessPresentation {
+    action: HintAccessAction;
+    variant: HintAccessVariant;
+}
+/**
+ * Map a hint access state to the panel's action and message variant, as the
+ * web and RN HintAccessPanel do:
+ *
+ * - `anonymous` → sign in (`login` message)
+ * - `no_subscription` → subscribe (`subscription` message)
+ * - `insufficient_tier` → subscribe (`upgrade` message)
+ * - anything else → dismiss (`unavailable` message)
+ *
+ * Note: useHint's client-side gate only produces `no_subscription` and
+ * `insufficient_tier`. `anonymous` came from the API's 402, which it no
+ * longer sends.
+ */
+export declare function getHintAccessAction(state: {
+    userState?: HintAccessUserState | string | null;
+} | null | undefined): HintAccessPresentation;
+/**
+ * i18n key suffixes for each message variant except `unavailable`, which the
+ * apps word differently. Both apps use these suffixes under their own prefix
+ * (web `game.hint.access.`, RN `game.hintAccess.`).
+ */
+export declare const HINT_ACCESS_KEY_SUFFIXES: {
+    readonly login: {
+        readonly title: "loginRequired";
+        readonly message: "loginMessage";
+        readonly button: "loginButton";
+    };
+    readonly subscription: {
+        readonly title: "subscriptionRequired";
+        readonly message: "subscriptionMessage";
+        readonly button: "subscribeButton";
+    };
+    readonly upgrade: {
+        readonly title: "upgradeRequired";
+        readonly message: "upgradeMessage";
+        readonly button: "upgradeButton";
+    };
+};
+//# sourceMappingURL=hintAccess.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hintAccess.d.ts","sourceRoot":"","sources":["../../src/utils/hintAccess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,gDAAgD;AAChD,MAAM,MAAM,gBAAgB;AAC1B,yDAAyD;AACvD,SAAS;AACX,oCAAoC;GAClC,WAAW;AACb,6CAA6C;GAC3C,SAAS,CAAC;AAEd,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,cAAc,GACd,SAAS,GACT,aAAa,CAAC;AAElB,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE;IAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC5E,sBAAsB,CAWxB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;CAgB3B,CAAC"}

package/dist/utils/hintAccess.js

@@ -0,0 +1,57 @@
+/**
+ * Hint access gating (client side).
+ *
+ * The API serves every hint step to everyone (sudojo_api removed its hint
+ * tiers), so gating happens in useHint: without the level's entitlement only
+ * the first FREE_HINT_STEP_LIMIT steps are visible and `accessError` is set.
+ */
+/** Number of hint steps shown for free before the paywall. */
+export const FREE_HINT_STEP_LIMIT = 2;
+/**
+ * Map a hint access state to the panel's action and message variant, as the
+ * web and RN HintAccessPanel do:
+ *
+ * - `anonymous` → sign in (`login` message)
+ * - `no_subscription` → subscribe (`subscription` message)
+ * - `insufficient_tier` → subscribe (`upgrade` message)
+ * - anything else → dismiss (`unavailable` message)
+ *
+ * Note: useHint's client-side gate only produces `no_subscription` and
+ * `insufficient_tier`. `anonymous` came from the API's 402, which it no
+ * longer sends.
+ */
+export function getHintAccessAction(state) {
+    switch (state?.userState) {
+        case 'anonymous':
+            return { action: 'sign_in', variant: 'login' };
+        case 'no_subscription':
+            return { action: 'subscribe', variant: 'subscription' };
+        case 'insufficient_tier':
+            return { action: 'subscribe', variant: 'upgrade' };
+        default:
+            return { action: 'dismiss', variant: 'unavailable' };
+    }
+}
+/**
+ * i18n key suffixes for each message variant except `unavailable`, which the
+ * apps word differently. Both apps use these suffixes under their own prefix
+ * (web `game.hint.access.`, RN `game.hintAccess.`).
+ */
+export const HINT_ACCESS_KEY_SUFFIXES = {
+    login: {
+        title: 'loginRequired',
+        message: 'loginMessage',
+        button: 'loginButton',
+    },
+    subscription: {
+        title: 'subscriptionRequired',
+        message: 'subscriptionMessage',
+        button: 'subscribeButton',
+    },
+    upgrade: {
+        title: 'upgradeRequired',
+        message: 'upgradeMessage',
+        button: 'upgradeButton',
+    },
+};
+//# sourceMappingURL=hintAccess.js.map

package/dist/utils/hintAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hintAccess.js","sourceRoot":"","sources":["../../src/utils/hintAccess.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAwBtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA6E;IAE7E,QAAQ,KAAK,EAAE,SAAS,EAAE,CAAC;QACzB,KAAK,WAAW;YACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACjD,KAAK,iBAAiB;YACpB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1D,KAAK,mBAAmB;YACtB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACrD;YACE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE;QACL,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,cAAc;QACvB,MAAM,EAAE,aAAa;KACtB;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,sBAAsB;QAC7B,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,iBAAiB;KAC1B;IACD,OAAO,EAAE;QACP,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,eAAe;KACxB;CACO,CAAC","sourcesContent":["/**\n * Hint access gating (client side).\n *\n * The API serves every hint step to everyone (sudojo_api removed its hint\n * tiers), so gating happens in useHint: without the level's entitlement only\n * the first FREE_HINT_STEP_LIMIT steps are visible and `accessError` is set.\n */\n\nimport type { HintAccessUserState } from '@sudobility/sudojo_types';\n\n/** Number of hint steps shown for free before the paywall. */\nexport const FREE_HINT_STEP_LIMIT = 2;\n\n/** What the hint-access panel's button does. */\nexport type HintAccessAction =\n  /** Open sign-in over the game, then dismiss the panel */\n  | 'sign_in'\n  /** Go to the subscription screen */\n  | 'subscribe'\n  /** Nothing to offer: just close the panel */\n  | 'dismiss';\n\n/** Which message the hint-access panel shows. */\nexport type HintAccessVariant =\n  | 'login'\n  | 'subscription'\n  | 'upgrade'\n  | 'unavailable';\n\n/** Panel behavior for one access state. */\nexport interface HintAccessPresentation {\n  action: HintAccessAction;\n  variant: HintAccessVariant;\n}\n\n/**\n * Map a hint access state to the panel's action and message variant, as the\n * web and RN HintAccessPanel do:\n *\n * - `anonymous` → sign in (`login` message)\n * - `no_subscription` → subscribe (`subscription` message)\n * - `insufficient_tier` → subscribe (`upgrade` message)\n * - anything else → dismiss (`unavailable` message)\n *\n * Note: useHint's client-side gate only produces `no_subscription` and\n * `insufficient_tier`. `anonymous` came from the API's 402, which it no\n * longer sends.\n */\nexport function getHintAccessAction(\n  state: { userState?: HintAccessUserState | string | null } | null | undefined\n): HintAccessPresentation {\n  switch (state?.userState) {\n    case 'anonymous':\n      return { action: 'sign_in', variant: 'login' };\n    case 'no_subscription':\n      return { action: 'subscribe', variant: 'subscription' };\n    case 'insufficient_tier':\n      return { action: 'subscribe', variant: 'upgrade' };\n    default:\n      return { action: 'dismiss', variant: 'unavailable' };\n  }\n}\n\n/**\n * i18n key suffixes for each message variant except `unavailable`, which the\n * apps word differently. Both apps use these suffixes under their own prefix\n * (web `game.hint.access.`, RN `game.hintAccess.`).\n */\nexport const HINT_ACCESS_KEY_SUFFIXES = {\n  login: {\n    title: 'loginRequired',\n    message: 'loginMessage',\n    button: 'loginButton',\n  },\n  subscription: {\n    title: 'subscriptionRequired',\n    message: 'subscriptionMessage',\n    button: 'subscribeButton',\n  },\n  upgrade: {\n    title: 'upgradeRequired',\n    message: 'upgradeMessage',\n    button: 'upgradeButton',\n  },\n} as const;\n"]}

package/dist/utils/index.d.ts

@@ -4,24 +4,45 @@
 export { cloneBoard, countFilledCells, createGameBoard, getBlockCells, getBlockIndex, getBoardStateString, getColumnCells, getEmptyCells, getPencilmarksString, getRelatedCells, getRowCells, isValidPlacement, } from './board';
 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 { Scrambler, NonScrambler, scrambleBoard as scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, cellsToSolutionString, countClues, } from './sudokuScrambler';
 export type { PresentBoardOptions } from './sudokuPresenter';
-export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, } from './sudokuPresenter';
+export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, solverColorToSudokuColor, parseHintDigits, convertSolverHintStep, isConflictHintStep, } from './sudokuPresenter';
 export { formatTime, parseTime } from './time';
-export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, } from './progress';
+export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, applyPuzzleCompletion, } from './progress';
+export type { PuzzleCompletion } from './progress';
 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 } from './technique';
+export { THEME_STORAGE_KEY, FONT_SIZE_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './theme';
+export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, getPeriodLabelKey, getPeriodLabel, isBestValueProduct, subscriptionPeriodToMonths, calculateSavingsPercent, isCrossPlatformSubscription, canDeleteAccount, getPuzzleDistribution, selectSavingsBasePlan, getPlanSavingsPercent, } from './subscription';
+export type { PricedPeriod, PaywallPlan, DeleteAccountBlocker, DeleteAccountCheck, } from './subscription';
+export type { TechniqueSlug, StrategySlug, StrategyDifficultyTier, StrategySection, TechniqueContent, } from './technique';
+export { getTechniqueIconUrl, toCanonicalTechniquePath, toApiTechniquePath, isSameTechniquePath, findTechniqueByPath, parseTechniqueDependencies, getTechniqueDependencies, getDependentTechniques, sortTechniquesByLevel, groupTechniquesByLevel, getTechniquesForStrategy, findStrategyByStub, TECHNIQUE_SLUGS, STRATEGY_SLUGS, getStrategyDifficultyTier, getStrategyDifficultyKey, getStrategySections, parseTechniqueContent, } from './technique';
+export { exactTechniqueBitmask, techniqueBitmaskString, techniqueFieldsOf, } from './techniqueBitmask';
 export type { WalkthroughStep } from './techniqueWalkthrough';
 export { parsePencilmarksString, pencilmarksToString, parsePracticeBoard, cloneSudokuBoard, applyHintStep, parseHintData, localizeHintStep, buildWalkthroughSteps, } from './techniqueWalkthrough';
 export { generateDetailedExplanation, getHintActionSummary, } from './hintExplanation';
-export type { TranslateFunction } from './localizedHint';
-export { getLocalizedHintText, getLocalizedHintTitle, localizedField, } from './localizedHint';
+export type { TranslateFunction, HintHeadingTree, LocalizedHintHelpers, } from './localizedHint';
+export { getLocalizedHintText, getLocalizedHintTitle, localizedField, HINT_HEADING_KEY_PREFIX, getStepHeadingLocalization, getLocalizedHintHeading, interpolateHintValues, getStepHeadingFromTree, createLocalizedHintHelpers, } from './localizedHint';
+export type { LevelDisplaySource, TechniqueDisplaySource, StrategyDisplaySource, } from './entityTranslate';
+export { createNamespacedTranslate, getLevelDisplayTitle, getLevelDisplayText, getTechniqueDisplayTitle, getBeltDisplayName, getBeltDisplayLabel, getStrategyDisplayTitle, } from './entityTranslate';
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 export { displayDigit } from './digitDisplay';
-export type { ShareUrlParams, ParsedShareParams } from './shareUrl';
+export type { ScannedBoard, ScanBoardErrorCode } from './scannedBoard';
+export { MIN_SCAN_CLUES, ScanBoardError, toScannedBoard, hasScannedInput, scannedBoardFromResponse, } from './scannedBoard';
+export type { ShareUrlParams, ParsedShareParams, ShareUrlType, ShareParamsSource, } from './shareUrl';
 export { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';
 export type { AuthUser } from './auth';
-export { isAuthenticatedUser } from './auth';
+export { isAuthenticatedUser, isRealUser } from './auth';
+export type { SupportedLanguageInfo, SupportedLanguageCode } from './language';
+export { SUPPORTED_LANGUAGES, SUPPORTED_LANGUAGE_CODES, DEFAULT_LANGUAGE, LANGUAGE_STORAGE_KEY, NATIVE_LANGUAGE_STORAGE_KEY, isSupportedLanguage, normalizeLanguageCode, resolveLanguage, toLanguageTag, getLanguageNativeName, } from './language';
+export type { CommunityPlatformInfo } from './community';
+export { COMMUNITY_PLATFORMS, getCommunityPlatform, sortCommunityPlatforms, } from './community';
+export type { BadgeProgress, BadgeDefinitionLike } from './gamification';
+export { LEVEL_MASTERY_BADGE_TYPE, GAMES_PLAYED_BADGE_TYPE, groupBadgeProgress, } from './gamification';
+export type { HintAccessAction, HintAccessVariant, HintAccessPresentation, } from './hintAccess';
+export { FREE_HINT_STEP_LIMIT, getHintAccessAction, HINT_ACCESS_KEY_SUFFIXES, } from './hintAccess';
+export { getUtcDateString, normalizeDailyDate, formatDailyDate, isStaleDaily, } from './date';
+export type { GameFetchResponse, PracticeFetchStatus } from './gameFetchStatus';
+export { isAuthRequiredResponse, isSubscriptionRequiredResponse, getGameFetchStatus, getErrorHttpStatus, getPracticeFetchStatus, } from './gameFetchStatus';
+export type { TechniqueExampleSource, TechniqueWalkthroughTranslations, TechniqueWalkthrough, } from './techniqueExample';
+export { buildTechniqueWalkthrough } from './techniqueExample';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -5,25 +5,36 @@
 export { cloneBoard, countFilledCells, createGameBoard, getBlockCells, getBlockIndex, getBoardStateString, getColumnCells, getEmptyCells, getPencilmarksString, getRelatedCells, getRowCells, isValidPlacement, } from './board';
 // Validation utilities (legacy - for useGame hook)
 export { autoRemovePencilmarks, clearHighlights, countMistakes, getIncorrectCells, getProgressPercentage, isBoardFilled, isCellCorrect, isGameComplete, isValueCorrect, updateCellErrors, updateCellHighlights, validateGameState, } from './validation';
-export { Scrambler, NonScrambler, scrambleBoard as scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, } from './sudokuScrambler';
-export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, } from './sudokuPresenter';
+export { Scrambler, NonScrambler, scrambleBoard as scrambleSudokuBoard, parsePuzzleString, cellsToPuzzleString, cellsToStateString, cellsToInputString, cellsToPencilmarksString, cellsToSolutionString, countClues, } from './sudokuScrambler';
+export { presentBoard, calculateCellHints, themeColorToCSS, getColorPalette, getCellsWithDigit, getSelectedDigit, computeSelectedDigitCells, convertSolverLink, convertSolverCellGroup, sudokuColorToTheme, solverColorToSudokuColor, parseHintDigits, convertSolverHintStep, isConflictHintStep, } from './sudokuPresenter';
 // Time utilities
 export { formatTime, parseTime } from './time';
 // Progress utilities
-export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, } from './progress';
-export { THEME_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './theme';
+export { calculateStats, calculateStreak, isPuzzleCompleted, getCompletedLevelIds, getCompletedDailyDates, applyPuzzleCompletion, } from './progress';
+export { THEME_STORAGE_KEY, FONT_SIZE_STORAGE_KEY, getSystemTheme, resolveTheme, isValidThemePreference, } from './theme';
 // Subscription utilities
-export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, } from './subscription';
-// Technique utilities
-export { getTechniqueIconUrl } from './technique';
+export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBestValuePlan, getRevenueCatErrorMessage, getPeriodLabelKey, getPeriodLabel, isBestValueProduct, subscriptionPeriodToMonths, calculateSavingsPercent, isCrossPlatformSubscription, canDeleteAccount, getPuzzleDistribution, selectSavingsBasePlan, getPlanSavingsPercent, } from './subscription';
+export { getTechniqueIconUrl, toCanonicalTechniquePath, toApiTechniquePath, isSameTechniquePath, findTechniqueByPath, parseTechniqueDependencies, getTechniqueDependencies, getDependentTechniques, sortTechniquesByLevel, groupTechniquesByLevel, getTechniquesForStrategy, findStrategyByStub, TECHNIQUE_SLUGS, STRATEGY_SLUGS, getStrategyDifficultyTier, getStrategyDifficultyKey, getStrategySections, parseTechniqueContent, } from './technique';
+// Technique bitmask utilities
+export { exactTechniqueBitmask, techniqueBitmaskString, techniqueFieldsOf, } from './techniqueBitmask';
 export { parsePencilmarksString, pencilmarksToString, parsePracticeBoard, cloneSudokuBoard, applyHintStep, parseHintData, localizeHintStep, buildWalkthroughSteps, } from './techniqueWalkthrough';
 // Hint explanation utilities
 export { generateDetailedExplanation, getHintActionSummary, } from './hintExplanation';
-export { getLocalizedHintText, getLocalizedHintTitle, localizedField, } from './localizedHint';
+export { getLocalizedHintText, getLocalizedHintTitle, localizedField, HINT_HEADING_KEY_PREFIX, getStepHeadingLocalization, getLocalizedHintHeading, interpolateHintValues, getStepHeadingFromTree, createLocalizedHintHelpers, } from './localizedHint';
+export { createNamespacedTranslate, getLevelDisplayTitle, getLevelDisplayText, getTechniqueDisplayTitle, getBeltDisplayName, getBeltDisplayLabel, getStrategyDisplayTitle, } from './entityTranslate';
 // i18n key utilities
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 // Digit display utilities
 export { displayDigit } from './digitDisplay';
+export { MIN_SCAN_CLUES, ScanBoardError, toScannedBoard, hasScannedInput, scannedBoardFromResponse, } from './scannedBoard';
 export { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';
-export { isAuthenticatedUser } from './auth';
+export { isAuthenticatedUser, isRealUser } from './auth';
+export { SUPPORTED_LANGUAGES, SUPPORTED_LANGUAGE_CODES, DEFAULT_LANGUAGE, LANGUAGE_STORAGE_KEY, NATIVE_LANGUAGE_STORAGE_KEY, isSupportedLanguage, normalizeLanguageCode, resolveLanguage, toLanguageTag, getLanguageNativeName, } from './language';
+export { COMMUNITY_PLATFORMS, getCommunityPlatform, sortCommunityPlatforms, } from './community';
+export { LEVEL_MASTERY_BADGE_TYPE, GAMES_PLAYED_BADGE_TYPE, groupBadgeProgress, } from './gamification';
+export { FREE_HINT_STEP_LIMIT, getHintAccessAction, HINT_ACCESS_KEY_SUFFIXES, } from './hintAccess';
+// Daily date utilities
+export { getUtcDateString, normalizeDailyDate, formatDailyDate, isStaleDaily, } from './date';
+export { isAuthRequiredResponse, isSubscriptionRequiredResponse, getGameFetchStatus, getErrorHttpStatus, getPracticeFetchStatus, } from './gameFetchStatus';
+export { buildTechniqueWalkthrough } from './techniqueExample';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE/C,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIlD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC","sourcesContent":["/**\n * Utility exports for Sudojo library\n */\n\n// Board utilities (legacy - for useGame hook)\nexport {\n  cloneBoard,\n  countFilledCells,\n  createGameBoard,\n  getBlockCells,\n  getBlockIndex,\n  getBoardStateString,\n  getColumnCells,\n  getEmptyCells,\n  getPencilmarksString,\n  getRelatedCells,\n  getRowCells,\n  isValidPlacement,\n} from './board';\n\n// Validation utilities (legacy - for useGame hook)\nexport {\n  autoRemovePencilmarks,\n  clearHighlights,\n  countMistakes,\n  getIncorrectCells,\n  getProgressPercentage,\n  isBoardFilled,\n  isCellCorrect,\n  isGameComplete,\n  isValueCorrect,\n  updateCellErrors,\n  updateCellHighlights,\n  validateGameState,\n} from './validation';\n\n// Sudoku scrambler utilities (for useSudoku hook - ported from renderable)\nexport type {\n  ScramblerProtocol,\n  ScrambleResult as SudokuScrambleResult,\n} from './sudokuScrambler';\nexport {\n  Scrambler,\n  NonScrambler,\n  scrambleBoard as scrambleSudokuBoard,\n  parsePuzzleString,\n  cellsToPuzzleString,\n  cellsToStateString,\n  cellsToInputString,\n  cellsToPencilmarksString,\n} from './sudokuScrambler';\n\n// Sudoku presenter (for rendering - matches Kotlin renderable)\nexport type { PresentBoardOptions } from './sudokuPresenter';\nexport {\n  presentBoard,\n  calculateCellHints,\n  themeColorToCSS,\n  getColorPalette,\n  getCellsWithDigit,\n  getSelectedDigit,\n  computeSelectedDigitCells,\n  convertSolverLink,\n  convertSolverCellGroup,\n  sudokuColorToTheme,\n} from './sudokuPresenter';\n\n// Time utilities\nexport { formatTime, parseTime } from './time';\n\n// Progress utilities\nexport {\n  calculateStats,\n  calculateStreak,\n  isPuzzleCompleted,\n  getCompletedLevelIds,\n  getCompletedDailyDates,\n} from './progress';\n\n// Theme utilities\nexport type { ThemePreference, ResolvedTheme } from './theme';\nexport {\n  THEME_STORAGE_KEY,\n  getSystemTheme,\n  resolveTheme,\n  isValidThemePreference,\n} from './theme';\n\n// Subscription utilities\nexport {\n  convertPackageToProduct,\n  parseCustomerInfo,\n  getPeriodDisplayName,\n  isBestValuePlan,\n  getRevenueCatErrorMessage,\n} from './subscription';\n\n// Technique utilities\nexport { getTechniqueIconUrl } from './technique';\n\n// Technique walkthrough utilities\nexport type { WalkthroughStep } from './techniqueWalkthrough';\nexport {\n  parsePencilmarksString,\n  pencilmarksToString,\n  parsePracticeBoard,\n  cloneSudokuBoard,\n  applyHintStep,\n  parseHintData,\n  localizeHintStep,\n  buildWalkthroughSteps,\n} from './techniqueWalkthrough';\n\n// Hint explanation utilities\nexport {\n  generateDetailedExplanation,\n  getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type { TranslateFunction } from './localizedHint';\nexport {\n  getLocalizedHintText,\n  getLocalizedHintTitle,\n  localizedField,\n} from './localizedHint';\n\n// i18n key utilities\nexport {\n  getBeltKey,\n  getLocalizedBeltName,\n  getBeltLabelKey,\n  getLocalizedBeltLabel,\n  getLevelKey,\n  getLocalizedLevelTitle,\n  getTechniqueKey,\n  getLocalizedTechniqueName,\n} from './i18nKeys';\n\n// Digit display utilities\nexport { displayDigit } from './digitDisplay';\n\n// Share URL utilities\nexport type { ShareUrlParams, ParsedShareParams } from './shareUrl';\nexport { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';\n\n// Auth utilities\nexport type { AuthUser } from './auth';\nexport { isAuthenticatedUser } from './auth';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,mDAAmD;AACnD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAOtB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,IAAI,mBAAmB,EACpC,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE/C,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,sBAAsB,GACvB,MAAM,SAAS,CAAC;AAEjB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAgBxB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIxE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAIrB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAQxB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,YAAY,GACb,MAAM,QAAQ,CAAC;AAIhB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["/**\n * Utility exports for Sudojo library\n */\n\n// Board utilities (legacy - for useGame hook)\nexport {\n  cloneBoard,\n  countFilledCells,\n  createGameBoard,\n  getBlockCells,\n  getBlockIndex,\n  getBoardStateString,\n  getColumnCells,\n  getEmptyCells,\n  getPencilmarksString,\n  getRelatedCells,\n  getRowCells,\n  isValidPlacement,\n} from './board';\n\n// Validation utilities (legacy - for useGame hook)\nexport {\n  autoRemovePencilmarks,\n  clearHighlights,\n  countMistakes,\n  getIncorrectCells,\n  getProgressPercentage,\n  isBoardFilled,\n  isCellCorrect,\n  isGameComplete,\n  isValueCorrect,\n  updateCellErrors,\n  updateCellHighlights,\n  validateGameState,\n} from './validation';\n\n// Sudoku scrambler utilities (for useSudoku hook - ported from renderable)\nexport type {\n  ScramblerProtocol,\n  ScrambleResult as SudokuScrambleResult,\n} from './sudokuScrambler';\nexport {\n  Scrambler,\n  NonScrambler,\n  scrambleBoard as scrambleSudokuBoard,\n  parsePuzzleString,\n  cellsToPuzzleString,\n  cellsToStateString,\n  cellsToInputString,\n  cellsToPencilmarksString,\n  cellsToSolutionString,\n  countClues,\n} from './sudokuScrambler';\n\n// Sudoku presenter (for rendering - matches Kotlin renderable)\nexport type { PresentBoardOptions } from './sudokuPresenter';\nexport {\n  presentBoard,\n  calculateCellHints,\n  themeColorToCSS,\n  getColorPalette,\n  getCellsWithDigit,\n  getSelectedDigit,\n  computeSelectedDigitCells,\n  convertSolverLink,\n  convertSolverCellGroup,\n  sudokuColorToTheme,\n  solverColorToSudokuColor,\n  parseHintDigits,\n  convertSolverHintStep,\n  isConflictHintStep,\n} from './sudokuPresenter';\n\n// Time utilities\nexport { formatTime, parseTime } from './time';\n\n// Progress utilities\nexport {\n  calculateStats,\n  calculateStreak,\n  isPuzzleCompleted,\n  getCompletedLevelIds,\n  getCompletedDailyDates,\n  applyPuzzleCompletion,\n} from './progress';\nexport type { PuzzleCompletion } from './progress';\n\n// Theme utilities\nexport type { ThemePreference, ResolvedTheme } from './theme';\nexport {\n  THEME_STORAGE_KEY,\n  FONT_SIZE_STORAGE_KEY,\n  getSystemTheme,\n  resolveTheme,\n  isValidThemePreference,\n} from './theme';\n\n// Subscription utilities\nexport {\n  convertPackageToProduct,\n  parseCustomerInfo,\n  getPeriodDisplayName,\n  isBestValuePlan,\n  getRevenueCatErrorMessage,\n  getPeriodLabelKey,\n  getPeriodLabel,\n  isBestValueProduct,\n  subscriptionPeriodToMonths,\n  calculateSavingsPercent,\n  isCrossPlatformSubscription,\n  canDeleteAccount,\n  getPuzzleDistribution,\n  selectSavingsBasePlan,\n  getPlanSavingsPercent,\n} from './subscription';\nexport type {\n  PricedPeriod,\n  PaywallPlan,\n  DeleteAccountBlocker,\n  DeleteAccountCheck,\n} from './subscription';\n\n// Technique and strategy utilities\nexport type {\n  TechniqueSlug,\n  StrategySlug,\n  StrategyDifficultyTier,\n  StrategySection,\n  TechniqueContent,\n} from './technique';\nexport {\n  getTechniqueIconUrl,\n  toCanonicalTechniquePath,\n  toApiTechniquePath,\n  isSameTechniquePath,\n  findTechniqueByPath,\n  parseTechniqueDependencies,\n  getTechniqueDependencies,\n  getDependentTechniques,\n  sortTechniquesByLevel,\n  groupTechniquesByLevel,\n  getTechniquesForStrategy,\n  findStrategyByStub,\n  TECHNIQUE_SLUGS,\n  STRATEGY_SLUGS,\n  getStrategyDifficultyTier,\n  getStrategyDifficultyKey,\n  getStrategySections,\n  parseTechniqueContent,\n} from './technique';\n\n// Technique bitmask utilities\nexport {\n  exactTechniqueBitmask,\n  techniqueBitmaskString,\n  techniqueFieldsOf,\n} from './techniqueBitmask';\n\n// Technique walkthrough utilities\nexport type { WalkthroughStep } from './techniqueWalkthrough';\nexport {\n  parsePencilmarksString,\n  pencilmarksToString,\n  parsePracticeBoard,\n  cloneSudokuBoard,\n  applyHintStep,\n  parseHintData,\n  localizeHintStep,\n  buildWalkthroughSteps,\n} from './techniqueWalkthrough';\n\n// Hint explanation utilities\nexport {\n  generateDetailedExplanation,\n  getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type {\n  TranslateFunction,\n  HintHeadingTree,\n  LocalizedHintHelpers,\n} from './localizedHint';\nexport {\n  getLocalizedHintText,\n  getLocalizedHintTitle,\n  localizedField,\n  HINT_HEADING_KEY_PREFIX,\n  getStepHeadingLocalization,\n  getLocalizedHintHeading,\n  interpolateHintValues,\n  getStepHeadingFromTree,\n  createLocalizedHintHelpers,\n} from './localizedHint';\n\n// Entity translation utilities\nexport type {\n  LevelDisplaySource,\n  TechniqueDisplaySource,\n  StrategyDisplaySource,\n} from './entityTranslate';\nexport {\n  createNamespacedTranslate,\n  getLevelDisplayTitle,\n  getLevelDisplayText,\n  getTechniqueDisplayTitle,\n  getBeltDisplayName,\n  getBeltDisplayLabel,\n  getStrategyDisplayTitle,\n} from './entityTranslate';\n\n// i18n key utilities\nexport {\n  getBeltKey,\n  getLocalizedBeltName,\n  getBeltLabelKey,\n  getLocalizedBeltLabel,\n  getLevelKey,\n  getLocalizedLevelTitle,\n  getTechniqueKey,\n  getLocalizedTechniqueName,\n} from './i18nKeys';\n\n// Digit display utilities\nexport { displayDigit } from './digitDisplay';\n\n// Scanned board (OCR) utilities\nexport type { ScannedBoard, ScanBoardErrorCode } from './scannedBoard';\nexport {\n  MIN_SCAN_CLUES,\n  ScanBoardError,\n  toScannedBoard,\n  hasScannedInput,\n  scannedBoardFromResponse,\n} from './scannedBoard';\n\n// Share URL utilities\nexport type {\n  ShareUrlParams,\n  ParsedShareParams,\n  ShareUrlType,\n  ShareParamsSource,\n} from './shareUrl';\nexport { buildShareUrl, parseShareParams, getWebUrl } from './shareUrl';\n\n// Auth utilities\nexport type { AuthUser } from './auth';\nexport { isAuthenticatedUser, isRealUser } from './auth';\n\n// Language utilities\nexport type { SupportedLanguageInfo, SupportedLanguageCode } from './language';\nexport {\n  SUPPORTED_LANGUAGES,\n  SUPPORTED_LANGUAGE_CODES,\n  DEFAULT_LANGUAGE,\n  LANGUAGE_STORAGE_KEY,\n  NATIVE_LANGUAGE_STORAGE_KEY,\n  isSupportedLanguage,\n  normalizeLanguageCode,\n  resolveLanguage,\n  toLanguageTag,\n  getLanguageNativeName,\n} from './language';\n\n// Community utilities\nexport type { CommunityPlatformInfo } from './community';\nexport {\n  COMMUNITY_PLATFORMS,\n  getCommunityPlatform,\n  sortCommunityPlatforms,\n} from './community';\n\n// Gamification utilities\nexport type { BadgeProgress, BadgeDefinitionLike } from './gamification';\nexport {\n  LEVEL_MASTERY_BADGE_TYPE,\n  GAMES_PLAYED_BADGE_TYPE,\n  groupBadgeProgress,\n} from './gamification';\n\n// Hint access utilities\nexport type {\n  HintAccessAction,\n  HintAccessVariant,\n  HintAccessPresentation,\n} from './hintAccess';\nexport {\n  FREE_HINT_STEP_LIMIT,\n  getHintAccessAction,\n  HINT_ACCESS_KEY_SUFFIXES,\n} from './hintAccess';\n\n// Daily date utilities\nexport {\n  getUtcDateString,\n  normalizeDailyDate,\n  formatDailyDate,\n  isStaleDaily,\n} from './date';\n\n// Game fetch status utilities\nexport type { GameFetchResponse, PracticeFetchStatus } from './gameFetchStatus';\nexport {\n  isAuthRequiredResponse,\n  isSubscriptionRequiredResponse,\n  getGameFetchStatus,\n  getErrorHttpStatus,\n  getPracticeFetchStatus,\n} from './gameFetchStatus';\n\n// Technique example walkthrough\nexport type {\n  TechniqueExampleSource,\n  TechniqueWalkthroughTranslations,\n  TechniqueWalkthrough,\n} from './techniqueExample';\nexport { buildTechniqueWalkthrough } from './techniqueExample';\n"]}

package/dist/utils/language.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Supported UI languages and locale-tag resolution.
+ *
+ * **Code casing.** Language codes here are lowercase (`zh-hant`), which is what
+ * the web app uses (i18next `lowerCaseLng`, URL prefixes like `/zh-hant/play`),
+ * what the API stores in `Community.language_code`, and how the locale
+ * directories are named. The RN app keys its i18next resources as `zh-Hant`;
+ * convert with {@link toLanguageTag} there.
+ */
+/** A supported UI language. */
+export interface SupportedLanguageInfo {
+    /** Lowercase language code, e.g. `en`, `zh-hant` */
+    code: string;
+    /** The language's name in itself, e.g. `Deutsch`, `繁體中文` */
+    nativeName: string;
+    /** Flag emoji shown next to the name in the RN language picker */
+    flag: string;
+}
+/**
+ * The 15 supported UI languages, in the web app's order.
+ *
+ * The two app copies differ only in the Chinese native names: the web says
+ * `简体中文` / `繁體中文`, the RN app `中文简体` / `中文繁體`. The web names are used
+ * here (the conventional word order).
+ */
+export declare const SUPPORTED_LANGUAGES: readonly [{
+    readonly code: "en";
+    readonly nativeName: "English";
+    readonly flag: "🇺🇸";
+}, {
+    readonly code: "de";
+    readonly nativeName: "Deutsch";
+    readonly flag: "🇩🇪";
+}, {
+    readonly code: "es";
+    readonly nativeName: "Español";
+    readonly flag: "🇪🇸";
+}, {
+    readonly code: "fr";
+    readonly nativeName: "Français";
+    readonly flag: "🇫🇷";
+}, {
+    readonly code: "it";
+    readonly nativeName: "Italiano";
+    readonly flag: "🇮🇹";
+}, {
+    readonly code: "ja";
+    readonly nativeName: "日本語";
+    readonly flag: "🇯🇵";
+}, {
+    readonly code: "ko";
+    readonly nativeName: "한국어";
+    readonly flag: "🇰🇷";
+}, {
+    readonly code: "pt";
+    readonly nativeName: "Português";
+    readonly flag: "🇧🇷";
+}, {
+    readonly code: "ru";
+    readonly nativeName: "Русский";
+    readonly flag: "🇷🇺";
+}, {
+    readonly code: "sv";
+    readonly nativeName: "Svenska";
+    readonly flag: "🇸🇪";
+}, {
+    readonly code: "th";
+    readonly nativeName: "ไทย";
+    readonly flag: "🇹🇭";
+}, {
+    readonly code: "uk";
+    readonly nativeName: "Українська";
+    readonly flag: "🇺🇦";
+}, {
+    readonly code: "vi";
+    readonly nativeName: "Tiếng Việt";
+    readonly flag: "🇻🇳";
+}, {
+    readonly code: "zh";
+    readonly nativeName: "简体中文";
+    readonly flag: "🇨🇳";
+}, {
+    readonly code: "zh-hant";
+    readonly nativeName: "繁體中文";
+    readonly flag: "🇹🇼";
+}];
+/** A supported language code (lowercase). */
+export type SupportedLanguageCode = (typeof SUPPORTED_LANGUAGES)[number]['code'];
+/** All supported language codes, in SUPPORTED_LANGUAGES order. */
+export declare const SUPPORTED_LANGUAGE_CODES: readonly SupportedLanguageCode[];
+/** The language used when nothing else matches. */
+export declare const DEFAULT_LANGUAGE: SupportedLanguageCode;
+/**
+ * localStorage key for the web app's language preference (`'language'`, the
+ * key i18next-browser-languagedetector and LanguageValidator use).
+ */
+export declare const LANGUAGE_STORAGE_KEY = "language";
+/** AsyncStorage key for the RN app's language preference (`'@sudojo/language'`). */
+export declare const NATIVE_LANGUAGE_STORAGE_KEY = "@sudojo/language";
+/** Whether `code` is a supported language code (exact, lowercase). */
+export declare function isSupportedLanguage(code: string | null | undefined): code is SupportedLanguageCode;
+/**
+ * Map a language code or locale tag to a supported language code, or null.
+ *
+ * Case and `_` / `-` are ignored. Traditional Chinese (`zh-Hant*`, `zh-TW`,
+ * `zh-HK`, `zh-MO`) → `zh-hant`; any other `zh*` → `zh`. Otherwise the full
+ * tag, then its base language (`pt-BR` → `pt`), must be supported.
+ */
+export declare function normalizeLanguageCode(code: string | null | undefined): SupportedLanguageCode | null;
+/**
+ * The supported language for a device/browser locale tag, or
+ * {@link DEFAULT_LANGUAGE} when it is not supported.
+ * Matches the RN app's device-language detection.
+ */
+export declare function resolveLanguage(localeTag: string | null | undefined): SupportedLanguageCode;
+/**
+ * BCP 47 casing of a language code, e.g. `zh-hant` → `zh-Hant` (the RN app's
+ * i18next resource key). Other codes are returned unchanged.
+ */
+export declare function toLanguageTag(code: string): string;
+/** Native name of a language, or undefined for an unsupported code. */
+export declare function getLanguageNativeName(code: string | null | undefined): string | undefined;
+//# sourceMappingURL=language.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/utils/language.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+BAA+B;AAC/B,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBqB,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EACzB,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,EAAE,qBAA4B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,oFAAoF;AACpF,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,IAAI,IAAI,qBAAqB,CAI/B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,qBAAqB,GAAG,IAAI,CAgB9B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,qBAAqB,CAEvB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,MAAM,GAAG,SAAS,CAGpB"}

package/dist/utils/language.js

@@ -0,0 +1,95 @@
+/**
+ * Supported UI languages and locale-tag resolution.
+ *
+ * **Code casing.** Language codes here are lowercase (`zh-hant`), which is what
+ * the web app uses (i18next `lowerCaseLng`, URL prefixes like `/zh-hant/play`),
+ * what the API stores in `Community.language_code`, and how the locale
+ * directories are named. The RN app keys its i18next resources as `zh-Hant`;
+ * convert with {@link toLanguageTag} there.
+ */
+/**
+ * The 15 supported UI languages, in the web app's order.
+ *
+ * The two app copies differ only in the Chinese native names: the web says
+ * `简体中文` / `繁體中文`, the RN app `中文简体` / `中文繁體`. The web names are used
+ * here (the conventional word order).
+ */
+export const SUPPORTED_LANGUAGES = [
+    { code: 'en', nativeName: 'English', flag: '🇺🇸' },
+    { code: 'de', nativeName: 'Deutsch', flag: '🇩🇪' },
+    { code: 'es', nativeName: 'Español', flag: '🇪🇸' },
+    { code: 'fr', nativeName: 'Français', flag: '🇫🇷' },
+    { code: 'it', nativeName: 'Italiano', flag: '🇮🇹' },
+    { code: 'ja', nativeName: '日本語', flag: '🇯🇵' },
+    { code: 'ko', nativeName: '한국어', flag: '🇰🇷' },
+    { code: 'pt', nativeName: 'Português', flag: '🇧🇷' },
+    { code: 'ru', nativeName: 'Русский', flag: '🇷🇺' },
+    { code: 'sv', nativeName: 'Svenska', flag: '🇸🇪' },
+    { code: 'th', nativeName: 'ไทย', flag: '🇹🇭' },
+    { code: 'uk', nativeName: 'Українська', flag: '🇺🇦' },
+    { code: 'vi', nativeName: 'Tiếng Việt', flag: '🇻🇳' },
+    { code: 'zh', nativeName: '简体中文', flag: '🇨🇳' },
+    { code: 'zh-hant', nativeName: '繁體中文', flag: '🇹🇼' },
+];
+/** All supported language codes, in SUPPORTED_LANGUAGES order. */
+export const SUPPORTED_LANGUAGE_CODES = SUPPORTED_LANGUAGES.map(lang => lang.code);
+/** The language used when nothing else matches. */
+export const DEFAULT_LANGUAGE = 'en';
+/**
+ * localStorage key for the web app's language preference (`'language'`, the
+ * key i18next-browser-languagedetector and LanguageValidator use).
+ */
+export const LANGUAGE_STORAGE_KEY = 'language';
+/** AsyncStorage key for the RN app's language preference (`'@sudojo/language'`). */
+export const NATIVE_LANGUAGE_STORAGE_KEY = '@sudojo/language';
+/** Whether `code` is a supported language code (exact, lowercase). */
+export function isSupportedLanguage(code) {
+    return (!!code && SUPPORTED_LANGUAGE_CODES.includes(code));
+}
+/**
+ * Map a language code or locale tag to a supported language code, or null.
+ *
+ * Case and `_` / `-` are ignored. Traditional Chinese (`zh-Hant*`, `zh-TW`,
+ * `zh-HK`, `zh-MO`) → `zh-hant`; any other `zh*` → `zh`. Otherwise the full
+ * tag, then its base language (`pt-BR` → `pt`), must be supported.
+ */
+export function normalizeLanguageCode(code) {
+    if (!code)
+        return null;
+    const tag = code.trim().toLowerCase().replace(/_/g, '-');
+    if (!tag)
+        return null;
+    if (tag.startsWith('zh-hant') ||
+        tag.startsWith('zh-tw') ||
+        tag.startsWith('zh-hk') ||
+        tag.startsWith('zh-mo')) {
+        return 'zh-hant';
+    }
+    if (tag === 'zh' || tag.startsWith('zh-'))
+        return 'zh';
+    if (isSupportedLanguage(tag))
+        return tag;
+    const base = tag.split('-')[0];
+    return isSupportedLanguage(base) ? base : null;
+}
+/**
+ * The supported language for a device/browser locale tag, or
+ * {@link DEFAULT_LANGUAGE} when it is not supported.
+ * Matches the RN app's device-language detection.
+ */
+export function resolveLanguage(localeTag) {
+    return normalizeLanguageCode(localeTag) ?? DEFAULT_LANGUAGE;
+}
+/**
+ * BCP 47 casing of a language code, e.g. `zh-hant` → `zh-Hant` (the RN app's
+ * i18next resource key). Other codes are returned unchanged.
+ */
+export function toLanguageTag(code) {
+    return code.toLowerCase() === 'zh-hant' ? 'zh-Hant' : code;
+}
+/** Native name of a language, or undefined for an unsupported code. */
+export function getLanguageNativeName(code) {
+    const normalized = normalizeLanguageCode(code);
+    return SUPPORTED_LANGUAGES.find(lang => lang.code === normalized)?.nativeName;
+}
+//# sourceMappingURL=language.js.map

package/dist/utils/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/utils/language.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Supported UI languages and locale-tag resolution.\n *\n * **Code casing.** Language codes here are lowercase (`zh-hant`), which is what\n * the web app uses (i18next `lowerCaseLng`, URL prefixes like `/zh-hant/play`),\n * what the API stores in `Community.language_code`, and how the locale\n * directories are named. The RN app keys its i18next resources as `zh-Hant`;\n * convert with {@link toLanguageTag} there.\n */\n\n/** A supported UI language. */\nexport interface SupportedLanguageInfo {\n  /** Lowercase language code, e.g. `en`, `zh-hant` */\n  code: string;\n  /** The language's name in itself, e.g. `Deutsch`, `繁體中文` */\n  nativeName: string;\n  /** Flag emoji shown next to the name in the RN language picker */\n  flag: string;\n}\n\n/**\n * The 15 supported UI languages, in the web app's order.\n *\n * The two app copies differ only in the Chinese native names: the web says\n * `简体中文` / `繁體中文`, the RN app `中文简体` / `中文繁體`. The web names are used\n * here (the conventional word order).\n */\nexport const SUPPORTED_LANGUAGES = [\n  { code: 'en', nativeName: 'English', flag: '🇺🇸' },\n  { code: 'de', nativeName: 'Deutsch', flag: '🇩🇪' },\n  { code: 'es', nativeName: 'Español', flag: '🇪🇸' },\n  { code: 'fr', nativeName: 'Français', flag: '🇫🇷' },\n  { code: 'it', nativeName: 'Italiano', flag: '🇮🇹' },\n  { code: 'ja', nativeName: '日本語', flag: '🇯🇵' },\n  { code: 'ko', nativeName: '한국어', flag: '🇰🇷' },\n  { code: 'pt', nativeName: 'Português', flag: '🇧🇷' },\n  { code: 'ru', nativeName: 'Русский', flag: '🇷🇺' },\n  { code: 'sv', nativeName: 'Svenska', flag: '🇸🇪' },\n  { code: 'th', nativeName: 'ไทย', flag: '🇹🇭' },\n  { code: 'uk', nativeName: 'Українська', flag: '🇺🇦' },\n  { code: 'vi', nativeName: 'Tiếng Việt', flag: '🇻🇳' },\n  { code: 'zh', nativeName: '简体中文', flag: '🇨🇳' },\n  { code: 'zh-hant', nativeName: '繁體中文', flag: '🇹🇼' },\n] as const satisfies readonly SupportedLanguageInfo[];\n\n/** A supported language code (lowercase). */\nexport type SupportedLanguageCode =\n  (typeof SUPPORTED_LANGUAGES)[number]['code'];\n\n/** All supported language codes, in SUPPORTED_LANGUAGES order. */\nexport const SUPPORTED_LANGUAGE_CODES: readonly SupportedLanguageCode[] =\n  SUPPORTED_LANGUAGES.map(lang => lang.code);\n\n/** The language used when nothing else matches. */\nexport const DEFAULT_LANGUAGE: SupportedLanguageCode = 'en';\n\n/**\n * localStorage key for the web app's language preference (`'language'`, the\n * key i18next-browser-languagedetector and LanguageValidator use).\n */\nexport const LANGUAGE_STORAGE_KEY = 'language';\n\n/** AsyncStorage key for the RN app's language preference (`'@sudojo/language'`). */\nexport const NATIVE_LANGUAGE_STORAGE_KEY = '@sudojo/language';\n\n/** Whether `code` is a supported language code (exact, lowercase). */\nexport function isSupportedLanguage(\n  code: string | null | undefined\n): code is SupportedLanguageCode {\n  return (\n    !!code && (SUPPORTED_LANGUAGE_CODES as readonly string[]).includes(code)\n  );\n}\n\n/**\n * Map a language code or locale tag to a supported language code, or null.\n *\n * Case and `_` / `-` are ignored. Traditional Chinese (`zh-Hant*`, `zh-TW`,\n * `zh-HK`, `zh-MO`) → `zh-hant`; any other `zh*` → `zh`. Otherwise the full\n * tag, then its base language (`pt-BR` → `pt`), must be supported.\n */\nexport function normalizeLanguageCode(\n  code: string | null | undefined\n): SupportedLanguageCode | null {\n  if (!code) return null;\n  const tag = code.trim().toLowerCase().replace(/_/g, '-');\n  if (!tag) return null;\n  if (\n    tag.startsWith('zh-hant') ||\n    tag.startsWith('zh-tw') ||\n    tag.startsWith('zh-hk') ||\n    tag.startsWith('zh-mo')\n  ) {\n    return 'zh-hant';\n  }\n  if (tag === 'zh' || tag.startsWith('zh-')) return 'zh';\n  if (isSupportedLanguage(tag)) return tag;\n  const base = tag.split('-')[0];\n  return isSupportedLanguage(base) ? base : null;\n}\n\n/**\n * The supported language for a device/browser locale tag, or\n * {@link DEFAULT_LANGUAGE} when it is not supported.\n * Matches the RN app's device-language detection.\n */\nexport function resolveLanguage(\n  localeTag: string | null | undefined\n): SupportedLanguageCode {\n  return normalizeLanguageCode(localeTag) ?? DEFAULT_LANGUAGE;\n}\n\n/**\n * BCP 47 casing of a language code, e.g. `zh-hant` → `zh-Hant` (the RN app's\n * i18next resource key). Other codes are returned unchanged.\n */\nexport function toLanguageTag(code: string): string {\n  return code.toLowerCase() === 'zh-hant' ? 'zh-Hant' : code;\n}\n\n/** Native name of a language, or undefined for an unsupported code. */\nexport function getLanguageNativeName(\n  code: string | null | undefined\n): string | undefined {\n  const normalized = normalizeLanguageCode(code);\n  return SUPPORTED_LANGUAGES.find(lang => lang.code === normalized)?.nativeName;\n}\n"]}

package/dist/utils/localizedHint.d.ts

@@ -35,4 +35,64 @@ export declare function getLocalizedHintText(t: TranslateFunction, step: SolverH
  */
 export declare function localizedField(t: TranslateFunction, loc: LocalizedHint | undefined, fallback: string | null | undefined): string;
 export declare function getLocalizedHintTitle(t: TranslateFunction, step: SolverHintStep, keyPrefix?: string): string;
+/**
+ * Top-level tree in the apps' `hints.json` that mirrors `hints`, with one
+ * heading per step: `hints.hiddenSingle.row.scan` → `headings.hiddenSingle.row.scan`.
+ */
+export declare const HINT_HEADING_KEY_PREFIX = "headings.";
+/**
+ * Heading lookup for ONE hint step.
+ *
+ * Every step key the solver emits (`hints.hiddenSingle.row.scan`) has a heading
+ * at the same path under the `headings` tree (`headings.hiddenSingle.row.scan`),
+ * interpolated with that step's own values, so `{{valueN}}` means the same in
+ * the heading as in the body. Injected `hints.conflict.*` steps get headings too.
+ *
+ * Accepts the legacy flat localization shape. Returns undefined when the step
+ * carries no `hints.*` localization; callers then render no heading.
+ */
+export declare function getStepHeadingLocalization(step: SolverHintStep | null | undefined): LocalizedHint | undefined;
+/**
+ * Translated heading for one hint step, or '' when it has none (no `hints.*`
+ * key, or the heading is missing), so the UI renders nothing instead of a raw key.
+ *
+ * @param t - Translation function for the `hints` namespace
+ */
+export declare function getLocalizedHintHeading(t: TranslateFunction, step: SolverHintStep | null | undefined): string;
+/** A nested heading tree, e.g. the `headings` object of `hints.json`. */
+export interface HintHeadingTree {
+    [key: string]: string | HintHeadingTree;
+}
+/**
+ * Fill `{{valueN}}` placeholders from a values array (values[0] → `{{value1}}`).
+ * Missing values become ''.
+ */
+export declare function interpolateHintValues(template: string, values: readonly string[]): string;
+/**
+ * Heading for one hint step looked up directly in a heading tree, without an
+ * i18n library (the Chrome extension bundles the English tree as JSON).
+ *
+ * The step's `hints.<path>` key maps to `<path>` in the tree and the template
+ * is interpolated with the step's values. Returns '' when there is no heading.
+ */
+export declare function getStepHeadingFromTree(tree: HintHeadingTree, step: SolverHintStep | null | undefined): string;
+/** Localized text, title and heading resolvers for hint steps. */
+export interface LocalizedHintHelpers {
+    /** Localized body text (falls back to `step.text`). */
+    getLocalizedText: (step: SolverHintStep) => string;
+    /** Localized technique title (falls back to `step.title`). */
+    getLocalizedTitle: (step: SolverHintStep) => string;
+    /** Localized per-step heading, or ''. */
+    getLocalizedHeading: (step: SolverHintStep | null | undefined) => string;
+}
+/**
+ * Build the hint text/title/heading resolvers the apps' `useLocalizedHint`
+ * hooks return. The hooks stay in the apps because they read react-i18next;
+ * they should wrap this.
+ *
+ * @param tHints - Translate function for the `hints` namespace (text + headings)
+ * @param tTitle - Entity translate function for titles
+ *   (`techniques.<path>.title`), e.g. from createNamespacedTranslate
+ */
+export declare function createLocalizedHintHelpers(tHints: TranslateFunction, tTitle: TranslateFunction): LocalizedHintHelpers;
 //# sourceMappingURL=localizedHint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"localizedHint.d.ts","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,MAAM,CAAC;AA0DZ;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR;AAED;;;;;;;GAOG;AACH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,aAAa,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR"}
+{"version":3,"file":"localizedHint.d.ts","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,MAAM,CAAC;AA0DZ;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR;AAED;;;;;;;GAOG;AACH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,EACpB,GAAG,EAAE,aAAa,GAAG,SAAS,EAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,MAAM,CAER;AAED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR;AAQD;;;GAGG;AACH,eAAO,MAAM,uBAAuB,cAAc,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GACtC,aAAa,GAAG,SAAS,CAU3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GACtC,MAAM,CAGR;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GACtC,MAAM,CAeR;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,gBAAgB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,CAAC;IACnD,8DAA8D;IAC9D,iBAAiB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,CAAC;IACpD,yCAAyC;IACzC,mBAAmB,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,KAAK,MAAM,CAAC;CAC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CAMtB"}