@akanjs/cli 2.4.0 → 2.4.1-rc.1

package/index-8pkbzj26.js

@@ -0,0 +1,840 @@
+// @bun
+import {
+  PageScript
+} from "./index-swf4bmbg.js";
+import {
+  pluralizeName
+} from "./index-ss469dec.js";
+import {
+  Prompter
+} from "./index-qaq13qk3.js";
+import {
+  bilingualDescriptionForField,
+  bilingualLabelForField,
+  createPassedPrimitiveReport,
+  generatedFilesForSync,
+  moduleSourcePaths,
+  sourceFile
+} from "./index-h6ca6qg0.js";
+import {
+  AiSession
+} from "./index-5vvwc0cz.js";
+import {
+  runner,
+  script
+} from "./index-hdqztm58.js";
+import {
+  ModuleExecutor
+} from "./index-a6sbyy0b.js";
+import {
+  FileSys
+} from "./index-61keag0s.js";
+
+// pkgs/@akanjs/devkit/getRelatedCnsts.ts
+import { readFileSync, realpathSync } from "fs";
+import ora from "ora";
+import * as ts from "typescript";
+var tsTranspiler = new Bun.Transpiler({ loader: "ts" });
+var tsxTranspiler = new Bun.Transpiler({ loader: "tsx" });
+var getTranspiler = (filePath) => filePath.endsWith(".tsx") ? tsxTranspiler : tsTranspiler;
+var scanModuleSpecifiers = (source, filePath, includeExports) => {
+  const scannedImports = getTranspiler(filePath).scanImports(source).map((imp) => imp.path).filter(Boolean);
+  if (includeExports) {
+    const specifiers = new Set(scannedImports);
+    const typeOnlyModuleRegex = /\b(?:import|export)\s+type\s+[\s\S]*?\s+from\s*["']([^"']+)["']/g;
+    for (const match of source.matchAll(typeOnlyModuleRegex)) {
+      const importPath = match[1];
+      if (importPath)
+        specifiers.add(importPath);
+    }
+    const exportFromRegex = /\bexport\s+(?:type\s+)?(?:\*|{[\s\S]*?})\s+from\s*["']([^"']+)["']/g;
+    for (const match of source.matchAll(exportFromRegex)) {
+      const importPath = match[1];
+      if (importPath)
+        specifiers.add(importPath);
+    }
+    return specifiers;
+  }
+  const importSpecifiers = new Set;
+  const importDeclarationRegex = /\bimport\s+(?:type\s+)?(?:["']([^"']+)["']|[\s\S]*?\s+from\s*["']([^"']+)["'])/g;
+  for (const match of source.matchAll(importDeclarationRegex)) {
+    const importPath = match[1] ?? match[2];
+    if (importPath && (scannedImports.includes(importPath) || match[0].startsWith("import type"))) {
+      importSpecifiers.add(importPath);
+    }
+  }
+  return importSpecifiers;
+};
+var parseTsConfig = (tsConfigPath = "./tsconfig.json") => {
+  const configFile = ts.readConfigFile(tsConfigPath, (path) => {
+    return ts.sys.readFile(path);
+  });
+  return ts.parseJsonConfigFileContent(configFile.config, ts.sys, realpathSync(tsConfigPath).replace(/[^/\\]+$/, ""));
+};
+var collectImportedFiles = (constantFilePath, parsedConfig) => {
+  const allFilesToAnalyze = new Set([constantFilePath]);
+  const analyzedFiles = new Set;
+  const spinner = ora("Collecting related files...");
+  spinner.start();
+  function collectImported(filePath) {
+    if (analyzedFiles.has(filePath))
+      return;
+    analyzedFiles.add(filePath);
+    const source = readFileSync(filePath, "utf-8");
+    for (const importPath of scanModuleSpecifiers(source, filePath, false)) {
+      if (!importPath.startsWith("."))
+        continue;
+      const resolved = ts.resolveModuleName(importPath, filePath, parsedConfig.options, ts.sys).resolvedModule?.resolvedFileName;
+      if (resolved && !allFilesToAnalyze.has(resolved)) {
+        allFilesToAnalyze.add(resolved);
+        collectImported(resolved);
+      }
+    }
+  }
+  collectImported(constantFilePath);
+  spinner.succeed(`Found ${allFilesToAnalyze.size} related files.`);
+  return {
+    allFilesToAnalyze,
+    analyzedFiles
+  };
+};
+var 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
+  };
+};
+var createSymbolCache = (checker) => {
+  const symbolCache = 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);
+  };
+};
+var analyzeProperties = (filesToAnalyze, program, checker) => {
+  const propertyMap = new Map;
+  const analyzedFiles = new Set;
+  const sourceLineCache = 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(`
+`));
+    }
+    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] && (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("_") ?? false;
+            const symbolFilePath = symbol.declarations[0]?.getSourceFile().fileName.replace(`${ts.sys.getCurrentDirectory()}/`, "");
+            if (!symbolFilePath)
+              throw new Error(`No symbol file path found for ${left.text}.${right.text}`);
+            if (property) {
+              propertyMap.set(`${left.text}.${right.text}`, {
+                filePath: symbolFilePath,
+                isLibModule: true,
+                isImport: false,
+                libName: left.text,
+                source: readFileSync(symbolFilePath, "utf-8"),
+                isScalar
+              });
+            } else {
+              propertyMap.set(key, {
+                filePath: symbolFilePath,
+                isLibModule: true,
+                isImport: false,
+                libName: left.text,
+                isScalar,
+                source: 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: 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;
+};
+var 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 }));
+};
+
+// pkgs/@akanjs/cli/module/module.script.ts
+import { input } from "@inquirer/prompts";
+import { capitalize as capitalize3, randomPicks } from "akanjs/common";
+
+// pkgs/@akanjs/cli/module/module.request.ts
+import { capitalize } from "akanjs/common";
+
+// pkgs/@akanjs/cli/module/module.prompt.ts
+var componentDefaultDescription = ({
+  modelName,
+  ModelName,
+  exampleFiles,
+  constant,
+  properties
+}) => ``;
+
+// pkgs/@akanjs/cli/module/module.request.ts
+class ModuleRequest extends Prompter {
+  sysType;
+  sysName;
+  config;
+  modelName;
+  constructor(options) {
+    super();
+    this.sysType = options.sysType;
+    this.sysName = options.sysName;
+    this.config = options.config;
+    this.modelName = options.modelName;
+  }
+  async requestModelConstant({
+    modelDesc,
+    modelSchemaDesign,
+    boilerplate,
+    exampleFiles
+  }) {
+    return this.makeTsFileUpdatePrompt({
+      context: `
+1. <model>.constant.ts \uD30C\uC77C\uC5D0 \uB300\uD55C \uAC1C\uC694
+${await this.getDocumentation("modelConstant")}
+
+2. <model>.constant.ts \uD30C\uC77C\uC758 Enum \uC791\uC131\uBC95
+${await this.getDocumentation("enumConstant")}
+
+3. <model>.constant.ts \uD30C\uC77C\uC758 Field \uC791\uC131\uBC95
+${await this.getDocumentation("fieldRule")}
+
+4. \uD604\uC7AC \uD504\uB85C\uC81D\uD2B8 \uB0B4 \uB2E4\uB978 constant.ts \uD30C\uC77C\uB4E4\uC5D0 \uB300\uD55C \uC608\uC2DC
+${exampleFiles.map((constant) => `
+Example file: ${constant.filePath}
+\`\`\`
+${constant.content}
+\`\`\`
+`).join(`
+`)}
+`,
+      request: `
+\uC704 \uB0B4\uC6A9\uB4E4\uC744 \uBC14\uD0D5\uC73C\uB85C \uD30C\uC2F1\uD558\uAE30 \uC27D\uAC8C \uC544\uB798\uC5D0 \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uB9DE\uAC8C \uC815\uB9AC\uD574\uC11C \uC918
+
+Application name: ${this.sysName}
+Model name: ${this.modelName}
+Model description: ${modelDesc}
+Model schema design: ${modelSchemaDesign}
+
+Target filename: ${this.modelName}.constant.ts
+\`\`\`typescript
+// File: lib/${this.modelName}/${this.modelName}.constant.ts
+${boilerplate}
+\`\`\`
+
+\uB9CC\uC57D, ${this.modelName}.constant.ts \uD30C\uC77C \uC678\uC5D0 \uB2E4\uB978 \uC2A4\uCE7C\uB77C \uBAA8\uB378\uC744 \uCD94\uAC00\uB85C \uC791\uC131\uD574\uC57C\uD55C\uB2E4\uBA74, \uB2E4\uC74C\uACFC \uAC19\uC740 \uD615\uC2DD\uC73C\uB85C \uCD94\uAC00\uB85C \uC791\uC131\uD574\uC918
+\`\`\`typescript
+// File: lib/__scalar/otherModel/otherModel.constant.ts
+...\uD30C\uC77C \uB0B4\uC6A9
+\`\`\`
+`
+    });
+  }
+}
+var requestDictionary = ({
+  sysName,
+  modelName,
+  constant,
+  modelDesc,
+  modelSchemaDesign,
+  boilerplate,
+  exampleFiles
+}) => ` 
+
+You are writing an Akan.js model dictionary file.
+
+Model constant:
+\`\`\`typescript
+// File: lib/${modelName}/${modelName}.constant.ts
+${constant}
+\`\`\`
+
+Reference dictionary files:
+${exampleFiles.map((exampleFile) => `
+\`\`\`typescript
+// File: ${exampleFile.filePath}
+${exampleFile.content}
+\`\`\`
+`).join(`
+`)}
+
+Application name: ${sysName}
+Model name: ${modelName}
+Model description: ${modelDesc}
+Model schema design: ${modelSchemaDesign}
+
+Complete the dictionary according to the constant file and boilerplate below.
+Return only file results in parseable code blocks.
+
+\`\`\`typescript
+// File: lib/${modelName}/${modelName}.dictionary.ts
+${boilerplate}
+\`\`\`
+`;
+var requestTemplate = ({
+  sysName,
+  modelName,
+  ModelName,
+  boilerplate,
+  constant,
+  properties,
+  exampleFiles
+}) => `
+		${componentDefaultDescription({
+  sysName,
+  modelName,
+  ModelName: ModelName ?? capitalize(modelName),
+  exampleFiles,
+  constant,
+  properties
+})}
+	 \uC5ED\uD560\uBD80\uC5EC 
+	 - Akan.js \uC0AC\uB0B4 \uD504\uB808\uC784\uC6CC\uD06C \uAE30\uBC18 Typescript \uC2DC\uB2C8\uC5B4 \uD504\uB860\uD2B8\uC5D4\uB4DC \uAC1C\uBC1C\uC790.
+ 
+	 \uCF54\uB529 \uADDC\uCE59
+		 - \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC544\uC774\uCF58: react-icons \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - CSS: tailwind, DaisyUI(card/hero \uAC19\uC740 \uBCF5\uC7A1\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 X) \uC0AC\uC6A9
+		 - Ui Component: @util/ui \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: clsx \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+	 \uCF54\uB4DC \uC2A4\uD0C0\uC77C
+		 - \uC0C9\uC0C1: \uD558\uB4DC\uCF54\uB529(bg-red) \uB300\uC2E0 \uD14C\uB9C8 \uC0C9\uC0C1(bg-primary) \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uB80C\uB354\uB9C1: field && <div>... \uB300\uC2E0 field ? <div>... : null \uC0AC\uC6A9
+		 - \uBAA8\uB378 \uC811\uADFC: \uAD6C\uC870\uBD84\uD574\uD560\uB2F9 \uB300\uC2E0 ${modelName}.field \uD615\uC2DD\uC73C\uB85C \uC811\uADFC
+		 - \uD0C0\uC785 \uC548\uC804: ${modelName}.constant.ts\uC758 \uC2A4\uD0A4\uB9C8 \uCC38\uC870\uD558\uC5EC \uC5D0\uB7EC \uBC29\uC9C0
+	 \uD544\uB4DC \uC811\uADFC \uC804: \uC2A4\uD0A4\uB9C8\uC758 \uC2E4\uC81C \uD544\uB4DC \uB9AC\uC2A4\uD2B8 \uC791\uC131 \uBC0F \uAC80\uD1A0 \uD544\uC218
+	 
+	 \uC5C4\uACA9\uD55C \uC8FC\uC758\uC0AC\uD56D
+		 - UI \uD0B7\uC740 \uBB38\uC11C\uC5D0 \uBA85\uC2DC\uB41C \uCEF4\uD3EC\uB10C\uD2B8\uB9CC \uC0AC\uC6A9
+		 - \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 \uC804 \uBB38\uC11C \uD655\uC778 \uBC0F props \uC815\uD655\uD788 \uAC80\uC99D
+		 - \uBA85\uC2DC\uB41C \uB8F0 \uC678 \uC784\uC758 \uCD94\uC0C1\uD654 \uAE08\uC9C0
+		 - dayjs \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB294 akanjs/base\uC5D0\uC11C \uB798\uD551\uD558\uC5EC \uC81C\uACF5\uD558\uACE0 \uC788\uC74C.
+
+		\uC694\uCCAD\uC0AC\uD56D
+		- \uC544\uB798 \uC81C\uACF5\uD560 \uAE30\uBCF8 \uD15C\uD50C\uB9BF \uCF54\uB4DC\uC5D0 \uCD94\uAC00\uB85C \uCEF4\uD3EC\uB10C\uD2B8 \uAC1C\uBC1C
+		- ${ModelName}.Template.tsx \uCF54\uB4DC \uC791\uC131
+		- \uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uC740 \uBAA8\uB378 \uC774\uB984\uC740 \uC2A4\uD0A4\uB9C8\uC5D0 \uAE30\uBC18\uD55C \uAE30\uB2A5\uC5D0 \uCD08\uC810\uC744 \uB450\uACE0 \uC791\uC131
+		- \uC544\uB798 \uC81C\uACF5\uD560 \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uC788\uB294 General \uCEF4\uD3EC\uB10C\uD2B8 1\uAC1C\uB97C \uC81C\uC678\uD55C \uB514\uC790\uC778 \uCEF4\uD3EC\uB10C\uD2B8 4\uAC1C \uAC1C\uBC1C 
+		- \uCD94\uC0C1\uD654 \uD574\uC57C\uD558\uB294 \uACBD\uC6B0\uAC00 \uC788\uC744 \uACBD\uC6B0\uC5D4 \uBB38\uC11C\uB97C \uB2E4\uC2DC \uCC38\uACE0\uD558\uACE0 \uC124\uBA85\uB41C \uB0B4\uC5D0\uC11C \uD574\uACB0\uD574\uC57C\uD568.
+		- \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uB9DE\uAC8C \uC815\uB9AC\uD574\uC11C \uC81C\uACF5
+	- 
+	
+	Application name: ${sysName}
+	Model name: ${modelName}
+	Target filename: ${ModelName}.Template.tsx
+		\`\`\`
+		${boilerplate}
+		\`\`\`
+	
+	 
+	`;
+var requestView = ({
+  sysName,
+  modelName,
+  ModelName,
+  boilerplate,
+  constant,
+  properties,
+  exampleFiles
+}) => `
+	 ${componentDefaultDescription({
+  sysName,
+  modelName,
+  ModelName: ModelName ?? capitalize(modelName),
+  exampleFiles,
+  constant,
+  properties
+})}
+
+	 \uC5ED\uD560\uBD80\uC5EC 
+	 - Akan.js \uC0AC\uB0B4 \uD504\uB808\uC784\uC6CC\uD06C \uAE30\uBC18 Typescript \uC2DC\uB2C8\uC5B4 \uD504\uB860\uD2B8\uC5D4\uB4DC \uAC1C\uBC1C\uC790.
+ 
+	 \uCF54\uB529 \uADDC\uCE59
+		 - \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC544\uC774\uCF58: react-icons \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - CSS: tailwind, DaisyUI(card/hero \uAC19\uC740 \uBCF5\uC7A1\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 X) \uC0AC\uC6A9
+		 - Ui Component: @util/ui \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: clsx \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+	 \uCF54\uB4DC \uC2A4\uD0C0\uC77C
+		 - \uC0C9\uC0C1: \uD558\uB4DC\uCF54\uB529(bg-red) \uB300\uC2E0 \uD14C\uB9C8 \uC0C9\uC0C1(bg-primary) \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uB80C\uB354\uB9C1: field && <div>... \uB300\uC2E0 field ? <div>... : null \uC0AC\uC6A9
+		 - \uBAA8\uB378 \uC811\uADFC: \uAD6C\uC870\uBD84\uD574\uD560\uB2F9 \uB300\uC2E0 ${modelName}.field \uD615\uC2DD\uC73C\uB85C \uC811\uADFC
+		 - \uD0C0\uC785 \uC548\uC804: ${modelName}.constant.ts\uC758 \uC2A4\uD0A4\uB9C8 \uCC38\uC870\uD558\uC5EC \uC5D0\uB7EC \uBC29\uC9C0
+	 \uD544\uB4DC \uC811\uADFC \uC804: \uC2A4\uD0A4\uB9C8\uC758 \uC2E4\uC81C \uD544\uB4DC \uB9AC\uC2A4\uD2B8 \uC791\uC131 \uBC0F \uAC80\uD1A0 \uD544\uC218
+	 
+	 \uC5C4\uACA9\uD55C \uC8FC\uC758\uC0AC\uD56D
+		 - UI \uD0B7\uC740 \uBB38\uC11C\uC5D0 \uBA85\uC2DC\uB41C \uCEF4\uD3EC\uB10C\uD2B8\uB9CC \uC0AC\uC6A9
+		 - \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 \uC804 \uBB38\uC11C \uD655\uC778 \uBC0F props \uC815\uD655\uD788 \uAC80\uC99D
+		 - \uBA85\uC2DC\uB41C \uB8F0 \uC678 \uC784\uC758 \uCD94\uC0C1\uD654 \uAE08\uC9C0
+		 - dayjs \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB294 akanjs/base\uC5D0\uC11C \uB798\uD551\uD558\uC5EC \uC81C\uACF5\uD558\uACE0 \uC788\uC74C.
+		 - util/ui \uC774\uC678\uC5D0 \uBA85\uC2DC\uB418\uC788\uC9C0 \uC54A\uC740 \uCEF4\uD3EC\uB10C\uD2B8 \uC808\uB300 \uC0AC\uC6A9 \uAE08\uC9C0. 
+
+		\uC694\uCCAD\uC0AC\uD56D
+		- \uC544\uB798 \uC81C\uACF5\uD560 \uAE30\uBCF8 \uD15C\uD50C\uB9BF \uCF54\uB4DC\uC5D0 \uCD94\uAC00\uB85C \uCEF4\uD3EC\uB10C\uD2B8 \uAC1C\uBC1C
+		- ${ModelName}.View.tsx \uCF54\uB4DC \uC791\uC131
+		- \uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uC5D0 ${ModelName}\uC740 \uC0DD\uB7B5\uD558\uBA70, \uB514\uC790\uC778 \uC911\uC810\uC758 \uC774\uB984\uC73C\uB85C \uC791\uC131
+		- \uC544\uB798 \uC81C\uACF5\uD560 \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uC788\uB294 General \uCEF4\uD3EC\uB10C\uD2B8 1\uAC1C\uB97C \uC81C\uC678\uD55C \uB514\uC790\uC778 \uCEF4\uD3EC\uB10C\uD2B8 4\uAC1C \uAC1C\uBC1C 
+		- \uCD94\uC0C1\uD654 \uD574\uC57C\uD558\uB294 \uACBD\uC6B0\uAC00 \uC788\uC744 \uACBD\uC6B0\uC5D4 \uBB38\uC11C\uB97C \uB2E4\uC2DC \uCC38\uACE0\uD558\uACE0 \uC124\uBA85\uB41C \uB0B4\uC5D0\uC11C \uD574\uACB0\uD574\uC57C\uD568.
+		- \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uB9DE\uAC8C \uC815\uB9AC\uD574\uC11C \uC81C\uACF5
+   		- UI \uD0B7\uC740 \uBB38\uC11C\uC5D0 \uBA85\uC2DC\uB41C \uCEF4\uD3EC\uB10C\uD2B8\uB9CC \uC0AC\uC6A9
+		
+	
+	Application name: ${sysName}
+	Model name: ${modelName}
+	
+	Target filename: ${ModelName}.View.tsx
+		\`\`\`
+		${boilerplate}
+		\`\`\`
+	
+	 
+	`;
+var requestUnit = ({
+  sysName,
+  modelName,
+  ModelName,
+  constant,
+  properties,
+  boilerplate,
+  exampleFiles
+}) => `
+	 ${componentDefaultDescription({
+  sysName,
+  modelName,
+  ModelName: ModelName ?? capitalize(modelName),
+  exampleFiles,
+  constant,
+  properties
+})}
+
+		\uC5ED\uD560\uBD80\uC5EC 
+	 - Akan.js \uC0AC\uB0B4 \uD504\uB808\uC784\uC6CC\uD06C \uAE30\uBC18 Typescript \uC2DC\uB2C8\uC5B4 \uD504\uB860\uD2B8\uC5D4\uB4DC \uAC1C\uBC1C\uC790.
+ 
+	 \uCF54\uB529 \uADDC\uCE59
+		 - \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC544\uC774\uCF58: react-icons \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - CSS: tailwind, DaisyUI(card/hero \uAC19\uC740 \uBCF5\uC7A1\uD55C \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 X) \uC0AC\uC6A9
+		 - Ui Component: @util/ui \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: clsx \uB77C\uC774\uBE0C\uB7EC\uB9AC \uC0AC\uC6A9
+	 \uCF54\uB4DC \uC2A4\uD0C0\uC77C
+		 - \uC0C9\uC0C1: \uD558\uB4DC\uCF54\uB529(bg-red) \uB300\uC2E0 \uD14C\uB9C8 \uC0C9\uC0C1(bg-primary) \uC0AC\uC6A9
+		 - \uC870\uAC74\uBD80 \uB80C\uB354\uB9C1: field && <div>... \uB300\uC2E0 field ? <div>... : null \uC0AC\uC6A9
+		 - \uBAA8\uB378 \uC811\uADFC: \uAD6C\uC870\uBD84\uD574\uD560\uB2F9 \uB300\uC2E0 ${modelName}.field \uD615\uC2DD\uC73C\uB85C \uC811\uADFC
+		 - \uD0C0\uC785 \uC548\uC804: ${modelName}.constant.ts\uC758 \uC2A4\uD0A4\uB9C8 \uCC38\uC870\uD558\uC5EC \uC5D0\uB7EC \uBC29\uC9C0
+	 \uD544\uB4DC \uC811\uADFC \uC804: \uC2A4\uD0A4\uB9C8\uC758 \uC2E4\uC81C \uD544\uB4DC \uB9AC\uC2A4\uD2B8 \uC791\uC131 \uBC0F \uAC80\uD1A0 \uD544\uC218
+	 
+	 \uC5C4\uACA9\uD55C \uC8FC\uC758\uC0AC\uD56D
+		 - UI \uD0B7\uC740 \uBB38\uC11C\uC5D0 \uBA85\uC2DC\uB41C \uCEF4\uD3EC\uB10C\uD2B8\uB9CC \uC0AC\uC6A9
+		 - \uCEF4\uD3EC\uB10C\uD2B8 \uC0AC\uC6A9 \uC804 \uBB38\uC11C \uD655\uC778 \uBC0F props \uC815\uD655\uD788 \uAC80\uC99D
+		 - \uBA85\uC2DC\uB41C \uB8F0 \uC678 \uC784\uC758 \uCD94\uC0C1\uD654 \uAE08\uC9C0
+		 - dayjs \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB294 akanjs/base\uC5D0\uC11C \uB798\uD551\uD558\uC5EC \uC81C\uACF5\uD558\uACE0 \uC788\uC74C.
+	
+		\uC694\uCCAD\uC0AC\uD56D
+		- \uC544\uB798 \uC81C\uACF5\uD560 \uAE30\uBCF8 \uD15C\uD50C\uB9BF \uCF54\uB4DC\uC5D0 \uCD94\uAC00\uB85C \uCEF4\uD3EC\uB10C\uD2B8 \uAC1C\uBC1C
+		- ${ModelName}.Unit.tsx \uCF54\uB4DC \uC791\uC131
+		- \uCEF4\uD3EC\uB10C\uD2B8 \uC774\uB984\uC5D0 ${ModelName}\uC740 \uC0DD\uB7B5\uD558\uBA70, \uB514\uC790\uC778 \uC911\uC810\uC758 \uC774\uB984\uC73C\uB85C \uC791\uC131
+		- \uC608\uC2DC\uD30C\uC77C \uCEF4\uD3EC\uB10C\uD2B8\uC758 \uAE30\uBC18\uD558\uC5EC \uC77C\uBC18\uC801\uC73C\uB85C \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uCEF4\uD3EC\uB10C\uD2B8 1\uAC1C\uC640 \uB514\uC790\uC778\uC801 \uC694\uC18C\uAC00 \uD3EC\uD568\uB41C \uCEF4\uD3EC\uB10C\uD2B8 3\uAC1C \uAC1C\uBC1C
+		- \uCD94\uC0C1\uD654 \uD574\uC57C\uD558\uB294 \uACBD\uC6B0\uAC00 \uC788\uC744 \uACBD\uC6B0\uC5D4 \uBB38\uC11C\uB97C \uB2E4\uC2DC \uCC38\uACE0\uD558\uACE0 \uC124\uBA85\uB41C \uB0B4\uC5D0\uC11C \uD574\uACB0\uD574\uC57C\uD568.
+		- \uBCF4\uC77C\uB7EC\uD50C\uB808\uC774\uD2B8\uC5D0 \uB9DE\uAC8C \uC815\uB9AC\uD574\uC11C \uC81C\uACF5
+	
+	
+	Application name: ${sysName}
+	Model name: ${modelName}
+	
+	Target filename: ${ModelName}.Unit.tsx
+		\`\`\`
+		${boilerplate}
+		\`\`\`
+	
+	 
+	`;
+
+// pkgs/@akanjs/cli/module/module.runner.ts
+import { capitalize as capitalize2 } from "akanjs/common";
+var purposeByModule = {
+  budget: "Budget represents planned or actual money allocated inside the app.",
+  project: "Project represents a project workspace or business initiative managed by the app.",
+  task: "Task represents work items that move through the app workflow."
+};
+var moduleAbstractContent = (moduleName) => {
+  const title = capitalize2(moduleName);
+  const label = bilingualLabelForField(moduleName);
+  const purpose = purposeByModule[moduleName] ?? `${title} represents ${label.en.toLowerCase()} records managed by the app.`;
+  return `# ${title} Module Abstract
+
+## Purpose
+
+${purpose}
+
+## Domain Rules
+
+- Keep ${label.en.toLowerCase()} data consistent with user-facing dictionary labels.
+
+## Data Meaning
+
+${label.en} (${label.ko}) is the primary business concept for this module.
+
+## Workflows
+
+No lifecycle workflow yet.
+
+## Agent Notes
+
+- Read this abstract before changing the module.
+- Update this file when business invariants, workflows, or public behavior change.
+- Do not update this file for formatting-only, import-only, or style-only changes.
+
+## Related Modules
+
+- None yet.
+`;
+};
+var localModuleFilename = (moduleName, pathKey) => moduleSourcePaths(moduleName)[pathKey].replace(`lib/${moduleName}/`, "");
+
+class ModuleRunner extends runner("module") {
+  async createService(module) {
+    const serviceName = module.name.replace(/^_+/, "");
+    await module.applyTemplate({
+      basePath: `.`,
+      template: "service",
+      dict: { model: serviceName, sysName: module.sys.name }
+    });
+    const [abstractContent, dictionaryContent, serviceContent, signalContent, storeContent] = await Promise.all([
+      module.readFile(`${serviceName}.abstract.md`),
+      module.readFile(`${serviceName}.dictionary.ts`),
+      module.readFile(`${serviceName}.service.ts`),
+      module.readFile(`${serviceName}.signal.ts`),
+      module.readFile(`${serviceName}.store.ts`)
+    ]);
+    return {
+      abstract: { filename: `${serviceName}.abstract.md`, content: abstractContent },
+      dictionary: { filename: `${serviceName}.dictionary.ts`, content: dictionaryContent },
+      service: { filename: `${serviceName}.service.ts`, content: serviceContent },
+      signal: { filename: `${serviceName}.signal.ts`, content: signalContent },
+      store: { filename: `${serviceName}.store.ts`, content: storeContent }
+    };
+  }
+  async removeModule(module) {
+    await module.sys.removeDir(`lib/${module.name}`);
+  }
+  async createComponentTemplate(module, type) {
+    await module.sys.applyTemplate({
+      basePath: `./lib/${module.name}`,
+      template: `module/__Model__.${capitalize2(type)}.tsx`,
+      dict: { model: module.name, appName: module.sys.name }
+    });
+    return {
+      component: {
+        filename: `${capitalize2(module.name)}.${capitalize2(type)}.tsx`,
+        content: await module.sys.readFile(`lib/${module.name}/${capitalize2(module.name)}.${capitalize2(type)}.tsx`)
+      }
+    };
+  }
+  async createModuleTemplate(module) {
+    const names = pluralizeName(module.name);
+    const modelLabel = bilingualLabelForField(module.name);
+    const modelDescription = bilingualDescriptionForField(module.name);
+    const filenames = {
+      abstract: localModuleFilename(module.name, "abstract"),
+      constant: localModuleFilename(module.name, "constant"),
+      dictionary: localModuleFilename(module.name, "dictionary"),
+      service: localModuleFilename(module.name, "service"),
+      store: localModuleFilename(module.name, "store"),
+      signal: localModuleFilename(module.name, "signal"),
+      unit: localModuleFilename(module.name, "unit"),
+      view: localModuleFilename(module.name, "view"),
+      template: localModuleFilename(module.name, "template"),
+      zone: localModuleFilename(module.name, "zone"),
+      util: localModuleFilename(module.name, "util")
+    };
+    await module.applyTemplate({
+      basePath: `.`,
+      template: "module",
+      dict: {
+        model: module.name,
+        models: names,
+        sysName: module.sys.name,
+        modelLabelEn: modelLabel.en,
+        modelLabelKo: modelLabel.ko,
+        modelDescEn: modelDescription.en,
+        modelDescKo: modelDescription.ko
+      }
+    });
+    await module.writeFile(filenames.abstract, moduleAbstractContent(module.name));
+    const [
+      abstractContent,
+      constantContent,
+      dictionaryContent,
+      serviceContent,
+      storeContent,
+      signalContent,
+      unitContent,
+      viewContent,
+      templateContent,
+      zoneContent,
+      utilContent
+    ] = await Promise.all([
+      module.readFile(filenames.abstract),
+      module.readFile(filenames.constant),
+      module.readFile(filenames.dictionary),
+      module.readFile(filenames.service),
+      module.readFile(filenames.store),
+      module.readFile(filenames.signal),
+      module.readFile(filenames.unit),
+      module.readFile(filenames.view),
+      module.readFile(filenames.template),
+      module.readFile(filenames.zone),
+      module.readFile(filenames.util)
+    ]);
+    return {
+      abstract: { filename: filenames.abstract, content: abstractContent },
+      constant: { filename: filenames.constant, content: constantContent },
+      dictionary: { filename: filenames.dictionary, content: dictionaryContent },
+      service: { filename: filenames.service, content: serviceContent },
+      store: { filename: filenames.store, content: storeContent },
+      signal: { filename: filenames.signal, content: signalContent },
+      unit: { filename: filenames.unit, content: unitContent },
+      view: { filename: filenames.view, content: viewContent },
+      template: { filename: filenames.template, content: templateContent },
+      zone: { filename: filenames.zone, content: zoneContent },
+      util: { filename: filenames.util, content: utilContent }
+    };
+  }
+}
+
+// pkgs/@akanjs/cli/module/module.script.ts
+var moduleChangedFiles = (sys2, moduleName, files) => Object.values(files).map((file) => sourceFile(sys2, `lib/${moduleName}/${file.filename}`, "create", "Module source file was created."));
+
+class ModuleScript extends script("module", [ModuleRunner, PageScript]) {
+  async createModuleTemplate(sys2, name, { page = false } = {}) {
+    const mod = ModuleExecutor.from(sys2, name);
+    const files = await this.moduleRunner.createModuleTemplate(mod);
+    if (page && sys2.type === "app")
+      await this.pageScript.createCrudPage(mod, { app: sys2, basePath: null, single: false });
+    await sys2.scan();
+    return createPassedPrimitiveReport({
+      command: "create-module",
+      changedFiles: moduleChangedFiles(sys2, name, files),
+      generatedFiles: generatedFilesForSync(sys2, "Generated files were refreshed after module creation."),
+      target: sys2.name
+    });
+  }
+  async createModule(sys2, name, {
+    page = false,
+    description,
+    schemaDescription
+  } = {}) {
+    const isContinued = await sys2.exists(`lib/${name}/${name}.constant.ts`);
+    const session = new AiSession("createModule", { workspace: sys2.workspace, cacheKey: name, isContinued });
+    const moduleConstantExampleFiles = await sys2.workspace.getConstantFiles();
+    const executor = ModuleExecutor.from(sys2, name);
+    const files = await this.moduleRunner.createModuleTemplate(executor);
+    const { constant, dictionary } = files;
+    if (page && sys2.type === "app")
+      await this.pageScript.createCrudPage(executor, { app: sys2, basePath: null, single: false });
+    const modelDesc = description ?? await input({ message: "description of module" });
+    const modelSchemaDesign = schemaDescription ?? await input({ message: "schema description of module" });
+    const config = await sys2.getConfig();
+    const moduleRequest = new ModuleRequest({ sysType: sys2.type, sysName: sys2.name, modelName: name, config });
+    const constantRequestPrompt = await moduleRequest.requestModelConstant({
+      modelDesc,
+      modelSchemaDesign,
+      boilerplate: constant.content,
+      exampleFiles: randomPicks(moduleConstantExampleFiles, Math.min(10, moduleConstantExampleFiles.length))
+    });
+    const constantGuide = await ModuleRequest.getGuideJson("modelConstant");
+    const constantWrites = await session.writeTypescripts(constantRequestPrompt, sys2, {
+      validate: constantGuide.update.rules
+    });
+    for (const scalarName of this.#getCreatedScalarNames(constantWrites.map(({ filePath }) => filePath))) {
+      await sys2.applyTemplate({
+        basePath: "./lib/__scalar",
+        template: "__scalar",
+        dict: { model: scalarName, models: pluralizeName(scalarName), sysName: sys2.name },
+        overwrite: false
+      });
+    }
+    const constantContent = await sys2.readFile(`lib/${name}/${name}.constant.ts`);
+    const dictionaryGuide = await ModuleRequest.getGuideJson("modelDictionary");
+    await session.writeTypescripts(requestDictionary({
+      sysName: sys2.name,
+      modelName: name,
+      constant: constantContent,
+      modelDesc,
+      modelSchemaDesign,
+      boilerplate: dictionary.content,
+      exampleFiles: randomPicks(moduleConstantExampleFiles, Math.min(10, moduleConstantExampleFiles.length))
+    }), sys2, { validate: dictionaryGuide.update.rules });
+    await sys2.scan();
+    sys2.log(`Module ${name} created in ${sys2.type}s/${sys2.name}/lib/${name}`);
+    return createPassedPrimitiveReport({
+      command: "create-module",
+      changedFiles: [
+        ...moduleChangedFiles(sys2, name, files),
+        ...constantWrites.map((write) => sourceFile(sys2, write.filePath, "modify", "AI-assisted module constant source was updated."))
+      ],
+      generatedFiles: generatedFilesForSync(sys2, "Generated files were refreshed after module creation."),
+      target: sys2.name
+    });
+  }
+  #getCreatedScalarNames(filePaths) {
+    return [
+      ...new Set(filePaths.map((filePath) => /^lib\/__scalar\/([^/]+)\/[^/]+\.constant\.ts$/.exec(filePath)?.[1]).filter((scalarName) => !!scalarName))
+    ];
+  }
+  async removeModule(mod) {
+    await this.moduleRunner.removeModule(mod);
+  }
+  async createService(sys2, name) {
+    const service = ModuleExecutor.from(sys2, `_${name}`);
+    const files = await this.moduleRunner.createService(service);
+    await sys2.scan();
+    return createPassedPrimitiveReport({
+      command: "create-service",
+      changedFiles: moduleChangedFiles(sys2, `_${name}`, files),
+      generatedFiles: generatedFilesForSync(sys2, "Generated files were refreshed after service creation."),
+      target: sys2.name
+    });
+  }
+  async createTest(workspace, name) {}
+  async createTemplate(mod) {
+    const { component: template } = await this.moduleRunner.createComponentTemplate(mod, "template");
+    const paths = moduleSourcePaths(mod.name);
+    const templateExampleFiles = (await mod.sys.getTemplatesSourceCode()).filter((f) => !f.filePath.includes(paths.template));
+    const Name = capitalize3(mod.name);
+    const relatedCnsts = getRelatedCnsts(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const constant = await FileSys.readText(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const session = new AiSession("createTemplate", { workspace: mod.sys.workspace, cacheKey: mod.name });
+    const promptRst = requestTemplate({
+      sysName: mod.sys.name,
+      modelName: mod.name,
+      ModelName: Name,
+      constant,
+      boilerplate: template.content,
+      properties: relatedCnsts.map((r) => ({ key: r.key, source: r.source })),
+      exampleFiles: randomPicks(templateExampleFiles, Math.min(20, templateExampleFiles.length))
+    });
+    const content = await session.editTypescript(promptRst);
+    //! 파일을 {name}.View.tsx에 저장.
+    await mod.writeFile(`${Name}.Template.tsx`, content);
+    return createPassedPrimitiveReport({
+      command: "create-template",
+      changedFiles: [
+        sourceFile(mod.sys, `lib/${mod.name}/${Name}.Template.tsx`, "modify", "Template UI source was created.")
+      ],
+      target: mod.sys.name
+    });
+  }
+  async createUnit(mod) {
+    const { component: unit } = await this.moduleRunner.createComponentTemplate(mod, "unit");
+    const paths = moduleSourcePaths(mod.name);
+    const Name = capitalize3(mod.name);
+    const unitExampleFiles = (await mod.sys.getUnitsSourceCode()).filter((f) => !f.filePath.includes(paths.unit));
+    const relatedCnsts = getRelatedCnsts(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const constant = await FileSys.readText(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const session = new AiSession("createUnit", { workspace: mod.sys.workspace, cacheKey: mod.name });
+    const promptRst = requestUnit({
+      sysName: mod.sys.name,
+      modelName: mod.name,
+      ModelName: Name,
+      constant,
+      properties: relatedCnsts.map((r) => ({ key: r.key, source: r.source })),
+      exampleFiles: randomPicks(unitExampleFiles, Math.min(10, unitExampleFiles.length)),
+      boilerplate: unit.content
+    });
+    const content = await session.editTypescript(promptRst);
+    //! 파일을 {name}.Unit.tsx에 저장.
+    await mod.writeFile(`${Name}.Unit.tsx`, content);
+    return createPassedPrimitiveReport({
+      command: "create-unit",
+      changedFiles: [sourceFile(mod.sys, `lib/${mod.name}/${Name}.Unit.tsx`, "modify", "Unit UI source was created.")],
+      target: mod.sys.name
+    });
+  }
+  async createView(mod) {
+    const { component: view } = await this.moduleRunner.createComponentTemplate(mod, "view");
+    const paths = moduleSourcePaths(mod.name);
+    const viewExampleFiles = (await mod.sys.getViewsSourceCode()).filter((f) => !f.filePath.includes(paths.view));
+    const Name = capitalize3(mod.name);
+    const relatedCnsts = getRelatedCnsts(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const constant = await FileSys.readText(`${mod.sys.cwdPath}/lib/${mod.name}/${mod.name}.constant.ts`);
+    const session = new AiSession("createView", { workspace: mod.sys.workspace, cacheKey: mod.name });
+    const promptRst = requestView({
+      sysName: mod.sys.name,
+      modelName: mod.name,
+      ModelName: Name,
+      constant,
+      boilerplate: view.content,
+      properties: relatedCnsts.map((r) => ({ key: r.key, source: r.source })),
+      exampleFiles: randomPicks(viewExampleFiles, Math.min(20, viewExampleFiles.length))
+    });
+    const content = await session.editTypescript(promptRst);
+    //! 파일을 {name}.View.tsx에 저장.
+    await mod.writeFile(`${Name}.View.tsx`, content);
+    return createPassedPrimitiveReport({
+      command: "create-view",
+      changedFiles: [sourceFile(mod.sys, `lib/${mod.name}/${Name}.View.tsx`, "modify", "View UI source was created.")],
+      target: mod.sys.name
+    });
+  }
+}
+
+export { ModuleScript };