@riverbankcms/sdk 0.77.0 → 0.78.0

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

@@ -1,8 +1,8 @@
 import type { Theme, ThemeHeader } from '../schema';
 import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
 import { type Brand } from './types';
-export declare const headerLookIdValues: readonly ["clean-base", "brand-solid", "editorial-line", "centered-calm", "practical-utility", "minimal-transparent", "transparent-overlay", "floating-glass"];
-export type HeaderLookIdValue = typeof headerLookIdValues[number];
+export declare const headerLookIdValues: readonly ["clean-base", "brand-solid", "serif-line", "centered-calm", "practical-utility", "minimal-transparent", "transparent-overlay", "floating-glass"];
+export type HeaderLookIdValue = (typeof headerLookIdValues)[number];
 export type HeaderLookId = Brand<HeaderLookIdValue, 'HeaderLookId'>;
 export declare function asHeaderLookId(value: HeaderLookIdValue): HeaderLookId;
 export type PersistedHeaderLookIdParseResult = Readonly<{
@@ -18,8 +18,8 @@ export declare function parsePersistedHeaderLookId(value: string): Exclude<Persi
     kind: 'empty';
 }>;
 export declare function parsePersistedHeaderLookId(value: string | null | undefined): PersistedHeaderLookIdParseResult;
-export declare const headerLayoutIdValues: readonly ["classic", "centered", "editorial", "floating"];
-export type HeaderLayoutIdValue = typeof headerLayoutIdValues[number];
+export declare const headerLayoutIdValues: readonly ["classic", "centered", "floating"];
+export type HeaderLayoutIdValue = (typeof headerLayoutIdValues)[number];
 export type HeaderLayoutId = Brand<HeaderLayoutIdValue, 'HeaderLayoutId'>;
 export declare function asHeaderLayoutId(value: HeaderLayoutIdValue): HeaderLayoutId;
 export type PersistedHeaderLayoutIdParseResult = Readonly<{
@@ -35,8 +35,8 @@ export declare function parsePersistedHeaderLayoutId(value: string): Exclude<Per
     kind: 'empty';
 }>;
 export declare function parsePersistedHeaderLayoutId(value: string | null | undefined): PersistedHeaderLayoutIdParseResult;
-export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "editorial-line", "flat-tabs", "glass", "minimal-surface", "soft-shell"];
-export type HeaderStyleIdValue = typeof headerStyleIdValues[number];
+export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "serif-line", "flat-tabs", "glass", "minimal-surface", "soft-shell", "split-glass", "split-pill"];
+export type HeaderStyleIdValue = (typeof headerStyleIdValues)[number];
 export type HeaderStyleId = Brand<HeaderStyleIdValue, 'HeaderStyleId'>;
 export declare function asHeaderStyleId(value: HeaderStyleIdValue): HeaderStyleId;
 export type PersistedHeaderStyleIdParseResult = Readonly<{
@@ -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,12 +74,25 @@ export type HeaderStyleDefinition = Readonly<{
     supportedLayoutIds: readonly HeaderLayoutId[];
     navInteraction: HeaderStyleNavInteraction;
     surface: HeaderStyleSurface;
-    requiresFloatingLayout?: boolean;
+    defaultDepth: HeaderStyleDepth;
+    navTypography: HeaderStyleNavTypography;
+    moods: readonly HeaderStyleMood[];
 }>;
 export type HeaderLayoutStyleSelection = Readonly<{
     layoutId: HeaderLayoutId;
     styleId: HeaderStyleId;
 }>;
+export type HeaderStyleChoiceSource = Readonly<{
+    id: HeaderStyleId;
+}>;
+export type HeaderLayoutChoiceSource = Readonly<{
+    id: HeaderLayoutId;
+}>;
+export type HeaderStyleChoicesByLayout = Readonly<Partial<Record<HeaderLayoutIdValue, readonly HeaderStyleChoiceSource[]>>>;
+export type HeaderLayoutStyleCuration = Readonly<{
+    recommendedHeaderLayoutChoices: readonly HeaderLayoutChoiceSource[];
+    recommendedHeaderStyleChoicesByLayout: HeaderStyleChoicesByLayout;
+}>;
 export type HeaderLegacyLookAlias = Readonly<{
     lookId: HeaderLookId;
     selection: HeaderLayoutStyleSelection;
@@ -99,9 +114,9 @@ export type HeaderLayoutStyleResolution = Readonly<{
     style: HeaderStyleDefinition;
     repair: HeaderLayoutStyleRepair;
 }>;
-export type HeaderLookVisualTreatment = 'solid-neutral' | 'solid-brand' | 'light-editorial' | 'minimal-transparent' | 'transparent-overlay' | 'floating-glass';
+export type HeaderLookVisualTreatment = 'solid-neutral' | 'solid-brand' | 'light-serif' | 'minimal-transparent' | 'transparent-overlay' | 'floating-glass';
 export type HeaderLookLayoutBehavior = 'normal-flow' | 'sticky' | 'sticky-shrink' | 'fixed-overlay' | 'fixed-floating';
-export type HeaderStructureId = 'inline-classic' | 'centered-stack' | 'editorial-stack' | 'floating-shell';
+export type HeaderStructureId = 'inline-classic' | 'centered-stack' | 'floating-shell';
 export type HeaderTreatmentId = HeaderLookVisualTreatment;
 export type HeaderBehaviorId = HeaderLookLayoutBehavior;
 export type HeaderConfiguration = Readonly<{
@@ -120,6 +135,7 @@ export type HeaderConfigurationResolution = Readonly<{
 }>;
 export type HeaderLookOpeningRequirement = 'none' | 'reserved-space-ok' | 'requires-image-hero-with-contrast-overlay';
 export type HeaderLogoShape = 'none' | 'text-only' | 'horizontal' | 'square' | 'tall';
+export type HeaderStyleNavTypography = 'plain' | 'heading' | 'quiet-caps' | 'brand-caps';
 export type HeaderLookDefinition = Readonly<{
     id: HeaderLookId;
     label: string;
@@ -220,22 +236,13 @@ export declare const headerLayoutCatalog: readonly [{
     readonly shrinkOnScroll: false;
     readonly maxRecommendedNavItems: 5;
     readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal", "square"];
-}, {
-    readonly id: HeaderLayoutId;
-    readonly label: "Editorial";
-    readonly description: "A composed, magazine-like stacked header treatment.";
-    readonly structure: "editorial-stack";
-    readonly variant: "editorial";
-    readonly defaultPositioning: "static";
-    readonly shrinkOnScroll: false;
-    readonly maxRecommendedNavItems: 6;
 }, {
     readonly id: HeaderLayoutId;
     readonly label: "Floating";
     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"];
@@ -247,6 +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";
@@ -254,6 +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";
@@ -261,6 +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";
@@ -268,6 +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";
@@ -275,6 +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";
@@ -282,6 +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";
@@ -289,13 +314,19 @@ 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: "Editorial Line";
+    readonly label: "Serif Line";
     readonly description: "Typographic logo treatment with understated underline navigation.";
     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";
@@ -303,22 +334,29 @@ 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";
-    readonly description: "Floating translucent chrome with frosted navigation backing.";
+    readonly description: "Translucent chrome with frosted navigation backing.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "glass-backed";
     readonly surface: "floating";
-    readonly requiresFloatingLayout: true;
+    readonly defaultDepth: "shadow";
+    readonly navTypography: "plain";
+    readonly moods: readonly ["expressive", "calm"];
 }, {
     readonly id: HeaderStyleId;
-    readonly label: "Minimal Surface";
-    readonly description: "Floating chrome with a restrained translucent surface.";
+    readonly label: "Clear Split";
+    readonly description: "Floating logo with transparent navigation and no shared shell.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "color-change";
     readonly surface: "floating";
-    readonly requiresFloatingLayout: true;
+    readonly defaultDepth: "none";
+    readonly navTypography: "plain";
+    readonly moods: readonly ["editorial", "calm"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Soft Shell";
@@ -326,7 +364,29 @@ export declare const headerStyleCatalog: readonly [{
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "pill-background";
     readonly surface: "floating";
-    readonly requiresFloatingLayout: true;
+    readonly defaultDepth: "shadow";
+    readonly navTypography: "plain";
+    readonly moods: readonly ["calm", "professional"];
+}, {
+    readonly id: HeaderStyleId;
+    readonly label: "Split Glass";
+    readonly description: "Logo floats independently while the navigation sits in a glass rail.";
+    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";
+    readonly description: "Logo floats independently with a soft pill-backed navigation rail.";
+    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;
@@ -383,12 +443,14 @@ export declare function isHeaderStyleCompatibleWithLayout(style: HeaderStyleDefi
 export declare function resolveLegacyHeaderLookAlias(lookId: HeaderLookId): HeaderLayoutStyleSelection | null;
 export declare function findLegacyHeaderLookIdForSelection(selection: HeaderLayoutStyleSelection): HeaderLookId | null;
 export declare function getCompatibleHeaderStyleIds(layoutId: HeaderLayoutId): readonly HeaderStyleId[];
+export declare function getOrderedHeaderLayoutIdsForCuration(curation: HeaderLayoutStyleCuration): readonly HeaderLayoutId[];
+export declare function getOrderedHeaderStyleIdsForLayout(curation: HeaderLayoutStyleCuration, layoutId: HeaderLayoutId): readonly HeaderStyleId[];
 export declare function deriveNearestCompatibleHeaderStyle(styleId: HeaderStyleId, layoutId: HeaderLayoutId): HeaderStyleId;
 export declare function resolveHeaderLayoutStyleSelection(selection: HeaderLayoutStyleSelection): HeaderLayoutStyleResolution;
 export declare function compileHeaderLayoutStyleSelection(theme: Theme, selection: HeaderLayoutStyleSelection): Theme['header'];
 declare function solidBrandHeader(theme: Theme): Theme['header'];
 declare function cleanBaseHeader(theme: Theme): Theme['header'];
-declare function editorialLineHeader(theme: Theme): Theme['header'];
+declare function serifLineHeader(theme: Theme): Theme['header'];
 declare function centeredCalmHeader(theme: Theme): Theme['header'];
 declare function practicalUtilityHeader(theme: Theme): Theme['header'];
 declare function minimalTransparentHeader(theme: Theme): Theme['header'];
@@ -420,25 +482,25 @@ export declare const headerLookCatalog: readonly [{
     readonly compile: typeof solidBrandHeader;
 }, {
     readonly id: HeaderLookId;
-    readonly label: "Editorial line";
-    readonly visualTreatment: "light-editorial";
+    readonly label: "Serif line";
+    readonly visualTreatment: "light-serif";
     readonly layoutBehavior: "sticky";
     readonly configuration: {
-        readonly structure: "editorial-stack";
-        readonly treatment: "light-editorial";
+        readonly structure: "centered-stack";
+        readonly treatment: "light-serif";
         readonly behavior: "sticky";
     };
     readonly openingRequirement: "none";
     readonly maxRecommendedNavItems: 6;
-    readonly compile: typeof editorialLineHeader;
+    readonly compile: typeof serifLineHeader;
 }, {
     readonly id: HeaderLookId;
     readonly label: "Centered calm";
-    readonly visualTreatment: "light-editorial";
+    readonly visualTreatment: "light-serif";
     readonly layoutBehavior: "normal-flow";
     readonly configuration: {
         readonly structure: "centered-stack";
-        readonly treatment: "light-editorial";
+        readonly treatment: "light-serif";
         readonly behavior: "normal-flow";
     };
     readonly openingRequirement: "none";

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";