pnpm-settings-migrator 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -1,10 +1,9 @@
 import { PnpmSettings } from "@pnpm/types";
-
 //#region src/types.d.ts
 /**
  * Compatibility target used by the migrator.
  */
-type CompatibilityTarget = 'auto' | 'v10' | 'v11';
+type CompatibilityTarget = 'auto' | 'v10' | 'v11' | 'v12';
 /**
  * Merge strategy for combining pnpm settings.
  */
@@ -30,6 +29,7 @@ interface Options {
    * - `auto`: detect from `packageManager` (fallback to `v10`)
    * - `v10`: keep legacy v10 settings
    * - `v11`: normalize to v11-compatible settings
+   * - `v12`: apply the v11 settings migration for pnpm v12
    *
    * @default 'auto'
    */
@@ -71,16 +71,24 @@ interface Options {
 /**
  * legacy `pnpm-workspace` types
  */
-type PnpmWorkspaceLegacy = {
+interface PnpmWorkspaceLegacy {
   catalog?: Record<string, string>;
   catalogs?: Record<string, Record<string, string>>;
   packages?: string[];
-};
+}
 /**
  * `package-json` types
  * @pg
  */
 interface PackageJson {
+  /**
+   * Development tool declarations.
+   */
+  devEngines?: {
+    packageManager?: PackageManagerEngine;
+    runtime?: RuntimeEngine | RuntimeEngine[];
+    [key: string]: unknown;
+  };
   /**
    * same as `pnpm.overrides`
    *
@@ -94,7 +102,7 @@ interface PackageJson {
   /**
    * pnpm settings
    */
-  pnpm?: PnpmSettings;
+  pnpm?: PnpmWorkspace;
   /**
    * same as `pnpm.overrides`
    *
@@ -107,11 +115,35 @@ interface PackageJson {
  * @pg
  */
 type NpmRC = Record<string, any>;
+/**
+ * Package manager declaration stored in
+ * `package.json#devEngines.packageManager`.
+ */
+interface PackageManagerEngine {
+  name: string;
+  onFail?: 'download' | 'error' | 'ignore' | 'warn';
+  version: string;
+}
+/**
+ * Runtime declaration stored in `package.json#devEngines.runtime`.
+ */
+interface RuntimeEngine {
+  name: string;
+  onFail?: 'download' | 'error' | 'ignore' | 'warn';
+  version: string;
+}
 /**
  * Deprecated `pnpm` settings in `package.json`
  * @see {@link https://github.com/pnpm/pnpm/blob/main/core/types/CHANGELOG.md#major-changes}
  */
 interface PnpmSettingsDeprecated {
+  /**
+   * @deprecated
+   */
+  auditConfig?: {
+    ignoreCves?: string[];
+    ignoreGhsas?: string[];
+  };
   /**
    * @deprecated
    */
@@ -120,10 +152,18 @@ interface PnpmSettingsDeprecated {
    * @deprecated
    */
   ignoredBuiltDependencies?: string[];
+  /**
+   * @deprecated
+   */
+  ignoreDepScripts?: boolean;
   /**
    * @deprecated
    */
   ignorePatchFailures?: boolean;
+  /**
+   * @deprecated
+   */
+  managePackageManagerVersions?: boolean;
   /**
    * @deprecated
    */
@@ -136,12 +176,38 @@ interface PnpmSettingsDeprecated {
    * @deprecated
    */
   onlyBuiltDependenciesFile?: string;
+  /**
+   * @deprecated
+   */
+  packageManagerStrict?: boolean;
+  /**
+   * @deprecated
+   */
+  packageManagerStrictVersion?: boolean;
+  /**
+   * @deprecated
+   */
+  useNodeVersion?: string;
+  /**
+   * @deprecated
+   */
+  executionEnv?: {
+    nodeVersion?: string;
+    [key: string]: unknown;
+  };
+}
+/**
+ * Settings introduced in pnpm v11.
+ */
+interface PnpmSettingsV11 {
+  packageConfigs?: Record<string, Record<string, unknown>>;
+  pmOnFail?: 'download' | 'error' | 'ignore' | 'warn';
 }
 /**
  * `pnpm-workspace` types
  * @pg
  */
-type PnpmWorkspace = PnpmSettings & PnpmSettingsDeprecated & PnpmWorkspaceLegacy;
+type PnpmWorkspace = PnpmSettings & PnpmSettingsDeprecated & PnpmSettingsV11 & PnpmWorkspaceLegacy;
 //#endregion
 //#region src/core.d.ts
 /**
@@ -152,6 +218,7 @@ type PnpmWorkspace = PnpmSettings & PnpmSettingsDeprecated & PnpmWorkspaceLegacy
  * - `package.json` pnpm field
  * - `.npmrc` pnpm-related settings
  * - `package.json` resolutions (optional, converts to pnpm overrides)
+ * - deprecated settings already present in `pnpm-workspace.yaml`
  *
  * @param rawOptions - Migration options
  * @param rawOptions.cwd - Current working directory (default: process.cwd())
@@ -204,4 +271,4 @@ declare function migratePnpmSettings(rawOptions?: Options): Promise<void>;
  */
 declare function resolveOptions(options?: Options): Required<Options>;
 //#endregion
-export { CompatibilityTarget, MergeStrategy, NpmRC, Options, PackageJson, PnpmSettingsDeprecated, PnpmWorkspace, PnpmWorkspaceLegacy, migratePnpmSettings, resolveOptions };
+export { CompatibilityTarget, MergeStrategy, NpmRC, Options, PackageJson, PackageManagerEngine, PnpmSettingsDeprecated, PnpmSettingsV11, PnpmWorkspace, PnpmWorkspaceLegacy, RuntimeEngine, migratePnpmSettings, resolveOptions };