@akanjs/cli 3.0.0-alpha.5 → 3.0.0-alpha.51

package/{index-0fj4yg7k.js → index-wr999y03.js}

@@ -9,10 +9,10 @@ import {
   createTsconfigPackageResolver,
   rewriteBarrelImports,
   transformUseClient
-} from "./index-j9cxndc0.js";
+} from "./index-qnv0aqmm.js";
 import {
   __require
-} from "./index-r24hmh0q.js";
+} from "./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/frontendBuild/allRoutesBuilder.ts
 import path4 from "path";
@@ -810,10 +810,10 @@ import { compile } from "tailwindcss";
 
 // pkgs/@akanjs/devkit/frontendBuild/cssCandidateCache.ts
 import { stat } from "fs/promises";
-var CANDIDATE_RE = /-?[\w@][\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
+var CANDIDATE_RE = /-?(?:[\w@]|\[[^\]\s]+\])[\w:/.-]*(?:\[[^\]\s]+\][\w:/.-]*)*/g;
 
 class CssCandidateCache {
-  static #version = 1;
+  static #version = 3;
   #path;
   #entries = new Map;
   #dirty = false;
@@ -973,8 +973,12 @@ class CssImportResolver {
       const pkg = await Bun.file(pkgPath).json();
       const subpath = id === pkgName ? "." : `.${id.slice(pkgName.length)}`;
       const exportValue = pkg.exports?.[subpath];
-      const styleEntry = (typeof exportValue === "string" ? exportValue : exportValue?.style || exportValue?.import || exportValue?.default) || pkg.exports?.["."]?.style || pkg.style || "index.css";
-      return await this.#firstExisting(path7.resolve(pkgDir, styleEntry));
+      const exportedEntry = typeof exportValue === "string" ? exportValue : exportValue?.style || exportValue?.import || exportValue?.default;
+      if (exportedEntry)
+        return await this.#firstExisting(path7.resolve(pkgDir, exportedEntry));
+      if (subpath !== ".")
+        return await this.#firstExisting(path7.resolve(pkgDir, subpath));
+      return await this.#firstExisting(path7.resolve(pkgDir, pkg.exports?.["."]?.style || pkg.style || "index.css"));
     } catch {
       return null;
     }
@@ -1031,6 +1035,8 @@ class CssCompiler {
   #fileExistsCache = new Map;
   #resolvedFileCache = new Map;
   #resolvedSpecifierCache = new Map;
+  #discoveredCssPaths = new Set;
+  importedStylesheetsByBasePath = {};
   #fileExists(absPath) {
     let cached = this.#fileExistsCache.get(absPath);
     if (!cached) {
@@ -1064,13 +1070,20 @@ class CssCompiler {
   async getCss({ refresh } = {}) {
     if (this.#cssText !== null && !refresh)
       return this.#cssText;
+    this.#discoveredCssPaths.clear();
+    this.importedStylesheetsByBasePath = {};
     const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh });
-    this.#cssText = await this.compileCss(cssPaths, sourcePaths);
+    const { css, imported } = await this.#compileWithImports(cssPaths, sourcePaths);
+    this.#cssText = css;
+    this.importedStylesheetsByBasePath = { "": imported };
+    await this.#warnUnreachableStylesheets();
     return this.#cssText;
   }
   async getCssByBasePath({ refresh } = {}) {
     if (this.#cssTextByBasePath !== null && !refresh)
       return this.#cssTextByBasePath;
+    this.#discoveredCssPaths.clear();
+    this.importedStylesheetsByBasePath = {};
     const akanConfig = await this.#app.getConfig({ refresh });
     const pageKeys = await this.#app.getPageKeys({ refresh });
     const basePaths = [...akanConfig.basePaths];
@@ -1081,7 +1094,8 @@ class CssCompiler {
           return ["", ""];
         const started = Date.now();
         const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh, pageKeys: rootPageKeys });
-        const css = await this.compileCss(cssPaths, sourcePaths);
+        const { css, imported } = await this.#compileWithImports(cssPaths, sourcePaths);
+        this.importedStylesheetsByBasePath[""] = imported;
         this.#logger.verbose(`css base=root paths=${cssPaths.length} sources=${sourcePaths.length} in ${Date.now() - started}ms`);
         return ["", css];
       })(),
@@ -1091,14 +1105,27 @@ class CssCompiler {
           return [basePath, ""];
         const started = Date.now();
         const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh, pageKeys: basePathPageKeys });
-        const css = await this.compileCss(cssPaths, sourcePaths);
+        const { css, imported } = await this.#compileWithImports(cssPaths, sourcePaths);
+        this.importedStylesheetsByBasePath[basePath] = imported;
         this.#logger.verbose(`css base=${basePath} paths=${cssPaths.length} sources=${sourcePaths.length} in ${Date.now() - started}ms`);
         return [basePath, css];
       })
     ]);
     this.#cssTextByBasePath = Object.fromEntries(cssEntries);
+    await this.#warnUnreachableStylesheets();
     return this.#cssTextByBasePath;
   }
+  async#warnUnreachableStylesheets() {
+    const pageDir = path8.join(this.#app.cwdPath, "page");
+    const glob = new Bun.Glob("**/*.css");
+    for await (const cssPath of glob.scan({ cwd: pageDir, absolute: true })) {
+      if (cssPath.includes(`${path8.sep}(libs)${path8.sep}`))
+        continue;
+      if (this.#discoveredCssPaths.has(cssPath))
+        continue;
+      this.#logger.warn(`css ${path8.relative(this.#app.cwdPath, cssPath)} is imported by no route and never compiled`);
+    }
+  }
   async discoverCss({ refresh } = {}) {
     const { cssPaths } = await this.discoverCssAndSources({ refresh });
     return cssPaths;
@@ -1158,21 +1185,47 @@ class CssCompiler {
         queue.push(resolved);
       }
     }
-    return { cssPaths: [...cssFiles], sourcePaths: [...sourceFiles] };
+    const tokenPaths = await this.#libTokenStylesheets(sourceFiles);
+    const cssPaths = [...new Set([...tokenPaths, ...cssFiles])];
+    for (const cssPath of cssPaths)
+      this.#discoveredCssPaths.add(cssPath);
+    return { cssPaths, sourcePaths: [...sourceFiles] };
+  }
+  async#libTokenStylesheets(sourceFiles) {
+    const libsRoot = path8.join(this.#app.workspace.workspaceRoot, "libs");
+    const libNames = new Set;
+    for (const filePath of sourceFiles) {
+      const relPath = path8.relative(libsRoot, filePath);
+      if (relPath.startsWith("..") || path8.isAbsolute(relPath))
+        continue;
+      const [libName] = relPath.split(path8.sep);
+      if (libName)
+        libNames.add(libName);
+    }
+    const tokenPaths = await Promise.all([...libNames].sort().map(async (libName) => {
+      const tokensPath = path8.join(libsRoot, libName, "ui/tokens.css");
+      return await this.#fileExists(tokensPath) ? tokensPath : null;
+    }));
+    return tokenPaths.filter((tokensPath) => !!tokensPath);
   }
   async compileCss(cssPaths, sourcePaths) {
+    const { css } = await this.#compileWithImports(cssPaths, sourcePaths);
+    return css;
+  }
+  async#compileWithImports(cssPaths, sourcePaths) {
     if (cssPaths.length === 0)
-      return "";
+      return { css: "", imported: [] };
     const compileStarted = Date.now();
     const compilers = await Promise.all(cssPaths.map(async (cssPath) => {
       const css = await Bun.file(cssPath).text();
       const base = path8.dirname(cssPath);
+      const imported2 = new Map;
       const compiler = await compile(css, {
         base,
-        loadStylesheet: (id, fromBase) => this.#loadStylesheet(id, fromBase),
+        loadStylesheet: (id, fromBase) => this.#loadStylesheet(id, fromBase, imported2),
         loadModule: (id, fromBase) => this.#loadModule(id, fromBase)
       });
-      return { cssPath, compiler };
+      return { cssPath, compiler, imported: imported2 };
     }));
     const sourceDirs = new Set;
     for (const entry of compilers) {
@@ -1185,23 +1238,39 @@ class CssCompiler {
     const candidates = await this.#scanCandidates(sourcePaths, [...sourceDirs]);
     this.#logger.verbose(`css candidates scanned count=${candidates.length} sources=${sourcePaths.length} dirs=${sourceDirs.size} in ${Date.now() - scanStarted}ms`);
     const parts = [];
+    const imported = [];
     for (const entry of compilers) {
       if (!entry)
         continue;
-      parts.push(entry.compiler.build(candidates));
+      const part = entry.compiler.build(candidates);
+      parts.push(part);
+      for (const [cssPath, content] of entry.imported) {
+        const declaredNames = declaredCustomProperties(content);
+        imported.push({ cssPath, declaredNames });
+        if (declaredNames.length === 0 || declaredNames.some((name) => part.includes(`${name}:`)))
+          continue;
+        this.#logger.warn(`css @import ${cssPath} was loaded by ${entry.cssPath} but none of its ${declaredNames.length} declaration(s) reached the compiled CSS`);
+      }
     }
     this.#logger.verbose(`css compiled paths=${cssPaths.length} candidates=${candidates.length} in ${Date.now() - compileStarted}ms`);
-    return parts.join(`
-`);
+    return { css: parts.join(`
+`), imported };
   }
-  async#loadStylesheet(id, fromBase) {
+  async#loadStylesheet(id, fromBase, imported) {
     const p = await this.#resolveCssImport(id, fromBase);
+    this.#discoveredCssPaths.add(p);
     const content = await Bun.file(p).text();
+    imported?.set(p, content);
+    this.#logger.verbose(`css import "${id}" from ${fromBase} -> ${p} (${content.length} bytes)`);
     return { path: p, base: path8.dirname(p), content };
   }
   async#resolveCssImport(id, fromBase) {
-    if (id.startsWith(".") || id.startsWith("/"))
-      return path8.resolve(fromBase, id);
+    if (id.startsWith(".") || id.startsWith("/")) {
+      const filePath = path8.resolve(fromBase, id);
+      if (await this.#fileExists(filePath))
+        return filePath;
+      throw new Error(`[css] failed to resolve stylesheet import "${id}" from ${fromBase} (no file at ${filePath})`);
+    }
     const resolver = await this.#getCssImportResolver();
     const resolved = await resolver.resolve(id, fromBase);
     if (resolved)
@@ -1286,6 +1355,10 @@ function isSourceFile(filePath) {
 function isIgnoredNodeModuleSource(filePath) {
   return NODE_MODULES_RE.test(filePath) && !AKANJS_NODE_MODULE_RE.test(filePath);
 }
+function declaredCustomProperties(css) {
+  const withoutThemeBlocks = css.replace(/@theme[^{]*\{[^}]*\}/g, "");
+  return [...new Set([...withoutThemeBlocks.matchAll(/(?:^|[\s;{])(--[\w-]+)\s*:/g)].map(([, name]) => name))].filter((name) => !!name);
+}
 function getPageKeyBasePath(pageKey, basePaths) {
   const normalized = pageKey.split(path8.sep).join("/").replace(/^\.\//, "");
   const segments = normalized.split("/");
@@ -1763,7 +1836,6 @@ var DEFAULT_EXCLUDE_PREFIX = ["@akanjs/cli/", "@akanjs/devkit/"];
 var OPTIONAL_BACKEND_EXTERNAL_EXACT = new Set([
   "@libsql/client",
   "bullmq",
-  "croner",
   "ioredis",
   "postgres",
   "protobufjs"
@@ -2180,7 +2252,7 @@ class SsrBaseArtifactBuilder {
     const ssrBundle = await new ClientEntriesBundler({
       app: this.#app,
       entries: [rscSegmentOutletEntry],
-      ...RouteClientBuilder.resolveSsrClientExternalOptions(this.#command),
+      ...RouteClientBuilder.resolveSsrClientBundleOptions(this.#command),
       outputSubdir: "client-ssr",
       command: this.#command
     }).bundle();
@@ -2232,13 +2304,13 @@ class SsrBaseArtifactBuilder {
 `);
       if (!cssText)
         return [];
-      return [this.#writeCssAsset(basePath, cssText)];
+      return [this.#writeCssAsset(basePath, cssText, cssCompiler.importedStylesheetsByBasePath[basePath] ?? [])];
     })));
     if (optimizedFonts.files.length > 0)
       this.#app.verbose(`[base-artifact] optimized ${optimizedFonts.files.length} font files`);
     return { cssCompiler, optimizedFonts, cssAssets };
   }
-  async#writeCssAsset(basePath, cssText) {
+  async#writeCssAsset(basePath, cssText, imported) {
     const cssAssetName = basePath || "root";
     const preparedCssText = await prepareCssAsset(this.#command, basePath, cssText);
     const cssHash = Bun.hash(`${basePath}
@@ -2248,9 +2320,17 @@ ${preparedCssText}`).toString(36);
       `/_akan/styles/${cssAssetName}-${cssHash}.css`
     ];
     await Bun.write(path13.join(this.#absArtifactDir, cssRelPath), preparedCssText);
+    SsrBaseArtifactBuilder.#warnDroppedImports(this.#app, cssRelPath, preparedCssText, imported);
     this.#app.verbose(`[base-artifact] wrote ${preparedCssText.length} bytes of CSS for ${basePath} -> ${cssRelPath}`);
     return [basePath, { cssUrl, cssRelPath }];
   }
+  static #warnDroppedImports(app, cssRelPath, css, imported) {
+    for (const { cssPath, declaredNames } of imported) {
+      if (declaredNames.length === 0 || declaredNames.some((name) => css.includes(`${name}:`)))
+        continue;
+      app.logger.warn(`[base-artifact] @import ${cssPath} declares ${declaredNames.length} custom propert${declaredNames.length === 1 ? "y" : "ies"} and none of them are in ${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)";
@@ -2258,210 +2338,8 @@ var PALETTE = "(?:slate|gray|zinc|neutral|stone|red|orange|amber|yellow|lime|gre
 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);
-  }
-}
+var DAISYUI_TOKEN = "(?:base-(?:100|200|300|content)|(?:primary|secondary|accent|neutral|info|success|warning|error)-content|error)";
+var DAISYUI_TOKEN_RE = new RegExp(`${LEAD}(?:${PREFIX})-${DAISYUI_TOKEN}${TAIL}`, "g");
 export { AllRoutesBuilder, CsrArtifactBuilder, CssCompiler, FontOptimizer, PagesBundleBuilder, precompressArtifacts, SsrBaseArtifactBuilder };

package/{index-nfxq39kj.js → index-xe3ychw5.js}

@@ -1,22 +1,25 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-jn9vfpwz.js";
+} from "./index-24h5bqpj.js";
 import {
   Prompter
-} from "./index-qp089jp0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   AGENT_BLOCK_END,
   AGENT_BLOCK_START,
   AppExecutor,
+  CLAUDE_COMMENT_RULE,
   LibExecutor,
+  readDevkitVersion,
   renderRecipeEntries,
+  stampBlockVersion,
   upsertAgentBlock
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 import {
   collectRecipeSources,
   scanRecipes
@@ -103,19 +106,33 @@ ${scopeIndexPointer}
 
 `;
 };
+var renderGuides = async (context) => {
+  const conventions = (await Prompter.getInstruction("conventions")).trim();
+  if (context.pkgs.some((pkg) => pkg.name === "akanjs"))
+    return conventions;
+  const onboarding = (await Prompter.getInstruction("workspaceOnboarding")).trim();
+  const appName = context.apps[0]?.name ?? "app";
+  return `${conventions}
+
+${onboarding.replaceAll("<%= appName %>", appName)}`;
+};
 var renderManagedBlock = async (workspace) => {
   const context = await AkanContextAnalyzer.analyze(workspace);
   const frameworkGuide = await Prompter.getInstruction("framework");
   const appNames = context.apps.map((app) => app.name);
   const sampleCleanup = await renderSampleCleanup(workspace, appNames);
   const recipeIndex = await renderRecipeIndex(workspace);
-  return `## Workspace
+  const guides = await renderGuides(context);
+  const version = await readDevkitVersion();
+  const block = `## Workspace
 
 - Repo: ${context.repoName}
 - Apps: ${context.apps.map((app) => app.name).join(", ") || "none"}
 - Libraries: ${context.libs.map((lib) => lib.name).join(", ") || "none"}
 - Packages: ${context.pkgs.map((pkg) => pkg.name).join(", ") || "none"}
 
+${guides}
+
 ${sampleCleanup}## Akan Module Abstracts
 
 - Before changing a domain, service, or scalar module, read its \`*.abstract.md\` file first.
@@ -148,7 +165,19 @@ ${context.validationCommands.map((command) => `- \`${command}\``).join(`
 
 ## Framework Guide
 
-${frameworkGuide.trim()}`;
+${frameworkGuide.trim()}
+
+## Before You Finish
+
+1. \`bun run akan lint <appName>\` \u2014 Tailwind class order, \`Err\`, \`console\`, \`#private\` scope, unused imports.
+2. \`bun run akan typecheck <appName>\` \u2014 server/client boundary violations.
+3. \`bun run akan sync <appName>\` if you added, renamed, or deleted any file.
+4. Did you write or change a \`.tsx\` file? \`bun run akan quality ssr\` \u2014 did the server share hold, and did you add
+   a \`"use client"\` you cannot justify?
+5. Re-read the file you wrote against its section above.
+6. Did you add a comment? Delete it unless it documents an external constraint or a security decision.
+7. Did behavior or an invariant change? Update the module's \`*.abstract.md\`.`;
+  return version ? stampBlockVersion(block, version) : block;
 };
 var renderAgentsMd = async (workspace, existing) => {
   const block = await renderManagedBlock(workspace);
@@ -171,6 +200,8 @@ var renderClaudeMd = async (workspace) => {
   return `# ${context.repoName} \u2014 Claude Code Guide
 
 @AGENTS.md
+
+${CLAUDE_COMMENT_RULE}
 `;
 };
 var renderCursorRule = () => `---

package/{index-60a3jfcz.js → index-xrdrttjb.js}

@@ -1,13 +1,13 @@
 // @bun
-import {
-  PageScript
-} from "./index-hrwzz2wf.js";
 import {
   pluralizeName
 } from "./index-ss469dec.js";
+import {
+  PageScript
+} from "./index-4z05haak.js";
 import {
   AiSession
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   bilingualDescriptionForField,
   bilingualLabelForField,
@@ -15,17 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-m4kpmmtj.js";
+} from "./index-5em412h5.js";
 import {
   Prompter
-} from "./index-qp089jp0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   ModuleExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-mn96y1nk.js → index-y59x51f1.js}

@@ -1,24 +1,24 @@
 // @bun
 import {
   CloudRunner
-} from "./index-p6txr1ss.js";
+} from "./index-bwt525ne.js";
 import {
   PackageScript
-} from "./index-meh7mmz9.js";
+} from "./index-7zd96bng.js";
 import {
   AiSession,
   CloudApi,
   GlobalConfig
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   ApplicationScript
-} from "./index-nx1vbtsc.js";
+} from "./index-7etegaht.js";
 import {
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   PkgExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";