@icarusmx/creta 1.0.23 → 1.1.0

package/.claude/settings.local.json

@@ -7,7 +7,8 @@
       "Bash(npm install)",
       "Bash(npm run dev:*)",
       "Bash(rm:*)",
-      "Bash(npm publish:*)"
+      "Bash(npm publish:*)",
+      "Bash(npm view:*)"
     ],
     "deny": [],
     "ask": []

package/bin/creta.js

@@ -12,6 +12,7 @@ import { Lesson3OnlyWay } from '../lessons/lesson3-only-way.js'
 import { Lesson4OperationSignatures } from '../lessons/lesson4-operation-signatures.js'
 import { Lesson5InterfaceSet } from '../lessons/lesson5-interface-set.js'
 import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
+import { Lesson7ObjectDefinition } from '../lessons/lesson7-object-definition.js'
 
 const ENUNCIADOS = [
   {
@@ -49,6 +50,12 @@ const ENUNCIADOS = [
     texto: "El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces.",
     nivel: "Diseño",
     enfoque: "Metodología de desarrollo"
+  },
+  {
+    id: 7,
+    texto: "Un objeto es un conjunto de datos y procedimientos que operan sobre esos datos.",
+    nivel: "Definición",
+    enfoque: "Naturaleza del objeto"
   }
 ]
 
@@ -579,8 +586,8 @@ async function unstuckProject(level) {
 
 function showHelp() {
   console.log("\n📚 Comandos disponibles:")
-  console.log("  creta                - Explora los 6 enunciados fundamentales (comando principal) 🧠")
-  console.log("  creta enunciados     - Explora los 6 enunciados fundamentales 🧠")
+  console.log("  creta                - Explora los 7 enunciados fundamentales (comando principal) 🧠")
+  console.log("  creta enunciados     - Explora los 7 enunciados fundamentales 🧠")
   console.log("  creta portafolio     - Crea tu portafolio personal (reto completo)")
   console.log("  creta portafolio-1   - Desbloquea nivel 1 (navbar) 🔓")
   console.log("  creta portafolio-2   - Desbloquea nivel 2 (navbar + hero) 🔓")
@@ -822,8 +829,8 @@ async function startEnunciadosSelectorInteractive() {
       let formattedText = enunciado.texto
       if (enunciado.id === 4) {
         // Special formatting for enunciado 4 with list items
-        formattedText = formattedText.replace(/\n([abc])\)/g, '\n      $1)')
-        formattedText = formattedText.replace(/\n\nEstos tres elementos/g, '\n\n      Estos tres elementos')
+        formattedText = formattedText.replace(/\n([abc])\)/g, '\n         $1)')
+        formattedText = formattedText.replace(/\n\nEstos tres elementos/g, '\n\n         Estos tres elementos')
       }
       console.log(`${highlight}${prefix}${index + 1}. ${formattedText}${reset}`)
       console.log("")
@@ -965,6 +972,22 @@ async function startEnunciadosSelectorInteractive() {
             console.log("- Proyectos específicos para internalizar la idea")
             await returnToMainMenu()
           }
+        } else if (enunciadoSeleccionado.id === 7) {
+          console.log(`${enunciadoSeleccionado.texto}`)
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson7 = new Lesson7ObjectDefinition()
+            await lesson7.start()
+            await returnToMainMenu()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+            await returnToMainMenu()
+          }
         } else {
           console.log("\n🚀 Próximamente:")
           console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
@@ -1028,7 +1051,7 @@ async function startEnunciadosSelectorFallback() {
       console.log("")
     })
 
-    const respuesta = await askQuestion("Elige un número (1-6) o 'q' para salir: ")
+    const respuesta = await askQuestion("Elige un número (1-7) o 'q' para salir: ")
 
     if (respuesta.toLowerCase() === 'q') {
       console.log("¡Hasta la vista! 👋")
@@ -1038,7 +1061,7 @@ async function startEnunciadosSelectorFallback() {
 
     const numeroSeleccionado = parseInt(respuesta)
 
-    if (numeroSeleccionado >= 1 && numeroSeleccionado <= 6) {
+    if (numeroSeleccionado >= 1 && numeroSeleccionado <= 7) {
       const enunciadoSeleccionado = ENUNCIADOS[numeroSeleccionado - 1]
 
       // Check if we have a lesson implementation for this enunciado
@@ -1154,6 +1177,22 @@ async function startEnunciadosSelectorFallback() {
           console.log("- Proyectos específicos para internalizar la idea")
         }
         return
+      } else if (enunciadoSeleccionado.id === 7) {
+        console.log(`${enunciadoSeleccionado.texto}`)
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson7 = new Lesson7ObjectDefinition()
+          await lesson7.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
       } else {
         console.log("\n🚀 Próximamente:")
         console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
@@ -1165,7 +1204,7 @@ async function startEnunciadosSelectorFallback() {
       }
 
     } else {
-      console.log("❌ Opción no válida. Elige un número entre 1 y 6.")
+      console.log("❌ Opción no válida. Elige un número entre 1 y 7.")
     }
 
     rl.close()

package/lessons/lesson7-object-definition.js

@@ -0,0 +1,393 @@
+#!/usr/bin/env node
+
+// LECCIÓN 7: Un objeto es un conjunto de datos y procedimientos que operan sobre esos datos
+// Enfoque práctico: Comparación entre código procedural vs orientado a objetos
+
+import { createInterface } from 'readline'
+
+export class Lesson7ObjectDefinition {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    await this.waitForEnter("\nPresiona Enter para comenzar...")
+
+    await this.practicalExercise()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async practicalExercise() {
+    console.clear()
+    console.log("Exploraremos qué ES un objeto comparando dos enfoques:")
+    console.log("1. Datos separados + funciones sueltas")
+    console.log("2. Objeto = datos + procedimientos unidos")
+
+    await this.waitForEnter("\nPresiona Enter para continuar...")
+
+    await this.step1_ProceduralApproach()
+    await this.step2_ObjectOrientedApproach()
+    await this.step3_ComparisonAndBenefits()
+  }
+
+  async step1_ProceduralApproach() {
+    console.clear()
+    console.log("🔧 Enfoque Procedural: Datos Separados")
+    console.log("=" .repeat(50))
+
+    console.log("\n💳 Ejemplo: Sistema de Cuenta Bancaria")
+    console.log("\n📊 Datos sueltos:")
+
+    const dataCode = `// Datos de la cuenta
+let accountNumber = "001-234567"
+let ownerName = "María González"
+let balance = 5000
+let isActive = true`
+
+    this.printCodeWithColors("Variables globales", dataCode)
+
+    await this.waitForEnter("\nPresiona Enter para ver las funciones...")
+
+    console.log("\n⚙️ Funciones separadas que operan sobre esos datos:")
+
+    const functionsCode = `function deposit(amount) {
+  if (!isActive) {
+    console.log("Cuenta inactiva")
+    return false
+  }
+  if (amount <= 0) {
+    console.log("Cantidad inválida")
+    return false
+  }
+  balance += amount
+  return true
+}
+
+function withdraw(amount) {
+  if (!isActive) return false
+  if (amount <= 0) return false
+  if (amount > balance) {
+    console.log("Fondos insuficientes")
+    return false
+  }
+  balance -= amount
+  return true
+}
+
+function getBalance() {
+  return isActive ? balance : 0
+}
+
+function deactivate() {
+  isActive = false
+}`
+
+    this.printCodeWithColors("Funciones sueltas", functionsCode)
+
+    await this.waitForEnter("\nPresiona Enter para ver el problema...")
+
+    console.clear()
+    console.log("❌ Problemas del enfoque procedural:")
+    console.log("=" .repeat(50))
+
+    console.log("\n1️⃣ Datos expuestos globalmente:")
+    console.log("   • Cualquier código puede modificar 'balance' directamente")
+    console.log("   • No hay protección de los datos")
+
+    console.log("\n2️⃣ Funciones no están vinculadas a datos:")
+    console.log("   • deposit() asume que 'balance' existe")
+    console.log("   • ¿Qué pasa si necesitamos múltiples cuentas?")
+
+    console.log("\n3️⃣ Difícil de escalar:")
+
+    const problemCode = `// ¿Cómo manejamos dos cuentas?
+let balance1 = 5000
+let balance2 = 3000
+let accountNumber1 = "001"
+let accountNumber2 = "002"
+
+// Las funciones solo trabajan con una cuenta
+deposit(100)  // ¿A cuál cuenta?`
+
+    this.printCodeWithColors("Escalabilidad problemática", problemCode)
+
+    await this.waitForEnter("\nPresiona Enter para ver la solución...")
+  }
+
+  async step2_ObjectOrientedApproach() {
+    console.clear()
+    console.log("✨ Enfoque Orientado a Objetos: Datos + Procedimientos")
+    console.log("=" .repeat(50))
+
+    console.log("\n💡 Un objeto AGRUPA datos y procedimientos")
+    console.log("Los datos se convierten en PROPIEDADES")
+    console.log("Los procedimientos se convierten en MÉTODOS")
+
+    await this.waitForEnter("\nPresiona Enter para ver el código...")
+
+    const objectCode = `class BankAccount {
+  // Constructor: inicializa los DATOS del objeto
+  constructor(accountNumber, ownerName, initialBalance) {
+    this.accountNumber = accountNumber
+    this.ownerName = ownerName
+    this.balance = initialBalance
+    this.isActive = true
+  }
+
+  // PROCEDIMIENTOS que operan sobre ESTOS datos específicos
+  deposit(amount) {
+    if (!this.isActive) {
+      console.log("Cuenta inactiva")
+      return false
+    }
+    if (amount <= 0) {
+      console.log("Cantidad inválida")
+      return false
+    }
+    this.balance += amount
+    return true
+  }
+
+  withdraw(amount) {
+    if (!this.isActive) return false
+    if (amount <= 0) return false
+    if (amount > this.balance) {
+      console.log("Fondos insuficientes")
+      return false
+    }
+    this.balance -= amount
+    return true
+  }
+
+  getBalance() {
+    return this.isActive ? this.balance : 0
+  }
+
+  deactivate() {
+    this.isActive = false
+  }
+
+  getAccountInfo() {
+    return {
+      number: this.accountNumber,
+      owner: this.ownerName,
+      balance: this.getBalance(),
+      status: this.isActive ? 'Activa' : 'Inactiva'
+    }
+  }
+}`
+
+    this.printCodeWithColors("Clase BankAccount", objectCode)
+
+    await this.waitForEnter("\nPresiona Enter para ver múltiples instancias...")
+
+    console.clear()
+    console.log("🎯 Múltiples objetos = Múltiples conjuntos de datos")
+    console.log("=" .repeat(50))
+
+    const usageCode = `// Crear múltiples cuentas es simple
+const account1 = new BankAccount("001-234567", "María González", 5000)
+const account2 = new BankAccount("001-789012", "Juan Pérez", 3000)
+
+// Cada objeto tiene SUS PROPIOS datos
+account1.deposit(500)
+account2.withdraw(200)
+
+console.log(account1.getBalance())  // 5500
+console.log(account2.getBalance())  // 2800
+
+// Los procedimientos operan sobre los datos del objeto específico
+account1.deactivate()
+console.log(account1.isActive)  // false
+console.log(account2.isActive)  // true  ← No afectado`
+
+    this.printCodeWithColors("Uso del objeto", usageCode)
+
+    await this.waitForEnter("\nPresiona Enter para ver las ventajas...")
+  }
+
+  async step3_ComparisonAndBenefits() {
+    console.clear()
+    console.log("📊 Comparación Directa")
+    console.log("=" .repeat(50))
+
+    console.log("\n🔴 Enfoque Procedural:")
+    console.log("   Datos: let balance = 5000")
+    console.log("   Procedimiento: function deposit(amount) { balance += amount }")
+    console.log("   ❌ Separados, sin relación formal")
+
+    console.log("\n🟢 Enfoque Orientado a Objetos:")
+    console.log("   Datos: this.balance = 5000")
+    console.log("   Procedimiento: deposit(amount) { this.balance += amount }")
+    console.log("   ✅ Unidos en el MISMO objeto")
+
+    await this.waitForEnter("\nPresiona Enter para ver ejemplo visual...")
+
+    console.clear()
+    console.log("🎨 Visualización del Concepto")
+    console.log("=" .repeat(50))
+
+    console.log("\n┌─────────────────────────────────────┐")
+    console.log("│  OBJETO: account1                   │")
+    console.log("├─────────────────────────────────────┤")
+    console.log("│  DATOS:                             │")
+    console.log("│  • accountNumber = \"001-234567\"     │")
+    console.log("│  • ownerName = \"María González\"     │")
+    console.log("│  • balance = 5000                   │")
+    console.log("│  • isActive = true                  │")
+    console.log("├─────────────────────────────────────┤")
+    console.log("│  PROCEDIMIENTOS:                    │")
+    console.log("│  • deposit(amount)                  │")
+    console.log("│  • withdraw(amount)                 │")
+    console.log("│  • getBalance()                     │")
+    console.log("│  • deactivate()                     │")
+    console.log("└─────────────────────────────────────┘")
+
+    console.log("\n📌 Nota clave:")
+    console.log("Los procedimientos SOLO operan sobre los datos de ESTE objeto")
+    console.log("account1.deposit() modifica account1.balance")
+    console.log("account2.deposit() modifica account2.balance")
+
+    await this.waitForEnter("\nPresiona Enter para ver otro ejemplo...")
+
+    console.clear()
+    console.log("🎮 Ejemplo 2: Sistema de Carrito de Compras")
+    console.log("=" .repeat(50))
+
+    const cartCode = `class ShoppingCart {
+  // DATOS del carrito
+  constructor(userId) {
+    this.userId = userId
+    this.items = []
+    this.totalAmount = 0
+  }
+
+  // PROCEDIMIENTOS que operan sobre estos datos
+  addItem(product, quantity) {
+    const item = { product, quantity, price: product.price * quantity }
+    this.items.push(item)
+    this.totalAmount += item.price
+  }
+
+  removeItem(productId) {
+    const itemIndex = this.items.findIndex(i => i.product.id === productId)
+    if (itemIndex > -1) {
+      this.totalAmount -= this.items[itemIndex].price
+      this.items.splice(itemIndex, 1)
+    }
+  }
+
+  getTotal() {
+    return this.totalAmount
+  }
+
+  getItemCount() {
+    return this.items.reduce((sum, item) => sum + item.quantity, 0)
+  }
+
+  clear() {
+    this.items = []
+    this.totalAmount = 0
+  }
+}
+
+// Uso
+const cart = new ShoppingCart("user123")
+cart.addItem({ id: 1, name: "Libro", price: 299 }, 2)
+cart.addItem({ id: 2, name: "Café", price: 85 }, 1)
+
+console.log(cart.getTotal())      // 683
+console.log(cart.getItemCount())  // 3`
+
+    this.printCodeWithColors("Clase ShoppingCart", cartCode)
+
+    await this.waitForEnter("\nPresiona Enter para la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 Conclusión: Definición del Objeto")
+    console.log("=" .repeat(50))
+
+    console.log("\n💎 Enunciado fundamental:")
+    console.log("'Un objeto es un conjunto de datos y procedimientos")
+    console.log(" que operan sobre esos datos'")
+
+    console.log("\n🔍 Desglose:")
+    console.log("1️⃣ CONJUNTO → agrupación unificada")
+    console.log("2️⃣ DATOS → propiedades del objeto (this.property)")
+    console.log("3️⃣ PROCEDIMIENTOS → métodos del objeto")
+    console.log("4️⃣ OPERAN SOBRE → los métodos modifican/leen las propiedades")
+
+    console.log("\n✅ Ventajas demostradas:")
+    console.log("• Encapsulación: datos y operaciones juntos")
+    console.log("• Modularidad: cada objeto es independiente")
+    console.log("• Escalabilidad: múltiples instancias fácilmente")
+    console.log("• Organización: responsabilidades claras")
+
+    console.log("\n📚 Ejemplos vistos:")
+    console.log("• BankAccount: balance + deposit/withdraw")
+    console.log("• ShoppingCart: items + addItem/removeItem")
+
+    console.log("\n🔗 Conexión con otros enunciados:")
+    console.log("• Enunciado 1: Estos objetos son los que descomponemos del sistema")
+    console.log("• Enunciado 2: Estos objetos interactúan mediante solicitudes")
+    console.log("• Enunciado 5: La interfaz expone los procedimientos disponibles")
+
+    console.log("\n💭 Reflexión:")
+    console.log("Antes de diseñar cómo los objetos interactúan,")
+    console.log("debemos entender QUÉ ES un objeto:")
+    console.log("datos + procedimientos, unidos e inseparables.")
+
+    await this.waitForEnter("\n✨ ¡Lección 7 completada! Presiona Enter para continuar...")
+  }
+
+  formatCode(code) {
+    const colors = {
+      keyword: '\x1b[35m',
+      property: '\x1b[32m',
+      string: '\x1b[33m',
+      comment: '\x1b[90m',
+      reset: '\x1b[0m'
+    }
+
+    return code
+      .replace(/\b(class|constructor|return|if|const|let|new|function)\b/g, `${colors.keyword}$1${colors.reset}`)
+      .replace(/\bthis\./g, `${colors.property}this.${colors.reset}`)
+      .replace(/'([^']*)'/g, `${colors.string}'$1'${colors.reset}`)
+      .replace(/"([^"]*)"/g, `${colors.string}"$1"${colors.reset}`)
+      .replace(/\/\/.*$/gm, `${colors.comment}$&${colors.reset}`)
+  }
+
+  printCodeWithColors(title, code) {
+    console.log(`\n${title}`)
+    console.log("━".repeat(50))
+
+    code.split('\n').forEach(line => {
+      const formattedLine = this.formatCode(line)
+      console.log(formattedLine)
+    })
+
+    console.log("━".repeat(50))
+  }
+
+  async waitForEnter(message) {
+    return new Promise((resolve) => {
+      this.rl.question(message, () => {
+        console.log("\n\n")
+        resolve()
+      })
+    })
+  }
+}
+
+// Para usar la lección independientemente
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const lesson = new Lesson7ObjectDefinition()
+  await lesson.start()
+}

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@icarusmx/creta",
-  "version": "1.0.23",
+  "version": "1.1.0",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {
     "creta": "./bin/creta.js"
   },
-  "keywords": ["cli", "icarus", "creta", "scythe", "software school"],
+  "keywords": [
+    "cli",
+    "icarus",
+    "creta",
+    "scythe",
+    "software school"
+  ],
   "author": "Guillermo Rodríguez López",
-  "publishConfig": { "access": "public" },
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT",
   "dependencies": {
     "chalk": "^5.3.0",