@craft-ts/dev-tools 0.7.0-beta.13

package/src/scripts/migrate.js

@@ -0,0 +1,98 @@
+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';
+import { runComponentsMigration, } from './components/migrate-components.js';
+import { runArchitectureMigration, } from './architecture/migrate-architecture.js';
+export async function runMigration(options = {}) {
+    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/5 Migrating primitives and Signal Forms...');
+    const primitives = await runPrimitivesMigration({
+        ...shared,
+        eslint: options.eslint,
+    });
+    if (!options.json)
+        log('2/5 Migrating Angular services...');
+    const services = await runServicesMigration({
+        ...shared,
+        configFilePath: options.configFilePath,
+        eslint: options.eslint,
+    });
+    if (!options.json)
+        log('3/5 Migrating Angular routes...');
+    const routes = await runRoutesMigration({
+        ...shared,
+        collectionName: options.collectionName,
+        parentMount: options.parentMount,
+        parentNames: options.parentNames,
+    });
+    if (!options.json)
+        log('4/5 Migrating Craft components and directives...');
+    const components = await runComponentsMigration({
+        ...shared,
+        eslint: options.eslint,
+    });
+    if (!options.json)
+        log('5/5 Scaffolding architecture tests...');
+    const architecture = await runArchitectureMigration({
+        rootDir: options.rootDir,
+        tsConfigFilePath: options.tsConfigFilePath,
+        write: options.write,
+        check: options.check,
+        log: stepLog,
+    });
+    const result = {
+        primitives,
+        services,
+        routes,
+        components,
+        architecture,
+        changedFiles: [
+            ...new Set([
+                ...primitives.changedFiles,
+                ...services.changedFiles,
+                ...routes.changedFiles,
+                ...components.changedFiles,
+                ...architecture.changedFiles,
+            ]),
+        ],
+        diagnostics: {
+            primitives: primitives.diagnostics,
+            services: services.diagnostics,
+            routes: routes.diagnostics,
+            components: components.diagnostics,
+        },
+        exitCode: Math.max(primitives.exitCode, services.exitCode, routes.exitCode, components.exitCode, architecture.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 +
+            components.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,162 @@
+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';
+import {
+  runComponentsMigration,
+  type MigrateComponentsResult,
+} from './components/migrate-components.js';
+import {
+  runArchitectureMigration,
+  type MigrateArchitectureResult,
+} from './architecture/migrate-architecture.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;
+  components: MigrateComponentsResult;
+  architecture: MigrateArchitectureResult;
+  changedFiles: string[];
+  diagnostics: {
+    primitives: MigratePrimitivesResult['diagnostics'];
+    services: MigrateServicesResult['diagnostics'];
+    routes: MigrateRoutesResult['diagnostics'];
+    components: MigrateComponentsResult['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/5 Migrating primitives and Signal Forms...');
+  const primitives = await runPrimitivesMigration({
+    ...shared,
+    eslint: options.eslint,
+  });
+
+  if (!options.json) log('2/5 Migrating Angular services...');
+  const services = await runServicesMigration({
+    ...shared,
+    configFilePath: options.configFilePath,
+    eslint: options.eslint,
+  });
+
+  if (!options.json) log('3/5 Migrating Angular routes...');
+  const routes = await runRoutesMigration({
+    ...shared,
+    collectionName: options.collectionName,
+    parentMount: options.parentMount,
+    parentNames: options.parentNames,
+  });
+
+  if (!options.json) log('4/5 Migrating Craft components and directives...');
+  const components = await runComponentsMigration({
+    ...shared,
+    eslint: options.eslint,
+  });
+
+  if (!options.json) log('5/5 Scaffolding architecture tests...');
+  const architecture = await runArchitectureMigration({
+    rootDir: options.rootDir,
+    tsConfigFilePath: options.tsConfigFilePath,
+    write: options.write,
+    check: options.check,
+    log: stepLog,
+  });
+
+  const result: MigrateResult = {
+    primitives,
+    services,
+    routes,
+    components,
+    architecture,
+    changedFiles: [
+      ...new Set([
+        ...primitives.changedFiles,
+        ...services.changedFiles,
+        ...routes.changedFiles,
+        ...components.changedFiles,
+        ...architecture.changedFiles,
+      ]),
+    ],
+    diagnostics: {
+      primitives: primitives.diagnostics,
+      services: services.diagnostics,
+      routes: routes.diagnostics,
+      components: components.diagnostics,
+    },
+    exitCode: Math.max(
+      primitives.exitCode,
+      services.exitCode,
+      routes.exitCode,
+      components.exitCode,
+      architecture.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 +
+      components.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,67 @@
+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) {
+    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) => 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, ruleName, initializer) {
+    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) {
+    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-named-primitives.d.ts

@@ -0,0 +1,50 @@
+import { SourceFile } from 'ts-morph';
+/**
+ * Migrates call-sites to the *named* craft primitives.
+ *
+ * The five primitives now take their name as first argument and resolve to the
+ * primitive reference itself. `craftComputed` / `craftMethod` already take a
+ * name and also return their reference directly:
+ *
+ * ```ts
+ * const users = yield* query({ loader });      // before
+ * const users = yield* query('users', { loader });  // after
+ *
+ * const handleFoo = craftMethod('handleFoo', fn);       // unchanged
+ * ```
+ *
+ * The name is taken from the binding the call is assigned to:
+ *
+ * 1. `const X = <call>` → `const X = <call>` (the name literal is `'X'`).
+ * 2. `const X = craftUse(<call>)` → same, looking through `craftUse` / `yield*`.
+ * 3. Class fields and object properties keep the direct primitive reference.
+ * 4. For `craftComputed` / `craftMethod` the name literal already exists and
+ *    wins; the binding is left unchanged.
+ *
+ * Anything the codemod cannot name — an inline call with no binding, an
+ * existing destructuring pattern — is left untouched and reported so it can be
+ * fixed by hand.
+ */
+export declare const NAMED_PRIMITIVES: readonly ["state", "query", "mutation", "asyncProcess", "queryParams"];
+/** Helpers that already take a name literal; only their return shape changed. */
+export declare const PRE_NAMED_HELPERS: readonly ["craftComputed", "craftMethod"];
+export type NamedPrimitiveName = (typeof NAMED_PRIMITIVES)[number] | (typeof PRE_NAMED_HELPERS)[number];
+export type MigrateNamedPrimitivesOptions = {
+    paths: readonly string[];
+    write?: boolean;
+    log?: (message: string) => void;
+};
+export type UnmigratedCall = {
+    file: string;
+    line: number;
+    primitive: string;
+    reason: string;
+    text: string;
+};
+export type MigrateNamedPrimitivesResult = {
+    changedFiles: string[];
+    unmigrated: UnmigratedCall[];
+};
+export declare function migrateNamedPrimitives({ paths, write, log, }: MigrateNamedPrimitivesOptions): Promise<MigrateNamedPrimitivesResult>;
+/** Applies the named-primitive rewrite to an already loaded source file. */
+export declare function migrateNamedPrimitivesInFile(sourceFile: SourceFile, unmigrated?: UnmigratedCall[]): boolean;