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

package/src/scripts/migrate.d.ts

@@ -0,0 +1,32 @@
+import { type MigratePrimitivesResult } from './primitives/migrate-primitives.js';
+import { type MigrateRoutesResult } from './routes/migrate-routes.js';
+import { type MigrateServicesResult } from './services/migrate-services.js';
+export type MigrateOptions = {
+    rootDir?: string;
+    tsConfigFilePath?: string;
+    configFilePath?: string;
+    files?: readonly string[];
+    write?: boolean;
+    check?: boolean;
+    json?: boolean;
+    jsonFilePath?: string;
+    failOnManual?: boolean;
+    eslint?: boolean;
+    collectionName?: string;
+    parentMount?: string;
+    parentNames?: readonly string[];
+    log?: (message: string) => void;
+};
+export type MigrateResult = {
+    primitives: MigratePrimitivesResult;
+    services: MigrateServicesResult;
+    routes: MigrateRoutesResult;
+    changedFiles: string[];
+    diagnostics: {
+        primitives: MigratePrimitivesResult['diagnostics'];
+        services: MigrateServicesResult['diagnostics'];
+        routes: MigrateRoutesResult['diagnostics'];
+    };
+    exitCode: number;
+};
+export declare function runMigration(options?: MigrateOptions): Promise<MigrateResult>;

package/src/scripts/migrate.js

@@ -0,0 +1,67 @@
+import { __awaiter } from "tslib";
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { runPrimitivesMigration, } from './primitives/migrate-primitives.js';
+import { runRoutesMigration, } from './routes/migrate-routes.js';
+import { runServicesMigration, } from './services/migrate-services.js';
+export function runMigration() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a;
+        const log = (_a = options.log) !== null && _a !== void 0 ? _a : console.log;
+        const stepLog = options.json ? () => undefined : log;
+        const shared = {
+            rootDir: options.rootDir,
+            tsConfigFilePath: options.tsConfigFilePath,
+            files: options.files,
+            write: options.write,
+            check: options.check,
+            failOnManual: options.failOnManual,
+            log: stepLog,
+        };
+        if (!options.json)
+            log('1/3 Migrating primitives and Signal Forms...');
+        const primitives = yield runPrimitivesMigration(Object.assign(Object.assign({}, shared), { eslint: options.eslint }));
+        if (!options.json)
+            log('2/3 Migrating Angular services...');
+        const services = yield runServicesMigration(Object.assign(Object.assign({}, shared), { configFilePath: options.configFilePath, eslint: options.eslint }));
+        if (!options.json)
+            log('3/3 Migrating Angular routes...');
+        const routes = yield runRoutesMigration(Object.assign(Object.assign({}, shared), { collectionName: options.collectionName, parentMount: options.parentMount, parentNames: options.parentNames }));
+        const result = {
+            primitives,
+            services,
+            routes,
+            changedFiles: [
+                ...new Set([
+                    ...primitives.changedFiles,
+                    ...services.changedFiles,
+                    ...routes.changedFiles,
+                ]),
+            ],
+            diagnostics: {
+                primitives: primitives.diagnostics,
+                services: services.diagnostics,
+                routes: routes.diagnostics,
+            },
+            exitCode: Math.max(primitives.exitCode, services.exitCode, routes.exitCode),
+        };
+        if (options.jsonFilePath) {
+            const path = resolve(options.jsonFilePath);
+            yield mkdir(dirname(path), { recursive: true });
+            yield writeFile(path, `${JSON.stringify(result, null, 2)}\n`, 'utf8');
+        }
+        if (options.json)
+            log(JSON.stringify(result, null, 2));
+        else {
+            const manualCount = primitives.diagnostics.length +
+                services.diagnostics.length +
+                routes.diagnostics.length;
+            log(`Migration complete: ${result.changedFiles.length} changed file(s), ${manualCount} manual diagnostic(s).`);
+            if (manualCount > 0) {
+                log('Review the diagnostics, then run the project type-check, tests and production build.');
+            }
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/src/scripts/migrate.js.map

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

package/src/scripts/migrate.ts

@@ -0,0 +1,128 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import {
+  runPrimitivesMigration,
+  type MigratePrimitivesResult,
+} from './primitives/migrate-primitives.js';
+import {
+  runRoutesMigration,
+  type MigrateRoutesResult,
+} from './routes/migrate-routes.js';
+import {
+  runServicesMigration,
+  type MigrateServicesResult,
+} from './services/migrate-services.js';
+
+export type MigrateOptions = {
+  rootDir?: string;
+  tsConfigFilePath?: string;
+  configFilePath?: string;
+  files?: readonly string[];
+  write?: boolean;
+  check?: boolean;
+  json?: boolean;
+  jsonFilePath?: string;
+  failOnManual?: boolean;
+  eslint?: boolean;
+  collectionName?: string;
+  parentMount?: string;
+  parentNames?: readonly string[];
+  log?: (message: string) => void;
+};
+
+export type MigrateResult = {
+  primitives: MigratePrimitivesResult;
+  services: MigrateServicesResult;
+  routes: MigrateRoutesResult;
+  changedFiles: string[];
+  diagnostics: {
+    primitives: MigratePrimitivesResult['diagnostics'];
+    services: MigrateServicesResult['diagnostics'];
+    routes: MigrateRoutesResult['diagnostics'];
+  };
+  exitCode: number;
+};
+
+export async function runMigration(
+  options: MigrateOptions = {},
+): Promise<MigrateResult> {
+  const log = options.log ?? console.log;
+  const stepLog = options.json ? () => undefined : log;
+  const shared = {
+    rootDir: options.rootDir,
+    tsConfigFilePath: options.tsConfigFilePath,
+    files: options.files,
+    write: options.write,
+    check: options.check,
+    failOnManual: options.failOnManual,
+    log: stepLog,
+  };
+
+  if (!options.json) log('1/3 Migrating primitives and Signal Forms...');
+  const primitives = await runPrimitivesMigration({
+    ...shared,
+    eslint: options.eslint,
+  });
+
+  if (!options.json) log('2/3 Migrating Angular services...');
+  const services = await runServicesMigration({
+    ...shared,
+    configFilePath: options.configFilePath,
+    eslint: options.eslint,
+  });
+
+  if (!options.json) log('3/3 Migrating Angular routes...');
+  const routes = await runRoutesMigration({
+    ...shared,
+    collectionName: options.collectionName,
+    parentMount: options.parentMount,
+    parentNames: options.parentNames,
+  });
+
+  const result: MigrateResult = {
+    primitives,
+    services,
+    routes,
+    changedFiles: [
+      ...new Set([
+        ...primitives.changedFiles,
+        ...services.changedFiles,
+        ...routes.changedFiles,
+      ]),
+    ],
+    diagnostics: {
+      primitives: primitives.diagnostics,
+      services: services.diagnostics,
+      routes: routes.diagnostics,
+    },
+    exitCode: Math.max(
+      primitives.exitCode,
+      services.exitCode,
+      routes.exitCode,
+    ),
+  };
+
+  if (options.jsonFilePath) {
+    const path = resolve(options.jsonFilePath);
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(result, null, 2)}\n`, 'utf8');
+  }
+
+  if (options.json) log(JSON.stringify(result, null, 2));
+  else {
+    const manualCount =
+      primitives.diagnostics.length +
+      services.diagnostics.length +
+      routes.diagnostics.length;
+    log(
+      `Migration complete: ${result.changedFiles.length} changed file(s), ${manualCount} manual diagnostic(s).`,
+    );
+    if (manualCount > 0) {
+      log(
+        'Review the diagnostics, then run the project type-check, tests and production build.',
+      );
+    }
+  }
+
+  return result;
+}

package/src/scripts/migration-workspace.d.ts

@@ -0,0 +1,2 @@
+import { Project, SourceFile } from 'ts-morph';
+export declare function migrateEslintConfig(project: Project, searchFromDir: string): SourceFile | undefined;

package/src/scripts/migration-workspace.js

@@ -0,0 +1,72 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { Node, SyntaxKind } from 'ts-morph';
+const ESLINT_CONFIG_NAMES = [
+    'eslint.config.js',
+    'eslint.config.mjs',
+    'eslint.config.cjs',
+    'eslint.config.ts',
+    'eslint.config.mts',
+    'eslint.config.cts',
+];
+export function migrateEslintConfig(project, searchFromDir) {
+    var _a, _b;
+    const filePath = findUp(searchFromDir, ESLINT_CONFIG_NAMES);
+    if (!filePath)
+        return undefined;
+    const sourceFile = (_a = project.getSourceFile(filePath)) !== null && _a !== void 0 ? _a : project.addSourceFileAtPath(filePath);
+    const rulesObjects = sourceFile
+        .getDescendantsOfKind(SyntaxKind.PropertyAssignment)
+        .filter((property) => property.getName() === 'rules')
+        .map((property) => ({
+        config: property.getFirstAncestorByKind(SyntaxKind.ObjectLiteralExpression),
+        rules: property.getInitializer(),
+    }))
+        .filter((entry) => Boolean(entry.config && Node.isObjectLiteralExpression(entry.rules)));
+    const rulesEntry = (_b = rulesObjects.find((entry) => {
+        var _a, _b;
+        return /\*\*\/\*\.ts|\.tsx|\[jt\]s/.test((_b = (_a = entry.config.getProperty('files')) === null || _a === void 0 ? void 0 : _a.getText()) !== null && _b !== void 0 ? _b : '');
+    })) !== null && _b !== void 0 ? _b : rulesObjects.at(-1);
+    const rules = rulesEntry && Node.isObjectLiteralExpression(rulesEntry.rules)
+        ? rulesEntry.rules
+        : undefined;
+    if (!rules)
+        return undefined;
+    const changedReturnTypeRule = setRule(rules, '@typescript-eslint/explicit-function-return-type', "'off'");
+    const changedEmptyObjectRule = setRule(rules, '@typescript-eslint/no-empty-object-type', "['error', { allowObjectTypes: 'always' }]");
+    return changedReturnTypeRule || changedEmptyObjectRule ? sourceFile : undefined;
+}
+function setRule(rules, ruleName, initializer) {
+    var _a;
+    const existing = rules.getProperty((property) => Node.isPropertyAssignment(property) &&
+        getPropertyName(property.getNameNode()) === ruleName);
+    if (Node.isPropertyAssignment(existing)) {
+        if (((_a = existing.getInitializer()) === null || _a === void 0 ? void 0 : _a.getText()) === initializer)
+            return false;
+        existing.setInitializer(initializer);
+    }
+    else {
+        rules.addPropertyAssignment({ name: `'${ruleName}'`, initializer });
+    }
+    return true;
+}
+function getPropertyName(node) {
+    return Node.isStringLiteral(node) || Node.isNoSubstitutionTemplateLiteral(node)
+        ? node.getLiteralValue()
+        : node.getText();
+}
+function findUp(startDir, names) {
+    let current = resolve(startDir);
+    while (true) {
+        for (const name of names) {
+            const candidate = join(current, name);
+            if (existsSync(candidate))
+                return candidate;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+//# sourceMappingURL=migration-workspace.js.map

package/src/scripts/migration-workspace.js.map

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

package/src/scripts/migration-workspace.ts

@@ -0,0 +1,93 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { Node, Project, SourceFile, SyntaxKind } from 'ts-morph';
+
+const ESLINT_CONFIG_NAMES = [
+  'eslint.config.js',
+  'eslint.config.mjs',
+  'eslint.config.cjs',
+  'eslint.config.ts',
+  'eslint.config.mts',
+  'eslint.config.cts',
+];
+
+export function migrateEslintConfig(
+  project: Project,
+  searchFromDir: string,
+): SourceFile | undefined {
+  const filePath = findUp(searchFromDir, ESLINT_CONFIG_NAMES);
+  if (!filePath) return undefined;
+  const sourceFile =
+    project.getSourceFile(filePath) ?? project.addSourceFileAtPath(filePath);
+  const rulesObjects = sourceFile
+    .getDescendantsOfKind(SyntaxKind.PropertyAssignment)
+    .filter((property) => property.getName() === 'rules')
+    .map((property) => ({
+      config: property.getFirstAncestorByKind(SyntaxKind.ObjectLiteralExpression),
+      rules: property.getInitializer(),
+    }))
+    .filter(
+      (entry): entry is { config: NonNullable<typeof entry.config>; rules: NonNullable<typeof entry.rules> } =>
+        Boolean(entry.config && Node.isObjectLiteralExpression(entry.rules)),
+    );
+  const rulesEntry =
+    rulesObjects.find((entry) =>
+      /\*\*\/\*\.ts|\.tsx|\[jt\]s/.test(
+        entry.config.getProperty('files')?.getText() ?? '',
+      ),
+    ) ?? rulesObjects.at(-1);
+  const rules =
+    rulesEntry && Node.isObjectLiteralExpression(rulesEntry.rules)
+      ? rulesEntry.rules
+      : undefined;
+  if (!rules) return undefined;
+  const changedReturnTypeRule = setRule(
+    rules,
+    '@typescript-eslint/explicit-function-return-type',
+    "'off'",
+  );
+  const changedEmptyObjectRule = setRule(
+    rules,
+    '@typescript-eslint/no-empty-object-type',
+    "['error', { allowObjectTypes: 'always' }]",
+  );
+  return changedReturnTypeRule || changedEmptyObjectRule ? sourceFile : undefined;
+}
+
+function setRule(
+  rules: import('ts-morph').ObjectLiteralExpression,
+  ruleName: string,
+  initializer: string,
+): boolean {
+  const existing = rules.getProperty(
+    (property) =>
+      Node.isPropertyAssignment(property) &&
+      getPropertyName(property.getNameNode()) === ruleName,
+  );
+  if (Node.isPropertyAssignment(existing)) {
+    if (existing.getInitializer()?.getText() === initializer) return false;
+    existing.setInitializer(initializer);
+  } else {
+    rules.addPropertyAssignment({ name: `'${ruleName}'`, initializer });
+  }
+  return true;
+}
+
+function getPropertyName(node: Node): string {
+  return Node.isStringLiteral(node) || Node.isNoSubstitutionTemplateLiteral(node)
+    ? node.getLiteralValue()
+    : node.getText();
+}
+
+function findUp(startDir: string, names: readonly string[]): string | undefined {
+  let current = resolve(startDir);
+  while (true) {
+    for (const name of names) {
+      const candidate = join(current, name);
+      if (existsSync(candidate)) return candidate;
+    }
+    const parent = dirname(current);
+    if (parent === current) return undefined;
+    current = parent;
+  }
+}

package/src/scripts/primitives/migrate-primitives.d.ts

@@ -0,0 +1,27 @@
+import type { PrimitiveMigrationDiagnostic } from './migration-diagnostic.js';
+export type MigratePrimitivesOptions = {
+    rootDir?: string;
+    tsConfigFilePath?: string;
+    files?: readonly string[];
+    write?: boolean;
+    check?: boolean;
+    json?: boolean;
+    jsonFilePath?: string;
+    failOnManual?: boolean;
+    eslint?: boolean;
+    log?: (message: string) => void;
+};
+export type MigratedPrimitiveFile = {
+    filePath: string;
+    changed: boolean;
+};
+export type MigratePrimitivesResult = {
+    changedFiles: string[];
+    files: MigratedPrimitiveFile[];
+    diagnostics: PrimitiveMigrationDiagnostic[];
+    remainingAngularSignals: number;
+    remainingSignalForms: number;
+    eslintRan: boolean;
+    exitCode: number;
+};
+export declare function runPrimitivesMigration(options?: MigratePrimitivesOptions): Promise<MigratePrimitivesResult>;