Ejercicios Module: Exercise Hooks and Group Configuration

export type UserGroupLevel = 'basic' | 'intermediate' | 'advanced';

export function useUserGroup(): {
  nivel: UserGroupLevel;
  pictoWidth: number;
  pictoHeight: number;
  minTouchSize: number;
  maxSubcategoriasVisibles: number;
}

import { useUserGroup } from '@/features/ejercicios/hooks/useUserGroup';

export function ExercisesRouter() {
  const { nivel } = useUserGroup();

  if (nivel === 'basic') return <EjerciciosG3Screen />;
  return <EjerciciosG2Screen />;
}

import { useShallow } from 'zustand/react/shallow';
import { useG2ProgressStore } from '@/stores/g2ProgressStore';

export function useEjerciciosG2(): EjerciciosG2State & G2Actions

import { useEjerciciosG2 } from '@/features/ejercicios/hooks/useEjerciciosG2';

export function G2LevelMap() {
  const {
    hydrated,
    isLevelUnlocked,
    isLevelComplete,
    nivelBadgeState,
    estrellasNivel,
    firstIncompleteIndex,
  } = useEjerciciosG2();

  if (!hydrated) return <LoadingSpinner />;

  return [1, 2, 3, 4, 5].map(nivel => (
    <LevelNode
      key={nivel}
      badge={nivelBadgeState(nivel)}
      stars={estrellasNivel(nivel)}
      resumeIndex={isLevelUnlocked(nivel) ? firstIncompleteIndex(nivel) : -1}
    />
  ));
}

import { useShallow } from 'zustand/react/shallow';
import { useG3ProgressStore } from '@/stores/g3ProgressStore';

export function useEjerciciosG3(): EjercicioG3State & G3Actions

import { useEjerciciosG3 } from '@/features/ejercicios/hooks/useEjerciciosG3';

export function G3ExerciseScreen({ nivel, ejIndex }) {
  const { registerFail, completeExercise, estrellasNivel } = useEjerciciosG3();

  const handleCorrect = async () => {
    await completeExercise(nivel, ejIndex);
    const stars = estrellasNivel(nivel);
    // Show star result if this was the last exercise in the level
  };

  const handleWrong = () => registerFail(nivel, ejIndex);

  return <ExerciseContent onCorrect={handleCorrect} onWrong={handleWrong} />;
}

// AsyncStorage key for G2 progress
STORAGE_KEYS.EJERCICIOS_G2   // → '@ejercicios_g2'

// AsyncStorage key for G3 progress
STORAGE_KEYS.EJERCICIOS_G3          // → '@ejercicios_g3'
STORAGE_KEYS.EJERCICIOS_G3_COMPLETADOS  // → '@ejercicios_g3_completados'

import {
  loadG2EmocionesRegistradas,
  loadG2AyudasRegistradas,
} from '@/features/ejercicios/hooks/useEjerciciosG2';

// Returns string[] of emotion IDs
const emociones = await loadG2EmocionesRegistradas();

// Returns AyudaRegistroG2[] of help requests
const ayudas = await loadG2AyudasRegistradas();

// G2
const { resetAllProgress } = useEjerciciosG2();
resetAllProgress(); // synchronous — clears completados, fallos, estrellas, emociones, ayudas

// G3
const { resetAllProgress } = useEjerciciosG3();
await resetAllProgress(); // async — also removes EJERCICIOS_G3_COMPLETADOS from AsyncStorage

// From features/ejercicios/data/grupo2.ts
export function starsFromFailsG2(totalFails: number): 1 | 2 | 3 {
  if (totalFails === 0) return 3;   // ★★★ — no errors
  if (totalFails <= 2) return 2;    // ★★☆ — 1–2 errors
  return 1;                          // ★☆☆ — 3 or more errors
}

// From features/ejercicios/data/grupo3.ts (identical logic)
export function starsFromFails(totalFails: number): 1 | 2 | 3 {
  if (totalFails === 0) return 3;
  if (totalFails <= 2) return 2;
  return 1;
}

// Level 1 — Recognize and Request
export const G2_N1_E1: { opciones: [G2Opt, G2Opt]; instruccion: string }
export const G2_N1_E2: { opciones: G2Opt[]; correctoId: string; instruccion: string; pista: string }
export const G2_N1_E3: { opciones: G2Opt[]; correctoId: string; instruccion: string; pista: string }

// Level 4 — Categories
export const G2_N4_E1  // Two-phase: category selection → pictogram selection
export const G2_N4_E2
export const G2_N4_E3  // Free-form tablero practice

// Level 5 — Turn and Response
export const G2_N5_E1  // "What do you want for a snack?"
export const G2_N5_E2  // "How are you today?"
export const G2_N5_E3  // "What do you want to do now?"

export type G2Opt = { id: string; emoji: string; label: string }

// Level 1 — El Despertar (tap what you see)
export const G3_NIVEL_1: G3L1[]

// Level 2 — La Elección (two-choice matching)
export const G3_NIVEL_2: G3L2[]

// Level 3 — Mis Necesidades (left/right two-choice)
export const G3_NIVEL_3: G3L3[]

// Level 4 — Pedir Ayuda (situational need cards)
export const G3_NIVEL_4: G3L4[]   // needs: 'duele' | 'agua' | 'ayuda'

// Level 5 — Mi Primera Frase (build "Yo quiero X")
export const G3_NIVEL_5: G3L5[]

export type G3Side = 'left' | 'right'
export type G3NeedKind = 'duele' | 'agua' | 'ayuda'