@riverbankcms/sdk 0.81.0 → 0.84.0

package/dist/_dts/theme-core/src/shared/componentStyles.d.ts

@@ -18,13 +18,13 @@ export declare const componentBorderSchema: z.ZodObject<{
     width: z.ZodDefault<z.ZodEnum<{
         medium: "medium";
         none: "none";
-        thick: "thick";
         thin: "thin";
+        thick: "thick";
         hairline: "hairline";
     }>>;
     style: z.ZodDefault<z.ZodEnum<{
-        dashed: "dashed";
         solid: "solid";
+        dashed: "dashed";
     }>>;
     colorToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

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

@@ -0,0 +1,27 @@
+import { type ThemeColorToken } from '../tokens';
+export type BackgroundTextLegibilityRole = 'body' | 'large';
+export declare const BACKGROUND_BODY_TEXT_MIN_CONTRAST_RATIO = 4.5;
+export declare const BACKGROUND_LARGE_TEXT_MIN_CONTRAST_RATIO = 3;
+export declare const backgroundTextLegibilityMinContrastRatio: {
+    readonly body: 4.5;
+    readonly large: 3;
+};
+export type ThemeBackgroundTextLegibilityPlan = Readonly<{
+    kind: 'theme-foreground-token';
+    foregroundToken: string;
+    minContrastRatio: 4.5 | 3;
+}>;
+export type ThemeChromeTextLegibilityPlan = Readonly<{
+    kind: 'theme-color-token';
+    foregroundToken: ThemeColorToken;
+    minContrastRatio: 4.5 | 3;
+}>;
+export declare const backgroundAppearanceQuickColorTokenNames: readonly ["background", "surface", "muted", "primary", "secondary", "accent"];
+export declare const backgroundAppearanceBaseColorTokenNames: readonly ["background", "surface", "surfaceAlt", "muted", "primary", "secondary", "accent", "neutral"];
+export declare const backgroundAppearanceShadeableColorTokenNames: readonly ["primary", "secondary", "accent", "neutral"];
+export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "primary" | "secondary" | "background" | "accent" | "muted" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "accent-500" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-900" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "primary" | "secondary" | "background" | "accent" | "muted" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "accent-500" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-900" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare function parseBackgroundAppearanceColorToken(value: unknown): ThemeColorToken | null;
+export declare function foregroundTokenForBackgroundAppearanceColorToken(token: ThemeColorToken): string;
+export declare function planThemeBackgroundTextLegibility(backgroundToken: ThemeColorToken, role?: BackgroundTextLegibilityRole): ThemeBackgroundTextLegibilityPlan;
+export declare function planThemeChromeTextLegibility(backgroundToken: ThemeColorToken, role?: BackgroundTextLegibilityRole): ThemeChromeTextLegibilityPlan;

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

@@ -6,9 +6,10 @@ 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';
 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: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"];
 export type CuratedSiteStyleIdValue = (typeof curatedSiteStyleIdValues)[number];
 type CuratedSiteStyleHeroOverrides = Readonly<{
     typography?: NonNullable<NonNullable<Theme['hero']>['typography']>;
@@ -89,6 +90,12 @@ export type CuratedSiteStyle = Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -127,6 +134,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -156,6 +169,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -185,6 +204,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -214,6 +239,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -243,6 +274,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -272,6 +309,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -301,6 +344,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -330,6 +379,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -359,6 +414,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -388,6 +449,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -417,6 +484,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -446,6 +519,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -475,6 +554,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -504,6 +589,12 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -533,6 +624,47 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     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;
+    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. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
+    defaultTypographyPresetId: KnownTypographyPresetId;
+}>, 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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -563,6 +695,12 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     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;
     defaultBlockVariants?: CuratedSiteStyleDefaultBlockVariants;
     /**
      * Site-wide heading decoration signature (family + colour). Applied to
@@ -585,5 +723,7 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>>;
 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 defaultBlockVariantForSiteStyle(siteStyle: CuratedSiteStyle, blockKind: 'block.faq'): FaqDefaultBlockVariant | null;
 export {};

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

@@ -122,9 +122,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"panel">;
         treatment: z.ZodEnum<{
-            inset: "inset";
             editorial: "editorial";
             raised: "raised";
+            inset: "inset";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"flush-panel">;
@@ -133,19 +133,19 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         }>;
         bleed: z.ZodEnum<{
             both: "both";
-            end: "end";
             start: "start";
+            end: "end";
         }>;
     }, z.core.$strict>], "kind">;
     itemSurface: z.ZodEnum<{
         flat: "flat";
         none: "none";
         default: "default";
-        inset: "inset";
         editorial: "editorial";
         raised: "raised";
         "color-blocked": "color-blocked";
         outlined: "outlined";
+        inset: "inset";
     }>;
     transitionAfter: z.ZodEnum<{
         none: "none";
@@ -163,8 +163,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }>;
     emphasis: z.ZodEnum<{
         medium: "medium";
-        high: "high";
         low: "low";
+        high: "high";
     }>;
     sectionHeight: z.ZodOptional<z.ZodEnum<{
         default: "default";
@@ -182,8 +182,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         "bottom-left": "bottom-left";
     }>>;
     heroTypographyScale: z.ZodOptional<z.ZodEnum<{
-        poster: "poster";
         display: "display";
+        poster: "poster";
         editorial: "editorial";
         quiet: "quiet";
     }>>;
@@ -255,6 +255,7 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
         plain: "plain";
         pill: "pill";
+        accent: "accent";
         "accent-pill": "accent-pill";
         "pill-bounce": "pill-bounce";
         "accent-pill-bounce": "accent-pill-bounce";
@@ -286,12 +287,12 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
     unit: z.ZodLiteral<"block-runtime-fields">;
     blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
     fields: z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        _frameStyles: "_frameStyles";
         _sectionStyles: "_sectionStyles";
         _containerStyles: "_containerStyles";
-        _frameStyles: "_frameStyles";
         _cardStyles: "_cardStyles";
         styleGroup: "styleGroup";
-    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_sectionStyles" | "_containerStyles" | "_frameStyles" | "_cardStyles" | "styleGroup")[]>>;
+    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"theme-v2">;
         source: z.ZodEnum<{
@@ -338,9 +339,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"panel">;
             treatment: z.ZodEnum<{
-                inset: "inset";
                 editorial: "editorial";
                 raised: "raised";
+                inset: "inset";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"flush-panel">;
@@ -349,19 +350,19 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             }>;
             bleed: z.ZodEnum<{
                 both: "both";
-                end: "end";
                 start: "start";
+                end: "end";
             }>;
         }, z.core.$strict>], "kind">;
         itemSurface: z.ZodEnum<{
             flat: "flat";
             none: "none";
             default: "default";
-            inset: "inset";
             editorial: "editorial";
             raised: "raised";
             "color-blocked": "color-blocked";
             outlined: "outlined";
+            inset: "inset";
         }>;
         transitionAfter: z.ZodEnum<{
             none: "none";
@@ -379,8 +380,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }>;
         emphasis: z.ZodEnum<{
             medium: "medium";
-            high: "high";
             low: "low";
+            high: "high";
         }>;
         sectionHeight: z.ZodOptional<z.ZodEnum<{
             default: "default";
@@ -398,8 +399,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             "bottom-left": "bottom-left";
         }>>;
         heroTypographyScale: z.ZodOptional<z.ZodEnum<{
-            poster: "poster";
             display: "display";
+            poster: "poster";
             editorial: "editorial";
             quiet: "quiet";
         }>>;
@@ -471,6 +472,7 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
             plain: "plain";
             pill: "pill";
+            accent: "accent";
             "accent-pill": "accent-pill";
             "pill-bounce": "pill-bounce";
             "accent-pill-bounce": "accent-pill-bounce";
@@ -480,12 +482,12 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         unit: z.ZodLiteral<"block-runtime-fields">;
         blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
         fields: z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            _frameStyles: "_frameStyles";
             _sectionStyles: "_sectionStyles";
             _containerStyles: "_containerStyles";
-            _frameStyles: "_frameStyles";
             _cardStyles: "_cardStyles";
             styleGroup: "styleGroup";
-        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_sectionStyles" | "_containerStyles" | "_frameStyles" | "_cardStyles" | "styleGroup")[]>>;
+        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
         authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"theme-v2">;
             source: z.ZodEnum<{

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", "footer-centered-calm", "footer-editorial-columns", "site-footer-brand-two-band"];
+export declare const footerLookIdValues: readonly ["footer-identity-quiet", "footer-muted-grounding", "footer-centered-calm", "footer-split-editorial", "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;
@@ -18,18 +18,45 @@ export declare function parsePersistedFooterLookId(value: string): Exclude<Persi
     kind: 'empty';
 }>;
 export declare function parsePersistedFooterLookId(value: string | null | undefined): PersistedFooterLookIdParseResult;
+export declare const footerLayoutIdValues: readonly ["identity", "centered", "split", "columns"];
+export type FooterLayoutIdValue = typeof footerLayoutIdValues[number];
+export type FooterLayoutId = Brand<FooterLayoutIdValue, 'FooterLayoutId'>;
+export declare function asFooterLayoutId(value: FooterLayoutIdValue): FooterLayoutId;
+export declare const footerStyleIdValues: readonly ["quiet", "calm", "editorial", "brand-band"];
+export type FooterStyleIdValue = typeof footerStyleIdValues[number];
+export type FooterStyleId = Brand<FooterStyleIdValue, 'FooterStyleId'>;
+export declare function asFooterStyleId(value: FooterStyleIdValue): FooterStyleId;
+export type FooterLayoutDefinition = Readonly<{
+    id: FooterLayoutId;
+    label: string;
+    description: string;
+    requiresFooterNav?: boolean;
+    requiresFooterNavGroups?: boolean;
+    maxRecommendedNavDensity?: Extract<FooterSelectionContext['navDensity'], 'sparse' | 'balanced'>;
+}>;
+export type FooterStyleDefinition = Readonly<{
+    id: FooterStyleId;
+    label: string;
+    description: string;
+}>;
 export type FooterLookDefinition = Readonly<{
     id: FooterLookId;
     label: string;
+    layoutId: FooterLayoutId;
+    styleId: FooterStyleId;
+    hiddenFromLayoutStyleControls?: boolean;
+    requiresFooterNav?: boolean;
+    requiresFooterNavGroups?: boolean;
     maxRecommendedNavDensity?: Extract<FooterSelectionContext['navDensity'], 'sparse' | 'balanced'>;
     allowedContentPresence?: readonly Exclude<FooterSelectionContext['contentPresence'], 'unknown'>[];
     compile: (theme: Theme) => Theme['footer'];
 }>;
 export type FooterSelectionContext = Readonly<{
-    navDensity: 'unknown' | 'sparse' | 'balanced' | 'dense';
+    navDensity: 'unknown' | 'none' | 'sparse' | 'balanced' | 'dense';
+    groupedNav: 'unknown' | 'none' | 'present';
     contentPresence: 'unknown' | 'default-footer' | 'footer-blocks' | 'default-and-blocks';
 }>;
-export type RejectedFooterLookReason = 'footer-nav-too-dense' | 'footer-content-incompatible';
+export type RejectedFooterLookReason = 'footer-nav-required' | 'footer-nav-groups-required' | 'footer-nav-too-dense' | 'footer-content-incompatible';
 export type RejectedFooterLook = Readonly<{
     lookId: FooterLookId;
     reasons: readonly RejectedFooterLookReason[];
@@ -48,7 +75,63 @@ export type FooterLookResolutionInput = Readonly<{
 }>;
 export declare const defaultFooterSelectionContext: FooterSelectionContext;
 export declare const guaranteedFallbackFooterLookId: FooterLookId;
-/** Uses the generated theme's footer branch as-is: the canonical calm Look. */
+export declare const footerLayoutCatalog: readonly [{
+    readonly id: FooterLayoutId;
+    readonly label: "Identity";
+    readonly description: "Logo, site text, address, and legal copy without relying on footer navigation.";
+}, {
+    readonly id: FooterLayoutId;
+    readonly label: "Centered";
+    readonly description: "A calm centered stack for identity, short copy, and optional compact navigation.";
+    readonly maxRecommendedNavDensity: "sparse";
+}, {
+    readonly id: FooterLayoutId;
+    readonly label: "Split";
+    readonly description: "Navigation and brand signoff separated into a wider split footer.";
+    readonly requiresFooterNav: true;
+    readonly maxRecommendedNavDensity: "balanced";
+}, {
+    readonly id: FooterLayoutId;
+    readonly label: "Columns";
+    readonly description: "Grouped footer navigation columns with a supporting bottom line.";
+    readonly requiresFooterNav: true;
+    readonly requiresFooterNavGroups: true;
+}];
+export declare const footerStyleCatalog: readonly [{
+    readonly id: FooterStyleId;
+    readonly label: "Quiet";
+    readonly description: "Lightweight, practical footer treatment.";
+}, {
+    readonly id: FooterStyleId;
+    readonly label: "Calm";
+    readonly description: "Soft centered treatment with restrained dividers.";
+}, {
+    readonly id: FooterStyleId;
+    readonly label: "Editorial";
+    readonly description: "Text-forward treatment with fine-line structure.";
+}, {
+    readonly id: FooterStyleId;
+    readonly label: "Brand band";
+    readonly description: "High-contrast brand treatment with a stronger bottom bar.";
+}];
+export declare function getFooterLayout(id: FooterLayoutId): FooterLayoutDefinition | null;
+export declare function getFooterStyle(id: FooterStyleId): FooterStyleDefinition | null;
+export declare function getFooterLooksForLayout(layoutId: FooterLayoutId): readonly FooterLookDefinition[];
+export declare function getFooterLooksForStyle(styleId: FooterStyleId): readonly FooterLookDefinition[];
+export declare function findFooterLookForLayoutStyle(input: Readonly<{
+    layoutId: FooterLayoutId;
+    styleId: FooterStyleId;
+}>): FooterLookDefinition | null;
+export declare function findDefaultFooterLookForLayout(layoutId: FooterLayoutId): FooterLookDefinition | null;
+/**
+ * No-nav-safe identity footer: brand and legal/supporting copy carry the
+ * footer without implying missing navigation.
+ */
+declare function identityQuietFooter(theme: Theme): Theme['footer'];
+/**
+ * Back-compat alias for the previous default footer Look. It keeps existing
+ * persisted selections valid while staying hidden from the new layout/style UI.
+ */
 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'];
@@ -57,6 +140,8 @@ declare function brandTwoBandFooter(theme: Theme): Theme['footer'];
  * hairline-topped copyright line, all centered.
  */
 declare function centeredCalmFooter(theme: Theme): Theme['footer'];
+/** Editorial split footer: compact nav on one side, brand signoff on the other. */
+declare function splitEditorialFooter(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
@@ -64,21 +149,41 @@ declare function centeredCalmFooter(theme: Theme): Theme['footer'];
  */
 declare function editorialColumnsFooter(theme: Theme): Theme['footer'];
 export declare const footerLookCatalog: readonly [{
+    readonly id: FooterLookId;
+    readonly label: "Identity footer";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
+    readonly compile: typeof identityQuietFooter;
+}, {
     readonly id: FooterLookId;
     readonly label: "Muted grounding footer";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
+    readonly hiddenFromLayoutStyleControls: true;
     readonly compile: typeof mutedGroundingFooter;
 }, {
     readonly id: FooterLookId;
     readonly label: "Centered calm footer";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
     readonly compile: typeof centeredCalmFooter;
+}, {
+    readonly id: FooterLookId;
+    readonly label: "Split editorial footer";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
+    readonly compile: typeof splitEditorialFooter;
 }, {
     readonly id: FooterLookId;
     readonly label: "Editorial columns footer";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
     readonly compile: typeof editorialColumnsFooter;
 }, {
     readonly id: FooterLookId;
     readonly label: "Two-band brand footer";
-    readonly maxRecommendedNavDensity: "balanced";
+    readonly layoutId: FooterLayoutId;
+    readonly styleId: FooterStyleId;
     readonly allowedContentPresence: readonly ["default-footer", "default-and-blocks"];
     readonly compile: typeof brandTwoBandFooter;
 }];