@ohhwells/bridge 0.1.128 → 0.1.130

package/dist/index.d.cts

@@ -20,14 +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' | 'video';
-/** 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';
-}
+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';
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -36,11 +29,8 @@ interface AiBlockNode {
     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>;
+     *  question/answer, media-strip's assetId/alt/href/linkTarget, footer link-list/hours/social-row). */
+    items?: Array<Record<string, unknown>>;
     animation?: {
         effect: 'fade-in' | 'fade-in-up' | 'slide-in-left' | 'slide-in-right' | 'zoom-in';
         trigger: 'on-scroll' | 'on-load' | 'on-hover';
@@ -232,6 +222,37 @@ declare const AI_TREE_TOKENS: {
 };
 declare function isRenderableTree(value: unknown): value is AiLayoutTree;
 
+/**
+ * Footer layout-tree contract  — bridge-side mirror of
+ * `rn-mobile-backend/app/helpers/ai-footer-tree.ts`.
+ *
+ * The server validates every footer tree fail-closed before it reaches the bridge.
+ * Legal links are never on this tree; the renderer injects them from site legal config.
+ */
+
+declare const FOOTER_COLUMN_SPANS: readonly [12, 6, 4, 3];
+type FooterColumnSpan = (typeof FOOTER_COLUMN_SPANS)[number];
+declare const FOOTER_COLUMN_BLOCKS: readonly ["link-list", "text", "hours", "logo", "social-row", "media-strip"];
+declare const FOOTER_SOCIAL_PLATFORMS: readonly ["facebook", "instagram", "youtube", "linkedin", "twitter", "tiktok", "threads", "pinterest", "whatsapp"];
+interface AiFooterColumn {
+    span: FooterColumnSpan;
+    blocks: AiBlockNode[];
+}
+/** Protected bottom bar — copyright only; legal links come from site config at render. */
+interface AiFooterBottomBar {
+    /** May include `{year}` — resolved at render time. */
+    copyright: string;
+}
+interface AiFooterLayoutTree {
+    schemaVersion: number;
+    type: 'footer';
+    columns: AiFooterColumn[];
+    bottomBar: AiFooterBottomBar;
+}
+/** Resolve `{year}` in copyright copy — never ship a stale year. */
+declare function resolveFooterCopyright(copyright: string, year?: number): string;
+declare function isRenderableFooterTree(value: unknown): value is AiFooterLayoutTree;
+
 interface AiTreeRendererProps {
     tree: AiLayoutTree;
     brand?: AiBrandKit;
@@ -247,6 +268,118 @@ interface AiTreeRendererProps {
     editKeyPrefix?: string;
 }
 declare function AiTreeRenderer({ tree, brand, buttonStyle, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Tier 1 legal links — always rendered from site config, never from the footer tree. */
+interface SiteLegalLinks {
+    privacy: {
+        label: string;
+        href: string;
+    };
+    terms: {
+        label: string;
+        href: string;
+    };
+    /** Cookie-settings control; omit to hide. Trigger only — no editable href. */
+    cookieSettings?: {
+        label: string;
+        onClick?: () => void;
+    };
+}
+interface AiFooterRendererProps {
+    tree: AiFooterLayoutTree;
+    brand?: AiBrandKit;
+    resolveMedia?: (ref: string) => string | null;
+    editKeyPrefix?: string;
+    /** Brand logo URL for `logo` blocks. */
+    logoUrl?: string | null;
+    /** Map page/anchor ids → navigable hrefs for link-list internals. */
+    resolvePageHref?: (pageOrAnchorId: string) => string | null;
+    /** Always painted in the bottom bar (Tier 1). */
+    legal: SiteLegalLinks;
+    /** Template footer's own surface — retrofit paints on the real band, not the brand's dark. */
+    surface?: {
+        background: string;
+        text: string;
+    } | null;
+}
+/**
+ * Site-wide footer from a validated footer layout tree .
+ * Bottom bar always includes copyright (`{year}` resolved) + legal links from `legal`.
+ */
+declare function AiFooterRenderer({ tree, brand, resolveMedia, editKeyPrefix, logoUrl, resolvePageHref, legal, surface, }: AiFooterRendererProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Site-wide AI footer persistence .
+ *
+ * One tree per site under `__ohw_ai_footer` — same Tier 1 guarded namespace as
+ * `__ohw_ai_sections`. Absent / empty = keep the template React footer
+ * (pixel-identical retrofit). Present = mount AiFooterRenderer and hide the
+ * template footer chrome.
+ */
+
+declare const AI_FOOTER_KEY = "__ohw_ai_footer";
+interface AiFooterState {
+    v: 1;
+    tree: AiFooterLayoutTree;
+    media?: Record<string, string>;
+    brand?: AiBrandKit;
+}
+/** Parse a persisted footer value — malformed state means "no custom footer". */
+declare function parseAiFooterState(raw: string | null | undefined): AiFooterState | null;
+declare function serializeAiFooterState(state: AiFooterState): string;
+
+/**
+ * Default footer layout tree  — bridge mirror of
+ * `rn-mobile-backend/app/helpers/ai-footer-default.ts`.
+ *
+ * Used when an AI edit first materialises a footer tree from the house default,
+ * and as the seed for prompt structured edits. Template footers stay until then.
+ */
+
+declare function buildDefaultFooterTree(opts?: {
+    businessName?: string;
+    about?: string;
+    pageLinks?: Array<{
+        label: string;
+        href: string;
+    }>;
+}): AiFooterLayoutTree;
+
+/**
+ * Pure structured edits for the site-wide footer tree .
+ * Prompt intents map here; the bridge/persist layer validates via the backend
+ * (or client-side shape checks) before applying.
+ */
+
+/** Ensure a footer tree exists — seed from the house default when first editing. */
+declare function ensureFooterTree(tree: AiFooterLayoutTree | null | undefined, opts?: {
+    businessName?: string;
+}): AiFooterLayoutTree;
+/**
+ * Add or update a social platform link. Same platform → update href (no duplicate icons);
+ * missing row → create `social-row` in the emptiest column.
+ */
+declare function appendFooterSocial(tree: AiFooterLayoutTree, entry: {
+    platform: string;
+    href: string;
+}): AiFooterLayoutTree;
+/** Insert an hours block into the emptiest/last column. */
+declare function insertFooterHours(tree: AiFooterLayoutTree, hours: Array<{
+    day: string;
+    hours: string;
+}>, title?: string): AiFooterLayoutTree;
+/**
+ * Add a link-list column (≤4 link columns). Packs brand first so it does not
+ * burn a slot. Rejects when already at 4 link-lists (returns original).
+ */
+declare function addFooterLinkColumn(tree: AiFooterLayoutTree, column: {
+    title?: string;
+    links: Array<{
+        label: string;
+        href: string;
+    }>;
+}): AiFooterLayoutTree;
+/** Remove the first block matching `predicate` (e.g. about text). */
+declare function removeFooterBlock(tree: AiFooterLayoutTree, predicate: (block: AiBlockNode, columnIndex: number, blockIndex: number) => boolean): AiFooterLayoutTree;
 
 type LinkPage = {
     path: string;
@@ -559,4 +692,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, 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 };
+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 };

package/dist/index.d.ts

@@ -20,14 +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' | 'video';
-/** 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';
-}
+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';
 interface AiBlockNode {
     type: AiBlockType;
     span: number;
@@ -36,11 +29,8 @@ interface AiBlockNode {
     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>;
+     *  question/answer, media-strip's assetId/alt/href/linkTarget, footer link-list/hours/social-row). */
+    items?: Array<Record<string, unknown>>;
     animation?: {
         effect: 'fade-in' | 'fade-in-up' | 'slide-in-left' | 'slide-in-right' | 'zoom-in';
         trigger: 'on-scroll' | 'on-load' | 'on-hover';
@@ -232,6 +222,37 @@ declare const AI_TREE_TOKENS: {
 };
 declare function isRenderableTree(value: unknown): value is AiLayoutTree;
 
+/**
+ * Footer layout-tree contract  — bridge-side mirror of
+ * `rn-mobile-backend/app/helpers/ai-footer-tree.ts`.
+ *
+ * The server validates every footer tree fail-closed before it reaches the bridge.
+ * Legal links are never on this tree; the renderer injects them from site legal config.
+ */
+
+declare const FOOTER_COLUMN_SPANS: readonly [12, 6, 4, 3];
+type FooterColumnSpan = (typeof FOOTER_COLUMN_SPANS)[number];
+declare const FOOTER_COLUMN_BLOCKS: readonly ["link-list", "text", "hours", "logo", "social-row", "media-strip"];
+declare const FOOTER_SOCIAL_PLATFORMS: readonly ["facebook", "instagram", "youtube", "linkedin", "twitter", "tiktok", "threads", "pinterest", "whatsapp"];
+interface AiFooterColumn {
+    span: FooterColumnSpan;
+    blocks: AiBlockNode[];
+}
+/** Protected bottom bar — copyright only; legal links come from site config at render. */
+interface AiFooterBottomBar {
+    /** May include `{year}` — resolved at render time. */
+    copyright: string;
+}
+interface AiFooterLayoutTree {
+    schemaVersion: number;
+    type: 'footer';
+    columns: AiFooterColumn[];
+    bottomBar: AiFooterBottomBar;
+}
+/** Resolve `{year}` in copyright copy — never ship a stale year. */
+declare function resolveFooterCopyright(copyright: string, year?: number): string;
+declare function isRenderableFooterTree(value: unknown): value is AiFooterLayoutTree;
+
 interface AiTreeRendererProps {
     tree: AiLayoutTree;
     brand?: AiBrandKit;
@@ -247,6 +268,118 @@ interface AiTreeRendererProps {
     editKeyPrefix?: string;
 }
 declare function AiTreeRenderer({ tree, brand, buttonStyle, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
+/** Tier 1 legal links — always rendered from site config, never from the footer tree. */
+interface SiteLegalLinks {
+    privacy: {
+        label: string;
+        href: string;
+    };
+    terms: {
+        label: string;
+        href: string;
+    };
+    /** Cookie-settings control; omit to hide. Trigger only — no editable href. */
+    cookieSettings?: {
+        label: string;
+        onClick?: () => void;
+    };
+}
+interface AiFooterRendererProps {
+    tree: AiFooterLayoutTree;
+    brand?: AiBrandKit;
+    resolveMedia?: (ref: string) => string | null;
+    editKeyPrefix?: string;
+    /** Brand logo URL for `logo` blocks. */
+    logoUrl?: string | null;
+    /** Map page/anchor ids → navigable hrefs for link-list internals. */
+    resolvePageHref?: (pageOrAnchorId: string) => string | null;
+    /** Always painted in the bottom bar (Tier 1). */
+    legal: SiteLegalLinks;
+    /** Template footer's own surface — retrofit paints on the real band, not the brand's dark. */
+    surface?: {
+        background: string;
+        text: string;
+    } | null;
+}
+/**
+ * Site-wide footer from a validated footer layout tree .
+ * Bottom bar always includes copyright (`{year}` resolved) + legal links from `legal`.
+ */
+declare function AiFooterRenderer({ tree, brand, resolveMedia, editKeyPrefix, logoUrl, resolvePageHref, legal, surface, }: AiFooterRendererProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * Site-wide AI footer persistence .
+ *
+ * One tree per site under `__ohw_ai_footer` — same Tier 1 guarded namespace as
+ * `__ohw_ai_sections`. Absent / empty = keep the template React footer
+ * (pixel-identical retrofit). Present = mount AiFooterRenderer and hide the
+ * template footer chrome.
+ */
+
+declare const AI_FOOTER_KEY = "__ohw_ai_footer";
+interface AiFooterState {
+    v: 1;
+    tree: AiFooterLayoutTree;
+    media?: Record<string, string>;
+    brand?: AiBrandKit;
+}
+/** Parse a persisted footer value — malformed state means "no custom footer". */
+declare function parseAiFooterState(raw: string | null | undefined): AiFooterState | null;
+declare function serializeAiFooterState(state: AiFooterState): string;
+
+/**
+ * Default footer layout tree  — bridge mirror of
+ * `rn-mobile-backend/app/helpers/ai-footer-default.ts`.
+ *
+ * Used when an AI edit first materialises a footer tree from the house default,
+ * and as the seed for prompt structured edits. Template footers stay until then.
+ */
+
+declare function buildDefaultFooterTree(opts?: {
+    businessName?: string;
+    about?: string;
+    pageLinks?: Array<{
+        label: string;
+        href: string;
+    }>;
+}): AiFooterLayoutTree;
+
+/**
+ * Pure structured edits for the site-wide footer tree .
+ * Prompt intents map here; the bridge/persist layer validates via the backend
+ * (or client-side shape checks) before applying.
+ */
+
+/** Ensure a footer tree exists — seed from the house default when first editing. */
+declare function ensureFooterTree(tree: AiFooterLayoutTree | null | undefined, opts?: {
+    businessName?: string;
+}): AiFooterLayoutTree;
+/**
+ * Add or update a social platform link. Same platform → update href (no duplicate icons);
+ * missing row → create `social-row` in the emptiest column.
+ */
+declare function appendFooterSocial(tree: AiFooterLayoutTree, entry: {
+    platform: string;
+    href: string;
+}): AiFooterLayoutTree;
+/** Insert an hours block into the emptiest/last column. */
+declare function insertFooterHours(tree: AiFooterLayoutTree, hours: Array<{
+    day: string;
+    hours: string;
+}>, title?: string): AiFooterLayoutTree;
+/**
+ * Add a link-list column (≤4 link columns). Packs brand first so it does not
+ * burn a slot. Rejects when already at 4 link-lists (returns original).
+ */
+declare function addFooterLinkColumn(tree: AiFooterLayoutTree, column: {
+    title?: string;
+    links: Array<{
+        label: string;
+        href: string;
+    }>;
+}): AiFooterLayoutTree;
+/** Remove the first block matching `predicate` (e.g. about text). */
+declare function removeFooterBlock(tree: AiFooterLayoutTree, predicate: (block: AiBlockNode, columnIndex: number, blockIndex: number) => boolean): AiFooterLayoutTree;
 
 type LinkPage = {
     path: string;
@@ -559,4 +692,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, 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 };
+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 };