@riverbankcms/sdk 0.60.16 → 0.62.4

package/dist/_dts/theme-core/src/index.d.ts

@@ -12,6 +12,7 @@ export * from "./responsive/breakpoints";
 export { ThemeFontLoader, ThemeFontLoaderFromTheme, getThemeFontLoadingOptions, type ThemeFontLoadingOptions, type ThemeFontLoaderFromThemeProps, } from "./ThemeFontLoader";
 export { ThemeScopeCore, type ThemeScopeCoreProps } from "./ThemeScopeCore";
 export { type ThemeDataAttrs } from "./themeScopeUtils";
+export { getStandaloneHeaderShellClassName, planSiteTopShell, renderSiteTopChrome, type SiteChromeLayoutNodes, type SiteTopShellPlan, type SiteTopShellBehavior, } from "./siteChrome";
 export { buildThemeRuntime } from "./runtime/buildThemeRuntime";
 export { buildThemeRuntimeFromBridge, type ThemeBridgeConfigMinimal, } from "./runtime/buildThemeRuntimeFromBridge";
 export type { CornerStyle, ShadowSize, TextTransform, FontWeight, HoverTransform, HoverColor, GradientStyle, GradientSharpness, GradientDirection, ButtonVariant, ButtonSystem, } from "./buttons/types";

package/dist/_dts/theme-core/src/mock-themes/all.d.ts

@@ -797,6 +797,7 @@ export declare const mockThemes: {
                         } | null | undefined;
                         spacing?: "none" | "compact" | "medium" | "spacious" | "comfortable" | "cozy" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
+                        tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                     } | null | undefined;
                     containerStyles?: {
@@ -1767,6 +1768,7 @@ export declare const mockThemes: {
                         } | null | undefined;
                         spacing?: "none" | "compact" | "medium" | "spacious" | "comfortable" | "cozy" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
+                        tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                     } | null | undefined;
                     containerStyles?: {
@@ -2737,6 +2739,7 @@ export declare const mockThemes: {
                         } | null | undefined;
                         spacing?: "none" | "compact" | "medium" | "spacious" | "comfortable" | "cozy" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
+                        tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                     } | null | undefined;
                     containerStyles?: {

package/dist/_dts/theme-core/src/palette/variants/types.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { type StyleTags } from '../../site-styles/styleTags';
+import { PALETTE_TOKEN_NAMES, paletteTokenNameSchema, type PaletteTokenName } from '../../tokens/themeColorTokens';
+export { PALETTE_TOKEN_NAMES, paletteTokenNameSchema, type PaletteTokenName, };
 /**
  * Branded ID for a palette variant in the curated library. Shape matches the
  * `Brand<T, TBrand>` convention in `site-styles/types.ts`. Use the helper at
@@ -10,27 +12,6 @@ export type PaletteVariantId<T extends string = string> = T & {
 };
 export declare function asPaletteVariantId<const T extends string>(value: T): PaletteVariantId<T>;
 export declare const paletteVariantIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId<string>, string>>;
-/**
- * Known palette role token names. Closed union so unknown tokens can't be
- * persisted via `paletteOverrides`. Add a new role here intentionally.
- */
-export declare const PALETTE_TOKEN_NAMES: readonly ["primary", "primaryForeground", "secondary", "accent", "success", "warning", "destructive", "background", "surface", "surfaceAlt", "muted", "text", "border"];
-export type PaletteTokenName = (typeof PALETTE_TOKEN_NAMES)[number];
-export declare const paletteTokenNameSchema: z.ZodEnum<{
-    success: "success";
-    text: "text";
-    surface: "surface";
-    warning: "warning";
-    border: "border";
-    background: "background";
-    primary: "primary";
-    secondary: "secondary";
-    primaryForeground: "primaryForeground";
-    accent: "accent";
-    destructive: "destructive";
-    surfaceAlt: "surfaceAlt";
-    muted: "muted";
-}>;
 export type HexColor = string & {
     readonly __brand: 'HexColor';
 };

package/dist/_dts/theme-core/src/schema.d.ts

@@ -176,6 +176,11 @@ export declare const sectionStylesOverrideSchema: z.ZodObject<{
         banner: "banner";
         immersive: "immersive";
     }>>>;
+    tileTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        default: "default";
+        quiet: "quiet";
+        "brand-depth": "brand-depth";
+    }>>>;
     eyebrowTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         pill: "pill";
         plain: "plain";
@@ -479,6 +484,11 @@ declare const blockStyleOverridesSchema: z.ZodObject<{
             banner: "banner";
             immersive: "immersive";
         }>>>;
+        tileTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            default: "default";
+            quiet: "quiet";
+            "brand-depth": "brand-depth";
+        }>>>;
         eyebrowTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             pill: "pill";
             plain: "plain";
@@ -811,6 +821,11 @@ declare const blockThemeOverrideSchema: z.ZodObject<{
                 banner: "banner";
                 immersive: "immersive";
             }>>>;
+            tileTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                default: "default";
+                quiet: "quiet";
+                "brand-depth": "brand-depth";
+            }>>>;
             eyebrowTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 pill: "pill";
                 plain: "plain";
@@ -4323,6 +4338,11 @@ export declare const themeSchema: z.ZodObject<{
                     banner: "banner";
                     immersive: "immersive";
                 }>>>;
+                tileTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                    default: "default";
+                    quiet: "quiet";
+                    "brand-depth": "brand-depth";
+                }>>>;
                 eyebrowTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     pill: "pill";
                     plain: "plain";
@@ -6400,6 +6420,11 @@ export declare const themesTurnSchema: z.ZodObject<{
                         banner: "banner";
                         immersive: "immersive";
                     }>>>;
+                    tileTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                        default: "default";
+                        quiet: "quiet";
+                        "brand-depth": "brand-depth";
+                    }>>>;
                     eyebrowTreatment: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                         pill: "pill";
                         plain: "plain";

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

@@ -0,0 +1,451 @@
+import type { AppearancePresetTarget, BlockAppearancePreset } from './appearancePresetTypes';
+export declare const appearancePresets: readonly [{
+    readonly kind: "block-design";
+    readonly id: "hero-immersive-image";
+    readonly target: "hero";
+    readonly label: "Immersive image hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "hero";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "neutral-wash";
+        };
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-scrim";
+    readonly target: "hero";
+    readonly label: "Brand scrim image hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly optionGroups: readonly [{
+        readonly id: "image-surface-treatment";
+        readonly label: "Treatment";
+        readonly selectedOptionId: "brand-scrim-primary";
+        readonly options: readonly [{
+            readonly id: "brand-scrim-primary";
+            readonly label: "Brand scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "brand-scrim";
+                    readonly token: "primary";
+                };
+            };
+        }, {
+            readonly id: "neutral-scrim";
+            readonly label: "Neutral scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "neutral-scrim";
+                };
+            };
+        }];
+    }];
+    readonly layoutPatches: readonly [{
+        readonly constraints: {
+            readonly layoutVariantKeys: readonly ["micro"];
+        };
+        readonly designPatch: {
+            readonly sectionHeight: "banner";
+        };
+    }];
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "immersive";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "brand-scrim";
+            readonly token: "primary";
+        };
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-scrim-fixed-frame";
+    readonly target: "hero";
+    readonly label: "Fixed-frame brand scrim hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly optionGroups: readonly [{
+        readonly id: "image-surface-treatment";
+        readonly label: "Treatment";
+        readonly selectedOptionId: "brand-scrim-primary";
+        readonly options: readonly [{
+            readonly id: "brand-scrim-primary";
+            readonly label: "Brand scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "brand-scrim";
+                    readonly token: "primary";
+                };
+            };
+        }, {
+            readonly id: "neutral-scrim";
+            readonly label: "Neutral scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "neutral-scrim";
+                };
+            };
+        }];
+    }];
+    readonly layoutPatches: readonly [{
+        readonly constraints: {
+            readonly layoutVariantKeys: readonly ["micro"];
+        };
+        readonly designPatch: {
+            readonly sectionHeight: "banner";
+        };
+    }];
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "immersive";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "brand-scrim";
+            readonly token: "primary";
+        };
+        readonly imageSurfaceMotion: "fixed-frame";
+        readonly eyebrowTreatment: "accent-pill-bounce";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-depth-expressive";
+    readonly target: "hero";
+    readonly label: "Expressive brand-depth hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly eyebrowTreatment: "accent-pill-bounce";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-contained-intro";
+    readonly target: "hero";
+    readonly label: "Contained intro hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "inset";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "body-text-editorial-intro";
+    readonly target: "body-text";
+    readonly label: "Editorial intro copy";
+    readonly blockKinds: readonly ["block.body-text"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "body-text-brand-depth-intro";
+    readonly target: "body-text";
+    readonly label: "Brand-depth intro copy";
+    readonly blockKinds: readonly ["block.body-text"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "offerings-calm-list";
+    readonly target: "offerings";
+    readonly label: "Calm offerings list";
+    readonly blockKinds: readonly ["block.event-listing", "block.event-calendar", "block.event-spotlight", "block.product-list"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "events-base-calendar";
+    readonly target: "events";
+    readonly label: "Base event calendar";
+    readonly blockKinds: readonly ["block.event-calendar", "block.event-listing"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "schedule-details-accent-section";
+    readonly target: "events";
+    readonly label: "Accent schedule details";
+    readonly blockKinds: readonly ["block.event-details", "block.course-details"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "schedule-details-brand-depth";
+    readonly target: "events";
+    readonly label: "Brand-depth schedule details";
+    readonly blockKinds: readonly ["block.event-details", "block.course-details"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+        readonly tileTreatment: "brand-depth";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "media-text-flush-feature";
+    readonly target: "media-text";
+    readonly label: "Flush media feature";
+    readonly blockKinds: readonly ["block.media-text"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "flush-panel";
+            treatment: import("@riverbankcms/blocks").FlushFrameTreatment;
+            bleed: "start";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "media-text-quiet-story";
+    readonly target: "media-text";
+    readonly label: "Quiet media story";
+    readonly blockKinds: readonly ["block.media-text"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-carded-proof";
+    readonly target: "testimonials";
+    readonly label: "Carded social proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-contained-proof";
+    readonly target: "testimonials";
+    readonly label: "Contained social proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-dark-proof";
+    readonly target: "testimonials";
+    readonly label: "Dark proof panel";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-accent-quote-proof";
+    readonly target: "testimonials";
+    readonly label: "Accent quote proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly testimonialCardTreatment: "accent-quote";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "faq-base-accordion";
+    readonly target: "faq";
+    readonly label: "Base accordion FAQ";
+    readonly blockKinds: readonly ["block.faq"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "faq-contained-help";
+    readonly target: "faq";
+    readonly label: "Contained help panel";
+    readonly blockKinds: readonly ["block.faq"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "inset";
+        }>;
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "low";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-panel";
+    readonly target: "contact-form";
+    readonly label: "Contact form panel";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-dark-card";
+    readonly target: "contact-form";
+    readonly label: "Dark form card";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-brand-depth-card";
+    readonly target: "contact-form";
+    readonly label: "Brand-depth form card";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "cta-accent-band";
+    readonly target: "cta";
+    readonly label: "Accent CTA band";
+    readonly blockKinds: readonly ["block.cta-full"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}];
+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

@@ -0,0 +1,12 @@
+import type { BlockLayoutDesignProfile } from './blockFlow';
+import type { BlockAppearanceDesign, BlockAppearancePreset, BlockAppearancePresetConstraints } from './appearancePresetTypes';
+import type { BlockDesignPlan } from './types';
+export declare function defineBlockAppearancePreset<const TPreset extends BlockAppearancePreset>(preset: TPreset): 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<{
+    blockId: TBlockId;
+    blockKind: string;
+    purpose: TPurpose;
+    layoutProfile?: BlockLayoutDesignProfile | null;
+}>): BlockDesignPlan<TBlockId, TPurpose>;

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

@@ -0,0 +1,61 @@
+import type { BlockLayoutFamily } from './blockFlow';
+import type { ContentFrameIntent, EyebrowTreatment, HeroLegibilityStrategy, ImageSurfaceMotion, ImageSurfaceTreatment, NonEmptyReadonlyArray, SectionHeightIntent, SiteStyleEmphasis, SiteStyleItemSurfaceIntent, SiteStyleSectionTransitionIntent, SiteStyleSurfaceIntent, TestimonialCardTreatment, TileTreatment } from './types';
+export type AppearancePresetTarget = 'hero' | 'body-text' | 'offerings' | 'events' | 'media-text' | 'testimonials' | 'faq' | 'contact-form' | 'cta';
+export type BlockAppearanceDesign = Readonly<{
+    sectionSurface: SiteStyleSurfaceIntent;
+    contentFrame: ContentFrameIntent;
+    itemSurface: SiteStyleItemSurfaceIntent;
+    transitionAfter: SiteStyleSectionTransitionIntent;
+    emphasis: SiteStyleEmphasis;
+    sectionHeight?: SectionHeightIntent;
+    heroLegibility?: HeroLegibilityStrategy;
+    imageSurfaceTreatment?: ImageSurfaceTreatment;
+    imageSurfaceMotion?: ImageSurfaceMotion;
+    testimonialCardTreatment?: TestimonialCardTreatment;
+    tileTreatment?: TileTreatment;
+    eyebrowTreatment?: EyebrowTreatment;
+}>;
+export type BlockAppearancePresetConstraints = Readonly<{
+    layoutFamilies?: readonly BlockLayoutFamily[];
+    layoutVariantKeys?: readonly string[];
+}>;
+export type BlockAppearanceOptionDesignPatch = Readonly<Partial<Pick<BlockAppearanceDesign, 'heroLegibility' | 'imageSurfaceTreatment' | 'imageSurfaceMotion' | 'sectionHeight' | 'testimonialCardTreatment' | 'tileTreatment' | 'eyebrowTreatment'>>>;
+export type BlockAppearanceLayoutDesignPatch = BlockAppearanceOptionDesignPatch;
+export type BlockAppearanceOption = Readonly<{
+    id: string;
+    label: string;
+    designPatch: BlockAppearanceOptionDesignPatch;
+}>;
+export type BlockAppearanceOptionGroup = Readonly<{
+    id: string;
+    label: string;
+    options: NonEmptyReadonlyArray<BlockAppearanceOption>;
+    selectedOptionId: string;
+}>;
+export type BlockAppearanceLayoutPatch = Readonly<{
+    constraints: BlockAppearancePresetConstraints;
+    designPatch: BlockAppearanceLayoutDesignPatch;
+}>;
+export type BlockAppearancePreset = Readonly<{
+    kind: 'block-design';
+    id: string;
+    target: AppearancePresetTarget;
+    label: string;
+    blockKinds: readonly string[];
+    constraints?: BlockAppearancePresetConstraints;
+    /**
+     * Author-time curated defaults. Page design intent pins only the preset today;
+     * option-level user pinning needs a separate persistence model before these
+     * become editable controls.
+     */
+    optionGroups?: readonly BlockAppearanceOptionGroup[];
+    /**
+     * Layout-aware defaults keep a Look's visual recipe stable while preventing
+     * contradictions such as compact/micro layouts inheriting immersive height.
+     */
+    layoutPatches?: readonly BlockAppearanceLayoutPatch[];
+    design: BlockAppearanceDesign;
+}>;
+export type AppearancePreset = BlockAppearancePreset;
+export type BlockAppearancePresetTarget = BlockAppearancePreset['target'];
+export declare const appearancePresetTargets: readonly ["hero", "body-text", "offerings", "events", "media-text", "testimonials", "faq", "contact-form", "cta"];