Versiones y soporte¶

Versionado semántico¶

Cada paquete sigue el versionado semántico: MAJOR.MINOR.PATCH.

MAJOR puede romper el contrato. Es la única versión que elimina algo.
MINOR añade funcionalidades y deprecaciones sin romper el contrato.
PATCH corrige errores y no cambia nada más.

Dos trenes de versiones¶

MageObsidian publica dos trenes de versiones independientes. Cada uno versiona todos sus paquetes juntos, así que todos los paquetes de un tren llevan siempre la misma versión.

Tren	Paquetes	Repositorio
Framework	`module-modern-frontend`, `module-modern-frontend-cli`, `module-modern-frontend-twig`, `component-modern-frontend`, npm `mage-obsidian`	`mage-obsidian/framework`
Storefront	los módulos del storefront y `theme-base`	`mage-obsidian/storefront`

El storefront depende del framework y declara la línea de framework que necesita, de modo que los dos trenes se relacionan por ese requisito y no por un número de versión compartido. Storefront 4.0.1 requiere framework 4.x; una versión de parche del storefront no obliga a publicar el framework, ni al revés.

theme-default se versiona por su cuenta y vive en su repositorio.

Qué cubre el contrato de 4.x¶

El contrato es la superficie que lista la Referencia:

Los comandos de la CLI y sus opciones.
Las rutas de configuración.
Las variables de entorno.
Las claves de theme.config.js y module.config.ts.
El XML de compatibilidad y la versión de esquema del contrato.
Las funciones y filtros de Twig.
Los nombres de paquetes.
Los especificadores Vendor_Module::path.
La API de interceptores JS.

Lo que no está en la Referencia no forma parte del contrato y puede cambiar en cualquier versión.

Política de deprecación¶

Nada del contrato se elimina en una minor ni en un parche. Una deprecación se marca en una versión minor, se anuncia en las Notas de actualización y se elimina en la siguiente major.

Versiones con soporte¶

Línea	Soporte
Última minor de 4.x	Recibe correcciones.
3.x	Congelada. Solo hotfixes de emergencia, publicados desde una rama `3.x` del repositorio afectado.

4.x requiere PHP 8.3+, Node 22+, pnpm 11+ y Magento Open Source o Mage-OS 2.4.7+, según la tabla de compatibilidad.

Las preguntas y los reportes van a las Discussions de los monorepos de framework y storefront.

Restricciones en tu composer.json¶

Usa ^4.0 para todos los paquetes de MageObsidian:

{
    "require": {
        "mage-obsidian/module-modern-frontend": "^4.0"
    }
}

No hace falta un techo. ^4.0 acepta todas las versiones 4.x y se detiene en 5.0, y el contrato garantiza que nada de 4.x te rompe. Las versiones de Magento y Mage-OS también son un piso, así que un Magento más nuevo no exige una restricción nueva.