@icarusmx/creta 1.3.4 → 1.4.0

package/lessons/lesson5-interface-set.js

@@ -1,326 +0,0 @@
-#!/usr/bin/env node
-
-// LECCIÓN 5: La interfaz de un objeto es el conjunto de todas sus firmas de operación
-// Enfoque práctico: Demostrar cómo las firmas individuales forman una interfaz coherente
-
-import { createInterface } from 'readline'
-
-export class Lesson5InterfaceSet {
-  constructor() {
-    this.rl = createInterface({
-      input: process.stdin,
-      output: process.stdout
-    })
-  }
-
-  async start() {
-    console.log("\n💡 ¿Qué significa esto?")
-    console.log("- Una interfaz NO es una sola operación")
-    console.log("- Es el CONJUNTO COMPLETO de todas las firmas")
-    console.log("- Define TODO lo que el objeto puede hacer")
-    console.log("- Es el 'contrato público' del objeto")
-
-    await this.waitForEnter("\nPresiona Enter para comenzar con ejemplos prácticos...")
-
-    await this.practicalExercise()
-    await this.conclusion()
-
-    this.rl.close()
-  }
-
-  async practicalExercise() {
-    console.clear()
-    console.log("🛠️ EJERCICIO PRÁCTICO: Reproductor de Música")
-    console.log("=" .repeat(50))
-    console.log("🎯 Vamos a construir una interfaz completa paso a paso")
-    console.log("\nSistema: Reproductor de música digital")
-    console.log("Objeto: MusicPlayer")
-
-    await this.waitForEnter("\nPresiona Enter para ver cómo NO diseñar una interfaz...")
-
-    await this.step1_IncompleteInterface()
-    await this.step2_CompleteInterface()
-    await this.step3_InterfaceCoherence()
-    await this.step4_InterfaceUsage()
-  }
-
-  async step1_IncompleteInterface() {
-    console.clear()
-    console.log("❌ INTERFAZ INCOMPLETA")
-    console.log("=" .repeat(30))
-    console.log("Veamos un objeto con interfaz parcial:")
-
-    console.log("\n🚫 PROBLEMA: Solo algunas operaciones definidas")
-    console.log(`class MusicPlayer {
-  // ✅ Operación bien definida
-  play(songId: string): boolean {
-    // implementación...
-  }
-
-  // ❌ Otras operaciones sin firma clara
-  stop() {
-    // ¿Qué devuelve? ¿Puede fallar?
-  }
-
-  volume(level) {
-    // ¿Qué tipo es level? ¿Qué rango?
-  }
-
-  // ❌ Operaciones faltantes
-  // ¿Cómo pauso? ¿Cómo cambio de canción?
-  // ¿Cómo consulto qué está sonando?
-}`)
-
-    console.log("\n💥 Problemas de interfaz incompleta:")
-    console.log("• Imposible predecir qué operaciones están disponibles")
-    console.log("• Firmas inconsistentes entre operaciones")
-    console.log("• Funcionalidad básica faltante")
-    console.log("• Colaboración con otros objetos impredecible")
-
-    await this.waitForEnter("\nPresiona Enter para ver otro problema...")
-
-    console.log("\n🚫 PROBLEMA: Firmas sin relación")
-    console.log(`class BadMusicPlayer {
-  // ❌ Firmas que no forman un conjunto coherente
-  startMusic(file: string): void          // Usa archivos
-  playTrack(id: number): boolean          // Usa IDs numéricos
-  beginSong(song: object): string         // Usa objetos
-
-  setVol(x: number): void                 // Volumen sin validación
-  adjustAudio(level: string): boolean     // Volumen como string??
-
-  getCurrentStatus(): any                 // Retorna 'any' (inútil)
-  getInfo(): string                       // Retorna string (ambiguo)
-}`)
-
-    console.log("\n📉 Resultado:")
-    console.log("No es una interfaz, es una colección caótica de operaciones")
-    console.log("sin relación ni coherencia entre sí.")
-
-    await this.waitForEnter("\nPresiona Enter para ver cómo debe ser...")
-  }
-
-  async step2_CompleteInterface() {
-    console.clear()
-    console.log("✅ INTERFAZ COMPLETA Y COHERENTE")
-    console.log("=" .repeat(40))
-    console.log("Veamos una interfaz bien diseñada:")
-
-    console.log("\n🎵 CONJUNTO COMPLETO de firmas de operación:")
-    console.log(`interface MusicPlayerInterface {
-  // 🎮 GRUPO: Control de reproducción
-  play(songId: string): Promise<{success: boolean, message: string}>
-  pause(): Promise<{success: boolean, currentPosition: number}>
-  stop(): Promise<{success: boolean}>
-  resume(): Promise<{success: boolean, message: string}>
-
-  // 🔊 GRUPO: Control de audio
-  setVolume(level: number): {success: boolean, currentVolume: number}  // 0-100
-  getVolume(): number
-  mute(): {success: boolean, previousVolume: number}
-  unmute(): {success: boolean, restoredVolume: number}
-
-  // 📋 GRUPO: Gestión de playlist
-  addSong(song: Song): {success: boolean, playlistLength: number}
-  removeSong(songId: string): {success: boolean, wasPlaying: boolean}
-  getPlaylist(): Song[]
-  shufflePlaylist(): {success: boolean, newOrder: string[]}
-
-  // 📊 GRUPO: Información de estado
-  getCurrentSong(): Song | null
-  getPlaybackStatus(): {
-    isPlaying: boolean,
-    isPaused: boolean,
-    currentTime: number,
-    totalTime: number,
-    volume: number
-  }
-  getDuration(songId: string): number | null
-
-  // ⚙️ GRUPO: Configuración
-  setRepeatMode(mode: 'none' | 'one' | 'all'): boolean
-  getRepeatMode(): 'none' | 'one' | 'all'
-  setShuffleMode(enabled: boolean): boolean
-  isShuffleEnabled(): boolean
-}`)
-
-    await this.waitForEnter("\nPresiona Enter para analizar esta interfaz...")
-
-    console.log("\n🔍 ANÁLISIS del conjunto:")
-    console.log("\n1️⃣ COMPLETITUD:")
-    console.log("   • Todas las operaciones necesarias están presentes")
-    console.log("   • No hay funcionalidad faltante básica")
-    console.log("   • Cubre todo el comportamiento esperado")
-
-    console.log("\n2️⃣ COHERENCIA:")
-    console.log("   • Todas las firmas usan tipos consistentes")
-    console.log("   • Patrones de retorno consistentes")
-    console.log("   • Nomenclatura uniforme")
-
-    console.log("\n3️⃣ ORGANIZACIÓN:")
-    console.log("   • Operaciones agrupadas por funcionalidad")
-    console.log("   • Cada grupo tiene propósito claro")
-    console.log("   • Fácil de entender y recordar")
-
-    await this.waitForEnter("\nPresiona Enter para ver la implementación...")
-  }
-
-  async step3_InterfaceCoherence() {
-    console.clear()
-    console.log("🧩 COHERENCIA DE LA INTERFAZ")
-    console.log("=" .repeat(35))
-    console.log("Veamos cómo las firmas forman un conjunto coherente:")
-
-    console.log("\n📏 CONSISTENCIA EN TIPOS:")
-    console.log(`// ✅ Todas las operaciones de canciones usan string
-play(songId: string)
-removeSong(songId: string)
-getDuration(songId: string)
-
-// ✅ Todas las operaciones de volumen usan number (0-100)
-setVolume(level: number)        // 0-100
-getVolume(): number            // 0-100
-mute(): {previousVolume: number}  // 0-100`)
-
-    console.log("\n🔄 CONSISTENCIA EN PATRONES:")
-    console.log(`// ✅ Operaciones de configuración siguen patrón set/get
-setRepeatMode(mode) / getRepeatMode()
-setShuffleMode(enabled) / isShuffleEnabled()
-setVolume(level) / getVolume()
-
-// ✅ Operaciones de estado siguen patrón de objeto estructurado
-getPlaybackStatus(): {isPlaying, isPaused, currentTime, ...}
-pause(): {success, currentPosition}
-mute(): {success, previousVolume}`)
-
-    console.log("\n🎯 COMPLETITUD FUNCIONAL:")
-    console.log(`// ✅ Para cada acción, hay su contraparte
-play() ↔ pause() ↔ stop() ↔ resume()
-mute() ↔ unmute()
-addSong() ↔ removeSong()
-
-// ✅ Para cada operación de cambio, hay consulta
-setVolume() → getVolume()
-setRepeatMode() → getRepeatMode()`)
-
-    await this.waitForEnter("\nPresiona Enter para ver cómo se usa...")
-  }
-
-  async step4_InterfaceUsage() {
-    console.clear()
-    console.log("🎭 DEMOSTRACIÓN: Uso de Interfaz Completa")
-    console.log("=" .repeat(45))
-    console.log("Veamos cómo se usa una interfaz bien diseñada:")
-
-    console.log("\n// Crear reproductor")
-    console.log("const player = new MusicPlayer()")
-    console.log("")
-    console.log("// 🎵 Usar GRUPO de reproducción")
-    console.log("const song = new Song('123', 'Bohemian Rhapsody', 'Queen')")
-    console.log("await player.addSong(song)")
-    console.log("")
-    console.log("const playResult = await player.play('123')")
-    console.log("if (playResult.success) {")
-    console.log("  console.log('Reproduciendo:', playResult.message)")
-    console.log("}")
-
-    await this.waitForEnter("\nPresiona Enter para ver más uso...")
-
-    console.log("\n// 🔊 Usar GRUPO de audio")
-    console.log("const volumeResult = player.setVolume(75)")
-    console.log("console.log('Volumen actual:', volumeResult.currentVolume)")
-    console.log("")
-    console.log("// 📊 Usar GRUPO de información")
-    console.log("const status = player.getPlaybackStatus()")
-    console.log("console.log(`Reproduciendo: ${status.isPlaying}`)")
-    console.log("console.log(`Tiempo: ${status.currentTime}/${status.totalTime}`)")
-    console.log("console.log(`Volumen: ${status.volume}`)")
-
-    await this.waitForEnter("\nPresiona Enter para ver uso avanzado...")
-
-    console.log("\n// 🎮 Combinando múltiples grupos")
-    console.log("async function createMusicSession() {")
-    console.log("  // Configurar reproductor")
-    console.log("  player.setRepeatMode('all')")
-    console.log("  player.setShuffleMode(true)")
-    console.log("  player.setVolume(60)")
-    console.log("  ")
-    console.log("  // Agregar canciones")
-    console.log("  const songs = ['123', '456', '789']")
-    console.log("  for (const songId of songs) {")
-    console.log("    await player.addSong(getSong(songId))")
-    console.log("  }")
-    console.log("  ")
-    console.log("  // Iniciar reproducción")
-    console.log("  await player.play(songs[0])")
-    console.log("  ")
-    console.log("  // Monitorear estado cada segundo")
-    console.log("  setInterval(() => {")
-    console.log("    const status = player.getPlaybackStatus()")
-    console.log("    updateUI(status)")
-    console.log("  }, 1000)")
-    console.log("}")
-
-    console.log("\n🌟 Beneficios observados:")
-    console.log("• Cada operación se complementa con las demás")
-    console.log("• Podemos crear flujos complejos combinando firmas")
-    console.log("• La interfaz completa permite cualquier funcionalidad")
-    console.log("• El conjunto es mayor que la suma de sus partes")
-
-    await this.waitForEnter("\nPresiona Enter para la conclusión...")
-  }
-
-  async conclusion() {
-    console.clear()
-    console.log("🎓 CONCLUSIÓN: Interfaz como Conjunto de Firmas")
-    console.log("=" .repeat(50))
-    console.log("🎯 Hemos demostrado que:")
-
-    console.log("\n1️⃣ Una interfaz es el CONJUNTO COMPLETO de firmas")
-    console.log("2️⃣ No es una operación individual, sino TODAS juntas")
-    console.log("3️⃣ Las firmas deben ser coherentes entre sí")
-    console.log("4️⃣ El conjunto debe cubrir toda la funcionalidad necesaria")
-
-    console.log("\n🧩 Características de una buena interfaz:")
-    console.log("• COMPLETITUD - todas las operaciones necesarias")
-    console.log("• COHERENCIA - tipos y patrones consistentes")
-    console.log("• ORGANIZACIÓN - agrupación lógica de funcionalidades")
-    console.log("• PREDICTIBILIDAD - comportamiento uniforme")
-
-    console.log("\n🎯 La interfaz como contrato:")
-    console.log("• Define TODO lo que el objeto puede hacer")
-    console.log("• Especifica exactamente cómo interactuar")
-    console.log("• Garantiza comportamiento predecible")
-    console.log("• Permite colaboración confiable")
-
-    console.log("\n📚 Conexión con otras lecciones:")
-    console.log("• Lección 1-3: Los objetos necesitan interfaces para interactuar")
-    console.log("• Lección 4: Cada operación de la interfaz tiene firma completa")
-    console.log("• Lección 5: ✅ La interfaz es el conjunto de TODAS las firmas")
-    console.log("• Lección 6: El énfasis debe estar en diseñar este conjunto")
-
-    console.log("\n💭 Reflexión:")
-    console.log("Imagina un control remoto que solo tuviera algunos botones:")
-    console.log("play pero no pause, volumen+ pero no volumen-. ¡Sería inútil!")
-    console.log("Las interfaces necesitan ser conjuntos completos y coherentes.")
-
-    console.log("\n🏆 Ahora entiendes qué es realmente una interfaz:")
-    console.log("el conjunto completo de todas las firmas de operación.")
-
-    await this.waitForEnter("\n✨ ¡Lección 5 completada! Presiona Enter para salir...")
-  }
-
-  async waitForEnter(message) {
-    return new Promise((resolve) => {
-      this.rl.question(message, () => {
-        resolve()
-      })
-    })
-  }
-}
-
-// Para usar la lección independientemente
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const lesson = new Lesson5InterfaceSet()
-  await lesson.start()
-}