@akanjs/cli 0.0.145 → 0.0.147

package/esm/index.js

@@ -1238,7 +1238,10 @@ ${errorMessages}`);
     ];
     const errors = diagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Error);
     const warnings = diagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Warning);
-    return { diagnostics, errors, warnings };
+    const fileDiagnostics = diagnostics.filter((diagnostic) => diagnostic.file?.fileName === filePath);
+    const fileErrors = fileDiagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Error);
+    const fileWarnings = fileDiagnostics.filter((diagnostic) => diagnostic.category === ts3.DiagnosticCategory.Warning);
+    return { diagnostics, errors, warnings, fileDiagnostics, fileErrors, fileWarnings };
   }
   /**
    * Format diagnostics for console output
@@ -1665,9 +1668,9 @@ var Executor = class _Executor {
   typeCheck(filePath) {
     const path9 = this.getPath(filePath);
     const typeChecker = this.getTypeChecker();
-    const { diagnostics, errors, warnings } = typeChecker.check(path9);
-    const message = typeChecker.formatDiagnostics(diagnostics);
-    return { diagnostics, errors, warnings, message };
+    const { fileDiagnostics, fileErrors, fileWarnings } = typeChecker.check(path9);
+    const message = typeChecker.formatDiagnostics(fileDiagnostics);
+    return { fileDiagnostics, fileErrors, fileWarnings, message };
   }
   getLinter() {
     this.linter ??= new Linter(this.cwdPath);
@@ -3097,7 +3100,7 @@ ${validate.map((v) => `- ${v}`).join("\n")}`;
         writes.map(async ({ filePath }) => {
           const typeCheckResult = executor.typeCheck(filePath);
           const lintResult = await executor.lint(filePath);
-          const needFix2 = !!typeCheckResult.errors.length || !!lintResult.errors.length;
+          const needFix2 = !!typeCheckResult.fileErrors.length || !!lintResult.errors.length;
           return { filePath, typeCheckResult, lintResult, needFix: needFix2 };
         })
       );
@@ -3131,7 +3134,7 @@ ${fileCheck.lintResult.message}`
     throw new Error("Failed to create scalar");
   }
   #getTypescriptCodes(text) {
-    const codes = text.match(/```typescript([\s\S]*?)```/g);
+    const codes = text.match(/```(typescript|tsx)([\s\S]*?)```/g);
     if (!codes)
       return [];
     const result = codes.map((code) => {
@@ -3239,7 +3242,7 @@ var Builder = class {
 };
 
 // pkgs/@akanjs/devkit/src/prompter.ts
-import { select as select4 } from "@inquirer/prompts";
+import { input as input3, select as select4 } from "@inquirer/prompts";
 import fsPromise2 from "fs/promises";
 var Prompter = class {
   static async selectGuideline() {
@@ -3256,6 +3259,9 @@ var Prompter = class {
     const content = await fsPromise2.readFile(filePath, "utf-8");
     return content;
   }
+  static async getUpdateRequest(guideName) {
+    return await input3({ message: `What do you want to update in ${guideName}?` });
+  }
   async makeTsFileUpdatePrompt({ context: context2, 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")}
@@ -3417,7 +3423,7 @@ var LibraryScript = class {
 };
 
 // pkgs/@akanjs/cli/src/application/application.runner.ts
-import { confirm as confirm2, input as input3 } from "@inquirer/prompts";
+import { confirm as confirm2, input as input4 } from "@inquirer/prompts";
 import { StringOutputParser } from "@langchain/core/output_parsers";
 import { PromptTemplate as PromptTemplate2 } from "@langchain/core/prompts";
 import { RunnableSequence as RunnableSequence2 } from "@langchain/core/runnables";
@@ -3877,8 +3883,8 @@ var ApplicationRunner = class {
     if (!openAIApiKey)
       throw new Error("OPENAI_API_KEY is not set");
     const chatModel = new ChatOpenAI3({ modelName: "gpt-4o", openAIApiKey });
-    const projectName = await input3({ message: "please enter project name." });
-    const projectDesc = await input3({ message: "please enter project description. (40 ~ 60 characters)" });
+    const projectName = await input4({ message: "please enter project name." });
+    const projectDesc = await input4({ message: "please enter project description. (40 ~ 60 characters)" });
     const spinner = ora3("Gerating project files...");
     const mainPrompt = PromptTemplate2.fromTemplate(`prompt.requestApplication()`);
     const chain = RunnableSequence2.from([mainPrompt, chatModel, new StringOutputParser()]);
@@ -5486,7 +5492,9 @@ var GuidelinePrompt = class extends Prompter {
     });
     const paths = [];
     for await (const path9 of matchingPaths) {
-      if (filterText && !fs16.readFileSync(path9, "utf-8").includes(filterText))
+      const fileContent = fs16.readFileSync(path9, "utf-8");
+      const textFilter = filterText ? new RegExp(filterText) : null;
+      if (filterText && !textFilter?.test(fileContent))
         continue;
       paths.push(path9);
     }
@@ -5539,10 +5547,39 @@ ${guideJson.update.rules.map((rule) => `- ${rule}`).join("\n")}
 
 => Now, you need to write the file content here. Let's go.
 `;
-    return { request, writePath };
+    return { guideJson, request, writePath };
   }
-  async requestUpdateDocumentPage(page) {
-    const writePath = `apps/angelo/app/${page}`;
+  async requestUpdateInstruction(updateRequest) {
+    const guideJson = await Prompter.getGuideJson(this.name);
+    const resultPath = `${__dirname}/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    const writePath = `${this.workspace.workspaceRoot}/pkgs/@akanjs/cli/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    const isResultExists = this.workspace.exists(writePath);
+    if (!isResultExists)
+      throw new Error(`${guideJson.update.filePath} file does not exist. Please create it first.`);
+    const existingResult = this.workspace.readFile(resultPath);
+    const request = `
+I am a developer of akanjs framework, a full-stack framework for building web applications.
+I want to update a ${guideJson.update.filePath} file for ${guideJson.description}.
+This file is a programming guideline for Akan.js framwork users.
+
+# ${guideJson.title} Workflow
+- 1. Read already-written ${guideJson.update.filePath} file.
+- 2. Write the updated file content of the ${guideJson.update.filePath} with the update request.
+
+## 1. Read already-written ${guideJson.update.filePath} file.
+\`\`\`markdown
+${existingResult}
+\`\`\`
+
+## 2. Write the updated file content of the ${guideJson.update.filePath} with the update request.
+Request: ${updateRequest}
+
+=> Now, you need to write the file content here. Let's go.
+`;
+    return { guideJson, request, writePath };
+  }
+  async requestCreateDocumentPage(page) {
+    const writePath = `apps/angelo/app${page}`;
     if (!this.workspace.exists(writePath))
       this.workspace.writeFile(
         writePath,
@@ -5554,30 +5591,99 @@ ${guideJson.update.rules.map((rule) => `- ${rule}`).join("\n")}
     const instruction = await Prompter.getInstruction(this.name);
     const pageContent = this.workspace.getLocalFile(writePath);
     const request = `
-\uB098\uB294 Akan.js \uD504\uB808\uC784\uC6CC\uD06C\uC5D0 \uB300\uD55C documentation \uC6F9\uC0AC\uC774\uD2B8\uB97C \uB9CC\uB4E4\uACE0 \uC788\uC5B4.
+I'm creating a documentation website for the Akan.js framework.
 
-1. Akan.js \uD504\uB808\uC784\uC6CC\uD06C\uC5D0 \uB300\uD55C \uAC1C\uC694
+1. Overview of the Akan.js framework
 ${await this.getDocumentation("framework")}
 
-\uB098\uB294 ${writePath}\uC5D0 \uC788\uB294 Next.js \uC11C\uBC84\uC0AC\uC774\uB4DC \uD398\uC774\uC9C0\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uB824\uACE0 \uD574.
-\uC544\uB798\uB294 \uD604\uC7AC \uC791\uC131\uB41C \uD398\uC774\uC9C0\uC758 \uB0B4\uC6A9\uC774\uC57C.
+2. Documentation page writing method
+${await this.getDocumentation("docPageRule")}
+
+3. CSS rule with TailwindCSS and DaisyUI
+${await this.getDocumentation("cssRule")}
+
+I want to update the Next.js server-side page located at ${writePath}.
+Below is the content of the currently written page.
+\`\`\`tsx
+// File: ${writePath}
+${pageContent.content}
+\`\`\`
+
+Please update this page with the latest content below. A great design application is needed.
+${instruction}
+
+Please follow these CSS rules when writing:
+- Use tailwindcss
+- Use className from the daisyui library
+
+Please return only the file result in the following format for easy parsing.
+\`\`\`tsx
+// File: ${writePath}
+...pageContent
+\`\`\`
+`;
+    return { request, writePath };
+  }
+  async requestUpdateDocumentPage(page, updateRequest) {
+    const writePath = `apps/angelo/app${page}`;
+    if (!this.workspace.exists(writePath))
+      this.workspace.writeFile(
+        writePath,
+        `export default function Page() {
+  return <div>No Content</div>;
+}
+`
+      );
+    const instruction = await Prompter.getInstruction(this.name);
+    const pageContent = this.workspace.getLocalFile(writePath);
+    const request = `
+I'm updating a documentation website for the Akan.js framework.
+
+I want to update the Next.js server-side page located at ${writePath}.
+Below is the content of the currently written page. You should update stale infos and preserve the existing content.
 \`\`\`tsx
 // File: ${writePath}
 ${pageContent.content}
 \`\`\`
 
-\uD574\uB2F9 \uD398\uC774\uC9C0\uC5D0 \uC544\uB798 \uB0B4\uC6A9\uC744 \uCD5C\uC2E0\uD654 \uD574\uC11C \uC5C5\uB370\uC774\uD2B8\uD574\uC918. \uADFC\uC0AC\uD55C \uB514\uC790\uC778\uC73C\uB85C \uC801\uC6A9\uC774 \uD544\uC694\uD574.
+The existing instruction is below.
+\`\`\`markdown
 ${instruction}
+\`\`\`
 
-CSS\uADDC\uCE59\uC740 \uB2E4\uC74C\uC744 \uB530\uB77C\uC11C \uC791\uC131\uD574\uC918.
-- tailwindcss\uB97C \uC0AC\uC6A9\uD560 \uAC83
-- daisyui \uB77C\uC774\uBE0C\uB7EC\uB9AC\uC758 className\uC744 \uC0AC\uC6A9\uD560 \uAC83
+Please update this page with the request below.
+${updateRequest}
 
-\uD30C\uC2F1\uD558\uAE30 \uC27D\uAC8C \uD30C\uC77C \uACB0\uACFC\uB9CC \uB2E4\uC74C\uACFC \uAC19\uC740 \uD615\uC2DD\uC73C\uB85C \uBC18\uD658\uD574\uC918.
+Please return only the file result in the following format for easy parsing.
 \`\`\`tsx
 // File: ${writePath}
 ...pageContent
 \`\`\`
+`;
+    return { request, writePath };
+  }
+  async requestReapplyInstruction(filePath) {
+    const guideJson = await Prompter.getGuideJson(this.name);
+    const writePath = `${this.workspace.workspaceRoot}/pkgs/@akanjs/cli/src/guidelines/${this.name}/${guideJson.update.filePath}`;
+    if (!guideJson.page)
+      throw new Error(`${this.name} does not have a page.`);
+    const pagePath = `apps/angelo/app${guideJson.page}`;
+    const pageFile = this.workspace.getLocalFile(pagePath);
+    const request = `
+I want to apply information in the Next.js page to markdown instruction file.
+
+Here's the newest information in the Next.js page.
+\`\`\`tsx
+// File: ${pagePath}
+${pageFile.content}
+\`\`\`
+
+Here's the existing instruction file.
+\`\`\`markdown
+${await Prompter.getInstruction(this.name)}
+\`\`\`
+
+Please update the instruction file with the information in the Next.js page.
 `;
     return { request, writePath };
   }
@@ -5588,18 +5694,44 @@ var GuidelineRunner = class {
   async generateInstruction(workspace, guideName) {
     const session = new AiSession("generateInstruction", { workspace, cacheKey: guideName });
     const prompt = new GuidelinePrompt(workspace, guideName);
-    const { request, writePath } = await prompt.requestCreateInstruction();
+    const { guideJson, request, writePath } = await prompt.requestCreateInstruction();
     const guidelineContent = await session.editMarkdown(request);
     workspace.writeFile(writePath, guidelineContent);
+    return { guideJson, session };
   }
-  async deployDocPages(workspace, guideName) {
+  async updateInstruction(workspace, guideName, { updateRequest }) {
+    const session = new AiSession("updateInstruction", { workspace, cacheKey: guideName });
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { guideJson, request, writePath } = await prompt.requestUpdateInstruction(updateRequest);
+    const guidelineContent = await session.editMarkdown(request);
+    workspace.writeFile(writePath, guidelineContent);
+    return { guideJson, session };
+  }
+  async generateDocument(workspace, guideName) {
     const session = new AiSession("deployDocPages", { workspace, cacheKey: guideName });
     const guideJson = await Prompter.getGuideJson(guideName);
     const prompt = new GuidelinePrompt(workspace, guideName);
-    const { request, writePath } = await prompt.requestUpdateDocumentPage(guideJson.page);
+    if (!guideJson.page)
+      return Promise.resolve({});
+    const { request } = await prompt.requestCreateDocumentPage(guideJson.page);
+    await session.writeTypescripts(request, workspace);
+  }
+  async updateDocument(workspace, guideName, { updateRequest, session }) {
+    const guideJson = await Prompter.getGuideJson(guideName);
+    if (!guideJson.page)
+      throw new Error(`${guideName} does not have a page.`);
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { request, writePath } = await prompt.requestUpdateDocumentPage(guideJson.page, updateRequest);
+    const guidelineContent = await session.editMarkdown(request);
+    workspace.writeFile(writePath, guidelineContent);
+  }
+  async reapplyInstruction(workspace, guideName) {
+    const session = new AiSession("reapplyInstruction", { workspace, cacheKey: guideName });
+    const guideJson = await Prompter.getGuideJson(guideName);
+    const prompt = new GuidelinePrompt(workspace, guideName);
+    const { request, writePath } = await prompt.requestReapplyInstruction(guideJson.update.filePath);
     const guidelineContent = await session.editMarkdown(request);
     workspace.writeFile(writePath, guidelineContent);
-    return Promise.resolve({});
   }
 };
 
@@ -5610,9 +5742,23 @@ var GuidelineScript = class {
     const guideName = name ?? await Prompter.selectGuideline();
     await this.#runner.generateInstruction(workspace, guideName);
   }
-  async deployDocPages(workspace, name = null) {
+  async updateInstruction(workspace, name = null, updateRequest) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    const { guideJson, session } = await this.#runner.updateInstruction(workspace, guideName, { updateRequest });
+    if (guideJson.page)
+      await this.updateDocument(workspace, guideName, { updateRequest, session });
+  }
+  async generateDocument(workspace, name = null) {
     const guideName = name ?? await Prompter.selectGuideline();
-    await this.#runner.deployDocPages(workspace, guideName);
+    await this.#runner.generateDocument(workspace, guideName);
+  }
+  async updateDocument(workspace, name = null, { updateRequest, session }) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    await this.#runner.updateDocument(workspace, guideName, { updateRequest, session });
+  }
+  async reapplyInstruction(workspace, name = null) {
+    const guideName = name ?? await Prompter.selectGuideline();
+    await this.#runner.reapplyInstruction(workspace, guideName);
   }
 };
 
@@ -5622,8 +5768,14 @@ var GuidelineCommand = class {
   async generateInstruction(name, workspace) {
     await this.guidelineScript.generateInstruction(workspace, name);
   }
-  async deployDocs(name, workspace) {
-    await this.guidelineScript.deployDocPages(workspace, name);
+  async updateInstruction(name, request, workspace) {
+    await this.guidelineScript.updateInstruction(workspace, name, request);
+  }
+  async generateDocument(name, workspace) {
+    await this.guidelineScript.generateDocument(workspace, name);
+  }
+  async reapplyInstruction(name, workspace) {
+    await this.guidelineScript.reapplyInstruction(workspace, name);
   }
 };
 __decorateClass([
@@ -5631,11 +5783,22 @@ __decorateClass([
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
 ], GuidelineCommand.prototype, "generateInstruction", 1);
+__decorateClass([
+  Target.Public(),
+  __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
+  __decorateParam(1, Option("request", { ask: "What do you want to update?" })),
+  __decorateParam(2, Workspace())
+], GuidelineCommand.prototype, "updateInstruction", 1);
+__decorateClass([
+  Target.Public(),
+  __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
+  __decorateParam(1, Workspace())
+], GuidelineCommand.prototype, "generateDocument", 1);
 __decorateClass([
   Target.Public(),
   __decorateParam(0, Argument("name", { ask: "name of the instruction", nullable: true })),
   __decorateParam(1, Workspace())
-], GuidelineCommand.prototype, "deployDocs", 1);
+], GuidelineCommand.prototype, "reapplyInstruction", 1);
 GuidelineCommand = __decorateClass([
   Commands()
 ], GuidelineCommand);
@@ -5644,7 +5807,7 @@ GuidelineCommand = __decorateClass([
 import pluralize2 from "pluralize";
 
 // pkgs/@akanjs/cli/src/scalar/scalar.prompt.ts
-import { input as input4 } from "@inquirer/prompts";
+import { input as input5 } from "@inquirer/prompts";
 var ScalarPrompt = class extends Prompter {
   constructor(sys3, name) {
     super();
@@ -5652,13 +5815,13 @@ var ScalarPrompt = class extends Prompter {
     this.name = name;
   }
   async requestUpdateConstant() {
-    const request = await input4({ message: `What do you want to change?` });
+    const request = await input5({ message: `What do you want to change?` });
     return { request, validate: void 0 };
   }
   async requestCreateConstant() {
     const constantFiles = await this.sys.getConstantFilesWithLibs();
-    const description = await input4({ message: "description of scalar scalar" });
-    const schemaDescription = await input4({ message: "schema description of scalar scalar" });
+    const description = await input5({ message: "description of scalar scalar" });
+    const schemaDescription = await input5({ message: "schema description of scalar scalar" });
     await this.sys.applyTemplate({
       basePath: "./lib/__scalar",
       template: "__scalar",

package/esm/src/guidelines/componentRule/componentRule.instruction.md

@@ -5,10 +5,9 @@
 1. [Component Architecture](#component-architecture)
 2. [Component Types](#component-types)
 3. [File Naming Conventions](#file-naming-conventions)
-4. [CSS Rule with TailwindCSS and DaisyUI](#css-rule-with-tailwindcss-and-daisyui)
-5. [Utility Functions](#utility-functions)
-6. [Best Practices](#best-practices)
-7. [Complete Examples](#complete-examples)
+4. [Utility Functions](#utility-functions)
+5. [Best Practices](#best-practices)
+6. [Complete Examples](#complete-examples)
 
 ---
 
@@ -248,83 +247,6 @@ Akan.js uses a strict naming convention to maintain consistency:
 
 ---
 
-## CSS Rule with TailwindCSS and DaisyUI
-
-Akan.js uses TailwindCSS with DaisyUI for styling. Follow these guidelines:
-
-### 1. Class Management
-
-Always use `clsx` for conditional and composite classes:
-
-```tsx
-import { clsx } from "@akanjs/client";
-
-className={clsx(
-  "base-classes",
-  condition && "conditional-class",
-  variant === "primary" ? "primary-class" : "secondary-class",
-  className // Always include passed className for composition
-)}
-```
-
-### 2. Color System
-
-Use DaisyUI's theme colors instead of hardcoded values. This ensures theme consistency and dark/light mode compatibility:
-
-```tsx
-// Good - uses theme colors
-className = "bg-primary text-base-100";
-
-// Bad - uses hardcoded colors
-className = "bg-[#C33C32] text-[#FFFFFF]";
-```
-
-DaisyUI provides semantic colors:
-
-- `primary`, `secondary`, `accent` - Brand colors
-- `base-100` through `base-900` - Background/text variants
-- `info`, `success`, `warning`, `error` - Status colors
-
-### 3. Responsive Design
-
-Use Tailwind's responsive prefixes:
-
-```tsx
-<div className="flex-col md:flex-row">
-  <div className="w-full md:w-1/2 lg:w-1/3">Responsive width</div>
-  <div className="hidden lg:block">Only visible on large screens</div>
-</div>
-```
-
-### 4. Animation
-
-Use Tailwind animation classes with transitions:
-
-```tsx
-<div className="transition-all duration-300 hover:scale-105">
-  Hover effect
-</div>
-
-<div className="animate-pulse">Loading indicator</div>
-```
-
-### 5. Component Styling
-
-Use DaisyUI components for consistent UIs:
-
-```tsx
-<button className="btn btn-primary btn-sm">Primary Button</button>
-
-<div className="card bg-base-200 shadow-md">
-  <div className="card-body">
-    <h2 className="card-title">Card Title</h2>
-    <p>Card content</p>
-  </div>
-</div>
-```
-
----
-
 ## Utility Functions
 
 Akan.js provides several utility modules for common frontend tasks: