@icarusmx/creta 1.3.4 → 1.4.0

package/lib/data/lessons/lesson7-object-definition.js

@@ -0,0 +1,380 @@
+export const LESSON_7_OBJECT_DEFINITION = {
+  id: 7,
+  title: 'LECCIÓN 7: Un objeto es un conjunto de datos y procedimientos que operan sobre esos datos',
+  subtitle: 'Enfoque conceptual: Entender qué es un dato, qué es un procedimiento, y por qué están unidos',
+  flow: [
+    {
+      message: '\nPresiona Enter para comenzar...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        'Para entender qué ES un objeto,',
+        'primero debemos entender dos conceptos fundamentales:',
+        '',
+        '1. ¿Qué es un DATO?',
+        '2. ¿Qué es un PROCEDIMIENTO?'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        '¿Qué es un DATO?',
+        '==================================================',
+        '\n🔍 Un dato es información que describe el estado de algo'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver ejemplos conceptuales...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n📦 Ejemplos de datos:',
+        '',
+        '• El saldo de una cuenta',
+        '  → Este número describe cuánto dinero hay',
+        '',
+        '• El nombre de un usuario',
+        '  → Este texto describe quién es',
+        '',
+        '• El estado de una puerta (abierta/cerrada)',
+        '  → Este valor describe la condición actual',
+        '',
+        '• La lista de productos en un carrito',
+        '  → Esta colección describe qué contiene'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n💡 Característica clave de los datos:',
+        'Los datos DESCRIBEN, no HACEN nada por sí mismos',
+        '',
+        'El saldo de 5000 no se deposita solo',
+        "El nombre 'María' no se cambia solo",
+        'La puerta cerrada no se abre sola',
+        '',
+        'Los datos son PASIVOS. Solo representan información.'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver qué es un procedimiento...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        '¿Qué es un PROCEDIMIENTO?',
+        '==================================================',
+        '\n' +
+          '🔍 Un procedimiento es una secuencia de pasos que MODIFICA o LEE datos'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver ejemplos conceptuales...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n⚙️ Ejemplos de procedimientos:',
+        '',
+        '• Depositar dinero en una cuenta',
+        "  → MODIFICA el dato 'saldo' sumándole una cantidad",
+        '',
+        '• Cambiar el nombre de un usuario',
+        "  → MODIFICA el dato 'nombre' asignándole un nuevo valor",
+        '',
+        '• Abrir una puerta',
+        "  → MODIFICA el dato 'estado' de 'cerrada' a 'abierta'",
+        '',
+        '• Consultar el saldo',
+        "  → LEE el dato 'saldo' sin modificarlo"
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n💡 Característica clave de los procedimientos:',
+        'Los procedimientos son ACTIVOS. Hacen algo con los datos.',
+        '',
+        'Un procedimiento sin datos no tiene sentido:',
+        '  • ¿Depositar en dónde?',
+        '  • ¿Cambiar qué nombre?',
+        '  • ¿Abrir cuál puerta?',
+        '',
+        'Los procedimientos NECESITAN datos para operar'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver por qué están unidos...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        '¿Por qué DATOS y PROCEDIMIENTOS están JUNTOS?',
+        '==================================================',
+        '\n🤔 La pregunta fundamental:',
+        'Si los datos describen el estado,',
+        'y los procedimientos modifican ese estado,',
+        '¿no deberían estar relacionados?'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver la respuesta...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n✨ La respuesta: EL OBJETO',
+        '',
+        'Un objeto es la unión natural de:',
+        '  • Los datos que describen SU estado',
+        '  • Los procedimientos que operan sobre ESE estado'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver un ejemplo conceptual...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n📍 Ejemplo conceptual: Una cuenta bancaria',
+        '',
+        '┌─────────────────────────────────────┐',
+        '│  OBJETO: Cuenta                     │',
+        '├─────────────────────────────────────┤',
+        '│  DATOS (estado):                    │',
+        '│  • saldo                            │',
+        '│  • titular                          │',
+        '│  • activa                           │',
+        '├─────────────────────────────────────┤',
+        '│  PROCEDIMIENTOS (operaciones):      │',
+        '│  • depositar                        │',
+        '│  • retirar                          │',
+        '│  • consultarSaldo                   │',
+        '│  • desactivar                       │',
+        '└─────────────────────────────────────┘'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n🔗 La relación esencial:',
+        '',
+        "• 'depositar' opera sobre 'saldo'",
+        '  → No tiene sentido depositar sin un saldo que modificar',
+        '',
+        "• 'desactivar' opera sobre 'activa'",
+        '  → No tiene sentido desactivar sin un estado que cambiar',
+        '',
+        "• 'consultarSaldo' lee 'saldo'",
+        '  → No tiene sentido consultar sin un saldo que leer'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n💭 La intuición:',
+        'Los datos y los procedimientos están ATADOS entre sí',
+        '',
+        'No existen datos sin procedimientos que los manipulen',
+        'No existen procedimientos sin datos sobre los que operen',
+        '',
+        'Esta unión es lo que llamamos: OBJETO'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver la definición completa...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        'La Definición Completa',
+        '==================================================',
+        "\n💎 'Un objeto es un conjunto de datos y procedimientos",
+        "    que operan sobre esos datos'"
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para desglosar la definición...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        '\n🔍 Desglose de la definición:',
+        '',
+        "1️⃣ 'Un objeto es un CONJUNTO'",
+        '   → No es un solo elemento, es una agrupación',
+        '   → Datos y procedimientos forman una unidad',
+        ''
+      ],
+      type: 'text'
+    },
+    {
+      message: 'Presiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        "2️⃣ '...de DATOS'",
+        '   → Información que describe el estado del objeto',
+        "   → Valores que representan lo que el objeto 'es'",
+        '   → PASIVOS: no hacen nada por sí mismos',
+        ''
+      ],
+      type: 'text'
+    },
+    {
+      message: 'Presiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        "3️⃣ '...y PROCEDIMIENTOS'",
+        '   → Secuencias de pasos que modifican o leen datos',
+        "   → Operaciones que representan lo que el objeto 'hace'",
+        '   → ACTIVOS: transforman el estado',
+        ''
+      ],
+      type: 'text'
+    },
+    {
+      message: 'Presiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      lines: [
+        "4️⃣ '...que OPERAN SOBRE esos datos'",
+        '   → Los procedimientos NO operan sobre datos ajenos',
+        '   → Solo modifican/leen los datos del MISMO objeto',
+        '   → Esta es la relación fundamental'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para ver por qué esto importa...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        '¿Por qué esta definición es fundamental?',
+        '==================================================',
+        '\n🎯 Sin entender qué ES un objeto,',
+        '   no podemos entender los otros 6 enunciados:',
+        '',
+        '• Enunciado 1: ¿Cómo descomponemos en objetos',
+        '              si no sabemos qué es un objeto?',
+        '',
+        '• Enunciado 2: ¿Cómo interactúan los objetos',
+        '              si no entendemos su naturaleza?',
+        '',
+        '• Enunciado 3: ¿Por qué solicitudes son la única forma',
+        '              de invocar procedimientos?',
+        '',
+        '• Enunciado 4: ¿Qué firmas tienen las operaciones',
+        '              (los procedimientos) del objeto?',
+        '',
+        '• Enunciado 5: ¿Qué es la interfaz del objeto',
+        '              sino el conjunto de sus operaciones?',
+        '',
+        '• Enunciado 6: ¿Por qué diseñar las interfaces primero',
+        '              si no sabemos que exponen operaciones?'
+      ],
+      type: 'text'
+    },
+    {
+      message: '\nPresiona Enter para la conclusión...',
+      type: 'pause'
+    },
+    {
+      type: 'clear'
+    },
+    {
+      lines: [
+        '🎓 Conclusión: La Naturaleza del Objeto',
+        '==================================================',
+        '\n📌 Lo que aprendimos:',
+        '',
+        '1. Un DATO describe el estado (información pasiva)',
+        '2. Un PROCEDIMIENTO modifica o lee datos (acción activa)',
+        '3. Un OBJETO une datos con sus procedimientos',
+        '4. Esta unión no es arbitraria, es esencial',
+        '\n💡 La intuición central:',
+        '',
+        'Los datos no existen aislados',
+        'Los procedimientos no operan en el vacío',
+        'El objeto es la unión natural de ambos',
+        '\n🔗 Conexión con el resto del paradigma:',
+        '',
+        'Ahora que sabemos QUÉ es un objeto,',
+        'podemos entender:',
+        '  • Cómo descomponerlos (enunciado 1)',
+        '  • Cómo se comunican (enunciados 2, 3)',
+        '  • Cómo se diseñan (enunciados 4, 5, 6)',
+        '\n💭 Reflexión final:',
+        '',
+        'Antes de diseñar sistemas orientados a objetos,',
+        'debemos entender la naturaleza fundamental del objeto:',
+        '',
+        "  'Un conjunto de datos y procedimientos",
+        "   que operan sobre esos datos'"
+      ],
+      type: 'text'
+    },
+    {
+      message: '\n✨ ¡Lección 7 completada! Presiona Enter para continuar...',
+      type: 'pause'
+    },
+    {
+      type: 'maze-completion',
+      message: 'Lección 7: Definición de objeto completado!',
+      unlocked: '¡Completaste todos los enunciados fundamentales!'
+    }
+  ]
+}

package/lib/data/lessons/sintaxis/terminal-basico.js

@@ -0,0 +1,50 @@
+// Terminal Básico - Comandos fundamentales de navegación
+export const TERMINAL_BASICO = {
+  id: 'terminal-basico',
+
+  intro: {
+    definition: 'Sintaxis: estudia el modo en que se combinan las palabras y los distintos grupos que forman para expresar significado.',
+    explanation: 'En esta sección aprenderemos algo más que palabras, aprenderemos comandos.',
+    detail: 'Al final del día un comando es una palabra, la diferencia es que está dotada de un significado que tu computadora entiende.'
+  },
+
+  steps: [
+    {
+      type: 'command-intro',
+      command: 'ls',
+      description: 'Este es tu primer comando: ls',
+      explanation: 'ls lista los archivos y carpetas en tu ubicación actual.',
+      instruction: 'Presiona ctrl + c para terminar esta sesión y después ejecuta el comando ls en tu terminal',
+      exitOnComplete: true
+    },
+    {
+      type: 'command-intro',
+      command: 'cd',
+      description: 'Segundo comando: cd',
+      explanation: 'cd te permite cambiar de directorio (carpeta).',
+      example: 'cd nombre-carpeta',
+      instruction: 'Úsalo para navegar a una carpeta. Ejemplo: cd Documentos'
+    },
+    {
+      type: 'command-intro',
+      command: 'cd ..',
+      description: 'Tercer comando: cd ..',
+      explanation: 'cd .. te regresa al directorio anterior (el padre).',
+      example: 'cd ..',
+      instruction: 'Si estás en /home/usuario/Documentos, cd .. te lleva a /home/usuario'
+    },
+    {
+      type: 'command-intro',
+      command: 'mkdir',
+      description: 'Cuarto comando: mkdir',
+      explanation: 'mkdir crea un nuevo directorio (carpeta).',
+      example: 'mkdir mi-proyecto',
+      instruction: 'Crea una carpeta nueva. Prueba: mkdir prueba'
+    },
+    {
+      type: 'maze-completion',
+      message: 'Terminal básico completado!',
+      unlocked: 'Git básico'
+    }
+  ]
+}

package/lib/data/menus.js

@@ -0,0 +1,43 @@
+import { WELCOME_BANNER } from './messages.js'
+import { ENUNCIADOS } from './enunciados.js'
+
+export const MAIN_MENU_CONFIG = {
+  banner: WELCOME_BANNER,
+  title: 'Te ofrecemos las siguientes opciones:',
+  options: [
+    { id: 'sintaxis', title: 'Aprender sintaxis' },
+    { id: 'enunciados', title: 'Aprender conceptos de diseño' },
+    { id: 'proyectos', title: 'Construir proyectos' }
+  ]
+}
+
+export const ENUNCIADOS_MENU_CONFIG = {
+  title: 'Elige qué enunciado te gustaría explorar:',
+  description: [
+    'Los enunciados fundamentales ejercitan el pensamiento orientado a objetos de los estudiantes de Creta.',
+    'Escogimos estos enunciados porque creemos que exhaustan los conceptos mínimos necesarios para entender el paradigma.'
+  ],
+  options: ENUNCIADOS.map((enunciado) => ({
+    id: enunciado.id,
+    title: `${enunciado.id}. ${enunciado.texto}`,
+    data: enunciado
+  }))
+}
+
+export const PROYECTOS_MENU_CONFIG = {
+  title: 'Construir Proyectos',
+  options: [
+    { id: 'pr', title: '🔀 Construye una pull-request' },
+    { id: 'portfolio', title: '🎨 Construye tu portafolio' }
+  ]
+}
+
+export const PORTFOLIO_MENU_CONFIG = {
+  title: 'Construye tu Portafolio',
+  options: [
+    { id: 0, title: '🎨 Portafolio Personal', description: 'Reto completo', level: 0 },
+    { id: 1, title: '🔓 Portafolio Nivel 1', description: 'Solo navbar', level: 1 },
+    { id: 2, title: '🔓 Portafolio Nivel 2', description: 'Navbar + hero', level: 2 },
+    { id: 3, title: '🔓 Portafolio Nivel 3', description: 'Solución completa', level: 3 }
+  ]
+}

package/lib/data/messages.js

@@ -0,0 +1,28 @@
+export const WELCOME_BANNER = `
+█████████████████████████
+█   █   █   █   █   █   █
+█ C █ R █ E █ T █ A █ █ █
+█   █   █   █   █   █   █
+█████████████████████████
+
+Bienvenido a la escuela de software de icarus.mx
+Salgamos de este laberinto 🏛️
+`
+
+export const HELP_TEXT = `
+📚 Comandos disponibles:
+  creta                - Explora los 7 enunciados fundamentales (comando principal) 🧠
+  creta enunciados     - Explora los 7 enunciados fundamentales 🧠
+  creta portafolio     - Crea tu portafolio personal (reto completo)
+  creta portafolio-1   - Desbloquea nivel 1 (navbar) 🔓
+  creta portafolio-2   - Desbloquea nivel 2 (navbar + hero) 🔓
+  creta portafolio-3   - Desbloquea nivel 3 (solución completa) 🔓
+  creta code           - Inicia sesión interactiva de programación 🤖
+  creta help           - Muestra esta ayuda
+
+💡 Tip: Si estás dentro de un proyecto existente, los comandos
+    portafolio-1/2/3 actualizarán tus archivos directamente
+
+🎯 La filosofía Creta: partir de enunciados que generan 'ruido' para
+   construir comprensión real, no solo sintaxis.
+`

package/lib/executors/enunciados-executor.js

@@ -0,0 +1,73 @@
+import { MenuBuilder } from '../builders/MenuBuilder.js'
+import { ENUNCIADOS_MENU_CONFIG } from '../data/menus.js'
+import { LESSONS_BY_ID } from '../data/lessons/index.js'
+import { LessonBuilder } from '../builders/LessonBuilder.js'
+import { createPromptInterface } from '../utils/input.js'
+import { clearConsole } from '../utils/output.js'
+
+const UPCOMING_MESSAGE = [
+  '\n🚀 Próximamente:',
+  '- Sesiones de estudio dirigidas basadas en este enunciado',
+  '- Ejercicios prácticos que ilustren el concepto',
+  '- Proyectos específicos para internalizar la idea'
+].join('\n')
+
+function waitForEnter(message = '\nPresiona Enter para continuar...') {
+  const rl = createPromptInterface()
+  return new Promise((resolve) => {
+    rl.question(message, () => {
+      rl.close()
+      resolve()
+    })
+  })
+}
+
+async function runLesson(lessonId, enunciadoTexto, { LessonCtor = LessonBuilder, delay = setTimeout } = {}) {
+  const lessonData = LESSONS_BY_ID.get(lessonId)
+
+  if (!lessonData) {
+    console.log(UPCOMING_MESSAGE)
+    console.log('\n💭 Por ahora, reflexiona: ¿qué parte de este enunciado te genera más curiosidad?')
+    return
+  }
+
+  // Show selection confirmation (NEW UX PATTERN)
+  console.log(`\nElegiste: Enunciado ${lessonId}`)
+  console.log('Cargando...')
+  await new Promise((resolve) => delay(resolve, 1000))
+
+  // Clear screen but keep scroll history (NEW UX PATTERN)
+  clearConsole()
+
+  // Show enunciado text
+  console.log(enunciadoTexto)
+  await new Promise((resolve) => delay(resolve, 1500))
+
+  try {
+    const lesson = new LessonCtor(lessonData)
+    await lesson.start()
+  } catch (error) {
+    console.error('\n❌ Error al ejecutar la lección:', error.message)
+    console.log(UPCOMING_MESSAGE)
+  }
+}
+
+export async function executeEnunciados({
+  waitForEnter: wait = waitForEnter,
+  menu,
+  menuConfig = ENUNCIADOS_MENU_CONFIG,
+  lessonBuilder: LessonCtor = LessonBuilder,
+  delay = setTimeout
+} = {}) {
+  const enunciadosMenu = menu || new MenuBuilder(menuConfig)
+
+  while (true) {
+    const choice = await enunciadosMenu.show()
+    if (!choice) {
+      return
+    }
+
+    await runLesson(choice.id, choice.data?.texto || choice.title, { LessonCtor, delay })
+    await wait('\nPresiona Enter para regresar al menú de enunciados...')
+  }
+}