@icarusmx/creta 1.3.4 → 1.3.5

package/lib/data/lessons/lesson5-interface-set.js

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