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,56 @@
1
+ 'use client';
2
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ // The class manager: every shared class in one list, with search, where each one is used (links
4
+ // to the pages), Rename, Duplicate and Delete, and "Remove unused classes". A Payload drawer opened
5
+ // from the Classes menu of the Styles panel ("Manage classes…"). Rename, Delete and Remove unused
6
+ // open the class dialogs (ClassDialog.tsx); the server changes every layout through its live session.
7
+ import { Drawer, useConfig, useModal } from '@payloadcms/ui';
8
+ import { useEffect, useMemo, useState } from 'react';
9
+ import { plural } from '../../../classes/shared.js';
10
+ import { filterClasses, usageOf } from './managerModel.js';
11
+ import { builderViewPath } from '../../../plugin/links.js';
12
+ import { Icon } from '../icons.js';
13
+ import { useRuntime } from '../runtime.js';
14
+ import { useValue } from '../valueStore.js';
15
+ import './manager.scss';
16
+ export const CLASS_MANAGER_SLUG = 'builder-class-manager';
17
+ /** Mounted with the Styles panel. Renders the drawer; `openModal(CLASS_MANAGER_SLUG)` opens it. */
18
+ export function ClassManager() {
19
+ const runtime = useRuntime();
20
+ const classes = runtime.classes;
21
+ const list = useValue(classes.list);
22
+ const usage = useValue(classes.usage);
23
+ const { isModalOpen } = useModal();
24
+ const open = isModalOpen(CLASS_MANAGER_SLUG);
25
+ const [query, setQuery] = useState('');
26
+ const [expanded, setExpanded] = useState(null);
27
+ // Fresh counts each time the drawer opens.
28
+ useEffect(() => {
29
+ if (open)
30
+ void classes.loadUsage();
31
+ }, [open, classes]);
32
+ const shown = useMemo(() => filterClasses(list, query), [list, query]);
33
+ const unused = usage ? list.filter((c) => usageOf(c, usage)?.blocks === 0) : [];
34
+ const removeUnused = () => classes.dialog.set({ kind: 'remove-unused', names: unused.map((c) => c.name) });
35
+ return (_jsx(Drawer, { slug: CLASS_MANAGER_SLUG, title: "Classes", className: "builder-class-manager", children: open && (_jsxs("div", { className: "builder-class-manager__body", children: [_jsxs("div", { className: "builder-class-manager__toolbar", children: [_jsxs("label", { className: "builder-class-manager__search", children: [_jsx(Icon, { name: "search", size: 14 }), _jsx("input", { type: "search", value: query, placeholder: "Search classes", "aria-label": "Search classes",
36
+ // oxlint-disable-next-line jsx-a11y/no-autofocus -- the drawer opens for this
37
+ autoFocus: true, onChange: (e) => setQuery(e.target.value) })] }), _jsx("button", { type: "button", className: "builder-class-manager__button", disabled: unused.length === 0, onClick: removeUnused, children: unused.length > 0 ? `Remove ${plural(unused.length, 'unused class', 'unused classes')}` : 'No unused classes' })] }), _jsxs("p", { className: "builder-class-manager__summary", children: [plural(list.length, 'class', 'classes'), usage ? (unused.length > 0 ? ` · ${unused.length} unused` : '') : ' · counting where they are used…'] }), list.length === 0 ? (_jsx("p", { className: "builder-class-manager__empty", children: "No shared classes yet. Select a block, then choose \u201CNew class from these styles\u201D in the Classes menu." })) : shown.length === 0 ? (_jsxs("p", { className: "builder-class-manager__empty", children: ["No class matches \u201C", query.trim(), "\u201D."] })) : (_jsx("ul", { className: "builder-class-manager__list", children: shown.map((item) => (_jsx(ClassRow, { item: item, usage: usageOf(item, usage), expanded: expanded === String(item.id), onToggle: () => setExpanded(expanded === String(item.id) ? null : String(item.id)) }, item.id))) }))] })) }));
38
+ }
39
+ function ClassRow({ item, usage, expanded, onToggle }) {
40
+ const runtime = useRuntime();
41
+ const classes = runtime.classes;
42
+ const { config: { collections, routes: { admin }, }, } = useConfig();
43
+ const collectionLabel = (slug) => {
44
+ const label = collections.find((c) => c.slug === slug)?.labels?.singular;
45
+ return typeof label === 'string' ? label : slug;
46
+ };
47
+ const used = usage ? usage.blocks > 0 : false;
48
+ const detailsId = `builder-class-${String(item.id)}-used`;
49
+ const duplicate = () => void classes.duplicate(item.id).then((result) => {
50
+ if (typeof result === 'string')
51
+ runtime.warn(`.${item.name} was not duplicated: ${result}`);
52
+ else
53
+ runtime.notify(`Created .${result.name}, a copy of .${item.name}.`);
54
+ });
55
+ return (_jsxs("li", { className: "builder-class-manager__row", "data-expanded": expanded ? '' : undefined, children: [_jsxs("div", { className: "builder-class-manager__line", children: [_jsxs("button", { type: "button", className: "builder-class-manager__main", "aria-expanded": expanded, "aria-controls": detailsId, disabled: !used, onClick: onToggle, children: [_jsxs("span", { className: "builder-class-manager__name", children: [".", item.name] }), item.label ? _jsx("span", { className: "builder-class-manager__label", children: item.label }) : null, _jsx("span", { className: "builder-class-manager__usage", "data-unused": usage && !used ? '' : undefined, children: usage ? (used ? `${plural(usage.blocks, 'block')} · ${plural(usage.documents.length, 'page')}` : 'Unused') : '…' }), item.status === 'draft' ? _jsx("span", { className: "builder-class-manager__badge", children: "Draft" }) : null] }), _jsxs("span", { className: "builder-class-manager__actions", children: [_jsx("button", { type: "button", "aria-label": `Rename .${item.name}`, "data-tooltip": "Rename", onClick: () => classes.dialog.set({ kind: 'rename', id: item.id }), children: _jsx(Icon, { name: "rename", size: 14 }) }), _jsx("button", { type: "button", "aria-label": `Duplicate .${item.name}`, "data-tooltip": "Duplicate", onClick: duplicate, children: _jsx(Icon, { name: "duplicate", size: 14 }) }), _jsx("button", { type: "button", "aria-label": `Delete .${item.name}`, "data-tooltip": "Delete", "data-danger": "", onClick: () => classes.dialog.set({ kind: 'delete', id: item.id }), children: _jsx(Icon, { name: "delete", size: 14 }) })] })] }), expanded && usage && used ? (_jsx("ul", { id: detailsId, className: "builder-class-manager__docs", "aria-label": `Pages that use .${item.name}`, children: usage.documents.map((doc) => (_jsx("li", { children: _jsxs("a", { href: builderViewPath(admin, doc.collection, doc.id), target: "_blank", rel: "noreferrer", children: [_jsx("span", { className: "builder-class-manager__doc-title", children: doc.title }), _jsxs("span", { className: "builder-class-manager__doc-meta", children: [collectionLabel(doc.collection), " \u00B7 ", plural(doc.blocks, 'block')] }), _jsx(Icon, { name: "external", size: 12 })] }) }, `${doc.collection}:${doc.id}`))) })) : null] }));
56
+ }
@@ -0,0 +1,112 @@
1
+ import { type BuilderClass, type ClassesClientConfig, type ClassUsage } from '../../../classes/shared.js';
2
+ import type { EditorStore } from '../store.js';
3
+ /** A dialog of the classes. `new`: a class from a block's classes (the block's own utilities move into it). */
4
+ export type ClassDialog = ({
5
+ kind: 'new';
6
+ blockId: string;
7
+ part: string | null;
8
+ } | {
9
+ kind: 'rename';
10
+ id: string | number;
11
+ } | {
12
+ kind: 'delete';
13
+ id: string | number;
14
+ } | {
15
+ kind: 'remove-unused';
16
+ names: string[];
17
+ }) & {
18
+ /** Shown again after a refused name: the name typed and why it was refused. */
19
+ name?: string;
20
+ error?: string;
21
+ };
22
+ export type ClassField = 'styles' | 'css';
23
+ /** Saving state by class id: a save waits or runs, or the last one failed (with its message). */
24
+ export type SaveState = {
25
+ status: 'saving';
26
+ } | {
27
+ status: 'error';
28
+ error: string;
29
+ };
30
+ export type ClassesController = ReturnType<typeof createClassesController>;
31
+ /** Messages on `CLASSES_CHANNEL`. A canvas says `hello` when it starts; the editor answers with the list. */
32
+ export type ClassesMessage = {
33
+ type: 'classes';
34
+ classes: BuilderClass[];
35
+ } | {
36
+ type: 'hello';
37
+ };
38
+ export declare function createClassesController(config: ClassesClientConfig, api: string, store: EditorStore): {
39
+ config: ClassesClientConfig;
40
+ list: {
41
+ get: () => BuilderClass[];
42
+ set(next: BuilderClass[]): void;
43
+ subscribe(listener: () => void): () => void;
44
+ };
45
+ loaded: {
46
+ get: () => boolean;
47
+ set(next: boolean): void;
48
+ subscribe(listener: () => void): () => void;
49
+ };
50
+ usage: {
51
+ get: () => Record<string, ClassUsage> | null;
52
+ set(next: Record<string, ClassUsage> | null): void;
53
+ subscribe(listener: () => void): () => void;
54
+ };
55
+ target: {
56
+ get: () => string | number | null;
57
+ set(next: string | number | null): void;
58
+ subscribe(listener: () => void): () => void;
59
+ };
60
+ saving: {
61
+ get: () => ReadonlyMap<string, SaveState>;
62
+ set(next: ReadonlyMap<string, SaveState>): void;
63
+ subscribe(listener: () => void): () => void;
64
+ };
65
+ dialog: {
66
+ get: () => ClassDialog | null;
67
+ set(next: ClassDialog | null): void;
68
+ subscribe(listener: () => void): () => void;
69
+ };
70
+ load(): Promise<void>;
71
+ loadUsage(): Promise<void>;
72
+ byId: (id: string | number | null) => BuilderClass | undefined;
73
+ byName: (name: string) => BuilderClass | undefined;
74
+ /** Changes one field of a class (an undo step; steps with the same `mergeKey` merge). */
75
+ edit(id: string | number, field: ClassField, value: string | null, mergeKey?: string): void;
76
+ /** Creates a class (a draft). Returns it, or the reason it was refused. */
77
+ create(data: {
78
+ name: string;
79
+ label?: string | null;
80
+ group?: string | null;
81
+ styles?: string | null;
82
+ css?: string | null;
83
+ }): Promise<BuilderClass | string>;
84
+ /** Saves the waiting edits and publishes the class: the live site changes on every page that uses it. */
85
+ publish(id: string | number): Promise<true | string>;
86
+ /** Renames the class and every block that uses it (their drafts). */
87
+ rename(id: string | number, name: string): Promise<{
88
+ documents: number;
89
+ blocks: number;
90
+ failed: number;
91
+ } | string>;
92
+ /** Removes the class from every block that uses it, then deletes it. */
93
+ remove(id: string | number): Promise<{
94
+ documents: number;
95
+ blocks: number;
96
+ } | string>;
97
+ /** A copy of the class (a draft) under a free name: `card-copy`, `card-copy-2`, … */
98
+ duplicate(id: string | number): Promise<BuilderClass | string>;
99
+ /** Deletes every class no page uses. The server checks again (drafts, open sessions and published pages). */
100
+ removeUnused(): Promise<{
101
+ deleted: string[];
102
+ failed: number;
103
+ } | string>;
104
+ /** Creates classes from the site's code `@utility` classes. */
105
+ importSite(): Promise<{
106
+ created: number;
107
+ skipped: number;
108
+ } | string>;
109
+ /** Saves a failed edit again. */
110
+ retry: (id: string | number) => undefined;
111
+ dispose(): void;
112
+ };
@@ -0,0 +1,326 @@
1
+ 'use client';
2
+ // The editor's editable classes: the list (latest drafts with this editor's unsaved edits), where
3
+ // each class is used, the class the Styles panel edits, and the writes.
4
+ //
5
+ // - Style edits apply at once (the canvas compiles them in the browser), save as a draft 600 ms
6
+ // after the last change with Payload's REST API (`?draft=true&autosave=true`, so one autosave
7
+ // version holds a run of edits), and are undo steps of the editor (`store.recordExternal`).
8
+ // - Canvases in this browser get every change over a BroadcastChannel (`CLASSES_CHANNEL`). Other
9
+ // people's changes arrive when this window gets the focus again.
10
+ // - Publish, rename, delete and import are explicit actions.
11
+ import { CLASSES_CHANNEL, normalizeStyles, toBuilderClass, } from '../../../classes/shared.js';
12
+ import { createValueStore } from '../valueStore.js';
13
+ const SAVE_DELAY_MS = 600;
14
+ /** The first error message of a Payload REST error body, else the status. */
15
+ async function errorText(res) {
16
+ try {
17
+ const body = (await res.json());
18
+ if (typeof body.error === 'string' && body.error)
19
+ return body.error;
20
+ const first = body.errors?.[0];
21
+ const detail = first?.data?.errors?.[0]?.message;
22
+ if (detail)
23
+ return detail;
24
+ if (first?.message)
25
+ return first.message;
26
+ }
27
+ catch {
28
+ // Not JSON.
29
+ }
30
+ return `${res.status} ${res.statusText}`.trim();
31
+ }
32
+ const request = (path, init) => fetch(path, { credentials: 'include', ...init, headers: { 'Content-Type': 'application/json', ...init?.headers } });
33
+ const sameId = (a, b) => String(a) === String(b);
34
+ export function createClassesController(config, api, store) {
35
+ const list = createValueStore([]);
36
+ const loaded = createValueStore(false);
37
+ const usage = createValueStore(null);
38
+ /** The class the Styles panel edits. Null: the block's own classes. */
39
+ const target = createValueStore(null);
40
+ const saving = createValueStore(new Map());
41
+ const dialog = createValueStore(null);
42
+ /** Fields changed here and not saved yet, by class id. */
43
+ const pending = new Map();
44
+ const timers = new Map();
45
+ // Browser only: Node has a BroadcastChannel too, and the editor also renders on the server.
46
+ const channel = typeof window === 'undefined' || typeof BroadcastChannel === 'undefined' ? null : new BroadcastChannel(CLASSES_CHANNEL);
47
+ const docPath = (id) => `${api}/${encodeURIComponent(config.collection)}/${encodeURIComponent(String(id))}`;
48
+ // oxlint-disable-next-line unicorn/require-post-message-target-origin -- a BroadcastChannel has no target origin
49
+ const broadcast = () => channel?.postMessage({ type: 'classes', classes: list.get() });
50
+ channel?.addEventListener('message', (event) => {
51
+ if (event.data?.type === 'hello')
52
+ broadcast();
53
+ });
54
+ const setSaving = (id, state) => {
55
+ const next = new Map(saving.get());
56
+ if (state)
57
+ next.set(String(id), state);
58
+ else
59
+ next.delete(String(id));
60
+ saving.set(next);
61
+ };
62
+ /** Replaces one class in the list (or adds it), keeping this editor's unsaved fields. */
63
+ const put = (item) => {
64
+ const local = pending.get(String(item.id));
65
+ const merged = local ? { ...item, ...local, status: 'draft' } : item;
66
+ const current = list.get();
67
+ const index = current.findIndex((c) => sameId(c.id, item.id));
68
+ const next = index === -1 ? [...current, merged] : current.map((c, i) => (i === index ? merged : c));
69
+ list.set(next.toSorted((a, b) => a.name.localeCompare(b.name)));
70
+ broadcast();
71
+ };
72
+ const drop = (id) => {
73
+ list.set(list.get().filter((c) => !sameId(c.id, id)));
74
+ if (target.get() !== null && sameId(target.get(), id))
75
+ target.set(null);
76
+ broadcast();
77
+ };
78
+ const save = async (id) => {
79
+ const key = String(id);
80
+ timers.delete(key);
81
+ const fields = pending.get(key);
82
+ if (!fields)
83
+ return;
84
+ pending.delete(key);
85
+ setSaving(id, { status: 'saving' });
86
+ try {
87
+ const res = await request(`${docPath(id)}?draft=true&autosave=true&depth=0`, { method: 'PATCH', body: JSON.stringify(fields) });
88
+ if (!res.ok)
89
+ throw new Error(await errorText(res));
90
+ setSaving(id, null);
91
+ const doc = toBuilderClass((await res.json()).doc ?? {});
92
+ if (doc)
93
+ put(doc);
94
+ }
95
+ catch (error) {
96
+ // Keep the fields for the next try, unless newer edits replaced them.
97
+ pending.set(key, { ...fields, ...pending.get(key) });
98
+ setSaving(id, { status: 'error', error: error instanceof Error ? error.message : String(error) });
99
+ }
100
+ };
101
+ const schedule = (id) => {
102
+ const key = String(id);
103
+ clearTimeout(timers.get(key));
104
+ timers.set(key, setTimeout(() => void save(id), SAVE_DELAY_MS));
105
+ setSaving(id, { status: 'saving' });
106
+ };
107
+ /** Sets a field in the editor at once and saves it later. No undo step (undo and redo use this). */
108
+ const setField = (id, field, value) => {
109
+ const item = list.get().find((c) => sameId(c.id, id));
110
+ if (!item)
111
+ return;
112
+ const next = field === 'styles' ? normalizeStyles(value) : value?.trim() ? value : null;
113
+ if ((item[field] ?? null) === next)
114
+ return;
115
+ pending.set(String(id), { ...pending.get(String(id)), [field]: next });
116
+ list.set(list.get().map((c) => (sameId(c.id, id) ? { ...c, [field]: next, status: 'draft' } : c)));
117
+ broadcast();
118
+ schedule(id);
119
+ };
120
+ /** Saves every waiting edit now (before publish, rename and delete). */
121
+ const flush = async (id) => {
122
+ clearTimeout(timers.get(String(id)));
123
+ await save(id);
124
+ };
125
+ const onFocus = () => {
126
+ void controller.load();
127
+ if (target.get() !== null)
128
+ void controller.loadUsage();
129
+ };
130
+ if (typeof window !== 'undefined')
131
+ window.addEventListener('focus', onFocus);
132
+ const controller = {
133
+ config,
134
+ list,
135
+ loaded,
136
+ usage,
137
+ target,
138
+ saving,
139
+ dialog,
140
+ async load() {
141
+ try {
142
+ const res = await request(config.endpoint);
143
+ if (!res.ok)
144
+ throw new Error(await errorText(res));
145
+ const body = (await res.json());
146
+ const fresh = (body.classes ?? []).map((item) => {
147
+ const local = pending.get(String(item.id));
148
+ return local ? { ...item, ...local, status: 'draft' } : item;
149
+ });
150
+ list.set(fresh);
151
+ loaded.set(true);
152
+ broadcast();
153
+ }
154
+ catch {
155
+ // Offline: keep the list. The Styles panel still edits the blocks.
156
+ loaded.set(true);
157
+ }
158
+ },
159
+ async loadUsage() {
160
+ try {
161
+ const res = await request(`${config.endpoint}/usage`);
162
+ if (res.ok)
163
+ usage.set((await res.json()).usage ?? {});
164
+ }
165
+ catch {
166
+ // Keep the last counts.
167
+ }
168
+ },
169
+ byId: (id) => (id === null ? undefined : list.get().find((c) => sameId(c.id, id))),
170
+ byName: (name) => list.get().find((c) => c.name === name),
171
+ /** Changes one field of a class (an undo step; steps with the same `mergeKey` merge). */
172
+ edit(id, field, value, mergeKey) {
173
+ const item = list.get().find((c) => sameId(c.id, id));
174
+ if (!item)
175
+ return;
176
+ const before = item[field] ?? null;
177
+ setField(id, field, value);
178
+ const after = list.get().find((c) => sameId(c.id, id))?.[field] ?? null;
179
+ if (before === after)
180
+ return;
181
+ store.recordExternal({ before, after, apply: (v) => setField(id, field, v) }, mergeKey);
182
+ },
183
+ /** Creates a class (a draft). Returns it, or the reason it was refused. */
184
+ async create(data) {
185
+ try {
186
+ const res = await request(`${api}/${encodeURIComponent(config.collection)}?draft=true&depth=0`, {
187
+ method: 'POST',
188
+ body: JSON.stringify({ ...data, styles: normalizeStyles(data.styles), _status: 'draft' }),
189
+ });
190
+ if (!res.ok)
191
+ return await errorText(res);
192
+ const doc = toBuilderClass((await res.json()).doc ?? {});
193
+ if (!doc)
194
+ return 'The server did not return the class.';
195
+ put(doc);
196
+ void controller.loadUsage();
197
+ return doc;
198
+ }
199
+ catch (error) {
200
+ return error instanceof Error ? error.message : String(error);
201
+ }
202
+ },
203
+ /** Saves the waiting edits and publishes the class: the live site changes on every page that uses it. */
204
+ async publish(id) {
205
+ const key = String(id);
206
+ clearTimeout(timers.get(key));
207
+ const fields = pending.get(key) ?? {};
208
+ pending.delete(key);
209
+ setSaving(id, { status: 'saving' });
210
+ try {
211
+ const res = await request(`${docPath(id)}?depth=0`, { method: 'PATCH', body: JSON.stringify({ ...fields, _status: 'published' }) });
212
+ if (!res.ok) {
213
+ pending.set(key, { ...fields, ...pending.get(key) });
214
+ const error = await errorText(res);
215
+ setSaving(id, { status: 'error', error });
216
+ return error;
217
+ }
218
+ setSaving(id, null);
219
+ const doc = toBuilderClass((await res.json()).doc ?? {});
220
+ if (doc)
221
+ put(doc);
222
+ return true;
223
+ }
224
+ catch (error) {
225
+ pending.set(key, { ...fields, ...pending.get(key) });
226
+ const text = error instanceof Error ? error.message : String(error);
227
+ setSaving(id, { status: 'error', error: text });
228
+ return text;
229
+ }
230
+ },
231
+ /** Renames the class and every block that uses it (their drafts). */
232
+ async rename(id, name) {
233
+ await flush(id);
234
+ try {
235
+ const res = await request(`${config.endpoint}/rename`, { method: 'POST', body: JSON.stringify({ id, name }) });
236
+ if (!res.ok)
237
+ return await errorText(res);
238
+ const body = (await res.json());
239
+ if (body.class)
240
+ put(body.class);
241
+ void controller.loadUsage();
242
+ return { documents: body.replaced?.documents ?? 0, blocks: body.replaced?.blocks ?? 0, failed: body.replaced?.failed.length ?? 0 };
243
+ }
244
+ catch (error) {
245
+ return error instanceof Error ? error.message : String(error);
246
+ }
247
+ },
248
+ /** Removes the class from every block that uses it, then deletes it. */
249
+ async remove(id) {
250
+ clearTimeout(timers.get(String(id)));
251
+ pending.delete(String(id));
252
+ try {
253
+ const res = await request(`${config.endpoint}/delete`, { method: 'POST', body: JSON.stringify({ id, removeFromBlocks: true }) });
254
+ if (!res.ok)
255
+ return await errorText(res);
256
+ const body = (await res.json());
257
+ setSaving(id, null);
258
+ drop(id);
259
+ void controller.loadUsage();
260
+ return { documents: body.replaced?.documents ?? 0, blocks: body.replaced?.blocks ?? 0 };
261
+ }
262
+ catch (error) {
263
+ return error instanceof Error ? error.message : String(error);
264
+ }
265
+ },
266
+ /** A copy of the class (a draft) under a free name: `card-copy`, `card-copy-2`, … */
267
+ async duplicate(id) {
268
+ const item = controller.byId(id);
269
+ if (!item)
270
+ return 'The class is gone.';
271
+ const taken = new Set(list.get().flatMap((c) => [c.name, ...(c.previousNames ?? [])]));
272
+ let name = `${item.name}-copy`;
273
+ for (let n = 2; taken.has(name); n++)
274
+ name = `${item.name}-copy-${n}`;
275
+ return controller.create({ name, label: item.label ? `${item.label} copy` : null, group: item.group ?? null, styles: item.styles ?? null, css: item.css ?? null });
276
+ },
277
+ /** Deletes every class no page uses. The server checks again (drafts, open sessions and published pages). */
278
+ async removeUnused() {
279
+ try {
280
+ const res = await request(`${config.endpoint}/remove-unused`, { method: 'POST', body: '{}' });
281
+ if (!res.ok)
282
+ return await errorText(res);
283
+ const body = (await res.json());
284
+ const deleted = body.deleted ?? [];
285
+ for (const name of deleted) {
286
+ const item = controller.byName(name);
287
+ if (item)
288
+ drop(item.id);
289
+ }
290
+ void controller.loadUsage();
291
+ return { deleted, failed: body.failed?.length ?? 0 };
292
+ }
293
+ catch (error) {
294
+ return error instanceof Error ? error.message : String(error);
295
+ }
296
+ },
297
+ /** Creates classes from the site's code `@utility` classes. */
298
+ async importSite() {
299
+ try {
300
+ const res = await request(`${config.endpoint}/import`, { method: 'POST', body: '{}' });
301
+ if (!res.ok)
302
+ return await errorText(res);
303
+ const body = (await res.json());
304
+ for (const item of body.created ?? [])
305
+ put(item);
306
+ void controller.loadUsage();
307
+ return { created: body.created?.length ?? 0, skipped: body.skipped?.length ?? 0 };
308
+ }
309
+ catch (error) {
310
+ return error instanceof Error ? error.message : String(error);
311
+ }
312
+ },
313
+ /** Saves a failed edit again. */
314
+ retry: (id) => void flush(id),
315
+ dispose() {
316
+ for (const [key, timer] of timers) {
317
+ clearTimeout(timer);
318
+ void save(key);
319
+ }
320
+ channel?.close();
321
+ if (typeof window !== 'undefined')
322
+ window.removeEventListener('focus', onFocus);
323
+ },
324
+ };
325
+ return controller;
326
+ }