@riverbankcms/sdk 0.107.0 → 0.108.0

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/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;