@riverbankcms/sdk 0.130.0 → 0.132.0

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

@@ -1,5 +1,5 @@
 import type { AppearancePresetTarget, BlockAppearancePreset } from './appearancePresetTypes';
-export declare const appearancePresets: readonly [{
+export declare const appearancePresets: readonly [import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-immersive-image";
     readonly target: "hero";
     readonly label: "Immersive image hero";
@@ -21,7 +21,6 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "hero";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -29,7 +28,7 @@ export declare const appearancePresets: readonly [{
             readonly kind: "neutral-wash";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-bottom-left-panel";
     readonly target: "hero";
     readonly label: "Bottom-left panel hero";
@@ -77,7 +76,6 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "bottom-left";
         readonly heroTypographyScale: "display";
@@ -86,7 +84,7 @@ export declare const appearancePresets: readonly [{
             readonly intensity: "balanced";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-poster-image";
     readonly target: "hero";
     readonly label: "Poster image hero";
@@ -108,7 +106,6 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "poster";
@@ -118,7 +115,7 @@ export declare const appearancePresets: readonly [{
             readonly intensity: "strong";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-brand-scrim";
     readonly target: "hero";
     readonly label: "Brand scrim image hero";
@@ -162,7 +159,6 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -171,7 +167,7 @@ export declare const appearancePresets: readonly [{
             readonly token: "primary";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-brand-scrim-fixed-frame";
     readonly target: "hero";
     readonly label: "Fixed-frame brand scrim hero";
@@ -215,7 +211,6 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -226,7 +221,7 @@ export declare const appearancePresets: readonly [{
         readonly imageSurfaceMotion: "fixed-frame";
         readonly eyebrowTreatment: "accent-pill-bounce";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-brand-depth-expressive";
     readonly target: "hero";
     readonly label: "Expressive brand-depth hero";
@@ -239,12 +234,11 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "editorial";
         readonly eyebrowTreatment: "accent-pill-bounce";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-contained-intro";
     readonly target: "hero";
     readonly label: "Contained intro hero";
@@ -255,11 +249,10 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "inset";
         }>;
-        readonly itemSurface: "none";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "editorial";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-split-editorial";
     readonly target: "hero";
     readonly label: "Editorial split hero";
@@ -272,10 +265,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly heroTypographyScale: "editorial";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-split-brand";
     readonly target: "hero";
     readonly label: "Brand split hero";
@@ -288,11 +280,10 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly heroTypographyScale: "display";
         readonly eyebrowTreatment: "accent-pill-bounce";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-split-soft-panel";
     readonly target: "hero";
     readonly label: "Soft panel split hero";
@@ -306,10 +297,9 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
         readonly heroTypographyScale: "editorial";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-split-accent";
     readonly target: "hero";
     readonly label: "Accent split hero";
@@ -323,10 +313,9 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
         readonly heroTypographyScale: "display";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "intro-editorial-statement";
     readonly target: "intro";
     readonly label: "Editorial intro statement";
@@ -339,13 +328,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly composition: {
             readonly kind: "intro";
             readonly treatment: "editorial-statement";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "intro-portrait-bio";
     readonly target: "intro";
     readonly label: "Portrait and bio";
@@ -358,13 +346,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly composition: {
             readonly kind: "intro";
             readonly treatment: "portrait-bio";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-default-cards";
     readonly target: "offerings";
     readonly label: "Default offering cards";
@@ -374,9 +361,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "default";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-secondary-cards";
     readonly target: "offerings";
     readonly label: "Secondary offering cards";
@@ -386,9 +373,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "inset";
+        readonly cardRole: "alternative";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-non-carded";
     readonly target: "offerings";
     readonly label: "Non-carded offerings";
@@ -398,9 +385,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "editorial";
+        readonly cardRole: "open";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-paired-feature-cards";
     readonly target: "offerings";
     readonly label: "Paired feature cards";
@@ -413,9 +400,13 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly cardRole: "alternative";
+        readonly composition: {
+            readonly kind: "offerings-preview";
+            readonly treatment: "paired-feature-cards";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-open-editorial-columns";
     readonly target: "offerings";
     readonly label: "Open editorial columns";
@@ -428,9 +419,13 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly cardRole: "open";
+        readonly composition: {
+            readonly kind: "offerings-preview";
+            readonly treatment: "open-editorial-columns";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-joined-programme-panel";
     readonly target: "offerings";
     readonly label: "Joined programme panel";
@@ -443,9 +438,13 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly cardRole: "default";
+        readonly composition: {
+            readonly kind: "offerings-preview";
+            readonly treatment: "joined-programme-panel";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-raised-rule";
     readonly target: "feature-cards";
     readonly label: "Raised cards with rule";
@@ -455,9 +454,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "raised";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-bold-colors";
     readonly target: "feature-cards";
     readonly label: "Bold colour-blocked cards";
@@ -467,21 +466,21 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "color-blocked";
+        readonly cardRole: "alternative";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     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 sectionSurface: "muted-band";
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "editorial";
+        readonly cardRole: "open";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-asymmetric-emphasis";
     readonly target: "feature-cards";
     readonly label: "Asymmetric emphasis pair";
@@ -494,13 +493,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly composition: {
             readonly kind: "feature-cards";
             readonly treatment: "asymmetric-emphasis";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-framed-programme";
     readonly target: "feature-cards";
     readonly label: "Framed programme cards";
@@ -513,13 +511,13 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "inset";
+        readonly cardRole: "alternative";
         readonly composition: {
             readonly kind: "feature-cards";
             readonly treatment: "framed-programme";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-soft-panels";
     readonly target: "feature-cards";
     readonly label: "Soft tinted panels";
@@ -529,9 +527,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "inset";
+        readonly cardRole: "alternative";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-editorial-diptych";
     readonly target: "feature-cards";
     readonly label: "Editorial diptych";
@@ -544,9 +542,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "flat";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-editorial-pathways";
     readonly target: "feature-cards";
     readonly label: "Editorial pathways";
@@ -559,9 +557,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "flat";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-photo-tiles";
     readonly target: "feature-cards";
     readonly label: "Photo tiles";
@@ -571,9 +569,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "raised";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "events-lined-panel";
     readonly target: "events";
     readonly label: "Raised event panel";
@@ -584,9 +582,8 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "events-ruled-register";
     readonly target: "events";
     readonly label: "Ruled event register";
@@ -596,10 +593,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly eventListTreatment: "ruled-register";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "events-editorial-register";
     readonly target: "events";
     readonly label: "Editorial event register";
@@ -609,10 +605,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly eventListTreatment: "editorial-register";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "events-dense-index";
     readonly target: "events";
     readonly label: "Dense event index";
@@ -622,10 +617,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly eventListTreatment: "dense-index";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "schedule-details-brand-depth";
     readonly target: "events";
     readonly label: "Brand-depth schedule details";
@@ -635,10 +629,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly tileTreatment: "brand-depth";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "media-text-flush-feature";
     readonly target: "media-text";
     readonly label: "Flush media feature";
@@ -650,9 +643,8 @@ export declare const appearancePresets: readonly [{
             treatment: import("../../../blocks/src/index").FlushFrameTreatment;
             bleed: "start";
         }>;
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-simple-cards";
     readonly target: "testimonials";
     readonly label: "Simple testimonial cards";
@@ -662,9 +654,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "default";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-raised-panel";
     readonly target: "testimonials";
     readonly label: "Raised testimonial panel";
@@ -675,9 +667,9 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "raised";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-accent-panel";
     readonly target: "testimonials";
     readonly label: "Accent testimonial panel";
@@ -688,9 +680,9 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "raised";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-default-cards";
     readonly target: "testimonials";
     readonly label: "Default cards";
@@ -700,10 +692,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
-        readonly testimonialCardTreatment: "default";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-statement-cards";
     readonly target: "testimonials";
     readonly label: "Statement cards";
@@ -713,10 +704,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "raised";
-        readonly testimonialCardTreatment: "statement";
+        readonly cardRole: "alternative";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-brand-statement-cards";
     readonly target: "testimonials";
     readonly label: "Brand statement cards";
@@ -726,10 +716,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "raised";
-        readonly testimonialCardTreatment: "statement";
+        readonly cardRole: "alternative";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-non-carded";
     readonly target: "testimonials";
     readonly label: "Non-carded";
@@ -739,10 +728,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
-        readonly testimonialCardTreatment: "non-carded";
+        readonly composition: {
+            readonly kind: "testimonials";
+            readonly treatment: "open-editorial";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-evergreen-lead";
     readonly target: "testimonials";
     readonly label: "Evergreen lead";
@@ -755,9 +746,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly composition: {
+            readonly kind: "testimonials";
+            readonly treatment: "evergreen-lead";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-room-and-response";
     readonly target: "testimonials";
     readonly label: "Room and response";
@@ -770,9 +764,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly composition: {
+            readonly kind: "testimonials";
+            readonly treatment: "room-and-response";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-open-floor";
     readonly target: "testimonials";
     readonly label: "Open floor";
@@ -785,9 +782,12 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
+        readonly composition: {
+            readonly kind: "testimonials";
+            readonly treatment: "open-floor";
+        };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "faq-base-accordion";
     readonly target: "faq";
     readonly label: "Base accordion FAQ";
@@ -797,9 +797,9 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "default";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "faq-contained-help";
     readonly target: "faq";
     readonly label: "Contained help panel";
@@ -810,9 +810,9 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "inset";
         }>;
-        readonly itemSurface: "default";
+        readonly cardRole: "default";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "contact-form-panel";
     readonly target: "contact-form";
     readonly label: "Raised form panel";
@@ -823,9 +823,19 @@ export declare const appearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
+    readonly id: "booking-brand-band";
+    readonly target: "contact-form";
+    readonly label: "Brand band booking";
+    readonly blockKinds: readonly ["block.appointment-booking"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+    };
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "cta-accent-band";
     readonly target: "cta";
     readonly label: "Accent CTA band";
@@ -835,9 +845,8 @@ export declare const appearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly eyebrowTreatment: "accent";
     };
-}];
+}>];
 export type BlockAppearancePresetBlockKind = (typeof appearancePresets)[number]['blockKinds'][number];
 export declare function getAppearancePresetsForTarget(target: AppearancePresetTarget): readonly BlockAppearancePreset[];

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

@@ -1,10 +1,21 @@
 import type { BlockLayoutDesignProfile } from './blockFlow';
 import type { BlockAppearanceDesign, BlockAppearancePreset, BlockAppearancePresetConstraints } from './appearancePresetTypes';
+import type { CardRole } from '../cards';
 import type { BlockDesignPlan, NoExtraKeys } from './types';
 type ExactBlockAppearancePreset<TPreset extends BlockAppearancePreset> = TPreset & NoExtraKeys<TPreset, BlockAppearancePreset> & Readonly<{
     design: NoExtraKeys<TPreset['design'], BlockAppearanceDesign>;
 }>;
-export declare function defineBlockAppearancePreset<const TPreset extends BlockAppearancePreset>(preset: ExactBlockAppearancePreset<TPreset>): TPreset;
+export type WithResolvedCardRole<TPreset extends BlockAppearancePreset> = Omit<TPreset, 'design'> & Readonly<{
+    design: TPreset['design'] & Readonly<{
+        cardRole: CardRole;
+    }>;
+}>;
+/**
+ * Every Look carries a card role. A Look that says nothing about cards renders
+ * none, which is the overwhelming majority of them; the card-bearing ones name
+ * the role they want and the site style owns how it looks.
+ */
+export declare function defineBlockAppearancePreset<const TPreset extends BlockAppearancePreset>(preset: ExactBlockAppearancePreset<TPreset>): WithResolvedCardRole<TPreset>;
 export declare function layoutProfileSupportsConstraints(profile: BlockLayoutDesignProfile, constraints: BlockAppearancePresetConstraints): boolean;
 export declare function resolveBlockAppearancePresetDesign(preset: BlockAppearancePreset, layoutProfile?: BlockLayoutDesignProfile | null): BlockAppearanceDesign;
 export declare function blockDesignPlanFromAppearancePreset<TBlockId extends string, TPurpose extends string>(preset: BlockAppearancePreset, input: Readonly<{