Auteur:
    Création:2026-09-23Dernière mise à jour:2026-09-23

    Mettre à jour les packages Intlayer

    bash
    npx intlayer upgrade
    

    La commande upgrade liste les packages Intlayer déclarés dans chaque package.json de votre projet, y compris les workspaces d'un monorepo, et les met à jour vers la dernière version publiée. Elle exécute de manière autonome la même étape de mise à jour des packages que intlayer init.

    Arguments :

    • --project-root [projectRoot] - Optionnel. Le répertoire racine du projet. Par défaut, la commande démarre à partir du package.json le plus proche au-dessus du répertoire de travail actuel.
    • --dry-run - Optionnel. Liste les packages et leur version cible sans modifier aucun fichier.
    • --tag <tag> - Optionnel. Le dist-tag npm vers lequel effectuer la mise à jour (par exemple canary). Par défaut à latest.

    Ce qu'elle fait :

    1. Liste les packages Intlayer - Analyse chaque package.json du projet (en ignorant node_modules et les sorties de build) à la recherche des dépendances et devDependencies intlayer, @intlayer/*, *-intlayer et intlayer-*.
    2. Récupère la version cible - Lit la version du dist-tag sélectionné (latest par défaut) de chaque package depuis le registre npm.
    3. Réécrit les plages de versions - Met à jour chaque plage obsolète directement dans le fichier, en conservant son opérateur (^, ~ ou aucun) ainsi que l'indentation du fichier.
    4. Installe en une seule fois - Exécute une seule installation depuis la racine du workspace (le répertoire le plus proche contenant un lock file), en utilisant le gestionnaire de packages propriétaire du lock file :
    Lock fileCommande
    bun.lock / bun.lockbbun install
    pnpm-lock.yamlpnpm install
    yarn.lockyarn install
    package-lock.json ou aucunnpm install

    S'il n'y a pas de lock file, le champ packageManager du package.json (par exemple "bun@1.2.0") est utilisé avant de basculer vers npm par défaut.

    Les plages qui ne pointent pas vers le registre, telles que workspace:*, file:, link:, catalog: ou les URLs git, ne sont jamais modifiées.

    Exemples :

    Lister les mises à jour disponibles sans les appliquer :

    bash
    npx intlayer upgrade --dry-run
    

    Mettre à jour vers la version canary :

    bash
    npx intlayer upgrade --tag canary
    

    Exemple de sortie :

    bash
    npx intlayer upgrade
    Intlayer packages:
      package.json
        intlayer ^9.0.0 ^9.5.7
      apps/web/package.json
        next-intlayer ^9.5.7 (latest)
        vite-intlayer ~9.2.0 ~9.5.7
    Running bun install...
     Upgraded 2 Intlayer dependencies to latest
    

    Notes :

    • Exécutez la commande depuis la racine de votre dépôt pour mettre à jour tous les workspaces. Exécutez-la depuis un workspace pour ne mettre à jour que ce workspace.
    • Les packages dont la version ne peut pas être récupérée (hors ligne, package privé ou non publié) sont listés et laissés inchangés.
    • Si l'installation échoue, les plages mises à jour sont conservées dans package.json. Exécutez manuellement la commande d'installation de votre gestionnaire de packages.