@lowdefy/docs-content 6.1.0 → 7.1.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 (284) hide show
  1. package/README.md +1 -0
  2. package/content/actions/downloadcsv.md +1 -1
  3. package/content/actions/emailotpsend.md +58 -0
  4. package/content/actions/emailotpverify.md +79 -0
  5. package/content/actions/getlocalstorage.md +43 -0
  6. package/content/actions/link.md +47 -1
  7. package/content/actions/login.md +25 -5
  8. package/content/actions/logout.md +7 -5
  9. package/content/actions/magiclinkverify.md +117 -0
  10. package/content/actions/pdfmake.md +2 -2
  11. package/content/actions/posthogalias.md +29 -0
  12. package/content/actions/posthogcapture.md +49 -0
  13. package/content/actions/posthogcapturepageleave.md +38 -0
  14. package/content/actions/posthogfeatureflag.md +50 -0
  15. package/content/actions/posthoggroup.md +37 -0
  16. package/content/actions/posthogidentify.md +54 -0
  17. package/content/actions/posthoginit.md +96 -0
  18. package/content/actions/posthogoptin.md +29 -0
  19. package/content/actions/posthogoptout.md +29 -0
  20. package/content/actions/posthogpageview.md +37 -0
  21. package/content/actions/posthogreloadfeatureflags.md +47 -0
  22. package/content/actions/posthogreset.md +28 -0
  23. package/content/actions/posthogsetpersonproperties.md +36 -0
  24. package/content/actions/removelocalstorage.md +28 -0
  25. package/content/actions/resetvalidation.md +7 -3
  26. package/content/actions/setdarkmode.md +3 -3
  27. package/content/actions/setglobal.md +2 -0
  28. package/content/actions/setlocale.md +1 -1
  29. package/content/actions/setlocalstorage.md +34 -0
  30. package/content/actions/validate.md +7 -4
  31. package/content/adapter-reference/mongodbauthadapter.md +46 -0
  32. package/content/agents/agent-endpoint-tools.md +24 -0
  33. package/content/agents/agent-properties.md +13 -3
  34. package/content/agents/agent-server-hooks.md +1 -1
  35. package/content/agents/agentchat.md +43 -7
  36. package/content/agents/agentconversations.md +42 -8
  37. package/content/agents/agents-introduction.md +107 -0
  38. package/content/callback-reference/auth0logoutcallback.md +54 -0
  39. package/content/concepts/ai-agent-docs.md +455 -106
  40. package/content/concepts/blocks.md +150 -0
  41. package/content/concepts/connections-and-requests.md +402 -0
  42. package/content/concepts/custom-html.md +42 -0
  43. package/content/concepts/custom-styling.md +50 -5
  44. package/content/concepts/dynamic-page-content.md +309 -0
  45. package/content/concepts/events-and-actions.md +154 -2
  46. package/content/concepts/four-primitives.md +31 -0
  47. package/content/concepts/html-attributes.md +293 -0
  48. package/content/concepts/i18n.md +8 -3
  49. package/content/concepts/keyboard-shortcuts.md +2 -2
  50. package/content/concepts/layout-overview.md +1 -1
  51. package/content/concepts/logger.md +99 -0
  52. package/content/concepts/lowdefy-api.md +1319 -0
  53. package/content/concepts/lowdefy-schema.md +136 -3
  54. package/content/concepts/menus.md +8 -7
  55. package/content/concepts/module-authoring.md +76 -5
  56. package/content/concepts/modules.md +3 -1
  57. package/content/concepts/notifications.md +180 -0
  58. package/content/concepts/operators.md +7 -0
  59. package/content/concepts/page-and-app-state.md +252 -0
  60. package/content/concepts/page-paths.md +209 -0
  61. package/content/concepts/theming.md +582 -0
  62. package/content/connections/aigateway.md +375 -0
  63. package/content/connections/anthropic.md +169 -2
  64. package/content/connections/awss3.md +178 -2
  65. package/content/connections/axioshttp.md +181 -0
  66. package/content/connections/google.md +169 -2
  67. package/content/connections/mongodb.md +1014 -3
  68. package/content/connections/openai-connection.md +169 -2
  69. package/content/connections/sendgridmail.md +2 -0
  70. package/content/connections/smtp.md +3 -1
  71. package/content/connections/treg.md +329 -0
  72. package/content/container-blocks/affix.md +47 -7
  73. package/content/container-blocks/alert.md +76 -24
  74. package/content/container-blocks/badge.md +100 -24
  75. package/content/container-blocks/box.md +9 -9
  76. package/content/container-blocks/card.md +132 -27
  77. package/content/container-blocks/carousel.md +60 -7
  78. package/content/container-blocks/collapse.md +153 -9
  79. package/content/container-blocks/configprovider.md +35 -13
  80. package/content/container-blocks/confirmmodal.md +69 -23
  81. package/content/container-blocks/content.md +62 -98
  82. package/content/container-blocks/descriptions.md +45 -4
  83. package/content/container-blocks/drawer.md +139 -28
  84. package/content/container-blocks/dropdownmenu.md +119 -31
  85. package/content/container-blocks/flex.md +40 -62
  86. package/content/container-blocks/footer.md +15 -11
  87. package/content/container-blocks/googlemapsheatmap.md +1 -1
  88. package/content/container-blocks/googlemapsscript.md +2 -2
  89. package/content/container-blocks/header.md +71 -36
  90. package/content/container-blocks/label.md +34 -7
  91. package/content/container-blocks/layout.md +52 -34
  92. package/content/container-blocks/masonry.md +17 -71
  93. package/content/container-blocks/mobilemenu.md +131 -88
  94. package/content/container-blocks/modal.md +161 -26
  95. package/content/container-blocks/pageheadermenu.md +138 -31
  96. package/content/container-blocks/pagesidebarlayout.md +230 -27
  97. package/content/container-blocks/pagesidermenu.md +153 -43
  98. package/content/container-blocks/popover.md +34 -31
  99. package/content/container-blocks/result.md +32 -21
  100. package/content/container-blocks/sider.md +85 -122
  101. package/content/container-blocks/span.md +7 -7
  102. package/content/container-blocks/spinner.md +3 -3
  103. package/content/container-blocks/splitter.md +150 -68
  104. package/content/container-blocks/tabs.md +64 -12
  105. package/content/container-blocks/tooltip.md +22 -46
  106. package/content/container-blocks/watermark.md +22 -4
  107. package/content/controls/parallel_for.md +21 -2
  108. package/content/controls/reject.md +24 -3
  109. package/content/controls/return.md +17 -1
  110. package/content/controls/throw.md +1 -0
  111. package/content/controls/try.md +4 -2
  112. package/content/controls/while.md +46 -0
  113. package/content/deployment/deployment-environments.md +10 -7
  114. package/content/deployment/docker.md +22 -7
  115. package/content/deployment/node-server.md +4 -0
  116. package/content/deployment/vercel.md +17 -6
  117. package/content/display-blocks/aggrid.md +36 -19
  118. package/content/display-blocks/anchor.md +16 -15
  119. package/content/display-blocks/avatar.md +57 -37
  120. package/content/display-blocks/breadcrumb.md +70 -21
  121. package/content/display-blocks/button.md +93 -19
  122. package/content/display-blocks/calendar.md +12 -0
  123. package/content/display-blocks/clickablehtml.md +239 -0
  124. package/content/display-blocks/dangeroushtml.md +1 -1
  125. package/content/display-blocks/difflist.md +1 -1
  126. package/content/display-blocks/difftimeline.md +1 -1
  127. package/content/display-blocks/divider.md +64 -3
  128. package/content/display-blocks/dropdownbutton.md +81 -30
  129. package/content/display-blocks/echart.md +35 -1
  130. package/content/display-blocks/eventlog.md +363 -0
  131. package/content/display-blocks/floatbutton.md +129 -42
  132. package/content/display-blocks/html.md +61 -1
  133. package/content/display-blocks/icon.md +250 -67
  134. package/content/display-blocks/img.md +2 -2
  135. package/content/display-blocks/menu.md +146 -73
  136. package/content/display-blocks/message.md +38 -124
  137. package/content/display-blocks/notification.md +94 -222
  138. package/content/display-blocks/paragraph.md +59 -9
  139. package/content/display-blocks/pollingtimer.md +263 -0
  140. package/content/display-blocks/progress.md +96 -17
  141. package/content/display-blocks/qrcode.md +19 -4
  142. package/content/display-blocks/s3download.md +1 -1
  143. package/content/display-blocks/search.md +19 -9
  144. package/content/display-blocks/skeletonbutton.md +1 -0
  145. package/content/display-blocks/skeletoninput.md +1 -0
  146. package/content/display-blocks/statistic.md +75 -17
  147. package/content/display-blocks/steps.md +58 -25
  148. package/content/display-blocks/table.md +2527 -0
  149. package/content/display-blocks/tablelight.md +621 -0
  150. package/content/display-blocks/tag.md +102 -17
  151. package/content/display-blocks/title.md +50 -11
  152. package/content/display-blocks/tour.md +33 -23
  153. package/content/input-blocks/autocomplete.md +81 -9
  154. package/content/input-blocks/buttonselector.md +45 -8
  155. package/content/input-blocks/captcha.md +40 -0
  156. package/content/input-blocks/checkboxselector.md +97 -7
  157. package/content/input-blocks/checkboxswitch.md +33 -3
  158. package/content/input-blocks/colorselector.md +63 -14
  159. package/content/input-blocks/daterangeselector.md +165 -45
  160. package/content/input-blocks/dateselector.md +139 -41
  161. package/content/input-blocks/datetimeselector.md +158 -49
  162. package/content/input-blocks/inputgallery.md +3 -3
  163. package/content/input-blocks/intentinput.md +207 -0
  164. package/content/input-blocks/monthselector.md +120 -52
  165. package/content/input-blocks/multipleselector.md +150 -39
  166. package/content/input-blocks/numberinput.md +98 -12
  167. package/content/input-blocks/pagination.md +70 -14
  168. package/content/input-blocks/paragraphinput.md +51 -37
  169. package/content/input-blocks/passwordinput.md +60 -6
  170. package/content/input-blocks/phonenumberinput.md +59 -26
  171. package/content/input-blocks/placesautocomplete.md +319 -0
  172. package/content/input-blocks/radioselector.md +83 -7
  173. package/content/input-blocks/ratingslider.md +57 -26
  174. package/content/input-blocks/s3uploadbutton.md +24 -24
  175. package/content/input-blocks/s3uploaddragger.md +3 -3
  176. package/content/input-blocks/s3uploadphoto.md +5 -5
  177. package/content/input-blocks/segmentedselector.md +72 -32
  178. package/content/input-blocks/selector.md +109 -21
  179. package/content/input-blocks/switch.md +65 -17
  180. package/content/input-blocks/tableinput.md +445 -0
  181. package/content/input-blocks/tagmultipleselector.md +114 -0
  182. package/content/input-blocks/tagselector.md +114 -0
  183. package/content/input-blocks/textarea.md +32 -3
  184. package/content/input-blocks/textinput.md +70 -29
  185. package/content/input-blocks/tiptapinput.md +1 -1
  186. package/content/input-blocks/tiptapmentioninput.md +2 -2
  187. package/content/input-blocks/titleinput.md +39 -12
  188. package/content/input-blocks/treeinput.md +49 -25
  189. package/content/input-blocks/treemultipleselector.md +127 -10
  190. package/content/input-blocks/treeselector.md +97 -9
  191. package/content/input-blocks/upload.md +64 -15
  192. package/content/input-blocks/uploaddragger.md +17 -1
  193. package/content/input-blocks/uploadphoto.md +18 -1
  194. package/content/input-blocks/weekselector.md +120 -55
  195. package/content/learn/introduction.md +27 -0
  196. package/content/learn/quickstart.md +53 -0
  197. package/content/list-blocks/controlledlist.md +24 -15
  198. package/content/list-blocks/list.md +11 -11
  199. package/content/list-blocks/masonrylist.md +7 -34
  200. package/content/migration/auth-upgrade.md +337 -0
  201. package/content/migration/upgrade-guide.md +1 -0
  202. package/content/migration/v3-to-v4.md +417 -0
  203. package/content/migration/v6-to-v7.md +620 -0
  204. package/content/operators/_agent.md +155 -0
  205. package/content/operators/_app.md +2 -1
  206. package/content/operators/_array.md +122 -1
  207. package/content/operators/_build.md +1 -0
  208. package/content/operators/_credential.md +57 -0
  209. package/content/operators/_cron.md +292 -0
  210. package/content/operators/_date.md +2 -0
  211. package/content/operators/_error.md +24 -1
  212. package/content/operators/_get.md +6 -6
  213. package/content/operators/_hmac.md +78 -0
  214. package/content/operators/_js.md +2 -1
  215. package/content/operators/_location.md +1 -1
  216. package/content/operators/_media.md +13 -0
  217. package/content/operators/_module.md +56 -2
  218. package/content/operators/_operator.md +17 -3
  219. package/content/operators/_path_params.md +82 -0
  220. package/content/operators/_ref.md +258 -0
  221. package/content/operators/_request.md +1 -1
  222. package/content/operators/_request_details.md +6 -0
  223. package/content/operators/_type.md +14 -3
  224. package/content/operators/_url_query.md +2 -0
  225. package/content/operators/_user.md +3 -3
  226. package/content/plugins/plugins-actions.md +10 -0
  227. package/content/plugins/plugins-connections.md +25 -0
  228. package/content/plugins/plugins-dev.md +66 -0
  229. package/content/plugins/plugins-icon-sets.md +267 -0
  230. package/content/plugins/plugins-introduction.md +27 -1
  231. package/content/plugins/plugins.md +19 -0
  232. package/content/plugins/posthog.md +359 -0
  233. package/content/provider-reference/auth-js-providers.md +107 -0
  234. package/content/provider-reference/openidconnectprovider.md +44 -0
  235. package/content/recipes/recipes.md +16 -0
  236. package/content/reference/actions-reference.md +31 -0
  237. package/content/reference/blocks-reference.md +35 -0
  238. package/content/reference/cli.md +403 -0
  239. package/content/reference/connections-reference.md +23 -0
  240. package/content/reference/operators-reference.md +47 -0
  241. package/content/reference/reference.md +16 -0
  242. package/content/reference/schema-reference.md +12 -0
  243. package/content/testing/config-tests.md +677 -0
  244. package/content/testing/e2e-configuration.md +31 -1
  245. package/content/testing/e2e-getting-started.md +1 -1
  246. package/content/testing/e2e-introduction.md +1 -1
  247. package/content/testing/e2e-writing-tests.md +12 -1
  248. package/content/testing/explore-pull-request.md +136 -0
  249. package/content/testing/journey-data-sets.md +326 -0
  250. package/content/tutorial/tutorial-actions-operators.md +2 -2
  251. package/content/tutorial/tutorial-add-blocks.md +2 -2
  252. package/content/tutorial/tutorial-create-page.md +48 -2
  253. package/content/tutorial/tutorial-display-data-page.md +3 -3
  254. package/content/tutorial/tutorial-requests-api.md +155 -0
  255. package/content/tutorial/tutorial-requests-sql.md +153 -0
  256. package/content/tutorial/tutorial-start.md +66 -1
  257. package/content/user-authentication/auth-configuration.md +267 -0
  258. package/content/user-authentication/auth-providers.md +24 -0
  259. package/content/user-authentication/auth-steps.md +141 -0
  260. package/content/user-authentication/login-and-logout.md +160 -8
  261. package/content/user-authentication/mcp-oauth.md +424 -0
  262. package/content/user-authentication/organizations.md +246 -0
  263. package/content/user-authentication/protected-pages-apis.md +97 -0
  264. package/content/user-authentication/roles.md +49 -0
  265. package/content/user-authentication/two-factor.md +229 -0
  266. package/content/user-authentication/user-object.md +58 -0
  267. package/content/user-authentication/users-introduction.md +8 -0
  268. package/content/websockets/websocket-publish.md +105 -0
  269. package/content/websockets/websocket-subscriptions.md +136 -0
  270. package/content/websockets/websockets-introduction.md +101 -0
  271. package/hazards.json +44 -0
  272. package/index.json +3691 -14
  273. package/package.json +11 -1
  274. package/scripts/collectImportedFiles.js +80 -0
  275. package/scripts/extractAgentDocs.js +41 -30
  276. package/scripts/hashDocSources.js +38 -0
  277. package/scripts/isRedirectPage.js +26 -0
  278. package/scripts/recordSourceHashes.js +100 -0
  279. package/scripts/resolvePageSections.js +42 -0
  280. package/scripts/sectionKind.js +27 -0
  281. package/content/concepts/cli.md +0 -223
  282. package/content/other/introduction.md +0 -39
  283. package/content/other/next-auth-providers.md +0 -3
  284. /package/content/{other → actions}/updatesession.md +0 -0
@@ -12,14 +12,14 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
12
12
  items:
13
13
  - title: Edit
14
14
  eventName: onEdit
15
- icon: AiOutlineEdit
15
+ icon: edit
16
16
  - title: Duplicate
17
17
  eventName: onDuplicate
18
- icon: AiOutlineCopy
18
+ icon: copy
19
19
  - type: divider
20
20
  - title: Delete
21
21
  eventName: onDelete
22
- icon: AiOutlineDelete
22
+ icon: delete
23
23
  danger: true
24
24
  events:
25
25
  onEdit:
@@ -50,17 +50,17 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
50
50
  flex: 0 0 auto
51
51
  properties:
52
52
  title: Save
53
- icon: AiOutlineSave
53
+ icon: save
54
54
  color: primary
55
55
  variant: solid
56
56
  split: true
57
57
  items:
58
58
  - title: Save as Draft
59
59
  eventName: onSaveDraft
60
- icon: AiOutlineFile
60
+ icon: file
61
61
  - title: Save & Publish
62
62
  eventName: onPublish
63
- icon: AiOutlineSend
63
+ icon: send
64
64
  events:
65
65
  onClick:
66
66
  - id: db_split_save_msg
@@ -183,19 +183,19 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
183
183
  flex: 0 0 auto
184
184
  properties:
185
185
  title: Export
186
- icon: AiOutlineDownload
186
+ icon: download
187
187
  color: primary
188
188
  variant: outlined
189
189
  items:
190
190
  - title: Export as CSV
191
191
  eventName: onCSV
192
- icon: AiOutlineFile
192
+ icon: file
193
193
  - title: Export as PDF
194
194
  eventName: onPDF
195
- icon: AiOutlineFilePdf
195
+ icon: FileText
196
196
  - title: Export as Excel
197
197
  eventName: onExcel
198
- icon: AiOutlineFileExcel
198
+ icon: FileSpreadsheet
199
199
  events:
200
200
  onCSV:
201
201
  - id: db_icon_csv_msg
@@ -217,6 +217,38 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
217
217
  duration: 2
218
218
  ```
219
219
 
220
+ ```yaml
221
+ - id: db_icon_end
222
+ type: DropdownButton
223
+ layout:
224
+ flex: 0 0 auto
225
+ properties:
226
+ title: Options
227
+ icon: chevron-down
228
+ iconPlacement: end
229
+ items:
230
+ - title: Rename
231
+ eventName: onRename
232
+ icon: edit
233
+ - title: Archive
234
+ eventName: onArchive
235
+ - id: db_split_icon_end
236
+ type: DropdownButton
237
+ layout:
238
+ flex: 0 0 auto
239
+ properties:
240
+ title: Send
241
+ icon: send
242
+ iconPlacement: end
243
+ split: true
244
+ color: primary
245
+ variant: solid
246
+ items:
247
+ - title: Schedule send
248
+ eventName: onSchedule
249
+ icon: clock
250
+ ```
251
+
220
252
  ```yaml
221
253
  - id: db_disabled_items
222
254
  type: DropdownButton
@@ -227,15 +259,15 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
227
259
  items:
228
260
  - title: View Details
229
261
  eventName: onView
230
- icon: AiOutlineEye
262
+ icon: view
231
263
  - title: Edit (no permission)
232
264
  eventName: onEdit
233
- icon: AiOutlineEdit
265
+ icon: edit
234
266
  disabled: true
235
267
  - type: divider
236
268
  - title: Archive
237
269
  eventName: onArchive
238
- icon: AiOutlineDelete
270
+ icon: delete
239
271
  danger: true
240
272
  events:
241
273
  onView:
@@ -260,18 +292,18 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
260
292
  flex: 0 0 auto
261
293
  properties:
262
294
  title: Edit
263
- icon: AiOutlineEdit
295
+ icon: edit
264
296
  items:
265
297
  - title: Undo
266
298
  eventName: onUndo
267
- icon: AiOutlineUndo
299
+ icon: Undo
268
300
  - title: Redo
269
301
  eventName: onRedo
270
- icon: AiOutlineRedo
302
+ icon: Redo
271
303
  - type: divider
272
304
  - title: Delete
273
305
  eventName: onDelete
274
- icon: AiOutlineDelete
306
+ icon: delete
275
307
  danger: true
276
308
  events:
277
309
  onUndo:
@@ -502,7 +534,7 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
502
534
  flex: 0 0 auto
503
535
  properties:
504
536
  title: My Account
505
- icon: AiOutlineUser
537
+ icon: user
506
538
  color: "#531dab"
507
539
  variant: solid
508
540
  theme:
@@ -516,14 +548,14 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
516
548
  items:
517
549
  - title: Profile Settings
518
550
  eventName: onProfile
519
- icon: AiOutlineSetting
551
+ icon: settings
520
552
  - title: Billing & Plans
521
553
  eventName: onBilling
522
- icon: AiOutlineCreditCard
554
+ icon: CreditCard
523
555
  - type: divider
524
556
  - title: Sign Out
525
557
  eventName: onSignOut
526
- icon: AiOutlineLogout
558
+ icon: logout
527
559
  danger: true
528
560
  events:
529
561
  onProfile:
@@ -554,7 +586,7 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
554
586
  flex: 0 0 auto
555
587
  properties:
556
588
  title: Delete Account
557
- icon: AiOutlineWarning
589
+ icon: warning
558
590
  color: danger
559
591
  variant: solid
560
592
  split: true
@@ -567,11 +599,11 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
567
599
  items:
568
600
  - title: Delete All Data
569
601
  eventName: onDeleteData
570
- icon: AiOutlineDelete
602
+ icon: delete
571
603
  danger: true
572
604
  - title: Export Data First
573
605
  eventName: onExportFirst
574
- icon: AiOutlineDownload
606
+ icon: download
575
607
  events:
576
608
  onClick:
577
609
  - id: db_dz_click_msg
@@ -598,7 +630,17 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
598
630
  | Property | Type | Default | Description |
599
631
  | --- | --- | --- | --- |
600
632
  | `title` | string | - | Button label text. |
601
- | `icon` | string \| object | - | Name of a React-Icon or properties of an Icon block to use icon in button. |
633
+ | `icon` | string \| object | - | Icon name (a semantic name like `edit`, a Lucide icon name like `Pencil`, or a set-qualified name like `tabler:Pencil`) or properties of an Icon block to use icon in button. |
634
+ | `icon.name` | string | - | Icon name: a semantic name like `edit`, a Lucide icon name like `Pencil`, or a set-qualified name like `tabler:Pencil`. |
635
+ | `icon.color` | string | - | Icon color. |
636
+ | `icon.size` | string \| number | - | Size of the icon. Defaults to `theme.icons.size`. |
637
+ | `icon.rotate` | number | - | Number of degrees to rotate the icon. |
638
+ | `icon.spin` | boolean | - | Continuously spin the icon with animation. |
639
+ | `icon.strokeWidth` | number | - | Stroke width of the icon lines, in pixels of the 24px icon grid. Defaults to `theme.icons.strokeWidth` (2). |
640
+ | `icon.nonScalingStroke` | boolean | - | Keep the stroke width constant at any icon size. Defaults to `theme.icons.nonScalingStroke`. |
641
+ | `icon.title` | string | - | Icon hover title for accessibility. An empty string marks the icon as decorative. |
642
+ | `icon.disableLoadingIcon` | boolean | - | While loading after the icon has been clicked, don't render the loading icon. |
643
+ | `iconPlacement` | string | `"start"` | Place the button icon before (start) or after (end) the title. Enum: `start`, `end`. |
602
644
  | `type` | string | `"default"` | Deprecated - use color and variant instead. The button type. Enum: `primary`, `default`, `dashed`, `text`, `link`. |
603
645
  | `color` | string | - | Button color. Preset values: default, primary, danger, blue, purple, cyan, green, magenta, pink, red, orange, yellow, volcano, geekblue, lime, gold. Also accepts custom hex color strings. |
604
646
  | `variant` | string | - | Button visual variant. When set, takes precedence over type. Enum: `solid`, `outlined`, `dashed`, `filled`, `text`, `link`. |
@@ -608,18 +650,27 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
608
650
  | `ghost` | boolean | `false` | Make the button's background transparent. |
609
651
  | `disabled` | boolean | `false` | Disable the entire dropdown. |
610
652
  | `trigger` | string | `"click"` | How the dropdown opens. Enum: `click`, `hover`. |
611
- | `placement` | string | `"bottomRight"` | Dropdown position. Enum: `bottomLeft`, `bottom`, `bottomRight`, `topLeft`, `top`, `topRight`. |
653
+ | `placement` | string | `"bottomRight"` | Dropdown position. Enum: `bottomLeft`, `bottom`, `bottomRight`, `topLeft`, `top`, `topRight`, `left`, `leftTop`, `leftBottom`, `right`, `rightTop`, `rightBottom`. |
612
654
  | `arrow` | boolean \| object | `false` | Show arrow pointing to trigger. |
613
655
  | `arrow.pointAtCenter` | boolean | - | |
614
656
  | `split` | boolean | `false` | Split button mode. Left button fires onClick, right arrow opens dropdown. |
615
- | `items` | array | - | Menu items. Each with an eventName that triggers a named event. Keyboard shortcuts can be configured via the standard `events..shortcut` schema (preferred) or via the item-level `shortcut` property — both render a badge next to the item label. The event-level shortcut takes precedence when both are set. |
657
+ | `items` | array | - | Menu items. Each with an eventName that triggers a named event. Keyboard shortcuts can be configured via the standard `events.<eventName>.shortcut` schema (preferred) or via the item-level `shortcut` property — both render a badge next to the item label. The event-level shortcut takes precedence when both are set. |
616
658
  | `items.$.title` | string | - | Display text. |
617
659
  | `items.$.eventName` | string | - | Event name to trigger when clicked. |
618
660
  | `items.$.icon` | string \| object | - | Icon name or config. |
661
+ | `items.$.icon.name` | string | - | Icon name: a semantic name like `edit`, a Lucide icon name like `Pencil`, or a set-qualified name like `tabler:Pencil`. |
662
+ | `items.$.icon.color` | string | - | Icon color. |
663
+ | `items.$.icon.size` | string \| number | - | Size of the icon. Defaults to `theme.icons.size`. |
664
+ | `items.$.icon.rotate` | number | - | Number of degrees to rotate the icon. |
665
+ | `items.$.icon.spin` | boolean | - | Continuously spin the icon with animation. |
666
+ | `items.$.icon.strokeWidth` | number | - | Stroke width of the icon lines, in pixels of the 24px icon grid. Defaults to `theme.icons.strokeWidth` (2). |
667
+ | `items.$.icon.nonScalingStroke` | boolean | - | Keep the stroke width constant at any icon size. Defaults to `theme.icons.nonScalingStroke`. |
668
+ | `items.$.icon.title` | string | - | Icon hover title for accessibility. An empty string marks the icon as decorative. |
669
+ | `items.$.icon.disableLoadingIcon` | boolean | - | While loading after the icon has been clicked, don't render the loading icon. |
619
670
  | `items.$.danger` | boolean | - | Red danger styling. |
620
671
  | `items.$.disabled` | boolean | - | Disable this item. |
621
672
  | `items.$.type` | string | - | Set to divider for a separator. Enum: `divider`. |
622
- | `items.$.shortcut` | string | - | Keyboard shortcut. Binds the key and renders the badge. Prefer configuring this via `events..shortcut` to follow the standard Lowdefy event schema — the event-level shortcut takes precedence when both are set. |
673
+ | `items.$.shortcut` | string | - | Keyboard shortcut. Binds the key and renders the badge. Prefer configuring this via `events.<eventName>.shortcut` to follow the standard Lowdefy event schema — the event-level shortcut takes precedence when both are set. |
623
674
  | `theme` | object | - | Antd design token overrides. Top-level keys apply to the Dropdown menu. Use the nested "button" key for Button-specific tokens. See [antd design tokens](https://ant.design/components/overview#design-token). See [Ant Design dropdown tokens](https://ant.design/components/dropdown#design-token). |
624
675
  | `theme.zIndexPopup` | number | `1050` | Z-index of the dropdown popup. |
625
676
  | `theme.controlItemBgHover` | string | - | Background color on menu item hover. |
@@ -650,12 +701,12 @@ Button that opens a dropdown menu of action items. Each item triggers a named ev
650
701
  | Key | Target |
651
702
  | --- | --- |
652
703
  | `/block` | Outer block wrapper (always available). |
653
- | `/element` | The outer container. |
704
+ | `/element` | The outer element: the button group in split mode, otherwise the button. |
654
705
  | `/button` | The trigger button. |
655
706
  | `/icon` | The icon in the button. |
656
707
  | `/menu` | The floating menu container. |
657
708
  | `/item` | Individual menu items. |
658
709
  | `/itemIcon` | Icon within menu items. |
659
- | `/arrow` | Dropdown arrow indicator. |
710
+ | `/arrow` | Has no effect: antd does not expose the dropdown arrow as a separately styled part. |
660
711
 
661
712
  No slots defined.
@@ -408,7 +408,41 @@ Apache ECharts visualization with full chart configuration support.
408
408
 
409
409
  | Event | Event Data | Description |
410
410
  | --- | --- | --- |
411
- | `click` | \- | Trigger actions when the element is clicked. |
411
+ | `click` | \- | Trigger actions when a chart element is clicked. |
412
+ | `dblclick` | \- | Trigger actions when a chart element is double clicked. |
413
+ | `mousedown` | \- | Trigger actions when the mouse is pressed on a chart element. |
414
+ | `mousemove` | \- | Trigger actions when the mouse moves over a chart element. |
415
+ | `mouseup` | \- | Trigger actions when the mouse is released on a chart element. |
416
+ | `mouseover` | \- | Trigger actions when the mouse enters a chart element. |
417
+ | `mouseout` | \- | Trigger actions when the mouse leaves a chart element. |
418
+ | `globalout` | \- | Trigger actions when the mouse leaves the chart. |
419
+ | `contextmenu` | \- | Trigger actions on a context menu on a chart element. |
420
+ | `highlight` | \- | Trigger actions when a chart element is highlighted. |
421
+ | `downplay` | \- | Trigger actions when a chart element highlight is removed. |
422
+ | `selectchanged` | \- | Trigger actions when the selected chart elements change. |
423
+ | `legendselectchanged` | \- | Trigger actions when the legend selection changes. |
424
+ | `legendselected` | \- | Trigger actions when a legend item is selected. |
425
+ | `legendunselected` | \- | Trigger actions when a legend item is unselected. |
426
+ | `legendselectall` | \- | Trigger actions when all legend items are selected. |
427
+ | `legendinverseselect` | \- | Trigger actions when the legend selection is inverted. |
428
+ | `legendscroll` | \- | Trigger actions when the legend is scrolled. |
429
+ | `datazoom` | \- | Trigger actions when the data zoom range changes. |
430
+ | `datarangeselected` | \- | Trigger actions when the visual map range is selected. |
431
+ | `timelinechanged` | \- | Trigger actions when the timeline point changes. |
432
+ | `timelineplaychanged` | \- | Trigger actions when timeline playback is toggled. |
433
+ | `restore` | \- | Trigger actions when the chart is restored. |
434
+ | `dataviewchanged` | \- | Trigger actions when the data view toolbox changes the data. |
435
+ | `magictypechanged` | \- | Trigger actions when the magic type toolbox changes the chart type. |
436
+ | `geoselectchanged` | \- | Trigger actions when the geo selection changes. |
437
+ | `geoselected` | \- | Trigger actions when a geo region is selected. |
438
+ | `geounselected` | \- | Trigger actions when a geo region is unselected. |
439
+ | `axisareaselected` | \- | Trigger actions when a parallel axis area is selected. |
440
+ | `brush` | \- | Trigger actions when a brush selection is made. |
441
+ | `brushEnd` | \- | Trigger actions when a brush selection ends. |
442
+ | `brushselected` | \- | Trigger actions when the brush selects chart elements. |
443
+ | `globalcursortaken` | \- | Trigger actions when the global cursor is taken. |
444
+ | `rendered` | \- | Trigger actions when the chart is rendered. |
445
+ | `finished` | \- | Trigger actions when the chart render is finished. |
412
446
 
413
447
  | Key | Target |
414
448
  | --- | --- |
@@ -0,0 +1,363 @@
1
+ # EventLog
2
+
3
+ A dense, virtualised log viewer for any array of records - audit trails, job runs, deploys, webhook deliveries or application events. Rows are searchable, filtered by severity and expandable to a detail pane with the actor, a rich detail body and a flattened context key-value table that can be copied as JSON.
4
+
5
+ The block does not assume a record shape: the `fields` property maps dot paths onto each record, and `eventTypeConfig` maps an event type onto its label, icon, colour and severity. Severity is explicit - it is read from the `level` field of a record, or from the `level` of its type config, and is one of `error`, `warning`, `success` or `info` (default `info`).
6
+
7
+ Large logs can be pushed straight into the block with the `setData` method using a CallMethod action, so the records never round-trip through the operator pipeline. Every string rendered by the block is set on the `text` property, so the log can be translated.
8
+
9
+ ## Setting records with `setData`
10
+
11
+ Call `setData` from the block's `onMount` event, after a Request action has loaded the
12
+ records. The page `onInit` event runs before the block mounts, so the method does not exist
13
+ yet. The block falls back to `properties.data` until `setData` is called. See
14
+ [Selectors](/selectors) for the same pattern on selector blocks.
15
+
16
+ ```yaml
17
+ id: audit_log
18
+ type: EventLog
19
+ properties:
20
+ height: 480
21
+ events:
22
+ onMount:
23
+ - id: load_events
24
+ type: Request
25
+ params: get_events
26
+ - id: fill
27
+ type: CallMethod
28
+ params:
29
+ blockId: audit_log
30
+ method: setData
31
+ args:
32
+ - _request: get_events
33
+ ```
34
+
35
+ ```yaml
36
+ - id: basic_event_log
37
+ type: EventLog
38
+ properties:
39
+ height: 320
40
+ fields:
41
+ id: id
42
+ time: timestamp
43
+ message: message
44
+ data:
45
+ - id: "1"
46
+ timestamp: 2026-03-04T09:12:04.000Z
47
+ type: deploy_failed
48
+ level: error
49
+ message: Deploy <b>web-api</b> failed on step build.
50
+ description: The build step exited with code 1 after 42 seconds.
51
+ metadata:
52
+ commit: 9f2c1ab
53
+ branch: main
54
+ duration_ms: 42311
55
+ error: Module not found - ./config/runtime.js
56
+ - id: "2"
57
+ timestamp: 2026-03-04T09:10:44.000Z
58
+ type: deploy_started
59
+ level: info
60
+ message: Deploy <b>web-api</b> started.
61
+ metadata:
62
+ commit: 9f2c1ab
63
+ branch: main
64
+ - id: "3"
65
+ timestamp: 2026-03-04T08:58:00.000Z
66
+ type: quota_warning
67
+ level: warning
68
+ message: Request quota at 82% of the monthly limit.
69
+ metadata:
70
+ used: 820000
71
+ limit: 1000000
72
+ - id: "4"
73
+ timestamp: 2026-03-04T08:30:12.000Z
74
+ type: deploy_succeeded
75
+ level: success
76
+ message: Deploy <b>web-app</b> succeeded.
77
+ metadata:
78
+ commit: 3ab77de
79
+ branch: main
80
+ duration_ms: 51200
81
+ ```
82
+
83
+ ```yaml
84
+ - id: typed_event_log
85
+ type: EventLog
86
+ properties:
87
+ height: 280
88
+ fields:
89
+ id: id
90
+ time: timestamp
91
+ message: message
92
+ eventTypeConfig:
93
+ user_invited:
94
+ title: Invited
95
+ icon: UserPlus
96
+ color: "#1677ff"
97
+ level: info
98
+ user_removed:
99
+ title: Removed
100
+ icon: UserMinus
101
+ color: "#ff4d4f"
102
+ level: error
103
+ role_changed:
104
+ title: Role changed
105
+ icon: Shield
106
+ color: "#faad14"
107
+ level: warning
108
+ data:
109
+ - id: "1"
110
+ timestamp: 2026-03-04T11:02:00.000Z
111
+ type: user_removed
112
+ message: Removed <b>dana@example.com</b> from the workspace.
113
+ created:
114
+ user:
115
+ name: Ada Lowe
116
+ metadata:
117
+ reason: Offboarding
118
+ - id: "2"
119
+ timestamp: 2026-03-04T10:45:00.000Z
120
+ type: role_changed
121
+ message: Changed the role of <b>sam@example.com</b> to admin.
122
+ created:
123
+ user:
124
+ name: Ada Lowe
125
+ metadata:
126
+ from: member
127
+ to: admin
128
+ - id: "3"
129
+ timestamp: 2026-03-04T10:02:00.000Z
130
+ type: user_invited
131
+ message: Invited <b>sam@example.com</b>.
132
+ metadata:
133
+ invited_by: ada@example.com
134
+ ```
135
+
136
+ ```yaml
137
+ - id: mapped_event_log
138
+ type: EventLog
139
+ properties:
140
+ height: 240
141
+ fields:
142
+ id: request_id
143
+ time: at
144
+ type: kind
145
+ level: severity
146
+ message: summary
147
+ detail: body
148
+ actor: operator
149
+ context: payload
150
+ data:
151
+ - request_id: req_9001
152
+ at: 2026-03-04T12:00:00.000Z
153
+ kind: payment
154
+ severity: error
155
+ summary: Charge declined for invoice INV-2201.
156
+ body: The card issuer returned <i>insufficient funds</i>.
157
+ operator: Billing job
158
+ payload:
159
+ invoice: INV-2201
160
+ amount: 149.5
161
+ currency: USD
162
+ - request_id: req_9002
163
+ at: 2026-03-04T11:59:10.000Z
164
+ kind: payment
165
+ severity: success
166
+ summary: Charge captured for invoice INV-2200.
167
+ operator: Billing job
168
+ payload:
169
+ invoice: INV-2200
170
+ amount: 89
171
+ currency: USD
172
+ ```
173
+
174
+ ```yaml
175
+ - id: plain_event_log
176
+ type: EventLog
177
+ properties:
178
+ height: 200
179
+ search: false
180
+ levelFilters: false
181
+ defaultExpanded: true
182
+ fields:
183
+ id: id
184
+ time: timestamp
185
+ message: message
186
+ data:
187
+ - id: "1"
188
+ timestamp: 2026-03-04T09:12:04.000Z
189
+ level: warning
190
+ type: cache_miss
191
+ message: Cache miss rate above 30%.
192
+ metadata:
193
+ rate: 0.34
194
+ ```
195
+
196
+ ```yaml
197
+ - id: translated_event_log
198
+ type: EventLog
199
+ properties:
200
+ height: 240
201
+ levelFilterOptions:
202
+ - all
203
+ - error
204
+ text:
205
+ all: Alles
206
+ error: Foute
207
+ context: Konteks
208
+ copy: Kopieer JSON
209
+ copied: Gekopieer
210
+ systemActor: Stelsel
211
+ searchPlaceholder: Soek gebeure…
212
+ noData: Geen gebeure nie.
213
+ noResults: Geen passende gebeure nie.
214
+ fields:
215
+ id: id
216
+ time: timestamp
217
+ message: message
218
+ data:
219
+ - id: "1"
220
+ timestamp: 2026-03-04T09:12:04.000Z
221
+ type: import_failed
222
+ level: error
223
+ message: Invoer van <b>kliente.csv</b> het misluk.
224
+ metadata:
225
+ rows: 2043
226
+ error: Kolom "epos" ontbreek
227
+ ```
228
+
229
+ ```yaml
230
+ - id: set_data_event_log
231
+ type: EventLog
232
+ properties:
233
+ height: 200
234
+ fields:
235
+ id: id
236
+ time: timestamp
237
+ message: message
238
+ events:
239
+ onMount:
240
+ - id: set_event_log_data
241
+ type: CallMethod
242
+ params:
243
+ blockId: set_data_event_log
244
+ method: setData
245
+ args:
246
+ - - id: "1"
247
+ timestamp: 2026-03-04T09:12:04.000Z
248
+ type: sync_failed
249
+ level: error
250
+ message: Contact sync failed after 3 retries.
251
+ metadata:
252
+ retries: 3
253
+ - id: "2"
254
+ timestamp: 2026-03-04T09:02:04.000Z
255
+ type: sync_succeeded
256
+ level: success
257
+ message: Contact sync completed.
258
+ metadata:
259
+ contacts: 1240
260
+ ```
261
+
262
+ ```yaml
263
+ - id: event_log_with_events
264
+ type: EventLog
265
+ properties:
266
+ height: 200
267
+ fields:
268
+ id: id
269
+ time: timestamp
270
+ message: message
271
+ data:
272
+ - id: "1"
273
+ timestamp: 2026-03-04T09:12:04.000Z
274
+ type: job_failed
275
+ level: error
276
+ message: Nightly export failed.
277
+ metadata:
278
+ job: nightly_export
279
+ - id: "2"
280
+ timestamp: 2026-03-04T08:12:04.000Z
281
+ type: job_succeeded
282
+ level: success
283
+ message: Nightly import succeeded.
284
+ metadata:
285
+ job: nightly_import
286
+ events:
287
+ onRowClick:
288
+ - id: set_selected_event
289
+ type: SetState
290
+ params:
291
+ selected_event:
292
+ _event: row
293
+ - id: selected_event_display
294
+ type: Markdown
295
+ properties:
296
+ content:
297
+ _nunjucks:
298
+ template: '**Selected:** {{ selected_event.message | default("none") }}'
299
+ on:
300
+ _state: true
301
+ ```
302
+
303
+ | Property | Type | Default | Description |
304
+ | --- | --- | --- | --- |
305
+ | `data` | array | `[]` | Array of records, in the order they should be listed (usually newest first). Each record is read using the `fields` paths, so any record shape works. |
306
+ | `fields` | object | - | Dot paths used to read each record. Set only the paths that differ from the defaults. |
307
+ | `fields.id` | string | `"_id"` | Path to a unique row id, used as the list key, to track expanded rows and matched by the search. Ids that are not strings, such as MongoDB ObjectIds, are serialized. Falls back to the row index when the path is empty or the id repeats an earlier row. |
308
+ | `fields.time` | string | `"created.timestamp"` | Path to the row timestamp. Any value the JavaScript Date constructor accepts, such as an ISO string or a date. |
309
+ | `fields.type` | string | `"type"` | Path to the event type, used as the key into `eventTypeConfig`. |
310
+ | `fields.level` | string | `"level"` | Path to the severity of the row. One of "error", "warning", "success" or "info". When the path is empty, the level on the matching `eventTypeConfig` entry is used, otherwise the row is "info". |
311
+ | `fields.message` | string | `"title"` | Path to the message shown on the row. Rendered as html, sanitized before it is inserted. |
312
+ | `fields.detail` | string | `"description"` | Path to the detail shown when the row is expanded. Rendered as html, sanitized before it is inserted. |
313
+ | `fields.actor` | string | `"created.user"` | Path to the actor of the row. A string is used as the actor name, an object is read using `actorName` and `actorPicture`. |
314
+ | `fields.actorName` | string | `"name"` | Path to the actor name, relative to the actor object. |
315
+ | `fields.actorPicture` | string | `"picture"` | Path to the actor avatar image url, relative to the actor object. The actor initials are shown when it is empty. |
316
+ | `fields.context` | string | `"metadata"` | Path to the context object shown as a flattened key-value table when the row is expanded. |
317
+ | `eventTypeConfig` | object | `{}` | Map of event type to display config: `{ color, title, icon, level }`. `title` labels the type column, `icon` names an icon shown before the label, `color` colors the label and icon, and `level` sets the severity for every row of that type. |
318
+ | `reverse` | boolean | `false` | Reverse the order of the records before they are listed. |
319
+ | `search` | object \| boolean | - | Client-side search over the id, type, title, message, detail and context of every record. The search input is shown by default: omit the property or set it to true for the defaults, set an object to tune it, or set false to hide it. |
320
+ | `search.placeholder` | string | - | Placeholder text in the search input. Defaults to `text.searchPlaceholder`. |
321
+ | `search.debounce` | number | `150` | Milliseconds to wait after the last keystroke before filtering. |
322
+ | `search.minLength` | number | `0` | Skip filtering until the query is at least this many characters. |
323
+ | `levelFilters` | boolean | `true` | Show the severity filter pills in the toolbar. |
324
+ | `levelFilterOptions` | array | - | The filter pills to show, in order. Defaults to "all" plus every level with at least one record. |
325
+ | `defaultExpanded` | boolean | `false` | Expand every row. Rows added later are expanded when they first appear, and rows the user collapsed stay collapsed. |
326
+ | `height` | number \| string | - | Pixel height (number) or css height string of the scroll container. When omitted, the log grows with its content and scrolls with the page. |
327
+ | `overscan` | number | `400` | Pixels of off-screen rows to render above and below the viewport. Increase for smoother fast-scroll, decrease to reduce DOM cost. |
328
+ | `text` | object | - | All the text rendered by the block, so it can be changed or translated. |
329
+ | `text.all` | string | `"All"` | Label of the filter pill that shows every record. |
330
+ | `text.error` | string | `"Errors"` | Label of the error level filter pill. |
331
+ | `text.warning` | string | `"Warnings"` | Label of the warning level filter pill. |
332
+ | `text.success` | string | `"Successes"` | Label of the success level filter pill. |
333
+ | `text.info` | string | `"Info"` | Label of the info level filter pill. |
334
+ | `text.searchPlaceholder` | string | `"Search events, context, ids…"` | Placeholder text in the search input. |
335
+ | `text.clearSearch` | string | `"Clear search"` | Accessible label of the button that clears the search input. |
336
+ | `text.context` | string | `"Context"` | Heading of the context table in an expanded row. |
337
+ | `text.copy` | string | `"Copy JSON"` | Label of the button that copies the context object to the clipboard. |
338
+ | `text.copied` | string | `"Copied"` | Label shown on the copy button after the context was copied. |
339
+ | `text.systemActor` | string | `"System"` | Actor name shown when a record has no actor. |
340
+ | `text.noData` | string | `"No events."` | Text shown when there are no records. |
341
+ | `text.noResults` | string | `"No matching events."` | Text shown when the search and filters match no records. |
342
+
343
+ | Event | Event Data | Description |
344
+ | --- | --- | --- |
345
+ | `onRowClick` | `{ row }` | Triggered when a row is clicked. |
346
+ | `onExpand` | `{ row, expanded }` | Triggered when a row is expanded or collapsed. |
347
+ | `onSearch` | `{ value, resultCount }` | Triggered when the debounced search query changes, including when the search is cleared. |
348
+
349
+ | Key | Target |
350
+ | --- | --- |
351
+ | `/block` | Outer block wrapper (always available). |
352
+ | `/element` | The outer log container. |
353
+ | `/toolbar` | The sticky toolbar row holding the search input and the level filters. |
354
+ | `/search` | The search input wrapper. |
355
+ | `/filters` | The level filter pill group. |
356
+ | `/list` | The virtualised list container. |
357
+ | `/row` | Each log row. |
358
+ | `/detail` | The expanded detail area of a row. |
359
+ | `/context` | The context key-value table in an expanded row. |
360
+ | `/noData` | The placeholder shown when there are no records. |
361
+ | `/noResults` | The placeholder shown when the search and level filter match no records. |
362
+
363
+ No slots defined.