payload-canvas 0.4.0 → 0.5.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 (468) hide show
  1. package/README.md +625 -153
  2. package/dist/admin/AiKeyField.d.ts +8 -0
  3. package/dist/admin/AiKeyField.js +54 -0
  4. package/dist/admin/BuilderTab.js +4 -1
  5. package/dist/admin/DocumentEditView.d.ts +9 -0
  6. package/dist/admin/DocumentEditView.js +45 -0
  7. package/dist/admin/LayoutField.d.ts +2 -2
  8. package/dist/admin/LayoutField.js +10 -7
  9. package/dist/admin/TemplateConditionsField.d.ts +9 -0
  10. package/dist/admin/TemplateConditionsField.js +22 -0
  11. package/dist/admin/aiKeyField.scss +58 -0
  12. package/dist/admin/client.d.ts +3 -0
  13. package/dist/admin/client.js +6 -0
  14. package/dist/admin/diff/changes.js +5 -0
  15. package/dist/admin/editor/Canvas.js +20 -5
  16. package/dist/admin/editor/Editor.d.ts +3 -1
  17. package/dist/admin/editor/Editor.js +6 -3
  18. package/dist/admin/editor/Inspector.js +75 -28
  19. package/dist/admin/editor/Library.js +40 -15
  20. package/dist/admin/editor/Outline.js +21 -16
  21. package/dist/admin/editor/Overlay.js +8 -3
  22. package/dist/admin/editor/actions.d.ts +10 -2
  23. package/dist/admin/editor/actions.js +18 -3
  24. package/dist/admin/editor/assistant/AssistantPanel.js +3 -1
  25. package/dist/admin/editor/classes/ClassManager.d.ts +4 -0
  26. package/dist/admin/editor/classes/ClassManager.js +56 -0
  27. package/dist/admin/editor/classes/controller.d.ts +112 -0
  28. package/dist/admin/editor/classes/controller.js +326 -0
  29. package/dist/admin/editor/classes/manager.scss +262 -0
  30. package/dist/admin/editor/classes/managerModel.d.ts +5 -0
  31. package/dist/admin/editor/classes/managerModel.js +27 -0
  32. package/dist/admin/editor/comments/CommentLayer.d.ts +2 -0
  33. package/dist/admin/editor/comments/CommentLayer.js +143 -0
  34. package/dist/admin/editor/comments/CommentsPanel.d.ts +8 -0
  35. package/dist/admin/editor/comments/CommentsPanel.js +73 -0
  36. package/dist/admin/editor/comments/Thread.d.ts +26 -0
  37. package/dist/admin/editor/comments/Thread.js +84 -0
  38. package/dist/admin/editor/comments/comments.scss +539 -0
  39. package/dist/admin/editor/comments/controller.d.ts +48 -0
  40. package/dist/admin/editor/comments/controller.js +142 -0
  41. package/dist/admin/editor/contentMode.d.ts +17 -0
  42. package/dist/admin/editor/contentMode.js +37 -0
  43. package/dist/admin/editor/dnd/DropOutlines.d.ts +1 -0
  44. package/dist/admin/editor/dnd/DropOutlines.js +73 -0
  45. package/dist/admin/editor/dnd/dnd.scss +43 -0
  46. package/dist/admin/editor/dnd/mode.d.ts +4 -0
  47. package/dist/admin/editor/dnd/mode.js +39 -0
  48. package/dist/admin/editor/editor.scss +13 -58
  49. package/dist/admin/editor/empty/EmptyStart.js +18 -66
  50. package/dist/admin/editor/fields/AddButton.d.ts +15 -0
  51. package/dist/admin/editor/fields/AddButton.js +14 -0
  52. package/dist/admin/editor/fields/ArrayField.js +3 -2
  53. package/dist/admin/editor/fields/CheckedInputs.d.ts +1 -0
  54. package/dist/admin/editor/fields/ConditionRows.d.ts +19 -0
  55. package/dist/admin/editor/fields/ConditionRows.js +137 -0
  56. package/dist/admin/editor/fields/ListWhereField.d.ts +8 -0
  57. package/dist/admin/editor/fields/ListWhereField.js +20 -0
  58. package/dist/admin/editor/fields/QueryFiltersField.d.ts +18 -0
  59. package/dist/admin/editor/fields/QueryFiltersField.js +41 -0
  60. package/dist/admin/editor/fields/RelatedField.d.ts +19 -0
  61. package/dist/admin/editor/fields/RelatedField.js +44 -0
  62. package/dist/admin/editor/fields/SortField.d.ts +13 -0
  63. package/dist/admin/editor/fields/SortField.js +37 -0
  64. package/dist/admin/editor/fields/WhereField.d.ts +12 -4
  65. package/dist/admin/editor/fields/WhereField.js +33 -53
  66. package/dist/admin/editor/fields/collectionFields.d.ts +6 -0
  67. package/dist/admin/editor/fields/collectionFields.js +15 -0
  68. package/dist/admin/editor/fields/conditions.d.ts +99 -0
  69. package/dist/admin/editor/fields/conditions.js +339 -0
  70. package/dist/admin/editor/fields/fields.scss +232 -9
  71. package/dist/admin/editor/fields/listOptions.d.ts +44 -0
  72. package/dist/admin/editor/fields/listOptions.js +111 -0
  73. package/dist/admin/editor/fields/queryFilterRows.d.ts +8 -0
  74. package/dist/admin/editor/fields/queryFilterRows.js +29 -0
  75. package/dist/admin/editor/fields/whereRows.d.ts +11 -12
  76. package/dist/admin/editor/fields/whereRows.js +83 -34
  77. package/dist/admin/editor/icons.d.ts +16 -1
  78. package/dist/admin/editor/icons.js +30 -1
  79. package/dist/admin/editor/inline.js +9 -0
  80. package/dist/admin/editor/insert/InsertHandle.js +4 -1
  81. package/dist/admin/editor/insert/picker.d.ts +3 -1
  82. package/dist/admin/editor/insert/picker.js +17 -10
  83. package/dist/admin/editor/insert/spots.d.ts +12 -1
  84. package/dist/admin/editor/insert/spots.js +49 -10
  85. package/dist/admin/editor/layout/LeftPanel.js +11 -6
  86. package/dist/admin/editor/live/useMultiplayer.js +9 -1
  87. package/dist/admin/editor/menu/blockMenu.js +27 -17
  88. package/dist/admin/editor/names.js +11 -3
  89. package/dist/admin/editor/renderField.d.ts +3 -1
  90. package/dist/admin/editor/renderField.js +63 -12
  91. package/dist/admin/editor/runtime.d.ts +14 -0
  92. package/dist/admin/editor/runtime.js +67 -6
  93. package/dist/admin/editor/sections/ComponentFields.d.ts +8 -0
  94. package/dist/admin/editor/sections/ComponentFields.js +116 -0
  95. package/dist/admin/editor/sections/PropertyControls.d.ts +18 -0
  96. package/dist/admin/editor/sections/PropertyControls.js +65 -0
  97. package/dist/admin/editor/sections/components.d.ts +29 -0
  98. package/dist/admin/editor/sections/components.js +112 -0
  99. package/dist/admin/editor/sections/components.scss +238 -0
  100. package/dist/admin/editor/sections/variants.d.ts +32 -0
  101. package/dist/admin/editor/sections/variants.js +59 -0
  102. package/dist/admin/editor/sections/variants.scss +90 -0
  103. package/dist/admin/editor/shortcuts.d.ts +4 -1
  104. package/dist/admin/editor/shortcuts.js +19 -3
  105. package/dist/admin/editor/store.d.ts +18 -0
  106. package/dist/admin/editor/store.js +46 -0
  107. package/dist/admin/editor/styles/ClassBar.d.ts +14 -0
  108. package/dist/admin/editor/styles/ClassBar.js +90 -0
  109. package/dist/admin/editor/styles/ClassCss.d.ts +4 -0
  110. package/dist/admin/editor/styles/ClassCss.js +28 -0
  111. package/dist/admin/editor/styles/ClassDialog.d.ts +2 -0
  112. package/dist/admin/editor/styles/ClassDialog.js +151 -0
  113. package/dist/admin/editor/styles/ColorPicker.js +5 -2
  114. package/dist/admin/editor/styles/RawClasses.d.ts +26 -1
  115. package/dist/admin/editor/styles/RawClasses.js +184 -32
  116. package/dist/admin/editor/styles/StylesPanel.d.ts +3 -3
  117. package/dist/admin/editor/styles/StylesPanel.js +53 -14
  118. package/dist/admin/editor/styles/VariantBar.js +2 -2
  119. package/dist/admin/editor/styles/classEdit.d.ts +4 -0
  120. package/dist/admin/editor/styles/classEdit.js +20 -0
  121. package/dist/admin/editor/styles/classes.scss +381 -0
  122. package/dist/admin/editor/styles/context.d.ts +19 -6
  123. package/dist/admin/editor/styles/context.js +24 -6
  124. package/dist/admin/editor/styles/controls.d.ts +3 -1
  125. package/dist/admin/editor/styles/controls.js +30 -12
  126. package/dist/admin/editor/styles/popover.d.ts +6 -0
  127. package/dist/admin/editor/styles/popover.js +5 -5
  128. package/dist/admin/editor/styles/styles.scss +26 -104
  129. package/dist/admin/editor/styles/suggestions.d.ts +22 -0
  130. package/dist/admin/editor/styles/suggestions.js +77 -0
  131. package/dist/admin/editor/styles/tokens.js +14 -0
  132. package/dist/admin/editor/templates/Bindable.js +86 -57
  133. package/dist/admin/editor/templates/SamplePicker.js +1 -1
  134. package/dist/admin/editor/templates/Visibility.d.ts +9 -0
  135. package/dist/admin/editor/templates/Visibility.js +54 -0
  136. package/dist/admin/editor/templates/binding.d.ts +2 -2
  137. package/dist/admin/editor/templates/binding.js +2 -2
  138. package/dist/admin/editor/templates/templates.scss +27 -0
  139. package/dist/admin/editor/templates/visibilityRows.d.ts +22 -0
  140. package/dist/admin/editor/templates/visibilityRows.js +83 -0
  141. package/dist/admin/editor/topbar/ContentModeToggle.d.ts +5 -0
  142. package/dist/admin/editor/topbar/ContentModeToggle.js +26 -0
  143. package/dist/admin/editor/topbar/DocumentActions.d.ts +1 -1
  144. package/dist/admin/editor/topbar/DocumentActions.js +5 -4
  145. package/dist/admin/editor/topbar/DocumentTitle.js +7 -2
  146. package/dist/admin/editor/topbar/TopBar.js +15 -3
  147. package/dist/admin/editor/topbar/contentMode.scss +35 -0
  148. package/dist/admin/editor/topbar/topbar.scss +3 -1
  149. package/dist/admin/formChoice.d.ts +3 -0
  150. package/dist/admin/formChoice.js +10 -0
  151. package/dist/admin/layoutField.scss +69 -0
  152. package/dist/admin/screen/BuilderScreen.d.ts +6 -1
  153. package/dist/admin/screen/BuilderScreen.js +4 -3
  154. package/dist/admin/server/BuilderView.js +10 -3
  155. package/dist/admin/templateConditions.scss +24 -0
  156. package/dist/ai/adapters/anthropic.js +17 -4
  157. package/dist/ai/adapters/cloudflare-gateway.js +7 -1
  158. package/dist/ai/adapters/cloudflare-workers-ai.js +2 -0
  159. package/dist/ai/adapters/openai-compatible.js +1 -0
  160. package/dist/ai/adapters/openrouter.js +2 -0
  161. package/dist/ai/config.d.ts +24 -4
  162. package/dist/ai/config.js +27 -8
  163. package/dist/ai/endpoint.d.ts +5 -2
  164. package/dist/ai/endpoint.js +31 -26
  165. package/dist/ai/images/cloudflare-workers-ai.js +6 -2
  166. package/dist/ai/images/openai.js +8 -3
  167. package/dist/ai/images/openrouter.js +6 -2
  168. package/dist/ai/images/service.d.ts +10 -4
  169. package/dist/ai/images/service.js +23 -7
  170. package/dist/ai/openai-format.d.ts +7 -0
  171. package/dist/ai/openai-format.js +17 -5
  172. package/dist/ai/prompt.d.ts +8 -0
  173. package/dist/ai/prompt.js +25 -5
  174. package/dist/ai/settings/index.d.ts +62 -0
  175. package/dist/ai/settings/index.js +264 -0
  176. package/dist/ai/settings/secret.d.ts +11 -0
  177. package/dist/ai/settings/secret.js +46 -0
  178. package/dist/ai/settings/shared.d.ts +22 -0
  179. package/dist/ai/settings/shared.js +3 -0
  180. package/dist/ai/tools.d.ts +3 -0
  181. package/dist/ai/tools.js +79 -15
  182. package/dist/ai/types.d.ts +43 -0
  183. package/dist/blocks/builtins/adjacentLinks.d.ts +5 -0
  184. package/dist/blocks/builtins/adjacentLinks.js +76 -0
  185. package/dist/blocks/builtins/carousel.d.ts +2 -29
  186. package/dist/blocks/builtins/carousel.js +44 -51
  187. package/dist/blocks/builtins/disclosure.d.ts +2 -1
  188. package/dist/blocks/builtins/disclosure.js +22 -32
  189. package/dist/blocks/builtins/embed.d.ts +15 -0
  190. package/dist/blocks/builtins/embed.js +47 -0
  191. package/dist/blocks/builtins/faq.d.ts +1 -1
  192. package/dist/blocks/builtins/faq.js +2 -2
  193. package/dist/blocks/builtins/filterLink.d.ts +1 -19
  194. package/dist/blocks/builtins/filterLink.js +9 -50
  195. package/dist/blocks/builtins/icon.d.ts +2 -0
  196. package/dist/blocks/builtins/icon.js +8 -8
  197. package/dist/blocks/builtins/index.d.ts +18 -13
  198. package/dist/blocks/builtins/index.js +43 -22
  199. package/dist/blocks/builtins/marquee.d.ts +5 -0
  200. package/dist/blocks/builtins/marquee.js +68 -0
  201. package/dist/blocks/builtins/popup.d.ts +5 -0
  202. package/dist/blocks/builtins/popup.js +83 -0
  203. package/dist/blocks/builtins/sectionRef.d.ts +16 -2
  204. package/dist/blocks/builtins/sectionRef.js +34 -12
  205. package/dist/blocks/builtins/shared.d.ts +18 -23
  206. package/dist/blocks/builtins/shared.js +34 -42
  207. package/dist/blocks/builtins/tableOfContents.d.ts +4 -0
  208. package/dist/blocks/builtins/tableOfContents.js +12 -18
  209. package/dist/blocks/builtins/tabs.d.ts +6 -0
  210. package/dist/blocks/builtins/tabs.js +87 -0
  211. package/dist/blocks/client/adjacentLinks.d.ts +4 -0
  212. package/dist/blocks/client/adjacentLinks.js +4 -0
  213. package/dist/blocks/client/carousel.d.ts +45 -0
  214. package/dist/blocks/client/carousel.js +53 -0
  215. package/dist/blocks/client/embed.d.ts +21 -0
  216. package/dist/blocks/client/embed.js +23 -0
  217. package/dist/blocks/client/field.d.ts +7 -0
  218. package/dist/blocks/client/field.js +8 -0
  219. package/dist/blocks/client/filterLink.d.ts +19 -0
  220. package/dist/blocks/client/filterLink.js +30 -0
  221. package/dist/blocks/client/helpers.d.ts +21 -0
  222. package/dist/blocks/client/helpers.js +24 -0
  223. package/dist/blocks/client/marquee.d.ts +14 -0
  224. package/dist/blocks/client/marquee.js +25 -0
  225. package/dist/blocks/client/menu.d.ts +46 -0
  226. package/dist/blocks/client/menu.js +49 -0
  227. package/dist/blocks/client/popup.d.ts +15 -0
  228. package/dist/blocks/client/popup.js +16 -0
  229. package/dist/blocks/client/tabs.d.ts +10 -0
  230. package/dist/blocks/client/tabs.js +11 -0
  231. package/dist/blocks/defaults.d.ts +15 -52
  232. package/dist/blocks/defaults.js +203 -437
  233. package/dist/blocks/index.d.ts +1 -2
  234. package/dist/blocks/index.js +1 -2
  235. package/dist/classes/actions.d.ts +97 -0
  236. package/dist/classes/actions.js +296 -0
  237. package/dist/classes/collection.d.ts +5 -0
  238. package/dist/classes/collection.js +189 -0
  239. package/dist/classes/config.d.ts +34 -0
  240. package/dist/classes/config.js +8 -0
  241. package/dist/classes/endpoints.d.ts +2 -0
  242. package/dist/classes/endpoints.js +120 -0
  243. package/dist/classes/index.d.ts +36 -0
  244. package/dist/classes/index.js +42 -0
  245. package/dist/classes/mcp.d.ts +6 -0
  246. package/dist/classes/mcp.js +161 -0
  247. package/dist/classes/shared.d.ts +131 -0
  248. package/dist/classes/shared.js +300 -0
  249. package/dist/classes/sheet.d.ts +34 -0
  250. package/dist/classes/sheet.js +126 -0
  251. package/dist/classes/usage.d.ts +57 -0
  252. package/dist/classes/usage.js +208 -0
  253. package/dist/comments/collection.d.ts +38 -0
  254. package/dist/comments/collection.js +226 -0
  255. package/dist/comments/config.d.ts +15 -0
  256. package/dist/comments/config.js +2 -0
  257. package/dist/comments/index.d.ts +20 -0
  258. package/dist/comments/index.js +22 -0
  259. package/dist/comments/shared.d.ts +54 -0
  260. package/dist/comments/shared.js +104 -0
  261. package/dist/core/bindings.d.ts +77 -32
  262. package/dist/core/bindings.js +319 -134
  263. package/dist/core/blockNames.d.ts +9 -0
  264. package/dist/core/blockNames.js +11 -0
  265. package/dist/core/blocks.d.ts +21 -8
  266. package/dist/core/blocks.js +37 -16
  267. package/dist/core/classes.d.ts +16 -8
  268. package/dist/core/classes.js +31 -27
  269. package/dist/core/components.d.ts +72 -0
  270. package/dist/core/components.js +294 -0
  271. package/dist/core/contentMode.d.ts +27 -0
  272. package/dist/core/contentMode.js +0 -0
  273. package/dist/core/dropTarget.d.ts +11 -0
  274. package/dist/core/dropTarget.js +24 -1
  275. package/dist/core/fields.d.ts +5 -0
  276. package/dist/core/fields.js +11 -0
  277. package/dist/core/headings.d.ts +5 -2
  278. package/dist/core/headings.js +14 -6
  279. package/dist/core/index.d.ts +8 -3
  280. package/dist/core/index.js +8 -3
  281. package/dist/core/layers.d.ts +9 -0
  282. package/dist/core/layers.js +29 -0
  283. package/dist/core/operations.d.ts +6 -0
  284. package/dist/core/operations.js +85 -24
  285. package/dist/core/payloadBlocks.js +5 -1
  286. package/dist/core/references.js +28 -0
  287. package/dist/core/schema.js +20 -6
  288. package/dist/core/sectionOrigin.d.ts +6 -0
  289. package/dist/core/sectionOrigin.js +21 -0
  290. package/dist/core/sections.d.ts +72 -0
  291. package/dist/core/sections.js +331 -0
  292. package/dist/core/templateChoice.d.ts +24 -0
  293. package/dist/core/templateChoice.js +43 -0
  294. package/dist/core/tree.js +18 -6
  295. package/dist/core/types.d.ts +148 -18
  296. package/dist/core/validate.d.ts +4 -1
  297. package/dist/core/validate.js +28 -11
  298. package/dist/core/visibility.d.ts +63 -0
  299. package/dist/core/visibility.js +214 -0
  300. package/dist/core/whereValues.d.ts +22 -0
  301. package/dist/core/whereValues.js +43 -0
  302. package/dist/css/classes.d.ts +16 -0
  303. package/dist/css/classes.js +172 -0
  304. package/dist/css/index.d.ts +32 -1
  305. package/dist/css/index.js +64 -5
  306. package/dist/css/tokens.d.ts +10 -0
  307. package/dist/css/tokens.js +23 -10
  308. package/dist/index.d.ts +5 -2
  309. package/dist/index.js +6 -1
  310. package/dist/live/contentMode.d.ts +24 -0
  311. package/dist/live/contentMode.js +39 -0
  312. package/dist/live/endpoints.js +3 -0
  313. package/dist/live/session.d.ts +5 -0
  314. package/dist/live/session.js +8 -0
  315. package/dist/live/types.d.ts +16 -1
  316. package/dist/mcp/index.d.ts +10 -1
  317. package/dist/mcp/index.js +146 -54
  318. package/dist/mcp/shared.d.ts +93 -3
  319. package/dist/mcp/shared.js +211 -15
  320. package/dist/plugin/hook.d.ts +7 -1
  321. package/dist/plugin/hook.js +30 -4
  322. package/dist/plugin/index.d.ts +19 -8
  323. package/dist/plugin/index.js +89 -20
  324. package/dist/plugin/links.d.ts +24 -0
  325. package/dist/plugin/links.js +27 -0
  326. package/dist/plugin/listCollections.d.ts +9 -7
  327. package/dist/plugin/listCollections.js +30 -21
  328. package/dist/plugin/sections.d.ts +14 -7
  329. package/dist/plugin/sections.js +69 -23
  330. package/dist/plugin/sectionsUsedIn.d.ts +6 -0
  331. package/dist/plugin/sectionsUsedIn.js +24 -0
  332. package/dist/plugin/templateEndpoint.d.ts +9 -0
  333. package/dist/plugin/templateEndpoint.js +49 -0
  334. package/dist/plugin/templates.js +23 -8
  335. package/dist/protocol/index.d.ts +16 -1
  336. package/dist/react/canvas/BuilderCanvas.js +144 -21
  337. package/dist/react/canvas/classes.d.ts +17 -0
  338. package/dist/react/canvas/classes.js +102 -0
  339. package/dist/react/canvas/controls.d.ts +31 -0
  340. package/dist/react/canvas/controls.js +75 -0
  341. package/dist/react/canvas/fetchDocs.d.ts +2 -2
  342. package/dist/react/canvas/fetchDocs.js +16 -8
  343. package/dist/react/canvas/measure.d.ts +9 -0
  344. package/dist/react/canvas/measure.js +106 -7
  345. package/dist/react/canvas/resolveLayout.d.ts +1 -1
  346. package/dist/react/canvas/resolveLayout.js +4 -3
  347. package/dist/react/canvas/thumbnail/ThumbnailCanvas.js +17 -4
  348. package/dist/react/classes/ClassesStyle.d.ts +27 -0
  349. package/dist/react/classes/ClassesStyle.js +27 -0
  350. package/dist/react/components/Button.d.ts +2 -11
  351. package/dist/react/components/Button.js +8 -43
  352. package/dist/react/components/CollectionList.d.ts +4 -1
  353. package/dist/react/components/CollectionList.js +10 -3
  354. package/dist/react/components/Container.d.ts +5 -2
  355. package/dist/react/components/Container.js +7 -4
  356. package/dist/react/components/Field.js +3 -14
  357. package/dist/react/components/Link.d.ts +1 -1
  358. package/dist/react/components/Link.js +5 -3
  359. package/dist/react/components/List.d.ts +1 -1
  360. package/dist/react/components/List.js +2 -2
  361. package/dist/react/components/Menu.d.ts +10 -1
  362. package/dist/react/components/Menu.js +39 -12
  363. package/dist/react/components/RichText.d.ts +3 -4
  364. package/dist/react/components/RichText.js +5 -5
  365. package/dist/react/components/builtins/Accordion.d.ts +4 -3
  366. package/dist/react/components/builtins/Accordion.js +6 -5
  367. package/dist/react/components/builtins/AdjacentLinks.d.ts +11 -0
  368. package/dist/react/components/builtins/AdjacentLinks.js +20 -0
  369. package/dist/react/components/builtins/Carousel.d.ts +21 -10
  370. package/dist/react/components/builtins/Carousel.js +175 -100
  371. package/dist/react/components/builtins/Disclosure.d.ts +4 -3
  372. package/dist/react/components/builtins/Disclosure.js +6 -5
  373. package/dist/react/components/builtins/Embed.d.ts +11 -0
  374. package/dist/react/components/builtins/Embed.js +23 -0
  375. package/dist/react/components/builtins/EmbedHtml.d.ts +15 -0
  376. package/dist/react/components/builtins/EmbedHtml.js +51 -0
  377. package/dist/react/components/builtins/EmbedPreview.d.ts +34 -0
  378. package/dist/react/components/builtins/EmbedPreview.js +105 -0
  379. package/dist/react/components/builtins/FilterLink.d.ts +1 -1
  380. package/dist/react/components/builtins/FilterLink.js +4 -4
  381. package/dist/react/components/builtins/Marquee.d.ts +8 -0
  382. package/dist/react/components/builtins/Marquee.js +15 -0
  383. package/dist/react/components/builtins/Popup.d.ts +26 -0
  384. package/dist/react/components/builtins/Popup.js +146 -0
  385. package/dist/react/components/builtins/SectionRef.d.ts +4 -3
  386. package/dist/react/components/builtins/SectionRef.js +9 -5
  387. package/dist/react/components/builtins/Tab.d.ts +7 -0
  388. package/dist/react/components/builtins/Tab.js +21 -0
  389. package/dist/react/components/builtins/TableOfContents.d.ts +17 -3
  390. package/dist/react/components/builtins/TableOfContents.js +22 -7
  391. package/dist/react/components/builtins/Tabs.d.ts +17 -0
  392. package/dist/react/components/builtins/Tabs.js +71 -0
  393. package/dist/react/components/builtins/index.d.ts +37 -20
  394. package/dist/react/components/builtins/index.js +54 -20
  395. package/dist/react/components/builtins/tabsContext.d.ts +12 -0
  396. package/dist/react/components/builtins/tabsContext.js +6 -0
  397. package/dist/react/components/index.js +11 -8
  398. package/dist/react/components/lazy.d.ts +32 -0
  399. package/dist/react/components/lazy.js +20 -0
  400. package/dist/react/components/lazyBlock.d.ts +17 -0
  401. package/dist/react/components/lazyBlock.js +23 -0
  402. package/dist/react/index.d.ts +6 -3
  403. package/dist/react/index.js +5 -2
  404. package/dist/react/render/RenderLayout.d.ts +9 -7
  405. package/dist/react/render/RenderLayout.js +96 -45
  406. package/dist/react/render/canvasMode.d.ts +13 -0
  407. package/dist/react/render/canvasMode.js +13 -0
  408. package/dist/react/render/canvasServer.js +4 -3
  409. package/dist/react/render/canvasServerTypes.d.ts +5 -0
  410. package/dist/react/render/lists.d.ts +36 -4
  411. package/dist/react/render/lists.js +132 -15
  412. package/dist/react/render/marks.d.ts +15 -0
  413. package/dist/react/render/marks.js +23 -0
  414. package/dist/react/render/payload.d.ts +8 -1
  415. package/dist/react/render/payload.js +12 -3
  416. package/dist/react/render/preview.d.ts +11 -0
  417. package/dist/react/render/preview.js +13 -0
  418. package/dist/react/render/relations.d.ts +10 -0
  419. package/dist/react/render/relations.js +39 -0
  420. package/dist/react/render/resolve.d.ts +8 -4
  421. package/dist/react/render/resolve.js +11 -5
  422. package/dist/react/render/reveal.d.ts +17 -0
  423. package/dist/react/render/reveal.js +39 -0
  424. package/dist/react/render/sections.d.ts +11 -5
  425. package/dist/react/render/sections.js +52 -24
  426. package/dist/react/render/templates.d.ts +47 -0
  427. package/dist/react/render/templates.js +139 -0
  428. package/dist/react/render/types.d.ts +62 -5
  429. package/dist/react/server.d.ts +2 -37
  430. package/dist/react/server.js +8 -133
  431. package/dist/react/theme/ThemeLiveLoader.d.ts +4 -0
  432. package/dist/react/theme/ThemeLiveLoader.js +5 -0
  433. package/dist/react/theme/ThemeStyle.js +1 -1
  434. package/dist/theme/admin/Variables.d.ts +11 -0
  435. package/dist/theme/admin/Variables.js +115 -0
  436. package/dist/theme/admin/fields.scss +113 -0
  437. package/dist/theme/client.d.ts +1 -0
  438. package/dist/theme/client.js +2 -0
  439. package/dist/theme/css.d.ts +6 -1
  440. package/dist/theme/css.js +12 -4
  441. package/dist/theme/global.js +83 -0
  442. package/dist/theme/index.d.ts +1 -0
  443. package/dist/theme/index.js +1 -0
  444. package/dist/theme/server.d.ts +15 -0
  445. package/dist/theme/server.js +43 -0
  446. package/dist/theme/usage.d.ts +23 -0
  447. package/dist/theme/usage.js +68 -0
  448. package/dist/theme/variables.d.ts +72 -0
  449. package/dist/theme/variables.js +231 -0
  450. package/package.json +4 -2
  451. package/dist/admin/editor/styles/SiteClasses.d.ts +0 -9
  452. package/dist/admin/editor/styles/SiteClasses.js +0 -31
  453. package/dist/blocks/builtins/headingId.d.ts +0 -15
  454. package/dist/blocks/builtins/headingId.js +0 -36
  455. package/dist/blocks/builtins/lightbox.d.ts +0 -43
  456. package/dist/blocks/builtins/lightbox.js +0 -93
  457. package/dist/blocks/builtins/mediaBackdrop.d.ts +0 -11
  458. package/dist/blocks/builtins/mediaBackdrop.js +0 -79
  459. package/dist/react/components/Quote.d.ts +0 -3
  460. package/dist/react/components/Quote.js +0 -12
  461. package/dist/react/components/Spacer.d.ts +0 -3
  462. package/dist/react/components/Spacer.js +0 -6
  463. package/dist/react/components/builtins/BackdropVideo.d.ts +0 -13
  464. package/dist/react/components/builtins/BackdropVideo.js +0 -16
  465. package/dist/react/components/builtins/Lightbox.d.ts +0 -45
  466. package/dist/react/components/builtins/Lightbox.js +0 -252
  467. package/dist/react/components/builtins/MediaBackdrop.d.ts +0 -14
  468. package/dist/react/components/builtins/MediaBackdrop.js +0 -61
@@ -0,0 +1,99 @@
1
+ import { type VisibilityOperator } from '../../../core/visibility.js';
2
+ import { type RelativeDate } from '../../../core/whereValues.js';
3
+ /** The operators of every condition row: Payload's where operators, with `exists` as "is set" / "is empty". */
4
+ export type ConditionOperator = VisibilityOperator;
5
+ /** A field the rows can test. `count`: the option tests the number of items of the field. */
6
+ export type ConditionFieldOption = {
7
+ path: string;
8
+ label: string;
9
+ /** Payload field type. Unknown (a path typed by hand): every operator and a text value. */
10
+ type?: string;
11
+ count?: boolean;
12
+ hasMany?: boolean;
13
+ relationTo?: string | string[];
14
+ /** Select and radio options. */
15
+ options?: ReadonlyArray<{
16
+ label: string;
17
+ value: string;
18
+ }>;
19
+ };
20
+ /** One row while it is edited: `text` keeps what the user typed ("a, " while typing a list). */
21
+ export type ConditionRow = {
22
+ field: string;
23
+ operator: string;
24
+ value: unknown;
25
+ text: string;
26
+ /** The row compares the number of items of the field (visibility conditions only). */
27
+ count?: boolean;
28
+ /** The row compares with this field instead of `value` (visibility conditions only). */
29
+ valueField?: string;
30
+ };
31
+ /**
32
+ * Where a row's value comes from: a fixed value, a date relative to now (`$now-30d`), a field of
33
+ * the page's document (`$page.<path>`), a URL query value (`$query.<param>`), or another field
34
+ * of the same document (`valueField`).
35
+ */
36
+ export type ValueSource = 'fixed' | 'date' | 'page' | 'query' | 'field';
37
+ /** The value sources a caller offers besides a fixed value. */
38
+ export type ConditionSources = {
39
+ /** Dates relative to now, for date fields. */
40
+ date?: boolean;
41
+ /** URL query values. */
42
+ query?: boolean;
43
+ /** Fields of the page's document (paths without `$page.`). */
44
+ page?: ConditionFieldOption[];
45
+ /** Other fields of the same document (visibility conditions). */
46
+ field?: ConditionFieldOption[];
47
+ };
48
+ export declare const SOURCE_LABELS: Record<ValueSource, string>;
49
+ /** The operators a field offers, in the order the select shows them. */
50
+ export declare function operatorsFor(field: ConditionFieldOption | undefined): ConditionOperator[];
51
+ /** The plain-language label of an operator for a field: "is", "is after", "has at least", "includes". */
52
+ export declare function operatorLabel(operator: string, field: ConditionFieldOption | undefined): string;
53
+ /** The operator select's options for a row: the field's operators, plus the row's own when it is not one of them. */
54
+ export declare function operatorOptions(field: ConditionFieldOption | undefined, current: string): Array<{
55
+ value: string;
56
+ label: string;
57
+ }>;
58
+ /** The fixed value input of a row. `multiple`: the operator takes a list (`in`, `not_in`). */
59
+ export type ValueInput = {
60
+ kind: 'none' | 'checkbox' | 'number' | 'date' | 'options' | 'documents' | 'text';
61
+ multiple: boolean;
62
+ };
63
+ /** The fixed value input of a row, from the field's Payload type and the operator. */
64
+ export declare function valueInputOf(field: ConditionFieldOption | undefined, operator: string): ValueInput;
65
+ /**
66
+ * The candidates a row's value can come from: fields of the same kind (any when a type is
67
+ * unknown), each path once. `exceptSelf`: leave out the row's own field (another field of the
68
+ * same document).
69
+ */
70
+ export declare function compatibleFields(field: ConditionFieldOption | undefined, candidates: readonly ConditionFieldOption[], exceptSelf?: boolean): ConditionFieldOption[];
71
+ /** The value sources a row offers: a fixed value first, then the caller's sources that fit the field. */
72
+ export declare function rowSources(field: ConditionFieldOption | undefined, operator: string, sources?: ConditionSources): ValueSource[];
73
+ /** Where the row's value comes from. A token the caller does not offer counts as a fixed value. */
74
+ export declare function rowSource(row: Pick<ConditionRow, 'value' | 'valueField'>, sources?: ConditionSources): ValueSource;
75
+ /** The row with its value taken from another source, with a starting value for that source. */
76
+ export declare function withSource(row: ConditionRow, source: ValueSource, field: ConditionFieldOption | undefined, sources?: ConditionSources): ConditionRow;
77
+ /** The row after the user picks another field: an operator the field offers, and a value that fits it. */
78
+ export declare function withField(row: ConditionRow, picked: ConditionFieldOption | undefined, path: string): ConditionRow;
79
+ /** The row after the user picks another operator. A value from another source stays when it still fits. */
80
+ export declare function withOperator(row: ConditionRow, operator: string, field: ConditionFieldOption | undefined, sources?: ConditionSources): ConditionRow;
81
+ /** The relative date choices: "now", or days or hours ago or from now. */
82
+ export declare const RELATIVE_DATE_OPTIONS: {
83
+ value: string;
84
+ label: string;
85
+ }[];
86
+ /** The relative date select's value of a date: "now", "d-", "d+", "h-" or "h+". */
87
+ export declare const relativeDateKey: (date: RelativeDate) => string;
88
+ /** The date token after a change of the amount or the choice. Picking days or hours from "now" starts at 7. */
89
+ export declare function changeRelativeDate(date: RelativeDate, change: {
90
+ amount?: number;
91
+ key?: string;
92
+ }): string;
93
+ /** A relative date in words: "now", "30 days ago", "1 hour from now". */
94
+ export declare function relativeDateText(date: RelativeDate): string;
95
+ /**
96
+ * The conditions in one line: "Price is greater than 100 and Tags is any of new, sale, or
97
+ * Featured is checked". Rows without a field are left out. Empty for none.
98
+ */
99
+ export declare function conditionSummary(groups: readonly ConditionRow[][], fields: readonly ConditionFieldOption[], sources?: ConditionSources): string;
@@ -0,0 +1,339 @@
1
+ // The condition rows' rules, shared by the where builder (WhereField) and the visibility
2
+ // conditions: which operators a field type offers and their plain-language labels, which value
3
+ // input a row shows, where a row's value comes from, and a one-line summary. Pure, so it is
4
+ // tested without React. ConditionRows.tsx draws the rows.
5
+ import { LIST_OPERATORS, VALUELESS_OPERATORS, VISIBILITY_OPERATORS, } from '../../../core/visibility.js';
6
+ import { dateToken, pageToken, pageTokenPath, parseDateToken, queryToken, queryTokenParam } from '../../../core/whereValues.js';
7
+ import { parseWhereValue, whereValueText } from './whereRows.js';
8
+ export const SOURCE_LABELS = {
9
+ fixed: 'Value',
10
+ date: 'Relative date',
11
+ page: 'Page field',
12
+ query: 'URL parameter',
13
+ field: 'Other field',
14
+ };
15
+ const TEXT_TYPES = new Set(['text', 'textarea', 'email', 'code', 'richText', 'json']);
16
+ const CHOICE_TYPES = new Set(['select', 'radio']);
17
+ const DOCUMENT_TYPES = new Set(['relationship', 'upload']);
18
+ const TEXT_OPERATORS = ['equals', 'not_equals', 'contains', 'like', 'in', 'not_in', 'is_set', 'is_empty'];
19
+ const NUMBER_OPERATORS = [
20
+ 'equals',
21
+ 'not_equals',
22
+ 'greater_than',
23
+ 'greater_than_equal',
24
+ 'less_than',
25
+ 'less_than_equal',
26
+ 'in',
27
+ 'not_in',
28
+ 'is_set',
29
+ 'is_empty',
30
+ ];
31
+ const DATE_OPERATORS = ['greater_than', 'greater_than_equal', 'less_than', 'less_than_equal', 'is_set', 'is_empty'];
32
+ const CHOICE_OPERATORS = ['equals', 'not_equals', 'in', 'not_in', 'is_set', 'is_empty'];
33
+ const COUNT_OPERATORS = ['greater_than_equal', 'greater_than', 'less_than', 'less_than_equal', 'equals', 'is_set', 'is_empty'];
34
+ const ALL_OPERATORS = [
35
+ 'equals',
36
+ 'not_equals',
37
+ 'contains',
38
+ 'like',
39
+ 'in',
40
+ 'not_in',
41
+ 'greater_than',
42
+ 'greater_than_equal',
43
+ 'less_than',
44
+ 'less_than_equal',
45
+ 'is_set',
46
+ 'is_empty',
47
+ ];
48
+ const isOperator = (value) => VISIBILITY_OPERATORS.includes(value);
49
+ /** The operators a field offers, in the order the select shows them. */
50
+ export function operatorsFor(field) {
51
+ if (!field?.type)
52
+ return field?.count ? COUNT_OPERATORS : ALL_OPERATORS;
53
+ if (field.count)
54
+ return COUNT_OPERATORS;
55
+ if (field.type === 'checkbox')
56
+ return ['equals'];
57
+ if (field.type === 'number')
58
+ return NUMBER_OPERATORS;
59
+ if (field.type === 'date')
60
+ return DATE_OPERATORS;
61
+ if (CHOICE_TYPES.has(field.type) || DOCUMENT_TYPES.has(field.type))
62
+ return CHOICE_OPERATORS;
63
+ if (TEXT_TYPES.has(field.type))
64
+ return TEXT_OPERATORS;
65
+ return ALL_OPERATORS;
66
+ }
67
+ const LABELS = {
68
+ is_set: 'is set',
69
+ is_empty: 'is empty',
70
+ equals: 'is',
71
+ not_equals: 'is not',
72
+ in: 'is any of',
73
+ not_in: 'is none of',
74
+ greater_than: 'is greater than',
75
+ greater_than_equal: 'is at least',
76
+ less_than: 'is less than',
77
+ less_than_equal: 'is at most',
78
+ like: 'has all the words',
79
+ contains: 'contains',
80
+ };
81
+ const DATE_LABELS = {
82
+ greater_than: 'is after',
83
+ greater_than_equal: 'is on or after',
84
+ less_than: 'is before',
85
+ less_than_equal: 'is on or before',
86
+ };
87
+ const COUNT_LABELS = {
88
+ is_set: 'has items',
89
+ is_empty: 'has no items',
90
+ equals: 'has exactly',
91
+ not_equals: 'does not have exactly',
92
+ greater_than: 'has more than',
93
+ greater_than_equal: 'has at least',
94
+ less_than: 'has fewer than',
95
+ less_than_equal: 'has at most',
96
+ };
97
+ /** A field with many values (hasMany) includes a value rather than being it. */
98
+ const MANY_LABELS = {
99
+ equals: 'includes',
100
+ not_equals: 'does not include',
101
+ in: 'includes any of',
102
+ not_in: 'includes none of',
103
+ };
104
+ /** The plain-language label of an operator for a field: "is", "is after", "has at least", "includes". */
105
+ export function operatorLabel(operator, field) {
106
+ if (!isOperator(operator))
107
+ return operator;
108
+ if (field?.count)
109
+ return COUNT_LABELS[operator] ?? LABELS[operator];
110
+ if (field?.type === 'date')
111
+ return DATE_LABELS[operator] ?? LABELS[operator];
112
+ if (field?.hasMany)
113
+ return MANY_LABELS[operator] ?? LABELS[operator];
114
+ return LABELS[operator];
115
+ }
116
+ /** The operator select's options for a row: the field's operators, plus the row's own when it is not one of them. */
117
+ export function operatorOptions(field, current) {
118
+ const list = operatorsFor(field);
119
+ const all = current && !list.includes(current) ? [current, ...list] : list;
120
+ return all.map((value) => ({ value, label: operatorLabel(value, field) }));
121
+ }
122
+ /** The fixed value input of a row, from the field's Payload type and the operator. */
123
+ export function valueInputOf(field, operator) {
124
+ if (VALUELESS_OPERATORS.has(operator))
125
+ return { kind: 'none', multiple: false };
126
+ const multiple = LIST_OPERATORS.has(operator);
127
+ if (field?.count)
128
+ return { kind: multiple ? 'text' : 'number', multiple };
129
+ switch (field?.type) {
130
+ case 'checkbox':
131
+ return { kind: 'checkbox', multiple: false };
132
+ case 'number':
133
+ return { kind: multiple ? 'text' : 'number', multiple };
134
+ case 'date':
135
+ return { kind: multiple ? 'text' : 'date', multiple };
136
+ case 'select':
137
+ case 'radio':
138
+ return { kind: field.options?.length ? 'options' : 'text', multiple };
139
+ case 'relationship':
140
+ case 'upload':
141
+ // A polymorphic field's values name their collection: typed as ids.
142
+ return { kind: typeof field.relationTo === 'string' ? 'documents' : 'text', multiple };
143
+ default:
144
+ return { kind: 'text', multiple };
145
+ }
146
+ }
147
+ /** The group a field type compares with: a value of one kind fits a field of the same kind. */
148
+ function kindOf(field) {
149
+ if (field.count)
150
+ return 'number';
151
+ if (!field.type)
152
+ return null;
153
+ if (TEXT_TYPES.has(field.type) || CHOICE_TYPES.has(field.type))
154
+ return 'text';
155
+ if (DOCUMENT_TYPES.has(field.type))
156
+ return `documents:${JSON.stringify(field.relationTo ?? null)}`;
157
+ return field.type;
158
+ }
159
+ /**
160
+ * The candidates a row's value can come from: fields of the same kind (any when a type is
161
+ * unknown), each path once. `exceptSelf`: leave out the row's own field (another field of the
162
+ * same document).
163
+ */
164
+ export function compatibleFields(field, candidates, exceptSelf = false) {
165
+ const kind = field ? kindOf(field) : null;
166
+ const seen = new Set();
167
+ return candidates.filter((candidate) => {
168
+ const key = `${candidate.count ? '#' : ''}${candidate.path}`;
169
+ if (seen.has(key))
170
+ return false;
171
+ seen.add(key);
172
+ if (exceptSelf && field && candidate.path === field.path && Boolean(candidate.count) === Boolean(field.count))
173
+ return false;
174
+ const other = kindOf(candidate);
175
+ return kind === null || other === null || other === kind;
176
+ });
177
+ }
178
+ /** The value sources a row offers: a fixed value first, then the caller's sources that fit the field. */
179
+ export function rowSources(field, operator, sources = {}) {
180
+ if (VALUELESS_OPERATORS.has(operator))
181
+ return [];
182
+ const out = ['fixed'];
183
+ if (sources.date && field?.type === 'date' && !field.count && !LIST_OPERATORS.has(operator))
184
+ out.push('date');
185
+ if (sources.page && compatibleFields(field, sources.page).length > 0)
186
+ out.push('page');
187
+ if (sources.query)
188
+ out.push('query');
189
+ if (sources.field && compatibleFields(field, sources.field, true).length > 0)
190
+ out.push('field');
191
+ return out;
192
+ }
193
+ /** Where the row's value comes from. A token the caller does not offer counts as a fixed value. */
194
+ export function rowSource(row, sources = {}) {
195
+ if (row.valueField !== undefined && sources.field)
196
+ return 'field';
197
+ if (sources.date && parseDateToken(row.value))
198
+ return 'date';
199
+ if (sources.page && pageTokenPath(row.value) !== null)
200
+ return 'page';
201
+ if (sources.query && queryTokenParam(row.value) !== null)
202
+ return 'query';
203
+ return 'fixed';
204
+ }
205
+ /** The last segment of a path, as a URL parameter name: `category.slug` -> `slug`. */
206
+ const paramOf = (path) => (path.split('.').filter((part) => !part.startsWith('$')).at(-1) ?? '').replace(/[^\w-]/g, '');
207
+ /** The row with its value taken from another source, with a starting value for that source. */
208
+ export function withSource(row, source, field, sources = {}) {
209
+ const { valueField: _valueField, ...rest } = row;
210
+ switch (source) {
211
+ case 'date':
212
+ return { ...rest, value: '$now-7d', text: '' };
213
+ case 'page': {
214
+ const first = compatibleFields(field, sources.page ?? [])[0];
215
+ return { ...rest, value: pageToken(first?.path ?? ''), text: '' };
216
+ }
217
+ case 'query':
218
+ return { ...rest, value: queryToken(paramOf(row.field)), text: '' };
219
+ case 'field': {
220
+ const first = compatibleFields(field, sources.field ?? [], true)[0];
221
+ return { ...rest, value: undefined, text: '', valueField: first?.path ?? '' };
222
+ }
223
+ default: {
224
+ const value = LIST_OPERATORS.has(row.operator) ? [] : field?.type === 'checkbox' ? true : '';
225
+ return { ...rest, value, text: '' };
226
+ }
227
+ }
228
+ }
229
+ /** The fixed value a row keeps for a new operator, re-read from its value for that operator. */
230
+ function convertValue(row, operator, field) {
231
+ if (VALUELESS_OPERATORS.has(operator))
232
+ return undefined;
233
+ const type = field?.count ? 'number' : field?.type;
234
+ if (type === 'checkbox')
235
+ return row.value !== false;
236
+ // Ids of documents are not text: keep them, as a list or as the first one.
237
+ if (type === 'relationship' || type === 'upload') {
238
+ const list = Array.isArray(row.value) ? row.value : row.value === undefined || row.value === '' ? [] : [row.value];
239
+ return LIST_OPERATORS.has(operator) ? list : (list[0] ?? '');
240
+ }
241
+ return parseWhereValue(whereValueText(row.value), operator, type);
242
+ }
243
+ /** The row after the user picks another field: an operator the field offers, and a value that fits it. */
244
+ export function withField(row, picked, path) {
245
+ const next = { ...row, field: picked?.path ?? path, count: picked?.count === true };
246
+ if (!next.count)
247
+ delete next.count;
248
+ const operators = operatorsFor(picked);
249
+ const operator = operators.includes(row.operator) ? row.operator : operators[0];
250
+ if (row.valueField !== undefined || pageTokenPath(row.value) !== null || queryTokenParam(row.value) !== null || parseDateToken(row.value)) {
251
+ // A value from another source may not fit the new field: start again with a fixed value.
252
+ return withSource({ ...next, operator }, 'fixed', picked);
253
+ }
254
+ const value = convertValue(next, operator, picked);
255
+ return { ...next, operator, value, text: whereValueText(value) };
256
+ }
257
+ /** The row after the user picks another operator. A value from another source stays when it still fits. */
258
+ export function withOperator(row, operator, field, sources = {}) {
259
+ const source = rowSource(row, sources);
260
+ if (VALUELESS_OPERATORS.has(operator)) {
261
+ const { valueField: _valueField, ...rest } = row;
262
+ return { ...rest, operator, value: undefined, text: '' };
263
+ }
264
+ if (source !== 'fixed') {
265
+ const next = { ...row, operator };
266
+ return rowSources(field, operator, sources).includes(source) ? next : withSource(next, 'fixed', field, sources);
267
+ }
268
+ const value = convertValue(row, operator, field);
269
+ return { ...row, operator, value, text: whereValueText(value) };
270
+ }
271
+ /** The relative date choices: "now", or days or hours ago or from now. */
272
+ export const RELATIVE_DATE_OPTIONS = [
273
+ { value: 'now', label: 'now' },
274
+ { value: 'd-', label: 'days ago' },
275
+ { value: 'd+', label: 'days from now' },
276
+ { value: 'h-', label: 'hours ago' },
277
+ { value: 'h+', label: 'hours from now' },
278
+ ];
279
+ /** The relative date select's value of a date: "now", "d-", "d+", "h-" or "h+". */
280
+ export const relativeDateKey = (date) => (date.amount === 0 ? 'now' : `${date.unit}${date.direction < 0 ? '-' : '+'}`);
281
+ /** The date token after a change of the amount or the choice. Picking days or hours from "now" starts at 7. */
282
+ export function changeRelativeDate(date, change) {
283
+ if (change.key === 'now')
284
+ return dateToken({ ...date, amount: 0 });
285
+ if (change.key) {
286
+ const unit = change.key[0] === 'h' ? 'h' : 'd';
287
+ return dateToken({ amount: date.amount || 7, unit, direction: change.key[1] === '-' ? -1 : 1 });
288
+ }
289
+ return dateToken({ ...date, amount: change.amount ?? date.amount });
290
+ }
291
+ /** A relative date in words: "now", "30 days ago", "1 hour from now". */
292
+ export function relativeDateText(date) {
293
+ if (date.amount === 0)
294
+ return 'now';
295
+ const unit = date.unit === 'h' ? 'hour' : 'day';
296
+ return `${date.amount} ${unit}${date.amount === 1 ? '' : 's'} ${date.direction < 0 ? 'ago' : 'from now'}`;
297
+ }
298
+ /** A row's value in words, for the summary. */
299
+ function valueText(row, field, fields, sources) {
300
+ const source = rowSource(row, sources);
301
+ const labelOf = (path, list) => list.find((f) => f.path === path && !f.count)?.label ?? path;
302
+ if (source === 'field')
303
+ return labelOf(row.valueField ?? '', sources.field ?? fields);
304
+ if (source === 'page')
305
+ return `the page's ${labelOf(pageTokenPath(row.value) ?? '', sources.page ?? [])}`;
306
+ if (source === 'query')
307
+ return `?${queryTokenParam(row.value) ?? ''}`;
308
+ const date = parseDateToken(row.value);
309
+ if (source === 'date' && date)
310
+ return relativeDateText(date);
311
+ if (typeof row.value === 'boolean')
312
+ return field?.type === 'checkbox' ? (row.value ? 'checked' : 'not checked') : String(row.value);
313
+ const values = Array.isArray(row.value) ? row.value : [row.value];
314
+ if (field?.type === 'relationship' || field?.type === 'upload')
315
+ return values.length === 1 ? 'a chosen document' : `${values.length} chosen documents`;
316
+ const optionLabel = (value) => field?.options?.find((o) => o.value === value)?.label ?? String(value ?? '');
317
+ return values.map(optionLabel).join(', ');
318
+ }
319
+ /**
320
+ * The conditions in one line: "Price is greater than 100 and Tags is any of new, sale, or
321
+ * Featured is checked". Rows without a field are left out. Empty for none.
322
+ */
323
+ export function conditionSummary(groups, fields, sources = {}) {
324
+ const parts = groups
325
+ .map((group) => group
326
+ .filter((row) => row.field.trim())
327
+ .map((row) => {
328
+ const field = fields.find((f) => f.path === row.field && Boolean(f.count) === Boolean(row.count));
329
+ const name = field?.label ?? row.field;
330
+ const operator = operatorLabel(row.operator, field ?? (row.count ? { path: row.field, label: name, count: true } : undefined));
331
+ if (VALUELESS_OPERATORS.has(row.operator))
332
+ return `${name} ${operator}`;
333
+ const value = valueText(row, field, fields, sources);
334
+ return `${name} ${operator} ${value}${row.count ? ' items' : ''}`;
335
+ })
336
+ .join(' and '))
337
+ .filter(Boolean);
338
+ return parts.join(', or ');
339
+ }