@riverbankcms/sdk 0.104.1 → 0.107.0

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

@@ -1,23 +1,28 @@
 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"];
+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']>;
 }>;
 type CuratedSiteStyleInputOverrides = NonNullable<Theme['inputs']>;
+/**
+ * Partial theme `shadow` override a site style may carry. Merged onto the
+ * compiled theme's `shadow` (which the token-recipe compiler always emits), so
+ * a style can pin just `colorToken` to tint the shadow ramp while inheriting
+ * the recipe-derived elevation/softness/position. Omitting it leaves the
+ * neutral-black ramp unchanged (byte-identical to before).
+ */
+type CuratedSiteStyleShadowOverrides = Partial<NonNullable<Theme['shadow']>>;
 type CuratedSiteStyleAccordionOverrides = NonNullable<Theme['accordions']>;
 type CuratedSiteStyleCardOverrides = NonNullable<Theme['cards']>;
 type CuratedSiteStyleTestimonialQuoteOverrides = NonNullable<Theme['testimonialQuote']>;
@@ -28,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
@@ -37,6 +40,12 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
      */
     inputs?: CuratedSiteStyleInputOverrides;
     accordions?: CuratedSiteStyleAccordionOverrides;
+    /**
+     * Partial theme `shadow` override, merged onto the compiled theme's shadow.
+     * Typically used to set `colorToken` for an ink-tinted shadow ramp while the
+     * elevation/softness stay recipe-derived. Optional; unset → neutral ramp.
+     */
+    shadow?: CuratedSiteStyleShadowOverrides;
     /**
      * Card variants (default + optional alternative/statement) the site style
      * owns. Card-using blocks resolve a variant by role; see generateCardCss,
@@ -50,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<{
@@ -58,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;
@@ -96,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
@@ -114,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
@@ -140,6 +151,86 @@ 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
+     * 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
@@ -158,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;
@@ -175,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
@@ -193,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;
@@ -210,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
@@ -228,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;
@@ -245,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
@@ -263,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;
@@ -280,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
@@ -298,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;
@@ -315,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
@@ -333,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;
@@ -350,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
@@ -368,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;
@@ -385,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
@@ -403,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;
@@ -420,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
@@ -438,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;
@@ -455,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
@@ -473,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;
@@ -490,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
@@ -508,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;
@@ -525,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
@@ -543,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;
@@ -560,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
@@ -578,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;
@@ -595,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
@@ -613,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;
@@ -630,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
@@ -648,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;
@@ -665,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
@@ -683,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;
@@ -701,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
@@ -719,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

@@ -132,9 +132,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
             "media-panel": "media-panel";
         }>;
         bleed: z.ZodEnum<{
+            end: "end";
             both: "both";
             start: "start";
-            end: "end";
         }>;
     }, z.core.$strict>], "kind">;
     itemSurface: z.ZodEnum<{
@@ -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";
@@ -350,9 +353,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
                 "media-panel": "media-panel";
             }>;
             bleed: z.ZodEnum<{
+                end: "end";
                 both: "both";
                 start: "start";
-                end: "end";
             }>;
         }, z.core.$strict>], "kind">;
         itemSurface: z.ZodEnum<{
@@ -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

@@ -34,7 +34,9 @@ export declare const generatedSiteStyleIdSchema: z.ZodPipe<z.ZodEnum<{
     "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
     "site-style:kirtan-ornate": "site-style:kirtan-ornate";
     "site-style:original-joy": "site-style:original-joy";
-}>, 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: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">;
@@ -183,7 +185,9 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
         "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
         "site-style:kirtan-ornate": "site-style:kirtan-ornate";
         "site-style:original-joy": "site-style:original-joy";
-    }>, 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: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;