@ohhwells/bridge 0.1.130 → 0.1.131

package/dist/index.d.cts

@@ -20,7 +20,7 @@ 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' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group' | 'link-list' | 'hours' | 'logo' | 'social-row' | 'video';
+type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group' | 'link-list' | 'hours' | 'logo' | 'social-row' | 'video' | 'carousel';
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -58,6 +58,39 @@ interface AiSectionSettings {
     /** Vertical distribution of column content (stacked/split scaffolds). */
     textDistribution?: 'top' | 'center' | 'space-between';
 }
+/**
+ * Next slide a fade carousel should fall back to when the one on screen failed to load (OHH-796),
+ * or `null` when there is nothing useful to move to.
+ *
+ * Pulled out of the effect that drives it so the broken-image fallback is a rule that can be
+ * asserted directly, rather than only reachable by making a real image 404 in a browser. Scans
+ * forward and wraps, so a failure lands on the nearest following slide that still works.
+ *
+ * `null` covers both no-op cases: the current slide is fine, or every slide has failed (in which
+ * case the carousel hides its controls and renders nothing rather than cycling through blanks).
+ */
+declare function nextViableSlide(index: number, failed: ReadonlySet<number>, count: number): number | null;
+/**
+ * Slide indexes a fade carousel can actually show, in order (OHH-796) — every slide whose image has
+ * not failed to load.
+ *
+ * The controls are built from this rather than from the raw child count. A dot per child means a
+ * visitor can click one that only bounces them straight back out (`nextViableSlide` above corrects
+ * a dead current slide the moment it becomes current), and the ticket's all-failed fallback row is
+ * "render the scrim/background only" — which means no chrome either, not chrome over a blank.
+ */
+declare function viableSlides(count: number, failed: ReadonlySet<number>): number[];
+/**
+ * Where a chevron, swipe or arrow key should land from `index`, skipping slides that failed to load
+ * (OHH-796). Returns `index` unchanged when there is nowhere to go — a clamped end under
+ * `loop: false`, or no other viable slide at all.
+ *
+ * `index + 1` stops being good enough once a slide can die: stepping *backwards* onto a dead slide
+ * is immediately corrected *forwards* by `nextViableSlide`, so "previous" past a failure would walk
+ * the visitor the wrong way. Scanning in the direction of travel keeps one press equal to one slide
+ * as the visitor counts them.
+ */
+declare function stepViableSlide(index: number, failed: ReadonlySet<number>, count: number, dir: 1 | -1, loop: boolean): number;
 interface AiLayoutTree {
     schemaVersion: number;
     type: 'section';
@@ -692,4 +725,4 @@ declare function useOhwCarousel(key: string, initial: CarouselSlide[]): {
     bind: Record<string, string>;
 };
 
-export { AI_DEFAULT_BRAND, AI_FOOTER_KEY, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiFooterBottomBar, type AiFooterColumn, type AiFooterLayoutTree, AiFooterRenderer, type AiFooterRendererProps, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, FOOTER_COLUMN_BLOCKS, FOOTER_COLUMN_SPANS, FOOTER_SOCIAL_PLATFORMS, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, type SiteLegalLinks, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, addFooterLinkColumn, appendFooterSocial, buildDefaultFooterTree, buildTarget, dropIndicatorVariants, ensureFooterTree, filterAvailablePages, getEditModeInitialState, insertFooterHours, isEditSessionActive, isRenderableFooterTree, isRenderableTree, isValidUrl, parseAiFooterState, parseTarget, removeFooterBlock, resolveFooterCopyright, serializeAiFooterState, toggleVariants, useOhwCarousel, validateUrlInput };
+export { AI_DEFAULT_BRAND, AI_FOOTER_KEY, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiFooterBottomBar, type AiFooterColumn, type AiFooterLayoutTree, AiFooterRenderer, type AiFooterRendererProps, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, FOOTER_COLUMN_BLOCKS, FOOTER_COLUMN_SPANS, FOOTER_SOCIAL_PLATFORMS, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, type SiteLegalLinks, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, addFooterLinkColumn, appendFooterSocial, buildDefaultFooterTree, buildTarget, dropIndicatorVariants, ensureFooterTree, filterAvailablePages, getEditModeInitialState, insertFooterHours, isEditSessionActive, isRenderableFooterTree, isRenderableTree, isValidUrl, nextViableSlide, parseAiFooterState, parseTarget, removeFooterBlock, resolveFooterCopyright, serializeAiFooterState, stepViableSlide, toggleVariants, useOhwCarousel, validateUrlInput, viableSlides };

package/dist/index.d.ts

@@ -20,7 +20,7 @@ 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' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group' | 'link-list' | 'hours' | 'logo' | 'social-row' | 'video';
+type AiBlockType = 'text' | 'button' | 'media' | 'media-list' | 'rating' | 'divider' | 'input' | 'section-header' | 'button-row' | 'card' | 'collection' | 'accordion' | 'media-strip' | 'form' | 'embed' | 'schedule-widget' | 'group' | 'link-list' | 'hours' | 'logo' | 'social-row' | 'video' | 'carousel';
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -58,6 +58,39 @@ interface AiSectionSettings {
     /** Vertical distribution of column content (stacked/split scaffolds). */
     textDistribution?: 'top' | 'center' | 'space-between';
 }
+/**
+ * Next slide a fade carousel should fall back to when the one on screen failed to load (OHH-796),
+ * or `null` when there is nothing useful to move to.
+ *
+ * Pulled out of the effect that drives it so the broken-image fallback is a rule that can be
+ * asserted directly, rather than only reachable by making a real image 404 in a browser. Scans
+ * forward and wraps, so a failure lands on the nearest following slide that still works.
+ *
+ * `null` covers both no-op cases: the current slide is fine, or every slide has failed (in which
+ * case the carousel hides its controls and renders nothing rather than cycling through blanks).
+ */
+declare function nextViableSlide(index: number, failed: ReadonlySet<number>, count: number): number | null;
+/**
+ * Slide indexes a fade carousel can actually show, in order (OHH-796) — every slide whose image has
+ * not failed to load.
+ *
+ * The controls are built from this rather than from the raw child count. A dot per child means a
+ * visitor can click one that only bounces them straight back out (`nextViableSlide` above corrects
+ * a dead current slide the moment it becomes current), and the ticket's all-failed fallback row is
+ * "render the scrim/background only" — which means no chrome either, not chrome over a blank.
+ */
+declare function viableSlides(count: number, failed: ReadonlySet<number>): number[];
+/**
+ * Where a chevron, swipe or arrow key should land from `index`, skipping slides that failed to load
+ * (OHH-796). Returns `index` unchanged when there is nowhere to go — a clamped end under
+ * `loop: false`, or no other viable slide at all.
+ *
+ * `index + 1` stops being good enough once a slide can die: stepping *backwards* onto a dead slide
+ * is immediately corrected *forwards* by `nextViableSlide`, so "previous" past a failure would walk
+ * the visitor the wrong way. Scanning in the direction of travel keeps one press equal to one slide
+ * as the visitor counts them.
+ */
+declare function stepViableSlide(index: number, failed: ReadonlySet<number>, count: number, dir: 1 | -1, loop: boolean): number;
 interface AiLayoutTree {
     schemaVersion: number;
     type: 'section';
@@ -692,4 +725,4 @@ declare function useOhwCarousel(key: string, initial: CarouselSlide[]): {
     bind: Record<string, string>;
 };
 
-export { AI_DEFAULT_BRAND, AI_FOOTER_KEY, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiFooterBottomBar, type AiFooterColumn, type AiFooterLayoutTree, AiFooterRenderer, type AiFooterRendererProps, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, FOOTER_COLUMN_BLOCKS, FOOTER_COLUMN_SPANS, FOOTER_SOCIAL_PLATFORMS, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, type SiteLegalLinks, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, addFooterLinkColumn, appendFooterSocial, buildDefaultFooterTree, buildTarget, dropIndicatorVariants, ensureFooterTree, filterAvailablePages, getEditModeInitialState, insertFooterHours, isEditSessionActive, isRenderableFooterTree, isRenderableTree, isValidUrl, parseAiFooterState, parseTarget, removeFooterBlock, resolveFooterCopyright, serializeAiFooterState, toggleVariants, useOhwCarousel, validateUrlInput };
+export { AI_DEFAULT_BRAND, AI_FOOTER_KEY, AI_TREE_SCHEMA_VERSIONS, AI_TREE_TOKENS, type AiBlockNode, type AiBrandKit, type AiFooterBottomBar, type AiFooterColumn, type AiFooterLayoutTree, AiFooterRenderer, type AiFooterRendererProps, type AiLayoutTree, AiTreeRenderer, type AiTreeRendererProps, type CarouselSlide, CustomToolbar, CustomToolbarButton, CustomToolbarDivider, DragHandle, DropIndicator, type DropIndicatorProps, DropdownMenu, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptySection, type EmptySectionProps, FOOTER_COLUMN_BLOCKS, FOOTER_COLUMN_SPANS, FOOTER_SOCIAL_PLATFORMS, ItemActionToolbar, type ItemActionToolbarProps, ItemInteractionLayer, type ItemInteractionLayerProps, type ItemInteractionState, LinkEditorPanel, type LinkModalMode, type LinkModalProps, type LinkPage, LinkPopover, type LinkSection, OhhwellsBridge, SchedulingWidget, type SectionScaffold, type SiteLegalLinks, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, addFooterLinkColumn, appendFooterSocial, buildDefaultFooterTree, buildTarget, dropIndicatorVariants, ensureFooterTree, filterAvailablePages, getEditModeInitialState, insertFooterHours, isEditSessionActive, isRenderableFooterTree, isRenderableTree, isValidUrl, nextViableSlide, parseAiFooterState, parseTarget, removeFooterBlock, resolveFooterCopyright, serializeAiFooterState, stepViableSlide, toggleVariants, useOhwCarousel, validateUrlInput, viableSlides };