@lowdefy/docs-content 6.1.0 → 7.0.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 (285) 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 +5 -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/setstate.md +2 -0
  31. package/content/actions/validate.md +7 -4
  32. package/content/adapter-reference/mongodbauthadapter.md +46 -0
  33. package/content/agents/agent-endpoint-tools.md +24 -0
  34. package/content/agents/agent-properties.md +13 -3
  35. package/content/agents/agent-server-hooks.md +1 -1
  36. package/content/agents/agentchat.md +43 -7
  37. package/content/agents/agentconversations.md +42 -8
  38. package/content/agents/agents-introduction.md +107 -0
  39. package/content/callback-reference/auth0logoutcallback.md +54 -0
  40. package/content/concepts/ai-agent-docs.md +455 -106
  41. package/content/concepts/blocks.md +150 -0
  42. package/content/concepts/connections-and-requests.md +402 -0
  43. package/content/concepts/custom-html.md +42 -0
  44. package/content/concepts/custom-styling.md +50 -5
  45. package/content/concepts/dynamic-page-content.md +309 -0
  46. package/content/concepts/events-and-actions.md +154 -2
  47. package/content/concepts/four-primitives.md +31 -0
  48. package/content/concepts/html-attributes.md +293 -0
  49. package/content/concepts/i18n.md +8 -3
  50. package/content/concepts/keyboard-shortcuts.md +2 -2
  51. package/content/concepts/layout-overview.md +1 -1
  52. package/content/concepts/logger.md +99 -0
  53. package/content/concepts/lowdefy-api.md +1319 -0
  54. package/content/concepts/lowdefy-schema.md +136 -3
  55. package/content/concepts/menus.md +8 -7
  56. package/content/concepts/module-authoring.md +76 -5
  57. package/content/concepts/modules.md +3 -1
  58. package/content/concepts/notifications.md +180 -0
  59. package/content/concepts/operators.md +7 -0
  60. package/content/concepts/page-and-app-state.md +252 -0
  61. package/content/concepts/page-paths.md +209 -0
  62. package/content/concepts/theming.md +582 -0
  63. package/content/connections/aigateway.md +375 -0
  64. package/content/connections/anthropic.md +169 -2
  65. package/content/connections/awss3.md +178 -2
  66. package/content/connections/axioshttp.md +181 -0
  67. package/content/connections/google.md +169 -2
  68. package/content/connections/mongodb.md +1014 -3
  69. package/content/connections/openai-connection.md +169 -2
  70. package/content/connections/sendgridmail.md +2 -0
  71. package/content/connections/smtp.md +3 -1
  72. package/content/connections/treg.md +329 -0
  73. package/content/container-blocks/affix.md +47 -7
  74. package/content/container-blocks/alert.md +76 -24
  75. package/content/container-blocks/badge.md +100 -24
  76. package/content/container-blocks/box.md +9 -9
  77. package/content/container-blocks/card.md +132 -27
  78. package/content/container-blocks/carousel.md +60 -7
  79. package/content/container-blocks/collapse.md +153 -9
  80. package/content/container-blocks/configprovider.md +35 -13
  81. package/content/container-blocks/confirmmodal.md +69 -23
  82. package/content/container-blocks/content.md +62 -98
  83. package/content/container-blocks/descriptions.md +45 -4
  84. package/content/container-blocks/drawer.md +139 -28
  85. package/content/container-blocks/dropdownmenu.md +119 -31
  86. package/content/container-blocks/flex.md +40 -62
  87. package/content/container-blocks/footer.md +15 -11
  88. package/content/container-blocks/googlemapsheatmap.md +1 -1
  89. package/content/container-blocks/googlemapsscript.md +2 -2
  90. package/content/container-blocks/header.md +71 -36
  91. package/content/container-blocks/label.md +34 -7
  92. package/content/container-blocks/layout.md +52 -34
  93. package/content/container-blocks/masonry.md +17 -71
  94. package/content/container-blocks/mobilemenu.md +131 -88
  95. package/content/container-blocks/modal.md +161 -26
  96. package/content/container-blocks/pageheadermenu.md +138 -31
  97. package/content/container-blocks/pagesidebarlayout.md +230 -27
  98. package/content/container-blocks/pagesidermenu.md +153 -43
  99. package/content/container-blocks/popover.md +34 -31
  100. package/content/container-blocks/result.md +32 -21
  101. package/content/container-blocks/sider.md +85 -122
  102. package/content/container-blocks/span.md +7 -7
  103. package/content/container-blocks/spinner.md +3 -3
  104. package/content/container-blocks/splitter.md +150 -68
  105. package/content/container-blocks/tabs.md +64 -12
  106. package/content/container-blocks/tooltip.md +22 -46
  107. package/content/container-blocks/watermark.md +22 -4
  108. package/content/controls/parallel_for.md +21 -2
  109. package/content/controls/reject.md +24 -3
  110. package/content/controls/return.md +17 -1
  111. package/content/controls/throw.md +1 -0
  112. package/content/controls/try.md +4 -2
  113. package/content/controls/while.md +46 -0
  114. package/content/deployment/deployment-environments.md +10 -7
  115. package/content/deployment/docker.md +22 -7
  116. package/content/deployment/node-server.md +4 -0
  117. package/content/deployment/vercel.md +17 -6
  118. package/content/display-blocks/aggrid.md +33 -16
  119. package/content/display-blocks/anchor.md +16 -15
  120. package/content/display-blocks/avatar.md +57 -37
  121. package/content/display-blocks/breadcrumb.md +70 -21
  122. package/content/display-blocks/button.md +93 -19
  123. package/content/display-blocks/calendar.md +12 -0
  124. package/content/display-blocks/clickablehtml.md +239 -0
  125. package/content/display-blocks/dangeroushtml.md +1 -1
  126. package/content/display-blocks/difflist.md +1 -1
  127. package/content/display-blocks/difftimeline.md +1 -1
  128. package/content/display-blocks/divider.md +64 -3
  129. package/content/display-blocks/dropdownbutton.md +81 -30
  130. package/content/display-blocks/echart.md +35 -1
  131. package/content/display-blocks/eventlog.md +363 -0
  132. package/content/display-blocks/floatbutton.md +129 -42
  133. package/content/display-blocks/html.md +61 -1
  134. package/content/display-blocks/icon.md +250 -67
  135. package/content/display-blocks/img.md +2 -2
  136. package/content/display-blocks/menu.md +146 -73
  137. package/content/display-blocks/message.md +38 -124
  138. package/content/display-blocks/notification.md +94 -222
  139. package/content/display-blocks/paragraph.md +59 -9
  140. package/content/display-blocks/pollingtimer.md +263 -0
  141. package/content/display-blocks/progress.md +96 -17
  142. package/content/display-blocks/qrcode.md +19 -4
  143. package/content/display-blocks/s3download.md +1 -1
  144. package/content/display-blocks/search.md +19 -9
  145. package/content/display-blocks/skeletonbutton.md +1 -0
  146. package/content/display-blocks/skeletoninput.md +1 -0
  147. package/content/display-blocks/statistic.md +75 -17
  148. package/content/display-blocks/steps.md +58 -25
  149. package/content/display-blocks/table.md +2527 -0
  150. package/content/display-blocks/tablelight.md +621 -0
  151. package/content/display-blocks/tag.md +102 -17
  152. package/content/display-blocks/title.md +50 -11
  153. package/content/display-blocks/tour.md +33 -23
  154. package/content/input-blocks/autocomplete.md +81 -9
  155. package/content/input-blocks/buttonselector.md +45 -8
  156. package/content/input-blocks/captcha.md +40 -0
  157. package/content/input-blocks/checkboxselector.md +97 -7
  158. package/content/input-blocks/checkboxswitch.md +33 -3
  159. package/content/input-blocks/colorselector.md +63 -14
  160. package/content/input-blocks/daterangeselector.md +165 -45
  161. package/content/input-blocks/dateselector.md +139 -41
  162. package/content/input-blocks/datetimeselector.md +158 -49
  163. package/content/input-blocks/inputgallery.md +3 -3
  164. package/content/input-blocks/intentinput.md +207 -0
  165. package/content/input-blocks/monthselector.md +120 -52
  166. package/content/input-blocks/multipleselector.md +150 -39
  167. package/content/input-blocks/numberinput.md +98 -12
  168. package/content/input-blocks/pagination.md +70 -14
  169. package/content/input-blocks/paragraphinput.md +51 -37
  170. package/content/input-blocks/passwordinput.md +60 -6
  171. package/content/input-blocks/phonenumberinput.md +59 -26
  172. package/content/input-blocks/placesautocomplete.md +319 -0
  173. package/content/input-blocks/radioselector.md +83 -7
  174. package/content/input-blocks/ratingslider.md +57 -26
  175. package/content/input-blocks/s3uploadbutton.md +24 -24
  176. package/content/input-blocks/s3uploaddragger.md +3 -3
  177. package/content/input-blocks/s3uploadphoto.md +5 -5
  178. package/content/input-blocks/segmentedselector.md +72 -32
  179. package/content/input-blocks/selector.md +109 -21
  180. package/content/input-blocks/switch.md +65 -17
  181. package/content/input-blocks/tableinput.md +445 -0
  182. package/content/input-blocks/tagmultipleselector.md +114 -0
  183. package/content/input-blocks/tagselector.md +114 -0
  184. package/content/input-blocks/textarea.md +32 -3
  185. package/content/input-blocks/textinput.md +70 -29
  186. package/content/input-blocks/tiptapinput.md +1 -1
  187. package/content/input-blocks/tiptapmentioninput.md +2 -2
  188. package/content/input-blocks/titleinput.md +39 -12
  189. package/content/input-blocks/treeinput.md +49 -25
  190. package/content/input-blocks/treemultipleselector.md +127 -10
  191. package/content/input-blocks/treeselector.md +97 -9
  192. package/content/input-blocks/upload.md +64 -15
  193. package/content/input-blocks/uploaddragger.md +17 -1
  194. package/content/input-blocks/uploadphoto.md +18 -1
  195. package/content/input-blocks/weekselector.md +120 -55
  196. package/content/learn/introduction.md +27 -0
  197. package/content/learn/quickstart.md +53 -0
  198. package/content/learn/showcase.md +8 -0
  199. package/content/list-blocks/controlledlist.md +24 -15
  200. package/content/list-blocks/list.md +11 -11
  201. package/content/list-blocks/masonrylist.md +7 -34
  202. package/content/migration/auth-upgrade.md +337 -0
  203. package/content/migration/upgrade-guide.md +1 -0
  204. package/content/migration/v3-to-v4.md +417 -0
  205. package/content/migration/v6-to-v7.md +620 -0
  206. package/content/operators/_agent.md +155 -0
  207. package/content/operators/_app.md +2 -1
  208. package/content/operators/_array.md +122 -1
  209. package/content/operators/_build.md +1 -0
  210. package/content/operators/_credential.md +57 -0
  211. package/content/operators/_cron.md +292 -0
  212. package/content/operators/_date.md +2 -0
  213. package/content/operators/_error.md +24 -1
  214. package/content/operators/_get.md +6 -6
  215. package/content/operators/_hmac.md +78 -0
  216. package/content/operators/_js.md +2 -1
  217. package/content/operators/_location.md +1 -1
  218. package/content/operators/_media.md +13 -0
  219. package/content/operators/_module.md +56 -2
  220. package/content/operators/_operator.md +17 -3
  221. package/content/operators/_path_params.md +82 -0
  222. package/content/operators/_ref.md +258 -0
  223. package/content/operators/_request.md +1 -1
  224. package/content/operators/_request_details.md +6 -0
  225. package/content/operators/_type.md +14 -3
  226. package/content/operators/_url_query.md +2 -0
  227. package/content/operators/_user.md +3 -3
  228. package/content/plugins/plugins-actions.md +10 -0
  229. package/content/plugins/plugins-connections.md +25 -0
  230. package/content/plugins/plugins-dev.md +66 -0
  231. package/content/plugins/plugins-icon-sets.md +267 -0
  232. package/content/plugins/plugins-introduction.md +27 -1
  233. package/content/plugins/plugins.md +19 -0
  234. package/content/plugins/posthog.md +359 -0
  235. package/content/provider-reference/auth-js-providers.md +107 -0
  236. package/content/provider-reference/openidconnectprovider.md +44 -0
  237. package/content/recipes/recipes.md +16 -0
  238. package/content/reference/actions-reference.md +31 -0
  239. package/content/reference/blocks-reference.md +35 -0
  240. package/content/reference/cli.md +403 -0
  241. package/content/reference/connections-reference.md +23 -0
  242. package/content/reference/operators-reference.md +47 -0
  243. package/content/reference/reference.md +16 -0
  244. package/content/reference/schema-reference.md +12 -0
  245. package/content/testing/config-tests.md +677 -0
  246. package/content/testing/e2e-configuration.md +31 -1
  247. package/content/testing/e2e-getting-started.md +1 -1
  248. package/content/testing/e2e-introduction.md +1 -1
  249. package/content/testing/e2e-writing-tests.md +12 -1
  250. package/content/testing/explore-pull-request.md +136 -0
  251. package/content/testing/journey-data-sets.md +326 -0
  252. package/content/tutorial/tutorial-actions-operators.md +2 -2
  253. package/content/tutorial/tutorial-add-blocks.md +2 -2
  254. package/content/tutorial/tutorial-create-page.md +48 -2
  255. package/content/tutorial/tutorial-display-data-page.md +3 -3
  256. package/content/tutorial/tutorial-requests-api.md +155 -0
  257. package/content/tutorial/tutorial-requests-sql.md +153 -0
  258. package/content/tutorial/tutorial-start.md +66 -1
  259. package/content/user-authentication/auth-configuration.md +267 -0
  260. package/content/user-authentication/auth-providers.md +24 -0
  261. package/content/user-authentication/auth-steps.md +141 -0
  262. package/content/user-authentication/login-and-logout.md +160 -8
  263. package/content/user-authentication/mcp-oauth.md +424 -0
  264. package/content/user-authentication/organizations.md +246 -0
  265. package/content/user-authentication/protected-pages-apis.md +97 -0
  266. package/content/user-authentication/roles.md +49 -0
  267. package/content/user-authentication/two-factor.md +229 -0
  268. package/content/user-authentication/user-object.md +58 -0
  269. package/content/user-authentication/users-introduction.md +8 -0
  270. package/content/websockets/websocket-publish.md +105 -0
  271. package/content/websockets/websocket-subscriptions.md +136 -0
  272. package/content/websockets/websockets-introduction.md +101 -0
  273. package/hazards.json +56 -0
  274. package/index.json +3458 -14
  275. package/package.json +10 -1
  276. package/scripts/extractAgentDocs.js +41 -30
  277. package/scripts/hashDocSources.js +38 -0
  278. package/scripts/isRedirectPage.js +26 -0
  279. package/scripts/recordSourceHashes.js +97 -0
  280. package/scripts/resolvePageSections.js +42 -0
  281. package/scripts/sectionKind.js +27 -0
  282. package/content/concepts/cli.md +0 -223
  283. package/content/other/introduction.md +0 -39
  284. package/content/other/next-auth-providers.md +0 -3
  285. /package/content/{other → actions}/updatesession.md +0 -0
@@ -14,7 +14,7 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
14
14
  properties:
15
15
  uploadPolicyRequestId: upload_policy_request
16
16
  button:
17
- icon: UploadOutlined
17
+ icon: upload
18
18
  title: Choose File
19
19
  type: default
20
20
  - id: basic_custom_icon
@@ -22,9 +22,18 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
22
22
  properties:
23
23
  uploadPolicyRequestId: upload_policy_request
24
24
  button:
25
- icon: AiOutlineCloudUpload
25
+ icon: CloudUpload
26
26
  title: Upload to Cloud
27
27
  type: default
28
+ - id: basic_icon_end
29
+ type: Upload
30
+ properties:
31
+ uploadPolicyRequestId: upload_policy_request
32
+ button:
33
+ icon: upload
34
+ iconPlacement: end
35
+ title: Attach
36
+ type: default
28
37
  ```
29
38
 
30
39
  ```yaml
@@ -34,7 +43,7 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
34
43
  uploadPolicyRequestId: upload_policy_request
35
44
  accept: image/*
36
45
  button:
37
- icon: AiOutlinePicture
46
+ icon: image
38
47
  title: Upload Image
39
48
  type: default
40
49
  - id: accept_pdf
@@ -43,7 +52,7 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
43
52
  uploadPolicyRequestId: upload_policy_request
44
53
  accept: .pdf
45
54
  button:
46
- icon: AiOutlineFilePdf
55
+ icon: FileText
47
56
  title: Upload PDF
48
57
  type: default
49
58
  ```
@@ -55,7 +64,7 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
55
64
  uploadPolicyRequestId: upload_policy_request
56
65
  singleFile: true
57
66
  button:
58
- icon: UploadOutlined
67
+ icon: upload
59
68
  title: Upload Single File
60
69
  type: default
61
70
  - id: limit_max_three
@@ -64,7 +73,7 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
64
73
  uploadPolicyRequestId: upload_policy_request
65
74
  maxCount: 3
66
75
  button:
67
- icon: UploadOutlined
76
+ icon: upload
68
77
  title: Upload (Max 3)
69
78
  type: default
70
79
  ```
@@ -76,11 +85,37 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
76
85
  emitFileContent: true
77
86
  singleFile: true
78
87
  button:
79
- icon: UploadOutlined
88
+ icon: upload
80
89
  title: Attach File
81
90
  type: default
82
91
  ```
83
92
 
93
+ ```yaml
94
+ - id: list_picture
95
+ type: Upload
96
+ properties:
97
+ uploadPolicyRequestId: upload_policy_request
98
+ accept: image/*
99
+ listType: picture
100
+ showUploadList:
101
+ showRemoveIcon: true
102
+ showDownloadIcon: false
103
+ button:
104
+ icon: image
105
+ title: Upload Images
106
+ type: default
107
+ - id: upload_directory
108
+ type: Upload
109
+ properties:
110
+ uploadPolicyRequestId: upload_policy_request
111
+ directory: true
112
+ pastable: true
113
+ button:
114
+ icon: folder
115
+ title: Upload Folder
116
+ type: default
117
+ ```
118
+
84
119
  ```yaml
85
120
  - id: disabled_default
86
121
  type: Upload
@@ -91,34 +126,48 @@ Upload files to any storage provider with a button trigger — AWS S3 (and S3-co
91
126
 
92
127
  ```yaml
93
128
  - id: label_default
94
- type: Upload
129
+ type: Label
95
130
  properties:
96
131
  title: Upload Attachment
97
- uploadPolicyRequestId: upload_policy_request
132
+ blocks:
133
+ - id: label_default_upload
134
+ type: Upload
135
+ properties:
136
+ uploadPolicyRequestId: upload_policy_request
98
137
  - id: label_extra
99
- type: Upload
138
+ type: Label
100
139
  properties:
101
140
  title: Upload Document
102
- uploadPolicyRequestId: upload_policy_request
103
- label:
104
- extra: Accepted formats are PDF, DOCX, and PNG. Max size 10MB.
141
+ extra: Accepted formats are PDF, DOCX, and PNG. Max size 10MB.
142
+ blocks:
143
+ - id: label_extra_upload
144
+ type: Upload
145
+ properties:
146
+ uploadPolicyRequestId: upload_policy_request
105
147
  ```
106
148
 
107
149
  | Property | Type | Default | Description |
108
150
  | --- | --- | --- | --- |
109
151
  | `accept` | string | - | File types accepted by the input. See html file type input accept property at https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept. |
110
- | `button` | object | `{"icon":"UploadOutlined","title":"Upload","type":"default"}` | Button block properties. See [Button](/Button) for all properties. |
152
+ | `button` | object | `{"icon":"upload","title":"Upload","type":"default"}` | Button block properties. See [Button](/Button) for all properties. |
111
153
  | `button.title` | string | - | Button title text. |
112
154
  | `button.icon` | string \| object | - | Button icon name or Icon block properties. |
155
+ | `button.iconPlacement` | string | `"start"` | Place the icon before (`start`) or after (`end`) the button title. Enum: `start`, `end`. |
113
156
  | `button.type` | string | `"default"` | Button type. Enum: `default`, `primary`, `dashed`, `text`, `link`. |
114
157
  | `button.danger` | boolean | `false` | Set button style to danger. |
115
158
  | `button.disabled` | boolean | `false` | Disable the button. |
116
159
  | `button.size` | string | `"default"` | Button size. Enum: `small`, `default`, `large`. |
160
+ | `directory` | boolean | `false` | Select a whole folder instead of files. Every file in the folder is uploaded. |
161
+ | `listType` | string | `"text"` | Style of the file list. `picture` shows a thumbnail for each image. Enum: `text`, `picture`. |
162
+ | `pastable` | boolean | `false` | Upload files pasted anywhere on the page. |
117
163
  | `disabled` | boolean | - | Disable the file input. |
118
164
  | `emitFileContent` | boolean | `false` | Instead of uploading, read the file and emit { name, size, type, content } — content a base64 string — as the block value and onChange event. Use with a CallAPI action to store the file with a server-side write request (e.g. AwsS3PutObject). Replaces uploadPolicyRequestId. |
119
165
  | `maxCount` | number | - | Maximum number of files that can be uploaded. |
120
166
  | `uploadPolicyRequestId` | string | - | Id of an upload-policy request (e.g. AwsS3PresignedPostPolicy, GcsSignedPostPolicy, AzureBlobUploadSas) that defines to which storage bucket and how the file should be uploaded. Required unless emitFileContent is true. |
121
- | `showUploadList` | boolean | `true` | Whether to show default upload list. |
167
+ | `showUploadList` | boolean \| object | `true` | Whether to show the uploaded file list. Set an object to choose which actions each file shows. |
168
+ | `showUploadList.showPreviewIcon` | boolean | `true` | Show the preview action on picture list items. |
169
+ | `showUploadList.showRemoveIcon` | boolean | `true` | Show the remove action, so files can be removed from the list. |
170
+ | `showUploadList.showDownloadIcon` | boolean | `false` | Show the download action. |
122
171
  | `singleFile` | boolean | `false` | Only allow a single file to be uploaded. Only one file can be selected in the prompt. |
123
172
  | `theme` | object | - | Antd design token overrides for this block. See [antd design tokens](https://ant.design/components/upload#design-token). See [Ant Design upload tokens](https://ant.design/components/upload#design-token). |
124
173
  | `theme.actionsColor` | string | - | Color of action icons (download, preview, remove). |
@@ -37,6 +37,16 @@ Upload files to any storage provider with a drag-and-drop (and paste) area — A
37
37
  singleFile: true
38
38
  ```
39
39
 
40
+ ```yaml
41
+ - id: dragger_drop_only
42
+ type: UploadDragger
43
+ properties:
44
+ uploadPolicyRequestId: upload_policy_request
45
+ title: Drop files here, or paste them with Ctrl+V.
46
+ openFileDialogOnClick: false
47
+ listType: picture
48
+ ```
49
+
40
50
  ```yaml
41
51
  - id: disabled_default
42
52
  type: UploadDragger
@@ -50,11 +60,17 @@ Upload files to any storage provider with a drag-and-drop (and paste) area — A
50
60
  | `height` | number \| string | - | Height of the dragger area. A number is applied in pixels; a string is passed through as a CSS length (e.g. "300px", "50vh"). Defaults to the antd `controlHeight` theme token. If `style.element.height` is set, it overrides this. |
51
61
  | `title` | string | - | Title of the file input to be displayed on the draggable area. |
52
62
  | `accept` | string | - | File types accepted by the input. See html file type input accept property at https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#accept. |
63
+ | `directory` | boolean | `false` | Select a whole folder instead of files. Every file in the folder is uploaded. |
64
+ | `listType` | string | `"text"` | Style of the file list. `picture` shows a thumbnail for each image. Enum: `text`, `picture`. |
65
+ | `openFileDialogOnClick` | boolean | `true` | Whether clicking the drop area opens the file dialog. Set to false for a drop or paste only area. |
53
66
  | `disabled` | boolean | - | Disable the file input. |
54
67
  | `emitFileContent` | boolean | `false` | Instead of uploading, read the file and emit { name, size, type, content } — content a base64 string — as the block value and onChange event. Use with a CallAPI action to store the file with a server-side write request (e.g. AwsS3PutObject). Replaces uploadPolicyRequestId. |
55
68
  | `maxCount` | number | - | Maximum number of files that can be uploaded. |
56
69
  | `uploadPolicyRequestId` | string | - | Id of an upload-policy request (e.g. AwsS3PresignedPostPolicy, GcsSignedPostPolicy, AzureBlobUploadSas) that defines to which storage bucket and how the file should be uploaded. Required unless emitFileContent is true. |
57
- | `showUploadList` | boolean | `true` | Whether to show default upload list. |
70
+ | `showUploadList` | boolean \| object | `true` | Whether to show the uploaded file list. Set an object to choose which actions each file shows. |
71
+ | `showUploadList.showPreviewIcon` | boolean | `true` | Show the preview action on picture list items. |
72
+ | `showUploadList.showRemoveIcon` | boolean | `true` | Show the remove action, so files can be removed from the list. |
73
+ | `showUploadList.showDownloadIcon` | boolean | `false` | Show the download action. |
58
74
  | `singleFile` | boolean | `false` | Only allow a single file to be uploaded. Only one file can be selected in the prompt. |
59
75
  | `theme` | object | - | Antd design token overrides for this block. See [antd design tokens](https://ant.design/components/upload#design-token). See [Ant Design upload tokens](https://ant.design/components/upload#design-token). |
60
76
  | `theme.actionsColor` | string | - | Color of action icons (download, preview, remove). |
@@ -37,6 +37,17 @@ Upload images to any storage provider with a picture-card interface — AWS S3 (
37
37
  singleFile: true
38
38
  ```
39
39
 
40
+ ```yaml
41
+ - id: photo_capture
42
+ type: UploadPhoto
43
+ properties:
44
+ uploadPolicyRequestId: upload_policy_request
45
+ title: Take photo
46
+ capture: environment
47
+ listType: picture-circle
48
+ singleFile: true
49
+ ```
50
+
40
51
  ```yaml
41
52
  - id: disabled_default
42
53
  type: UploadPhoto
@@ -48,11 +59,17 @@ Upload images to any storage provider with a picture-card interface — AWS S3 (
48
59
  | Property | Type | Default | Description |
49
60
  | --- | --- | --- | --- |
50
61
  | `title` | string | `"Upload image"` | Title of the file input to be displayed instead of 'Upload image'. |
62
+ | `pastable` | boolean | `false` | Upload files pasted anywhere on the page. |
63
+ | `capture` | string | - | On mobile devices, open the camera directly: `user` for the front camera, `environment` for the back camera. Enum: `user`, `environment`. |
64
+ | `listType` | string | `"picture-card"` | Shape of the photo tiles. Enum: `picture-card`, `picture-circle`. |
51
65
  | `disabled` | boolean | - | Disable the file input. |
52
66
  | `emitFileContent` | boolean | `false` | Instead of uploading, read the file and emit { name, size, type, content } — content a base64 string — as the block value and onChange event. Use with a CallAPI action to store the file with a server-side write request (e.g. AwsS3PutObject). Replaces uploadPolicyRequestId. |
53
67
  | `maxCount` | number | - | Maximum number of files that can be uploaded. |
54
68
  | `uploadPolicyRequestId` | string | - | Id of an upload-policy request (e.g. AwsS3PresignedPostPolicy, GcsSignedPostPolicy, AzureBlobUploadSas) that defines to which storage bucket and how the file should be uploaded. Required unless emitFileContent is true. |
55
- | `showUploadList` | boolean | `true` | Whether to show default upload list. |
69
+ | `showUploadList` | boolean \| object | `true` | Whether to show the uploaded file list. Set an object to choose which actions each file shows. |
70
+ | `showUploadList.showPreviewIcon` | boolean | `true` | Show the preview action on picture list items. |
71
+ | `showUploadList.showRemoveIcon` | boolean | `true` | Show the remove action, so files can be removed from the list. |
72
+ | `showUploadList.showDownloadIcon` | boolean | `false` | Show the download action. |
56
73
  | `singleFile` | boolean | `false` | Only allow a single file to be uploaded. Only one file can be selected in the prompt. |
57
74
  | `theme` | object | - | Antd design token overrides for this block. See [antd design tokens](https://ant.design/components/upload#design-token). See [Ant Design upload tokens](https://ant.design/components/upload#design-token). |
58
75
  | `theme.actionsColor` | string | - | Color of action icons (download, preview, remove). |
@@ -49,6 +49,13 @@ Week picker for selecting a week of the year.
49
49
  properties:
50
50
  title: Borderless
51
51
  variant: borderless
52
+ - id: ws_variant_underlined
53
+ type: WeekSelector
54
+ properties:
55
+ title: Underlined
56
+ variant: underlined
57
+ label:
58
+ disabled: true
52
59
  ```
53
60
 
54
61
  ```yaml
@@ -123,20 +130,31 @@ Week picker for selecting a week of the year.
123
130
  ```
124
131
 
125
132
  ```yaml
126
- - id: ws_today_enabled
133
+ - id: ws_prefix_icon
127
134
  type: WeekSelector
128
135
  properties:
129
- title: Show Today (default)
130
- showToday: true
131
- label:
132
- disabled: true
133
- - id: ws_today_disabled
136
+ title: Prefix Icon
137
+ prefixIcon: clock
138
+ suffixIcon:
139
+ name: calendar
140
+ color: "#8c8c8c"
141
+ - id: ws_prefix_text
134
142
  type: WeekSelector
135
143
  properties:
136
- title: No Today Button
137
- showToday: false
144
+ title: Prefix Text
145
+ prefix: "From:"
146
+ - id: ws_placement
147
+ type: WeekSelector
148
+ properties:
149
+ title: Popup Opens Top Right
150
+ placement: topRight
151
+ - id: ws_read_only
152
+ type: WeekSelector
153
+ properties:
154
+ title: Pick From Calendar Only
155
+ inputReadOnly: true
138
156
  label:
139
- disabled: true
157
+ extra: The input is read-only, so touch devices do not open the keyboard.
140
158
  ```
141
159
 
142
160
  ```yaml
@@ -150,14 +168,14 @@ Week picker for selecting a week of the year.
150
168
  type: WeekSelector
151
169
  properties:
152
170
  title: Clock Icon
153
- suffixIcon: AiOutlineClockCircle
171
+ suffixIcon: clock
154
172
  label:
155
173
  disabled: true
156
174
  - id: ws_icon_schedule
157
175
  type: WeekSelector
158
176
  properties:
159
177
  title: Schedule Icon
160
- suffixIcon: AiOutlineSchedule
178
+ suffixIcon: CalendarDays
161
179
  label:
162
180
  disabled: true
163
181
  - id: ws_icon_custom_color
@@ -165,7 +183,7 @@ Week picker for selecting a week of the year.
165
183
  properties:
166
184
  title: Custom Color Icon
167
185
  suffixIcon:
168
- name: AiOutlineCalendar
186
+ name: calendar
169
187
  color: "#1677ff"
170
188
  label:
171
189
  disabled: true
@@ -334,7 +352,8 @@ Week picker for selecting a week of the year.
334
352
  - id: ws_style_element_bg
335
353
  type: WeekSelector
336
354
  style:
337
- .element: null
355
+ .element:
356
+ backgroundColor: var(--ant-color-primary-bg)
338
357
  properties:
339
358
  title: Custom Background
340
359
  label:
@@ -421,7 +440,7 @@ Week picker for selecting a week of the year.
421
440
  placeholder: Select sprint week
422
441
  format: YYYY [Week] wo
423
442
  size: large
424
- suffixIcon: AiOutlineSchedule
443
+ suffixIcon: CalendarDays
425
444
  showToday: true
426
445
  allowClear: true
427
446
  label:
@@ -446,7 +465,7 @@ Week picker for selecting a week of the year.
446
465
  placeholder: Select fiscal week
447
466
  format: YYYY [W]ww
448
467
  suffixIcon:
449
- name: AiOutlineCalendar
468
+ name: calendar
450
469
  color: "#1677ff"
451
470
  disabledDates:
452
471
  min: 2026-01-01
@@ -468,7 +487,7 @@ Week picker for selecting a week of the year.
468
487
  placeholder: Select sprint week
469
488
  format: YYYY [Week] wo
470
489
  size: large
471
- suffixIcon: AiOutlineSchedule
490
+ suffixIcon: CalendarDays
472
491
  label:
473
492
  extra: Choose the week this sprint begins.
474
493
  - id: applied_sprint_team
@@ -496,7 +515,7 @@ Week picker for selecting a week of the year.
496
515
  type: Button
497
516
  properties:
498
517
  title: Start Sprint
499
- icon: AiOutlineThunderbolt
518
+ icon: Zap
500
519
  type: primary
501
520
  block: true
502
521
  events:
@@ -567,7 +586,7 @@ Week picker for selecting a week of the year.
567
586
  type: Button
568
587
  properties:
569
588
  title: Submit Timesheet
570
- icon: AiOutlineCheck
589
+ icon: check
571
590
  type: primary
572
591
  block: true
573
592
  events:
@@ -590,7 +609,7 @@ Week picker for selecting a week of the year.
590
609
  | `autoFocus` | boolean | `false` | Autofocus to the block on page load. |
591
610
  | `bordered` | boolean | `true` | Deprecated - use variant: 'borderless'. Whether or not the input has a border style. |
592
611
  | `disabled` | boolean | `false` | Disable the block if true. |
593
- | `variant` | string | `"outlined"` | Variant style of the input. Use 'borderless' instead of bordered: false. Enum: `outlined`, `filled`, `borderless`. |
612
+ | `variant` | string | `"outlined"` | Variant style of the input. Use 'borderless' instead of bordered: false. Enum: `outlined`, `filled`, `borderless`, `underlined`. |
594
613
  | `disabledDates` | object | - | Disable specific dates so that they can not be chosen. |
595
614
  | `disabledDates.min` | string \| object | - | Disable all dates less than the minimum date. Can be a date string or a _date object. |
596
615
  | `disabledDates.max` | string \| object | - | Disable all dates greater than the maximum date. Can be a date string or a _date object. |
@@ -599,67 +618,112 @@ Week picker for selecting a week of the year.
599
618
  | `disabledDates.ranges.$.from` | string \| object | - | Start of the disabled range. |
600
619
  | `disabledDates.ranges.$.to` | string \| object | - | End of the disabled range. |
601
620
  | `format` | string | `"YYYY-wo"` | Format in which to format the date value, eg. "wo-YYYY" will format a date value of 1999-12-26 as "52nd-1999". The format has to conform to dayjs formats. |
621
+ | `inputReadOnly` | boolean | `false` | Make the text input read-only, so a date can only be chosen from the calendar. This also stops the on-screen keyboard opening on touch devices. |
602
622
  | `placeholder` | string | - | Placeholder text inside the block before user types input. |
623
+ | `placement` | string | `"bottomLeft"` | Position of the calendar popup relative to the input. Enum: `bottomLeft`, `bottomRight`, `topLeft`, `topRight`. |
624
+ | `prefix` | string | - | Prefix text shown before the date in the input, priority over prefixIcon. |
625
+ | `prefixIcon` | 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 customize icon on the left-hand side of the date picker. |
626
+ | `prefixIcon.name` | string | - | Icon name: a semantic name like `edit`, a Lucide icon name like `Pencil`, or a set-qualified name like `tabler:Pencil`. |
627
+ | `prefixIcon.color` | string | - | Icon color. |
628
+ | `prefixIcon.size` | string \| number | - | Size of the icon. Defaults to `theme.icons.size`. |
629
+ | `prefixIcon.rotate` | number | - | Number of degrees to rotate the icon. |
630
+ | `prefixIcon.spin` | boolean | - | Continuously spin the icon with animation. |
631
+ | `prefixIcon.strokeWidth` | number | - | Stroke width of the icon lines, in pixels of the 24px icon grid. Defaults to `theme.icons.strokeWidth` (2). |
632
+ | `prefixIcon.nonScalingStroke` | boolean | - | Keep the stroke width constant at any icon size. Defaults to `theme.icons.nonScalingStroke`. |
633
+ | `prefixIcon.title` | string | - | Icon hover title for accessibility. An empty string marks the icon as decorative. |
634
+ | `prefixIcon.disableLoadingIcon` | boolean | - | While loading after the icon has been clicked, don't render the loading icon. |
603
635
  | `presets` | array | - | Shortcuts listed next to the calendar to quickly select a week. Presets are re-evaluated every time the block config is evaluated, so operator based values like "_date: now" stay current. A preset is offered on the same terms as the calendar cells: a shortcut with nothing it may select is listed as disabled. |
604
636
  | `presets.$.label` | string | - | Text shown for the shortcut - supports html. |
605
637
  | `presets.$.value` | string \| number \| object | - | A date string, a timestamp, or a _date object. Dates are read as UTC, the same as the block value, so a fixed date like "2026-01-01" resolves to the same week in every timezone. A date relative to now is an instant, not a calendar date, so end a _dayjs chain with a format step to pin it to the local calendar: "_dayjs: [now, {startOf: week}, {format: YYYY-MM-DD}]". Without the format step the chain resolves to an instant, which can select the week before or after the current one, depending on the browser timezone and the time of day. |
606
638
  | `label` | object | - | Label properties. |
639
+ | `label.xs` | object | - | Label width on extra small screens (below 576px) when the label is not inline. |
640
+ | `label.xs.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
641
+ | `label.sm` | object | - | Label width on small screens (576px and up) when the label is not inline. Also applies below 576px unless `xs` is set. |
642
+ | `label.sm.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
643
+ | `label.md` | object | - | Label width on medium screens (768px and up) when the label is not inline. Overrides `span`. |
644
+ | `label.md.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
645
+ | `label.lg` | object | - | Label width on large screens (992px and up) when the label is not inline. |
646
+ | `label.lg.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
647
+ | `label.xl` | object | - | Label width on extra large screens (1200px and up) when the label is not inline. |
648
+ | `label.xl.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
649
+ | `label.xxl` | object | - | Label width on extra extra large screens (1600px and up) when the label is not inline. |
650
+ | `label.xxl.span` | number | - | Label width in columns, out of 24. The content takes the remaining columns. |
607
651
  | `label.align` | string | `"left"` | Align label left or right when inline. Enum: `left`, `right`. |
608
652
  | `label.colon` | boolean | `true` | Append label with colon. |
609
653
  | `label.extra` | string | - | Extra text to display beneath the content - supports html. |
610
654
  | `label.title` | string | - | Label title - supports html. |
611
655
  | `label.tooltip` | string \| object | - | Help tooltip shown via an icon beside the label. A string sets the tooltip text (supports html), or an object to also customize the icon and color. Use the block's onTooltipClick event to respond to clicks on the icon. |
612
656
  | `label.tooltip.title` | string | - | Tooltip text shown on hover - supports html. |
613
- | `label.tooltip.icon` | string | `"AiOutlineQuestionCircle"` | Name of the icon to show beside the label. |
657
+ | `label.tooltip.icon` | string | `"help"` | Icon name to show beside the label: a semantic name like `help`, a Lucide icon name like `CircleQuestionMark`, or a set-qualified name like `tabler:HelpCircle`. |
614
658
  | `label.tooltip.color` | string | - | Color of the tooltip icon. |
615
- | `label.span` | number | - | Label inline span. |
659
+ | `label.span` | number | - | Label width in columns, out of 24, on medium screens (768px) and up when the label is not inline. The content takes the remaining columns. |
616
660
  | `label.disabled` | boolean | `false` | Hide input label. |
617
661
  | `label.hasFeedback` | boolean | `true` | Display feedback extra from validation, this does not disable validation. |
618
662
  | `label.inline` | boolean | `false` | Render input and label inline. |
619
- | `showToday` | boolean | `true` | Shows a button to easily select the current date if true. |
663
+ | `label.wrap` | boolean | `false` | Wrap long label text onto multiple lines when the label is inline. Labels above their input always wrap. |
664
+ | `showToday` | boolean | `true` | Deprecated - has no effect. The week picker has no button to select the current date. |
620
665
  | `size` | string | `"default"` | Size of the block. Enum: `small`, `default`, `large`. |
621
- | `suffixIcon` | string \| object | `"AiOutlineCalendar"` | Name of an React-Icon (See all icons) or properties of an Icon block to customize icon at the right-hand side of the date picker. |
666
+ | `suffixIcon` | string \| object | `"calendar"` | 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 customize icon at the right-hand side of the date picker. |
667
+ | `suffixIcon.name` | string | - | Icon name: a semantic name like `edit`, a Lucide icon name like `Pencil`, or a set-qualified name like `tabler:Pencil`. |
668
+ | `suffixIcon.color` | string | - | Icon color. |
669
+ | `suffixIcon.size` | string \| number | - | Size of the icon. Defaults to `theme.icons.size`. |
670
+ | `suffixIcon.rotate` | number | - | Number of degrees to rotate the icon. |
671
+ | `suffixIcon.spin` | boolean | - | Continuously spin the icon with animation. |
672
+ | `suffixIcon.strokeWidth` | number | - | Stroke width of the icon lines, in pixels of the 24px icon grid. Defaults to `theme.icons.strokeWidth` (2). |
673
+ | `suffixIcon.nonScalingStroke` | boolean | - | Keep the stroke width constant at any icon size. Defaults to `theme.icons.nonScalingStroke`. |
674
+ | `suffixIcon.title` | string | - | Icon hover title for accessibility. An empty string marks the icon as decorative. |
675
+ | `suffixIcon.disableLoadingIcon` | boolean | - | While loading after the icon has been clicked, don't render the loading icon. |
622
676
  | `title` | string | - | Title to describe the input component, if no title is specified the block id is displayed - supports html. |
623
677
  | `theme` | object | - | Antd design token overrides for this block. See [antd design tokens](https://ant.design/components/overview#design-token). See [Ant Design date-picker tokens](https://ant.design/components/date-picker#design-token). |
678
+ | `theme.activeBg` | string | `"#ffffff"` | Background color of the input when the picker is active/focused. |
679
+ | `theme.activeBorderColor` | string | - | Border color when the picker is active/focused. |
680
+ | `theme.activeShadow` | string | `"0 0 0 2px rgba(5,145,255,0.1)"` | Shadow effect when the picker is active/focused. |
681
+ | `theme.borderRadius` | number | `6` | Border radius of the picker input. |
682
+ | `theme.borderRadiusLG` | number | `8` | Border radius for the large picker and popup panel. |
683
+ | `theme.borderRadiusSM` | number | `4` | Border radius for the small picker. |
684
+ | `theme.cellActiveWithRangeBg` | string | `"#e6f4ff"` | Background color of cells within the selected range. |
685
+ | `theme.cellBgDisabled` | string | `"rgba(0,0,0,0.04)"` | Background color of disabled cells. |
624
686
  | `theme.cellHeight` | number | `24` | Height of a calendar cell. |
687
+ | `theme.cellHoverBg` | string | `"rgba(0, 0, 0, 0.04)"` | Background color of a calendar cell on hover. |
688
+ | `theme.cellHoverWithRangeBg` | string | `"#cbe0fd"` | Background color of cells within range on hover. |
689
+ | `theme.cellRangeBorderColor` | string | `"#82b4f9"` | Border color of range selection cells. |
625
690
  | `theme.cellWidth` | number | `36` | Width of a calendar cell. |
626
- | `theme.cellHoverBg` | string | - | Background color of a calendar cell on hover. |
627
- | `theme.cellActiveWithRangeBg` | string | - | Background color of cells within the selected range. |
628
- | `theme.cellHoverWithRangeBg` | string | - | Background color of cells within range on hover. |
629
- | `theme.cellBgDisabled` | string | - | Background color of disabled cells. |
630
- | `theme.cellRangeBorderColor` | string | - | Border color of range selection cells. |
631
- | `theme.timeColumnWidth` | number | `56` | Width of the time panel column. |
632
- | `theme.timeColumnHeight` | number | `224` | Height of the time panel column. |
633
- | `theme.timeCellHeight` | number | `28` | Height of a time cell in the time panel. |
634
- | `theme.addonBg` | string | - | Background color for the addon area. |
635
- | `theme.hoverBorderColor` | string | - | Border color on hover. |
636
- | `theme.activeBorderColor` | string | - | Border color when active. |
637
- | `theme.activeShadow` | string | - | Shadow effect when active. |
638
- | `theme.paddingBlock` | number | `4` | Vertical padding of the input. |
639
- | `theme.paddingBlockSM` | number | `0` | Vertical padding for small size. |
640
- | `theme.paddingBlockLG` | number | `7` | Vertical padding for large size. |
641
- | `theme.paddingInline` | number | `11` | Horizontal padding of the input. |
642
- | `theme.paddingInlineSM` | number | `7` | Horizontal padding for small size. |
643
- | `theme.paddingInlineLG` | number | `11` | Horizontal padding for large size. |
644
- | `theme.zIndexPopup` | number | `1050` | Z-index of the picker popup. |
645
- | `theme.borderRadius` | number | `6` | Border radius of the input. |
646
- | `theme.borderRadiusSM` | number | `4` | Border radius for the small picker. |
647
- | `theme.borderRadiusLG` | number | `8` | Border radius for the large picker and popup panel. |
648
- | `theme.controlHeight` | number | `32` | Height of the input. |
649
- | `theme.controlHeightLG` | number | `40` | Height for large size. |
650
- | `theme.controlHeightSM` | number | `24` | Height for small size. |
691
+ | `theme.colorBgContainer` | string | - | Background color of the picker input. |
692
+ | `theme.colorBorder` | string | - | Border color of the picker input. |
693
+ | `theme.colorPrimary` | string | - | Primary color used for the selected date and active states. |
694
+ | `theme.colorText` | string | - | Text color of the picker input and calendar cells. |
695
+ | `theme.colorTextPlaceholder` | string | - | Color of the placeholder text. |
696
+ | `theme.controlHeight` | number | `32` | Height of the picker input. |
697
+ | `theme.controlHeightLG` | number | `40` | Height of the large picker input. |
698
+ | `theme.controlHeightSM` | number | `24` | Height of the small picker input. |
699
+ | `theme.errorActiveShadow` | string | `"0 0 0 2px rgba(255,38,5,0.06)"` | Shadow effect when the picker has error status and is focused. |
651
700
  | `theme.fontSize` | number | `14` | Font size of the picker input. |
652
- | `theme.fontSizeSM` | number | `14` | Font size for the small picker. |
653
701
  | `theme.fontSizeLG` | number | `16` | Font size for the large picker. |
654
- | `theme.lineWidth` | number | `1` | Border width. |
655
- | `theme.colorPrimary` | string | - | Primary color override. |
656
- | `theme.colorBgContainer` | string | - | Background color of the input. |
657
- | `theme.colorText` | string | - | Text color. |
658
- | `theme.colorBorder` | string | - | Border color. |
659
- | `theme.colorTextPlaceholder` | string | - | Placeholder text color. |
702
+ | `theme.fontSizeSM` | number | `14` | Font size for the small picker. |
703
+ | `theme.hoverBg` | string | `"#ffffff"` | Background color of the input when hovering over the picker. |
704
+ | `theme.hoverBorderColor` | string | - | Border color when hovering over the picker. |
705
+ | `theme.lineWidth` | number | `1` | Border width of the picker input. |
706
+ | `theme.paddingBlock` | number | `4` | Vertical padding for the default size picker. |
707
+ | `theme.paddingBlockLG` | number | `7` | Vertical padding for the large size picker. |
708
+ | `theme.paddingBlockSM` | number | `0` | Vertical padding for the small size picker. |
709
+ | `theme.paddingInline` | number | `11` | Horizontal padding for the default size picker. |
710
+ | `theme.paddingInlineLG` | number | `11` | Horizontal padding for the large size picker. |
711
+ | `theme.paddingInlineSM` | number | `7` | Horizontal padding for the small size picker. |
712
+ | `theme.presetsMaxWidth` | number | `200` | Maximum width of the presets list next to the calendar. |
713
+ | `theme.presetsWidth` | number | `120` | Width of the presets list next to the calendar. |
714
+ | `theme.timeCellHeight` | number | `28` | Height of a time cell in the time panel. |
715
+ | `theme.timeColumnHeight` | number | `224` | Height of the time panel column. |
716
+ | `theme.timeColumnWidth` | number | `56` | Width of the time panel column. |
717
+ | `theme.warningActiveShadow` | string | `"0 0 0 2px rgba(255,215,5,0.1)"` | Shadow effect when the picker has warning status and is focused. |
718
+ | `theme.withoutTimeCellHeight` | number | `66` | Height of the cells of the month, week, quarter, year and decade panels. |
719
+ | `theme.zIndexPopup` | number | `1050` | Z-index of the picker popup layer. |
660
720
 
661
721
  | Event | Event Data | Description |
662
722
  | --- | --- | --- |
723
+ | `onBlur` | \- | Trigger actions when the picker loses focus. |
724
+ | `onClear` | \- | Trigger actions when the clear button is clicked. |
725
+ | `onFocus` | \- | Trigger actions when the picker gets focus. |
726
+ | `onOpenChange` | `{ open }` | Trigger actions when the calendar popup opens or closes. |
663
727
  | `onChange` | `{ value }` | Trigger action when week is changed. |
664
728
  | `onTooltipClick` | \- | Trigger actions when the tooltip icon is clicked. |
665
729
 
@@ -671,6 +735,7 @@ Week picker for selecting a week of the year.
671
735
  | `/extra` | The WeekSelector extra content. |
672
736
  | `/feedback` | The WeekSelector validation feedback. |
673
737
  | `/popup` | The WeekSelector popup. |
738
+ | `/prefixIcon` | The prefix icon in the WeekSelector. |
674
739
  | `/suffixIcon` | The suffix icon in the WeekSelector. |
675
740
 
676
741
  No slots defined.
@@ -0,0 +1,27 @@
1
+ # Introduction
2
+
3
+ $
4
+
5
+ pnpx lowdefy@5 init && pnpx lowdefy@5 dev
6
+
7
+ Built with four primitives
8
+
9
+ The UI. 114 components you compose into pages.
10
+
11
+ The logic. 70 functions evaluated live in config.
12
+
13
+ The behavior. Respond to clicks, loads, and changes.
14
+
15
+ The data. Databases, APIs, and AI, server-side.
16
+
17
+ What you can build
18
+
19
+ Start here
20
+
21
+ One command to a running app, one edit to make it yours.
22
+
23
+ Build a complete app — pages, requests, data, and deployment.
24
+
25
+ The mental model — four primitives and one state loop.
26
+
27
+ Batteries included, ecosystem attached
@@ -0,0 +1,53 @@
1
+ # Quickstart
2
+
3
+ A running Lowdefy app in five minutes. You need [Node.js](https://nodejs.org) v24 or newer and [pnpm](https://pnpm.io) installed.
4
+
5
+ ## 1. Create an app
6
+
7
+ Initialize a new app and start the dev server:
8
+
9
+ $
10
+
11
+ pnpx lowdefy@5 init && pnpx lowdefy@5 dev
12
+
13
+ This creates a `lowdefy.yaml` in the current directory and opens your app at
14
+ [http://localhost:3000](http://localhost:3000). The dev server reloads on every save.
15
+
16
+ ## 2. Add a block
17
+
18
+ Pages are lists of blocks. Open `lowdefy.yaml` and add a `TextInput` and a `Title` to the first page's `blocks`:
19
+
20
+ ```yaml
21
+ blocks:
22
+ - id: name
23
+ type: TextInput
24
+ properties:
25
+ title: What is your name?
26
+ - id: greeting
27
+ type: Title
28
+ properties:
29
+ content:
30
+ _nunjucks:
31
+ template: 'Hello {{ name }}!'
32
+ on:
33
+ name:
34
+ _state: name
35
+ ```
36
+
37
+ Save, and type into the input — the title updates as you type.
38
+
39
+ ## 3. What just happened
40
+
41
+ You used three of the four primitives:
42
+
43
+ - The **blocks** `TextInput` and `Title` render the UI.
44
+ - The **operators** `_state` and `_nunjucks` read the input's value from page state and template the greeting. Operators re-evaluate whenever state changes.
45
+ - Behind the scenes, typing fires **events** — the fourth primitive, **actions**, lets you respond to them (navigate, call APIs, set state).
46
+
47
+ Add a **connection** and a request when you're ready to talk to a database or API.
48
+
49
+ ## Next steps
50
+
51
+ - Take the [full tutorial](/tutorial-start) — build a complete app with requests and data, in about an hour.
52
+ - Read [The Four Primitives](/four-primitives) for the mental model.
53
+ - Browse the [Reference](/reference) to see everything Lowdefy ships.
@@ -0,0 +1,8 @@
1
+ # Showcase
2
+
3
+ More than 25 000 apps have been built with Lowdefy — admin panels, BI dashboards,
4
+ CRMs, ticketing systems, webforms, and these docs themselves. A few open examples:
5
+
6
+ Built something with Lowdefy? Share it with the community on
7
+ [GitHub Discussions](https://github.com/lowdefy/lowdefy/discussions) or
8
+ [Discord](https://discord.gg/WmcJgXt).