@riverbankcms/sdk 0.79.0 → 0.80.0

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

@@ -394,6 +394,24 @@ export declare const appearancePresets: readonly [{
         readonly itemSurface: "none";
         readonly transitionAfter: "soft-fade-short";
         readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "intro-portrait-bio";
+    readonly target: "intro";
+    readonly label: "Portrait and bio";
+    readonly blockKinds: readonly ["block.intro"];
+    readonly constraints: {
+        readonly layoutVariantKeys: readonly ["media-copy"];
+    };
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
         readonly headingDecoration: {
             readonly family: "organic-squiggle";
             readonly placement: "after-heading";
@@ -429,11 +447,51 @@ export declare const appearancePresets: readonly [{
         readonly itemSurface: "raised";
         readonly transitionAfter: "none";
         readonly emphasis: "high";
-        readonly headingDecoration: {
-            readonly family: "short-center-rule";
-            readonly placement: "under-centered-heading";
-            readonly colorToken: "primary";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-editorial-columns";
+    readonly target: "feature-cards";
+    readonly label: "Editorial open columns";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "editorial";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-soft-panels";
+    readonly target: "feature-cards";
+    readonly label: "Soft tinted panels";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "inset";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-photo-tiles";
+    readonly target: "feature-cards";
+    readonly label: "Photo tiles";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
         };
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
     };
 }, {
     readonly kind: "block-design";
@@ -578,9 +636,25 @@ export declare const appearancePresets: readonly [{
     };
 }, {
     readonly kind: "block-design";
-    readonly id: "testimonials-accent-quote-cards";
+    readonly id: "testimonials-default-cards";
+    readonly target: "testimonials";
+    readonly label: "Default cards";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+        readonly testimonialCardTreatment: "default";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-statement-cards";
     readonly target: "testimonials";
-    readonly label: "Accent quote cards";
+    readonly label: "Statement cards";
     readonly blockKinds: readonly ["block.testimonials"];
     readonly design: {
         readonly sectionSurface: "accent-band";
@@ -590,28 +664,23 @@ export declare const appearancePresets: readonly [{
         readonly itemSurface: "raised";
         readonly transitionAfter: "soft-fade-short";
         readonly emphasis: "high";
-        readonly testimonialCardTreatment: "accent-quote";
+        readonly testimonialCardTreatment: "statement";
     };
 }, {
     readonly kind: "block-design";
-    readonly id: "testimonials-brand-background-quotes";
+    readonly id: "testimonials-non-carded";
     readonly target: "testimonials";
-    readonly label: "Brand background quotes";
+    readonly label: "Non-carded";
     readonly blockKinds: readonly ["block.testimonials"];
     readonly design: {
-        readonly sectionSurface: "brand-depth-band";
+        readonly sectionSurface: "muted-band";
         readonly contentFrame: {
             readonly kind: "plain";
         };
         readonly itemSurface: "none";
         readonly transitionAfter: "soft-fade-short";
-        readonly emphasis: "high";
-        readonly testimonialCardTreatment: "accent-quote";
-        readonly headingDecoration: {
-            readonly family: "short-center-rule";
-            readonly placement: "under-centered-heading";
-            readonly colorToken: "border";
-        };
+        readonly emphasis: "medium";
+        readonly testimonialCardTreatment: "non-carded";
     };
 }, {
     readonly kind: "block-design";

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

@@ -1,5 +1,5 @@
 import type { BlockLayoutFamily } from './blockFlow';
-import type { ContentFrameIntent, EyebrowTreatment, EventListTreatment, HeroCompositionIntent, HeroLegibilityStrategy, HeroTypographyScaleIntent, HeadingDecoration, ImageSurfaceMotion, ImageSurfaceTreatment, AccordionIconTreatment, NonEmptyReadonlyArray, SectionHeightIntent, SiteStyleEmphasis, SiteStyleItemSurfaceIntent, SiteStyleSectionTransitionIntent, SiteStyleSurfaceIntent, TestimonialCardTreatment, TileTreatment } from './types';
+import type { ContentFrameIntent, EyebrowTreatment, EventListTreatment, HeroCompositionIntent, HeroLegibilityStrategy, HeroTypographyScaleIntent, ImageSurfaceMotion, ImageSurfaceTreatment, AccordionIconTreatment, NonEmptyReadonlyArray, SectionHeightIntent, SiteStyleEmphasis, SiteStyleItemSurfaceIntent, SiteStyleSectionTransitionIntent, SiteStyleSurfaceIntent, TestimonialCardTreatment, TileTreatment } from './types';
 export type AppearancePresetTarget = 'hero' | 'intro' | 'body-text' | 'offerings' | 'feature-cards' | 'events' | 'media-text' | 'testimonials' | 'faq' | 'contact-form' | 'cta';
 export type BlockAppearanceDesign = Readonly<{
     sectionSurface: SiteStyleSurfaceIntent;
@@ -17,14 +17,13 @@ export type BlockAppearanceDesign = Readonly<{
     tileTreatment?: TileTreatment;
     eventListTreatment?: EventListTreatment;
     eyebrowTreatment?: EyebrowTreatment;
-    headingDecoration?: HeadingDecoration;
     accordionIconTreatment?: AccordionIconTreatment | null;
 }>;
 export type BlockAppearancePresetConstraints = Readonly<{
     layoutFamilies?: readonly BlockLayoutFamily[];
     layoutVariantKeys?: readonly string[];
 }>;
-export type BlockAppearanceOptionDesignPatch = Readonly<Partial<Pick<BlockAppearanceDesign, 'heroLegibility' | 'heroComposition' | 'heroTypographyScale' | 'imageSurfaceTreatment' | 'imageSurfaceMotion' | 'sectionHeight' | 'testimonialCardTreatment' | 'tileTreatment' | 'eventListTreatment' | 'eyebrowTreatment' | 'headingDecoration' | 'accordionIconTreatment'>>>;
+export type BlockAppearanceOptionDesignPatch = Readonly<Partial<Pick<BlockAppearanceDesign, 'heroLegibility' | 'heroComposition' | 'heroTypographyScale' | 'imageSurfaceTreatment' | 'imageSurfaceMotion' | 'sectionHeight' | 'testimonialCardTreatment' | 'tileTreatment' | 'eventListTreatment' | 'eyebrowTreatment' | 'accordionIconTreatment'>>>;
 export type BlockAppearanceLayoutDesignPatch = BlockAppearanceOptionDesignPatch;
 export type BlockAppearanceOption = Readonly<{
     id: string;

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

@@ -393,6 +393,24 @@ export declare const blockAppearancePresets: readonly [{
         readonly itemSurface: "none";
         readonly transitionAfter: "soft-fade-short";
         readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "intro-portrait-bio";
+    readonly target: "intro";
+    readonly label: "Portrait and bio";
+    readonly blockKinds: readonly ["block.intro"];
+    readonly constraints: {
+        readonly layoutVariantKeys: readonly ["media-copy"];
+    };
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
         readonly headingDecoration: {
             readonly family: "organic-squiggle";
             readonly placement: "after-heading";
@@ -428,11 +446,51 @@ export declare const blockAppearancePresets: readonly [{
         readonly itemSurface: "raised";
         readonly transitionAfter: "none";
         readonly emphasis: "high";
-        readonly headingDecoration: {
-            readonly family: "short-center-rule";
-            readonly placement: "under-centered-heading";
-            readonly colorToken: "primary";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-editorial-columns";
+    readonly target: "feature-cards";
+    readonly label: "Editorial open columns";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "editorial";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-soft-panels";
+    readonly target: "feature-cards";
+    readonly label: "Soft tinted panels";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "inset";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "feature-cards-photo-tiles";
+    readonly target: "feature-cards";
+    readonly label: "Photo tiles";
+    readonly blockKinds: readonly ["block.feature-cards"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
         };
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
     };
 }, {
     readonly kind: "block-design";
@@ -577,9 +635,25 @@ export declare const blockAppearancePresets: readonly [{
     };
 }, {
     readonly kind: "block-design";
-    readonly id: "testimonials-accent-quote-cards";
+    readonly id: "testimonials-default-cards";
+    readonly target: "testimonials";
+    readonly label: "Default cards";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+        readonly testimonialCardTreatment: "default";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-statement-cards";
     readonly target: "testimonials";
-    readonly label: "Accent quote cards";
+    readonly label: "Statement cards";
     readonly blockKinds: readonly ["block.testimonials"];
     readonly design: {
         readonly sectionSurface: "accent-band";
@@ -589,28 +663,23 @@ export declare const blockAppearancePresets: readonly [{
         readonly itemSurface: "raised";
         readonly transitionAfter: "soft-fade-short";
         readonly emphasis: "high";
-        readonly testimonialCardTreatment: "accent-quote";
+        readonly testimonialCardTreatment: "statement";
     };
 }, {
     readonly kind: "block-design";
-    readonly id: "testimonials-brand-background-quotes";
+    readonly id: "testimonials-non-carded";
     readonly target: "testimonials";
-    readonly label: "Brand background quotes";
+    readonly label: "Non-carded";
     readonly blockKinds: readonly ["block.testimonials"];
     readonly design: {
-        readonly sectionSurface: "brand-depth-band";
+        readonly sectionSurface: "muted-band";
         readonly contentFrame: {
             readonly kind: "plain";
         };
         readonly itemSurface: "none";
         readonly transitionAfter: "soft-fade-short";
-        readonly emphasis: "high";
-        readonly testimonialCardTreatment: "accent-quote";
-        readonly headingDecoration: {
-            readonly family: "short-center-rule";
-            readonly placement: "under-centered-heading";
-            readonly colorToken: "border";
-        };
+        readonly emphasis: "medium";
+        readonly testimonialCardTreatment: "non-carded";
     };
 }, {
     readonly kind: "block-design";

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

@@ -4,7 +4,7 @@ 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 NonEmptyReadonlyArray, type SiteStyleId } from './types';
+import { type AppearancePresetId, type DesignSystemTemplate, type HeadingDecoration, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
 import { type KnownTypographyPresetId, type TypographyPresetId } from './typographyPresets';
 export declare const SOFT_EARTH_SITE_STYLE_ID_VALUE: "site-style:soft-earth";
 export declare const SOFT_EARTH_SITE_STYLE_ID: SiteStyleId;
@@ -18,6 +18,8 @@ type CuratedSiteStyleBodyTextOverrides = Readonly<{
 }>;
 type CuratedSiteStyleInputOverrides = NonNullable<Theme['inputs']>;
 type CuratedSiteStyleAccordionOverrides = NonNullable<Theme['accordions']>;
+type CuratedSiteStyleCardOverrides = NonNullable<Theme['cards']>;
+type CuratedSiteStyleTestimonialQuoteOverrides = NonNullable<Theme['testimonialQuote']>;
 /**
  * Site-style-specific Theme overrides are applied after token recipes,
  * button personality, and palette variant selection have compiled the base
@@ -34,6 +36,17 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
      */
     inputs?: CuratedSiteStyleInputOverrides;
     accordions?: CuratedSiteStyleAccordionOverrides;
+    /**
+     * Card variants (default + optional alternative/statement) the site style
+     * owns. Card-using blocks resolve a variant by role; see generateCardCss,
+     * which emits a `.card-{id}` class per enabled variant.
+     */
+    cards?: CuratedSiteStyleCardOverrides;
+    /**
+     * Testimonial quote-mark treatment the site style owns (analogue of the FAQ
+     * accordion icon). Every curated style declares one; looks may still hide it.
+     */
+    testimonialQuote?: CuratedSiteStyleTestimonialQuoteOverrides;
 }>;
 export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
 export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
@@ -77,6 +90,12 @@ export type CuratedSiteStyle = Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -109,6 +128,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -132,6 +157,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -155,6 +186,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -178,6 +215,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -201,6 +244,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -224,6 +273,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -247,6 +302,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -270,6 +331,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -293,6 +360,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -316,6 +389,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -339,6 +418,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -362,6 +447,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -385,6 +476,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -408,6 +505,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;
@@ -432,6 +535,12 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     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>;

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

@@ -1,7 +1,7 @@
 import type { Theme } from '../schema';
 import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
 import { type Brand } from './types';
-export declare const footerLookIdValues: readonly ["footer-muted-grounding", "site-footer-brand-two-band"];
+export declare const footerLookIdValues: readonly ["footer-muted-grounding", "footer-centered-calm", "footer-editorial-columns", "site-footer-brand-two-band"];
 export type FooterLookIdValue = typeof footerLookIdValues[number];
 export type FooterLookId = Brand<FooterLookIdValue, 'FooterLookId'>;
 export declare function asFooterLookId(value: FooterLookIdValue): FooterLookId;
@@ -52,10 +52,29 @@ export declare const guaranteedFallbackFooterLookId: FooterLookId;
 declare function mutedGroundingFooter(theme: Theme): Theme['footer'];
 /** Applies a high-contrast brand band with a darker full-bleed bottom bar. */
 declare function brandTwoBandFooter(theme: Theme): Theme['footer'];
+/**
+ * Centered stack on a softly tinted band: logo, inline nav, address, and a
+ * hairline-topped copyright line, all centered.
+ */
+declare function centeredCalmFooter(theme: Theme): Theme['footer'];
+/**
+ * Editorial columns: site name and supporting copy on the left, inline nav on
+ * the right, with a hairline-topped bottom line. Uses the footer block's
+ * columns layout.
+ */
+declare function editorialColumnsFooter(theme: Theme): Theme['footer'];
 export declare const footerLookCatalog: readonly [{
     readonly id: FooterLookId;
     readonly label: "Muted grounding footer";
     readonly compile: typeof mutedGroundingFooter;
+}, {
+    readonly id: FooterLookId;
+    readonly label: "Centered calm footer";
+    readonly compile: typeof centeredCalmFooter;
+}, {
+    readonly id: FooterLookId;
+    readonly label: "Editorial columns footer";
+    readonly compile: typeof editorialColumnsFooter;
 }, {
     readonly id: FooterLookId;
     readonly label: "Two-band brand footer";

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

@@ -82,6 +82,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
             flat: "flat";
             none: "none";
             default: "default";
+            inset: "inset";
+            editorial: "editorial";
             raised: "raised";
             outlined: "outlined";
         }>;
@@ -230,6 +232,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                     flat: "flat";
                     none: "none";
                     default: "default";
+                    inset: "inset";
+                    editorial: "editorial";
                     raised: "raised";
                     outlined: "outlined";
                 }>;