@riverbankcms/sdk 0.64.0 → 0.68.0

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

@@ -14,7 +14,7 @@ export { ThemeScopeCore, type ThemeScopeCoreProps } from "./ThemeScopeCore";
 export { type ThemeDataAttrs } from "./themeScopeUtils";
 export { getStandaloneHeaderShellClassName, planSiteTopShell, renderSiteTopChrome, type SiteChromeLayoutNodes, type SiteTopShellPlan, type SiteTopShellBehavior, } from "./siteChrome";
 export { buildThemeRuntime } from "./runtime/buildThemeRuntime";
-export { buildThemeRuntimeFromBridge, type ThemeBridgeConfigMinimal, } from "./runtime/buildThemeRuntimeFromBridge";
+export { buildThemeBridgeRuntime, buildThemeRuntimeFromBridge, THEME_BRIDGE_SCOPE_ID, type ThemeBridgeRuntime, type ThemeBridgeConfigMinimal, } from "./runtime/buildThemeRuntimeFromBridge";
 export type { CornerStyle, ShadowSize, TextTransform, FontWeight, HoverTransform, HoverColor, GradientStyle, GradientSharpness, GradientDirection, ButtonVariant, ButtonSystem, } from "./buttons/types";
 export { mockThemes } from "./mock-themes/all";
 export { modernMinimalTheme } from "./mock-themes/modern-minimal";

package/dist/_dts/theme-core/src/palette/utils/index.d.ts

@@ -6,3 +6,4 @@ export * from './suggestRecipes';
 export * from './generatePalette';
 export * from './textColor';
 export * from './legibility';
+export * from './onColor';

package/dist/_dts/theme-core/src/palette/utils/onColor.d.ts

@@ -0,0 +1,2 @@
+export declare function onColorTokenName(backgroundToken: string): string;
+export declare function isOnColorBackgroundCandidateToken(token: string): boolean;

package/dist/_dts/theme-core/src/runtime/buildThemeRuntimeFromBridge.d.ts

@@ -1,15 +1,16 @@
 /**
  * Build Theme Runtime from ThemeBridge Config
  *
- * Converts a ThemeBridgeConfig (used by SDK sites) to ThemeCssVars
- * matching the canonical variable names used by the full theme system.
- * This enables ThemeBridgeProvider to use ThemeScopeCore for rendering.
+ * Converts the SDK ThemeBridge config into the same runtime buckets consumed by
+ * ThemeScopeCore. The bridge deliberately keeps component skins opt-in while
+ * always emitting the structural CSS contract system blocks rely on.
  */
 import type { ThemeCssVars } from './buildThemeRuntime';
+export declare const THEME_BRIDGE_SCOPE_ID = "sdk";
 /**
- * ThemeBridgeConfig definition (subset needed for CSS var generation).
- * Full type is in @riverbankcms/sdk, but we define minimal interface here
- * to avoid circular dependency.
+ * ThemeBridgeConfig definition (subset needed for runtime generation).
+ * Full type is in @riverbankcms/sdk, but we define the compatible shape here
+ * to avoid a package cycle.
  */
 export interface ThemeBridgeConfigMinimal {
     tokens: Record<string, string>;
@@ -22,23 +23,29 @@ export interface ThemeBridgeConfigMinimal {
     spacing?: 'comfortable' | 'standard' | 'dense';
     corners?: 'square' | 'soft' | 'rounded' | 'pill';
     shadows?: 'none' | 'low' | 'medium' | 'high';
+    components?: {
+        buttons?: boolean | {
+            variants?: Array<'primary' | 'secondary' | 'outline' | 'ghost'>;
+        };
+        cards?: boolean | {
+            variants?: Array<'default' | 'elevated' | 'outlined'>;
+        };
+        inputs?: boolean;
+    };
+    overrides?: Record<string, string>;
 }
-/**
- * Normalize token value to CSS-ready format.
- * - Hex colors are converted to RGB channels
- * - CSS variable references are passed through
- * - Already-formatted RGB values are passed through
- */
+export type ThemeBridgeRuntime = Readonly<{
+    themeId: typeof THEME_BRIDGE_SCOPE_ID;
+    cssVars: ThemeCssVars;
+    buttonCss?: string;
+    cardCss?: string;
+    inputCss?: string;
+    statusCss: string;
+    progressCss: string;
+    blockVarsCss: string;
+    customCss?: string;
+}>;
+export declare const BRIDGE_DEFAULT_TOKENS: Readonly<Record<string, string>>;
 export declare function normalizeTokenValue(value: string): string;
-/**
- * Build ThemeCssVars from a ThemeBridgeConfig.
- *
- * Produces CSS variables matching the canonical names used by buildThemeCssVars:
- * - Color tokens: `--tb-{name}` (e.g., --tb-primary, --tb-background)
- * - Typography: `--font-heading`, `--font-body`, etc.
- * - Font sizes: `--fs-h1`, `--fs-body`, etc.
- * - Spacing: `--space-mult`, `--rt-space-y`
- * - Shadows: `--shadow-elev`
- * - Motion: `--motion-duration`, `--motion-ease`
- */
 export declare function buildThemeRuntimeFromBridge(config: ThemeBridgeConfigMinimal): ThemeCssVars;
+export declare function buildThemeBridgeRuntime(config: ThemeBridgeConfigMinimal): ThemeBridgeRuntime;

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

@@ -0,0 +1,83 @@
+import type { ExpandedPalette } from '../palette/expandPalette';
+import type { SiteStyleSurfaceIntent } from './types';
+export type AccessibleColorSurfaceIntent = Exclude<SiteStyleSurfaceIntent, 'hero-image'>;
+export type ContrastPolicy = 'body-aa' | 'large-text-aa' | 'decorative';
+export type ForegroundRole = 'heading' | 'text' | 'supporting';
+export type AccessibleSurfaceToken = string & {
+    readonly __brand: 'AccessibleSurfaceToken';
+};
+export type ForegroundFallbackReason = 'supporting-token-unsafe';
+export type ResolvedForeground = Readonly<{
+    kind: 'safe-token';
+    role: ForegroundRole;
+    token: AccessibleSurfaceToken;
+    hex: string;
+    contrastRatio: number;
+}> | Readonly<{
+    kind: 'fallback-to-text';
+    role: Extract<ForegroundRole, 'supporting'>;
+    token: AccessibleSurfaceToken;
+    hex: string;
+    contrastRatio: number;
+    reason: ForegroundFallbackReason;
+}>;
+export type RejectedBackgroundCandidate = Readonly<{
+    kind: 'background-candidate';
+    token: string;
+    reason: 'missing-token';
+}>;
+export type RejectedForegroundCandidate = Readonly<{
+    kind: 'foreground-candidate';
+    role: ForegroundRole;
+    token: string;
+}> & (Readonly<{
+    reason: 'missing-token';
+}> | Readonly<{
+    reason: 'contrast-too-low';
+    contrastRatio: number;
+}>);
+export type RejectedSurfaceCandidate = RejectedBackgroundCandidate | RejectedForegroundCandidate;
+export type ResolvedAccessibleSurface = Readonly<{
+    kind: 'resolved-accessible-surface';
+    surface: AccessibleColorSurfaceIntent;
+    background: Readonly<{
+        token: AccessibleSurfaceToken;
+        hex: string;
+        inherited: boolean;
+    }>;
+    heading: Extract<ResolvedForeground, {
+        kind: 'safe-token';
+    }>;
+    text: Extract<ResolvedForeground, {
+        kind: 'safe-token';
+    }>;
+    supporting: ResolvedForeground;
+    rejectedCandidates: readonly RejectedSurfaceCandidate[];
+}>;
+export type AccessibleSurfaceResolutionFailure = Readonly<{
+    kind: 'accessible-surface-resolution-failure';
+    surface: AccessibleColorSurfaceIntent;
+    reason: 'no-background-candidate' | 'no-safe-foreground-candidate';
+    rejectedCandidates: readonly RejectedSurfaceCandidate[];
+}>;
+export declare const contrastThresholdByPolicy: {
+    readonly 'body-aa': 4.5;
+    readonly 'large-text-aa': 3;
+    readonly decorative: 1;
+};
+export declare function toAccessibleColorSurfaceIntent(surface: SiteStyleSurfaceIntent): AccessibleColorSurfaceIntent | null;
+export declare function resolveAccessibleSurface(input: Readonly<{
+    surface: AccessibleColorSurfaceIntent;
+    palette: ExpandedPalette;
+    policy?: ContrastPolicy;
+}>): ResolvedAccessibleSurface | AccessibleSurfaceResolutionFailure;
+export declare function resolveAccessibleSurfaceOrTerminalFallback(input: Readonly<{
+    surface: AccessibleColorSurfaceIntent;
+    palette: ExpandedPalette;
+    policy?: ContrastPolicy;
+}>): ResolvedAccessibleSurface;
+export declare function requireResolvedAccessibleSurface(input: Readonly<{
+    surface: AccessibleColorSurfaceIntent;
+    palette: ExpandedPalette;
+    policy?: ContrastPolicy;
+}>): ResolvedAccessibleSurface;

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 } from './runtimeCompiler';
+import type { CompiledBlockRuntimeFields, SurfaceResolutionContext } from './runtimeCompiler';
 import { type ContentTemplateBlockScope, type ContentTemplateDesignBlockId, type ContentTemplateDesignIntent } from './contentTemplateDesignIntent';
 import type { LayoutVariantKey } from './types';
 export type ContentTemplateRuntimeBlockInput = Readonly<{
@@ -23,4 +23,5 @@ export type CompiledContentTemplateRuntime = Readonly<{
 export declare function compileContentTemplateRuntimeFields(input: Readonly<{
     intent: ContentTemplateDesignIntent;
     blocks: readonly ContentTemplateRuntimeBlockInput[];
+    surfaceResolutionContext: SurfaceResolutionContext;
 }>): CompiledContentTemplateRuntime;

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

@@ -5,7 +5,7 @@ import { type HeaderLookId } from './headerLooks';
 import { type FooterLookId } from './footerLooks';
 import { type CuratedChoice } from './curatedChoices';
 import { type AppearancePresetId, type DesignSystemTemplate, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
-export declare const curatedSiteStyleIdValues: readonly ["site-style:calm-studio", "site-style:clear-professional", "site-style:warm-editorial", "site-style:bright-community", "site-style:quiet-luxury", "site-style:practical-services", "site-style:modern-wellness", "site-style:bold-launch", "site-style:south-west-twerk-school"];
+export declare const curatedSiteStyleIdValues: readonly ["site-style:calm-studio", "site-style:clear-professional", "site-style:warm-editorial", "site-style:bright-community", "site-style:quiet-luxury", "site-style:practical-services", "site-style:quiet-practice", "site-style:personal-retreat-journal", "site-style:tactile-workshop", "site-style:modern-wellness", "site-style:bold-launch", "site-style:south-west-twerk-school"];
 export type CuratedSiteStyleIdValue = typeof curatedSiteStyleIdValues[number];
 type CuratedSiteStyleHeroOverrides = Readonly<{
     typography?: NonNullable<NonNullable<Theme['hero']>['typography']>;
@@ -32,12 +32,31 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
 }>;
 export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
 export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
+export type CuratedSiteStyleSelectionKeywordRule = Readonly<{
+    kind: 'phrase';
+    value: string;
+}> | Readonly<{
+    kind: 'word';
+    value: string;
+}> | Readonly<{
+    kind: 'substring';
+    value: string;
+}>;
+export type CuratedSiteStyleCreatorSelection = Readonly<{
+    kind: 'site_creator_keyword_heuristic';
+    priority: number;
+}> | Readonly<{
+    kind: 'primary_goal_support';
+}> | Readonly<{
+    kind: 'explicit_only';
+}>;
 export type CuratedSiteStyle = Readonly<{
     id: SiteStyleId;
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -60,7 +79,56 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
+    template: DesignSystemTemplate;
+    themeOverrides?: CuratedSiteStyleThemeOverrides;
+    recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+}>, Readonly<{
+    id: SiteStyleId;
+    name: string;
+    description: string;
+    generationBrief: string;
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
+    template: DesignSystemTemplate;
+    themeOverrides?: CuratedSiteStyleThemeOverrides;
+    recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+}>, Readonly<{
+    id: SiteStyleId;
+    name: string;
+    description: string;
+    generationBrief: string;
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
+    template: DesignSystemTemplate;
+    themeOverrides?: CuratedSiteStyleThemeOverrides;
+    recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
+}>, Readonly<{
+    id: SiteStyleId;
+    name: string;
+    description: string;
+    generationBrief: string;
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -75,7 +143,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -90,7 +159,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -105,7 +175,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -120,7 +191,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -135,7 +207,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -150,7 +223,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -165,7 +239,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -180,7 +255,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
@@ -196,7 +272,8 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     name: string;
     description: string;
     generationBrief: string;
-    selectionKeywords: readonly string[];
+    selectionKeywordRules: readonly CuratedSiteStyleSelectionKeywordRule[];
+    siteCreatorSelection: CuratedSiteStyleCreatorSelection;
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];

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

@@ -24,10 +24,13 @@ export declare const generatedSiteStyleIdSchema: z.ZodPipe<z.ZodEnum<{
     "site-style:bright-community": "site-style:bright-community";
     "site-style:quiet-luxury": "site-style:quiet-luxury";
     "site-style:practical-services": "site-style:practical-services";
+    "site-style:quiet-practice": "site-style:quiet-practice";
+    "site-style:personal-retreat-journal": "site-style:personal-retreat-journal";
+    "site-style:tactile-workshop": "site-style:tactile-workshop";
     "site-style:modern-wellness": "site-style:modern-wellness";
     "site-style:bold-launch": "site-style:bold-launch";
     "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-}>, z.ZodTransform<SiteStyleId, "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+}>, z.ZodTransform<SiteStyleId, "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
 export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
     sectionSurface: z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"generated">;
@@ -163,10 +166,13 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
         "site-style:bright-community": "site-style:bright-community";
         "site-style:quiet-luxury": "site-style:quiet-luxury";
         "site-style:practical-services": "site-style:practical-services";
+        "site-style:quiet-practice": "site-style:quiet-practice";
+        "site-style:personal-retreat-journal": "site-style:personal-retreat-journal";
+        "site-style:tactile-workshop": "site-style:tactile-workshop";
         "site-style:modern-wellness": "site-style:modern-wellness";
         "site-style:bold-launch": "site-style:bold-launch";
         "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-    }>, z.ZodTransform<SiteStyleId, "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+    }>, z.ZodTransform<SiteStyleId, "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         blockKind: z.ZodString;

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

@@ -1,3 +1,4 @@
+export * from './accessibleSurfaces';
 export * from './appearancePresets';
 export * from './blockFlow';
 export * from './compositionBudget';

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

@@ -5,7 +5,7 @@ import { type PaletteOverrides, type PaletteVariantId } from '../palette/variant
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId, type FooterSelectionContext, type FooterSelectionResult } from './footerLooks';
 import { type HeaderSelectionContext, type HeaderLookId, type HeaderSelectionResult } from './headerLooks';
-import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing } from './runtimeCompiler';
+import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import type { AppearancePresetId, DesignBlockId, SiteStyleId } from './types';
 /**
  * Browser-safe public API for Theme V2 live preview compilation.
@@ -20,7 +20,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, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, } from './runtimeCompiler';
+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 { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
 export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteVariantForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
 export { asDesignBlockId, asSiteStyleId, makeBoundaryId, type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type ResolvedPageDesignPlan, type SiteStyleId, } from './types';
@@ -98,6 +98,7 @@ export type EditorModelRuntimeLookOverride<TBlockId extends DesignBlockId = Desi
 }>;
 export type CompileEditorModelRuntimeInput<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     editorModel: PageDesignEditorReadModel<TBlockId>;
+    surfaceResolutionContext: SurfaceResolutionContext;
     lookOverrides?: readonly EditorModelRuntimeLookOverride<TBlockId>[];
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;

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

@@ -1,4 +1,5 @@
 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 RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
@@ -33,8 +34,15 @@ export type CompiledBlockRuntime = Readonly<{
     sectionPaddingX: SectionPaddingX;
     fields: CompiledBlockRuntimeFields;
 }>;
+export type SurfaceResolutionContext = Readonly<{
+    kind: 'concrete-palette';
+    palette: ExpandedPalette;
+}>;
+export declare function surfaceResolutionContextFromPalette(palette: ExpandedPalette): SurfaceResolutionContext;
+export declare function surfaceResolutionContextFromTheme(theme: Pick<Theme, 'palette'>): SurfaceResolutionContext;
 export type CompileBlockRuntimeInput<TBlockId extends string, TPurpose extends string> = Readonly<{
     block: ResolvedBlockDesignPlan<TBlockId, TPurpose>;
+    surfaceResolutionContext: SurfaceResolutionContext;
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
@@ -62,24 +70,18 @@ export declare const defaultDesignRuntimeRules: {
             readonly background: {
                 readonly type: "color";
                 readonly color: "muted";
-                readonly textColor: "text";
-                readonly headingColor: "text";
             };
         };
         readonly 'accent-band': {
             readonly background: {
                 readonly type: "color";
                 readonly color: "primary";
-                readonly textColor: "primaryForeground";
-                readonly headingColor: "primaryForeground";
             };
         };
         readonly 'brand-depth-band': {
             readonly background: {
                 readonly type: "color";
                 readonly color: "primary-800";
-                readonly textColor: "primaryForeground";
-                readonly headingColor: "primaryForeground";
             };
         };
         readonly 'hero-image': {
@@ -212,6 +214,7 @@ export declare function compileBlockRuntimeFieldsIntoContent<TBlockId extends st
 /** Compiles a resolved page plan into legacy runtime fields for each resolved block. */
 export declare function compilePageRuntimeFields<TBlockId extends string, TPurpose extends string>(input: Readonly<{
     resolved: ResolvedPageDesignPlan<TBlockId, TPurpose>;
+    surfaceResolutionContext: SurfaceResolutionContext;
     designRules?: DesignRuntimeRules;
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;

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

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const calloutVariants: (props?: ({
-    tone?: "success" | "default" | "warning" | "danger" | "info" | null | undefined;
+    tone?: "success" | "default" | "warning" | "info" | "danger" | null | undefined;
     layout?: "inline" | "banner" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CalloutProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof calloutVariants> & {