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

package/.build-stamp

@@ -1 +1 @@
-a34d45f587458f2d61958dd9ee987f37603163c544913a6db6391770a8849f01
+84acd2086ed367dc670ca155f5d5f884d8af105b3527914ac5ba312e3e1985e6

package/{application.command-rdm3et0g.js → application.command-rp3y4ejb.js}

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

package/{applicationBuildRunner-6m8n71w4.js → applicationBuildRunner-73kbbb7e.js}

@@ -4,7 +4,7 @@ import {
   CsrArtifactBuilder,
   SsrBaseArtifactBuilder,
   precompressArtifacts
-} from "./index-cav1azma.js";
+} from "./index-wzdeact3.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-wzdeact3.js";
 import"./index-xjd3rqzj.js";
 import"./index-j9cxndc0.js";
 import"./index-bjpxzr6s.js";

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

@@ -1,13 +1,13 @@
 // @bun
 import {
   CloudScript
-} from "./index-a5cs7d8r.js";
-import"./index-nwqqssnb.js";
+} from "./index-k8gpsrm1.js";
+import"./index-rdv33eye.js";
 import"./index-h5whaj26.js";
 import {
   GlobalConfig
 } from "./index-0cj2zxbm.js";
-import"./index-bzznxgcx.js";
+import"./index-5yjc80ha.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-5yjc80ha.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-73kbbb7e.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-a5cs7d8r.js → index-k8gpsrm1.js}

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

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

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

package/{index-cav1azma.js → index-wzdeact3.js}

@@ -1036,6 +1036,7 @@ class CssCompiler {
   #resolvedFileCache = new Map;
   #resolvedSpecifierCache = new Map;
   #discoveredCssPaths = new Set;
+  #importedStylesheets = new Map;
   #fileExists(absPath) {
     let cached = this.#fileExistsCache.get(absPath);
     if (!cached) {
@@ -1204,11 +1205,12 @@ class CssCompiler {
   async compileCss(cssPaths, sourcePaths) {
     if (cssPaths.length === 0)
       return "";
+    this.#importedStylesheets.clear();
     const compileStarted = Date.now();
     const compilers = await Promise.all(cssPaths.map(async (cssPath) => {
-      const css = await Bun.file(cssPath).text();
+      const css2 = await Bun.file(cssPath).text();
       const base = path8.dirname(cssPath);
-      const compiler = await compile(css, {
+      const compiler = await compile(css2, {
         base,
         loadStylesheet: (id, fromBase) => this.#loadStylesheet(id, fromBase),
         loadModule: (id, fromBase) => this.#loadModule(id, fromBase)
@@ -1232,13 +1234,25 @@ class CssCompiler {
       parts.push(entry.compiler.build(candidates));
     }
     this.#logger.verbose(`css compiled paths=${cssPaths.length} candidates=${candidates.length} in ${Date.now() - compileStarted}ms`);
-    return parts.join(`
+    const css = parts.join(`
 `);
+    this.#warnDroppedImports(css);
+    return css;
+  }
+  #warnDroppedImports(css) {
+    for (const [cssPath, content] of this.#importedStylesheets) {
+      const names = declaredCustomProperties(content);
+      if (names.length === 0 || names.some((name) => css.includes(`${name}:`)))
+        continue;
+      this.#logger.warn(`css @import ${cssPath} was loaded but none of its ${names.length} declaration(s) reached the compiled CSS`);
+    }
   }
   async#loadStylesheet(id, fromBase) {
     const p = await this.#resolveCssImport(id, fromBase);
     this.#discoveredCssPaths.add(p);
     const content = await Bun.file(p).text();
+    this.#importedStylesheets.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 +1346,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("/");

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-x49ekpkt.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-rp3y4ejb.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-f75tqg9w.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-7mcmm52j.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-f75tqg9w.js}

@@ -2,14 +2,14 @@
 import {
   CloudRunner,
   getNpmRegistryUrl
-} from "./index-nwqqssnb.js";
+} from "./index-rdv33eye.js";
 import {
   PackageScript
 } from "./index-h5whaj26.js";
 import"./index-0cj2zxbm.js";
 import {
   ApplicationScript
-} from "./index-bzznxgcx.js";
+} from "./index-5yjc80ha.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.12",
   "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.12",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

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

@@ -11,11 +11,11 @@ import"./index-ss469dec.js";
 import"./index-65aeh789.js";
 import {
   CloudScript
-} from "./index-a5cs7d8r.js";
+} from "./index-k8gpsrm1.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-nwqqssnb.js";
+} from "./index-rdv33eye.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-5yjc80ha.js";
 import {
   LibraryScript
 } from "./index-8pd02prk.js";