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
@@ -0,0 +1,349 @@
1
+ const skipTags = new Set([
2
+ "SCRIPT",
3
+ "STYLE",
4
+ "NOSCRIPT",
5
+ "TEMPLATE",
6
+ "IFRAME",
7
+ "SVG",
8
+ "CANVAS",
9
+ "VIDEO",
10
+ "AUDIO",
11
+ "OBJECT",
12
+ "EMBED",
13
+ ]);
14
+ const headingLevels = { H1: 1, H2: 2, H3: 3, H4: 4, H5: 5, H6: 6 } as const;
15
+ const headingSelector = "h1, h2, h3, h4, h5, h6";
16
+ const blockTags = new Set([
17
+ "ADDRESS",
18
+ "ARTICLE",
19
+ "ASIDE",
20
+ "BLOCKQUOTE",
21
+ "DD",
22
+ "DETAILS",
23
+ "DIV",
24
+ "DL",
25
+ "DT",
26
+ "FIELDSET",
27
+ "FIGCAPTION",
28
+ "FIGURE",
29
+ "FOOTER",
30
+ "FORM",
31
+ "HEADER",
32
+ "HR",
33
+ "LEGEND",
34
+ "MAIN",
35
+ "NAV",
36
+ "OL",
37
+ "P",
38
+ "SECTION",
39
+ "SUMMARY",
40
+ "TABLE",
41
+ "THEAD",
42
+ "TBODY",
43
+ "TFOOT",
44
+ "TR",
45
+ "UL",
46
+ ]);
47
+
48
+ /**
49
+ * Serializes what the page is rendering into compact text an agent can answer questions from: headings keep their
50
+ * level and their anchor, links keep their href, controls keep their value and `data-akan-*` annotation. The
51
+ * agent's own UI is marked `data-agent-ui` and skipped, so a turn never re-reads its own transcript, and a
52
+ * password value is never read — the screen shows dots, so the DOM holds more than the user sees.
53
+ *
54
+ * A region the app marks `data-agent-skip` — what `Agent.Skip` renders — costs a `[skipped: <name>]` line instead
55
+ * of its text. It stands in the output rather than vanishing because a deleted region reads as an absent one, and
56
+ * an agent asked about a footer it never saw answers that the page has none. Naming the region as `section` reads
57
+ * it: the marker is what the default read leaves out, not a wall.
58
+ *
59
+ * A heading carries `(#anchor)` whenever it opens a container that has an id or a scope path, because that is the
60
+ * name `readScreen({ section })` and `highlight` take: printing the text without the name leaves an agent
61
+ * guessing at a slug. For the same reason a truncated read ends with the headings below the cut instead of only
62
+ * a character count — otherwise everything past the limit is unreachable, since nothing names it.
63
+ */
64
+ export class ScreenReader {
65
+ static readonly limit = 8000;
66
+
67
+ static read(root?: HTMLElement | null): string {
68
+ if (typeof document === "undefined") return "No rendered document is available.";
69
+ const reader = new ScreenReader();
70
+ const title = document.title.trim();
71
+ if (title) reader.#lines.push(`Page: ${title}`);
72
+ reader.#walk(root ?? document.body, true);
73
+ reader.#flush();
74
+ return reader.#text() || "The page is rendering nothing readable.";
75
+ }
76
+
77
+ /**
78
+ * One heading's own section: the heading, then what follows it until the next heading of the same level or
79
+ * higher. Reads the heading's container when the heading is the only one in it — the shape a docs slide or an
80
+ * `<article>` has — and otherwise the heading's own following siblings.
81
+ */
82
+ static readFrom(heading: HTMLElement, root?: HTMLElement | null): string {
83
+ if (typeof document === "undefined") return "No rendered document is available.";
84
+ const reader = new ScreenReader();
85
+ const container = ScreenReader.#sectionOf(heading, root);
86
+ if (container) reader.#walk(container, true);
87
+ else {
88
+ const level = headingLevels[heading.tagName.toUpperCase() as keyof typeof headingLevels] ?? 1;
89
+ reader.#walk(heading, true);
90
+ let next = heading.nextElementSibling;
91
+ while (next && !ScreenReader.#stops(next, level)) {
92
+ reader.#walk(next);
93
+ next = next.nextElementSibling;
94
+ }
95
+ }
96
+ reader.#flush();
97
+ return reader.#text() || "That section is rendering nothing readable.";
98
+ }
99
+
100
+ /**
101
+ * The outermost ancestor that still holds this heading and no other of its level — the section, not the title
102
+ * wrapper inside it. Climbing matters: a docs slide puts its heading two or three divs down, so the innermost
103
+ * match is often the heading and nothing else.
104
+ */
105
+ static #sectionOf(heading: HTMLElement, root?: HTMLElement | null): HTMLElement | null {
106
+ const level = headingLevels[heading.tagName.toUpperCase() as keyof typeof headingLevels] ?? 1;
107
+ const boundary = root ?? document.body;
108
+ let container: HTMLElement | null = null;
109
+ let parent = heading.parentElement;
110
+ for (let depth = 0; parent && parent !== boundary && depth < 6; depth += 1) {
111
+ const owned = [...parent.querySelectorAll(headingSelector)].filter((found) => ScreenReader.#stops(found, level));
112
+ if (owned.length !== 1) break;
113
+ container = parent;
114
+ parent = parent.parentElement;
115
+ }
116
+ return container;
117
+ }
118
+
119
+ /** The anchor a heading is addressable by: its own id, or the id or scope path of the container it opens. */
120
+ static anchorOf(heading: HTMLElement): string {
121
+ if (heading.id) return heading.id;
122
+ let parent = heading.parentElement;
123
+ for (let depth = 0; parent && depth < 4; depth += 1) {
124
+ const name = parent.getAttribute("data-agent-scope") ?? parent.getAttribute("data-agent-zone") ?? parent.id;
125
+ if (name && parent.querySelector(headingSelector) === heading) return name;
126
+ parent = parent.parentElement;
127
+ }
128
+ return "";
129
+ }
130
+
131
+ /**
132
+ * `checkVisibility()` reports whether the element has a layout box, and a `display: contents` wrapper has none
133
+ * while its children do — so Chrome answers false for a wrapper the user is looking straight at, and skipping it
134
+ * would drop that whole subtree (happy-dom answers true, so no DOM test sees the difference). Reading through it
135
+ * is safe only because the walk is top-down: a `display: none` ancestor bails on its own computed display first.
136
+ */
137
+ static #rendered(el: HTMLElement) {
138
+ if (typeof el.checkVisibility !== "function" || el.checkVisibility()) return true;
139
+ return getComputedStyle(el).display === "contents";
140
+ }
141
+
142
+ static #stops(el: Element, level: number) {
143
+ const found = headingLevels[el.tagName.toUpperCase() as keyof typeof headingLevels];
144
+ return !!found && found <= level;
145
+ }
146
+
147
+ #lines: string[] = [];
148
+ #headings: string[] = [];
149
+ #buffer = "";
150
+ #length = 0;
151
+
152
+ /**
153
+ * Past the walk budget the text is dropped but the headings are not: a section below the cut is exactly what the
154
+ * truncation note owes the reader, and it is the only way that part of the screen can be named at all.
155
+ */
156
+ #outline(node: Node): void {
157
+ if (node.nodeType !== Node.ELEMENT_NODE) return;
158
+ const el = node as HTMLElement;
159
+ const tag = el.tagName.toUpperCase();
160
+ if (skipTags.has(tag) || el.hasAttribute("data-agent-ui") || el.hasAttribute("data-agent-skip")) return;
161
+ const level = headingLevels[tag as keyof typeof headingLevels];
162
+ if (level) {
163
+ const anchor = ScreenReader.anchorOf(el);
164
+ const text = (el.textContent ?? "").replace(/\s+/g, " ").trim();
165
+ if (text) this.#headings.push(`${"#".repeat(level)} ${text}${anchor ? ` (#${anchor})` : ""}`);
166
+ return;
167
+ }
168
+ for (const child of el.childNodes) this.#outline(child);
169
+ }
170
+
171
+ #text() {
172
+ const text = this.#lines.join("\n").trim();
173
+ if (text.length <= ScreenReader.limit) return text;
174
+ const kept = text.slice(0, ScreenReader.limit);
175
+ const below = this.#headings.filter((heading) => !kept.includes(heading)).slice(0, 25);
176
+ const note = `… [truncated ${text.length - ScreenReader.limit} more characters]`;
177
+ return below.length
178
+ ? `${kept}${note}\nFurther down, unread: ${below.join(" · ")}. Pass one of those names as \`section\` to read it.`
179
+ : `${kept}${note}`;
180
+ }
181
+
182
+ /** What stands where a skipped region was: its own name, and the anchor `section` takes to read it on request. */
183
+ #mark(el: HTMLElement, label: string) {
184
+ const anchor = el.getAttribute("data-agent-scope") ?? el.getAttribute("data-agent-zone") ?? el.id;
185
+ this.#flush();
186
+ this.#buffer = `[skipped: ${label || el.tagName.toLowerCase()}${anchor ? ` (#${anchor})` : ""}]`;
187
+ this.#flush();
188
+ }
189
+
190
+ #walk(node: Node, isRoot = false): void {
191
+ if (this.#length > ScreenReader.limit * 2) {
192
+ this.#outline(node);
193
+ return;
194
+ }
195
+ if (node.nodeType === Node.TEXT_NODE) {
196
+ const text = (node.textContent ?? "").replace(/\s+/g, " ");
197
+ if (text.trim()) this.#buffer += text;
198
+ return;
199
+ }
200
+ if (node.nodeType !== Node.ELEMENT_NODE) return;
201
+ const el = node as HTMLElement;
202
+ const tag = el.tagName.toUpperCase();
203
+ if (skipTags.has(tag)) return;
204
+ if (el.hasAttribute("data-agent-ui") || el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true")
205
+ return;
206
+ if (!ScreenReader.#rendered(el)) return;
207
+
208
+ const skipped = isRoot ? null : el.getAttribute("data-agent-skip");
209
+ if (skipped !== null) {
210
+ this.#mark(el, skipped);
211
+ return;
212
+ }
213
+ if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") {
214
+ this.#control(el, tag);
215
+ return;
216
+ }
217
+ if (tag === "IMG") {
218
+ const alt = el.getAttribute("alt");
219
+ if (alt) this.#buffer += ` [image: ${alt}]`;
220
+ return;
221
+ }
222
+ if (tag === "BR") {
223
+ this.#flush();
224
+ return;
225
+ }
226
+ if (tag === "PRE") {
227
+ this.#pre(el);
228
+ return;
229
+ }
230
+ if (tag === "A") {
231
+ this.#anchor(el);
232
+ return;
233
+ }
234
+ if (tag === "BUTTON" || el.getAttribute("role") === "button") {
235
+ this.#button(el);
236
+ return;
237
+ }
238
+ const level = headingLevels[tag as keyof typeof headingLevels];
239
+ if (level) {
240
+ this.#flush();
241
+ this.#walkChildren(el);
242
+ const anchor = ScreenReader.anchorOf(el);
243
+ if (anchor) this.#buffer += ` (#${anchor})`;
244
+ const before = this.#lines.length;
245
+ this.#flush(`${"#".repeat(level)} `);
246
+ if (this.#lines.length > before) this.#headings.push(this.#lines[this.#lines.length - 1]);
247
+ return;
248
+ }
249
+ if (tag === "LI") {
250
+ this.#flush();
251
+ this.#walkChildren(el);
252
+ this.#flush("- ");
253
+ return;
254
+ }
255
+ if (tag === "TD" || tag === "TH") {
256
+ if (this.#buffer.trim()) this.#buffer += " |";
257
+ this.#walkChildren(el);
258
+ return;
259
+ }
260
+ if (blockTags.has(tag)) {
261
+ this.#flush();
262
+ this.#walkChildren(el);
263
+ this.#flush();
264
+ return;
265
+ }
266
+ this.#walkChildren(el);
267
+ }
268
+
269
+ #walkChildren(el: HTMLElement) {
270
+ for (const child of el.childNodes) this.#walk(child);
271
+ }
272
+
273
+ #anchor(el: HTMLElement) {
274
+ const href = el.getAttribute("href") ?? "";
275
+ const before = this.#buffer;
276
+ this.#walkChildren(el);
277
+ const text = this.#buffer.slice(before.length).replace(/\s+/g, " ").trim();
278
+ if (href && href !== "#" && !href.startsWith("javascript:") && text !== href) this.#buffer += ` (${href})`;
279
+ }
280
+
281
+ /**
282
+ * A control the person cannot use publishes no tool, so saying so here is what turns a silent refusal into a
283
+ * fact the agent could have read. It reads `aria-disabled` too: a styled-off div carries no native property.
284
+ */
285
+ static #off(el: HTMLElement) {
286
+ const native = (el as HTMLInputElement | HTMLButtonElement).disabled;
287
+ return native || el.getAttribute("aria-disabled") === "true" ? " (disabled)" : "";
288
+ }
289
+
290
+ #button(el: HTMLElement) {
291
+ const before = this.#buffer;
292
+ this.#walkChildren(el);
293
+ const inner = this.#buffer.slice(before.length).replace(/\s+/g, " ").trim();
294
+ this.#buffer = before;
295
+ const label = inner || el.getAttribute("aria-label") || "";
296
+ const action = el.getAttribute("data-akan-action");
297
+ if (label || action) this.#buffer += ` [button${ScreenReader.#off(el)}: ${label}${action ? ` → ${action}` : ""}]`;
298
+ }
299
+
300
+ #control(el: HTMLElement, tag: string) {
301
+ const input = el as HTMLInputElement;
302
+ const type = (el.getAttribute("type") ?? (tag === "INPUT" ? "text" : tag.toLowerCase())).toLowerCase();
303
+ if (type === "hidden") return;
304
+ const name =
305
+ el.getAttribute("data-akan-state") ??
306
+ el.getAttribute("aria-label") ??
307
+ el.getAttribute("placeholder") ??
308
+ el.getAttribute("name") ??
309
+ type;
310
+ const off = ScreenReader.#off(el);
311
+ if (type === "password") {
312
+ this.#buffer += ` [input ${name}${off}]`;
313
+ return;
314
+ }
315
+ if (type === "checkbox" || type === "radio") {
316
+ this.#buffer += ` [${type} ${name}${off}: ${input.checked ? "on" : "off"}]`;
317
+ return;
318
+ }
319
+ const raw =
320
+ tag === "SELECT"
321
+ ? ((el as unknown as HTMLSelectElement).selectedOptions?.[0]?.textContent ??
322
+ (el as unknown as HTMLSelectElement).value)
323
+ : input.value;
324
+ const value = (raw ?? "").replace(/\s+/g, " ").trim().slice(0, 120);
325
+ this.#buffer += ` [${tag === "SELECT" ? "select" : "input"} ${name}${off}: ${JSON.stringify(value)}]`;
326
+ }
327
+
328
+ #pre(el: HTMLElement) {
329
+ this.#flush();
330
+ const raw = (el.textContent ?? "").trim();
331
+ if (!raw) return;
332
+ const rows = raw.split("\n");
333
+ this.#lines.push(
334
+ "```",
335
+ ...rows.slice(0, 30),
336
+ ...(rows.length > 30 ? [`… ${rows.length - 30} more lines`] : []),
337
+ "```",
338
+ );
339
+ this.#length += raw.length;
340
+ }
341
+
342
+ #flush(prefix = "") {
343
+ const text = this.#buffer.replace(/\s+/g, " ").trim();
344
+ this.#buffer = "";
345
+ if (!text) return;
346
+ this.#lines.push(prefix + text);
347
+ this.#length += prefix.length + text.length;
348
+ }
349
+ }
@@ -0,0 +1,45 @@
1
+ export interface ScreenSettleOptions {
2
+ /** How long the DOM must hold still before the screen counts as settled. */
3
+ quietMs?: number;
4
+ /** How long to wait for a change that has not started yet — a navigation whose payload is still in flight. */
5
+ appearMs?: number;
6
+ timeoutMs?: number;
7
+ }
8
+
9
+ /**
10
+ * Waits until the screen stops changing.
11
+ *
12
+ * The surface is read synchronously and the app is not: `router.push` returns while the RSC payload for the new
13
+ * route is still in flight, and a store action that fires `void fetch.*` commits a tick later. A tool that returns
14
+ * at either of those moments reports the screen it replaced — and the `readScreen` the agent calls next reads the
15
+ * page the user already left.
16
+ *
17
+ * Quiescence rather than a framework signal, because there is no one signal: the client router hands its promise
18
+ * to nobody, and a change may land in the store, in a refetch, or in a streamed Suspense boundary. A
19
+ * MutationObserver sees all three, and every wait is bounded — a screen that never holds still still answers.
20
+ */
21
+ export class ScreenSettle {
22
+ static wait({ quietMs = 120, appearMs = 0, timeoutMs = 3000 }: ScreenSettleOptions = {}): Promise<void> {
23
+ const body = typeof document === "undefined" ? null : (document.body ?? document.documentElement);
24
+ if (!body || typeof MutationObserver === "undefined") return Promise.resolve();
25
+ return new Promise((resolve) => {
26
+ let quiet: ReturnType<typeof setTimeout> | null = null;
27
+ const done = () => {
28
+ if (quiet) clearTimeout(quiet);
29
+ clearTimeout(deadline);
30
+ observer.disconnect();
31
+ resolve();
32
+ };
33
+ const rearm = () => {
34
+ if (quiet) clearTimeout(quiet);
35
+ quiet = setTimeout(done, quietMs);
36
+ };
37
+ const observer = new MutationObserver(rearm);
38
+ const deadline = setTimeout(done, timeoutMs);
39
+ observer.observe(body, { attributes: true, characterData: true, childList: true, subtree: true });
40
+
41
+ if (appearMs) quiet = setTimeout(done, appearMs);
42
+ else rearm();
43
+ });
44
+ }
45
+ }
@@ -0,0 +1,135 @@
1
+ import { ScreenReader } from "./ScreenReader";
2
+
3
+ const containerAttrs = ["data-agent-zone", "data-agent-scope", "data-agent-skip"] as const;
4
+ const controlAttrs = ["data-akan-action", "data-akan-state"] as const;
5
+ const headingSelector = "h1, h2, h3, h4, h5, h6";
6
+ const nameCap = 40;
7
+
8
+ /**
9
+ * Resolves a name the agent read on screen to the element it names.
10
+ *
11
+ * Four vocabularies, every one of them something already on the screen rather than a selector the model invented:
12
+ * the `data-akan-action` / `data-akan-state` annotation a control carries and `readScreen` prints beside it, a
13
+ * container — an `Agent.Zone`, a `useScreenScope` scope, or an `Agent.Skip` region named by the marker left in its
14
+ * place — a plain element id, what a docs slide is addressed by, and, last, a **heading by its own text**.
15
+ *
16
+ * A heading is matched on letters and digits alone, so the slug an agent naturally writes for a heading it read
17
+ * ("images-and-public-env") finds "Images And Public Env". That tolerance is for headings only: a heading is a
18
+ * landmark and scrolling to the wrong one costs nothing, while two buttons reading "Save" are not the same control
19
+ * and matching a *control* by its label would drive the wrong one.
20
+ *
21
+ * Nothing hidden ever resolves, by the same rule `readScreen` skips it. A collapsed panel or an off-variant
22
+ * duplicate is not what the user is looking at, and scrolling to one flashes a ring nobody can see — which reads
23
+ * as the tool being broken rather than as a miss. A `display: contents` wrapper does not resolve either, even
24
+ * though the reader now reads through it: it has no box, so `scrollIntoView` has nothing to scroll to.
25
+ */
26
+ export class ScreenTarget {
27
+ static container(name: string, root?: HTMLElement | null): HTMLElement | null {
28
+ const scope = root ?? ScreenTarget.#body();
29
+ if (!scope || !name) return null;
30
+ if (ScreenTarget.#named(scope, containerAttrs, name)) return scope;
31
+ const escaped = CSS.escape(name);
32
+ const selector = containerAttrs.map((attr) => `[${attr}="${escaped}"]`).join(", ");
33
+
34
+ return (
35
+ ScreenTarget.#first(scope, selector) ??
36
+ [...scope.querySelectorAll<HTMLElement>("[id]")].find((el) => el.id === name && ScreenTarget.#visible(el)) ??
37
+ null
38
+ );
39
+ }
40
+
41
+ static control(name: string, root?: HTMLElement | null): HTMLElement | null {
42
+ const scope = root ?? ScreenTarget.#body();
43
+ if (!scope || !name) return null;
44
+ const escaped = CSS.escape(name);
45
+ return ScreenTarget.#first(scope, controlAttrs.map((attr) => `[${attr}="${escaped}"]`).join(", "));
46
+ }
47
+
48
+ /** Matched on letters and digits only, so a slug written for a heading still finds it. */
49
+ static heading(text: string, root?: HTMLElement | null): HTMLElement | null {
50
+ const scope = root ?? ScreenTarget.#body();
51
+ const wanted = ScreenTarget.#slug(text);
52
+ if (!scope || !wanted) return null;
53
+ const headings = [...scope.querySelectorAll<HTMLElement>(headingSelector)].filter(ScreenTarget.#visible);
54
+ return (
55
+ headings.find((heading) => ScreenTarget.#slug(heading.textContent ?? "") === wanted) ??
56
+ headings.find((heading) => ScreenTarget.#slug(heading.textContent ?? "").includes(wanted)) ??
57
+ null
58
+ );
59
+ }
60
+
61
+ /** A control first — an annotated button is the most specific match — then a container, then a heading. */
62
+ static find(name: string, root?: HTMLElement | null): HTMLElement | null {
63
+ return ScreenTarget.control(name, root) ?? ScreenTarget.container(name, root) ?? ScreenTarget.heading(name, root);
64
+ }
65
+
66
+ /**
67
+ * The names a refusal can honestly offer for a region: the scope paths, plus every heading anchor on screen.
68
+ * Leaving the anchors out is what let a page of twenty named sections answer "nothing carries a name".
69
+ */
70
+ static containerNames(root?: HTMLElement | null): string[] {
71
+ return [...new Set([...ScreenTarget.#names(containerAttrs, root), ...ScreenTarget.anchorNames(root)])].slice(
72
+ 0,
73
+ nameCap,
74
+ );
75
+ }
76
+
77
+ static anchorNames(root?: HTMLElement | null): string[] {
78
+ const scope = root ?? ScreenTarget.#body();
79
+ if (!scope) return [];
80
+ const names = new Set<string>();
81
+ for (const heading of scope.querySelectorAll<HTMLElement>(headingSelector)) {
82
+ const anchor = ScreenTarget.#visible(heading) ? ScreenReader.anchorOf(heading) : "";
83
+ if (anchor) names.add(anchor);
84
+ }
85
+ return [...names];
86
+ }
87
+
88
+ static targetNames(root?: HTMLElement | null): string[] {
89
+ return [...new Set([...ScreenTarget.#names(controlAttrs, root), ...ScreenTarget.containerNames(root)])].slice(
90
+ 0,
91
+ nameCap,
92
+ );
93
+ }
94
+
95
+ static #names(attrs: readonly string[], root?: HTMLElement | null): string[] {
96
+ const scope = root ?? ScreenTarget.#body();
97
+ if (!scope) return [];
98
+ const names = new Set<string>();
99
+ for (const attr of attrs) {
100
+ const own = scope.getAttribute(attr);
101
+ if (own) names.add(own);
102
+ for (const el of scope.querySelectorAll<HTMLElement>(`[${attr}]`)) {
103
+ const value = ScreenTarget.#visible(el) ? el.getAttribute(attr) : null;
104
+ if (value) names.add(value);
105
+ }
106
+ }
107
+ return [...names].slice(0, nameCap);
108
+ }
109
+
110
+ static #named(el: HTMLElement, attrs: readonly string[], name: string) {
111
+ return attrs.some((attr) => el.getAttribute(attr) === name);
112
+ }
113
+
114
+ static #first(scope: HTMLElement, selector: string) {
115
+ return [...scope.querySelectorAll<HTMLElement>(selector)].find(ScreenTarget.#visible) ?? null;
116
+ }
117
+
118
+ static #visible(el: HTMLElement) {
119
+ if (el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true") return false;
120
+ if (el.closest("[data-agent-ui]")) return false;
121
+ return typeof el.checkVisibility === "function" ? el.checkVisibility() : true;
122
+ }
123
+
124
+ static #slug(text: string) {
125
+ return text
126
+ .toLowerCase()
127
+ .replace(/[^a-z0-9]+/g, " ")
128
+ .trim();
129
+ }
130
+
131
+ static #body(): HTMLElement | null {
132
+ if (typeof document === "undefined") return null;
133
+ return document.body ?? document.documentElement;
134
+ }
135
+ }
@@ -0,0 +1,116 @@
1
+ import type { Cls } from "akanjs/base";
2
+ import { ConstantRegistry } from "akanjs/constant";
3
+ import type { AgentRefusal } from "akanjs/signal";
4
+ import { databaseStateModelTypes, databaseStateNames } from "../databaseStateNames";
5
+ import type { SliceStateKey } from "../state";
6
+ import type { StoreInstance } from "../storeInstance";
7
+ import type { SerializedStoreState } from "./types";
8
+
9
+ /** Which of the model's classes each slice state key holds. The rest hold a primitive or a query descriptor. */
10
+ const sliceStateModelTypes: { [key in SliceStateKey]?: SerializedStoreState["modelType"] } = {
11
+ defaultModel: "full",
12
+ modelList: "light",
13
+ modelInitList: "light",
14
+ modelSelection: "light",
15
+ modelInsight: "insight",
16
+ };
17
+
18
+ /**
19
+ * Every store key an in-page agent may read, derived on the client from the store the browser is already running.
20
+ *
21
+ * Keys only — nothing here becomes a tool. What an agent may *do* is declared where the screen declares it, with
22
+ * `st.tool` beside the control that does the same thing for the user; a store method nobody declared is the app's
23
+ * own vocabulary and says nothing about what this screen offers. Deriving tools from the store published the
24
+ * bundle rather than the screen, and every lever the screen did not have was noise the model paid for.
25
+ *
26
+ * Reads stay store-derived because a read has to be masked and only the store declares which model masks it. Which
27
+ * of these keys is readable at a given moment is liveness rather than this catalogue — the keys the mounted
28
+ * components subscribe. Plumbing in the base store opts out at the call site with `{ agent: false }`.
29
+ *
30
+ * It is derived on the client rather than shipped from the server: the store classes are in the bundle already,
31
+ * and a second copy over the wire is a second thing to keep in step.
32
+ */
33
+ export class StoreCatalogue {
34
+ readonly state: { [key: string]: SerializedStoreState };
35
+ readonly refusals: AgentRefusal[] = [];
36
+
37
+ readonly #instance: StoreInstance;
38
+
39
+ constructor(instance: StoreInstance) {
40
+ this.#instance = instance;
41
+ this.state = this.#state();
42
+ }
43
+
44
+ #state(): { [key: string]: SerializedStoreState } {
45
+ const state = this.#instance.get();
46
+ const declared = StoreCatalogue.#declaredStateModels();
47
+ const entries = Object.keys(state)
48
+ .sort()
49
+ .map((key): [string, SerializedStoreState] => {
50
+ const role = this.#instance.sliceStateRoles.get(key);
51
+ const model = role
52
+ ? { refName: role.refName, ...StoreCatalogue.#modelTypeOf(sliceStateModelTypes[role.role]) }
53
+ : (declared.get(key) ?? StoreCatalogue.#refNameOf(state[key]));
54
+ return [
55
+ key,
56
+ {
57
+ type: StoreCatalogue.#typeOf(state[key]),
58
+ ...model,
59
+ ...(role ? { role: role.role } : {}),
60
+ derived: this.#instance.derivedKeys.has(key),
61
+ },
62
+ ];
63
+ });
64
+ return Object.fromEntries(entries);
65
+ }
66
+
67
+ /**
68
+ * The model each generated state key holds, taken from the declaration rather than from the value.
69
+ *
70
+ * A read has to be masked by the model, and the value cannot supply it: `immerify` copies a form into a plain
71
+ * object, so `<model>Form` — an `Input` holding whatever the user typed — arrives with its class already gone.
72
+ */
73
+ static #declaredStateModels() {
74
+ const declared = new Map<string, { refName: string; modelType: SerializedStoreState["modelType"] }>();
75
+ for (const refName of ConstantRegistry.database.keys()) {
76
+ const names = databaseStateNames(refName);
77
+ for (const [role, modelType] of Object.entries(databaseStateModelTypes))
78
+ declared.set(names[role as keyof typeof names], { refName, modelType });
79
+ }
80
+ return declared;
81
+ }
82
+
83
+ static #modelTypeOf(modelType: SerializedStoreState["modelType"]) {
84
+ return modelType ? { modelType } : {};
85
+ }
86
+
87
+ static #typeOf(value: unknown): SerializedStoreState["type"] {
88
+ if (value === null || value === undefined) return "unknown";
89
+ if (Array.isArray(value)) return "list";
90
+ if (value instanceof Map) return "map";
91
+ if (value instanceof Date) return "date";
92
+ switch (typeof value) {
93
+ case "string":
94
+ return "string";
95
+ case "number":
96
+ return "number";
97
+ case "boolean":
98
+ return "boolean";
99
+ case "object":
100
+ return StoreCatalogue.#isList(value) ? "list" : "object";
101
+ default:
102
+ return "unknown";
103
+ }
104
+ }
105
+
106
+ /** `DataList` and `dayjs` are the two objects a store holds that are not what `typeof` says they are. */
107
+ static #isList(value: object) {
108
+ return "values" in value && Array.isArray((value as { values: unknown }).values);
109
+ }
110
+
111
+ static #refNameOf(value: unknown) {
112
+ if (!value || typeof value !== "object") return {};
113
+ const refName = ConstantRegistry.getRefName(value.constructor as Cls, { allowEmpty: true });
114
+ return refName ? { refName } : {};
115
+ }
116
+ }