@measured/puck 0.20.0-canary.88a4251d → 0.20.0-canary.8c56aa8b

package/dist/index.js

@@ -171,6 +171,7 @@ __export(bundle_exports, {
   createUsePuck: () => createUsePuck,
   migrate: () => migrate,
   overrideKeys: () => overrideKeys,
+  registerOverlayPortal: () => registerOverlayPortal,
   renderContext: () => renderContext,
   resolveAllData: () => resolveAllData,
   transformProps: () => transformProps,
@@ -203,8 +204,9 @@ var overrideKeys = [
   "headerActions",
   "fields",
   "fieldLabel",
-  "components",
-  "componentItem",
+  "drawer",
+  "drawerItem",
+  "componentOverlay",
   "outline",
   "puck",
   "preview"
@@ -4465,7 +4467,7 @@ var import_react25 = require("react");
 
 // css-module:/home/runner/work/puck/puck/packages/core/components/DraggableComponent/styles.module.css#css-module
 init_react_import();
-var styles_module_default11 = { "DraggableComponent": "_DraggableComponent_qzbgx_1", "DraggableComponent-overlay": "_DraggableComponent-overlay_qzbgx_12", "DraggableComponent-loadingOverlay": "_DraggableComponent-loadingOverlay_qzbgx_29", "DraggableComponent--hover": "_DraggableComponent--hover_qzbgx_45", "DraggableComponent--isLocked": "_DraggableComponent--isLocked_qzbgx_45", "DraggableComponent--isSelected": "_DraggableComponent--isSelected_qzbgx_54", "DraggableComponent-actionsOverlay": "_DraggableComponent-actionsOverlay_qzbgx_66", "DraggableComponent-actions": "_DraggableComponent-actions_qzbgx_66" };
+var styles_module_default11 = { "DraggableComponent": "_DraggableComponent_1vaqy_1", "DraggableComponent-overlayWrapper": "_DraggableComponent-overlayWrapper_1vaqy_12", "DraggableComponent-overlay": "_DraggableComponent-overlay_1vaqy_12", "DraggableComponent-loadingOverlay": "_DraggableComponent-loadingOverlay_1vaqy_34", "DraggableComponent--hover": "_DraggableComponent--hover_1vaqy_50", "DraggableComponent--isSelected": "_DraggableComponent--isSelected_1vaqy_57", "DraggableComponent-actionsOverlay": "_DraggableComponent-actionsOverlay_1vaqy_71", "DraggableComponent-actions": "_DraggableComponent-actions_1vaqy_71" };
 
 // components/DraggableComponent/index.tsx
 var import_react_dom2 = require("react-dom");
@@ -4619,6 +4621,9 @@ var DefaultActionBar = ({
   ] }),
   /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(ActionBar.Group, { children })
 ] });
+var DefaultOverlay = ({
+  children
+}) => /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(import_jsx_runtime20.Fragment, { children });
 var DraggableComponent = ({
   children,
   depth,
@@ -4812,9 +4817,16 @@ var DraggableComponent = ({
     () => overrides.actionBar || DefaultActionBar,
     [overrides.actionBar]
   );
+  const CustomOverlay = (0, import_react25.useMemo)(
+    () => overrides.componentOverlay || DefaultOverlay,
+    [overrides.componentOverlay]
+  );
   const onClick = (0, import_react25.useCallback)(
     (e) => {
-      e.stopPropagation();
+      const el = e.target;
+      if (!el.closest("[data-puck-overlay-portal]")) {
+        e.stopPropagation();
+      }
       dispatch({
         type: "setUi",
         ui: {
@@ -5054,7 +5066,16 @@ var DraggableComponent = ({
                 )
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: getClassName16("overlay") })
+            /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: getClassName16("overlayWrapper"), children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)(
+              CustomOverlay,
+              {
+                componentId: id,
+                componentType,
+                hover,
+                isSelected,
+                children: /* @__PURE__ */ (0, import_jsx_runtime20.jsx)("div", { className: getClassName16("overlay") })
+              }
+            ) })
           ]
         }
       ),
@@ -5563,13 +5584,14 @@ var DropZoneChild = ({
   let label = (_b = (_a = componentConfig == null ? void 0 : componentConfig.label) != null ? _a : item == null ? void 0 : item.type.toString()) != null ? _b : "Component";
   const renderPreview = (0, import_react34.useMemo)(
     () => function Preview3() {
+      var _a2;
       if (item && "element" in item && item.element) {
         return (
           // Safe to use this since the HTML is set by the user
           /* @__PURE__ */ (0, import_jsx_runtime25.jsx)("div", { dangerouslySetInnerHTML: { __html: item.element.outerHTML } })
         );
       }
-      return /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(DrawerItemInner, { name: label, children: overrides.componentItem });
+      return /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(DrawerItemInner, { name: label, children: (_a2 = overrides.componentItem) != null ? _a2 : overrides.drawerItem });
     },
     [componentId, label, overrides]
   );
@@ -6765,7 +6787,7 @@ Drawer.Item = DrawerItem;
 
 // components/Puck/index.tsx
 init_react_import();
-var import_react58 = require("react");
+var import_react59 = require("react");
 
 // components/SidebarSection/index.tsx
 init_react_import();
@@ -7010,7 +7032,7 @@ init_react_import();
 
 // lib/use-component-list.tsx
 init_react_import();
-var import_react42 = require("react");
+var import_react43 = require("react");
 
 // components/ComponentList/index.tsx
 init_react_import();
@@ -7020,19 +7042,28 @@ init_react_import();
 var styles_module_default16 = { "ComponentList": "_ComponentList_1rrlt_1", "ComponentList--isExpanded": "_ComponentList--isExpanded_1rrlt_5", "ComponentList-content": "_ComponentList-content_1rrlt_9", "ComponentList-title": "_ComponentList-title_1rrlt_17", "ComponentList-titleIcon": "_ComponentList-titleIcon_1rrlt_53" };
 
 // components/ComponentList/index.tsx
+var import_react42 = require("react");
 var import_jsx_runtime30 = require("react/jsx-runtime");
 var getClassName21 = get_class_name_factory_default("ComponentList", styles_module_default16);
 var ComponentListItem = ({
   name,
   label
 }) => {
+  var _a;
   const overrides = useAppStore((s) => s.overrides);
   const canInsert = useAppStore(
     (s) => s.permissions.getPermissions({
       type: name
     }).insert
   );
-  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(Drawer.Item, { label, name, isDragDisabled: !canInsert, children: overrides.componentItem });
+  (0, import_react42.useEffect)(() => {
+    if (overrides.componentItem) {
+      console.warn(
+        "The `componentItem` override has been deprecated and renamed to `drawerItem`"
+      );
+    }
+  }, [overrides]);
+  return /* @__PURE__ */ (0, import_jsx_runtime30.jsx)(Drawer.Item, { label, name, isDragDisabled: !canInsert, children: (_a = overrides.componentItem) != null ? _a : overrides.drawerItem });
 };
 var ComponentList = ({
   children,
@@ -7081,10 +7112,10 @@ ComponentList.Item = ComponentListItem;
 // lib/use-component-list.tsx
 var import_jsx_runtime31 = require("react/jsx-runtime");
 var useComponentList = () => {
-  const [componentList, setComponentList] = (0, import_react42.useState)();
+  const [componentList, setComponentList] = (0, import_react43.useState)();
   const config = useAppStore((s) => s.config);
   const uiComponentList = useAppStore((s) => s.state.ui.componentList);
-  (0, import_react42.useEffect)(() => {
+  (0, import_react43.useEffect)(() => {
     var _a, _b, _c;
     if (Object.keys(uiComponentList).length > 0) {
       const matchedComponents = [];
@@ -7153,22 +7184,29 @@ var useComponentList = () => {
 };
 
 // components/Puck/components/Components/index.tsx
-var import_react43 = require("react");
+var import_react44 = require("react");
 var import_jsx_runtime32 = require("react/jsx-runtime");
 var Components = () => {
   const overrides = useAppStore((s) => s.overrides);
   const componentList = useComponentList();
-  const Wrapper = (0, import_react43.useMemo)(() => overrides.components || "div", [overrides]);
+  const Wrapper = (0, import_react44.useMemo)(() => {
+    if (overrides.components) {
+      console.warn(
+        "The `components` override has been deprecated and renamed to `drawer`"
+      );
+    }
+    return overrides.components || overrides.drawer || "div";
+  }, [overrides]);
   return /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(Wrapper, { children: componentList ? componentList : /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(ComponentList, { id: "all" }) });
 };
 
 // components/Puck/components/Preview/index.tsx
 init_react_import();
-var import_react45 = require("react");
+var import_react46 = require("react");
 
 // components/AutoFrame/index.tsx
 init_react_import();
-var import_react44 = require("react");
+var import_react45 = require("react");
 var import_object_hash = __toESM(require("object-hash"));
 var import_react_dom3 = require("react-dom");
 var import_jsx_runtime33 = require("react/jsx-runtime");
@@ -7221,7 +7259,7 @@ var CopyHostStyles = ({
   onStylesLoaded = () => null
 }) => {
   const { document: doc, window: win } = useFrame();
-  (0, import_react44.useEffect)(() => {
+  (0, import_react45.useEffect)(() => {
     if (!win || !doc) {
       return () => {
       };
@@ -7380,8 +7418,8 @@ var CopyHostStyles = ({
   }, []);
   return /* @__PURE__ */ (0, import_jsx_runtime33.jsx)(import_jsx_runtime33.Fragment, { children });
 };
-var autoFrameContext = (0, import_react44.createContext)({});
-var useFrame = () => (0, import_react44.useContext)(autoFrameContext);
+var autoFrameContext = (0, import_react45.createContext)({});
+var useFrame = () => (0, import_react45.useContext)(autoFrameContext);
 function AutoFrame(_a) {
   var _b = _a, {
     children,
@@ -7402,11 +7440,11 @@ function AutoFrame(_a) {
     "onNotReady",
     "frameRef"
   ]);
-  const [loaded, setLoaded] = (0, import_react44.useState)(false);
-  const [ctx, setCtx] = (0, import_react44.useState)({});
-  const [mountTarget, setMountTarget] = (0, import_react44.useState)();
-  const [stylesLoaded, setStylesLoaded] = (0, import_react44.useState)(false);
-  (0, import_react44.useEffect)(() => {
+  const [loaded, setLoaded] = (0, import_react45.useState)(false);
+  const [ctx, setCtx] = (0, import_react45.useState)({});
+  const [mountTarget, setMountTarget] = (0, import_react45.useState)();
+  const [stylesLoaded, setStylesLoaded] = (0, import_react45.useState)(false);
+  (0, import_react45.useEffect)(() => {
     var _a2;
     if (frameRef.current) {
       const doc = frameRef.current.contentDocument;
@@ -7458,7 +7496,7 @@ var import_jsx_runtime34 = require("react/jsx-runtime");
 var getClassName22 = get_class_name_factory_default("PuckPreview", styles_module_default17);
 var useBubbleIframeEvents = (ref) => {
   const status = useAppStore((s) => s.status);
-  (0, import_react45.useEffect)(() => {
+  (0, import_react46.useEffect)(() => {
     if (ref.current && status === "READY") {
       const iframe = ref.current;
       const handlePointerMove = (event) => {
@@ -7507,7 +7545,7 @@ var Preview2 = ({ id = "puck-preview" }) => {
   const renderData = useAppStore(
     (s) => s.state.ui.previewMode === "edit" ? null : s.state.data
   );
-  const Page = (0, import_react45.useCallback)(
+  const Page = (0, import_react46.useCallback)(
     (pageProps) => {
       var _a, _b;
       const propsWithSlots = useSlots(
@@ -7521,9 +7559,9 @@ var Preview2 = ({ id = "puck-preview" }) => {
     },
     [config]
   );
-  const Frame = (0, import_react45.useMemo)(() => overrides.iframe, [overrides]);
+  const Frame = (0, import_react46.useMemo)(() => overrides.iframe, [overrides]);
   const rootProps = root.props || root;
-  const ref = (0, import_react45.useRef)(null);
+  const ref = (0, import_react46.useRef)(null);
   useBubbleIframeEvents(ref);
   const inner = !renderData ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
     Page,
@@ -7538,7 +7576,7 @@ var Preview2 = ({ id = "puck-preview" }) => {
       children: /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(DropZonePure, { zone: rootDroppableId })
     })
   ) : /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(Render, { data: renderData, config, metadata });
-  (0, import_react45.useEffect)(() => {
+  (0, import_react46.useEffect)(() => {
     if (!iframe.enabled) {
       setStatus("READY");
     }
@@ -7549,8 +7587,11 @@ var Preview2 = ({ id = "puck-preview" }) => {
       className: getClassName22(),
       id,
       "data-puck-preview": true,
-      onClick: () => {
-        dispatch({ type: "setUi", ui: { itemSelector: null } });
+      onClick: (e) => {
+        const el = e.target;
+        if (!el.hasAttribute("data-puck-component") && !el.hasAttribute("data-puck-dropzone")) {
+          dispatch({ type: "setUi", ui: { itemSelector: null } });
+        }
       },
       children: iframe.enabled ? /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
         AutoFrame_default,
@@ -7608,7 +7649,7 @@ var scrollIntoView = (el) => {
 };
 
 // components/LayerTree/index.tsx
-var import_react46 = require("react");
+var import_react47 = require("react");
 
 // lib/on-scroll-end.ts
 init_react_import();
@@ -7643,7 +7684,7 @@ var Layer = ({
   const config = useAppStore((s) => s.config);
   const itemSelector = useAppStore((s) => s.state.ui.itemSelector);
   const dispatch = useAppStore((s) => s.dispatch);
-  const setItemSelector = (0, import_react46.useCallback)(
+  const setItemSelector = (0, import_react47.useCallback)(
     (itemSelector2) => {
       dispatch({ type: "setUi", ui: { itemSelector: itemSelector2 } });
     },
@@ -7663,7 +7704,7 @@ var Layer = ({
     )
   );
   const containsZone = zonesForItem.length > 0;
-  const zoneStore = (0, import_react46.useContext)(ZoneStoreContext);
+  const zoneStore = (0, import_react47.useContext)(ZoneStoreContext);
   const isHovering = useContextStore(
     ZoneStoreContext,
     (s) => s.hoveringComponent === itemId
@@ -7790,7 +7831,7 @@ var LayerTree = ({
 };
 
 // components/Puck/components/Outline/index.tsx
-var import_react47 = require("react");
+var import_react48 = require("react");
 
 // lib/data/find-zones-for-area.ts
 init_react_import();
@@ -7808,7 +7849,7 @@ var Outline = () => {
   const rootZones = useAppStore(
     (0, import_shallow8.useShallow)((s) => findZonesForArea(s.state, "root"))
   );
-  const Wrapper = (0, import_react47.useMemo)(() => outlineOverride || "div", [outlineOverride]);
+  const Wrapper = (0, import_react48.useMemo)(() => outlineOverride || "div", [outlineOverride]);
   return /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Wrapper, { children: rootZones.map((zoneCompound) => /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(
     LayerTree,
     {
@@ -7821,11 +7862,11 @@ var Outline = () => {
 
 // components/Puck/components/Canvas/index.tsx
 init_react_import();
-var import_react50 = require("react");
+var import_react51 = require("react");
 
 // components/ViewportControls/index.tsx
 init_react_import();
-var import_react48 = require("react");
+var import_react49 = require("react");
 
 // css-module:/home/runner/work/puck/puck/packages/core/components/ViewportControls/styles.module.css#css-module
 init_react_import();
@@ -7848,8 +7889,8 @@ var ViewportButton = ({
   onClick
 }) => {
   const viewports = useAppStore((s) => s.state.ui.viewports);
-  const [isActive, setIsActive] = (0, import_react48.useState)(false);
-  (0, import_react48.useEffect)(() => {
+  const [isActive, setIsActive] = (0, import_react49.useState)(false);
+  (0, import_react49.useEffect)(() => {
     setIsActive(width === viewports.current.width);
   }, [width, viewports.current.width]);
   return /* @__PURE__ */ (0, import_jsx_runtime37.jsx)("span", { className: getClassNameButton({ isActive }), children: /* @__PURE__ */ (0, import_jsx_runtime37.jsx)(
@@ -7886,7 +7927,7 @@ var ViewportControls = ({
   const defaultsContainAutoZoom = defaultZoomOptions.find(
     (option) => option.value === autoZoom
   );
-  const zoomOptions = (0, import_react48.useMemo)(
+  const zoomOptions = (0, import_react49.useMemo)(
     () => [
       ...defaultZoomOptions,
       ...defaultsContainAutoZoom ? [] : [
@@ -7978,14 +8019,14 @@ var import_shallow9 = require("zustand/react/shallow");
 
 // lib/frame-context.tsx
 init_react_import();
-var import_react49 = require("react");
+var import_react50 = require("react");
 var import_jsx_runtime38 = require("react/jsx-runtime");
-var FrameContext = (0, import_react49.createContext)(null);
+var FrameContext = (0, import_react50.createContext)(null);
 var FrameProvider = ({
   children
 }) => {
-  const frameRef = (0, import_react49.useRef)(null);
-  const value = (0, import_react49.useMemo)(
+  const frameRef = (0, import_react50.useRef)(null);
+  const value = (0, import_react50.useMemo)(
     () => ({
       frameRef
     }),
@@ -7994,7 +8035,7 @@ var FrameProvider = ({
   return /* @__PURE__ */ (0, import_jsx_runtime38.jsx)(FrameContext.Provider, { value, children });
 };
 var useCanvasFrame = () => {
-  const context = (0, import_react49.useContext)(FrameContext);
+  const context = (0, import_react50.useContext)(FrameContext);
   if (context === null) {
     throw new Error("useCanvasFrame must be used within a FrameProvider");
   }
@@ -8042,17 +8083,17 @@ var Canvas = () => {
       viewports: s.state.ui.viewports
     }))
   );
-  const [showTransition, setShowTransition] = (0, import_react50.useState)(false);
-  const isResettingZoomRef = (0, import_react50.useRef)(false);
-  const defaultRender = (0, import_react50.useMemo)(() => {
+  const [showTransition, setShowTransition] = (0, import_react51.useState)(false);
+  const isResettingZoomRef = (0, import_react51.useRef)(false);
+  const defaultRender = (0, import_react51.useMemo)(() => {
     const PuckDefault = ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(import_jsx_runtime39.Fragment, { children });
     return PuckDefault;
   }, []);
-  const CustomPreview = (0, import_react50.useMemo)(
+  const CustomPreview = (0, import_react51.useMemo)(
     () => overrides.preview || defaultRender,
     [overrides]
   );
-  const getFrameDimensions = (0, import_react50.useCallback)(() => {
+  const getFrameDimensions = (0, import_react51.useCallback)(() => {
     if (frameRef.current) {
       const frame = frameRef.current;
       const box = getBox(frame);
@@ -8060,7 +8101,7 @@ var Canvas = () => {
     }
     return { width: 0, height: 0 };
   }, [frameRef]);
-  (0, import_react50.useEffect)(() => {
+  (0, import_react51.useEffect)(() => {
     resetAutoZoom({
       isResettingRef: isResettingZoomRef,
       setShowTransition,
@@ -8076,7 +8117,7 @@ var Canvas = () => {
     resetAutoZoom,
     viewports
   ]);
-  (0, import_react50.useEffect)(() => {
+  (0, import_react51.useEffect)(() => {
     const { height: frameHeight } = getFrameDimensions();
     if (viewports.current.height === "auto") {
       setZoomConfig(__spreadProps(__spreadValues({}, zoomConfig), {
@@ -8084,7 +8125,7 @@ var Canvas = () => {
       }));
     }
   }, [zoomConfig.zoom, getFrameDimensions, setZoomConfig]);
-  (0, import_react50.useEffect)(() => {
+  (0, import_react51.useEffect)(() => {
     if (ZOOM_ON_CHANGE) {
       resetAutoZoom({
         isResettingRef: isResettingZoomRef,
@@ -8094,7 +8135,7 @@ var Canvas = () => {
       });
     }
   }, [viewports.current.width, resetAutoZoom, viewports]);
-  (0, import_react50.useEffect)(() => {
+  (0, import_react51.useEffect)(() => {
     const cb = () => {
       resetAutoZoom({
         isResettingRef: isResettingZoomRef,
@@ -8107,8 +8148,8 @@ var Canvas = () => {
       window.removeEventListener("resize", cb);
     };
   }, [resetAutoZoom]);
-  const [showLoader, setShowLoader] = (0, import_react50.useState)(false);
-  (0, import_react50.useEffect)(() => {
+  const [showLoader, setShowLoader] = (0, import_react51.useState)(false);
+  (0, import_react51.useEffect)(() => {
     setTimeout(() => {
       setShowLoader(true);
     }, 500);
@@ -8120,11 +8161,16 @@ var Canvas = () => {
         ready: status === "READY" || !iframe.enabled || !iframe.waitForStyles,
         showLoader
       }),
-      onClick: () => dispatch({
-        type: "setUi",
-        ui: { itemSelector: null },
-        recordHistory: true
-      }),
+      onClick: (e) => {
+        const el = e.target;
+        if (!el.hasAttribute("data-puck-component") && !el.hasAttribute("data-puck-dropzone")) {
+          dispatch({
+            type: "setUi",
+            ui: { itemSelector: null },
+            recordHistory: true
+          });
+        }
+      },
       children: [
         viewports.controlsVisible && iframe.enabled && /* @__PURE__ */ (0, import_jsx_runtime39.jsx)("div", { className: getClassName25("controls"), children: /* @__PURE__ */ (0, import_jsx_runtime39.jsx)(
           ViewportControls,
@@ -8188,7 +8234,7 @@ var Canvas = () => {
 
 // lib/use-loaded-overrides.ts
 init_react_import();
-var import_react51 = require("react");
+var import_react52 = require("react");
 
 // lib/load-overrides.ts
 init_react_import();
@@ -8227,7 +8273,7 @@ var useLoadedOverrides = ({
   overrides,
   plugins
 }) => {
-  return (0, import_react51.useMemo)(() => {
+  return (0, import_react52.useMemo)(() => {
     return loadOverrides({ overrides, plugins });
   }, [plugins, overrides]);
 };
@@ -8239,14 +8285,14 @@ var DefaultOverride = ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime40
 
 // lib/use-inject-css.ts
 init_react_import();
-var import_react52 = require("react");
+var import_react53 = require("react");
 var styles = ``;
 var useInjectStyleSheet = (initialStyles, iframeEnabled) => {
-  const [el, setEl] = (0, import_react52.useState)();
-  (0, import_react52.useEffect)(() => {
+  const [el, setEl] = (0, import_react53.useState)();
+  (0, import_react53.useEffect)(() => {
     setEl(document.createElement("style"));
   }, []);
-  (0, import_react52.useEffect)(() => {
+  (0, import_react53.useEffect)(() => {
     var _a;
     if (!el || typeof window === "undefined") {
       return;
@@ -8266,10 +8312,10 @@ var useInjectGlobalCss = (iframeEnabled) => {
 
 // lib/use-preview-mode-hotkeys.ts
 init_react_import();
-var import_react53 = require("react");
+var import_react54 = require("react");
 var usePreviewModeHotkeys = () => {
   const appStore = useAppStoreApi();
-  const toggleInteractive = (0, import_react53.useCallback)(() => {
+  const toggleInteractive = (0, import_react54.useCallback)(() => {
     const dispatch = appStore.getState().dispatch;
     dispatch({
       type: "setUi",
@@ -8284,7 +8330,7 @@ var usePreviewModeHotkeys = () => {
 
 // lib/use-puck.ts
 init_react_import();
-var import_react54 = require("react");
+var import_react55 = require("react");
 var import_zustand6 = require("zustand");
 var generateUsePuck = (store) => {
   const history = {
@@ -8317,7 +8363,7 @@ var generateUsePuck = (store) => {
   };
   return storeData;
 };
-var UsePuckStoreContext = (0, import_react54.createContext)(
+var UsePuckStoreContext = (0, import_react55.createContext)(
   null
 );
 var convertToPickedStore = (store) => {
@@ -8331,12 +8377,12 @@ var convertToPickedStore = (store) => {
   };
 };
 var useRegisterUsePuckStore = (appStore) => {
-  const [usePuckStore] = (0, import_react54.useState)(
+  const [usePuckStore] = (0, import_react55.useState)(
     () => (0, import_zustand6.createStore)(
       () => generateUsePuck(convertToPickedStore(appStore.getState()))
     )
   );
-  (0, import_react54.useEffect)(() => {
+  (0, import_react55.useEffect)(() => {
     return appStore.subscribe(
       (store) => convertToPickedStore(store),
       (pickedStore) => {
@@ -8348,7 +8394,7 @@ var useRegisterUsePuckStore = (appStore) => {
 };
 function createUsePuck() {
   return function usePuck2(selector) {
-    const usePuckApi = (0, import_react54.useContext)(UsePuckStoreContext);
+    const usePuckApi = (0, import_react55.useContext)(UsePuckStoreContext);
     if (!usePuckApi) {
       throw new Error("usePuck must be used inside <Puck>.");
     }
@@ -8360,7 +8406,7 @@ function createUsePuck() {
   };
 }
 function usePuck() {
-  (0, import_react54.useEffect)(() => {
+  (0, import_react55.useEffect)(() => {
     console.warn(
       "You're using the `usePuck` method without a selector, which may cause unnecessary re-renders. Replace with `createUsePuck` and provide a selector for improved performance."
     );
@@ -8368,7 +8414,7 @@ function usePuck() {
   return createUsePuck()((s) => s);
 }
 function useGetPuck() {
-  const usePuckApi = (0, import_react54.useContext)(UsePuckStoreContext);
+  const usePuckApi = (0, import_react55.useContext)(UsePuckStoreContext);
   if (!usePuckApi) {
     throw new Error("usePuckGet must be used inside <Puck>.");
   }
@@ -8380,7 +8426,7 @@ var import_fast_deep_equal3 = __toESM(require("fast-deep-equal"));
 
 // components/Puck/components/Header/index.tsx
 init_react_import();
-var import_react55 = require("react");
+var import_react56 = require("react");
 
 // components/MenuBar/index.tsx
 init_react_import();
@@ -8462,7 +8508,7 @@ var HeaderInner = () => {
   } = usePropsContext();
   const dispatch = useAppStore((s) => s.dispatch);
   const appStore = useAppStoreApi();
-  const defaultHeaderRender = (0, import_react55.useMemo)(() => {
+  const defaultHeaderRender = (0, import_react56.useMemo)(() => {
     if (renderHeader) {
       console.warn(
         "`renderHeader` is deprecated. Please use `overrides.header` and the `usePuck` hook instead"
@@ -8477,7 +8523,7 @@ var HeaderInner = () => {
     }
     return DefaultOverride;
   }, [renderHeader]);
-  const defaultHeaderActionsRender = (0, import_react55.useMemo)(() => {
+  const defaultHeaderActionsRender = (0, import_react56.useMemo)(() => {
     if (renderHeaderActions) {
       console.warn(
         "`renderHeaderActions` is deprecated. Please use `overrides.headerActions` and the `usePuck` hook instead."
@@ -8497,7 +8543,7 @@ var HeaderInner = () => {
   const CustomHeaderActions = useAppStore(
     (s) => s.overrides.headerActions || defaultHeaderActionsRender
   );
-  const [menuOpen, setMenuOpen] = (0, import_react55.useState)(false);
+  const [menuOpen, setMenuOpen] = (0, import_react56.useState)(false);
   const rootTitle = useAppStore((s) => {
     var _a, _b;
     const rootData = (_a = s.state.indexes.nodes["root"]) == null ? void 0 : _a.data;
@@ -8507,7 +8553,7 @@ var HeaderInner = () => {
   const rightSideBarVisible = useAppStore(
     (s) => s.state.ui.rightSideBarVisible
   );
-  const toggleSidebars = (0, import_react55.useCallback)(
+  const toggleSidebars = (0, import_react56.useCallback)(
     (sidebar) => {
       const widerViewport = window.matchMedia("(min-width: 638px)").matches;
       const sideBarVisible = sidebar === "left" ? leftSideBarVisible : rightSideBarVisible;
@@ -8610,14 +8656,14 @@ var HeaderInner = () => {
     }
   );
 };
-var Header = (0, import_react55.memo)(HeaderInner);
+var Header = (0, import_react56.memo)(HeaderInner);
 
 // components/Puck/components/Sidebar/index.tsx
 init_react_import();
 
 // components/Puck/components/ResizeHandle/index.tsx
 init_react_import();
-var import_react56 = require("react");
+var import_react57 = require("react");
 
 // css-module:/home/runner/work/puck/puck/packages/core/components/Puck/components/ResizeHandle/styles.module.css#css-module
 init_react_import();
@@ -8634,11 +8680,11 @@ var ResizeHandle = ({
 }) => {
   const { frameRef } = useCanvasFrame();
   const resetAutoZoom = useResetAutoZoom(frameRef);
-  const handleRef = (0, import_react56.useRef)(null);
-  const isDragging = (0, import_react56.useRef)(false);
-  const startX = (0, import_react56.useRef)(0);
-  const startWidth = (0, import_react56.useRef)(0);
-  const handleMouseMove = (0, import_react56.useCallback)(
+  const handleRef = (0, import_react57.useRef)(null);
+  const isDragging = (0, import_react57.useRef)(false);
+  const startX = (0, import_react57.useRef)(0);
+  const startWidth = (0, import_react57.useRef)(0);
+  const handleMouseMove = (0, import_react57.useCallback)(
     (e) => {
       if (!isDragging.current) return;
       const delta = e.clientX - startX.current;
@@ -8649,7 +8695,7 @@ var ResizeHandle = ({
     },
     [onResize, position]
   );
-  const handleMouseUp = (0, import_react56.useCallback)(() => {
+  const handleMouseUp = (0, import_react57.useCallback)(() => {
     var _a;
     if (!isDragging.current) return;
     isDragging.current = false;
@@ -8665,7 +8711,7 @@ var ResizeHandle = ({
     onResizeEnd(finalWidth);
     resetAutoZoom();
   }, [onResizeEnd, resetAutoZoom]);
-  const handleMouseDown = (0, import_react56.useCallback)(
+  const handleMouseDown = (0, import_react57.useCallback)(
     (e) => {
       var _a;
       isDragging.current = true;
@@ -8726,14 +8772,14 @@ var Sidebar = ({
 
 // lib/use-sidebar-resize.ts
 init_react_import();
-var import_react57 = require("react");
+var import_react58 = require("react");
 function useSidebarResize(position, dispatch) {
-  const [width, setWidth] = (0, import_react57.useState)(null);
-  const sidebarRef = (0, import_react57.useRef)(null);
+  const [width, setWidth] = (0, import_react58.useState)(null);
+  const sidebarRef = (0, import_react58.useRef)(null);
   const storeWidth = useAppStore(
     (s) => position === "left" ? s.state.ui.leftSideBarWidth : s.state.ui.rightSideBarWidth
   );
-  (0, import_react57.useEffect)(() => {
+  (0, import_react58.useEffect)(() => {
     if (typeof window !== "undefined" && !storeWidth) {
       try {
         const savedWidths = localStorage.getItem("puck-sidebar-widths");
@@ -8757,12 +8803,12 @@ function useSidebarResize(position, dispatch) {
       }
     }
   }, [dispatch, position, storeWidth]);
-  (0, import_react57.useEffect)(() => {
+  (0, import_react58.useEffect)(() => {
     if (storeWidth !== void 0) {
       setWidth(storeWidth);
     }
   }, [storeWidth]);
-  const handleResizeEnd = (0, import_react57.useCallback)(
+  const handleResizeEnd = (0, import_react58.useCallback)(
     (width2) => {
       dispatch({
         type: "setUi",
@@ -8817,11 +8863,11 @@ var FieldSideBar = () => {
   );
   return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(SidebarSection, { noPadding: true, noBorderTop: true, showBreadcrumbs: true, title, children: /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(Fields, {}) });
 };
-var propsContext = (0, import_react58.createContext)({});
+var propsContext = (0, import_react59.createContext)({});
 function PropsProvider(props) {
   return /* @__PURE__ */ (0, import_jsx_runtime45.jsx)(propsContext.Provider, { value: props, children: props.children });
 }
-var usePropsContext = () => (0, import_react58.useContext)(propsContext);
+var usePropsContext = () => (0, import_react59.useContext)(propsContext);
 function PuckProvider({ children }) {
   const {
     config,
@@ -8837,14 +8883,14 @@ function PuckProvider({ children }) {
     metadata,
     onAction
   } = usePropsContext();
-  const iframe = (0, import_react58.useMemo)(
+  const iframe = (0, import_react59.useMemo)(
     () => __spreadValues({
       enabled: true,
       waitForStyles: true
     }, _iframe),
     [_iframe]
   );
-  const [generatedAppState] = (0, import_react58.useState)(() => {
+  const [generatedAppState] = (0, import_react59.useState)(() => {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const initial = __spreadValues(__spreadValues({}, defaultAppState.ui), initialUi);
     let clientUiState = {};
@@ -8873,7 +8919,7 @@ function PuckProvider({ children }) {
       }
     }
     if (Object.keys((initialData == null ? void 0 : initialData.root) || {}).length > 0 && !((_g = initialData == null ? void 0 : initialData.root) == null ? void 0 : _g.props)) {
-      console.error(
+      console.warn(
         "Warning: Defining props on `root` is deprecated. Please use `root.props`, or republish this page to migrate automatically."
       );
     }
@@ -8904,7 +8950,7 @@ function PuckProvider({ children }) {
     return walkAppState(newAppState, config);
   });
   const { appendData = true } = _initialHistory || {};
-  const [blendedHistories] = (0, import_react58.useState)(
+  const [blendedHistories] = (0, import_react59.useState)(
     [
       ...(_initialHistory == null ? void 0 : _initialHistory.histories) || [],
       ...appendData ? [{ state: generatedAppState }] : []
@@ -8924,7 +8970,7 @@ function PuckProvider({ children }) {
     overrides,
     plugins
   });
-  const generateAppStore = (0, import_react58.useCallback)(
+  const generateAppStore = (0, import_react59.useCallback)(
     (state) => {
       return {
         state,
@@ -8948,15 +8994,15 @@ function PuckProvider({ children }) {
       metadata
     ]
   );
-  const [appStore] = (0, import_react58.useState)(
+  const [appStore] = (0, import_react59.useState)(
     () => createAppStore(generateAppStore(initialAppState))
   );
-  (0, import_react58.useEffect)(() => {
+  (0, import_react59.useEffect)(() => {
     if (process.env.NODE_ENV !== "production") {
       window.__PUCK_INTERNAL_DO_NOT_USE = { appStore };
     }
   }, [appStore]);
-  (0, import_react58.useEffect)(() => {
+  (0, import_react59.useEffect)(() => {
     const state = appStore.getState().state;
     appStore.setState(__spreadValues({}, generateAppStore(state)));
   }, [config, plugins, loadedOverrides, viewports, iframe, onAction, metadata]);
@@ -8965,8 +9011,8 @@ function PuckProvider({ children }) {
     index: initialHistoryIndex,
     initialAppState
   });
-  const previousData = (0, import_react58.useRef)(null);
-  (0, import_react58.useEffect)(() => {
+  const previousData = (0, import_react59.useRef)(null);
+  (0, import_react59.useEffect)(() => {
     appStore.subscribe(
       (s) => s.state.data,
       (data) => {
@@ -8980,7 +9026,7 @@ function PuckProvider({ children }) {
   }, []);
   useRegisterPermissionsSlice(appStore, permissions);
   const uPuckStore = useRegisterUsePuckStore(appStore);
-  (0, import_react58.useEffect)(() => {
+  (0, import_react59.useEffect)(() => {
     const { resolveAndCommitData } = appStore.getState();
     resolveAndCommitData();
   }, []);
@@ -8992,7 +9038,7 @@ function PuckLayout({ children }) {
     dnd,
     initialHistory: _initialHistory
   } = usePropsContext();
-  const iframe = (0, import_react58.useMemo)(
+  const iframe = (0, import_react59.useMemo)(
     () => __spreadValues({
       enabled: true,
       waitForStyles: true
@@ -9017,7 +9063,7 @@ function PuckLayout({ children }) {
     sidebarRef: rightSidebarRef,
     handleResizeEnd: handleRightSidebarResizeEnd
   } = useSidebarResize("right", dispatch);
-  (0, import_react58.useEffect)(() => {
+  (0, import_react59.useEffect)(() => {
     if (!window.matchMedia("(min-width: 638px)").matches) {
       dispatch({
         type: "setUi",
@@ -9041,17 +9087,17 @@ function PuckLayout({ children }) {
     };
   }, []);
   const overrides = useAppStore((s) => s.overrides);
-  const CustomPuck = (0, import_react58.useMemo)(
+  const CustomPuck = (0, import_react59.useMemo)(
     () => overrides.puck || DefaultOverride,
     [overrides]
   );
-  const [mounted, setMounted] = (0, import_react58.useState)(false);
-  (0, import_react58.useEffect)(() => {
+  const [mounted, setMounted] = (0, import_react59.useState)(false);
+  (0, import_react59.useEffect)(() => {
     setMounted(true);
   }, []);
   const ready = useAppStore((s) => s.status === "READY");
   useMonitorHotkeys();
-  (0, import_react58.useEffect)(() => {
+  (0, import_react59.useEffect)(() => {
     if (ready && iframe.enabled) {
       const frameDoc = getFrame();
       if (frameDoc) {
@@ -9288,6 +9334,36 @@ function transformProps(data, propTransforms, config = { components: {} }) {
   return updatedData;
 }
 
+// lib/overlay-portal/index.tsx
+init_react_import();
+var registerOverlayPortal = (el, opts = {}) => {
+  if (!el) return;
+  const { disableDrag = true } = opts;
+  const stopPropagation = (e) => {
+    e.stopPropagation();
+  };
+  el.addEventListener("mouseover", stopPropagation, {
+    capture: true
+  });
+  if (disableDrag) {
+    el.addEventListener("pointerdown", stopPropagation, {
+      capture: true
+    });
+  }
+  el.setAttribute("data-puck-overlay-portal", "true");
+  return () => {
+    el.removeEventListener("mouseover", stopPropagation, {
+      capture: true
+    });
+    if (disableDrag) {
+      el.removeEventListener("pointerdown", stopPropagation, {
+        capture: true
+      });
+    }
+    el.removeAttribute("data-puck-overlay-portal");
+  };
+};
+
 // lib/resolve-all-data.ts
 init_react_import();
 
@@ -9366,6 +9442,7 @@ function resolveAllData(_0, _1) {
   createUsePuck,
   migrate,
   overrideKeys,
+  registerOverlayPortal,
   renderContext,
   resolveAllData,
   transformProps,