@riverbankcms/sdk 0.107.0 → 0.109.0

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

@@ -19,8 +19,8 @@ export type ThemeChromeTextLegibilityPlan = Readonly<{
 export declare const backgroundAppearanceQuickColorTokenNames: readonly ["background", "surface", "muted", "primary", "secondary", "accent"];
 export declare const backgroundAppearanceBaseColorTokenNames: readonly ["background", "surface", "surfaceAlt", "muted", "primary", "secondary", "accent", "neutral"];
 export declare const backgroundAppearanceShadeableColorTokenNames: readonly ["primary", "secondary", "accent", "neutral"];
-export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "accent" | "muted" | "primary" | "secondary" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "accent-500" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-900" | "primary-800" | "primary-700" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950")[];
-export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "accent" | "muted" | "primary" | "secondary" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "accent-500" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-900" | "primary-800" | "primary-700" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950")[];
+export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "accent" | "muted" | "primary" | "secondary" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "primary-800" | "primary-700" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950")[];
+export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "accent" | "muted" | "primary" | "secondary" | "surfaceAlt" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "primary-100" | "primary-50" | "primary-900" | "secondary-50" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "primary-800" | "primary-700" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950")[];
 export declare function parseBackgroundAppearanceColorToken(value: unknown): ThemeColorToken | null;
 export declare function foregroundTokenForBackgroundAppearanceColorToken(token: ThemeColorToken): string;
 export declare function planThemeBackgroundTextLegibility(backgroundToken: ThemeColorToken, role?: BackgroundTextLegibilityRole): ThemeBackgroundTextLegibilityPlan;

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

@@ -197,8 +197,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
             secondary: "secondary";
         }>;
         intensity: z.ZodOptional<z.ZodEnum<{
-            soft: "soft";
             balanced: "balanced";
+            soft: "soft";
             strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
@@ -209,29 +209,29 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
             secondary: "secondary";
         }>;
         intensity: z.ZodOptional<z.ZodEnum<{
-            soft: "soft";
             balanced: "balanced";
+            soft: "soft";
             strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"neutral-scrim">;
         intensity: z.ZodOptional<z.ZodEnum<{
-            soft: "soft";
             balanced: "balanced";
+            soft: "soft";
             strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"neutral-wash">;
         intensity: z.ZodOptional<z.ZodEnum<{
-            soft: "soft";
             balanced: "balanced";
+            soft: "soft";
             strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"solid-panel">;
         intensity: z.ZodOptional<z.ZodEnum<{
-            soft: "soft";
             balanced: "balanced";
+            soft: "soft";
             strong: "strong";
         }>>;
     }, z.core.$strict>], "kind">>;
@@ -418,8 +418,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
                 secondary: "secondary";
             }>;
             intensity: z.ZodOptional<z.ZodEnum<{
-                soft: "soft";
                 balanced: "balanced";
+                soft: "soft";
                 strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
@@ -430,29 +430,29 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
                 secondary: "secondary";
             }>;
             intensity: z.ZodOptional<z.ZodEnum<{
-                soft: "soft";
                 balanced: "balanced";
+                soft: "soft";
                 strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"neutral-scrim">;
             intensity: z.ZodOptional<z.ZodEnum<{
-                soft: "soft";
                 balanced: "balanced";
+                soft: "soft";
                 strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"neutral-wash">;
             intensity: z.ZodOptional<z.ZodEnum<{
-                soft: "soft";
                 balanced: "balanced";
+                soft: "soft";
                 strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"solid-panel">;
             intensity: z.ZodOptional<z.ZodEnum<{
-                soft: "soft";
                 balanced: "balanced";
+                soft: "soft";
                 strong: "strong";
             }>>;
         }, z.core.$strict>], "kind">>;

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

@@ -36,7 +36,7 @@ export declare function parsePersistedHeaderLayoutId(value: string): Exclude<Per
     kind: 'empty';
 }>;
 export declare function parsePersistedHeaderLayoutId(value: string | null | undefined): PersistedHeaderLayoutIdParseResult;
-export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "serif-line", "flat-tabs", "glass", "minimal-surface", "soft-shell", "split-glass", "split-pill"];
+export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "brand-capsule", "serif-line", "flat-tabs", "glass", "minimal-surface", "soft-shell", "split-glass", "split-pill"];
 export type HeaderStyleIdValue = (typeof headerStyleIdValues)[number];
 export type HeaderStyleId = Brand<HeaderStyleIdValue, 'HeaderStyleId'>;
 export declare function asHeaderStyleId(value: HeaderStyleIdValue): HeaderStyleId;
@@ -339,6 +339,16 @@ export declare const headerStyleCatalog: readonly [{
     readonly defaultDepth: "none";
     readonly navTypography: "brand-caps";
     readonly moods: readonly ["expressive"];
+}, {
+    readonly id: HeaderStyleId;
+    readonly label: "Brand Capsule";
+    readonly description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.";
+    readonly supportedLayoutIds: readonly HeaderLayoutId[];
+    readonly navInteraction: "pill-background";
+    readonly surface: "brand-solid";
+    readonly defaultDepth: "shadow";
+    readonly navTypography: "quiet-caps";
+    readonly moods: readonly ["expressive", "professional"];
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Serif Line";
@@ -468,6 +478,7 @@ export declare const legacyHeaderLookAliases: readonly [{
 export declare function getHeaderLayout(id: HeaderLayoutId): HeaderLayoutDefinition | null;
 export declare function getHeaderStyle(id: HeaderStyleId): HeaderStyleDefinition | null;
 export declare function isHeaderStyleCompatibleWithLayout(style: HeaderStyleDefinition, layoutId: HeaderLayoutId): boolean;
+export declare function headerLayoutSupportsBarFrame(layoutId: HeaderLayoutId): boolean;
 export declare function resolveLegacyHeaderLookAlias(lookId: HeaderLookId): HeaderLayoutStyleSelection | null;
 export declare function findLegacyHeaderLookIdForSelection(selection: HeaderLayoutStyleSelection): HeaderLookId | null;
 export declare function getCompatibleHeaderStyleIds(layoutId: HeaderLayoutId): readonly HeaderStyleId[];

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

@@ -1,6 +1,6 @@
 import type { BlockAppearanceDesign, BlockAppearanceOptionGroup } from './appearancePresets';
 import type { BlockDesignMetadata, BlockLayoutDesignProfile } from './blockFlow';
-import { type PageDesignIntent } from './pageDesignIntent';
+import { type PageDesignDecisions } from './pageDesignIntent';
 import { type AppearancePresetId, type BlockDesignCapability, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId, type UnsupportedBlockDesignCapabilityReason } from './types';
 import { type BoundaryOption } from './sectionTransitions';
 export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
@@ -163,7 +163,8 @@ export declare const pageFlowPresets: readonly [{
     readonly defaultBoundaryOptionId: BoundaryOptionId;
 }];
 export declare function buildPageDesignEditorReadModel<TBlockId extends DesignBlockId>(input: Readonly<{
-    intent: PageDesignIntent<TBlockId>;
+    siteStyleId: SiteStyleId;
+    intent: PageDesignDecisions<TBlockId>;
     blocks: readonly PageDesignEditorBlockInput<TBlockId>[];
 }>): PageDesignEditorReadModel<TBlockId>;
 export declare function resolveVisiblePromotedFieldPathsForEditorBlock(input: Readonly<{

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

@@ -43,6 +43,8 @@ export type PageDesignIntent<TBlockId extends DesignBlockId = DesignBlockId> = R
     blockLookPins: readonly PageDesignBlockLookPin<TBlockId>[];
     boundaryPins: readonly PageDesignBoundaryPin<TBlockId>[];
 }>;
+/** Page-owned decisions consumed by compilers; site style is supplied separately. */
+export type PageDesignDecisions<TBlockId extends DesignBlockId = DesignBlockId> = Omit<PageDesignIntent<TBlockId>, 'siteStyleId'>;
 export type PageDesignBlockDescriptor<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     blockId: TBlockId;
     blockKind: string;
@@ -110,6 +112,11 @@ export type PageDesignIntentUpdate<TBlockId extends DesignBlockId = DesignBlockI
     intent: PageDesignIntent<TBlockId>;
     issues: readonly PageDesignIntentIssue<TBlockId>[];
 }>;
+/**
+ * Site style is site-owned authority. Page design snapshots retain pins and
+ * flow choices, but must not keep resolving against a superseded site style.
+ */
+export declare function rebasePageDesignIntentToSiteStyle<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, siteStyleId: SiteStyleId): PageDesignIntent<TBlockId>;
 export type PageDesignDuplicateBlockMapping<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     sourceBlockId: TBlockId;
     targetBlockId: TBlockId;
@@ -148,8 +155,8 @@ export declare const pageDesignBoundaryTreatmentSchema: z.ZodDiscriminatedUnion<
         expansive: "expansive";
     }>;
     curve: z.ZodEnum<{
-        soft: "soft";
         spacious: "spacious";
+        soft: "soft";
         expansive: "expansive";
     }>;
 }, z.core.$strict>, z.ZodObject<{
@@ -206,8 +213,8 @@ export declare const pageDesignUserPinnedBoundaryTreatmentChoiceSchema: z.ZodObj
             expansive: "expansive";
         }>;
         curve: z.ZodEnum<{
-            soft: "soft";
             spacious: "spacious";
+            soft: "soft";
             expansive: "expansive";
         }>;
     }, z.core.$strict>, z.ZodObject<{
@@ -277,8 +284,8 @@ export declare const pageDesignBoundaryPinSchema: z.ZodObject<{
                 expansive: "expansive";
             }>;
             curve: z.ZodEnum<{
-                soft: "soft";
                 spacious: "spacious";
+                soft: "soft";
                 expansive: "expansive";
             }>;
         }, z.core.$strict>, z.ZodObject<{
@@ -389,8 +396,8 @@ export declare const pageDesignIntentV2Schema: z.ZodObject<{
                     expansive: "expansive";
                 }>;
                 curve: z.ZodEnum<{
-                    soft: "soft";
                     spacious: "spacious";
+                    soft: "soft";
                     expansive: "expansive";
                 }>;
             }, z.core.$strict>, z.ZodObject<{
@@ -441,8 +448,8 @@ export declare function parsePageDesignIntent(value: unknown, options?: ParsePag
 export declare function normalizeLegacyPageDesignIntent<TBlockId extends DesignBlockId>(intent: LegacyPageDesignIntent<TBlockId>): PageDesignIntent<TBlockId>;
 export declare function autoDesignChoice(): PageDesignAutoChoice;
 export declare function userPinnedDesignChoice<TValue>(value: TValue): PageDesignUserPinnedChoice<TValue>;
-export declare function resolvePageDesignBlockLookChoice<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, blockId: TBlockId): PageDesignChoice<AppearancePresetId>;
-export declare function resolvePageDesignBoundaryChoice<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, previousBlockId: TBlockId, nextBlockId: TBlockId): PageDesignChoice<SectionBoundaryTreatment>;
+export declare function resolvePageDesignBlockLookChoice<TBlockId extends DesignBlockId>(intent: PageDesignDecisions<TBlockId>, blockId: TBlockId): PageDesignChoice<AppearancePresetId>;
+export declare function resolvePageDesignBoundaryChoice<TBlockId extends DesignBlockId>(intent: PageDesignDecisions<TBlockId>, previousBlockId: TBlockId, nextBlockId: TBlockId): PageDesignChoice<SectionBoundaryTreatment>;
 export declare function buildBoundaryPin<TBlockId extends DesignBlockId>(previousBlockId: TBlockId, nextBlockId: TBlockId, choice: PageDesignUserPinnedChoice<SectionBoundaryTreatment>): PageDesignBoundaryPin<TBlockId>;
 export declare function reducePageDesignIntentForStructureEvent<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, event: PageDesignStructureEvent<TBlockId>): PageDesignIntentUpdate<TBlockId>;
 export declare function reducePageDesignIntentForUserAction<TBlockId extends DesignBlockId>(intent: PageDesignIntent<TBlockId>, action: PageDesignUserAction<TBlockId>): PageDesignIntent<TBlockId>;

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

@@ -5,14 +5,35 @@ import type { CompleteResolvedPaletteSelection } from '../palette/resolveSelecti
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
 import { type SectionBoundaryRuntimeMetrics } from './sectionTransitions';
-import type { ThemeColorToken } from '../tokens';
+import { type ThemeColorToken } from '../tokens';
+import { type GradientPresetId } from '../gradients';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type SectionPaddingX = 'normal' | 'none';
-type SectionForegroundRuntimeTokens = Pick<NonNullable<SectionSurfaceRuntimeRule['background']>, 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor'>;
-export type SectionSurfaceRuntimeRule = Readonly<{
-    background?: NonNullable<SectionStylesOverride['background']>;
+type SectionBackgroundOverride = NonNullable<SectionStylesOverride['background']>;
+type SectionForegroundRuntimeTokenKey = 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor';
+export type SectionForegroundRuntimeTokens = {
+    readonly [TKey in SectionForegroundRuntimeTokenKey]: ThemeColorToken;
+};
+export declare function defineSectionForegroundRuntimeTokens(input: Readonly<Record<SectionForegroundRuntimeTokenKey, unknown>>): SectionForegroundRuntimeTokens;
+type NonGradientSectionRuntimeBackground = Omit<SectionBackgroundOverride, 'type' | 'gradient' | 'gradientPresetId'> & Readonly<{
+    type?: 'color' | 'image';
+    gradient?: never;
+    gradientPresetId?: never;
+}>;
+type GradientSectionRuntimeBackground = Readonly<{
+    type: 'gradient';
+    gradientPresetId: GradientPresetId;
+    opacity?: number;
+}>;
+type NonGradientSectionSurfaceRuntimeRule = Readonly<{
+    background?: NonGradientSectionRuntimeBackground;
     foreground?: Partial<SectionForegroundRuntimeTokens>;
 }>;
+type GradientSectionSurfaceRuntimeRule = Readonly<{
+    background: GradientSectionRuntimeBackground;
+    foreground: SectionForegroundRuntimeTokens;
+}>;
+export type SectionSurfaceRuntimeRule = NonGradientSectionSurfaceRuntimeRule | GradientSectionSurfaceRuntimeRule;
 export type DesignRuntimeRules = Readonly<{
     sectionSurfaces: Readonly<Record<SiteStyleSurfaceIntent, SectionSurfaceRuntimeRule>>;
     defaultEyebrowTreatment?: EyebrowTreatment;
@@ -150,10 +171,10 @@ export declare const defaultDesignRuntimeRules: {
         };
         readonly 'hero-image': {
             readonly background: {
-                readonly textColor?: string | null | undefined;
-                readonly headingColor?: string | null | undefined;
-                readonly linkColor?: string | null | undefined;
-                readonly supportingColor?: string | null | undefined;
+                readonly textColor: string;
+                readonly headingColor: string;
+                readonly linkColor: string;
+                readonly supportingColor: string;
                 readonly type: "image";
                 readonly opacity: 1;
                 readonly position: "center center";

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

@@ -41,5 +41,20 @@ export declare const defaultHeaderNavPreferences: {
 export declare function readHeaderNavPreferences(theme: Theme | null | undefined): HeaderNavPreferences;
 export declare function headerNavPreferencesEqual(left: HeaderNavPreferences, right: HeaderNavPreferences): boolean;
 export declare function withHeaderNavThemePreferences(theme: Theme, preferences: HeaderNavPreferences): Theme;
+/**
+ * Applies the user's nav font-role/size overrides on top of a style-resolved
+ * nav link style. This is where the precedence contract lands:
+ *
+ * - The nav typography TREATMENT (case/tracking identity: plain / heading /
+ *   quiet-caps / brand-caps) is ALWAYS owned by the active header style and is
+ *   baked into `style` before this call (see `applyNavTypography` in
+ *   headerLooks.ts).
+ * - Each treatment resolves through a DEFAULT font role: `heading` resolves
+ *   through the heading role; `plain` / `quiet-caps` / `brand-caps` resolve
+ *   through the body role.
+ * - The user's `navFontRole` (surfaced here as `preferences.typography`) only
+ *   overrides which font ROLE the treatment resolves through. It never changes
+ *   the treatment. `'inherit'` keeps the treatment's default role.
+ */
 export declare function mergeHeaderNavTypographyPreference(style: NavLinkStyle, preferences: HeaderNavPreferences): NavLinkStyle;
 export declare function readHeaderNavFontSizePreference(value: NavLinkTextSize | undefined): HeaderNavFontSizePreference;

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

@@ -28,9 +28,9 @@ export declare const styleTagsSchema: z.ZodObject<{
     era: z.ZodOptional<z.ZodEnum<{
         editorial: "editorial";
         modern: "modern";
-        retro: "retro";
-        technical: "technical";
         organic: "organic";
+        technical: "technical";
+        retro: "retro";
     }>>;
 }, z.core.$strip>;
 export type StyleTone = (typeof STYLE_AXIS_VALUES.tone)[number];