@sudobility/sudojo_lib 0.0.4

package/dist/hooks/useGamePersistence.js

@@ -0,0 +1,124 @@
+/**
+ * Hook for persisting game state to localStorage
+ *
+ * Saves game progress automatically so users can resume where they left off
+ */
+import { useCallback, useEffect, useRef } from 'react';
+import { getGameStorageKey } from '../types/gamePersistence';
+/**
+ * Hook for persisting individual game progress
+ *
+ * @param options - Hook options
+ * @returns Functions to load, save, and clear game state
+ *
+ * @example
+ * ```tsx
+ * const { loadGame, saveGame, clearGame } = useGamePersistence({
+ *   puzzleKey: { type: 'daily', id: '2024-01-15' },
+ *   autoSave: true,
+ * });
+ *
+ * // On mount, try to restore saved state
+ * useEffect(() => {
+ *   const saved = loadGame();
+ *   if (saved) {
+ *     // Restore game state
+ *   }
+ * }, []);
+ *
+ * // Save after each move
+ * useEffect(() => {
+ *   saveGame({ inputString, pencilmarksString, isPencilMode });
+ * }, [inputString, pencilmarksString, isPencilMode]);
+ * ```
+ */
+export function useGamePersistence({ puzzleKey, }) {
+    const storageKey = puzzleKey ? getGameStorageKey(puzzleKey) : null;
+    const loadGame = useCallback(() => {
+        if (!storageKey)
+            return null;
+        try {
+            const item = window.localStorage.getItem(storageKey);
+            if (!item)
+                return null;
+            return JSON.parse(item);
+        }
+        catch (error) {
+            console.warn('Error loading saved game:', error);
+            return null;
+        }
+    }, [storageKey]);
+    const saveGame = useCallback((state) => {
+        if (!storageKey)
+            return;
+        try {
+            const savedState = {
+                ...state,
+                savedAt: new Date().toISOString(),
+            };
+            window.localStorage.setItem(storageKey, JSON.stringify(savedState));
+        }
+        catch (error) {
+            console.warn('Error saving game:', error);
+        }
+    }, [storageKey]);
+    const clearGame = useCallback(() => {
+        if (!storageKey)
+            return;
+        try {
+            window.localStorage.removeItem(storageKey);
+        }
+        catch (error) {
+            console.warn('Error clearing saved game:', error);
+        }
+    }, [storageKey]);
+    const hasSavedGame = useCallback(() => {
+        if (!storageKey)
+            return false;
+        try {
+            return window.localStorage.getItem(storageKey) !== null;
+        }
+        catch {
+            return false;
+        }
+    }, [storageKey]);
+    return {
+        loadGame,
+        saveGame,
+        clearGame,
+        hasSavedGame,
+    };
+}
+/**
+ * Hook that auto-saves game state with debouncing
+ *
+ * @param puzzleKey - Key identifying the puzzle
+ * @param getCurrentState - Function to get current game state
+ * @param dependencies - Dependencies that trigger save
+ * @param debounceMs - Debounce delay in ms (default: 1000)
+ */
+export function useAutoSave(puzzleKey, getCurrentState, dependencies, debounceMs = 1000) {
+    const { saveGame } = useGamePersistence({ puzzleKey });
+    const timeoutRef = useRef(null);
+    useEffect(() => {
+        if (!puzzleKey)
+            return;
+        // Clear any pending save
+        if (timeoutRef.current) {
+            globalThis.clearTimeout(timeoutRef.current);
+        }
+        // Schedule new save
+        timeoutRef.current = globalThis.setTimeout(() => {
+            const state = getCurrentState();
+            if (state) {
+                saveGame(state);
+            }
+        }, debounceMs);
+        return () => {
+            if (timeoutRef.current) {
+                globalThis.clearTimeout(timeoutRef.current);
+            }
+        };
+    }, [puzzleKey, saveGame, debounceMs, ...dependencies]);
+}
+//# sourceMappingURL=useGamePersistence.js.map

package/dist/hooks/useGamePersistence.js.map

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

package/dist/hooks/useGameTeaching.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Hook for integrating the Sudoku solver for teaching and hints
+ */
+import type { NetworkClient } from '@sudobility/types';
+import { type ClientConfig } from '@sudobility/sudojo_client';
+import type { GameHint, TeachingState } from '../types';
+export interface UseGameTeachingOptions {
+    /** Network client for API calls */
+    networkClient: NetworkClient;
+    /** Solver API configuration */
+    config: ClientConfig;
+}
+export interface UseGameTeachingResult {
+    /** Current teaching state */
+    teachingState: TeachingState;
+    /** Get a hint for the current board state */
+    getHint: (originalPuzzle: string, userBoard: string, options?: {
+        autoPencilmarks?: boolean;
+        pencilmarks?: string;
+    }) => Promise<void>;
+    /** Apply the current hint to the board (returns the action to perform) */
+    applyHint: () => GameHint | null;
+    /** Move to the next step in a multi-step hint */
+    nextStep: () => void;
+    /** Move to the previous step in a multi-step hint */
+    previousStep: () => void;
+    /** Clear the current hint */
+    clearHint: () => void;
+    /** Whether a hint is available */
+    hasHint: boolean;
+    /** Whether there are more steps in the current hint */
+    hasMoreSteps: boolean;
+    /** Whether we can go to previous step */
+    hasPreviousStep: boolean;
+}
+/**
+ * Hook for teaching/hint functionality using the solver API
+ *
+ * @param options - Hook options
+ * @returns Teaching state and actions
+ *
+ * @example
+ * ```tsx
+ * function GameWithHints() {
+ *   const game = useGame();
+ *   const { teachingState, getHint, applyHint } = useGameTeaching({
+ *     networkClient,
+ *     config: { baseUrl: 'https://solver.sudojo.com' },
+ *   });
+ *
+ *   const handleGetHint = async () => {
+ *     await getHint(
+ *       game.getOriginalPuzzle(),
+ *       game.getBoardString(),
+ *       { autoPencilmarks: game.state.settings.autoPencilmarks }
+ *     );
+ *   };
+ *
+ *   const handleApplyHint = () => {
+ *     const hint = applyHint();
+ *     if (hint) {
+ *       // Apply the hint actions to the game
+ *       for (const cell of hint.cells) {
+ *         if (cell.action?.select) {
+ *           game.selectCell(cell.row, cell.column);
+ *           game.setValue(cell.action.select);
+ *         }
+ *       }
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <Board cells={game.state.board} />
+ *       <button onClick={handleGetHint}>Get Hint</button>
+ *       {teachingState.currentHint && (
+ *         <div>
+ *           <h3>{teachingState.currentHint.title}</h3>
+ *           <p>{teachingState.currentHint.text}</p>
+ *           <button onClick={handleApplyHint}>Apply</button>
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useGameTeaching(options: UseGameTeachingOptions): UseGameTeachingResult;
+//# sourceMappingURL=useGameTeaching.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGameTeaching.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameTeaching.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,6CAA6C;IAC7C,OAAO,EAAE,CACP,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAC1D,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IACjC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,qDAAqD;IACrD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;CAC1B;AA6CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA8KvB"}

package/dist/hooks/useGameTeaching.js

@@ -0,0 +1,230 @@
+/**
+ * Hook for integrating the Sudoku solver for teaching and hints
+ */
+import { useCallback, useMemo, useState } from 'react';
+import { createSudojoSolverClient, } from '@sudobility/sudojo_client';
+/**
+ * Converts a solver SolverHintStep to our GameHint format
+ */
+function convertHintStep(step) {
+    return {
+        title: step.title,
+        text: step.text,
+        cells: step.cells?.map(cell => {
+            const action = {};
+            if (cell.actions.select) {
+                action.select = parseInt(cell.actions.select, 10);
+            }
+            if (cell.actions.add) {
+                action.addPencilmarks = cell.actions.add
+                    .split('')
+                    .map(d => parseInt(d, 10));
+            }
+            if (cell.actions.remove) {
+                action.removePencilmarks = cell.actions.remove
+                    .split('')
+                    .map(d => parseInt(d, 10));
+            }
+            return {
+                row: cell.row,
+                column: cell.column,
+                color: cell.color,
+                ...(Object.keys(action).length > 0 ? { action } : {}),
+            };
+        }) ?? [],
+        areas: step.areas?.map(area => ({
+            type: area.type,
+            index: area.index,
+            color: area.color,
+        })) ?? [],
+    };
+}
+/**
+ * Hook for teaching/hint functionality using the solver API
+ *
+ * @param options - Hook options
+ * @returns Teaching state and actions
+ *
+ * @example
+ * ```tsx
+ * function GameWithHints() {
+ *   const game = useGame();
+ *   const { teachingState, getHint, applyHint } = useGameTeaching({
+ *     networkClient,
+ *     config: { baseUrl: 'https://solver.sudojo.com' },
+ *   });
+ *
+ *   const handleGetHint = async () => {
+ *     await getHint(
+ *       game.getOriginalPuzzle(),
+ *       game.getBoardString(),
+ *       { autoPencilmarks: game.state.settings.autoPencilmarks }
+ *     );
+ *   };
+ *
+ *   const handleApplyHint = () => {
+ *     const hint = applyHint();
+ *     if (hint) {
+ *       // Apply the hint actions to the game
+ *       for (const cell of hint.cells) {
+ *         if (cell.action?.select) {
+ *           game.selectCell(cell.row, cell.column);
+ *           game.setValue(cell.action.select);
+ *         }
+ *       }
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <Board cells={game.state.board} />
+ *       <button onClick={handleGetHint}>Get Hint</button>
+ *       {teachingState.currentHint && (
+ *         <div>
+ *           <h3>{teachingState.currentHint.title}</h3>
+ *           <p>{teachingState.currentHint.text}</p>
+ *           <button onClick={handleApplyHint}>Apply</button>
+ *         </div>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useGameTeaching(options) {
+    const { networkClient, config } = options;
+    const [teachingState, setTeachingState] = useState({
+        isActive: false,
+        currentHint: null,
+        currentStep: 0,
+        totalSteps: 0,
+        isLoading: false,
+        error: null,
+    });
+    // Store all hint steps for multi-step hints
+    const [allSteps, setAllSteps] = useState([]);
+    // Create solver client
+    const solverClient = useMemo(() => {
+        return createSudojoSolverClient(networkClient, config);
+    }, [networkClient, config]);
+    const getHint = useCallback(async (originalPuzzle, userBoard, hintOptions) => {
+        setTeachingState(prev => ({
+            ...prev,
+            isLoading: true,
+            error: null,
+        }));
+        try {
+            const solveOptions = {
+                original: originalPuzzle,
+                user: userBoard,
+            };
+            if (hintOptions?.autoPencilmarks !== undefined) {
+                solveOptions.autoPencilmarks = hintOptions.autoPencilmarks;
+            }
+            if (hintOptions?.pencilmarks !== undefined) {
+                solveOptions.pencilmarks = hintOptions.pencilmarks;
+            }
+            const response = await solverClient.solve(solveOptions);
+            if (!response.success || !response.data?.hints?.length) {
+                const errorMessage = response.error ?? 'No hints available for the current state';
+                setTeachingState(prev => ({
+                    ...prev,
+                    isLoading: false,
+                    error: errorMessage,
+                    isActive: false,
+                    currentHint: null,
+                    currentStep: 0,
+                    totalSteps: 0,
+                }));
+                setAllSteps([]);
+                return;
+            }
+            const hints = response.data.hints;
+            const convertedSteps = hints.map(convertHintStep);
+            if (convertedSteps.length === 0) {
+                setTeachingState(prev => ({
+                    ...prev,
+                    isLoading: false,
+                    error: 'No hints available',
+                    isActive: false,
+                    currentHint: null,
+                    currentStep: 0,
+                    totalSteps: 0,
+                }));
+                setAllSteps([]);
+                return;
+            }
+            setAllSteps(convertedSteps);
+            setTeachingState({
+                isActive: true,
+                currentHint: convertedSteps[0] ?? null,
+                currentStep: 0,
+                totalSteps: convertedSteps.length,
+                isLoading: false,
+                error: null,
+            });
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Failed to get hint';
+            setTeachingState(prev => ({
+                ...prev,
+                isLoading: false,
+                error: errorMessage,
+                isActive: false,
+                currentHint: null,
+                currentStep: 0,
+                totalSteps: 0,
+            }));
+            setAllSteps([]);
+        }
+    }, [solverClient]);
+    const applyHint = useCallback(() => {
+        return teachingState.currentHint;
+    }, [teachingState.currentHint]);
+    const nextStep = useCallback(() => {
+        if (teachingState.currentStep < teachingState.totalSteps - 1) {
+            const nextStepIndex = teachingState.currentStep + 1;
+            setTeachingState(prev => ({
+                ...prev,
+                currentStep: nextStepIndex,
+                currentHint: allSteps[nextStepIndex] ?? null,
+            }));
+        }
+    }, [teachingState.currentStep, teachingState.totalSteps, allSteps]);
+    const previousStep = useCallback(() => {
+        if (teachingState.currentStep > 0) {
+            const prevStepIndex = teachingState.currentStep - 1;
+            setTeachingState(prev => ({
+                ...prev,
+                currentStep: prevStepIndex,
+                currentHint: allSteps[prevStepIndex] ?? null,
+            }));
+        }
+    }, [teachingState.currentStep, allSteps]);
+    const clearHint = useCallback(() => {
+        setTeachingState({
+            isActive: false,
+            currentHint: null,
+            currentStep: 0,
+            totalSteps: 0,
+            isLoading: false,
+            error: null,
+        });
+        setAllSteps([]);
+    }, []);
+    const hasHint = useMemo(() => teachingState.isActive && teachingState.currentHint !== null, [teachingState.isActive, teachingState.currentHint]);
+    const hasMoreSteps = useMemo(() => teachingState.currentStep < teachingState.totalSteps - 1, [teachingState.currentStep, teachingState.totalSteps]);
+    const hasPreviousStep = useMemo(() => teachingState.currentStep > 0, [teachingState.currentStep]);
+    return {
+        teachingState,
+        getHint,
+        applyHint,
+        nextStep,
+        previousStep,
+        clearHint,
+        hasHint,
+        hasMoreSteps,
+        hasPreviousStep,
+    };
+}
+//# sourceMappingURL=useGameTeaching.js.map

package/dist/hooks/useGameTeaching.js.map

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

package/dist/hooks/useGameTimer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Game Timer Hook - Track elapsed time during gameplay
+ */
+export interface UseGameTimerResult {
+    /** Elapsed time in seconds */
+    elapsedSeconds: number;
+    /** Formatted time string (MM:SS or HH:MM:SS) */
+    formattedTime: string;
+    /** Whether the timer is running */
+    isRunning: boolean;
+    /** Start the timer */
+    start: () => void;
+    /** Pause the timer */
+    pause: () => void;
+    /** Resume the timer */
+    resume: () => void;
+    /** Reset the timer */
+    reset: () => void;
+    /** Stop the timer (pause and return final time) */
+    stop: () => number;
+}
+export interface UseGameTimerOptions {
+    /** Auto-start timer on mount */
+    autoStart?: boolean;
+    /** Initial time in seconds */
+    initialTime?: number;
+}
+/**
+ * Hook for game timer functionality
+ *
+ * @param options - Timer options
+ * @returns Timer state and controls
+ *
+ * @example
+ * ```tsx
+ * const { elapsedSeconds, formattedTime, isRunning, start, pause, stop } = useGameTimer({ autoStart: true });
+ *
+ * // Display: <span>{formattedTime}</span>
+ * // On completion: const finalTime = stop();
+ * ```
+ */
+export declare function useGameTimer(options?: UseGameTimerOptions): UseGameTimerResult;
+//# sourceMappingURL=useGameTimer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useGameTimer.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameTimer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,uBAAuB;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CA0DpB"}

package/dist/hooks/useGameTimer.js

@@ -0,0 +1,68 @@
+/**
+ * Game Timer Hook - Track elapsed time during gameplay
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { formatTime } from '../utils/time';
+/**
+ * Hook for game timer functionality
+ *
+ * @param options - Timer options
+ * @returns Timer state and controls
+ *
+ * @example
+ * ```tsx
+ * const { elapsedSeconds, formattedTime, isRunning, start, pause, stop } = useGameTimer({ autoStart: true });
+ *
+ * // Display: <span>{formattedTime}</span>
+ * // On completion: const finalTime = stop();
+ * ```
+ */
+export function useGameTimer(options = {}) {
+    const { autoStart = false, initialTime = 0 } = options;
+    const [elapsedSeconds, setElapsedSeconds] = useState(initialTime);
+    const [isRunning, setIsRunning] = useState(autoStart);
+    const intervalRef = useRef(null);
+    // Timer tick effect
+    useEffect(() => {
+        if (isRunning) {
+            intervalRef.current = globalThis.setInterval(() => {
+                setElapsedSeconds(prev => prev + 1);
+            }, 1000);
+        }
+        return () => {
+            if (intervalRef.current) {
+                globalThis.clearInterval(intervalRef.current);
+                intervalRef.current = null;
+            }
+        };
+    }, [isRunning]);
+    const start = useCallback(() => {
+        setElapsedSeconds(0);
+        setIsRunning(true);
+    }, []);
+    const pause = useCallback(() => {
+        setIsRunning(false);
+    }, []);
+    const resume = useCallback(() => {
+        setIsRunning(true);
+    }, []);
+    const reset = useCallback(() => {
+        setIsRunning(false);
+        setElapsedSeconds(0);
+    }, []);
+    const stop = useCallback(() => {
+        setIsRunning(false);
+        return elapsedSeconds;
+    }, [elapsedSeconds]);
+    return {
+        elapsedSeconds,
+        formattedTime: formatTime(elapsedSeconds),
+        isRunning,
+        start,
+        pause,
+        resume,
+        reset,
+        stop,
+    };
+}
+//# sourceMappingURL=useGameTimer.js.map

package/dist/hooks/useGameTimer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameTimer.js","sourceRoot":"","sources":["../../src/hooks/useGameTimer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AA4B3C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAC1B,UAA+B,EAAE;IAEjC,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEvD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,MAAM,CACxB,IAAI,CACL,CAAC;IAEF,oBAAoB;IACpB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,CAAC,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE;gBAChD,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAC9C,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACrB,YAAY,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,YAAY,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,cAAc,CAAC;IACxB,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,OAAO;QACL,cAAc;QACd,aAAa,EAAE,UAAU,CAAC,cAAc,CAAC;QACzC,SAAS;QACT,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,IAAI;KACL,CAAC;AACJ,CAAC"}