@riverbankcms/sdk 0.104.3 → 0.108.0

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

@@ -1,19 +1,16 @@
 import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
-import { type KnownCuratedPaletteId, type CuratedPaletteId } from '../palette/curated';
+import { type KnownCuratedPaletteValueKey } from '../palette/curated';
 import type { Theme } from '../schema';
 import { type HeaderLayoutId, type HeaderLayoutIdValue, type HeaderLookId, type HeaderStyleId } from './headerLooks';
 import { type FooterLookId } from './footerLooks';
 import { type CuratedChoice } from './curatedChoices';
 import { type AppearancePresetId, type DesignSystemTemplate, type HeadingDecoration, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
-import { type KnownTypographyPresetId, type TypographyPresetId } from './typographyPresets';
-import { type DesignRuntimeRules } from './runtimeCompiler';
+import { type SiteStyleHeroTypography } from './siteStyleTypography';
+import { type ComponentRuntimeRules, type DesignRuntimeRules } from './runtimeCompiler';
 export declare const SOFT_EARTH_SITE_STYLE_ID_VALUE: "site-style:soft-earth";
 export declare const SOFT_EARTH_SITE_STYLE_ID: SiteStyleId;
-export declare const curatedSiteStyleIdValues: readonly ["site-style:calm-studio", "site-style:clear-professional", "site-style:warm-editorial", "site-style:bright-community", "site-style:quiet-luxury", "site-style:practical-services", "site-style:quiet-practice", "site-style:personal-retreat-journal", "site-style:tactile-workshop", "site-style:modern-wellness", "site-style:clarity-zen-blue", "site-style:soft-earth", "site-style:bold-launch", "site-style:south-west-twerk-school", "site-style:kirtan-ornate", "site-style:original-joy", "site-style:fulcrum"];
+export declare const curatedSiteStyleIdValues: readonly ["site-style:calm-studio", "site-style:clear-professional", "site-style:warm-editorial", "site-style:bright-community", "site-style:quiet-luxury", "site-style:practical-services", "site-style:quiet-practice", "site-style:personal-retreat-journal", "site-style:tactile-workshop", "site-style:modern-wellness", "site-style:clarity-zen-blue", "site-style:soft-earth", "site-style:bold-launch", "site-style:south-west-twerk-school", "site-style:kirtan-ornate", "site-style:original-joy", "site-style:fulcrum", "site-style:grounded-practice"];
 export type CuratedSiteStyleIdValue = (typeof curatedSiteStyleIdValues)[number];
-type CuratedSiteStyleHeroOverrides = Readonly<{
-    typography?: NonNullable<NonNullable<Theme['hero']>['typography']>;
-}>;
 type CuratedSiteStyleBodyTextOverrides = Readonly<{
     intro?: NonNullable<NonNullable<Theme['bodyText']>['intro']>;
 }>;
@@ -36,8 +33,6 @@ type CuratedSiteStyleTestimonialQuoteOverrides = NonNullable<Theme['testimonialQ
  * independent Style configurator choices.
  */
 export type CuratedSiteStyleThemeOverrides = Readonly<{
-    typography?: Theme['typography'];
-    hero?: CuratedSiteStyleHeroOverrides;
     bodyText?: CuratedSiteStyleBodyTextOverrides;
     /**
      * Inputs are authored as a complete system rather than sparsely merged so
@@ -64,7 +59,7 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
     testimonialQuote?: CuratedSiteStyleTestimonialQuoteOverrides;
 }>;
 export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
-export type CuratedPaletteRecommendation = CuratedChoice<KnownCuratedPaletteId>;
+export type CuratedPaletteRecommendation = CuratedChoice<KnownCuratedPaletteValueKey>;
 export type HeaderLayoutChoice = CuratedChoice<HeaderLayoutId>;
 export type HeaderStyleChoice = CuratedChoice<HeaderStyleId>;
 export type HeaderLayoutStyleChoice = Readonly<{
@@ -72,7 +67,6 @@ export type HeaderLayoutStyleChoice = Readonly<{
     styleId: HeaderStyleId;
 }>;
 export type RecommendedHeaderStylesByLayout = Readonly<Partial<Record<HeaderLayoutIdValue, NonEmptyReadonlyArray<HeaderStyleChoice>>>>;
-export type TypographyPresetChoice = CuratedChoice<KnownTypographyPresetId>;
 export type FaqDefaultBlockVariant = 'default' | 'two-column' | 'question-columns' | 'split-heading-columns';
 export type CuratedSiteStyleDefaultBlockVariants = Readonly<Partial<{
     'block.faq': FaqDefaultBlockVariant;
@@ -110,6 +104,8 @@ export type CuratedSiteStyle = Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -128,12 +124,13 @@ export type CuratedSiteStyle = Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme['typography'];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>;
 export declare function defaultButtonPersonalityForSiteStyle(siteStyle: CuratedSiteStyle): ButtonPersonalityId;
-export declare function defaultPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CuratedPaletteId;
-export declare function defaultTypographyPresetForSiteStyle(siteStyle: CuratedSiteStyle): TypographyPresetId;
+export declare function defaultPaletteForSiteStyle(siteStyle: CuratedSiteStyle): KnownCuratedPaletteValueKey;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
  * systems. Generators choose one of these bounded entries, then downstream
@@ -154,6 +151,47 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
+    defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
+    /**
+     * Site-wide heading decoration signature (family + colour). Applied to
+     * eligible block headings as a single consistent mark; alignment is inherited
+     * from the heading. The factory defaults this to the short centre rule.
+     */
+    headingDecoration: HeadingDecoration;
+    recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    defaultHeaderSelection: HeaderLayoutStyleChoice;
+    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
+    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
+    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
+}>, Readonly<{
+    id: SiteStyleId;
+    name: string;
+    description: string;
+    generationBrief: string;
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
+    template: DesignSystemTemplate;
+    themeOverrides?: CuratedSiteStyleThemeOverrides;
+    /**
+     * Optional Theme V2 runtime rules owned by the style. These translate
+     * semantic section surfaces into block runtime fields such as background
+     * and foreground tokens.
+     */
+    designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -172,8 +210,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -189,6 +229,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -207,8 +249,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -224,6 +268,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -242,8 +288,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -259,6 +307,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -277,8 +327,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -294,6 +346,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -312,8 +366,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -329,6 +385,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -347,8 +405,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -364,6 +424,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -382,8 +444,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -399,6 +463,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -417,8 +483,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -434,6 +502,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -452,8 +522,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -469,6 +541,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -487,8 +561,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -504,6 +580,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -522,8 +600,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -539,6 +619,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -557,8 +639,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -574,6 +658,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -592,8 +678,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -609,6 +697,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -627,8 +717,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -644,6 +736,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -662,8 +756,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -679,6 +775,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -697,8 +795,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -714,6 +814,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -732,8 +834,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>];
 export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     id: SiteStyleId;
@@ -750,6 +854,8 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
      * and foreground tokens.
      */
     designRuntimeRules?: DesignRuntimeRules;
+    /** Resolves semantic frames/items into this style's shape and depth language. */
+    componentRuntimeRules: ComponentRuntimeRules;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -768,11 +874,15 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
     paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
-    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
-    defaultTypographyPresetId: KnownTypographyPresetId;
+    /** Concrete typography applied when this site style is selected. */
+    typography: Theme["typography"];
+    /** Optional concrete hero typography applied with the site style. */
+    heroTypography?: SiteStyleHeroTypography;
 }>>;
 export declare function getCuratedSiteStyle(id: SiteStyleId): CuratedSiteStyle | null;
 export declare function designRuntimeRulesForSiteStyle(siteStyle: CuratedSiteStyle | null | undefined): DesignRuntimeRules;
 export declare function designRuntimeRulesForTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined): DesignRuntimeRules;
+export declare function componentRuntimeRulesForSiteStyle(siteStyle: CuratedSiteStyle | null | undefined): ComponentRuntimeRules;
+export declare function componentRuntimeRulesForTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined): ComponentRuntimeRules;
 export declare function defaultBlockVariantForSiteStyle(siteStyle: CuratedSiteStyle, blockKind: 'block.faq'): FaqDefaultBlockVariant | null;
 export {};

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

@@ -251,6 +251,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     eventListTreatment: z.ZodOptional<z.ZodEnum<{
         plain: "plain";
         "lined-panel": "lined-panel";
+        "ruled-register": "ruled-register";
+        "editorial-register": "editorial-register";
+        "dense-index": "dense-index";
     }>>;
     eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
         accent: "accent";
@@ -469,6 +472,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         eventListTreatment: z.ZodOptional<z.ZodEnum<{
             plain: "plain";
             "lined-panel": "lined-panel";
+            "ruled-register": "ruled-register";
+            "editorial-register": "editorial-register";
+            "dense-index": "dense-index";
         }>>;
         eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
             accent: "accent";

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

@@ -35,7 +35,8 @@ export declare const generatedSiteStyleIdSchema: z.ZodPipe<z.ZodEnum<{
     "site-style:kirtan-ornate": "site-style:kirtan-ornate";
     "site-style:original-joy": "site-style:original-joy";
     "site-style:fulcrum": "site-style:fulcrum";
-}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:kirtan-ornate" | "site-style:original-joy" | "site-style:fulcrum">>;
+    "site-style:grounded-practice": "site-style:grounded-practice";
+}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:kirtan-ornate" | "site-style:original-joy" | "site-style:fulcrum" | "site-style:grounded-practice">>;
 export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
     sectionSurface: z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"generated">;
@@ -185,7 +186,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
         "site-style:kirtan-ornate": "site-style:kirtan-ornate";
         "site-style:original-joy": "site-style:original-joy";
         "site-style:fulcrum": "site-style:fulcrum";
-    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:kirtan-ornate" | "site-style:original-joy" | "site-style:fulcrum">>;
+        "site-style:grounded-practice": "site-style:grounded-practice";
+    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school" | "site-style:kirtan-ornate" | "site-style:original-joy" | "site-style:fulcrum" | "site-style:grounded-practice">>;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         blockKind: z.ZodString;

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

@@ -36,7 +36,7 @@ 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", "serif-line", "flat-tabs", "glass", "minimal-surface", "soft-shell", "split-glass", "split-pill"];
+export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "brand-capsule", "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;
@@ -339,6 +339,16 @@ export declare const headerStyleCatalog: readonly [{
     readonly defaultDepth: "none";
     readonly navTypography: "brand-caps";
     readonly moods: readonly ["expressive"];
+}, {
+    readonly id: HeaderStyleId;
+    readonly label: "Brand Capsule";
+    readonly description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.";
+    readonly supportedLayoutIds: readonly HeaderLayoutId[];
+    readonly navInteraction: "pill-background";
+    readonly surface: "brand-solid";
+    readonly defaultDepth: "shadow";
+    readonly navTypography: "quiet-caps";
+    readonly moods: readonly ["expressive", "professional"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Serif Line";
@@ -468,6 +478,7 @@ export declare const legacyHeaderLookAliases: readonly [{
 export declare function getHeaderLayout(id: HeaderLayoutId): HeaderLayoutDefinition | null;
 export declare function getHeaderStyle(id: HeaderStyleId): HeaderStyleDefinition | null;
 export declare function isHeaderStyleCompatibleWithLayout(style: HeaderStyleDefinition, layoutId: HeaderLayoutId): boolean;
+export declare function headerLayoutSupportsBarFrame(layoutId: HeaderLayoutId): boolean;
 export declare function resolveLegacyHeaderLookAlias(lookId: HeaderLookId): HeaderLayoutStyleSelection | null;
 export declare function findLegacyHeaderLookIdForSelection(selection: HeaderLayoutStyleSelection): HeaderLookId | null;
 export declare function getCompatibleHeaderStyleIds(layoutId: HeaderLayoutId): readonly HeaderStyleId[];

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

@@ -34,6 +34,6 @@ export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';
 export * from './styleTags';
 export * from './tokenRecipes';
-export * from './typographyPresets';
+export * from './siteStyleTypography';
 export * from './themeParity';
 export * from './types';