dune-react 0.0.19 → 0.0.20

package/dist/components/puck-core/core/types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ⚠️ 兼容转发层 — 真正的定义已迁移到 ./props/ 目录
+ *
+ * 本文件保留所有原有导出名称，确保现有 import 不需要修改。
+ * 新代码请直接从 "./props" 导入。
+ */
+export { type IconName, type ActionType, type Action, resolveActionUrl, } from "./props/interactive";
+export { type Feature } from "./props/content";

package/dist/components/puck-core/core/utils.d.ts

@@ -0,0 +1,5 @@
+export declare function getRandomAdjective(arr?: string[]): string;
+/**
+ * 在 Puck 数据树中（content + zones）查找指定 ID 的组件。
+ */
+export declare function findComponentById(data: any, componentId: string): any | null;

package/dist/components/puck-core/core/with-editable.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentType } from "react";
+interface EditableConfig {
+    type: string;
+    fields: Record<string, any>;
+}
+/**
+ * HOC: wraps any component to be inline-editable in Puck editor mode.
+ *
+ * Location strategy:
+ *   1. componentId  — read from the nearest `[data-puck-component]` ancestor in the DOM.
+ *   2. propPath     — search only within that single component's props (narrow scope).
+ */
+export declare function withEditable<P extends Record<string, any>>(Component: ComponentType<P>, config: EditableConfig): (props: P & {
+    onEdit?: (props: P, onSave: (updated: Partial<P>) => void) => void;
+}) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/puck-core/editor-context.d.ts

@@ -0,0 +1,25 @@
+import { type RefObject } from "react";
+export type SitePage = {
+    /** 页面 slug，如 "about"、"pricing"，用作路由值 */
+    slug: string;
+    /** 页面显示名，如 "关于我们"、"定价" */
+    label: string;
+};
+type EditorContextValue = {
+    openFieldsPanel: (componentId: string, componentType: string) => void;
+    openAddSection: (index: number, zone: string) => void;
+    isEditor: boolean;
+    toolbarPortalRef: RefObject<HTMLDivElement | null> | null;
+    fetchLibraryImages?: () => Promise<string[]>;
+    /** 站点 ID，用于表单提交等业务接口 */
+    siteId?: string;
+    /** 后台 API 域名，如 https://api.example.com */
+    domain?: string;
+    /** 站内可选页面列表，用于 url 字段快捷选择 */
+    sitePages?: SitePage[];
+    /** Google Maps API Key，用于 LocationField 地址搜索 */
+    googleMapsApiKey?: string;
+};
+export declare const EditorContextProvider: import("react").Provider<EditorContextValue>;
+export declare const useEditorContext: () => EditorContextValue;
+export {};

package/dist/components/puck-core/editor-context.js

@@ -0,0 +1,15 @@
+"use client";
+import { useContext, createContext } from "react";
+const EditorContext = createContext({
+  openFieldsPanel: () => {
+  },
+  openAddSection: () => {
+  },
+  isEditor: false,
+  toolbarPortalRef: null
+});
+EditorContext.Provider;
+const useEditorContext = () => useContext(EditorContext);
+export {
+  useEditorContext
+};

package/dist/components/puck-core/error-boundary.d.ts

@@ -0,0 +1,4 @@
+import { ReactNode } from "react";
+export declare function ErrorBoundary({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/puck-core/fields/action-field.d.ts

@@ -0,0 +1,30 @@
+import { Action, ActionType } from "../core/types";
+export interface ActionTypeFieldProps {
+    /** 表单字段名前缀，会拼到各子 input 的 name 上 */
+    name: string;
+    /** 当前完整的 Action 对象（子组件只读写与自己 type 相关的字段） */
+    value: Action;
+    /** 合并局部 patch 到 Action，由父组件负责与完整 state 合并 */
+    onChange: (patch: Partial<Action>) => void;
+}
+/** 完整 Action 编辑器（含类型切换 + 子字段） */
+interface ActionFieldProps {
+    name: string;
+    value: Action | undefined;
+    /** 传出合并后的完整 Action */
+    onChange: (value: Action) => void;
+}
+/** 类型 Tab 的展示文案与值（可在外部自定义 UI 时复用） */
+export declare const ACTION_TYPE_OPTIONS: {
+    label: string;
+    value: ActionType;
+}[];
+export declare const PageActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const ExternalActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const EmailActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const PhoneActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const SectionActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const DownloadActionFields: import("react").NamedExoticComponent<ActionTypeFieldProps>;
+export declare const ACTION_TYPE_FIELD_MAP: Partial<Record<ActionType, React.ComponentType<ActionTypeFieldProps>>>;
+export declare function ActionField({ name, value, onChange }: ActionFieldProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/puck-core/fields/action-field.js

@@ -0,0 +1,265 @@
+"use client";
+import { jsxs, jsx, Fragment } from "react/jsx-runtime";
+import { useCallback, memo } from "react";
+import { Input } from "../../shadcn/input.js";
+import { Label } from "../../shadcn/label.js";
+import { Tabs, TabsList, TabsTrigger } from "../../shadcn/tabs.js";
+import { LinkIcon, XIcon, GlobeIcon } from "lucide-react";
+import { useEditorContext } from "../editor-context.js";
+const ACTION_TYPE_OPTIONS = [
+  { label: "Page Link", value: "page" },
+  { label: "External Link", value: "external" },
+  { label: "Email", value: "email" },
+  { label: "Phone", value: "phone" },
+  { label: "Page Section", value: "section" },
+  { label: "Download", value: "download" },
+  { label: "None", value: "none" }
+];
+const PageActionFields = memo(function PageActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  const { sitePages } = useEditorContext();
+  const pages = sitePages ?? [];
+  const pageUrl = value.pageUrl ?? "";
+  const selectedSlug = pageUrl.startsWith("/") ? pageUrl.slice(1) : null;
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3", children: [
+    /* @__PURE__ */ jsx(Label, { children: "Page URL" }),
+    /* @__PURE__ */ jsx("div", { className: "flex items-center gap-2", children: /* @__PURE__ */ jsxs("div", { className: "flex flex-1 items-center gap-2 rounded-lg border px-3 py-2", children: [
+      /* @__PURE__ */ jsx(LinkIcon, { className: "text-muted-foreground size-4 shrink-0" }),
+      /* @__PURE__ */ jsx(
+        "input",
+        {
+          name: `${name}.pageUrl`,
+          className: "w-full bg-transparent text-sm outline-none placeholder:text-muted-foreground",
+          placeholder: "/about",
+          value: pageUrl,
+          onChange: (e) => onChange({ pageUrl: e.target.value })
+        }
+      ),
+      pageUrl && /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          className: "text-muted-foreground hover:text-foreground shrink-0",
+          onClick: () => onChange({ pageUrl: "" }),
+          children: /* @__PURE__ */ jsx(XIcon, { className: "size-3.5" })
+        }
+      )
+    ] }) }),
+    pages.length > 0 && /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
+      /* @__PURE__ */ jsx("span", { className: "text-muted-foreground text-xs font-medium", children: "Site pages" }),
+      /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2", children: pages.map((page) => {
+        const isSelected = selectedSlug === page.slug;
+        return /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            className: `inline-flex items-center gap-1.5 rounded-full border px-3 py-1 text-xs font-medium transition-colors ${isSelected ? "border-primary bg-primary text-primary-foreground" : "border-border bg-background text-foreground hover:bg-accent"}`,
+            onClick: () => onChange({ pageUrl: isSelected ? "" : `${page.slug}` }),
+            children: [
+              /* @__PURE__ */ jsx(GlobeIcon, { className: "size-3" }),
+              page.label
+            ]
+          },
+          page.slug
+        );
+      }) })
+    ] })
+  ] });
+});
+const ExternalActionFields = memo(function ExternalActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+      /* @__PURE__ */ jsx(Label, { children: "External URL" }),
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          name: `${name}.externalUrl`,
+          className: "h-8 text-sm",
+          value: value.externalUrl ?? "",
+          onChange: (e) => onChange({ externalUrl: e.target.value }),
+          placeholder: "https://example.com"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("fieldset", { className: "flex flex-col gap-1.5", children: [
+      /* @__PURE__ */ jsx(Label, { children: "Open in new tab" }),
+      /* @__PURE__ */ jsxs("div", { className: "flex gap-3", children: [
+        /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-1.5 text-sm", children: [
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              type: "radio",
+              name: `${name}.openInNewTab`,
+              value: "true",
+              checked: value.openInNewTab === "true",
+              onChange: () => onChange({ openInNewTab: "true" })
+            }
+          ),
+          "Yes"
+        ] }),
+        /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-1.5 text-sm", children: [
+          /* @__PURE__ */ jsx(
+            "input",
+            {
+              type: "radio",
+              name: `${name}.openInNewTab`,
+              value: "false",
+              checked: value.openInNewTab !== "true",
+              onChange: () => onChange({ openInNewTab: "false" })
+            }
+          ),
+          "No"
+        ] })
+      ] })
+    ] })
+  ] });
+});
+const EmailActionFields = memo(function EmailActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+      /* @__PURE__ */ jsx(Label, { children: "Email" }),
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          name: `${name}.email`,
+          className: "h-8 text-sm",
+          value: value.email ?? "",
+          onChange: (e) => onChange({ email: e.target.value }),
+          placeholder: "hello@example.com"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+      /* @__PURE__ */ jsx(Label, { children: "Subject" }),
+      /* @__PURE__ */ jsx(
+        Input,
+        {
+          name: `${name}.subject`,
+          className: "h-8 text-sm",
+          value: value.subject ?? "",
+          onChange: (e) => onChange({ subject: e.target.value }),
+          placeholder: "Optional email subject"
+        }
+      )
+    ] })
+  ] });
+});
+const PhoneActionFields = memo(function PhoneActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+    /* @__PURE__ */ jsx(Label, { children: "Phone" }),
+    /* @__PURE__ */ jsx(
+      Input,
+      {
+        name: `${name}.phone`,
+        className: "h-8 text-sm",
+        value: value.phone ?? "",
+        onChange: (e) => onChange({ phone: e.target.value }),
+        placeholder: "+1 234 567 890"
+      }
+    )
+  ] });
+});
+const SectionActionFields = memo(function SectionActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+    /* @__PURE__ */ jsx(Label, { children: "Section ID" }),
+    /* @__PURE__ */ jsx(
+      Input,
+      {
+        name: `${name}.sectionId`,
+        className: "h-8 text-sm",
+        value: value.sectionId ?? "",
+        onChange: (e) => onChange({ sectionId: e.target.value }),
+        placeholder: "#section-id"
+      }
+    )
+  ] });
+});
+const DownloadActionFields = memo(function DownloadActionFields2({
+  name,
+  value,
+  onChange
+}) {
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+    /* @__PURE__ */ jsx(Label, { children: "Download URL" }),
+    /* @__PURE__ */ jsx(
+      Input,
+      {
+        name: `${name}.downloadUrl`,
+        className: "h-8 text-sm",
+        value: value.downloadUrl ?? "",
+        onChange: (e) => onChange({ downloadUrl: e.target.value }),
+        placeholder: "https://example.com/file.pdf"
+      }
+    )
+  ] });
+});
+const ACTION_TYPE_FIELD_MAP = {
+  page: PageActionFields,
+  external: ExternalActionFields,
+  email: EmailActionFields,
+  phone: PhoneActionFields,
+  section: SectionActionFields,
+  download: DownloadActionFields
+};
+function ActionField({ name, value, onChange }) {
+  const current = value ?? { type: "none" };
+  const update = useCallback(
+    (patch) => {
+      onChange({ ...current, ...patch });
+    },
+    [current, onChange]
+  );
+  const TypeFields = ACTION_TYPE_FIELD_MAP[current.type];
+  return /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-3", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-1.5", children: [
+      /* @__PURE__ */ jsx(Label, { children: "Action Type" }),
+      /* @__PURE__ */ jsx(
+        Tabs,
+        {
+          value: current.type,
+          onValueChange: (val) => update({ type: val }),
+          children: /* @__PURE__ */ jsx(TabsList, { className: "h-auto w-full flex-wrap justify-start gap-1 p-1 group-data-[orientation=horizontal]/tabs:h-auto", children: ACTION_TYPE_OPTIONS.map((opt) => /* @__PURE__ */ jsx(
+            TabsTrigger,
+            {
+              value: opt.value,
+              className: "h-7 flex-none text-xs",
+              children: opt.label
+            },
+            opt.value
+          )) })
+        }
+      )
+    ] }),
+    TypeFields && /* @__PURE__ */ jsx(TypeFields, { name, value: current, onChange: update })
+  ] });
+}
+export {
+  ACTION_TYPE_FIELD_MAP,
+  ACTION_TYPE_OPTIONS,
+  ActionField,
+  DownloadActionFields,
+  EmailActionFields,
+  ExternalActionFields,
+  PageActionFields,
+  PhoneActionFields,
+  SectionActionFields
+};

package/dist/components/puck-core/fields/auto-field.d.ts

@@ -0,0 +1,2 @@
+import type { AutoFieldProps } from "./types";
+export declare const AutoField: import("react").NamedExoticComponent<AutoFieldProps>;

package/dist/components/puck-core/fields/color-field.d.ts

@@ -0,0 +1,6 @@
+/** 颜色选择器：color swatch + 文本输入 */
+export declare const ColorField: import("react").NamedExoticComponent<{
+    label: string;
+    value: any;
+    onChange: (value: any) => void;
+}>;

package/dist/components/puck-core/fields/icon-picker-field.d.ts

@@ -0,0 +1,8 @@
+export declare function IconPickerField({ value, onChange, }: {
+    field: any;
+    name: string;
+    id: string;
+    value: any;
+    onChange: (value: any) => void;
+    readOnly?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/puck-core/fields/icon-picker-field.js

@@ -0,0 +1,153 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useState, useMemo } from "react";
+import { cn } from "../../../utils/css-utils.js";
+import { Popover, PopoverTrigger, PopoverContent } from "../../shadcn/popover.js";
+import { Command, CommandInput, CommandList, CommandEmpty, CommandGroup, CommandItem } from "../../shadcn/command.js";
+import { ScrollArea } from "../../shadcn/scroll-area.js";
+import { Input } from "../../shadcn/input.js";
+import { Label } from "../../shadcn/label.js";
+import { ICON_MAP, ICON_CATALOG } from "../core/icon-catalog.js";
+import { ChevronDown } from "lucide-react";
+function IconPickerField({
+  value,
+  onChange
+}) {
+  const [open, setOpen] = useState(false);
+  const current = value ?? "none";
+  const [search, setSearch] = useState("");
+  const [manualInput, setManualInput] = useState("");
+  const CurrentIcon = ICON_MAP.get(current);
+  const filteredCatalog = useMemo(() => {
+    const q = search.trim().toLowerCase();
+    if (!q) return ICON_CATALOG;
+    return ICON_CATALOG.map((cat) => ({
+      ...cat,
+      icons: cat.icons.filter((e) => e.name.toLowerCase().includes(q))
+    })).filter((cat) => cat.icons.length > 0);
+  }, [search]);
+  const handleSelect = (name) => {
+    onChange(name);
+    setSearch("");
+    setOpen(false);
+  };
+  const handleManualSubmit = () => {
+    const v = manualInput.trim();
+    if (v) {
+      onChange(v);
+      setManualInput("");
+      setOpen(false);
+    }
+  };
+  return /* @__PURE__ */ jsxs(Popover, { open, onOpenChange: setOpen, children: [
+    /* @__PURE__ */ jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        className: cn(
+          "inline-flex h-8 w-full items-center gap-2 rounded-md border bg-background px-2.5 text-sm",
+          "text-foreground transition-colors hover:bg-accent/50",
+          "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50"
+        ),
+        children: [
+          CurrentIcon ? /* @__PURE__ */ jsx(CurrentIcon, { className: "size-4 shrink-0 text-muted-foreground" }) : /* @__PURE__ */ jsx("span", { className: "size-4 shrink-0 rounded-sm border border-dashed" }),
+          /* @__PURE__ */ jsx("span", { className: "flex-1 truncate text-left", children: current === "none" ? /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "None" }) : current }),
+          /* @__PURE__ */ jsx(ChevronDown, { className: "size-3.5 shrink-0 text-muted-foreground" })
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ jsx(
+      PopoverContent,
+      {
+        className: "w-72 p-0",
+        align: "start",
+        side: "bottom",
+        sideOffset: 4,
+        children: /* @__PURE__ */ jsxs(Command, { shouldFilter: false, children: [
+          /* @__PURE__ */ jsx(
+            CommandInput,
+            {
+              placeholder: "Search icons...",
+              value: search,
+              onValueChange: setSearch
+            }
+          ),
+          /* @__PURE__ */ jsxs(CommandList, { className: "max-h-none overflow-visible", children: [
+            /* @__PURE__ */ jsx(CommandEmpty, { children: "No icons found." }),
+            /* @__PURE__ */ jsxs(ScrollArea, { className: "h-72", children: [
+              /* @__PURE__ */ jsx(CommandGroup, { children: /* @__PURE__ */ jsxs(
+                CommandItem,
+                {
+                  value: "none",
+                  onSelect: () => handleSelect("none"),
+                  "data-checked": current === "none" ? "true" : void 0,
+                  className: "gap-2",
+                  children: [
+                    /* @__PURE__ */ jsx("span", { className: "size-4 shrink-0 rounded-sm border border-dashed" }),
+                    /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "None" })
+                  ]
+                }
+              ) }),
+              filteredCatalog.map((cat) => /* @__PURE__ */ jsx(CommandGroup, { heading: cat.label, children: /* @__PURE__ */ jsx("div", { className: "grid grid-cols-6 gap-0.5 px-1 py-0.5", children: cat.icons.map((entry) => {
+                const IconComp = entry.component;
+                const isSelected = current === entry.name;
+                return /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    title: entry.name,
+                    onClick: () => handleSelect(entry.name),
+                    className: cn(
+                      "flex size-8 items-center justify-center rounded-md transition-colors",
+                      "hover:bg-accent hover:text-accent-foreground",
+                      isSelected && "bg-primary text-primary-foreground hover:bg-primary/90"
+                    ),
+                    "aria-label": entry.name,
+                    "aria-pressed": isSelected,
+                    children: /* @__PURE__ */ jsx(IconComp, { className: "size-4" })
+                  },
+                  entry.name
+                );
+              }) }) }, cat.label))
+            ] }),
+            /* @__PURE__ */ jsxs("div", { className: "border-t p-2", children: [
+              /* @__PURE__ */ jsx(Label, { className: "mb-1 block text-xs text-muted-foreground", children: "Or type any Lucide icon name" }),
+              /* @__PURE__ */ jsxs("div", { className: "flex gap-1.5", children: [
+                /* @__PURE__ */ jsx(
+                  Input,
+                  {
+                    className: "h-7 flex-1 text-xs",
+                    placeholder: "e.g. arrow-right",
+                    value: manualInput,
+                    onChange: (e) => setManualInput(e.target.value),
+                    onKeyDown: (e) => {
+                      if (e.key === "Enter") {
+                        e.preventDefault();
+                        handleManualSubmit();
+                      }
+                    }
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    onClick: handleManualSubmit,
+                    className: cn(
+                      "inline-flex h-7 items-center rounded-md border bg-secondary px-2.5 text-xs font-medium",
+                      "text-secondary-foreground transition-colors hover:bg-secondary/80"
+                    ),
+                    children: "Set"
+                  }
+                )
+              ] })
+            ] })
+          ] })
+        ] })
+      }
+    )
+  ] });
+}
+export {
+  IconPickerField
+};

package/dist/components/puck-core/fields/image-upload-field.d.ts

@@ -0,0 +1,7 @@
+interface ImageUploadFieldProps {
+    name: string;
+    value: string;
+    onChange: (value: string) => void;
+}
+export declare function ImageUploadField({ name, value, onChange, }: ImageUploadFieldProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,8 @@
+export type { FieldDef, AutoFieldProps, FieldsPanelProps } from "./types";
+export { AutoField } from "./auto-field";
+export { ColorField } from "./color-field";
+export { RadioToggleField } from "./radio-toggle-field";
+export { ObjectField } from "./object-field";
+export { VirtualizedSelectField, LARGE_SELECT_THRESHOLD, } from "./virtualized-select-field";
+export { LocationField } from "./location-field";
+export { ActionField, ACTION_TYPE_FIELD_MAP, ACTION_TYPE_OPTIONS, PageActionFields, ExternalActionFields, EmailActionFields, PhoneActionFields, SectionActionFields, DownloadActionFields, type ActionTypeFieldProps, } from "./action-field";

package/dist/components/puck-core/fields/location-field.d.ts

@@ -0,0 +1,44 @@
+import type { MapLocation } from "../core/fields";
+interface GLatLng {
+    lat(): number;
+    lng(): number;
+}
+interface GGeometry {
+    location?: GLatLng;
+}
+interface GPlaceResult {
+    formatted_address?: string;
+    geometry?: GGeometry;
+    place_id?: string;
+    address_components?: unknown[];
+}
+interface GAutocomplete {
+    getPlace(): GPlaceResult;
+    addListener(event: string, handler: () => void): void;
+}
+interface GAutocompleteConstructor {
+    new (input: HTMLInputElement, opts?: Record<string, unknown>): GAutocomplete;
+}
+interface GGoogleMaps {
+    places: {
+        Autocomplete: GAutocompleteConstructor;
+    };
+    event: {
+        clearInstanceListeners(instance: unknown): void;
+    };
+}
+interface GGoogle {
+    maps: GGoogleMaps;
+}
+declare global {
+    interface Window {
+        google?: GGoogle;
+    }
+}
+export interface LocationFieldProps {
+    name: string;
+    value: MapLocation | undefined;
+    onChange: (value: MapLocation) => void;
+}
+export declare const LocationField: import("react").NamedExoticComponent<LocationFieldProps>;
+export {};

package/dist/components/puck-core/fields/object-field.d.ts

@@ -0,0 +1,8 @@
+import type { FieldDef } from "./types";
+/** 嵌套对象字段：按 objectFields 递归渲染子 AutoField，onChange 合并回对象 */
+export declare const ObjectField: import("react").NamedExoticComponent<{
+    field: FieldDef;
+    name: string;
+    value: any;
+    onChange: (value: any) => void;
+}>;

package/dist/components/puck-core/fields/radio-toggle-field.d.ts

@@ -0,0 +1,10 @@
+/** 单选/切换：若选项恰好为 true/false 两个值则渲染开关，否则为 ToggleGroup */
+export declare const RadioToggleField: import("react").NamedExoticComponent<{
+    label: string;
+    options: {
+        label: string;
+        value: any;
+    }[];
+    value: any;
+    onChange: (value: any) => void;
+}>;

package/dist/components/puck-core/fields/types.d.ts

@@ -0,0 +1,29 @@
+import type React from "react";
+export type FieldDef = {
+    type: string;
+    label?: string;
+    options?: {
+        label: string;
+        value: any;
+    }[];
+    arrayFields?: Record<string, FieldDef>;
+    objectFields?: Record<string, FieldDef>;
+    getItemSummary?: (item: any, index: number) => string;
+    defaultItemProps?: Record<string, any>;
+    min?: number;
+    max?: number;
+    render?: React.FC<any>;
+};
+export type AutoFieldProps = {
+    field: FieldDef;
+    name: string;
+    value: any;
+    onChange: (value: any) => void;
+};
+export interface FieldsPanelProps {
+    open: boolean;
+    componentType: string | null;
+    componentData: Record<string, any> | null;
+    onSave: (updatedProps: Record<string, any>) => void;
+    onClose: () => void;
+}