@riverbankcms/sdk 0.102.0 → 0.104.0

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

@@ -1,9 +1,11 @@
 import { type CardStylesOverride, type ContainerStylesOverride, type SectionStylesOverride, type Theme } from '../schema';
 import { type ExpandedPalette } from '../palette/expandPalette';
 import { type ButtonPersonalityId } from '../buttons/personalities';
-import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
+import { type PaletteOverrides, type CuratedPaletteId } from '../palette/curated';
+import type { ResolvedPaletteSelection } from '../palette/resolveSelection';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
-import { type ContentFrameIntent, type EyebrowTreatment, type FlushFrameTreatment, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
+import { type ContentFrameIntent, 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';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type SectionPaddingX = 'normal' | 'none';
@@ -50,6 +52,20 @@ export type CompiledTransitionRuntime = Readonly<{
         to: string;
     }>;
 }>;
+export type CompiledBoundaryRuntime<TBlockId extends string = string> = Readonly<{
+    boundaryId: DesignBoundaryId | string;
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    treatment: SiteStyleSectionTransitionIntent;
+    metrics: SectionBoundaryRuntimeMetrics;
+    from: CompiledTransitionEndpoint;
+    to: CompiledTransitionEndpoint;
+    cssVars: Readonly<{
+        from: string;
+        to: string;
+    }>;
+    styleGroup: string;
+}>;
 export type HeroLayoutStylesOverride = Readonly<{
     contentAlignment?: 'left' | 'center' | 'right';
     verticalAlignment?: 'top' | 'center' | 'bottom';
@@ -91,6 +107,7 @@ export type CompiledPageRuntime<TBlockId extends string = string> = Readonly<{
     blocks: readonly (CompiledBlockRuntime & Readonly<{
         blockId: TBlockId;
     }>)[];
+    boundaries: readonly CompiledBoundaryRuntime<TBlockId>[];
 }>;
 export type SectionAdjacency = Readonly<{
     kind: 'next-section';
@@ -272,6 +289,15 @@ export declare function compileTransitionRuntime(input: Readonly<{
     from: CompiledTransitionEndpoint;
     to: CompiledTransitionEndpoint;
 }>): CompiledTransitionRuntime;
+export declare function compileBoundaryRuntime<TBlockId extends string>(input: Readonly<{
+    boundaryId: DesignBoundaryId | string;
+    previousBlockId: TBlockId;
+    nextBlockId: TBlockId;
+    treatment: SiteStyleSectionTransitionIntent;
+    fromSurface: SiteStyleSurfaceIntent;
+    toSurface: SiteStyleSurfaceIntent;
+    rules?: DesignRuntimeRules;
+}>): CompiledBoundaryRuntime<TBlockId> | null;
 /**
  * Compiles block runtime fields and writes them into content only when Theme V2
  * owns that block's runtime-style fields.
@@ -286,30 +312,35 @@ export declare function compilePageRuntimeFields<TBlockId extends string, TPurpo
     sectionSpacing?: SemanticSpacing;
     terminalSectionAdjacency?: TerminalSectionAdjacency;
 }>): CompiledPageRuntime<TBlockId>;
-export type CompileTokenRecipesOptions = Readonly<{
-    /** Resolved button personality ID. When provided, emits `theme.buttons`. */
-    buttonPersonalityId?: ButtonPersonalityId;
-    /**
-     * Resolved palette variant ID. When provided, replaces the recipe-based
-     * palette lookup; the recipe family is still consulted for the rest of the
-     * theme (typography, spacing, etc.).
-     */
-    paletteVariantId?: PaletteVariantId;
+type ResolvedPaletteCompileOptions = Readonly<{
+    /** A complete palette resolved from an explicit curated or site selection. */
+    resolvedPalette: ResolvedPaletteSelection;
+    paletteVariantId?: never;
+    paletteOverrides?: never;
+}>;
+type LegacyPaletteCompileOptions = Readonly<{
+    resolvedPalette?: undefined;
     /**
-     * Sparse per-token hex overrides applied on top of the palette variant.
-     * Tokens not in this map keep the variant's value.
+     * Legacy curated-palette selection retained while persisted Theme V2
+     * selections are migrated to the explicit palette-selection model.
      */
+    paletteVariantId?: CuratedPaletteId;
+    /** Legacy sparse overrides materialized into a site palette during migration. */
     paletteOverrides?: PaletteOverrides;
 }>;
+export type CompileTokenRecipesOptions = Readonly<{
+    /** Resolved button personality ID. When provided, emits `theme.buttons`. */
+    buttonPersonalityId?: ButtonPersonalityId;
+}> & (ResolvedPaletteCompileOptions | LegacyPaletteCompileOptions);
 /**
  * Compiles bounded token recipes to the current Theme schema. This is intentionally
  * pure and schema-validated so generated Theme V2 choices have a concrete legacy
  * Theme output before any persistence or Phase 5 integration consumes them.
  *
- * Optional `options` accept already-resolved button personality and palette
- * variant IDs (typically supplied by `compileSiteThemeFromSelections`). When
- * IDs are omitted, the function falls through to the legacy recipe-based
- * palette lookup and leaves `theme.buttons` as the mock-theme default.
+ * Optional `options` accept an already-resolved palette selection and button
+ * personality. During migration they also accept the legacy curated ID plus
+ * sparse overrides. When neither palette input is supplied, the function falls
+ * through to the recipe-based palette lookup.
  */
 export declare function compileTokenRecipes(recipes: ThemeTokenRecipes, options?: CompileTokenRecipesOptions): Theme;
 export {};

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

@@ -49,6 +49,83 @@ export type SectionTransitionFamily = Readonly<{
     label: string;
     variants: NonEmptyReadonlyArray<SectionTransitionVariant>;
 }>;
+export type SectionBoundaryRuntimeSize = 'compact' | 'medium' | 'large' | 'spacious' | 'expansive';
+export type SectionBoundaryRuntimeMetrics = Readonly<{
+    family: Exclude<SectionTransitionFamilyId, 'none'>;
+    size: SectionBoundaryRuntimeSize;
+    heightCss: string;
+    reserveCss: string;
+}>;
+export declare const sectionBoundaryRuntimeMetricsByTransition: {
+    readonly none: null;
+    readonly 'soft-fade-short': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'soft-fade-long': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'soft-fade-expansive': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'wave-edge': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'wave-edge-balanced': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'wave-edge-gentle': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'wave-edge-bold': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'wave-edge-drift': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'angle-edge': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'angle-edge-subtle': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+    readonly 'angle-edge-steep': Readonly<{
+        family: Exclude<SectionTransitionFamilyId, "none">;
+        size: SectionBoundaryRuntimeSize;
+        heightCss: string;
+        reserveCss: string;
+    }>;
+};
+export declare function boundaryRuntimeMetricsForTransition(transition: SiteStyleSectionTransitionIntent): SectionBoundaryRuntimeMetrics | null;
 export declare const noneBoundaryOption: {
     readonly id: BoundaryOptionId;
     readonly label: "None";

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

@@ -0,0 +1,45 @@
+import type { NavLinkStyle, NavLinkTextSize } from '../navigation/types';
+import type { Theme } from '../schema';
+export declare const headerNavTypographyPreferenceValues: readonly ["inherit", "body", "heading"];
+export type HeaderNavTypographyPreference = (typeof headerNavTypographyPreferenceValues)[number];
+export declare const headerNavFontSizePreferenceValues: readonly ["inherit", "sm", "base", "lg", "xl"];
+export type HeaderNavFontSizePreference = (typeof headerNavFontSizePreferenceValues)[number];
+export type HeaderNavPreferences = Readonly<{
+    typography: HeaderNavTypographyPreference;
+    fontSize: HeaderNavFontSizePreference;
+}>;
+export declare const headerNavTypographyOptions: readonly [{
+    readonly value: "inherit";
+    readonly label: "Default";
+}, {
+    readonly value: "body";
+    readonly label: "Body";
+}, {
+    readonly value: "heading";
+    readonly label: "Heading";
+}];
+export declare const headerNavFontSizeOptions: readonly [{
+    readonly value: "inherit";
+    readonly label: "Default";
+}, {
+    readonly value: "sm";
+    readonly label: "Small";
+}, {
+    readonly value: "base";
+    readonly label: "Regular";
+}, {
+    readonly value: "lg";
+    readonly label: "Large";
+}, {
+    readonly value: "xl";
+    readonly label: "Huge";
+}];
+export declare const defaultHeaderNavPreferences: {
+    readonly typography: "inherit";
+    readonly fontSize: "inherit";
+};
+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;
+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

@@ -12,9 +12,9 @@ export declare const STYLE_AXIS_VALUES: {
 };
 export declare const styleTagsSchema: z.ZodObject<{
     tone: z.ZodOptional<z.ZodEnum<{
-        classic: "classic";
         bold: "bold";
         minimal: "minimal";
+        classic: "classic";
     }>>;
     energy: z.ZodOptional<z.ZodEnum<{
         calm: "calm";

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

@@ -0,0 +1,21 @@
+import type { Theme } from '../schema';
+export type CanonicalThemeValue = null | boolean | number | string | readonly CanonicalThemeValue[] | Readonly<{
+    [key: string]: CanonicalThemeValue;
+}>;
+export type ThemeParityDifference = Readonly<{
+    kind: 'missing';
+    path: string;
+    before: CanonicalThemeValue;
+}> | Readonly<{
+    kind: 'extra';
+    path: string;
+    after: CanonicalThemeValue;
+}> | Readonly<{
+    kind: 'changed';
+    path: string;
+    before: CanonicalThemeValue;
+    after: CanonicalThemeValue;
+}>;
+export declare function canonicalizeThemeForParity(theme: Theme): CanonicalThemeValue;
+export declare function serializeThemeForParity(theme: Theme): string;
+export declare function diffThemesForParity(before: Theme, after: Theme): readonly ThemeParityDifference[];

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

@@ -18,8 +18,8 @@ export declare const themeTokenRecipesSchema: z.ZodObject<{
     }>;
     contrast: z.ZodEnum<{
         standard: "standard";
-        strong: "strong";
         maximum: "maximum";
+        strong: "strong";
     }>;
     radius: z.ZodEnum<{
         soft: "soft";

package/dist/_dts/theme-core/src/tokens/themeColorTokens.d.ts

@@ -10,13 +10,13 @@ export declare const paletteTokenNameSchema: z.ZodEnum<{
     surface: "surface";
     success: "success";
     text: "text";
-    accent: "accent";
-    primary: "primary";
-    secondary: "secondary";
     warning: "warning";
     background: "background";
+    accent: "accent";
     muted: "muted";
     border: "border";
+    primary: "primary";
+    secondary: "secondary";
     destructive: "destructive";
     surfaceAlt: "surfaceAlt";
     primaryForeground: "primaryForeground";

package/dist/_dts/ui/src/badge.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "success" | "secondary" | "outline" | "default" | "warning" | "destructive" | null | undefined;
+    variant?: "success" | "default" | "warning" | "outline" | "secondary" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/_dts/ui/src/button.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from 'class-variance-authority';
 import * as React from 'react';
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "secondary" | "outline" | "default" | "destructive" | "ghost" | "onDark" | "onDarkOutline" | "heroGlass" | null | undefined;
+    variant?: "link" | "default" | "outline" | "secondary" | "destructive" | "ghost" | "onDark" | "onDarkOutline" | "heroGlass" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

package/dist/_dts/ui/src/card.d.ts

@@ -4,7 +4,7 @@ import { surfaceVariants } from './surface';
 export type CardVariant = VariantProps<typeof surfaceVariants>['variant'];
 export type CardRadius = VariantProps<typeof surfaceVariants>['radius'];
 declare const cardLayoutVariants: (props?: ({
-    size?: "none" | "compact" | "default" | "responsive" | null | undefined;
+    size?: "default" | "none" | "compact" | "responsive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CardSize = VariantProps<typeof cardLayoutVariants>['size'];
 export type CardProps = React.ComponentProps<'div'> & {

package/dist/_dts/ui/src/palette/PaletteTokenEditor.d.ts

@@ -38,6 +38,7 @@ export type PaletteTokenEditorProps = Readonly<{
     feedbackRoles?: ReadonlyArray<PaletteRole>;
     surfaceRoles?: ReadonlyArray<PaletteRole>;
     showContrastChecks?: boolean;
+    disabled?: boolean;
     className?: string;
 }>;
 /**
@@ -47,4 +48,4 @@ export type PaletteTokenEditorProps = Readonly<{
  *   - LiveThemeEditor's palette tab (via a thin context wrapper)
  *   - Style configurator's brand-colours row
  */
-export declare function PaletteTokenEditor({ palette, onChange, hasInvalidValues, brandRoles, feedbackRoles, surfaceRoles, showContrastChecks, className, }: PaletteTokenEditorProps): import("react").JSX.Element;
+export declare function PaletteTokenEditor({ palette, onChange, hasInvalidValues, brandRoles, feedbackRoles, surfaceRoles, showContrastChecks, disabled, className, }: PaletteTokenEditorProps): import("react").JSX.Element;

package/dist/_dts/ui/src/toggle.d.ts

@@ -2,11 +2,11 @@ import * as React from "react";
 import * as TogglePrimitive from "@radix-ui/react-toggle";
 import { type VariantProps } from "class-variance-authority";
 declare const toggleVariants: (props?: ({
-    variant?: "outline" | "default" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "outline" | "default" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
 export { Toggle, toggleVariants };