@icarusmx/creta 1.1.1 → 1.2.0

package/lessons/lesson7-object-definition.js

@@ -1,7 +1,7 @@
 #!/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
+// Enfoque conceptual: Entender qué es un dato, qué es un procedimiento, y por qué están unidos
 
 import { createInterface } from 'readline'
 
@@ -16,369 +16,277 @@ export class Lesson7ObjectDefinition {
   async start() {
     await this.waitForEnter("\nPresiona Enter para comenzar...")
 
-    await this.practicalExercise()
+    await this.conceptualExercise()
     await this.conclusion()
 
     this.rl.close()
   }
 
-  async practicalExercise() {
+  async conceptualExercise() {
     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")
+    console.log("Para entender qué ES un objeto,")
+    console.log("primero debemos entender dos conceptos fundamentales:")
+    console.log("")
+    console.log("1. ¿Qué es un DATO?")
+    console.log("2. ¿Qué es un PROCEDIMIENTO?")
 
     await this.waitForEnter("\nPresiona Enter para continuar...")
 
-    await this.step1_ProceduralApproach()
-    await this.step2_ObjectOrientedApproach()
-    await this.step3_ComparisonAndBenefits()
+    await this.step1_WhatIsData()
+    await this.step2_WhatIsProcedure()
+    await this.step3_WhyTogether()
+    await this.step4_ObjectDefinition()
   }
 
-  async step1_ProceduralApproach() {
+  async step1_WhatIsData() {
     console.clear()
-    console.log("🔧 Enfoque Procedural: Datos Separados")
+    console.log("¿Qué es un DATO?")
     console.log("=" .repeat(50))
 
-    console.log("\n💳 Ejemplo: Sistema de Cuenta Bancaria")
-    console.log("\n📊 Datos sueltos:")
+    console.log("\n🔍 Un dato es información que describe el estado de algo")
 
-    const dataCode = `// Datos de la cuenta
-let accountNumber = "001-234567"
-let ownerName = "María González"
-let balance = 5000
-let isActive = true`
+    await this.waitForEnter("\nPresiona Enter para ver ejemplos conceptuales...")
 
-    this.printCodeWithColors("Variables globales", dataCode)
+    console.log("\n📦 Ejemplos de datos:")
+    console.log("")
+    console.log("• El saldo de una cuenta")
+    console.log("  → Este número describe cuánto dinero hay")
+    console.log("")
+    console.log("• El nombre de un usuario")
+    console.log("  → Este texto describe quién es")
+    console.log("")
+    console.log("• El estado de una puerta (abierta/cerrada)")
+    console.log("  → Este valor describe la condición actual")
+    console.log("")
+    console.log("• La lista de productos en un carrito")
+    console.log("  → Esta colección describe qué contiene")
 
-    await this.waitForEnter("\nPresiona Enter para ver las funciones...")
-
-    console.log("\n⚙️ Funciones separadas que operan sobre esos datos:")
+    await this.waitForEnter("\nPresiona Enter para continuar...")
 
-    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
-}
+    console.log("\n💡 Característica clave de los datos:")
+    console.log("Los datos DESCRIBEN, no HACEN nada por sí mismos")
+    console.log("")
+    console.log("El saldo de 5000 no se deposita solo")
+    console.log("El nombre 'María' no se cambia solo")
+    console.log("La puerta cerrada no se abre sola")
+    console.log("")
+    console.log("Los datos son PASIVOS. Solo representan información.")
 
-function withdraw(amount) {
-  if (!isActive) return false
-  if (amount <= 0) return false
-  if (amount > balance) {
-    console.log("Fondos insuficientes")
-    return false
+    await this.waitForEnter("\nPresiona Enter para ver qué es un procedimiento...")
   }
-  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...")
 
+  async step2_WhatIsProcedure() {
     console.clear()
-    console.log("❌ Problemas del enfoque procedural:")
+    console.log("¿Qué es un PROCEDIMIENTO?")
     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:")
+    console.log("\n🔍 Un procedimiento es una secuencia de pasos que MODIFICA o LEE datos")
 
-    const problemCode = `// ¿Cómo manejamos dos cuentas?
-let balance1 = 5000
-let balance2 = 3000
-let accountNumber1 = "001"
-let accountNumber2 = "002"
+    await this.waitForEnter("\nPresiona Enter para ver ejemplos conceptuales...")
 
-// Las funciones solo trabajan con una cuenta
-deposit(100)  // ¿A cuál cuenta?`
+    console.log("\n⚙️ Ejemplos de procedimientos:")
+    console.log("")
+    console.log("• Depositar dinero en una cuenta")
+    console.log("  → MODIFICA el dato 'saldo' sumándole una cantidad")
+    console.log("")
+    console.log("• Cambiar el nombre de un usuario")
+    console.log("  → MODIFICA el dato 'nombre' asignándole un nuevo valor")
+    console.log("")
+    console.log("• Abrir una puerta")
+    console.log("  → MODIFICA el dato 'estado' de 'cerrada' a 'abierta'")
+    console.log("")
+    console.log("• Consultar el saldo")
+    console.log("  → LEE el dato 'saldo' sin modificarlo")
 
-    this.printCodeWithColors("Escalabilidad problemática", problemCode)
+    await this.waitForEnter("\nPresiona Enter para continuar...")
 
-    await this.waitForEnter("\nPresiona Enter para ver la solución...")
+    console.log("\n💡 Característica clave de los procedimientos:")
+    console.log("Los procedimientos son ACTIVOS. Hacen algo con los datos.")
+    console.log("")
+    console.log("Un procedimiento sin datos no tiene sentido:")
+    console.log("  • ¿Depositar en dónde?")
+    console.log("  • ¿Cambiar qué nombre?")
+    console.log("  • ¿Abrir cuál puerta?")
+    console.log("")
+    console.log("Los procedimientos NECESITAN datos para operar")
+
+    await this.waitForEnter("\nPresiona Enter para ver por qué están unidos...")
   }
 
-  async step2_ObjectOrientedApproach() {
+  async step3_WhyTogether() {
     console.clear()
-    console.log("✨ Enfoque Orientado a Objetos: Datos + Procedimientos")
+    console.log("¿Por qué DATOS y PROCEDIMIENTOS están JUNTOS?")
     console.log("=" .repeat(50))
 
-    console.log("\n💡 Un objeto AGRUPA datos y procedimientos")
-    console.log("Los datos quedan unidos con sus procedimientos")
+    console.log("\n🤔 La pregunta fundamental:")
+    console.log("Si los datos describen el estado,")
+    console.log("y los procedimientos modifican ese estado,")
+    console.log("¿no deberían estar relacionados?")
 
-    await this.waitForEnter("\nPresiona Enter para ver el código...")
+    await this.waitForEnter("\nPresiona Enter para ver la respuesta...")
 
-    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
-  }
+    console.log("\n✨ La respuesta: EL OBJETO")
+    console.log("")
+    console.log("Un objeto es la unión natural de:")
+    console.log("  • Los datos que describen SU estado")
+    console.log("  • Los procedimientos que operan sobre ESE estado")
 
-  // 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
-  }
+    await this.waitForEnter("\nPresiona Enter para ver un ejemplo conceptual...")
 
-  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
-  }
+    console.log("\n📍 Ejemplo conceptual: Una cuenta bancaria")
+    console.log("")
+    console.log("┌─────────────────────────────────────┐")
+    console.log("│  OBJETO: Cuenta                     │")
+    console.log("├─────────────────────────────────────┤")
+    console.log("│  DATOS (estado):                    │")
+    console.log("│  • saldo                            │")
+    console.log("│  • titular                          │")
+    console.log("│  • activa                           │")
+    console.log("├─────────────────────────────────────┤")
+    console.log("│  PROCEDIMIENTOS (operaciones):      │")
+    console.log("│  • depositar                        │")
+    console.log("│  • retirar                          │")
+    console.log("│  • consultarSaldo                   │")
+    console.log("│  • desactivar                       │")
+    console.log("└─────────────────────────────────────┘")
 
-  getBalance() {
-    return this.isActive ? this.balance : 0
-  }
+    await this.waitForEnter("\nPresiona Enter para continuar...")
 
-  deactivate() {
-    this.isActive = false
-  }
+    console.log("\n🔗 La relación esencial:")
+    console.log("")
+    console.log("• 'depositar' opera sobre 'saldo'")
+    console.log("  → No tiene sentido depositar sin un saldo que modificar")
+    console.log("")
+    console.log("• 'desactivar' opera sobre 'activa'")
+    console.log("  → No tiene sentido desactivar sin un estado que cambiar")
+    console.log("")
+    console.log("• 'consultarSaldo' lee 'saldo'")
+    console.log("  → No tiene sentido consultar sin un saldo que leer")
 
-  getAccountInfo() {
-    return {
-      number: this.accountNumber,
-      owner: this.ownerName,
-      balance: this.getBalance(),
-      status: this.isActive ? 'Activa' : 'Inactiva'
-    }
-  }
-}`
+    await this.waitForEnter("\nPresiona Enter para continuar...")
 
-    this.printCodeWithColors("Clase BankAccount", objectCode)
+    console.log("\n💭 La intuición:")
+    console.log("Los datos y los procedimientos están ATADOS entre sí")
+    console.log("")
+    console.log("No existen datos sin procedimientos que los manipulen")
+    console.log("No existen procedimientos sin datos sobre los que operen")
+    console.log("")
+    console.log("Esta unión es lo que llamamos: OBJETO")
 
-    await this.waitForEnter("\nPresiona Enter para ver múltiples instancias...")
+    await this.waitForEnter("\nPresiona Enter para ver la definición completa...")
+  }
 
+  async step4_ObjectDefinition() {
     console.clear()
-    console.log("🎯 Múltiples objetos = Múltiples conjuntos de datos")
+    console.log("La Definición Completa")
     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)
+    console.log("\n💎 'Un objeto es un conjunto de datos y procedimientos")
+    console.log("    que operan sobre esos datos'")
 
-// Cada objeto tiene SUS PROPIOS datos
-account1.deposit(500)
-account2.withdraw(200)
+    await this.waitForEnter("\nPresiona Enter para desglosar la definición...")
 
-console.log(account1.getBalance())  // 5500
-console.log(account2.getBalance())  // 2800
+    console.log("\n🔍 Desglose de la definición:")
+    console.log("")
+    console.log("1️⃣ 'Un objeto es un CONJUNTO'")
+    console.log("   → No es un solo elemento, es una agrupación")
+    console.log("   → Datos y procedimientos forman una unidad")
+    console.log("")
 
-// Los procedimientos operan sobre los datos del objeto específico
-account1.deactivate()
-console.log(account1.isActive)  // false
-console.log(account2.isActive)  // true  ← No afectado`
+    await this.waitForEnter("Presiona Enter para continuar...")
 
-    this.printCodeWithColors("Uso del objeto", usageCode)
+    console.log("2️⃣ '...de DATOS'")
+    console.log("   → Información que describe el estado del objeto")
+    console.log("   → Valores que representan lo que el objeto 'es'")
+    console.log("   → PASIVOS: no hacen nada por sí mismos")
+    console.log("")
 
-    await this.waitForEnter("\nPresiona Enter para ver las ventajas...")
-  }
+    await this.waitForEnter("Presiona Enter para continuar...")
 
-  async step3_ComparisonAndBenefits() {
-    console.clear()
-    console.log("📊 Comparación Directa")
-    console.log("=" .repeat(50))
+    console.log("3️⃣ '...y PROCEDIMIENTOS'")
+    console.log("   → Secuencias de pasos que modifican o leen datos")
+    console.log("   → Operaciones que representan lo que el objeto 'hace'")
+    console.log("   → ACTIVOS: transforman el estado")
+    console.log("")
 
-    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")
+    await this.waitForEnter("Presiona Enter para continuar...")
 
-    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")
+    console.log("4️⃣ '...que OPERAN SOBRE esos datos'")
+    console.log("   → Los procedimientos NO operan sobre datos ajenos")
+    console.log("   → Solo modifican/leen los datos del MISMO objeto")
+    console.log("   → Esta es la relación fundamental")
 
-    await this.waitForEnter("\nPresiona Enter para ver ejemplo visual...")
+    await this.waitForEnter("\nPresiona Enter para ver por qué esto importa...")
 
     console.clear()
-    console.log("🎨 Visualización del Concepto")
+    console.log("¿Por qué esta definición es fundamental?")
     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)
+    console.log("\n🎯 Sin entender qué ES un objeto,")
+    console.log("   no podemos entender los otros 6 enunciados:")
+    console.log("")
+    console.log("• Enunciado 1: ¿Cómo descomponemos en objetos")
+    console.log("              si no sabemos qué es un objeto?")
+    console.log("")
+    console.log("• Enunciado 2: ¿Cómo interactúan los objetos")
+    console.log("              si no entendemos su naturaleza?")
+    console.log("")
+    console.log("• Enunciado 3: ¿Por qué solicitudes son la única forma")
+    console.log("              de invocar procedimientos?")
+    console.log("")
+    console.log("• Enunciado 4: ¿Qué firmas tienen las operaciones")
+    console.log("              (los procedimientos) del objeto?")
+    console.log("")
+    console.log("• Enunciado 5: ¿Qué es la interfaz del objeto")
+    console.log("              sino el conjunto de sus operaciones?")
+    console.log("")
+    console.log("• Enunciado 6: ¿Por qué diseñar las interfaces primero")
+    console.log("              si no sabemos que exponen operaciones?")
 
     await this.waitForEnter("\nPresiona Enter para la conclusión...")
   }
 
   async conclusion() {
     console.clear()
-    console.log("🎓 Conclusión: Definición del Objeto")
+    console.log("🎓 Conclusión: La Naturaleza 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 → información del objeto (this.balance, this.name)")
-    console.log("3️⃣ PROCEDIMIENTOS → funciones del objeto (deposit, withdraw)")
-    console.log("4️⃣ OPERAN SOBRE → los procedimientos modifican/leen los datos")
-
-    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.")
+    console.log("\n📌 Lo que aprendimos:")
+    console.log("")
+    console.log("1. Un DATO describe el estado (información pasiva)")
+    console.log("2. Un PROCEDIMIENTO modifica o lee datos (acción activa)")
+    console.log("3. Un OBJETO une datos con sus procedimientos")
+    console.log("4. Esta unión no es arbitraria, es esencial")
+
+    console.log("\n💡 La intuición central:")
+    console.log("")
+    console.log("Los datos no existen aislados")
+    console.log("Los procedimientos no operan en el vacío")
+    console.log("El objeto es la unión natural de ambos")
+
+    console.log("\n🔗 Conexión con el resto del paradigma:")
+    console.log("")
+    console.log("Ahora que sabemos QUÉ es un objeto,")
+    console.log("podemos entender:")
+    console.log("  • Cómo descomponerlos (enunciado 1)")
+    console.log("  • Cómo se comunican (enunciados 2, 3)")
+    console.log("  • Cómo se diseñan (enunciados 4, 5, 6)")
+
+    console.log("\n💭 Reflexión final:")
+    console.log("")
+    console.log("Antes de diseñar sistemas orientados a objetos,")
+    console.log("debemos entender la naturaleza fundamental del objeto:")
+    console.log("")
+    console.log("  'Un conjunto de datos y procedimientos")
+    console.log("   que operan sobre esos datos'")
 
     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")
+        console.log("\n")
         resolve()
       })
     })

package/package.json

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