@craft-ng/dev-tools 0.5.0-beta.5 → 0.5.1-beta.0

package/README.md

@@ -10,27 +10,45 @@ Development tools for ng-craft: ESLint configs, ESLint rules, and codemods.
 npm install -D @craft-ng/dev-tools
 ```
 
-## Angular Brand Codemod Config
+## Dev-tools configuration
 
-`craft-brand` can load a typed project config from `craft-brand.config.ts`.
+`craft-brand` and the migrations load a typed project config from
+`craft-dev-tools.config.ts`. The legacy `craft-brand.config.ts` format remains
+supported.
 
 ```ts
-import { defineAngularBrandConfig } from '@craft-ng/dev-tools';
-
-export default defineAngularBrandConfig({
-  importAugmentations: [
-    {
-      match: {
-        module: '@ngx-translate/core',
-        symbols: ['TranslatePipe'],
-        metadata: ['imports'],
+import { defineCraftDevToolsConfig } from '@craft-ng/dev-tools';
+
+export default defineCraftDevToolsConfig({
+  brand: {
+    importAugmentations: [
+      {
+        match: {
+          module: '@ngx-translate/core',
+          symbols: ['TranslatePipe'],
+          metadata: ['imports'],
+        },
+        deps: [
+          {
+            key: 'TranslateService',
+            symbol: 'TranslateService',
+            typeText: 'TranslateService<unknown>',
+          },
+        ],
       },
-      deps: [{ key: 'TranslateService', symbol: 'TranslateService' }],
-      missingProvider: [
-        { key: 'TranslateService', symbol: 'TranslateService' },
-      ],
-    },
-  ],
+    ],
+  },
+  serviceMigration: {
+    overrides: [
+      {
+        file: 'src/app/legacy-api.service.ts',
+        symbol: 'LegacyApiService',
+        name: 'Api',
+        scope: 'manuallyProvidedAtRoot',
+        strategy: 'craftService',
+      },
+    ],
+  },
 });
 ```
 
@@ -57,12 +75,9 @@ Discovery behavior:
 - `brand-angular-deps-match` can autofix an existing `GenDeps_*` alias in the current file
 - `component-test-gen-deps-match` verifies component test helpers use the matching `GenDeps_*` alias
 
-Current scope:
-
-- `TypeScript` config file only
-- declarative rules only
-- matching only from Angular `imports` and `hostDirectives`
-- no arbitrary `typeText` generation and no helper-local `typeof injectX` expressions
+`typeText` supports generic dependency spellings that cannot be inferred from
+Angular metadata. Service overrides match by file/module/symbol; later matching
+entries take precedence.
 
 Example CLI usage:
 
@@ -71,6 +86,99 @@ craft-brand --root apps/demo/src
 craft-brand --root apps/demo/src --config ./craft-brand.config.ts
 ```
 
+## Angular services migration
+
+Run services before routes so generated `GenDeps` and route provider names see
+the craft helpers:
+
+```bash
+craft-migrate --project apps/my-app/tsconfig.app.json --root apps/my-app/src --dry-run
+craft-migrate --project apps/my-app/tsconfig.app.json --root apps/my-app/src --write
+```
+
+`craft-migrate` runs primitives, services, then routes and can emit one combined
+report with `--json [path]`. The individual commands remain available for
+targeted migrations:
+
+```bash
+craft-migrate-primitives --project apps/my-app/tsconfig.app.json --root apps/my-app/src --dry-run
+craft-migrate-primitives --project apps/my-app/tsconfig.app.json --root apps/my-app/src --write
+craft-migrate-services --project apps/my-app/tsconfig.app.json --root apps/my-app/src --dry-run
+craft-migrate-services --project apps/my-app/tsconfig.app.json --root apps/my-app/src --write
+craft-migrate-routes --project apps/my-app/tsconfig.app.json --root apps/my-app/src --write
+ng build my-app
+```
+
+`--write` runs ESLint on touched files by default; use `--no-eslint` only when
+the caller owns that step. `--json [path]`, `--check`, and `--fail-on-manual`
+support CI and staged migrations. Ambiguous classes are retained and receive an
+idempotent `.craft.ts` companion containing `CRAFT_IMPLEMENTATION_REQUIRED`.
+The companion uses a valid inferred scope and consumers import its generated
+helpers, so a manual service rewrite no longer leaves broken imports behind.
+
+`craft-migrate-primitives` runs before service migration. It converts simple
+Angular `signal(...)` calls to the craft `state(...)` primitive and reports
+signal-form migration points. Signal forms are intentionally diagnostic-first:
+`form(...)` must become `state(..., insertForm(...))`, but field paths and
+validators change shape. For async validators, the script reports the
+`validateAsync(...) + rxResource(...)` pattern so it can be rewritten as a local
+`query(...)` triggered by the field value plus `cAsyncValidate(queryRef, ...)`.
+
+The service migration also:
+
+- preserves method type parameters and avoids property/parameter shadowing
+- removes replaced Angular service imports
+- converts simple `httpResource(...)` calls to `query(...)` backed by
+  `CraftHttpClient.request(...)`
+- converts simple writable service methods using `HttpClient.post/put/patch/delete`
+  into generator operations backed by `CraftHttpClient`
+- when a component already performs a simple `.subscribe()`, creates a
+  component-local `mutation(...)` and replaces the subscription trigger with
+  `.mutate(...)`; complex subscriptions keep a manual diagnostic so callback
+  semantics are not silently moved to a shared service lifecycle
+- rewrites simple `chain(resource)` dependencies to `resource.value()` and
+  reports only complex chains that require a semantic decision
+- disables `@typescript-eslint/explicit-function-return-type` in the nearest
+  flat ESLint config, because generated craft callbacks rely on inference
+
+## Angular routes migration
+
+`craft-migrate-routes` converts exported `Routes` arrays to `craftRoutes`, wraps
+statically resolvable component routes with `craftRoute`, generates or reuses
+their `GenDeps_*` type, and adds the file-level DI check.
+
+Start with a dry run:
+
+```bash
+craft-migrate-routes \
+  --project apps/my-app/tsconfig.app.json \
+  --root apps/my-app/src/app \
+  --dry-run
+```
+
+Then write the deterministic changes and let the project rules refresh their
+generated assertions:
+
+```bash
+craft-migrate-routes --project apps/my-app/tsconfig.app.json --root apps/my-app/src/app --write
+eslint --fix "apps/my-app/src/**/*.ts"
+ng build my-app
+```
+
+When the root collection is fully migratable, the routes migration also updates
+`app.config.ts` to `craftAppConfig(...)` + `provideCraftRouter(routes.toRoutes())`
+and wraps the bootstrap config with `toApplicationConfig(...)`. Collections
+containing Angular guards or nested `children` are kept as Angular `Routes`
+instead of being half-converted; the CLI emits manual diagnostics and leaves
+`app.config.ts` unchanged until the root route tree is craft-compatible.
+
+The migration deliberately reports guards, dynamic paths/redirects, ambiguous
+components, inherited providers, and route splits instead of guessing their
+business semantics. Use `--fail-on-manual` to make these diagnostics fail the
+command, `--json <path>` for a machine-readable report, and `--check` in CI to
+reject remaining legacy collections. Lazy collections can declare their mount
+context with `--parent-mount <path>` and `--parent-names <name,...>`.
+
 ```bash
 import craftRules from '@craft-ng/dev-tools/eslint-rules';
 
@@ -88,6 +196,7 @@ export default [
       'craft-ng/prefer-craft-service': 'error',
       'craft-ng/prefer-craft-http-client': 'error',
       'craft-ng/prefer-browser-boundaries': 'error',
+      'craft-ng/require-lazy-load-with-retry': 'error',
     }
   }
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-ng/dev-tools",
-  "version": "0.5.0-beta.5",
+  "version": "0.5.1-beta.0",
   "description": "Development tools for ng-craft: ESLint configs, ESLint rules, and codemods",
   "type": "module",
   "main": "./src/index.js",
@@ -17,7 +17,11 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "craft-brand": "./src/bin/craft-brand.js"
+    "craft-brand": "./src/bin/craft-brand.js",
+    "craft-migrate": "./src/bin/craft-migrate.js",
+    "craft-migrate-primitives": "./src/bin/craft-migrate-primitives.js",
+    "craft-migrate-services": "./src/bin/craft-migrate-services.js",
+    "craft-migrate-routes": "./src/bin/craft-migrate-routes.js"
   },
   "files": [
     "src/**/*",

package/src/bin/craft-migrate-primitives.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/bin/craft-migrate-primitives.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { runPrimitivesMigration } from '../scripts/primitives/migrate-primitives.js';
+function parseArgs(argv) {
+    const options = { files: [] };
+    const files = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        switch (argument) {
+            case '--project':
+                options.tsConfigFilePath = argv[++index];
+                break;
+            case '--root':
+                options.rootDir = argv[++index];
+                break;
+            case '--dry-run':
+                options.write = false;
+                break;
+            case '--write':
+                options.write = true;
+                break;
+            case '--check':
+                options.check = true;
+                break;
+            case '--json':
+                if (argv[index + 1] && !argv[index + 1].startsWith('-'))
+                    options.jsonFilePath = argv[++index];
+                else
+                    options.json = true;
+                break;
+            case '--fail-on-manual':
+                options.failOnManual = true;
+                break;
+            case '--no-eslint':
+                options.eslint = false;
+                break;
+            case '--help':
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                if (argument.startsWith('-'))
+                    throw new Error(`Unknown argument: ${argument}`);
+                files.push(argument);
+        }
+    }
+    options.files = files;
+    return options;
+}
+function printHelp() {
+    console.log(`Usage: craft-migrate-primitives [files...] [options]
+
+Options:
+  --project <path>       Application tsconfig.
+  --root <dir>           Source root. Defaults to cwd.
+  --dry-run              Analyze without writing (default).
+  --write                Write migrated files.
+  --check                Fail while Angular signals or signal forms remain.
+  --json [path]          Print JSON, or write it to path.
+  --fail-on-manual       Fail when manual diagnostics are emitted.
+  --no-eslint            Do not run ESLint --fix after --write.
+`);
+}
+runPrimitivesMigration(parseArgs(process.argv.slice(2)))
+    .then((result) => {
+    process.exitCode = result.exitCode;
+})
+    .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=craft-migrate-primitives.js.map

package/src/bin/craft-migrate-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-migrate-primitives.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-migrate-primitives.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAIrF,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;gBACtB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;oBACrD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;;oBAClC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,MAAM;YACR,KAAK,kBAAkB;gBACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC5B,MAAM;YACR,KAAK,aAAa;gBAChB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;gBACvB,MAAM;YACR,KAAK,QAAQ;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;CAWb,CAAC,CAAC;AACH,CAAC;AAED,sBAAsB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACrD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IACf,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACrC,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/src/bin/craft-migrate-routes.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/bin/craft-migrate-routes.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { runRoutesMigration } from '../scripts/routes/migrate-routes.js';
+function parseArgs(argv) {
+    const options = { files: [] };
+    const files = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        switch (argument) {
+            case '--root':
+                options.rootDir = argv[++index];
+                break;
+            case '--project':
+            case '--tsconfig':
+                options.tsConfigFilePath = argv[++index];
+                break;
+            case '--write':
+                options.write = true;
+                break;
+            case '--dry-run':
+                options.write = false;
+                break;
+            case '--check':
+                options.check = true;
+                break;
+            case '--collection-name':
+                options.collectionName = argv[++index];
+                break;
+            case '--parent-mount':
+                options.parentMount = argv[++index];
+                break;
+            case '--parent-names':
+                options.parentNames = argv[++index].split(',').filter(Boolean);
+                break;
+            case '--json':
+                options.jsonFilePath = argv[++index];
+                break;
+            case '--fail-on-manual':
+                options.failOnManual = true;
+                break;
+            case '--help':
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                if (argument.startsWith('-'))
+                    throw new Error(`Unknown argument: ${argument}`);
+                files.push(argument);
+        }
+    }
+    options.files = files;
+    return options;
+}
+function printHelp() {
+    console.log(`Usage: craft-migrate-routes [files...] [options]
+
+Options:
+  --root <dir>                 Source root. Defaults to cwd.
+  --project, --tsconfig <path> Application tsconfig.
+  --dry-run                    Analyze and print without writing (default).
+  --write                      Write migrated files.
+  --check                      Fail when legacy Routes collections remain.
+  --collection-name <name>    Override the inferred craftRoutes name.
+  --parent-mount <path>        Pin the collection with ParentRoutes<path>.
+  --parent-names <a,b>         Named providers inherited at the mount point.
+  --json <path>                Write the complete migration report as JSON.
+  --fail-on-manual             Fail when manual diagnostics are emitted.
+`);
+}
+runRoutesMigration(parseArgs(process.argv.slice(2)))
+    .then((result) => {
+    process.exitCode = result.exitCode;
+})
+    .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=craft-migrate-routes.js.map

package/src/bin/craft-migrate-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-migrate-routes.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-migrate-routes.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAIzE,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,YAAY;gBACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;gBACtB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,mBAAmB;gBACtB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,gBAAgB;gBACnB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC/D,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACrC,MAAM;YACR,KAAK,kBAAkB;gBACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC5B,MAAM;YACR,KAAK,QAAQ;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;gBAC/E,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAab,CAAC,CAAC;AACH,CAAC;AAED,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACjD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IACf,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACrC,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/src/bin/craft-migrate-services.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/bin/craft-migrate-services.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { runServicesMigration } from '../scripts/services/migrate-services.js';
+function parseArgs(argv) {
+    const options = { files: [] };
+    const files = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        switch (argument) {
+            case '--project':
+                options.tsConfigFilePath = argv[++index];
+                break;
+            case '--root':
+                options.rootDir = argv[++index];
+                break;
+            case '--config':
+                options.configFilePath = argv[++index];
+                break;
+            case '--dry-run':
+                options.write = false;
+                break;
+            case '--write':
+                options.write = true;
+                break;
+            case '--check':
+                options.check = true;
+                break;
+            case '--json':
+                if (argv[index + 1] && !argv[index + 1].startsWith('-'))
+                    options.jsonFilePath = argv[++index];
+                else
+                    options.json = true;
+                break;
+            case '--fail-on-manual':
+                options.failOnManual = true;
+                break;
+            case '--no-eslint':
+                options.eslint = false;
+                break;
+            case '--help':
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                if (argument.startsWith('-'))
+                    throw new Error(`Unknown argument: ${argument}`);
+                files.push(argument);
+        }
+    }
+    options.files = files;
+    return options;
+}
+function printHelp() {
+    console.log(`Usage: craft-migrate-services [files...] [options]
+
+Options:
+  --project <path>       Application tsconfig.
+  --root <dir>           Source root. Defaults to cwd.
+  --config <path>        craft-dev-tools.config.ts override.
+  --dry-run              Analyze without writing (default).
+  --write                Write migrated and companion files.
+  --check                Fail while legacy services remain.
+  --json [path]          Print JSON, or write it to path.
+  --fail-on-manual       Fail when manual diagnostics are emitted.
+  --no-eslint            Do not run ESLint --fix after --write.
+`);
+}
+runServicesMigration(parseArgs(process.argv.slice(2)))
+    .then((result) => {
+    process.exitCode = result.exitCode;
+})
+    .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=craft-migrate-services.js.map

package/src/bin/craft-migrate-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-migrate-services.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-migrate-services.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAI/E,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,UAAU;gBACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACvC,MAAM;YACR,KAAK,WAAW;gBACd,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;gBACtB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,SAAS;gBACZ,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;oBACrD,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;;oBAClC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;gBACzB,MAAM;YACR,KAAK,kBAAkB;gBACrB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC5B,MAAM;YACR,KAAK,aAAa;gBAChB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;gBACvB,MAAM;YACR,KAAK,QAAQ;gBACX,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,MAAM;YACR;gBACE,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;CAYb,CAAC,CAAC;AACH,CAAC;AAED,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;KACnD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IACf,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACrC,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/src/bin/craft-migrate.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/src/bin/craft-migrate.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import { runMigration } from '../scripts/migrate.js';
+function parseArgs(argv) {
+    const options = { files: [] };
+    const files = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        switch (argument) {
+            case '--project':
+            case '--tsconfig':
+                options.tsConfigFilePath = argv[++index];
+                break;
+            case '--root':
+                options.rootDir = argv[++index];
+                break;
+            case '--config':
+                options.configFilePath = argv[++index];
+                break;
+            case '--dry-run':
+                options.write = false;
+                break;
+            case '--write':
+                options.write = true;
+                break;
+            case '--check':
+                options.check = true;
+                break;
+            case '--json':
+                if (argv[index + 1] && !argv[index + 1].startsWith('-'))
+                    options.jsonFilePath = argv[++index];
+                else
+                    options.json = true;
+                break;
+            case '--fail-on-manual':
+                options.failOnManual = true;
+                break;
+            case '--no-eslint':
+                options.eslint = false;
+                break;
+            case '--collection-name':
+                options.collectionName = argv[++index];
+                break;
+            case '--parent-mount':
+                options.parentMount = argv[++index];
+                break;
+            case '--parent-names':
+                options.parentNames = argv[++index].split(',').filter(Boolean);
+                break;
+            case '--help':
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                if (argument.startsWith('-'))
+                    throw new Error(`Unknown argument: ${argument}`);
+                files.push(argument);
+        }
+    }
+    options.files = files;
+    return options;
+}
+function printHelp() {
+    console.log(`Usage: craft-migrate [files...] [options]
+
+Runs the primitive, service and route migrations in that order.
+
+Options:
+  --project, --tsconfig <path> Application tsconfig.
+  --root <dir>                 Source root. Defaults to cwd.
+  --config <path>              craft-dev-tools.config.ts override.
+  --dry-run                    Analyze without writing (default).
+  --write                      Write migrated files.
+  --check                      Fail while supported legacy code remains.
+  --json [path]                Print the combined report, or write it to path.
+  --fail-on-manual             Fail when manual diagnostics are emitted.
+  --no-eslint                  Do not run ESLint --fix after writes.
+  --collection-name <name>     Override the inferred root routes name.
+  --parent-mount <path>        Pin a route collection to its parent mount.
+  --parent-names <a,b>         Named providers inherited by the route collection.
+`);
+}
+runMigration(parseArgs(process.argv.slice(2)))
+    .then((result) => {
+    process.exitCode = result.exitCode;
+})
+    .catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=craft-migrate.js.map

package/src/bin/craft-migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-migrate.js","sourceRoot":"","sources":["../../../../../libs/dev-tools/src/bin/craft-migrate.ts"],"names":[],"mappings":"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"}

package/src/eslint-rules/index.cjs

@@ -22,6 +22,7 @@ const requirePendingComponentDiCheck = require('./require-pending-component-di-c
 const requireCraftExceptionHandler = require('./require-craft-exception-handler.cjs');
 const requireExceptionComponentDiCheck = require('./require-exception-component-di-check.cjs');
 const requireChildRouteMountCheck = require('./require-child-route-mount-check.cjs');
+const requireLazyLoadWithRetry = require('./require-lazy-load-with-retry.cjs');
 
 module.exports = {
   rules: {
@@ -50,5 +51,6 @@ module.exports = {
     'require-craft-exception-handler': requireCraftExceptionHandler,
     'require-exception-component-di-check': requireExceptionComponentDiCheck,
     'require-child-route-mount-check': requireChildRouteMountCheck,
+    'require-lazy-load-with-retry': requireLazyLoadWithRetry,
   },
 };