execonvert 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -9,6 +9,40 @@ Categorías usadas: **Añadido**, **Cambiado**, **Corregido**, **Eliminado**.
 
 ## [Unreleased]
 
+## [0.5.1] - 2026-09-05
+
+### Cambiado
+- La conversión de fórmulas OMML de `.docx` ya no depende del paquete
+  `omml2mathml`, abandonado desde 2017. Se incorpora una copia en
+  `src/vendor/omml2mathml/` (Apache-2.0) cuya única modificación funcional es
+  crear el documento de salida con `@xmldom/xmldom` en lugar de `get-dom`.
+  Con ello desaparecen del árbol `jsdom@9`, `request`, `har-validator`, `abab`,
+  `uuid@3`, `content-type-parser` y `whatwg-encoding`: instalar el paquete pasa
+  de mostrar siete avisos de dependencias obsoletas a uno solo, y las alertas de
+  seguridad en dependencias de producción bajan de 15 a 7, sin ninguna crítica.
+  La conversión se ha comprobado contra los 178 casos de prueba del proyecto
+  original.
+
+## [0.5.0] - 2026-09-05
+
+### Añadido
+- Comprobación diaria de actualizaciones de eXeConvert en la CLI interactiva,
+  desactivable mediante `--no-update-check` o `EXECONVERT_NO_UPDATE_CHECK=1`.
+  No interfiere con tuberías, CI, JSON ni conversiones sin conexión.
+- `execonvert update --check` y `execonvert update`: consulta de versiones,
+  actualización mediante npm o descarga verificada de instaladores nativos.
+- Identificación del canal de instalación y de la arquitectura en los paquetes
+  nativos, con nombres explícitos de arquitectura para macOS y Windows.
+- Comprobación semanal de nuevas versiones de eXeLearning en GitHub Actions:
+  prueba las conversiones y genera un parche para revisión, sin publicarlo.
+- Pruebas del actualizador y de las conversiones de CLI y navegador con un
+  proyecto sintético que incluye páginas, imagen, fórmulas y traducciones.
+
+### Cambiado
+- Runtime embebido de eXeLearning actualizado de **v4.0.1** a **v4.0.3**,
+  incluidos los importadores, exportadores, temas, iDevices y traducciones
+  compartidos por la web y la CLI.
+
 ## [0.4.2] - 2026-06-25
 
 ### Corregido

package/README.md

@@ -103,6 +103,85 @@ Estado actual de la CLI:
 - soportado: `.elp -> .docx`
 - soportado: `.elp -> .pdf`
 
+## Actualizaciones de la CLI
+
+La CLI comprueba nuevas versiones estables de **eXeConvert** en GitHub como
+máximo una vez al día cuando se usa en una terminal interactiva. El aviso sale
+por `stderr`. No comprueba automáticamente en tuberías, CI, con `--json`, ni al
+pedir ayuda o la versión. Los errores de red no afectan a las conversiones y
+la consulta se cancela cuando termina la operación.
+
+```bash
+execonvert update --check                 # Consultar sin descargar
+execonvert update --check --json          # Resultado estructurado
+execonvert update                        # Actualizar npm o descargar el instalador
+execonvert update --out-dir ./descargas   # Elegir carpeta para instaladores
+```
+
+- **npm:** instala la versión estable anunciada en GitHub usando npm, en el
+  ámbito global o en el proyecto local donde está instalada esta copia. En un
+  proyecto local, npm puede actualizar `package.json` y el archivo de bloqueo.
+  Si npm todavía no tiene esa versión o faltan permisos, muestra el error.
+- **Debian, Windows y macOS:** descarga el instalador de su canal y arquitectura
+  y muestra dónde está para instalarlo mediante el sistema. No pide privilegios
+  ni ejecuta automáticamente el instalador.
+- **AppImage:** descarga la nueva versión, le da permiso de ejecución y conserva
+  la anterior. Hay que usar el nuevo archivo o actualizar el enlace habitual.
+- **Repositorio de desarrollo:** muestra la versión disponible; la actualización
+  del código se hace mediante Git y una nueva compilación.
+
+Las descargas de instaladores comprueban tamaño y SHA-256 antes de guardarse con
+su nombre definitivo. Si la publicación aún no tiene un instalador compatible,
+se muestra un aviso. Las nuevas publicaciones identifican la arquitectura en
+los paquetes de macOS y Windows. Los antiguos `.pkg` sin arquitectura explícita
+se descargan manualmente desde la página de versiones.
+
+Por defecto, los instaladores se guardan en la caché del usuario, bajo
+`execonvert/downloads/<versión>`. El estado de la consulta diaria se guarda en
+`execonvert/update-check.json` dentro de `$XDG_CACHE_HOME` o `~/.cache` en Linux,
+`~/Library/Caches` en macOS y `%LOCALAPPDATA%` en Windows.
+
+Para desactivar las consultas automáticas en una ejecución:
+
+```bash
+execonvert proyecto.elpx proyecto.md --no-update-check
+```
+
+Para desactivarlas de forma persistente, configura la variable de entorno
+`EXECONVERT_NO_UPDATE_CHECK=1`. La consulta explícita `update --check` sigue
+funcionando. La consulta solo solicita metadatos públicos de versiones;
+no envía los documentos del usuario.
+
+## Compatibilidad con nuevas versiones de eXeLearning
+
+El comando `update` conserva la combinación de eXeConvert y eXeLearning probada
+en cada publicación. Los componentes de eXeLearning se actualizan en el
+repositorio mediante `npm run sync:exe`.
+
+El workflow **Check eXeLearning compatibility** comprueba cada lunes a las
+06:25 UTC si hay una versión estable nueva; también se puede lanzar manualmente.
+Cuando la encuentra, sincroniza los componentes, comprueba los tipos, ejecuta
+las pruebas del actualizador, compila web y CLI y prueba las conversiones.
+Si todo pasa, adjunta un artefacto `tested-exelearning-update` con un parche
+binario y la procedencia del runtime. El parche se revisa y aplica con
+`git apply exelearning-update.patch` sobre la revisión usada por el workflow.
+No hace push, no crea releases y no publica cambios automáticamente.
+
+Las pruebas usan un `.elp` sintético con dos páginas, una imagen, fórmulas LaTeX
+y contenido en español. Comprueban `.elp → .elpx`, las exportaciones a Markdown,
+DOCX y PDF, la reimportación de Markdown/DOCX y la vista previa web en Chromium.
+Para ejecutarlas localmente:
+
+```bash
+npm run test:updates
+npm run build:all
+npm run test:cli
+npm run test:runtime
+```
+
+El workflow **Test CLI and conversions** ejecuta las pruebas del actualizador
+en Linux, Windows y macOS; las conversiones y el navegador se comprueban en Linux.
+
 ## Organización del código
 
 La web y la CLI están separadas como dos frontends distintos sobre el mismo núcleo de conversión:

package/THIRD_PARTY_NOTICES.md

@@ -27,6 +27,25 @@ Included resources in this repository:
 - `app/public/exelearning/bundles/manifest.json`
   - Supporting resource bundles required by the reused eXeLearning browser import/export runtime.
 
+## Vendored copy of omml2mathml
+
+- Source project: https://github.com/scienceai/omml2mathml
+- Project license: Apache-2.0 (see `src/vendor/omml2mathml/LICENSE`)
+
+Included in this repository:
+
+- `src/vendor/omml2mathml/index.js`
+- `src/vendor/omml2mathml/operators.js`
+  - Copied verbatim from omml2mathml 1.3.0, converted from CommonJS to ES
+    modules, and with the `get-dom` import replaced by `./dom.js`.
+- `src/vendor/omml2mathml/dom.js`
+  - Written for this project. It supplies the empty document the converter
+    builds the MathML tree on, using `@xmldom/xmldom` instead of `get-dom`,
+    which pulled in jsdom 9 and its unmaintained dependency chain.
+
+The library has been unmaintained since 2017, so there is no upstream release
+to update to; the copy is kept here to convert OMML formulas from `.docx`.
+
 ## Additional license notes
 
 - `app/public/idevices/text/text.js` contains a header pointing to:

package/dist/cli/app/public/exelearning/app/common/common_i18n.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": c_("Local mode: Due to browser security policy, you will need to select the folder from which you opened this file. On a web server this will not be necessary."),
     "proprietaryLicense": c_("Proprietary license"),
     "notAppropriate": c_("Not appropriate"),
-    "publicDomain": c_("Public domain")
+    "publicDomain": c_("Public domain"),
+    "attachment": c_("Attachment"),
+    "noFilesAttached": c_("No files attached."),
+    "fileUnavailable": c_("File unavailable")
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.ca.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Mode local: a causa de la política de seguretat del navegador, hauràs de seleccionar la carpeta des de la qual vas obrir aquest fitxer. En un servidor web això no serà necessari.",
     "proprietaryLicense": "Llicència propietària",
     "notAppropriate": "No apropiada",
-    "publicDomain": "Domini públic"
+    "publicDomain": "Domini públic",
+    "attachment": "Adjunt",
+    "noFilesAttached": "No hi ha cap fitxer adjunt.",
+    "fileUnavailable": "Fitxer no disponible"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.de.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Lokaler Modus: Aufgrund der Sicherheitsrichtlinien des Browsers müssen Sie den Ordner auswählen, aus dem Sie diese Datei geöffnet haben. Bei einem Webserver ist dies nicht erforderlich.",
     "proprietaryLicense": "Proprietäre Lizenz",
     "notAppropriate": "Nicht zutreffend",
-    "publicDomain": "Gemeinfrei"
+    "publicDomain": "Gemeinfrei",
+    "attachment": "Anhang",
+    "noFilesAttached": "Keine Dateien angehängt.",
+    "fileUnavailable": "Datei nicht verfügbar"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.en.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Local mode: Due to browser security policy, you will need to select the folder from which you opened this file. On a web server this will not be necessary.",
     "proprietaryLicense": "Proprietary license",
     "notAppropriate": "Not appropriate",
-    "publicDomain": "Public domain"
+    "publicDomain": "Public domain",
+    "attachment": "Attachment",
+    "noFilesAttached": "No files attached.",
+    "fileUnavailable": "File unavailable"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.eo.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Loka modo: pro la sekurecopolitiko de la retumilo, vi devos elekti la dosierujon, de kiu vi malfermis ĉi tiun dosieron. En retservilo tio ne estos necese.",
     "proprietaryLicense": "Propra licenco",
     "notAppropriate": "Ne konvena",
-    "publicDomain": "Publika domajno"
+    "publicDomain": "Publika domajno",
+    "attachment": "Aldonaĵo",
+    "noFilesAttached": "Neniu dosiero aldonita.",
+    "fileUnavailable": "Dosiero ne disponebla"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.es.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Modo local: debido a la política de seguridad del navegador, tendrás que seleccionar la carpeta desde la que abriste este archivo. En un servidor web esto no será necesario.",
     "proprietaryLicense": "Licencia propietaria",
     "notAppropriate": "No procede",
-    "publicDomain": "Dominio público"
+    "publicDomain": "Dominio público",
+    "attachment": "Adjunto",
+    "noFilesAttached": "No hay archivos adjuntos.",
+    "fileUnavailable": "Archivo no disponible"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.eu.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Modu lokala: nabigatzailearen segurtasun-politika dela eta, fitxategi hau irekitzeko erabili duzun karpeta aukeratu beharko duzu. Web zerbitzari batean hau ez da beharrezkoa izango.",
     "proprietaryLicense": "Jabetzaren lizentzia",
     "notAppropriate": "Ez dagokio",
-    "publicDomain": "Domeinu publikoa"
+    "publicDomain": "Domeinu publikoa",
+    "attachment": "Eranskina",
+    "noFilesAttached": "Ez dago fitxategi erantsirik.",
+    "fileUnavailable": "Fitxategia ez dago erabilgarri"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.gl.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Modo local: debido á política de seguranza do navegador, terás que seleccionar o cartafol desde o que abriches este ficheiro. Nun servidor web isto non será necesario.",
     "proprietaryLicense": "Licenza propietaria",
     "notAppropriate": "Non axeitado",
-    "publicDomain": "Dominio público"
+    "publicDomain": "Dominio público",
+    "attachment": "Anexo",
+    "noFilesAttached": "Non hai ficheiros anexos.",
+    "fileUnavailable": "Ficheiro non dispoñible"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.it.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Modalità locale: a causa della politica di sicurezza del browser, dovrai selezionare la cartella da cui hai aperto questo file. Su un server web non sarà necessario.",
     "proprietaryLicense": "Licenza d'uso",
     "notAppropriate": "Non applicabile",
-    "publicDomain": "Dominio pubblico"
+    "publicDomain": "Dominio pubblico",
+    "attachment": "Allegato",
+    "noFilesAttached": "Nessun file allegato.",
+    "fileUnavailable": "File non disponibile"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.pt.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Modo local: devido à política de segurança do navegador, você precisará selecionar a pasta de onde abriu este arquivo. Em um servidor web, isso não será necessário.",
     "proprietaryLicense": "Licença proprietária",
     "notAppropriate": "Não apropriada",
-    "publicDomain": "Domínio público"
+    "publicDomain": "Domínio público",
+    "attachment": "Anexo",
+    "noFilesAttached": "Nenhum arquivo anexado.",
+    "fileUnavailable": "Arquivo indisponível"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.ro.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Mod local: Din cauza politicii de securitate a browserului, va trebui să selectați folderul din care ați deschis acest fișier. Pe un server web, acest lucru nu va fi necesar.",
     "proprietaryLicense": "Licență proprietară",
     "notAppropriate": "Nu este adecvată",
-    "publicDomain": "Domeniu public"
+    "publicDomain": "Domeniu public",
+    "attachment": "Atașament",
+    "noFilesAttached": "Niciun fișier atașat.",
+    "fileUnavailable": "Fișier indisponibil"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/app/common/i18n/common_i18n.va.js

@@ -46,7 +46,10 @@ $exe_i18n = {
     "elpxFileProtocolWarning": "Mode local: a causa de la política de seguretat del navegador, hauràs de seleccionar la carpeta des de la qual vas obrir aquest arxiu. En un servidor web això no serà necessari.",
     "proprietaryLicense": "Llicència propietària",
     "notAppropriate": "No apropiada",
-    "publicDomain": "Domini públic"
+    "publicDomain": "Domini públic",
+    "attachment": "Adjunt",
+    "noFilesAttached": "No hi ha cap fitxer adjunt.",
+    "fileUnavailable": "Fitxer no disponible"
 };
 // The following line should only be used if the ELP contains a hangman game:
 $exe_i18n.exeGames = {

package/dist/cli/app/public/exelearning/bundles/manifest.json

@@ -1,110 +1,111 @@
 {
   "buildVersion": "v0.0.0-alpha",
-  "builtAt": "2026-06-09T10:43:11.684Z",
+  "builtAt": "2026-08-06T11:49:55.217Z",
   "themes": {
-    "flux": {
-      "files": 76,
-      "size": 209700,
-      "hash": "a981ba3bb7bae3f5c8c976db8b5918a38337676a60aed8deb15920e96ff3711f"
+    "base": {
+      "files": 56,
+      "size": 80989,
+      "hash": "e8ce68ed6628fa7a1913422f3ad9adadf395e708a38a0f84bd644b37de70b76a"
     },
     "nova": {
       "files": 74,
-      "size": 140925,
-      "hash": "394c618263265e0d35e396917bbd977fb46145eb62002192ee9b9cd8e7bfd073"
+      "size": 141010,
+      "hash": "7008fc03a970da6ec2a5926af79317fcc4e5f93ecbc193afe650743390912e91"
     },
-    "neo": {
-      "files": 87,
-      "size": 815172,
-      "hash": "6497a80276d0ee1776e8a22838928401876c232bc8ab5ee146967af22397c084"
+    "flux": {
+      "files": 76,
+      "size": 209684,
+      "hash": "972d71b1de28b2a888131ce173ff26a1825cfd027b9f380f9d7d3fc1d77b3bc3"
+    },
+    "universal": {
+      "files": 93,
+      "size": 139371,
+      "hash": "1f1ca9b301ffa365fae3cfbfba35839f5857c37802a9f172af7efc9c6c6aefef"
     },
     "zen": {
       "files": 80,
-      "size": 1172615,
-      "hash": "35d3c5a35948dcc8babfbdbb1812f99b4bb4217433d2d82263f47a9d226a425c"
-    },
-    "base": {
-      "files": 56,
-      "size": 81002,
-      "hash": "cfd14a9bf08e12a490bd4feb525a33ce48a4879418023c1fb653a5fa2bd13c40"
+      "size": 1172600,
+      "hash": "97f6f23e376b464e79ee0e6e864f4339e001198880d4359d070317aea9dbf30e"
     },
-    "universal": {
-      "files": 93,
-      "size": 139386,
-      "hash": "2aadc6a6719461fd16680bba3c9080315912633ce5f8659d2388d1d99337e61b"
+    "neo": {
+      "files": 87,
+      "size": 815158,
+      "hash": "8823c4a0aed446ab0a61788d823c12a8a9fc9bb992c1c131830a9c3824b47f57"
     }
   },
   "idevices": {
-    "three-sixty-viewer": 6,
-    "hidden-image": 15,
-    "trueorfalse": 19,
-    "mathproblems": 18,
+    "word-search": 25,
+    "crossword": 23,
+    "file-attachment": 6,
+    "scrambled-list": 14,
+    "select-media-files": 26,
+    "beforeafter": 18,
+    "form": 13,
+    "discover": 26,
+    "image-gallery": 7,
+    "text": 5,
+    "relate": 22,
+    "sort": 26,
+    "identify": 24,
     "az-quiz-game": 31,
+    "udl-content": 9,
+    "checklist": 10,
+    "markdown-text": 4,
+    "download-source-file": 5,
+    "3dmol": 31,
+    "flipcards": 22,
+    "mathproblems": 18,
+    "lomloe": 3,
+    "interactive-video": 9,
+    "progress-report": 11,
+    "challenge": 62,
+    "electrical-circuits": 23,
     "padlock": 13,
     "example": 4,
+    "magnifier": 9,
+    "hidden-image": 15,
+    "geogebra-activity": 7,
+    "complete": 17,
     "trivial": 42,
-    "flipcards": 22,
-    "udl-content": 9,
-    "magnifier": 8,
-    "relate": 22,
-    "image-gallery": 7,
-    "3dmol": 31,
-    "puzzle": 26,
+    "quick-questions-multiple-choice": 28,
     "external-website": 3,
-    "three-d-viewer": 10,
-    "dragdrop": 18,
-    "rubric": 5,
-    "adaptative-quiz": 14,
-    "progress-report": 11,
-    "discover": 26,
+    "classify": 22,
+    "casestudy": 5,
+    "guess": 31,
+    "quick-questions-video": 27,
     "slide": 4,
-    "lomloe": 3,
-    "text": 5,
-    "geogebra-activity": 7,
     "periodic-table": 14,
-    "crossword": 23,
-    "markdown-text": 4,
-    "checklist": 10,
-    "mathematicaloperations": 18,
-    "download-source-file": 5,
     "quick-questions": 26,
     "digcompedu": 4,
-    "classify": 22,
-    "challenge": 62,
-    "quick-questions-video": 27,
-    "form": 13,
-    "guess": 31,
-    "electrical-circuits": 23,
-    "identify": 24,
-    "beforeafter": 18,
-    "interactive-video": 9,
-    "casestudy": 5,
-    "select-media-files": 26,
-    "complete": 17,
-    "word-search": 25,
-    "quick-questions-multiple-choice": 28,
-    "scrambled-list": 14,
-    "sort": 26,
-    "map": 158
+    "puzzle": 26,
+    "dragdrop": 18,
+    "adaptative-quiz": 14,
+    "trueorfalse": 19,
+    "map": 158,
+    "three-d-viewer": 10,
+    "rubric": 5,
+    "mathematicaloperations": 18,
+    "three-sixty-viewer": 6
   },
   "idevicesBundle": {
-    "count": 51,
-    "files": 1011,
-    "size": 4125502,
-    "hash": "33b5ad3c08d7b2a24ecb1bf885c55820704826c9595e1190dc5af8248e006419"
+    "count": 52,
+    "files": 1018,
+    "size": 4153645,
+    "hash": "b264144ca156a59a50f762d064ba5353b3136a92afe13b31f5ebec09a47d9b54"
   },
   "libs": {
     "files": 9,
-    "size": 309498,
-    "hash": "502b1f7c1ef193fb0ad6e968e176eeb0f7895994bf20519b954a3c5823495434"
+    "size": 313157,
+    "hash": "959c03673e458af8b502a7b335c9a3073e923441896233df833a326d5336ddd3"
   },
   "common": {
-    "files": 132,
-    "size": 2728084,
-    "hash": "b65311c2d960abbff1da26e81dba0c8c58ea15cb310e952cf18c151e4eb12bd5"
+    "files": 133,
+    "size": 2731770,
+    "hash": "ced8ba388aab4061ebac5b1d6cea5ea709af015bea25a37d5f90cedcfa02db2d"
   },
   "contentCss": {
     "files": 4,
-    "size": 44634,
-    "hash": "b84c1f4b4f922266b37aa7da3283cf43a4973784b7b7a6a50c2a47b1953f2e44"
+    "size": 45491,
+    "hash": "6113f93a438647d347a38e0a9d16575a42be0488bfa48a48dc6f95113d26c80a"
   }
 }