import React from 'react'; /** * Maps one image "version" to the widget-settings keys it writes. The picker * sets `urlField` to the chosen image and, if provided, `widthField`/ * `heightField` to the image's natural dimensions (captured admin-side). * Paths are relative to the widget, e.g. "settings.src" or * "settings.slides.0.mobileImage". */ export interface ImageFieldMapping { urlField: string; widthField?: string; heightField?: string; } interface EditableImageProps { /** Desktop / default image target. */ desktop: ImageFieldMapping; /** * Optional mobile-variant target. When set, the overlay offers a second * "Mobile" action — so a merchant can replace the mobile image, or ADD one * even when the slot currently falls back to the desktop image. */ mobile?: ImageFieldMapping; /** Extra classes for the positioning wrapper (page-builder canvas only). */ className?: string; /** * The slot has no image yet. On the live storefront this renders nothing; in * the page-builder canvas it renders a clickable placeholder so the first * image can be added inline (not only replaced). */ empty?: boolean; /** The real image markup — ``, a ``, or banner's dual * CSS-toggled ``s. Rendered untouched on the live storefront. */ children?: React.ReactNode; } /** * Inline-edit affordance that WRAPS a standalone image slot (banner, * split-feature, product-hero, collection-spotlight, brand-story). On the live * storefront it's a no-op passthrough (`display: contents`). * * For widgets whose image is a full-bleed background with content layered on * top (bento tiles, category mosaic, slideshow), use `EditableImageOverlay` * instead — it drops the same affordance ABOVE the content without wrapping. * * The picker can't live in the iframe (it needs the admin session/GraphQL), so * clicking a target posts an `edit-image` message; the admin shell opens the * FileBrowser and writes the result back through the page-level form — the same * bridge `` uses for text. */ export declare function EditableImage({ desktop, mobile, className, empty, children }: EditableImageProps): React.ReactElement | null; interface EditableImageOverlayProps { desktop: ImageFieldMapping; mobile?: ImageFieldMapping; /** True when the slot has no image yet — switches the label to "Add image". */ empty?: boolean; } /** * Drop-in inline-edit overlay for widgets whose image is a full-bleed * background with content layered on top (bento tiles, category mosaic, * tiered categories, slideshow). Render it as the LAST child of a * `group relative` container; it shows the same hover affordance ABOVE the * content (z-30) and renders nothing on the live storefront. */ export declare function EditableImageOverlay({ desktop, mobile, empty }: EditableImageOverlayProps): React.ReactElement | null; export {};