@riverbankcms/sdk 0.80.0 → 0.81.0

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

@@ -0,0 +1,508 @@
+import { type BoundaryOptionId, type NonEmptyReadonlyArray, type SiteStyleSectionTransitionIntent } from './types';
+export type BoundaryEdgeHeight = 'compact' | 'medium' | 'large' | 'expansive';
+export type FadeCurve = 'soft' | 'spacious' | 'expansive';
+export type WaveAmplitude = 'subtle' | 'balanced' | 'bold';
+export type WaveRhythm = 'single' | 'double';
+export type WaveSymmetry = 'symmetrical' | 'asymmetrical' | 'drift';
+export type BoundaryDirection = 'forward' | 'reverse';
+export type AngleSlope = 'subtle' | 'balanced' | 'steep';
+export type SectionBoundaryTreatment = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'soft-fade';
+    height: BoundaryEdgeHeight;
+    curve: FadeCurve;
+}> | Readonly<{
+    kind: 'wave-edge';
+    height: BoundaryEdgeHeight;
+    amplitude: WaveAmplitude;
+    rhythm: WaveRhythm;
+    symmetry: WaveSymmetry;
+}> | Readonly<{
+    kind: 'angle-edge';
+    height: BoundaryEdgeHeight;
+    slope: AngleSlope;
+    direction: BoundaryDirection;
+}> | Readonly<{
+    kind: 'legacy-unsupported';
+    boundaryOptionId: BoundaryOptionId;
+}>;
+export type BoundaryOption = Readonly<{
+    id: BoundaryOptionId;
+    label: string;
+    transitionAfter: SiteStyleSectionTransitionIntent;
+    treatment: SectionBoundaryTreatment;
+}>;
+export type SectionTransitionFamilyId = 'none' | 'gradient' | 'wave' | 'angle';
+export type GradientSectionTransitionVariantId = 'soft' | 'spacious' | 'expansive';
+export type WaveSectionTransitionVariantId = 'balanced' | 'classic' | 'gentle' | 'bold' | 'drift';
+export type AngleSectionTransitionVariantId = 'subtle' | 'balanced' | 'steep';
+export type SectionTransitionVariantId = 'none' | GradientSectionTransitionVariantId | WaveSectionTransitionVariantId | AngleSectionTransitionVariantId;
+export type SectionTransitionVariant = Readonly<{
+    familyId: SectionTransitionFamilyId;
+    variantId: SectionTransitionVariantId;
+    label: string;
+    boundaryOption: BoundaryOption;
+}>;
+export type SectionTransitionFamily = Readonly<{
+    id: SectionTransitionFamilyId;
+    label: string;
+    variants: NonEmptyReadonlyArray<SectionTransitionVariant>;
+}>;
+export declare const noneBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "None";
+    readonly transitionAfter: "none";
+    readonly treatment: {
+        readonly kind: "none";
+    };
+};
+export declare const softBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Soft";
+    readonly transitionAfter: "soft-fade-short";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "medium";
+        readonly curve: "soft";
+    };
+};
+export declare const spaciousBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Spacious";
+    readonly transitionAfter: "soft-fade-long";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "large";
+        readonly curve: "spacious";
+    };
+};
+export declare const expansiveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Expansive";
+    readonly transitionAfter: "soft-fade-expansive";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "expansive";
+        readonly curve: "expansive";
+    };
+};
+export declare const waveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Classic wave";
+    readonly transitionAfter: "wave-edge";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "asymmetrical";
+    };
+};
+export declare const balancedWaveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Balanced wave";
+    readonly transitionAfter: "wave-edge-balanced";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+};
+export declare const gentleWaveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Gentle wave";
+    readonly transitionAfter: "wave-edge-gentle";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "compact";
+        readonly amplitude: "subtle";
+        readonly rhythm: "single";
+        readonly symmetry: "symmetrical";
+    };
+};
+export declare const boldWaveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Bold wave";
+    readonly transitionAfter: "wave-edge-bold";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "large";
+        readonly amplitude: "bold";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+};
+export declare const driftWaveBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Drift wave";
+    readonly transitionAfter: "wave-edge-drift";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "drift";
+    };
+};
+export declare const subtleAngleBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Subtle angle";
+    readonly transitionAfter: "angle-edge-subtle";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "compact";
+        readonly slope: "subtle";
+        readonly direction: "forward";
+    };
+};
+export declare const balancedAngleBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Balanced angle";
+    readonly transitionAfter: "angle-edge";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "medium";
+        readonly slope: "balanced";
+        readonly direction: "forward";
+    };
+};
+export declare const steepAngleBoundaryOption: {
+    readonly id: BoundaryOptionId;
+    readonly label: "Steep angle";
+    readonly transitionAfter: "angle-edge-steep";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "large";
+        readonly slope: "steep";
+        readonly direction: "forward";
+    };
+};
+export declare const sectionTransitionFamilies: readonly [{
+    readonly id: "none";
+    readonly label: "None";
+    readonly variants: readonly [{
+        readonly familyId: "none";
+        readonly variantId: "none";
+        readonly label: "None";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "None";
+            readonly transitionAfter: "none";
+            readonly treatment: {
+                readonly kind: "none";
+            };
+        };
+    }];
+}, {
+    readonly id: "gradient";
+    readonly label: "Gradient";
+    readonly variants: readonly [{
+        readonly familyId: "gradient";
+        readonly variantId: "soft";
+        readonly label: "Soft";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Soft";
+            readonly transitionAfter: "soft-fade-short";
+            readonly treatment: {
+                readonly kind: "soft-fade";
+                readonly height: "medium";
+                readonly curve: "soft";
+            };
+        };
+    }, {
+        readonly familyId: "gradient";
+        readonly variantId: "spacious";
+        readonly label: "Spacious";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Spacious";
+            readonly transitionAfter: "soft-fade-long";
+            readonly treatment: {
+                readonly kind: "soft-fade";
+                readonly height: "large";
+                readonly curve: "spacious";
+            };
+        };
+    }, {
+        readonly familyId: "gradient";
+        readonly variantId: "expansive";
+        readonly label: "Expansive";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Expansive";
+            readonly transitionAfter: "soft-fade-expansive";
+            readonly treatment: {
+                readonly kind: "soft-fade";
+                readonly height: "expansive";
+                readonly curve: "expansive";
+            };
+        };
+    }];
+}, {
+    readonly id: "wave";
+    readonly label: "Wave";
+    readonly variants: readonly [{
+        readonly familyId: "wave";
+        readonly variantId: "balanced";
+        readonly label: "Balanced";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Balanced wave";
+            readonly transitionAfter: "wave-edge-balanced";
+            readonly treatment: {
+                readonly kind: "wave-edge";
+                readonly height: "medium";
+                readonly amplitude: "balanced";
+                readonly rhythm: "double";
+                readonly symmetry: "symmetrical";
+            };
+        };
+    }, {
+        readonly familyId: "wave";
+        readonly variantId: "classic";
+        readonly label: "Classic";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Classic wave";
+            readonly transitionAfter: "wave-edge";
+            readonly treatment: {
+                readonly kind: "wave-edge";
+                readonly height: "medium";
+                readonly amplitude: "balanced";
+                readonly rhythm: "double";
+                readonly symmetry: "asymmetrical";
+            };
+        };
+    }, {
+        readonly familyId: "wave";
+        readonly variantId: "gentle";
+        readonly label: "Gentle";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Gentle wave";
+            readonly transitionAfter: "wave-edge-gentle";
+            readonly treatment: {
+                readonly kind: "wave-edge";
+                readonly height: "compact";
+                readonly amplitude: "subtle";
+                readonly rhythm: "single";
+                readonly symmetry: "symmetrical";
+            };
+        };
+    }, {
+        readonly familyId: "wave";
+        readonly variantId: "bold";
+        readonly label: "Bold";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Bold wave";
+            readonly transitionAfter: "wave-edge-bold";
+            readonly treatment: {
+                readonly kind: "wave-edge";
+                readonly height: "large";
+                readonly amplitude: "bold";
+                readonly rhythm: "double";
+                readonly symmetry: "symmetrical";
+            };
+        };
+    }, {
+        readonly familyId: "wave";
+        readonly variantId: "drift";
+        readonly label: "Drift";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Drift wave";
+            readonly transitionAfter: "wave-edge-drift";
+            readonly treatment: {
+                readonly kind: "wave-edge";
+                readonly height: "medium";
+                readonly amplitude: "balanced";
+                readonly rhythm: "double";
+                readonly symmetry: "drift";
+            };
+        };
+    }];
+}, {
+    readonly id: "angle";
+    readonly label: "Angle";
+    readonly variants: readonly [{
+        readonly familyId: "angle";
+        readonly variantId: "subtle";
+        readonly label: "Subtle";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Subtle angle";
+            readonly transitionAfter: "angle-edge-subtle";
+            readonly treatment: {
+                readonly kind: "angle-edge";
+                readonly height: "compact";
+                readonly slope: "subtle";
+                readonly direction: "forward";
+            };
+        };
+    }, {
+        readonly familyId: "angle";
+        readonly variantId: "balanced";
+        readonly label: "Balanced";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Balanced angle";
+            readonly transitionAfter: "angle-edge";
+            readonly treatment: {
+                readonly kind: "angle-edge";
+                readonly height: "medium";
+                readonly slope: "balanced";
+                readonly direction: "forward";
+            };
+        };
+    }, {
+        readonly familyId: "angle";
+        readonly variantId: "steep";
+        readonly label: "Steep";
+        readonly boundaryOption: {
+            readonly id: BoundaryOptionId;
+            readonly label: "Steep angle";
+            readonly transitionAfter: "angle-edge-steep";
+            readonly treatment: {
+                readonly kind: "angle-edge";
+                readonly height: "large";
+                readonly slope: "steep";
+                readonly direction: "forward";
+            };
+        };
+    }];
+}];
+/**
+ * Must remain non-empty; downstream code indexes `[0]` as the documented default.
+ */
+export declare const boundaryOptions: readonly [{
+    readonly id: BoundaryOptionId;
+    readonly label: "None";
+    readonly transitionAfter: "none";
+    readonly treatment: {
+        readonly kind: "none";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Soft";
+    readonly transitionAfter: "soft-fade-short";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "medium";
+        readonly curve: "soft";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Spacious";
+    readonly transitionAfter: "soft-fade-long";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "large";
+        readonly curve: "spacious";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Expansive";
+    readonly transitionAfter: "soft-fade-expansive";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "expansive";
+        readonly curve: "expansive";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Balanced wave";
+    readonly transitionAfter: "wave-edge-balanced";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Classic wave";
+    readonly transitionAfter: "wave-edge";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "asymmetrical";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Gentle wave";
+    readonly transitionAfter: "wave-edge-gentle";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "compact";
+        readonly amplitude: "subtle";
+        readonly rhythm: "single";
+        readonly symmetry: "symmetrical";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Bold wave";
+    readonly transitionAfter: "wave-edge-bold";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "large";
+        readonly amplitude: "bold";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Drift wave";
+    readonly transitionAfter: "wave-edge-drift";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "drift";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Subtle angle";
+    readonly transitionAfter: "angle-edge-subtle";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "compact";
+        readonly slope: "subtle";
+        readonly direction: "forward";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Balanced angle";
+    readonly transitionAfter: "angle-edge";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "medium";
+        readonly slope: "balanced";
+        readonly direction: "forward";
+    };
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Steep angle";
+    readonly transitionAfter: "angle-edge-steep";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "large";
+        readonly slope: "steep";
+        readonly direction: "forward";
+    };
+}];
+export declare function sectionTransitionVariantForBoundaryOptionId(boundaryOptionId: BoundaryOptionId | null): SectionTransitionVariant | null;
+export declare function boundaryTreatmentForBoundaryOptionId(boundaryOptionId: BoundaryOptionId): SectionBoundaryTreatment;
+export declare function boundaryOptionForTreatment(treatment: SectionBoundaryTreatment): BoundaryOption | null;
+export declare function boundaryOptionIdForTreatment(treatment: SectionBoundaryTreatment): BoundaryOptionId | null;
+export declare function sectionBoundaryTreatmentsEqual(left: SectionBoundaryTreatment, right: SectionBoundaryTreatment): boolean;
+export declare function sectionTransitionFamilyForBoundaryOptionId(boundaryOptionId: BoundaryOptionId | null): SectionTransitionFamily | null;
+export declare function defaultSectionTransitionVariantForFamily(familyId: SectionTransitionFamilyId): SectionTransitionVariant;

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

@@ -35,7 +35,7 @@ export declare const generatedDesignOptionCatalog: {
         treatment: import("../../../blocks/src/index").FlushFrameTreatment;
         bleed: "start";
     }>];
-    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
+    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
     readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long"];
     readonly emphases: readonly ["low", "medium", "high"];
     readonly detachedCustom: false;
@@ -67,8 +67,8 @@ export declare const userDesignOptionCatalog: {
         treatment: import("../../../blocks/src/index").FlushFrameTreatment;
         bleed: "both";
     }>];
-    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
-    readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "wave-edge", "angle-edge"];
+    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
+    readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "soft-fade-expansive", "wave-edge", "wave-edge-balanced", "wave-edge-gentle", "wave-edge-bold", "wave-edge-drift", "angle-edge", "angle-edge-subtle", "angle-edge-steep"];
     readonly emphases: readonly ["low", "medium", "high"];
     readonly detachedCustom: false;
 };
@@ -99,8 +99,8 @@ export declare const advancedDesignOptionCatalog: {
         treatment: import("../../../blocks/src/index").FlushFrameTreatment;
         bleed: "both";
     }>];
-    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
-    readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "wave-edge", "angle-edge"];
+    readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
+    readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "soft-fade-expansive", "wave-edge", "wave-edge-balanced", "wave-edge-gentle", "wave-edge-bold", "wave-edge-drift", "angle-edge", "angle-edge-subtle", "angle-edge-steep"];
     readonly emphases: readonly ["low", "medium", "high"];
     readonly detachedCustom: true;
 };
@@ -121,7 +121,7 @@ export declare const designOptionCatalogs: {
             treatment: import("../../../blocks/src/index").FlushFrameTreatment;
             bleed: "start";
         }>];
-        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
+        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
         readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long"];
         readonly emphases: readonly ["low", "medium", "high"];
         readonly detachedCustom: false;
@@ -153,8 +153,8 @@ export declare const designOptionCatalogs: {
             treatment: import("../../../blocks/src/index").FlushFrameTreatment;
             bleed: "both";
         }>];
-        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
-        readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "wave-edge", "angle-edge"];
+        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
+        readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "soft-fade-expansive", "wave-edge", "wave-edge-balanced", "wave-edge-gentle", "wave-edge-bold", "wave-edge-drift", "angle-edge", "angle-edge-subtle", "angle-edge-steep"];
         readonly emphases: readonly ["low", "medium", "high"];
         readonly detachedCustom: false;
     };
@@ -185,8 +185,8 @@ export declare const designOptionCatalogs: {
             treatment: import("../../../blocks/src/index").FlushFrameTreatment;
             bleed: "both";
         }>];
-        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial"];
-        readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "wave-edge", "angle-edge"];
+        readonly itemSurfaces: readonly ["none", "default", "flat", "outlined", "raised", "inset", "editorial", "color-blocked"];
+        readonly transitions: readonly ["none", "soft-fade-short", "soft-fade-long", "soft-fade-expansive", "wave-edge", "wave-edge-balanced", "wave-edge-gentle", "wave-edge-bold", "wave-edge-drift", "angle-edge", "angle-edge-subtle", "angle-edge-steep"];
         readonly emphases: readonly ["low", "medium", "high"];
         readonly detachedCustom: true;
     };

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

@@ -2,6 +2,17 @@ import type { Theme } from '../schema';
 export type Brand<T, TBrand extends string> = T & {
     readonly __brand: TBrand;
 };
+export type NoExtraKeys<TActual, TExpected> = TActual & {
+    readonly [K in Exclude<keyof TActual, keyof TExpected>]: never;
+};
+export type ExactCatalog<TEntries extends readonly unknown[], TExpected> = {
+    readonly [K in keyof TEntries]: TEntries[K] extends TExpected ? NoExtraKeys<TEntries[K], TExpected> : never;
+};
+/**
+ * Defines a literal-preserving catalog while rejecting top-level extra keys on
+ * each entry: `defineExactCatalog<Entry>()([{ ... }])`.
+ */
+export declare function defineExactCatalog<TExpected>(): <const TEntries extends readonly TExpected[]>(entries: ExactCatalog<TEntries, TExpected>) => TEntries;
 export type DesignBlockId = Brand<string, 'DesignBlockId'>;
 export type DesignPageId = Brand<string, 'DesignPageId'>;
 export type DesignEntryId = Brand<string, 'DesignEntryId'>;
@@ -88,8 +99,8 @@ export type DesignResolutionPolicy = 'generated' | 'user' | 'admin' | 'sdk';
 export type DesignIssueSeverity = 'blocking' | 'repairable' | 'advisory';
 export declare function designIssueSeverityForPolicy(policy: DesignResolutionPolicy): DesignIssueSeverity;
 export type SiteStyleSurfaceIntent = 'base' | 'muted-band' | 'accent-band' | 'brand-depth-band' | 'hero-image';
-export type SiteStyleItemSurfaceIntent = 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial';
-export type SiteStyleSectionTransitionIntent = 'none' | 'soft-fade-short' | 'soft-fade-long' | 'wave-edge' | 'angle-edge';
+export type SiteStyleItemSurfaceIntent = 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial' | 'color-blocked';
+export type SiteStyleSectionTransitionIntent = 'none' | 'soft-fade-short' | 'soft-fade-long' | 'soft-fade-expansive' | 'wave-edge' | 'wave-edge-balanced' | 'wave-edge-gentle' | 'wave-edge-bold' | 'wave-edge-drift' | 'angle-edge' | 'angle-edge-subtle' | 'angle-edge-steep';
 export type SiteStyleEmphasis = 'low' | 'medium' | 'high';
 export type SectionHeightIntent = 'default' | 'banner' | 'hero' | 'immersive';
 export type FrameKind = 'plain' | 'panel' | 'flush-panel';
@@ -248,7 +259,7 @@ export type GeneratedFlushPanelFrameIntent = Readonly<{
 export type GeneratedContentFrameIntent = PlainFrameIntent | GeneratedPanelFrameIntent | GeneratedFlushPanelFrameIntent;
 export type UserContentFrameIntent = ContentFrameIntent;
 export type AdvancedContentFrameIntent = ContentFrameIntent | AdvancedDetachedDesignValue;
-export type GeneratedItemSurfaceIntent = Extract<SiteStyleItemSurfaceIntent, 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial'>;
+export type GeneratedItemSurfaceIntent = Extract<SiteStyleItemSurfaceIntent, 'none' | 'default' | 'flat' | 'outlined' | 'raised' | 'inset' | 'editorial' | 'color-blocked'>;
 export type UserItemSurfaceIntent = SiteStyleItemSurfaceIntent;
 export type AdvancedItemSurfaceIntent = SiteStyleItemSurfaceIntent | AdvancedDetachedDesignValue;
 export type GeneratedSectionTransitionIntent = Extract<SiteStyleSectionTransitionIntent, 'none' | 'soft-fade-short' | 'soft-fade-long'>;
@@ -369,6 +380,7 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
     blockId: TBlockId;
     blockKind: string;
     purpose: TPurpose;
+    appearancePresetId?: AppearancePresetId;
     sectionSurface: SiteStyleSurfaceIntent;
     contentFrame: ContentFrameIntent;
     itemSurface: SiteStyleItemSurfaceIntent;
@@ -410,6 +422,12 @@ export type ResolvedPageDesignPlan<TBlockId extends string = DesignBlockId, TPur
     blocks: readonly ResolvedBlockDesignPlan<TBlockId, TPurpose>[];
     issues: readonly DesignResolutionIssue<TBlockId, TPurpose>[];
 }>;
+export type HeadingDecorationCapability = Readonly<{
+    kind: 'unsupported';
+}> | Readonly<{
+    kind: 'supported';
+    families: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+}>;
 export type DesignedBlockDesignCapabilityInput = Readonly<{
     sectionSurfaces: 'supported' | 'unsupported';
     contentFrames: FrameCapability;
@@ -422,7 +440,7 @@ export type DesignedBlockDesignCapabilityInput = Readonly<{
     eventListTreatments?: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments?: NonEmptyReadonlyArray<EyebrowTreatment>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
-    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+    headingDecorationCapability?: HeadingDecorationCapability;
 }>;
 export type DesignedBlockDesignCapability = Readonly<{
     kind: 'designed';
@@ -437,7 +455,7 @@ export type DesignedBlockDesignCapability = Readonly<{
     eventListTreatments: NonEmptyReadonlyArray<EventListTreatment>;
     eyebrowTreatments: NonEmptyReadonlyArray<EyebrowTreatment>;
     accordionIconSets?: NonEmptyReadonlyArray<AccordionIconSet>;
-    headingDecorations?: NonEmptyReadonlyArray<VisibleHeadingDecorationFamily>;
+    headingDecorationCapability: HeadingDecorationCapability;
 }>;
 export type UnsupportedBlockDesignCapabilityReason = 'site-chrome' | 'transactional' | 'placeholder' | 'legacy-layout' | 'custom-runtime';
 export type NoBlockDesignCapability = Readonly<{
@@ -446,7 +464,7 @@ export type NoBlockDesignCapability = Readonly<{
 }>;
 export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesignCapability;
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
-export declare function defineBlockDesignCapability(capability: DesignedBlockDesignCapabilityInput): DesignedBlockDesignCapability;
+export declare function defineBlockDesignCapability<const TCapability extends DesignedBlockDesignCapabilityInput>(capability: NoExtraKeys<TCapability, DesignedBlockDesignCapabilityInput>): DesignedBlockDesignCapability;
 export declare function defineNoBlockDesignCapability(reason: UnsupportedBlockDesignCapabilityReason): NoBlockDesignCapability;
 export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-item-surface' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-testimonial-card-treatment' | 'fallback-tile-treatment' | 'fallback-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-accordion-icon-treatment' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
 export type UnsupportedSectionSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{