@ohhwells/bridge 0.1.117 → 0.1.119-next.331

package/dist/index.d.cts

@@ -20,7 +20,14 @@ declare function OhhwellsBridge(): react_jsx_runtime.JSX.Element;
  */
 declare const AI_TREE_SCHEMA_VERSIONS: readonly [1];
 type SectionScaffold = 'stacked' | 'split' | 'overlay';
-type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'form' | 'embed' | 'schedule-widget' | 'group';
+type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group';
+/** media-strip's `items[]` entry shape (rn-mobile-backend's `itemFields` for that block). */
+interface MediaStripItem {
+    assetId: string;
+    alt: string;
+    href?: string;
+    linkTarget?: 'new-tab' | 'same-tab';
+}
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -28,10 +35,12 @@ interface AiBlockNode {
     align?: 'left' | 'center' | 'right';
     slots?: Record<string, unknown>;
     children?: AiBlockNode[];
+    /** Shape is per-block-type, defined by the backend's `BlockDef.itemFields` (accordion's
+     *  question/answer, media-strip's assetId/alt/href/linkTarget). */
     items?: Array<{
         question: string;
         answer: string;
-    }>;
+    } | MediaStripItem>;
     animation?: {
         effect: 'fade-in' | 'fade-in-up' | 'slide-in-left' | 'slide-in-right' | 'zoom-in';
         trigger: 'on-scroll' | 'on-load' | 'on-hover';
@@ -63,6 +72,21 @@ interface AiLayoutTree {
         align?: 'top' | 'center' | 'bottom' | 'stretch';
     }>;
 }
+declare const BUTTON_FILL_TOKENS: readonly ["dark", "primary", "accent", "light"];
+declare const BUTTON_STYLES: readonly ["solid", "outline", "ghost"];
+declare const BUTTON_RADII: readonly ["square", "rounded", "pill"];
+declare const BUTTON_SIZES: readonly ["s", "m", "l"];
+interface ButtonStyle {
+    fill: (typeof BUTTON_FILL_TOKENS)[number];
+    textColor: (typeof BUTTON_FILL_TOKENS)[number];
+    style: (typeof BUTTON_STYLES)[number];
+    radius: (typeof BUTTON_RADII)[number];
+    size: (typeof BUTTON_SIZES)[number];
+}
+interface ButtonStyles {
+    primary: ButtonStyle;
+    secondary: ButtonStyle;
+}
 /** One uploaded weight file for a custom font family. */
 interface AiCustomFontWeight {
     weight: number;
@@ -96,7 +120,20 @@ interface AiBrandKit {
         heading: string;
         body: string;
     };
+    /** Absent on a kit saved before OHH-791 — renderer falls back to today's hardcoded button look. */
+    buttons?: ButtonStyles;
     customFonts?: AiCustomFont[];
+    /** Which parts the user actually set. Absent (kits saved before this field) = both, as ever;
+     *  an unset part is a carried-over template snapshot and must not be written onto the page. */
+    touched?: {
+        palette?: boolean;
+        fonts?: boolean;
+        /** Per variant, the button fields the user set (fill, textColor, style, radius, size). */
+        buttons?: {
+            primary?: (keyof ButtonStyle)[];
+            secondary?: (keyof ButtonStyle)[];
+        };
+    };
 }
 /**
  * Shape, padding and typography measured off a host-template CTA, so generated buttons read as the
@@ -431,9 +468,15 @@ type ItemInteractionLayerProps = {
     chromeGap?: number;
     /** Toolbar alignment over the element; forms hang theirs on the left edge (OHH-642). */
     toolbarAlign?: 'center' | 'left';
+    /**
+     * Parent-scroll hide. `applyToolbarPos` sets `display:none` on this node when the
+     * selection leaves the canvas; React will not clear that on the next selection unless
+     * we own `display` here (same node, same `display:block` in the prev VDOM).
+     */
+    hidden?: boolean;
     className?: string;
 };
-declare function ItemInteractionLayer({ rect, state, elRef, toolbar, toolbarBelowRect, toolbarBelowEl, showHandle, dragDisabled, dragHandleLabel, onDragHandleDragStart, onDragHandleDragEnd, onItemPointerDown, onItemClick, itemDragSurface, chromeGap, toolbarAlign, className, }: ItemInteractionLayerProps): react_jsx_runtime.JSX.Element | null;
+declare function ItemInteractionLayer({ rect, state, elRef, toolbar, toolbarBelowRect, toolbarBelowEl, showHandle, dragDisabled, dragHandleLabel, onDragHandleDragStart, onDragHandleDragEnd, onItemPointerDown, onItemClick, itemDragSurface, chromeGap, toolbarAlign, hidden, className, }: ItemInteractionLayerProps): react_jsx_runtime.JSX.Element | null;
 
 declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenu$1.Root>): react_jsx_runtime.JSX.Element;
 /**
@@ -469,6 +512,16 @@ declare function TooltipContent({ className, sideOffset, side, children, hideArr
     hideArrow?: boolean;
 }): react_jsx_runtime.JSX.Element;
 
+interface EmptySectionProps {
+    title: string;
+    homeHref?: string;
+    /** data-ohw-key values for the editable text nodes — omit a key to leave that node non-editable. */
+    eyebrowKey?: string;
+    titleKey?: string;
+    subtitleKey?: string;
+}
+declare function EmptySection({ title, homeHref, eyebrowKey, titleKey, subtitleKey }: EmptySectionProps): react_jsx_runtime.JSX.Element;
+
 declare function isEditSessionActive(): boolean;
 
 type CarouselSlide = {
@@ -492,4 +545,4 @@ declare function useOhwCarousel(key: string, initial: CarouselSlide[]): {
     bind: Record<string, string>;
 };
 
-export { AI_DEFAULT_BRAND, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buildTarget, dropIndicatorVariants, filterAvailablePages, getEditModeInitialState, isEditSessionActive, isRenderableTree, isValidUrl, parseTarget, toggleVariants, useOhwCarousel, validateUrlInput };
+export { AI_DEFAULT_BRAND, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buildTarget, dropIndicatorVariants, filterAvailablePages, getEditModeInitialState, isEditSessionActive, isRenderableTree, isValidUrl, parseTarget, toggleVariants, useOhwCarousel, validateUrlInput };

package/dist/index.d.ts

@@ -20,7 +20,14 @@ declare function OhhwellsBridge(): react_jsx_runtime.JSX.Element;
  */
 declare const AI_TREE_SCHEMA_VERSIONS: readonly [1];
 type SectionScaffold = 'stacked' | 'split' | 'overlay';
-type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'form' | 'embed' | 'schedule-widget' | 'group';
+type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group';
+/** media-strip's `items[]` entry shape (rn-mobile-backend's `itemFields` for that block). */
+interface MediaStripItem {
+    assetId: string;
+    alt: string;
+    href?: string;
+    linkTarget?: 'new-tab' | 'same-tab';
+}
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -28,10 +35,12 @@ interface AiBlockNode {
     align?: 'left' | 'center' | 'right';
     slots?: Record<string, unknown>;
     children?: AiBlockNode[];
+    /** Shape is per-block-type, defined by the backend's `BlockDef.itemFields` (accordion's
+     *  question/answer, media-strip's assetId/alt/href/linkTarget). */
     items?: Array<{
         question: string;
         answer: string;
-    }>;
+    } | MediaStripItem>;
     animation?: {
         effect: 'fade-in' | 'fade-in-up' | 'slide-in-left' | 'slide-in-right' | 'zoom-in';
         trigger: 'on-scroll' | 'on-load' | 'on-hover';
@@ -63,6 +72,21 @@ interface AiLayoutTree {
         align?: 'top' | 'center' | 'bottom' | 'stretch';
     }>;
 }
+declare const BUTTON_FILL_TOKENS: readonly ["dark", "primary", "accent", "light"];
+declare const BUTTON_STYLES: readonly ["solid", "outline", "ghost"];
+declare const BUTTON_RADII: readonly ["square", "rounded", "pill"];
+declare const BUTTON_SIZES: readonly ["s", "m", "l"];
+interface ButtonStyle {
+    fill: (typeof BUTTON_FILL_TOKENS)[number];
+    textColor: (typeof BUTTON_FILL_TOKENS)[number];
+    style: (typeof BUTTON_STYLES)[number];
+    radius: (typeof BUTTON_RADII)[number];
+    size: (typeof BUTTON_SIZES)[number];
+}
+interface ButtonStyles {
+    primary: ButtonStyle;
+    secondary: ButtonStyle;
+}
 /** One uploaded weight file for a custom font family. */
 interface AiCustomFontWeight {
     weight: number;
@@ -96,7 +120,20 @@ interface AiBrandKit {
         heading: string;
         body: string;
     };
+    /** Absent on a kit saved before OHH-791 — renderer falls back to today's hardcoded button look. */
+    buttons?: ButtonStyles;
     customFonts?: AiCustomFont[];
+    /** Which parts the user actually set. Absent (kits saved before this field) = both, as ever;
+     *  an unset part is a carried-over template snapshot and must not be written onto the page. */
+    touched?: {
+        palette?: boolean;
+        fonts?: boolean;
+        /** Per variant, the button fields the user set (fill, textColor, style, radius, size). */
+        buttons?: {
+            primary?: (keyof ButtonStyle)[];
+            secondary?: (keyof ButtonStyle)[];
+        };
+    };
 }
 /**
  * Shape, padding and typography measured off a host-template CTA, so generated buttons read as the
@@ -431,9 +468,15 @@ type ItemInteractionLayerProps = {
     chromeGap?: number;
     /** Toolbar alignment over the element; forms hang theirs on the left edge (OHH-642). */
     toolbarAlign?: 'center' | 'left';
+    /**
+     * Parent-scroll hide. `applyToolbarPos` sets `display:none` on this node when the
+     * selection leaves the canvas; React will not clear that on the next selection unless
+     * we own `display` here (same node, same `display:block` in the prev VDOM).
+     */
+    hidden?: boolean;
     className?: string;
 };
-declare function ItemInteractionLayer({ rect, state, elRef, toolbar, toolbarBelowRect, toolbarBelowEl, showHandle, dragDisabled, dragHandleLabel, onDragHandleDragStart, onDragHandleDragEnd, onItemPointerDown, onItemClick, itemDragSurface, chromeGap, toolbarAlign, className, }: ItemInteractionLayerProps): react_jsx_runtime.JSX.Element | null;
+declare function ItemInteractionLayer({ rect, state, elRef, toolbar, toolbarBelowRect, toolbarBelowEl, showHandle, dragDisabled, dragHandleLabel, onDragHandleDragStart, onDragHandleDragEnd, onItemPointerDown, onItemClick, itemDragSurface, chromeGap, toolbarAlign, hidden, className, }: ItemInteractionLayerProps): react_jsx_runtime.JSX.Element | null;
 
 declare function DropdownMenu({ ...props }: React.ComponentProps<typeof DropdownMenu$1.Root>): react_jsx_runtime.JSX.Element;
 /**
@@ -469,6 +512,16 @@ declare function TooltipContent({ className, sideOffset, side, children, hideArr
     hideArrow?: boolean;
 }): react_jsx_runtime.JSX.Element;
 
+interface EmptySectionProps {
+    title: string;
+    homeHref?: string;
+    /** data-ohw-key values for the editable text nodes — omit a key to leave that node non-editable. */
+    eyebrowKey?: string;
+    titleKey?: string;
+    subtitleKey?: string;
+}
+declare function EmptySection({ title, homeHref, eyebrowKey, titleKey, subtitleKey }: EmptySectionProps): react_jsx_runtime.JSX.Element;
+
 declare function isEditSessionActive(): boolean;
 
 type CarouselSlide = {
@@ -492,4 +545,4 @@ declare function useOhwCarousel(key: string, initial: CarouselSlide[]): {
     bind: Record<string, string>;
 };
 
-export { AI_DEFAULT_BRAND, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buildTarget, dropIndicatorVariants, filterAvailablePages, getEditModeInitialState, isEditSessionActive, isRenderableTree, isValidUrl, parseTarget, toggleVariants, useOhwCarousel, validateUrlInput };
+export { AI_DEFAULT_BRAND, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buildTarget, dropIndicatorVariants, filterAvailablePages, getEditModeInitialState, isEditSessionActive, isRenderableTree, isValidUrl, parseTarget, toggleVariants, useOhwCarousel, validateUrlInput };