@ohhwells/bridge 0.1.92 → 0.1.93-next.281

package/dist/index.d.cts

@@ -63,6 +63,27 @@ interface AiLayoutTree {
         align?: 'top' | 'center' | 'bottom' | 'stretch';
     }>;
 }
+/** One uploaded weight file for a custom font family. */
+interface AiCustomFontWeight {
+    weight: number;
+    /** Present when the file is a variable font with a `wght` axis — `weight` is the axis min,
+     *  `weightEnd` the axis max, together spanning every weight the one file actually covers. */
+    weightEnd?: number;
+    url: string;
+    format: 'woff2' | 'woff' | 'truetype' | 'opentype';
+}
+/**
+ * A custom (non-Google) font family, grouped by its uploaded weight files so a bold heading
+ * actually resolves to a real bold file instead of the browser synthesizing fake bold from
+ * whichever single weight happens to be present.
+ */
+interface AiCustomFont {
+    /** Collision-proof internal family name — what `fonts.heading`/`fonts.body` actually reference. */
+    family: string;
+    /** Human-readable name shown in the picker; hidden everywhere the internal `family` is used. */
+    label: string;
+    weights: AiCustomFontWeight[];
+}
 /** The site brand kit the renderer styles from (editor Brand settings). */
 interface AiBrandKit {
     palette: {
@@ -75,6 +96,26 @@ interface AiBrandKit {
         heading: string;
         body: string;
     };
+    customFonts?: AiCustomFont[];
+}
+/**
+ * Shape, padding and typography measured off a host-template CTA, so generated buttons read as the
+ * site's own button rather than a default. Colour stays brand-driven (band-aware); everything here
+ * follows the template button. Null when the page has no template button to measure.
+ */
+interface TemplateButtonStyle {
+    radius: string;
+    padding: string;
+    fontFamily: string;
+    fontSize: string;
+    fontWeight: string;
+    letterSpacing: string;
+    textTransform: string;
+    /** Measured fill/label pair of the template's primary CTA — a template may fill its buttons
+     *  with any token (hvac uses accent, not primary), so the pair travels together. Absent when
+     *  the page's only buttons are unfilled (ghost/outline). */
+    background?: string;
+    color?: string;
 }
 /** Section System defaults — used when a site has no brand kit override. */
 declare const AI_DEFAULT_BRAND: AiBrandKit;
@@ -143,8 +184,8 @@ declare function isRenderableTree(value: unknown): value is AiLayoutTree;
 interface AiTreeRendererProps {
     tree: AiLayoutTree;
     brand?: AiBrandKit;
-    /** The host template's button corner radius (e.g. "0px", "8px"); a form's submit adopts it. */
-    buttonRadius?: string | null;
+    /** The host template's button shape/padding/typography; generated CTAs adopt it. */
+    buttonStyle?: TemplateButtonStyle | null;
     /** Resolves a media ref to a URL; null renders a placeholder. */
     resolveMedia?: (ref: string) => string | null;
     /**
@@ -154,7 +195,7 @@ interface AiTreeRendererProps {
      */
     editKeyPrefix?: string;
 }
-declare function AiTreeRenderer({ tree, brand, buttonRadius, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
+declare function AiTreeRenderer({ tree, brand, buttonStyle, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
 
 type LinkPage = {
     path: string;
@@ -423,6 +464,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 = {
@@ -446,4 +497,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

@@ -63,6 +63,27 @@ interface AiLayoutTree {
         align?: 'top' | 'center' | 'bottom' | 'stretch';
     }>;
 }
+/** One uploaded weight file for a custom font family. */
+interface AiCustomFontWeight {
+    weight: number;
+    /** Present when the file is a variable font with a `wght` axis — `weight` is the axis min,
+     *  `weightEnd` the axis max, together spanning every weight the one file actually covers. */
+    weightEnd?: number;
+    url: string;
+    format: 'woff2' | 'woff' | 'truetype' | 'opentype';
+}
+/**
+ * A custom (non-Google) font family, grouped by its uploaded weight files so a bold heading
+ * actually resolves to a real bold file instead of the browser synthesizing fake bold from
+ * whichever single weight happens to be present.
+ */
+interface AiCustomFont {
+    /** Collision-proof internal family name — what `fonts.heading`/`fonts.body` actually reference. */
+    family: string;
+    /** Human-readable name shown in the picker; hidden everywhere the internal `family` is used. */
+    label: string;
+    weights: AiCustomFontWeight[];
+}
 /** The site brand kit the renderer styles from (editor Brand settings). */
 interface AiBrandKit {
     palette: {
@@ -75,6 +96,26 @@ interface AiBrandKit {
         heading: string;
         body: string;
     };
+    customFonts?: AiCustomFont[];
+}
+/**
+ * Shape, padding and typography measured off a host-template CTA, so generated buttons read as the
+ * site's own button rather than a default. Colour stays brand-driven (band-aware); everything here
+ * follows the template button. Null when the page has no template button to measure.
+ */
+interface TemplateButtonStyle {
+    radius: string;
+    padding: string;
+    fontFamily: string;
+    fontSize: string;
+    fontWeight: string;
+    letterSpacing: string;
+    textTransform: string;
+    /** Measured fill/label pair of the template's primary CTA — a template may fill its buttons
+     *  with any token (hvac uses accent, not primary), so the pair travels together. Absent when
+     *  the page's only buttons are unfilled (ghost/outline). */
+    background?: string;
+    color?: string;
 }
 /** Section System defaults — used when a site has no brand kit override. */
 declare const AI_DEFAULT_BRAND: AiBrandKit;
@@ -143,8 +184,8 @@ declare function isRenderableTree(value: unknown): value is AiLayoutTree;
 interface AiTreeRendererProps {
     tree: AiLayoutTree;
     brand?: AiBrandKit;
-    /** The host template's button corner radius (e.g. "0px", "8px"); a form's submit adopts it. */
-    buttonRadius?: string | null;
+    /** The host template's button shape/padding/typography; generated CTAs adopt it. */
+    buttonStyle?: TemplateButtonStyle | null;
     /** Resolves a media ref to a URL; null renders a placeholder. */
     resolveMedia?: (ref: string) => string | null;
     /**
@@ -154,7 +195,7 @@ interface AiTreeRendererProps {
      */
     editKeyPrefix?: string;
 }
-declare function AiTreeRenderer({ tree, brand, buttonRadius, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
+declare function AiTreeRenderer({ tree, brand, buttonStyle, resolveMedia, editKeyPrefix, }: AiTreeRendererProps): react_jsx_runtime.JSX.Element | null;
 
 type LinkPage = {
     path: string;
@@ -423,6 +464,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 = {
@@ -446,4 +497,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 };