@akanjs/cli 3.1.1-rc.9 → 3.1.2-rc.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (207) hide show
  1. package/.build-stamp +1 -1
  2. package/CodeAgent-dyc45f5w.js +11 -0
  3. package/{CodeAgentRpcHost-9g27hmer.js → CodeAgentRpcHost-6dzfkvsc.js} +1 -1
  4. package/CodeAgentRpcListener-tcwrdvst.js +182 -0
  5. package/{CodeTui-z5vkm9ea.js → CodeTui-q55b2zrn.js} +25 -8
  6. package/TunnelShare-hdq9h1hr.js +14 -0
  7. package/agent.command-20zaqe60.js +49 -0
  8. package/akanCode.js +13 -8
  9. package/{application.command-wthg8nn9.js → application.command-nd0fshsk.js} +45 -12
  10. package/{applicationBuildRunner-t2r84sz6.js → applicationBuildRunner-s13x3zqb.js} +14 -10
  11. package/buildBatch.proc.js +7 -7
  12. package/{cloud.command-sz11hpre.js → cloud.command-8kbddsz9.js} +28 -19
  13. package/cloud.script-hgvvajm3.js +27 -0
  14. package/code.command-625bg8s8.js +345 -0
  15. package/commandManifest.json +1 -1
  16. package/{context.command-15j9b7c0.js → context.command-p6haqjay.js} +20 -18
  17. package/context.runner-rsnqnk9j.js +27 -0
  18. package/{dependencyScanner-3afj2vt1.js → dependencyScanner-78sq8m4q.js} +2 -2
  19. package/{devTui-q7k7bakd.js → devTui-evr3b35y.js} +1 -1
  20. package/{fileSys-wzzrntkw.js → fileSys-zpvt5gtf.js} +1 -1
  21. package/{guideline.command-snh85ctf.js → guideline.command-195g0h9a.js} +4 -4
  22. package/guidelines/agentRule/agentRule.instruction.md +22 -8
  23. package/guidelines/conventions/core.md +106 -0
  24. package/guidelines/conventions/rules/app.md +83 -0
  25. package/guidelines/conventions/rules/auth.md +46 -0
  26. package/guidelines/conventions/rules/config.md +60 -0
  27. package/guidelines/conventions/rules/constant.md +24 -0
  28. package/guidelines/conventions/rules/gates.md +32 -0
  29. package/guidelines/conventions/rules/layer.md +25 -0
  30. package/guidelines/conventions/rules/migration.md +27 -0
  31. package/guidelines/conventions/rules/module.md +90 -0
  32. package/guidelines/conventions/rules/page.md +56 -0
  33. package/guidelines/conventions/rules/sensitive.md +16 -0
  34. package/guidelines/conventions/rules/server.md +91 -0
  35. package/guidelines/conventions/rules/ssr.md +47 -0
  36. package/guidelines/conventions/rules/style.md +43 -0
  37. package/guidelines/conventions/rules/test.md +34 -0
  38. package/guidelines/conventions/rules/ts.md +95 -0
  39. package/guidelines/conventions/rules/tsx.md +76 -0
  40. package/guidelines/mcpRule/mcpRule.instruction.md +1 -1
  41. package/guidelines/pageRule/pageRule.instruction.md +8 -7
  42. package/guidelines/queryRule/queryRule.instruction.md +4 -0
  43. package/guidelines/runtimeRule/runtimeRule.instruction.md +35 -25
  44. package/guidelines/ssrRule/ssrRule.instruction.md +11 -10
  45. package/guidelines/transportRule/transportRule.instruction.md +5 -4
  46. package/guidelines/workspaceRecipes/workspaceRecipes.instruction.md +4 -4
  47. package/incrementalBuilder.proc.js +7 -7
  48. package/{index-301pdbzz.js → index-00a7j05x.js} +7 -7
  49. package/{index-js6geqjn.js → index-0j1t1h2b.js} +3 -1
  50. package/{index-6txx6a9p.js → index-1h2jc0x3.js} +154 -88
  51. package/{index-55j120r8.js → index-1qsd8ft1.js} +65 -145
  52. package/{index-9th4gszy.js → index-2mwjshz5.js} +233 -1271
  53. package/index-2nxk8wgs.js +266 -0
  54. package/{index-j9vyj3dj.js → index-2phm56a1.js} +49 -8
  55. package/index-35j83zkd.js +61 -0
  56. package/index-4am4dvmf.js +29 -0
  57. package/index-75y7bcz4.js +28 -0
  58. package/index-7apsdr5g.js +487 -0
  59. package/{index-42j4a8zq.js → index-84h43kg6.js} +8 -6
  60. package/index-9bv479q5.js +1 -0
  61. package/{index-3wypz6xj.js → index-9zy8479y.js} +11 -5
  62. package/{index-a5dhqkdr.js → index-a1vb3x7t.js} +273 -259
  63. package/{index-52w0fvh8.js → index-bns3wcpc.js} +15 -0
  64. package/index-cjmjvg4r.js +3622 -0
  65. package/{index-pcwzkdqb.js → index-defp4gmb.js} +1 -1
  66. package/index-ewbmfarf.js +1606 -0
  67. package/index-fbewhg4g.js +590 -0
  68. package/index-fhw7yq2d.js +653 -0
  69. package/{index-wcej7g4z.js → index-g500c5j9.js} +271 -105
  70. package/{index-74tjjsnc.js → index-g841cap9.js} +33 -37
  71. package/{index-2azahjaw.js → index-gr9thy79.js} +5 -5
  72. package/{index-4pf8g7ff.js → index-h7hehkw6.js} +3 -0
  73. package/{index-xjf5j657.js → index-hm0tn7qv.js} +1001 -91
  74. package/index-j6eeh5d7.js +138 -0
  75. package/{index-31es1yev.js → index-j7hwy56s.js} +108 -7
  76. package/{index-skk9zc1x.js → index-jc2zbwra.js} +2 -2
  77. package/{index-905qdgqp.js → index-khk05tsf.js} +1 -1
  78. package/{index-5nd1wtkv.js → index-p6x5b7hr.js} +1 -1
  79. package/{index-tvehn2sp.js → index-qd7xn2bk.js} +1 -1
  80. package/{index-a58emady.js → index-qw6814m4.js} +55 -17
  81. package/index-raz588b3.js +445 -0
  82. package/{index-at7bz0xq.js → index-s4nvxpzm.js} +2 -0
  83. package/{index-bt438yxm.js → index-sp0qsr7a.js} +116 -13
  84. package/{index-xb8809yb.js → index-sveq36gh.js} +40 -43
  85. package/{index-hmt54t45.js → index-t1t9wq9a.js} +4 -4
  86. package/index-t78230d7.js +191 -0
  87. package/index-tenw3mah.js +225 -0
  88. package/{index-qfp55x1y.js → index-tgqameyb.js} +4 -4
  89. package/{index-espk51ah.js → index-tp56652m.js} +6 -6
  90. package/index-w15mg3km.js +389 -0
  91. package/{index-dy0jx9ay.js → index-wwe9rsrx.js} +14 -0
  92. package/{index-2xcc2ax5.js → index-y4kcmbt2.js} +2 -2
  93. package/index-yf9wc28h.js +52 -0
  94. package/{index-0fz95kxe.js → index-zbrwnmf1.js} +9 -7
  95. package/{index-40brg4px.js → index-zttm13c3.js} +5 -5
  96. package/index.js +24 -23
  97. package/{library.command-gycrwhf1.js → library.command-63hgt9te.js} +4 -4
  98. package/{localRegistry.command-jtd8gaes.js → localRegistry.command-g3f8k25t.js} +46 -22
  99. package/{module.command-v6hgs1bc.js → module.command-r4sa2khp.js} +7 -6
  100. package/{package.command-shzpcfph.js → package.command-96eheyvd.js} +5 -5
  101. package/package.json +2 -2
  102. package/{page.command-ptxn5kqk.js → page.command-gs6d841d.js} +4 -4
  103. package/{pipeline.command-zz31pgax.js → pipeline.command-wdfvdbfj.js} +3 -3
  104. package/{primitive.command-a1vse91z.js → primitive.command-dfsv4mpe.js} +8 -7
  105. package/{projectTypecheck-2ztky9cf.js → projectTypecheck-kqj1t6hb.js} +1 -1
  106. package/{prompter-76k56b37.js → prompter-qrwx1p17.js} +2 -2
  107. package/quality.command-webzxee2.js +78 -0
  108. package/{repair.command-cvazbz99.js → repair.command-3r3j1xre.js} +7 -6
  109. package/{routeSourceValidator-6jd0q6r6.js → routeSourceValidator-4h947v7c.js} +13 -3
  110. package/{scalar.command-0acvyp26.js → scalar.command-e8y47j6d.js} +6 -5
  111. package/skills/akan-agent/SKILL.md +43 -0
  112. package/skills/akan-code/SKILL.md +38 -11
  113. package/skills/akan-debug/SKILL.md +41 -6
  114. package/skills/akan-deps/SKILL.md +1 -2
  115. package/skills/akan-err/SKILL.md +2 -1
  116. package/skills/akan-mcp/SKILL.md +40 -0
  117. package/skills/akan-page/SKILL.md +44 -0
  118. package/skills/akan-query/SKILL.md +39 -0
  119. package/skills/akan-runtime/SKILL.md +43 -0
  120. package/skills/akan-scaffold/SKILL.md +16 -6
  121. package/skills/akan-transport/SKILL.md +40 -0
  122. package/skills/akan-validate/SKILL.md +13 -11
  123. package/{subspace.command-822qx2bx.js → subspace.command-a1sf9n5a.js} +12 -10
  124. package/templates/__scalar/__model__/__model__.constant.ts +3 -5
  125. package/templates/__scalar/__model__/__model__.dictionary.ts +6 -5
  126. package/templates/__scalar/__model__/__model__.document.ts +3 -3
  127. package/templates/app/akan.config.ts +2 -3
  128. package/templates/app/env/env.client.ts +2 -4
  129. package/templates/app/env/env.client.type.ts +2 -3
  130. package/templates/app/env/env.server.ts +2 -3
  131. package/templates/app/lib/___appName__/__appName__.dictionary.ts +1 -2
  132. package/templates/app/lib/___appName__/__appName__.service.ts +3 -3
  133. package/templates/app/lib/___appName__/__appName__.signal.ts +5 -5
  134. package/templates/app/lib/___appName__/__appName__.store.ts +4 -6
  135. package/templates/app/lib/option.ts +2 -3
  136. package/templates/app/main.ts +2 -4
  137. package/templates/app/page/_index.tsx +3 -3
  138. package/templates/app/page/_layout.tsx +13 -10
  139. package/templates/appSample/lib/__scalar/workHistory/workHistory.constant.ts +1 -5
  140. package/templates/appSample/lib/__scalar/workHistory/workHistory.dictionary.ts +1 -1
  141. package/templates/appSample/lib/_noti/noti.signal.ts +1 -1
  142. package/templates/appSample/lib/task/Task.Template.tsx +2 -1
  143. package/templates/appSample/lib/task/Task.Unit.tsx +3 -2
  144. package/templates/appSample/lib/task/Task.Util.tsx +16 -4
  145. package/templates/appSample/lib/task/task.constant.ts +1 -5
  146. package/templates/appSample/lib/task/task.dictionary.ts +2 -8
  147. package/templates/appSample/lib/task/task.document.ts +1 -1
  148. package/templates/appSample/lib/task/task.signal.ts +14 -9
  149. package/templates/appSample/page/task/_index.tsx +2 -1
  150. package/templates/appSample/page/task/new.tsx +2 -1
  151. package/templates/appSample/srvkit/guards.ts +11 -0
  152. package/templates/appSample/ui/QuantityControl.tsx +5 -9
  153. package/templates/biomeForm.ts +144 -0
  154. package/templates/crudPages/[__model__Id]/edit/page.tsx +3 -3
  155. package/templates/crudPages/[__model__Id]/page.tsx +5 -5
  156. package/templates/crudPages/new/page.tsx +4 -3
  157. package/templates/crudPages/page.tsx +3 -3
  158. package/templates/crudSinglePage/page.tsx +9 -5
  159. package/templates/libRoot/akan.config.ts +2 -3
  160. package/templates/libRoot/lib/___libName__/__libName__.dictionary.ts +1 -2
  161. package/templates/libRoot/lib/___libName__/__libName__.service.ts +5 -4
  162. package/templates/libRoot/lib/___libName__/__libName__.signal.ts +6 -5
  163. package/templates/libRoot/lib/___libName__/__libName__.store.ts +5 -6
  164. package/templates/libRoot/lib/option.ts +1 -2
  165. package/templates/module/__Model__.Template.tsx +11 -10
  166. package/templates/module/__Model__.Unit.tsx +18 -5
  167. package/templates/module/__Model__.Util.tsx +9 -7
  168. package/templates/module/__Model__.View.tsx +9 -6
  169. package/templates/module/__Model__.Zone.tsx +25 -17
  170. package/templates/module/__model__.constant.ts +8 -9
  171. package/templates/module/__model__.dictionary.ts +16 -17
  172. package/templates/module/__model__.document.ts +6 -8
  173. package/templates/module/__model__.service.ts +3 -3
  174. package/templates/module/__model__.signal.ts +11 -10
  175. package/templates/module/__model__.store.ts +3 -5
  176. package/templates/service/__model__.dictionary.ts +5 -6
  177. package/templates/service/__model__.service.ts +3 -3
  178. package/templates/service/__model__.signal.ts +5 -4
  179. package/templates/service/__model__.store.ts +3 -5
  180. package/templates/workspaceRoot/.gitignore.template +4 -0
  181. package/templates/workspaceRoot/.vscode/settings.json.template +21 -21
  182. package/templates/workspaceRoot/AGENTS.md.template +4 -10
  183. package/{tunnel.command-ycmja19q.js → tunnel.command-dcb0wg93.js} +25 -13
  184. package/{typeChecker-px49mezc.js → typeChecker-j2jdnqsr.js} +1 -1
  185. package/typecheck.proc.js +6 -1
  186. package/verify.command-yyepccbh.js +93 -0
  187. package/{workflow.command-abb1d5xy.js → workflow.command-z5pg9ay0.js} +49 -14
  188. package/workspace.command-d7x5jttw.js +290 -0
  189. package/CodeAgent-8d5qs787.js +0 -9
  190. package/CodeAgentRpcListener-7p7z5dd7.js +0 -97
  191. package/TunnelShare-qkm8zp03.js +0 -14
  192. package/agent.command-ydftceda.js +0 -25
  193. package/cloud.script-nqevg5qw.js +0 -24
  194. package/code.command-9h3yrzhe.js +0 -167
  195. package/context.runner-8gg030b0.js +0 -25
  196. package/guidelines/conventions/conventions.instruction.md +0 -617
  197. package/guidelines/workspaceOnboarding/workspaceOnboarding.instruction.md +0 -291
  198. package/index-2mwc0g0d.js +0 -49
  199. package/index-4vgbysa0.js +0 -279
  200. package/index-7md2g9vw.js +0 -6
  201. package/index-b70zct19.js +0 -856
  202. package/index-c6eggbee.js +0 -123
  203. package/index-zzvvc845.js +0 -74
  204. package/quality.command-ah8qcakd.js +0 -1478
  205. package/templates/workspaceRoot/docs/AI-DEVELOPMENT.md.template +0 -69
  206. package/templates/workspaceRoot/docs/GENERATED.md.template +0 -55
  207. package/workspace.command-qm7cw29v.js +0 -521
@@ -5,12 +5,19 @@ interface Dict {
5
5
  }
6
6
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict, options: { libs: string[] }) {
7
7
  const isUsingShared = options.libs.includes("shared");
8
+ const rendered = isUsingShared
9
+ ? `(
10
+ <>
11
+ {children}
12
+ <Auth.User />
13
+ <Auth.Admin />
14
+ </>
15
+ )`
16
+ : "<>{children}</>";
8
17
  return {
9
18
  filename: "_layout.tsx",
10
- content: `
11
- import "./styles.css";
12
- import { rootLayout } from "akanjs/client";
13
- ${isUsingShared ? "import { Auth } from '@shared/ui';" : ""}
19
+ content: `import "./styles.css";
20
+ ${isUsingShared ? 'import { Auth } from "@libs/shared/ui";\n' : ""}import { rootLayout } from "akanjs/client";
14
21
 
15
22
  export default rootLayout()
16
23
  .fonts([
@@ -41,12 +48,8 @@ export default rootLayout()
41
48
  </>,
42
49
  )
43
50
  .render(({ children }) => {
44
- return (
45
- <>
46
- {children}${isUsingShared ? "\n <Auth.User />\n <Auth.Admin />" : ""}
47
- </>
48
- );
51
+ return ${rendered};
49
52
  });
50
- `,
53
+ `,
51
54
  };
52
55
  }
@@ -12,11 +12,7 @@ import { via } from "akanjs/constant";
12
12
  // ---- Enum ----
13
13
  // WorkHistoryAction: the type of change recorded in a work history entry
14
14
  // Scalar enums follow the same enumOf() convention as model enums
15
- export class WorkHistoryAction extends enumOf("workHistoryAction", [
16
- "created",
17
- "started",
18
- "completed",
19
- ] as const) {}
15
+ export class WorkHistoryAction extends enumOf("workHistoryAction", ["created", "started", "completed"] as const) {}
20
16
 
21
17
  // ---- Scalar Entry ----
22
18
  // WorkHistory: a single entry in a model's workHistory list
@@ -3,7 +3,7 @@ import type { AppInfo, LibInfo } from "akanjs";
3
3
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
4
4
  return `import { scalarDictionary } from "akanjs/dictionary";
5
5
 
6
- import type { WorkHistoryAction, WorkHistory } from "./workHistory.constant";
6
+ import type { WorkHistory, WorkHistoryAction } from "./workHistory.constant";
7
7
 
8
8
  // ===== workHistory.dictionary.ts =====
9
9
  // Convention: scalarDictionary() for scalar module i18n — fewer layers than modelDictionary().
@@ -1,7 +1,7 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
2
 
3
3
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
4
- return `import { internal, endpoint } from "akanjs/signal";
4
+ return `import { endpoint, internal } from "akanjs/signal";
5
5
 
6
6
  import * as srv from "../srv";
7
7
 
@@ -40,6 +40,7 @@ export const General = ({ className }: TaskEditProps) => {
40
40
  />
41
41
  </Layout.Template>
42
42
  );
43
- };`,
43
+ };
44
+ `,
44
45
  };
45
46
  }
@@ -4,7 +4,7 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
4
4
  return {
5
5
  filename: "Task.Unit.tsx",
6
6
  content: `import { type cnst, usePage } from "@apps/${dict.appName}/client";
7
- import { type ModelProps, cn } from "akanjs/client";
7
+ import { cn, type ModelProps } from "akanjs/client";
8
8
  import { badgeRecipe, Layout } from "akanjs/ui";
9
9
 
10
10
  // ===== Task.Unit.tsx =====
@@ -60,6 +60,7 @@ export const Card = ({ task, className, href }: CardProps) => {
60
60
  // Abstract: abstracted summary display (search results, previews)
61
61
  // export const Abstract = ({ task }: AbstractProps) => (
62
62
  // <div className="text-sm">{task.title} — {l("taskStatus", task.status)}</div>
63
- // );`,
63
+ // );
64
+ `,
64
65
  };
65
66
  }
@@ -20,7 +20,11 @@ interface StartProps {
20
20
  }
21
21
 
22
22
  export const Start = ({ taskId }: StartProps) => (
23
- <button type="button" className={jellyButtonRecipe({ variant: "primary", size: "xs" })} onClick={() => st.do.startTask(taskId)}>
23
+ <button
24
+ type="button"
25
+ className={jellyButtonRecipe({ variant: "primary", size: "xs" })}
26
+ onClick={() => st.do.startTask(taskId)}
27
+ >
24
28
  {usePage().l("task.taskStart")}
25
29
  </button>
26
30
  );
@@ -30,7 +34,11 @@ interface CompleteProps {
30
34
  }
31
35
 
32
36
  export const Complete = ({ taskId }: CompleteProps) => (
33
- <button type="button" className={jellyButtonRecipe({ variant: "success", size: "xs" })} onClick={() => st.do.completeTask(taskId)}>
37
+ <button
38
+ type="button"
39
+ className={jellyButtonRecipe({ variant: "success", size: "xs" })}
40
+ onClick={() => st.do.completeTask(taskId)}
41
+ >
34
42
  {usePage().l("task.taskComplete")}
35
43
  </button>
36
44
  );
@@ -63,12 +71,16 @@ export const Toolbox = ({ taskId, status }: ToolboxProps) => {
63
71
  <>
64
72
  {status === "todo" && (
65
73
  <li>
66
- <button type="button" onClick={() => st.do.startTask(taskId)}>{l("task.taskStart")}</button>
74
+ <button type="button" onClick={() => st.do.startTask(taskId)}>
75
+ {l("task.taskStart")}
76
+ </button>
67
77
  </li>
68
78
  )}
69
79
  {status === "inProgress" && (
70
80
  <li>
71
- <button type="button" onClick={() => st.do.completeTask(taskId)}>{l("task.taskComplete")}</button>
81
+ <button type="button" onClick={() => st.do.completeTask(taskId)}>
82
+ {l("task.taskComplete")}
83
+ </button>
72
84
  </li>
73
85
  )}
74
86
  <li>
@@ -14,11 +14,7 @@ import { WorkHistory } from "../__scalar/workHistory/workHistory.constant";
14
14
  // Input = user-provided fields; Object = Input + system fields + embedded scalars; Light = subset for list views; Full = Object + Light.
15
15
  // Registered by akan sync into cnst.ts barrel.
16
16
 
17
- export class TaskStatus extends enumOf("taskStatus", [
18
- "todo",
19
- "inProgress",
20
- "completed",
21
- ] as const) {}
17
+ export class TaskStatus extends enumOf("taskStatus", ["todo", "inProgress", "completed"] as const) {}
22
18
 
23
19
  export class TaskInput extends via((field) => ({
24
20
  title: field(String),
@@ -14,10 +14,7 @@ import type { TaskFilter } from "./task.document";
14
14
  // Registered by akan sync into dict.ts barrel.
15
15
 
16
16
  export const dictionary = modelDictionary(["en", "ko"])
17
- .of((t) =>
18
- t(["Task", "할 일"])
19
- .desc(["A unit of work to be completed", "완료해야 할 작업 단위"]),
20
- )
17
+ .of((t) => t(["Task", "할 일"]).desc(["A unit of work to be completed", "완료해야 할 작업 단위"]))
21
18
  .model<Task>((t) => ({
22
19
  title: t(["Title", "제목"]).desc(["Task title", "할 일 제목"]),
23
20
  content: t(["Content", "내용"]).desc(["Detailed task description", "상세 작업 설명"]),
@@ -43,10 +40,7 @@ export const dictionary = modelDictionary(["en", "ko"])
43
40
  completed: t(["Completed", "완료"]),
44
41
  }))
45
42
  .error({
46
- cannotStartFromNonTodo: [
47
- "Task can only start from todo status",
48
- "할 일 상태에서만 시작할 수 있습니다",
49
- ],
43
+ cannotStartFromNonTodo: ["Task can only start from todo status", "할 일 상태에서만 시작할 수 있습니다"],
50
44
  cannotCompleteFromNonInProgress: [
51
45
  "Task can only complete from in-progress status",
52
46
  "진행 중 상태에서만 완료할 수 있습니다",
@@ -4,8 +4,8 @@ export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { a
4
4
  return `import { dayjs } from "akanjs/base";
5
5
  import { by, from, into } from "akanjs/document";
6
6
 
7
- import { Err } from "../dict";
8
7
  import * as cnst from "../cnst";
8
+ import { Err } from "../dict";
9
9
 
10
10
  // ===== task.document.ts =====
11
11
  // Convention: <module>.document.ts — the database query and persistence layer.
@@ -1,7 +1,8 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
2
 
3
3
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: { appName: string }) {
4
- return `import { endpoint, internal, None, Public, slice } from "akanjs/signal";
4
+ return `import { LocalOrSignedIn } from "@apps/${dict.appName}/srvkit";
5
+ import { endpoint, internal, None, Public, slice } from "akanjs/signal";
5
6
 
6
7
  import * as cnst from "../cnst";
7
8
  import * as srv from "../srv";
@@ -23,25 +24,29 @@ export class TaskInternal extends internal(srv.task, ({ interval }) => ({})) {}
23
24
 
24
25
  // Guards, per key: root = the generated admin API (runs any filter with caller-supplied args), get = reads,
25
26
  // cru = create/update/remove. None here means "nobody until you name a guard".
26
- // The sample lets guests write so it works before the app has sign-in. Once it does, swap Public for SignedIn
27
- // (srvkit/guards.ts) on cru and on the mutations below — a real app never leaves writes Public.
28
- export class TaskSlice extends slice(srv.task, { guards: { root: None, get: Public, cru: Public } }, (init) => ({
29
- inPublic: init({ guards: [Public] }).exec(function () {
30
- return this.taskService.queryAny();
27
+ // Writes take LocalOrSignedIn (srvkit/guards.ts): open while the app runs locally or under test, so the sample works
28
+ // before the app has sign-in, and signed-in only once deployed. Once the app signs users in, swap it for SignedIn.
29
+ export class TaskSlice extends slice(
30
+ srv.task,
31
+ { guards: { root: None, get: Public, cru: LocalOrSignedIn } },
32
+ (init) => ({
33
+ inPublic: init({ guards: [Public] }).exec(function () {
34
+ return this.taskService.queryAny();
35
+ }),
31
36
  }),
32
- })) {}
37
+ ) {}
33
38
 
34
39
  // Every custom endpoint names its own guards array — the slice's map above only covers generated CRUD.
35
40
  // It is also the MCP decision: an endpoint declaring no guard, or a mutation guarded only by Public, is not
36
41
  // published to agents at all.
37
42
  export class TaskEndpoint extends endpoint(srv.task, ({ mutation }) => ({
38
- startTask: mutation(cnst.Task, { guards: [Public] })
43
+ startTask: mutation(cnst.Task, { guards: [LocalOrSignedIn] })
39
44
  .param("taskId", String)
40
45
  .exec(async function (taskId) {
41
46
  return await this.taskService.startTask(taskId);
42
47
  }),
43
48
 
44
- completeTask: mutation(cnst.Task, { guards: [Public] })
49
+ completeTask: mutation(cnst.Task, { guards: [LocalOrSignedIn] })
45
50
  .param("taskId", String)
46
51
  .exec(async function (taskId) {
47
52
  return await this.taskService.completeTask(taskId);
@@ -26,6 +26,7 @@ export default page().render(() => {
26
26
  <Task.Zone.Card className="flex flex-col gap-3" init={taskInitInPublic} />
27
27
  </main>
28
28
  );
29
- });`,
29
+ });
30
+ `,
30
31
  };
31
32
  }
@@ -29,6 +29,7 @@ export default page().render(() => {
29
29
  </div>
30
30
  </main>
31
31
  );
32
- });`,
32
+ });
33
+ `,
33
34
  };
34
35
  }
@@ -28,6 +28,17 @@ export class SignedIn implements Guard {
28
28
  }
29
29
  }
30
30
 
31
+ // Open locally and under \`akan test\` so the sample works before sign-in; once the app signs users in, use SignedIn.
32
+ export class LocalOrSignedIn implements Guard {
33
+ static name = "LocalOrSignedIn";
34
+ static scope: GuardScope = "account";
35
+
36
+ canPass(context: SignalContext): boolean {
37
+ const environment = process.env.AKAN_PUBLIC_ENV;
38
+ return environment === "local" || environment === "testing" || new SignedIn().canPass(context);
39
+ }
40
+ }
41
+
31
42
  // ---- Expandable additional fields: ----
32
43
  // Role-based guard: only allow users with a specific role
33
44
  // export class IsAdmin implements Guard {
@@ -21,16 +21,11 @@ interface QuantityControlProps {
21
21
  max?: number;
22
22
  }
23
23
 
24
- export const QuantityControl = ({
25
- className,
26
- value,
27
- onChange,
28
- min = 0,
29
- max = 99,
30
- }: QuantityControlProps) => {
24
+ export const QuantityControl = ({ className, value, onChange, min = 0, max = 99 }: QuantityControlProps) => {
31
25
  return (
32
26
  <div className={cn("inline-flex items-center gap-1", className)}>
33
- <button type="button"
27
+ <button
28
+ type="button"
34
29
  className={jellyButtonRecipe({ variant: "default", size: "icon" }, "size-7")}
35
30
  disabled={value <= min}
36
31
  onClick={() => onChange(Math.max(min, value - 1))}
@@ -38,7 +33,8 @@ export const QuantityControl = ({
38
33
  −
39
34
  </button>
40
35
  <span className="w-8 text-center font-medium tabular-nums">{value}</span>
41
- <button type="button"
36
+ <button
37
+ type="button"
42
38
  className={jellyButtonRecipe({ variant: "default", size: "icon" }, "size-7")}
43
39
  disabled={value >= max}
44
40
  onClick={() => onChange(Math.min(max, value + 1))}
@@ -0,0 +1,144 @@
1
+ import { compareExportNames } from "./facetIndex";
2
+
3
+ export interface JsxElement {
4
+ tag: string;
5
+ attrs: JsxAttr[];
6
+ }
7
+ export type JsxAttr = string | { name: string; param: string; body: JsxElement };
8
+
9
+ //? A scaffold is written before `bun install`, when no Biome can format it, so these break lines where Biome would.
10
+ export class BiomeForm {
11
+ static readonly lineWidth = 120;
12
+
13
+ //? Biome counts a Hangul syllable as two columns, as Bun.stringWidth does.
14
+ static fits(line: string) {
15
+ return Bun.stringWidth(line) <= BiomeForm.lineWidth;
16
+ }
17
+
18
+ static sorted(specifiers: string[]) {
19
+ return specifiers.toSorted((a, b) => compareExportNames(a.replace(/^type /, ""), b.replace(/^type /, "")));
20
+ }
21
+
22
+ //? Biome never breaks an import of one specifier, however long.
23
+ static importFrom(specifiers: string[], source: string, { typeOnly = false }: { typeOnly?: boolean } = {}) {
24
+ const keyword = typeOnly ? "import type" : "import";
25
+ const names = BiomeForm.sorted(specifiers);
26
+ const flat = `${keyword} { ${names.join(", ")} } from "${source}";`;
27
+ if (names.length === 1 || BiomeForm.fits(flat)) return flat;
28
+ return `${keyword} {\n${names.map((name) => ` ${name},`).join("\n")}\n} from "${source}";`;
29
+ }
30
+
31
+ //? A multi-line argument comes indented as it reads hugged, relative to the indent the call starts at.
32
+ static callArgs(indent: string, head: string, args: string[], tail = "") {
33
+ const leading = args.slice(0, -1);
34
+ const lastLines = (args.at(-1) ?? "").split("\n");
35
+ if (lastLines.length === 1) {
36
+ const flat = `${indent}${head}(${args.join(", ")})${tail}`;
37
+ if (BiomeForm.fits(flat)) return flat;
38
+ } else {
39
+ const opening = `${indent}${head}(${[...leading, lastLines[0]].join(", ")}`;
40
+ const closing = `${lastLines.at(-1)})${tail}`;
41
+ if (BiomeForm.fits(opening) && BiomeForm.fits(`${indent}${closing}`))
42
+ return [
43
+ opening,
44
+ ...lastLines.slice(1, -1).map((line) => BiomeForm.#indented(line, indent)),
45
+ `${indent}${closing}`,
46
+ ].join("\n");
47
+ }
48
+ const broken = args.map((arg) =>
49
+ `${arg},`
50
+ .split("\n")
51
+ .map((line) => BiomeForm.#indented(line, `${indent} `))
52
+ .join("\n"),
53
+ );
54
+ return `${indent}${head}(\n${broken.join("\n")}\n${indent})${tail}`;
55
+ }
56
+
57
+ //? Biome breaks after `=` only when the right side cannot break before the line ends.
58
+ static assign(indent: string, target: string, head: string, args: string[], tail = "") {
59
+ const call = BiomeForm.callArgs(indent, `${target} = ${head}`, args, tail);
60
+ if (!call.includes("\n") || (args.length > 0 && BiomeForm.fits(`${indent}${target} = ${head}(`))) return call;
61
+ return `${indent}${target} =\n${BiomeForm.callArgs(`${indent} `, head, args, tail)}`;
62
+ }
63
+
64
+ //? A broken type argument list takes no trailing comma.
65
+ static typeArgs(indent: string, head: string, args: string[], tail = "") {
66
+ const flat = `${indent}${head}<${args.join(", ")}>${tail}`;
67
+ if (BiomeForm.fits(flat)) return flat;
68
+ return `${indent}${head}<\n${args.map((arg) => `${indent} ${arg}`).join(",\n")}\n${indent}>${tail}`;
69
+ }
70
+
71
+ //? JSX text that does not fit ends its line with an explicit `{" "}`, since a line break there would drop the space.
72
+ static jsxSpaced(indent: string, first: string, second: string) {
73
+ const flat = `${indent}${first} ${second}`;
74
+ if (BiomeForm.fits(flat)) return flat;
75
+ return `${indent}${first}{" "}\n${indent}${second}`;
76
+ }
77
+
78
+ static wrap(indent: string, open: string, child: string, close: string) {
79
+ const flat = `${indent}${open}${child}${close}`;
80
+ if (BiomeForm.fits(flat)) return flat;
81
+ return `${indent}${open}\n${indent} ${child}\n${indent}${close}`;
82
+ }
83
+
84
+ static element(element: JsxElement, indent: string, { before = "", after = "" } = {}): string {
85
+ const flat = `${indent}${before}${BiomeForm.#flat(element)}${after}`;
86
+ if (BiomeForm.fits(flat)) return flat;
87
+ const attrs = element.attrs.map((attr) => BiomeForm.#attr(attr, `${indent} `));
88
+ return `${indent}${before}<${element.tag}\n${attrs.join("\n")}\n${indent}/>${after}`;
89
+ }
90
+
91
+ static openingTag(element: JsxElement, indent: string) {
92
+ const flat = `${indent}<${element.tag} ${element.attrs.map((attr) => BiomeForm.#flatAttr(attr)).join(" ")}>`;
93
+ if (BiomeForm.fits(flat)) return flat;
94
+ const attrs = element.attrs.map((attr) => BiomeForm.#attr(attr, `${indent} `));
95
+ return `${indent}<${element.tag}\n${attrs.join("\n")}\n${indent}>`;
96
+ }
97
+
98
+ static returnElement(element: JsxElement, indent: string) {
99
+ const flat = `${indent}return ${BiomeForm.#flat(element)};`;
100
+ if (BiomeForm.fits(flat)) return flat;
101
+ return `${indent}return (\n${BiomeForm.element(element, `${indent} `)}\n${indent});`;
102
+ }
103
+
104
+ static dictionaryOf(label: readonly [string, string], desc: readonly [string, string]) {
105
+ const body = `t(${BiomeForm.#pair(label)}).desc(${BiomeForm.#pair(desc)})`;
106
+ if (BiomeForm.fits(` .of((t) => ${body})`)) return ` .of((t) => ${body})`;
107
+ if (BiomeForm.fits(` ${body},`)) return ` .of((t) =>\n ${body},\n )`;
108
+ const descLines = desc.map((text) => ` ${JSON.stringify(text)},`).join("\n");
109
+ if (BiomeForm.fits(` t(${BiomeForm.#pair(label)}).desc([`))
110
+ return ` .of((t) =>\n t(${BiomeForm.#pair(label)}).desc([\n${descLines}\n ]),\n )`;
111
+ const labelLines = label.map((text) => ` ${JSON.stringify(text)},`).join("\n");
112
+ return ` .of((t) =>\n t([\n${labelLines}\n ]).desc([\n${descLines}\n ]),\n )`;
113
+ }
114
+
115
+ static dictionarySlice(key: string, label: readonly [string, string]) {
116
+ const head = ` ${key}: fn(${BiomeForm.#pair(label)}).arg(`;
117
+ if (BiomeForm.fits(`${head}(t) => ({})),`)) return `${head}(t) => ({})),`;
118
+ if (BiomeForm.fits(head)) return `${head}\n (t) => ({}),\n ),`;
119
+ const labelLines = label.map((text) => ` ${JSON.stringify(text)},`).join("\n");
120
+ return ` ${key}: fn([\n${labelLines}\n ]).arg((t) => ({})),`;
121
+ }
122
+
123
+ static #pair(pair: readonly [string, string]) {
124
+ return `[${pair.map((text) => JSON.stringify(text)).join(", ")}]`;
125
+ }
126
+
127
+ static #indented(line: string, indent: string) {
128
+ return line ? `${indent}${line}` : line;
129
+ }
130
+
131
+ static #flat({ tag, attrs }: JsxElement): string {
132
+ return `<${[tag, ...attrs.map((attr) => BiomeForm.#flatAttr(attr))].join(" ")} />`;
133
+ }
134
+
135
+ static #flatAttr(attr: JsxAttr): string {
136
+ return typeof attr === "string" ? attr : `${attr.name}={(${attr.param}) => ${BiomeForm.#flat(attr.body)}}`;
137
+ }
138
+
139
+ static #attr(attr: JsxAttr, indent: string): string {
140
+ const flat = `${indent}${BiomeForm.#flatAttr(attr)}`;
141
+ if (typeof attr === "string" || BiomeForm.fits(flat)) return flat;
142
+ return `${indent}${attr.name}={(${attr.param}) => (\n${BiomeForm.element(attr.body, `${indent} `)}\n${indent})}`;
143
+ }
144
+ }
@@ -1,4 +1,5 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
+ import { BiomeForm } from "../../../biomeForm";
2
3
 
3
4
  interface Dict {
4
5
  Model: string;
@@ -9,8 +10,7 @@ interface Dict {
9
10
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
10
11
  return {
11
12
  filename: "_index.tsx",
12
- content: `
13
- import { ${dict.Model}, fetch, usePage } from "${dict.clientPath}";
13
+ content: `${BiomeForm.importFrom([dict.Model, "fetch", "usePage"], dict.clientPath)}
14
14
  import { ID } from "akanjs/base";
15
15
  import { page } from "akanjs/client";
16
16
  import { Load } from "akanjs/ui";
@@ -20,7 +20,7 @@ export default page()
20
20
  .config({ transition: "none" })
21
21
  .render(({ ${dict.model}Id }) => {
22
22
  const { l } = usePage();
23
- const { ${dict.model}Edit } = fetch.edit${dict.Model}(${dict.model}Id);
23
+ ${BiomeForm.assign(" ", `const { ${dict.model}Edit }`, `fetch.edit${dict.Model}`, [`${dict.model}Id`], ";")}
24
24
  return (
25
25
  <div className="container">
26
26
  <div className="m-4 mt-8 flex justify-between">
@@ -1,4 +1,5 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
+ import { BiomeForm } from "../../biomeForm";
2
3
 
3
4
  interface Dict {
4
5
  Model: string;
@@ -9,8 +10,7 @@ interface Dict {
9
10
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
10
11
  return {
11
12
  filename: "_index.tsx",
12
- content: `
13
- import { ${dict.Model}, fetch, usePage } from "${dict.clientPath}";
13
+ content: `${BiomeForm.importFrom([dict.Model, "fetch", "usePage"], dict.clientPath)}
14
14
  import { ID } from "akanjs/base";
15
15
  import { page } from "akanjs/client";
16
16
  import { buttonRecipe, Link } from "akanjs/ui";
@@ -28,12 +28,12 @@ export default page()
28
28
  ))
29
29
  .render(({ ${dict.model}Id }) => {
30
30
  const { l } = usePage();
31
- const { ${dict.model}View } = fetch.view${dict.Model}(${dict.model}Id);
31
+ ${BiomeForm.assign(" ", `const { ${dict.model}View }`, `fetch.view${dict.Model}`, [`${dict.model}Id`], ";")}
32
32
  return (
33
33
  <div className="container flex flex-col gap-4">
34
34
  <div className="flex items-center gap-4 font-bold text-lg">
35
- <${dict.Model}.Zone.View view={${dict.model}View} />
36
- <Link className={buttonRecipe()} href={\`/${dict.model}/\${${dict.model}Id}/edit\`}>
35
+ ${BiomeForm.element({ tag: `${dict.Model}.Zone.View`, attrs: [`view={${dict.model}View}`] }, " ")}
36
+ ${BiomeForm.openingTag({ tag: "Link", attrs: ["className={buttonRecipe()}", `href={\`/${dict.model}/\${${dict.model}Id}/edit\`}`] }, " ")}
37
37
  {l("base.updateModel", { model: l("${dict.model}.modelName") })}
38
38
  </Link>
39
39
  </div>
@@ -1,4 +1,5 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
+ import { BiomeForm } from "../../biomeForm";
2
3
 
3
4
  interface Dict {
4
5
  Model: string;
@@ -7,10 +8,10 @@ interface Dict {
7
8
  clientPath: string;
8
9
  }
9
10
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
11
+ const form = ` const ${dict.model}Form: Partial<cnst.${dict.Model}> =`;
10
12
  return {
11
13
  filename: "_index.tsx",
12
- content: `
13
- import { type cnst, fetch, usePage, ${dict.Model} } from "${dict.clientPath}";
14
+ content: `${BiomeForm.importFrom(["type cnst", "fetch", "usePage", dict.Model], dict.clientPath)}
14
15
  import { page } from "akanjs/client";
15
16
  import { Load } from "akanjs/ui";
16
17
 
@@ -18,7 +19,7 @@ export default page()
18
19
  .config({ transition: "none" })
19
20
  .render(() => {
20
21
  const { l } = usePage();
21
- const ${dict.model}Form: Partial<cnst.${dict.Model}> = {};
22
+ ${BiomeForm.fits(`${form} {};`) ? `${form} {};` : `${form}\n {};`}
22
23
  return (
23
24
  <div className="container">
24
25
  <div className="m-4 mt-8 flex justify-between">
@@ -1,4 +1,5 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
+ import { BiomeForm } from "../biomeForm";
2
3
 
3
4
  interface Dict {
4
5
  Model: string;
@@ -9,8 +10,7 @@ interface Dict {
9
10
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
10
11
  return {
11
12
  filename: "_index.tsx",
12
- content: `
13
- import { ${dict.Model}, fetch, usePage } from "${dict.clientPath}";
13
+ content: `${BiomeForm.importFrom([dict.Model, "fetch", "usePage"], dict.clientPath)}
14
14
  import { page } from "akanjs/client";
15
15
  import { buttonRecipe, Link } from "akanjs/ui";
16
16
 
@@ -18,7 +18,7 @@ export default page()
18
18
  .config({ transition: "none" })
19
19
  .render(() => {
20
20
  const { l } = usePage();
21
- const { ${dict.model}InitInPublic } = fetch.init${dict.Model}InPublic();
21
+ ${BiomeForm.assign(" ", `const { ${dict.model}InitInPublic }`, `fetch.init${dict.Model}InPublic`, [], ";")}
22
22
  return (
23
23
  <div className="container flex flex-col gap-4">
24
24
  <div className="mt-5 h-full w-full px-5">
@@ -1,4 +1,5 @@
1
1
  import type { AppInfo, LibInfo } from "akanjs";
2
+ import { BiomeForm } from "../biomeForm";
2
3
 
3
4
  interface Dict {
4
5
  Model: string;
@@ -9,8 +10,7 @@ interface Dict {
9
10
  export default function getContent(scanInfo: AppInfo | LibInfo | null, dict: Dict) {
10
11
  return {
11
12
  filename: "_index.tsx",
12
- content: `
13
- import { ${dict.Model}, fetch, usePage } from "${dict.clientPath}";
13
+ content: `${BiomeForm.importFrom([dict.Model, "fetch", "usePage"], dict.clientPath)}
14
14
  import { page } from "akanjs/client";
15
15
  import { buttonRecipe, Model } from "akanjs/ui";
16
16
 
@@ -18,13 +18,17 @@ export default page()
18
18
  .config({ transition: "none" })
19
19
  .render(() => {
20
20
  const { l } = usePage();
21
- const { ${dict.model}InitInPublic } = fetch.init${dict.Model}InPublic();
21
+ ${BiomeForm.assign(" ", `const { ${dict.model}InitInPublic }`, `fetch.init${dict.Model}InPublic`, [], ";")}
22
22
  return (
23
23
  <>
24
24
  <div className="flex animate-fadeIn items-center gap-4 px-4 pt-4">
25
- <div className="font-bold text-lg md:text-4xl">{l("${dict.model}.modelName")}</div>
25
+ ${BiomeForm.wrap(" ", '<div className="font-bold text-lg md:text-4xl">', `{l("${dict.model}.modelName")}`, "</div>")}
26
26
  <Model.New
27
- trigger={<button type="button" className={buttonRecipe({ size: "sm", variant: "ghost" })}>{l("base.new")}</button>}
27
+ trigger={
28
+ <button type="button" className={buttonRecipe({ size: "sm", variant: "ghost" })}>
29
+ {l("base.new")}
30
+ </button>
31
+ }
28
32
  slice={fetch.slice.${dict.model}InPublic}
29
33
  renderTitle="id"
30
34
  >
@@ -2,11 +2,10 @@ interface Dict {
2
2
  libName: string;
3
3
  }
4
4
  export default function getContent(scanInfo: null, dict: Dict) {
5
- return `
6
- import type { LibConfig } from "akanjs";
5
+ return `import type { LibConfig } from "akanjs";
7
6
 
8
7
  const config: LibConfig = {};
9
8
 
10
9
  export default config;
11
- `;
10
+ `;
12
11
  }
@@ -3,8 +3,7 @@ interface Dict {
3
3
  LibName: string;
4
4
  }
5
5
  export default function getContent(scanInfo: null, dict: Dict) {
6
- return `
7
- import { serviceDictionary } from "akanjs/dictionary";
6
+ return `import { serviceDictionary } from "akanjs/dictionary";
8
7
 
9
8
  import type { ${dict.LibName}Endpoint } from "./${dict.libName}.signal";
10
9
 
@@ -1,13 +1,14 @@
1
+ import { BiomeForm } from "../../../biomeForm";
2
+
1
3
  interface Dict {
2
4
  libName: string;
3
5
  LibName: string;
4
6
  }
5
7
  export default function getContent(scanInfo: null, dict: Dict) {
6
- return `
7
- import { serve } from "akanjs/service";
8
+ return `import { serve } from "akanjs/service";
8
9
 
9
10
  // import type * as srv from "../srv";
10
11
 
11
- export class ${dict.LibName}Service extends serve("${dict.libName}" as const, { serverMode: "batch" }, () => ({})) {}
12
- `;
12
+ ${BiomeForm.callArgs("", `export class ${dict.LibName}Service extends serve`, [`"${dict.libName}" as const`, '{ serverMode: "batch" }', "() => ({})"], " {}")}
13
+ `;
13
14
  }