@craft-ng/dev-tools 0.5.0-beta.5 → 0.6.0-beta.1

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,164 @@ 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.
+
+For new routes, use the `craft` façade rather than the migration command:
+
+```bash
+npx craft route add /users/:userId --component src/app/users/user-detail.ts#UserDetailComponent
+npx craft route add /users/:userId --create-component users/user-detail
+npx craft route add /legacy --redirect-to /users --parent src/app/app.routes.ts#appRoutes
+npx craft route split --parent src/app/app.routes.ts#appRoutes --prefix users --target src/app/users/users.routes.ts
+```
+
+The same route engine is also published as a native Nx generator and as an
+Angular CLI schematic. Both use a virtual workspace tree, so their host CLI
+provides project-name resolution and `--dry-run` without direct filesystem
+writes:
+
+```bash
+# Nx workspace
+npx nx g @craft-ng/dev-tools:route /users/:userId \
+  --project=my-app \
+  --create-component=users/UserDetail
+
+npx nx g @craft-ng/dev-tools:route-split \
+  --project=my-app \
+  --parent=apps/my-app/src/app/app.routes.ts#appRoutes \
+  --prefix=users \
+  --target=apps/my-app/src/app/users/users.routes.ts
+
+# Angular CLI workspace
+npx ng g @craft-ng/dev-tools:route /users/:userId \
+  --project=my-app \
+  --create-component=users/UserDetail
+```
+
+Without route target options, the generator asks for the target kind. Component
+creation then asks for the path relative to the application's `src/app` base,
+followed by the component name. Before mutating the virtual tree it prints the
+planned `CREATE` and `UPDATE` operations and asks for confirmation. Use `--yes`
+for non-interactive automation; Nx/Angular `--dry-run` prints the preview without
+asking for confirmation or writing files.
+
+When `--parent` is omitted in an interactive terminal, the generator discovers
+every `craftRoutes(...)` collection in the selected Angular project and lists
+its exported routes name, source file, and prefix. Select `0` to retain route
+path-based auto-detection, or choose a collection number. Scripted calls can
+still pass `--parent=path/to/routes.ts#routesName` directly.
+
+Pass `--skip-validation` when another task will run lint and the Angular build.
+Otherwise validation runs after the virtual tree has been committed. Nx
+workspaces compose the native `@nx/angular:component` generator; Angular CLI
+workspaces compose the local `@schematics/angular:component` schematic. New
+components use an inline template and inline styles, so the generator creates a
+single component `.ts` file rather than separate `.ts`, `.html`, and `.css`
+files. Component filenames are always normalized to kebab-case: a component
+name such as `DemoPage` produces `demo-page.ts` while retaining the `DemoPage`
+class name.
+
+The add command defaults to a lazy routes file per feature and generates
+`componentDeps`, `withRetry`, the cascade DI proof, exception assertion,
+`.withParent`, and the parent mount assertion. Both commands print their plan
+before writing. `--dry-run`, `--yes`, `--json`, `--project`, `--parent`, and
+`--feature-file` support scripted usage. After writing, ESLint autofix and the
+project TypeScript diagnostics run automatically; failed validation leaves the
+changes in place and returns a non-zero exit code with diagnostics.
+Component creation uses the local Angular CLI in an `angular.json` workspace,
+or the local Nx Angular schematic in an `nx.json` workspace.
+
+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 +261,8 @@ 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',
+      'craft-ng/require-cascade-route-di-check': 'error',
     }
   }
 ];

package/generators.json

@@ -0,0 +1,26 @@
+{
+  "generators": {
+    "route": {
+      "factory": "./src/generators/route/generator#routeGenerator",
+      "schema": "./src/generators/route/schema.json",
+      "description": "Add a type-safe Craft NG route."
+    },
+    "route-split": {
+      "factory": "./src/generators/route/generator#routeSplitGenerator",
+      "schema": "./src/generators/route/split-schema.json",
+      "description": "Split Craft NG routes into a lazy collection."
+    }
+  },
+  "schematics": {
+    "route": {
+      "factory": "./src/generators/route/compat#routeSchematic",
+      "schema": "./src/generators/route/schema.json",
+      "description": "Add a type-safe Craft NG route."
+    },
+    "route-split": {
+      "factory": "./src/generators/route/compat#routeSplitSchematic",
+      "schema": "./src/generators/route/split-schema.json",
+      "description": "Split Craft NG routes into a lazy collection."
+    }
+  }
+}

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "@craft-ng/dev-tools",
-  "version": "0.5.0-beta.5",
+  "version": "0.6.0-beta.1",
   "description": "Development tools for ng-craft: ESLint configs, ESLint rules, and codemods",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ng-angular-stack/ng-craft.git"
+  },
   "type": "module",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -16,14 +20,23 @@
     },
     "./package.json": "./package.json"
   },
+  "generators": "./generators.json",
+  "schematics": "./generators.json",
   "bin": {
-    "craft-brand": "./src/bin/craft-brand.js"
+    "craft": "./src/bin/craft.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": [
+    "generators.json",
     "src/**/*",
     "README.md"
   ],
   "dependencies": {
+    "@nx/devkit": "^22.3.1",
     "tslib": "^2.3.0",
     "ts-morph": "^24.0.0",
     "ts-node": "^10.9.2",
@@ -31,6 +44,8 @@
   },
   "peerDependencies": {
     "@angular-eslint/eslint-plugin": ">=21.0.0",
+    "@nx/angular": ">=21.0.0 <24.0.0",
+    "@schematics/angular": ">=20.0.0 <23.0.0",
     "@typescript-eslint/eslint-plugin": ">=8.0.0",
     "eslint": ">=9.0.0"
   },
@@ -38,6 +53,12 @@
     "@angular-eslint/eslint-plugin": {
       "optional": true
     },
+    "@nx/angular": {
+      "optional": true
+    },
+    "@schematics/angular": {
+      "optional": true
+    },
     "@typescript-eslint/eslint-plugin": {
       "optional": true
     },

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 {};