akanjs 3.0.0-alpha.7 → 3.0.0-alpha.71

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 (719) hide show
  1. package/CHANGELOG.md +103 -0
  2. package/README.ko.md +1 -1
  3. package/README.md +1 -1
  4. package/base/baseEnv.ts +7 -4
  5. package/base/primitiveRegistry.ts +59 -12
  6. package/base/symbols.ts +4 -0
  7. package/client/capacitor.ts +34 -0
  8. package/client/clientRuntime.ts +5 -0
  9. package/client/csrTypes.ts +4 -3
  10. package/client/index.ts +1 -0
  11. package/client/locale.ts +2 -2
  12. package/client/router.ts +7 -7
  13. package/client/sharedContext.ts +31 -0
  14. package/client/translator.ts +2 -2
  15. package/client/types.ts +3 -3
  16. package/common/Logger.ts +280 -67
  17. package/common/clientAddress.ts +40 -0
  18. package/common/deepObjectify.ts +24 -9
  19. package/common/index.ts +42 -1
  20. package/common/logContext.ts +27 -0
  21. package/common/mcpExposure.ts +114 -0
  22. package/common/pathGetLoose.ts +31 -0
  23. package/common/pathSet.ts +17 -5
  24. package/common/plainFieldsOf.ts +13 -0
  25. package/common/routeConvention.ts +22 -12
  26. package/common/websocketBinaryFrame.ts +46 -0
  27. package/constant/crystalize.ts +94 -28
  28. package/constant/dateSlot.ts +62 -0
  29. package/constant/deserialize.ts +3 -2
  30. package/constant/fieldInfo.ts +43 -3
  31. package/constant/fieldQueryMeta.ts +35 -0
  32. package/constant/getDefault.ts +16 -11
  33. package/constant/hydrationPlan.ts +72 -0
  34. package/constant/immerify.ts +4 -6
  35. package/constant/index.ts +5 -0
  36. package/constant/labelOf.ts +26 -0
  37. package/constant/mask.ts +67 -0
  38. package/constant/purify.ts +17 -11
  39. package/constant/textFieldPaths.ts +13 -7
  40. package/constant/types.ts +19 -13
  41. package/constant/via.ts +24 -17
  42. package/dictionary/DictionaryLookup.ts +30 -0
  43. package/dictionary/agent.dictionary.ts +31 -0
  44. package/dictionary/agentTurn.dictionary.ts +29 -0
  45. package/dictionary/base.dictionary.ts +81 -0
  46. package/dictionary/dictInfo.ts +11 -2
  47. package/dictionary/dictionary.ts +9 -3
  48. package/dictionary/index.ts +1 -0
  49. package/dictionary/trans.ts +2 -2
  50. package/document/documentQuery.ts +1 -0
  51. package/document/filterMeta.ts +77 -12
  52. package/document/index.ts +1 -0
  53. package/document/noDocumentError.ts +12 -0
  54. package/document/types.ts +0 -1
  55. package/fetch/agentTurn.ts +19 -0
  56. package/fetch/client/fetchClient.ts +137 -37
  57. package/fetch/client/httpClient.ts +95 -20
  58. package/fetch/client/wsClient.ts +27 -12
  59. package/fetch/fetchType/appliedReturn.type.ts +65 -44
  60. package/fetch/fetchType/endpointFetch.type.ts +17 -8
  61. package/fetch/fetchType/sliceFetch.type.ts +27 -50
  62. package/fetch/index.ts +1 -0
  63. package/index.ts +80 -6
  64. package/local/apps/akan/akan-local.db +0 -0
  65. package/local/apps/akan/akan-local.db-shm +0 -0
  66. package/local/apps/akan/akan-local.db-wal +0 -0
  67. package/local/apps/akan/akan-local_solid.db +0 -0
  68. package/local/apps/akan/akan-local_solid.db-shm +0 -0
  69. package/local/apps/akan/akan-local_solid.db-wal +0 -0
  70. package/local/apps/serverLifecycle/serverLifecycle-local.db +0 -0
  71. package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
  72. package/local/apps/serverLifecycle/serverLifecycle-local.db-wal +0 -0
  73. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db +0 -0
  74. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
  75. package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-wal +0 -0
  76. package/package.json +27 -18
  77. package/server/akanApp.ts +278 -138
  78. package/server/akanAppHeaders.ts +16 -2
  79. package/server/akanOption.ts +63 -8
  80. package/server/akanServer.ts +387 -32
  81. package/server/animatedImage.ts +83 -0
  82. package/server/assetEncoding.ts +4 -24
  83. package/server/binaryPubsub.ts +55 -0
  84. package/server/console.ts +110 -101
  85. package/server/consoleEvaluator.ts +51 -0
  86. package/server/consolePasteFilter.ts +91 -0
  87. package/server/consoleSession.ts +242 -0
  88. package/server/contentEncoding.ts +83 -0
  89. package/server/devtools/signalSerializer.ts +2 -2
  90. package/server/devtools/types.ts +4 -4
  91. package/server/di/diLifecycle.ts +123 -13
  92. package/server/di/predefinedAdaptor.ts +6 -0
  93. package/server/di/utils.ts +40 -0
  94. package/server/imageOptimizer.ts +154 -57
  95. package/server/lifecycle/runtimeDir.ts +14 -0
  96. package/server/lifecycle/shutdownManager.ts +1 -1
  97. package/server/logging/childOutputReader.ts +137 -0
  98. package/server/logging/hubFileSink.ts +39 -0
  99. package/server/logging/logControlSocket.ts +173 -0
  100. package/server/logging/logForwarder.ts +131 -0
  101. package/server/logging/logHub.ts +0 -0
  102. package/server/logging/logQuery.ts +130 -0
  103. package/server/logging/logStdoutWriter.ts +39 -0
  104. package/server/logging/logStreamRoute.ts +87 -0
  105. package/server/logging/logTailClient.ts +161 -0
  106. package/server/mcp/McpAuth.ts +177 -0
  107. package/server/mcp/McpDispatcher.ts +289 -0
  108. package/server/mcp/McpEventStream.ts +24 -0
  109. package/server/mcp/McpExecutionContext.ts +105 -0
  110. package/server/mcp/McpRouter.ts +621 -0
  111. package/server/mcp/index.ts +5 -0
  112. package/server/processMetricsCollector.ts +1 -1
  113. package/server/resolver/database.resolver.ts +5 -4
  114. package/server/resolver/signal.resolver.ts +208 -86
  115. package/server/routeTreeBuilder.ts +10 -8
  116. package/server/routing/apiRouter.ts +44 -14
  117. package/server/routing/appWsData.ts +24 -2
  118. package/server/routing/eventStream.ts +93 -0
  119. package/server/routing/soloAppRoutes.ts +50 -0
  120. package/server/rscWorker.tsx +36 -22
  121. package/server/rscWorkerHost.ts +59 -8
  122. package/server/semaphore.ts +22 -0
  123. package/server/subRouteIndexDocument.tsx +61 -0
  124. package/server/systemPageDocument.tsx +3 -3
  125. package/server/systemPages.tsx +49 -16
  126. package/server/types.tsx +28 -0
  127. package/server/vendor/akanjs-fetch.ts +1 -0
  128. package/server/webRouter.ts +96 -39
  129. package/service/adapt.ts +4 -4
  130. package/service/agent.service.ts +81 -0
  131. package/service/base.service.ts +2 -1
  132. package/service/index.ts +1 -0
  133. package/service/injectInfo.ts +8 -3
  134. package/service/ipcTypes.ts +6 -0
  135. package/service/predefinedAdaptor/compress.adaptor.ts +5 -1
  136. package/service/predefinedAdaptor/database.adaptor.ts +68 -37
  137. package/service/predefinedAdaptor/deepseekLlm.ts +271 -0
  138. package/service/predefinedAdaptor/index.ts +3 -0
  139. package/service/predefinedAdaptor/insightQuery.ts +183 -0
  140. package/service/predefinedAdaptor/llm.adaptor.ts +115 -0
  141. package/service/predefinedAdaptor/logging.adaptor.ts +1 -1
  142. package/service/predefinedAdaptor/queue.adaptor.ts +5 -2
  143. package/service/predefinedAdaptor/role.adaptor.ts +2 -0
  144. package/service/predefinedAdaptor/schedule.adaptor.ts +12 -5
  145. package/service/predefinedAdaptor/solidPubsub.adaptor.ts +10 -6
  146. package/service/predefinedAdaptor/solidQueue.adaptor.ts +6 -2
  147. package/service/predefinedAdaptor/solidSqlite.ts +11 -9
  148. package/service/predefinedAdaptor/websocket.adaptor.ts +6 -1
  149. package/service/serve.ts +16 -9
  150. package/service/toolNames.ts +119 -0
  151. package/signal/agent/AgentCatalogue.ts +165 -0
  152. package/signal/agent/index.ts +1 -0
  153. package/signal/agent.signal.ts +38 -0
  154. package/signal/agentTurn.ts +8 -0
  155. package/signal/agentTurnStream.ts +60 -0
  156. package/signal/base.signal.ts +2 -1
  157. package/signal/endpointInfo.ts +38 -2
  158. package/signal/guard.ts +28 -1
  159. package/signal/guards.ts +49 -1
  160. package/signal/index.ts +6 -0
  161. package/signal/intercept.ts +4 -4
  162. package/signal/internalArg.ts +21 -4
  163. package/signal/mcp/McpDocument.ts +326 -0
  164. package/signal/mcp/McpProgress.ts +106 -0
  165. package/signal/mcp/McpUriTemplate.ts +80 -0
  166. package/signal/mcp/Msg.ts +368 -0
  167. package/signal/mcp/index.ts +5 -0
  168. package/signal/mcp/mcpProtocol.ts +120 -0
  169. package/signal/middleware.ts +3 -3
  170. package/signal/openapi/openapi.ts +36 -173
  171. package/signal/schema/JsonSchemaBuilder.ts +221 -0
  172. package/signal/schema/index.ts +1 -0
  173. package/signal/serializer/fetch.serializer.ts +51 -0
  174. package/signal/signalContext.ts +324 -76
  175. package/signal/slice.ts +62 -27
  176. package/signal/trace.ts +268 -9
  177. package/signal/types.ts +55 -4
  178. package/store/action.ts +34 -41
  179. package/store/actionTag.ts +33 -0
  180. package/store/agent/AgentBridge.ts +87 -0
  181. package/store/agent/AgentContext.ts +71 -0
  182. package/store/agent/AgentPrompts.ts +111 -0
  183. package/store/agent/ScreenReader.ts +349 -0
  184. package/store/agent/ScreenSettle.ts +45 -0
  185. package/store/agent/ScreenTarget.ts +135 -0
  186. package/store/agent/StoreCatalogue.ts +116 -0
  187. package/store/agent/StoreSurfaceSource.ts +225 -0
  188. package/store/agent/index.ts +13 -0
  189. package/store/agent/storeSurface.ts +28 -0
  190. package/store/agent/types.ts +16 -0
  191. package/store/agentic/AgentValue.ts +119 -0
  192. package/store/agentic/StExposeBuilder.ts +47 -0
  193. package/store/agentic/StExposeDraft.ts +24 -0
  194. package/store/agentic/StStateBuilder.ts +85 -0
  195. package/store/agentic/StStateDraft.ts +23 -0
  196. package/store/agentic/StToolBuilder.ts +279 -0
  197. package/store/agentic/StToolDraft.ts +22 -0
  198. package/store/agentic/attachAgentic.ts +33 -0
  199. package/store/agentic/formFields.ts +194 -0
  200. package/store/agentic/index.ts +12 -0
  201. package/store/agentic/useFieldTool.ts +183 -0
  202. package/store/agentic/useFormTools.ts +77 -0
  203. package/store/agentic/useRelationFieldTool.ts +113 -0
  204. package/store/baseSt.ts +1 -1
  205. package/store/databaseStateNames.ts +31 -0
  206. package/store/formSetterNames.ts +35 -0
  207. package/store/index.ts +8 -0
  208. package/store/rootStore.ts +3 -1
  209. package/store/sliceRole.ts +36 -0
  210. package/store/state.ts +2 -12
  211. package/store/store.ts +9 -0
  212. package/store/storeInstance.ts +185 -20
  213. package/store/storeRegistry.ts +39 -1
  214. package/store/types.ts +5 -0
  215. package/store/withSelector.ts +5 -4
  216. package/test/index.ts +1 -1
  217. package/test/registerDom.ts +4 -0
  218. package/test/sampleOf.ts +2 -0
  219. package/test/signalTestRuntime.ts +5 -5
  220. package/test/testServer.ts +14 -11
  221. package/types/base/baseEnv.d.ts +1 -1
  222. package/types/base/primitiveRegistry.d.ts +20 -8
  223. package/types/base/symbols.d.ts +4 -0
  224. package/types/client/capacitor.d.ts +39 -0
  225. package/types/client/clientRuntime.d.ts +7 -0
  226. package/types/client/index.d.ts +1 -0
  227. package/types/client/sharedContext.d.ts +21 -0
  228. package/types/client/types.d.ts +5 -3
  229. package/types/common/Logger.d.ts +88 -6
  230. package/types/common/clientAddress.d.ts +19 -0
  231. package/types/common/deepObjectify.d.ts +4 -2
  232. package/types/common/index.d.ts +8 -2
  233. package/types/common/logContext.d.ts +17 -0
  234. package/types/common/mcpExposure.d.ts +64 -0
  235. package/types/common/pathGetLoose.d.ts +8 -0
  236. package/types/common/plainFieldsOf.d.ts +6 -0
  237. package/types/common/routeConvention.d.ts +6 -0
  238. package/types/common/websocketBinaryFrame.d.ts +17 -0
  239. package/types/constant/constantRegistry.d.ts +2 -10
  240. package/types/constant/crystalize.d.ts +5 -0
  241. package/types/constant/dateSlot.d.ts +14 -0
  242. package/types/constant/fieldInfo.d.ts +20 -3
  243. package/types/constant/fieldQueryMeta.d.ts +17 -0
  244. package/types/constant/getDefault.d.ts +8 -0
  245. package/types/constant/hydrationPlan.d.ts +24 -0
  246. package/types/constant/index.d.ts +5 -0
  247. package/types/constant/labelOf.d.ts +7 -0
  248. package/types/constant/mask.d.ts +41 -0
  249. package/types/constant/purify.d.ts +2 -2
  250. package/types/constant/types.d.ts +5 -5
  251. package/types/dictionary/DictionaryLookup.d.ts +14 -0
  252. package/types/dictionary/agent.dictionary.d.ts +1 -0
  253. package/types/dictionary/agentTurn.dictionary.d.ts +1 -0
  254. package/types/dictionary/base.dictionary.d.ts +1 -1
  255. package/types/dictionary/dictInfo.d.ts +7 -1
  256. package/types/dictionary/dictionary.d.ts +11 -9
  257. package/types/dictionary/index.d.ts +1 -0
  258. package/types/document/filterMeta.d.ts +24 -4
  259. package/types/document/index.d.ts +1 -0
  260. package/types/document/noDocumentError.d.ts +12 -0
  261. package/types/document/types.d.ts +0 -1
  262. package/types/fetch/agentTurn.d.ts +475 -0
  263. package/types/fetch/client/fetchClient.d.ts +12 -0
  264. package/types/fetch/client/httpClient.d.ts +2 -1
  265. package/types/fetch/fetchType/appliedReturn.type.d.ts +37 -18
  266. package/types/fetch/fetchType/endpointFetch.type.d.ts +8 -5
  267. package/types/fetch/fetchType/sliceFetch.type.d.ts +11 -15
  268. package/types/fetch/index.d.ts +1 -0
  269. package/types/index.d.ts +74 -10
  270. package/types/server/akanApp.d.ts +12 -0
  271. package/types/server/akanAppHeaders.d.ts +7 -1
  272. package/types/server/akanOption.d.ts +36 -6
  273. package/types/server/akanServer.d.ts +67 -9
  274. package/types/server/animatedImage.d.ts +7 -0
  275. package/types/server/assetEncoding.d.ts +1 -1
  276. package/types/server/binaryPubsub.d.ts +18 -0
  277. package/types/server/console.d.ts +11 -1
  278. package/types/server/consoleEvaluator.d.ts +2 -0
  279. package/types/server/consolePasteFilter.d.ts +11 -0
  280. package/types/server/consoleSession.d.ts +22 -0
  281. package/types/server/contentEncoding.d.ts +28 -0
  282. package/types/server/devtools/types.d.ts +4 -4
  283. package/types/server/di/diLifecycle.d.ts +10 -2
  284. package/types/server/di/predefinedAdaptor.d.ts +4 -1
  285. package/types/server/di/utils.d.ts +16 -0
  286. package/types/server/lifecycle/runtimeDir.d.ts +5 -0
  287. package/types/server/logging/childOutputReader.d.ts +40 -0
  288. package/types/server/logging/hubFileSink.d.ts +18 -0
  289. package/types/server/logging/logControlSocket.d.ts +60 -0
  290. package/types/server/logging/logForwarder.d.ts +37 -0
  291. package/types/server/logging/logHub.d.ts +70 -0
  292. package/types/server/logging/logQuery.d.ts +31 -0
  293. package/types/server/logging/logStdoutWriter.d.ts +35 -0
  294. package/types/server/logging/logStreamRoute.d.ts +20 -0
  295. package/types/server/logging/logTailClient.d.ts +42 -0
  296. package/types/server/mcp/McpAuth.d.ts +62 -0
  297. package/types/server/mcp/McpDispatcher.d.ts +61 -0
  298. package/types/server/mcp/McpEventStream.d.ts +17 -0
  299. package/types/server/mcp/McpExecutionContext.d.ts +44 -0
  300. package/types/server/mcp/McpRouter.d.ts +65 -0
  301. package/types/server/mcp/index.d.ts +5 -0
  302. package/types/server/mcp.d.ts +1 -0
  303. package/types/server/resolver/signal.resolver.d.ts +7 -4
  304. package/types/server/routing/apiRouter.d.ts +2 -1
  305. package/types/server/routing/appWsData.d.ts +13 -1
  306. package/types/server/routing/eventStream.d.ts +23 -0
  307. package/types/server/routing/soloAppRoutes.d.ts +17 -0
  308. package/types/server/rscWorkerHost.d.ts +4 -1
  309. package/types/server/semaphore.d.ts +5 -0
  310. package/types/server/subRouteIndexDocument.d.ts +8 -0
  311. package/types/server/systemPageDocument.d.ts +1 -0
  312. package/types/server/systemPages.d.ts +5 -0
  313. package/types/server/types.d.ts +16 -0
  314. package/types/server/vendor/akanjs-fetch.d.ts +1 -0
  315. package/types/server/webRouter.d.ts +15 -4
  316. package/types/service/adapt.d.ts +2 -2
  317. package/types/service/agent.service.d.ts +32 -0
  318. package/types/service/base.service.d.ts +4 -0
  319. package/types/service/index.d.ts +1 -0
  320. package/types/service/injectInfo.d.ts +2 -2
  321. package/types/service/ipcTypes.d.ts +12 -0
  322. package/types/service/predefinedAdaptor/compress.adaptor.d.ts +1 -1
  323. package/types/service/predefinedAdaptor/database.adaptor.d.ts +9 -3
  324. package/types/service/predefinedAdaptor/deepseekLlm.d.ts +76 -0
  325. package/types/service/predefinedAdaptor/index.d.ts +3 -0
  326. package/types/service/predefinedAdaptor/insightQuery.d.ts +50 -0
  327. package/types/service/predefinedAdaptor/llm.adaptor.d.ts +105 -0
  328. package/types/service/predefinedAdaptor/queue.adaptor.d.ts +3 -2
  329. package/types/service/predefinedAdaptor/role.adaptor.d.ts +2 -0
  330. package/types/service/predefinedAdaptor/schedule.adaptor.d.ts +10 -6
  331. package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts +6 -2
  332. package/types/service/predefinedAdaptor/solidSqlite.d.ts +2 -2
  333. package/types/service/serve.d.ts +3 -3
  334. package/types/service/toolNames.d.ts +35 -0
  335. package/types/signal/agent/AgentCatalogue.d.ts +100 -0
  336. package/types/signal/agent/index.d.ts +1 -0
  337. package/types/signal/agent.d.ts +1 -0
  338. package/types/signal/agent.signal.d.ts +24 -0
  339. package/types/signal/agentTurn.d.ts +9 -0
  340. package/types/signal/agentTurnStream.d.ts +24 -0
  341. package/types/signal/base.signal.d.ts +1 -1
  342. package/types/signal/endpointInfo.d.ts +21 -3
  343. package/types/signal/guard.d.ts +12 -0
  344. package/types/signal/guards.d.ts +23 -1
  345. package/types/signal/index.d.ts +6 -0
  346. package/types/signal/intercept.d.ts +2 -2
  347. package/types/signal/internalArg.d.ts +22 -6
  348. package/types/signal/mcp/McpDocument.d.ts +84 -0
  349. package/types/signal/mcp/McpProgress.d.ts +40 -0
  350. package/types/signal/mcp/McpUriTemplate.d.ts +25 -0
  351. package/types/signal/mcp/Msg.d.ts +143 -0
  352. package/types/signal/mcp/index.d.ts +5 -0
  353. package/types/signal/mcp/mcpProtocol.d.ts +107 -0
  354. package/types/signal/mcp.d.ts +1 -0
  355. package/types/signal/middleware.d.ts +7 -7
  356. package/types/signal/openapi/openapi.d.ts +3 -3
  357. package/types/signal/schema/JsonSchemaBuilder.d.ts +51 -0
  358. package/types/signal/schema/index.d.ts +1 -0
  359. package/types/signal/schema.d.ts +1 -0
  360. package/types/signal/signalContext.d.ts +67 -8
  361. package/types/signal/slice.d.ts +42 -15
  362. package/types/signal/trace.d.ts +52 -2
  363. package/types/signal/types.d.ts +53 -4
  364. package/types/store/action.d.ts +7 -5
  365. package/types/store/actionTag.d.ts +21 -0
  366. package/types/store/agent/AgentBridge.d.ts +37 -0
  367. package/types/store/agent/AgentContext.d.ts +16 -0
  368. package/types/store/agent/AgentPrompts.d.ts +31 -0
  369. package/types/store/agent/ScreenReader.d.ts +29 -0
  370. package/types/store/agent/ScreenSettle.d.ts +22 -0
  371. package/types/store/agent/ScreenTarget.d.ts +34 -0
  372. package/types/store/agent/StoreCatalogue.d.ts +26 -0
  373. package/types/store/agent/StoreSurfaceSource.d.ts +30 -0
  374. package/types/store/agent/index.d.ts +11 -0
  375. package/types/store/agent/storeSurface.d.ts +14 -0
  376. package/types/store/agent/types.d.ts +15 -0
  377. package/types/store/agent.d.ts +1 -0
  378. package/types/store/agentic/AgentValue.d.ts +43 -0
  379. package/types/store/agentic/StExposeBuilder.d.ts +21 -0
  380. package/types/store/agentic/StExposeDraft.d.ts +13 -0
  381. package/types/store/agentic/StStateBuilder.d.ts +21 -0
  382. package/types/store/agentic/StStateDraft.d.ts +12 -0
  383. package/types/store/agentic/StToolBuilder.d.ts +56 -0
  384. package/types/store/agentic/StToolDraft.d.ts +13 -0
  385. package/types/store/agentic/attachAgentic.d.ts +25 -0
  386. package/types/store/agentic/formFields.d.ts +53 -0
  387. package/types/store/agentic/index.d.ts +12 -0
  388. package/types/store/agentic/useFieldTool.d.ts +22 -0
  389. package/types/store/agentic/useFormTools.d.ts +19 -0
  390. package/types/store/agentic/useRelationFieldTool.d.ts +27 -0
  391. package/types/store/agentic.d.ts +1 -0
  392. package/types/store/baseSt.d.ts +35 -39
  393. package/types/store/databaseStateNames.d.ts +25 -0
  394. package/types/store/formSetterNames.d.ts +30 -0
  395. package/types/store/index.d.ts +7 -0
  396. package/types/store/rootStore.d.ts +5 -1
  397. package/types/store/sliceRole.d.ts +25 -0
  398. package/types/store/store.d.ts +5 -1
  399. package/types/store/storeInstance.d.ts +33 -1
  400. package/types/store/storeRegistry.d.ts +5 -0
  401. package/types/store/types.d.ts +4 -0
  402. package/types/store/withSelector.d.ts +5 -4
  403. package/types/test/index.d.ts +1 -1
  404. package/types/test/registerDom.d.ts +1 -0
  405. package/types/test/signalTestRuntime.d.ts +2 -3
  406. package/types/test/testServer.d.ts +6 -4
  407. package/types/ui/Agent/Approval.d.ts +8 -0
  408. package/types/ui/Agent/Attach.d.ts +16 -0
  409. package/types/ui/Agent/Bubble.d.ts +26 -0
  410. package/types/ui/Agent/Chat.d.ts +91 -0
  411. package/types/ui/Agent/ChatCommands.d.ts +34 -0
  412. package/types/ui/Agent/Composer.d.ts +23 -0
  413. package/types/ui/Agent/Context.d.ts +13 -0
  414. package/types/ui/Agent/Dock.d.ts +17 -0
  415. package/types/ui/Agent/Guide.d.ts +9 -0
  416. package/types/ui/Agent/History.d.ts +26 -0
  417. package/types/ui/Agent/Launcher.d.ts +16 -0
  418. package/types/ui/Agent/Markdown.d.ts +19 -0
  419. package/types/ui/Agent/Menu.d.ts +18 -0
  420. package/types/ui/Agent/Mic.d.ts +8 -0
  421. package/types/ui/Agent/Question.d.ts +14 -0
  422. package/types/ui/Agent/Section.d.ts +10 -0
  423. package/types/ui/Agent/Skip.d.ts +22 -0
  424. package/types/ui/Agent/StateKey.d.ts +16 -0
  425. package/types/ui/Agent/Tool.d.ts +15 -0
  426. package/types/ui/Agent/Transcript.d.ts +13 -0
  427. package/types/ui/Agent/Zone.d.ts +48 -0
  428. package/types/ui/Agent/agentSessionOf.d.ts +27 -0
  429. package/types/ui/Agent/attachment.d.ts +34 -0
  430. package/types/ui/Agent/fetchRunner.d.ts +12 -0
  431. package/types/ui/Agent/index.d.ts +19 -0
  432. package/types/ui/Agent/index_.d.ts +1 -0
  433. package/types/ui/Agent/markdownBlocks.d.ts +35 -0
  434. package/types/ui/Agent/markdownSpans.d.ts +2 -0
  435. package/types/ui/Agent/markdownTable.d.ts +16 -0
  436. package/types/ui/Agent/sessionHistory.d.ts +14 -0
  437. package/types/ui/Agent/sessionView.d.ts +15 -0
  438. package/types/ui/Agent/tokenCount.d.ts +6 -0
  439. package/types/ui/Agent/useChatAttachments.d.ts +24 -0
  440. package/types/ui/Agent/useChatVoice.d.ts +30 -0
  441. package/types/ui/Agent/useDraftRecall.d.ts +14 -0
  442. package/types/ui/Agent/useKeyboardInset.d.ts +8 -0
  443. package/types/ui/Agent/useSlashMenu.d.ts +24 -0
  444. package/types/ui/Agent/voice.d.ts +71 -0
  445. package/types/ui/Agent.d.ts +1 -0
  446. package/types/ui/Badge.d.ts +1 -1
  447. package/types/ui/Button.d.ts +1 -1
  448. package/types/ui/Constant/Graph.d.ts +10 -0
  449. package/types/ui/Constant/index.d.ts +2 -1
  450. package/types/ui/Constant/schemaGraph.d.ts +39 -0
  451. package/types/ui/Data/Dashboard.d.ts +16 -3
  452. package/types/ui/Data/Insight.d.ts +1 -1
  453. package/types/ui/Data/ListContainer.d.ts +15 -7
  454. package/types/ui/Data/QueryMaker.d.ts +45 -3
  455. package/types/ui/Data/RefPicker.d.ts +16 -0
  456. package/types/ui/Data/dataExport.d.ts +5 -0
  457. package/types/ui/Data/dataText.d.ts +6 -0
  458. package/types/ui/Data/index.d.ts +2 -0
  459. package/types/ui/Data/index_.d.ts +1 -0
  460. package/types/ui/DatePicker.d.ts +15 -11
  461. package/types/ui/Dialog/LegacyModal.d.ts +13 -0
  462. package/types/ui/Dialog/Provider.d.ts +3 -1
  463. package/types/ui/Dialog/context.d.ts +9 -1
  464. package/types/ui/Dialog/index.d.ts +1 -0
  465. package/types/ui/DraggableList.d.ts +1 -1
  466. package/types/ui/Dropdown.d.ts +5 -1
  467. package/types/ui/Field.d.ts +13 -12
  468. package/types/ui/Layout/BottomTab.d.ts +3 -2
  469. package/types/ui/LegacyModal.d.ts +24 -0
  470. package/types/ui/Loading/ProgressBar.d.ts +4 -0
  471. package/types/ui/Loading/Spin.d.ts +2 -1
  472. package/types/ui/Model/AdminPanel.d.ts +15 -3
  473. package/types/ui/Model/EditModal.d.ts +1 -1
  474. package/types/ui/Model/New.d.ts +3 -1
  475. package/types/ui/Model/NewWrapper.d.ts +2 -0
  476. package/types/ui/Model/NewWrapper_Client.d.ts +2 -1
  477. package/types/ui/Pagination.d.ts +2 -2
  478. package/types/ui/Radio.d.ts +1 -1
  479. package/types/ui/RecentTime.d.ts +18 -1
  480. package/types/ui/Reference/Collapse.d.ts +11 -0
  481. package/types/ui/Reference/Panel.d.ts +29 -0
  482. package/types/ui/Reference/Segmented.d.ts +17 -0
  483. package/types/ui/Reference/Summary.d.ts +13 -0
  484. package/types/ui/Reference/Toolbar.d.ts +21 -0
  485. package/types/ui/Reference/dictText.d.ts +6 -0
  486. package/types/ui/Reference/index.d.ts +7 -0
  487. package/types/ui/Reference/style.d.ts +20 -0
  488. package/types/ui/Reference.d.ts +1 -0
  489. package/types/ui/ScreenNavigator.d.ts +3 -1
  490. package/types/ui/Signal/Arg.d.ts +7 -3
  491. package/types/ui/Signal/Doc.d.ts +4 -6
  492. package/types/ui/Signal/Object.d.ts +2 -1
  493. package/types/ui/Signal/RestApi.d.ts +2 -1
  494. package/types/ui/Signal/WebSocket.d.ts +2 -1
  495. package/types/ui/Signal/endpointEntries.d.ts +20 -0
  496. package/types/ui/Signal/style.d.ts +9 -8
  497. package/types/ui/System/Client.d.ts +1 -2
  498. package/types/ui/System/Common.d.ts +3 -4
  499. package/types/ui/System/Messages.d.ts +1 -1
  500. package/types/ui/Tab/Provider.d.ts +3 -1
  501. package/types/ui/Tab/context.d.ts +4 -2
  502. package/types/ui/ToggleSelect.d.ts +1 -0
  503. package/types/ui/UiOverride/context.d.ts +18 -1
  504. package/types/ui/agentAttrs.d.ts +14 -0
  505. package/types/ui/index.d.ts +22 -1
  506. package/types/ui/overlayLayer.d.ts +13 -0
  507. package/types/ui/overlayPosition.d.ts +28 -0
  508. package/types/ui/recipe/badgeRecipe.d.ts +2 -2
  509. package/types/ui/recipe/buttonRecipe.d.ts +2 -2
  510. package/types/vendor/use-agentic/AgentAbort.d.ts +17 -0
  511. package/types/vendor/use-agentic/AgentProgress.d.ts +27 -0
  512. package/types/vendor/use-agentic/AgentProvider.d.ts +17 -0
  513. package/types/vendor/use-agentic/AgentScope.d.ts +9 -0
  514. package/types/vendor/use-agentic/AgentSession.d.ts +163 -0
  515. package/types/vendor/use-agentic/Agentic.d.ts +21 -0
  516. package/types/vendor/use-agentic/AgenticSurface.d.ts +58 -0
  517. package/types/vendor/use-agentic/Compaction.d.ts +48 -0
  518. package/types/vendor/use-agentic/ToolOutput.d.ts +21 -0
  519. package/types/vendor/use-agentic/Transcript.d.ts +18 -0
  520. package/types/vendor/use-agentic/httpRunner.d.ts +15 -0
  521. package/types/vendor/use-agentic/index.d.ts +19 -0
  522. package/types/vendor/use-agentic/sharedContext.d.ts +15 -0
  523. package/types/vendor/use-agentic/surfaceContext.d.ts +5 -0
  524. package/types/vendor/use-agentic/types.d.ts +182 -0
  525. package/types/vendor/use-agentic/useAgent.d.ts +4 -0
  526. package/types/vendor/use-agentic/useAgentGuide.d.ts +6 -0
  527. package/types/vendor/use-agentic/useAgentResource.d.ts +12 -0
  528. package/types/vendor/use-agentic/useAgentState.d.ts +16 -0
  529. package/types/vendor/use-agentic/useAgentTool.d.ts +16 -0
  530. package/types/vendor/use-agentic.d.ts +1 -0
  531. package/types/webkit/index.d.ts +4 -0
  532. package/types/webkit/useBodyScrollLock.d.ts +2 -0
  533. package/types/webkit/usePageTool.d.ts +19 -0
  534. package/types/webkit/useScreenScope.d.ts +25 -0
  535. package/ui/Agent/Approval.tsx +32 -0
  536. package/ui/Agent/Attach.tsx +77 -0
  537. package/ui/Agent/Bubble.tsx +192 -0
  538. package/ui/Agent/Chat.tsx +525 -0
  539. package/ui/Agent/ChatCommands.ts +141 -0
  540. package/ui/Agent/Composer.tsx +94 -0
  541. package/ui/Agent/Context.tsx +49 -0
  542. package/ui/Agent/Dock.tsx +77 -0
  543. package/ui/Agent/Guide.tsx +16 -0
  544. package/ui/Agent/History.tsx +49 -0
  545. package/ui/Agent/Launcher.tsx +60 -0
  546. package/ui/Agent/Markdown.tsx +142 -0
  547. package/ui/Agent/Menu.tsx +55 -0
  548. package/ui/Agent/Mic.tsx +27 -0
  549. package/ui/Agent/Question.tsx +63 -0
  550. package/ui/Agent/Section.tsx +24 -0
  551. package/ui/Agent/Skip.tsx +30 -0
  552. package/ui/Agent/StateKey.tsx +46 -0
  553. package/ui/Agent/Tool.tsx +59 -0
  554. package/ui/Agent/Transcript.tsx +33 -0
  555. package/ui/Agent/Zone.tsx +116 -0
  556. package/ui/Agent/agentSessionOf.ts +60 -0
  557. package/ui/Agent/attachment.ts +73 -0
  558. package/ui/Agent/fetchRunner.ts +44 -0
  559. package/ui/Agent/index.ts +27 -0
  560. package/ui/Agent/index_.tsx +4 -0
  561. package/ui/Agent/markdownBlocks.ts +137 -0
  562. package/ui/Agent/markdownSpans.tsx +49 -0
  563. package/ui/Agent/markdownTable.ts +54 -0
  564. package/ui/Agent/sessionHistory.ts +62 -0
  565. package/ui/Agent/sessionView.ts +38 -0
  566. package/ui/Agent/tokenCount.ts +10 -0
  567. package/ui/Agent/useChatAttachments.ts +84 -0
  568. package/ui/Agent/useChatVoice.ts +129 -0
  569. package/ui/Agent/useDraftRecall.ts +42 -0
  570. package/ui/Agent/useKeyboardInset.ts +26 -0
  571. package/ui/Agent/useSlashMenu.ts +58 -0
  572. package/ui/Agent/voice.ts +177 -0
  573. package/ui/Badge.tsx +1 -1
  574. package/ui/BottomSheet.tsx +32 -36
  575. package/ui/Button.tsx +3 -1
  576. package/ui/Clipboard.tsx +3 -6
  577. package/ui/Constant/Doc.tsx +265 -254
  578. package/ui/Constant/Graph.tsx +151 -0
  579. package/ui/Constant/index.ts +3 -2
  580. package/ui/Constant/schemaGraph.ts +232 -0
  581. package/ui/Data/CardList.tsx +14 -3
  582. package/ui/Data/Dashboard.tsx +70 -52
  583. package/ui/Data/Insight.tsx +18 -12
  584. package/ui/Data/Item.tsx +42 -56
  585. package/ui/Data/ListContainer.tsx +246 -132
  586. package/ui/Data/Pagination.tsx +10 -3
  587. package/ui/Data/QueryMaker.tsx +160 -11
  588. package/ui/Data/RefPicker.tsx +202 -0
  589. package/ui/Data/TableList.tsx +22 -13
  590. package/ui/Data/dataExport.ts +54 -0
  591. package/ui/Data/dataText.ts +22 -0
  592. package/ui/Data/index.ts +13 -1
  593. package/ui/Data/index_.tsx +1 -0
  594. package/ui/DatePicker.tsx +110 -128
  595. package/ui/Dialog/Close.tsx +3 -7
  596. package/ui/Dialog/LegacyModal.tsx +241 -0
  597. package/ui/Dialog/Modal.tsx +62 -195
  598. package/ui/Dialog/Provider.tsx +47 -3
  599. package/ui/Dialog/Trigger.tsx +3 -7
  600. package/ui/Dialog/context.ts +14 -2
  601. package/ui/Dialog/index.tsx +2 -0
  602. package/ui/DragAction.tsx +3 -2
  603. package/ui/DraggableList.tsx +9 -4
  604. package/ui/Dropdown.tsx +89 -27
  605. package/ui/Empty.tsx +6 -4
  606. package/ui/Field.tsx +128 -58
  607. package/ui/Input.tsx +27 -5
  608. package/ui/KeyboardAvoiding.tsx +2 -2
  609. package/ui/Layout/BottomTab.tsx +32 -37
  610. package/ui/Layout/Sider.tsx +37 -14
  611. package/ui/LegacyModal.tsx +53 -0
  612. package/ui/Link/CsrLink.tsx +1 -1
  613. package/ui/Load/Pagination.tsx +15 -8
  614. package/ui/Load/Units.tsx +30 -7
  615. package/ui/Load/View.tsx +10 -3
  616. package/ui/Loading/Area.tsx +7 -6
  617. package/ui/Loading/Button.tsx +7 -9
  618. package/ui/Loading/Input.tsx +7 -9
  619. package/ui/Loading/ProgressBar.tsx +16 -7
  620. package/ui/Loading/Skeleton.tsx +8 -13
  621. package/ui/Loading/Spin.tsx +20 -14
  622. package/ui/Menu.tsx +1 -1
  623. package/ui/Model/AdminPanel.tsx +52 -12
  624. package/ui/Model/EditModal.tsx +28 -6
  625. package/ui/Model/EditWrapper.tsx +16 -4
  626. package/ui/Model/New.tsx +4 -0
  627. package/ui/Model/NewWrapper.tsx +2 -0
  628. package/ui/Model/NewWrapper_Client.tsx +20 -6
  629. package/ui/Model/Remove.tsx +18 -6
  630. package/ui/Model/RemoveWrapper.tsx +12 -2
  631. package/ui/Model/SureToRemove.tsx +18 -6
  632. package/ui/Model/ViewEditModal.tsx +64 -15
  633. package/ui/Model/ViewModal.tsx +25 -11
  634. package/ui/Model/ViewWrapper.tsx +15 -4
  635. package/ui/Model/index_.tsx +1 -1
  636. package/ui/Pagination.tsx +51 -66
  637. package/ui/Popconfirm.tsx +88 -78
  638. package/ui/Radio.tsx +53 -24
  639. package/ui/RecentTime.tsx +83 -35
  640. package/ui/Reference/Collapse.tsx +26 -0
  641. package/ui/Reference/Panel.tsx +79 -0
  642. package/ui/Reference/Segmented.tsx +41 -0
  643. package/ui/Reference/Summary.tsx +25 -0
  644. package/ui/Reference/Toolbar.tsx +44 -0
  645. package/ui/Reference/dictText.ts +9 -0
  646. package/ui/Reference/index.ts +7 -0
  647. package/ui/Reference/style.ts +45 -0
  648. package/ui/ScreenNavigator.tsx +17 -2
  649. package/ui/Select.tsx +96 -57
  650. package/ui/Signal/Arg.tsx +83 -68
  651. package/ui/Signal/Doc.tsx +163 -129
  652. package/ui/Signal/Listener.tsx +40 -29
  653. package/ui/Signal/Message.tsx +87 -135
  654. package/ui/Signal/Object.tsx +79 -57
  655. package/ui/Signal/PubSub.tsx +72 -113
  656. package/ui/Signal/Request.tsx +2 -22
  657. package/ui/Signal/Response.tsx +19 -45
  658. package/ui/Signal/RestApi.tsx +170 -200
  659. package/ui/Signal/WebSocket.tsx +29 -26
  660. package/ui/Signal/endpointEntries.ts +59 -0
  661. package/ui/Signal/makeExample.ts +10 -3
  662. package/ui/Signal/style.ts +34 -29
  663. package/ui/Switch.tsx +4 -0
  664. package/ui/System/CSR.tsx +1 -1
  665. package/ui/System/Client.tsx +31 -15
  666. package/ui/System/Common.tsx +3 -4
  667. package/ui/System/DevModeToggle.tsx +1 -1
  668. package/ui/System/Gtag.tsx +2 -2
  669. package/ui/System/Messages.tsx +52 -31
  670. package/ui/System/Reconnect.tsx +22 -56
  671. package/ui/System/SelectLanguage.tsx +24 -15
  672. package/ui/System/ThemeToggle.tsx +25 -13
  673. package/ui/Tab/Menu.tsx +24 -12
  674. package/ui/Tab/Menus.tsx +6 -3
  675. package/ui/Tab/Provider.tsx +30 -3
  676. package/ui/Tab/context.ts +8 -4
  677. package/ui/Table.tsx +66 -60
  678. package/ui/ToggleSelect.tsx +8 -7
  679. package/ui/Tooltip.tsx +15 -1
  680. package/ui/UiOverride/context.ts +21 -2
  681. package/ui/Unauthorized.tsx +6 -4
  682. package/ui/agentAttrs.ts +19 -0
  683. package/ui/index.ts +49 -1
  684. package/ui/overlayLayer.ts +12 -2
  685. package/ui/overlayPosition.ts +104 -0
  686. package/ui/recipe/buttonRecipe.ts +2 -2
  687. package/ui/styles.css +31 -0
  688. package/vendor/use-agentic/AgentAbort.ts +29 -0
  689. package/vendor/use-agentic/AgentProgress.ts +40 -0
  690. package/vendor/use-agentic/AgentProvider.tsx +39 -0
  691. package/vendor/use-agentic/AgentScope.tsx +20 -0
  692. package/vendor/use-agentic/AgentSession.ts +750 -0
  693. package/vendor/use-agentic/Agentic.tsx +44 -0
  694. package/vendor/use-agentic/AgenticSurface.ts +333 -0
  695. package/vendor/use-agentic/Compaction.ts +120 -0
  696. package/vendor/use-agentic/ToolOutput.ts +60 -0
  697. package/vendor/use-agentic/Transcript.ts +50 -0
  698. package/vendor/use-agentic/WIRE.md +86 -0
  699. package/vendor/use-agentic/httpRunner.ts +131 -0
  700. package/vendor/use-agentic/index.ts +20 -0
  701. package/vendor/use-agentic/sharedContext.ts +25 -0
  702. package/vendor/use-agentic/surfaceContext.ts +10 -0
  703. package/vendor/use-agentic/types.ts +192 -0
  704. package/vendor/use-agentic/useAgent.ts +18 -0
  705. package/vendor/use-agentic/useAgentGuide.ts +16 -0
  706. package/vendor/use-agentic/useAgentResource.ts +36 -0
  707. package/vendor/use-agentic/useAgentState.ts +64 -0
  708. package/vendor/use-agentic/useAgentTool.ts +55 -0
  709. package/webkit/bootCsr.tsx +10 -8
  710. package/webkit/index.ts +4 -0
  711. package/webkit/lazy.tsx +5 -1
  712. package/webkit/useBodyScrollLock.tsx +29 -0
  713. package/webkit/useFrameRuntime.ts +1 -1
  714. package/webkit/usePageTool.tsx +37 -0
  715. package/webkit/useScreenScope.tsx +60 -0
  716. package/types/ui/Constant/Mermaid.d.ts +0 -8
  717. package/types/ui/Signal/Collapse.d.ts +0 -12
  718. package/ui/Constant/Mermaid.tsx +0 -149
  719. package/ui/Signal/Collapse.tsx +0 -29
@@ -1,36 +1,41 @@
1
- "use client";
2
- import { badgeRecipe } from "../Badge";
1
+ import { docPill, type Tone } from "../Reference";
3
2
 
4
3
  export const signalUi = {
5
- sectionTitle: "font-extrabold text-lg",
6
- sectionDescription: "text-foreground/70 text-sm",
7
- sectionPanel: "rounded-xl bg-background p-3",
8
- tablePanel: "overflow-x-auto rounded-xl bg-background p-3",
9
-
10
- tableClass:
11
- "w-full text-left text-sm [&_th]:px-3 [&_th]:py-2 [&_th]:font-medium [&_th]:text-foreground/60 [&_td]:px-3 [&_td]:py-2 [&_tbody_tr]:border-border [&_tbody_tr]:border-t",
12
4
  inputRow: "flex w-full flex-col gap-2 py-2 md:flex-row md:items-center",
13
- inputLabel: "w-full font-semibold text-foreground/70 text-sm md:w-36",
14
- codePanel:
15
- "min-h-[300px] w-full rounded-xl border border-border bg-background p-4 font-normal text-foreground text-sm",
5
+ inputLabel: "w-full shrink-0 font-mono text-foreground/70 text-sm md:w-40",
16
6
  };
17
7
 
18
- export const getEndpointBadgeClassName = (type: string) =>
19
- badgeRecipe({ variant: type === "query" || type === "pubsub" ? "primary" : "secondary" });
8
+ /** The REST convention rather than a palette choice: reads are blue, writes are green. */
9
+ const methodTone: { [key: string]: Tone } = {
10
+ query: "info",
11
+ prompt: "info",
12
+ message: "info",
13
+ mutation: "success",
14
+ pubsub: "warning",
15
+ };
16
+
17
+ /** Only a mutation is a POST — enumerating that side leaves a `prompt` a GET beside the queries, and lets a
18
+ * read-shaped type added later inherit the right verb rather than be mislabelled. */
19
+ export const getMethodLabel = (type: string) => (type === "mutation" ? "POST" : type === "query" ? "GET" : type);
20
+
21
+ export const getMethodBadgeClassName = (type: string) =>
22
+ docPill(methodTone[type] ?? "muted", "w-16 justify-center uppercase");
23
+
24
+ export const getWsBadgeClassName = (type: string) => docPill(methodTone[type] ?? "muted", "uppercase");
20
25
 
21
26
  export const getGuardBadgeClassName = (guard: string) =>
22
- badgeRecipe({ variant: guard === "Public" ? "primary" : guard === "None" ? "default" : "secondary" });
23
-
24
- export const getStatusBadgeClassName = (status: string) =>
25
- badgeRecipe({
26
- variant: status === "error" ? "error" : status === "success" || status === "listening" ? "primary" : "outline",
27
- });
28
-
29
- export const getStatusTextareaClassName = (status: string) =>
30
- status === "error"
31
- ? "border-destructive text-destructive"
32
- : status === "success" || status === "listening"
33
- ? "border-primary"
34
- : status === "loading"
35
- ? "pointer-events-none opacity-50"
36
- : "";
27
+ docPill(guard === "Public" ? "warning" : guard === "None" ? "muted" : "info");
28
+
29
+ /** Published to agents is quiet; refused is amber, because it is a thing to go fix. */
30
+ export const getMcpBadgeClassName = (exposed: boolean) => docPill(exposed ? "success" : "warning");
31
+
32
+ const statusTone: { [key: string]: Tone } = {
33
+ error: "error",
34
+ success: "success",
35
+ listening: "success",
36
+ loading: "info",
37
+ };
38
+
39
+ export const getStatusTone = (status: string): Tone => statusTone[status] ?? "muted";
40
+
41
+ export const getStatusBadgeClassName = (status: string) => docPill(getStatusTone(status), "uppercase");
package/ui/Switch.tsx CHANGED
@@ -1,6 +1,8 @@
1
1
  "use client";
2
2
  import { cn } from "akanjs/client";
3
+ import { useFieldTool } from "akanjs/store";
3
4
  import { useState } from "react";
5
+ import { agentAttrs } from "./agentAttrs";
4
6
 
5
7
  export interface SwitchProps {
6
8
  checked?: boolean;
@@ -30,12 +32,14 @@ export const Switch = ({
30
32
  className,
31
33
  variant = "primary",
32
34
  }: SwitchProps) => {
35
+ useFieldTool(onChange, { disabled });
33
36
  const [internal, setInternal] = useState(defaultChecked ?? false);
34
37
  const isControlled = checked !== undefined;
35
38
  const isChecked = isControlled ? checked : internal;
36
39
  const state = isChecked ? "checked" : "unchecked";
37
40
  return (
38
41
  <button
42
+ {...agentAttrs(onChange)}
39
43
  type="button"
40
44
  role="switch"
41
45
  aria-checked={isChecked}
package/ui/System/CSR.tsx CHANGED
@@ -125,7 +125,7 @@ const CSRWrapper = ({
125
125
  bottomSafeArea,
126
126
  pathRoutes,
127
127
  } = useCsr();
128
- const csrLoaded = st.use.csrLoaded();
128
+ const csrLoaded = st.use.csrLoaded({ agent: false });
129
129
  const { router: reactRouter } = useCsr();
130
130
  useEffect(() => {
131
131
  debugFrame("csrWrapper.mount", { appName, layoutStyle, pathCount: pathRoutes.length });
@@ -7,6 +7,7 @@ import {
7
7
  debugFrame,
8
8
  defaultPageState,
9
9
  fetch,
10
+ getCookie,
10
11
  getPathInfo,
11
12
  initAuth,
12
13
  type Location,
@@ -196,7 +197,7 @@ export const ClientPathWrapper = ({
196
197
  };
197
198
 
198
199
  interface ClientBridgeProps {
199
- env: ClientEnv;
200
+ env?: object;
200
201
  lang?: string;
201
202
  theme?: AkanTheme;
202
203
  prefix?: string;
@@ -205,11 +206,15 @@ interface ClientBridgeProps {
205
206
  }
206
207
 
207
208
  export const ClientBridge = ({ env, lang, theme, prefix, gaTrackingId, wsConnect = true }: ClientBridgeProps) => {
208
- (globalThis as typeof globalThis & { __AKAN_CLIENT_ENV__?: ClientEnv }).__AKAN_CLIENT_ENV__ = env;
209
- const uiOperation = st.use.uiOperation();
210
- const pathname = st.use.pathname();
211
- const params = st.use.params();
212
- const searchParams = st.use.searchParams();
209
+
210
+ (globalThis as typeof globalThis & { __AKAN_CLIENT_ENV__?: ClientEnv }).__AKAN_CLIENT_ENV__ = {
211
+ ...getEnv(),
212
+ ...env,
213
+ };
214
+ const uiOperation = st.use.uiOperation({ agent: false });
215
+ const pathname = st.use.pathname({ agent: false });
216
+ const params = st.use.params({ agent: false });
217
+ const searchParams = st.use.searchParams({ agent: false });
213
218
  const language = (params.lang as string | undefined) ?? lang;
214
219
  const path = `/${pathname.split("/").slice(2).join("/")}`;
215
220
 
@@ -230,9 +235,16 @@ export const ClientBridge = ({ env, lang, theme, prefix, gaTrackingId, wsConnect
230
235
  (fetch.instance as { connect: () => void }).connect();
231
236
  }, [wsConnect]);
232
237
 
238
+ useLayoutEffect(() => {
239
+ restoreDocumentTheme(theme);
240
+ }, [theme, pathname]);
241
+
233
242
  useEffect(() => {
234
- if (getThemeCookie() !== undefined) return;
235
- applyThemePolicy(theme ?? "system");
243
+ const onPageShow = (event: PageTransitionEvent) => {
244
+ if (event.persisted) restoreDocumentTheme(theme);
245
+ };
246
+ window.addEventListener("pageshow", onPageShow);
247
+ return () => window.removeEventListener("pageshow", onPageShow);
236
248
  }, [theme]);
237
249
 
238
250
  useEffect(() => {
@@ -257,17 +269,21 @@ export const ClientBridge = ({ env, lang, theme, prefix, gaTrackingId, wsConnect
257
269
 
258
270
  useEffect(() => {
259
271
  setCookie("path", path);
260
- Logger.log(`pathChange-finished:${path}`);
272
+ Logger.info(`pathChange-finished:${path}`);
261
273
  }, [pathname]);
262
274
  return gaTrackingId && <Gtag trackingId={gaTrackingId} />;
263
275
  };
264
276
  Client.Bridge = ClientBridge;
265
277
 
266
- function getThemeCookie(): string | undefined {
267
- return document.cookie
268
- .split(";")
269
- .find((cookie) => cookie.trim().startsWith("theme="))
270
- ?.split("=")[1];
278
+ function restoreDocumentTheme(layoutTheme: AkanTheme | undefined): void {
279
+ const cookieTheme = getCookie("theme");
280
+
281
+ if (cookieTheme) {
282
+ document.documentElement.setAttribute("data-theme", cookieTheme);
283
+ st.do.setTheme(cookieTheme);
284
+ return;
285
+ }
286
+ applyThemePolicy(layoutTheme ?? "system");
271
287
  }
272
288
 
273
289
  function applyThemePolicy(theme: AkanTheme): void {
@@ -294,7 +310,7 @@ function buildSearchParams(entries: Iterable<[string, string]>): Record<string,
294
310
  }
295
311
 
296
312
  export const ClientInner = () => {
297
- const uiOperation = st.use.uiOperation();
313
+ const uiOperation = st.use.uiOperation({ agent: false });
298
314
  return (
299
315
  <>
300
316
  <div key="modal-root" id="modal-root" />
@@ -1,6 +1,5 @@
1
1
  import "dayjs/locale/ko";
2
2
 
3
- import type { ClientEnv } from "akanjs/base";
4
3
  import type { RootLayoutProps, WebAppManifest } from "akanjs/client";
5
4
  import type { AkanTheme } from "akanjs/fetch";
6
5
  import type { ReactNode } from "react";
@@ -16,8 +15,8 @@ export interface ProviderProps {
16
15
  head?: ReactNode;
17
16
  /** Web app manifest emitted as a data URL. */
18
17
  manifest?: WebAppManifest;
19
- /** Client runtime environment injected into the app bridge. */
20
- env: ClientEnv;
18
+ /** App-specific public client config (`env/env.client.ts`) merged over the framework's own `getEnv()`. */
19
+ env?: object;
21
20
  /** Initial Akan theme configuration. */
22
21
  theme?: AkanTheme;
23
22
  /** Optional route prefix/base path. */
@@ -45,7 +44,7 @@ export interface ProviderProps {
45
44
  }
46
45
 
47
46
  export const Common = () => {
48
- return <></>;
47
+ return null;
49
48
  };
50
49
 
51
50
  export function ManifestLink({ manifest }: { manifest?: WebAppManifest }) {
@@ -4,7 +4,7 @@ import { st } from "akanjs/store";
4
4
  import { Switch } from "../Switch";
5
5
 
6
6
  export const DevModeToggle = () => {
7
- const devMode = st.use.devMode();
7
+ const devMode = st.use.devMode({ agent: false });
8
8
  return (
9
9
  <div className="flex cursor-pointer items-center">
10
10
  <span className="mr-2 whitespace-nowrap text-sm">Dev Mode</span>
@@ -8,8 +8,8 @@ declare const window: {
8
8
  };
9
9
 
10
10
  export const Gtag = ({ trackingId, debugMode = false }: { trackingId: string; debugMode?: boolean }) => {
11
- const pathname = st.use.pathname();
12
- const searchParams = st.use.searchParams();
11
+ const pathname = st.use.pathname({ agent: false });
12
+ const searchParams = st.use.searchParams({ agent: false });
13
13
 
14
14
  const pageview = (url: string) => {
15
15
  window.gtag?.("config", trackingId, { page_path: url });
@@ -2,13 +2,15 @@
2
2
  import { cn, msg, usePage } from "akanjs/client";
3
3
  import { st } from "akanjs/store";
4
4
  import { type ReactNode, useEffect, useState } from "react";
5
+ import { createPortal } from "react-dom";
5
6
  import {
6
7
  AiOutlineCheckCircle,
8
+ AiOutlineClose,
9
+ AiOutlineExclamationCircle,
7
10
  AiOutlineInfoCircle,
8
11
  AiOutlineLoading3Quarters,
9
- AiOutlineQuestionCircle,
12
+ AiOutlineWarning,
10
13
  } from "react-icons/ai";
11
- import { BsExclamationCircleFill } from "react-icons/bs";
12
14
 
13
15
  type MessageType = "success" | "error" | "info" | "warning" | "loading";
14
16
 
@@ -29,10 +31,25 @@ interface MsgOption {
29
31
  data?: Record<string, string | number>;
30
32
  }
31
33
 
34
+ const messageTone: { [key in MessageType]: { card: string; chip: string; icon: ReactNode } } = {
35
+ info: { card: "border-info/35", chip: "bg-info/15 text-info", icon: <AiOutlineInfoCircle /> },
36
+ success: { card: "border-success/35", chip: "bg-success/15 text-success", icon: <AiOutlineCheckCircle /> },
37
+ warning: { card: "border-warning/35", chip: "bg-warning/15 text-warning", icon: <AiOutlineWarning /> },
38
+ error: {
39
+ card: "border-destructive/35",
40
+ chip: "bg-destructive/15 text-destructive",
41
+ icon: <AiOutlineExclamationCircle />,
42
+ },
43
+ loading: {
44
+ card: "border-border",
45
+ chip: "bg-muted text-foreground/60",
46
+ icon: <AiOutlineLoading3Quarters className="animate-spin" />,
47
+ },
48
+ };
49
+
32
50
  let timeOuts: TimeOutType[] = [];
33
51
 
34
52
  const Message = ({ content, type = "info" as MessageType, duration, keyForMessage }: MessageProps) => {
35
- const pageState = st.use.pageState();
36
53
  const [preBlind, setPreBlind] = useState(false);
37
54
  useEffect(() => {
38
55
  if (!content) return;
@@ -70,45 +87,46 @@ const Message = ({ content, type = "info" as MessageType, duration, keyForMessag
70
87
  timeOuts = timeOuts.filter((item) => item.key !== key);
71
88
  };
72
89
 
73
- const iconClassName = type === "loading" ? "text-info" : `text-${type}`;
74
- const getIcon = (type: MessageType) => {
75
- const icons: { [key in MessageType]: ReactNode } = {
76
- info: <AiOutlineInfoCircle className={cn("text-2xl", iconClassName)} />,
77
- success: <AiOutlineCheckCircle className={cn("text-2xl", iconClassName)} />,
78
- error: <BsExclamationCircleFill className={cn("text-2xl", iconClassName)} />,
79
- warning: <AiOutlineQuestionCircle className={cn("text-2xl", iconClassName)} />,
80
- loading: <AiOutlineLoading3Quarters className={cn("animate-spin text-2xl", iconClassName)} />,
81
- };
82
- return icons[type];
83
- };
84
-
90
+ const tone = messageTone[type];
85
91
  return (
86
92
  <div
87
93
  data-state={preBlind}
88
- className="group w-screen animate-zoomIn px-6 duration-300 data-[state=true]:animate-smaller md:max-w-[60%]"
89
- style={{
90
- paddingTop: pageState.topSafeArea,
91
- }}
94
+ className="pointer-events-auto w-full animate-fadeInDown15-150ms data-[state=true]:animate-smaller"
92
95
  >
93
96
  <div
94
97
  className={cn(
95
- "typo-body1 flex w-full items-center gap-2 rounded-[4px] border px-4 py-2 text-foreground drop-shadow-lg",
96
- (type === "loading" || type === "info") && "border-border bg-primary-foreground stroke-foreground",
97
- type === "success" && "border-success-border bg-success/80 stroke-success",
98
- type === "error" && "border-destructive-border bg-destructive/80 stroke-destructive",
99
- type === "warning" && "border-warning-border bg-warning/80 stroke-warning",
98
+ "flex w-full items-start gap-3 rounded-box border bg-popover/95 p-3 text-popover-foreground shadow-lg backdrop-blur-sm",
99
+ tone.card,
100
100
  )}
101
101
  >
102
- <div className="flex size-6 items-center justify-center rounded-full bg-background">{getIcon(type)}</div>
103
- <span className="truncate whitespace-nowrap text-background">{content}</span>
102
+ <div className={cn("flex size-7 shrink-0 items-center justify-center rounded-full text-base", tone.chip)}>
103
+ {tone.icon}
104
+ </div>
105
+ <span className="min-w-0 flex-1 self-center break-words text-sm leading-snug">{content}</span>
106
+ <button
107
+ aria-label="Dismiss"
108
+ className="-mr-1 shrink-0 self-center rounded-full p-1 text-foreground/30 transition-colors hover:text-foreground/70"
109
+ onClick={() => {
110
+ setPreBlind(true);
111
+ }}
112
+ type="button"
113
+ >
114
+ <AiOutlineClose className="text-sm" />
115
+ </button>
104
116
  </div>
105
117
  </div>
106
118
  );
107
119
  };
108
120
 
109
121
  export const Messages = () => {
110
- const messages = st.use.messages();
122
+ const messages = st.use.messages({ agent: false });
123
+ const pageState = st.use.pageState({ agent: false });
111
124
  const { l } = usePage();
125
+ const [portalElement, setPortalElement] = useState<HTMLElement | null>(null);
126
+ useEffect(() => {
127
+ if (typeof document === "undefined") return;
128
+ setPortalElement(document.body);
129
+ }, []);
112
130
  useEffect(() => {
113
131
  Object.assign(msg, {
114
132
  info: (msgKey: `${string}.${string}`, option = {} as MsgOption) => {
@@ -153,11 +171,13 @@ export const Messages = () => {
153
171
  },
154
172
  });
155
173
  }, []);
156
- if (!messages.length) return null;
157
- return (
174
+ if (!messages.length || !portalElement) return null;
175
+
176
+ return createPortal(
158
177
  <div
159
178
  id="toast"
160
- className="fixed top-0 left-0 z-[100] mt-[var(--safe-area-top)] flex h-fit w-screen flex-col items-center justify-start gap-2 pt-2"
179
+ className="pointer-events-none fixed top-0 left-1/2 z-[100] flex h-fit w-full max-w-md -translate-x-1/2 flex-col items-center gap-2 px-4 pt-3"
180
+ style={{ marginTop: pageState.topSafeArea }}
161
181
  >
162
182
  {messages.map((message) => (
163
183
  <Message
@@ -168,6 +188,7 @@ export const Messages = () => {
168
188
  keyForMessage={message.key}
169
189
  />
170
190
  ))}
171
- </div>
191
+ </div>,
192
+ portalElement,
172
193
  );
173
194
  };
@@ -82,73 +82,39 @@ export const Reconnect = () => {
82
82
  if (process.env.AKAN_PUBLIC_ENV !== "local") return null;
83
83
  if (connectStatus === "initial" || connectStatus === "normal") return null;
84
84
  return (
85
- <div className="fixed top-0 left-0 flex h-screen w-screen animate-fadeIn flex-col items-center justify-center bg-background/50">
86
- <div className="flex w-4/5 flex-col items-center justify-center rounded-md bg-border p-5 md:w-1/3">
87
- <div className="whitespace-nowrap font-bold text-3xl">
85
+ <div className="fixed inset-0 z-[200] flex animate-fadeIn flex-col items-center justify-center bg-background/80 backdrop-blur-sm">
86
+ <div className="flex w-[min(90vw,26rem)] flex-col items-center gap-4 rounded-box border border-border bg-card p-8 text-center text-card-foreground shadow-2xl">
87
+ <div
88
+ className={cn(
89
+ "flex size-20 items-center justify-center rounded-full text-4xl",
90
+ connectStatus === "connected" ? "bg-success/15 text-success" : "bg-muted text-foreground/40",
91
+ connectStatus === "connecting" && "animate-pulse",
92
+ )}
93
+ >
94
+ {connectStatus === "connected" ? <TbPlugConnected /> : <TbPlugConnectedX />}
95
+ </div>
96
+ <div className="font-bold text-2xl leading-snug">
88
97
  {connectStatus === "disconnected"
89
98
  ? l("base.somethingWrong")
90
99
  : connectStatus === "connecting"
91
100
  ? l("base.connecting")
92
101
  : l("base.connected")}
93
102
  </div>
94
- <div className="flex flex-col items-center justify-center">
95
- <div className="py-5">
96
- {connectStatus === "disconnected" ? (
97
- <div className="text-[150px] text-muted-foreground">
98
- <TbPlugConnectedX />
99
- </div>
100
- ) : connectStatus === "connecting" ? (
101
- <div className="animate-pulse py-5 text-[150px] text-muted-foreground">
102
- <TbPlugConnectedX />
103
- </div>
104
- ) : (
105
- <div className="animate-pop text-[150px] text-white">
106
- <TbPlugConnected />
107
- </div>
108
- )}
109
- </div>
110
-
103
+ <div className="text-foreground/70 text-sm">
111
104
  {connectStatus === "connected" ? (
112
- <>
113
- <div className="animate-pop"></div>
114
- <span>
115
- <span className="text-lg">{l("base.refreshing")}</span>
116
- </span>
117
- </>
105
+ l("base.refreshing")
118
106
  ) : connectStatus === "connecting" ? (
119
- <div className="flex items-center justify-center">
120
- <div className="text-lg">{l("base.tryReconnecting")}</div>
121
- <div className="flex items-center">
122
- {Array.from({ length: DOTS_LENGTH }).map((_, index) =>
123
- dots >= index ? (
124
- <div key={index} className="visible">
125
- .
126
- </div>
127
- ) : (
128
- <div key={index} className="invisible">
129
- .
130
- </div>
131
- ),
132
- )}
133
- </div>
134
- </div>
107
+ <span>
108
+ {l("base.tryReconnecting")}
109
+ {".".repeat(dots + 1)}
110
+ </span>
135
111
  ) : (
136
- <div className="text-lg">{l("base.serverDisconnected")}</div>
112
+ l("base.serverDisconnected")
137
113
  )}
138
114
  </div>
139
-
140
- <div
141
- className={cn(
142
- "mt-2 text-center text-muted-foreground text-sm leading-tight",
143
- connectStatus === "disconnected" || connectStatus === "connecting" ? "visible" : "invisible",
144
- )}
145
- >
146
- <div className="flex items-center justify-center gap-2">
147
- <div className="flex flex-col items-center justify-center">
148
- <div>{l("base.serverHasProblem")}</div>
149
- <div className="font-bold">{l("base.checkServerStatus")}</div>
150
- </div>
151
- </div>
115
+ <div className={cn("text-muted-foreground text-sm leading-snug", connectStatus === "connected" && "invisible")}>
116
+ <div>{l("base.serverHasProblem")}</div>
117
+ <div className="font-bold">{l("base.checkServerStatus")}</div>
152
118
  </div>
153
119
  </div>
154
120
  </div>
@@ -1,7 +1,9 @@
1
1
  "use client";
2
2
  import { router, usePage } from "akanjs/client";
3
3
  import { parseAkanI18nEnv } from "akanjs/common";
4
+ import { st } from "akanjs/store";
4
5
 
6
+ import { agentAttrs } from "../agentAttrs";
5
7
  import { buttonRecipe } from "../Button";
6
8
  import { Dropdown } from "../Dropdown";
7
9
 
@@ -18,26 +20,33 @@ export interface SelectLanguageProps {
18
20
  }
19
21
  export const SelectLanguage = ({ className, languages = parseAkanI18nEnv().locales }: SelectLanguageProps) => {
20
22
  const { lang } = usePage();
23
+ const offered = languages.filter((lang) => !!languageNames[lang as keyof typeof languageNames]);
24
+ const setLanguage = st
25
+ .tool("setLanguage")
26
+ .desc("Show the site in another language.")
27
+ .arg("language", String, { oneOf: offered })
28
+ .exec((language) => {
29
+ router.setLang(language);
30
+ });
21
31
  return (
22
32
  <Dropdown
23
33
  className={className}
24
34
  buttonClassName="mx-2 my-auto h-8 min-h-0 border-none px-3 font-medium text-xs md:mx-4"
25
35
  value={languageNames[lang as keyof typeof languageNames]}
26
- content={languages
27
- .filter((lang) => !!languageNames[lang as keyof typeof languageNames])
28
- .map((lang) => (
29
- <li key={lang}>
30
- <button
31
- type="button"
32
- className={buttonRecipe({ variant: "ghost", size: "sm" }, "w-full justify-start")}
33
- onClick={() => {
34
- router.setLang(lang);
35
- }}
36
- >
37
- {languageNames[lang as keyof typeof languageNames]}
38
- </button>
39
- </li>
40
- ))}
36
+ content={offered.map((lang) => (
37
+ <li key={lang}>
38
+ <button
39
+ type="button"
40
+ className={buttonRecipe({ variant: "ghost", size: "sm" }, "w-full justify-start")}
41
+ onClick={() => {
42
+ void setLanguage(lang);
43
+ }}
44
+ {...agentAttrs(setLanguage)}
45
+ >
46
+ {languageNames[lang as keyof typeof languageNames]}
47
+ </button>
48
+ </li>
49
+ ))}
41
50
  />
42
51
  );
43
52
  };
@@ -1,8 +1,8 @@
1
1
  "use client";
2
2
 
3
- import { setCookie } from "akanjs/client";
4
- import { useCallback, useEffect, useState } from "react";
5
-
3
+ import { getCookie, setCookie } from "akanjs/client";
4
+ import { st } from "akanjs/store";
5
+ import { useLayoutEffect } from "react";
6
6
  import { buttonRecipe } from "../Button";
7
7
  import { Dropdown } from "../Dropdown";
8
8
  import { Switch } from "../Switch";
@@ -10,20 +10,32 @@ import { Switch } from "../Switch";
10
10
  export interface ThemeToggleProps {
11
11
  themes?: string[];
12
12
  }
13
-
14
13
  export const ThemeToggle = ({ themes }: ThemeToggleProps) => {
15
- const [theme, setTheme] = useState<string | undefined>(undefined);
16
- useEffect(() => {
14
+ const theme = st.use.theme();
15
+ const applyTheme = st
16
+ .tool("applyTheme")
17
+ .desc(`Switch this page's color theme. One of: ${themes?.join(", ") ?? "none"}.`)
18
+ .arg("theme", String)
19
+ .exec((theme) => {
20
+ document.documentElement.setAttribute("data-theme", theme);
21
+ setCookie("theme", theme);
22
+ st.do.setTheme(theme);
23
+ });
24
+ useLayoutEffect(() => {
17
25
  if (!themes) return;
18
- const currentTheme = document.documentElement.getAttribute("data-theme");
19
- setTheme(currentTheme && themes.includes(currentTheme) ? currentTheme : themes[0]);
26
+ const cookieTheme = getCookie("theme");
27
+ const documentTheme = document.documentElement.getAttribute("data-theme");
28
+
29
+ const next =
30
+ cookieTheme && themes.includes(cookieTheme)
31
+ ? cookieTheme
32
+ : documentTheme && themes.includes(documentTheme)
33
+ ? documentTheme
34
+ : themes[0];
35
+ document.documentElement.setAttribute("data-theme", next);
36
+ st.do.setTheme(next);
20
37
  }, [themes]);
21
38
 
22
- const applyTheme = useCallback((theme: string) => {
23
- document.documentElement.setAttribute("data-theme", theme);
24
- setCookie("theme", theme);
25
- setTheme(theme);
26
- }, []);
27
39
  if (!themes || themes.length <= 1) return null;
28
40
  if (themes.length === 2)
29
41
  return (