@measured/puck 0.10.1-canary.cc20c52 → 0.11.0-canary.4613df4

package/dist/index.d.ts

@@ -8,39 +8,71 @@ type ItemSelector = {
     zone?: string;
 };
 
-type Adaptor<AdaptorParams = {}> = {
+type Adaptor<AdaptorParams = {}, TableShape extends Record<string, any> = {}, PropShape = TableShape> = {
     name: string;
-    fetchList: (adaptorParams?: AdaptorParams) => Promise<Record<string, any>[] | null>;
+    fetchList: (adaptorParams?: AdaptorParams) => Promise<TableShape[] | null>;
+    mapProp?: (value: TableShape) => PropShape;
 };
-type WithId<T> = T & {
+type WithPuckProps<Props> = Props & {
     id: string;
+    _meta?: {
+        readOnly: Partial<Record<keyof Props, boolean>>;
+    };
 };
-type Field<Props extends {
+type BaseField = {
+    label?: string;
+};
+type TextField = BaseField & {
+    type: "text" | "number" | "textarea";
+};
+type SelectField = BaseField & {
+    type: "select" | "radio";
+    options: {
+        label: string;
+        value: string | number | boolean;
+    }[];
+};
+type ArrayField<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
-}> = {
-    type: "text" | "textarea" | "number" | "select" | "array" | "external" | "radio" | "custom";
-    label?: string;
-    adaptor?: Adaptor;
-    adaptorParams?: object;
-    arrayFields?: {
-        [SubPropName in keyof Props]: Field<Props[SubPropName][0]>;
+}> = BaseField & {
+    type: "array";
+    arrayFields: {
+        [SubPropName in keyof Props[0]]: Field<Props[0][SubPropName]>;
     };
-    getItemSummary?: (item: Props, index?: number) => string;
-    defaultItemProps?: Props;
-    render?: (props: {
-        field: Field;
+    defaultItemProps?: Props[0];
+    getItemSummary?: (item: Props[0], index?: number) => string;
+};
+type ExternalField<Props extends {
+    [key: string]: any;
+} = {
+    [key: string]: any;
+}> = BaseField & {
+    type: "external";
+    adaptor: Adaptor<any, any, Props>;
+    adaptorParams?: object;
+    getItemSummary: (item: Props, index?: number) => string;
+};
+type CustomField<Props extends {
+    [key: string]: any;
+} = {
+    [key: string]: any;
+}> = BaseField & {
+    type: "custom";
+    render: (props: {
+        field: CustomField;
         name: string;
         value: any;
-        onChange: (value: any) => void;
+        onChange: (value: Props) => void;
         readOnly?: boolean;
     }) => ReactElement;
-    options?: {
-        label: string;
-        value: string | number | boolean;
-    }[];
 };
+type Field<Props extends {
+    [key: string]: any;
+} = {
+    [key: string]: any;
+}> = TextField | SelectField | ArrayField<Props> | ExternalField<Props> | CustomField;
 type DefaultRootProps = {
     children: ReactNode;
     title: string;
@@ -52,7 +84,7 @@ type DefaultComponentProps = {
     editMode?: boolean;
 };
 type Fields<ComponentProps extends DefaultComponentProps = DefaultComponentProps> = {
-    [PropName in keyof Omit<Required<ComponentProps>, "children" | "editMode">]: Field<ComponentProps[PropName][0]>;
+    [PropName in keyof Omit<Required<ComponentProps>, "children" | "editMode">]: Field<ComponentProps[PropName]>;
 };
 type Content<Props extends {
     [key: string]: any;
@@ -60,15 +92,28 @@ type Content<Props extends {
     [key: string]: any;
 }> = MappedItem<Props>[];
 type ComponentConfig<ComponentProps extends DefaultComponentProps = DefaultComponentProps, DefaultProps = ComponentProps> = {
-    render: (props: WithId<ComponentProps>) => ReactElement;
+    render: (props: WithPuckProps<ComponentProps>) => ReactElement;
     defaultProps?: DefaultProps;
     fields?: Fields<ComponentProps>;
+    resolveProps?: (props: WithPuckProps<ComponentProps>) => Promise<{
+        props: WithPuckProps<ComponentProps>;
+        readOnly?: Partial<Record<keyof ComponentProps, boolean>>;
+    }>;
+};
+type Category<ComponentName> = {
+    components?: ComponentName[];
+    title?: string;
+    visible?: boolean;
+    defaultExpanded?: boolean;
 };
 type Config<Props extends {
     [key: string]: any;
 } = {
     [key: string]: any;
-}, RootProps extends DefaultRootProps = DefaultRootProps> = {
+}, RootProps extends DefaultRootProps = DefaultRootProps, CategoryName extends string = string> = {
+    categories?: Record<CategoryName, Category<keyof Props>> & {
+        other?: Category<Props>;
+    };
     components: {
         [ComponentName in keyof Props]: ComponentConfig<Props[ComponentName], Props[ComponentName]>;
     };
@@ -84,7 +129,7 @@ type MappedItem<Props extends {
     [key: string]: any;
 }> = {
     type: keyof Props;
-    props: WithId<{
+    props: WithPuckProps<{
         [key: string]: any;
     }>;
 };
@@ -115,6 +160,12 @@ type UiState = {
     leftSideBarVisible: boolean;
     itemSelector: ItemSelector | null;
     arrayState: Record<string, ArrayState | undefined>;
+    componentList: Record<string, {
+        components?: string[];
+        title?: string;
+        visible?: boolean;
+        expanded?: boolean;
+    }>;
 };
 type AppState = {
     data: Data;
@@ -201,6 +252,7 @@ type PathData = Record<string, {
 type DropZoneContext = {
     data: Data;
     config: Config;
+    dynamicProps?: Record<string, any>;
     itemSelector?: ItemSelector | null;
     setItemSelector?: (newIndex: ItemSelector | null) => void;
     dispatch?: (action: PuckAction) => void;
@@ -265,12 +317,17 @@ type Plugin = {
     }) => ReactElement<any>;
 };
 
-declare function Puck({ config, data: initialData, onChange, onPublish, plugins, renderHeader, renderHeaderActions, headerTitle, headerPath, }: {
+declare function Puck({ config, data: initialData, onChange, onPublish, plugins, renderComponentList, renderHeader, renderHeaderActions, headerTitle, headerPath, }: {
     config: Config;
     data: Data;
     onChange?: (data: Data) => void;
     onPublish: (data: Data) => void;
     plugins?: Plugin[];
+    renderComponentList?: (props: {
+        children: ReactNode;
+        dispatch: (action: PuckAction) => void;
+        state: AppState;
+    }) => ReactElement;
     renderHeader?: (props: {
         children: ReactNode;
         dispatch: (action: PuckAction) => void;
@@ -289,10 +346,24 @@ 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 FieldLabel: ({ children, icon, label, }: {
     children?: ReactNode;
     icon?: ReactNode;
     label: string;
 }) => react_jsx_runtime.JSX.Element;
 
-export { Adaptor, AppState, ArrayState, Button, ComponentConfig, Config, Content, Data, DefaultComponentProps, DefaultRootProps, DropZone, DropZoneProvider, Field, FieldLabel, Fields, IconButton, ItemWithId, MappedItem, Puck, Render, UiState, dropZoneContext };
+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 };