@riverbankcms/sdk 0.77.1 → 0.78.0

package/dist/_dts/theme-core/src/site-styles/headerLooks.d.ts

@@ -65,6 +65,8 @@ export type HeaderLayoutDefinition = Readonly<{
 }>;
 export type HeaderStyleNavInteraction = 'color-change' | 'underline-grow' | 'pill-background' | 'flat-block' | 'glass-backed';
 export type HeaderStyleSurface = 'neutral' | 'bordered' | 'soft' | 'brand-solid' | 'floating';
+export type HeaderStyleDepth = 'none' | 'line' | 'shadow';
+export type HeaderStyleMood = 'calm' | 'professional' | 'editorial' | 'expressive' | 'utility';
 export type HeaderStyleDefinition = Readonly<{
     id: HeaderStyleId;
     label: string;
@@ -72,7 +74,9 @@ export type HeaderStyleDefinition = Readonly<{
     supportedLayoutIds: readonly HeaderLayoutId[];
     navInteraction: HeaderStyleNavInteraction;
     surface: HeaderStyleSurface;
+    defaultDepth: HeaderStyleDepth;
     navTypography: HeaderStyleNavTypography;
+    moods: readonly HeaderStyleMood[];
 }>;
 export type HeaderLayoutStyleSelection = Readonly<{
     layoutId: HeaderLayoutId;
@@ -238,7 +242,7 @@ export declare const headerLayoutCatalog: readonly [{
     readonly description: "Detached header chrome that sits over the opening section.";
     readonly structure: "floating-shell";
     readonly variant: "floating";
-    readonly defaultPositioning: "fixed";
+    readonly defaultPositioning: "sticky";
     readonly shrinkOnScroll: true;
     readonly maxRecommendedNavItems: 5;
     readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal"];
@@ -250,7 +254,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "color-change";
     readonly surface: "neutral";
+    readonly defaultDepth: "none";
     readonly navTypography: "plain";
+    readonly moods: readonly ["calm", "professional", "editorial"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Fine Line";
@@ -258,7 +264,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "underline-grow";
     readonly surface: "bordered";
+    readonly defaultDepth: "line";
     readonly navTypography: "plain";
+    readonly moods: readonly ["calm", "professional", "editorial"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Soft Bar";
@@ -266,7 +274,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "soft";
+    readonly defaultDepth: "line";
     readonly navTypography: "plain";
+    readonly moods: readonly ["calm", "professional"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Pill Nav";
@@ -274,7 +284,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "soft";
+    readonly defaultDepth: "none";
     readonly navTypography: "plain";
+    readonly moods: readonly ["calm"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Bar";
@@ -282,7 +294,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "color-change";
     readonly surface: "brand-solid";
+    readonly defaultDepth: "none";
     readonly navTypography: "brand-caps";
+    readonly moods: readonly ["professional", "expressive", "utility"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Underline";
@@ -290,7 +304,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "underline-grow";
     readonly surface: "brand-solid";
+    readonly defaultDepth: "none";
     readonly navTypography: "brand-caps";
+    readonly moods: readonly ["expressive"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Pill";
@@ -298,7 +314,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "brand-solid";
+    readonly defaultDepth: "none";
     readonly navTypography: "brand-caps";
+    readonly moods: readonly ["expressive"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Serif Line";
@@ -306,7 +324,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "underline-grow";
     readonly surface: "bordered";
+    readonly defaultDepth: "line";
     readonly navTypography: "heading";
+    readonly moods: readonly ["editorial", "calm"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Flat Tabs";
@@ -314,7 +334,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "flat-block";
     readonly surface: "bordered";
+    readonly defaultDepth: "shadow";
     readonly navTypography: "quiet-caps";
+    readonly moods: readonly ["professional", "utility", "expressive"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Glass";
@@ -322,7 +344,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "glass-backed";
     readonly surface: "floating";
+    readonly defaultDepth: "shadow";
     readonly navTypography: "plain";
+    readonly moods: readonly ["expressive", "calm"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Clear Split";
@@ -330,7 +354,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "color-change";
     readonly surface: "floating";
+    readonly defaultDepth: "none";
     readonly navTypography: "plain";
+    readonly moods: readonly ["editorial", "calm"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Soft Shell";
@@ -338,7 +364,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "floating";
+    readonly defaultDepth: "shadow";
     readonly navTypography: "plain";
+    readonly moods: readonly ["calm", "professional"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Split Glass";
@@ -346,7 +374,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "glass-backed";
     readonly surface: "floating";
+    readonly defaultDepth: "shadow";
     readonly navTypography: "quiet-caps";
+    readonly moods: readonly ["expressive"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Split Pill";
@@ -354,7 +384,9 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "floating";
+    readonly defaultDepth: "shadow";
     readonly navTypography: "heading";
+    readonly moods: readonly ["calm", "editorial"];
 }];
 export declare const legacyHeaderLookAliases: readonly [{
     readonly lookId: HeaderLookId;

package/dist/_dts/theme-core/src/site-styles/rawStyleFields.d.ts

@@ -1,8 +1,10 @@
 export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup"];
 export type ThemeV2RuntimeStyleFieldName = typeof themeV2RuntimeStyleFieldNames[number];
-export declare const themeV2BlockSpecificRawStyleFieldNames: readonly ["_contentCardStyles", "_textCardStyles"];
+export declare const themeV2BlockSpecificRawStyleFieldNames: readonly ["_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export type ThemeV2BlockSpecificRawStyleFieldName = typeof themeV2BlockSpecificRawStyleFieldNames[number];
 export type ThemeV2NormalEditorRawStyleFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
-export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_textCardStyles"];
+export type ThemeV2CompilerOwnedFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
+export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare function isThemeV2NormalEditorRawStyleFieldName(fieldName: string): boolean;
 export declare function isThemeV2NormalEditorRawStylePath(fieldPath: string): boolean;

package/dist/_dts/theme-core/src/site-styles/runtimeCompiler.d.ts

@@ -23,10 +23,18 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _frameStyles: ContentFrameIntent;
     _sectionStyles?: SectionStylesOverride;
     _containerStyles?: ContainerStylesOverride;
+    _contentCardStyles?: ContainerStylesOverride;
+    _heroLayoutStyles?: HeroLayoutStylesOverride;
     _cardStyles?: CardStylesOverride;
     styleGroup?: string;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup"];
+export type HeroLayoutStylesOverride = Readonly<{
+    contentAlignment?: 'left' | 'center' | 'right';
+    verticalAlignment?: 'top' | 'center' | 'bottom';
+    contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
+    typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
+}>;
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "styleGroup"];
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;

package/dist/_dts/theme-core/src/site-styles/types.d.ts

@@ -163,6 +163,8 @@ export type AdvancedSurfaceIntent = SiteStyleSurfaceIntent | AdvancedDetachedDes
 export type MediaCompositionIntent = 'none' | 'supporting' | 'dominant';
 export type DecorativeCompositionIntent = 'none' | 'supporting' | 'feature';
 export type HeroLegibilityStrategy = 'none' | 'scrim-gradient' | 'solid-panel';
+export type HeroCompositionIntent = 'center' | 'bottom-left';
+export type HeroTypographyScaleIntent = 'quiet' | 'editorial' | 'display' | 'poster';
 export type ImageSurfaceTreatmentToken = 'primary' | 'secondary' | 'accent';
 export type ImageSurfaceTreatmentIntensity = 'soft' | 'balanced' | 'strong';
 export type ImageSurfaceMotion = 'static' | 'fixed-frame';
@@ -190,6 +192,8 @@ export type ImageSurfaceTreatmentKind = ImageSurfaceTreatment['kind'];
 export type TestimonialCardTreatment = 'default' | 'accent-quote';
 export declare const tileTreatmentValues: readonly ["default", "quiet", "brand-depth"];
 export type TileTreatment = (typeof tileTreatmentValues)[number];
+export declare const eventListTreatmentValues: readonly ["plain", "lined-panel"];
+export type EventListTreatment = (typeof eventListTreatmentValues)[number];
 export declare const eyebrowTreatmentValues: readonly ["plain", "pill", "accent-pill", "pill-bounce", "accent-pill-bounce"];
 export type EyebrowTreatment = (typeof eyebrowTreatmentValues)[number];
 export declare const headingDecorationFamilyValues: readonly ["none", "organic-squiggle", "short-center-rule"];
@@ -379,10 +383,13 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     emphasis: SiteStyleEmphasis;
     sectionHeight?: SectionHeightIntent;
     heroLegibility?: HeroLegibilityStrategy;
+    heroComposition?: HeroCompositionIntent;
+    heroTypographyScale?: HeroTypographyScaleIntent;
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
     tileTreatment?: TileTreatment;
+    eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
     headingDecoration?: HeadingDecoration;
     accordionIconTreatment?: AccordionIconTreatment | null;
@@ -398,6 +405,7 @@ export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPu
     appliedImageSurfaceMotion: ImageSurfaceMotion;
     appliedTestimonialCardTreatment: TestimonialCardTreatment;
     appliedTileTreatment: TileTreatment;
+    appliedEventListTreatment: EventListTreatment;
     appliedEyebrowTreatment: EyebrowTreatment;
     appliedHeadingDecoration: HeadingDecoration;
     appliedAccordionIconTreatment: AccordionIconTreatment | null;
@@ -420,6 +428,7 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     imageSurfaceMotions?: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments?: NonEmptyReadonlyArray<TestimonialCardTreatment>;
     tileTreatments?: NonEmptyReadonlyArray<TileTreatment>;
+    eventListTreatments?: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
     headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
@@ -434,6 +443,7 @@ export type DesignedBlockDesignCapability = Readonly<{
     imageSurfaceMotions: NonEmptyReadonlyArray<ImageSurfaceMotion>;
     testimonialCardTreatments: NonEmptyReadonlyArray<TestimonialCardTreatment>;
     tileTreatments: NonEmptyReadonlyArray<TileTreatment>;
+    eventListTreatments: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
     headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
@@ -447,7 +457,7 @@ export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesig
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
 export declare function defineBlockDesignCapability(capability: DesignedBlockDesignCapabilityInput): DesignedBlockDesignCapability;
 export declare function defineNoBlockDesignCapability(reason: UnsupportedBlockDesignCapabilityReason): NoBlockDesignCapability;
-export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-item-surface' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-testimonial-card-treatment' | 'fallback-tile-treatment' | 'fallback-eyebrow-treatment' | 'fallback-heading-decoration' | 'fallback-accordion-icon-treatment' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
+export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-item-surface' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-testimonial-card-treatment' | 'fallback-tile-treatment' | 'fallback-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-heading-decoration' | 'fallback-accordion-icon-treatment' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
 export type UnsupportedSectionSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-section-surface';
     blockId: TBlockId;
@@ -538,6 +548,17 @@ export type UnsupportedTileTreatmentIssue<TBlockId extends string = DesignBlockI
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-tile-treatment'];
 }>;
+export type UnsupportedEventListTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
+    kind: 'unsupported-event-list-treatment';
+    blockId: TBlockId;
+    blockKind: string;
+    purpose: TPurpose;
+    requested: EventListTreatment;
+    fallback: 'plain';
+    policy: DesignResolutionPolicy;
+    severity: DesignIssueSeverity;
+    allowedRepairActions: readonly ['fallback-event-list-treatment'];
+}>;
 export type UnsupportedEyebrowTreatmentIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-eyebrow-treatment';
     blockId: TBlockId;
@@ -613,10 +634,13 @@ export type BlockDesignCapabilityRequest = Readonly<{
     transitionAfter: SiteStyleSectionTransitionIntent;
     sectionHeight?: SectionHeightIntent;
     heroLegibility?: HeroLegibilityStrategy;
+    heroComposition?: HeroCompositionIntent;
+    heroTypographyScale?: HeroTypographyScaleIntent;
     imageSurfaceTreatment?: ImageSurfaceTreatment;
     imageSurfaceMotion?: ImageSurfaceMotion;
     testimonialCardTreatment?: TestimonialCardTreatment;
     tileTreatment?: TileTreatment;
+    eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
     headingDecoration?: HeadingDecoration;
     accordionIconTreatment?: AccordionIconTreatment | null;
@@ -634,6 +658,7 @@ export type BlockDesignCapabilityFallback = Readonly<{
     imageSurfaceMotion: 'static';
     testimonialCardTreatment: 'default';
     tileTreatment: 'default';
+    eventListTreatment: 'plain';
     eyebrowTreatment: 'plain';
     headingDecoration: NoHeadingDecoration;
     accordionIconTreatment: null;
@@ -683,7 +708,7 @@ export type HeroImageWithoutLegibilityIssue<TBlockId extends string = DesignBloc
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-hero-legibility'];
 }>;
-export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedItemSurfaceIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTestimonialCardTreatmentIssue<TBlockId, TPurpose> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedHeadingDecorationIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | RemovedTransitionForFlushFrameIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
+export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedItemSurfaceIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTestimonialCardTreatmentIssue<TBlockId, TPurpose> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEventListTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedHeadingDecorationIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | RemovedTransitionForFlushFrameIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
 export type DesignRepairResultForIssue<TIssue extends DesignResolutionIssue<string, string>> = {
     [TKind in TIssue['kind']]: Readonly<{
         kind: TKind extends 'removed-transition-for-flush-frame' ? 'repaired' : 'fallbackApplied';

package/dist/_dts/theme-core/src/siteChrome.d.ts

@@ -1,36 +1,13 @@
 import React, { type ReactNode } from "react";
-import type { Theme } from "./schema";
-export type SiteTopShellBehavior = "normal-flow" | "shared-sticky-shell" | "banner-above-overlay-header";
-export type SiteTopShellPlan = Readonly<{
-    behavior: "normal-flow";
-    contentStartsUnderHeader: boolean;
-    requiresHeaderOffset: false;
-}> | Readonly<{
-    behavior: "shared-sticky-shell";
-    contentStartsUnderHeader: false;
-    requiresHeaderOffset: false;
-}> | Readonly<{
-    behavior: "banner-above-overlay-header";
-    contentStartsUnderHeader: true;
-    requiresHeaderOffset: true;
-}>;
+import type { SiteDocumentPlan, SiteTopShellBehavior } from "./siteChromePlanning";
+export { getStandaloneHeaderShellClassName, planSiteDocument, planSiteTopShell, type SiteDocumentLayoutMode, type SiteDocumentPlan, type SiteDocumentPlanInput, type SiteTopShellBehavior, type SiteTopShellPlan, } from "./siteChromePlanning";
+export { SITE_CHROME_VISIBLE_HEADER_ATTR, SITE_CHROME_VISIBLE_HEADER_SELECTOR, SITE_OVERLAY_HEADER_CLEARANCE_CSS_VAR, SITE_OVERLAY_HEADER_CLEARANCE_FALLBACK, visibleHeaderClearancePx, type HeaderMeasurementBox, type SiteOverlayHeaderClearancePlan, } from "./siteChromeOverlayClearance";
 export type SiteChromeLayoutNodes = Readonly<{
     headerNode: ReactNode;
     bannerNode?: ReactNode;
     bannerShellBehavior?: SiteTopShellBehavior;
     footerNode: ReactNode;
 }>;
-type HeaderPositioning = NonNullable<Theme["header"]>["positioning"];
-export type SiteDocumentLayoutMode = "normal-flow" | "header-overlay";
-export type SiteDocumentPlan = Readonly<{
-    topShell: SiteTopShellPlan;
-    layoutMode: SiteDocumentLayoutMode;
-}>;
-export type SiteDocumentPlanInput = Readonly<{
-    headerPositioning: HeaderPositioning;
-    headerVariant?: Theme["header"]["variant"] | null;
-    hasVisibleBanner: boolean;
-}>;
 export type SiteDocumentLayoutProps = Omit<SiteChromeLayoutNodes, "bannerShellBehavior"> & Readonly<{
     plan: SiteDocumentPlan;
     children: ReactNode;
@@ -41,13 +18,19 @@ export type SiteDocumentLayoutProps = Omit<SiteChromeLayoutNodes, "bannerShellBe
     contentClassName?: string | null;
     style?: React.CSSProperties;
 }>;
-export declare function getStandaloneHeaderShellClassName(theme: Theme): string | null;
+export declare const SITE_CHROME_CLASS_NAMES: {
+    readonly standaloneStickyHeaderShell: "sticky top-0 z-40 w-full";
+    readonly standaloneFixedHeaderShell: "fixed left-0 right-0 top-0 z-40 w-full";
+    readonly sharedStickyTopShell: "rb-sticky rb-top-0 rb-z-40 rb-w-full";
+    readonly defaultMinHeight: "rb-min-h-screen";
+    readonly fullMinHeight: "rb-min-h-full";
+    readonly overlayRoot: "rb-grid rb-grid-rows-main-footer rb-grid-cols-1";
+    readonly normalFlowRoot: "rb-flex rb-flex-col";
+    readonly overlayTopShell: "rb-row-start-1 rb-col-start-1 rb-z-40";
+    readonly overlayTopShellPlacementMarker: "rb-site-document-overlay-top-shell";
+    readonly overlayContent: "rb-row-start-1 rb-col-start-1";
+    readonly overlayFooter: "rb-row-start-2 rb-col-start-1";
+    readonly normalFlowContent: "rb-flex-1";
+};
 export declare function renderSiteTopChrome({ headerNode, bannerNode, bannerShellBehavior, }: Pick<SiteChromeLayoutNodes, "headerNode" | "bannerNode" | "bannerShellBehavior">): ReactNode;
-export declare function planSiteDocument(input: SiteDocumentPlanInput): SiteDocumentPlan;
 export declare function SiteDocumentLayout({ plan, headerNode, bannerNode, footerNode, children, as: Root, role, className, minHeightClassName, contentClassName, style, }: SiteDocumentLayoutProps): React.ReactElement;
-export declare function planSiteTopShell(input: Readonly<{
-    headerPositioning: HeaderPositioning;
-    headerVariant?: Theme["header"]["variant"] | null;
-    hasVisibleBanner: boolean;
-}>): SiteTopShellPlan;
-export {};

package/dist/_dts/theme-core/src/siteChromeOverlayClearance.d.ts

@@ -0,0 +1,22 @@
+export declare const SITE_OVERLAY_HEADER_CLEARANCE_CSS_VAR: "--site-overlay-header-clearance";
+export declare const SITE_OVERLAY_HEADER_CLEARANCE_FALLBACK: "clamp(5rem, 8vw, 7rem)";
+export declare const SITE_CHROME_VISIBLE_HEADER_ATTR: "data-site-chrome-visible-header";
+export declare const SITE_CHROME_VISIBLE_HEADER_SELECTOR: "[data-site-chrome-visible-header=\"true\"]";
+export type SiteOverlayHeaderClearancePlan = Readonly<{
+    kind: "none";
+}> | Readonly<{
+    kind: "opening-content";
+    cssValue: string;
+}>;
+export type SiteOverlayHeaderClearancePlanInput = Readonly<{
+    layoutMode: "normal-flow" | "header-overlay";
+    topShell: Readonly<{
+        contentStartsUnderHeader: boolean;
+    }>;
+}>;
+export declare function planSiteOverlayHeaderClearance(input: SiteOverlayHeaderClearancePlanInput): SiteOverlayHeaderClearancePlan;
+export type HeaderMeasurementBox = Readonly<{
+    bottom: number;
+    height: number;
+}>;
+export declare function visibleHeaderClearancePx(box: HeaderMeasurementBox | null): number;

package/dist/_dts/theme-core/src/siteChromePlacement.d.ts

@@ -0,0 +1,22 @@
+import type { HeaderPositioning } from "./schema";
+export type SiteChromePlacementPlan = Readonly<{
+    kind: "static";
+    headerRootClassName: null;
+    standaloneShellClassName: null;
+}> | Readonly<{
+    kind: "sticky";
+    headerRootClassName: "rb-sticky rb-top-0";
+    standaloneShellClassName: "sticky top-0 z-40 w-full";
+}> | Readonly<{
+    kind: "fixed";
+    headerRootClassName: "rb-fixed rb-top-0 rb-left-0 rb-right-0";
+    standaloneShellClassName: "fixed left-0 right-0 top-0 z-40 w-full";
+}>;
+export declare const SITE_CHROME_PLACEMENT_CLASSES: readonly ["rb-sticky", "rb-fixed", "rb-absolute", "rb-relative", "rb-top-0", "rb-left-0", "rb-right-0", "rb-bottom-0", "rb-z-40", "rb-z-50"];
+export declare function parseHeaderPositioning(value: unknown): HeaderPositioning;
+export declare function isHeaderPositioning(value: unknown): value is HeaderPositioning;
+export declare function planSiteChromePlacement(positioning: HeaderPositioning): SiteChromePlacementPlan;
+export declare function splitSiteChromePlacementClasses(className: string | undefined): {
+    wrapperClasses: string;
+    sectionClasses: string;
+};

package/dist/_dts/theme-core/src/siteChromePlanning.d.ts

@@ -0,0 +1,32 @@
+import type { HeaderPositioning, Theme } from "./schema";
+import { type SiteChromePlacementPlan } from "./siteChromePlacement";
+import { type SiteOverlayHeaderClearancePlan } from "./siteChromeOverlayClearance";
+export type SiteTopShellBehavior = "normal-flow" | "shared-sticky-shell" | "banner-above-overlay-header";
+export type SiteTopShellPlan = Readonly<{
+    behavior: "normal-flow";
+    contentStartsUnderHeader: boolean;
+    requiresHeaderOffset: false;
+}> | Readonly<{
+    behavior: "shared-sticky-shell";
+    contentStartsUnderHeader: false;
+    requiresHeaderOffset: false;
+}> | Readonly<{
+    behavior: "banner-above-overlay-header";
+    contentStartsUnderHeader: true;
+    requiresHeaderOffset: true;
+}>;
+export type SiteDocumentLayoutMode = "normal-flow" | "header-overlay";
+export type SiteDocumentPlan = Readonly<{
+    placement: SiteChromePlacementPlan;
+    topShell: SiteTopShellPlan;
+    layoutMode: SiteDocumentLayoutMode;
+    overlayHeaderClearance: SiteOverlayHeaderClearancePlan;
+}>;
+export type SiteDocumentPlanInput = Readonly<{
+    headerPositioning: HeaderPositioning;
+    headerVariant?: Theme["header"]["variant"] | null;
+    hasVisibleBanner: boolean;
+}>;
+export declare function getStandaloneHeaderShellClassName(theme: Theme): string | null;
+export declare function planSiteDocument(input: SiteDocumentPlanInput): SiteDocumentPlan;
+export declare function planSiteTopShell(input: SiteDocumentPlanInput): SiteTopShellPlan;

package/dist/_dts/theme-core/src/tokens/themeColorTokens.d.ts

@@ -7,16 +7,16 @@ import { z } from 'zod';
 export declare const PALETTE_TOKEN_NAMES: readonly ["primary", "primaryForeground", "secondary", "accent", "success", "warning", "destructive", "background", "surface", "surfaceAlt", "muted", "text", "border"];
 export type PaletteTokenName = (typeof PALETTE_TOKEN_NAMES)[number];
 export declare const paletteTokenNameSchema: z.ZodEnum<{
+    surface: "surface";
     success: "success";
     text: "text";
     primary: "primary";
     secondary: "secondary";
+    warning: "warning";
     border: "border";
     background: "background";
     muted: "muted";
-    surface: "surface";
     accent: "accent";
-    warning: "warning";
     destructive: "destructive";
     primaryForeground: "primaryForeground";
     surfaceAlt: "surfaceAlt";