@measured/puck 0.21.0-canary.74d9a160 → 0.21.0-canary.8416d520

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.
@@ -10,63 +10,63 @@ type FieldOption = {
10
10
  value: string | number | boolean | undefined | null | object;
11
11
  };
12
12
  type FieldOptions = Array<FieldOption> | ReadonlyArray<FieldOption>;
13
- type BaseField = {
13
+ interface BaseField {
14
14
  label?: string;
15
15
  labelIcon?: ReactElement;
16
- metadata?: Metadata;
16
+ metadata?: FieldMetadata;
17
17
  visible?: boolean;
18
- };
19
- type TextField = BaseField & {
18
+ }
19
+ interface TextField extends BaseField {
20
20
  type: "text";
21
21
  placeholder?: string;
22
22
  contentEditable?: boolean;
23
- };
24
- type NumberField = BaseField & {
23
+ }
24
+ interface NumberField extends BaseField {
25
25
  type: "number";
26
26
  placeholder?: string;
27
27
  min?: number;
28
28
  max?: number;
29
29
  step?: number;
30
- };
31
- type TextareaField = BaseField & {
30
+ }
31
+ interface TextareaField extends BaseField {
32
32
  type: "textarea";
33
33
  placeholder?: string;
34
34
  contentEditable?: boolean;
35
- };
36
- type SelectField = BaseField & {
35
+ }
36
+ interface SelectField extends BaseField {
37
37
  type: "select";
38
38
  options: FieldOptions;
39
- };
40
- type RadioField = BaseField & {
39
+ }
40
+ interface RadioField extends BaseField {
41
41
  type: "radio";
42
42
  options: FieldOptions;
43
- };
44
- type ArrayField<Props extends {
43
+ }
44
+ interface ArrayField<Props extends {
45
45
  [key: string]: any;
46
46
  }[] = {
47
47
  [key: string]: any;
48
- }[], UserField extends {} = {}> = BaseField & {
48
+ }[], UserField extends {} = {}> extends BaseField {
49
49
  type: "array";
50
50
  arrayFields: {
51
51
  [SubPropName in keyof Props[0]]: UserField extends {
52
52
  type: PropertyKey;
53
53
  } ? Field<Props[0][SubPropName], UserField> | UserField : Field<Props[0][SubPropName], UserField>;
54
54
  };
55
- defaultItemProps?: Props[0];
55
+ defaultItemProps?: Props[0] | ((index: number) => Props[0]);
56
56
  getItemSummary?: (item: Props[0], index?: number) => string;
57
57
  max?: number;
58
58
  min?: number;
59
- };
60
- type ObjectField<Props extends any = {
59
+ }
60
+ interface ObjectField<Props extends any = {
61
61
  [key: string]: any;
62
- }, UserField extends {} = {}> = BaseField & {
62
+ }, UserField extends {} = {}> extends BaseField {
63
63
  type: "object";
64
64
  objectFields: {
65
65
  [SubPropName in keyof Props]: UserField extends {
66
66
  type: PropertyKey;
67
67
  } ? Field<Props[SubPropName]> | UserField : Field<Props[SubPropName]>;
68
68
  };
69
- };
69
+ }
70
70
  type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
71
71
  name: string;
72
72
  fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
@@ -85,9 +85,9 @@ type ExternalFieldWithAdaptor<Props extends any = {
85
85
  type CacheOpts = {
86
86
  enabled?: boolean;
87
87
  };
88
- type ExternalField<Props extends any = {
88
+ interface ExternalField<Props extends any = {
89
89
  [key: string]: any;
90
- }> = BaseField & {
90
+ }> extends BaseField {
91
91
  type: "external";
92
92
  cache?: CacheOpts;
93
93
  placeholder?: string;
@@ -105,7 +105,7 @@ type ExternalField<Props extends any = {
105
105
  initialQuery?: string;
106
106
  filterFields?: Record<string, Field>;
107
107
  initialFilters?: Record<string, any>;
108
- };
108
+ }
109
109
  type CustomFieldRender<Value extends any> = (props: {
110
110
  field: CustomField<Value>;
111
111
  name: string;
@@ -114,16 +114,17 @@ type CustomFieldRender<Value extends any> = (props: {
114
114
  onChange: (value: Value) => void;
115
115
  readOnly?: boolean;
116
116
  }) => ReactElement;
117
- type CustomField<Value extends any> = BaseField & {
117
+ interface CustomField<Value extends any> extends BaseField {
118
118
  type: "custom";
119
119
  render: CustomFieldRender<Value>;
120
120
  contentEditable?: boolean;
121
- };
122
- type SlotField = BaseField & {
121
+ key?: string;
122
+ }
123
+ interface SlotField extends BaseField {
123
124
  type: "slot";
124
125
  allow?: string[];
125
126
  disallow?: string[];
126
- };
127
+ }
127
128
  type Field<ValueType = any, UserField extends {} = {}> = TextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<ValueType extends {
128
129
  [key: string]: any;
129
130
  }[] ? ValueType : never, UserField> | ObjectField<ValueType, UserField> | ExternalField<ValueType> | ExternalFieldWithAdaptor<ValueType> | CustomField<ValueType> | SlotField;
@@ -151,7 +152,7 @@ type DropZoneProps = {
151
152
  };
152
153
 
153
154
  type PuckContext = {
154
- renderDropZone: React.FC<DropZoneProps>;
155
+ renderDropZone: (props: DropZoneProps) => React.ReactNode;
155
156
  metadata: Metadata;
156
157
  isEditing: boolean;
157
158
  dragRef: ((element: Element | null) => void) | null;
@@ -201,6 +202,8 @@ type ResolveDataTrigger = "insert" | "replace" | "load" | "force";
201
202
  type WithPartialProps<T, Props extends DefaultComponentProps> = Omit<T, "props"> & {
202
203
  props?: Partial<Props>;
203
204
  };
205
+ interface ComponentConfigExtensions {
206
+ }
204
207
  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.
205
208
  UserField extends BaseField = {}> = {
206
209
  render: PuckComponent<RenderProps>;
@@ -216,7 +219,7 @@ UserField extends BaseField = {}> = {
216
219
  fields: Fields<FieldProps>;
217
220
  lastFields: Fields<FieldProps>;
218
221
  lastData: DataShape | null;
219
- metadata: Metadata;
222
+ metadata: ComponentMetadata;
220
223
  appState: AppState;
221
224
  parent: ComponentData | null;
222
225
  }) => Promise<Fields<FieldProps>> | Fields<FieldProps>;
@@ -225,7 +228,7 @@ UserField extends BaseField = {}> = {
225
228
  id: string;
226
229
  }>;
227
230
  lastData: DataShape | null;
228
- metadata: Metadata;
231
+ metadata: ComponentMetadata;
229
232
  trigger: ResolveDataTrigger;
230
233
  }) => Promise<WithPartialProps<DataShape, FieldProps>> | WithPartialProps<DataShape, FieldProps>;
231
234
  resolvePermissions?: (data: DataShape, params: {
@@ -237,8 +240,8 @@ UserField extends BaseField = {}> = {
237
240
  appState: AppState;
238
241
  lastData: DataShape | null;
239
242
  }) => Promise<Partial<Permissions>> | Partial<Permissions>;
240
- metadata?: Metadata;
241
- };
243
+ metadata?: ComponentMetadata;
244
+ } & ComponentConfigExtensions;
242
245
  type ComponentConfig<RenderPropsOrParams extends LeftOrExactRight<RenderPropsOrParams, DefaultComponentProps, ComponentConfigParams> = DefaultComponentProps, FieldProps extends DefaultComponentProps = RenderPropsOrParams extends {
243
246
  props: any;
244
247
  } ? 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>;
@@ -269,6 +272,16 @@ type ExtractConfigParams<UserConfig extends ConfigInternal> = UserConfig extends
269
272
  type: string;
270
273
  } ? UserField : Field;
271
274
  } : never;
275
+ type ConfigParams<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = any, CategoryNames extends string[] = string[], UserFields extends FieldsExtension = FieldsExtension> = {
276
+ components?: Components;
277
+ root?: RootProps;
278
+ categories?: CategoryNames;
279
+ fields?: AssertHasValue<UserFields>;
280
+ };
281
+ type ComponentConfigParams<Props extends DefaultComponentProps = DefaultComponentProps, UserFields extends FieldsExtension = never> = {
282
+ props: Props;
283
+ fields?: AssertHasValue<UserFields>;
284
+ };
272
285
 
273
286
  type BaseData<Props extends {
274
287
  [key: string]: any;
@@ -309,10 +322,17 @@ type Data<Components extends DefaultComponents = DefaultComponents, RootProps ex
309
322
  type Metadata = {
310
323
  [key: string]: any;
311
324
  };
325
+ interface PuckMetadata extends Metadata {
326
+ }
327
+ interface ComponentMetadata extends PuckMetadata {
328
+ }
329
+ interface FieldMetadata extends Metadata {
330
+ }
312
331
 
313
332
  type ItemWithId = {
314
333
  _arrayId: string;
315
334
  _originalIndex: number;
335
+ _currentIndex: number;
316
336
  };
317
337
  type ArrayState = {
318
338
  items: ItemWithId[];
@@ -323,6 +343,7 @@ type UiState = {
323
343
  rightSideBarVisible: boolean;
324
344
  leftSideBarWidth?: number | null;
325
345
  rightSideBarWidth?: number | null;
346
+ mobilePanelExpanded?: boolean;
326
347
  itemSelector: ItemSelector | null;
327
348
  arrayState: Record<string, ArrayState | undefined>;
328
349
  previewMode: "interactive" | "edit";
@@ -335,7 +356,7 @@ type UiState = {
335
356
  isDragging: boolean;
336
357
  viewports: {
337
358
  current: {
338
- width: number;
359
+ width: number | "100%";
339
360
  height: number | "auto";
340
361
  };
341
362
  controlsVisible: boolean;
@@ -344,6 +365,9 @@ type UiState = {
344
365
  field: {
345
366
  focus?: string | null;
346
367
  };
368
+ plugin: {
369
+ current: string | null;
370
+ };
347
371
  };
348
372
  type AppState<UserData extends Data = Data> = {
349
373
  data: UserData;
@@ -377,26 +401,24 @@ type BuiltinTypes = Date | RegExp | Error | Function | symbol | null | undefined
377
401
  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 ? {
378
402
  [K in keyof T]: WithDeepSlots<T[K], SlotType>;
379
403
  } : T;
380
- type ConfigParams<Components extends DefaultComponents = DefaultComponents, RootProps extends DefaultComponentProps = any, CategoryNames extends string[] = string[], UserFields extends FieldsExtension = FieldsExtension> = {
381
- components?: Components;
382
- root?: RootProps;
383
- categories?: CategoryNames;
384
- fields?: AssertHasValue<UserFields>;
385
- };
386
404
  type FieldsExtension = {
387
405
  [Type in string]: {
388
406
  type: Type;
389
407
  };
390
408
  };
391
- type ComponentConfigParams<Props extends DefaultComponentProps = DefaultComponentProps, UserFields extends FieldsExtension = never> = {
392
- props: Props;
393
- fields?: AssertHasValue<UserFields>;
394
- };
395
409
  type Exact<T, Target> = Record<Exclude<keyof T, keyof Target>, never>;
396
410
  type LeftOrExactRight<Union, Left, Right> = (Left & Union extends Right ? Exact<Union, Right> : Left) | (Right & Exact<Union, Right>);
397
411
  type AssertHasValue<T, True = T, False = never> = [keyof T] extends [
398
412
  never
399
413
  ] ? False : True;
414
+ type RenderFunc<Props extends {
415
+ [key: string]: any;
416
+ } = {
417
+ children: ReactNode;
418
+ }> = (props: Props) => ReactElement;
419
+ type PluginInternal = Plugin & {
420
+ mobileOnly?: boolean;
421
+ };
400
422
 
401
423
  type MapFnParams<ThisField = Field> = {
402
424
  value: any;
@@ -420,11 +442,6 @@ G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>, UserField extends
420
442
  [Type in UserField["type"]]: FieldTransformFn<ExtractField<UserField, Type>>;
421
443
  }>;
422
444
 
423
- type RenderFunc<Props extends {
424
- [key: string]: any;
425
- } = {
426
- children: ReactNode;
427
- }> = (props: Props) => ReactElement;
428
445
  declare const overrideKeys: readonly ["header", "headerActions", "fields", "fieldLabel", "drawer", "drawerItem", "componentOverlay", "outline", "puck", "preview"];
429
446
  type OverrideKey = (typeof overrideKeys)[number];
430
447
  type OverridesGeneric<Shape extends {
@@ -496,7 +513,7 @@ type DragAxis = "dynamic" | "y" | "x";
496
513
 
497
514
  type iconTypes = "Smartphone" | "Monitor" | "Tablet";
498
515
  type Viewport = {
499
- width: number;
516
+ width: number | "100%";
500
517
  height?: number | "auto";
501
518
  label?: string;
502
519
  icon?: iconTypes | ReactNode;
@@ -516,8 +533,13 @@ type IframeConfig = {
516
533
  };
517
534
  type OnAction<UserData extends Data = Data> = (action: PuckAction, appState: AppState<UserData>, prevAppState: AppState<UserData>) => void;
518
535
  type Plugin<UserConfig extends Config = Config> = {
536
+ name?: string;
537
+ label?: string;
538
+ icon?: ReactNode;
539
+ render?: () => ReactElement;
519
540
  overrides?: Partial<Overrides<UserConfig>>;
520
541
  fieldTransforms?: FieldTransforms<UserConfig>;
542
+ mobilePanelHeight?: "toggle" | "min-content";
521
543
  };
522
544
  type History<D = any> = {
523
545
  state: D;
@@ -635,4 +657,4 @@ type WalkTreeOptions = {
635
657
  };
636
658
  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;
637
659
 
638
- 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 CacheOpts as a9, type ExternalField as aa, type CustomFieldRender as ab, type CustomField as ac, type SlotField as ad, type PuckContext as ae, type DefaultRootFieldProps as af, type DefaultRootRenderProps as ag, type DefaultRootProps as ah, type DefaultComponentProps as ai, type WithId as aj, type WithPuckProps as ak, type AsFieldProps as al, type WithChildren as am, type ExtractField as an, 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 };
660
+ export { type ComponentDataOptionalId as $, type AppState as A, type ItemWithId as B, type Config as C, type DropZoneProps as D, type ArrayState as E, type Fields as F, type SlotComponent as G, type History as H, type IframeConfig as I, type PuckComponent as J, type ComponentConfigExtensions as K, type RootConfig as L, type Metadata as M, type DefaultComponents as N, type Overrides as O, type Permissions as P, type ExtractConfigParams as Q, type RootDataWithProps as R, type Slot as S, type ConfigParams as T, type UserGenerics as U, type Viewports as V, type WithSlotProps as W, type ComponentConfigParams as X, type BaseData as Y, type RootDataWithoutProps as Z, type RootData as _, type ComponentData as a, type MappedItem as a0, type ComponentDataMap as a1, type Content as a2, type PuckMetadata as a3, type ComponentMetadata as a4, type FieldMetadata as a5, type BaseField as a6, type TextField as a7, type NumberField as a8, type TextareaField as a9, type SelectField as aa, type RadioField as ab, type ArrayField as ac, type ObjectField as ad, type Adaptor as ae, type ExternalFieldWithAdaptor as af, type CacheOpts as ag, type ExternalField as ah, type CustomFieldRender as ai, type CustomField as aj, type SlotField as ak, type PuckContext as al, type DefaultRootFieldProps as am, type DefaultRootRenderProps as an, type DefaultRootProps as ao, type DefaultComponentProps as ap, type WithId as aq, type WithPuckProps as ar, type AsFieldProps as as, type WithChildren as at, type ExtractField as au, 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 PluginInternal as o, type Direction as p, type DragAxis as q, resolveAllData as r, type Viewport as s, transformProps as t, type FieldTransformFnParams as u, type FieldTransformFn as v, walkTree as w, overrideKeys as x, type OverrideKey as y, type FieldRenderFunctions as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@measured/puck",
3
- "version": "0.21.0-canary.74d9a160",
3
+ "version": "0.21.0-canary.8416d520",
4
4
  "description": "The open-source visual editor for React",
5
5
  "author": "Chris Villa <chris@puckeditor.com>",
6
6
  "repository": "measuredco/puck",