@icarusmx/creta 1.4.6 → 1.4.8

package/ejemplo.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+MENSAJE="Salgamos de este laberinto."
+echo $MENSAJE

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

@@ -3,9 +3,9 @@ export const GIT_BASICO = {
   id: 'git-basico',
 
   intro: {
-    definition: 'Git es un sistema de control de versiones que te permite rastrear cambios en tu código.',
-    explanation: 'Con git puedes guardar "snapshots" de tu proyecto en diferentes momentos.',
-    detail: 'Esto te permite experimentar sin miedo, colaborar con otros, y volver atrás si algo sale mal.'
+    definition: 'Git es un sistema de registro y control de versiones que te permite gestionar los distintos estados de un proyecto a lo largo de su desarrollo.',
+    explanation: 'Imagina un álbum de fotos: cada commit es una foto de todos tus archivos en un momento específico.',
+    detail: 'Con Git puedes hojear el álbum completo, volver a cualquier foto anterior, o tomar nuevas fotos conforme avanzas. Esto te permite experimentar sin miedo porque siempre puedes regresar.'
   },
 
   steps: [
@@ -29,17 +29,17 @@ export const GIT_BASICO = {
       type: 'command-intro',
       command: 'git add',
       description: 'Tercer comando: git add',
-      explanation: 'git add prepara archivos para ser guardados en el siguiente commit.',
+      explanation: 'git add prepara los archivos que quieres incluir en tu próxima foto.',
       example: 'git add archivo.js\ngit add .',
-      instruction: 'Usa "git add ." para agregar todos los cambios, o especifica archivos individuales.'
+      instruction: 'Usa git add . para incluir todos los cambios, o git add archivo.js para elegir archivos específicos.'
     },
     {
       type: 'command-intro',
       command: 'git commit',
       description: 'Cuarto comando: git commit',
-      explanation: 'git commit guarda un snapshot de los cambios que agregaste con git add.',
+      explanation: 'git commit toma la foto y la guarda en tu álbum.',
       example: 'git commit -m "Mensaje descriptivo"',
-      instruction: 'Siempre incluye un mensaje que describa qué cambiaste y por qué.'
+      instruction: 'El mensaje con -m es como escribir al reverso de la foto para recordar qué cambiaste y por qué.'
     },
     {
       type: 'command-intro',

package/lib/data/lessons/sintaxis/piping-redireccion.js

@@ -0,0 +1,142 @@
+// Piping y Redirección - Conectando comandos y manejando flujos de datos
+export const PIPING_REDIRECCION = {
+  id: 'piping-redireccion',
+
+  intro: {
+    definition: 'Piping y redirección son mecanismos para conectar comandos y controlar hacia dónde va la información.',
+    explanation: 'En lugar de ver resultados en pantalla, puedes enviarlos a archivos, otros comandos, o usarlos como entrada.',
+    detail: 'Esto es lo que hace a bash tan poderoso: puedes combinar comandos simples para crear flujos de trabajo complejos.'
+  },
+
+  steps: [
+    {
+      type: 'command-intro',
+      command: '|',
+      description: 'El pipe (tubería)',
+      explanation: 'El símbolo | toma la salida de un comando y la envía como entrada a otro.',
+      example: 'ls | grep ".js"\ncat archivo.txt | wc -l',
+      instruction: 'Úsalo para encadenar comandos. La salida del izquierdo entra al derecho.'
+    },
+    {
+      type: 'command-intro',
+      command: '>',
+      description: 'Redirección de salida (sobrescribir)',
+      explanation: '> toma la salida de un comando y la guarda en un archivo, sobrescribiendo contenido previo.',
+      example: 'echo "Hola mundo" > saludo.txt\nls > archivos.txt',
+      instruction: 'Si el archivo existe, se borra y se reemplaza con el nuevo contenido.'
+    },
+    {
+      type: 'command-intro',
+      command: '>>',
+      description: 'Redirección de salida (agregar)',
+      explanation: '>> agrega contenido al final de un archivo sin borrar lo que ya existe.',
+      example: 'echo "Primera línea" > log.txt\necho "Segunda línea" >> log.txt',
+      instruction: 'Útil para logs y archivos donde quieres preservar el contenido anterior.'
+    },
+    {
+      type: 'command-intro',
+      command: '<',
+      description: 'Redirección de entrada',
+      explanation: '< toma el contenido de un archivo y lo usa como entrada para un comando.',
+      example: 'wc -l < archivo.txt\nsort < nombres.txt',
+      instruction: 'En lugar de leer desde teclado, el comando lee desde el archivo.'
+    },
+    {
+      type: 'command-intro',
+      command: '<<<',
+      description: 'Here-string (cadena directa)',
+      explanation: '<<< pasa un string directamente como entrada a un comando.',
+      example: 'wc -w <<< "Salgamos de este laberinto"\ngrep "mundo" <<< "Hola mundo"',
+      instruction: 'Muy útil para pasar variables como entrada: grep "patrón" <<< "$VARIABLE"'
+    },
+    {
+      type: 'command-intro',
+      command: 'read <<< "$VAR"',
+      description: 'Usando read con here-string',
+      explanation: 'read puede tomar una string y dividirla en partes.',
+      example: 'VERSION="1.2.3"\nIFS=\'.\' read -r MAJOR MINOR PATCH <<< "$VERSION"\necho $PATCH  # imprime: 3',
+      instruction: 'IFS define el delimitador. read separa la string y asigna a cada variable.'
+    },
+    {
+      type: 'command-intro',
+      command: 'read -r -a',
+      description: 'Read en un array',
+      explanation: 'Con -a, read guarda las partes en un array en lugar de variables separadas.',
+      example: 'VERSION="1.2.3"\nIFS=\'.\' read -r -a PARTS <<< "$VERSION"\necho ${PARTS[0]}  # 1\necho ${PARTS[1]}  # 2\necho ${PARTS[2]}  # 3',
+      instruction: 'Accede a cada parte con ${ARRAY[índice]}. Los índices empiezan en 0.'
+    },
+    {
+      type: 'command-intro',
+      command: '2>',
+      description: 'Redirección de errores',
+      explanation: '2> redirige los mensajes de error (stderr) a un archivo.',
+      example: 'npm install 2> errores.log\nls archivo-que-no-existe 2> /dev/null',
+      instruction: '/dev/null es como un "agujero negro" - descarta todo lo que le envíes.'
+    },
+    {
+      type: 'command-intro',
+      command: '&>',
+      description: 'Redirección de salida Y errores',
+      explanation: '&> redirige tanto la salida normal como los errores al mismo destino.',
+      example: 'npm install &> install-log.txt\ngit pull &> pull.log',
+      instruction: 'Útil cuando quieres capturar todo lo que un comando produce.'
+    },
+    {
+      type: 'code',
+      title: 'Ejemplo real: Procesando una versión',
+      code: `#!/bin/bash
+
+# Obtener versión del package.json
+VERSION=$(node -p "require('./package.json').version")
+
+# Aquí está la magia del here-string:
+# 1. Tomamos $VERSION (ej: "1.2.3")
+# 2. Se lo pasamos como entrada a read usando <<<
+# 3. IFS='.' le dice a read que separe por puntos
+# 4. -r significa "raw" (no interpretar backslashes)
+# 5. -a PARTS dice "guarda las partes en el array PARTS"
+
+IFS='.' read -r -a PARTS <<< "$VERSION"
+
+# Ahora podemos acceder a cada parte
+echo "Major: \${PARTS[0]}"   # 1
+echo "Minor: \${PARTS[1]}"   # 2
+echo "Patch: \${PARTS[2]}"   # 3
+
+# Incrementar el patch
+NEW_PATCH=$((PARTS[2] + 1))
+echo "Nueva versión: \${PARTS[0]}.\${PARTS[1]}.$NEW_PATCH"`,
+      after: [
+        '',
+        'El operador <<< es una forma elegante de pasar datos.',
+        'Sin él, tendrías que crear un archivo temporal o usar echo | read.',
+        'Es especialmente útil para procesar variables.'
+      ]
+    },
+    {
+      type: 'code',
+      title: 'Combinando pipes y redirección',
+      code: `# Ver solo archivos .js, contar líneas, guardar resultado
+ls | grep ".js" | wc -l > total-archivos.txt
+
+# Buscar en múltiples archivos y guardar matches
+cat *.js | grep "function" > funciones.txt
+
+# Procesar git log y extraer solo los commits
+git log --oneline | head -5 > ultimos-commits.txt
+
+# Buscar errores en logs, ignorar otros mensajes
+cat app.log | grep "ERROR" 2> /dev/null > errores-importantes.txt`,
+      after: [
+        '',
+        'Puedes encadenar cuantos pipes necesites.',
+        'Cada comando procesa la salida del anterior.'
+      ]
+    },
+    {
+      type: 'maze-completion',
+      message: 'Piping y Redirección completado!',
+      unlocked: 'Ahora entiendes cómo fluye la información entre comandos.'
+    }
+  ]
+}

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

@@ -12,34 +12,67 @@ export const TERMINAL_BASICO = {
     {
       type: 'command-intro',
       command: 'ls',
-      description: 'Este es tu primer comando: ls',
+      description: '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
+      example: 'ls\nls -la',
+      instruction: 'Pruébalo en tu terminal. Con -la verás archivos ocultos y más detalles.'
+    },
+    {
+      type: 'command-intro',
+      command: 'mkdir',
+      description: 'Segundo comando: mkdir',
+      explanation: 'mkdir crea un nuevo directorio (carpeta).',
+      example: 'mkdir mi-carpeta\nmkdir proyectos/nuevo-proyecto',
+      instruction: 'Crea una carpeta nueva. Prueba: mkdir prueba'
     },
     {
       type: 'command-intro',
       command: 'cd',
-      description: 'Segundo comando: cd',
+      description: 'Tercer comando: cd',
       explanation: 'cd te permite cambiar de directorio (carpeta).',
-      example: 'cd nombre-carpeta',
-      instruction: 'Úsalo para navegar a una carpeta. Ejemplo: cd Documentos'
+      example: 'cd mi-carpeta\ncd ..\ncd ~',
+      instruction: 'cd nombre-carpeta entra a una carpeta. cd .. regresa al directorio padre. cd ~ te lleva a tu carpeta home.'
     },
     {
       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'
+      command: 'touch',
+      description: 'Cuarto comando: touch',
+      explanation: 'touch crea un archivo vacío si no existe, o actualiza su fecha de modificación.',
+      example: 'touch archivo.txt\ntouch script.js README.md',
+      instruction: 'Muy útil para crear archivos rápidamente antes de editarlos.'
     },
     {
       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'
+      command: 'wc',
+      description: 'Quinto comando: wc (word count)',
+      explanation: 'wc cuenta líneas, palabras y caracteres en archivos o texto.',
+      example: 'wc archivo.txt\nwc -l archivo.txt  # solo líneas\nwc -w archivo.txt  # solo palabras\nwc -c archivo.txt  # solo caracteres',
+      instruction: 'Por defecto muestra: líneas palabras caracteres. Con flags puedes ver solo lo que necesitas.'
+    },
+    {
+      type: 'code',
+      title: 'Ejemplos detallados de wc',
+      code: `# Contar líneas de código en un archivo
+wc -l script.js
+
+# Contar palabras en un texto
+echo "Salgamos de este laberinto" | wc -w
+# Resultado: 4
+
+# Contar archivos en un directorio
+ls | wc -l
+
+# Contar líneas en múltiples archivos
+wc -l *.js
+
+# Combinar con otros comandos
+cat archivo.txt | grep "error" | wc -l
+# Cuenta cuántas líneas contienen "error"`,
+      after: [
+        '',
+        'wc es especialmente útil cuando lo combinas con pipes.',
+        'Puedes contar resultados de búsquedas, líneas de código, etc.'
+      ]
     },
     {
       type: 'maze-completion',

package/lib/data/menus.js

@@ -8,7 +8,8 @@ export const SINTAXIS_MENU_CONFIG = {
   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: 'bash-scripts', title: '3. Bash Scripts', description: 'variables, sed, condicionales' },
+    { id: 'piping-redireccion', title: '4. Piping y Redirección', description: '|, >, <, <<<' }
   ]
 }
 

package/lib/executors/sintaxis-executor.js

@@ -4,6 +4,7 @@ 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'
 import { BASH_SCRIPTS } from '../data/lessons/sintaxis/bash-scripts.js'
+import { PIPING_REDIRECCION } from '../data/lessons/sintaxis/piping-redireccion.js'
 import { clearConsole } from '../utils/output.js'
 import { createPromptInterface } from '../utils/input.js'
 import { UserState } from '../utils/user-state.js'
@@ -12,7 +13,8 @@ import { UNLOCK_CONFIG } from '../data/progression.js'
 const LESSONS_BY_ID = new Map([
   ['terminal-basico', TERMINAL_BASICO],
   ['git-basico', GIT_BASICO],
-  ['bash-scripts', BASH_SCRIPTS]
+  ['bash-scripts', BASH_SCRIPTS],
+  ['piping-redireccion', PIPING_REDIRECCION]
 ])
 
 function waitForEnter(message = '\nPresiona Enter para continuar...') {

package/package.json

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