Política de versionado

Oxlint sigue versionado semántico para dar claridad y previsibilidad al actualizar.

Se considera un cambio rompedor (breaking):

• Cambios en la CLI que rompan flujos de trabajo existentes.
• Cambios en el archivo de configuración (.oxlintrc.json) que rompan configuraciones actuales.
• Renombrar o eliminar una regla.

Se considera un cambio no rompedor:

• Añadir reglas nuevas.
• Cambiar la configuración por defecto de una regla.
• Mejorar descripciones de reglas o mensajes de diagnóstico.
• Añadir opciones de configuración a reglas existentes.
• Correcciones que alineen mejor el comportamiento con la regla ESLint original.
• Añadir campos nuevos al archivo de configuración.

Funciones fuera de semver

Lo siguiente no está sujeto al versionado semántico: pueden introducir cambios rompedores en cualquier momento, incluso en parches o menores:

• Plugins JS personalizados — La API y el comportamiento pueden cambiar sin aviso.
• Lint con información de tipos — Las reglas type-aware pueden cambiar mientras evoluciona la función.

¿Son rompedores los avisos nuevos del lint?

Si una versión nueva de Oxlint muestra más problemas en tu código, es lo esperado: significa que Oxlint ha mejorado, no que tu proyecto se haya “roto”. Los errores nuevos reflejan un análisis más estricto, no un fallo de la actualización.

Qué esperar en cada tipo de versión

• Parche (1.0.x): Correcciones, rendimiento, refactors internos. Suele ser seguro actualizar.
• Menor (1.x.0): Reglas nuevas, mejores diagnósticos, funciones nuevas. No se consideran rompedoras aunque aparezcan errores nuevos en el código.
• Mayor (x.0.0): Reservada para cambios rompedores en CLI o formato de configuración.

Con Renovate Bot

Añade el siguiente fragmento a tu configuración de Renovate para mantener Oxlint al día.

renovate.json

{
  "extends": ["config:recommended"],
  "packageRules": [
    {
      "matchPackageNames": ["oxlint"],
      "groupName": "oxlint",
      "automergeType": "branch",
      "stabilityDays": 1
    }
  ]
}

Si usas eslint-plugin-oxlint, actualízalo junto con Oxlint para evitar problemas de compatibilidad.

Con Dependabot

Añade el siguiente fragmento a tu configuración de Dependabot para mantener Oxlint al día.

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/" # location of package.json
    schedule:
      interval: "daily"
    groups: # group all Oxlint updates together
      oxlint:
        patterns:
          - "oxlint"
    commit-message: # keep the history tidy
      prefix: "chore"
      include: "scope"
    ignore: # optional: ignore future majors
      - dependency-name: "oxlint"
        update-types: ["version-update:semver-major"]
    open-pull-requests-limit: 1 # one PR at a time

Si usas eslint-plugin-oxlint, actualízalo junto con Oxlint para evitar problemas de compatibilidad.