@intlayer/engine 9.5.7 → 9.5.9-canary.0

package/dist/esm/writeFileIfChanged.mjs

@@ -1,6 +1,6 @@
-import { basename, dirname, join } from "node:path";
 import { rmSync } from "node:fs";
 import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
 import { randomBytes } from "node:crypto";
 
 //#region src/writeFileIfChanged.ts

package/dist/types/cli.d.ts

@@ -13,6 +13,7 @@ import { CmsCredentials, enableEditorInConfig, setupCmsCredentials, writeCmsCred
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT } from "./init/utils/nextCompilerBabel.js";
 import "./init/utils/index.js";
 import { ContentStrategy, InitOptions, getDefaultApplicationURL, initIntlayer } from "./init/index.js";
+import { UpgradeIntlayerPackagesOptions, UpgradeIntlayerPackagesResult, upgradeIntlayerPackages } from "./init/upgradeIntlayerPackages.js";
 import { installLSP } from "./installLSP.js";
 import { PLATFORMS, PLATFORMS_METADATA, Platform, PlatformMetadata, SKILLS, SKILLS_METADATA, Skill, getInitialSkills, installSkills } from "./installSkills/index.js";
 import { MCPTransport, installMCP } from "./installMCP/installMCP.js";
@@ -20,4 +21,4 @@ import { listDictionaries, listDictionariesWithStats } from "./listDictionariesP
 import { DiffMode, ListGitFilesOptions, ListGitLinesOptions, listGitFiles, listGitLines } from "./listGitFiles.js";
 import { ListProjectsOptions, getGitRootDir, listProjects } from "./listProjects.js";
 import { logConfigDetails } from "./logConfigDetails.js";
-export { COMPAT_I18N_LIBRARIES, type CmsCredentials, type CompatI18nLibrary, ContentStrategy, DictionaryStatus, DiffMode, InitOptions, ListGitFilesOptions, ListGitLinesOptions, ListProjectsOptions, MCPTransport, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, type PackageManager, Platform, PlatformMetadata, type RoutingMode, SKILLS, SKILLS_METADATA, Skill, detectCompatI18nLibraries, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };
+export { COMPAT_I18N_LIBRARIES, type CmsCredentials, type CompatI18nLibrary, ContentStrategy, DictionaryStatus, DiffMode, InitOptions, ListGitFilesOptions, ListGitLinesOptions, ListProjectsOptions, MCPTransport, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, PLATFORMS, PLATFORMS_METADATA, type PackageManager, Platform, PlatformMetadata, type RoutingMode, SKILLS, SKILLS_METADATA, Skill, UpgradeIntlayerPackagesOptions, UpgradeIntlayerPackagesResult, detectCompatI18nLibraries, detectExportedComponentName, detectFormatCommand, detectPackageManager, enableEditorInConfig, getContentDeclarationFileTemplate, getDefaultApplicationURL, getGitRootDir, getInitialSkills, initIntlayer, installLSP, installMCP, installPackages, installSkills, listDictionaries, listDictionariesWithStats, listGitFiles, listGitLines, listProjects, logConfigDetails, prepareIntlayer, setupCmsCredentials, transformJSFile, upgradeIntlayerPackages, writeCmsCredentialsToEnv, writeContentDeclaration, writeJSFile };

package/dist/types/init/index.d.ts

@@ -26,7 +26,8 @@ export type InitOptions = {
   /** Skip scaffolding the `fill` and `test` GitHub Actions workflows. */
   noGithubActions?: boolean;
   /**
-   * Skip installing missing Intlayer dependencies and upgrading outdated ones.
+   * Skip installing missing Intlayer dependencies and upgrading the Intlayer
+   * packages of every `package.json` to their latest version.
    */
   noInstallPackages?: boolean;
   /** Skip adding the Intlayer extension to `.vscode/extensions.json`. */
@@ -36,14 +37,16 @@ export type InitOptions = {
   /** Skip enabling the Intlayer lint rules (ESLint / oxlint). */
   noEslint?: boolean;
   /**
-   * Skip framework-specific scaffolding (middleware/proxy, providers in
-   * layout/page, example content). Defaults to enabled.
+   * Skip the project setup: tsconfig types/aliases, the Intlayer config file,
+   * bundler/framework configs, the dev script and framework-specific
+   * scaffolding (middleware/proxy, providers in layout/page). Defaults to
+   * enabled.
    */
   noFrameworkSetup?: boolean;
   /**
-   * Version that outdated Intlayer packages should be upgraded to (typically the
-   * running CLI version). When omitted, installed packages are left untouched and
-   * only missing ones are installed.
+   * Version to install the missing Intlayer packages at (typically the running
+   * CLI version). Already declared Intlayer packages are upgraded to the latest
+   * published version instead.
    */
   upgradeToVersion?: string;
   /**

package/dist/types/init/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/init/index.ts"],"mappings":";;;;;;;;;qBAiOa,2BAAwB,cACrB;;;;;;;;;;YAsBJ;;;;YAQA;EACV;;EAEA;;;;EAIA;;EAEA;;EAEA;;EAEA;;;;;EAKA;;;;;;EAMA;;;;;;EAMA,cAAc;;;;;;;EAOd,kBAAkB;;;;;qBAMP,eAAY,iBAAyB,UAAY,gBAAW"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/init/index.ts"],"mappings":";;;;;;;;;qBA6Oa,2BAAwB,cACrB;;;;;;;;;;YAsBJ;;;;YAQA;EACV;;EAEA;;;;;EAKA;;EAEA;;EAEA;;EAEA;;;;;;;EAOA;;;;;;EAMA;;;;;;EAMA,cAAc;;;;;;;EAOd,kBAAkB;;;;;qBAMP,eAAY,iBAAyB,UAAY,gBAAW"}

package/dist/types/init/upgradeIntlayerPackages.d.ts

@@ -0,0 +1,26 @@
+import { IntlayerDependencyUpgrade, PackageJsonIntlayerDependencies } from "./utils/intlayerDependencies.js";
+import "./utils/index.js";
+//#region src/init/upgradeIntlayerPackages.d.ts
+export type UpgradeIntlayerPackagesOptions = {
+  /** List the Intlayer packages and their target version without upgrading. */
+  dryRun?: boolean;
+  /**
+   * npm dist-tag to upgrade to (e.g. `canary`).
+   * @default 'latest'
+   */
+  distTag?: string;
+};
+export type UpgradeIntlayerPackagesResult = {
+  /** Intlayer dependencies found in every `package.json` of the project. */
+  packageJsonDependencies: PackageJsonIntlayerDependencies[];
+  /** Upgrades written (or that would be written, in dry-run mode). */
+  upgrades: IntlayerDependencyUpgrade[];
+};
+/**
+ * Lists the Intlayer packages of every `package.json` of the project
+ * (monorepo workspaces included), rewrites their ranges to the version of the
+ * given dist-tag, then runs a single install from the root.
+ */
+export declare const upgradeIntlayerPackages: (rootDir: string, options?: UpgradeIntlayerPackagesOptions) => Promise<UpgradeIntlayerPackagesResult>;
+//#endregion
+//# sourceMappingURL=upgradeIntlayerPackages.d.ts.map

package/dist/types/init/upgradeIntlayerPackages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgradeIntlayerPackages.d.ts","names":[],"sources":["../../../src/init/upgradeIntlayerPackages.ts"],"mappings":";;;YAcY;;EAEV;;;;;EAKA;;YAGU;;EAEV,yBAAyB;;EAEzB,UAAU;;;;;;;qBAQC,0BAAuB,iBACnB,UACL,mCACT,QAAQ"}

package/dist/types/init/utils/index.d.ts

@@ -1,11 +1,12 @@
-import { COMPAT_I18N_LIBRARIES, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectOutdatedIntlayerPackages, detectPackageManager, getInstalledPackageVersion, hasLintTooling, installPackages, isIntlayerPackageName, normalizeVersion, upgradePackages } from "./packageManager.js";
+import { COMPAT_I18N_LIBRARIES, COMPAT_PACKAGE_REPLACEMENTS, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, IntlayerPackageAnalysis, PackageManager, detectCompatI18nLibraries, detectMissingIntlayerPackages, detectPackageManager, findLockFileDir, hasLintTooling, installPackages, isIntlayerPackageName, moveCompatPackagesToDevDependencies, normalizeVersion, runPackageInstall } from "./packageManager.js";
 import { RoutingMode, enableIntlayerEditorConfig, getMetroConfigTemplate, hasIntlayerVitePlugin, replaceViteConfigPluginImportSource, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n } from "./configManipulation.js";
 import { ensureNamedImport, firstInsertIndex, isModuleScopeBinding } from "./astImports.js";
 import { BACKEND_INTLAYER_PACKAGES, ResolveDevScriptParams, resolveDevScript } from "./devScript.js";
 import { JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NextIntlMessagesPattern, detectJsonLocalePattern, detectLinguiCatalogPattern, detectNextIntlMessagesPattern, ensureDirectory, exists, readFileFromRoot, writeFileToRoot } from "./fileSystem.js";
 import { GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, GithubWorkflowFile, GithubWorkflowsContext, GithubWorkflowsOptions, getGithubWorkflows, resolveGithubWorkflowsContext } from "./githubActions.js";
+import { IntlayerDependency, IntlayerDependencyUpgrade, PackageJsonIntlayerDependencies, fetchLatestPackageVersion, findPackageJsonFiles, getIntlayerDependencies, getIntlayerDependencyUpgrades, listIntlayerDependencies, toRange, writeIntlayerDependencyUpgrades } from "./intlayerDependencies.js";
 import { parseJSONWithComments } from "./jsonParser.js";
 import { NEXT_INTLAYER_BABEL_CONFIG_CONTENT, setupNextCompilerBabelConfig } from "./nextCompilerBabel.js";
 import { findTsConfigFiles } from "./tsConfig.js";
 import { isVersionAtLeast } from "./version.js";
-export { BACKEND_INTLAYER_PACKAGES, COMPAT_I18N_LIBRARIES, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, GithubWorkflowFile, GithubWorkflowsContext, GithubWorkflowsOptions, IntlayerPackageAnalysis, JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, NextIntlMessagesPattern, PackageManager, ResolveDevScriptParams, RoutingMode, detectCompatI18nLibraries, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectOutdatedIntlayerPackages, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getInstalledPackageVersion, getMetroConfigTemplate, hasIntlayerVitePlugin, hasLintTooling, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveDevScript, resolveGithubWorkflowsContext, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, upgradePackages, writeFileToRoot };
+export { BACKEND_INTLAYER_PACKAGES, COMPAT_I18N_LIBRARIES, COMPAT_PACKAGE_REPLACEMENTS, CompatI18nLibrary, CompatSyncConfig, CompatVitePluginConfig, DetectMissingPackagesOptions, GITHUB_FILL_WORKFLOW_PATH, GITHUB_TEST_WORKFLOW_PATH, GithubWorkflowFile, GithubWorkflowsContext, GithubWorkflowsOptions, IntlayerDependency, IntlayerDependencyUpgrade, IntlayerPackageAnalysis, JsonLocalePattern, JsonLocalePatternType, LinguiCatalogPattern, NEXT_INTLAYER_BABEL_CONFIG_CONTENT, NextIntlMessagesPattern, PackageJsonIntlayerDependencies, PackageManager, ResolveDevScriptParams, RoutingMode, detectCompatI18nLibraries, detectJsonLocalePattern, detectLinguiCatalogPattern, detectMissingIntlayerPackages, detectNextIntlMessagesPattern, detectPackageManager, enableIntlayerEditorConfig, ensureDirectory, ensureNamedImport, exists, fetchLatestPackageVersion, findLockFileDir, findPackageJsonFiles, findTsConfigFiles, firstInsertIndex, getGithubWorkflows, getIntlayerDependencies, getIntlayerDependencyUpgrades, getMetroConfigTemplate, hasIntlayerVitePlugin, hasLintTooling, installPackages, isIntlayerPackageName, isModuleScopeBinding, isVersionAtLeast, listIntlayerDependencies, moveCompatPackagesToDevDependencies, normalizeVersion, parseJSONWithComments, readFileFromRoot, replaceViteConfigPluginImportSource, resolveDevScript, resolveGithubWorkflowsContext, runPackageInstall, setIntlayerConfigCompilerOutput, setIntlayerConfigRoutingMode, setupNextCompilerBabelConfig, toRange, updateAstroConfig, updateIntlayerConfigWithSyncPlugin, updateMetroConfig, updateNextConfig, updateNextConfigForNextI18next, updateNextConfigForNextIntl, updateNextConfigForNextTranslate, updateNuxtConfig, updateNuxtConfigForNuxtjsI18n, updateViteConfig, updateViteConfigForCompatPlugin, updateViteConfigForVueI18n, writeFileToRoot, writeIntlayerDependencyUpgrades };

package/dist/types/init/utils/intlayerDependencies.d.ts

@@ -0,0 +1,66 @@
+//#region src/init/utils/intlayerDependencies.d.ts
+/** Dependency fields of a `package.json` scanned for Intlayer packages. */
+declare const DEPENDENCY_FIELDS: readonly ['dependencies', 'devDependencies'];
+type DependencyField = (typeof DEPENDENCY_FIELDS)[number];
+/** An Intlayer dependency declared in one of the project's `package.json`. */
+export type IntlayerDependency = {
+  /** Package name, e.g. `next-intlayer`. */
+  packageName: string;
+  /** Field the dependency is declared in. */
+  dependencyField: DependencyField;
+  /** Declared version range, e.g. `^9.5.0`. */
+  currentRange: string;
+};
+/** Intlayer dependencies of one `package.json`. */
+export type PackageJsonIntlayerDependencies = {
+  /** Path of the `package.json`, relative to the project root. */
+  packageJsonPath: string;
+  dependencies: IntlayerDependency[];
+};
+/** A dependency range rewritten to the latest published version. */
+export type IntlayerDependencyUpgrade = IntlayerDependency & {
+  packageJsonPath: string;
+  /** Range written back to the `package.json`, e.g. `^9.5.7`. */
+  nextRange: string;
+};
+/**
+ * Lists every `package.json` of the project (root first), skipping
+ * `node_modules` and build outputs.
+ */
+export declare const findPackageJsonFiles: (rootDir: string) => Promise<string[]>;
+/**
+ * Lists the Intlayer packages (`intlayer`, `@intlayer/*`, `*-intlayer`,
+ * `intlayer-*`) declared with a registry range in a parsed `package.json`.
+ */
+export declare const getIntlayerDependencies: (packageJson: Partial<Record<DependencyField, Record<string, string>>>) => IntlayerDependency[];
+/** Lists the Intlayer dependencies of every `package.json` of the project. */
+export declare const listIntlayerDependencies: (rootDir: string) => Promise<PackageJsonIntlayerDependencies[]>;
+/**
+ * Fetches the version a dist-tag (`latest` by default) of a package points to
+ * on the npm registry. Resolves to `null` when the registry cannot be reached,
+ * the package is not published or the dist-tag does not exist.
+ */
+export declare const fetchLatestPackageVersion: (packageName: string, { distTag, registryUrl }?: {
+  distTag?: string;
+  registryUrl?: string;
+}) => Promise<string | null>;
+/**
+ * Keeps the range operator (`^`, `~` or none) of `currentRange` and points it
+ * to `version`.
+ *
+ * @example toRange('^9.0.0', '9.5.7') // '^9.5.7'
+ */
+export declare const toRange: (currentRange: string, version: string) => string;
+/**
+ * Computes the upgrades bringing every listed dependency to its latest version.
+ * Dependencies already on the latest version, or whose latest version could not
+ * be fetched, are left out.
+ */
+export declare const getIntlayerDependencyUpgrades: (packageJsonDependencies: PackageJsonIntlayerDependencies[], latestVersions: Map<string, string | null>) => IntlayerDependencyUpgrade[];
+/**
+ * Writes the upgraded ranges back to their `package.json`, keeping the file's
+ * indentation and trailing newline.
+ */
+export declare const writeIntlayerDependencyUpgrades: (rootDir: string, upgrades: IntlayerDependencyUpgrade[]) => Promise<void>;
+//#endregion
+//# sourceMappingURL=intlayerDependencies.d.ts.map

package/dist/types/init/utils/intlayerDependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlayerDependencies.d.ts","names":[],"sources":["../../../../src/init/utils/intlayerDependencies.ts"],"mappings":";;cAOM;KAED,0BAA0B;;YAGnB;;EAEV;;EAEA,iBAAiB;;EAEjB;;;YAIU;;EAEV;EACA,cAAc;;;YAIJ,4BAA4B;EACtC;;EAEA;;;;;;qBAcW,uBAAoB,oBAE9B;;;;;qBAmBU,0BAAuB,aACrB,QAAQ,OAAO,iBAAiB,6BAC5C;;qBAeU,2BAAwB,oBAElC,QAAQ;;;;;;qBA2BE,4BAAyB,uBACjB,SAAA;EAId;EAAkB;MACtB;;;;;;;qBAqBU,UAAO,sBAAwB;;;;;;qBAQ/B,gCAA6B,yBACf,mCAAiC,gBAC1C,+BACf;;;;;qBA2BU,kCAA+B,iBAC3B,UACL,gCACT"}

package/dist/types/init/utils/packageManager.d.ts

@@ -69,6 +69,8 @@ export type IntlayerPackageAnalysis = {
   packagesToInstall: string[];
   /** Intlayer dev packages that are referenced but not yet installed. */
   devPackagesToInstall: string[];
+  /** Compat packages in dependencies that got replaced and should be moved to devDependencies. */
+  packagesToMoveToDev: string[];
   /**
    * syncJSON plugin configuration to inject when a compat i18n library is
    * detected. Undefined when no compat library is present or format is not
@@ -84,9 +86,16 @@ export type IntlayerPackageAnalysis = {
 };
 /**
  * Detects the package manager in use by checking for lock files in the
- * project root. Falls back to npm when no lock file is found.
+ * project root, then the `packageManager` field of its `package.json`. Falls
+ * back to npm when neither is found.
  */
 export declare const detectPackageManager: (rootDir: string) => PackageManager;
+/**
+ * Walks up from `startDir` to the nearest directory holding a lock file — the
+ * workspace root an install must run from. Stops at the repository root
+ * (`.git`) and returns `null` when no lock file is found.
+ */
+export declare const findLockFileDir: (startDir: string) => string | null;
 /**
  * Analyzes existing project dependencies to determine which intlayer packages
  * are missing and what syncJSON configuration to inject when compat i18n
@@ -100,6 +109,16 @@ export type DetectMissingPackagesOptions = {
    * dependency the lingui compat setup uses.
    */
   linguiCatalogFormat?: 'po' | 'json' | null;
+  /**
+   * The project's runtime dependencies (from `package.json` `dependencies`).
+   * When provided, compat packages found here that are replaced by `@intlayer/*`
+   * are reported in `packagesToMoveToDev`.
+   */
+  dependencies?: Record<string, string>;
+  /**
+   * The project's development dependencies (from `package.json` `devDependencies`).
+   */
+  devDependencies?: Record<string, string>;
 };
 /** An existing i18n library Intlayer ships a compat adapter for. */
 export type CompatI18nLibrary = {
@@ -111,6 +130,11 @@ export type CompatI18nLibrary = {
    * recognized.
    */
   packages: readonly string[];
+  /**
+   * Upstream third-party packages replaced by Intlayer compat adapters at runtime,
+   * mapped to their adapter package name.
+   */
+  replacements: Record<string, string>;
 };
 /**
  * Existing i18n libraries Intlayer can adapt, keyed by the dependencies that
@@ -119,6 +143,19 @@ export type CompatI18nLibrary = {
  * detection will wire up on its own once its package is in `package.json`.
  */
 export declare const COMPAT_I18N_LIBRARIES: readonly CompatI18nLibrary[];
+/**
+ * Maps third-party i18n libraries to the Intlayer compat adapter that replaces
+ * them at runtime, derived from {@link COMPAT_I18N_LIBRARIES}.
+ */
+export declare const COMPAT_PACKAGE_REPLACEMENTS: Record<string, string>;
+/**
+ * When a project uses a compat i18n package (such as `next-intl`) that gets
+ * replaced by an `@intlayer/*` adapter (e.g. `@intlayer/next-intl`), moves the
+ * original package from `dependencies` to `devDependencies` in `package.json`.
+ *
+ * Returns the list of package names that were moved.
+ */
+export declare const moveCompatPackagesToDevDependencies: (packageJson: Record<string, any>) => string[];
 /**
  * Returns the labels of the compat i18n libraries present in `dependencies`.
  *
@@ -153,7 +190,8 @@ export declare const installPackages: (rootDir: string, packages: string[], pack
  * Matches the core `intlayer` package, every scoped `@intlayer/*` package
  * (including compat adapters such as `@intlayer/next-intl`) and the framework
  * runtime integrations that follow the `<framework>-intlayer` convention
- * (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`).
+ * (e.g. `next-intlayer`, `react-intlayer`, `express-intlayer`), as well as the
+ * `intlayer-*` packages (e.g. `intlayer-editor`).
  */
 export declare const isIntlayerPackageName: (packageName: string) => boolean;
 /**
@@ -165,23 +203,10 @@ export declare const isIntlayerPackageName: (packageName: string) => boolean;
  */
 export declare const normalizeVersion: (version?: string) => string | null;
 /**
- * Reads the installed version of a package from its `package.json` inside the
- * project's `node_modules`. Returns `null` when the package is not installed or
- * its manifest cannot be read.
- */
-export declare const getInstalledPackageVersion: (rootDir: string, packageName: string) => string | null;
-/**
- * Returns the Intlayer packages from `dependencies` whose installed version is
- * behind `targetVersion` (compared on `major.minor.patch`). Packages that are
- * not installed yet are ignored — those are handled by
- * {@link detectMissingIntlayerPackages}.
- */
-export declare const detectOutdatedIntlayerPackages: (rootDir: string, dependencies: Record<string, string>, targetVersion: string) => string[];
-/**
- * Upgrades the given packages to `targetVersion` synchronously, preserving the
- * dependency type via the `isDev` flag. Throws if the install process exits
- * with a non-zero code.
+ * Runs the package manager install command synchronously, so edited
+ * `package.json` ranges are resolved and the lock file updated. Throws if the
+ * install process exits with a non-zero code.
  */
-export declare const upgradePackages: (rootDir: string, packages: string[], packageManager: PackageManager, targetVersion: string, isDev?: boolean) => void;
+export declare const runPackageInstall: (rootDir: string, packageManager: PackageManager) => void;
 //#endregion
 //# sourceMappingURL=packageManager.d.ts.map

package/dist/types/init/utils/packageManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packageManager.d.ts","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"mappings":";;YAMY;;;;;YAMA;;;;;;;EAOV;;;;;EAKA;;;;;EAKA;;;;;;;;;;;;;;;EAeA;;;;;;;YAQU;;EAEV;;EAEA;;;;;;;;EAQA;;IAEE;;IAEA;;;;YAKQ;;EAEV;;EAEA;;;;;;EAMA,kBAAkB;;;;;;EAMlB,wBAAwB;;;;;;qBAOb,uBAAoB,oBAAsB;;;;;;;YA2C3C;;;;;;EAMV;;;YAIU;;EAEV;;;;;;EAMA;;;;;;;;qBASW,gCAAgC;;;;;;;;;;qBA0EhC,4BAAyB,cACtB;;;;;;;;;;;;qBAiBH,iBAAc,cAAkB;qBAGhC,gCAA6B,iBACvB,wBAAsB,UAC9B,iCACR;;;;;qBAiVU,kBAAe,iBACX,oBACG,gBACF,gBAAc;;;;;;;;;qBAenB,wBAAqB;;;;;;;;qBAYrB,mBAAgB;;;;;;qBAWhB,6BAA0B,iBACtB;;;;;;;qBAwBJ,iCAA8B,iBAC1B,cACD,wBAAsB;;;;;;qBAuBzB,kBAAe,iBACX,oBACG,gBACF,gBAAc,uBACT"}
+{"version":3,"file":"packageManager.d.ts","names":[],"sources":["../../../../src/init/utils/packageManager.ts"],"mappings":";;YAKY;;;;;YAMA;;;;;;;EAOV;;;;;EAKA;;;;;EAKA;;;;;;;;;;;;;;;EAeA;;;;;;;YAQU;;EAEV;;EAEA;;;;;;;;EAQA;;IAEE;;IAEA;;;;YAKQ;;EAEV;;EAEA;;EAEA;;;;;;EAMA,kBAAkB;;;;;;EAMlB,wBAAwB;;;;;;;qBA8Cb,uBAAoB,oBAAsB;;;;;;qBAY1C,kBAAe;;;;;;;YA2ChB;;;;;;EAMV;;;;;;EAMA,eAAe;;;;EAIf,kBAAkB;;;YAIR;;EAEV;;;;;;EAMA;;;;;EAKA,cAAc;;;;;;;;qBASH,gCAAgC;;;;;qBA+GhC,6BAA6B;;;;;;;;qBAc7B,sCAAmC,aACjC;;;;;;;;;;qBA8BF,4BAAyB,cACtB;;;;;;;;;;;;qBAiBH,iBAAc,cAAkB;qBAGhC,gCAA6B,iBACvB,wBAAsB,UAC9B,iCACR;;;;;qBA4VU,kBAAe,iBACX,oBACG,gBACF,gBAAc;;;;;;;;;;qBAgBnB,wBAAqB;;;;;;;;qBAarB,mBAAgB;;;;;;qBAahB,oBAAiB,iBACb,gBACC"}

package/dist/types/installSkills/index.d.ts

@@ -5,22 +5,35 @@
 export declare const SKILLS_METADATA: {
   readonly Config: 'Intlayer configuration documentation';
   readonly Content: 'Reference for all Intlayer content node types (t, enu, etc.)';
+  readonly Markdown: 'Markdown / rich text content: md(), MDX components, MarkdownProvider, SSR';
   readonly Usage: 'How to use Intlayer in your project';
   readonly CLI: 'Intlayer CLI commands and usage';
   readonly Compiler: 'Intlayer Compiler setup and usage for automatic content extraction without .content files';
   readonly RemoteContent: 'How to use Intlayer with Remote/CMS/Server-side content';
+  readonly DevTools: 'ESLint, LSP, VS Code & Chrome extensions, MCP server and CI/CD';
+  readonly Compat: 'Migrate from i18next, next-intl, react-intl, vue-i18n, Lingui… keeping their API';
   readonly NextJS: 'Next.js-specific usage (Server & Client components)';
   readonly React: 'React-specific syntax and hooks usage';
   readonly Vue: 'Vue-specific composables and syntax';
   readonly Svelte: 'Svelte-specific stores and syntax';
   readonly Angular: 'Angular-specific syntax and Injectable Function usage';
   readonly Preact: 'Preact-specific syntax and hooks usage';
-  readonly Solid: 'Integrates Intlayer internationalization with SolidJS components. Use when the user asks to "setup SolidJS i18n", use the "useIntlayer" hook in Solid, or manage locales in a SolidJS application.';
-  readonly Astro: 'Astro-specific usage and getIntlayer';
+  readonly Solid: 'Solid-specific syntax and hooks usage';
+  readonly Astro: 'Astro-specific usage, middleware and islands';
+  readonly Lit: 'Lit-specific ReactiveController usage (useIntlayer, useLocale)';
+  readonly Vanilla: 'Framework-less JavaScript usage (vanilla-intlayer)';
+  readonly Remix: 'Remix 3 router middleware and request-scoped hooks';
+  readonly Backend: 'Server-side usage for Express, Fastify, Hono, NestJS, AdonisJS and Elysia';
 };
 export type Skill = keyof typeof SKILLS_METADATA;
 export declare const SKILLS: Skill[];
-export declare const getInitialSkills: (deps: Record<string, string>) => (keyof typeof SKILLS_METADATA)[];
+/**
+ * Resolves the skills to preselect from the project's installed packages.
+ *
+ * @param dependencies - Merged `dependencies` and `devDependencies` of `package.json`.
+ * @returns The base skills plus every framework skill whose packages are installed.
+ */
+export declare const getInitialSkills: (dependencies: Record<string, string>) => Skill[];
 export interface PlatformMetadata {
   label: string;
   dir: string;

package/dist/types/installSkills/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/installSkills/index.ts"],"mappings":";;;;qBASa;WACX;WACA;WACA;WACA;WACA;WAEA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WAEA;;YAGU,qBAAqB;qBAEpB,QAAyC;qBAEzC,mBAAgB,MACrB,yCACS;iBAoBA;EACf;EACA;EACA;;;;;qBAMW,oBAAoB,eAAe;YA6JpC,wBAAwB;qBAEvB,WAA+C;;;;;qBA8G/C,gBAAa,qBACL,UACT,UAAQ,QACV,YACP"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/installSkills/index.ts"],"mappings":";;;;qBASa;WACX;WACA;WACA;WAEA;WACA;WACA;WAEA;WACA;WACA;WAEA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;YAIU,qBAAqB;qBAEpB,QAAyC;;;;;;;qBAoFzC,mBAAgB,cACb,2BACb;iBAUc;EACf;EACA;EACA;;;;;qBAMW,oBAAoB,eAAe;YA6JpC,wBAAwB;qBAEvB,WAA+C;;;;;qBA8G/C,gBAAa,qBACL,UACT,UAAQ,QACV,YACP"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/engine",
-  "version": "9.5.7",
+  "version": "9.5.9-canary.0",
   "private": false,
   "description": "Scans and builds Intlayer declaration files into dictionaries based on Intlayer configuration.",
   "keywords": [
@@ -142,11 +142,11 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/api": "9.5.6",
-    "@intlayer/config": "9.5.6",
-    "@intlayer/core": "9.5.6",
-    "@intlayer/dictionaries-entry": "9.5.6",
-    "@intlayer/types": "9.5.6",
+    "@intlayer/api": "9.5.8",
+    "@intlayer/config": "9.5.8",
+    "@intlayer/core": "9.5.8",
+    "@intlayer/dictionaries-entry": "9.5.8",
+    "@intlayer/types": "9.5.8",
     "@parcel/watcher": "2.6.0",
     "defu": "6.1.7",
     "fast-glob": "3.3.3",
@@ -166,7 +166,7 @@
     "zod": "4.6.5"
   },
   "peerDependencies": {
-    "@intlayer/babel": "9.5.6"
+    "@intlayer/babel": "9.5.8"
   },
   "peerDependenciesMeta": {
     "@intlayer/babel": {