@sudobility/sudojo_lib 0.0.4

package/dist/hooks/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hook exports for Sudojo library
+ */
+export { useLevel, useLevels } from './useLevels';
+export type { UseLevelOptions, UseLevelResult, UseLevelsOptions, UseLevelsResult, } from './useLevels';
+export { useTechnique, useTechniques } from './useTechniques';
+export type { UseTechniqueOptions, UseTechniqueResult, UseTechniquesOptions, UseTechniquesResult, } from './useTechniques';
+export { useLearning, useLearningItem } from './useLearning';
+export type { UseLearningItemOptions, UseLearningItemResult, UseLearningOptions, UseLearningResult, } from './useLearning';
+export { useGame } from './useGame';
+export type { UseGameOptions, UseGameResult } from './useGame';
+export { useGameTeaching } from './useGameTeaching';
+export type { UseGameTeachingOptions, UseGameTeachingResult, } from './useGameTeaching';
+export { useSudoku } from './useSudoku';
+export type { UseSudokuOptions, UseSudokuResult } from './useSudoku';
+export { useLevelGame } from './useLevelGame';
+export type { UseLevelGameOptions, UseLevelGameResult, GameFetchStatus, } from './useLevelGame';
+export { useDailyGame } from './useDailyGame';
+export type { UseDailyGameOptions, UseDailyGameResult } from './useDailyGame';
+export { useGameTimer } from './useGameTimer';
+export type { UseGameTimerOptions, UseGameTimerResult } from './useGameTimer';
+export { useGamePersistence, useAutoSave } from './useGamePersistence';
+export type { UseGamePersistenceOptions, UseGamePersistenceResult, } from './useGamePersistence';
+export { useLocalStorage } from './useLocalStorage';
+export { useHint } from './useHint';
+export type { UseHintOptions, UseHintResult, HintBoardData } from './useHint';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACvE,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,27 @@
+/**
+ * Hook exports for Sudojo library
+ */
+// Levels hooks
+export { useLevel, useLevels } from './useLevels';
+// Techniques hooks
+export { useTechnique, useTechniques } from './useTechniques';
+// Learning hooks
+export { useLearning, useLearningItem } from './useLearning';
+// Game hooks (legacy)
+export { useGame } from './useGame';
+// Teaching hooks
+export { useGameTeaching } from './useGameTeaching';
+// Sudoku hooks (ported from renderable)
+export { useSudoku } from './useSudoku';
+// Game fetching hooks (with auth/subscription handling)
+export { useLevelGame } from './useLevelGame';
+export { useDailyGame } from './useDailyGame';
+// Game timer hook
+export { useGameTimer } from './useGameTimer';
+// Game persistence hooks
+export { useGamePersistence, useAutoSave } from './useGamePersistence';
+// Local storage hook
+export { useLocalStorage } from './useLocalStorage';
+// Hint hook
+export { useHint } from './useHint';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQlD,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ9D,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQ7D,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,wCAAwC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,wDAAwD;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMvE,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,YAAY;AACZ,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/hooks/useDailyGame.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Hook for fetching and managing today's daily puzzle
+ * Handles auth and subscription status with automatic refresh
+ */
+import type { Daily } from '@sudobility/sudojo_types';
+import type { NetworkClient } from '@sudobility/types';
+import { type SudojoAuth, type SudojoConfig } from '@sudobility/sudojo_client';
+import type { GameFetchStatus } from './useLevelGame';
+export interface UseDailyGameOptions {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Sudojo API configuration */
+    config: SudojoConfig;
+    /** Auth credentials with access token */
+    auth: SudojoAuth;
+    /** Whether subscription is currently active */
+    subscriptionActive?: boolean;
+    /** Whether to enable the query */
+    enabled?: boolean;
+}
+export interface UseDailyGameResult {
+    /** Today's daily puzzle */
+    daily: Daily | null;
+    /** The date string for this daily (YYYY-MM-DD) */
+    dailyDate: string | null;
+    /** Current status of the game fetch */
+    status: GameFetchStatus;
+    /** Whether data is loading */
+    isLoading: boolean;
+    /** Error if fetch failed */
+    error: Error | null;
+    /** Refetch the daily puzzle */
+    refetch: () => void;
+}
+/**
+ * Hook for fetching today's daily puzzle
+ *
+ * Automatically refetches when auth token or subscription status changes.
+ * Returns status indicating whether auth or subscription is required.
+ *
+ * @param options - Hook options
+ * @returns Daily puzzle data and status
+ *
+ * @example
+ * ```tsx
+ * function DailyPage() {
+ *   const { daily, dailyDate, status, refetch } = useDailyGame({
+ *     networkClient,
+ *     config,
+ *     auth,
+ *     subscriptionActive: subscription.isActive,
+ *   });
+ *
+ *   if (status === 'loading') return <Loading />;
+ *   if (status === 'auth_required') return <AuthRequired onLogin={openAuthModal} />;
+ *   if (status === 'subscription_required') return <SubscriptionPaywall onSuccess={refetch} />;
+ *   if (status === 'error') return <Error />;
+ *
+ *   return <SudokuGame puzzle={daily.board} solution={daily.solution} />;
+ * }
+ * ```
+ */
+export declare function useDailyGame(options: UseDailyGameOptions): UseDailyGameResult;
+//# sourceMappingURL=useDailyGame.d.ts.map

package/dist/hooks/useDailyGame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDailyGame.d.ts","sourceRoot":"","sources":["../../src/hooks/useDailyGame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAuDtD,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,yCAAyC;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,MAAM,EAAE,eAAe,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAsE7E"}

package/dist/hooks/useDailyGame.js

@@ -0,0 +1,120 @@
+/**
+ * Hook for fetching and managing today's daily puzzle
+ * Handles auth and subscription status with automatic refresh
+ */
+import { useEffect, useMemo, useRef } from 'react';
+import { useSudojoTodayDaily, } from '@sudobility/sudojo_client';
+/** Check if response indicates auth is required */
+function isAuthRequired(response, error) {
+    if (response?.success === false &&
+        response.action?.type === 'auth_required') {
+        return true;
+    }
+    if (error && typeof error === 'object') {
+        const err = error;
+        if (err.message?.includes('Account required'))
+            return true;
+    }
+    return false;
+}
+/** Check if response indicates subscription is required */
+function isSubscriptionRequired(response, error) {
+    if (response?.success === false &&
+        response.action?.type === 'subscription_required') {
+        return true;
+    }
+    if (error && typeof error === 'object') {
+        const err = error;
+        if (err.message?.includes('Daily limit reached') ||
+            err.message?.includes('subscription')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Hook for fetching today's daily puzzle
+ *
+ * Automatically refetches when auth token or subscription status changes.
+ * Returns status indicating whether auth or subscription is required.
+ *
+ * @param options - Hook options
+ * @returns Daily puzzle data and status
+ *
+ * @example
+ * ```tsx
+ * function DailyPage() {
+ *   const { daily, dailyDate, status, refetch } = useDailyGame({
+ *     networkClient,
+ *     config,
+ *     auth,
+ *     subscriptionActive: subscription.isActive,
+ *   });
+ *
+ *   if (status === 'loading') return <Loading />;
+ *   if (status === 'auth_required') return <AuthRequired onLogin={openAuthModal} />;
+ *   if (status === 'subscription_required') return <SubscriptionPaywall onSuccess={refetch} />;
+ *   if (status === 'error') return <Error />;
+ *
+ *   return <SudokuGame puzzle={daily.board} solution={daily.solution} />;
+ * }
+ * ```
+ */
+export function useDailyGame(options) {
+    const { networkClient, config, auth, subscriptionActive = false, enabled: _enabled = true, } = options;
+    // Track previous state to detect changes
+    const prevStateRef = useRef({
+        authToken: auth.accessToken,
+        subscriptionActive,
+    });
+    // Note: useSudojoTodayDaily doesn't support enabled option directly
+    // We handle enabled by conditionally using the data
+    const { data, isLoading, error, refetch } = useSudojoTodayDaily(networkClient, config, auth);
+    // Determine status based on response
+    const status = useMemo(() => {
+        if (isLoading)
+            return 'loading';
+        if (isAuthRequired(data, error))
+            return 'auth_required';
+        if (isSubscriptionRequired(data, error))
+            return 'subscription_required';
+        if (error)
+            return 'error';
+        if (data?.success && data.data)
+            return 'success';
+        return 'loading';
+    }, [isLoading, data, error]);
+    const daily = useMemo(() => {
+        if (data?.success && data.data) {
+            return data.data;
+        }
+        return null;
+    }, [data]);
+    const dailyDate = useMemo(() => {
+        if (daily?.date) {
+            const dateStr = new Date(daily.date).toISOString().split('T')[0];
+            return dateStr ?? null;
+        }
+        return null;
+    }, [daily]);
+    // Auto-refresh when auth token or subscription status changes
+    useEffect(() => {
+        const prev = prevStateRef.current;
+        const authChanged = prev.authToken !== auth.accessToken;
+        const subscriptionChanged = !prev.subscriptionActive && subscriptionActive;
+        if (authChanged || subscriptionChanged) {
+            refetch();
+        }
+        // Update ref for next comparison
+        prevStateRef.current = { authToken: auth.accessToken, subscriptionActive };
+    }, [auth.accessToken, subscriptionActive, refetch]);
+    return {
+        daily,
+        dailyDate,
+        status,
+        isLoading,
+        error: error ?? (data?.error ? new Error(data.error) : null),
+        refetch: () => refetch(),
+    };
+}
+//# sourceMappingURL=useDailyGame.js.map

package/dist/hooks/useDailyGame.js.map

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

package/dist/hooks/useGame.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Main game state management hook for Sudoku gameplay
+ */
+import type { GameSettings, GameState, ScrambleConfig } from '../types';
+export interface UseGameOptions {
+    /** Maximum mistakes allowed (0 = unlimited) */
+    maxMistakes?: number;
+    /** Initial settings */
+    initialSettings?: Partial<GameSettings>;
+}
+export interface UseGameResult {
+    /** Current game state */
+    state: GameState;
+    /** Whether the game is active (playing or paused) */
+    isActive: boolean;
+    /** Whether the game is complete */
+    isComplete: boolean;
+    /** Whether the game failed (too many mistakes) */
+    isFailed: boolean;
+    /** Can undo */
+    canUndo: boolean;
+    /** Can redo */
+    canRedo: boolean;
+    /** Load a new board */
+    loadBoard: (puzzle: string, solution: string, options?: {
+        scramble?: boolean;
+        scrambleConfig?: ScrambleConfig;
+        boardUuid?: string;
+        levelUuid?: string;
+    }) => void;
+    /** Select a cell */
+    selectCell: (row: number, column: number) => void;
+    /** Deselect the current cell */
+    deselectCell: () => void;
+    /** Set a value in the selected cell */
+    setValue: (value: number) => void;
+    /** Clear the value in the selected cell */
+    clearValue: () => void;
+    /** Toggle a pencilmark in the selected cell */
+    togglePencilmark: (value: number) => void;
+    /** Set pencilmarks in the selected cell */
+    setPencilmarks: (values: number[]) => void;
+    /** Clear pencilmarks in the selected cell */
+    clearPencilmarks: () => void;
+    /** Undo the last move */
+    undo: () => void;
+    /** Redo the last undone move */
+    redo: () => void;
+    /** Update game settings */
+    updateSettings: (settings: Partial<GameSettings>) => void;
+    /** Pause the game */
+    pause: () => void;
+    /** Resume the game */
+    resume: () => void;
+    /** Reset the game to initial state */
+    reset: () => void;
+    /** Update elapsed time */
+    tick: (seconds: number) => void;
+    /** Set hint mode */
+    setHintMode: (enabled: boolean) => void;
+    /** Get current board state as string (for solver API) */
+    getBoardString: () => string;
+    /** Get pencilmarks as string (for solver API) */
+    getPencilmarksString: () => string;
+    /** Get the original (unscrambled) puzzle string */
+    getOriginalPuzzle: () => string;
+}
+/**
+ * Main hook for managing Sudoku game state
+ *
+ * @param options - Hook options
+ * @returns Game state and actions
+ *
+ * @example
+ * ```tsx
+ * function GameScreen() {
+ *   const {
+ *     state,
+ *     loadBoard,
+ *     selectCell,
+ *     setValue,
+ *     isComplete,
+ *   } = useGame({ maxMistakes: 3 });
+ *
+ *   useEffect(() => {
+ *     // Load a puzzle from the API
+ *     loadBoard(puzzle, solution, { scramble: true });
+ *   }, []);
+ *
+ *   if (isComplete) {
+ *     return <Congratulations />;
+ *   }
+ *
+ *   return (
+ *     <Board
+ *       cells={state.board}
+ *       onCellPress={(row, col) => selectCell(row, col)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare function useGame(options?: UseGameOptions): UseGameResult;
+//# sourceMappingURL=useGame.d.ts.map

package/dist/hooks/useGame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGame.d.ts","sourceRoot":"","sources":["../../src/hooks/useGame.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAGV,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,UAAU,CAAC;AAijBlB,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IAGjB,uBAAuB;IACvB,SAAS,EAAE,CACT,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KACE,IAAI,CAAC;IACV,oBAAoB;IACpB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,gCAAgC;IAChC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,uCAAuC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,2CAA2C;IAC3C,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,+CAA+C;IAC/C,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,2CAA2C;IAC3C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC3C,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,2BAA2B;IAC3B,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAC1D,qBAAqB;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,oBAAoB;IACpB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAGxC,yDAAyD;IACzD,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,iDAAiD;IACjD,oBAAoB,EAAE,MAAM,MAAM,CAAC;IACnC,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAwKnE"}