@akanjs/cli 3.0.0-alpha.11 → 3.0.0-alpha.13

package/.build-stamp

@@ -1 +1 @@
-a34d45f587458f2d61958dd9ee987f37603163c544913a6db6391770a8849f01
+0c2560c17e7c39a0ab1a6f08e27af58e63e9598a265c90e5d65e943b82db95c9

package/{application.command-rdm3et0g.js → application.command-16bzjsam.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-1az48fvn.js";
 import"./index-8pd02prk.js";
 import {
   getMobileTargetChoices

package/{applicationBuildRunner-6m8n71w4.js → applicationBuildRunner-9ps10a0h.js}

@@ -4,7 +4,7 @@ import {
   CsrArtifactBuilder,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-cav1azma.js";
+} from "./index-2m11t9ek.js";
 import"./index-xjd3rqzj.js";
 import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";

package/buildBatch.proc.js

@@ -5,7 +5,7 @@ import {
   FontOptimizer,
   PagesBundleBuilder,
   SsrBaseArtifactBuilder
-} from "./index-cav1azma.js";
+} from "./index-2m11t9ek.js";
 import"./index-xjd3rqzj.js";
 import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";

package/{cloud.command-56aeekqn.js → cloud.command-f6t115qw.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   CloudScript
-} from "./index-a5cs7d8r.js";
-import"./index-nwqqssnb.js";
+} from "./index-xzkynk9f.js";
+import"./index-mt3nkbpt.js";
 import"./index-h5whaj26.js";
 import {
   GlobalConfig
 } from "./index-0cj2zxbm.js";
-import"./index-bzznxgcx.js";
+import"./index-1az48fvn.js";
 import"./index-8pd02prk.js";
 import"./index-76rn3g2c.js";
 import {

package/guidelines/conventions/conventions.instruction.md

@@ -272,7 +272,7 @@ Full version with code, the `Tab` composition example, and a review checklist: `
 - Conditional render is `cond ? <X/> : null`. Never `{cond && <X/>}` — in a `className` context it renders the literal string `"false"`. Early `return null` is for guard clauses only.
 - Never hand-roll loading, empty, or list states. Use `Load.Units` / `Load.View` / `Load.Edit` with `renderItem`, `renderList`, `renderView`, and `renderEmpty`; `<Empty />` for a bare placeholder; and `Model.New` / `Model.Edit` / `Model.SureToRemove` for CRUD modals.
 - Avoid hooks. `useState` is for modal-open, tab, draft-input, and drag state only — never for server data. `useEffect` must be a genuine effect such as subscribe-with-cleanup or one-shot init. Prefer `Tab` over a `useState` mode switch. `.Template.tsx` files contain zero `useState`.
-- Forms are entirely store-driven: `value={xForm.field}` with `onChange={st.do.setFieldOnX}`, the setter passed by reference. Always use `Field.*`, never a bare `<input>` for a model field. Nested rows use `st.do.writeOnX("payments.3.name", v)` plus the generated `add<Field>OnX` / `sub<Field>OnX`.
+- Forms are entirely store-driven: `value={xForm.field}` with `onChange={st.do.setFieldOnX}`, the setter passed by reference. Always use `Field.*`, never a bare `<input>` for a model field. Nested rows use `st.do.writeOnX("payments.3.name", v)` plus the generated `add<Field>OnX` / `sub<Field>OnX`. **Passing the setter by reference is also what makes the framework emit `data-akan-action` / `data-akan-state`** on the control — the annotation an in-page agent, an E2E selector, and an external browser agent all read. Wrapping it in an inline arrow (`onChange={(v) => st.do.setFieldOnX(v)}`) silently drops that: a closure the caller wrote says nothing about what it does. Never hand-write a `data-akan-*` attribute.
 - Read with `st.use.*` and write with `st.do.*`. Client components do not call `fetch.*`.
 - Static class strings stay plain strings. Reach for `cn` only for a conditional or to merge an incoming `className`, and merge the caller last: `cn("base classes", cond && "extra", className)`. `cn` comes from `akanjs/client` (token-aware tailwind-merge) and is the only class-combining function — no `clsx` (removed), no raw `twMerge` imports, no object syntax (`{ x: cond }` → `cond && "x"`).
 - Multi-slot components take extra named props (`wrapperClassName`, `bodyClassName`), never a `classNames` object.

package/{index-bzznxgcx.js → index-1az48fvn.js}

@@ -1898,7 +1898,7 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-6m8n71w4.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-9ps10a0h.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
 var loadCapacitorApp = async () => (await import("./capacitorApp-mr81qdxq.js")).CapacitorApp;
 var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;

package/{index-cav1azma.js → index-2m11t9ek.js}

@@ -1036,6 +1036,7 @@ class CssCompiler {
   #resolvedFileCache = new Map;
   #resolvedSpecifierCache = new Map;
   #discoveredCssPaths = new Set;
+  importedStylesheetsByBasePath = {};
   #fileExists(absPath) {
     let cached = this.#fileExistsCache.get(absPath);
     if (!cached) {
@@ -1070,8 +1071,11 @@ class CssCompiler {
     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;
   }
@@ -1079,6 +1083,7 @@ class CssCompiler {
     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];
@@ -1089,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];
       })(),
@@ -1099,7 +1105,8 @@ 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];
       })
@@ -1202,18 +1209,23 @@ class CssCompiler {
     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) {
@@ -1226,19 +1238,30 @@ 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) {
@@ -1332,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("/");
@@ -2278,13 +2305,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}
@@ -2294,9 +2321,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)";

package/{index-nwqqssnb.js → index-mt3nkbpt.js}

@@ -7,7 +7,7 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   openBrowser
-} from "./index-bzznxgcx.js";
+} from "./index-1az48fvn.js";
 import {
   runner
 } from "./index-etwh7sd3.js";

package/{index-a5cs7d8r.js → index-xzkynk9f.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   CloudRunner
-} from "./index-nwqqssnb.js";
+} from "./index-mt3nkbpt.js";
 import {
   PackageScript
 } from "./index-h5whaj26.js";
@@ -12,7 +12,7 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-1az48fvn.js";
 import {
   script
 } from "./index-etwh7sd3.js";

package/index.js

@@ -18,16 +18,16 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-xhyhajxa.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-bqchx18r.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-a3n15c6t.js")).AgentCommand,
-  application: async () => (await import("./application.command-rdm3et0g.js")).ApplicationCommand,
+  application: async () => (await import("./application.command-16bzjsam.js")).ApplicationCommand,
   library: async () => (await import("./library.command-x6t29a30.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-649g1n7b.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-3jssedmy.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-zgy7f3fz.js")).PackageCommand,
   module: async () => (await import("./module.command-8w8ys5t3.js")).ModuleCommand,
   page: async () => (await import("./page.command-yjmnkyk2.js")).PageCommand,
   context: async () => (await import("./context.command-ysxawe7h.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-56aeekqn.js")).CloudCommand,
+  cloud: async () => (await import("./cloud.command-f6t115qw.js")).CloudCommand,
   guideline: async () => (await import("./guideline.command-yqf9a372.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-9dhmqhtm.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-gfqaagsg.js")).PrimitiveCommand,

package/{localRegistry.command-649g1n7b.js → localRegistry.command-3jssedmy.js}

@@ -2,14 +2,14 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-nwqqssnb.js";
+} from "./index-mt3nkbpt.js";
 import {
   PackageScript
 } from "./index-h5whaj26.js";
 import"./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-1az48fvn.js";
 import"./index-8pd02prk.js";
 import"./index-76rn3g2c.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.11",
+  "version": "3.0.0-alpha.13",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "3.0.0-alpha.11",
+    "akanjs": "3.0.0-alpha.13",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/{workspace.command-xhyhajxa.js → workspace.command-bqchx18r.js}

@@ -11,11 +11,11 @@ import"./index-ss469dec.js";
 import"./index-65aeh789.js";
 import {
   CloudScript
-} from "./index-a5cs7d8r.js";
+} from "./index-xzkynk9f.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-nwqqssnb.js";
+} from "./index-mt3nkbpt.js";
 import {
   PackageScript
 } from "./index-h5whaj26.js";
@@ -31,7 +31,7 @@ import"./index-kcsa1zff.js";
 import"./index-j37qq1f2.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-1az48fvn.js";
 import {
   LibraryScript
 } from "./index-8pd02prk.js";