@icarusmx/creta 1.4.10 → 1.4.12

package/lib/data/menus.js

@@ -2,15 +2,43 @@ import { ENUNCIADOS } from './enunciados.js'
 import { UNLOCK_CONFIG, isUnlocked, hasCompletedLesson } from './progression.js'
 import { UserState } from '../utils/user-state.js'
 
-export const SINTAXIS_MENU_CONFIG = {
-  title: 'Elige qué lección de sintaxis te gustaría explorar:',
-  description: 'Aprende los comandos fundamentales de terminal y git.',
-  options: [
-    { id: 'terminal-basico', title: '1. Terminal básico', description: 'ls, cd, mkdir' },
-    { id: 'git-basico', title: '2. Git básico', description: 'init, status, add, commit' },
-    { id: 'bash-scripts', title: '3. Bash Scripts', description: 'variables, sed, condicionales' },
-    { id: 'piping-redireccion', title: '4. Piping y Redirección', description: '|, >, <, <<<' }
-  ]
+export const SINTAXIS_LESSONS = [
+  {
+    id: 'terminal-basico',
+    title: '1. Terminal básico',
+    description: '',
+    unlockAfter: null
+  },
+  {
+    id: 'git-basico',
+    title: '2. Git básico',
+    description: '',
+    unlockAfter: 'terminal-basico'
+  },
+  {
+    id: 'piping-redireccion',
+    title: '3. Piping y Redirección',
+    description: '',
+    unlockAfter: 'git-basico'
+  },
+  {
+    id: 'bash-scripts',
+    title: '4. Bash Scripts',
+    description: '',
+    unlockAfter: 'piping-redireccion'
+  }
+]
+
+export function getSintaxisMenuConfig(state = UserState.get()) {
+  const options = SINTAXIS_LESSONS
+    .filter((lesson) => !lesson.unlockAfter || hasCompletedLesson(lesson.unlockAfter, state))
+    .map(({ id, title, description }) => ({ id, title, description }))
+
+  return {
+    title: 'Elige qué lección de sintaxis te gustaría explorar:',
+    description: 'Aprende los comandos fundamentales de terminal y git.',
+    options
+  }
 }
 
 const MENU_ITEMS = {
@@ -19,14 +47,13 @@ const MENU_ITEMS = {
   proyectos: { baseTitle: 'Construir proyectos' }
 }
 
-export function getMainMenuConfig() {
-  const state = UserState.get()
+export function getMainMenuConfig(state = UserState.get()) {
   const options = []
 
   for (const [id, itemConfig] of Object.entries(MENU_ITEMS)) {
     const unlockConfig = UNLOCK_CONFIG.mainMenu[id]
 
-    if (!isUnlocked(id, unlockConfig)) continue
+    if (!isUnlocked(id, unlockConfig, state)) continue
 
     const showNew = typeof unlockConfig.showNewIndicator === 'function'
       ? unlockConfig.showNewIndicator(state)
@@ -45,7 +72,9 @@ export function getMainMenuConfig() {
 
   return {
     clearConsole: false,
-    title: 'Te ofrecemos las siguientes opciones:',
+    title: options.length === 1
+      ? 'Empecemos por aquí:'
+      : 'Te ofrecemos las siguientes opciones:',
     options
   }
 }

package/lib/data/progression.js

@@ -1,9 +1,9 @@
 // Centralized progression and unlock logic
 import { UserState } from '../utils/user-state.js'
 
-export function hasCompletedLesson(lessonId) {
-  const state = UserState.get()
-  return state.lessonsCompleted.some(
+export function hasCompletedLesson(lessonId, state = UserState.get()) {
+  const lessonsCompleted = state?.lessonsCompleted || []
+  return lessonsCompleted.some(
     lesson => typeof lesson === 'object' ? lesson.id === lessonId : lesson === lessonId
   )
 }
@@ -14,9 +14,9 @@ export const UNLOCK_CONFIG = {
     sintaxis: {
       alwaysVisible: true,
       showNewIndicator: (state) =>
-        hasCompletedLesson('terminal-basico') && !hasCompletedLesson('git-basico'),
+        hasCompletedLesson('terminal-basico', state) && !hasCompletedLesson('git-basico', state),
       description: (state) =>
-        hasCompletedLesson('terminal-basico') && !hasCompletedLesson('git-basico')
+        hasCompletedLesson('terminal-basico', state) && !hasCompletedLesson('git-basico', state)
           ? 'Git básico desbloqueado'
           : undefined
     },
@@ -33,12 +33,12 @@ export const UNLOCK_CONFIG = {
   },
   sintaxis: {
     directToLesson: (state) =>
-      !hasCompletedLesson('terminal-basico') ? 'terminal-basico' : null
+      !hasCompletedLesson('terminal-basico', state) ? 'terminal-basico' : null
   }
 }
 
-export function isUnlocked(itemKey, config) {
+export function isUnlocked(itemKey, config, state = UserState.get()) {
   if (config.alwaysVisible) return true
   if (!config.unlockAfter) return true
-  return hasCompletedLesson(config.unlockAfter)
+  return hasCompletedLesson(config.unlockAfter, state)
 }

package/lib/executors/sintaxis-executor.js

@@ -1,5 +1,5 @@
 import { MenuBuilder } from '../builders/MenuBuilder.js'
-import { SINTAXIS_MENU_CONFIG } from '../data/menus.js'
+import { getSintaxisMenuConfig, SINTAXIS_LESSONS } from '../data/menus.js'
 import { LessonBuilder } from '../builders/LessonBuilder.js'
 import { TERMINAL_BASICO } from '../data/lessons/sintaxis/terminal-basico.js'
 import { GIT_BASICO } from '../data/lessons/sintaxis/git-basico.js'
@@ -53,18 +53,30 @@ export async function executeSintaxis() {
   const directLesson = UNLOCK_CONFIG.sintaxis.directToLesson(state)
 
   if (directLesson) {
-    await runLesson(directLesson, 'Terminal básico')
+    const lessonMeta = SINTAXIS_LESSONS.find((lesson) => lesson.id === directLesson)
+    const lessonTitle = lessonMeta?.title || 'Lección de sintaxis'
+
+    await runLesson(directLesson, lessonTitle)
+
+    const nextLesson = SINTAXIS_LESSONS.find((lesson) => lesson.unlockAfter === directLesson)
+    if (nextLesson) {
+      console.log(`\n✨ ${nextLesson.title} desbloqueado.`)
+      console.log('   Vuelve al menú de sintaxis para explorarlo.')
+    }
 
-    // After completing, show what was unlocked
-    console.log('\n✨ Ahora puedes acceder al menú de sintaxis para aprender Git básico')
     await waitForEnter()
     return
   }
 
-  // Show menu
-  const menu = new MenuBuilder(SINTAXIS_MENU_CONFIG)
-
   while (true) {
+    const menuConfig = getSintaxisMenuConfig()
+
+    if (menuConfig.options.length === 0) {
+      console.log('\nPor ahora no hay lecciones disponibles en este camino.')
+      return
+    }
+
+    const menu = new MenuBuilder(menuConfig)
     const choice = await menu.show()
     if (!choice) {
       return

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.4.10",
+  "version": "1.4.12",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {

package/test/sintaxis-menu.test.js

@@ -0,0 +1,45 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { getSintaxisMenuConfig, getMainMenuConfig } from '../lib/data/menus.js'
+
+const baseState = {
+  lessonsCompleted: []
+}
+
+test('sintaxis menu shows only terminal básico for new users', () => {
+  const menu = getSintaxisMenuConfig(baseState)
+  assert.equal(menu.options.length, 1)
+  assert.equal(menu.options[0].id, 'terminal-basico')
+})
+
+test('sintaxis menu unlocks git básico after completing terminal básico', () => {
+  const state = {
+    lessonsCompleted: [{ id: 'terminal-basico' }]
+  }
+  const menu = getSintaxisMenuConfig(state)
+  assert.equal(menu.options.length, 2)
+  assert.deepEqual(menu.options.map(option => option.id), ['terminal-basico', 'git-basico'])
+})
+
+test('sintaxis menu unlocks bash scripts after completing git básico', () => {
+  const state = {
+    lessonsCompleted: [
+      { id: 'terminal-basico' },
+      { id: 'git-basico' }
+    ]
+  }
+  const menu = getSintaxisMenuConfig(state)
+  assert.equal(menu.options.length, 3)
+  assert.deepEqual(menu.options.map(option => option.id), ['terminal-basico', 'git-basico', 'bash-scripts'])
+})
+
+test('main menu title changes when only one option is available', () => {
+  const config = getMainMenuConfig({ lessonsCompleted: [] })
+  assert.equal(config.title, 'Empecemos por aquí:')
+})
+
+test('main menu title defaults once multiple options unlock', () => {
+  const config = getMainMenuConfig({ lessonsCompleted: [{ id: 'terminal-basico' }] })
+  assert.equal(config.title, 'Te ofrecemos las siguientes opciones:')
+})