@measured/puck 0.21.0-canary.c6d4e0ec → 0.21.0-canary.cbc526d1

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 (52) hide show
  1. package/dist/Editor-32UYWE6W.mjs +204 -0
  2. package/dist/Editor-IQP25PUX.css +404 -0
  3. package/dist/Render-3OV4N4MT.css +102 -0
  4. package/dist/Render-FXZX6NFH.mjs +55 -0
  5. package/dist/{walk-tree-Ctf3FZQI.d.mts → actions-BkBoKAc5.d.mts} +287 -83
  6. package/dist/{walk-tree-Ctf3FZQI.d.ts → actions-BkBoKAc5.d.ts} +287 -83
  7. package/dist/chunk-3VQHXASI.mjs +33 -0
  8. package/dist/chunk-6KNQXLQR.mjs +708 -0
  9. package/dist/chunk-AOEDIUVK.mjs +11 -0
  10. package/dist/chunk-GVKHZNTR.mjs +53 -0
  11. package/dist/chunk-K562SEXI.mjs +1813 -0
  12. package/dist/chunk-KN3XDS7U.mjs +528 -0
  13. package/dist/chunk-M6W7YEVX.mjs +95 -0
  14. package/dist/chunk-MEL7FUSF.mjs +63 -0
  15. package/dist/chunk-NYGQH27S.mjs +445 -0
  16. package/dist/chunk-Q3TJ2VYO.mjs +436 -0
  17. package/dist/chunk-REWRIUGR.mjs +156 -0
  18. package/dist/chunk-V2IQTPPK.mjs +111 -0
  19. package/dist/chunk-V5I7CVLT.mjs +103 -0
  20. package/dist/{chunk-HNR5CJAZ.mjs → chunk-WD3LNSAC.mjs} +7041 -8151
  21. package/dist/chunk-Y2EFNT5P.mjs +108 -0
  22. package/dist/full-2GJTAAZE.css +301 -0
  23. package/dist/full-4OS3O57Y.mjs +93 -0
  24. package/dist/index-bqD1SEOb.d.mts +118 -0
  25. package/dist/index-lt1zf5WR.d.ts +118 -0
  26. package/dist/index.css +1032 -385
  27. package/dist/index.d.mts +118 -114
  28. package/dist/index.d.ts +118 -114
  29. package/dist/index.js +9823 -5714
  30. package/dist/index.mjs +34 -12
  31. package/dist/internal.d.mts +27 -0
  32. package/dist/internal.d.ts +27 -0
  33. package/dist/internal.js +927 -0
  34. package/dist/internal.mjs +13 -0
  35. package/dist/loaded-DCQVLO7I.mjs +57 -0
  36. package/dist/loaded-JGRO7BH7.mjs +57 -0
  37. package/dist/loaded-KKVJE5KH.mjs +60 -0
  38. package/dist/loaded-RVWBFK7L.css +87 -0
  39. package/dist/no-external.css +1121 -470
  40. package/dist/no-external.d.mts +19 -2
  41. package/dist/no-external.d.ts +19 -2
  42. package/dist/no-external.js +9825 -5713
  43. package/dist/no-external.mjs +36 -9
  44. package/dist/rsc.css +102 -0
  45. package/dist/rsc.d.mts +17 -2
  46. package/dist/rsc.d.ts +17 -2
  47. package/dist/rsc.js +551 -101
  48. package/dist/rsc.mjs +18 -9
  49. package/dist/walk-tree-CRRDqx6_.d.mts +29 -0
  50. package/dist/walk-tree-CS7sEpfG.d.ts +29 -0
  51. package/package.json +31 -4
  52. package/dist/chunk-X7YZ3YE7.mjs +0 -964
@@ -0,0 +1,55 @@
1
+ import {
2
+ PuckRichText
3
+ } from "./chunk-V5I7CVLT.mjs";
4
+ import {
5
+ styles_module_default
6
+ } from "./chunk-AOEDIUVK.mjs";
7
+ import {
8
+ get_class_name_factory_default
9
+ } from "./chunk-Y2EFNT5P.mjs";
10
+ import {
11
+ init_react_import
12
+ } from "./chunk-M6W7YEVX.mjs";
13
+
14
+ // components/RichTextEditor/components/Render.tsx
15
+ init_react_import();
16
+ import { generateHTML, generateJSON } from "@tiptap/html";
17
+ import { useMemo } from "react";
18
+ import { jsx } from "react/jsx-runtime";
19
+ var getClassName = get_class_name_factory_default("RichTextEditor", styles_module_default);
20
+ function RichTextRender({
21
+ content,
22
+ field
23
+ }) {
24
+ const { tiptap = {}, options } = field;
25
+ const { extensions = [] } = tiptap;
26
+ const loadedExtensions = useMemo(
27
+ () => [PuckRichText.configure(options), ...extensions],
28
+ [field, extensions]
29
+ );
30
+ const normalized = useMemo(() => {
31
+ if (typeof content === "object" && (content == null ? void 0 : content.type) === "doc") {
32
+ return content;
33
+ }
34
+ if (typeof content === "string") {
35
+ const isHtml = /<\/?[a-z][\s\S]*>/i.test(content);
36
+ if (isHtml) {
37
+ return generateJSON(content, loadedExtensions);
38
+ }
39
+ return {
40
+ type: "doc",
41
+ content: [
42
+ { type: "paragraph", content: [{ type: "text", text: content }] }
43
+ ]
44
+ };
45
+ }
46
+ return { type: "doc", content: [] };
47
+ }, [content, loadedExtensions]);
48
+ const html = useMemo(() => {
49
+ return generateHTML(normalized, loadedExtensions);
50
+ }, [normalized, loadedExtensions]);
51
+ return /* @__PURE__ */ jsx("div", { className: getClassName(), children: /* @__PURE__ */ jsx("div", { className: "rich-text", dangerouslySetInnerHTML: { __html: html } }) });
52
+ }
53
+ export {
54
+ RichTextRender
55
+ };
@@ -1,72 +1,269 @@
1
- import { ReactElement, CSSProperties, ReactNode, JSX } from 'react';
1
+ import { ReactElement, CSSProperties, ReactNode, ElementType, Ref, JSX } from 'react';
2
+ import { EditorStateSnapshot, Editor, Extensions } from '@tiptap/react';
3
+ import { BlockquoteOptions } from '@tiptap/extension-blockquote';
4
+ import { BoldOptions } from '@tiptap/extension-bold';
5
+ import { CodeOptions } from '@tiptap/extension-code';
6
+ import { CodeBlockOptions } from '@tiptap/extension-code-block';
7
+ import { HardBreakOptions } from '@tiptap/extension-hard-break';
8
+ import { HeadingOptions } from '@tiptap/extension-heading';
9
+ import { HorizontalRuleOptions } from '@tiptap/extension-horizontal-rule';
10
+ import { ItalicOptions } from '@tiptap/extension-italic';
11
+ import { LinkOptions } from '@tiptap/extension-link';
12
+ import { BulletListOptions, ListItemOptions, ListKeymapOptions, OrderedListOptions } from '@tiptap/extension-list';
13
+ import { ParagraphOptions } from '@tiptap/extension-paragraph';
14
+ import { StrikeOptions } from '@tiptap/extension-strike';
15
+ import { TextAlignOptions } from '@tiptap/extension-text-align';
16
+ import { UnderlineOptions } from '@tiptap/extension-underline';
2
17
 
3
18
  type ItemSelector = {
4
19
  index: number;
5
20
  zone?: string;
6
21
  };
7
22
 
23
+ declare const defaultEditorState: (ctx: EditorStateSnapshot, readOnly: boolean) => {
24
+ isAlignLeft?: undefined;
25
+ canAlignLeft?: undefined;
26
+ isAlignCenter?: undefined;
27
+ canAlignCenter?: undefined;
28
+ isAlignRight?: undefined;
29
+ canAlignRight?: undefined;
30
+ isAlignJustify?: undefined;
31
+ canAlignJustify?: undefined;
32
+ isBold?: undefined;
33
+ canBold?: undefined;
34
+ isItalic?: undefined;
35
+ canItalic?: undefined;
36
+ isUnderline?: undefined;
37
+ canUnderline?: undefined;
38
+ isStrike?: undefined;
39
+ canStrike?: undefined;
40
+ isInlineCode?: undefined;
41
+ canInlineCode?: undefined;
42
+ isBulletList?: undefined;
43
+ canBulletList?: undefined;
44
+ isOrderedList?: undefined;
45
+ canOrderedList?: undefined;
46
+ isCodeBlock?: undefined;
47
+ canCodeBlock?: undefined;
48
+ isBlockquote?: undefined;
49
+ canBlockquote?: undefined;
50
+ canHorizontalRule?: undefined;
51
+ } | {
52
+ isAlignLeft: boolean;
53
+ canAlignLeft: boolean;
54
+ isAlignCenter: boolean;
55
+ canAlignCenter: boolean;
56
+ isAlignRight: boolean;
57
+ canAlignRight: boolean;
58
+ isAlignJustify: boolean;
59
+ canAlignJustify: boolean;
60
+ isBold: boolean;
61
+ canBold: boolean;
62
+ isItalic: boolean;
63
+ canItalic: boolean;
64
+ isUnderline: boolean;
65
+ canUnderline: boolean;
66
+ isStrike: boolean;
67
+ canStrike: boolean;
68
+ isInlineCode: boolean;
69
+ canInlineCode: boolean;
70
+ isBulletList: boolean;
71
+ canBulletList: boolean;
72
+ isOrderedList: boolean;
73
+ canOrderedList: boolean;
74
+ isCodeBlock: boolean;
75
+ canCodeBlock: boolean;
76
+ isBlockquote: boolean;
77
+ canBlockquote: boolean;
78
+ canHorizontalRule: boolean;
79
+ };
80
+
81
+ type RichTextSelector = (ctx: EditorStateSnapshot, readOnly: boolean) => Partial<Record<string, boolean>>;
82
+ type DefaultEditorState = ReturnType<typeof defaultEditorState>;
83
+ type EditorState<Selector extends RichTextSelector = RichTextSelector> = DefaultEditorState & ReturnType<Selector> & Record<string, boolean | undefined>;
84
+
85
+ interface PuckRichTextOptions {
86
+ /**
87
+ * If set to false, the blockquote extension will not be registered
88
+ * @example blockquote: false
89
+ */
90
+ blockquote: Partial<BlockquoteOptions> | false;
91
+ /**
92
+ * If set to false, the bold extension will not be registered
93
+ * @example bold: false
94
+ */
95
+ bold: Partial<BoldOptions> | false;
96
+ /**
97
+ * If set to false, the bulletList extension will not be registered
98
+ * @example bulletList: false
99
+ */
100
+ bulletList: Partial<BulletListOptions> | false;
101
+ /**
102
+ * If set to false, the code extension will not be registered
103
+ * @example code: false
104
+ */
105
+ code: Partial<CodeOptions> | false;
106
+ /**
107
+ * If set to false, the codeBlock extension will not be registered
108
+ * @example codeBlock: false
109
+ */
110
+ codeBlock: Partial<CodeBlockOptions> | false;
111
+ /**
112
+ * If set to false, the document extension will not be registered
113
+ * @example document: false
114
+ */
115
+ document: false;
116
+ /**
117
+ * If set to false, the hardBreak extension will not be registered
118
+ * @example hardBreak: false
119
+ */
120
+ hardBreak: Partial<HardBreakOptions> | false;
121
+ /**
122
+ * If set to false, the heading extension will not be registered
123
+ * @example heading: false
124
+ */
125
+ heading: Partial<HeadingOptions> | false;
126
+ /**
127
+ * If set to false, the horizontalRule extension will not be registered
128
+ * @example horizontalRule: false
129
+ */
130
+ horizontalRule: Partial<HorizontalRuleOptions> | false;
131
+ /**
132
+ * If set to false, the italic extension will not be registered
133
+ * @example italic: false
134
+ */
135
+ italic: Partial<ItalicOptions> | false;
136
+ /**
137
+ * If set to false, the listItem extension will not be registered
138
+ * @example listItem: false
139
+ */
140
+ listItem: Partial<ListItemOptions> | false;
141
+ /**
142
+ * If set to false, the listItemKeymap extension will not be registered
143
+ * @example listKeymap: false
144
+ */
145
+ listKeymap: Partial<ListKeymapOptions> | false;
146
+ /**
147
+ * If set to false, the link extension will not be registered
148
+ * @example link: false
149
+ */
150
+ link: Partial<LinkOptions> | false;
151
+ /**
152
+ * If set to false, the orderedList extension will not be registered
153
+ * @example orderedList: false
154
+ */
155
+ orderedList: Partial<OrderedListOptions> | false;
156
+ /**
157
+ * If set to false, the paragraph extension will not be registered
158
+ * @example paragraph: false
159
+ */
160
+ paragraph: Partial<ParagraphOptions> | false;
161
+ /**
162
+ * If set to false, the strike extension will not be registered
163
+ * @example strike: false
164
+ */
165
+ strike: Partial<StrikeOptions> | false;
166
+ /**
167
+ * If set to false, the text extension will not be registered
168
+ * @example text: false
169
+ */
170
+ text: false;
171
+ /**
172
+ * If set to false, the textAlign extension will not be registered
173
+ * @example text: false
174
+ */
175
+ textAlign: Partial<TextAlignOptions> | false;
176
+ /**
177
+ * If set to false, the underline extension will not be registered
178
+ * @example underline: false
179
+ */
180
+ underline: Partial<UnderlineOptions> | false;
181
+ }
182
+
8
183
  type FieldOption = {
9
184
  label: string;
10
185
  value: string | number | boolean | undefined | null | object;
11
186
  };
12
187
  type FieldOptions = Array<FieldOption> | ReadonlyArray<FieldOption>;
13
- type BaseField = {
188
+ interface BaseField {
14
189
  label?: string;
15
190
  labelIcon?: ReactElement;
16
- metadata?: Metadata;
191
+ metadata?: FieldMetadata;
17
192
  visible?: boolean;
18
- };
19
- type TextField = BaseField & {
193
+ }
194
+ interface TextField extends BaseField {
20
195
  type: "text";
21
196
  placeholder?: string;
22
197
  contentEditable?: boolean;
23
- };
24
- type NumberField = BaseField & {
198
+ }
199
+ interface NumberField extends BaseField {
25
200
  type: "number";
26
201
  placeholder?: string;
27
202
  min?: number;
28
203
  max?: number;
29
204
  step?: number;
30
- };
31
- type TextareaField = BaseField & {
205
+ }
206
+ interface TextareaField extends BaseField {
32
207
  type: "textarea";
33
208
  placeholder?: string;
34
209
  contentEditable?: boolean;
35
- };
36
- type SelectField = BaseField & {
210
+ }
211
+ interface SelectField extends BaseField {
37
212
  type: "select";
38
213
  options: FieldOptions;
39
- };
40
- type RadioField = BaseField & {
214
+ }
215
+ interface RadioField extends BaseField {
41
216
  type: "radio";
42
217
  options: FieldOptions;
43
- };
44
- type ArrayField<Props extends {
218
+ }
219
+ interface RichtextField<UserSelector extends RichTextSelector = RichTextSelector> extends BaseField {
220
+ type: "richtext";
221
+ contentEditable?: boolean;
222
+ initialHeight?: CSSProperties["height"];
223
+ options?: Partial<PuckRichTextOptions>;
224
+ renderMenu?: (props: {
225
+ children: ReactNode;
226
+ editor: Editor | null;
227
+ editorState: EditorState<UserSelector> | null;
228
+ readOnly: boolean;
229
+ }) => ReactNode;
230
+ renderInlineMenu?: (props: {
231
+ children: ReactNode;
232
+ editor: Editor | null;
233
+ editorState: EditorState<UserSelector> | null;
234
+ readOnly: boolean;
235
+ }) => ReactNode;
236
+ tiptap?: {
237
+ selector?: UserSelector;
238
+ extensions?: Extensions;
239
+ };
240
+ }
241
+ interface ArrayField<Props extends {
45
242
  [key: string]: any;
46
243
  }[] = {
47
244
  [key: string]: any;
48
- }[], UserField extends {} = {}> = BaseField & {
245
+ }[], UserField extends {} = {}> extends BaseField {
49
246
  type: "array";
50
247
  arrayFields: {
51
248
  [SubPropName in keyof Props[0]]: UserField extends {
52
249
  type: PropertyKey;
53
250
  } ? Field<Props[0][SubPropName], UserField> | UserField : Field<Props[0][SubPropName], UserField>;
54
251
  };
55
- defaultItemProps?: Props[0];
56
- getItemSummary?: (item: Props[0], index?: number) => string;
252
+ defaultItemProps?: Props[0] | ((index: number) => Props[0]);
253
+ getItemSummary?: (item: Props[0], index?: number) => ReactNode;
57
254
  max?: number;
58
255
  min?: number;
59
- };
60
- type ObjectField<Props extends any = {
256
+ }
257
+ interface ObjectField<Props extends any = {
61
258
  [key: string]: any;
62
- }, UserField extends {} = {}> = BaseField & {
259
+ }, UserField extends {} = {}> extends BaseField {
63
260
  type: "object";
64
261
  objectFields: {
65
262
  [SubPropName in keyof Props]: UserField extends {
66
263
  type: PropertyKey;
67
264
  } ? Field<Props[SubPropName]> | UserField : Field<Props[SubPropName]>;
68
265
  };
69
- };
266
+ }
70
267
  type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
71
268
  name: string;
72
269
  fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
@@ -80,12 +277,16 @@ type ExternalFieldWithAdaptor<Props extends any = {
80
277
  placeholder?: string;
81
278
  adaptor: Adaptor<any, any, Props>;
82
279
  adaptorParams?: object;
83
- getItemSummary: (item: NotUndefined<Props>, index?: number) => string;
280
+ getItemSummary: (item: NotUndefined<Props>, index?: number) => ReactNode;
281
+ };
282
+ type CacheOpts = {
283
+ enabled?: boolean;
84
284
  };
85
- type ExternalField<Props extends any = {
285
+ interface ExternalField<Props extends any = {
86
286
  [key: string]: any;
87
- }> = BaseField & {
287
+ }> extends BaseField {
88
288
  type: "external";
289
+ cache?: CacheOpts;
89
290
  placeholder?: string;
90
291
  fetchList: (params: {
91
292
  query: string;
@@ -93,7 +294,7 @@ type ExternalField<Props extends any = {
93
294
  }) => Promise<any[] | null>;
94
295
  mapProp?: (value: any) => Props;
95
296
  mapRow?: (value: any) => Record<string, string | number | ReactElement>;
96
- getItemSummary?: (item: NotUndefined<Props>, index?: number) => string;
297
+ getItemSummary?: (item: NotUndefined<Props>, index?: number) => ReactNode;
97
298
  showSearch?: boolean;
98
299
  renderFooter?: (props: {
99
300
  items: any[];
@@ -101,7 +302,7 @@ type ExternalField<Props extends any = {
101
302
  initialQuery?: string;
102
303
  filterFields?: Record<string, Field>;
103
304
  initialFilters?: Record<string, any>;
104
- };
305
+ }
105
306
  type CustomFieldRender<Value extends any> = (props: {
106
307
  field: CustomField<Value>;
107
308
  name: string;
@@ -110,17 +311,18 @@ type CustomFieldRender<Value extends any> = (props: {
110
311
  onChange: (value: Value) => void;
111
312
  readOnly?: boolean;
112
313
  }) => ReactElement;
113
- type CustomField<Value extends any> = BaseField & {
314
+ interface CustomField<Value extends any> extends BaseField {
114
315
  type: "custom";
115
316
  render: CustomFieldRender<Value>;
116
317
  contentEditable?: boolean;
117
- };
118
- type SlotField = BaseField & {
318
+ key?: string;
319
+ }
320
+ interface SlotField extends BaseField {
119
321
  type: "slot";
120
322
  allow?: string[];
121
323
  disallow?: string[];
122
- };
123
- type Field<ValueType = any, UserField extends {} = {}> = TextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<ValueType extends {
324
+ }
325
+ type Field<ValueType = any, UserField extends {} = {}> = TextField | RichtextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<ValueType extends {
124
326
  [key: string]: any;
125
327
  }[] ? ValueType : never, UserField> | ObjectField<ValueType, UserField> | ExternalField<ValueType> | ExternalFieldWithAdaptor<ValueType> | CustomField<ValueType> | SlotField;
126
328
  type Fields<ComponentProps extends DefaultComponentProps = DefaultComponentProps, UserField extends {} = {}> = {
@@ -141,13 +343,15 @@ type DropZoneProps = {
141
343
  allow?: string[];
142
344
  disallow?: string[];
143
345
  style?: CSSProperties;
144
- minEmptyHeight?: number;
346
+ minEmptyHeight?: CSSProperties["minHeight"] | number;
145
347
  className?: string;
146
348
  collisionAxis?: DragAxis;
349
+ as?: ElementType;
350
+ ref?: Ref<any>;
147
351
  };
148
352
 
149
353
  type PuckContext = {
150
- renderDropZone: React.FC<DropZoneProps>;
354
+ renderDropZone: (props: DropZoneProps) => React.ReactNode;
151
355
  metadata: Metadata;
152
356
  isEditing: boolean;
153
357
  dragRef: ((element: Element | null) => void) | null;
@@ -193,10 +397,12 @@ type SlotComponent = (props?: Omit<DropZoneProps, "zone">) => ReactNode;
193
397
  type PuckComponent<Props> = (props: WithId<WithPuckProps<{
194
398
  [K in keyof Props]: WithDeepSlots<Props[K], SlotComponent>;
195
399
  }>>) => JSX.Element;
196
- type ResolveDataTrigger = "insert" | "replace" | "load" | "force";
400
+ type ResolveDataTrigger = "insert" | "replace" | "load" | "force" | "move";
197
401
  type WithPartialProps<T, Props extends DefaultComponentProps> = Omit<T, "props"> & {
198
402
  props?: Partial<Props>;
199
403
  };
404
+ interface ComponentConfigExtensions {
405
+ }
200
406
  type ComponentConfigInternal<RenderProps extends DefaultComponentProps, FieldProps extends DefaultComponentProps, DataShape = Omit<ComponentData<FieldProps>, "type">, // NB this doesn't include AllProps, so types will not contain deep slot types. To fix, we require a breaking change.
201
407
  UserField extends BaseField = {}> = {
202
408
  render: PuckComponent<RenderProps>;
@@ -212,7 +418,7 @@ UserField extends BaseField = {}> = {
212
418
  fields: Fields<FieldProps>;
213
419
  lastFields: Fields<FieldProps>;
214
420
  lastData: DataShape | null;
215
- metadata: Metadata;
421
+ metadata: ComponentMetadata;
216
422
  appState: AppState;
217
423
  parent: ComponentData | null;
218
424
  }) => Promise<Fields<FieldProps>> | Fields<FieldProps>;
@@ -221,8 +427,9 @@ UserField extends BaseField = {}> = {
221
427
  id: string;
222
428
  }>;
223
429
  lastData: DataShape | null;
224
- metadata: Metadata;
430
+ metadata: ComponentMetadata;
225
431
  trigger: ResolveDataTrigger;
432
+ parent: ComponentData | null;
226
433
  }) => Promise<WithPartialProps<DataShape, FieldProps>> | WithPartialProps<DataShape, FieldProps>;
227
434
  resolvePermissions?: (data: DataShape, params: {
228
435
  changed: Partial<Record<keyof FieldProps, boolean> & {
@@ -232,9 +439,10 @@ UserField extends BaseField = {}> = {
232
439
  permissions: Partial<Permissions>;
233
440
  appState: AppState;
234
441
  lastData: DataShape | null;
442
+ parent: ComponentData | null;
235
443
  }) => Promise<Partial<Permissions>> | Partial<Permissions>;
236
- metadata?: Metadata;
237
- };
444
+ metadata?: ComponentMetadata;
445
+ } & ComponentConfigExtensions;
238
446
  type ComponentConfig<RenderPropsOrParams extends LeftOrExactRight<RenderPropsOrParams, DefaultComponentProps, ComponentConfigParams> = DefaultComponentProps, FieldProps extends DefaultComponentProps = RenderPropsOrParams extends {
239
447
  props: any;
240
448
  } ? RenderPropsOrParams["props"] : RenderPropsOrParams, DataShape = Omit<ComponentData<FieldProps>, "type">> = RenderPropsOrParams extends ComponentConfigParams<infer ParamsRenderProps, never> ? ComponentConfigInternal<ParamsRenderProps, FieldProps, DataShape, {}> : RenderPropsOrParams extends ComponentConfigParams<infer ParamsRenderProps, infer ParamsFields> ? ComponentConfigInternal<ParamsRenderProps, FieldProps, DataShape, ParamsFields[keyof ParamsFields] & BaseField> : ComponentConfigInternal<RenderPropsOrParams, FieldProps, DataShape>;
@@ -265,6 +473,16 @@ type ExtractConfigParams<UserConfig extends ConfigInternal> = UserConfig extends
265
473
  type: string;
266
474
  } ? UserField : Field;
267
475
  } : never;
476
+ type ConfigParams<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = any, CategoryNames extends string[] = string[], UserFields extends FieldsExtension = FieldsExtension> = {
477
+ components?: Components;
478
+ root?: RootProps;
479
+ categories?: CategoryNames;
480
+ fields?: AssertHasValue<UserFields>;
481
+ };
482
+ type ComponentConfigParams<Props extends DefaultComponentProps = DefaultComponentProps, UserFields extends FieldsExtension = never> = {
483
+ props: Props;
484
+ fields?: AssertHasValue<UserFields>;
485
+ };
268
486
 
269
487
  type BaseData<Props extends {
270
488
  [key: string]: any;
@@ -305,10 +523,17 @@ type Data<Components extends DefaultComponents = DefaultComponents, RootProps ex
305
523
  type Metadata = {
306
524
  [key: string]: any;
307
525
  };
526
+ interface PuckMetadata extends Metadata {
527
+ }
528
+ interface ComponentMetadata extends PuckMetadata {
529
+ }
530
+ interface FieldMetadata extends Metadata {
531
+ }
308
532
 
309
533
  type ItemWithId = {
310
534
  _arrayId: string;
311
535
  _originalIndex: number;
536
+ _currentIndex: number;
312
537
  };
313
538
  type ArrayState = {
314
539
  items: ItemWithId[];
@@ -319,6 +544,7 @@ type UiState = {
319
544
  rightSideBarVisible: boolean;
320
545
  leftSideBarWidth?: number | null;
321
546
  rightSideBarWidth?: number | null;
547
+ mobilePanelExpanded?: boolean;
322
548
  itemSelector: ItemSelector | null;
323
549
  arrayState: Record<string, ArrayState | undefined>;
324
550
  previewMode: "interactive" | "edit";
@@ -331,7 +557,7 @@ type UiState = {
331
557
  isDragging: boolean;
332
558
  viewports: {
333
559
  current: {
334
- width: number;
560
+ width: number | "100%";
335
561
  height: number | "auto";
336
562
  };
337
563
  controlsVisible: boolean;
@@ -339,6 +565,10 @@ type UiState = {
339
565
  };
340
566
  field: {
341
567
  focus?: string | null;
568
+ metadata?: Record<string, any>;
569
+ };
570
+ plugin: {
571
+ current: string | null;
342
572
  };
343
573
  };
344
574
  type AppState<UserData extends Data = Data> = {
@@ -373,26 +603,25 @@ type BuiltinTypes = Date | RegExp | Error | Function | symbol | null | undefined
373
603
  type WithDeepSlots<T, SlotType = T> = T extends Slot ? SlotType : T extends (infer U)[] ? Array<WithDeepSlots<U, SlotType>> : T extends (infer U)[] ? WithDeepSlots<U, SlotType>[] : T extends BuiltinTypes ? T : T extends object ? {
374
604
  [K in keyof T]: WithDeepSlots<T[K], SlotType>;
375
605
  } : T;
376
- type ConfigParams<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = any, CategoryNames extends string[] = string[], UserFields extends FieldsExtension = FieldsExtension> = {
377
- components?: Components;
378
- root?: RootProps;
379
- categories?: CategoryNames;
380
- fields?: AssertHasValue<UserFields>;
381
- };
382
606
  type FieldsExtension = {
383
607
  [Type in string]: {
384
608
  type: Type;
385
609
  };
386
610
  };
387
- type ComponentConfigParams<Props extends DefaultComponentProps = DefaultComponentProps, UserFields extends FieldsExtension = never> = {
388
- props: Props;
389
- fields?: AssertHasValue<UserFields>;
390
- };
391
611
  type Exact<T, Target> = Record<Exclude<keyof T, keyof Target>, never>;
392
612
  type LeftOrExactRight<Union, Left, Right> = (Left & Union extends Right ? Exact<Union, Right> : Left) | (Right & Exact<Union, Right>);
393
613
  type AssertHasValue<T, True = T, False = never> = [keyof T] extends [
394
614
  never
395
615
  ] ? False : True;
616
+ type RenderFunc<Props extends {
617
+ [key: string]: any;
618
+ } = {
619
+ children: ReactNode;
620
+ }> = (props: Props) => ReactElement;
621
+ type PluginInternal = Plugin & {
622
+ mobileOnly?: boolean;
623
+ desktopOnly?: boolean;
624
+ };
396
625
 
397
626
  type MapFnParams<ThisField = Field> = {
398
627
  value: any;
@@ -416,11 +645,6 @@ G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>, UserField extends
416
645
  [Type in UserField["type"]]: FieldTransformFn<ExtractField<UserField, Type>>;
417
646
  }>;
418
647
 
419
- type RenderFunc<Props extends {
420
- [key: string]: any;
421
- } = {
422
- children: ReactNode;
423
- }> = (props: Props) => ReactElement;
424
648
  declare const overrideKeys: readonly ["header", "headerActions", "fields", "fieldLabel", "drawer", "drawerItem", "componentOverlay", "outline", "puck", "preview"];
425
649
  type OverrideKey = (typeof overrideKeys)[number];
426
650
  type OverridesGeneric<Shape extends {
@@ -492,7 +716,7 @@ type DragAxis = "dynamic" | "y" | "x";
492
716
 
493
717
  type iconTypes = "Smartphone" | "Monitor" | "Tablet";
494
718
  type Viewport = {
495
- width: number;
719
+ width: number | "100%";
496
720
  height?: number | "auto";
497
721
  label?: string;
498
722
  icon?: iconTypes | ReactNode;
@@ -512,8 +736,13 @@ type IframeConfig = {
512
736
  };
513
737
  type OnAction<UserData extends Data = Data> = (action: PuckAction, appState: AppState<UserData>, prevAppState: AppState<UserData>) => void;
514
738
  type Plugin<UserConfig extends Config = Config> = {
739
+ name?: string;
740
+ label?: string;
741
+ icon?: ReactNode;
742
+ render?: () => ReactElement;
515
743
  overrides?: Partial<Overrides<UserConfig>>;
516
744
  fieldTransforms?: FieldTransforms<UserConfig>;
745
+ mobilePanelHeight?: "toggle" | "min-content";
517
746
  };
518
747
  type History<D = any> = {
519
748
  state: D;
@@ -538,6 +767,7 @@ type Slot<Props extends {
538
767
  [K in keyof Props]: ComponentDataOptionalId<Props[K], K extends string ? K : never>;
539
768
  }[keyof Props][];
540
769
  type WithSlotProps<Target extends Record<string, any>, Components extends DefaultComponents = DefaultComponents, SlotType extends Content<Components> = Content<Components>> = WithDeepSlots<Target, SlotType>;
770
+ type RichText = string | ReactNode;
541
771
 
542
772
  type InsertAction = {
543
773
  type: "insert";
@@ -605,30 +835,4 @@ type PuckAction = {
605
835
  recordHistory?: boolean;
606
836
  } & (ReorderAction | InsertAction | MoveAction | ReplaceAction | ReplaceRootAction | RemoveAction | DuplicateAction | SetAction | SetDataAction | SetUiAction | RegisterZoneAction | UnregisterZoneAction);
607
837
 
608
- type MigrationOptions<UserConfig extends Config> = {
609
- migrateDynamicZonesForComponent?: {
610
- [ComponentName in keyof UserConfig["components"]]: (props: WithId<UserGenerics<UserConfig>["UserProps"][ComponentName]>, zones: Record<string, Content>) => ComponentData["props"];
611
- };
612
- };
613
- declare function migrate<UserConfig extends Config = Config>(data: Data, config?: UserConfig, migrationOptions?: MigrationOptions<UserConfig>): Data;
614
-
615
- type PropTransform<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = DefaultRootFieldProps> = Partial<{
616
- [ComponentName in keyof Components]: (props: Components[ComponentName] & {
617
- [key: string]: any;
618
- }) => Components[ComponentName];
619
- } & {
620
- root: (props: RootProps & {
621
- [key: string]: any;
622
- }) => RootProps;
623
- }>;
624
- declare function transformProps<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = DefaultRootFieldProps>(data: Partial<Data>, propTransforms: PropTransform<Components, RootProps>, config?: Config): Data;
625
-
626
- declare function resolveAllData<Components extends DefaultComponents = DefaultComponents, RootProps extends Record<string, any> = DefaultRootFieldProps>(data: Partial<Data>, config: Config, metadata?: Metadata, onResolveStart?: (item: ComponentData) => void, onResolveEnd?: (item: ComponentData) => void): Promise<Data<Components, RootProps>>;
627
-
628
- type WalkTreeOptions = {
629
- parentId: string;
630
- propName: string;
631
- };
632
- declare function walkTree<T extends ComponentData | RootData | G["UserData"], UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(data: T, config: UserConfig, callbackFn: (data: Content, options: WalkTreeOptions) => Content | null | void): T;
633
-
634
- export { type BaseField as $, type AppState as A, type ArrayState as B, type Config as C, type DropZoneProps as D, type SlotComponent as E, type Fields as F, type PuckComponent as G, type History as H, type IframeConfig as I, type RootConfig as J, type DefaultComponents as K, type ExtractConfigParams as L, type Metadata as M, type BaseData as N, type Overrides as O, type Permissions as P, type RootDataWithoutProps as Q, type RootDataWithProps as R, type Slot as S, type RootData as T, type UserGenerics as U, type Viewports as V, type WithSlotProps as W, type ComponentDataOptionalId as X, type MappedItem as Y, type ComponentDataMap as Z, type Content as _, type ComponentData as a, type TextField as a0, type NumberField as a1, type TextareaField as a2, type SelectField as a3, type RadioField as a4, type ArrayField as a5, type ObjectField as a6, type Adaptor as a7, type ExternalFieldWithAdaptor as a8, type ExternalField as a9, type CustomFieldRender as aa, type CustomField as ab, type SlotField as ac, type PuckContext as ad, type DefaultRootFieldProps as ae, type DefaultRootRenderProps as af, type DefaultRootProps as ag, type DefaultComponentProps as ah, type WithId as ai, type WithPuckProps as aj, type AsFieldProps as ak, type WithChildren as al, type ExtractField as am, type PuckAction as b, type ResolveDataTrigger as c, type Plugin as d, type UiState as e, type ComponentConfig as f, type FieldTransforms as g, type Field as h, type FieldProps as i, type Data as j, type OnAction as k, type InitialHistory as l, migrate as m, type ItemSelector as n, type Direction as o, type DragAxis as p, type Viewport as q, resolveAllData as r, type FieldTransformFnParams as s, transformProps as t, type FieldTransformFn as u, overrideKeys as v, walkTree as w, type OverrideKey as x, type FieldRenderFunctions as y, type ItemWithId as z };
838
+ export { type ComponentConfigParams as $, type AppState as A, type FieldTransformFnParams as B, type Config as C, type Data as D, type FieldTransformFn as E, type Fields as F, overrideKeys as G, type History as H, type IframeConfig as I, type OverrideKey as J, type FieldRenderFunctions as K, type ItemWithId as L, type Metadata as M, type ArrayState as N, type OnAction as O, type PrivateAppState as P, type SlotComponent as Q, type RootData as R, type Slot as S, type PuckComponent as T, type UserGenerics as U, type Viewports as V, type WithId as W, type ComponentConfigExtensions as X, type RootConfig as Y, type ExtractConfigParams as Z, type ConfigParams as _, type PuckAction as a, type BaseData as a0, type RootDataWithoutProps as a1, type ComponentDataOptionalId as a2, type MappedItem as a3, type ComponentDataMap as a4, type PuckMetadata as a5, type ComponentMetadata as a6, type FieldMetadata as a7, type BaseField as a8, type TextField as a9, type NumberField as aa, type TextareaField as ab, type SelectField as ac, type RadioField as ad, type ArrayField as ae, type ObjectField as af, type Adaptor as ag, type ExternalFieldWithAdaptor as ah, type CacheOpts as ai, type ExternalField as aj, type CustomFieldRender as ak, type CustomField as al, type SlotField as am, type PuckContext as an, type DefaultRootRenderProps as ao, type DefaultRootProps as ap, type WithPuckProps as aq, type AsFieldProps as ar, type WithChildren as as, type ExtractField as at, type Content as b, type ComponentData as c, type DefaultComponents as d, type DefaultComponentProps as e, type DefaultRootFieldProps as f, type Permissions as g, type RootDataWithProps as h, type ResolveDataTrigger as i, type Plugin as j, type Overrides as k, type UiState as l, type ComponentConfig as m, type FieldTransforms as n, type RichtextField as o, type Field as p, type FieldProps as q, type DropZoneProps as r, type InitialHistory as s, type ItemSelector as t, type PluginInternal as u, type WithSlotProps as v, type RichText as w, type Direction as x, type DragAxis as y, type Viewport as z };