@riverbankcms/sdk 0.101.0 → 0.103.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" | "accent" | "primary" | "secondary" | "background" | "muted" | "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" | "accent" | "primary" | "secondary" | "background" | "muted" | "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" | "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 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/contentTemplateRuntimeCompiler.d.ts

@@ -1,6 +1,6 @@
 import type { BlockDesignMetadata } from './blockFlow';
 import { type PageDesignEditorIssue } from './pageDesignEditorModel';
-import type { CompiledBlockRuntimeFields, SurfaceResolutionContext } from './runtimeCompiler';
+import type { CompiledBlockRuntimeFields, CompiledBoundaryRuntime, SurfaceResolutionContext } from './runtimeCompiler';
 import { type ContentTemplateBlockScope, type ContentTemplateDesignBlockId, type ContentTemplateDesignIntent } from './contentTemplateDesignIntent';
 import type { LayoutVariantKey } from './types';
 export type ContentTemplateRuntimeBlockInput = Readonly<{
@@ -17,6 +17,7 @@ export type CompiledContentTemplateRuntimeBlock = Readonly<{
 }>;
 export type CompiledContentTemplateRuntime = Readonly<{
     blocks: readonly CompiledContentTemplateRuntimeBlock[];
+    boundaries: readonly CompiledBoundaryRuntime<ContentTemplateDesignBlockId>[];
     fieldsByBlockId: ReadonlyMap<ContentTemplateDesignBlockId, CompiledBlockRuntimeFields>;
     issues: readonly PageDesignEditorIssue<ContentTemplateDesignBlockId>[];
 }>;

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

@@ -139,8 +139,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }, z.core.$strict>], "kind">;
     itemSurface: z.ZodEnum<{
         flat: "flat";
-        none: "none";
         default: "default";
+        none: "none";
         editorial: "editorial";
         raised: "raised";
         "color-blocked": "color-blocked";
@@ -183,9 +183,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }>>;
     heroTypographyScale: z.ZodOptional<z.ZodEnum<{
         display: "display";
-        poster: "poster";
         editorial: "editorial";
         quiet: "quiet";
+        poster: "poster";
     }>>;
     imageSurfaceTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"none">;
@@ -198,8 +198,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         }>;
         intensity: z.ZodOptional<z.ZodEnum<{
             soft: "soft";
-            strong: "strong";
             balanced: "balanced";
+            strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"brand-wash">;
@@ -210,29 +210,29 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         }>;
         intensity: z.ZodOptional<z.ZodEnum<{
             soft: "soft";
-            strong: "strong";
             balanced: "balanced";
+            strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"neutral-scrim">;
         intensity: z.ZodOptional<z.ZodEnum<{
             soft: "soft";
-            strong: "strong";
             balanced: "balanced";
+            strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"neutral-wash">;
         intensity: z.ZodOptional<z.ZodEnum<{
             soft: "soft";
-            strong: "strong";
             balanced: "balanced";
+            strong: "strong";
         }>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"solid-panel">;
         intensity: z.ZodOptional<z.ZodEnum<{
             soft: "soft";
-            strong: "strong";
             balanced: "balanced";
+            strong: "strong";
         }>>;
     }, z.core.$strict>], "kind">>;
     imageSurfaceMotion: z.ZodOptional<z.ZodEnum<{
@@ -240,8 +240,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         "fixed-frame": "fixed-frame";
     }>>;
     testimonialCardTreatment: z.ZodOptional<z.ZodEnum<{
-        "accent-quote": "accent-quote";
         default: "default";
+        "accent-quote": "accent-quote";
     }>>;
     tileTreatment: z.ZodOptional<z.ZodEnum<{
         default: "default";
@@ -254,8 +254,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }>>;
     eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
         accent: "accent";
-        plain: "plain";
         pill: "pill";
+        plain: "plain";
         "accent-pill": "accent-pill";
         "pill-bounce": "pill-bounce";
         "accent-pill-bounce": "accent-pill-bounce";
@@ -264,10 +264,10 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
 export declare const styleAuthoritySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"theme-v2">;
     source: z.ZodEnum<{
-        generated: "generated";
-        admin: "admin";
         user: "user";
+        admin: "admin";
         sdk: "sdk";
+        generated: "generated";
     }>;
     siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
     templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;
@@ -291,15 +291,16 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
         _sectionStyles: "_sectionStyles";
         _containerStyles: "_containerStyles";
         _cardStyles: "_cardStyles";
+        _transitionStyles: "_transitionStyles";
         styleGroup: "styleGroup";
-    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
+    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_transitionStyles" | "styleGroup")[]>>;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"theme-v2">;
         source: z.ZodEnum<{
-            generated: "generated";
-            admin: "admin";
             user: "user";
+            admin: "admin";
             sdk: "sdk";
+            generated: "generated";
         }>;
         siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
         templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;
@@ -356,8 +357,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }, z.core.$strict>], "kind">;
         itemSurface: z.ZodEnum<{
             flat: "flat";
-            none: "none";
             default: "default";
+            none: "none";
             editorial: "editorial";
             raised: "raised";
             "color-blocked": "color-blocked";
@@ -400,9 +401,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }>>;
         heroTypographyScale: z.ZodOptional<z.ZodEnum<{
             display: "display";
-            poster: "poster";
             editorial: "editorial";
             quiet: "quiet";
+            poster: "poster";
         }>>;
         imageSurfaceTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"none">;
@@ -415,8 +416,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             }>;
             intensity: z.ZodOptional<z.ZodEnum<{
                 soft: "soft";
-                strong: "strong";
                 balanced: "balanced";
+                strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"brand-wash">;
@@ -427,29 +428,29 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             }>;
             intensity: z.ZodOptional<z.ZodEnum<{
                 soft: "soft";
-                strong: "strong";
                 balanced: "balanced";
+                strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"neutral-scrim">;
             intensity: z.ZodOptional<z.ZodEnum<{
                 soft: "soft";
-                strong: "strong";
                 balanced: "balanced";
+                strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"neutral-wash">;
             intensity: z.ZodOptional<z.ZodEnum<{
                 soft: "soft";
-                strong: "strong";
                 balanced: "balanced";
+                strong: "strong";
             }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"solid-panel">;
             intensity: z.ZodOptional<z.ZodEnum<{
                 soft: "soft";
-                strong: "strong";
                 balanced: "balanced";
+                strong: "strong";
             }>>;
         }, z.core.$strict>], "kind">>;
         imageSurfaceMotion: z.ZodOptional<z.ZodEnum<{
@@ -457,8 +458,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             "fixed-frame": "fixed-frame";
         }>>;
         testimonialCardTreatment: z.ZodOptional<z.ZodEnum<{
-            "accent-quote": "accent-quote";
             default: "default";
+            "accent-quote": "accent-quote";
         }>>;
         tileTreatment: z.ZodOptional<z.ZodEnum<{
             default: "default";
@@ -471,8 +472,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }>>;
         eyebrowTreatment: z.ZodOptional<z.ZodEnum<{
             accent: "accent";
-            plain: "plain";
             pill: "pill";
+            plain: "plain";
             "accent-pill": "accent-pill";
             "pill-bounce": "pill-bounce";
             "accent-pill-bounce": "accent-pill-bounce";
@@ -486,15 +487,16 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             _sectionStyles: "_sectionStyles";
             _containerStyles: "_containerStyles";
             _cardStyles: "_cardStyles";
+            _transitionStyles: "_transitionStyles";
             styleGroup: "styleGroup";
-        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup")[]>>;
+        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_frameStyles" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_transitionStyles" | "styleGroup")[]>>;
         authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"theme-v2">;
             source: z.ZodEnum<{
-                generated: "generated";
-                admin: "admin";
                 user: "user";
+                admin: "admin";
                 sdk: "sdk";
+                generated: "generated";
             }>;
             siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
             templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;

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

@@ -82,8 +82,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         kind: z.ZodLiteral<"explicit">;
         value: z.ZodEnum<{
             flat: "flat";
-            none: "none";
             default: "default";
+            none: "none";
             editorial: "editorial";
             raised: "raised";
             "color-blocked": "color-blocked";
@@ -235,8 +235,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"explicit">;
                 value: z.ZodEnum<{
                     flat: "flat";
-                    none: "none";
                     default: "default";
+                    none: "none";
                     editorial: "editorial";
                     raised: "raised";
                     "color-blocked": "color-blocked";

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

@@ -281,12 +281,12 @@ export declare const headerStyleCatalog: readonly [{
     readonly moods: readonly ["calm", "professional", "editorial"];
 }, {
     readonly id: HeaderStyleId;
-    readonly label: "Fine Line";
-    readonly description: "Light surface with a crisp lower rule and underline hover.";
+    readonly label: "Seamless";
+    readonly description: "Borderless surface with underline hover for a quieter page transition.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
     readonly navInteraction: "underline-grow";
-    readonly surface: "bordered";
-    readonly defaultDepth: "line";
+    readonly surface: "neutral";
+    readonly defaultDepth: "none";
     readonly navTypography: "plain";
     readonly moods: readonly ["calm", "professional", "editorial"];
 }, {

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

@@ -28,6 +28,7 @@ export * from './resolver';
 export * from './runtimeCompiler';
 export * from './sectionTransitions';
 export * from './siteChromeBackgrounds';
+export * from './siteChromeNavPreferences';
 export * from './siteStyleThemeCompiler';
 export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';

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

@@ -6,7 +6,7 @@ import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type CompiledTypographySelection, type KnownTypographyPresetId, type TypographyPresetId, type TypographyPresetResolutionWarning, type TypographySelection } from './typographyPresets';
 import { type FooterLookId, type FooterSelectionContext, type FooterSelectionResult } from './footerLooks';
 import { type HeaderLayoutId, type HeaderSelectionContext, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
-import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
+import { type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';
 import { type CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
 export type { CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
@@ -23,7 +23,7 @@ export { buildPageDesignEditorReadModel, boundaryOptions, pageFlowPresets, type
 export { autoDesignChoice, reducePageDesignIntentForUserAction, resolvePageDesignBlockLookChoice, resolvePageDesignBoundaryChoice, userPinnedDesignChoice, type PageDesignChoice, type PageDesignIntent, type PageDesignUserAction, } from './pageDesignIntent';
 export { repairDesignIssue, resolveBlockDesignPlan } from './resolver';
 export { cycleableOptionsFromResolved, deriveDesignCustomizationScope, recommendedDesignOption, type CycleableDesignOption, type CycleableOptions, type DesignCustomizationAuthority, type DesignCustomizationScope, type DesignCustomizationSurface, type DesignCustomizationUnsupportedReason, type DesignOptionIssue, type ResolvedDesignOption, } from './previewCustomization';
-export { compileBlockRuntimeFields, compilePageRuntimeFields, compileTokenRecipes, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
+export { compileBlockRuntimeFields, compileBoundaryRuntime, compilePageRuntimeFields, compileTokenRecipes, compileTransitionRuntime, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
 export { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
 export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteVariantForSiteStyle, defaultTypographyPresetForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
 export { asTypographyPresetId, compileTypographySelection, evaluateTypographyFontSlot, findTypographyPreset, parsePersistedTypographyPresetId, typographyPresetIdValues, typographyPresets, type CompiledTypographySelection, type GoogleFontCategory, type KnownTypographyPresetId, type KnownTypographyPresetIdValue, type TypographyFontCapability, type TypographyFontSlot, type TypographyFontSlotFit, type TypographyFontSlotPolicy, type TypographyPreset, type TypographyPresetId, type TypographyPresetResolutionWarning, type TypographySelection, } from './typographyPresets';
@@ -121,8 +121,15 @@ export type CompileEditorModelRuntimeInput<TBlockId extends DesignBlockId = Desi
  */
 export declare function compileEditorModelRuntime<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): CompiledPageRuntime<TBlockId>;
 export declare function buildEditorModelRuntimeFieldsByBlockId<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): ReadonlyMap<TBlockId, CompiledBlockRuntimeFields>;
+export declare function buildEditorModelRuntimeBoundaries<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId>): readonly CompiledBoundaryRuntime<TBlockId>[];
 export declare function compileEditorModelRuntimeFieldsForBlock<TBlockId extends DesignBlockId>(input: CompileEditorModelRuntimeInput<TBlockId> & Readonly<{
     blockId: TBlockId;
 }>): CompiledBlockRuntimeFields | null;
 export declare function applyCompiledRuntimeFieldsToContent<TContent extends Record<string, unknown>>(content: TContent, fields: CompiledBlockRuntimeFields | null | undefined): Record<string, unknown>;
+export type RuntimeContentAdjacency = Readonly<{
+    currentContent: Record<string, unknown> | null | undefined;
+    nextContent: Record<string, unknown> | null | undefined;
+}>;
+export declare function retargetCompiledRuntimeFieldsForContentAdjacency(fields: CompiledBlockRuntimeFields | null | undefined, adjacency: RuntimeContentAdjacency): CompiledBlockRuntimeFields | null | undefined;
+export declare function retargetCompiledBoundaryRuntimeForContentAdjacency<TBlockId extends string>(boundary: CompiledBoundaryRuntime<TBlockId>, adjacency: RuntimeContentAdjacency): CompiledBoundaryRuntime<TBlockId>;
 export declare function restoreCompiledRuntimeFieldsFromContent<TCurrentContent extends Record<string, unknown>, TPreviousContent extends Record<string, unknown>>(currentContent: TCurrentContent, previousContent: TPreviousContent): Record<string, unknown>;

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

@@ -1,11 +1,11 @@
-export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup"];
+export declare const themeV2RuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup"];
 export type ThemeV2RuntimeStyleFieldName = typeof themeV2RuntimeStyleFieldNames[number];
 export declare const themeV2BlockSpecificRawStyleFieldNames: readonly ["_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export type ThemeV2BlockSpecificRawStyleFieldName = typeof themeV2BlockSpecificRawStyleFieldNames[number];
 export type ThemeV2NormalEditorRawStyleFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
 export type ThemeV2CompilerOwnedFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
-export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
-export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "_transitionStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare const pageDesignEditorBackgroundOverrideOwner: "page-design-editor";
 export type PageDesignEditorBackgroundOverrideOwner = typeof pageDesignEditorBackgroundOverrideOwner;
 export declare const siteChromeBackgroundOverrideOwner: "site-chrome-editor";

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

@@ -3,7 +3,9 @@ import { type ExpandedPalette } from '../palette/expandPalette';
 import { type ButtonPersonalityId } from '../buttons/personalities';
 import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
 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';
 type SectionForegroundRuntimeTokens = Pick<NonNullable<SectionSurfaceRuntimeRule['background']>, 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor'>;
@@ -29,16 +31,47 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _contentCardStyles?: ContainerStylesOverride;
     _heroLayoutStyles?: HeroLayoutStylesOverride;
     _cardStyles?: CardStylesOverride;
+    _transitionStyles?: CompiledTransitionRuntime;
     blockLook?: string;
     styleGroup?: string;
 }>;
+export type CompiledTransitionEndpoint = Readonly<{
+    kind: 'surface';
+    surface: SiteStyleSurfaceIntent;
+}> | Readonly<{
+    kind: 'color-token';
+    token: ThemeColorToken;
+}>;
+export type CompiledTransitionRuntime = Readonly<{
+    treatment: SiteStyleSectionTransitionIntent;
+    from: CompiledTransitionEndpoint;
+    to: CompiledTransitionEndpoint;
+    cssVars: Readonly<{
+        from: string;
+        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';
     contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
     typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "blockLook", "styleGroup"];
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "_transitionStyles", "blockLook", "styleGroup"];
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;
@@ -73,6 +106,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';
@@ -249,6 +283,20 @@ export declare const defaultComponentRuntimeRules: {
 export declare function compileBlockRuntimeFields<TBlockId extends string, TPurpose extends string>(input: CompileBlockRuntimeInput<TBlockId, TPurpose>): CompiledBlockRuntime & Readonly<{
     blockId: TBlockId;
 }>;
+export declare function compileTransitionRuntime(input: Readonly<{
+    treatment: SiteStyleSectionTransitionIntent;
+    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.

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,44 @@
+import type { NavLinkStyle } 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", "xs", "sm", "base", "lg"];
+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: "xs";
+    readonly label: "Tiny";
+}, {
+    readonly value: "sm";
+    readonly label: "Small";
+}, {
+    readonly value: "base";
+    readonly label: "Regular";
+}, {
+    readonly value: "lg";
+    readonly label: "Large";
+}];
+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;

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