npm - @sudobility/sudojo_lib - Versions diffs - 0.0.126 → 0.0.129 - Mend

@sudobility/sudojo_lib 0.0.126 → 0.0.129

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/dist/hooks/useGameSession.d.ts +5 -1
package/dist/hooks/useGameSession.d.ts.map +1 -1
package/dist/hooks/useGameSession.js.map +1 -1
package/dist/index.d.ts +3 -1
package/dist/index.d.ts.map +1 -1
package/dist/index.js +3 -1
package/dist/index.js.map +1 -1
package/dist/utils/index.d.ts +1 -1
package/dist/utils/index.d.ts.map +1 -1
package/dist/utils/index.js +1 -1
package/dist/utils/index.js.map +1 -1
package/dist/utils/localizedHint.d.ts +12 -0
package/dist/utils/localizedHint.d.ts.map +1 -1
package/dist/utils/localizedHint.js +49 -12
package/dist/utils/localizedHint.js.map +1 -1
package/package.json +5 -5

package/dist/hooks/useGameSession.d.ts CHANGED Viewed

@@ -6,7 +6,7 @@
  * - Finishing game sessions and receiving rewards
  * - Tracking achievement results for display
  */
-import type { GameFinishResponse, GameStartRequest } from '@sudobility/sudojo_types';
+import type { GameFinishResponse, GameStartRequest, LocalizedHint } from '@sudobility/sudojo_types';
 import type { NetworkClient } from '@sudobility/types';
 export interface UseGameSessionOptions {
     networkClient: NetworkClient;
@@ -30,6 +30,10 @@ export interface GameFinishResult {
         badgeKey: string;
         title: string;
         description: string | null;
+        localization?: {
+            title?: LocalizedHint;
+            description?: LocalizedHint;
+        };
     }>;
     /** Total points earned */
     totalPointsEarned: number;

package/dist/hooks/useGameSession.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useGameSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameSession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,~~EACjB~~,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;~~KAC5B~~,CAAC,CAAC;IACH,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB;yBAyBP,gBAAgB,KAAG,OAAO,CAAC,iBAAiB,CAAC;iCAsCtC,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC;;;;;EA4DzD"}
1	+ {"version":3,"file":"useGameSession.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameSession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,cAAc,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,CAAC,EAAE;YACb,KAAK,CAAC,EAAE,aAAa,CAAC;YACtB,WAAW,CAAC,EAAE,aAAa,CAAC;SAC7B,CAAC;KACH,CAAC,CAAC;IACH,0BAA0B;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,EAC7B,aAAa,EACb,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB;yBAyBP,gBAAgB,KAAG,OAAO,CAAC,iBAAiB,CAAC;iCAsCtC,MAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC;;;;;EA4DzD"}

package/dist/hooks/useGameSession.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"useGameSession.js","sourceRoot":"","sources":["../../src/hooks/useGameSession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;~~AAoCnC~~,MAAM,UAAU,cAAc,CAAC,EAC7B,aAAa,EACb,OAAO,EACP,KAAK,EACL,MAAM,GACgB;IACtB,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEjD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAEvE,2DAA2D;IAC3D,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,GAAG,EAAE;QACb,YAAY,CAAC,OAAO,GAAG,iBAAiB,CAAC;QACzC,aAAa,CAAC,OAAO,GAAG,kBAAkB,CAAC;QAC3C,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QACzB,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH;;;OAGG;IACH,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,IAAsB,EAA8B,EAAE;QAC3D,4BAA4B;QAC5B,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;QAED,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC;gBACtD,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtC,YAAY,CAAC,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC/C,OAAO;oBACL,cAAc,EAAE,IAAI;oBACpB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS;iBACnC,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2CAA2C;YAC3C,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;YAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,EAAE,CACH,CAAC;IAEF;;;OAGG;IACH,MAAM,aAAa,GAAG,WAAW,CAC/B,KAAK,EAAE,WAAmB,EAA6B,EAAE;QACvD,4BAA4B;QAC5B,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,EAAE;gBACb,iBAAiB,EAAE,CAAC;aACrB,CAAC;QACJ,CAAC;QAED,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC;gBACvD,KAAK,EAAE,QAAQ,CAAC,OAAO;gBACvB,IAAI,EAAE,EAAE,WAAW,EAAE;aACtB,CAAC,CAAC;YAEH,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC;YAE5B,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACtC,OAAO;oBACL,QAAQ,EAAE,QAAQ,CAAC,IAAI;oBACvB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK;oBAChC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE;oBACrC,iBAAiB,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;iBACpD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,EAAE;gBACb,iBAAiB,EAAE,CAAC;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACvD,OAAO;gBACL,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,EAAE;gBACb,iBAAiB,EAAE,CAAC;aACrB,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,EACD,EAAE,CACH,CAAC;IAEF;;OAEG;IACH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;IAE5C,OAAO;QACL,YAAY;QACZ,aAAa;QACb,UAAU;QACV,WAAW;QACX,eAAe;QACf,SAAS,EAAE,YAAY,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC","sourcesContent":["/*\n Hook for managing game sessions with gamification\n \n Handles:\n * - Starting game sessions on the server\n * - Finishing game sessions and receiving rewards\n * - Tracking achievement results for display\n /\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n useSudojoPlayFinish,\n useSudojoPlayStart,\n} from '@sudobility/sudojo_client';\nimport type {\n GameFinishResponse,\n GameStartRequest,\n} from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\n\nexport interface UseGameSessionOptions {\n networkClient: NetworkClient;\n baseUrl: string;\n token: string \| null;\n userId: string \| null;\n}\n\nexport interface GameSessionResult {\n /* Whether a server session was started /\n sessionStarted: boolean;\n /* Session ID from server (if started) /\n sessionId?: string;\n}\n\nexport interface GameFinishResult {\n /* The full response from the server /\n response?: GameFinishResponse;\n /* Whether the user leveled up /\n leveledUp: boolean;\n /* New badges earned /\n newBadges: Array<{\n badgeKey: string;\n title: string;\n description: string \| null;\n }>;\n /* Total points earned /\n totalPointsEarned: number;\n}\n\nexport function useGameSession({\n networkClient,\n baseUrl,\n token,\n userId,\n}: UseGameSessionOptions) {\n const [isStarting, setIsStarting] = useState(false);\n const [isFinishing, setIsFinishing] = useState(false);\n const sessionIdRef = useRef<string \| null>(null);\n\n const playStartMutation = useSudojoPlayStart(networkClient, baseUrl);\n const playFinishMutation = useSudojoPlayFinish(networkClient, baseUrl);\n\n // Use refs for mutations so callbacks have stable identity\n const playStartRef = useRef(playStartMutation);\n const playFinishRef = useRef(playFinishMutation);\n const tokenRef = useRef(token);\n const userIdRef = useRef(userId);\n useEffect(() => {\n playStartRef.current = playStartMutation;\n playFinishRef.current = playFinishMutation;\n tokenRef.current = token;\n userIdRef.current = userId;\n });\n\n /\n Start a game session on the server\n * Only works if user is authenticated\n /\n const startSession = useCallback(\n async (data: GameStartRequest): Promise<GameSessionResult> => {\n // Skip if not authenticated\n if (!userIdRef.current \|\| !tokenRef.current) {\n return { sessionStarted: false };\n }\n\n setIsStarting(true);\n try {\n const response = await playStartRef.current.mutateAsync({\n token: tokenRef.current,\n data,\n });\n\n if (response.success && response.data) {\n sessionIdRef.current = response.data.sessionId;\n return {\n sessionStarted: true,\n sessionId: response.data.sessionId,\n };\n }\n\n return { sessionStarted: false };\n } catch (error) {\n // Non-critical: gamification tracking only\n console.log('[game-session] Failed to start session:', error);\n return { sessionStarted: false };\n } finally {\n setIsStarting(false);\n }\n },\n []\n );\n\n /\n Finish the game session and get rewards\n * Only works if user is authenticated and session was started\n /\n const finishSession = useCallback(\n async (elapsedTime: number): Promise<GameFinishResult> => {\n // Skip if not authenticated\n if (!userIdRef.current \|\| !tokenRef.current) {\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n }\n\n setIsFinishing(true);\n try {\n const response = await playFinishRef.current.mutateAsync({\n token: tokenRef.current,\n data: { elapsedTime },\n });\n\n sessionIdRef.current = null;\n\n if (response.success && response.data) {\n return {\n response: response.data,\n leveledUp: !!response.data.level,\n newBadges: response.data.badges ?? [],\n totalPointsEarned: response.data.points.totalPoints,\n };\n }\n\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n } catch (error) {\n console.error('Failed to finish game session:', error);\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n } finally {\n setIsFinishing(false);\n }\n },\n []\n );\n\n /\n Check if user is authenticated (can use gamification)\n */\n const isAuthenticated = !!userId && !!token;\n\n return {\n startSession,\n finishSession,\n isStarting,\n isFinishing,\n isAuthenticated,\n sessionId: sessionIdRef.current,\n };\n}\n"]}
1	+ {"version":3,"file":"useGameSession.js","sourceRoot":"","sources":["../../src/hooks/useGameSession.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Hook for managing game sessions with gamification\n \n Handles:\n * - Starting game sessions on the server\n * - Finishing game sessions and receiving rewards\n * - Tracking achievement results for display\n /\n\nimport { useCallback, useEffect, useRef, useState } from 'react';\nimport {\n useSudojoPlayFinish,\n useSudojoPlayStart,\n} from '@sudobility/sudojo_client';\nimport type {\n GameFinishResponse,\n GameStartRequest,\n LocalizedHint,\n} from '@sudobility/sudojo_types';\nimport type { NetworkClient } from '@sudobility/types';\n\nexport interface UseGameSessionOptions {\n networkClient: NetworkClient;\n baseUrl: string;\n token: string \| null;\n userId: string \| null;\n}\n\nexport interface GameSessionResult {\n /* Whether a server session was started /\n sessionStarted: boolean;\n /* Session ID from server (if started) /\n sessionId?: string;\n}\n\nexport interface GameFinishResult {\n /* The full response from the server /\n response?: GameFinishResponse;\n /* Whether the user leveled up /\n leveledUp: boolean;\n /* New badges earned /\n newBadges: Array<{\n badgeKey: string;\n title: string;\n description: string \| null;\n localization?: {\n title?: LocalizedHint;\n description?: LocalizedHint;\n };\n }>;\n /* Total points earned /\n totalPointsEarned: number;\n}\n\nexport function useGameSession({\n networkClient,\n baseUrl,\n token,\n userId,\n}: UseGameSessionOptions) {\n const [isStarting, setIsStarting] = useState(false);\n const [isFinishing, setIsFinishing] = useState(false);\n const sessionIdRef = useRef<string \| null>(null);\n\n const playStartMutation = useSudojoPlayStart(networkClient, baseUrl);\n const playFinishMutation = useSudojoPlayFinish(networkClient, baseUrl);\n\n // Use refs for mutations so callbacks have stable identity\n const playStartRef = useRef(playStartMutation);\n const playFinishRef = useRef(playFinishMutation);\n const tokenRef = useRef(token);\n const userIdRef = useRef(userId);\n useEffect(() => {\n playStartRef.current = playStartMutation;\n playFinishRef.current = playFinishMutation;\n tokenRef.current = token;\n userIdRef.current = userId;\n });\n\n /\n Start a game session on the server\n * Only works if user is authenticated\n /\n const startSession = useCallback(\n async (data: GameStartRequest): Promise<GameSessionResult> => {\n // Skip if not authenticated\n if (!userIdRef.current \|\| !tokenRef.current) {\n return { sessionStarted: false };\n }\n\n setIsStarting(true);\n try {\n const response = await playStartRef.current.mutateAsync({\n token: tokenRef.current,\n data,\n });\n\n if (response.success && response.data) {\n sessionIdRef.current = response.data.sessionId;\n return {\n sessionStarted: true,\n sessionId: response.data.sessionId,\n };\n }\n\n return { sessionStarted: false };\n } catch (error) {\n // Non-critical: gamification tracking only\n console.log('[game-session] Failed to start session:', error);\n return { sessionStarted: false };\n } finally {\n setIsStarting(false);\n }\n },\n []\n );\n\n /\n Finish the game session and get rewards\n * Only works if user is authenticated and session was started\n /\n const finishSession = useCallback(\n async (elapsedTime: number): Promise<GameFinishResult> => {\n // Skip if not authenticated\n if (!userIdRef.current \|\| !tokenRef.current) {\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n }\n\n setIsFinishing(true);\n try {\n const response = await playFinishRef.current.mutateAsync({\n token: tokenRef.current,\n data: { elapsedTime },\n });\n\n sessionIdRef.current = null;\n\n if (response.success && response.data) {\n return {\n response: response.data,\n leveledUp: !!response.data.level,\n newBadges: response.data.badges ?? [],\n totalPointsEarned: response.data.points.totalPoints,\n };\n }\n\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n } catch (error) {\n console.error('Failed to finish game session:', error);\n return {\n leveledUp: false,\n newBadges: [],\n totalPointsEarned: 0,\n };\n } finally {\n setIsFinishing(false);\n }\n },\n []\n );\n\n /\n Check if user is authenticated (can use gamification)\n */\n const isAuthenticated = !!userId && !!token;\n\n return {\n startSession,\n finishSession,\n isStarting,\n isFinishing,\n isAuthenticated,\n sessionId: sessionIdRef.current,\n };\n}\n"]}

package/dist/index.d.ts CHANGED Viewed

@@ -340,7 +340,9 @@ TranslateFunction, } from './utils';
 /** Hint localization utilities. */
 export {
 /** Get localized text for a hint step using a translation function. */
-getLocalizedHintText, } from './utils';
+getLocalizedHintText,
+/** Get localized title for a hint step using a translation function. */
+getLocalizedHintTitle, } from './utils';
 /** Internationalization key generation and localization utilities. */
 export {
 /** Get i18n key for a belt name (e.g., 'belts.1.name'). */

package/dist/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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~~GACrB~~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"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js CHANGED Viewed

@@ -258,7 +258,9 @@ getHintActionSummary, } from './utils';
 /** Hint localization utilities. */
 export {
 /** Get localized text for a hint step using a translation function. */
-getLocalizedHintText, } from './utils';
+getLocalizedHintText,
+/** Get localized title for a hint step using a translation function. */
+getLocalizedHintTitle, } from './utils';
 // ============================================================================
 // i18n Key Utilities
 // ============================================================================

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n @sudobility/sudojo_lib - Business logic library for Sudojo app\n \n This library provides:\n * - Game state management with useSudoku hook (ported from renderable)\n * - Board scrambling utilities\n * - Game validation (mistakes, completion)\n * - Level, technique, and learning data hooks\n * - Teaching/hint integration with solver\n * - Legacy useGame hook for backward compatibility\n \n ## Hook Architecture\n \n The hooks form a layered composition pattern:\n \n Data hooks (fetch and cache server data):\n * - `useLevels` / `useLevel` - Difficulty level data\n * - `useTechniques` / `useTechnique` - Solving technique data\n * - `useLearning` / `useLearningItem` - Learning material data\n \n Game fetching hooks (handle auth, subscription, and puzzle loading):\n * - `useLevelGame` - Fetch a random board for a specific level\n * - `useDailyGame` - Fetch today's daily puzzle\n \n Game state hooks (manage board state and user interaction):\n * - `useSudoku` - Primary game state (flat 81-cell array, modern API)\n * - `useGame` - Legacy game state (2D array, deprecated)\n * - `useBoardEntry` - Manual puzzle entry mode\n \n Feature hooks (provide specific game features):\n * - `useHint` - Solver integration for hints (matches Kotlin HintInteractor)\n * - `useGameTeaching` - Step-by-step teaching with solver\n * - `useGameTimer` - Elapsed time tracking via ref (no re-renders)\n * - `useGamePersistence` / `useAutoSave` - localStorage game save/restore\n * - `useLocalStorage` - Generic typed localStorage hook\n \n Orchestration hooks (combine multiple hooks for app-level features):\n * - `useGamePlay` - Current game management with Zustand store (daily/play slots)\n * - `useGameSession` - Server-side gamification (start/finish, points, badges)\n \n ## Migration Guide\n \n Legacy exports (prefixed with \"Legacy\" comments) use the 2D `GameBoard` type\n * from `useGame`. New code should use `useSudoku` with its flat 81-cell\n * `SudokuBoard` type. See `@deprecated` tags on legacy exports.\n /\n\n// ============================================================================\n// Legacy Types (useGame hook)\n// ============================================================================\n\n/\n @deprecated Use `SudokuCell` instead. Part of the legacy `useGame` 2D board API.\n /\nexport type {\n CellPosition,\n CellState,\n GameBoard,\n GameHint,\n GameMove,\n GameSettings,\n GameState,\n GameStatus,\n TeachingState,\n} from './types';\n\n/* @deprecated Use `DEFAULT_APP_SETTINGS` / `DEFAULT_PLAY_SETTINGS` instead. /\nexport { DEFAULT_GAME_SETTINGS } from './types';\n\n// ============================================================================\n// Sudoku Types (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/* Core Sudoku cell and board types using flat 81-cell array representation. /\nexport type {\n /* A single cell in the Sudoku board (indexed 0-80). /\n SudokuCell,\n /* The Sudoku board containing all 81 cells. /\n SudokuBoard,\n /* Current play state including board, settings, and selection. /\n SudokuPlay,\n /* Session settings that can change during play (pencilmarking, auto-pencilmarks). /\n SudokuPlaySettings,\n /* App-level settings persisted across sessions (showErrors, display format). /\n SudokuAppSettings,\n /* Full game state including source, history, and digit mapping. /\n SudokuGameState,\n /* Display modes for Sudoku digits ('NUMERIC' \| 'KANJI' \| 'COLORS' \| 'EMOJIS'). /\n SudokuDisplay,\n /* Source of the puzzle ('DAILY' \| 'CHALLENGE' \| 'LEVEL' \| 'ENTERED'). /\n PlayingSource,\n} from './types';\n\n/* Default settings and cell/board helper functions for the modern Sudoku API. /\nexport {\n /* Default session play settings (pencilmarking off, auto-pencilmarks off). /\n DEFAULT_PLAY_SETTINGS,\n /* Default app settings (showErrors on, animations on, numeric display). /\n DEFAULT_APP_SETTINGS,\n /* Create an empty SudokuCell at the given index. /\n createEmptyCell,\n /* Create an empty 81-cell SudokuBoard. /\n createEmptyBoard,\n /* Check if a cell has an error (input does not match solution). /\n cellHasError,\n /* Get row index (0-8) from cell index (0-80). /\n rowOf,\n /* Get column index (0-8) from cell index (0-80). /\n columnOf,\n /* Get block index (0-8) from cell index (0-80). /\n blockOf,\n /* Get cell index (0-80) from row and column. /\n cellIndex,\n /* Get all cell indices in the same row as the given index. /\n getRowIndices,\n /* Get all cell indices in the same column as the given index. /\n getColumnIndices,\n /* Get all cell indices in the same block as the given index. /\n getBlockIndices,\n /* Get all related cell indices (same row, column, or block) excluding the cell itself. /\n getRelatedIndices,\n} from './types';\n\n// ============================================================================\n// Display types (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/* Display and hint visualization types matching the Kotlin renderable layer. /\nexport type {\n /* Highlighted area in a hint (row, column, or block). /\n HintArea,\n /* Cell display information in a hint step. /\n HintCell,\n /* Actions to perform on a cell during hint visualization. /\n HintCellActions,\n /* A single hint step with title, text, areas, cells, links, and groups. /\n DisplayHintStep,\n /* Complete display state for a single cell (colors, digit, pencilmarks). /\n CellDisplayState,\n /* Display state for a single pencilmark (digit and color). /\n PencilmarkDisplayState,\n /* UI color palette with system colors for light or dark mode. /\n UIColorPalette,\n /* Link type for chain visualization ('strong' \| 'weak'). /\n LinkType,\n /* A link between two cells in a chain (display format). /\n DisplayLink,\n /* A group of cells for pattern visualization (display format). /\n DisplayCellGroup,\n} from './types';\n\n/* Theme and color enums plus predefined light/dark palettes. /\nexport { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';\n\n// ============================================================================\n// Progress Types (for user progress tracking)\n// ============================================================================\n\n/* Types for tracking user puzzle completion and statistics. /\nexport type {\n /* Record of a completed puzzle (id, type, time). /\n CompletedPuzzle,\n /* Computed game statistics (best times, averages). /\n GameStats,\n /* Full user progress data (completed puzzles, streak, stats). /\n UserProgress,\n} from './types';\n\nexport {\n /* Default empty user progress state. /\n DEFAULT_PROGRESS,\n /* localStorage key for progress data ('sudojo-progress'). /\n PROGRESS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Settings Types (for app settings)\n// ============================================================================\n\n/* Types for application settings. /\nexport type {\n /* Digit display format ('numeric' \| 'kanji' \| 'emojis'). /\n DigitDisplay,\n /* Application settings (showErrors, symmetrical, display). /\n AppSettings,\n} from './types';\n\nexport {\n /* Default application settings. /\n DEFAULT_SETTINGS,\n /* localStorage key for settings ('sudojo-settings'). /\n SETTINGS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Subscription Types (for subscription management)\n// ============================================================================\n\n/* Types for RevenueCat subscription management. /\nexport type {\n /* Subscription product information (price, period, trial). /\n Product,\n /* User subscription status (active, expiration, renewal). /\n Subscription,\n} from './types';\n\n/* Default inactive subscription state. /\nexport { DEFAULT_SUBSCRIPTION } from './types';\n\n// ============================================================================\n// Game Persistence Types (for saving/loading game state)\n// ============================================================================\n\n/* Types for saving and restoring game progress to localStorage. /\nexport type {\n /* Saved game state (input, pencilmarks, mode, timestamp). /\n SavedGameState,\n /* Key identifying a game to persist (type + id). /\n GamePersistenceKey,\n} from './types';\n\nexport {\n /* localStorage key prefix for game saves ('sudojo_game_'). /\n GAME_STORAGE_PREFIX,\n /* Generate a localStorage key from a GamePersistenceKey. /\n getGameStorageKey,\n} from './types';\n\n// ============================================================================\n// Current Game Types (for current game feature)\n// ============================================================================\n\n/* Types for the Zustand-backed current game store. /\nexport type {\n /* Source of the current game ('daily' \| 'level' \| 'entered'). /\n GameSource,\n /* Navigation metadata for resuming a game (date, level, board info). /\n CurrentGameMeta,\n /* Full current game state stored in Zustand (puzzle, progress, timing). /\n CurrentGame,\n /* Which store slot a game lives in ('daily' \| 'play'). /\n GameSlot,\n} from './types';\n\n// ============================================================================\n// Legacy Utilities (useGame hook)\n// ============================================================================\n\n/\n @deprecated These utilities work with the legacy 2D `GameBoard` type.\n * For new code, use `useSudoku` with its flat 81-cell board and the\n * scrambler/presenter utilities below.\n /\nexport {\n /* @deprecated Clone a 2D GameBoard. Use useSudoku's immutable state instead. /\n cloneBoard,\n /* @deprecated Count filled cells in a 2D GameBoard. /\n countFilledCells,\n /* @deprecated Create a 2D GameBoard from puzzle/solution strings. /\n createGameBoard,\n /* @deprecated Get cells in a block by block index (2D API). /\n getBlockCells,\n /* @deprecated Get block index from row/col (2D API). Use blockOf() instead. /\n getBlockIndex,\n /* @deprecated Get 2D board state as string. Use cellsToStateString() instead. /\n getBoardStateString,\n /* @deprecated Get cells in a column (2D API). Use getColumnIndices() instead. /\n getColumnCells,\n /* @deprecated Get empty cells from a 2D GameBoard. /\n getEmptyCells,\n /* @deprecated Get pencilmarks string from 2D GameBoard. Use cellsToPencilmarksString() instead. /\n getPencilmarksString,\n /* @deprecated Get related cells (2D API). Use getRelatedIndices() instead. /\n getRelatedCells,\n /* @deprecated Get cells in a row (2D API). Use getRowIndices() instead. /\n getRowCells,\n /* @deprecated Check if placement is valid (2D API). /\n isValidPlacement,\n /* @deprecated Auto-remove pencilmarks (2D API). useSudoku handles this internally. /\n autoRemovePencilmarks,\n /* @deprecated Clear highlights (2D API). useSudoku handles this via presentBoard(). /\n clearHighlights,\n /* @deprecated Count mistakes (2D API). Use useSudoku's errorCount instead. /\n countMistakes,\n /* @deprecated Get incorrect cells (2D API). Use useSudoku's errorCells instead. /\n getIncorrectCells,\n /* @deprecated Get progress percentage (2D API). Use useSudoku's progress instead. /\n getProgressPercentage,\n /* @deprecated Check if board is filled (2D API). /\n isBoardFilled,\n /* @deprecated Check if cell is correct (2D API). Use cellHasError() instead. /\n isCellCorrect,\n /* @deprecated Check if game is complete (2D API). Use useSudoku's isCompleted instead. /\n isGameComplete,\n /* @deprecated Check if value is correct (2D API). /\n isValueCorrect,\n /* @deprecated Update cell errors (2D API). useSudoku handles this automatically. /\n updateCellErrors,\n /* @deprecated Update cell highlights (2D API). Use presentBoard() instead. /\n updateCellHighlights,\n /* @deprecated Validate entire game state (2D API). /\n validateGameState,\n} from './utils';\n\n// ============================================================================\n// Sudoku Utilities (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/* Types for board scrambling. /\nexport type {\n /* Protocol for board scramblers (Scrambler and NonScrambler implement this). /\n ScramblerProtocol,\n /* Result of scrambling a board (cells + digit mappings). /\n SudokuScrambleResult,\n} from './utils';\n\n/* Board scrambling and puzzle string conversion utilities. /\nexport {\n /* Scrambler that permutes rows, columns, and digits to create unique puzzles. /\n Scrambler,\n /* Identity scrambler that returns the board unchanged. /\n NonScrambler,\n /* Scramble a board using a ScramblerProtocol implementation. /\n scrambleSudokuBoard,\n /* Parse an 81-character puzzle string into SudokuCell array. /\n parsePuzzleString,\n /* Convert SudokuCell array to puzzle string (given values only). /\n cellsToPuzzleString,\n /* Convert SudokuCell array to state string (given + input values). /\n cellsToStateString,\n /* Convert SudokuCell array to input-only string. /\n cellsToInputString,\n /* Convert SudokuCell array to comma-separated pencilmarks string. /\n cellsToPencilmarksString,\n} from './utils';\n\n// ============================================================================\n// Presenter utilities (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/* Options type for the presentBoard function. /\nexport type {\n /* Options for generating cell display states (cells, selection, errors, hints). /\n PresentBoardOptions,\n} from './utils';\n\n/* Board presentation and color utilities matching the Kotlin renderable layer. /\nexport {\n /* Generate display states for all 81 cells (colors, digits, pencilmarks, hints). /\n presentBoard,\n /* Process hint step areas and cells into a map of cell hints by index. /\n calculateCellHints,\n /* Convert a ThemeColor to an actual CSS color string using a palette. /\n themeColorToCSS,\n /* Get the UIColorPalette for light or dark mode. /\n getColorPalette,\n /* Get indices of cells containing a specific digit (given or input). /\n getCellsWithDigit,\n /* Get the digit to highlight based on the selected cell (given or correct input). /\n getSelectedDigit,\n /* Compute the set of cell indices with the same digit as the selected cell. /\n computeSelectedDigitCells,\n /* Convert a solver link (row/col pairs) to display format (flat indices). /\n convertSolverLink,\n /* Convert a solver cell group to display format with ThemeColor. /\n convertSolverCellGroup,\n /* Convert SudokuColor enum to ThemeColor enum. /\n sudokuColorToTheme,\n} from './utils';\n\n// ============================================================================\n// Time Utilities\n// ============================================================================\n\n/* Time formatting and parsing utilities. /\nexport {\n /* Format seconds into MM:SS or HH:MM:SS string. /\n formatTime,\n /* Parse a MM:SS or HH:MM:SS string back to total seconds. /\n parseTime,\n} from './utils';\n\n// ============================================================================\n// Progress Utilities\n// ============================================================================\n\n/* User progress calculation utilities. /\nexport {\n /* Calculate game statistics (best times, averages) from completed puzzles. /\n calculateStats,\n /* Calculate current daily streak from completion history. /\n calculateStreak,\n /* Check if a specific puzzle (by type and id) has been completed. /\n isPuzzleCompleted,\n /* Get all completed level IDs from completion history. /\n getCompletedLevelIds,\n /* Get all completed daily dates (YYYY-MM-DD) from completion history. /\n getCompletedDailyDates,\n} from './utils';\n\n// ============================================================================\n// Theme Utilities\n// ============================================================================\n\n/* Types for theme preference management. /\nexport type {\n /* Theme preference: 'light' \| 'dark' \| 'system'. /\n ThemePreference,\n /* Resolved theme without system option: 'light' \| 'dark'. /\n ResolvedTheme,\n} from './utils';\n\n/* Theme detection and resolution utilities. /\nexport {\n /* localStorage key for theme preference ('sudojo-theme'). /\n THEME_STORAGE_KEY,\n /* Detect the system color scheme preference (light/dark). /\n getSystemTheme,\n /* Resolve a ThemePreference to an actual theme using the system theme. /\n resolveTheme,\n /* Type guard: check if a value is a valid ThemePreference. /\n isValidThemePreference,\n} from './utils';\n\n// ============================================================================\n// Subscription Utilities\n// ============================================================================\n\n/* RevenueCat subscription conversion and display utilities. /\nexport {\n /* Convert a RevenueCat package to a Product domain model. /\n convertPackageToProduct,\n /* Parse RevenueCat CustomerInfo into a Subscription domain model. /\n parseCustomerInfo,\n /* Get human-readable name for an ISO 8601 subscription period (e.g., 'P1M' -> 'Monthly'). /\n getPeriodDisplayName,\n /* Check if a subscription period is the \"best value\" option (annual plans). /\n isBestValuePlan,\n /* Get a user-friendly error message for a RevenueCat error code. /\n getRevenueCatErrorMessage,\n} from './utils';\n\n// ============================================================================\n// Technique Utilities\n// ============================================================================\n\n/* Technique display utilities. /\nexport {\n /* Get the icon URL for a solving technique by its path slug. /\n getTechniqueIconUrl,\n} from './utils';\n\n// ============================================================================\n// Hint Explanation Utilities\n// ============================================================================\n\n/* Hint explanation generation utilities for teaching users solving techniques. /\nexport {\n /* Generate a detailed explanation for a hint step based on the technique. /\n generateDetailedExplanation,\n /* Get a short action summary for a hint step (e.g., 'Place 5 in R1C3'). /\n getHintActionSummary,\n} from './utils';\n\n// ============================================================================\n// Localized Hint Utilities\n// ============================================================================\n\n/* Types for hint text localization. /\nexport type {\n /* Translation function compatible with i18next's `t` function. /\n TranslateFunction,\n} from './utils';\n\n/* Hint localization utilities. /\nexport {\n /* Get localized text for a hint step using a translation function. /\n getLocalizedHintText,\n} from './utils';\n\n// ============================================================================\n// i18n Key Utilities\n// ============================================================================\n\n/* Internationalization key generation and localization utilities. /\nexport {\n /* Get i18n key for a belt name (e.g., 'belts.1.name'). /\n getBeltKey,\n /* Get localized belt name using a translation function. /\n getLocalizedBeltName,\n /* Get i18n key for a belt label (e.g., 'belts.1.label'). /\n getBeltLabelKey,\n /* Get localized belt label (e.g., 'White Belt'). /\n getLocalizedBeltLabel,\n /* Get i18n key for a level title (e.g., 'levels.3'). /\n getLevelKey,\n /* Get localized level title using a translation function. /\n getLocalizedLevelTitle,\n /* Get i18n key for a technique name (e.g., 'techniques.full-house.title'). /\n getTechniqueKey,\n /* Get localized technique name using a translation function. /\n getLocalizedTechniqueName,\n} from './utils';\n\n// ============================================================================\n// Digit Display Utilities\n// ============================================================================\n\n/* Digit display format conversion. /\nexport {\n /* Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). /\n displayDigit,\n} from './utils';\n\n// ============================================================================\n// Share URL Utilities\n// ============================================================================\n\n/* Types for share URL building and parsing. /\nexport type { ShareUrlParams, ParsedShareParams } from './utils';\n\n/* Build a share URL from game state. /\nexport { buildShareUrl } from './utils';\n\n/* Parse share URL query parameters into game state. /\nexport { parseShareParams } from './utils';\n\n/* Derive web app URL from API base URL. /\nexport { getWebUrl } from './utils';\n\n// ============================================================================\n// Auth Utilities\n// ============================================================================\n\n/* Minimal user shape for auth checks. /\nexport type { AuthUser } from './utils';\n\n/* Check if user-specific API calls should be enabled (non-anonymous, has token). /\nexport { isAuthenticatedUser } from './utils';\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\nexport {\n // Data hooks\n /* Fetch a single difficulty level by number. /\n useLevel,\n /* Fetch all difficulty levels with sorting and filtering utilities. /\n useLevels,\n /* Fetch a single solving technique by number. /\n useTechnique,\n /* Fetch all solving techniques with grouping utilities. /\n useTechniques,\n /* Fetch learning materials with filtering by technique and language. /\n useLearning,\n /* Fetch a single learning item by UUID. /\n useLearningItem,\n\n /\n @deprecated Use `useSudoku` instead. `useGame` uses a legacy 2D array board\n * representation, while `useSudoku` uses a flat 81-cell array consistent with\n * the Kotlin renderable layer and the rest of the codebase.\n /\n useGame,\n\n /* Primary game state hook with flat 81-cell board, pencil mode, and scrambling. /\n useSudoku,\n\n /* Teaching/hint integration with the solver API (legacy GameHint format). /\n useGameTeaching,\n\n /* Fetch a random board for a specific level with auth/subscription handling. /\n useLevelGame,\n /* Fetch today's daily puzzle with auth/subscription handling. /\n useDailyGame,\n\n /* Game timer using refs to avoid re-renders every second. /\n useGameTimer,\n\n /* Persist individual game progress to localStorage. /\n useGamePersistence,\n /* Auto-save game state with debouncing. /\n useAutoSave,\n\n /* Generic typed localStorage hook with SSR safety. /\n useLocalStorage,\n\n /* Solver hint integration matching Kotlin HintInteractor behavior. /\n useHint,\n\n /* Current game management with Zustand store (daily/play slots). /\n useGamePlay,\n\n /* Manual puzzle entry mode with solver validation. /\n useBoardEntry,\n\n /* Server-side game session management for gamification (points, badges). /\n useGameSession,\n\n /* Check whether a level is enabled for the current user's entitlements. /\n useLevelEnabled,\n /* Check whether a technique is enabled for the current user's entitlements. /\n useTechniqueEnabled,\n\n /* Convert internal user level (0-indexed) to display values (1-indexed + belt). /\n useDisplayLevel,\n\n /* Compute cumulative puzzle distribution across entitlement tiers. /\n usePuzzleDistribution,\n\n /* Shared hint step tracker for game screens (ref + state). /\n useHintStepTracker,\n\n /* Auto-hint orchestration for shared links/deep links. /\n useAutoHint,\n\n /* Progress reporting for game state persistence. /\n useProgressReporter,\n} from './hooks';\n\nexport type {\n // Data hook types\n /* Options for useLevel hook. /\n UseLevelOptions,\n /* Result type for useLevel hook. /\n UseLevelResult,\n /* Options for useLevels hook. /\n UseLevelsOptions,\n /* Result type for useLevels hook. /\n UseLevelsResult,\n /* Options for useTechnique hook. /\n UseTechniqueOptions,\n /* Result type for useTechnique hook. /\n UseTechniqueResult,\n /* Options for useTechniques hook. /\n UseTechniquesOptions,\n /* Result type for useTechniques hook. /\n UseTechniquesResult,\n /* Options for useLearningItem hook. /\n UseLearningItemOptions,\n /* Result type for useLearningItem hook. /\n UseLearningItemResult,\n /* Options for useLearning hook. /\n UseLearningOptions,\n /* Result type for useLearning hook. /\n UseLearningResult,\n\n // Game hook types (legacy)\n /* @deprecated Options for legacy useGame hook. Use UseSudokuOptions instead. /\n UseGameOptions,\n /* @deprecated Result type for legacy useGame hook. Use UseSudokuResult instead. /\n UseGameResult,\n\n // Sudoku hook types\n /* Options for useSudoku hook (initial app settings). /\n UseSudokuOptions,\n /* Result type for useSudoku hook (state, computed values, actions, utilities). /\n UseSudokuResult,\n\n // Teaching hook types\n /* Options for useGameTeaching hook (network client, URL, token). /\n UseGameTeachingOptions,\n /* Result type for useGameTeaching hook (teaching state, hint actions). /\n UseGameTeachingResult,\n\n // Game fetching hook types\n /* Options for useLevelGame hook (network, auth, level number). /\n UseLevelGameOptions,\n /* Result type for useLevelGame hook (board data, fetch status). /\n UseLevelGameResult,\n /* Options for useDailyGame hook (network, auth). /\n UseDailyGameOptions,\n /* Result type for useDailyGame hook (daily data, fetch status). /\n UseDailyGameResult,\n /* Status of a game fetch: 'loading' \| 'success' \| 'auth_required' \| 'subscription_required' \| 'entitlement_required' \| 'error'. /\n GameFetchStatus,\n\n // Timer hook types\n /* Options for useGameTimer hook (autoStart, initialTime). /\n UseGameTimerOptions,\n /* Result type for useGameTimer hook (elapsedRef, controls). /\n UseGameTimerResult,\n\n // Persistence hook types\n /* Options for useGamePersistence hook (puzzleKey, autoSave). /\n UseGamePersistenceOptions,\n /* Result type for useGamePersistence hook (load, save, clear, hasSaved). /\n UseGamePersistenceResult,\n\n // Hint hook types\n /* Options for useHint hook (network, puzzle state, technique filter). /\n UseHintOptions,\n /* Result type for useHint hook (hint steps, navigation, apply). /\n UseHintResult,\n /* Board data returned when applying a hint (user input, pencilmarks). /\n HintBoardData,\n /* Data passed to onHintReceived callback (hint, board data, technique info). /\n HintReceivedData,\n /* Access denied error info when hint level exceeds subscription tier. /\n HintAccessError,\n\n // Game play hook types\n /* Options for useGamePlay hook (slot selection, auto-save delay). /\n UseGamePlayOptions,\n /* Result type for useGamePlay hook (current game, start, update, clear). /\n UseGamePlayResult,\n\n // Board entry hook types\n /* Options for useBoardEntry hook (network client, URL, token). /\n UseBoardEntryOptions,\n /* Result type for useBoardEntry hook (cells, validation, actions). /\n UseBoardEntryReturn,\n /* Validated puzzle data from solver (puzzle + solution strings). /\n ValidatedPuzzle,\n\n // Game session hook types\n /* Options for useGameSession hook (network, auth, userId). /\n UseGameSessionOptions,\n /* Result of starting a game session (sessionStarted, sessionId). /\n GameSessionResult,\n /* Result of finishing a game session (leveledUp, badges, points). /\n GameFinishResult,\n\n // Display level hook types\n /* Result type for useDisplayLevel hook. /\n UseDisplayLevelResult,\n\n // Hint step tracker types\n /* Result type for useHintStepTracker hook. /\n UseHintStepTrackerResult,\n\n // Auto-hint types\n /* Options for useAutoHint hook. /\n UseAutoHintOptions,\n\n // Progress reporter types\n /* Options for useProgressReporter hook. /\n UseProgressReporterOptions,\n /* Callback type for progress updates. /\n ProgressUpdateCallback,\n} from './hooks';\n\n// ============================================================================\n// Stores\n// ============================================================================\n\n/* Zustand store for current game state with daily/play slots and localStorage persistence. /\nexport { useGamePlayStore } from './stores/gamePlayStore';\n/* State shape for the game play Zustand store. /\nexport type { GamePlayState } from './stores/gamePlayStore';\n\n// ============================================================================\n// Config\n// ============================================================================\n\n/* Authentication provider configuration types. /\nexport type {\n /* Available auth provider types: 'google' \| 'apple' \| 'email'. /\n AuthProviderType,\n /* Configuration for which auth providers are enabled. /\n AuthProvidersConfig,\n} from './config';\n\n/* Default auth providers configuration (Google + Email, anonymous fallback). /\nexport { DEFAULT_AUTH_PROVIDERS } from './config';\n\n// ============================================================================\n// Entitlement Context\n// ============================================================================\n\n/* Provider that supplies entitlements to useLevelEnabled / useTechniqueEnabled. /\nexport { EntitlementProvider } from './context';\n/* React context for entitlements (for advanced use). /\nexport { EntitlementContext, useEntitlementContext } from './context';\n\n// ============================================================================\n// Entitlement Utilities (re-exported from sudojo_types)\n// ============================================================================\n\n/* Parse a comma-delimited entitlement string into an array. /\nexport { parseEntitlements } from '@sudobility/sudojo_types';\n\n/* Check if a user has the required entitlement for a level. */\nexport { hasRequiredEntitlement } from '@sudobility/sudojo_types';\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n @sudobility/sudojo_lib - Business logic library for Sudojo app\n \n This library provides:\n * - Game state management with useSudoku hook (ported from renderable)\n * - Board scrambling utilities\n * - Game validation (mistakes, completion)\n * - Level, technique, and learning data hooks\n * - Teaching/hint integration with solver\n * - Legacy useGame hook for backward compatibility\n \n ## Hook Architecture\n \n The hooks form a layered composition pattern:\n \n Data hooks (fetch and cache server data):\n * - `useLevels` / `useLevel` - Difficulty level data\n * - `useTechniques` / `useTechnique` - Solving technique data\n * - `useLearning` / `useLearningItem` - Learning material data\n \n Game fetching hooks (handle auth, subscription, and puzzle loading):\n * - `useLevelGame` - Fetch a random board for a specific level\n * - `useDailyGame` - Fetch today's daily puzzle\n \n Game state hooks (manage board state and user interaction):\n * - `useSudoku` - Primary game state (flat 81-cell array, modern API)\n * - `useGame` - Legacy game state (2D array, deprecated)\n * - `useBoardEntry` - Manual puzzle entry mode\n \n Feature hooks (provide specific game features):\n * - `useHint` - Solver integration for hints (matches Kotlin HintInteractor)\n * - `useGameTeaching` - Step-by-step teaching with solver\n * - `useGameTimer` - Elapsed time tracking via ref (no re-renders)\n * - `useGamePersistence` / `useAutoSave` - localStorage game save/restore\n * - `useLocalStorage` - Generic typed localStorage hook\n \n Orchestration hooks (combine multiple hooks for app-level features):\n * - `useGamePlay` - Current game management with Zustand store (daily/play slots)\n * - `useGameSession` - Server-side gamification (start/finish, points, badges)\n \n ## Migration Guide\n \n Legacy exports (prefixed with \"Legacy\" comments) use the 2D `GameBoard` type\n * from `useGame`. New code should use `useSudoku` with its flat 81-cell\n * `SudokuBoard` type. See `@deprecated` tags on legacy exports.\n /\n\n// ============================================================================\n// Legacy Types (useGame hook)\n// ============================================================================\n\n/\n @deprecated Use `SudokuCell` instead. Part of the legacy `useGame` 2D board API.\n /\nexport type {\n CellPosition,\n CellState,\n GameBoard,\n GameHint,\n GameMove,\n GameSettings,\n GameState,\n GameStatus,\n TeachingState,\n} from './types';\n\n/* @deprecated Use `DEFAULT_APP_SETTINGS` / `DEFAULT_PLAY_SETTINGS` instead. /\nexport { DEFAULT_GAME_SETTINGS } from './types';\n\n// ============================================================================\n// Sudoku Types (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/* Core Sudoku cell and board types using flat 81-cell array representation. /\nexport type {\n /* A single cell in the Sudoku board (indexed 0-80). /\n SudokuCell,\n /* The Sudoku board containing all 81 cells. /\n SudokuBoard,\n /* Current play state including board, settings, and selection. /\n SudokuPlay,\n /* Session settings that can change during play (pencilmarking, auto-pencilmarks). /\n SudokuPlaySettings,\n /* App-level settings persisted across sessions (showErrors, display format). /\n SudokuAppSettings,\n /* Full game state including source, history, and digit mapping. /\n SudokuGameState,\n /* Display modes for Sudoku digits ('NUMERIC' \| 'KANJI' \| 'COLORS' \| 'EMOJIS'). /\n SudokuDisplay,\n /* Source of the puzzle ('DAILY' \| 'CHALLENGE' \| 'LEVEL' \| 'ENTERED'). /\n PlayingSource,\n} from './types';\n\n/* Default settings and cell/board helper functions for the modern Sudoku API. /\nexport {\n /* Default session play settings (pencilmarking off, auto-pencilmarks off). /\n DEFAULT_PLAY_SETTINGS,\n /* Default app settings (showErrors on, animations on, numeric display). /\n DEFAULT_APP_SETTINGS,\n /* Create an empty SudokuCell at the given index. /\n createEmptyCell,\n /* Create an empty 81-cell SudokuBoard. /\n createEmptyBoard,\n /* Check if a cell has an error (input does not match solution). /\n cellHasError,\n /* Get row index (0-8) from cell index (0-80). /\n rowOf,\n /* Get column index (0-8) from cell index (0-80). /\n columnOf,\n /* Get block index (0-8) from cell index (0-80). /\n blockOf,\n /* Get cell index (0-80) from row and column. /\n cellIndex,\n /* Get all cell indices in the same row as the given index. /\n getRowIndices,\n /* Get all cell indices in the same column as the given index. /\n getColumnIndices,\n /* Get all cell indices in the same block as the given index. /\n getBlockIndices,\n /* Get all related cell indices (same row, column, or block) excluding the cell itself. /\n getRelatedIndices,\n} from './types';\n\n// ============================================================================\n// Display types (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/* Display and hint visualization types matching the Kotlin renderable layer. /\nexport type {\n /* Highlighted area in a hint (row, column, or block). /\n HintArea,\n /* Cell display information in a hint step. /\n HintCell,\n /* Actions to perform on a cell during hint visualization. /\n HintCellActions,\n /* A single hint step with title, text, areas, cells, links, and groups. /\n DisplayHintStep,\n /* Complete display state for a single cell (colors, digit, pencilmarks). /\n CellDisplayState,\n /* Display state for a single pencilmark (digit and color). /\n PencilmarkDisplayState,\n /* UI color palette with system colors for light or dark mode. /\n UIColorPalette,\n /* Link type for chain visualization ('strong' \| 'weak'). /\n LinkType,\n /* A link between two cells in a chain (display format). /\n DisplayLink,\n /* A group of cells for pattern visualization (display format). /\n DisplayCellGroup,\n} from './types';\n\n/* Theme and color enums plus predefined light/dark palettes. /\nexport { ThemeColor, SudokuColor, UIColorLight, UIColorDark } from './types';\n\n// ============================================================================\n// Progress Types (for user progress tracking)\n// ============================================================================\n\n/* Types for tracking user puzzle completion and statistics. /\nexport type {\n /* Record of a completed puzzle (id, type, time). /\n CompletedPuzzle,\n /* Computed game statistics (best times, averages). /\n GameStats,\n /* Full user progress data (completed puzzles, streak, stats). /\n UserProgress,\n} from './types';\n\nexport {\n /* Default empty user progress state. /\n DEFAULT_PROGRESS,\n /* localStorage key for progress data ('sudojo-progress'). /\n PROGRESS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Settings Types (for app settings)\n// ============================================================================\n\n/* Types for application settings. /\nexport type {\n /* Digit display format ('numeric' \| 'kanji' \| 'emojis'). /\n DigitDisplay,\n /* Application settings (showErrors, symmetrical, display). /\n AppSettings,\n} from './types';\n\nexport {\n /* Default application settings. /\n DEFAULT_SETTINGS,\n /* localStorage key for settings ('sudojo-settings'). /\n SETTINGS_STORAGE_KEY,\n} from './types';\n\n// ============================================================================\n// Subscription Types (for subscription management)\n// ============================================================================\n\n/* Types for RevenueCat subscription management. /\nexport type {\n /* Subscription product information (price, period, trial). /\n Product,\n /* User subscription status (active, expiration, renewal). /\n Subscription,\n} from './types';\n\n/* Default inactive subscription state. /\nexport { DEFAULT_SUBSCRIPTION } from './types';\n\n// ============================================================================\n// Game Persistence Types (for saving/loading game state)\n// ============================================================================\n\n/* Types for saving and restoring game progress to localStorage. /\nexport type {\n /* Saved game state (input, pencilmarks, mode, timestamp). /\n SavedGameState,\n /* Key identifying a game to persist (type + id). /\n GamePersistenceKey,\n} from './types';\n\nexport {\n /* localStorage key prefix for game saves ('sudojo_game_'). /\n GAME_STORAGE_PREFIX,\n /* Generate a localStorage key from a GamePersistenceKey. /\n getGameStorageKey,\n} from './types';\n\n// ============================================================================\n// Current Game Types (for current game feature)\n// ============================================================================\n\n/* Types for the Zustand-backed current game store. /\nexport type {\n /* Source of the current game ('daily' \| 'level' \| 'entered'). /\n GameSource,\n /* Navigation metadata for resuming a game (date, level, board info). /\n CurrentGameMeta,\n /* Full current game state stored in Zustand (puzzle, progress, timing). /\n CurrentGame,\n /* Which store slot a game lives in ('daily' \| 'play'). /\n GameSlot,\n} from './types';\n\n// ============================================================================\n// Legacy Utilities (useGame hook)\n// ============================================================================\n\n/\n @deprecated These utilities work with the legacy 2D `GameBoard` type.\n * For new code, use `useSudoku` with its flat 81-cell board and the\n * scrambler/presenter utilities below.\n /\nexport {\n /* @deprecated Clone a 2D GameBoard. Use useSudoku's immutable state instead. /\n cloneBoard,\n /* @deprecated Count filled cells in a 2D GameBoard. /\n countFilledCells,\n /* @deprecated Create a 2D GameBoard from puzzle/solution strings. /\n createGameBoard,\n /* @deprecated Get cells in a block by block index (2D API). /\n getBlockCells,\n /* @deprecated Get block index from row/col (2D API). Use blockOf() instead. /\n getBlockIndex,\n /* @deprecated Get 2D board state as string. Use cellsToStateString() instead. /\n getBoardStateString,\n /* @deprecated Get cells in a column (2D API). Use getColumnIndices() instead. /\n getColumnCells,\n /* @deprecated Get empty cells from a 2D GameBoard. /\n getEmptyCells,\n /* @deprecated Get pencilmarks string from 2D GameBoard. Use cellsToPencilmarksString() instead. /\n getPencilmarksString,\n /* @deprecated Get related cells (2D API). Use getRelatedIndices() instead. /\n getRelatedCells,\n /* @deprecated Get cells in a row (2D API). Use getRowIndices() instead. /\n getRowCells,\n /* @deprecated Check if placement is valid (2D API). /\n isValidPlacement,\n /* @deprecated Auto-remove pencilmarks (2D API). useSudoku handles this internally. /\n autoRemovePencilmarks,\n /* @deprecated Clear highlights (2D API). useSudoku handles this via presentBoard(). /\n clearHighlights,\n /* @deprecated Count mistakes (2D API). Use useSudoku's errorCount instead. /\n countMistakes,\n /* @deprecated Get incorrect cells (2D API). Use useSudoku's errorCells instead. /\n getIncorrectCells,\n /* @deprecated Get progress percentage (2D API). Use useSudoku's progress instead. /\n getProgressPercentage,\n /* @deprecated Check if board is filled (2D API). /\n isBoardFilled,\n /* @deprecated Check if cell is correct (2D API). Use cellHasError() instead. /\n isCellCorrect,\n /* @deprecated Check if game is complete (2D API). Use useSudoku's isCompleted instead. /\n isGameComplete,\n /* @deprecated Check if value is correct (2D API). /\n isValueCorrect,\n /* @deprecated Update cell errors (2D API). useSudoku handles this automatically. /\n updateCellErrors,\n /* @deprecated Update cell highlights (2D API). Use presentBoard() instead. /\n updateCellHighlights,\n /* @deprecated Validate entire game state (2D API). /\n validateGameState,\n} from './utils';\n\n// ============================================================================\n// Sudoku Utilities (useSudoku hook - ported from renderable)\n// ============================================================================\n\n/* Types for board scrambling. /\nexport type {\n /* Protocol for board scramblers (Scrambler and NonScrambler implement this). /\n ScramblerProtocol,\n /* Result of scrambling a board (cells + digit mappings). /\n SudokuScrambleResult,\n} from './utils';\n\n/* Board scrambling and puzzle string conversion utilities. /\nexport {\n /* Scrambler that permutes rows, columns, and digits to create unique puzzles. /\n Scrambler,\n /* Identity scrambler that returns the board unchanged. /\n NonScrambler,\n /* Scramble a board using a ScramblerProtocol implementation. /\n scrambleSudokuBoard,\n /* Parse an 81-character puzzle string into SudokuCell array. /\n parsePuzzleString,\n /* Convert SudokuCell array to puzzle string (given values only). /\n cellsToPuzzleString,\n /* Convert SudokuCell array to state string (given + input values). /\n cellsToStateString,\n /* Convert SudokuCell array to input-only string. /\n cellsToInputString,\n /* Convert SudokuCell array to comma-separated pencilmarks string. /\n cellsToPencilmarksString,\n} from './utils';\n\n// ============================================================================\n// Presenter utilities (for rendering - matches Kotlin renderable)\n// ============================================================================\n\n/* Options type for the presentBoard function. /\nexport type {\n /* Options for generating cell display states (cells, selection, errors, hints). /\n PresentBoardOptions,\n} from './utils';\n\n/* Board presentation and color utilities matching the Kotlin renderable layer. /\nexport {\n /* Generate display states for all 81 cells (colors, digits, pencilmarks, hints). /\n presentBoard,\n /* Process hint step areas and cells into a map of cell hints by index. /\n calculateCellHints,\n /* Convert a ThemeColor to an actual CSS color string using a palette. /\n themeColorToCSS,\n /* Get the UIColorPalette for light or dark mode. /\n getColorPalette,\n /* Get indices of cells containing a specific digit (given or input). /\n getCellsWithDigit,\n /* Get the digit to highlight based on the selected cell (given or correct input). /\n getSelectedDigit,\n /* Compute the set of cell indices with the same digit as the selected cell. /\n computeSelectedDigitCells,\n /* Convert a solver link (row/col pairs) to display format (flat indices). /\n convertSolverLink,\n /* Convert a solver cell group to display format with ThemeColor. /\n convertSolverCellGroup,\n /* Convert SudokuColor enum to ThemeColor enum. /\n sudokuColorToTheme,\n} from './utils';\n\n// ============================================================================\n// Time Utilities\n// ============================================================================\n\n/* Time formatting and parsing utilities. /\nexport {\n /* Format seconds into MM:SS or HH:MM:SS string. /\n formatTime,\n /* Parse a MM:SS or HH:MM:SS string back to total seconds. /\n parseTime,\n} from './utils';\n\n// ============================================================================\n// Progress Utilities\n// ============================================================================\n\n/* User progress calculation utilities. /\nexport {\n /* Calculate game statistics (best times, averages) from completed puzzles. /\n calculateStats,\n /* Calculate current daily streak from completion history. /\n calculateStreak,\n /* Check if a specific puzzle (by type and id) has been completed. /\n isPuzzleCompleted,\n /* Get all completed level IDs from completion history. /\n getCompletedLevelIds,\n /* Get all completed daily dates (YYYY-MM-DD) from completion history. /\n getCompletedDailyDates,\n} from './utils';\n\n// ============================================================================\n// Theme Utilities\n// ============================================================================\n\n/* Types for theme preference management. /\nexport type {\n /* Theme preference: 'light' \| 'dark' \| 'system'. /\n ThemePreference,\n /* Resolved theme without system option: 'light' \| 'dark'. /\n ResolvedTheme,\n} from './utils';\n\n/* Theme detection and resolution utilities. /\nexport {\n /* localStorage key for theme preference ('sudojo-theme'). /\n THEME_STORAGE_KEY,\n /* Detect the system color scheme preference (light/dark). /\n getSystemTheme,\n /* Resolve a ThemePreference to an actual theme using the system theme. /\n resolveTheme,\n /* Type guard: check if a value is a valid ThemePreference. /\n isValidThemePreference,\n} from './utils';\n\n// ============================================================================\n// Subscription Utilities\n// ============================================================================\n\n/* RevenueCat subscription conversion and display utilities. /\nexport {\n /* Convert a RevenueCat package to a Product domain model. /\n convertPackageToProduct,\n /* Parse RevenueCat CustomerInfo into a Subscription domain model. /\n parseCustomerInfo,\n /* Get human-readable name for an ISO 8601 subscription period (e.g., 'P1M' -> 'Monthly'). /\n getPeriodDisplayName,\n /* Check if a subscription period is the \"best value\" option (annual plans). /\n isBestValuePlan,\n /* Get a user-friendly error message for a RevenueCat error code. /\n getRevenueCatErrorMessage,\n} from './utils';\n\n// ============================================================================\n// Technique Utilities\n// ============================================================================\n\n/* Technique display utilities. /\nexport {\n /* Get the icon URL for a solving technique by its path slug. /\n getTechniqueIconUrl,\n} from './utils';\n\n// ============================================================================\n// Hint Explanation Utilities\n// ============================================================================\n\n/* Hint explanation generation utilities for teaching users solving techniques. /\nexport {\n /* Generate a detailed explanation for a hint step based on the technique. /\n generateDetailedExplanation,\n /* Get a short action summary for a hint step (e.g., 'Place 5 in R1C3'). /\n getHintActionSummary,\n} from './utils';\n\n// ============================================================================\n// Localized Hint Utilities\n// ============================================================================\n\n/* Types for hint text localization. /\nexport type {\n /* Translation function compatible with i18next's `t` function. /\n TranslateFunction,\n} from './utils';\n\n/* Hint localization utilities. /\nexport {\n /* Get localized text for a hint step using a translation function. /\n getLocalizedHintText,\n /* Get localized title for a hint step using a translation function. /\n getLocalizedHintTitle,\n} from './utils';\n\n// ============================================================================\n// i18n Key Utilities\n// ============================================================================\n\n/* Internationalization key generation and localization utilities. /\nexport {\n /* Get i18n key for a belt name (e.g., 'belts.1.name'). /\n getBeltKey,\n /* Get localized belt name using a translation function. /\n getLocalizedBeltName,\n /* Get i18n key for a belt label (e.g., 'belts.1.label'). /\n getBeltLabelKey,\n /* Get localized belt label (e.g., 'White Belt'). /\n getLocalizedBeltLabel,\n /* Get i18n key for a level title (e.g., 'levels.3'). /\n getLevelKey,\n /* Get localized level title using a translation function. /\n getLocalizedLevelTitle,\n /* Get i18n key for a technique name (e.g., 'techniques.full-house.title'). /\n getTechniqueKey,\n /* Get localized technique name using a translation function. /\n getLocalizedTechniqueName,\n} from './utils';\n\n// ============================================================================\n// Digit Display Utilities\n// ============================================================================\n\n/* Digit display format conversion. /\nexport {\n /* Convert a digit (1-9) to its display string based on the format (numeric, kanji, emojis). /\n displayDigit,\n} from './utils';\n\n// ============================================================================\n// Share URL Utilities\n// ============================================================================\n\n/* Types for share URL building and parsing. /\nexport type { ShareUrlParams, ParsedShareParams } from './utils';\n\n/* Build a share URL from game state. /\nexport { buildShareUrl } from './utils';\n\n/* Parse share URL query parameters into game state. /\nexport { parseShareParams } from './utils';\n\n/* Derive web app URL from API base URL. /\nexport { getWebUrl } from './utils';\n\n// ============================================================================\n// Auth Utilities\n// ============================================================================\n\n/* Minimal user shape for auth checks. /\nexport type { AuthUser } from './utils';\n\n/* Check if user-specific API calls should be enabled (non-anonymous, has token). /\nexport { isAuthenticatedUser } from './utils';\n\n// ============================================================================\n// Hooks\n// ============================================================================\n\nexport {\n // Data hooks\n /* Fetch a single difficulty level by number. /\n useLevel,\n /* Fetch all difficulty levels with sorting and filtering utilities. /\n useLevels,\n /* Fetch a single solving technique by number. /\n useTechnique,\n /* Fetch all solving techniques with grouping utilities. /\n useTechniques,\n /* Fetch learning materials with filtering by technique and language. /\n useLearning,\n /* Fetch a single learning item by UUID. /\n useLearningItem,\n\n /\n @deprecated Use `useSudoku` instead. `useGame` uses a legacy 2D array board\n * representation, while `useSudoku` uses a flat 81-cell array consistent with\n * the Kotlin renderable layer and the rest of the codebase.\n /\n useGame,\n\n /* Primary game state hook with flat 81-cell board, pencil mode, and scrambling. /\n useSudoku,\n\n /* Teaching/hint integration with the solver API (legacy GameHint format). /\n useGameTeaching,\n\n /* Fetch a random board for a specific level with auth/subscription handling. /\n useLevelGame,\n /* Fetch today's daily puzzle with auth/subscription handling. /\n useDailyGame,\n\n /* Game timer using refs to avoid re-renders every second. /\n useGameTimer,\n\n /* Persist individual game progress to localStorage. /\n useGamePersistence,\n /* Auto-save game state with debouncing. /\n useAutoSave,\n\n /* Generic typed localStorage hook with SSR safety. /\n useLocalStorage,\n\n /* Solver hint integration matching Kotlin HintInteractor behavior. /\n useHint,\n\n /* Current game management with Zustand store (daily/play slots). /\n useGamePlay,\n\n /* Manual puzzle entry mode with solver validation. /\n useBoardEntry,\n\n /* Server-side game session management for gamification (points, badges). /\n useGameSession,\n\n /* Check whether a level is enabled for the current user's entitlements. /\n useLevelEnabled,\n /* Check whether a technique is enabled for the current user's entitlements. /\n useTechniqueEnabled,\n\n /* Convert internal user level (0-indexed) to display values (1-indexed + belt). /\n useDisplayLevel,\n\n /* Compute cumulative puzzle distribution across entitlement tiers. /\n usePuzzleDistribution,\n\n /* Shared hint step tracker for game screens (ref + state). /\n useHintStepTracker,\n\n /* Auto-hint orchestration for shared links/deep links. /\n useAutoHint,\n\n /* Progress reporting for game state persistence. /\n useProgressReporter,\n} from './hooks';\n\nexport type {\n // Data hook types\n /* Options for useLevel hook. /\n UseLevelOptions,\n /* Result type for useLevel hook. /\n UseLevelResult,\n /* Options for useLevels hook. /\n UseLevelsOptions,\n /* Result type for useLevels hook. /\n UseLevelsResult,\n /* Options for useTechnique hook. /\n UseTechniqueOptions,\n /* Result type for useTechnique hook. /\n UseTechniqueResult,\n /* Options for useTechniques hook. /\n UseTechniquesOptions,\n /* Result type for useTechniques hook. /\n UseTechniquesResult,\n /* Options for useLearningItem hook. /\n UseLearningItemOptions,\n /* Result type for useLearningItem hook. /\n UseLearningItemResult,\n /* Options for useLearning hook. /\n UseLearningOptions,\n /* Result type for useLearning hook. /\n UseLearningResult,\n\n // Game hook types (legacy)\n /* @deprecated Options for legacy useGame hook. Use UseSudokuOptions instead. /\n UseGameOptions,\n /* @deprecated Result type for legacy useGame hook. Use UseSudokuResult instead. /\n UseGameResult,\n\n // Sudoku hook types\n /* Options for useSudoku hook (initial app settings). /\n UseSudokuOptions,\n /* Result type for useSudoku hook (state, computed values, actions, utilities). /\n UseSudokuResult,\n\n // Teaching hook types\n /* Options for useGameTeaching hook (network client, URL, token). /\n UseGameTeachingOptions,\n /* Result type for useGameTeaching hook (teaching state, hint actions). /\n UseGameTeachingResult,\n\n // Game fetching hook types\n /* Options for useLevelGame hook (network, auth, level number). /\n UseLevelGameOptions,\n /* Result type for useLevelGame hook (board data, fetch status). /\n UseLevelGameResult,\n /* Options for useDailyGame hook (network, auth). /\n UseDailyGameOptions,\n /* Result type for useDailyGame hook (daily data, fetch status). /\n UseDailyGameResult,\n /* Status of a game fetch: 'loading' \| 'success' \| 'auth_required' \| 'subscription_required' \| 'entitlement_required' \| 'error'. /\n GameFetchStatus,\n\n // Timer hook types\n /* Options for useGameTimer hook (autoStart, initialTime). /\n UseGameTimerOptions,\n /* Result type for useGameTimer hook (elapsedRef, controls). /\n UseGameTimerResult,\n\n // Persistence hook types\n /* Options for useGamePersistence hook (puzzleKey, autoSave). /\n UseGamePersistenceOptions,\n /* Result type for useGamePersistence hook (load, save, clear, hasSaved). /\n UseGamePersistenceResult,\n\n // Hint hook types\n /* Options for useHint hook (network, puzzle state, technique filter). /\n UseHintOptions,\n /* Result type for useHint hook (hint steps, navigation, apply). /\n UseHintResult,\n /* Board data returned when applying a hint (user input, pencilmarks). /\n HintBoardData,\n /* Data passed to onHintReceived callback (hint, board data, technique info). /\n HintReceivedData,\n /* Access denied error info when hint level exceeds subscription tier. /\n HintAccessError,\n\n // Game play hook types\n /* Options for useGamePlay hook (slot selection, auto-save delay). /\n UseGamePlayOptions,\n /* Result type for useGamePlay hook (current game, start, update, clear). /\n UseGamePlayResult,\n\n // Board entry hook types\n /* Options for useBoardEntry hook (network client, URL, token). /\n UseBoardEntryOptions,\n /* Result type for useBoardEntry hook (cells, validation, actions). /\n UseBoardEntryReturn,\n /* Validated puzzle data from solver (puzzle + solution strings). /\n ValidatedPuzzle,\n\n // Game session hook types\n /* Options for useGameSession hook (network, auth, userId). /\n UseGameSessionOptions,\n /* Result of starting a game session (sessionStarted, sessionId). /\n GameSessionResult,\n /* Result of finishing a game session (leveledUp, badges, points). /\n GameFinishResult,\n\n // Display level hook types\n /* Result type for useDisplayLevel hook. /\n UseDisplayLevelResult,\n\n // Hint step tracker types\n /* Result type for useHintStepTracker hook. /\n UseHintStepTrackerResult,\n\n // Auto-hint types\n /* Options for useAutoHint hook. /\n UseAutoHintOptions,\n\n // Progress reporter types\n /* Options for useProgressReporter hook. /\n UseProgressReporterOptions,\n /* Callback type for progress updates. /\n ProgressUpdateCallback,\n} from './hooks';\n\n// ============================================================================\n// Stores\n// ============================================================================\n\n/* Zustand store for current game state with daily/play slots and localStorage persistence. /\nexport { useGamePlayStore } from './stores/gamePlayStore';\n/* State shape for the game play Zustand store. /\nexport type { GamePlayState } from './stores/gamePlayStore';\n\n// ============================================================================\n// Config\n// ============================================================================\n\n/* Authentication provider configuration types. /\nexport type {\n /* Available auth provider types: 'google' \| 'apple' \| 'email'. /\n AuthProviderType,\n /* Configuration for which auth providers are enabled. /\n AuthProvidersConfig,\n} from './config';\n\n/* Default auth providers configuration (Google + Email, anonymous fallback). /\nexport { DEFAULT_AUTH_PROVIDERS } from './config';\n\n// ============================================================================\n// Entitlement Context\n// ============================================================================\n\n/* Provider that supplies entitlements to useLevelEnabled / useTechniqueEnabled. /\nexport { EntitlementProvider } from './context';\n/* React context for entitlements (for advanced use). /\nexport { EntitlementContext, useEntitlementContext } from './context';\n\n// ============================================================================\n// Entitlement Utilities (re-exported from sudojo_types)\n// ============================================================================\n\n/* Parse a comma-delimited entitlement string into an array. /\nexport { parseEntitlements } from '@sudobility/sudojo_types';\n\n/* Check if a user has the required entitlement for a level. */\nexport { hasRequiredEntitlement } from '@sudobility/sudojo_types';\n"]}

package/dist/utils/index.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBes
 export { getTechniqueIconUrl } from './technique';
 export { generateDetailedExplanation, getHintActionSummary, } from './hintExplanation';
 export type { TranslateFunction } from './localizedHint';
-export { getLocalizedHintText } from './localizedHint';
+export { getLocalizedHintText, getLocalizedHintTitle } from './localizedHint';
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 export { displayDigit } from './digitDisplay';
 export type { ShareUrlParams, ParsedShareParams } from './shareUrl';

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

	@@ -1 +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,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;~~AAGvD~~,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"}
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,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,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"}

package/dist/utils/index.js CHANGED Viewed

@@ -18,7 +18,7 @@ export { convertPackageToProduct, parseCustomerInfo, getPeriodDisplayName, isBes
 export { getTechniqueIconUrl } from './technique';
 // Hint explanation utilities
 export { generateDetailedExplanation, getHintActionSummary, } from './hintExplanation';
-export { getLocalizedHintText } from './localizedHint';
+export { getLocalizedHintText, getLocalizedHintTitle } from './localizedHint';
 // i18n key utilities
 export { getBeltKey, getLocalizedBeltName, getBeltLabelKey, getLocalizedBeltLabel, getLevelKey, getLocalizedLevelTitle, getTechniqueKey, getLocalizedTechniqueName, } from './i18nKeys';
 // Digit display utilities

package/dist/utils/index.js.map CHANGED Viewed

	@@ -1 +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;AAElD,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;~~AAEvD~~,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// Hint explanation utilities\nexport {\n generateDetailedExplanation,\n getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type { TranslateFunction } from './localizedHint';\nexport { getLocalizedHintText } 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"]}
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;AAElD,6BAA6B;AAC7B,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,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// Hint explanation utilities\nexport {\n generateDetailedExplanation,\n getHintActionSummary,\n} from './hintExplanation';\n\n// Localized hint utilities\nexport type { TranslateFunction } from './localizedHint';\nexport { getLocalizedHintText, getLocalizedHintTitle } 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"]}

package/dist/utils/localizedHint.d.ts CHANGED Viewed

@@ -9,9 +9,21 @@ export type TranslateFunction = (key: string, values?: Record<string, string>) =
  * Returns the translated text with interpolated values,
  * or falls back to step.text if localization is unavailable.
  *
+ * Handles both new structured format { text?: LocalizedHint, title?: LocalizedHint }
+ * and old flat format (LocalizedHint directly) for backward compatibility.
+ *
  * @param t - Translation function (e.g. from `useTranslation('hints')`)
  * @param step - The hint step containing localization data
  * @param keyPrefix - Optional prefix to prepend to the string key (e.g. 'hints.')
  */
 export declare function getLocalizedHintText(t: TranslateFunction, step: SolverHintStep, keyPrefix?: string): string;
+/**
+ * Get localized title for a hint step (technique name).
+ * Returns the translated title or falls back to step.title.
+ *
+ * @param t - Translation function (e.g. from `useTranslation()` for common namespace)
+ * @param step - The hint step containing localization data
+ * @param keyPrefix - Optional prefix to prepend to the string key
+ */
+export declare function getLocalizedHintTitle(t: TranslateFunction, step: SolverHintStep, keyPrefix?: string): string;
 //# sourceMappingURL=localizedHint.d.ts.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"localizedHint.d.ts","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,~~EAAE~~,cAAc,EAAE,MAAM,0BAA0B,CAAC;~~AAE/D~~;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC5B,MAAM,CAAC;~~AAcZ;;;;;;;;GAQG~~;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,~~CAiBR~~"}
1	+ {"version":3,"file":"localizedHint.d.ts","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,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,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR"}

package/dist/utils/localizedHint.js CHANGED Viewed

@@ -9,27 +9,64 @@ function valuesToInterpolation(values) {
     });
     return result;
 }
+/**
+ * Resolve a LocalizedHint to translated text, falling back to the raw value.
+ */
+function resolveLocalization(t, loc, fallback, keyPrefix = '') {
+    if (!loc?.stringKey)
+        return fallback;
+    const interpolation = valuesToInterpolation(loc.values);
+    const fullKey = keyPrefix + loc.stringKey;
+    const translated = t(fullKey, interpolation);
+    // If translation returns the key itself (missing translation), use fallback
+    if (translated === fullKey)
+        return fallback;
+    return translated;
+}
+/**
+ * Extract the text LocalizedHint from a hint step's localization field.
+ * Handles both the new structured format { text?: LocalizedHint }
+ * and the old flat format (LocalizedHint directly) for backward compatibility.
+ */
+function getTextLocalization(step) {
+    const loc = step.localization;
+    if (!loc)
+        return undefined;
+    // New structured format: { text: { stringKey, values } }
+    if (loc.text?.stringKey)
+        return loc.text;
+    // Old flat format: { stringKey, values } directly
+    if ('stringKey' in loc && loc.stringKey) {
+        return loc;
+    }
+    return undefined;
+}
 /**
  * Get localized text for a hint step using a provided translation function.
  * Returns the translated text with interpolated values,
  * or falls back to step.text if localization is unavailable.
  *
+ * Handles both new structured format { text?: LocalizedHint, title?: LocalizedHint }
+ * and old flat format (LocalizedHint directly) for backward compatibility.
+ *
  * @param t - Translation function (e.g. from `useTranslation('hints')`)
  * @param step - The hint step containing localization data
  * @param keyPrefix - Optional prefix to prepend to the string key (e.g. 'hints.')
  */
 export function getLocalizedHintText(t, step, keyPrefix = '') {
-    if (!step.localization?.stringKey) {
-        return step.text;
-    }
-    const { stringKey, values } = step.localization;
-    const interpolation = valuesToInterpolation(values);
-    const fullKey = keyPrefix + stringKey;
-    const translated = t(fullKey, interpolation);
-    // If translation returns the key itself (missing translation), use fallback
-    if (translated === fullKey) {
-        return step.text;
-    }
-    return translated;
+    const textLoc = getTextLocalization(step);
+    return resolveLocalization(t, textLoc, step.text, keyPrefix);
+}
+/**
+ * Get localized title for a hint step (technique name).
+ * Returns the translated title or falls back to step.title.
+ *
+ * @param t - Translation function (e.g. from `useTranslation()` for common namespace)
+ * @param step - The hint step containing localization data
+ * @param keyPrefix - Optional prefix to prepend to the string key
+ */
+export function getLocalizedHintTitle(t, step, keyPrefix = '') {
+    const loc = step.localization;
+    return resolveLocalization(t, loc?.title, step.title, keyPrefix);
 }
 //# sourceMappingURL=localizedHint.js.map

package/dist/utils/localizedHint.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"localizedHint.js","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,SAAS,qBAAqB,CAAC,MAAgB;IAC7C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED~~;;;;;;;;GAQG~~;AACH,~~MAAM~~,~~UAAU~~,~~oBAAoB~~,~~CAClC,~~CAAoB,EACpB,~~IAAoB~~,~~EACpB~~,YAAoB,EAAE;IAEtB,IAAI,CAAC,~~IAAI~~,~~CAAC,YAAY,~~EAAE,SAAS,~~EAAE~~,CAAC;~~QAClC~~,~~OAAO~~,~~IAAI~~,CAAC,~~IAAI~~,CAAC~~;IACnB~~,CAAC;~~IAED~~,MAAM,~~EAAE~~,SAAS,~~EAAE~~,MAAM,~~EAAE~~,GAAG,IAAI,CAAC,~~YAAY~~,CAAC;~~IAChD~~,MAAM,~~aAAa~~,GAAG,~~qBAAqB~~,CAAC,~~MAAM~~,CAAC,CAAC;~~IACpD~~,~~MAAM,~~OAAO,GAAG,SAAS,GAAG,~~SAAS~~,CAAC;~~IAEtC~~,~~MAAM~~,~~UAAU~~,GAAG,CAAC,CAAC,OAAO,~~EAAE~~,~~aAAa~~,CAAC,CAAC;~~IAE7C~~,~~4EAA4E~~;~~IAC5E~~,~~IAAI~~,UAAU,~~KAAK~~,~~OAAO~~,EAAE,CAAC;~~QAC3B~~,OAAO,IAAI,CAAC,IAAI,CAAC;~~IACnB~~,CAAC;~~IAED~~,~~OAAO~~,UAAU,CAAC;~~AACpB~~,CAAC","sourcesContent":["import type { SolverHintStep } from '@sudobility/sudojo_types';\n\n/*\n A translation function that takes a key and interpolation values.\n * Compatible with i18next's `t` function.\n /\nexport type TranslateFunction = (\n key: string,\n values?: Record<string, string>\n) => string;\n\n/\n Convert localization values array to i18next interpolation object.\n * values: [\"3\", \"R1C5\"] → { value1: \"3\", value2: \"R1C5\" }\n /\nfunction valuesToInterpolation(values: string[]): Record<string, string> {\n const result: Record<string, string> = {};\n values.forEach((value, index) => {\n result[`value${index + 1}`] = value;\n });\n return result;\n}\n\n/\n Get localized text for a hint step using a provided translation function.\n * Returns the translated text with interpolated values,\n * or falls back to step.text if localization is unavailable.\n \n @param t - Translation function (e.g. from `useTranslation('hints')`)\n * @param step - The hint step containing localization data\n * @param keyPrefix - Optional prefix to prepend to the string key (e.g. 'hints.')\n */\nexport function getLocalizedHintText(\n t: TranslateFunction,\n step: SolverHintStep,\n keyPrefix: string = ''\n): string {\n if (!step~~.localization?.stringKey~~) {\n return step.text;\n }\n\n ~~const~~ { ~~stringKey,~~ ~~values~~ } = ~~step.localization;\n const~~ ~~interpolation~~ = ~~valuesToInterpolation~~(~~values~~);\n ~~const~~ ~~fullKey~~ = ~~keyPrefix~~ + ~~stringKey;\~~n\n ~~const~~ ~~translated~~ = t(~~fullKey,~~ ~~interpolation~~);\n\n // If ~~translation~~ ~~returns~~ the key ~~itself~~ (~~missing~~ ~~translation),~~ ~~use fallback\~~n if ~~(translated~~ ~~===~~ ~~fullKey~~) {\n ~~return~~ step.~~text~~;\n ~~}\n\n~~ return ~~translated~~;\n}\n"]}
1	+ {"version":3,"file":"localizedHint.js","sourceRoot":"","sources":["../../src/utils/localizedHint.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,SAAS,qBAAqB,CAAC,MAAgB;IAC7C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,CAAC,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,CAAoB,EACpB,GAA8B,EAC9B,QAAgB,EAChB,YAAoB,EAAE;IAEtB,IAAI,CAAC,GAAG,EAAE,SAAS;QAAE,OAAO,QAAQ,CAAC;IAErC,MAAM,aAAa,GAAG,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAE7C,4EAA4E;IAC5E,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAoB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,YAGJ,CAAC;IAEd,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAE3B,yDAAyD;IACzD,IAAI,GAAG,CAAC,IAAI,EAAE,SAAS;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAEzC,kDAAkD;IAClD,IAAI,WAAW,IAAI,GAAG,IAAK,GAAqB,CAAC,SAAS,EAAE,CAAC;QAC3D,OAAO,GAA+B,CAAC;IACzC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,CAAoB,EACpB,IAAoB,EACpB,YAAoB,EAAE;IAEtB,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,CAAoB,EACpB,IAAoB,EACpB,YAAoB,EAAE;IAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAqD,CAAC;IACvE,OAAO,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import type { LocalizedHint, SolverHintStep } from '@sudobility/sudojo_types';\n\n/*\n A translation function that takes a key and interpolation values.\n * Compatible with i18next's `t` function.\n /\nexport type TranslateFunction = (\n key: string,\n values?: Record<string, string>\n) => string;\n\n/\n Convert localization values array to i18next interpolation object.\n * values: [\"3\", \"R1C5\"] → { value1: \"3\", value2: \"R1C5\" }\n /\nfunction valuesToInterpolation(values: string[]): Record<string, string> {\n const result: Record<string, string> = {};\n values.forEach((value, index) => {\n result[`value${index + 1}`] = value;\n });\n return result;\n}\n\n/\n Resolve a LocalizedHint to translated text, falling back to the raw value.\n /\nfunction resolveLocalization(\n t: TranslateFunction,\n loc: LocalizedHint \| undefined,\n fallback: string,\n keyPrefix: string = ''\n): string {\n if (!loc?.stringKey) return fallback;\n\n const interpolation = valuesToInterpolation(loc.values);\n const fullKey = keyPrefix + loc.stringKey;\n const translated = t(fullKey, interpolation);\n\n // If translation returns the key itself (missing translation), use fallback\n if (translated === fullKey) return fallback;\n return translated;\n}\n\n/\n Extract the text LocalizedHint from a hint step's localization field.\n * Handles both the new structured format { text?: LocalizedHint }\n * and the old flat format (LocalizedHint directly) for backward compatibility.\n /\nfunction getTextLocalization(step: SolverHintStep): LocalizedHint \| undefined {\n const loc = step.localization as\n \| { text?: LocalizedHint; title?: LocalizedHint }\n \| (LocalizedHint & { text?: never })\n \| undefined;\n\n if (!loc) return undefined;\n\n // New structured format: { text: { stringKey, values } }\n if (loc.text?.stringKey) return loc.text;\n\n // Old flat format: { stringKey, values } directly\n if ('stringKey' in loc && (loc as LocalizedHint).stringKey) {\n return loc as unknown as LocalizedHint;\n }\n\n return undefined;\n}\n\n/\n Get localized text for a hint step using a provided translation function.\n * Returns the translated text with interpolated values,\n * or falls back to step.text if localization is unavailable.\n \n Handles both new structured format { text?: LocalizedHint, title?: LocalizedHint }\n * and old flat format (LocalizedHint directly) for backward compatibility.\n \n @param t - Translation function (e.g. from `useTranslation('hints')`)\n * @param step - The hint step containing localization data\n * @param keyPrefix - Optional prefix to prepend to the string key (e.g. 'hints.')\n /\nexport function getLocalizedHintText(\n t: TranslateFunction,\n step: SolverHintStep,\n keyPrefix: string = ''\n): string {\n const textLoc = getTextLocalization(step);\n return resolveLocalization(t, textLoc, step.text, keyPrefix);\n}\n\n/\n Get localized title for a hint step (technique name).\n * Returns the translated title or falls back to step.title.\n \n @param t - Translation function (e.g. from `useTranslation()` for common namespace)\n * @param step - The hint step containing localization data\n * @param keyPrefix - Optional prefix to prepend to the string key\n */\nexport function getLocalizedHintTitle(\n t: TranslateFunction,\n step: SolverHintStep,\n keyPrefix: string = ''\n): string {\n const loc = step.localization as { title?: LocalizedHint } \| undefined;\n return resolveLocalization(t, loc?.title, step.title, keyPrefix);\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sudojo_lib",
-  "version": "0.0.126",
+  "version": "0.0.129",
   "description": "Business logic library for Sudojo app",
   "type": "module",
   "main": "dist/index.js",
@@ -47,8 +47,8 @@
   "license": "BUSL-1.1",
   "devDependencies": {
     "@sudobility/di": "^1.5.52",
-    "@sudobility/sudojo_client": "^0.0.97",
-    "@sudobility/sudojo_types": "^1.2.46",
+    "@sudobility/sudojo_client": "^0.0.99",
+    "@sudobility/sudojo_types": "^1.2.49",
     "@sudobility/types": "^1.9.61",
     "@tanstack/react-query": "^5.90.11",
     "@testing-library/dom": "^10.4.1",
@@ -73,8 +73,8 @@
   },
   "peerDependencies": {
     "@sudobility/di": "^1.5.52",
-    "@sudobility/sudojo_client": "^0.0.97",
-    "@sudobility/sudojo_types": "^1.2.46",
+    "@sudobility/sudojo_client": "^0.0.99",
+    "@sudobility/sudojo_types": "^1.2.49",
     "@sudobility/types": "^1.9.61",
     "@tanstack/react-query": ">=5.0.0",
     "react": ">=18.0.0",