@akanjs/cli 2.4.2-rc.3 → 3.0.0-alpha.0

package/{index-zn9rh7sh.js → index-n0z3f2xg.js}

@@ -1,26 +1,37 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-v9jqrdd1.js";
+} from "./index-4yp06pn1.js";
 import {
   Prompter
-} from "./index-xftstr5s.js";
+} from "./index-xwgm94zr.js";
 import {
   runner,
   script
-} from "./index-d0h48d2f.js";
+} from "./index-jk9q6pse.js";
+import {
+  AGENT_BLOCK_END,
+  AGENT_BLOCK_START,
+  AppExecutor,
+  LibExecutor,
+  renderRecipeEntries,
+  upsertAgentBlock
+} from "./index-jtm86byd.js";
+import {
+  collectRecipeSources,
+  scanRecipes
+} from "./index-xys926f2.js";
 
 // pkgs/@akanjs/cli/agent/agent.script.ts
-import { Logger } from "akanjs/common";
+import { Logger as Logger2 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/agent/agent.runner.ts
+import { Logger } from "akanjs/common";
 var targetPaths = {
   cursor: ".cursor/rules/akan.mdc",
   "agents-md": "AGENTS.md",
   claude: "CLAUDE.md"
 };
-var AGENT_BLOCK_START = "<!-- akan:agent:start -->";
-var AGENT_BLOCK_END = "<!-- akan:agent:end -->";
 var SAMPLE_ARTIFACTS = [
   { probe: "lib/task/task.constant.ts", target: "lib/task", label: "sample database module" },
   { probe: "lib/_noti/noti.service.ts", target: "lib/_noti", label: "sample service module" },
@@ -60,12 +71,44 @@ ${items.join(`
 
 Keep a sample only while you are still learning its pattern; delete it once your own modules cover the same ground.
 
+`;
+};
+var renderRecipeIndex = async (workspace) => {
+  const sources = await collectRecipeSources(`${workspace.workspaceRoot}/pkgs/akanjs/ui`, "akanjs/ui", "recipe");
+  const recipes = scanRecipes(sources);
+  const scopeIndexPointer = `App and lib recipes are **not** listed here. Each app/lib carries its own generated index \u2014
+\`apps/<app>/AGENTS.md\` / \`libs/<lib>/AGENTS.md\` (\`## Recipes In Scope\`) \u2014 regenerated by \`akan sync\` and
+verified by \`akan lint\`. When working inside an app or lib, consult that file before consuming or authoring a look.`;
+  if (recipes.length === 0)
+    return `## Recipes
+
+${scopeIndexPointer}
+
+`;
+  return `## Recipes
+
+Framework UI recipes (Tailwind-variant look factories), importable from every app and lib. Consume by exact name \u2014
+\`import { <name> } from "akanjs/ui"\`, then \`<name>(variants?, className?)\`. The second arg merges internally and
+takes **an array too**, so never wrap it in \`cn()\`: \`<name>({}, ["h-full", isWide && "w-full", className])\`.
+Do not guess recipe names, import paths, or variant values; the list below carries
+the full contract (\`*\` marks the default, \`key?\` is a boolean flag), so there is no need to open the recipe file to
+consume one. tsc still reports variant mistakes. **Before inlining a repeated surface (card, box,
+tile, \u2026): reuse a recipe, or add one as \`apps/<app>/ui/Recipe/<name>.ts\` (one recipe per file, re-exported from
+that folder's \`index.ts\`) \u2014 never re-implement the same look inline in several places, and never author a
+near-duplicate.** Full authoring/consumption policy: the \`recipeRule\` guideline.
+
+${renderRecipeEntries(recipes)}
+
+${scopeIndexPointer}
+
 `;
 };
 var renderManagedBlock = async (workspace) => {
   const context = await AkanContextAnalyzer.analyze(workspace);
   const frameworkGuide = await Prompter.getInstruction("framework");
-  const sampleCleanup = await renderSampleCleanup(workspace, context.apps.map((app) => app.name));
+  const appNames = context.apps.map((app) => app.name);
+  const sampleCleanup = await renderSampleCleanup(workspace, appNames);
+  const recipeIndex = await renderRecipeIndex(workspace);
   return `## Workspace
 
 - Repo: ${context.repoName}
@@ -86,7 +129,7 @@ ${sampleCleanup}## Akan Module Abstracts
 Do not hand-edit generated Akan files such as ${context.generatedFiles.map((file) => `\`${file}\``).join(", ")}.
 If generated output is stale or broken, update the owning source file and run \`akan repair generated\` or \`akan sync <app-or-lib>\`.
 
-## MCP Workflow Policy
+${recipeIndex}## MCP Workflow Policy
 
 - Prefer Akan MCP workflows before direct source edits.
 - Direct source edits are denied when an allowlisted Akan workflow or repair tool can perform the change.
@@ -107,24 +150,10 @@ ${context.validationCommands.map((command) => `- \`${command}\``).join(`
 
 ${frameworkGuide.trim()}`;
 };
-var upsertManagedBlock = (existing, block) => {
-  const managed = `${AGENT_BLOCK_START}
-${block}
-${AGENT_BLOCK_END}`;
-  const startIndex = existing.indexOf(AGENT_BLOCK_START);
-  const endIndex = existing.indexOf(AGENT_BLOCK_END);
-  if (startIndex >= 0 && endIndex > startIndex) {
-    return `${existing.slice(0, startIndex)}${managed}${existing.slice(endIndex + AGENT_BLOCK_END.length)}`;
-  }
-  return `${existing.replace(/\s*$/, "")}
-
-${managed}
-`;
-};
 var renderAgentsMd = async (workspace, existing) => {
   const block = await renderManagedBlock(workspace);
   if (existing?.trim())
-    return upsertManagedBlock(existing, block);
+    return upsertAgentBlock(existing, block);
   const context = await AkanContextAnalyzer.analyze(workspace);
   return `# ${context.repoName} Agent Guide
 
@@ -176,6 +205,26 @@ class AgentRunner extends runner("agent") {
       await workspace.writeFile(filePath, content, { overwrite: true });
       written.push(filePath);
     }
+    if (targets.includes("agents-md"))
+      written.push(...await this.#installScopeIndexes(workspace));
+    return written;
+  }
+  async#installScopeIndexes(workspace) {
+    const [appNames, libNames] = await workspace.getExecs();
+    const written = [];
+    const syncScope = async (exec) => {
+      try {
+        await exec.syncAgentsIndex();
+        written.push(`${exec.type}s/${exec.name}/AGENTS.md`);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        Logger.rawLog(`Skipped ${exec.type}s/${exec.name}/AGENTS.md (${message})`, undefined, "warn");
+      }
+    };
+    for (const name of libNames)
+      await syncScope(LibExecutor.from(workspace, name));
+    for (const name of appNames)
+      await syncScope(AppExecutor.from(workspace, name));
     return written;
   }
 }
@@ -194,7 +243,7 @@ class AgentScript extends script("agent", [AgentRunner]) {
     if (action !== "install")
       throw new Error(`Unknown agent action: ${action}. Use "install".`);
     const written = await this.agentRunner.install(workspace, resolveTargets(target), { force });
-    Logger.rawLog(`Agent rules written:
+    Logger2.rawLog(`Agent rules written:
 ${written.map((file) => `- ${file}`).join(`
 `)}`);
   }

package/{index-7k9sj7j5.js → index-pyt2b4nw.js}

@@ -2217,4 +2217,216 @@ ${preparedCssText}`).toString(36);
     return [basePath, { cssUrl, cssRelPath }];
   }
 }
+// pkgs/@akanjs/devkit/frontendBuild/styleGuard.ts
+var PREFIX = "(?:bg|text|border(?:-[tblrxy])?(?:-[se])?|ring(?:-offset)?|fill|stroke|shadow|from|to|via|divide|outline|decoration|placeholder|caret|accent)";
+var PALETTE = "(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|green|emerald|teal|cyan|sky|blue|indigo|violet|purple|fuchsia|pink|rose)";
+var LEAD = "(^|[\\s\"'`{(\\[:!])";
+var TAIL = "(?=[\\s\"'`})\\]:/!,]|$)";
+var RAW_PALETTE_RE = new RegExp(`${LEAD}((?:${PREFIX})-)${PALETTE}-\\d{2,3}${TAIL}`, "g");
+var ARBITRARY_COLOR_RE = /\[(#[0-9a-fA-F]{3,8}|(?:rgb|rgba|hsl|hsla|oklch|oklab|lab|lch|hwb|color)\([^\]]*\))\]/g;
+var INTERPOLATED_ARBITRARY_RE = new RegExp(`${LEAD}[a-z][a-z0-9-]*-\\[[^\\]\`]*\\$\\{`, "g");
+var STYLE_OBJECT_RE = /style=\{\{([\s\S]*?)\}\}/g;
+var STYLE_TAG_RE = /<style[^>]*>([\s\S]*?)<\/style>/g;
+var INLINE_COLOR_LITERAL_RE = /#[0-9a-fA-F]{3,8}\b|(?:rgb|rgba|hsl|hsla|oklch|oklab|lab|lch|hwb)\(/g;
+var DAISYUI_LEGACY_RE = new RegExp(`${LEAD}(?:` + "btn-(?:primary|secondary|accent|neutral|info|success|warning|error|ghost|link|outline|square|circle|wide|block|xs|sm|md|lg)|" + "badge-(?:primary|secondary|accent|neutral|info|success|warning|error|ghost|outline)|" + "alert-(?:info|success|warning|error)|" + "input-(?:bordered|primary|secondary|accent|ghost|error)|" + "select-(?:bordered|primary|ghost)|textarea-(?:bordered|primary|ghost)|" + "checkbox-(?:primary|secondary|accent)|toggle-(?:primary|secondary|accent)|" + "loading-(?:spinner|dots|ring|ball|bars|infinity)|" + "card-(?:body|title|actions)|modal-(?:box|action|backdrop)|" + "collapse-(?:title|content|arrow|plus)|dropdown-(?:content|end|start|hover)|" + "stat-(?:title|value|desc)|tabs-(?:boxed|lifted|bordered)|tab-active|" + "menu-(?:title|dropdown)|steps-(?:horizontal|vertical)|join-item|" + "mockup-(?:code|phone|browser|window)|drawer-(?:side|content|toggle)" + `)${TAIL}`, "g");
+var ALL_RULES = [
+  "raw-palette",
+  "arbitrary-color",
+  "inline-color",
+  "daisyui-legacy",
+  "interpolated-arbitrary"
+];
+
+class StyleGuard {
+  run(files) {
+    const out = [];
+    for (const file of files) {
+      const directives = this.#parseDirectives(file.content);
+      const scan = this.#stripComments(file.content);
+      const local = [];
+      this.#scanClassLiterals(file, scan, local);
+      this.#scanInlineColors(file, scan, local);
+      for (const v of local)
+        if (!this.#isSuppressed(v, directives))
+          out.push(v);
+    }
+    return out;
+  }
+  #stripComments(src) {
+    const out = src.split("");
+    const blank = (i2) => {
+      if (src[i2] !== `
+`)
+        out[i2] = " ";
+    };
+    let state = "code";
+    let i = 0;
+    while (i < src.length) {
+      const c = src[i];
+      const d = src[i + 1];
+      if (state === "code") {
+        if (c === "/" && d === "/") {
+          blank(i);
+          blank(i + 1);
+          state = "line";
+          i += 2;
+        } else if (c === "/" && d === "*") {
+          blank(i);
+          blank(i + 1);
+          state = "block";
+          i += 2;
+        } else {
+          if (c === "'")
+            state = "squote";
+          else if (c === '"')
+            state = "dquote";
+          else if (c === "`")
+            state = "template";
+          i++;
+        }
+      } else if (state === "line") {
+        if (c === `
+`)
+          state = "code";
+        else
+          blank(i);
+        i++;
+      } else if (state === "block") {
+        if (c === "*" && d === "/") {
+          blank(i);
+          blank(i + 1);
+          state = "code";
+          i += 2;
+        } else {
+          blank(i);
+          i++;
+        }
+      } else {
+        const close = state === "squote" ? "'" : state === "dquote" ? '"' : "`";
+        if (c === "\\")
+          i += 2;
+        else {
+          if (c === close)
+            state = "code";
+          i++;
+        }
+      }
+    }
+    return out.join("");
+  }
+  #parseDirectives(content) {
+    const directives = { file: null, nextLine: new Map };
+    const lines = content.split(`
+`);
+    for (let i = 0;i < lines.length; i++) {
+      const line = lines[i];
+      const nextLineMatch = line.match(/styleguard-disable-next-line\b(.*)$/);
+      if (nextLineMatch) {
+        directives.nextLine.set(i + 2, this.#extractRules(nextLineMatch[1]));
+        continue;
+      }
+      const fileMatch = line.match(/styleguard-disable\b(.*)$/);
+      if (fileMatch)
+        directives.file = this.#mergeFileScope(directives.file, this.#extractRules(fileMatch[1]));
+    }
+    return directives;
+  }
+  #extractRules(tail) {
+    const found = ALL_RULES.filter((rule) => tail.includes(rule));
+    return found.length === 0 ? "all" : new Set(found);
+  }
+  #mergeFileScope(prev, next) {
+    if (prev === "all" || next === "all")
+      return "all";
+    return new Set([...prev ?? [], ...next]);
+  }
+  #isSuppressed(v, directives) {
+    if (directives.file === "all" || directives.file?.has(v.rule))
+      return true;
+    const nextLine = directives.nextLine.get(v.line);
+    return nextLine === "all" || (nextLine?.has(v.rule) ?? false);
+  }
+  #scanClassLiterals(file, scan, out) {
+    for (const m of scan.matchAll(RAW_PALETTE_RE)) {
+      out.push(this.#violation(file, m.index ?? 0, {
+        rule: "raw-palette",
+        severity: "error",
+        suggestion: "\uC2DC\uB9E8\uD2F1 \uD1A0\uD070\uC73C\uB85C \uAD50\uCCB4\uD558\uC138\uC694 \u2014 \uC608: text-gray-500\u2192text-muted-foreground, bg-red-500\u2192bg-destructive, bg-blue-500\u2192bg-info. \uBE0C\uB79C\uB4DC \uC0C9\uC740 page/styles.css \uD1A0\uD070\uC5D0\uC11C \uC870\uC815\uD569\uB2C8\uB2E4."
+      }));
+    }
+    for (const m of scan.matchAll(ARBITRARY_COLOR_RE)) {
+      out.push(this.#violation(file, m.index ?? 0, {
+        rule: "arbitrary-color",
+        severity: "error",
+        suggestion: "\uC784\uC758 \uC0C9 \uB9AC\uD130\uB7F4 \uB300\uC2E0 \uD1A0\uD070\uC744 \uC4F0\uC138\uC694 \u2014 bg-[#3b82f6]\u2192bg-info, text-[rgb(...)]\u2192\uC2DC\uB9E8\uD2F1 \uD1A0\uD070. \uAF2D \uD544\uC694\uD558\uBA74 \uC2A4\uCF54\uD504 \uD1A0\uD070(.campaign-x { --primary: \u2026 })\uC744 \uC815\uC758\uD558\uC138\uC694."
+      }));
+    }
+    for (const m of scan.matchAll(DAISYUI_LEGACY_RE)) {
+      out.push(this.#violation(file, m.index ?? 0, {
+        rule: "daisyui-legacy",
+        severity: "error",
+        suggestion: "daisyUI \uD074\uB798\uC2A4\uB294 \uC81C\uAC70\uB410\uC2B5\uB2C8\uB2E4. akanjs/ui \uD504\uB9AC\uBBF8\uD2F0\uBE0C(Button/Badge \uB4F1)\uB098 buttonRecipe()/badgeRecipe() + \uC2DC\uB9E8\uD2F1 \uD1A0\uD070\uC73C\uB85C \uAD50\uCCB4\uD558\uC138\uC694."
+      }));
+    }
+    for (const m of scan.matchAll(INTERPOLATED_ARBITRARY_RE)) {
+      out.push(this.#violation(file, m.index ?? 0, {
+        rule: "interpolated-arbitrary",
+        severity: "error",
+        suggestion: "\uB7F0\uD0C0\uC784 \uAC12\uC73C\uB85C \uC784\uC758\uAC12 \uD074\uB798\uC2A4\uB97C \uC870\uB9BD\uD558\uBA74 CSS \uAC00 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC2A4\uCE90\uB108\uB294 \uC18C\uC2A4 \uD14D\uC2A4\uD2B8\uB97C \uC77D\uC2B5\uB2C8\uB2E4). \uD06C\uAE30/\uC704\uCE58\uB294 style prop \uC73C\uB85C \uB118\uAE30\uC138\uC694 \u2014 style={{ minHeight }}. \uAC12\uC774 enum \uC774\uBA74 \uB9AC\uD130\uB7F4 \uD074\uB798\uC2A4 \uB9F5\uC73C\uB85C \uB450\uC138\uC694."
+      }));
+    }
+  }
+  #scanInlineColors(file, scan, out) {
+    const push = (index) => out.push(this.#violation(file, index, {
+      rule: "inline-color",
+      severity: "error",
+      suggestion: "\uC778\uB77C\uC778 \uC0C9 \uB9AC\uD130\uB7F4 \uB300\uC2E0 CSS \uBCC0\uC218/\uD1A0\uD070\uC744 \uCC38\uC870\uD558\uC138\uC694 \u2014 style={{ color: 'var(--primary)' }} \uB610\uB294 \uC2DC\uB9E8\uD2F1 \uD074\uB798\uC2A4(text-primary). \uD558\uB4DC\uCF54\uB529 hex/rgb \uB294 \uD14C\uB9C8 \uC804\uD658\uC744 \uAE68\uB728\uB9BD\uB2C8\uB2E4."
+    }));
+    for (const region of [STYLE_OBJECT_RE, STYLE_TAG_RE]) {
+      for (const m of scan.matchAll(region)) {
+        const inner = m[1] ?? "";
+        const innerStart = (m.index ?? 0) + m[0].indexOf(inner);
+        for (const lit of inner.matchAll(INLINE_COLOR_LITERAL_RE)) {
+          push(innerStart + (lit.index ?? 0));
+        }
+      }
+    }
+  }
+  #violation(file, index, base) {
+    const before = file.content.slice(0, index);
+    const line = before.length === 0 ? 1 : before.split(`
+`).length;
+    const lineStart = before.lastIndexOf(`
+`) + 1;
+    const lineEnd = file.content.indexOf(`
+`, index);
+    const snippet = file.content.slice(lineStart, lineEnd === -1 ? undefined : lineEnd).trim();
+    return { ...base, path: file.path, line, snippet };
+  }
+  static countNamedComponentClasses(css) {
+    const names = new Set;
+    const layerRe = /@layer\s+components\s*\{/g;
+    for (const layer of css.matchAll(layerRe)) {
+      const bodyStart = (layer.index ?? 0) + layer[0].length;
+      const body = StyleGuard.#extractBalanced(css, bodyStart);
+      for (const sel of body.matchAll(/(^|[\s}])\.(-?[a-zA-Z_][\w-]*)/g))
+        names.add(sel[2]);
+    }
+    return { count: names.size, names: [...names].sort() };
+  }
+  static #extractBalanced(css, start) {
+    let depth = 1;
+    for (let i = start;i < css.length; i++) {
+      const ch = css[i];
+      if (ch === "{")
+        depth++;
+      else if (ch === "}") {
+        depth--;
+        if (depth === 0)
+          return css.slice(start, i);
+      }
+    }
+    return css.slice(start);
+  }
+}
 export { AllRoutesBuilder, CsrArtifactBuilder, CssCompiler, FontOptimizer, PagesBundleBuilder, precompressArtifacts, SsrBaseArtifactBuilder };

package/{index-acwxfncv.js → index-r4w8cry5.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-04as43rp.js";
+} from "./index-vhv3xnjz.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-pfnh87f9.js";
+} from "./index-4zgs8g1w.js";
 import {
   script
-} from "./index-d0h48d2f.js";
+} from "./index-jk9q6pse.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-xwfg9bam.js";
+} from "./index-jtm86byd.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-zfp1gz9f.js → index-sggm9qkv.js}

@@ -5,7 +5,7 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   CommandExecutionError
-} from "./index-xwfg9bam.js";
+} from "./index-jtm86byd.js";
 
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";

package/{index-04as43rp.js → index-vhv3xnjz.js}

@@ -1,10 +1,13 @@
 // @bun
 import {
   PageScript
-} from "./index-dgeaqwmw.js";
+} from "./index-hjzr8ja1.js";
 import {
   pluralizeName
 } from "./index-ss469dec.js";
+import {
+  AiSession
+} from "./index-3pgtw35d.js";
 import {
   bilingualDescriptionForField,
   bilingualLabelForField,
@@ -12,20 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-pfnh87f9.js";
+} from "./index-4zgs8g1w.js";
 import {
   Prompter
-} from "./index-xftstr5s.js";
-import {
-  AiSession
-} from "./index-nsj2ftxj.js";
+} from "./index-xwgm94zr.js";
 import {
   runner,
   script
-} from "./index-d0h48d2f.js";
+} from "./index-jk9q6pse.js";
 import {
   ModuleExecutor
-} from "./index-xwfg9bam.js";
+} from "./index-jtm86byd.js";
 import {
   FileSys
 } from "./index-67546d0j.js";
@@ -352,9 +352,9 @@ var requestTemplate = ({
 	 \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
+		 - CSS: tailwind + akanjs/ui \uD504\uB9AC\uBBF8\uD2F0\uBE0C(Button/Badge/Input \uB4F1) + \uC2DC\uB9E8\uD2F1 \uD1A0\uD070(bg-background/text-foreground/bg-primary \uB4F1) \uC0AC\uC6A9 (DaisyUI \uAE08\uC9C0)
 		 - 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
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: cn \uD568\uC218 \uC0AC\uC6A9 (akanjs/client, cond && 'x' \uD615\uD0DC \u2014 \uAC1D\uCCB4 \uBB38\uBC95 \uC5C6\uC74C)
 	 \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
@@ -410,9 +410,9 @@ var requestView = ({
 	 \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
+		 - CSS: tailwind + akanjs/ui \uD504\uB9AC\uBBF8\uD2F0\uBE0C(Button/Badge/Input \uB4F1) + \uC2DC\uB9E8\uD2F1 \uD1A0\uD070(bg-background/text-foreground/bg-primary \uB4F1) \uC0AC\uC6A9 (DaisyUI \uAE08\uC9C0)
 		 - 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
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: cn \uD568\uC218 \uC0AC\uC6A9 (akanjs/client, cond && 'x' \uD615\uD0DC \u2014 \uAC1D\uCCB4 \uBB38\uBC95 \uC5C6\uC74C)
 	 \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
@@ -471,9 +471,9 @@ var requestUnit = ({
 	 \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
+		 - CSS: tailwind + akanjs/ui \uD504\uB9AC\uBBF8\uD2F0\uBE0C(Button/Badge/Input \uB4F1) + \uC2DC\uB9E8\uD2F1 \uD1A0\uD070(bg-background/text-foreground/bg-primary \uB4F1) \uC0AC\uC6A9 (DaisyUI \uAE08\uC9C0)
 		 - 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
+		 - \uC870\uAC74\uBD80 \uD074\uB798\uC2A4: cn \uD568\uC218 \uC0AC\uC6A9 (akanjs/client, cond && 'x' \uD615\uD0DC \u2014 \uAC1D\uCCB4 \uBB38\uBC95 \uC5C6\uC74C)
 	 \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
@@ -579,7 +579,7 @@ class ModuleRunner extends runner("module") {
     await module.sys.applyTemplate({
       basePath: `./lib/${module.name}`,
       template: `module/__Model__.${capitalize2(type)}.tsx`,
-      dict: { model: module.name, appName: module.sys.name }
+      dict: { model: module.name, sysName: module.sys.name, sysType: module.sys.type }
     });
     return {
       component: {
@@ -612,6 +612,7 @@ class ModuleRunner extends runner("module") {
         model: module.name,
         models: names,
         sysName: module.sys.name,
+        sysType: module.sys.type,
         modelLabelEn: modelLabel.en,
         modelLabelKo: modelLabel.ko,
         modelDescEn: modelDescription.en,

package/index-xjd3rqzj.js

@@ -0,0 +1,129 @@
+// @bun
+// pkgs/@akanjs/devkit/frontendBuild/styleContract.ts
+var countBlocking = (v) => v.style.filter((s) => s.severity === "error").length + v.theme.length;
+var formatStyleContract = (v) => {
+  const lines = [];
+  for (const s of v.style) {
+    lines.push(`  [${s.severity}] ${s.rule}  ${s.path}:${s.line}`);
+    lines.push(`      ${s.snippet}`);
+    lines.push(`      \u2192 ${s.suggestion}`);
+  }
+  for (const t of v.theme) {
+    lines.push(`  [error] contrast  ${t.scope}  ${t.pair} = ${t.ratio}:1 (min ${t.threshold}:1)`);
+    lines.push(`      \u2192 ${t.suggestion}`);
+  }
+  return lines.join(`
+`);
+};
+
+// pkgs/@akanjs/devkit/frontendBuild/themeValidator.ts
+var PAIRS = [
+  { base: "background", fg: "foreground", threshold: 4.5 },
+  { base: "primary", fg: "primary-foreground", threshold: 4.5 },
+  { base: "secondary", fg: "secondary-foreground", threshold: 4.5 },
+  { base: "accent", fg: "accent-foreground", threshold: 4.5 },
+  { base: "neutral", fg: "neutral-foreground", threshold: 4.5 },
+  { base: "card", fg: "card-foreground", threshold: 4.5 },
+  { base: "popover", fg: "popover-foreground", threshold: 4.5 },
+  { base: "muted", fg: "muted-foreground", threshold: 3 },
+  { base: "info", fg: "info-foreground", threshold: 3 },
+  { base: "success", fg: "success-foreground", threshold: 3 },
+  { base: "warning", fg: "warning-foreground", threshold: 3 },
+  { base: "destructive", fg: "destructive-foreground", threshold: 3 },
+  { base: "open", fg: "open-foreground", threshold: 3 }
+];
+var THEME_SCOPES = new Set([":root", '[data-theme="dark"]', '[data-theme="light"]']);
+
+class ThemeValidator {
+  validate(css) {
+    const tokensByScope = ThemeValidator.parseThemeTokens(css);
+    const violations = [];
+    for (const [scope, tokens] of Object.entries(tokensByScope)) {
+      if (!THEME_SCOPES.has(scope))
+        continue;
+      violations.push(...this.validateScope(tokens, scope));
+    }
+    return violations;
+  }
+  validateScope(tokens, scope) {
+    const violations = [];
+    for (const { base, fg, threshold } of PAIRS) {
+      const bg = tokens[base];
+      const front = tokens[fg];
+      if (!bg || !front)
+        continue;
+      const bgRgb = ThemeValidator.parseHex(bg);
+      const fgRgb = ThemeValidator.parseHex(front);
+      if (!bgRgb || !fgRgb)
+        continue;
+      const ratio = ThemeValidator.contrastRatio(bgRgb, fgRgb);
+      if (ratio >= threshold)
+        continue;
+      violations.push({
+        scope,
+        pair: `${base} / ${fg}`,
+        background: bg,
+        foreground: front,
+        ratio: Math.round(ratio * 100) / 100,
+        threshold,
+        suggestion: `${scope}\uC758 --${base}(${bg})\uC640 --${fg}(${front}) \uB300\uBE44\uAC00 ${ratio.toFixed(2)}:1 \uB85C \uCD5C\uC18C ${threshold}:1 \uBBF8\uB9CC\uC785\uB2C8\uB2E4. \uD55C\uCABD\uC744 \uB354 \uBC1D\uAC8C/\uC5B4\uB461\uAC8C \uC870\uC815\uD574 \uB300\uBE44\uB97C \uD655\uBCF4\uD558\uC138\uC694.`
+      });
+    }
+    return violations;
+  }
+  static parseThemeTokens(css) {
+    const result = {};
+    const blockRe = /(?:^|})\s*([^{}@]+?)\s*\{([^{}]*)\}/g;
+    for (const block of css.matchAll(blockRe)) {
+      const selectors = block[1].split(",").map((s) => s.trim());
+      const relevant = selectors.filter((s) => THEME_SCOPES.has(ThemeValidator.#normalizeScope(s)));
+      if (relevant.length === 0)
+        continue;
+      const decls = {};
+      for (const decl of block[2].matchAll(/--([\w-]+)\s*:\s*([^;]+?)\s*(?:;|$)/g)) {
+        decls[decl[1]] = decl[2].trim();
+      }
+      for (const selector of relevant) {
+        const scope = ThemeValidator.#normalizeScope(selector);
+        result[scope] = { ...result[scope] ?? {}, ...decls };
+      }
+    }
+    return result;
+  }
+  static #normalizeScope(selector) {
+    return selector.replace(/\[data-theme=['"]?([\w-]+)['"]?\]/g, '[data-theme="$1"]').trim();
+  }
+  static parseHex(value) {
+    const v = value.trim();
+    if (!v.startsWith("#"))
+      return null;
+    const hex = v.slice(1);
+    let full;
+    if (hex.length === 3 || hex.length === 4)
+      full = hex.slice(0, 3).split("").map((c) => c + c).join("");
+    else if (hex.length === 6 || hex.length === 8)
+      full = hex.slice(0, 6);
+    else
+      return null;
+    if (!/^[0-9a-fA-F]{6}$/.test(full))
+      return null;
+    const n = Number.parseInt(full, 16);
+    return [n >> 16 & 255, n >> 8 & 255, n & 255];
+  }
+  static #relativeLuminance([r, g, b]) {
+    const channel = (c) => {
+      const s = c / 255;
+      return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+    };
+    return 0.2126 * channel(r) + 0.7152 * channel(g) + 0.0722 * channel(b);
+  }
+  static contrastRatio(a, b) {
+    const la = ThemeValidator.#relativeLuminance(a);
+    const lb = ThemeValidator.#relativeLuminance(b);
+    const hi = Math.max(la, lb);
+    const lo = Math.min(la, lb);
+    return (hi + 0.05) / (lo + 0.05);
+  }
+}
+
+export { countBlocking, formatStyleContract, ThemeValidator };

package/{index-xftstr5s.js → index-xwgm94zr.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   getDirname
-} from "./index-xwfg9bam.js";
+} from "./index-jtm86byd.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";