@puckeditor/cli 0.24.0-canary.fd916921 → 0.25.0-canary.a9fe1d00

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 (210) hide show
  1. package/README.md +5 -1
  2. package/dist/bin.mjs +327 -137
  3. package/dist/docs/cli.md +39 -5
  4. package/dist/docs/cloud/ai/assembly-mode.md +271 -0
  5. package/dist/docs/cloud/ai/business-context.md +69 -0
  6. package/dist/docs/cloud/ai/custom-agents.md +133 -0
  7. package/dist/docs/cloud/ai/design-mode.md +235 -0
  8. package/dist/docs/cloud/ai/headless-generation.md +122 -0
  9. package/dist/docs/cloud/ai/localization.md +43 -0
  10. package/dist/docs/cloud/ai/model-configuration.md +113 -0
  11. package/dist/docs/cloud/ai/overview.md +35 -0
  12. package/dist/docs/cloud/ai/setup.md +65 -0
  13. package/dist/docs/cloud/ai/tools.md +99 -0
  14. package/dist/docs/cloud/api-reference/cloud-client/helpers/chat.md +515 -0
  15. package/dist/docs/cloud/api-reference/cloud-client/helpers/login-url.md +21 -0
  16. package/dist/docs/cloud/api-reference/cloud-client/helpers/tool.md +128 -0
  17. package/dist/docs/cloud/api-reference/cloud-client/puck-cloud.md +73 -0
  18. package/dist/docs/cloud/api-reference/cloud-client/puck-handler.md +434 -0
  19. package/dist/docs/cloud/api-reference/cloud-client/server-apis/ai-generate.md +523 -0
  20. package/dist/docs/cloud/api-reference/cloud-client/server-apis/auth-get-session.md +41 -0
  21. package/dist/docs/cloud/api-reference/cloud-client/server-apis/auth-sign-out.md +24 -0
  22. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-create-version.md +50 -0
  23. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-create.md +45 -0
  24. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-delete.md +42 -0
  25. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-get-by-path.md +34 -0
  26. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-get-published.md +25 -0
  27. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-get.md +34 -0
  28. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-list-versions.md +49 -0
  29. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-list.md +46 -0
  30. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-publish.md +30 -0
  31. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-unpublish.md +25 -0
  32. package/dist/docs/cloud/api-reference/cloud-client/server-apis/pages-update.md +38 -0
  33. package/dist/docs/cloud/api-reference/cloud-client/types/ai-generate-field-type.md +33 -0
  34. package/dist/docs/cloud/api-reference/cloud-client/types/page-list.md +41 -0
  35. package/dist/docs/cloud/api-reference/cloud-client/types/page.md +61 -0
  36. package/dist/docs/cloud/api-reference/cloud-client/types/puck-cloud-error.md +34 -0
  37. package/dist/docs/cloud/api-reference/cloud-client/types/puck-session.md +53 -0
  38. package/dist/docs/cloud/api-reference/plugin-ai/ai-configuration/components.md +72 -0
  39. package/dist/docs/cloud/api-reference/plugin-ai/ai-configuration/fields.md +231 -0
  40. package/dist/docs/cloud/api-reference/plugin-ai/ai-field-type.md +41 -0
  41. package/dist/docs/cloud/api-reference/plugin-ai/ai-part.md +90 -0
  42. package/dist/docs/cloud/api-reference/plugin-ai/create-ai-plugin.md +311 -0
  43. package/dist/docs/cloud/api-reference/plugin-ai/dictionary.md +77 -0
  44. package/dist/docs/cloud/api-reference/plugin-ai/use-puck-ai.md +175 -0
  45. package/dist/docs/cloud/api-reference/plugin-ai/with-dynamic-config.md +35 -0
  46. package/dist/docs/cloud/api-reference/plugin-auth/create-auth-plugin.md +43 -0
  47. package/dist/docs/cloud/api-reference/plugin-pages/create-pages-plugin.md +65 -0
  48. package/dist/docs/cloud/auth/overview.md +24 -0
  49. package/dist/docs/cloud/auth/setup.md +169 -0
  50. package/dist/docs/cloud/auth-and-identity.md +70 -0
  51. package/dist/docs/cloud/getting-started.md +47 -0
  52. package/dist/docs/cloud/overview.md +23 -0
  53. package/dist/docs/cloud/pages/overview.md +38 -0
  54. package/dist/docs/cloud/pages/setup.md +80 -0
  55. package/dist/docs/cloud/server-apis.md +58 -0
  56. package/dist/docs/cloud/setup-cloud-plugins.md +202 -0
  57. package/dist/docs/{api-reference → editor/api-reference}/actions.md +16 -16
  58. package/dist/docs/{api-reference → editor/api-reference}/components/action-bar-action.md +2 -2
  59. package/dist/docs/editor/api-reference/components/action-bar-drag-handle.md +33 -0
  60. package/dist/docs/{api-reference → editor/api-reference}/components/action-bar-group.md +2 -2
  61. package/dist/docs/{api-reference → editor/api-reference}/components/action-bar-label.md +1 -1
  62. package/dist/docs/{api-reference → editor/api-reference}/components/action-bar-separator.md +1 -1
  63. package/dist/docs/{api-reference → editor/api-reference}/components/action-bar.md +2 -2
  64. package/dist/docs/{api-reference → editor/api-reference}/components/auto-field.md +11 -11
  65. package/dist/docs/{api-reference → editor/api-reference}/components/drawer-item.md +2 -2
  66. package/dist/docs/{api-reference → editor/api-reference}/components/drawer.md +2 -2
  67. package/dist/docs/{api-reference → editor/api-reference}/components/drop-zone.md +5 -5
  68. package/dist/docs/editor/api-reference/components/field-group-item.md +40 -0
  69. package/dist/docs/editor/api-reference/components/field-group.md +87 -0
  70. package/dist/docs/{api-reference → editor/api-reference}/components/field-label.md +6 -1
  71. package/dist/docs/editor/api-reference/components/field-tab.md +56 -0
  72. package/dist/docs/{api-reference → editor/api-reference}/components/inline-text-field.md +6 -6
  73. package/dist/docs/{api-reference → editor/api-reference}/components/puck-components.md +1 -1
  74. package/dist/docs/{api-reference → editor/api-reference}/components/puck-fields.md +1 -1
  75. package/dist/docs/{api-reference → editor/api-reference}/components/puck-layout.md +1 -1
  76. package/dist/docs/{api-reference → editor/api-reference}/components/puck.md +52 -47
  77. package/dist/docs/editor/api-reference/components/render.md +114 -0
  78. package/dist/docs/{api-reference → editor/api-reference}/components/rich-text-menu-control.md +1 -1
  79. package/dist/docs/{api-reference → editor/api-reference}/components/rich-text-menu-group.md +2 -2
  80. package/dist/docs/editor/api-reference/components/rich-text-menu.md +99 -0
  81. package/dist/docs/editor/api-reference/components.md +36 -0
  82. package/dist/docs/{api-reference → editor/api-reference}/configuration/component-config.md +71 -28
  83. package/dist/docs/{api-reference → editor/api-reference}/configuration/config.md +7 -7
  84. package/dist/docs/editor/api-reference/configuration.md +4 -0
  85. package/dist/docs/{api-reference → editor/api-reference}/data-model/app-state.md +30 -16
  86. package/dist/docs/{api-reference → editor/api-reference}/data-model/component-data.md +3 -3
  87. package/dist/docs/{api-reference → editor/api-reference}/data-model/data.md +12 -12
  88. package/dist/docs/{api-reference → editor/api-reference}/data-model/item-selector.md +5 -5
  89. package/dist/docs/editor/api-reference/data-model/root-data.md +59 -0
  90. package/dist/docs/editor/api-reference/data-model.md +8 -0
  91. package/dist/docs/{api-reference → editor/api-reference}/dictionary.md +8 -7
  92. package/dist/docs/{api-reference → editor/api-reference}/field-transforms.md +13 -13
  93. package/dist/docs/{api-reference → editor/api-reference}/fields/array.md +1 -1
  94. package/dist/docs/editor/api-reference/fields/checkbox.md +87 -0
  95. package/dist/docs/{api-reference → editor/api-reference}/fields/custom.md +11 -11
  96. package/dist/docs/{api-reference → editor/api-reference}/fields/external.md +2 -2
  97. package/dist/docs/{api-reference → editor/api-reference}/fields/number.md +1 -1
  98. package/dist/docs/editor/api-reference/fields/object.md +100 -0
  99. package/dist/docs/{api-reference → editor/api-reference}/fields/radio.md +1 -1
  100. package/dist/docs/{api-reference → editor/api-reference}/fields/richtext.md +5 -5
  101. package/dist/docs/{api-reference → editor/api-reference}/fields/select.md +1 -1
  102. package/dist/docs/{api-reference → editor/api-reference}/fields/slot.md +2 -2
  103. package/dist/docs/{api-reference → editor/api-reference}/fields/text.md +3 -3
  104. package/dist/docs/{api-reference → editor/api-reference}/fields/textarea.md +3 -3
  105. package/dist/docs/editor/api-reference/fields.md +17 -0
  106. package/dist/docs/{api-reference → editor/api-reference}/functions/migrate.md +9 -9
  107. package/dist/docs/{api-reference → editor/api-reference}/functions/register-overlay-portal.md +2 -2
  108. package/dist/docs/editor/api-reference/functions/resolve-all-data.md +27 -0
  109. package/dist/docs/{api-reference → editor/api-reference}/functions/set-deep.md +4 -4
  110. package/dist/docs/editor/api-reference/functions/transform-props.md +51 -0
  111. package/dist/docs/{api-reference → editor/api-reference}/functions/use-get-puck.md +3 -3
  112. package/dist/docs/{api-reference → editor/api-reference}/functions/use-puck.md +2 -2
  113. package/dist/docs/{api-reference → editor/api-reference}/functions/walk-tree.md +16 -16
  114. package/dist/docs/editor/api-reference/functions.md +8 -0
  115. package/dist/docs/editor/api-reference/overrides/action-bar.md +51 -0
  116. package/dist/docs/{api-reference → editor/api-reference}/overrides/component-overlay.md +2 -2
  117. package/dist/docs/{api-reference → editor/api-reference}/overrides/field-label.md +1 -1
  118. package/dist/docs/{api-reference → editor/api-reference}/overrides/field-types.md +9 -9
  119. package/dist/docs/editor/api-reference/overrides/fields.md +45 -0
  120. package/dist/docs/{api-reference → editor/api-reference}/overrides/header.md +1 -1
  121. package/dist/docs/{api-reference → editor/api-reference}/overrides/puck.md +2 -2
  122. package/dist/docs/editor/api-reference/overrides.md +28 -0
  123. package/dist/docs/{api-reference → editor/api-reference}/permissions.md +5 -5
  124. package/dist/docs/{api-reference → editor/api-reference}/plugin.md +12 -12
  125. package/dist/docs/{api-reference → editor/api-reference}/puck-api.md +39 -38
  126. package/dist/docs/{api-reference → editor/api-reference}/theming/action-bar.md +1 -1
  127. package/dist/docs/{api-reference → editor/api-reference}/theming/button.md +1 -1
  128. package/dist/docs/{api-reference → editor/api-reference}/theming/canvas.md +1 -1
  129. package/dist/docs/{api-reference → editor/api-reference}/theming/computed-values.md +15 -0
  130. package/dist/docs/{api-reference → editor/api-reference}/theming/drawer.md +1 -1
  131. package/dist/docs/editor/api-reference/theming/field-tabs.md +28 -0
  132. package/dist/docs/{api-reference → editor/api-reference}/theming/fields.md +8 -1
  133. package/dist/docs/{api-reference → editor/api-reference}/theming/header.md +1 -1
  134. package/dist/docs/{api-reference → editor/api-reference}/theming/icon-button.md +1 -1
  135. package/dist/docs/{api-reference → editor/api-reference}/theming/outline.md +1 -1
  136. package/dist/docs/{api-reference → editor/api-reference}/theming/plugin-bar.md +1 -1
  137. package/dist/docs/{api-reference → editor/api-reference}/theming/sidebar.md +1 -1
  138. package/dist/docs/{api-reference → editor/api-reference}/theming/slot.md +1 -1
  139. package/dist/docs/{integrating-puck → editor/components-and-fields}/component-configuration.md +12 -12
  140. package/dist/docs/{extending-puck → editor/components-and-fields}/custom-fields.md +8 -8
  141. package/dist/docs/{integrating-puck → editor/components-and-fields}/dynamic-fields.md +6 -6
  142. package/dist/docs/editor/components-and-fields/field-grouping.md +151 -0
  143. package/dist/docs/{extending-puck → editor/components-and-fields}/field-transforms.md +21 -7
  144. package/dist/docs/{integrating-puck → editor/components-and-fields}/multi-column-layouts.md +11 -11
  145. package/dist/docs/{integrating-puck → editor/components-and-fields}/overlay-portals.md +2 -2
  146. package/dist/docs/{integrating-puck → editor/components-and-fields}/rich-text-editing.md +13 -13
  147. package/dist/docs/{integrating-puck → editor/components-and-fields}/root-configuration.md +5 -5
  148. package/dist/docs/{integrating-puck → editor/customize}/categories.md +3 -3
  149. package/dist/docs/editor/customize/composition.md +54 -0
  150. package/dist/docs/{integrating-puck → editor/customize}/feature-toggling.md +11 -11
  151. package/dist/docs/{extending-puck → editor/customize}/internal-puck-api.md +15 -14
  152. package/dist/docs/{integrating-puck → editor/customize}/localization.md +13 -13
  153. package/dist/docs/{extending-puck → editor/customize}/plugins.md +19 -17
  154. package/dist/docs/{integrating-puck → editor/customize}/styling.md +11 -11
  155. package/dist/docs/editor/customize/theming.md +89 -0
  156. package/dist/docs/{extending-puck → editor/customize}/ui-overrides.md +9 -9
  157. package/dist/docs/{integrating-puck → editor/customize}/viewports.md +5 -5
  158. package/dist/docs/{integrating-puck → editor/data-and-rendering}/dynamic-props.md +7 -7
  159. package/dist/docs/{integrating-puck → editor/data-and-rendering}/external-data-sources.md +10 -10
  160. package/dist/docs/editor/data-and-rendering/save-and-render-pages.md +82 -0
  161. package/dist/docs/{integrating-puck → editor/data-and-rendering}/server-components.md +4 -4
  162. package/dist/docs/{getting-started.md → editor/getting-started.md} +3 -1
  163. package/dist/docs/{integrating-puck → editor/migrations}/data-migration.md +6 -6
  164. package/dist/docs/{guides → editor}/migrations/dropzones-to-slots.md +8 -8
  165. package/dist/docs/editor/overview.md +27 -0
  166. package/dist/docs/index.json +381 -137
  167. package/dist/templates/next/app/puck/[...puckPath]/page.tsx +3 -2
  168. package/dist/templates/next/app/puck/page.tsx +0 -2
  169. package/dist/templates/next/package.json +1 -1
  170. package/dist/templates/next-ai/app/puck/[...puckPath]/page.tsx +3 -2
  171. package/dist/templates/next-ai/app/puck/page.tsx +0 -2
  172. package/dist/templates/next-ai/package.json +1 -1
  173. package/dist/templates/react-router/package.json +1 -1
  174. package/dist/templates/react-router-ai/package.json +1 -1
  175. package/dist/templates/vinext/app/puck/[...puckPath]/page.tsx +3 -2
  176. package/dist/templates/vinext/app/puck/page.tsx +0 -2
  177. package/dist/templates/vinext-ai/app/puck/[...puckPath]/page.tsx +3 -2
  178. package/dist/templates/vinext-ai/app/puck/page.tsx +0 -2
  179. package/package.json +1 -1
  180. package/dist/docs/api-reference/components/render.md +0 -94
  181. package/dist/docs/api-reference/components/rich-text-menu.md +0 -99
  182. package/dist/docs/api-reference/components.md +0 -32
  183. package/dist/docs/api-reference/configuration.md +0 -4
  184. package/dist/docs/api-reference/data-model/root-data.md +0 -59
  185. package/dist/docs/api-reference/data-model.md +0 -8
  186. package/dist/docs/api-reference/fields/object.md +0 -78
  187. package/dist/docs/api-reference/fields.md +0 -16
  188. package/dist/docs/api-reference/functions/resolve-all-data.md +0 -27
  189. package/dist/docs/api-reference/functions/transform-props.md +0 -51
  190. package/dist/docs/api-reference/functions.md +0 -8
  191. package/dist/docs/api-reference/overrides/action-bar.md +0 -35
  192. package/dist/docs/api-reference/overrides/fields.md +0 -19
  193. package/dist/docs/api-reference/overrides.md +0 -28
  194. package/dist/docs/extending-puck/composition.md +0 -54
  195. package/dist/docs/extending-puck/theming.md +0 -88
  196. package/dist/docs/index.md +0 -37
  197. /package/dist/docs/{api-reference → editor/api-reference}/components/puck-outline.md +0 -0
  198. /package/dist/docs/{api-reference → editor/api-reference}/components/puck-preview.md +0 -0
  199. /package/dist/docs/{api-reference → editor/api-reference}/fields/base.md +0 -0
  200. /package/dist/docs/{api-reference → editor/api-reference}/overrides/drawer-item.md +0 -0
  201. /package/dist/docs/{api-reference → editor/api-reference}/overrides/drawer.md +0 -0
  202. /package/dist/docs/{api-reference → editor/api-reference}/overrides/header-actions.md +0 -0
  203. /package/dist/docs/{api-reference → editor/api-reference}/overrides/iframe.md +0 -0
  204. /package/dist/docs/{api-reference → editor/api-reference}/overrides/outline.md +0 -0
  205. /package/dist/docs/{api-reference → editor/api-reference}/overrides/preview.md +0 -0
  206. /package/dist/docs/{api-reference → editor/api-reference}/plugins/blocks-plugin.md +0 -0
  207. /package/dist/docs/{api-reference → editor/api-reference}/plugins/fields-plugin.md +0 -0
  208. /package/dist/docs/{api-reference → editor/api-reference}/plugins/legacy-side-bar-plugin.md +0 -0
  209. /package/dist/docs/{api-reference → editor/api-reference}/plugins/outline-plugin.md +0 -0
  210. /package/dist/docs/{api-reference → editor/api-reference}/theming/global.md +0 -0
package/README.md CHANGED
@@ -11,9 +11,11 @@ npx @puckeditor/cli init
11
11
  For coding agents:
12
12
 
13
13
  ```sh
14
- npx @puckeditor/cli init --yes --json --ai --pages --auth # or --editor-only
14
+ npx @puckeditor/cli init --yes --json
15
15
  ```
16
16
 
17
+ `init` returns a `choose_capabilities` action. Ask the developer which to include rather than choosing for them.
18
+
17
19
  Other commands:
18
20
 
19
21
  ```sh
@@ -36,6 +38,8 @@ See the [CLI docs](https://puckeditor.com/docs/cli) for the full JSON contract,
36
38
 
37
39
  The CLI collects anonymous usage data. See [Telemetry](https://puckeditor.com/docs/cli#telemetry) for what's sent and how to turn it off.
38
40
 
41
+ Coding agents: leave this to the developer. Don't turn telemetry off unless they ask.
42
+
39
43
  ## Development
40
44
 
41
45
  The CLI integrates Puck using the [recipes](../../recipes) as templates. Tests read the recipes directly, and `pnpm build` copies them into `dist/templates`.