@measured/puck 0.11.0-canary.b28404f → 0.11.0-canary.d22150a

package/dist/index.d.ts

@@ -8,16 +8,8 @@ type ItemSelector = {
     zone?: string;
 };
 
-type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
-    name: string;
-    fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
-    mapProp?: (value: TableShape) => PropShape;
-};
 type WithPuckProps<Props> = Props & {
     id: string;
-    _meta?: {
-        readOnly: Partial<Record<keyof Props, boolean>>;
-    };
 };
 type BaseField = {
     label?: string;
@@ -44,16 +36,33 @@ type ArrayField<Props extends {
     defaultItemProps?: Props[0];
     getItemSummary?: (item: Props[0], index?: number) => string;
 };
-type ExternalField<Props extends {
+type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
+    name: string;
+    fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
+    mapProp?: (value: TableShape) => PropShape;
+};
+type ExternalFieldWithAdaptor<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
 }> = BaseField & {
     type: "external";
+    placeholder?: string;
     adaptor: Adaptor<any, any, Props>;
     adaptorParams?: object;
     getItemSummary: (item: Props, index?: number) => string;
 };
+type ExternalField<Props extends {
+    [key: string]: any;
+} = {
+    [key: string]: any;
+}> = BaseField & {
+    type: "external";
+    placeholder?: string;
+    fetchList: () => Promise<any[] | null>;
+    mapProp?: (value: any) => Props;
+    getItemSummary: (item: Props, index?: number) => string;
+};
 type CustomField<Props extends {
     [key: string]: any;
 } = {
@@ -72,13 +81,14 @@ type Field<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
-}> = TextField | SelectField | ArrayField<Props> | ExternalField<Props> | CustomField;
+}> = TextField | SelectField | ArrayField<Props> | ExternalField<Props> | ExternalFieldWithAdaptor<Props> | CustomField;
 type DefaultRootProps = {
-    children: ReactNode;
-    title: string;
-    editMode: boolean;
+    title?: string;
     [key: string]: any;
 };
+type DefaultRootRenderProps = {
+    editMode: boolean;
+} & DefaultRootProps;
 type DefaultComponentProps = {
     [key: string]: any;
     editMode?: boolean;
@@ -90,15 +100,14 @@ type Content<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
-}> = MappedItem<Props>[];
-type ComponentConfig<ComponentProps extends DefaultComponentProps = DefaultComponentProps, DefaultProps = ComponentProps> = {
+}> = ComponentData<Props>[];
+type ComponentConfig<ComponentProps extends DefaultComponentProps = DefaultComponentProps, DefaultProps = ComponentProps, DataShape = ComponentData<ComponentProps>> = {
     render: (props: WithPuckProps<ComponentProps>) => ReactElement;
     defaultProps?: DefaultProps;
     fields?: Fields<ComponentProps>;
-    resolveProps?: (props: WithPuckProps<ComponentProps>) => Promise<{
-        props: WithPuckProps<ComponentProps>;
-        readOnly?: Partial<Record<keyof ComponentProps, boolean>>;
-    }>;
+    resolveData?: (data: DataShape, params: {
+        changed: Partial<Record<keyof ComponentProps, boolean>>;
+    }) => Promise<Partial<ComponentDataWithOptionalProps<ComponentProps>>> | Partial<ComponentDataWithOptionalProps<ComponentProps>>;
 };
 type Category<ComponentName> = {
     components?: ComponentName[];
@@ -115,38 +124,42 @@ type Config<Props extends {
         other?: Category<Props>;
     };
     components: {
-        [ComponentName in keyof Props]: ComponentConfig<Props[ComponentName], Props[ComponentName]>;
+        [ComponentName in keyof Props]: Omit<ComponentConfig<Props[ComponentName], Props[ComponentName]>, "type">;
     };
-    root?: ComponentConfig<RootProps & {
+    root?: Partial<ComponentConfig<RootProps & {
         children: ReactNode;
     }, Partial<RootProps & {
         children: ReactNode;
-    }>>;
+    }>, RootDataWithProps<RootProps>>>;
 };
-type MappedItem<Props extends {
+type BaseData<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
 }> = {
-    type: keyof Props;
-    props: WithPuckProps<{
-        [key: string]: any;
-    }>;
+    readOnly?: Partial<Record<keyof Props, boolean>>;
 };
-type Data<Props extends {
-    [key: string]: any;
-} = {
-    [key: string]: any;
-}, RootProps extends {
-    title: string;
+type ComponentData<Props extends DefaultComponentProps = DefaultComponentProps> = {
+    type: keyof Props;
+    props: WithPuckProps<Props>;
+} & BaseData<Props>;
+type RootDataWithProps<Props extends DefaultRootProps = DefaultRootProps> = {
+    props: Props;
+};
+type RootDataWithoutProps<Props extends DefaultRootProps = DefaultRootProps> = Props;
+type RootData<Props extends DefaultRootProps = DefaultRootProps> = BaseData<Props> & Partial<RootDataWithProps<Props>> & Partial<RootDataWithoutProps<Props>>;
+type ComponentDataWithOptionalProps<Props extends {
     [key: string]: any;
 } = {
-    title: string;
     [key: string]: any;
-}> = {
-    root: RootProps;
-    content: Content<Props>;
-    zones?: Record<string, Content<Props>>;
+}> = Omit<ComponentData, "props"> & {
+    props: Partial<WithPuckProps<Props>>;
+};
+type MappedItem = ComponentData;
+type Data<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultRootProps = DefaultRootProps> = {
+    root: RootData<RootProps>;
+    content: Content<WithPuckProps<Props>>;
+    zones?: Record<string, Content<WithPuckProps<Props>>>;
 };
 type ItemWithId = {
     _arrayId: string;
@@ -221,13 +234,13 @@ type RemoveAction = {
     index: number;
     zone: string;
 };
-type SetStateAction = {
+type SetUiAction = {
     type: "setUi";
-    ui: Partial<UiState>;
+    ui: Partial<UiState> | ((previous: UiState) => Partial<UiState>);
 };
 type SetDataAction = {
     type: "setData";
-    data: Partial<Data>;
+    data: Partial<Data> | ((previous: Data) => Partial<Data>);
 };
 type SetAction = {
     type: "set";
@@ -243,7 +256,7 @@ type UnregisterZoneAction = {
 };
 type PuckAction = {
     recordHistory?: boolean;
-} & (ReorderAction | InsertAction | MoveAction | ReplaceAction | RemoveAction | DuplicateAction | SetAction | SetDataAction | SetStateAction | RegisterZoneAction | UnregisterZoneAction);
+} & (ReorderAction | InsertAction | MoveAction | ReplaceAction | RemoveAction | DuplicateAction | SetAction | SetDataAction | SetUiAction | RegisterZoneAction | UnregisterZoneAction);
 
 type PathData = Record<string, {
     path: string[];
@@ -252,7 +265,7 @@ type PathData = Record<string, {
 type DropZoneContext = {
     data: Data;
     config: Config;
-    dynamicProps?: Record<string, any>;
+    componentState?: Record<string, any>;
     itemSelector?: ItemSelector | null;
     setItemSelector?: (newIndex: ItemSelector | null) => void;
     dispatch?: (action: PuckAction) => void;
@@ -346,24 +359,19 @@ declare function Render({ config, data }: {
     data: Data;
 }): react_jsx_runtime.JSX.Element;
 
-declare const resolveData: (data: Data, config: Config) => Promise<{
-    content: {
-        props: any;
-        type: string | number;
-    }[];
-    zones: Record<string, MappedItem<{
-        [key: string]: any;
-    }>[]>;
-    root: {
-        [key: string]: any;
-        title: string;
-    };
+declare const resolveAllData: (data: Data, config: Config, onResolveStart?: ((item: MappedItem) => void) | undefined, onResolveEnd?: ((item: MappedItem) => void) | undefined) => Promise<{
+    root: RootDataWithProps<DefaultRootProps> | RootData<DefaultRootProps>;
+    content: any[];
+    zones: Record<string, MappedItem[]>;
 }>;
 
-declare const FieldLabel: ({ children, icon, label, }: {
+declare const FieldLabel: ({ children, icon, label, el, readOnly, className, }: {
     children?: ReactNode;
     icon?: ReactNode;
     label: string;
+    el?: "div" | "label" | undefined;
+    readOnly?: boolean | undefined;
+    className?: string | undefined;
 }) => react_jsx_runtime.JSX.Element;
 
-export { Adaptor, AppState, ArrayField, ArrayState, BaseField, Button, ComponentConfig, Config, Content, CustomField, Data, DefaultComponentProps, DefaultRootProps, DropZone, DropZoneProvider, ExternalField, Field, FieldLabel, Fields, IconButton, ItemWithId, MappedItem, Puck, Render, SelectField, TextField, UiState, dropZoneContext, resolveData };
+export { Adaptor, AppState, ArrayField, ArrayState, BaseData, BaseField, Button, ComponentConfig, ComponentData, Config, Content, CustomField, Data, DefaultComponentProps, DefaultRootProps, DefaultRootRenderProps, DropZone, DropZoneProvider, ExternalField, ExternalFieldWithAdaptor, Field, FieldLabel, Fields, IconButton, ItemWithId, MappedItem, Puck, Render, RootData, RootDataWithProps, RootDataWithoutProps, SelectField, TextField, UiState, dropZoneContext, resolveAllData };