@riverbankcms/sdk 0.126.0 → 0.128.0

package/dist/_dts/sdk/src/rendering/index.d.ts

@@ -16,14 +16,16 @@ export type { LoadPageParams, LoadPageResult } from './helpers/loadPage';
 export { loadContent, isPageContent, isEntryContent, isPageSurfaceContent, } from './helpers/loadContent';
 export type { LoadContentParams, LoadContentResult, ContentEntryData, PagePreviewMetadata, SiteData, } from './helpers/loadContent';
 export type { BlockLoaderMap, DataLoaderContext, DataLoaderFn, DataLoaderOverrides, DataLoaderPreviewStage, DataLoaderRenderTarget, DataLoaderSearchParams, DataLoaderValue, } from '../data/types';
-export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, RichTextDoc, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
+export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, ButtonVariant, CalendarTabViews, CardStylesContent, CollectionContent, ColumnsContent, ColumnOption, ContainerStylesContent, CtaFullContent, DisplayMode, EmbedContent, EventCalendarContent, EventDetailsContent, EventLayout, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FaqItem, FilterAutoShow, FormBlockContent, GiftingContent, HeroContent, HeroCta, HeroCtaInput, HeroMedia, ImageColSize, ImageGalleryContent, LayoutAlign, LayoutWidth, Media, MediaTextAlignment, MediaTextAspectRatio, MediaTextContent, MediaTextImagePosition, NewsletterSignupContent, NewsletterSignupPreset, RichTextDoc, TipTapNode, TipTapMark, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, PageLinkValue, EntryLinkValue, RichTextPrimitiveProps, RichTextVariant, PageOutline, BlockOutline, RouteMap, RouteMapEntry, OccurrenceContextData, EntrySubrouteContextData, Theme, ThemeTokens, SectionStylesContent, SemanticSpacing, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, StackContentAlignment, StackImagePosition, SystemBlockContentByFullKind, SystemBlockContentByKind, SystemBlockContentFor, SystemBlockShortKind, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, ThumbnailPadding, ThumbnailShape, VideoGridContent, WeekStart, MediaAssetIndexItem, ImageOptions, ResolveImageUrlContext, ResolveImageUrlContextInput, ResolveImageSourceSetOptions, ResolvedImageSourceSet, } from '../contracts';
 export { ImagePresets } from '../contracts';
 export { RichText } from './primitives/RichText';
 export { resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, } from './image';
-export { PageRenderer } from './blocks-page-renderer';
+export { PageRenderer, toBlocksPageRendererDataContext, } from './blocks-page-renderer';
 export { ThemeScope } from './blocks-theme-scope';
 export { buildThemeRuntime } from './blocks-theme-runtime';
-export type { ComponentRegistry, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
+export { toBlocksImageResolveContextInput, toBlocksMediaAssets, } from './mediaAssets';
+export type { BlocksImageResolveContextInput, BlocksMediaAssetIndexItem, } from './mediaAssets';
+export type { ComponentRegistry, BlocksPageRendererDataContext, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
 export type { ThemeScopeProps } from './blocks-theme-scope';
 export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, CustomBlockOverrideKey, KnownSystemBlockOverrides, KnownBlockOverrideKey, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, StrictBlockOverrideRegistrations, StrictBlockOverrides, SystemBlockOverrideKey, } from './overrides';
 export { defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, } from './overrides';

package/dist/_dts/sdk/src/rendering/islands/types.d.ts

@@ -1,4 +1,4 @@
-import type { EventScheduleScope as SystemEventScheduleScope, EventSurfacePreset as SystemEventSurfacePreset, RichTextDoc as SystemRichTextDoc } from '../../contracts/system-block-content';
+import type { ButtonVariant as SystemButtonVariant, EventScheduleScope as SystemEventScheduleScope, EventSurfacePreset as SystemEventSurfacePreset, RichTextDoc as SystemRichTextDoc } from '../../contracts/system-block-content';
 import type { PublicTeamMemberSummary } from '../../../../api/src/index';
 import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, LocationCoordinates, PublicCoursePriceDisplay, PublicEventPriceDisplay, PublicEventPricing, PublicEventPricingType } from '../../../../core/src/index';
 import type { AccordionIslandProps as BlocksAccordionIslandProps, BookingFormConfig as BlocksBookingFormConfig, BookingFormInteractiveIslandProps as BlocksBookingFormIslandProps, BookingFormService as BlocksBookingFormService, CarouselIslandProps as BlocksCarouselIslandProps, CourseRegistrationInteractiveIslandProps as BlocksCourseRegistrationIslandProps, CartDisplay as BlocksCartDisplay, CartInteractiveIslandProps as BlocksCartIslandProps, CartLineDisplay as BlocksCartLineDisplay, CheckoutDisplay as BlocksCheckoutDisplay, CheckoutInteractiveIslandProps as BlocksCheckoutIslandProps, EventCalendarInteractiveIslandProps as BlocksEventCalendarIslandProps, EventCombinedInteractiveIslandProps as BlocksEventCombinedIslandProps, EventDetailsIslandProps as BlocksEventDetailsIslandProps, EventDetailsOccurrenceContext as BlocksEventDetailsOccurrenceContext, LocationMapIslandProps as BlocksLocationMapIslandProps, EventRegistrationInteractiveIslandProps as BlocksEventRegistrationIslandProps, EventListingDisplay as BlocksEventListingDisplay, EventListingHydration as BlocksEventListingHydration, EventListingInteractiveIslandProps as BlocksEventListingIslandProps, PublicEvent as BlocksPublicEvent, FormInteractiveIslandProps as BlocksFormIslandProps, HeaderSectionIslandProps as BlocksHeaderSectionIslandProps, MembershipCardDisplay as BlocksMembershipCardDisplay, NewsletterFormInteractiveIslandProps as BlocksNewsletterFormIslandProps, PassCardDisplay as BlocksPassCardDisplay, PassesMembershipsDisplay as BlocksPassesMembershipsDisplay, ProductCardDisplay as BlocksProductCardDisplay, ProductDetailDisplay as BlocksProductDetailDisplay, ProductDetailInteractiveIslandProps as BlocksProductDetailIslandProps, ProductListDisplay as BlocksProductListDisplay, ProductListInteractiveIslandProps as BlocksProductListIslandProps, ProductVariantOptionDisplay as BlocksProductVariantOptionDisplay, ShopInteractiveIslandProps as BlocksShopIslandProps } from '../../../../blocks/src/contracts/index';
@@ -240,7 +240,7 @@ export type BookingFormService = BlocksBookingFormService;
 export type BookingFormConfig = BlocksBookingFormConfig;
 export type BookingFormIslandProps = BlocksBookingFormIslandProps;
 export type CardVariant = 'default' | 'variant1' | 'variant2';
-export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'link';
+export type ButtonVariant = SystemButtonVariant;
 export type EventListingLayout = EventLayout;
 export type CardOrientation = 'vertical' | 'horizontal';
 export type EventListingDisplay = BlocksEventListingDisplay;

package/dist/_dts/sdk/src/rendering/mediaAssets.d.ts

@@ -1,4 +1,10 @@
-import type { MediaAssetIndexItem as BlocksMediaAssetIndexItem, ResolveImageUrlContextInput as BlocksResolveImageUrlContextInput } from '../../../blocks/src/index';
+import { type MediaAssetId } from '../../../core/src/index';
 import type { MediaAssetIndexItem as SdkMediaAssetIndexItem, ResolveImageUrlContextInput as SdkResolveImageUrlContextInput } from '../contracts';
+export type BlocksMediaAssetIndexItem = Omit<SdkMediaAssetIndexItem, 'id'> & Readonly<{
+    id: MediaAssetId;
+}>;
+export type BlocksImageResolveContextInput = Omit<SdkResolveImageUrlContextInput, 'mediaAssets'> & Readonly<{
+    mediaAssets?: readonly BlocksMediaAssetIndexItem[];
+}>;
 export declare function toBlocksMediaAssets(assets: readonly SdkMediaAssetIndexItem[] | undefined): readonly BlocksMediaAssetIndexItem[] | undefined;
-export declare function toBlocksImageResolveContextInput(context: SdkResolveImageUrlContextInput | undefined): BlocksResolveImageUrlContextInput | undefined;
+export declare function toBlocksImageResolveContextInput(context: SdkResolveImageUrlContextInput | undefined): BlocksImageResolveContextInput | undefined;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.126.0";
+export declare const SDK_VERSION = "0.128.0";

package/dist/_dts/site-commands/src/commandContract.d.ts

@@ -674,7 +674,14 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
         type: z.ZodLiteral<"upsertFooterContent">;
         ref: z.ZodPipe<z.ZodString, z.ZodTransform<import("./refs").FooterRef, string>>;
         input: z.ZodObject<{
-            bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<import("../../core/src/index").RichTextDoc, import("../../core/src/index").RichTextDoc>>>;
+            composition: z.ZodCustom<Readonly<{
+                schemaVersion: 1;
+                sections: readonly import("../../core/src/index").FooterSection[];
+            }>, Readonly<{
+                schemaVersion: 1;
+                sections: readonly import("../../core/src/index").FooterSection[];
+            }>>;
+            baseRevision: z.ZodNumber;
         }, z.core.$strict>;
     }, z.core.$strict>, z.ZodObject<{
         type: z.ZodLiteral<"upsertContentEntry">;

package/dist/_dts/site-commands/src/commands.d.ts

@@ -224,7 +224,14 @@ export declare const upsertFooterContentCommandSchema: z.ZodObject<{
     type: z.ZodLiteral<"upsertFooterContent">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<FooterRef, string>>;
     input: z.ZodObject<{
-        bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<RichTextDoc, RichTextDoc>>>;
+        composition: z.ZodCustom<Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>, Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>>;
+        baseRevision: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const upsertContentEntryCommandSchema: z.ZodObject<{
@@ -1392,7 +1399,14 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"upsertFooterContent">;
     ref: z.ZodPipe<z.ZodString, z.ZodTransform<FooterRef, string>>;
     input: z.ZodObject<{
-        bottomText: z.ZodOptional<z.ZodNullable<z.ZodCustom<RichTextDoc, RichTextDoc>>>;
+        composition: z.ZodCustom<Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>, Readonly<{
+            schemaVersion: 1;
+            sections: readonly import("../../core/src/index").FooterSection[];
+        }>>;
+        baseRevision: z.ZodNumber;
     }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"upsertContentEntry">;

package/dist/_dts/theme-core/src/buttons/effects/presets/background.d.ts

@@ -1,4 +1,4 @@
-import type { EffectPreset } from "../types";
+import type { EffectPreset } from '../types';
 /**
  * Darken background on hover
  *

package/dist/_dts/theme-core/src/buttons/styles/registry.d.ts

@@ -720,24 +720,6 @@ export type ResolveButtonStyleSelectionResult = Readonly<{
 }>;
 export declare function resolveButtonStyleSelection(selection: ButtonStyleSelection): ResolveButtonStyleSelectionResult;
 export declare function defaultButtonStyleSelectionFor<TStyleId extends ButtonStyleId>(styleId: TStyleId): ButtonStyleSelectionFor<TStyleId>;
-export type PersistedButtonStyleWarning = Readonly<{
-    kind: 'missing-style-id';
-}> | Readonly<{
-    kind: 'unknown-style-id';
-    raw: string;
-}> | Readonly<{
-    kind: 'invalid-parameters';
-    styleId: ButtonStyleId;
-    issues: readonly string[];
-}>;
-export type PersistedButtonStyleSelectionResult = Readonly<{
-    selection: ButtonStyleSelection;
-    warning: PersistedButtonStyleWarning | null;
-}>;
-export declare function parsePersistedButtonStyleSelection(input: Readonly<{
-    styleId: string | null | undefined;
-    parameters: unknown;
-}>, fallback?: ButtonStyleSelection): PersistedButtonStyleSelectionResult;
 export declare function buttonStyleSelectionParameterValue(selection: ButtonStyleSelection, parameter: string): string | null;
 export type UpdateButtonStyleSelectionChoiceResult = Readonly<{
     kind: 'updated';

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

@@ -41,7 +41,7 @@ export type ButtonSizes = Record<ButtonSizeName, ButtonSizeConfig>;
  * Block content references variants by role; the active theme determines
  * what each role looks like.
  */
-export declare const VARIANT_ROLES: readonly ["primary", "secondary", "outline", "ghost", "link", "tertiary", "accent"];
+export declare const VARIANT_ROLES: readonly ["primary", "secondary", "outline", "ghost", "accent"];
 export type VariantRole = (typeof VARIANT_ROLES)[number];
 export declare function isVariantRole(value: string): value is VariantRole;
 declare const SpecialVariantIdBrand: unique symbol;
@@ -307,13 +307,11 @@ export declare const gradientSharpnessSchema: z.ZodEnum<{
 }>;
 export declare const prioritySchema: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
 export declare const variantRoleSchema: z.ZodEnum<{
-    link: "link";
     outline: "outline";
     accent: "accent";
     primary: "primary";
     secondary: "secondary";
     ghost: "ghost";
-    tertiary: "tertiary";
 }>;
 export declare const buttonSizeNameSchema: z.ZodEnum<{
     sm: "sm";

package/dist/_dts/theme-core/src/header/containerSchema.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const headerContainerSchema: z.ZodOptional<z.ZodObject<{
+    rounded: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+        "2xl": "2xl";
+    }>>;
+    border: z.ZodDefault<z.ZodBoolean>;
+    shadow: z.ZodDefault<z.ZodBoolean>;
+    padding: z.ZodDefault<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+    }>>;
+    tint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;

package/dist/_dts/theme-core/src/header/generateHeaderCss.d.ts

@@ -16,5 +16,5 @@ export declare const _testExports: {
 /**
  * Generate root header container styles
  */
-declare function generateHeaderRootStyles(header: ThemeHeader, themeId: string, tokens: TokenResolver, _theme: Theme): string;
+declare function generateHeaderRootStyles(header: ThemeHeader, themeId: string, tokens: TokenResolver): string;
 export {};

package/dist/_dts/theme-core/src/header/interactionPalette.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const headerInteractionPaletteValues: readonly ["primary", "secondary", "accent"];
+export declare const headerInteractionPaletteSchema: z.ZodEnum<{
+    accent: "accent";
+    primary: "primary";
+    secondary: "secondary";
+}>;
+export type HeaderInteractionPalette = z.infer<typeof headerInteractionPaletteSchema>;
+export type HeaderInteractionPalettePreference = 'recommended' | HeaderInteractionPalette;
+export type HeaderInteractionPalettePair = Readonly<{
+    backgroundToken: 'primary' | 'secondary' | 'accent';
+    foregroundToken: 'onPrimary' | 'onSecondary' | 'onAccent';
+}>;
+export declare function headerInteractionPalettePair(palette: HeaderInteractionPalette): HeaderInteractionPalettePair;

package/dist/_dts/theme-core/src/header/legacyNavLinkStyle.d.ts

@@ -0,0 +1,3 @@
+import type { NavLinkContrastTreatment, NavLinkStyle } from '../navigation/types';
+import type { ThemeHeader } from '../schema';
+export declare function buildLegacyHeaderNavLinkStyle(header: ThemeHeader, contrastTreatment: NavLinkContrastTreatment | null, navTextSize: NavLinkStyle['textSize'] | null): NavLinkStyle | null;

package/dist/_dts/theme-core/src/header/paintTargets.d.ts

@@ -0,0 +1,31 @@
+type HeaderLayoutVariant = 'classic' | 'centered' | 'transparent' | 'floating';
+type ElementBoxPaintTarget = Readonly<{
+    kind: 'element-box';
+    selector: string;
+    mediaQuery?: string;
+    pseudoElement?: 'inset';
+}>;
+type ViewportBandPaintTarget = Readonly<{
+    kind: 'viewport-band';
+    clipSelector: string;
+    ownerSelector: string;
+    selector: string;
+    mediaQuery: string;
+    extent: Readonly<{
+        top: Readonly<{
+            customProperty: '--rb-header-floating-top-gap';
+            value: '1rem' | '0.75rem';
+            ownerProperty: 'top' | 'margin-top';
+        }>;
+        bottom: Readonly<{
+            customProperty: '--rb-header-floating-bottom-extension';
+            value: '0.75rem';
+        }>;
+    }>;
+    ownerNeedsPositioning: boolean;
+}>;
+export type HeaderPaintTarget = ElementBoxPaintTarget | ViewportBandPaintTarget;
+/** Resolve the element that owns the visible header surface for each layout. */
+export declare function getHeaderPaintTargets(variant: HeaderLayoutVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
+export declare function renderHeaderPaintTargetRules(targets: readonly HeaderPaintTarget[], rules: readonly string[]): string;
+export {};

package/dist/_dts/theme-core/src/header/scrollTreatment.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"contrast-glass">;
+    backgroundTone: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+}, z.core.$strip>], "kind">>;
+export type HeaderScrollTreatment = z.infer<typeof headerScrollTreatmentSchema>;
+export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating'): string;
+export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating', surfaceRules?: readonly string[]): string;

package/dist/_dts/theme-core/src/header/surfaceRules.d.ts

@@ -0,0 +1,8 @@
+import type { ThemeHeader } from '../schema';
+import type { TokenResolver } from '../tokens/resolver';
+export type HeaderSurfaceRules = Readonly<{
+    base: readonly string[];
+    border: readonly string[];
+}>;
+/** Compile the at-rest surface independently of scroll treatment and paint geometry. */
+export declare function buildHeaderSurfaceRules(header: ThemeHeader, tokens: TokenResolver): HeaderSurfaceRules;

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

@@ -187,6 +187,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -226,6 +230,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -1540,6 +1545,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -1579,6 +1588,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -2893,6 +2903,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -2932,6 +2946,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";

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

@@ -87,7 +87,7 @@ export declare function paletteColorsEqual(left: PaletteColors, right: PaletteCo
 export declare function paletteColorFingerprint(colors: PaletteColors): string;
 export declare function canonicalPaletteHashInput(colors: PaletteColors, mode: PaletteMode): string;
 /**
- * The shared TypeScript/SQL protocol. Do not reorder roles: the order comes
+ * Stable curated-catalogue identity. Do not reorder roles: the order comes
  * from PALETTE_TOKEN_NAMES through canonicalPaletteHashInput.
  */
 export declare function paletteValueKey(colors: PaletteColors, mode: PaletteMode): PaletteValueKey;

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

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import type { ExpandedPalette } from './palette/expandPalette';
 import { paletteColorSchema, paletteMetaSchema, paletteSchema } from './palette/schema';
+import { headerContainerSchema } from './header/containerSchema';
 export declare const axesSchema: z.ZodObject<{
     tone: z.ZodEnum<{
         bold: "bold";
@@ -1708,25 +1709,6 @@ declare const headerMaxWidth: z.ZodEnum<{
     full: "full";
     container: "container";
 }>;
-declare const headerContainerSchema: z.ZodOptional<z.ZodObject<{
-    rounded: z.ZodDefault<z.ZodEnum<{
-        none: "none";
-        sm: "sm";
-        md: "md";
-        lg: "lg";
-        xl: "xl";
-        "2xl": "2xl";
-    }>>;
-    border: z.ZodDefault<z.ZodBoolean>;
-    shadow: z.ZodDefault<z.ZodBoolean>;
-    padding: z.ZodDefault<z.ZodEnum<{
-        sm: "sm";
-        md: "md";
-        lg: "lg";
-    }>>;
-    tint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    opacity: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>>;
 declare const headerBorderSchema: z.ZodOptional<z.ZodObject<{
     width: z.ZodDefault<z.ZodEnum<{
         medium: "medium";
@@ -1941,6 +1923,13 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
         "full-bleed": "full-bleed";
         "inset-shell": "inset-shell";
     }>>;
+    scrollTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"contrast-glass">;
+        backgroundTone: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+    }, z.core.$strip>], "kind">>;
     logoOverride: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         type: z.ZodEnum<{
             image: "image";
@@ -2082,6 +2071,11 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
         xl: "xl";
         xs: "xs";
     }>>;
+    interactionPalette: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        primary: "primary";
+        secondary: "secondary";
+    }>>;
     navPlacement: z.ZodOptional<z.ZodEnum<{
         center: "center";
         end: "end";
@@ -2392,6 +2386,10 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
         tint?: string | null | undefined;
     };
     barFrame?: "full-bleed" | "inset-shell" | undefined;
+    scrollTreatment?: {
+        kind: "contrast-glass";
+        backgroundTone: "light" | "dark";
+    } | undefined;
     logoOverride?: {
         type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
         purpose?: string | undefined;
@@ -2431,6 +2429,7 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
     navFontRole?: "heading" | "body" | undefined;
     navTypography?: "heading" | "body" | undefined;
     navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+    interactionPalette?: "accent" | "primary" | "secondary" | undefined;
     navPlacement?: "center" | "end" | undefined;
     container?: {
         rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -2580,6 +2579,10 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
         tint?: string | null | undefined;
     };
     barFrame?: "full-bleed" | "inset-shell" | undefined;
+    scrollTreatment?: {
+        kind: "contrast-glass";
+        backgroundTone: "light" | "dark";
+    } | undefined;
     logoOverride?: {
         type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
         purpose?: string | undefined;
@@ -2619,6 +2622,7 @@ export declare const headerSchema: z.ZodPipe<z.ZodObject<{
     navFontRole?: "heading" | "body" | undefined;
     navTypography?: "heading" | "body" | undefined;
     navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+    interactionPalette?: "accent" | "primary" | "secondary" | undefined;
     navPlacement?: "center" | "end" | undefined;
     container?: {
         rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -3915,6 +3919,13 @@ export declare const themeSchema: z.ZodObject<{
             "full-bleed": "full-bleed";
             "inset-shell": "inset-shell";
         }>>;
+        scrollTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"contrast-glass">;
+            backgroundTone: z.ZodEnum<{
+                light: "light";
+                dark: "dark";
+            }>;
+        }, z.core.$strip>], "kind">>;
         logoOverride: z.ZodOptional<z.ZodNullable<z.ZodObject<{
             type: z.ZodEnum<{
                 image: "image";
@@ -4056,6 +4067,11 @@ export declare const themeSchema: z.ZodObject<{
             xl: "xl";
             xs: "xs";
         }>>;
+        interactionPalette: z.ZodOptional<z.ZodEnum<{
+            accent: "accent";
+            primary: "primary";
+            secondary: "secondary";
+        }>>;
         navPlacement: z.ZodOptional<z.ZodEnum<{
             center: "center";
             end: "end";
@@ -4366,6 +4382,10 @@ export declare const themeSchema: z.ZodObject<{
             tint?: string | null | undefined;
         };
         barFrame?: "full-bleed" | "inset-shell" | undefined;
+        scrollTreatment?: {
+            kind: "contrast-glass";
+            backgroundTone: "light" | "dark";
+        } | undefined;
         logoOverride?: {
             type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
             purpose?: string | undefined;
@@ -4405,6 +4425,7 @@ export declare const themeSchema: z.ZodObject<{
         navFontRole?: "heading" | "body" | undefined;
         navTypography?: "heading" | "body" | undefined;
         navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+        interactionPalette?: "accent" | "primary" | "secondary" | undefined;
         navPlacement?: "center" | "end" | undefined;
         container?: {
             rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -4554,6 +4575,10 @@ export declare const themeSchema: z.ZodObject<{
             tint?: string | null | undefined;
         };
         barFrame?: "full-bleed" | "inset-shell" | undefined;
+        scrollTreatment?: {
+            kind: "contrast-glass";
+            backgroundTone: "light" | "dark";
+        } | undefined;
         logoOverride?: {
             type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
             purpose?: string | undefined;
@@ -4593,6 +4618,7 @@ export declare const themeSchema: z.ZodObject<{
         navFontRole?: "heading" | "body" | undefined;
         navTypography?: "heading" | "body" | undefined;
         navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+        interactionPalette?: "accent" | "primary" | "secondary" | undefined;
         navPlacement?: "center" | "end" | undefined;
         container?: {
             rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -7181,6 +7207,13 @@ export declare const themesTurnSchema: z.ZodObject<{
                 "full-bleed": "full-bleed";
                 "inset-shell": "inset-shell";
             }>>;
+            scrollTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"contrast-glass">;
+                backgroundTone: z.ZodEnum<{
+                    light: "light";
+                    dark: "dark";
+                }>;
+            }, z.core.$strip>], "kind">>;
             logoOverride: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 type: z.ZodEnum<{
                     image: "image";
@@ -7322,6 +7355,11 @@ export declare const themesTurnSchema: z.ZodObject<{
                 xl: "xl";
                 xs: "xs";
             }>>;
+            interactionPalette: z.ZodOptional<z.ZodEnum<{
+                accent: "accent";
+                primary: "primary";
+                secondary: "secondary";
+            }>>;
             navPlacement: z.ZodOptional<z.ZodEnum<{
                 center: "center";
                 end: "end";
@@ -7632,6 +7670,10 @@ export declare const themesTurnSchema: z.ZodObject<{
                 tint?: string | null | undefined;
             };
             barFrame?: "full-bleed" | "inset-shell" | undefined;
+            scrollTreatment?: {
+                kind: "contrast-glass";
+                backgroundTone: "light" | "dark";
+            } | undefined;
             logoOverride?: {
                 type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                 purpose?: string | undefined;
@@ -7671,6 +7713,7 @@ export declare const themesTurnSchema: z.ZodObject<{
             navFontRole?: "heading" | "body" | undefined;
             navTypography?: "heading" | "body" | undefined;
             navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+            interactionPalette?: "accent" | "primary" | "secondary" | undefined;
             navPlacement?: "center" | "end" | undefined;
             container?: {
                 rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -7820,6 +7863,10 @@ export declare const themesTurnSchema: z.ZodObject<{
                 tint?: string | null | undefined;
             };
             barFrame?: "full-bleed" | "inset-shell" | undefined;
+            scrollTreatment?: {
+                kind: "contrast-glass";
+                backgroundTone: "light" | "dark";
+            } | undefined;
             logoOverride?: {
                 type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                 purpose?: string | undefined;
@@ -7859,6 +7906,7 @@ export declare const themesTurnSchema: z.ZodObject<{
             navFontRole?: "heading" | "body" | undefined;
             navTypography?: "heading" | "body" | undefined;
             navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+            interactionPalette?: "accent" | "primary" | "secondary" | undefined;
             navPlacement?: "center" | "end" | undefined;
             container?: {
                 rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";