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
package/ui/RecentTime.tsx CHANGED
@@ -5,6 +5,21 @@ import relativeTime from "dayjs/plugin/relativeTime";
5
5
  import { Tooltip } from "./Tooltip";
6
6
 
7
7
  dayjs.extend(relativeTime);
8
+
9
+ export type RecentTimeRelativeUnit = "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
10
+ export type RecentTimeRelativeStyle = "fromNow" | "always" | "auto";
11
+
12
+ export interface RecentTimeRelative {
13
+ unit: RecentTimeRelativeUnit;
14
+ /** Signed count in `unit`. Negative is past, positive is future, `0` is now. */
15
+ count: number;
16
+ date: Dayjs;
17
+ now: Dayjs;
18
+ defaultLabel: string;
19
+ }
20
+
21
+ export type RecentTimeRelativeFormat = RecentTimeRelativeStyle | ((relative: RecentTimeRelative) => string);
22
+
8
23
  export interface RecentTimeProps {
9
24
  /** Date value to render. Null renders nothing, and epoch placeholder values render --:--. */
10
25
  date: Date | Dayjs | null;
@@ -12,16 +27,76 @@ export interface RecentTimeProps {
12
27
  breakUnit?: Intl.RelativeTimeFormatUnit;
13
28
  /** Use compact automatic formatting or always include date and time. */
14
29
  format?: "full" | "auto";
30
+ /**
31
+ * Relative phrasing. `"fromNow"` (default) keeps dayjs locale strings (`하루 전`).
32
+ * `"always"` / `"auto"` use `Intl.RelativeTimeFormat` — `1일 전` vs `어제`.
33
+ * A function replaces the relative label; return `defaultLabel` to keep the default.
34
+ */
35
+ relative?: RecentTimeRelativeFormat;
15
36
  /** Additional classes for the trigger span. */
16
37
  className?: string;
17
38
  }
18
39
 
19
- export const RecentTime = ({ date, breakUnit, format = "auto", className }: RecentTimeProps) => {
40
+ const resolveRecentTimeUnit = (date: Dayjs, now: Dayjs): Pick<RecentTimeRelative, "unit" | "count"> => {
41
+ const ms = date.valueOf() - now.valueOf();
42
+ if (ms === 0) return { unit: "second", count: 0 };
43
+ const sign = ms > 0 ? 1 : -1;
44
+ if (date.isSame(now, "day")) {
45
+ const secs = Math.abs(now.diff(date, "second"));
46
+ if (secs < 60) return { unit: "second", count: sign * secs };
47
+ const mins = Math.abs(now.diff(date, "minute"));
48
+ if (mins < 60) return { unit: "minute", count: sign * mins };
49
+ return { unit: "hour", count: sign * Math.abs(now.diff(date, "hour")) };
50
+ }
51
+ const days = Math.abs(now.startOf("day").diff(date.startOf("day"), "day"));
52
+ if (days < 7) return { unit: "day", count: sign * days };
53
+ const months = Math.abs(now.startOf("month").diff(date.startOf("month"), "month"));
54
+ if (months < 1) return { unit: "week", count: sign * Math.max(1, Math.floor(days / 7)) };
55
+ if (months < 12) return { unit: "month", count: sign * months };
56
+ return { unit: "year", count: sign * Math.max(1, Math.abs(now.startOf("year").diff(date.startOf("year"), "year"))) };
57
+ };
58
+
59
+ const formatRelativeLabel = (date: Dayjs, now: Dayjs, lang: string, relative: RecentTimeRelativeFormat) => {
60
+ const defaultLabel = date.fromNow();
61
+ if (relative === "fromNow") return defaultLabel;
62
+ const { unit, count } = resolveRecentTimeUnit(date, now);
63
+ if (typeof relative === "function") return relative({ unit, count, date, now, defaultLabel });
64
+ if (count === 0) return new Intl.RelativeTimeFormat(lang, { numeric: "auto" }).format(0, "second");
65
+ return new Intl.RelativeTimeFormat(lang, { numeric: relative }).format(count, unit);
66
+ };
67
+
68
+ const isRelativeDisplay = (diffMs: number, breakUnit?: Intl.RelativeTimeFormatUnit) => {
69
+ const elapsed = {
70
+ second: Math.abs(Math.floor(diffMs / 1000)),
71
+ minute: Math.abs(Math.floor(diffMs / (1000 * 60))),
72
+ hour: Math.abs(Math.floor(diffMs / (1000 * 3600))),
73
+ day: Math.abs(Math.floor(diffMs / (1000 * 3600 * 24))),
74
+ week: Math.abs(Math.floor(diffMs / (1000 * 3600 * 24 * 7))),
75
+ month: Math.abs(Math.floor(diffMs / (1000 * 3600 * 24 * 30))),
76
+ };
77
+ if (breakUnit === "second") return false;
78
+ if (elapsed.second < 60) return true;
79
+ if (breakUnit === "minute") return false;
80
+ if (elapsed.minute < 60) return true;
81
+ if (breakUnit === "hour") return false;
82
+ if (elapsed.hour < 24) return true;
83
+ if (breakUnit === "day") return false;
84
+ if (elapsed.day < 7) return true;
85
+ if (breakUnit === "week") return false;
86
+ if (elapsed.week < 4) return true;
87
+ if (breakUnit === "month") return false;
88
+ if (elapsed.month < 12) return true;
89
+ if (breakUnit === "year") return false;
90
+ return true;
91
+ };
92
+
93
+ export const RecentTime = ({ date, breakUnit, format = "auto", relative = "fromNow", className }: RecentTimeProps) => {
20
94
  const { lang } = usePage();
95
+ if (!date) return null;
96
+ if (dayjs(0).isSame(date) || dayjs(-1).isSame(date)) return <span>--:--</span>;
97
+
21
98
  const now = dayjs();
22
- const datejs = dayjs(date);
23
- datejs.locale(lang);
24
- const diff = dayjs().diff(datejs);
99
+ const datejs = dayjs(date).locale(lang);
25
100
  const dateFormat =
26
101
  format === "full"
27
102
  ? "YY-MM-DD HH:mm"
@@ -30,37 +105,10 @@ export const RecentTime = ({ date, breakUnit, format = "auto", className }: Rece
30
105
  : now.month() !== datejs.month() || now.date() !== datejs.date()
31
106
  ? "MM-DD"
32
107
  : "HH:mm";
33
-
34
- const diffSecs = Math.floor(diff / 1000);
35
- if (!date) return null;
36
- if (dayjs(0).isSame(date) || dayjs(-1).isSame(date)) return <span>--:--</span>;
37
-
38
- const formatted = datejs.format(dateFormat);
39
- const relative = datejs.fromNow();
40
- const diffMins = Math.floor(diff / (1000 * 60));
41
- const diffHours = Math.floor(diff / (1000 * 3600));
42
- const diffDays = Math.floor(diff / (1000 * 3600 * 24));
43
- const diffWeeks = Math.floor(diff / (1000 * 3600 * 24 * 7));
44
- const diffMonths = Math.floor(diff / (1000 * 3600 * 24 * 30));
45
-
46
- let tip = datejs.format("YYYY-MM-DD HH:mm");
47
- let label: string;
48
- if (breakUnit === "second") {
49
- tip = datejs.format("YYYY-MM-DD HH:mm:ss");
50
- label = formatted;
51
- } else if (Math.abs(diffSecs) < 60) label = relative;
52
- else if (breakUnit === "minute") label = formatted;
53
- else if (Math.abs(diffMins) < 60) label = relative;
54
- else if (breakUnit === "hour") label = formatted;
55
- else if (Math.abs(diffHours) < 24) label = relative;
56
- else if (breakUnit === "day") label = formatted;
57
- else if (Math.abs(diffDays) < 7) label = relative;
58
- else if (breakUnit === "week") label = formatted;
59
- else if (Math.abs(diffWeeks) < 4) label = relative;
60
- else if (breakUnit === "month") label = formatted;
61
- else if (Math.abs(diffMonths) < 12) label = relative;
62
- else if (breakUnit === "year") label = formatted;
63
- else label = relative;
108
+ const tip = breakUnit === "second" ? datejs.format("YYYY-MM-DD HH:mm:ss") : datejs.format("YYYY-MM-DD HH:mm");
109
+ const label = isRelativeDisplay(now.diff(datejs), breakUnit)
110
+ ? formatRelativeLabel(datejs, now, lang, relative)
111
+ : datejs.format(dateFormat);
64
112
 
65
113
  return (
66
114
  <Tooltip content={tip}>
@@ -0,0 +1,26 @@
1
+ import { cn } from "akanjs/client";
2
+ import type { ReactNode } from "react";
3
+ import { BiChevronDown } from "react-icons/bi";
4
+ import { docUi } from "./style";
5
+
6
+ interface CollapseProps {
7
+ className?: string;
8
+ contentClassName?: string;
9
+ summary: ReactNode;
10
+ children: ReactNode;
11
+ open?: boolean;
12
+ }
13
+
14
+ /** 레퍼런스 카드의 접이식 컨테이너. daisyui `collapse` 대신 네이티브 `<details>/<summary>` — 열고 닫는 데 JS 가 없다. */
15
+ export const Collapse = ({ summary, children, open, className, contentClassName }: CollapseProps) => (
16
+ <details
17
+ className={cn(docUi.card, "group overflow-hidden transition-colors hover:border-foreground/20", className)}
18
+ open={open}
19
+ >
20
+ <summary className="flex cursor-pointer list-none items-start gap-3 px-4 py-3 transition-colors hover:bg-muted/40 [&::-webkit-details-marker]:hidden">
21
+ <div className="min-w-0 flex-1">{summary}</div>
22
+ <BiChevronDown className="mt-1 shrink-0 text-foreground/30 transition-transform group-open:rotate-180" />
23
+ </summary>
24
+ <div className={cn("flex w-full flex-col gap-4 border-border/70 border-t p-4", contentClassName)}>{children}</div>
25
+ </details>
26
+ );
@@ -0,0 +1,79 @@
1
+ import { cn } from "akanjs/client";
2
+ import type { ReactNode, RefObject } from "react";
3
+ import { AiOutlineCopy } from "react-icons/ai";
4
+ import { buttonRecipe } from "../Button";
5
+ import { Copy } from "../Copy";
6
+ import { docBorder, docDash, docUi } from "./style";
7
+
8
+ interface PanelProps {
9
+ className?: string;
10
+ bodyClassName?: string;
11
+ label?: string;
12
+ meta?: ReactNode;
13
+ tone?: Parameters<typeof docBorder>[0];
14
+ /** Rendered outside the scrolling body so it can cover the whole panel. */
15
+ overlay?: ReactNode;
16
+ children: ReactNode;
17
+ }
18
+
19
+ export const Panel = ({ className, bodyClassName, label, meta, tone = "muted", overlay, children }: PanelProps) => (
20
+ <div
21
+ className={cn(
22
+ "relative flex min-w-0 flex-col overflow-hidden border transition-colors",
23
+ docUi.panel,
24
+ docBorder(tone),
25
+ className,
26
+ )}
27
+ >
28
+ {label || meta ? (
29
+ <div className="flex items-center gap-2 border-border/70 border-b bg-muted/40 px-3 py-1.5">
30
+ <span className={docUi.sectionLabel}>{label}</span>
31
+ <div className="ml-auto flex items-center gap-1.5">{meta}</div>
32
+ </div>
33
+ ) : null}
34
+ <div className={cn("scrollbar-thin max-h-96 overflow-auto p-3", bodyClassName)}>{children}</div>
35
+ {overlay}
36
+ </div>
37
+ );
38
+
39
+ interface CodeProps {
40
+ className?: string;
41
+ label?: string;
42
+ code: string;
43
+ tone?: PanelProps["tone"];
44
+ meta?: ReactNode;
45
+ placeholder?: string;
46
+ bodyRef?: RefObject<HTMLPreElement | null>;
47
+ overlay?: ReactNode;
48
+ }
49
+
50
+ /**
51
+ * Read-only code surface. A `<pre>` rather than a `<textarea>`: every one of these panels ignored what was typed
52
+ * into it, so the caret and the resize grip were promising an edit that never landed anywhere.
53
+ */
54
+ export const Code = ({ className, label, code, tone, meta, placeholder = "—", bodyRef, overlay }: CodeProps) => (
55
+ <Panel
56
+ bodyClassName="max-h-none overflow-visible p-0"
57
+ className={className}
58
+ label={label}
59
+ meta={
60
+ <>
61
+ {meta}
62
+ <Copy text={code}>
63
+ <button className={buttonRecipe({ variant: "ghost", size: "xs" }, "text-foreground/50")} type="button">
64
+ <AiOutlineCopy />
65
+ </button>
66
+ </Copy>
67
+ </>
68
+ }
69
+ overlay={overlay}
70
+ tone={tone}
71
+ >
72
+ <pre
73
+ className="scrollbar-thin max-h-96 min-h-16 overflow-auto p-3 font-mono text-foreground/85 text-xs leading-relaxed"
74
+ ref={bodyRef}
75
+ >
76
+ {code || <span className={docDash}>{placeholder}</span>}
77
+ </pre>
78
+ </Panel>
79
+ );
@@ -0,0 +1,41 @@
1
+ "use client";
2
+ import { cn } from "akanjs/client";
3
+ import type { ReactNode } from "react";
4
+
5
+ export interface SegmentedItem<Key extends string> {
6
+ key: Key;
7
+ label: ReactNode;
8
+ icon?: ReactNode;
9
+ }
10
+
11
+ interface SegmentedProps<Key extends string> {
12
+ className?: string;
13
+ items: readonly SegmentedItem<Key>[];
14
+ value: Key;
15
+ onChange: (value: Key) => void;
16
+ }
17
+
18
+ /** The track and its items are also the shape of a multi-select chip group, which `Segmented` itself cannot be. */
19
+ export const segmentTrackClass = "inline-flex w-fit flex-wrap gap-1 rounded-field bg-muted p-1";
20
+
21
+ export const segmentItemClass = (active: boolean) =>
22
+ cn(
23
+ "inline-flex items-center gap-1.5 rounded-[calc(var(--radius-field)-0.25rem)] px-3 py-1.5 font-medium text-sm transition-colors",
24
+ active ? "bg-background text-foreground shadow-sm" : "text-foreground/50 hover:text-foreground",
25
+ );
26
+
27
+ export const Segmented = <Key extends string>({ className, items, value, onChange }: SegmentedProps<Key>) => (
28
+ <div className={cn(segmentTrackClass, className)}>
29
+ {items.map((item) => (
30
+ <button
31
+ className={segmentItemClass(item.key === value)}
32
+ key={item.key}
33
+ onClick={() => onChange(item.key)}
34
+ type="button"
35
+ >
36
+ {item.icon}
37
+ {item.label}
38
+ </button>
39
+ ))}
40
+ </div>
41
+ );
@@ -0,0 +1,25 @@
1
+ import { cn } from "akanjs/client";
2
+ import type { ReactNode } from "react";
3
+ import { docUi } from "./style";
4
+
5
+ interface SummaryCardProps {
6
+ className?: string;
7
+ label: string;
8
+ value: number | string;
9
+ }
10
+
11
+ export const SummaryCard = ({ className, label, value }: SummaryCardProps) => (
12
+ <div className={cn(docUi.card, "px-4 py-3", className)}>
13
+ <div className={docUi.sectionLabel}>{label}</div>
14
+ <div className="font-bold text-2xl">{value}</div>
15
+ </div>
16
+ );
17
+
18
+ interface SummaryGridProps {
19
+ className?: string;
20
+ children: ReactNode;
21
+ }
22
+
23
+ export const SummaryGrid = ({ className, children }: SummaryGridProps) => (
24
+ <div className={cn("grid grid-cols-2 gap-2 md:grid-cols-4", className)}>{children}</div>
25
+ );
@@ -0,0 +1,44 @@
1
+ import { cn } from "akanjs/client";
2
+ import type { ReactNode } from "react";
3
+ import { docUi } from "./style";
4
+
5
+ interface ToolbarProps {
6
+ className?: string;
7
+ children: ReactNode;
8
+ }
9
+
10
+ export const Toolbar = ({ className, children }: ToolbarProps) => (
11
+ <div className={cn(docUi.card, "flex flex-wrap items-center gap-x-6 gap-y-3 px-4 py-3", className)}>{children}</div>
12
+ );
13
+
14
+ interface ToolbarFieldProps {
15
+ className?: string;
16
+ label: string;
17
+ children: ReactNode;
18
+ }
19
+
20
+ export const ToolbarField = ({ className, label, children }: ToolbarFieldProps) => (
21
+ <div className={cn("flex min-w-0 items-center gap-2", className)}>
22
+ <span className={docUi.sectionLabel}>{label}</span>
23
+ {children}
24
+ </div>
25
+ );
26
+
27
+ interface SectionProps {
28
+ className?: string;
29
+ title: string;
30
+ action?: ReactNode;
31
+ children: ReactNode;
32
+ }
33
+
34
+ /** Titled band with a rule running to the edge, so a long document reads as sections rather than as one list. */
35
+ export const Section = ({ className, title, action, children }: SectionProps) => (
36
+ <section className={cn("flex flex-col gap-3", className)}>
37
+ <div className="flex items-center gap-3">
38
+ <h2 className={docUi.sectionTitle}>{title}</h2>
39
+ <div className="h-px flex-1 bg-border" />
40
+ {action}
41
+ </div>
42
+ {children}
43
+ </section>
44
+ );
@@ -0,0 +1,9 @@
1
+ interface Translator {
2
+ _: (key: string) => string;
3
+ }
4
+
5
+ /** `l._` echoes an absent key back, and a raw `user.signal.x.desc` reads as prose on a document surface. */
6
+ export const dictText = (l: Translator, key: string) => {
7
+ const text = l._(key);
8
+ return text === key ? "" : text;
9
+ };
@@ -0,0 +1,7 @@
1
+ export { Collapse } from "./Collapse";
2
+ export { dictText } from "./dictText";
3
+ export { Code, Panel } from "./Panel";
4
+ export { Segmented, type SegmentedItem, segmentItemClass, segmentTrackClass } from "./Segmented";
5
+ export { SummaryCard, SummaryGrid } from "./Summary";
6
+ export { docDash, docPill, docUi, type Tone } from "./style";
7
+ export { Section, Toolbar, ToolbarField } from "./Toolbar";
@@ -0,0 +1,45 @@
1
+ import { cn } from "../../client/cn";
2
+
3
+ export type Tone = "info" | "success" | "warning" | "error" | "muted";
4
+
5
+ const toneFill: { [key in Tone]: string } = {
6
+ info: "bg-info/15 text-info ring-info/25",
7
+ success: "bg-success/15 text-success ring-success/25",
8
+ warning: "bg-warning/15 text-warning ring-warning/25",
9
+ error: "bg-destructive/15 text-destructive ring-destructive/25",
10
+ muted: "bg-muted text-foreground/60 ring-border",
11
+ };
12
+
13
+ const toneBorder: { [key in Tone]: string } = {
14
+ info: "border-info/40",
15
+ success: "border-success/40",
16
+ warning: "border-warning/40",
17
+ error: "border-destructive/40",
18
+ muted: "border-border",
19
+ };
20
+
21
+ const pill = "inline-flex items-center gap-1 rounded-full px-2 py-0.5 font-medium text-xs ring-1 ring-inset";
22
+
23
+ /** Shared vocabulary for the generated reference surfaces — Constant schema docs and Signal API docs. */
24
+ export const docUi = {
25
+ card: "rounded-box border border-border bg-card",
26
+ panel: "rounded-box border border-border bg-background",
27
+ tablePanel: "overflow-x-auto rounded-box border border-border bg-background",
28
+ sectionLabel: "font-semibold text-foreground/45 text-xs uppercase tracking-wider",
29
+ sectionTitle: "font-bold text-xl",
30
+ pageTitle: "font-bold text-3xl",
31
+ sectionDescription: "text-foreground/70 text-sm",
32
+ prose: "text-foreground/75 text-sm leading-relaxed",
33
+ key: "font-medium font-mono",
34
+ subLabel: "text-foreground/45 text-xs",
35
+ tableClass:
36
+ "w-full text-left text-sm [&_th]:whitespace-nowrap [&_th]:px-3 [&_th]:py-2 [&_th]:font-semibold [&_th]:text-foreground/45 [&_th]:text-xs [&_th]:uppercase [&_th]:tracking-wider [&_td]:px-3 [&_td]:py-2.5 [&_td]:align-top [&_tbody_tr]:border-border/70 [&_tbody_tr]:border-t [&_tbody_tr]:transition-colors hover:[&_tbody_tr]:bg-muted/40",
37
+ emptyPanel: "rounded-box border border-border border-dashed p-8 text-center text-foreground/40 text-sm",
38
+ };
39
+
40
+ export const docPill = (tone: Tone, className?: string) => cn(pill, toneFill[tone], className);
41
+
42
+ export const docBorder = (tone: Tone) => toneBorder[tone];
43
+
44
+ /** Absent optional cell. One glyph everywhere, so an empty column reads as empty rather than as data. */
45
+ export const docDash = "text-foreground/25";
@@ -1,9 +1,12 @@
1
1
  "use client";
2
2
  import { useDrag } from "@use-gesture/react";
3
3
  import { cn } from "akanjs/client";
4
+ import { capitalize } from "akanjs/common";
5
+ import { st } from "akanjs/store";
4
6
  import { animated } from "akanjs/ui";
5
- import { createContext, type ReactNode, useContext, useEffect, useRef, useState } from "react";
7
+ import { type ReactNode, useContext, useEffect, useRef, useState } from "react";
6
8
  import { SpringValue, useSpringValue } from "react-spring";
9
+ import { sharedContext } from "../client/sharedContext";
7
10
 
8
11
  interface ScreenNavigatorContextType {
9
12
  bind: (...args: any[]) => any;
@@ -14,7 +17,7 @@ interface ScreenNavigatorContextType {
14
17
  onClickMenu: (menu: string) => void;
15
18
  }
16
19
 
17
- const ScreenNavigatorContext = createContext<ScreenNavigatorContextType>({
20
+ const ScreenNavigatorContext = sharedContext<ScreenNavigatorContextType>("screenNavigator", {
18
21
  bind: () => ({}),
19
22
  xValue: new SpringValue(0),
20
23
  setMenu: null as unknown as (menu: string) => void,
@@ -28,6 +31,8 @@ interface ScreenNavigatorProps {
28
31
  children: React.ReactNode;
29
32
  setMenu?: (menu: string) => void;
30
33
  menus: string[];
34
+ /** Names this navigator for the in-page agent. Without it it publishes nothing — two on one screen would share a name. */
35
+ namespace?: string;
31
36
  }
32
37
 
33
38
  export const ScreenNavigator = ({
@@ -35,6 +40,7 @@ export const ScreenNavigator = ({
35
40
  setMenu = () => {
36
41
  },
37
42
  menus,
43
+ namespace,
38
44
  }: ScreenNavigatorProps) => {
39
45
  const [currentMenu, setCurrentMenu] = useState(menus[0]);
40
46
  const xValue = useSpringValue(0, { config: { clamp: true } });
@@ -95,6 +101,15 @@ export const ScreenNavigator = ({
95
101
  }
96
102
  };
97
103
 
104
+ const suffix = namespace ? capitalize(namespace) : "";
105
+ st.expose(namespace ? `screenIn${suffix}` : null, String)
106
+ .desc("The screen this navigator is showing.")
107
+ .value(currentMenu);
108
+ st.tool(namespace ? `goToScreenIn${suffix}` : null)
109
+ .desc(`Slide the ${namespace ?? ""} navigator to one screen.`)
110
+ .arg("screen", String, { oneOf: menus })
111
+ .exec(onClickMenu);
112
+
98
113
  return (
99
114
  <ScreenNavigatorContext.Provider value={{ bind, xValue, onClickMenu, menus, currentMenu, setMenu }}>
100
115
  <animated.div {...bind()} className="flex h-full w-[200vw] overflow-x-scroll" style={{ x: xValue }} ref={ref}>