@lowdefy/blocks-native 0.0.0-stage → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (419) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +9 -2
  3. package/dist/actions/AddCalendarEvent/AddCalendarEvent.js +31 -0
  4. package/dist/actions/AddCalendarEvent/schema.js +55 -0
  5. package/dist/actions/AddContact/AddContact.js +24 -0
  6. package/dist/actions/AddContact/schema.js +49 -0
  7. package/dist/actions/CancelNotification/CancelNotification.js +23 -0
  8. package/dist/actions/CancelNotification/schema.js +31 -0
  9. package/dist/actions/DiscardQueuedRequest/DiscardQueuedRequest.js +23 -0
  10. package/dist/actions/DiscardQueuedRequest/schema.js +31 -0
  11. package/dist/actions/GetCalendarEvents/GetCalendarEvents.js +32 -0
  12. package/dist/actions/GetCalendarEvents/schema.js +35 -0
  13. package/dist/actions/GetRequestQueue/GetRequestQueue.js +24 -0
  14. package/dist/actions/GetRequestQueue/schema.js +22 -0
  15. package/dist/actions/Haptic/Haptic.js +38 -0
  16. package/dist/actions/Haptic/schema.js +37 -0
  17. package/dist/actions/KeepAwake/KeepAwake.js +23 -0
  18. package/dist/actions/KeepAwake/schema.js +28 -0
  19. package/dist/actions/PickContact/PickContact.js +24 -0
  20. package/dist/actions/PickContact/schema.js +22 -0
  21. package/dist/actions/PickFile/PickFile.js +32 -0
  22. package/dist/actions/PickFile/schema.js +58 -0
  23. package/dist/actions/PickImage/PickImage.js +32 -0
  24. package/dist/actions/PickImage/schema.js +76 -0
  25. package/dist/actions/ReadNfc/ReadNfc.js +24 -0
  26. package/dist/actions/ReadNfc/schema.js +27 -0
  27. package/dist/actions/RefreshWidgets/RefreshWidgets.js +24 -0
  28. package/dist/actions/RefreshWidgets/schema.js +22 -0
  29. package/dist/actions/RequestNotificationPermission/RequestNotificationPermission.js +24 -0
  30. package/dist/actions/RequestNotificationPermission/schema.js +22 -0
  31. package/dist/actions/RetryRequestQueue/RetryRequestQueue.js +24 -0
  32. package/dist/actions/RetryRequestQueue/schema.js +27 -0
  33. package/dist/actions/ScanCode/ScanCode.js +24 -0
  34. package/dist/actions/ScanCode/schema.js +54 -0
  35. package/dist/actions/ScanDocument/ScanDocument.js +32 -0
  36. package/dist/actions/ScanDocument/schema.js +57 -0
  37. package/dist/actions/ScheduleNotification/ScheduleNotification.js +27 -0
  38. package/dist/actions/ScheduleNotification/schema.js +67 -0
  39. package/dist/actions/SetBadgeCount/SetBadgeCount.js +27 -0
  40. package/dist/actions/SetBadgeCount/schema.js +31 -0
  41. package/dist/actions/SetBrightness/SetBrightness.js +24 -0
  42. package/dist/actions/SetBrightness/schema.js +33 -0
  43. package/dist/actions/Share/Share.js +50 -0
  44. package/dist/actions/Share/schema.js +51 -0
  45. package/dist/actions/Speak/Speak.js +27 -0
  46. package/dist/actions/Speak/schema.js +44 -0
  47. package/dist/actions/StartGeofencing/StartGeofencing.js +29 -0
  48. package/dist/actions/StartGeofencing/schema.js +63 -0
  49. package/dist/actions/StartLocationTracking/StartLocationTracking.js +29 -0
  50. package/dist/actions/StartLocationTracking/schema.js +59 -0
  51. package/dist/actions/StartRecording/StartRecording.js +23 -0
  52. package/dist/actions/StartRecording/schema.js +32 -0
  53. package/dist/actions/StopGeofencing/StopGeofencing.js +23 -0
  54. package/dist/actions/StopGeofencing/schema.js +22 -0
  55. package/dist/actions/StopLocationTracking/StopLocationTracking.js +23 -0
  56. package/dist/actions/StopLocationTracking/schema.js +22 -0
  57. package/dist/actions/StopRecording/StopRecording.js +37 -0
  58. package/dist/actions/StopRecording/schema.js +46 -0
  59. package/dist/actions/StopSpeaking/StopSpeaking.js +23 -0
  60. package/dist/actions/StopSpeaking/schema.js +22 -0
  61. package/dist/actions/TakePhoto/TakePhoto.js +31 -0
  62. package/dist/actions/TakePhoto/schema.js +67 -0
  63. package/dist/actions/WriteNfc/WriteNfc.js +28 -0
  64. package/dist/actions/WriteNfc/schema.js +61 -0
  65. package/dist/actions/uploadFiles.js +51 -0
  66. package/dist/actions.js +47 -0
  67. package/dist/blocks/ActivityTimeline/ActivityTimeline.js +507 -0
  68. package/dist/blocks/ActivityTimeline/CommentBody.js +176 -0
  69. package/dist/blocks/ActivityTimeline/CommentItem.js +302 -0
  70. package/dist/blocks/ActivityTimeline/EditBox.js +143 -0
  71. package/dist/blocks/ActivityTimeline/LineText.js +71 -0
  72. package/dist/blocks/ActivityTimeline/RailIcon.js +41 -0
  73. package/dist/blocks/ActivityTimeline/RailRow.js +74 -0
  74. package/dist/blocks/ActivityTimeline/ReactionPicker.js +68 -0
  75. package/dist/blocks/ActivityTimeline/ReactionPills.js +112 -0
  76. package/dist/blocks/ActivityTimeline/ThreadCard.js +160 -0
  77. package/dist/blocks/ActivityTimeline/TimelineMarkdownRenderer.js +48 -0
  78. package/dist/blocks/ActivityTimeline/buildTimelineRows.js +194 -0
  79. package/dist/blocks/ActivityTimeline/describeEvent.js +61 -0
  80. package/dist/blocks/ActivityTimeline/describeGap.js +71 -0
  81. package/dist/blocks/ActivityTimeline/fillTemplate.js +84 -0
  82. package/dist/blocks/ActivityTimeline/fillText.js +38 -0
  83. package/dist/blocks/ActivityTimeline/formatRelativeTime.js +68 -0
  84. package/dist/blocks/ActivityTimeline/getActor.js +41 -0
  85. package/dist/blocks/ActivityTimeline/getCommentMenuActions.js +85 -0
  86. package/dist/blocks/ActivityTimeline/getCommentView.js +72 -0
  87. package/dist/blocks/ActivityTimeline/getTimelineColors.js +71 -0
  88. package/dist/blocks/ActivityTimeline/getToneColor.js +49 -0
  89. package/dist/blocks/ActivityTimeline/getVisibleReplies.js +36 -0
  90. package/dist/blocks/ActivityTimeline/isThreadShown.js +28 -0
  91. package/dist/blocks/ActivityTimeline/joinList.js +21 -0
  92. package/dist/blocks/ActivityTimeline/meta.js +320 -0
  93. package/dist/blocks/ActivityTimeline/parseTimelineHref.js +43 -0
  94. package/dist/blocks/ActivityTimeline/selectEventRule.js +69 -0
  95. package/dist/blocks/ActivityTimeline/summariseEvents.js +51 -0
  96. package/dist/blocks/ActivityTimeline/toPlainText.js +32 -0
  97. package/dist/blocks/ActivityTimeline/toTime.js +36 -0
  98. package/dist/blocks/ActivityTimeline/toTimelineMarkdown.js +57 -0
  99. package/dist/blocks/ActivityTimeline/toggleReaction.js +74 -0
  100. package/dist/blocks/ActivityTimeline/useNow.js +24 -0
  101. package/dist/blocks/AgentChat/AgentChat.js +726 -0
  102. package/dist/blocks/AgentChat/AssistantMessage.js +243 -0
  103. package/dist/blocks/AgentChat/ChatComposer.js +401 -0
  104. package/dist/blocks/AgentChat/ChatError.js +129 -0
  105. package/dist/blocks/AgentChat/ChatSkeleton.js +97 -0
  106. package/dist/blocks/AgentChat/ReasoningDisclosure.js +125 -0
  107. package/dist/blocks/AgentChat/ThinkingIndicator.js +103 -0
  108. package/dist/blocks/AgentChat/ThreadsSheet.js +347 -0
  109. package/dist/blocks/AgentChat/ToolApprovalCard.js +190 -0
  110. package/dist/blocks/AgentChat/ToolCallRow.js +187 -0
  111. package/dist/blocks/AgentChat/ToolDetail.js +137 -0
  112. package/dist/blocks/AgentChat/UserMessage.js +84 -0
  113. package/dist/blocks/AgentChat/WelcomeView.js +100 -0
  114. package/dist/blocks/AgentChat/createAgentTransport.js +74 -0
  115. package/dist/blocks/AgentChat/describeToolPart.js +133 -0
  116. package/dist/blocks/AgentChat/getChatSeed.js +44 -0
  117. package/dist/blocks/AgentChat/getFirstExchange.js +43 -0
  118. package/dist/blocks/AgentChat/getMessageSegments.js +73 -0
  119. package/dist/blocks/AgentChat/getMessageText.js +25 -0
  120. package/dist/blocks/AgentChat/getPageStateUpdates.js +47 -0
  121. package/dist/blocks/AgentChat/getProvisionalTitle.js +32 -0
  122. package/dist/blocks/AgentChat/getReadableRows.js +157 -0
  123. package/dist/blocks/AgentChat/getThreadEndpoints.js +54 -0
  124. package/dist/blocks/AgentChat/getToolIcon.js +110 -0
  125. package/dist/blocks/AgentChat/humanizeToolName.js +30 -0
  126. package/dist/blocks/AgentChat/messageParts.js +86 -0
  127. package/dist/blocks/AgentChat/meta.js +530 -0
  128. package/dist/blocks/AgentChat/mintConversationId.js +29 -0
  129. package/dist/blocks/AgentChat/replayableMessages.js +62 -0
  130. package/dist/blocks/AgentChat/showMessageMenu.js +49 -0
  131. package/dist/blocks/AgentChat/summarizeToolInput.js +36 -0
  132. package/dist/blocks/AgentChat/summarizeToolOutput.js +49 -0
  133. package/dist/blocks/AgentChat/useAgentEvents.js +218 -0
  134. package/dist/blocks/AgentChat/useChatDictation.js +151 -0
  135. package/dist/blocks/AgentChat/useChatThreads.js +450 -0
  136. package/dist/blocks/AgentChat/useFollowScroll.js +80 -0
  137. package/dist/blocks/AgentChat/useThinkingMessage.js +77 -0
  138. package/dist/blocks/Alert/Alert.js +167 -0
  139. package/dist/blocks/Alert/meta.js +200 -0
  140. package/dist/blocks/Avatar/Avatar.js +51 -0
  141. package/dist/blocks/Avatar/AvatarCircle.js +114 -0
  142. package/dist/blocks/Avatar/AvatarPhoto.js +68 -0
  143. package/dist/blocks/Avatar/AvatarStack.js +89 -0
  144. package/dist/blocks/Avatar/getAvatarColor.js +84 -0
  145. package/dist/blocks/Avatar/getAvatarImage.js +97 -0
  146. package/dist/blocks/Avatar/getInitials.js +51 -0
  147. package/dist/blocks/Avatar/meta.js +57 -0
  148. package/dist/blocks/Box/Box.js +118 -0
  149. package/dist/blocks/Box/getRubberBand.js +29 -0
  150. package/dist/blocks/Box/getSwipeDirection.js +45 -0
  151. package/dist/blocks/Box/isSwipeGesture.js +41 -0
  152. package/dist/blocks/Box/meta.js +46 -0
  153. package/dist/blocks/Box/useSwipeGesture.js +113 -0
  154. package/dist/blocks/Button/Button.js +136 -0
  155. package/dist/blocks/Button/getButtonColors.js +216 -0
  156. package/dist/blocks/Button/meta.js +137 -0
  157. package/dist/blocks/Card/Card.js +185 -0
  158. package/dist/blocks/Card/meta.js +203 -0
  159. package/dist/blocks/ChipSelector/Chip.js +178 -0
  160. package/dist/blocks/ChipSelector/ChipSelector.js +313 -0
  161. package/dist/blocks/ChipSelector/EdgeFade.js +68 -0
  162. package/dist/blocks/ChipSelector/getChipColors.js +88 -0
  163. package/dist/blocks/ChipSelector/getFadeRanges.js +55 -0
  164. package/dist/blocks/ChipSelector/getOverscrollSwipe.js +44 -0
  165. package/dist/blocks/ChipSelector/getScrollTarget.js +41 -0
  166. package/dist/blocks/ChipSelector/meta.js +156 -0
  167. package/dist/blocks/Composer/Composer.js +511 -0
  168. package/dist/blocks/Composer/MentionTextInput.js +91 -0
  169. package/dist/blocks/Composer/SuggestionList.js +165 -0
  170. package/dist/blocks/Composer/applyDisplayEdit.js +81 -0
  171. package/dist/blocks/Composer/convertSpokenMentions.js +234 -0
  172. package/dist/blocks/Composer/createMentionPattern.js +40 -0
  173. package/dist/blocks/Composer/findTrigger.js +51 -0
  174. package/dist/blocks/Composer/getSendState.js +38 -0
  175. package/dist/blocks/Composer/getSpokenMentionWords.js +35 -0
  176. package/dist/blocks/Composer/indexSpokenNames.js +50 -0
  177. package/dist/blocks/Composer/insertLink.js +36 -0
  178. package/dist/blocks/Composer/insertMention.js +43 -0
  179. package/dist/blocks/Composer/matchSpokenName.js +88 -0
  180. package/dist/blocks/Composer/meta.js +212 -0
  181. package/dist/blocks/Composer/parseMentionValue.js +55 -0
  182. package/dist/blocks/Composer/placeDictation.js +51 -0
  183. package/dist/blocks/Composer/rankMentions.js +51 -0
  184. package/dist/blocks/Composer/replaceRange.js +48 -0
  185. package/dist/blocks/Composer/segmentText.js +78 -0
  186. package/dist/blocks/Composer/shiftOffset.js +37 -0
  187. package/dist/blocks/Composer/snapSelection.js +37 -0
  188. package/dist/blocks/Composer/useMentionEditor.js +381 -0
  189. package/dist/blocks/Composer/withPartial.js +50 -0
  190. package/dist/blocks/DateSelector/DateSelector.js +250 -0
  191. package/dist/blocks/DateSelector/formatDateValue.js +34 -0
  192. package/dist/blocks/DateSelector/getDateMenuActions.js +96 -0
  193. package/dist/blocks/DateSelector/meta.js +109 -0
  194. package/dist/blocks/DateSelector/toBoundDate.js +40 -0
  195. package/dist/blocks/DateSelector/toPickerDate.js +31 -0
  196. package/dist/blocks/DateSelector/toUtcDay.js +25 -0
  197. package/dist/blocks/Divider/Divider.js +159 -0
  198. package/dist/blocks/Divider/meta.js +108 -0
  199. package/dist/blocks/Empty/Empty.js +107 -0
  200. package/dist/blocks/Empty/meta.js +61 -0
  201. package/dist/blocks/FileInput/FileInput.js +253 -0
  202. package/dist/blocks/FileInput/formatFileSize.js +28 -0
  203. package/dist/blocks/FileInput/getFileSources.js +48 -0
  204. package/dist/blocks/FileInput/meta.js +123 -0
  205. package/dist/blocks/Icon/Icon.js +41 -0
  206. package/dist/blocks/Icon/meta.js +80 -0
  207. package/dist/blocks/Illustration/Illustration.js +154 -0
  208. package/dist/blocks/Illustration/IllustrationLayer.js +105 -0
  209. package/dist/blocks/Illustration/colorNodes.js +72 -0
  210. package/dist/blocks/Illustration/createIllustrationMotion.js +172 -0
  211. package/dist/blocks/Illustration/getIllustrationBox.js +54 -0
  212. package/dist/blocks/Illustration/getIllustrationColors.js +48 -0
  213. package/dist/blocks/Illustration/getKeyframeRange.js +99 -0
  214. package/dist/blocks/Illustration/getLayerBounds.js +74 -0
  215. package/dist/blocks/Illustration/getLayers.js +113 -0
  216. package/dist/blocks/Illustration/getNodePoints.js +210 -0
  217. package/dist/blocks/Illustration/meta.js +196 -0
  218. package/dist/blocks/Illustration/parseIllustration.js +84 -0
  219. package/dist/blocks/Illustration/toBoundingBoxGradients.js +188 -0
  220. package/dist/blocks/Illustration/useIllustrationMotion.js +75 -0
  221. package/dist/blocks/Label/Label.js +111 -0
  222. package/dist/blocks/Label/getLabelProperties.js +38 -0
  223. package/dist/blocks/Label/getLabelState.js +59 -0
  224. package/dist/blocks/List/List.js +159 -0
  225. package/dist/blocks/List/ListRow.js +74 -0
  226. package/dist/blocks/List/ListRowContext.js +20 -0
  227. package/dist/blocks/List/SectionHeader.js +119 -0
  228. package/dist/blocks/List/getSections.js +161 -0
  229. package/dist/blocks/List/meta.js +190 -0
  230. package/dist/blocks/ListItem/ListItem.js +440 -0
  231. package/dist/blocks/ListItem/ListItemContextMenu.js +58 -0
  232. package/dist/blocks/ListItem/getListItemParts.js +101 -0
  233. package/dist/blocks/ListItem/getSfSymbol.js +33 -0
  234. package/dist/blocks/ListItem/meta.js +284 -0
  235. package/dist/blocks/Map/Map.js +78 -0
  236. package/dist/blocks/Map/meta.js +153 -0
  237. package/dist/blocks/Markdown/ChipWidthContext.js +20 -0
  238. package/dist/blocks/Markdown/ChipWidthView.js +40 -0
  239. package/dist/blocks/Markdown/LinkChip.js +151 -0
  240. package/dist/blocks/Markdown/Markdown.js +70 -0
  241. package/dist/blocks/Markdown/MarkdownCode.js +67 -0
  242. package/dist/blocks/Markdown/MarkdownContent.js +119 -0
  243. package/dist/blocks/Markdown/MarkdownImage.js +77 -0
  244. package/dist/blocks/Markdown/MarkdownList.js +97 -0
  245. package/dist/blocks/Markdown/MarkdownListContext.js +22 -0
  246. package/dist/blocks/Markdown/MarkdownRenderer.js +231 -0
  247. package/dist/blocks/Markdown/MarkdownTable.js +96 -0
  248. package/dist/blocks/Markdown/MarkdownTokenizer.js +43 -0
  249. package/dist/blocks/Markdown/TaskBox.js +58 -0
  250. package/dist/blocks/Markdown/TaskMark.js +37 -0
  251. package/dist/blocks/Markdown/getChipMaxWidth.js +33 -0
  252. package/dist/blocks/Markdown/getLinkChip.js +95 -0
  253. package/dist/blocks/Markdown/getLinkChipColors.js +51 -0
  254. package/dist/blocks/Markdown/getListMarker.js +116 -0
  255. package/dist/blocks/Markdown/getMarkdownStyles.js +206 -0
  256. package/dist/blocks/Markdown/getNodeText.js +37 -0
  257. package/dist/blocks/Markdown/layoutLinkChips.js +209 -0
  258. package/dist/blocks/Markdown/matchLinkChip.js +82 -0
  259. package/dist/blocks/Markdown/meta.js +56 -0
  260. package/dist/blocks/Markdown/restyleText.js +40 -0
  261. package/dist/blocks/Markdown/trimOuterSpace.js +42 -0
  262. package/dist/blocks/Menu/Menu.js +96 -0
  263. package/dist/blocks/Menu/getMenuActions.js +66 -0
  264. package/dist/blocks/Menu/meta.js +159 -0
  265. package/dist/blocks/MultipleSelector/MultipleSelector.js +290 -0
  266. package/dist/blocks/MultipleSelector/MultipleSelectorRow.js +71 -0
  267. package/dist/blocks/MultipleSelector/ValueSummary.js +130 -0
  268. package/dist/blocks/MultipleSelector/getOptionIndices.js +30 -0
  269. package/dist/blocks/MultipleSelector/getSessionOptions.js +38 -0
  270. package/dist/blocks/MultipleSelector/getSummaryCount.js +35 -0
  271. package/dist/blocks/MultipleSelector/meta.js +284 -0
  272. package/dist/blocks/MultipleSelector/toggleValue.js +50 -0
  273. package/dist/blocks/NumberInput/NumberInput.js +251 -0
  274. package/dist/blocks/NumberInput/StepButton.js +46 -0
  275. package/dist/blocks/NumberInput/formatNumber.js +35 -0
  276. package/dist/blocks/NumberInput/getNumberKeyboardType.js +32 -0
  277. package/dist/blocks/NumberInput/meta.js +123 -0
  278. package/dist/blocks/NumberInput/normalizeNumber.js +38 -0
  279. package/dist/blocks/NumberInput/parseNumberText.js +46 -0
  280. package/dist/blocks/PageDots/PageDots.js +131 -0
  281. package/dist/blocks/PageDots/meta.js +48 -0
  282. package/dist/blocks/Paragraph/Paragraph.js +52 -0
  283. package/dist/blocks/Paragraph/meta.js +295 -0
  284. package/dist/blocks/QRScanner/QRScanner.js +94 -0
  285. package/dist/blocks/QRScanner/createScanFilter.js +44 -0
  286. package/dist/blocks/QRScanner/meta.js +80 -0
  287. package/dist/blocks/Screen/meta.js +197 -0
  288. package/dist/blocks/SegmentedControl/SegmentedControl.js +77 -0
  289. package/dist/blocks/SegmentedControl/meta.js +78 -0
  290. package/dist/blocks/Selector/NoValueAvatar.js +42 -0
  291. package/dist/blocks/Selector/PickerOptionRow.js +130 -0
  292. package/dist/blocks/Selector/PickerRowLeading.js +57 -0
  293. package/dist/blocks/Selector/PickerSearchField.js +85 -0
  294. package/dist/blocks/Selector/PickerSheet.js +239 -0
  295. package/dist/blocks/Selector/Selector.js +122 -0
  296. package/dist/blocks/Selector/SelectorMenu.js +97 -0
  297. package/dist/blocks/Selector/SelectorRow.js +86 -0
  298. package/dist/blocks/Selector/SelectorSheet.js +131 -0
  299. package/dist/blocks/Selector/getOptionIndex.js +39 -0
  300. package/dist/blocks/Selector/getOptionLabel.js +32 -0
  301. package/dist/blocks/Selector/getOptionValue.js +20 -0
  302. package/dist/blocks/Selector/getPickerSheetDetents.js +45 -0
  303. package/dist/blocks/Selector/getPickerSheetRows.js +174 -0
  304. package/dist/blocks/Selector/getPickerSheetScrollIndex.js +35 -0
  305. package/dist/blocks/Selector/getSelectorMenuActions.js +61 -0
  306. package/dist/blocks/Selector/meta.js +195 -0
  307. package/dist/blocks/Selector/normalizeSearchText.js +27 -0
  308. package/dist/blocks/Selector/setSelectorValue.js +54 -0
  309. package/dist/blocks/Sheet/Sheet.js +174 -0
  310. package/dist/blocks/Sheet/getSheetDetents.js +56 -0
  311. package/dist/blocks/Sheet/meta.js +72 -0
  312. package/dist/blocks/SignaturePad/SignaturePad.js +182 -0
  313. package/dist/blocks/SignaturePad/meta.js +74 -0
  314. package/dist/blocks/SignaturePad/toSignatureValue.js +52 -0
  315. package/dist/blocks/Skeleton/Skeleton.js +131 -0
  316. package/dist/blocks/Skeleton/SkeletonCard.js +42 -0
  317. package/dist/blocks/Skeleton/SkeletonHero.js +72 -0
  318. package/dist/blocks/Skeleton/SkeletonInsetGroup.js +82 -0
  319. package/dist/blocks/Skeleton/SkeletonListRow.js +90 -0
  320. package/dist/blocks/Skeleton/SkeletonParagraph.js +36 -0
  321. package/dist/blocks/Skeleton/SkeletonRows.js +58 -0
  322. package/dist/blocks/Skeleton/SkeletonTimeline.js +88 -0
  323. package/dist/blocks/Skeleton/getBarWidth.js +45 -0
  324. package/dist/blocks/Skeleton/getParagraphWidths.js +56 -0
  325. package/dist/blocks/Skeleton/getSectionCounts.js +33 -0
  326. package/dist/blocks/Skeleton/getSkeletonVariant.js +27 -0
  327. package/dist/blocks/Skeleton/meta.js +98 -0
  328. package/dist/blocks/Spinner/Spinner.js +68 -0
  329. package/dist/blocks/Spinner/meta.js +35 -0
  330. package/dist/blocks/StatusIcon/StatusGlyph.js +247 -0
  331. package/dist/blocks/StatusIcon/StatusIcon.js +34 -0
  332. package/dist/blocks/StatusIcon/StatusMark.js +87 -0
  333. package/dist/blocks/StatusIcon/getPiePath.js +41 -0
  334. package/dist/blocks/StatusIcon/getStatusColor.js +61 -0
  335. package/dist/blocks/StatusIcon/meta.js +38 -0
  336. package/dist/blocks/StatusIcon/statusLabels.js +33 -0
  337. package/dist/blocks/Switch/Switch.js +85 -0
  338. package/dist/blocks/Switch/meta.js +78 -0
  339. package/dist/blocks/Tabs/Tabs.js +269 -0
  340. package/dist/blocks/Tabs/meta.js +305 -0
  341. package/dist/blocks/Tag/TONE_PALETTES.js +34 -0
  342. package/dist/blocks/Tag/Tag.js +173 -0
  343. package/dist/blocks/Tag/getTagColors.js +120 -0
  344. package/dist/blocks/Tag/getTagDotColor.js +32 -0
  345. package/dist/blocks/Tag/meta.js +131 -0
  346. package/dist/blocks/TextArea/ComposerSendButton.js +69 -0
  347. package/dist/blocks/TextArea/TextArea.js +167 -0
  348. package/dist/blocks/TextArea/meta.js +96 -0
  349. package/dist/blocks/TextInput/TextInput.js +253 -0
  350. package/dist/blocks/TextInput/applyReplaceInput.js +30 -0
  351. package/dist/blocks/TextInput/getKeyboardProps.js +64 -0
  352. package/dist/blocks/TextInput/getSearchBoxStyle.js +39 -0
  353. package/dist/blocks/TextInput/meta.js +113 -0
  354. package/dist/blocks/Title/Title.js +62 -0
  355. package/dist/blocks/Title/meta.js +355 -0
  356. package/dist/blocks.js +52 -0
  357. package/dist/device/getDeviceFeature.js +81 -0
  358. package/dist/device/playFeedback.js +32 -0
  359. package/dist/device.js +18 -0
  360. package/dist/dictation.js +17 -0
  361. package/dist/htmlToText.js +32 -0
  362. package/dist/metas.js +53 -0
  363. package/dist/schemas/avatar.js +40 -0
  364. package/dist/schemas/icon.js +65 -0
  365. package/dist/schemas/inputLabel.js +96 -0
  366. package/dist/schemas/inputProperties.js +92 -0
  367. package/dist/schemas/linkChips.js +85 -0
  368. package/dist/schemas/status.js +75 -0
  369. package/dist/schemas/textStyle.js +33 -0
  370. package/dist/schemas/tone.js +28 -0
  371. package/dist/schemas.js +47 -0
  372. package/dist/shared/ClearButton.js +53 -0
  373. package/dist/shared/CountText.js +38 -0
  374. package/dist/shared/MissingFeature.js +43 -0
  375. package/dist/shared/NativeMenu.js +69 -0
  376. package/dist/shared/OptionGlyph.js +59 -0
  377. package/dist/shared/PropertyRow.js +89 -0
  378. package/dist/shared/SheetCloseButton.js +51 -0
  379. package/dist/shared/SheetDoneButton.js +44 -0
  380. package/dist/shared/SwipeContext.js +20 -0
  381. package/dist/shared/SwipeableRow.js +294 -0
  382. package/dist/shared/SystemIcon.js +72 -0
  383. package/dist/shared/dictation/DictationButton.js +77 -0
  384. package/dist/shared/dictation/DictationWarning.js +89 -0
  385. package/dist/shared/dictation/LevelMeter.js +57 -0
  386. package/dist/shared/dictation/ListeningRow.js +100 -0
  387. package/dist/shared/dictation/PartialSpans.js +50 -0
  388. package/dist/shared/dictation/checkDictationAvailable.js +65 -0
  389. package/dist/shared/dictation/claimMic.js +68 -0
  390. package/dist/shared/dictation/createQueuedRecognizer.js +213 -0
  391. package/dist/shared/dictation/getDictationLevel.js +30 -0
  392. package/dist/shared/dictation/getDictationWarning.js +40 -0
  393. package/dist/shared/dictation/getLevelBars.js +38 -0
  394. package/dist/shared/dictation/getRecognizer.js +46 -0
  395. package/dist/shared/dictation/getStartOptions.js +42 -0
  396. package/dist/shared/dictation/insertAtSelection.js +48 -0
  397. package/dist/shared/dictation/pickRecognitionLocale.js +37 -0
  398. package/dist/shared/dictation/useDictation.js +299 -0
  399. package/dist/shared/getControlSize.js +50 -0
  400. package/dist/shared/getInputBoxStyle.js +93 -0
  401. package/dist/shared/getPropertyRowTextStyles.js +40 -0
  402. package/dist/shared/getSemanticColors.js +96 -0
  403. package/dist/shared/getToneColor.js +51 -0
  404. package/dist/shared/iosTextStyles.js +49 -0
  405. package/dist/shared/useBlockTokens.js +41 -0
  406. package/dist/skeleton/SkeletonFrameContext.js +21 -0
  407. package/dist/skeleton/SkeletonLine.js +46 -0
  408. package/dist/skeleton/SkeletonShape.js +140 -0
  409. package/dist/skeleton/createShimmerClock.js +57 -0
  410. package/dist/skeleton/shimmerClock.js +20 -0
  411. package/dist/skeleton/skeletonText.js +44 -0
  412. package/dist/skeleton/useShimmer.js +34 -0
  413. package/dist/types.js +23 -0
  414. package/dist/typography/TITLE_LEVEL_STYLES.js +24 -0
  415. package/dist/typography/TypographyText.js +78 -0
  416. package/dist/typography/getIosTextStyle.js +33 -0
  417. package/dist/typography/getTextStyle.js +94 -0
  418. package/dist/useComponentTokens.js +38 -0
  419. package/package.json +94 -3
@@ -0,0 +1,450 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
16
+ import { type } from '@lowdefy/helpers';
17
+ import getChatSeed from './getChatSeed.js';
18
+ import getFirstExchange from './getFirstExchange.js';
19
+ import getMessageText from './getMessageText.js';
20
+ import getProvisionalTitle from './getProvisionalTitle.js';
21
+ import getThreadEndpoints from './getThreadEndpoints.js';
22
+ import mintConversationId from './mintConversationId.js';
23
+ import replayableMessages from './replayableMessages.js';
24
+ const THREADS_EVENT = '__agentThreads';
25
+ function newThreadState({ scope, seed = null }) {
26
+ return {
27
+ id: mintConversationId({
28
+ scope
29
+ }),
30
+ messages: [],
31
+ provisionalTitle: null,
32
+ seed,
33
+ title: seed?.title ?? null
34
+ };
35
+ }
36
+ function userMessageIds(messages) {
37
+ return new Set(messages.filter((message)=>message.role === 'user').map(({ id })=>id));
38
+ }
39
+ /**
40
+ * The chat's threads, kept through the app's thread endpoints (the ai-assistant module's, or the
41
+ * app's own of the same shape) when the `threads` property is set, as the module's panel keeps
42
+ * them on the web:
43
+ *
44
+ * - On mount, the thread last opened in the scope is resumed (getActiveThread), unless
45
+ * `threads.resume` is false. A chat the person starts (newChat) or opens while it loads cancels
46
+ * the resume, so the answer does not replace it.
47
+ * - A thread is saved (saveThread) when the person sends in it, named by their first message, and
48
+ * again when each reply finishes; after the first reply it is named from the first exchange
49
+ * (titleThread).
50
+ * - The list (listThreads) is read when the threads sheet opens; a thread opens with its stored
51
+ * messages (getThread) and is deleted with deleteThread. A new chat is minted on the phone and
52
+ * stored on its first message.
53
+ * - A new chat can start from a seed (getChatSeed): the `seed` property when the chat mounts with
54
+ * no thread resumed, or the newChat method's args. The thread keeps it as `seed` for the block
55
+ * (its welcome, input and shared state), saves it with the seed's tag, and keeps the seed's
56
+ * title rather than naming itself.
57
+ *
58
+ * Without `threads`, the conversation is the `conversationId` property (or one minted for the
59
+ * block) and nothing is kept, as the web block does.
60
+ *
61
+ * The endpoints are called through one internal event running CallAPI.
62
+ *
63
+ * @param {Object} params
64
+ * @param {{ current: Object[] }} params.messagesRef The chat's messages as last rendered.
65
+ * @param {Object} params.methods The block methods.
66
+ * @param {(messages: Object[]) => void} params.onThreadLoaded Called with a thread's stored
67
+ * messages as it opens, before it shows.
68
+ * @param {Object} params.properties The block properties.
69
+ */ function useChatThreads({ messagesRef, methods, onThreadLoaded, properties }) {
70
+ const threadsConfig = properties.threads;
71
+ const threadsKey = JSON.stringify(threadsConfig ?? null);
72
+ const endpoints = useMemo(()=>getThreadEndpoints(threadsConfig), [
73
+ threadsKey
74
+ ]); // eslint-disable-line react-hooks/exhaustive-deps
75
+ const managed = endpoints !== null;
76
+ const scope = type.isString(threadsConfig?.scope) ? threadsConfig.scope : null;
77
+ const canResume = managed && threadsConfig.resume !== false && endpoints.getActiveThread !== null;
78
+ const [thread, setThread] = useState(()=>newThreadState({
79
+ scope,
80
+ seed: getChatSeed(properties.seed)
81
+ }));
82
+ const [resuming, setResuming] = useState(canResume);
83
+ // A resume still waiting on getActiveThread. A chat the person starts or opens meanwhile wins.
84
+ const resumePendingRef = useRef(canResume);
85
+ const [list, setList] = useState({
86
+ status: 'idle',
87
+ items: []
88
+ });
89
+ const [openingId, setOpeningId] = useState(null);
90
+ const threadRef = useRef(thread);
91
+ threadRef.current = thread;
92
+ // User messages already saved, or loaded with a stored thread, so each is saved once.
93
+ const savedUserIdsRef = useRef(new Set());
94
+ // The thread a reply streams into, with its seed's tag, so a reply that finishes after a switch
95
+ // is saved to its own.
96
+ const streamThreadRef = useRef(null);
97
+ const conversationId = managed ? thread.id : properties.conversationId ?? thread.id;
98
+ useEffect(()=>{
99
+ methods.registerEvent({
100
+ name: THREADS_EVENT,
101
+ actions: [
102
+ {
103
+ id: 'call',
104
+ type: 'CallAPI',
105
+ params: {
106
+ endpointId: {
107
+ _event: 'endpointId'
108
+ },
109
+ payload: {
110
+ _event: 'payload'
111
+ }
112
+ }
113
+ }
114
+ ]
115
+ });
116
+ }, [
117
+ methods
118
+ ]);
119
+ const callEndpoint = useCallback(async (key, payload)=>{
120
+ const result = await methods.triggerEvent({
121
+ name: THREADS_EVENT,
122
+ event: {
123
+ endpointId: endpoints[key],
124
+ payload
125
+ }
126
+ });
127
+ if (result.success !== true) {
128
+ throw result.error ?? new Error(`Thread endpoint "${endpoints[key]}" failed.`);
129
+ }
130
+ return result.responses.call.response.response;
131
+ }, [
132
+ endpoints,
133
+ methods
134
+ ]);
135
+ const cancelResume = useCallback(()=>{
136
+ if (!resumePendingRef.current) return;
137
+ resumePendingRef.current = false;
138
+ setResuming(false);
139
+ }, []);
140
+ const showThread = useCallback((next)=>{
141
+ cancelResume();
142
+ savedUserIdsRef.current = userMessageIds(next.messages);
143
+ onThreadLoaded(next.messages);
144
+ setThread(next);
145
+ methods.triggerEvent({
146
+ name: 'onThreadChange',
147
+ event: {
148
+ conversationId: next.id,
149
+ title: next.title
150
+ }
151
+ });
152
+ }, [
153
+ cancelResume,
154
+ methods,
155
+ onThreadLoaded
156
+ ]);
157
+ useEffect(()=>{
158
+ if (!canResume) return undefined;
159
+ let current = true;
160
+ callEndpoint('getActiveThread', {
161
+ scope
162
+ }).then((active)=>{
163
+ if (!current || !resumePendingRef.current || type.isNone(active?.conversationId)) return;
164
+ const messages = replayableMessages({
165
+ messages: active.messages ?? []
166
+ });
167
+ savedUserIdsRef.current = userMessageIds(messages);
168
+ onThreadLoaded(messages);
169
+ setThread({
170
+ id: active.conversationId,
171
+ messages,
172
+ provisionalTitle: null,
173
+ seed: null,
174
+ title: active.title ?? null
175
+ });
176
+ }).catch(()=>undefined).finally(()=>{
177
+ if (!current) return;
178
+ resumePendingRef.current = false;
179
+ setResuming(false);
180
+ });
181
+ return ()=>{
182
+ current = false;
183
+ };
184
+ }, []); // eslint-disable-line react-hooks/exhaustive-deps
185
+ const saveThread = useCallback(async ({ id, messages, tag, title })=>{
186
+ if (!managed || endpoints.saveThread === null) return;
187
+ let savedTag = null;
188
+ if (type.isString(tag)) {
189
+ savedTag = tag;
190
+ } else if (type.isString(threadsConfig.tag)) {
191
+ savedTag = threadsConfig.tag;
192
+ }
193
+ await callEndpoint('saveThread', {
194
+ conversationId: id,
195
+ messages: replayableMessages({
196
+ messages
197
+ }),
198
+ ...type.isString(title) ? {
199
+ title
200
+ } : {},
201
+ ...scope === null ? {} : {
202
+ scope
203
+ },
204
+ tag: savedTag
205
+ });
206
+ }, [
207
+ callEndpoint,
208
+ endpoints,
209
+ managed,
210
+ scope,
211
+ threadsConfig
212
+ ]);
213
+ const renameInList = useCallback((id, title)=>{
214
+ setList((prev)=>{
215
+ if (prev.items.some((item)=>item.key === id)) {
216
+ return {
217
+ ...prev,
218
+ items: prev.items.map((item)=>item.key === id ? {
219
+ ...item,
220
+ label: title
221
+ } : item)
222
+ };
223
+ }
224
+ return {
225
+ ...prev,
226
+ items: [
227
+ {
228
+ key: id,
229
+ label: title,
230
+ tags: []
231
+ },
232
+ ...prev.items
233
+ ]
234
+ };
235
+ });
236
+ }, []);
237
+ // A request to the agent, as it is made, from the conversation whose transport made it. Its
238
+ // reply is saved to that thread when it finishes. A message the person just sent names a new
239
+ // thread and is kept now, before the reply can finish.
240
+ const onRequest = useCallback(({ conversationId: requestId, messages, trigger })=>{
241
+ if (!managed) return;
242
+ const current = threadRef.current;
243
+ const tag = current.id === requestId ? current.seed?.tag ?? null : null;
244
+ streamThreadRef.current = {
245
+ id: requestId,
246
+ tag
247
+ };
248
+ const last = messages[messages.length - 1];
249
+ if (trigger !== 'submit-message' || last?.role !== 'user') return;
250
+ if (savedUserIdsRef.current.has(last.id)) return;
251
+ savedUserIdsRef.current.add(last.id);
252
+ if (current.id !== requestId) return;
253
+ let { title } = current;
254
+ if (title === null) {
255
+ title = getProvisionalTitle(getMessageText(last));
256
+ if (title !== null) {
257
+ // Read by a reply that finishes before the next render.
258
+ threadRef.current = {
259
+ ...current,
260
+ provisionalTitle: title,
261
+ title
262
+ };
263
+ setThread((prev)=>prev.id === current.id ? {
264
+ ...prev,
265
+ provisionalTitle: title,
266
+ title
267
+ } : prev);
268
+ renameInList(current.id, title);
269
+ }
270
+ }
271
+ saveThread({
272
+ id: current.id,
273
+ messages,
274
+ tag,
275
+ title
276
+ }).catch(()=>undefined);
277
+ }, [
278
+ managed,
279
+ renameInList,
280
+ saveThread
281
+ ]);
282
+ // A reply finished (or was stopped): keep it, and name the thread from its first exchange.
283
+ const onReplyFinished = useCallback(async (messages)=>{
284
+ if (!managed) return;
285
+ const current = threadRef.current;
286
+ const stream = streamThreadRef.current ?? {
287
+ id: current.id,
288
+ tag: current.seed?.tag ?? null
289
+ };
290
+ const { id } = stream;
291
+ const sameThread = id === current.id;
292
+ try {
293
+ await saveThread({
294
+ id,
295
+ messages,
296
+ tag: stream.tag,
297
+ title: sameThread ? current.title : null
298
+ });
299
+ } catch (error) {
300
+ return;
301
+ }
302
+ if (!sameThread || endpoints.titleThread === null) return;
303
+ const exchange = getFirstExchange({
304
+ messages,
305
+ provisionalTitle: current.provisionalTitle,
306
+ title: current.title
307
+ });
308
+ if (exchange === null) return;
309
+ try {
310
+ const result = await callEndpoint('titleThread', {
311
+ conversationId: id,
312
+ ...exchange,
313
+ context: type.isString(threadsConfig.titleContext) ? threadsConfig.titleContext : null
314
+ });
315
+ if (!type.isString(result?.title)) return;
316
+ setThread((prev)=>prev.id === id && prev.title === exchange.replaces ? {
317
+ ...prev,
318
+ title: result.title
319
+ } : prev);
320
+ renameInList(id, result.title);
321
+ } catch (error) {
322
+ // A title is cosmetic: the thread keeps the name it has.
323
+ }
324
+ }, [
325
+ callEndpoint,
326
+ endpoints,
327
+ managed,
328
+ renameInList,
329
+ saveThread,
330
+ threadsConfig
331
+ ]);
332
+ const loadList = useCallback(async ()=>{
333
+ if (!managed || endpoints.listThreads === null) return;
334
+ setList((prev)=>({
335
+ ...prev,
336
+ status: 'loading'
337
+ }));
338
+ try {
339
+ const items = await callEndpoint('listThreads', {
340
+ scope
341
+ });
342
+ setList({
343
+ status: 'ready',
344
+ items: type.isArray(items) ? items : []
345
+ });
346
+ } catch (error) {
347
+ setList((prev)=>({
348
+ ...prev,
349
+ status: 'error'
350
+ }));
351
+ }
352
+ }, [
353
+ callEndpoint,
354
+ endpoints,
355
+ managed,
356
+ scope
357
+ ]);
358
+ // A new chat, from a seed (the newChat method's args) or none. A chat that is still empty and
359
+ // unseeded is kept rather than replaced.
360
+ const newThread = useCallback((seedArgs)=>{
361
+ cancelResume();
362
+ const seed = getChatSeed(seedArgs);
363
+ const current = threadRef.current;
364
+ const isBlank = messagesRef.current.length === 0 && current.title === null && current.seed === null;
365
+ if (seed === null && isBlank) return;
366
+ showThread(newThreadState({
367
+ scope,
368
+ seed
369
+ }));
370
+ }, [
371
+ cancelResume,
372
+ messagesRef,
373
+ scope,
374
+ showThread
375
+ ]);
376
+ const openThread = useCallback(async ({ key, label })=>{
377
+ if (key === threadRef.current.id) return true;
378
+ cancelResume();
379
+ setOpeningId(key);
380
+ try {
381
+ const stored = await callEndpoint('getThread', {
382
+ conversationId: key
383
+ });
384
+ showThread({
385
+ id: key,
386
+ messages: replayableMessages({
387
+ messages: stored?.messages ?? []
388
+ }),
389
+ provisionalTitle: null,
390
+ seed: null,
391
+ title: type.isString(label) ? label : null
392
+ });
393
+ return true;
394
+ } catch (error) {
395
+ return false;
396
+ } finally{
397
+ setOpeningId(null);
398
+ }
399
+ }, [
400
+ callEndpoint,
401
+ cancelResume,
402
+ showThread
403
+ ]);
404
+ const deleteThread = useCallback(async (key)=>{
405
+ const before = list.items;
406
+ setList((prev)=>({
407
+ ...prev,
408
+ items: prev.items.filter((item)=>item.key !== key)
409
+ }));
410
+ if (key === threadRef.current.id) {
411
+ showThread(newThreadState({
412
+ scope
413
+ }));
414
+ }
415
+ try {
416
+ await callEndpoint('deleteThread', {
417
+ conversationId: key
418
+ });
419
+ } catch (error) {
420
+ setList((prev)=>({
421
+ ...prev,
422
+ items: before
423
+ }));
424
+ }
425
+ }, [
426
+ callEndpoint,
427
+ list.items,
428
+ scope,
429
+ showThread
430
+ ]);
431
+ return {
432
+ canDelete: managed && endpoints.deleteThread !== null,
433
+ canList: managed && endpoints.listThreads !== null,
434
+ conversationId,
435
+ deleteThread,
436
+ initialMessages: thread.messages,
437
+ list,
438
+ loadList,
439
+ managed,
440
+ newThread,
441
+ onReplyFinished,
442
+ onRequest,
443
+ openingId,
444
+ openThread,
445
+ resuming,
446
+ seed: thread.seed,
447
+ title: thread.title
448
+ };
449
+ }
450
+ export default useChatThreads;
@@ -0,0 +1,80 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */ import { useCallback, useContext, useEffect, useRef, useState } from 'react';
16
+ import { Keyboard } from 'react-native';
17
+ import { ElementsContext } from '@lowdefy/client-native';
18
+ /**
19
+ * Keeps the newest message in view, as a chat app does: the conversation is the page's content,
20
+ * so this scrolls the page's scroll view (found in the page's element registry) to its end as a
21
+ * reply grows, when the keyboard comes up, and when the person sends. A touch on the conversation
22
+ * stops the following, so someone reading back is not pulled down; sending, or pressing the
23
+ * "jump to latest" control, follows again.
24
+ *
25
+ * @returns {{ following: boolean, follow: () => void, onContentLayout: () => void,
26
+ * onTouchStart: () => void }}
27
+ */ function useFollowScroll() {
28
+ const elements = useContext(ElementsContext);
29
+ const followingRef = useRef(true);
30
+ const [following, setFollowing] = useState(true);
31
+ const scrollToEnd = useCallback((animated)=>{
32
+ if (elements === null) return;
33
+ const scrollView = elements.registry.find({
34
+ kind: 'scroll',
35
+ pageId: elements.pageId
36
+ });
37
+ scrollView?.scrollToEnd?.({
38
+ animated
39
+ });
40
+ }, [
41
+ elements
42
+ ]);
43
+ const setFollow = useCallback((next)=>{
44
+ followingRef.current = next;
45
+ setFollowing(next);
46
+ }, []);
47
+ const follow = useCallback(()=>{
48
+ setFollow(true);
49
+ // After the frame that draws the message just sent.
50
+ requestAnimationFrame(()=>scrollToEnd(true));
51
+ }, [
52
+ scrollToEnd,
53
+ setFollow
54
+ ]);
55
+ const onContentLayout = useCallback(()=>{
56
+ if (followingRef.current) scrollToEnd(false);
57
+ }, [
58
+ scrollToEnd
59
+ ]);
60
+ const onTouchStart = useCallback(()=>{
61
+ if (followingRef.current) setFollow(false);
62
+ }, [
63
+ setFollow
64
+ ]);
65
+ useEffect(()=>{
66
+ const subscription = Keyboard.addListener('keyboardDidShow', ()=>{
67
+ if (followingRef.current) scrollToEnd(true);
68
+ });
69
+ return ()=>subscription.remove();
70
+ }, [
71
+ scrollToEnd
72
+ ]);
73
+ return {
74
+ follow,
75
+ following,
76
+ onContentLayout,
77
+ onTouchStart
78
+ };
79
+ }
80
+ export default useFollowScroll;
@@ -0,0 +1,77 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */ // The web AgentChat's (blocks-antd-x), copied rather than imported, so a shell never installs a
16
+ // web block package.
17
+ import { useEffect, useState } from 'react';
18
+ const MIN_DELAY = 500;
19
+ const DEFAULT_DELAY = 3000;
20
+ const DEFAULT_INTERVAL = 8000;
21
+ function toList(messages) {
22
+ if (typeof messages === 'string' && messages.length > 0) return [
23
+ messages
24
+ ];
25
+ if (Array.isArray(messages)) {
26
+ const filtered = messages.filter((m)=>typeof m === 'string' && m.length > 0);
27
+ return filtered.length > 0 ? filtered : null;
28
+ }
29
+ return null;
30
+ }
31
+ // React hook: returns the current thinking-message label string, or null.
32
+ // - `active`: true while the loading state is visible (bubble has `loading: true`).
33
+ // - `messages`: string or string[] to show / rotate through. Falsy = feature off.
34
+ // - `delay`: ms before the first label appears after `active` becomes true.
35
+ // - `interval`: ms between rotations when `messages` has 2+ entries.
36
+ // - `resetKey`: stable identifier (usually the loading bubble's id). Changing it restarts timers.
37
+ //
38
+ // The hook keeps all timer lifecycle inside a single useEffect. When `active` flips
39
+ // false (or `resetKey`/`messages` change, or the component unmounts) cleanup fires
40
+ // and clears both the delay timeout and the rotation interval — no leaks.
41
+ export default function useThinkingMessage({ active, messages, delay, interval, resetKey }) {
42
+ const list = toList(messages);
43
+ const listSize = list?.length ?? 0;
44
+ // Serialize for useEffect dependency — array identity changes on every render
45
+ // for YAML-sourced config, but only content changes matter.
46
+ const listKey = list ? list.join('\u0000') : '';
47
+ const effectiveDelay = Math.max(MIN_DELAY, typeof delay === 'number' && delay >= 0 ? delay : DEFAULT_DELAY);
48
+ const effectiveInterval = typeof interval === 'number' && interval > 0 ? interval : DEFAULT_INTERVAL;
49
+ // -1 means "delay not yet elapsed, no label to show"
50
+ const [index, setIndex] = useState(-1);
51
+ useEffect(()=>{
52
+ setIndex(-1);
53
+ if (!active || listSize === 0) return undefined;
54
+ let rotationId = null;
55
+ const delayId = setTimeout(()=>{
56
+ setIndex(0);
57
+ if (listSize >= 2) {
58
+ rotationId = setInterval(()=>{
59
+ setIndex((i)=>(i + 1) % listSize);
60
+ }, effectiveInterval);
61
+ }
62
+ }, effectiveDelay);
63
+ return ()=>{
64
+ clearTimeout(delayId);
65
+ if (rotationId !== null) clearInterval(rotationId);
66
+ };
67
+ }, [
68
+ active,
69
+ listSize,
70
+ listKey,
71
+ effectiveDelay,
72
+ effectiveInterval,
73
+ resetKey
74
+ ]);
75
+ if (!active || listSize === 0 || index < 0) return null;
76
+ return list[index];
77
+ }