@riverbankcms/sdk 0.129.1 → 0.130.2

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

@@ -1,4 +1,4 @@
-export declare const blockAppearancePresets: readonly [{
+export declare const blockAppearancePresets: readonly [import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-immersive-image";
     readonly target: "hero";
     readonly label: "Immersive image hero";
@@ -20,7 +20,6 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "hero";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -28,7 +27,7 @@ export declare const blockAppearancePresets: 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";
@@ -76,7 +75,6 @@ export declare const blockAppearancePresets: readonly [{
             kind: "panel";
             treatment: "raised";
         }>;
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "bottom-left";
         readonly heroTypographyScale: "display";
@@ -85,7 +83,7 @@ export declare const blockAppearancePresets: readonly [{
             readonly intensity: "balanced";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-poster-image";
     readonly target: "hero";
     readonly label: "Poster image hero";
@@ -107,7 +105,6 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "poster";
@@ -117,7 +114,7 @@ export declare const blockAppearancePresets: readonly [{
             readonly intensity: "strong";
         };
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "hero-brand-scrim";
     readonly target: "hero";
     readonly label: "Brand scrim image hero";
@@ -161,7 +158,6 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -170,7 +166,7 @@ export declare const blockAppearancePresets: 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";
@@ -214,7 +210,6 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly sectionHeight: "immersive";
         readonly heroComposition: "center";
         readonly heroTypographyScale: "display";
@@ -225,7 +220,7 @@ export declare const blockAppearancePresets: 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";
@@ -238,12 +233,11 @@ export declare const blockAppearancePresets: 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";
@@ -254,11 +248,10 @@ export declare const blockAppearancePresets: 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";
@@ -271,10 +264,9 @@ export declare const blockAppearancePresets: 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";
@@ -287,11 +279,10 @@ export declare const blockAppearancePresets: 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";
@@ -305,10 +296,9 @@ export declare const blockAppearancePresets: 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";
@@ -322,10 +312,9 @@ export declare const blockAppearancePresets: 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";
@@ -338,13 +327,12 @@ export declare const blockAppearancePresets: 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";
@@ -357,13 +345,12 @@ export declare const blockAppearancePresets: 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";
@@ -373,9 +360,9 @@ export declare const blockAppearancePresets: 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";
@@ -385,9 +372,9 @@ export declare const blockAppearancePresets: 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";
@@ -397,9 +384,9 @@ export declare const blockAppearancePresets: 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";
@@ -412,9 +399,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-open-editorial-columns";
     readonly target: "offerings";
     readonly label: "Open editorial columns";
@@ -427,9 +413,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "offerings-preview-joined-programme-panel";
     readonly target: "offerings";
     readonly label: "Joined programme panel";
@@ -442,9 +427,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "feature-cards-raised-rule";
     readonly target: "feature-cards";
     readonly label: "Raised cards with rule";
@@ -454,9 +438,9 @@ export declare const blockAppearancePresets: 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";
@@ -466,21 +450,21 @@ export declare const blockAppearancePresets: 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";
@@ -493,13 +477,12 @@ export declare const blockAppearancePresets: 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";
@@ -512,13 +495,13 @@ export declare const blockAppearancePresets: 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";
@@ -528,9 +511,9 @@ export declare const blockAppearancePresets: 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";
@@ -543,9 +526,9 @@ export declare const blockAppearancePresets: 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";
@@ -558,9 +541,9 @@ export declare const blockAppearancePresets: 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";
@@ -570,9 +553,9 @@ export declare const blockAppearancePresets: 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";
@@ -583,9 +566,8 @@ export declare const blockAppearancePresets: 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";
@@ -595,10 +577,9 @@ export declare const blockAppearancePresets: 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";
@@ -608,10 +589,9 @@ export declare const blockAppearancePresets: 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";
@@ -621,10 +601,9 @@ export declare const blockAppearancePresets: 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";
@@ -634,10 +613,9 @@ export declare const blockAppearancePresets: 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";
@@ -649,9 +627,8 @@ export declare const blockAppearancePresets: 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";
@@ -661,9 +638,9 @@ export declare const blockAppearancePresets: 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";
@@ -674,9 +651,9 @@ export declare const blockAppearancePresets: 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";
@@ -687,9 +664,9 @@ export declare const blockAppearancePresets: 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";
@@ -699,10 +676,9 @@ export declare const blockAppearancePresets: 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";
@@ -712,10 +688,9 @@ export declare const blockAppearancePresets: 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";
@@ -725,10 +700,9 @@ export declare const blockAppearancePresets: 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";
@@ -738,10 +712,12 @@ export declare const blockAppearancePresets: 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";
@@ -754,9 +730,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-room-and-response";
     readonly target: "testimonials";
     readonly label: "Room and response";
@@ -769,9 +744,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "testimonials-open-floor";
     readonly target: "testimonials";
     readonly label: "Open floor";
@@ -784,9 +758,8 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
     };
-}, {
+}>, import("../../../blocks/src/index").WithResolvedCardRole<{
     readonly id: "faq-base-accordion";
     readonly target: "faq";
     readonly label: "Base accordion FAQ";
@@ -796,9 +769,9 @@ export declare const blockAppearancePresets: 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";
@@ -809,9 +782,9 @@ export declare const blockAppearancePresets: 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";
@@ -822,9 +795,19 @@ export declare const blockAppearancePresets: 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";
@@ -834,7 +817,6 @@ export declare const blockAppearancePresets: readonly [{
         readonly contentFrame: {
             readonly kind: "plain";
         };
-        readonly itemSurface: "none";
         readonly eyebrowTreatment: "accent";
     };
-}];
+}>];

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

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { type CardRole } from '../cards';
+/**
+ * The legacy `itemSurface` treatment vocabulary, and how it reads as a card
+ * role.
+ *
+ * `itemSurface` named a *treatment* ("raised", "inset"); a role names *which
+ * card* a Look wants and defers the appearance to the site style. Phase 3
+ * deleted the treatment vocabulary and the recipe table it fed, so this map is
+ * no longer a migration coexistence device — it is the one parse boundary where
+ * persisted design plans written before the cutover still load, normalizing to
+ * the role they meant.
+ *
+ * Per-value rationale is recorded in
+ * `.project/plans/1297-card-role-contract-site-styles-own-card-surfaces/mapping-table.md`.
+ */
+export declare const legacyItemSurfaceCardRoles: {
+    readonly none: "none";
+    readonly flat: "default";
+    readonly default: "default";
+    readonly outlined: "default";
+    readonly raised: "default";
+    readonly inset: "alternative";
+    readonly editorial: "open";
+    readonly 'color-blocked': "alternative";
+};
+export type LegacyItemSurfaceValue = keyof typeof legacyItemSurfaceCardRoles;
+/**
+ * The enum form of the legacy vocabulary, for schemas that still parse it.
+ * Derived from the map so the two cannot drift.
+ */
+export declare const legacyItemSurfaceValues: [LegacyItemSurfaceValue, ...LegacyItemSurfaceValue[]];
+/**
+ * Read a card role from untrusted input, accepting the legacy `itemSurface`
+ * vocabulary as aliases. Returns `null` for anything else.
+ */
+export declare function cardRoleFromLegacyVocabulary(value: unknown): CardRole | null;
+/**
+ * The parse boundary for card roles reaching design intents and persisted
+ * design plans: roles pass through, legacy `itemSurface` values normalize to
+ * the role they meant, everything else fails the parse.
+ */
+export declare const cardRoleWithLegacyAliasSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
+    open: "open";
+    default: "default";
+    none: "none";
+    alternative: "alternative";
+}>>;