@akanjs/cli 3.0.0-alpha.1 → 3.0.0-alpha.10

package/{module.command-9c1bnsx4.js → module.command-qyr1s9cn.js}

@@ -1,21 +1,22 @@
 // @bun
 import {
   ModuleScript
-} from "./index-yzmhasdb.js";
-import"./index-bbkek1bp.js";
+} from "./index-jhpa13zj.js";
 import"./index-ss469dec.js";
+import"./index-xmmzf150.js";
 import"./index-0cj2zxbm.js";
 import {
   renderPrimitiveReport
-} from "./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-rxkpk7n4.js";
+import"./index-j37qq1f2.js";
 import {
   Module,
   Sys,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{package.command-t93p4jkj.js → package.command-wsjx0k47.js}

@@ -1,14 +1,15 @@
 // @bun
 import {
   PackageScript
-} from "./index-k95xkh4p.js";
+} from "./index-gcv8ncfh.js";
 import {
   Pkg,
   Workspace,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-46tjzh6s.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-alpha.10",
   "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.1",
+    "akanjs": "3.0.0-alpha.10",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/{page.command-k3k0meh2.js → page.command-rdzg65rm.js}

@@ -1,14 +1,15 @@
 // @bun
 import {
   PageScript
-} from "./index-bbkek1bp.js";
+} from "./index-xmmzf150.js";
 import {
   App,
   Module,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{primitive.command-de6nktdt.js → primitive.command-89g38b53.js}

@@ -1,21 +1,22 @@
 // @bun
 import {
   PrimitiveScript
-} from "./index-bekddz9q.js";
-import"./index-yzmhasdb.js";
-import"./index-bbkek1bp.js";
+} from "./index-3vta1tqa.js";
+import"./index-jhpa13zj.js";
 import"./index-ss469dec.js";
+import"./index-xmmzf150.js";
 import"./index-0cj2zxbm.js";
 import {
   renderPrimitiveReport
-} from "./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-rxkpk7n4.js";
+import"./index-j37qq1f2.js";
 import {
   Workspace,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{quality.command-z5kth2wa.js → quality.command-0cs2z92d.js}

@@ -7,9 +7,13 @@ import {
   command,
   runner,
   script
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import {
+  appRootAllowedFiles,
+  libFacetRootAllowedFiles
+} from "./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 
@@ -17,6 +21,7 @@ import"./index-r24hmh0q.js";
 import { createHash } from "crypto";
 import { readdir, readFile, stat } from "fs/promises";
 import path from "path";
+import { RESERVED_ROUTE_CONFIG_EXPORTS } from "akanjs/common";
 import ignore from "ignore";
 import ts2 from "typescript";
 
@@ -404,27 +409,6 @@ var SUGGESTED_RULES = [
   "Move shared app utilities to apps/*/common instead of creating apps/*/base.",
   "Avoid large mixed-purpose class files; class export files should import helpers from neighboring utility files instead of declaring them inline."
 ];
-var APP_ROOT_FILES = new Set([
-  "akan.app.json",
-  "akan.config.ts",
-  "capacitor.config.ts",
-  "client.ts",
-  "main.ts",
-  "package.json",
-  "server.ts",
-  "tsconfig.json"
-]);
-var LIB_ROOT_FILES = new Set([
-  "cnst.ts",
-  "db.ts",
-  "dict.ts",
-  "option.ts",
-  "sig.ts",
-  "srv.ts",
-  "st.ts",
-  "useClient.ts",
-  "useServer.ts"
-]);
 var CONVENTION_SUFFIXES = [
   ".constant.ts",
   ".dictionary.ts",
@@ -433,20 +417,6 @@ var CONVENTION_SUFFIXES = [
   ".signal.ts",
   ".store.ts"
 ];
-var PAGE_RESERVED_EXPORTS = new Set([
-  "pageConfig",
-  "head",
-  "metadata",
-  "generateHead",
-  "generateMetadata",
-  "fonts",
-  "manifest",
-  "theme",
-  "reconnect",
-  "wsConnect",
-  "layoutStyle",
-  "gaTrackingId"
-]);
 var RULE_FIXES = {
   "akan.global.duplicate-exported-function-name": "Rename one of the exports, or if they are the same thing, extract it into one shared module and import it in both places.",
   "akan.global.duplicate-exported-function-body": "Extract the shared implementation into a single exported helper and import it, instead of copying the body.",
@@ -703,7 +673,7 @@ class AkanQualityScanner {
   #scanLayoutQuality(sourceFile) {
     const segments = sourceFile.file.split("/");
     const warnings = [];
-    if (segments[0] === "apps" && segments.length === 3 && !APP_ROOT_FILES.has(segments[2])) {
+    if (segments[0] === "apps" && segments.length === 3 && !appRootAllowedFiles.has(segments[2])) {
       warnings.push({
         rule: "akan.layout.app-root-file",
         scope: "layout",
@@ -713,7 +683,7 @@ class AkanQualityScanner {
       });
     }
     const libRootFile = getLibRootFile(sourceFile.file);
-    if (libRootFile && !LIB_ROOT_FILES.has(libRootFile)) {
+    if (libRootFile && !libFacetRootAllowedFiles.has(libRootFile)) {
       warnings.push({
         rule: "akan.layout.lib-root-file",
         scope: "layout",
@@ -929,7 +899,7 @@ function isRestrictedInternalKind(kind) {
 function isAllowedComponentExport(declaration, isPage) {
   if (isComponentValueKind(declaration.kind) && isPascalCaseName(declaration.name))
     return true;
-  return isPage && PAGE_RESERVED_EXPORTS.has(declaration.name);
+  return isPage && RESERVED_ROUTE_CONFIG_EXPORTS.has(declaration.name);
 }
 function isPascalCaseName(name) {
   return /^[A-Z]/.test(name) && !/^[A-Z0-9_]+$/.test(name);

package/{repair.command-ehf2g112.js → repair.command-6fphxfwj.js}

@@ -1,17 +1,18 @@
 // @bun
 import {
   RepairRunner
-} from "./index-mr5s7mqd.js";
-import"./index-a00jg8x8.js";
-import"./index-rzwcpcc3.js";
+} from "./index-jf2ya7r2.js";
+import"./index-774gcx29.js";
+import"./index-rxkpk7n4.js";
 import {
   Workspace,
   command,
   script
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{routeSourceValidator-cncd92fv.js → routeSourceValidator-e4jmbfcx.js}

@@ -2,49 +2,13 @@
 import"./index-r24hmh0q.js";
 
 // pkgs/@akanjs/devkit/routeSourceValidator.ts
+import { getRouteExports } from "akanjs/common";
 import ts from "typescript";
 
 class RouteSourceValidator {
-  static #pageExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "Loading"
-  ]);
-  static #rootLayoutExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "fonts",
-    "manifest",
-    "theme",
-    "reconnect",
-    "layoutStyle",
-    "gaTrackingId",
-    "Loading",
-    "NotFound",
-    "Error"
-  ]);
-  static #layoutExports = new Set([
-    "default",
-    "pageConfig",
-    "head",
-    "metadata",
-    "generateHead",
-    "generateMetadata",
-    "Loading",
-    "NotFound",
-    "Error"
-  ]);
   static validateRouteSourceExports(source, filePath, kind, options = {}) {
     const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    const allowed = kind === "page" ? RouteSourceValidator.#pageExports : options.rootLayout ? RouteSourceValidator.#rootLayoutExports : RouteSourceValidator.#layoutExports;
+    const allowed = getRouteExports(kind, { rootLayout: options.rootLayout });
     const exported = new Set;
     const assertExport = (name) => {
       if (!allowed.has(name)) {

package/{scalar.command-7a2jtv33.js → scalar.command-xfer69s6.js}

@@ -1,19 +1,20 @@
 // @bun
 import {
   ScalarScript
-} from "./index-ec09pws3.js";
+} from "./index-y4vkyhvv.js";
 import"./index-ss469dec.js";
 import"./index-0cj2zxbm.js";
 import {
   renderPrimitiveReport
-} from "./index-rzwcpcc3.js";
-import"./index-tdbas9r0.js";
+} from "./index-rxkpk7n4.js";
+import"./index-j37qq1f2.js";
 import {
   Sys,
   command
-} from "./index-8hsbnyes.js";
-import"./index-hgna5rjy.js";
+} from "./index-kdh76j26.js";
+import"./index-z8ptfkzv.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/templates/app/page/styles.css.template

@@ -1,10 +1,10 @@
 @import "tailwindcss";
 @import "akanjs/ui/styles.css";
 
-/* 테마 시스템(브랜드-중립 기본 팔레트 · @theme inline 매핑 · dark 변형 · 런타임 data-theme 전환)은
-   akanjs/ui/styles.css(프레임워크)가 전부 제공한다. 이 앱은 import 만으로 즉시 동작한다.
+/* The theme system (brand-neutral default palette, @theme inline mapping, dark variant, and runtime
+   data-theme switching) is fully provided by akanjs/ui/styles.css. This app works from the import alone.
 
-   이 앱만의 브랜드 색을 쓰려면 아래처럼 토큰만 override 하면 된다:
+   To use this app's own brand colors, override the tokens like this:
 
    :root,
    [data-theme="dark"] {

package/templates/crudPages/[__model__Id]/edit/page.tsx

@@ -30,7 +30,7 @@ export default async function Page({ params }: PageProps) {
       </div>
       <Load.Edit
         className="flex flex-col items-center"
-        slice={fetch.slice["${dict.model}InPublic"]}
+        slice={fetch.slice.${dict.model}InPublic}
         edit={${dict.model}Edit}
         type="form"
         onCancel="back"

package/templates/crudPages/new/page.tsx

@@ -25,7 +25,7 @@ export default function Page() {
       </div>
       <Load.Edit
         className="flex flex-col items-center"
-        slice={fetch.slice["${dict.model}InPublic"]}
+        slice={fetch.slice.${dict.model}InPublic}
         edit={${dict.model}Form}
         type="form"
         onCancel="back"

package/templates/crudSinglePage/page.tsx

@@ -20,7 +20,7 @@ export default async function Page() {
     <>
       <div className="animate-fadeIn flex items-center gap-4 px-4 pt-4">
         <div className="text-lg font-bold md:text-4xl">{l("${dict.model}.modelName")}</div>
-        <Model.New className="inline-flex items-center gap-2 rounded-field px-3 py-1.5 text-sm transition-colors hover:bg-muted" slice={fetch.slice["${dict.model}InPublic"]} renderTitle="id">
+        <Model.New className="inline-flex items-center gap-2 rounded-field px-3 py-1.5 text-sm transition-colors hover:bg-muted" slice={fetch.slice.${dict.model}InPublic} renderTitle="id">
           <${dict.Model}.Template.General />
         </Model.New>
       </div>

package/templates/lib/db.ts

@@ -16,7 +16,9 @@ ${databaseModules.map((module) => `import * as ${module}Db from "./${module}/${m
 ${libs.map((lib) => `export { db as ${lib} } from "@libs/${lib}/server";`).join("\n")}
 
 ${databaseModules.map((module) => `class ${capitalize(module)}Input extends by(cnst.${capitalize(module)}Input) {}`).join("\n")}
+${databaseModules.map((module) => `class ${capitalize(module)}Insight extends by(cnst.${capitalize(module)}Insight) {}`).join("\n")}
 ${databaseModules.length ? `export type { ${databaseModules.map((module) => `${capitalize(module)}Input`).join(", ")} };` : ""}
+${databaseModules.length ? `export type { ${databaseModules.map((module) => `${capitalize(module)}Insight`).join(", ")} };` : ""}
 
 ${scalarModules.map((module) => `export type * from "./__scalar/${module}/${module}.document";`).join("\n")}
 ${databaseModules.map((module) => `export type * from "./${module}/${module}.document";`).join("\n")}
@@ -24,7 +26,7 @@ ${databaseModules.map((module) => `export type * from "./${module}/${module}.doc
 ${databaseModules
   .map((module) => {
     const names = { Module: module.charAt(0).toUpperCase() + module.slice(1) };
-    return `export const ${module} = DatabaseRegistry.buildModel("${module}" as const, ${names.Module}Input, ${module}Db.${names.Module}, ${module}Db.${names.Module}Model, cnst.${names.Module}, cnst.${names.Module}Insight, ${module}Db.${names.Module}Filter);`;
+    return `export const ${module} = DatabaseRegistry.buildModel("${module}" as const, ${names.Module}Input, ${module}Db.${names.Module}, ${module}Db.${names.Module}Model, cnst.${names.Module}, ${names.Module}Insight, ${module}Db.${names.Module}Filter);`;
   })
   .join("\n")}
 ${scalarModules.map((module) => `export const ${module} = DatabaseRegistry.buildScalar("${module}" as const, ${capitalize(module)});`).join("\n")}

package/templates/lib/useClient.ts

@@ -1,16 +1,22 @@
 import type { AppInfo, LibInfo } from "akanjs";
 
 export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { [key: string]: string } = {}) {
+  const isApp = (scanInfo?.type ?? "lib") === "app";
   return `
 import { makePageProto, registerClientRuntime } from "akanjs/client";
 import { FetchClient } from "akanjs/fetch";
 import * as cnst from "./cnst";
-import { getAllDictionary } from "./dict" with { type: "macro" };
-import type * as dict from "./dict";
+${isApp ? `import { getAllDictionary } from "./dict" with { type: "macro" };\n` : ""}import type * as dict from "./dict";
 import { getSerializedSignal } from "./sig" with { type: "macro" };
 import type * as signal from "./sig";
 
-const dictionary = process.env.AKAN_PUBLIC_RENDER_ENV === "csr" ? getAllDictionary() : {};
+${
+  isApp
+    ? `const dictionary = process.env.AKAN_PUBLIC_RENDER_ENV === "csr" ? getAllDictionary() : {};`
+    : `// dict.ts is cumulative, so a lib dictionary is a subset of the mounting app's. Translator state is global,
+// so the app's seed already resolves l() here — seeding again would ship the same payload a second time.
+const dictionary = {};`
+}
 const pageProto = makePageProto<typeof dict>(dictionary);
 const fetchProto = FetchClient.build<typeof signal>(cnst, getSerializedSignal(), { Err: pageProto.Err });
 export const runtime = registerClientRuntime({ ...pageProto, ...fetchProto }, { scope: ${JSON.stringify(scanInfo?.type ?? "lib")} });

package/templates/module/__Model__.Util.tsx

@@ -21,7 +21,7 @@ interface RemoveProps {
 export const Remove = ({ ${dict.model}Id }: RemoveProps) => {
   const { l } = usePage();
   return (
-    <Model.Remove modelId={${dict.model}Id} slice={fetch.slice["${dict.model}"]}>
+    <Model.Remove modelId={${dict.model}Id} slice={fetch.slice.${dict.model}}>
       <BiTrash /> {l("base.remove")}
     </Model.Remove>
   );

package/templates/module/__Model__.Zone.tsx

@@ -12,9 +12,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dic
     content: `
 "use client";
 import { Load } from "akanjs/ui";
-// Alias the domain namespace so the Card/View exports below never collide with the model name
-// (a model literally named "card" or "view" would otherwise shadow this import).
-import { type cnst, ${dict.Model} as ${dict.Model}Domain } from "@${dict.sysType}s/${dict.sysName}/client";
+import { type cnst, ${dict.Model} as ${dict.Model} } from "@${dict.sysType}s/${dict.sysName}/client";
 import type { ClientInit, ClientView, SliceMeta } from "akanjs/fetch";
 
 interface CardProps {
@@ -28,7 +26,7 @@ export const Card = ({ className, init, slice }: CardProps) => {
       className={className}
       init={init}
       renderItem={(${dict.model}) => (
-        <${dict.Model}Domain.Unit.Card key={${dict.model}.id} href={\`/${dict.model}/\${${dict.model}.id}\`} ${dict.model}={${dict.model}} />
+        <${dict.Model}.Unit.Card key={${dict.model}.id} href={\`/${dict.model}/\${${dict.model}.id}\`} ${dict.model}={${dict.model}} />
       )}
     />
   );
@@ -39,7 +37,7 @@ interface ViewProps {
   view: ClientView<"${dict.model}", cnst.${dict.Model}>;
 }
 export const View = ({ view }: ViewProps) => {
-  return <Load.View view={view} renderView={(${dict.model}) => <${dict.Model}Domain.View.General ${dict.model}={${dict.model}} />} />;
+  return <Load.View view={view} renderView={(${dict.model}) => <${dict.Model}.View.General ${dict.model}={${dict.model}} />} />;
 };
 `,
   };