@riverbankcms/sdk 0.60.16 → 0.62.2

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, renderSiteTopChrome, type SiteChromeLayoutNodes, 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/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,515 @@
+import type { BlockAppearancePreset, BlockAppearancePresetTarget, SiteChromeAppearancePreset, SiteChromeAppearancePresetTarget } 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";
+    };
+}, {
+    readonly kind: "site-chrome";
+    readonly id: "header-clean-base";
+    readonly target: "site-header";
+    readonly label: "Clean base header";
+    readonly header: {
+        readonly surface: {
+            readonly kind: "neutral-solid";
+            readonly token: "surface";
+            readonly textColorToken: "text";
+        };
+        readonly navTreatment: "minimal";
+        readonly dropdownTreatment: "surface";
+        readonly ctaTreatment: "default";
+        readonly behavior: "default";
+    };
+}, {
+    readonly kind: "site-chrome";
+    readonly id: "site-header-brand-solid-inverted-cta";
+    readonly target: "site-header";
+    readonly label: "Brand solid header with inverted CTA";
+    readonly header: {
+        readonly surface: {
+            readonly kind: "brand-solid";
+            readonly token: "primary";
+            readonly textColorToken: "primaryForeground";
+        };
+        readonly navTreatment: "uppercase-underline";
+        readonly dropdownTreatment: "matched-solid";
+        readonly ctaTreatment: "inverted";
+        readonly behavior: "sticky-shrink";
+    };
+}, {
+    readonly kind: "site-chrome";
+    readonly id: "footer-muted-grounding";
+    readonly target: "site-footer";
+    readonly label: "Muted grounding footer";
+    readonly footer: {
+        readonly kind: "grounding";
+        readonly surface: "muted-band";
+        readonly emphasis: "low";
+    };
+}, {
+    readonly kind: "site-chrome";
+    readonly id: "site-footer-brand-two-band";
+    readonly target: "site-footer";
+    readonly label: "Two-band brand footer";
+    readonly footer: {
+        readonly kind: "brand-two-band";
+        readonly surface: {
+            readonly token: "primary";
+            readonly shade: "800";
+            readonly textColorToken: "primaryForeground";
+        };
+        readonly bottomBand: {
+            readonly token: "primary";
+            readonly shade: "900";
+            readonly textColorToken: "primaryForeground";
+        };
+        readonly emphasis: "high";
+    };
+}];
+export type BlockAppearancePresetBlockKind = Extract<(typeof appearancePresets)[number], {
+    kind: 'block-design';
+}>['blockKinds'][number];
+export declare function getAppearancePresetsForTarget(target: SiteChromeAppearancePresetTarget): readonly SiteChromeAppearancePreset[];
+export declare function getAppearancePresetsForTarget(target: BlockAppearancePresetTarget): 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>;