@measured/puck 0.19.0-canary.b918900 → 0.19.0-canary.bc5bfff1

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.
package/dist/rsc.mjs CHANGED
@@ -1,113 +1,18 @@
1
1
  import {
2
- __spreadProps,
3
- __spreadValues,
2
+ Render,
4
3
  init_react_import,
4
+ migrate,
5
5
  resolveAllData,
6
- rootAreaId,
7
- rootDroppableId,
8
- rootZone,
9
- setupZone
10
- } from "./chunk-T6VJEBJD.mjs";
6
+ transformProps,
7
+ walkTree
8
+ } from "./chunk-DCJTUSJF.mjs";
11
9
 
12
10
  // rsc.tsx
13
11
  init_react_import();
14
-
15
- // components/ServerRender/index.tsx
16
- init_react_import();
17
- import { Fragment, jsx } from "react/jsx-runtime";
18
- function DropZoneRender({
19
- zone,
20
- data,
21
- areaId = "root",
22
- config,
23
- metadata = {}
24
- }) {
25
- let zoneCompound = rootDroppableId;
26
- let content = (data == null ? void 0 : data.content) || [];
27
- if (!data || !config) {
28
- return null;
29
- }
30
- if (areaId !== rootAreaId && zone !== rootZone) {
31
- zoneCompound = `${areaId}:${zone}`;
32
- content = setupZone(data, zoneCompound).zones[zoneCompound];
33
- }
34
- return /* @__PURE__ */ jsx(Fragment, { children: content.map((item) => {
35
- const Component = config.components[item.type];
36
- if (Component) {
37
- return /* @__PURE__ */ jsx(
38
- Component.render,
39
- __spreadProps(__spreadValues({}, item.props), {
40
- puck: {
41
- renderDropZone: ({ zone: zone2 }) => /* @__PURE__ */ jsx(
42
- DropZoneRender,
43
- {
44
- zone: zone2,
45
- data,
46
- areaId: item.props.id,
47
- config,
48
- metadata
49
- }
50
- ),
51
- metadata
52
- }
53
- }),
54
- item.props.id
55
- );
56
- }
57
- return null;
58
- }) });
59
- }
60
- function Render({
61
- config,
62
- data,
63
- metadata
64
- }) {
65
- var _a;
66
- if ((_a = config.root) == null ? void 0 : _a.render) {
67
- const rootProps = data.root.props || data.root;
68
- const title = rootProps.title || "";
69
- return /* @__PURE__ */ jsx(
70
- config.root.render,
71
- __spreadProps(__spreadValues({}, rootProps), {
72
- puck: {
73
- renderDropZone: ({ zone }) => /* @__PURE__ */ jsx(
74
- DropZoneRender,
75
- {
76
- zone,
77
- data,
78
- config,
79
- metadata
80
- }
81
- ),
82
- isEditing: false,
83
- dragRef: null
84
- },
85
- title,
86
- editMode: false,
87
- id: "puck-root",
88
- children: /* @__PURE__ */ jsx(
89
- DropZoneRender,
90
- {
91
- config,
92
- data,
93
- zone: rootZone,
94
- metadata
95
- }
96
- )
97
- })
98
- );
99
- }
100
- return /* @__PURE__ */ jsx(
101
- DropZoneRender,
102
- {
103
- config,
104
- data,
105
- zone: rootZone,
106
- metadata
107
- }
108
- );
109
- }
110
12
  export {
111
13
  Render,
112
- resolveAllData
14
+ migrate,
15
+ resolveAllData,
16
+ transformProps,
17
+ walkTree
113
18
  };
@@ -1,4 +1,4 @@
1
- import { CSSProperties, ReactElement, JSX, ReactNode } from 'react';
1
+ import { CSSProperties, ReactElement, ReactNode, JSX } from 'react';
2
2
 
3
3
  type ItemSelector = {
4
4
  index: number;
@@ -22,6 +22,8 @@ type FieldOption = {
22
22
  type FieldOptions = Array<FieldOption> | ReadonlyArray<FieldOption>;
23
23
  type BaseField = {
24
24
  label?: string;
25
+ labelIcon?: ReactElement;
26
+ metadata?: Metadata;
25
27
  };
26
28
  type TextField = BaseField & {
27
29
  type: "text";
@@ -108,16 +110,22 @@ type ExternalField<Props extends {
108
110
  filterFields?: Record<string, Field>;
109
111
  initialFilters?: Record<string, any>;
110
112
  };
111
- type CustomField<Props extends any = {}> = BaseField & {
113
+ type CustomFieldRender<Value extends any> = (props: {
114
+ field: CustomField<Value>;
115
+ name: string;
116
+ id: string;
117
+ value: Value;
118
+ onChange: (value: Value) => void;
119
+ readOnly?: boolean;
120
+ }) => ReactElement;
121
+ type CustomField<Value extends any> = BaseField & {
112
122
  type: "custom";
113
- render: (props: {
114
- field: CustomField<Props>;
115
- name: string;
116
- id: string;
117
- value: Props;
118
- onChange: (value: Props) => void;
119
- readOnly?: boolean;
120
- }) => ReactElement;
123
+ render: CustomFieldRender<Value>;
124
+ };
125
+ type SlotField = BaseField & {
126
+ type: "slot";
127
+ allow?: string[];
128
+ disallow?: string[];
121
129
  };
122
130
  type Field<Props extends any = any> = TextField | NumberField | TextareaField | SelectField | RadioField | ArrayField<Props extends {
123
131
  [key: string]: any;
@@ -127,7 +135,7 @@ type Field<Props extends any = any> = TextField | NumberField | TextareaField |
127
135
  [key: string]: any;
128
136
  } ? Props : any> | ExternalFieldWithAdaptor<Props extends {
129
137
  [key: string]: any;
130
- } ? Props : any> | CustomField<Props>;
138
+ } ? Props : any> | CustomField<Props> | SlotField;
131
139
  type Fields<ComponentProps extends DefaultComponentProps = DefaultComponentProps> = {
132
140
  [PropName in keyof Omit<ComponentProps, "editMode">]: Field<ComponentProps[PropName]>;
133
141
  };
@@ -139,7 +147,17 @@ type FieldProps<F = Field<any>, ValueType = any> = {
139
147
  readOnly?: boolean;
140
148
  };
141
149
 
142
- type PuckComponent<Props> = (props: WithId<WithPuckProps<Props>>) => JSX.Element;
150
+ type SlotComponent = (props?: Omit<DropZoneProps, "zone">) => ReactNode;
151
+ /**
152
+ * Recursively walk T and replace Slots with SlotComponents
153
+ */
154
+ type WithDeepSlots<T> = T extends Slot ? SlotComponent : T extends readonly (infer U)[] ? ReadonlyArray<WithDeepSlots<U>> : T extends (infer U)[] ? WithDeepSlots<U>[] : T extends object ? {
155
+ [K in keyof T]: WithDeepSlots<T[K]>;
156
+ } : T;
157
+ type PuckComponent<Props> = (props: WithId<WithPuckProps<{
158
+ [K in keyof Props]: WithDeepSlots<Props[K]>;
159
+ }>>) => JSX.Element;
160
+ type ResolveDataTrigger = "insert" | "replace" | "load" | "force";
143
161
  type ComponentConfig<RenderProps extends DefaultComponentProps = DefaultComponentProps, FieldProps extends DefaultComponentProps = RenderProps, DataShape = Omit<ComponentData<FieldProps>, "type">> = {
144
162
  render: PuckComponent<RenderProps>;
145
163
  label?: string;
@@ -148,7 +166,9 @@ type ComponentConfig<RenderProps extends DefaultComponentProps = DefaultComponen
148
166
  permissions?: Partial<Permissions>;
149
167
  inline?: boolean;
150
168
  resolveFields?: (data: DataShape, params: {
151
- changed: Partial<Record<keyof FieldProps, boolean>>;
169
+ changed: Partial<Record<keyof FieldProps, boolean> & {
170
+ id: string;
171
+ }>;
152
172
  fields: Fields<FieldProps>;
153
173
  lastFields: Fields<FieldProps>;
154
174
  lastData: DataShape | null;
@@ -156,24 +176,31 @@ type ComponentConfig<RenderProps extends DefaultComponentProps = DefaultComponen
156
176
  parent: ComponentData | null;
157
177
  }) => Promise<Fields<FieldProps>> | Fields<FieldProps>;
158
178
  resolveData?: (data: DataShape, params: {
159
- changed: Partial<Record<keyof FieldProps, boolean>>;
179
+ changed: Partial<Record<keyof FieldProps, boolean> & {
180
+ id: string;
181
+ }>;
160
182
  lastData: DataShape | null;
161
183
  metadata: Metadata;
184
+ trigger: ResolveDataTrigger;
162
185
  }) => Promise<{
163
186
  props?: Partial<FieldProps>;
164
- readOnly?: Partial<Record<keyof FieldProps, boolean>>;
187
+ readOnly?: Partial<Record<keyof FieldProps, boolean>> & Record<string, boolean>;
165
188
  }> | {
166
189
  props?: Partial<FieldProps>;
167
- readOnly?: Partial<Record<keyof FieldProps, boolean>>;
190
+ readOnly?: Partial<Record<keyof FieldProps, boolean>> & Record<string, boolean>;
168
191
  };
169
192
  resolvePermissions?: (data: DataShape, params: {
170
- changed: Partial<Record<keyof FieldProps, boolean>>;
193
+ changed: Partial<Record<keyof FieldProps, boolean> & {
194
+ id: string;
195
+ }>;
171
196
  lastPermissions: Partial<Permissions>;
172
197
  permissions: Partial<Permissions>;
173
198
  appState: AppState;
174
199
  lastData: DataShape | null;
175
200
  }) => Promise<Partial<Permissions>> | Partial<Permissions>;
201
+ metadata?: Metadata;
176
202
  };
203
+ type RootConfig<RootProps extends DefaultComponentProps = any> = Partial<ComponentConfig<WithChildren<RootProps>, AsFieldProps<RootProps>, RootData<AsFieldProps<RootProps>>>>;
177
204
  type Category<ComponentName> = {
178
205
  components?: ComponentName[];
179
206
  title?: string;
@@ -187,7 +214,7 @@ type Config<Props extends DefaultComponentProps = DefaultComponentProps, RootPro
187
214
  components: {
188
215
  [ComponentName in keyof Props]: Omit<ComponentConfig<Props[ComponentName], Props[ComponentName]>, "type">;
189
216
  };
190
- root?: Partial<ComponentConfig<WithChildren<RootProps>, AsFieldProps<RootProps>, RootData<AsFieldProps<RootProps>>>>;
217
+ root?: RootConfig<RootProps>;
191
218
  };
192
219
 
193
220
  type WithId<Props> = Props & {
@@ -203,7 +230,7 @@ type WithChildren<Props> = Props & {
203
230
  };
204
231
  type ExtractPropsFromConfig<UserConfig> = UserConfig extends Config<infer P, any, any> ? P : never;
205
232
  type ExtractRootPropsFromConfig<UserConfig> = UserConfig extends Config<any, infer P, any> ? P : never;
206
- type UserGenerics<UserConfig extends Config = Config, UserProps extends ExtractPropsFromConfig<UserConfig> = ExtractPropsFromConfig<UserConfig>, UserRootProps extends ExtractRootPropsFromConfig<UserConfig> = ExtractRootPropsFromConfig<UserConfig>, UserData extends Data<UserProps, UserRootProps> | Data = Data<UserProps, UserRootProps>, UserAppState extends AppState<UserData> = AppState<UserData>, UserComponentData extends ComponentData = UserData["content"][0]> = {
233
+ type UserGenerics<UserConfig extends Config = Config, UserProps extends ExtractPropsFromConfig<UserConfig> = ExtractPropsFromConfig<UserConfig>, UserRootProps extends ExtractRootPropsFromConfig<UserConfig> = ExtractRootPropsFromConfig<UserConfig>, UserData extends Data<UserProps, UserRootProps> | Data = Data<UserProps, UserRootProps>, UserAppState extends PrivateAppState<UserData> = PrivateAppState<UserData>, UserComponentData extends ComponentData = UserData["content"][0]> = {
207
234
  UserConfig: UserConfig;
208
235
  UserProps: UserProps;
209
236
  UserRootProps: UserRootProps;
@@ -235,22 +262,28 @@ type BaseData<Props extends {
235
262
  readOnly?: Partial<Record<keyof Props, boolean>>;
236
263
  };
237
264
  type RootDataWithProps<Props extends DefaultComponentProps = DefaultRootFieldProps> = BaseData<Props> & {
238
- props: Props;
265
+ props: WithSlotProps<Props>;
239
266
  };
240
267
  type RootDataWithoutProps<Props extends DefaultComponentProps = DefaultRootFieldProps> = Props;
241
268
  type RootData<Props extends DefaultComponentProps = DefaultRootFieldProps> = Partial<RootDataWithProps<AsFieldProps<Props>>> & Partial<RootDataWithoutProps<Props>>;
242
269
  type ComponentData<Props extends DefaultComponentProps = DefaultComponentProps, Name = string> = {
243
270
  type: Name;
244
- props: WithId<Props>;
271
+ props: WithId<WithSlotProps<Props>>;
272
+ } & BaseData<Props>;
273
+ type ComponentDataOptionalId<Props extends DefaultComponentProps = DefaultComponentProps, Name = string> = {
274
+ type: Name;
275
+ props: Props & {
276
+ id?: string;
277
+ };
245
278
  } & BaseData<Props>;
246
279
  type MappedItem = ComponentData;
247
280
  type ComponentDataMap<Props extends Record<string, DefaultComponentProps> = DefaultComponentProps> = {
248
281
  [K in keyof Props]: ComponentData<Props[K], K extends string ? K : never>;
249
282
  }[keyof Props];
250
283
  type Content<PropsMap extends {
251
- [key: string]: any;
284
+ [key: string]: DefaultComponentProps;
252
285
  } = {
253
- [key: string]: any;
286
+ [key: string]: DefaultComponentProps;
254
287
  }> = ComponentDataMap<PropsMap>[];
255
288
  type Data<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps> = {
256
289
  root: RootData<RootProps>;
@@ -299,6 +332,27 @@ type AppState<UserData extends Data = Data> = {
299
332
  ui: UiState;
300
333
  };
301
334
 
335
+ type ZoneType = "root" | "dropzone" | "slot";
336
+ type PuckNodeData = {
337
+ data: ComponentData;
338
+ flatData: ComponentData;
339
+ parentId: string | null;
340
+ zone: string;
341
+ path: string[];
342
+ };
343
+ type PuckZoneData = {
344
+ contentIds: string[];
345
+ type: ZoneType;
346
+ };
347
+ type NodeIndex = Record<string, PuckNodeData>;
348
+ type ZoneIndex = Record<string, PuckZoneData>;
349
+ type PrivateAppState<UserData extends Data = Data> = AppState<UserData> & {
350
+ indexes: {
351
+ nodes: NodeIndex;
352
+ zones: ZoneIndex;
353
+ };
354
+ };
355
+
302
356
  type RenderFunc<Props extends {
303
357
  [key: string]: any;
304
358
  } = {
@@ -405,6 +459,16 @@ type InitialHistoryNoAppend<AS = Partial<AppState>> = {
405
459
  appendData?: false;
406
460
  };
407
461
  type InitialHistory<AS = Partial<AppState>> = InitialHistoryAppend<AS> | InitialHistoryNoAppend<AS>;
462
+ type Slot<Props extends {
463
+ [key: string]: DefaultComponentProps;
464
+ } = {
465
+ [key: string]: DefaultComponentProps;
466
+ }> = {
467
+ [K in keyof Props]: ComponentDataOptionalId<Props[K], K extends string ? K : never>;
468
+ }[keyof Props][];
469
+ type WithSlotProps<Props extends DefaultComponentProps = DefaultComponentProps, SlotProps extends DefaultComponentProps = Props> = Props extends any ? any : {
470
+ [PropName in keyof Props]: Props[PropName] extends Slot<SlotProps> ? Content<SlotProps> : Props[PropName];
471
+ };
408
472
 
409
473
  type InsertAction = {
410
474
  type: "insert";
@@ -418,11 +482,17 @@ type DuplicateAction = {
418
482
  sourceIndex: number;
419
483
  sourceZone: string;
420
484
  };
421
- type ReplaceAction = {
485
+ type ReplaceAction<UserData extends Data = Data> = {
422
486
  type: "replace";
423
487
  destinationIndex: number;
424
488
  destinationZone: string;
425
- data: any;
489
+ data: ComponentData;
490
+ ui?: Partial<AppState<UserData>["ui"]>;
491
+ };
492
+ type ReplaceRootAction<UserData extends Data = Data> = {
493
+ type: "replaceRoot";
494
+ root: RootData;
495
+ ui?: Partial<AppState<UserData>["ui"]>;
426
496
  };
427
497
  type ReorderAction = {
428
498
  type: "reorder";
@@ -452,7 +522,7 @@ type SetDataAction = {
452
522
  };
453
523
  type SetAction<UserData extends Data = Data> = {
454
524
  type: "set";
455
- state: Partial<AppState<UserData>> | ((previous: AppState<UserData>) => Partial<AppState<UserData>>);
525
+ state: Partial<PrivateAppState<UserData>> | ((previous: PrivateAppState<UserData>) => Partial<PrivateAppState<UserData>>);
456
526
  };
457
527
  type RegisterZoneAction = {
458
528
  type: "registerZone";
@@ -464,8 +534,27 @@ type UnregisterZoneAction = {
464
534
  };
465
535
  type PuckAction = {
466
536
  recordHistory?: boolean;
467
- } & (ReorderAction | InsertAction | MoveAction | ReplaceAction | RemoveAction | DuplicateAction | SetAction | SetDataAction | SetUiAction | RegisterZoneAction | UnregisterZoneAction);
537
+ } & (ReorderAction | InsertAction | MoveAction | ReplaceAction | ReplaceRootAction | RemoveAction | DuplicateAction | SetAction | SetDataAction | SetUiAction | RegisterZoneAction | UnregisterZoneAction);
538
+
539
+ declare function migrate(data: Data, config?: Config): Data;
540
+
541
+ type PropTransform<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps> = Partial<{
542
+ [ComponentName in keyof Props]: (props: Props[ComponentName] & {
543
+ [key: string]: any;
544
+ }) => Props[ComponentName];
545
+ } & {
546
+ root: (props: RootProps & {
547
+ [key: string]: any;
548
+ }) => RootProps;
549
+ }>;
550
+ declare function transformProps<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps>(data: Partial<Data>, propTransforms: PropTransform<Props, RootProps>, config?: Config): Data;
468
551
 
469
552
  declare function resolveAllData<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends Record<string, any> = DefaultRootFieldProps>(data: Partial<Data>, config: Config, metadata?: Metadata, onResolveStart?: (item: ComponentData) => void, onResolveEnd?: (item: ComponentData) => void): Promise<Data<Props, RootProps>>;
470
553
 
471
- export { type DefaultRootProps as $, type AppState as A, type BaseData as B, type Config as C, type DropZoneProps as D, type BaseField as E, type FieldProps as F, type TextareaField as G, type History as H, type IframeConfig as I, type RadioField as J, type ArrayField as K, type ObjectField as L, type Metadata as M, type NumberField as N, type OnAction as O, type Permissions as P, type Adaptor as Q, type RootDataWithProps as R, type SelectField as S, type TextField as T, type UserGenerics as U, type Viewports as V, type ExternalFieldWithAdaptor as W, type ExternalField as X, type CustomField as Y, type PuckContext as Z, type DefaultRootRenderProps as _, type Field as a, type WithId as a0, type WithPuckProps as a1, type AsFieldProps as a2, type WithChildren as a3, type ExtractPropsFromConfig as a4, type ExtractRootPropsFromConfig as a5, resolveAllData as a6, type Data as b, type UiState as c, type Plugin as d, type Overrides as e, type PuckAction as f, type InitialHistory as g, type DefaultComponentProps as h, type DefaultRootFieldProps as i, type ComponentData as j, type Fields as k, type ComponentConfig as l, type Direction as m, type DragAxis as n, type Viewport as o, overrideKeys as p, type OverrideKey as q, type FieldRenderFunctions as r, type ItemWithId as s, type ArrayState as t, type PuckComponent as u, type RootDataWithoutProps as v, type RootData as w, type MappedItem as x, type ComponentDataMap as y, type Content as z };
554
+ type WalkTreeOptions = {
555
+ parentId: string;
556
+ propName: string;
557
+ };
558
+ 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;
559
+
560
+ export { type ExternalFieldWithAdaptor as $, type AppState as A, type BaseData as B, type ComponentData as C, type DropZoneProps as D, type MappedItem as E, type Fields as F, type ComponentDataMap as G, type History as H, type IframeConfig as I, type Content as J, type BaseField as K, type TextareaField as L, type Metadata as M, type NumberField as N, type Overrides as O, type Permissions as P, type SelectField as Q, type RootDataWithProps as R, type Slot as S, type TextField as T, type UserGenerics as U, type Viewports as V, type WithSlotProps as W, type RadioField as X, type ArrayField as Y, type ObjectField as Z, type Adaptor as _, type Config as a, type ExternalField as a0, type CustomFieldRender as a1, type CustomField as a2, type SlotField as a3, type PuckContext as a4, type DefaultRootFieldProps as a5, type DefaultRootRenderProps as a6, type DefaultRootProps as a7, type DefaultComponentProps as a8, type WithId as a9, type WithPuckProps as aa, type AsFieldProps as ab, type WithChildren as ac, type ExtractPropsFromConfig as ad, type ExtractRootPropsFromConfig as ae, migrate as af, transformProps as ag, resolveAllData as ah, type PuckAction as b, type ResolveDataTrigger as c, type Plugin as d, type UiState as e, type ComponentConfig as f, type Field as g, type FieldProps as h, type Data as i, type OnAction as j, type InitialHistory as k, type ItemSelector as l, type Direction as m, type DragAxis as n, type Viewport as o, overrideKeys as p, type OverrideKey as q, type FieldRenderFunctions as r, type ItemWithId as s, type ArrayState as t, type PuckComponent as u, type RootConfig as v, walkTree as w, type RootDataWithoutProps as x, type RootData as y, type ComponentDataOptionalId as z };