migrations.json

{
  "migrations": [
    {
      "cli": "nx",
      "version": "22.6.0-beta.10",
      "description": "Adds .claude/worktrees to .gitignore",
      "implementation": "./dist/src/migrations/update-22-6-0/add-claude-worktrees-to-git-ignore",
      "package": "nx",
      "name": "22-6-1-add-claude-worktrees-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.7.0-beta.0",
      "description": "Adds .nx/polygraph to .gitignore",
      "implementation": "./dist/src/migrations/update-22-7-0/add-polygraph-to-git-ignore",
      "package": "nx",
      "name": "22-7-0-add-polygraph-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.6.0-rc.0",
      "description": "Adds .claude/settings.local.json to .gitignore",
      "implementation": "./dist/src/migrations/update-22-6-0/add-claude-settings-local-to-git-ignore",
      "package": "nx",
      "name": "22-6-0-add-claude-settings-local-to-git-ignore"
    },
    {
      "cli": "nx",
      "version": "22.6.0-beta.11",
      "description": "Prompts to enable usage analytics",
      "implementation": "./dist/src/migrations/update-22-6-0/enable-analytics-prompt",
      "package": "nx",
      "name": "22-6-0-enable-analytics-prompt"
    },
    {
      "cli": "nx",
      "version": "22.7.0-beta.0",
      "description": "Adds .nx/self-healing to .gitignore",
      "implementation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore",
      "documentation": "./dist/src/migrations/update-22-2-0/add-self-healing-to-gitignore.md",
      "package": "nx",
      "name": "22-7-0-add-self-healing-to-gitignore"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Consolidates any remaining legacy releaseTag* flat properties into the nested releaseTag object. The flat properties were removed in Nx 23.",
      "implementation": "./dist/src/migrations/update-23-0-0/consolidate-release-tag-config",
      "package": "nx",
      "name": "23-0-0-consolidate-release-tag-config"
    },
    {
      "version": "23.0.0-beta.18",
      "description": "Adds .nx/migrate-runs to .gitignore",
      "implementation": "./dist/src/migrations/update-23-0-0/add-migrate-runs-to-git-ignore",
      "package": "nx",
      "name": "23-0-0-add-migrate-runs-to-git-ignore"
    },
    {
      "version": "23.0.0-beta.25",
      "description": "Rewrites `@nx/web/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/web`'s exports map. Named imports/exports of public symbols are routed to `@nx/web` and the rest to the new `@nx/web/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/web/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/web",
      "name": "rewrite-web-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.10",
      "requires": {
        "jest": ">=30.0.0"
      },
      "description": "Update the Jest snapshot guide link in `.snap` files from the legacy `https://goo.gl/fbAQLP` URL to `https://jestjs.io/docs/snapshot-testing`, which Jest v30 now requires.",
      "implementation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link",
      "documentation": "./dist/src/migrations/update-23-0-0/update-snapshot-guide-link.md",
      "package": "@nx/jest",
      "name": "update-snapshot-guide-link"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Rewrites `@nx/jest/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/jest`'s exports map. Named imports/exports of public symbols are routed to `@nx/jest` and the rest to the new `@nx/jest/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/jest/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/jest",
      "name": "rewrite-jest-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.16",
      "description": "Replaces the removed `jestProjectGenerator` export from `@nx/jest` with its replacement `configurationGenerator`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-jest-project-generator",
      "package": "@nx/jest",
      "name": "rewrite-jest-project-generator"
    },
    {
      "version": "23.0.0-beta.22",
      "description": "Migrate the deprecated `setupFile` option of the `@nx/jest:jest` executor: push the file path into `setupFilesAfterEnv` in the project's Jest config and remove the option from `project.json` and `nx.json` target defaults.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-executor-setup-file",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-jest-executor-setup-file.md",
      "package": "@nx/jest",
      "name": "migrate-jest-executor-setup-file"
    },
    {
      "version": "23.0.0-beta.22",
      "description": "Migrate the deprecated `skipSetupFile` option of the `@nx/jest:configuration` generator stored as a default in `nx.json` or per-project `project.json` to `setupFile: 'none'` (when `true`) or remove it (when `false`).",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-jest-configuration-skip-setup-file",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-jest-configuration-skip-setup-file.md",
      "package": "@nx/jest",
      "name": "migrate-jest-configuration-skip-setup-file"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/jest/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/jest",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.1.0-beta.4",
      "requires": {
        "ts-jest": ">=29.2.0"
      },
      "description": "Set `isolatedModules: true` in `tsconfig.spec.json` for ts-jest projects on TypeScript < 6 (ts-jest 29.2+ forces `moduleResolution: node10` on the CommonJS path, which ignores package `exports` maps and breaks resolution of exports-only workspace libraries), then verify the workspace still typechecks and remedy any failures the change surfaced.",
      "implementation": "./dist/src/migrations/update-23-1-0/set-ts-jest-isolated-modules",
      "prompt": "tools/ai-migrations/@nx/jest/23.1.1/verify-typecheck.md",
      "documentation": "./dist/src/migrations/update-23-1-0/set-ts-jest-isolated-modules.md",
      "package": "@nx/jest",
      "name": "set-ts-jest-isolated-modules"
    },
    {
      "version": "23.0.0-beta.6",
      "description": "Rewrite imports from `@nx/devkit/src/...` to `@nx/devkit` (for public symbols) or `@nx/devkit/internal` (for the rest), since deep imports are no longer reachable through the package's `exports` map.",
      "implementation": "./dist/src/migrations/update-23-0-0/update-deep-imports",
      "documentation": "./dist/src/migrations/update-23-0-0/update-deep-imports.md",
      "package": "@nx/devkit",
      "name": "update-devkit-deep-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename deprecated CreateNodes `V2` type imports (CreateNodesV2, CreateNodesContextV2, CreateNodesResultV2, CreateNodesFunctionV2, NxPluginV2) from `@nx/devkit` to their canonical names.",
      "implementation": "./dist/src/migrations/update-23-0-0/rename-create-nodes-v2-types",
      "documentation": "./dist/src/migrations/update-23-0-0/rename-create-nodes-v2-types.md",
      "package": "@nx/devkit",
      "name": "update-23-0-0-rename-create-nodes-v2-types"
    },
    {
      "version": "22.7.0-beta.12",
      "description": "Add missing inputs to @nx/eslint:lint executor target defaults",
      "implementation": "./dist/src/migrations/update-21-6-0/update-executor-lint-inputs",
      "package": "@nx/eslint",
      "name": "update-executor-lint-inputs"
    },
    {
      "version": "23.0.0-beta.17",
      "description": "Rewrites `@nx/eslint/src/*` subpath imports now that the `./src/*` subpath is no longer exposed by `@nx/eslint`'s exports map. Named imports/exports of public symbols are routed to `@nx/eslint` and the rest to the new `@nx/eslint/internal` entry; `require`, dynamic `import` and `jest.mock` calls reference the whole module and are routed to `@nx/eslint/internal`.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/eslint",
      "name": "rewrite-eslint-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/eslint/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/eslint",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "eslint": ">=9.0.0"
      },
      "description": "Convert remaining ESLint configs to flat config for ESLint v9 and keep the workspace lint-passing, disabling rules whose preset defaults changed.",
      "implementation": "./dist/src/migrations/update-23-1-0/convert-to-flat-config",
      "prompt": "tools/ai-migrations/@nx/eslint/23.1.1/convert-to-flat-config.md",
      "package": "@nx/eslint",
      "name": "update-23-1-0-convert-to-flat-config"
    },
    {
      "version": "23.1.0-beta.5",
      "description": "Handle typescript-eslint rules removed in v8 in ESLint flat configs, since referencing a removed rule stops the config from loading. Deletes the removed formatting/extension rules (e.g. @typescript-eslint/no-extra-semi) and rewrites the safe 1:1 renames (no-throw-literal -> only-throw-error, no-useless-template-literals -> no-unnecessary-template-expression) to preserve enforcement.",
      "implementation": "./dist/src/migrations/update-23-1-0/remove-removed-typescript-eslint-extension-rules",
      "package": "@nx/eslint",
      "name": "update-23-1-0-remove-removed-typescript-eslint-extension-rules"
    },
    {
      "version": "23.1.0-beta.5",
      "description": "Migrate the removed @typescript-eslint/ban-types rule to its v8 successors (no-empty-object-type, no-unsafe-function-type, no-wrapper-object-types), whose options do not map 1:1 - so it is driven by an AI prompt rather than a deterministic codemod.",
      "prompt": "tools/ai-migrations/@nx/eslint/23.1.1/migrate-ban-types-rule.md",
      "package": "@nx/eslint",
      "name": "update-23-1-0-migrate-ban-types-rule"
    },
    {
      "version": "23.0.0-beta.14",
      "description": "Rewrites `@nx/js/src/*` subpath imports to the new `@nx/js/internal` entry. The `./src/*` wildcard has been removed from `@nx/js`'s exports map; `@nx/js/src/release/version-actions` is preserved as a non-wildcard entry for back-compat with existing nx.json release configs. If a rewritten import resolves to a symbol that lives on the public `@nx/js` entry (e.g. `libraryGenerator`, `extractTsConfigBase`, `resolvePathsBaseUrl`), change the specifier to `@nx/js`.",
      "factory": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/js",
      "name": "23-0-0-rewrite-internal-subpath-imports"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/js/typescript` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/js",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.1.0-beta.8",
      "description": "Adds `\"ignoreDeprecations\": \"6.0\"` to tsconfig files whose compilerOptions (or ts-node.compilerOptions) carry a TypeScript 6 deprecated option value, set directly or inherited through `extends` including from a base this migration does not edit (e.g. moduleResolution node/node10/classic, baseUrl, target es5, esModuleInterop false, outFile, module amd/umd/system/none, alwaysStrict false, allowSyntheticDefaultImports false, downlevelIteration set). Also pins `\"strict\": false`, `\"noUncheckedSideEffectImports\": false`, `\"types\": [\"*\"]`, and `\"esModuleInterop\": false` in chain-root tsconfigs (no \"extends\") that lack each key, preserving pre-TS6 behavior where these defaults changed; `esModuleInterop` false is itself deprecated (removed in TS7) so it also receives `ignoreDeprecations`, deferring the interop change to the TS7 migration. Also adds `ignoreDeprecations` to every `tsconfig.json` (the exact name jest/ts-node auto-resolve when compiling a config file; ts-node injects a deprecated default `target: es5` there, so the load can hit a TS6 error even on a clean config), even one with no deprecated value of its own; a stale local `ignoreDeprecations` (e.g. `5.0`) that would otherwise override the inherited flag is upgraded.",
      "requires": {
        "typescript": ">=6.0.0"
      },
      "factory": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6",
      "documentation": "./dist/src/migrations/update-23-1-0/add-ignore-deprecations-for-ts6.md",
      "package": "@nx/js",
      "name": "23-1-0-add-ignore-deprecations-for-ts6"
    },
    {
      "version": "23.1.0-rc.2",
      "description": "Sets an explicit `rootDir` on project `tsconfig*.json` files that lack one, pinned to the source directory TypeScript 5 inferred implicitly, so programs keep compiling and emitting the same layout under TypeScript 6, which otherwise hard-fails with TS5011 or TS6059 (for example a spec tsconfig importing another project's source through a `paths` alias). The pin is written even when the inferred directory already equals the tsconfig directory, because tools like ts-jest with `isolatedModules` compile a program per file and re-infer a deeper directory from that subset. The value is computed by the compiler, so emit layout is unchanged. Each config is written on its own; the migration never writes to a shared `extends` base, so a config never inherits a value computed for a sibling. Composite projects are pinned to their own directory: `rootDir` already defaults there under `tsc` so it is a no-op for a real composite build, but ts-jest strips `composite` for its per-file transpile and the explicit value is needed to avoid TS5011 there.",
      "requires": {
        "typescript": ">=6.0.0"
      },
      "factory": "./dist/src/migrations/update-23-1-0/set-tsconfig-root-dir-for-ts6",
      "documentation": "./dist/src/migrations/update-23-1-0/set-tsconfig-root-dir-for-ts6.md",
      "package": "@nx/js",
      "name": "23-1-0-set-tsconfig-root-dir-for-ts6"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/playwright/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/playwright",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.0.0-beta.10",
      "description": "Rewrites imports of `@nx/workspace/src/utilities/typescript/compilation` to `@nx/js/internal`, where the module now lives.",
      "implementation": "./dist/src/migrations/update-23-0-0/move-typescript-compilation-import",
      "package": "@nx/workspace",
      "name": "23-0-0-move-typescript-compilation-import"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/storybook/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/storybook",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.0.0-beta.0",
      "description": "Update the @nx/angular/module-federation import to use @nx/module-federation/angular.",
      "factory": "./dist/src/migrations/update-23-0-0/migrate-with-mf-import-to-new-package",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-with-mf-import-to-new-package.md",
      "package": "@nx/angular",
      "name": "update-23-0-0-update-with-module-federation-import"
    },
    {
      "version": "23.0.0-beta.7",
      "description": "Split @nx/angular:ngrx generator defaults in nx.json across the @nx/angular:ngrx-root-store and @nx/angular:ngrx-feature-store generators.",
      "factory": "./dist/src/migrations/update-23-0-0/migrate-ngrx-generator-defaults",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-ngrx-generator-defaults.md",
      "package": "@nx/angular",
      "name": "update-23-0-0-migrate-ngrx-generator-defaults"
    },
    {
      "version": "23.0.0-beta.24",
      "description": "Rename imports of `createNodesV2` from `@nx/angular/plugin` to the canonical `createNodes` export.",
      "implementation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes",
      "documentation": "./dist/src/migrations/update-23-0-0/migrate-create-nodes-v2-to-create-nodes.md",
      "package": "@nx/angular",
      "name": "update-23-0-0-migrate-create-nodes-v2-import"
    },
    {
      "version": "23.0.0-beta.25",
      "description": "Rewrites the now-removed deep `@nx/angular/src/utils`, `@nx/angular/src/generators/utils` and `@nx/angular/src/generators/move/move-impl` subpath imports to the new `@nx/angular/internal` entry. The executor/builder/generator schema and impl subpaths remain available and are left untouched.",
      "implementation": "./dist/src/migrations/update-23-0-0/rewrite-internal-subpath-imports",
      "package": "@nx/angular",
      "name": "rewrite-angular-internal-subpath-imports"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "@angular/core": ">=22.0.0"
      },
      "description": "Rename the `ssr.experimentalPlatform` option to `ssr.platform` in `@angular/build:application`, `@angular-devkit/build-angular:application`, and `@nx/angular:application` targets, matching the Angular v22 rename.",
      "factory": "./dist/src/migrations/update-23-1-0/rename-ssr-experimental-platform",
      "documentation": "./dist/src/migrations/update-23-1-0/rename-ssr-experimental-platform.md",
      "package": "@nx/angular",
      "name": "update-23-1-0-rename-ssr-experimental-platform"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "@angular/core": ">=22.0.0"
      },
      "description": "Add `istanbul-lib-instrument` to `devDependencies` when a project runs unit tests with Karma (the `@angular-devkit/build-angular:karma` / `@angular/build:karma` builders, or `@angular/build:unit-test` / `@nx/angular:unit-test` with `runner: karma`), matching the Angular v22 `add-istanbul-instrumenter` migration.",
      "factory": "./dist/src/migrations/update-23-1-0/add-istanbul-instrumenter",
      "documentation": "./dist/src/migrations/update-23-1-0/add-istanbul-instrumenter.md",
      "package": "@nx/angular",
      "name": "update-23-1-0-add-istanbul-instrumenter"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "@angular/core": ">=22.0.0"
      },
      "description": "Add the `trustProxyHeaders` option to `AngularNodeAppEngine` and `AngularAppEngine` instantiations in SSR server files, matching the Angular v22 `trust-proxy-headers` migration.",
      "factory": "./dist/src/migrations/update-23-1-0/add-trust-proxy-headers",
      "documentation": "./dist/src/migrations/update-23-1-0/add-trust-proxy-headers.md",
      "package": "@nx/angular",
      "name": "update-23-1-0-add-trust-proxy-headers"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "@angular/core": ">=22.0.0"
      },
      "description": "Add `@angular/build` to `devDependencies` when a project uses the `@nx/angular:application` or `@nx/angular:unit-test` executor, or an `@angular/build:*` executor, and it is not already installed. These executors import `@angular/build` directly at runtime, but it has only ever been available transitively via `@angular-devkit/build-angular`, which is not reliable across package managers.",
      "factory": "./dist/src/migrations/update-23-1-0/add-angular-build",
      "documentation": "./dist/src/migrations/update-23-1-0/add-angular-build.md",
      "package": "@nx/angular",
      "name": "update-23-1-0-add-angular-build"
    },
    {
      "version": "23.1.0-beta.0",
      "requires": {
        "@angular/core": ">=22.0.0"
      },
      "description": "Remove the `extendedDiagnostics` Angular compiler option from tsconfig files where `strictTemplates` resolves to `false`. Angular v22's `strict-templates-default` and `strict-safe-navigation-narrow` migrations can together produce this combination, which the Angular compiler rejects (`extendedDiagnostics` requires `strictTemplates` to be enabled).",
      "factory": "./dist/src/migrations/update-23-1-0/remove-conflicting-extended-diagnostics",
      "documentation": "./dist/src/migrations/update-23-1-0/remove-conflicting-extended-diagnostics.md",
      "package": "@nx/angular",
      "name": "update-23-1-0-remove-conflicting-extended-diagnostics"
    },
    {
      "version": "22.0.0",
      "description": "Adds `ChangeDetectionStrategy.Eager` to all components.",
      "factory": "./bundles/change-detection-eager.cjs#migrate",
      "package": "@angular/core",
      "name": "change-detection-eager"
    },
    {
      "version": "22.0.0",
      "description": "Adds 'withXhr' to 'provideHttpClient' function calls when the 'HttpXhrBackend' is used. For more information see: https://angular.dev/api/common/http/withXhr",
      "factory": "./bundles/http-xhr-backend.cjs#migrate",
      "package": "@angular/core",
      "name": "http-xhr-backend"
    },
    {
      "version": "22.0.0",
      "description": "Adds 'strictTemplates: false' in tsconfig.json when not set.",
      "factory": "./bundles/strict-templates-default.cjs#migrate",
      "package": "@angular/core",
      "name": "strict-templates-default"
    },
    {
      "version": "22.0.0",
      "description": "Adds the required third argument to canMatch callsites.",
      "factory": "./bundles/can-match-snapshot-required.cjs#migrate",
      "package": "@angular/core",
      "name": "can-match-snapshot-required"
    },
    {
      "version": "22.0.0",
      "description": "Adds withNoIncrementalHydration() opt out to provideClientHydration() when incremental hydration is not enabled to retain pre-v22 behavior-.",
      "factory": "./bundles/incremental-hydration.cjs#migrate",
      "package": "@angular/core",
      "name": "incremental-hydration"
    },
    {
      "version": "22.0.0",
      "description": "Disables the 'nullishCoalescingNotNullable & optionalChainNotNullable extended diagnostics.",
      "factory": "./bundles/strict-safe-navigation-narrow.cjs#migrate",
      "package": "@angular/core",
      "name": "strict-safe-navigation-narrow"
    },
    {
      "version": "22.0.0",
      "description": "Migrate broken duplicate outputs",
      "factory": "./bundles/model-output.cjs#migrate",
      "package": "@angular/core",
      "name": "model-output"
    },
    {
      "version": "22.0.0",
      "description": "Wraps optional chaining expressions in $safeNavigationMigration().",
      "factory": "./bundles/safe-optional-chaining.cjs#migrate",
      "package": "@angular/core",
      "name": "safe-optional-chaining"
    },
    {
      "version": "22.0.0-0",
      "description": "Updates the Angular CDK to v22",
      "factory": "./ng-update/index#updateToV22",
      "package": "@angular/cdk",
      "name": "migration-v22"
    }
  ]
}