@riverbankcms/sdk 0.102.0 → 0.104.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/curatedSiteStyles.d.ts

@@ -1,5 +1,5 @@
 import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
-import { type KnownPaletteVariantId, type PaletteVariantId } from '../palette/variants';
+import { type KnownCuratedPaletteId, type CuratedPaletteId } from '../palette/curated';
 import type { Theme } from '../schema';
 import { type HeaderLayoutId, type HeaderLayoutIdValue, type HeaderLookId, type HeaderStyleId } from './headerLooks';
 import { type FooterLookId } from './footerLooks';
@@ -23,7 +23,7 @@ type CuratedSiteStyleCardOverrides = NonNullable<Theme['cards']>;
 type CuratedSiteStyleTestimonialQuoteOverrides = NonNullable<Theme['testimonialQuote']>;
 /**
  * Site-style-specific Theme overrides are applied after token recipes,
- * button personality, and palette variant selection have compiled the base
+ * button personality, and curated palette selection have compiled the base
  * Theme. Values here intentionally win; palette and button selections remain
  * independent Style configurator choices.
  */
@@ -50,7 +50,7 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
     testimonialQuote?: CuratedSiteStyleTestimonialQuoteOverrides;
 }>;
 export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
-export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
+export type CuratedPaletteRecommendation = CuratedChoice<KnownCuratedPaletteId>;
 export type HeaderLayoutChoice = CuratedChoice<HeaderLayoutId>;
 export type HeaderStyleChoice = CuratedChoice<HeaderStyleId>;
 export type HeaderLayoutStyleChoice = Readonly<{
@@ -113,12 +113,12 @@ export type CuratedSiteStyle = Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>;
 export declare function defaultButtonPersonalityForSiteStyle(siteStyle: CuratedSiteStyle): ButtonPersonalityId;
-export declare function defaultPaletteVariantForSiteStyle(siteStyle: CuratedSiteStyle): PaletteVariantId;
+export declare function defaultPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CuratedPaletteId;
 export declare function defaultTypographyPresetForSiteStyle(siteStyle: CuratedSiteStyle): TypographyPresetId;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
@@ -157,7 +157,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -192,7 +192,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -227,7 +227,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -262,7 +262,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -297,7 +297,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -332,7 +332,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -367,7 +367,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -402,7 +402,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -437,7 +437,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -472,7 +472,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -507,7 +507,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -542,7 +542,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -577,7 +577,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -612,7 +612,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -647,7 +647,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>, Readonly<{
@@ -682,7 +682,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>];
@@ -718,7 +718,7 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
-    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+    paletteRecommendations: NonEmptyReadonlyArray<CuratedPaletteRecommendation>;
     typographyPresetChoices: NonEmptyReadonlyArray<TypographyPresetChoice>;
     defaultTypographyPresetId: KnownTypographyPresetId;
 }>>;

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>>;
@@ -297,10 +297,10 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
     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>>;
@@ -357,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";
@@ -401,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">;
@@ -416,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">;
@@ -428,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<{
@@ -458,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";
@@ -472,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";
@@ -493,10 +493,10 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         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/index.d.ts

@@ -28,10 +28,12 @@ export * from './resolver';
 export * from './runtimeCompiler';
 export * from './sectionTransitions';
 export * from './siteChromeBackgrounds';
+export * from './siteChromeNavPreferences';
 export * from './siteStyleThemeCompiler';
 export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';
 export * from './styleTags';
 export * from './tokenRecipes';
 export * from './typographyPresets';
+export * from './themeParity';
 export * from './types';

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

@@ -1,12 +1,13 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import { type Theme } from '../schema';
 import { type ButtonPersonalityId } from '../buttons/personalities';
-import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
+import { type PaletteOverrides, type CuratedPaletteId } from '../palette/curated';
+import type { PaletteSelection, ResolvedPaletteSelection } from '../palette';
 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,9 +24,9 @@ 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, compileTransitionRuntime, 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 { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteForSiteStyle, 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';
 export { asDesignBlockId, asSiteStyleId, makeBoundaryId, type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type ResolvedPageDesignPlan, type SiteStyleId, } from './types';
 export declare const previewCustomizePurpose: "preview-customize";
@@ -43,13 +44,11 @@ export type SelectionFallbackWarning = Readonly<{
 }> | Readonly<{
     kind: 'rejected-palette';
     requested: string;
-    fellBackTo: PaletteVariantId;
+    fellBackTo: CuratedPaletteId;
 }> | TypographyPresetResolutionWarning;
-export type SiteThemeSelectionsInput = Readonly<{
+type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     buttonPersonalityId: ButtonPersonalityId | null;
-    paletteVariantId: PaletteVariantId | null;
-    paletteOverrides: PaletteOverrides | null;
     typographyPresetId?: TypographyPresetId | null;
     typographyBodyFontOverride?: string | null;
     typographyHeadingFontOverride?: string | null;
@@ -61,6 +60,17 @@ export type SiteThemeSelectionsInput = Readonly<{
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
+export type LegacySiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
+    resolvedPalette?: undefined;
+    paletteVariantId: CuratedPaletteId | null;
+    paletteOverrides: PaletteOverrides | null;
+}>;
+export type ExplicitPaletteSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
+    resolvedPalette: ResolvedPaletteSelection;
+    paletteVariantId?: never;
+    paletteOverrides?: never;
+}>;
+export type SiteThemeSelectionsInput = LegacySiteThemeSelectionsInput | ExplicitPaletteSiteThemeSelectionsInput;
 export type SiteThemeSelectionsResult = Readonly<{
     theme: CuratedSiteStyleTheme;
     requestedSelections: Readonly<{
@@ -71,7 +81,11 @@ export type SiteThemeSelectionsResult = Readonly<{
     }>;
     resolvedSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
-        paletteVariantId: PaletteVariantId;
+        paletteVariantId: CuratedPaletteId;
+        paletteSelection: Readonly<{
+            kind: 'curated';
+            paletteId: CuratedPaletteId;
+        }>;
         typographySelection: CompiledTypographySelection['resolvedSelection'];
         typographyPresetId: KnownTypographyPresetId | null;
         typographyBodyFontOverride: string | null;
@@ -85,10 +99,16 @@ export type SiteThemeSelectionsResult = Readonly<{
     footerSelection: FooterSelectionResult;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
+export type ExplicitPaletteSiteThemeSelectionsResult = Omit<SiteThemeSelectionsResult, 'resolvedSelections'> & Readonly<{
+    resolvedSelections: Omit<SiteThemeSelectionsResult['resolvedSelections'], 'paletteVariantId' | 'paletteSelection'> & Readonly<{
+        paletteVariantId: CuratedPaletteId | null;
+        paletteSelection: PaletteSelection;
+    }>;
+}>;
 /**
  * High-level, site-style-aware compiler. Resolves the user's personality and
  * palette selections into theme tokens. Button personality still resolves
- * against the site style's authored choice list; palette variants are brand
+ * against the site style's authored choice list; curated palettes are brand
  * choices, so any known palette is preserved across site styles and the style's
  * first palette choice is only used when the request is absent or unknown.
  *
@@ -96,7 +116,9 @@ export type SiteThemeSelectionsResult = Readonly<{
  * any fallback warnings the UI can surface as "we changed your selection"
  * notices.
  */
-export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult;
+export declare function compileSiteThemeFromSelections(input: LegacySiteThemeSelectionsInput): SiteThemeSelectionsResult;
+export declare function compileSiteThemeFromSelections(input: ExplicitPaletteSiteThemeSelectionsInput): ExplicitPaletteSiteThemeSelectionsResult;
+export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult | ExplicitPaletteSiteThemeSelectionsResult;
 export declare function siteStyleIdFromTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined): SiteStyleId | null;
 export type EditorModelRuntimeLookOverride<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     kind: 'pinned';
@@ -121,6 +143,7 @@ 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;
@@ -130,4 +153,5 @@ export type RuntimeContentAdjacency = Readonly<{
     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>;