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

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

@@ -0,0 +1,20 @@
+import type { ComponentMigrationDiagnostic } from './migration-diagnostic.js';
+export type MigrateComponentsOptions = {
+    rootDir?: string;
+    tsConfigFilePath?: string;
+    files?: readonly string[];
+    write?: boolean;
+    check?: boolean;
+    json?: boolean;
+    failOnManual?: boolean;
+    eslint?: boolean;
+    log?: (message: string) => void;
+};
+export type MigrateComponentsResult = {
+    changedFiles: string[];
+    diagnostics: ComponentMigrationDiagnostic[];
+    remainingLegacyComponents: number;
+    remainingLegacyDirectives: number;
+    exitCode: number;
+};
+export declare function runComponentsMigration(options?: MigrateComponentsOptions): Promise<MigrateComponentsResult>;

package/src/scripts/components/migrate-components.js

@@ -0,0 +1,163 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { Node, Project, QuoteKind, SyntaxKind, } from 'ts-morph';
+export async function runComponentsMigration(options = {}) {
+    const rootDir = resolve(options.rootDir ?? process.cwd());
+    const tsConfigFilePath = options.tsConfigFilePath
+        ? resolve(options.tsConfigFilePath)
+        : join(rootDir, 'tsconfig.json');
+    const project = new Project({
+        ...(existsSync(tsConfigFilePath) ? { tsConfigFilePath } : {}),
+        manipulationSettings: { quoteKind: QuoteKind.Single },
+        skipAddingFilesFromTsConfig: false,
+    });
+    project.addSourceFilesAtPaths([
+        join(rootDir, '**/*.ts'),
+        `!${join(rootDir, '**/node_modules/**')}`,
+        `!${join(rootDir, '**/dist/**')}`,
+        `!${join(rootDir, '**/.angular/**')}`,
+        `!${join(rootDir, '**/*.d.ts')}`,
+    ]);
+    const selected = options.files?.length
+        ? new Set(options.files.map((file) => resolve(rootDir, file)))
+        : undefined;
+    const sourceFiles = project.getSourceFiles().filter((file) => {
+        const path = resolve(file.getFilePath());
+        return path.startsWith(`${rootDir}/`) && (!selected || selected.has(path));
+    });
+    const touched = new Set();
+    const diagnostics = [];
+    const legacyComponentsBeforeMigration = sourceFiles.reduce((count, sourceFile) => count + countLegacyComponentCalls(sourceFile), 0);
+    for (const sourceFile of sourceFiles) {
+        const componentImport = sourceFile
+            .getImportDeclarations()
+            .flatMap((declaration) => declaration.getNamedImports())
+            .find((specifier) => specifier.getName() === 'component');
+        const componentNameNode = componentImport?.getNameNode();
+        const componentAliasNode = componentImport?.getAliasNode();
+        if (componentImport && componentAliasNode) {
+            if (componentAliasNode.getText() !== 'craftComponent') {
+                componentAliasNode.rename('craftComponent');
+            }
+            componentImport.setName('craftComponent').removeAlias();
+            touched.add(sourceFile);
+        }
+        else if (componentNameNode && Node.isIdentifier(componentNameNode)) {
+            if (componentNameNode.getText() !== 'craftComponent') {
+                componentNameNode.rename('craftComponent');
+                touched.add(sourceFile);
+            }
+        }
+        const componentCalls = sourceFile
+            .getDescendantsOfKind(SyntaxKind.CallExpression)
+            .filter((call) => call.getExpression().getText() === 'craftComponent');
+        for (const call of componentCalls.sort((a, b) => b.getStart() - a.getStart())) {
+            const name = declaredNameFor(call);
+            if (!name) {
+                diagnostics.push({
+                    code: 'NAME_NOT_DEDUCIBLE',
+                    filePath: sourceFile.getFilePath(),
+                    message: 'Could not infer the name for craftComponent(...).',
+                    manual: true,
+                });
+                continue;
+            }
+            if (!isStringLiteral(call.getArguments()[0])) {
+                call.insertArgument(0, `'${name}'`);
+                touched.add(sourceFile);
+            }
+        }
+        const directiveCalls = sourceFile
+            .getDescendantsOfKind(SyntaxKind.CallExpression)
+            .filter((call) => call.getExpression().getText() === 'craftDirective');
+        for (const call of directiveCalls.sort((a, b) => b.getStart() - a.getStart())) {
+            const name = declaredNameFor(call);
+            if (!name) {
+                diagnostics.push({
+                    code: 'NAME_NOT_DEDUCIBLE',
+                    filePath: sourceFile.getFilePath(),
+                    message: 'Could not infer the name for craftDirective(...).',
+                    manual: true,
+                });
+                continue;
+            }
+            if (!isStringLiteral(call.getArguments()[0])) {
+                call.insertArgument(0, `'${name}'`);
+                call.insertArgument(1, '{}');
+                touched.add(sourceFile);
+            }
+        }
+    }
+    if (options.write)
+        await Promise.all([...touched].map((file) => file.save()));
+    const remainingLegacyComponentsAfterMigration = sourceFiles.reduce((count, sourceFile) => {
+        const hasLegacyImport = sourceFile
+            .getImportDeclarations()
+            .flatMap((declaration) => declaration.getNamedImports())
+            .some((specifier) => specifier.getName() === 'component');
+        return hasLegacyImport
+            ? count + countCalls(sourceFile, 'component')
+            : count;
+    }, 0);
+    const remainingLegacyComponents = options.write
+        ? remainingLegacyComponentsAfterMigration
+        : legacyComponentsBeforeMigration;
+    const remainingLegacyDirectives = sourceFiles.reduce((count, sourceFile) => count + countCalls(sourceFile, 'craftDirective', true), 0);
+    const result = {
+        changedFiles: [...touched].map((file) => file.getFilePath()),
+        diagnostics,
+        remainingLegacyComponents,
+        remainingLegacyDirectives,
+        exitCode: (options.check &&
+            (remainingLegacyComponents > 0 || remainingLegacyDirectives > 0)) ||
+            (options.failOnManual && diagnostics.length > 0)
+            ? 1
+            : 0,
+    };
+    const log = options.log ?? console.log;
+    if (options.json)
+        log(JSON.stringify(result, null, 2));
+    else
+        log(`Components migration complete: ${result.changedFiles.length} changed file(s), ${diagnostics.length} manual diagnostic(s).`);
+    return result;
+}
+function declaredNameFor(call) {
+    let current = call;
+    while (current) {
+        if (Node.isVariableDeclaration(current) && current.getNameNode()) {
+            return current.getName();
+        }
+        if (Node.isPropertyDeclaration(current) ||
+            Node.isPropertyAssignment(current)) {
+            return current.getName();
+        }
+        current = current.getParent();
+    }
+    return undefined;
+}
+function isStringLiteral(node) {
+    return Boolean(node &&
+        (Node.isStringLiteral(node) ||
+            (Node.isNoSubstitutionTemplateLiteral(node) && node.getLiteralText())));
+}
+function countCalls(sourceFile, name, migrated = false) {
+    return sourceFile
+        .getDescendantsOfKind(SyntaxKind.CallExpression)
+        .filter((call) => {
+        const expression = call.getExpression().getText();
+        return migrated
+            ? expression === name && !isStringLiteral(call.getArguments()[0])
+            : expression === name;
+    }).length;
+}
+function countLegacyComponentCalls(sourceFile) {
+    const localNames = new Set(sourceFile
+        .getImportDeclarations()
+        .flatMap((declaration) => declaration.getNamedImports())
+        .filter((specifier) => specifier.getName() === 'component')
+        .map((specifier) => specifier.getAliasNode()?.getText() ?? 'component'));
+    return sourceFile
+        .getDescendantsOfKind(SyntaxKind.CallExpression)
+        .filter((call) => localNames.has(call.getExpression().getText())).length;
+}
+//# sourceMappingURL=migrate-components.js.map

package/src/scripts/components/migrate-components.js.map

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

package/src/scripts/components/migrate-components.ts

@@ -0,0 +1,227 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import {
+  Node,
+  Project,
+  QuoteKind,
+  SourceFile,
+  SyntaxKind,
+  type CallExpression,
+} from 'ts-morph';
+import type { ComponentMigrationDiagnostic } from './migration-diagnostic.js';
+
+export type MigrateComponentsOptions = {
+  rootDir?: string;
+  tsConfigFilePath?: string;
+  files?: readonly string[];
+  write?: boolean;
+  check?: boolean;
+  json?: boolean;
+  failOnManual?: boolean;
+  eslint?: boolean;
+  log?: (message: string) => void;
+};
+
+export type MigrateComponentsResult = {
+  changedFiles: string[];
+  diagnostics: ComponentMigrationDiagnostic[];
+  remainingLegacyComponents: number;
+  remainingLegacyDirectives: number;
+  exitCode: number;
+};
+
+export async function runComponentsMigration(
+  options: MigrateComponentsOptions = {},
+): Promise<MigrateComponentsResult> {
+  const rootDir = resolve(options.rootDir ?? process.cwd());
+  const tsConfigFilePath = options.tsConfigFilePath
+    ? resolve(options.tsConfigFilePath)
+    : join(rootDir, 'tsconfig.json');
+  const project = new Project({
+    ...(existsSync(tsConfigFilePath) ? { tsConfigFilePath } : {}),
+    manipulationSettings: { quoteKind: QuoteKind.Single },
+    skipAddingFilesFromTsConfig: false,
+  });
+  project.addSourceFilesAtPaths([
+    join(rootDir, '**/*.ts'),
+    `!${join(rootDir, '**/node_modules/**')}`,
+    `!${join(rootDir, '**/dist/**')}`,
+    `!${join(rootDir, '**/.angular/**')}`,
+    `!${join(rootDir, '**/*.d.ts')}`,
+  ]);
+
+  const selected = options.files?.length
+    ? new Set(options.files.map((file) => resolve(rootDir, file)))
+    : undefined;
+  const sourceFiles = project.getSourceFiles().filter((file) => {
+    const path = resolve(file.getFilePath());
+    return path.startsWith(`${rootDir}/`) && (!selected || selected.has(path));
+  });
+  const touched = new Set<SourceFile>();
+  const diagnostics: ComponentMigrationDiagnostic[] = [];
+  const legacyComponentsBeforeMigration = sourceFiles.reduce(
+    (count, sourceFile) => count + countLegacyComponentCalls(sourceFile),
+    0,
+  );
+
+  for (const sourceFile of sourceFiles) {
+    const componentImport = sourceFile
+      .getImportDeclarations()
+      .flatMap((declaration) => declaration.getNamedImports())
+      .find((specifier) => specifier.getName() === 'component');
+    const componentNameNode = componentImport?.getNameNode();
+    const componentAliasNode = componentImport?.getAliasNode();
+    if (componentImport && componentAliasNode) {
+      if (componentAliasNode.getText() !== 'craftComponent') {
+        componentAliasNode.rename('craftComponent');
+      }
+      componentImport.setName('craftComponent').removeAlias();
+      touched.add(sourceFile);
+    } else if (componentNameNode && Node.isIdentifier(componentNameNode)) {
+      if (componentNameNode.getText() !== 'craftComponent') {
+        componentNameNode.rename('craftComponent');
+        touched.add(sourceFile);
+      }
+    }
+
+    const componentCalls = sourceFile
+      .getDescendantsOfKind(SyntaxKind.CallExpression)
+      .filter((call) => call.getExpression().getText() === 'craftComponent');
+    for (const call of componentCalls.sort(
+      (a, b) => b.getStart() - a.getStart(),
+    )) {
+      const name = declaredNameFor(call);
+      if (!name) {
+        diagnostics.push({
+          code: 'NAME_NOT_DEDUCIBLE',
+          filePath: sourceFile.getFilePath(),
+          message: 'Could not infer the name for craftComponent(...).',
+          manual: true,
+        });
+        continue;
+      }
+      if (!isStringLiteral(call.getArguments()[0])) {
+        call.insertArgument(0, `'${name}'`);
+        touched.add(sourceFile);
+      }
+    }
+
+    const directiveCalls = sourceFile
+      .getDescendantsOfKind(SyntaxKind.CallExpression)
+      .filter((call) => call.getExpression().getText() === 'craftDirective');
+    for (const call of directiveCalls.sort(
+      (a, b) => b.getStart() - a.getStart(),
+    )) {
+      const name = declaredNameFor(call);
+      if (!name) {
+        diagnostics.push({
+          code: 'NAME_NOT_DEDUCIBLE',
+          filePath: sourceFile.getFilePath(),
+          message: 'Could not infer the name for craftDirective(...).',
+          manual: true,
+        });
+        continue;
+      }
+      if (!isStringLiteral(call.getArguments()[0])) {
+        call.insertArgument(0, `'${name}'`);
+        call.insertArgument(1, '{}');
+        touched.add(sourceFile);
+      }
+    }
+  }
+
+  if (options.write) await Promise.all([...touched].map((file) => file.save()));
+
+  const remainingLegacyComponentsAfterMigration = sourceFiles.reduce(
+    (count, sourceFile) => {
+      const hasLegacyImport = sourceFile
+        .getImportDeclarations()
+        .flatMap((declaration) => declaration.getNamedImports())
+        .some((specifier) => specifier.getName() === 'component');
+      return hasLegacyImport
+        ? count + countCalls(sourceFile, 'component')
+        : count;
+    },
+    0,
+  );
+  const remainingLegacyComponents = options.write
+    ? remainingLegacyComponentsAfterMigration
+    : legacyComponentsBeforeMigration;
+  const remainingLegacyDirectives = sourceFiles.reduce(
+    (count, sourceFile) =>
+      count + countCalls(sourceFile, 'craftDirective', true),
+    0,
+  );
+  const result: MigrateComponentsResult = {
+    changedFiles: [...touched].map((file) => file.getFilePath()),
+    diagnostics,
+    remainingLegacyComponents,
+    remainingLegacyDirectives,
+    exitCode:
+      (options.check &&
+        (remainingLegacyComponents > 0 || remainingLegacyDirectives > 0)) ||
+      (options.failOnManual && diagnostics.length > 0)
+        ? 1
+        : 0,
+  };
+  const log = options.log ?? console.log;
+  if (options.json) log(JSON.stringify(result, null, 2));
+  else
+    log(
+      `Components migration complete: ${result.changedFiles.length} changed file(s), ${diagnostics.length} manual diagnostic(s).`,
+    );
+  return result;
+}
+
+function declaredNameFor(call: CallExpression): string | undefined {
+  let current: Node | undefined = call;
+  while (current) {
+    if (Node.isVariableDeclaration(current) && current.getNameNode()) {
+      return current.getName();
+    }
+    if (
+      Node.isPropertyDeclaration(current) ||
+      Node.isPropertyAssignment(current)
+    ) {
+      return current.getName();
+    }
+    current = current.getParent();
+  }
+  return undefined;
+}
+
+function isStringLiteral(node: Node | undefined): boolean {
+  return Boolean(
+    node &&
+      (Node.isStringLiteral(node) ||
+        (Node.isNoSubstitutionTemplateLiteral(node) && node.getLiteralText())),
+  );
+}
+
+function countCalls(
+  sourceFile: SourceFile,
+  name: string,
+  migrated = false,
+): number {
+  return sourceFile
+    .getDescendantsOfKind(SyntaxKind.CallExpression)
+    .filter((call) => {
+      const expression = call.getExpression().getText();
+      return migrated
+        ? expression === name && !isStringLiteral(call.getArguments()[0])
+        : expression === name;
+    }).length;
+}
+
+function countLegacyComponentCalls(sourceFile: SourceFile): number {
+  const localNames = new Set(
+    sourceFile
+      .getImportDeclarations()
+      .flatMap((declaration) => declaration.getNamedImports())
+      .filter((specifier) => specifier.getName() === 'component')
+      .map((specifier) => specifier.getAliasNode()?.getText() ?? 'component'),
+  );
+  return sourceFile
+    .getDescendantsOfKind(SyntaxKind.CallExpression)
+    .filter((call) => localNames.has(call.getExpression().getText())).length;
+}

package/src/scripts/components/migration-diagnostic.d.ts

@@ -0,0 +1,7 @@
+export type ComponentMigrationDiagnosticCode = 'NAME_NOT_DEDUCIBLE';
+export type ComponentMigrationDiagnostic = {
+    code: ComponentMigrationDiagnosticCode;
+    filePath: string;
+    message: string;
+    manual: true;
+};

package/src/scripts/components/migration-diagnostic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration-diagnostic.js.map

package/src/scripts/components/migration-diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-diagnostic.js","sourceRoot":"","sources":["../../../../../../libs/dev-tools/src/scripts/components/migration-diagnostic.ts"],"names":[],"mappings":""}

package/src/scripts/components/migration-diagnostic.ts

@@ -0,0 +1,8 @@
+export type ComponentMigrationDiagnosticCode = 'NAME_NOT_DEDUCIBLE';
+
+export type ComponentMigrationDiagnostic = {
+  code: ComponentMigrationDiagnosticCode;
+  filePath: string;
+  message: string;
+  manual: true;
+};

package/src/scripts/create/create-project.d.ts

@@ -0,0 +1,20 @@
+export declare const CRAFT_TS_STARTER_VERSION = "^0.7.0-beta.11";
+export declare const EFFECT_V4_VERSION = "^4.0.0-rc.110";
+export type CreateAgent = 'codex' | 'cursor' | 'claude-code' | 'cloud-code';
+export type CreateMode = 'effect' | 'plain';
+export type CreateProjectOptions = {
+    readonly directory: string;
+    readonly rootDir?: string;
+    readonly mode?: CreateMode;
+    readonly agents?: readonly CreateAgent[];
+    readonly force?: boolean;
+};
+export type CreateProjectResult = {
+    readonly directory: string;
+    readonly mode: CreateMode;
+    readonly agents: readonly CreateAgent[];
+    readonly changedFiles: readonly string[];
+};
+export declare function parseCreateAgents(value: string | undefined): readonly CreateAgent[];
+export declare function createCraftProject(options: CreateProjectOptions): Promise<CreateProjectResult>;
+export declare function createModeFromFlag(value: string | undefined): CreateMode | undefined;