dune-react 0.0.29 → 0.0.30

package/dist/components/puck-core/core/props/form.d.ts

@@ -0,0 +1,172 @@
+/**
+ * 表单与数据输入类 Props — 用户填写/结构化数据
+ *
+ * 包含：Form Field / Form / Location / Social
+ * 每个 prop 按 Type → Field → Defaults 顺序排列
+ */
+import { type BaseButton } from "./interactive";
+export declare const fieldTypes: readonly ["text", "number", "password", "date", "file"];
+export type FieldTypes = (typeof fieldTypes)[number];
+export interface CompoundFieldProps {
+    id?: string;
+    name: string;
+    label: string;
+    type: FieldTypes;
+}
+export declare const formMethods: readonly ["get", "post", "put", "patch", "delete"];
+export type FormMethods = (typeof formMethods)[number];
+export interface CompoundFormProps {
+    title?: string;
+    fields: CompoundFieldProps[];
+    action: string;
+    method: FormMethods;
+    button: BaseButton;
+}
+export type BaseFormFieldType = "text" | "email" | "tel" | "number" | "date" | "url" | "file" | "textarea" | "select";
+export interface BaseFormField {
+    label: string;
+    name: string;
+    type?: BaseFormFieldType;
+    options?: string[];
+    required?: boolean;
+}
+export declare const formFieldField: {
+    type: string;
+    objectFields: {
+        label: {
+            type: string;
+            contentEditable: boolean;
+        };
+        name: {
+            type: string;
+        };
+        type: {
+            type: string;
+            options: {
+                label: "number" | "text" | "date" | "file" | "password";
+                value: "number" | "text" | "date" | "file" | "password";
+            }[];
+        };
+    };
+};
+export declare const formFieldDefaults: CompoundFieldProps;
+export declare const formField: {
+    type: string;
+    objectFields: {
+        title: {
+            type: string;
+            contentEditable: boolean;
+        };
+        fields: {
+            type: string;
+            min: number;
+            max: number;
+            arrayFields: {
+                label: {
+                    type: string;
+                    contentEditable: boolean;
+                };
+                name: {
+                    type: string;
+                };
+                type: {
+                    type: string;
+                    options: {
+                        label: "number" | "text" | "date" | "file" | "password";
+                        value: "number" | "text" | "date" | "file" | "password";
+                    }[];
+                };
+            };
+            getItemSummary: (item: {
+                label?: string;
+            }, index?: number) => string;
+            defaultItemProps: CompoundFieldProps;
+        };
+        action: {
+            type: string;
+            label: string;
+        };
+        method: {
+            type: string;
+            label: string;
+            options: {
+                label: "delete" | "get" | "post" | "put" | "patch";
+                value: "delete" | "get" | "post" | "put" | "patch";
+            }[];
+        };
+        button: {
+            objectFields: {
+                label: {
+                    readonly type: "text";
+                };
+                variant: {
+                    readonly type: "select";
+                    readonly options: readonly [{
+                        readonly label: "primary";
+                        readonly value: "default";
+                    }, {
+                        readonly label: "secondary";
+                        readonly value: "secondary";
+                    }, {
+                        readonly label: "outline";
+                        readonly value: "outline";
+                    }, {
+                        readonly label: "ghost";
+                        readonly value: "ghost";
+                    }, {
+                        readonly label: "link";
+                        readonly value: "link";
+                    }, {
+                        readonly label: "destructive";
+                        readonly value: "destructive";
+                    }];
+                };
+                size: {
+                    readonly type: "select";
+                    readonly options: readonly [{
+                        readonly label: "default";
+                        readonly value: "default";
+                    }, {
+                        readonly label: "sm";
+                        readonly value: "sm";
+                    }, {
+                        readonly label: "lg";
+                        readonly value: "lg";
+                    }, {
+                        readonly label: "icon";
+                        readonly value: "icon";
+                    }];
+                };
+                icon: {
+                    type: "custom";
+                    render: typeof import("../../fields/icon-picker-field").IconPickerField;
+                };
+            };
+            type: "object";
+        };
+    };
+};
+export declare const formDefaults: CompoundFormProps;
+/** 地图定位的核心数据：地址 + 坐标 */
+export interface MapLocation {
+    /** 用户可读的完整地址（显示 & 搜索用） */
+    address: string;
+    /** 纬度 */
+    lat: number;
+    /** 经度 */
+    lng: number;
+    /** 地图缩放级别，默认 14 */
+    zoom?: number;
+    /** Google Place ID（可选，便于精确定位） */
+    placeId?: string;
+}
+/** 从 MapLocation 生成 Google Maps embed URL */
+export declare function getMapEmbedUrl(loc: MapLocation): string;
+/** 从 MapLocation 生成 Google Maps 导航 URL */
+export declare function getDirectionsUrl(loc: MapLocation): string;
+export declare const locationDefaults: MapLocation;
+export declare const locationField: {
+    type: "custom";
+    label: string;
+    render: any;
+};

package/dist/components/puck-core/core/props/index.d.ts

@@ -0,0 +1,271 @@
+/**
+ * Props 统一出口
+ *
+ * 所有 prop 的 type / field / defaults 从这里导出。
+ * 使用方：import { BaseButton, buttonField, ... } from "@/components/puck-core/core/props"
+ */
+export { type IconName, iconField, type ActionType, type Action, resolveActionUrl, actionField, actionDefaults, type ButtonVariant, type ButtonSize, type BaseButton, buttonField, buttonDefaults, buttonsField, type BadgeVariant, type BaseBadge, badgeField, type BaseLink, type BaseSocialLink, } from "./interactive";
+export { headingField, descriptionField, type BaseFeatureItem, type FeatureItemWithImage, type Feature, featuresField, cardField, cardsField, } from "./content";
+export { type BaseImage, imageField, imagesField, getPlaceholderImageUrl, image16x9Placeholder, image1x1Placeholder, image9x16Placeholder, } from "./media";
+export { fieldTypes, type FieldTypes, type CompoundFieldProps, formMethods, type FormMethods, type CompoundFormProps, type BaseFormFieldType, type BaseFormField, formFieldField, formFieldDefaults, formField, formDefaults, type MapLocation, getMapEmbedUrl, getDirectionsUrl, locationDefaults, locationField, } from "./form";
+export { type PaddingLevel, type SectionPadding, type BaseSectionStyle, type BaseSectionStyles, } from "./section";
+/** heading + description + badge + buttons */
+export declare const contentFields: {
+    readonly heading: {
+        readonly type: "text";
+        readonly contentEditable: true;
+    };
+    readonly description: {
+        readonly type: "textarea";
+        readonly contentEditable: true;
+    };
+    readonly badge: {
+        readonly type: "object";
+        readonly objectFields: {
+            readonly label: {
+                readonly type: "text";
+            };
+            readonly url: {
+                readonly type: "text";
+            };
+            readonly variant: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "default";
+                    readonly value: "default";
+                }, {
+                    readonly label: "secondary";
+                    readonly value: "secondary";
+                }, {
+                    readonly label: "destructive";
+                    readonly value: "destructive";
+                }, {
+                    readonly label: "outline";
+                    readonly value: "outline";
+                }];
+            };
+        };
+    };
+    readonly buttons: {
+        readonly type: "array";
+        readonly max: 3;
+        readonly getItemSummary: (item: {
+            label?: string;
+        }, index?: number) => string;
+        readonly arrayFields: {
+            readonly label: {
+                readonly type: "text";
+            };
+            readonly action: {
+                type: "custom";
+                label: string;
+                render: typeof import("../..").ActionField;
+            };
+            readonly variant: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "primary";
+                    readonly value: "default";
+                }, {
+                    readonly label: "secondary";
+                    readonly value: "secondary";
+                }, {
+                    readonly label: "outline";
+                    readonly value: "outline";
+                }, {
+                    readonly label: "ghost";
+                    readonly value: "ghost";
+                }, {
+                    readonly label: "link";
+                    readonly value: "link";
+                }, {
+                    readonly label: "destructive";
+                    readonly value: "destructive";
+                }];
+            };
+            readonly size: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "default";
+                    readonly value: "default";
+                }, {
+                    readonly label: "sm";
+                    readonly value: "sm";
+                }, {
+                    readonly label: "lg";
+                    readonly value: "lg";
+                }, {
+                    readonly label: "icon";
+                    readonly value: "icon";
+                }];
+            };
+            readonly icon: {
+                type: "custom";
+                render: typeof import("../../fields/icon-picker-field").IconPickerField;
+            };
+        };
+        readonly defaultItemProps: {
+            readonly label: "Button";
+            readonly action: {
+                readonly type: "page";
+                readonly pageUrl: "";
+                readonly externalUrl: "";
+                readonly openInNewTab: "false";
+                readonly email: "";
+                readonly subject: "";
+                readonly phone: "";
+                readonly sectionId: "";
+                readonly downloadUrl: "";
+            };
+            readonly variant: "default";
+            readonly size: "default";
+            readonly icon: "none";
+        };
+        readonly ai: {
+            readonly instructions: "Buttons must use the same size";
+        };
+    };
+};
+/** heading + description + badge + features + buttons */
+export declare const contentFieldsWithFeatures: {
+    readonly heading: {
+        readonly type: "text";
+        readonly contentEditable: true;
+    };
+    readonly description: {
+        readonly type: "textarea";
+        readonly contentEditable: true;
+    };
+    readonly badge: {
+        readonly type: "object";
+        readonly objectFields: {
+            readonly label: {
+                readonly type: "text";
+            };
+            readonly url: {
+                readonly type: "text";
+            };
+            readonly variant: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "default";
+                    readonly value: "default";
+                }, {
+                    readonly label: "secondary";
+                    readonly value: "secondary";
+                }, {
+                    readonly label: "destructive";
+                    readonly value: "destructive";
+                }, {
+                    readonly label: "outline";
+                    readonly value: "outline";
+                }];
+            };
+        };
+    };
+    readonly features: {
+        readonly type: "array";
+        readonly max: 5;
+        readonly getItemSummary: (item: {
+            name?: string;
+        }, index?: number) => string;
+        readonly arrayFields: {
+            readonly icon: {
+                type: "custom";
+                render: typeof import("../../fields/icon-picker-field").IconPickerField;
+            };
+            readonly name: {
+                readonly type: "text";
+                readonly contentEditable: true;
+            };
+            readonly description: {
+                readonly type: "textarea";
+                readonly contentEditable: true;
+            };
+        };
+        readonly defaultItemProps: {
+            readonly icon: "check";
+            readonly name: "Feature name";
+            readonly description: "Description of the feature";
+        };
+    };
+    readonly buttons: {
+        readonly type: "array";
+        readonly max: 3;
+        readonly getItemSummary: (item: {
+            label?: string;
+        }, index?: number) => string;
+        readonly arrayFields: {
+            readonly label: {
+                readonly type: "text";
+            };
+            readonly action: {
+                type: "custom";
+                label: string;
+                render: typeof import("../..").ActionField;
+            };
+            readonly variant: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "primary";
+                    readonly value: "default";
+                }, {
+                    readonly label: "secondary";
+                    readonly value: "secondary";
+                }, {
+                    readonly label: "outline";
+                    readonly value: "outline";
+                }, {
+                    readonly label: "ghost";
+                    readonly value: "ghost";
+                }, {
+                    readonly label: "link";
+                    readonly value: "link";
+                }, {
+                    readonly label: "destructive";
+                    readonly value: "destructive";
+                }];
+            };
+            readonly size: {
+                readonly type: "select";
+                readonly options: readonly [{
+                    readonly label: "default";
+                    readonly value: "default";
+                }, {
+                    readonly label: "sm";
+                    readonly value: "sm";
+                }, {
+                    readonly label: "lg";
+                    readonly value: "lg";
+                }, {
+                    readonly label: "icon";
+                    readonly value: "icon";
+                }];
+            };
+            readonly icon: {
+                type: "custom";
+                render: typeof import("../../fields/icon-picker-field").IconPickerField;
+            };
+        };
+        readonly defaultItemProps: {
+            readonly label: "Button";
+            readonly action: {
+                readonly type: "page";
+                readonly pageUrl: "";
+                readonly externalUrl: "";
+                readonly openInNewTab: "false";
+                readonly email: "";
+                readonly subject: "";
+                readonly phone: "";
+                readonly sectionId: "";
+                readonly downloadUrl: "";
+            };
+            readonly variant: "default";
+            readonly size: "default";
+            readonly icon: "none";
+        };
+        readonly ai: {
+            readonly instructions: "Buttons must use the same size";
+        };
+    };
+};

package/dist/components/puck-core/core/props/interactive.d.ts

@@ -0,0 +1,244 @@
+/**
+ * 交互类 Props — 用户可点击/触发的元素
+ *
+ * 包含：Action / Button / Badge / Link / Icon
+ * 每个 prop 按 Type → Field → Defaults 顺序排列
+ */
+import { iconNames } from "lucide-react/dynamic";
+import { ActionField } from "../../fields/action-field";
+import { IconPickerField } from "../../fields/icon-picker-field";
+export type IconName = "none" | (typeof iconNames)[number];
+export declare const iconField: {
+    type: "custom";
+    render: typeof IconPickerField;
+};
+export type ActionType = "page" | "external" | "scroll" | "email" | "phone" | "section" | "download" | "none";
+export type Action = {
+    type: ActionType;
+    pageUrl?: string;
+    externalUrl?: string;
+    openInNewTab?: string;
+    email?: string;
+    subject?: string;
+    phone?: string;
+    sectionId?: string;
+    downloadUrl?: string;
+};
+export declare function resolveActionUrl(action: Action): string | undefined;
+export declare const actionField: {
+    type: "custom";
+    label: string;
+    render: typeof ActionField;
+};
+export declare const actionDefaults: {
+    readonly type: "page";
+    readonly pageUrl: "";
+    readonly externalUrl: "";
+    readonly openInNewTab: "false";
+    readonly email: "";
+    readonly subject: "";
+    readonly phone: "";
+    readonly sectionId: "";
+    readonly downloadUrl: "";
+};
+export type ButtonVariant = "default" | "secondary" | "outline" | "ghost" | "link" | "destructive";
+export type ButtonSize = "default" | "sm" | "lg" | "icon";
+export interface BaseButton {
+    label: string;
+    action?: Action;
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    icon?: IconName;
+}
+export declare const buttonField: {
+    readonly type: "object";
+    readonly objectFields: {
+        readonly label: {
+            readonly type: "text";
+        };
+        readonly action: {
+            type: "custom";
+            label: string;
+            render: typeof ActionField;
+        };
+        readonly variant: {
+            readonly type: "select";
+            readonly options: readonly [{
+                readonly label: "primary";
+                readonly value: "default";
+            }, {
+                readonly label: "secondary";
+                readonly value: "secondary";
+            }, {
+                readonly label: "outline";
+                readonly value: "outline";
+            }, {
+                readonly label: "ghost";
+                readonly value: "ghost";
+            }, {
+                readonly label: "link";
+                readonly value: "link";
+            }, {
+                readonly label: "destructive";
+                readonly value: "destructive";
+            }];
+        };
+        readonly size: {
+            readonly type: "select";
+            readonly options: readonly [{
+                readonly label: "default";
+                readonly value: "default";
+            }, {
+                readonly label: "sm";
+                readonly value: "sm";
+            }, {
+                readonly label: "lg";
+                readonly value: "lg";
+            }, {
+                readonly label: "icon";
+                readonly value: "icon";
+            }];
+        };
+        readonly icon: {
+            type: "custom";
+            render: typeof IconPickerField;
+        };
+    };
+};
+export declare const buttonDefaults: {
+    readonly label: "Button";
+    readonly action: {
+        readonly type: "page";
+        readonly pageUrl: "";
+        readonly externalUrl: "";
+        readonly openInNewTab: "false";
+        readonly email: "";
+        readonly subject: "";
+        readonly phone: "";
+        readonly sectionId: "";
+        readonly downloadUrl: "";
+    };
+    readonly variant: "default";
+    readonly size: "default";
+    readonly icon: "none";
+};
+export declare const buttonsField: {
+    readonly type: "array";
+    readonly max: 3;
+    readonly getItemSummary: (item: {
+        label?: string;
+    }, index?: number) => string;
+    readonly arrayFields: {
+        readonly label: {
+            readonly type: "text";
+        };
+        readonly action: {
+            type: "custom";
+            label: string;
+            render: typeof ActionField;
+        };
+        readonly variant: {
+            readonly type: "select";
+            readonly options: readonly [{
+                readonly label: "primary";
+                readonly value: "default";
+            }, {
+                readonly label: "secondary";
+                readonly value: "secondary";
+            }, {
+                readonly label: "outline";
+                readonly value: "outline";
+            }, {
+                readonly label: "ghost";
+                readonly value: "ghost";
+            }, {
+                readonly label: "link";
+                readonly value: "link";
+            }, {
+                readonly label: "destructive";
+                readonly value: "destructive";
+            }];
+        };
+        readonly size: {
+            readonly type: "select";
+            readonly options: readonly [{
+                readonly label: "default";
+                readonly value: "default";
+            }, {
+                readonly label: "sm";
+                readonly value: "sm";
+            }, {
+                readonly label: "lg";
+                readonly value: "lg";
+            }, {
+                readonly label: "icon";
+                readonly value: "icon";
+            }];
+        };
+        readonly icon: {
+            type: "custom";
+            render: typeof IconPickerField;
+        };
+    };
+    readonly defaultItemProps: {
+        readonly label: "Button";
+        readonly action: {
+            readonly type: "page";
+            readonly pageUrl: "";
+            readonly externalUrl: "";
+            readonly openInNewTab: "false";
+            readonly email: "";
+            readonly subject: "";
+            readonly phone: "";
+            readonly sectionId: "";
+            readonly downloadUrl: "";
+        };
+        readonly variant: "default";
+        readonly size: "default";
+        readonly icon: "none";
+    };
+    readonly ai: {
+        readonly instructions: "Buttons must use the same size";
+    };
+};
+export type BadgeVariant = "default" | "secondary" | "destructive" | "outline";
+export interface BaseBadge {
+    label: string;
+    action?: Action;
+    variant?: BadgeVariant;
+}
+export declare const badgeField: {
+    readonly type: "object";
+    readonly objectFields: {
+        readonly label: {
+            readonly type: "text";
+        };
+        readonly url: {
+            readonly type: "text";
+        };
+        readonly variant: {
+            readonly type: "select";
+            readonly options: readonly [{
+                readonly label: "default";
+                readonly value: "default";
+            }, {
+                readonly label: "secondary";
+                readonly value: "secondary";
+            }, {
+                readonly label: "destructive";
+                readonly value: "destructive";
+            }, {
+                readonly label: "outline";
+                readonly value: "outline";
+            }];
+        };
+    };
+};
+export interface BaseLink {
+    label: string;
+    action?: Action;
+}
+export interface BaseSocialLink {
+    platform: string;
+    url: string;
+}