@akanjs/devkit 1.0.20 → 2.1.0-rc.1

package/esm/src/getCredentials.js

@@ -1,11 +0,0 @@
-import fs from "fs";
-import yaml from "js-yaml";
-const getCredentials = (app, environment) => {
-  const secret = yaml.load(
-    fs.readFileSync(`${app.workspace.workspaceRoot}/infra/app/values/${app.name}-secret.yaml`, "utf-8")
-  );
-  return secret[environment];
-};
-export {
-  getCredentials
-};

package/esm/src/getDirname.js

@@ -1,5 +0,0 @@
-import path from "path";
-const getDirname = (url) => path.dirname(new URL(url).pathname);
-export {
-  getDirname
-};

package/esm/src/getModelFileData.js

@@ -1,33 +0,0 @@
-import fs from "fs";
-const getModelFileData = (modulePath, modelName) => {
-  const moduleType = modulePath.startsWith("apps") ? "app" : "lib";
-  const moduleName = modulePath.split("/")[1];
-  const constantFilePath = `${modulePath}/lib/${modelName}/${modelName}.constant.ts`;
-  const unitFilePath = `${modulePath}/lib/${modelName}/${modelName}.Unit.tsx`;
-  const viewFilePath = `${modulePath}/lib/${modelName}/${modelName}.View.tsx`;
-  const constantFileStr = fs.readFileSync(constantFilePath, "utf8");
-  const unitFileStr = fs.readFileSync(unitFilePath, "utf8");
-  const viewFileStr = fs.readFileSync(viewFilePath, "utf8");
-  const constantFileLines = constantFileStr.split("\n");
-  const importLibNames = constantFileLines.filter((line) => line.startsWith("import { cnst as ")).map((line) => line.split("cnst as ")[1].split(" ")[0]);
-  const importLocalPaths = constantFileLines.filter((line) => line.startsWith("import { ") && line.includes('from "../')).map((line) => line.split("from ")[1].split('"')[1]);
-  const importModelNames = importLocalPaths.map((path) => path.split("/")[1]).filter((name) => !name.startsWith("_"));
-  const hasImportScalar = !!importLocalPaths.map((path) => path.split("/")[1]).filter((name) => name.startsWith("_")).length;
-  return {
-    moduleType,
-    moduleName,
-    modelName,
-    constantFilePath,
-    unitFilePath,
-    viewFilePath,
-    importModelNames,
-    hasImportScalar,
-    importLibNames,
-    constantFileStr,
-    unitFileStr,
-    viewFileStr
-  };
-};
-export {
-  getModelFileData
-};

package/esm/src/getRelatedCnsts.js

@@ -1,221 +0,0 @@
-import * as fs from "fs";
-import ora from "ora";
-import * as ts from "typescript";
-const parseTsConfig = (tsConfigPath = "./tsconfig.json") => {
-  const configFile = ts.readConfigFile(tsConfigPath, (path) => {
-    return ts.sys.readFile(path);
-  });
-  return ts.parseJsonConfigFileContent(
-    configFile.config,
-    ts.sys,
-    fs.realpathSync(tsConfigPath).replace(/[^/\\]+$/, "")
-  );
-};
-const collectImportedFiles = (constantFilePath, parsedConfig) => {
-  const allFilesToAnalyze = /* @__PURE__ */ new Set([constantFilePath]);
-  const analyzedFiles = /* @__PURE__ */ new Set();
-  const spinner = ora("Collecting related files...");
-  spinner.start();
-  function collectImported(filePath) {
-    if (analyzedFiles.has(filePath))
-      return;
-    analyzedFiles.add(filePath);
-    const tempProgram = ts.createProgram([filePath], parsedConfig.options);
-    const source = tempProgram.getSourceFile(filePath);
-    if (!source)
-      return;
-    function collectImports(node) {
-      if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
-        const importPath = node.moduleSpecifier.text;
-        if (importPath.startsWith(".")) {
-          const resolved = ts.resolveModuleName(importPath, filePath, parsedConfig.options, ts.sys).resolvedModule?.resolvedFileName;
-          if (resolved && !allFilesToAnalyze.has(resolved)) {
-            allFilesToAnalyze.add(resolved);
-            collectImported(resolved);
-          }
-        }
-      }
-      ts.forEachChild(node, collectImports);
-    }
-    collectImports(source);
-  }
-  collectImported(constantFilePath);
-  spinner.succeed(`Found ${allFilesToAnalyze.size} related files.`);
-  return {
-    allFilesToAnalyze,
-    analyzedFiles
-  };
-};
-const collectExportedFiles = (constantFilePath, parsedConfig) => {
-  const allFilesToAnalyze = /* @__PURE__ */ new Set([constantFilePath]);
-  const analyzedFiles = /* @__PURE__ */ new Set();
-  const spinner = ora("Collecting files from exports...");
-  spinner.start();
-  function collectExported(filePath) {
-    if (analyzedFiles.has(filePath))
-      return;
-    analyzedFiles.add(filePath);
-    const tempProgram = ts.createProgram([filePath], parsedConfig.options);
-    const source = tempProgram.getSourceFile(filePath);
-    if (!source)
-      return;
-    function collectExports(node) {
-      if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier) && !node.exportClause) {
-        const exportPath = node.moduleSpecifier.text;
-        if (exportPath.startsWith(".")) {
-          const resolved = ts.resolveModuleName(exportPath, filePath, parsedConfig.options, ts.sys).resolvedModule?.resolvedFileName;
-          if (resolved && !allFilesToAnalyze.has(resolved)) {
-            allFilesToAnalyze.add(resolved);
-            collectExported(resolved);
-          }
-        }
-      } else if (ts.isExportDeclaration(node) && node.exportClause && ts.isNamedExports(node.exportClause) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) {
-        const exportPath = node.moduleSpecifier.text;
-        if (exportPath.startsWith(".")) {
-          const resolved = ts.resolveModuleName(exportPath, filePath, parsedConfig.options, ts.sys).resolvedModule?.resolvedFileName;
-          if (resolved && !allFilesToAnalyze.has(resolved)) {
-            allFilesToAnalyze.add(resolved);
-            collectExported(resolved);
-          }
-        }
-      } else if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
-        const importPath = node.moduleSpecifier.text;
-        if (importPath.startsWith(".")) {
-          const resolved = ts.resolveModuleName(importPath, filePath, parsedConfig.options, ts.sys).resolvedModule?.resolvedFileName;
-          if (resolved && !allFilesToAnalyze.has(resolved)) {
-            allFilesToAnalyze.add(resolved);
-            collectExported(resolved);
-          }
-        }
-      }
-      if ((ts.isVariableStatement(node) || ts.isFunctionDeclaration(node) || ts.isClassDeclaration(node)) && node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {
-      }
-      ts.forEachChild(node, collectExports);
-    }
-    collectExports(source);
-  }
-  collectExported(constantFilePath);
-  spinner.succeed(`Found ${allFilesToAnalyze.size} related files from exports.`);
-  return {
-    allFilesToAnalyze,
-    analyzedFiles
-  };
-};
-const createTsProgram = (filePaths, options) => {
-  const spinner = ora("Creating TypeScript program for all files...");
-  spinner.start();
-  const program = ts.createProgram(Array.from(filePaths), options);
-  const checker = program.getTypeChecker();
-  spinner.succeed("TypeScript program created.");
-  return {
-    program,
-    checker
-  };
-};
-const createSymbolCache = (checker) => {
-  const symbolCache = /* @__PURE__ */ new Map();
-  return (node) => {
-    const cacheKey = `${node.getSourceFile().fileName}:${node.pos}:${node.end}`;
-    if (!symbolCache.has(cacheKey)) {
-      symbolCache.set(cacheKey, checker.getSymbolAtLocation(node));
-    }
-    return symbolCache.get(cacheKey);
-  };
-};
-const analyzeProperties = (filesToAnalyze, program, checker) => {
-  const propertyMap = /* @__PURE__ */ new Map();
-  const analyzedFiles = /* @__PURE__ */ new Set();
-  const sourceLineCache = /* @__PURE__ */ new Map();
-  const getCachedSymbol = createSymbolCache(checker);
-  const spinner = ora("Analyzing property relationships...");
-  spinner.start();
-  function analyzeFileProperties(filePath) {
-    if (analyzedFiles.has(filePath))
-      return;
-    analyzedFiles.add(filePath);
-    const source = program.getSourceFile(filePath);
-    if (!source)
-      return;
-    if (!sourceLineCache.has(filePath)) {
-      sourceLineCache.set(filePath, source.getFullText().split("\n"));
-    }
-    const sourceLines = sourceLineCache.get(filePath);
-    function visit(node) {
-      if (!source)
-        return;
-      if (ts.isPropertyAccessExpression(node)) {
-        const left = node.expression;
-        const right = node.name;
-        const { line } = ts.getLineAndCharacterOfPosition(source, node.getStart());
-        if (ts.isIdentifier(left) && sourceLines && sourceLines.length > line && (sourceLines[line].includes(`@Field.Prop(() => ${left.text}.${right.text}`) || sourceLines[line].includes(`base.Filter(${left.text}.${right.text},`))) {
-          const symbol = getCachedSymbol(right);
-          if (symbol?.declarations && symbol.declarations.length > 0) {
-            const key = symbol.declarations[0].getSourceFile().fileName.split("/").pop()?.split(".")[0] ?? "";
-            const property = propertyMap.get(key);
-            const isScalar = symbol.declarations[0].getSourceFile().fileName.includes("_");
-            const symbolFilePath = symbol.declarations[0].getSourceFile().fileName.replace(`${ts.sys.getCurrentDirectory()}/`, "");
-            if (property) {
-              propertyMap.set(`${left.text}.${right.text}`, {
-                filePath: symbolFilePath,
-                isLibModule: true,
-                isImport: false,
-                libName: left.text,
-                source: fs.readFileSync(symbolFilePath, "utf-8"),
-                isScalar
-              });
-            } else {
-              propertyMap.set(key, {
-                filePath: symbolFilePath,
-                isLibModule: true,
-                isImport: false,
-                libName: left.text,
-                isScalar,
-                source: fs.readFileSync(symbolFilePath, "utf-8")
-              });
-            }
-          }
-        }
-      } else if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier)) {
-        const importPath = node.moduleSpecifier.text;
-        if (importPath.startsWith(".")) {
-          const resolved = ts.resolveModuleName(importPath, filePath, program.getCompilerOptions(), ts.sys).resolvedModule?.resolvedFileName;
-          const moduleName = importPath.split("/").pop()?.split(".")[0] ?? "";
-          const property = propertyMap.get(moduleName);
-          const isScalar = importPath.includes("_");
-          if (moduleName && resolved && (!property || property.filePath !== resolved)) {
-            propertyMap.set(moduleName, {
-              filePath: resolved,
-              isLibModule: false,
-              isImport: true,
-              isScalar,
-              source: fs.readFileSync(resolved, "utf-8")
-            });
-          }
-        }
-      }
-      ts.forEachChild(node, visit);
-    }
-    visit(source);
-  }
-  for (const filePath of filesToAnalyze) {
-    analyzeFileProperties(filePath);
-  }
-  spinner.succeed(`Analysis complete. Found ${propertyMap.size} properties.`);
-  return propertyMap;
-};
-const getRelatedCnsts = (constantFilePath) => {
-  const parsedConfig = parseTsConfig();
-  const { allFilesToAnalyze } = collectImportedFiles(constantFilePath, parsedConfig);
-  const { program, checker } = createTsProgram(allFilesToAnalyze, parsedConfig.options);
-  const propertyMap = analyzeProperties(allFilesToAnalyze, program, checker);
-  return Array.from(propertyMap.entries()).map(([key, value]) => ({ key, ...value }));
-};
-export {
-  analyzeProperties,
-  collectExportedFiles,
-  collectImportedFiles,
-  createSymbolCache,
-  createTsProgram,
-  getRelatedCnsts,
-  parseTsConfig
-};

package/esm/src/linter.js

@@ -1,205 +0,0 @@
-import { Logger } from "@akanjs/common";
-import chalk from "chalk";
-import { ESLint } from "eslint";
-import * as fs from "fs";
-import * as path from "path";
-class Linter {
-  #logger = new Logger("Linter");
-  #eslint;
-  lintRoot;
-  constructor(cwdPath) {
-    this.lintRoot = this.#findEslintRootPath(cwdPath);
-    this.#eslint = new ESLint({ cwd: this.lintRoot, errorOnUnmatchedPattern: false });
-  }
-  #findEslintRootPath(dir) {
-    const configPath = path.join(dir, "eslint.config.ts");
-    if (fs.existsSync(configPath))
-      return dir;
-    const parentDir = path.dirname(dir);
-    return this.#findEslintRootPath(parentDir);
-  }
-  async lint(filePath, { fix = false, dryRun = false } = {}) {
-    if (fix)
-      return await this.fixFile(filePath, dryRun);
-    return await this.lintFile(filePath);
-  }
-  /**
-   * Lint a single file using ESLint
-   * @param filePath - Path to the file to lint
-   * @returns Array of ESLint results
-   */
-  async lintFile(filePath) {
-    if (!fs.existsSync(filePath))
-      throw new Error(`File not found: ${filePath}`);
-    const isIgnored = await this.#eslint.isPathIgnored(filePath);
-    if (isIgnored) {
-      this.#logger.warn(`File ${filePath} is ignored by ESLint configuration`);
-      return { fixed: false, results: [], errors: [], warnings: [] };
-    }
-    const results = await this.#eslint.lintFiles([filePath]);
-    const errors = results.flatMap((result) => result.messages.filter((message) => message.severity === 2));
-    const warnings = results.flatMap((result) => result.messages.filter((message) => message.severity === 1));
-    return { fixed: false, results, errors, warnings };
-  }
-  /**
-   * Format lint results for console output
-   * @param results - Array of ESLint results
-   * @returns Formatted string
-   */
-  formatLintResults(results) {
-    if (results.length === 0)
-      return "No files to lint";
-    const output = [];
-    let totalErrors = 0;
-    let totalWarnings = 0;
-    results.forEach((result) => {
-      totalErrors += result.errorCount;
-      totalWarnings += result.warningCount;
-      if (result.messages.length > 0) {
-        output.push(`
-${chalk.cyan(result.filePath)}`);
-        let sourceLines = [];
-        if (fs.existsSync(result.filePath)) {
-          try {
-            const sourceContent = fs.readFileSync(result.filePath, "utf8");
-            sourceLines = sourceContent.split("\n");
-          } catch (error) {
-          }
-        }
-        result.messages.forEach((message) => {
-          const type = message.severity === 2 ? "error" : "warning";
-          const typeColor = message.severity === 2 ? chalk.red : chalk.yellow;
-          const icon = message.severity === 2 ? "\u274C" : "\u26A0\uFE0F";
-          const ruleInfo = message.ruleId ? chalk.dim(` (${message.ruleId})`) : "";
-          output.push(`
-  ${icon} ${typeColor(type)}: ${message.message}${ruleInfo}`);
-          output.push(`     ${chalk.gray("at")} ${result.filePath}:${chalk.bold(`${message.line}:${message.column}`)}`);
-          if (sourceLines.length > 0 && message.line <= sourceLines.length) {
-            const sourceLine = sourceLines[message.line - 1];
-            const lineNumber = message.line.toString().padStart(5, " ");
-            output.push(`
-${chalk.dim(lineNumber + " |")} ${sourceLine}`);
-            const underlinePrefix = " ".repeat(message.column - 1);
-            const underlineLength = message.endColumn ? message.endColumn - message.column : 1;
-            const underline = "^".repeat(Math.max(1, underlineLength));
-            output.push(`${chalk.dim(" ".repeat(lineNumber.length) + " |")} ${underlinePrefix}${typeColor(underline)}`);
-          }
-        });
-      }
-    });
-    if (totalErrors === 0 && totalWarnings === 0)
-      return chalk.bold("\u2705 No ESLint errors or warnings found");
-    const errorText = totalErrors > 0 ? chalk.red(`${totalErrors} error(s)`) : "0 errors";
-    const warningText = totalWarnings > 0 ? chalk.yellow(`${totalWarnings} warning(s)`) : "0 warnings";
-    const summary = [`
-${errorText}, ${warningText} found`];
-    return summary.concat(output).join("\n");
-  }
-  /**
-   * Get detailed lint information
-   * @param filePath - Path to the file to lint
-   * @returns Object containing detailed lint information
-   */
-  async getDetailedLintInfo(filePath) {
-    const { results } = await this.lintFile(filePath);
-    const details = results.flatMap(
-      (result) => result.messages.map((message) => ({
-        line: message.line,
-        column: message.column,
-        message: message.message,
-        ruleId: message.ruleId,
-        severity: message.severity === 2 ? "error" : "warning",
-        fix: message.fix,
-        suggestions: message.suggestions
-      }))
-    );
-    const stats = results.reduce(
-      (acc, result) => ({
-        errorCount: acc.errorCount + result.errorCount,
-        warningCount: acc.warningCount + result.warningCount,
-        fixableErrorCount: acc.fixableErrorCount + result.fixableErrorCount,
-        fixableWarningCount: acc.fixableWarningCount + result.fixableWarningCount
-      }),
-      { errorCount: 0, warningCount: 0, fixableErrorCount: 0, fixableWarningCount: 0 }
-    );
-    return { results, details, stats };
-  }
-  /**
-   * Check if a file has lint errors
-   * @param filePath - Path to the file to check
-   * @returns true if there are no errors, false otherwise
-   */
-  async hasNoLintErrors(filePath) {
-    try {
-      const { results } = await this.lintFile(filePath);
-      return results.every((result) => result.errorCount === 0);
-    } catch (error) {
-      return false;
-    }
-  }
-  /**
-   * Get only error messages (excluding warnings)
-   * @param filePath - Path to the file to lint
-   * @returns Array of error messages
-   */
-  async getErrors(filePath) {
-    const { results } = await this.lintFile(filePath);
-    return results.flatMap((result) => result.messages.filter((message) => message.severity === 2));
-  }
-  /**
-   * Get only warning messages
-   * @param filePath - Path to the file to lint
-   * @returns Array of warning messages
-   */
-  async getWarnings(filePath) {
-    const { results } = await this.lintFile(filePath);
-    return results.flatMap((result) => result.messages.filter((message) => message.severity === 1));
-  }
-  /**
-   * Fix lint errors automatically
-   * @param filePath - Path to the file to fix
-   * @param dryRun - If true, returns the fixed content without writing to file
-   * @returns Fixed content and remaining issues
-   */
-  async fixFile(filePath, dryRun = false) {
-    if (!fs.existsSync(filePath))
-      throw new Error(`File not found: ${filePath}`);
-    const eslint = new ESLint({ cwd: this.lintRoot, fix: true });
-    const results = await eslint.lintFiles([filePath]);
-    const errors = results.flatMap((result) => result.messages.filter((message) => message.severity === 2));
-    const warnings = results.flatMap((result) => result.messages.filter((message) => message.severity === 1));
-    if (!dryRun)
-      await ESLint.outputFixes(results);
-    const fixedResult = results[0];
-    return { fixed: fixedResult.output !== void 0, output: fixedResult.output, results, errors, warnings };
-  }
-  /**
-   * Get ESLint configuration for a file
-   * @param filePath - Path to the file
-   * @returns ESLint configuration object
-   */
-  async getConfigForFile(filePath) {
-    const eslint = new ESLint();
-    const config = await eslint.calculateConfigForFile(filePath);
-    return config;
-  }
-  /**
-   * Get rules that are causing errors in a file
-   * @param filePath - Path to the file to check
-   * @returns Object mapping rule IDs to their error counts
-   */
-  async getProblematicRules(filePath) {
-    const { results } = await this.lintFile(filePath);
-    const ruleCounts = {};
-    results.forEach((result) => {
-      result.messages.forEach((message) => {
-        if (message.ruleId)
-          ruleCounts[message.ruleId] = (ruleCounts[message.ruleId] || 0) + 1;
-      });
-    });
-    return ruleCounts;
-  }
-}
-export {
-  Linter
-};

package/esm/src/prompter.js

@@ -1,51 +0,0 @@
-import { input, select } from "@inquirer/prompts";
-import fsPromise from "fs/promises";
-import { getDirname } from "./getDirname";
-class Prompter {
-  static async selectGuideline() {
-    const guideNames = (await fsPromise.readdir(`${getDirname(import.meta.url)}/src/guidelines`)).filter(
-      (name) => !name.startsWith("_")
-    );
-    return await select({ message: "Select a guideline", choices: guideNames.map((name) => ({ name, value: name })) });
-  }
-  static async getGuideJson(guideName) {
-    const filePath = `${getDirname(import.meta.url)}/src/guidelines/${guideName}/${guideName}.generate.json`;
-    const guideJson = await fsPromise.readFile(filePath, "utf-8");
-    return JSON.parse(guideJson);
-  }
-  static async getInstruction(guideName) {
-    const filePath = `${getDirname(import.meta.url)}/src/guidelines/${guideName}/${guideName}.instruction.md`;
-    const content = await fsPromise.readFile(filePath, "utf-8");
-    return content;
-  }
-  static async getUpdateRequest(guideName) {
-    return await input({ message: `What do you want to update in ${guideName}?` });
-  }
-  async makeTsFileUpdatePrompt({ context, request }) {
-    return `You are a senior developer writing TypeScript-based programs using Akan.js, an in-house framework. Here's an overview of the Akan.js framework:
-${await this.getDocumentation("framework")}
-Please understand the following background information, write code that meets the requirements, verify that it satisfies the validation conditions, and return the result.
-
-# Background Information
-\`\`\`markdown
-${context}
-\`\`\`
-
-# Requirements
-\`\`\`markdown
-${request}
-\`\`\`
-`;
-  }
-  async getDocumentation(guideName) {
-    const filePath = `${getDirname(import.meta.url)}/src/guidelines/${guideName}/${guideName}.instruction.md`;
-    const document = await fsPromise.readFile(filePath, "utf-8");
-    return `\`\`\`markdown
-${document}
-\`\`\`
-`;
-  }
-}
-export {
-  Prompter
-};