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/Field.tsx CHANGED
@@ -3,12 +3,12 @@ import { type DataList, type Dayjs, dayjs, type EnumInstance, isEnum } from "aka
3
3
  import { cn, usePage } from "akanjs/client";
4
4
  import { capitalize, formatPhone, isPhoneNumber, lowerlize } from "akanjs/common";
5
5
  import type { SliceMeta } from "akanjs/fetch";
6
- import { st } from "akanjs/store";
6
+ import { actionTagOf, st, tagAction, useFieldTool, useRelationFieldTool } from "akanjs/store";
7
7
  import { memo, type ReactNode, useState } from "react";
8
8
  import { AiOutlinePlus } from "react-icons/ai";
9
9
  import { BiHelpCircle, BiTrash, BiX } from "react-icons/bi";
10
10
  import { MdDragIndicator } from "react-icons/md";
11
-
11
+ import { agentAttrs } from "./agentAttrs";
12
12
  import { badgeRecipe } from "./Badge";
13
13
  import { buttonRecipe } from "./Button";
14
14
  import { DraggableList } from "./DraggableList";
@@ -86,7 +86,7 @@ interface ListProps<Item> {
86
86
  label?: string;
87
87
  desc?: string;
88
88
  nullable?: boolean;
89
- value: Item[];
89
+ value: Item[] | null;
90
90
  onChange: (value: Item[]) => void;
91
91
  onAdd: () => void;
92
92
  renderItem: (item: Item, idx: number) => ReactNode;
@@ -104,11 +104,13 @@ const List = <Item,>({
104
104
  }: ListProps<Item>) => {
105
105
  const { l } = usePage();
106
106
  const recipe = useUiRecipe("button") ?? buttonRecipe;
107
+ useFieldTool(onChange);
108
+ const items = value ?? [];
107
109
  return (
108
- <div className={cn("flex w-full flex-col", className)}>
110
+ <div {...agentAttrs(onChange)} className={cn("flex w-full flex-col", className)}>
109
111
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
110
- <div className="mb-2 flex w-full flex-col gap-2 rounded-md border border-border p-2">
111
- {value.map((item, idx) => (
112
+ <div className="mb-2 flex w-full flex-col gap-2 rounded-box border border-border p-2">
113
+ {items.map((item, idx) => (
112
114
  <>
113
115
  <div key={idx} className="flex h-full w-full items-center justify-between gap-2">
114
116
  {renderItem(item, idx)}
@@ -119,7 +121,7 @@ const List = <Item,>({
119
121
  "size-6 border-destructive p-0 text-destructive hover:bg-destructive hover:text-destructive-foreground",
120
122
  )}
121
123
  onClick={() => {
122
- onChange(value.filter((_, i) => i !== idx));
124
+ onChange(items.filter((_, i) => i !== idx));
123
125
  }}
124
126
  >
125
127
  <BiTrash />
@@ -181,11 +183,13 @@ const Text = ({
181
183
  inputClassName,
182
184
  inputStyleType = "bordered",
183
185
  }: TextProps) => {
186
+ useFieldTool(onChange, { transform, disabled });
184
187
  const { l } = usePage();
185
188
  return (
186
189
  <div className={cn("flex flex-col", className)}>
187
190
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
188
191
  <Input
192
+ {...agentAttrs(onChange)}
189
193
  cacheKey={cache ? `${label}-${desc}-text` : undefined}
190
194
  inputStyleType={inputStyleType}
191
195
  value={value ?? ""}
@@ -245,11 +249,13 @@ const Price = ({
245
249
  inputClassName,
246
250
  inputStyleType = "bordered",
247
251
  }: PriceProps) => {
252
+ useFieldTool(onChange, { transform, disabled });
248
253
  const { l } = usePage();
249
254
  return (
250
255
  <div className={cn("flex flex-col", className)}>
251
256
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
252
257
  <Input
258
+ {...agentAttrs(onChange)}
253
259
  inputStyleType={inputStyleType}
254
260
  value={value ?? ""}
255
261
  nullable={nullable}
@@ -311,11 +317,13 @@ const TextArea = ({
311
317
  cache,
312
318
  inputClassName,
313
319
  }: TextAreaProps) => {
320
+ useFieldTool(onChange, { transform, disabled });
314
321
  const { l } = usePage();
315
322
  return (
316
323
  <div className={cn("flex flex-col", className)}>
317
324
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
318
325
  <Input.TextArea
326
+ {...agentAttrs(onChange)}
319
327
  value={value ?? ""}
320
328
  cacheKey={cache ? `${label}-${desc}-textArea` : undefined}
321
329
  nullable={nullable}
@@ -344,7 +352,7 @@ interface SwitchProps {
344
352
  desc?: string;
345
353
  labelClassName?: string;
346
354
  className?: string;
347
- value: boolean;
355
+ value: boolean | null;
348
356
  onChange: (value: boolean) => void;
349
357
  inputClassName?: string;
350
358
  onDesc?: string;
@@ -363,15 +371,16 @@ const Switch = ({
363
371
  onDesc,
364
372
  offDesc,
365
373
  }: SwitchProps) => {
374
+ useFieldTool(onChange, { disabled });
366
375
  return (
367
- <div className={cn("flex flex-col", className)}>
376
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
368
377
  {label ? <Label className={labelClassName} nullable label={label} desc={desc} /> : null}
369
378
  <div className="flex items-center gap-2">
370
379
  <UiSwitch
371
380
  variant="accent"
372
381
  disabled={disabled}
373
382
  className={inputClassName}
374
- checked={value}
383
+ checked={value ?? false}
375
384
  onChange={(checked) => {
376
385
  onChange(checked);
377
386
  }}
@@ -383,7 +392,7 @@ const Switch = ({
383
392
  };
384
393
  Field.Switch = Switch;
385
394
 
386
- interface ToggleSelectProps<I> {
395
+ interface ToggleSelectProps<I, Nullable extends boolean> {
387
396
  className?: string;
388
397
  labelClassName?: string;
389
398
  label?: string;
@@ -391,14 +400,14 @@ interface ToggleSelectProps<I> {
391
400
  model?: string;
392
401
  field?: string;
393
402
  items: { label: string; value: I; disabled?: boolean }[] | readonly I[] | I[] | EnumInstance<string, I>;
394
- value: I;
395
- nullable?: boolean;
403
+ value: I | null;
404
+ nullable?: Nullable;
396
405
  disabled?: boolean;
397
406
  validate?: (value: I) => boolean | string;
398
- onChange: (value: I) => void;
407
+ onChange: (value: Nullable extends true ? I | null : I) => void;
399
408
  btnClassName?: string;
400
409
  }
401
- const ToggleSelect = <I extends string | number | boolean | null>({
410
+ const ToggleSelect = <I extends string | number | boolean | null, Nullable extends boolean = false>({
402
411
  className,
403
412
  labelClassName,
404
413
  label,
@@ -410,13 +419,15 @@ const ToggleSelect = <I extends string | number | boolean | null>({
410
419
  nullable,
411
420
  disabled,
412
421
  btnClassName,
413
- }: ToggleSelectProps<I>) => {
422
+ }: ToggleSelectProps<I, Nullable>) => {
423
+ useFieldTool(onChange, { disabled });
414
424
  const { l } = usePage();
415
425
  const isEnumValue = isEnum(items as EnumInstance<string, I>);
426
+ const change = onChange as (value: I | null) => void;
416
427
  return (
417
- <div className={cn("flex flex-col", className)}>
428
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
418
429
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
419
- <UtilToggleSelect
430
+ <UtilToggleSelect<I | null>
420
431
  className="mt-2"
421
432
  nullable={!!nullable}
422
433
  btnClassName={btnClassName}
@@ -429,12 +440,15 @@ const ToggleSelect = <I extends string | number | boolean | null>({
429
440
  : (items as { label: string; value: I; disabled?: boolean }[])
430
441
  }
431
442
  value={value}
432
- onChange={(value: I, idx) => {
433
- onChange(value);
443
+ onChange={(selected) => {
444
+ change(selected);
445
+ }}
446
+ onClear={() => {
447
+ change(null);
434
448
  }}
435
449
  disabled={disabled}
436
- validate={(value: I) => {
437
- return validate?.(value) ?? true;
450
+ validate={(selected) => {
451
+ return selected === null ? true : (validate?.(selected) ?? true);
438
452
  }}
439
453
  />
440
454
  </div>
@@ -448,7 +462,7 @@ interface MultiToggleSelectProps<I extends string | number | boolean> {
448
462
  label?: string;
449
463
  desc?: string;
450
464
  items: EnumInstance<string, I> | { label: string; value: I; disabled?: boolean }[] | readonly I[] | I[];
451
- value: I[];
465
+ value: I[] | null;
452
466
  disabled?: boolean;
453
467
  minlength?: number;
454
468
  maxlength?: number;
@@ -468,11 +482,12 @@ const MultiToggleSelect = <I extends string | number | boolean>({
468
482
  onChange,
469
483
  disabled,
470
484
  }: MultiToggleSelectProps<I>) => {
485
+ useFieldTool(onChange, { disabled });
471
486
  const { l } = usePage();
472
487
  const isEnumValue = isEnum(items as EnumInstance<string, I>);
473
488
  return (
474
- <div className={cn("flex flex-col", className)}>
475
- {label ? <Label className={labelClassName} nullable={!!minlength} label={label} desc={desc} /> : null}
489
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
490
+ {label ? <Label className={labelClassName} nullable={!minlength} label={label} desc={desc} /> : null}
476
491
  <UtilToggleSelect.Multi
477
492
  nullable={!minlength}
478
493
  items={
@@ -483,7 +498,7 @@ const MultiToggleSelect = <I extends string | number | boolean>({
483
498
  })) as { label: string; value: string; disabled?: boolean }[])
484
499
  : (items as { label: string; value: string; disabled?: boolean }[])
485
500
  }
486
- value={value as string[]}
501
+ value={(value ?? []) as string[]}
487
502
  onChange={(values) => {
488
503
  onChange(values as I[]);
489
504
  }}
@@ -504,7 +519,7 @@ interface TextListProps {
504
519
  desc?: string;
505
520
  labelClassName?: string;
506
521
  className?: string;
507
- value: string[];
522
+ value: string[] | null;
508
523
  onChange: (value: string[]) => void;
509
524
  inputClassName?: string;
510
525
  placeholder?: string;
@@ -535,20 +550,25 @@ const TextList = ({
535
550
  validate,
536
551
  inputClassName,
537
552
  }: TextListProps) => {
553
+ useFieldTool(onChange, { transform, disabled, sortable: true });
538
554
  const { l } = usePage();
539
555
  const recipe = useUiRecipe("button") ?? buttonRecipe;
556
+ const texts = value ?? [];
540
557
  return (
541
- <div className={cn("flex flex-col", className)}>
558
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
542
559
  {label ? <Label className={labelClassName} nullable={!minlength} label={label} desc={desc} /> : null}
543
- <div className="mb-5 h-full gap-2 rounded-md border border-border p-2">
560
+ <div className="mb-5 h-full gap-2 rounded-box border border-border p-2">
544
561
  <DraggableList
545
562
  className="h-full gap-2"
546
- onChange={onChange}
563
+
564
+ onChange={(sorted: string[]) => {
565
+ onChange(sorted);
566
+ }}
547
567
  onRemove={(_, idx) => {
548
- onChange(value.filter((_, i) => i !== idx));
568
+ onChange(texts.filter((_, i) => i !== idx));
549
569
  }}
550
570
  >
551
- {value.map((text, idx) => (
571
+ {texts.map((text, idx) => (
552
572
  <DraggableList.Item key={idx} value={text}>
553
573
  <div className="flex w-full items-center">
554
574
  <DraggableList.Cursor>
@@ -559,7 +579,7 @@ const TextList = ({
559
579
  value={text}
560
580
  cacheKey={cache ? `${label}-${desc}-textList-[${idx}]` : undefined}
561
581
  onChange={(text) => {
562
- const newValue = [...value];
582
+ const newValue = [...texts];
563
583
  newValue[idx] = transform(text);
564
584
  onChange(newValue);
565
585
  }}
@@ -579,7 +599,7 @@ const TextList = ({
579
599
  "size-6 border-destructive p-0 text-destructive hover:bg-destructive hover:text-destructive-foreground",
580
600
  )}
581
601
  onClick={() => {
582
- onChange(value.filter((_, i) => i !== idx));
602
+ onChange(texts.filter((_, i) => i !== idx));
583
603
  }}
584
604
  >
585
605
  <BiTrash />
@@ -590,11 +610,11 @@ const TextList = ({
590
610
  ))}
591
611
  </DraggableList>
592
612
  <div className="my-5 h-[0.5px] bg-foreground/20" />
593
- {value.length <= maxTextlength ? (
613
+ {texts.length <= maxTextlength ? (
594
614
  <button
595
615
  className={recipe({ variant: "outline" }, "w-full")}
596
616
  onClick={() => {
597
- onChange([...value, ""]);
617
+ onChange([...texts, ""]);
598
618
  }}
599
619
  >
600
620
  + New
@@ -611,7 +631,7 @@ interface TagsProps {
611
631
  desc?: string;
612
632
  labelClassName?: string;
613
633
  className?: string;
614
- value: string[];
634
+ value: string[] | null;
615
635
  onChange: (value: string[]) => void;
616
636
  inputClassName?: string;
617
637
  placeholder?: string;
@@ -641,29 +661,31 @@ const Tags = ({
641
661
  validate,
642
662
  inputClassName,
643
663
  }: TagsProps) => {
664
+ useFieldTool(onChange, { transform, disabled });
644
665
  const { l } = usePage();
645
666
  const badge = useUiRecipe("badge") ?? badgeRecipe;
667
+ const tagList = value ?? [];
646
668
  const [inputVisible, setInputVisible] = useState(false);
647
669
  const [tag, setTag] = useState("");
648
670
  const addTag = () => {
649
671
  if (!tag.length) return;
650
- onChange([...value, tag]);
672
+ onChange([...tagList, tag]);
651
673
  setInputVisible(false);
652
674
  setTag("");
653
675
  };
654
676
 
655
677
  return (
656
- <div className={cn("flex flex-col", className)}>
678
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
657
679
  {label ? <Label className={labelClassName} nullable={!minlength} label={label} desc={desc} /> : null}
658
- <div className="flex w-full flex-wrap items-center gap-1 rounded-md border border-foreground/20 p-2">
659
- {value.map((val, idx) => (
680
+ <div className="flex w-full flex-wrap items-center gap-1 rounded-box border border-border p-2">
681
+ {tagList.map((val, idx) => (
660
682
  <span className={badge({ variant: "outline" }, "items-center")} key={idx}>
661
683
  <div className="text-xs italic">#</div>
662
684
  {val}
663
685
  <BiX
664
686
  className="ml-1 cursor-pointer opacity-50 duration-200 hover:opacity-100"
665
687
  onClick={() => {
666
- if (!disabled) onChange(value.filter((v, i) => i !== idx));
688
+ if (!disabled) onChange(tagList.filter((v, i) => i !== idx));
667
689
  }}
668
690
  />
669
691
  </span>
@@ -735,8 +757,9 @@ const Date = <Nullable extends boolean>({
735
757
  showTime,
736
758
  dateClassName,
737
759
  }: DateProps<Nullable>) => {
760
+ useFieldTool(onChange);
738
761
  return (
739
- <div className={cn("flex flex-col", className)}>
762
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
740
763
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
741
764
  {/* FIXME: daysi UI datetime-local 컴포넌트에 max 값 넣으면 오른쪽 끝 짤리는 버그 있음.*/}
742
765
  <input
@@ -771,6 +794,7 @@ interface DateRangeProps<Nullable extends boolean> {
771
794
  showTime?: boolean;
772
795
  onChangeFrom: (value: Dayjs) => void;
773
796
  onChangeTo: (value: Dayjs) => void;
797
+ /** The whole range after either end moves. Fires only once both ends are set — nobody can query a half-open one. */
774
798
  onChange?: (from: Dayjs, to: Dayjs) => void;
775
799
  }
776
800
  const DateRange = <Nullable extends boolean>({
@@ -788,6 +812,24 @@ const DateRange = <Nullable extends boolean>({
788
812
  onChange,
789
813
  showTime,
790
814
  }: DateRangeProps<Nullable>) => {
815
+ /**
816
+ * Adds the pair callback to one endpoint setter, carrying that setter's own tag onto the wrapper.
817
+ *
818
+ * The wrapper really does run the setter, so the tag stays a true statement — and wiring `onChange` then costs
819
+ * the endpoint neither its agent tool nor its `data-akan-action`, which a plain closure would both drop.
820
+ */
821
+ const withPair = (setter: (value: Dayjs) => void, pair: (value: Dayjs) => [Dayjs | null, Dayjs | null]) => {
822
+ if (!onChange) return setter;
823
+ const wrapped = (value: Dayjs) => {
824
+ setter(value);
825
+ const [nextFrom, nextTo] = pair(value);
826
+ if (nextFrom && nextTo) onChange(nextFrom, nextTo);
827
+ };
828
+ const tag = actionTagOf(setter);
829
+ return tag ? tagAction(wrapped, tag) : wrapped;
830
+ };
831
+ const changeFrom = withPair(onChangeFrom, (value) => [value, to]);
832
+ const changeTo = withPair(onChangeTo, (value) => [from, value]);
791
833
  return (
792
834
  <div className={cn("flex flex-col", className)}>
793
835
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
@@ -802,9 +844,7 @@ const DateRange = <Nullable extends boolean>({
802
844
  value={from}
803
845
  max={max}
804
846
  min={min}
805
- onChange={(value: Dayjs) => {
806
- onChangeFrom(value);
807
- }}
847
+ onChange={changeFrom}
808
848
  />
809
849
  </div>
810
850
  <div className="relative flex w-full flex-col items-start gap-2 text-center md:flex-row md:items-center">
@@ -816,9 +856,7 @@ const DateRange = <Nullable extends boolean>({
816
856
  value={to}
817
857
  max={max}
818
858
  min={min}
819
- onChange={(value: Dayjs) => {
820
- onChangeTo(value);
821
- }}
859
+ onChange={changeTo}
822
860
  />
823
861
  </div>
824
862
  </div>
@@ -869,11 +907,13 @@ const Number = ({
869
907
  formatter,
870
908
  parser,
871
909
  }: NumberProps) => {
910
+ useFieldTool(onChange, { transform, disabled });
872
911
  const { l } = usePage();
873
912
  return (
874
913
  <div className={cn("flex flex-col", className)}>
875
914
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} unit={unit} /> : null}
876
915
  <Input.Number
916
+ {...agentAttrs(onChange)}
877
917
  min={min}
878
918
  max={max}
879
919
  cacheKey={cache ? `${label}-${desc}-number` : undefined}
@@ -939,9 +979,10 @@ const DoubleNumber = ({
939
979
  validate,
940
980
  onPressEnter,
941
981
  }: DoubleNumberProps) => {
982
+ useFieldTool(onChange, { transform, disabled });
942
983
  const { l } = usePage();
943
984
  return (
944
- <div className={cn("flex flex-col", className)}>
985
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
945
986
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
946
987
  <div className="flex items-center gap-2">
947
988
  <Input.Number
@@ -1026,11 +1067,13 @@ const Email = ({
1026
1067
  inputClassName,
1027
1068
  inputStyleType,
1028
1069
  }: EmailProps) => {
1070
+ useFieldTool(onChange, { transform, disabled });
1029
1071
  const { l } = usePage();
1030
1072
  return (
1031
1073
  <div className={cn("flex flex-col", className)}>
1032
1074
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1033
1075
  <Input.Email
1076
+ {...agentAttrs(onChange)}
1034
1077
  value={value ?? ""}
1035
1078
  cacheKey={cache ? `${label}-${desc}-email` : undefined}
1036
1079
  nullable={nullable}
@@ -1089,12 +1132,14 @@ const Phone = ({
1089
1132
  onPressEnter,
1090
1133
  inputClassName,
1091
1134
  }: PhoneProps) => {
1135
+ useFieldTool(onChange, { transform, disabled });
1092
1136
  const { l } = usePage();
1093
1137
 
1094
1138
  return (
1095
1139
  <div className={cn("flex flex-col", className)}>
1096
1140
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1097
1141
  <Input
1142
+ {...agentAttrs(onChange)}
1098
1143
  value={value ?? ""}
1099
1144
  cacheKey={cache ? `${label}-${desc}-phone` : undefined}
1100
1145
  nullable={nullable}
@@ -1159,12 +1204,14 @@ const Password = ({
1159
1204
  inputClassName,
1160
1205
  showConfirm,
1161
1206
  }: PasswordProps) => {
1207
+ useFieldTool(onChange, { transform, disabled });
1162
1208
  const { l } = usePage();
1163
1209
  return (
1164
1210
  <div className={cn("flex flex-col", className)}>
1165
1211
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1166
1212
  <div className="flex flex-col gap-2">
1167
1213
  <Input.Password
1214
+ {...agentAttrs(onChange)}
1168
1215
  cacheKey={cache ? `${label}-${desc}-password` : undefined}
1169
1216
  value={value ?? ""}
1170
1217
  nullable={nullable}
@@ -1221,6 +1268,12 @@ interface ParentProps<T extends string, State, Input, Full, Light> {
1221
1268
  renderOption: (model: Light) => ReactNode;
1222
1269
  renderSelected?: (value: Light) => ReactNode;
1223
1270
  }
1271
+ /** The one line an option renders as, so an agent can match an id against what it reads on screen. */
1272
+ const optionLabel = <Light extends { id: string }>(model: Light, render: (model: Light) => ReactNode) => {
1273
+ const rendered = render(model);
1274
+ return typeof rendered === "string" ? rendered : model.id;
1275
+ };
1276
+
1224
1277
  const Parent = <T extends string, State, Input, Full extends { id: string }, Light extends { id: string }>({
1225
1278
  label,
1226
1279
  desc,
@@ -1242,6 +1295,7 @@ const Parent = <T extends string, State, Input, Full extends { id: string }, Lig
1242
1295
  const [modelName, ModelName] = [lowerlize(refName), capitalize(refName)];
1243
1296
  const storeUse = st.use as { [key: string]: () => unknown };
1244
1297
  const storeDo = st.do as unknown as { [key: string]: (...args: any[]) => Promise<void> };
1298
+ const storeGet = st.get as unknown as <V>() => { [key: string]: V };
1245
1299
 
1246
1300
  const names = {
1247
1301
  model: modelName,
@@ -1258,9 +1312,15 @@ const Parent = <T extends string, State, Input, Full extends { id: string }, Lig
1258
1312
 
1259
1313
  const modelList = storeUse[namesOfSlice.modelList]() as DataList<Light>;
1260
1314
  const modelListLoading = storeUse[namesOfSlice.modelListLoading]() as string | boolean;
1315
+ useRelationFieldTool(onChange, {
1316
+ read: () => storeGet<DataList<Light>>()[namesOfSlice.modelList],
1317
+ load: () => storeDo[namesOfSlice.refreshModel]({ invalidate: true, queryArgs: initArgs }),
1318
+ label: (model) => optionLabel(model, renderOption),
1319
+ disabled,
1320
+ });
1261
1321
 
1262
1322
  return (
1263
- <div className={cn("flex flex-col", className)}>
1323
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
1264
1324
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1265
1325
  <Select<string | null, false, true>
1266
1326
  label={label}
@@ -1352,9 +1412,11 @@ const ParentId = <T extends string, State, Input, Full extends { id: string }, L
1352
1412
  };
1353
1413
  const modelList = storeUse[namesOfSlice.modelList]() as DataList<Light>;
1354
1414
  const modelListLoading = storeUse[namesOfSlice.modelListLoading]() as string | boolean;
1415
+
1416
+ useFieldTool(onChange, { disabled });
1355
1417
 
1356
1418
  return (
1357
- <div className={cn("flex flex-col", className)}>
1419
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
1358
1420
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1359
1421
  <Select<string | null, false, true>
1360
1422
  searchable
@@ -1400,7 +1462,7 @@ interface ChildrenProps<T extends string, State, Input, Full, Light> {
1400
1462
  disabled?: boolean;
1401
1463
  nullable?: boolean;
1402
1464
  initArgs?: any[];
1403
- value: Light[];
1465
+ value: Light[] | null;
1404
1466
  onChange: (value: Light[]) => void;
1405
1467
  onSearch?: (text: string) => void;
1406
1468
  slice: SliceMeta;
@@ -1443,9 +1505,15 @@ const Children = <T extends string, State, Input, Full extends { id: string }, L
1443
1505
  };
1444
1506
  const modelList = storeUse[namesOfSlice.modelList]() as DataList<Light>;
1445
1507
  const modelListLoading = storeUse[namesOfSlice.modelListLoading]() as string | boolean;
1508
+ useRelationFieldTool(onChange, {
1509
+ read: () => storeGet<DataList<Light>>()[namesOfSlice.modelList],
1510
+ load: () => storeDo[namesOfSlice.refreshModel]({ invalidate: true, queryArgs: initArgs }),
1511
+ label: (model) => optionLabel(model, renderOption),
1512
+ disabled,
1513
+ });
1446
1514
 
1447
1515
  return (
1448
- <div className={cn("flex flex-col", className)}>
1516
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
1449
1517
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1450
1518
  <Select
1451
1519
  searchable
@@ -1454,7 +1522,7 @@ const Children = <T extends string, State, Input, Full extends { id: string }, L
1454
1522
  labelClassName={labelClassName}
1455
1523
  selectClassName={selectClassName}
1456
1524
  multiple
1457
- value={value.map((model) => model.id)}
1525
+ value={(value ?? []).map((model) => model.id)}
1458
1526
  options={modelList.map((model) => {
1459
1527
  const label = renderOption(model);
1460
1528
  return { label: typeof label === "string" ? label : model.id, value: model.id };
@@ -1493,7 +1561,7 @@ interface ChildrenIdProps<T extends string, State, Input, Full, Light> {
1493
1561
  disabled?: boolean;
1494
1562
  nullable?: boolean;
1495
1563
  initArgs?: any[];
1496
- value: string[];
1564
+ value: string[] | null;
1497
1565
  slice: SliceMeta;
1498
1566
  onChange: (value: string[]) => void;
1499
1567
  onSearch?: (text: string) => void;
@@ -1533,9 +1601,11 @@ const ChildrenId = <T extends string, State, Input, Full extends { id: string },
1533
1601
  };
1534
1602
  const modelList = storeUse[namesOfSlice.modelList]() as DataList<Light>;
1535
1603
  const modelListLoading = storeUse[namesOfSlice.modelListLoading]() as string | boolean;
1604
+
1605
+ useFieldTool(onChange, { disabled });
1536
1606
 
1537
1607
  return (
1538
- <div className={cn("flex flex-col", className)}>
1608
+ <div {...agentAttrs(onChange)} className={cn("flex flex-col", className)}>
1539
1609
  {label ? <Label className={labelClassName} nullable={nullable} label={label} desc={desc} /> : null}
1540
1610
  <Select
1541
1611
  searchable
@@ -1544,7 +1614,7 @@ const ChildrenId = <T extends string, State, Input, Full extends { id: string },
1544
1614
  labelClassName={labelClassName}
1545
1615
  multiple
1546
1616
 
1547
- value={value}
1617
+ value={value ?? []}
1548
1618
  options={modelList.map((model) => {
1549
1619
  const label = renderOption(model);
1550
1620
  return { label: typeof label === "string" ? label : model.id, value: model.id };