# Mejoras de la versión 16

## Uso

- **Aprende paso a paso**: elige fases o eclipse. La escena espacial se centra temporalmente en Sol, Tierra y Luna. Abre **Ver cómo llega la luz** para ver un esquema explicativo. El cielo desde tu ciudad sigue siendo opcional debajo del visor.
- **Viñetas numeradas**: salta a cualquier paso; el activo se destaca en morado y el pendiente, si tarda, en dorado. Anterior/Siguiente siguen disponibles. Salir y volver recupera tu escena previa; Seguir explorando conserva el instante actual. Elegir un destino externo termina el recorrido.
- **Sistema completo → Lunas**: Ío, Europa, Ganímedes y Calisto muestran su propia tarjeta, diámetro, período y distancias a Júpiter y al Sol. Activa **Ejes y observación** para ver eje, polos y ecuador en las lunas. Conocer este astro abre sus detalles.
- **¿Qué estoy viendo?**, bajo el visor: explicación del encuadre, iluminación y dirección del Sol respecto a tu cámara. Abre Datos y cómo se representa para ver fecha UTC, reloj, escala y límites. No cambia cámara ni tiempo.

## Código modular

| Archivo | Responsabilidad |
| --- | --- |
| js/leccion-escena.js | Aislamiento temporal de astros y esquemas opcionales de fases/sombra. |
| css/leccion-escena.css | Presentación del esquema y ocultación de rótulos ajenos durante lecciones. |
| js/experiencias.js y css/leccion.css | Pasos directos, estado aplicado/pendiente y controles del recorrido. |
| js/que-veo.js y css/que-veo.css | Ayuda contextual plegable y datos del encuadre. |
| js/jupiter.js | Guías de las cuatro lunas y sus detalles; reutiliza el cálculo existente. |
| js/astro-actual.js | Miniatura Canvas2D propia y lectura física de cada luna, incluida sombra joviana. |
| js/interfaz.js, js/estado.js, js/principal.js | Conexión de destinos, lecciones, reloj y restauración sin cerrar recorridos por sus cambios internos. |

## Datos y límites

Las posiciones y la iluminación se calculan para la fecha simulada; los mapas son históricos. La orientación de las lunas jovianas es una aproximación síncrona basada en posición y velocidad orbital, no una solución completa de libraciones. Las guías comparten esa orientación.

Los esquemas educativos acortan las distancias para que se entiendan. La sección de umbra/penumbra y el desplazamiento lunar se obtienen de radios y posiciones físicos, sin refracción atmosférica. El brillo rojizo del eclipse es ilustrativo. Ocultar astros durante una lección no cambia sus efemérides ni las capas guardadas.

La explicación de luz usa el vector físico hacia el Sol transformado a los ejes de tu cámara. No usa las distancias comprimidas del visor. La fase geométrica no equivale a la proporción de luz que llega durante un eclipse.

## Fuentes y recursos

Esta versión reutiliza todos los mapas y bibliotecas ya incluidos; no añade dependencias, descargas en ejecución ni recursos de pago. Se conservan licencias y créditos existentes.

- NASA, [fases lunares](https://science.nasa.gov/moon/moon-phases/) y [eclipses](https://science.nasa.gov/moon/eclipses/).
- [Modelo de las lunas y límites de v16](jupiter-v16.md).
- [Geometría y aislamiento de las lecciones](lecciones-v16.md).
- [Verificación](verificacion-v16.md).