@icarusmx/creta 1.4.5 → 1.4.7

package/ejemplo.sh

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

package/lib/data/lessons/sintaxis/bash-scripts.js

@@ -0,0 +1,142 @@
+// Bash Scripts - Automatización con scripts de shell
+export const BASH_SCRIPTS = {
+  id: 'bash-scripts',
+
+  intro: {
+    definition: 'Un script es una secuencia de comandos guardados en un archivo que se pueden ejecutar como un programa.',
+    explanation: 'Los bash scripts te permiten automatizar tareas repetitivas y crear herramientas personalizadas.',
+    detail: 'Comenzaremos con "Salgamos de este laberinto." y terminaremos construyendo un script de deployment automático.'
+  },
+
+  steps: [
+    {
+      type: 'command-intro',
+      command: 'echo',
+      description: 'Primer concepto: echo',
+      explanation: 'echo imprime texto en la terminal.',
+      example: 'echo "Salgamos de este laberinto."',
+      instruction: 'Este es el comando más simple. Pruébalo en tu terminal.'
+    },
+    {
+      type: 'command-intro',
+      command: '#!/bin/bash',
+      description: 'El shebang',
+      explanation: 'La primera línea de un script debe indicar qué intérprete usar.',
+      example: '#!/bin/bash\necho "Salgamos de este laberinto."',
+      instruction: 'Siempre comienza tus scripts con #!/bin/bash en la primera línea.'
+    },
+    {
+      type: 'command-intro',
+      command: 'nano script.sh',
+      description: 'Crear un archivo de script',
+      explanation: 'Usa cualquier editor de texto para crear archivos .sh',
+      example: 'nano deploy.sh\n# O usa: code deploy.sh',
+      instruction: 'Los scripts son archivos de texto. La extensión .sh es convencional para bash scripts.'
+    },
+    {
+      type: 'command-intro',
+      command: 'chmod +x',
+      description: 'Hacer ejecutable un script',
+      explanation: 'chmod +x le da permisos de ejecución a un archivo.',
+      example: 'chmod +x deploy.sh\n./deploy.sh',
+      instruction: 'Después de chmod +x puedes ejecutar el script con ./nombre-script.sh'
+    },
+    {
+      type: 'command-intro',
+      command: 'VARIABLE="valor"',
+      description: 'Variables en bash',
+      explanation: 'Puedes guardar valores en variables para reutilizarlos.',
+      example: 'MENSAJE="Salgamos de este laberinto."\necho $MENSAJE',
+      instruction: 'Define con NOMBRE="valor" y usa con $NOMBRE. Sin espacios alrededor del ='
+    },
+    {
+      type: 'command-intro',
+      command: '$(comando)',
+      description: 'Sustitución de comandos',
+      explanation: 'Puedes guardar la salida de un comando en una variable.',
+      example: 'VERSION=$(node -p "require(\'./package.json\').version")\necho "Versión actual: $VERSION"',
+      instruction: 'Todo lo que esté dentro de $() se ejecuta y su resultado se guarda.'
+    },
+    {
+      type: 'command-intro',
+      command: 'IFS',
+      description: 'Dividir strings (Internal Field Separator)',
+      explanation: 'IFS te permite dividir un string en partes usando un delimitador.',
+      example: 'VERSION="1.2.3"\nIFS=\'.\' read -r -a PARTS <<< "$VERSION"\necho ${PARTS[2]}  # imprime: 3',
+      instruction: 'Muy útil para manipular versiones semánticas (major.minor.patch).'
+    },
+    {
+      type: 'command-intro',
+      command: '$((expresión))',
+      description: 'Aritmética en bash',
+      explanation: 'Usa $(( )) para hacer operaciones matemáticas.',
+      example: 'PATCH=3\nNEW_PATCH=$((PATCH + 1))\necho $NEW_PATCH  # imprime: 4',
+      instruction: 'Funciona para sumar, restar, multiplicar y dividir números enteros.'
+    },
+    {
+      type: 'command-intro',
+      command: 'sed',
+      description: 'Reemplazar texto en archivos',
+      explanation: 'sed permite buscar y reemplazar texto dentro de archivos.',
+      example: 'sed -i \'\' "s/viejo/nuevo/" archivo.txt',
+      instruction: 'En macOS usa -i \'\'. En Linux solo -i. Formato: s/buscar/reemplazar/'
+    },
+    {
+      type: 'command-intro',
+      command: 'if [ $? -eq 0 ]',
+      description: 'Condicionales y códigos de salida',
+      explanation: '$? contiene el código de salida del último comando. 0 significa éxito.',
+      example: 'npm publish\nif [ $? -eq 0 ]; then\n  echo "✅ Éxito"\nelse\n  echo "❌ Error"\nfi',
+      instruction: 'Usa if/then/else/fi para tomar decisiones basadas en resultados.'
+    },
+    {
+      type: 'code',
+      title: 'Script completo: deploy-patch.sh',
+      code: `#!/bin/bash
+
+# Obtener versión actual del package.json
+CURRENT_VERSION=$(node -p "require('./package.json').version")
+
+# Dividir la versión en partes (major.minor.patch)
+IFS='.' read -r -a VERSION_PARTS <<< "$CURRENT_VERSION"
+MAJOR="\${VERSION_PARTS[0]}"
+MINOR="\${VERSION_PARTS[1]}"
+PATCH="\${VERSION_PARTS[2]}"
+
+# Incrementar el número de patch
+NEW_PATCH=$((PATCH + 1))
+NEW_VERSION="$MAJOR.$MINOR.$NEW_PATCH"
+
+echo "📦 Bumping version: $CURRENT_VERSION → $NEW_VERSION"
+
+# Actualizar package.json con la nueva versión
+sed -i '' "s/\\"version\\": \\"$CURRENT_VERSION\\"/\\"version\\": \\"$NEW_NEW\\"/" package.json
+
+echo "🚀 Publishing to npm..."
+npm publish
+
+# Verificar si el publish fue exitoso
+if [ $? -eq 0 ]; then
+    echo "✅ Successfully published @icarusmx/creta@$NEW_VERSION"
+else
+    echo "❌ Publish failed, reverting version..."
+    sed -i '' "s/\\"version\\": \\"$NEW_VERSION\\"/\\"version\\": \\"$CURRENT_VERSION\\"/" package.json
+    exit 1
+fi`,
+      after: [
+        '',
+        'Este script automatiza:',
+        '1. Leer la versión actual',
+        '2. Incrementar el patch',
+        '3. Actualizar package.json',
+        '4. Publicar a npm',
+        '5. Revertir si falla'
+      ]
+    },
+    {
+      type: 'maze-completion',
+      message: 'Bash Scripts completado! Ya puedes automatizar tareas.',
+      unlocked: 'Ahora puedes crear tus propias herramientas de automatización.'
+    }
+  ]
+}

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/menus.js

@@ -7,7 +7,9 @@ export const SINTAXIS_MENU_CONFIG = {
   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: '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: '|, >, <, <<<' }
   ]
 }
 

package/lib/executors/sintaxis-executor.js

@@ -3,6 +3,8 @@ import { SINTAXIS_MENU_CONFIG } 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'
+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'
@@ -10,7 +12,9 @@ import { UNLOCK_CONFIG } from '../data/progression.js'
 
 const LESSONS_BY_ID = new Map([
   ['terminal-basico', TERMINAL_BASICO],
-  ['git-basico', GIT_BASICO]
+  ['git-basico', GIT_BASICO],
+  ['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.5",
+  "version": "1.4.7",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {