@riverbankcms/sdk 0.62.4 → 0.67.0

package/dist/_dts/site-commands/src/planner.d.ts

@@ -0,0 +1,58 @@
+import { type Result } from '@riverbankcms/core';
+import { type SiteCommand, type SiteCommandBatch, type SiteCommandOf, type SiteCommandType } from './commands';
+import { type CommandRisk, type LifecycleIntent, type SiteCommandCapabilityGap, type SiteCommandIdempotencyKey, type SiteCommandMetadata, type SiteCommandValidationError } from './domain';
+import { type ResourceRef } from './refs';
+type PlannedSiteCommandCommon = Readonly<{
+    metadata: SiteCommandMetadata;
+    lifecycleIntent: LifecycleIntent;
+    provides: readonly ResourceRef[];
+    requires: readonly ResourceRef[];
+    idempotencyKey: SiteCommandIdempotencyKey;
+}>;
+export type PlannedSiteCommandFor<TType extends SiteCommandType> = PlannedSiteCommandCommon & Readonly<{
+    command: SiteCommandOf<TType>;
+}>;
+export type PlannedSiteCommand = PlannedSiteCommandFor<SiteCommandType>;
+export type SiteCommandPlan = Readonly<{
+    batch: SiteCommandBatch;
+    commands: readonly PlannedSiteCommand[];
+    capabilityGaps: readonly SiteCommandCapabilityGap[];
+}>;
+export type PlannedSiteCommandOf<TType extends SiteCommandType> = {
+    [TCommandType in TType]: PlannedSiteCommandFor<TCommandType>;
+}[TType];
+export type SiteCommandPlanFor<TType extends SiteCommandType> = Omit<SiteCommandPlan, 'commands'> & Readonly<{
+    commands: readonly PlannedSiteCommandOf<TType>[];
+}>;
+export type PlannedSiteCommandDispatcher<TResult> = <TType extends SiteCommandType>(plannedCommand: PlannedSiteCommandFor<TType>) => TResult;
+export type SiteCommandMatcher<TResult> = <TType extends SiteCommandType>(command: SiteCommandOf<TType>) => TResult;
+export declare function parseCommandBatch(input: unknown): Result<SiteCommandBatch, readonly SiteCommandValidationError[]>;
+export declare function planCommandBatch(batch: SiteCommandBatch): Result<SiteCommandPlan, readonly SiteCommandValidationError[]>;
+export declare function matchSiteCommand<TResult>(command: SiteCommand, match: SiteCommandMatcher<TResult>): TResult;
+export declare function dispatchPlannedSiteCommand<TResult>(plannedCommand: PlannedSiteCommand, dispatch: PlannedSiteCommandDispatcher<TResult>): TResult;
+export declare function matchPlannedSiteCommand<TResult>(plannedCommand: PlannedSiteCommand, match: PlannedSiteCommandDispatcher<TResult>): TResult;
+export declare function parseAndPlanCommandBatch(input: unknown): Result<SiteCommandPlan, readonly SiteCommandValidationError[]>;
+export declare function parseAndPlanCommandBatchForTypes<TType extends SiteCommandType>(input: unknown, allowedTypes: readonly TType[]): Result<SiteCommandPlanFor<TType>, readonly SiteCommandValidationError[]>;
+export declare function narrowSiteCommandPlan<TType extends SiteCommandType>(plan: SiteCommandPlan, allowedTypes: readonly TType[]): Result<SiteCommandPlanFor<TType>, readonly SiteCommandValidationError[]>;
+export declare function deriveIdempotencyKey(input: Readonly<{
+    batch: Pick<SiteCommandBatch, 'batchRef' | 'target'>;
+    command: Pick<SiteCommand, 'type' | 'ref'>;
+    metadata: Pick<SiteCommandMetadata, 'idempotencyStrategy'>;
+}>): SiteCommandIdempotencyKey;
+export type DryRunReport = Readonly<{
+    status: 'dry_run_passed' | 'dry_run_passed_with_gaps';
+    commandCount: number;
+    mutationCount: number;
+    publishCount: number;
+    unpublishCount: number;
+    seedCount: number;
+    riskSummary: Readonly<Record<CommandRisk, number>>;
+    executionOrder: readonly Readonly<{
+        ref: string;
+        type: SiteCommandType;
+    }>[];
+    resolvedRefs: readonly ResourceRef[];
+    capabilityGaps: readonly SiteCommandCapabilityGap[];
+}>;
+export declare function createDryRunReport<TType extends SiteCommandType>(plan: SiteCommandPlan | SiteCommandPlanFor<TType>): DryRunReport;
+export {};

package/dist/_dts/site-commands/src/refContributions.d.ts

@@ -0,0 +1,10 @@
+import type { SiteCommand } from './commands';
+export type RefContribution = Readonly<{
+    ref: string;
+    field: string;
+}>;
+export type CommandRefContributions = Readonly<{
+    provides: readonly RefContribution[];
+    requires: readonly RefContribution[];
+}>;
+export declare function commandRefContributions(command: SiteCommand): CommandRefContributions;

package/dist/_dts/site-commands/src/refs.d.ts

@@ -0,0 +1,87 @@
+import { type Brand, type Result } from '@riverbankcms/core';
+export declare const resourceKinds: readonly ["site-style", "media", "page", "block", "blocks", "nav", "form", "footer", "content", "staff", "venue", "event", "course", "ticket", "pass", "membership", "customer", "customer-pass", "customer-membership", "appointment", "course-enrollment", "event-registration", "pass-redemption", "order", "appointment-service", "appointment-resource", "availability"];
+export type ResourceKind = (typeof resourceKinds)[number];
+export type CommandRef = Brand<`${string}:${string}`, 'SiteCommandRef:command'>;
+export type SiteStyleRef = Brand<`site-style:${string}`, 'SiteCommandResourceRef:site-style'>;
+export type MediaRef = Brand<`media:${string}`, 'SiteCommandResourceRef:media'>;
+export type PageRef = Brand<`page:${string}`, 'SiteCommandResourceRef:page'>;
+export type BlockRef = Brand<`block:${string}`, 'SiteCommandResourceRef:block'>;
+export type BlocksRef = Brand<`blocks:${string}`, 'SiteCommandResourceRef:blocks'>;
+export type NavigationRef = Brand<`nav:${string}`, 'SiteCommandResourceRef:nav'>;
+export type FormRef = Brand<`form:${string}`, 'SiteCommandResourceRef:form'>;
+export type FooterRef = Brand<`footer:${string}`, 'SiteCommandResourceRef:footer'>;
+export type ContentEntryRef = Brand<`content:${string}`, 'SiteCommandResourceRef:content'>;
+export type StaffRef = Brand<`staff:${string}`, 'SiteCommandResourceRef:staff'>;
+export type VenueRef = Brand<`venue:${string}`, 'SiteCommandResourceRef:venue'>;
+export type EventSeriesRef = Brand<`event:${string}`, 'SiteCommandResourceRef:event'>;
+export type CourseRef = Brand<`course:${string}`, 'SiteCommandResourceRef:course'>;
+export type TicketTypeRef = Brand<`ticket:${string}`, 'SiteCommandResourceRef:ticket'>;
+export type PassProductRef = Brand<`pass:${string}`, 'SiteCommandResourceRef:pass'>;
+export type MembershipProductRef = Brand<`membership:${string}`, 'SiteCommandResourceRef:membership'>;
+export type BookingCustomerRef = Brand<`customer:${string}`, 'SiteCommandResourceRef:customer'>;
+export type CustomerPassRef = Brand<`customer-pass:${string}`, 'SiteCommandResourceRef:customer-pass'>;
+export type CustomerMembershipRef = Brand<`customer-membership:${string}`, 'SiteCommandResourceRef:customer-membership'>;
+export type AppointmentBookingRef = Brand<`appointment:${string}`, 'SiteCommandResourceRef:appointment'>;
+export type CourseEnrollmentRef = Brand<`course-enrollment:${string}`, 'SiteCommandResourceRef:course-enrollment'>;
+export type EventRegistrationRef = Brand<`event-registration:${string}`, 'SiteCommandResourceRef:event-registration'>;
+export type PassRedemptionRef = Brand<`pass-redemption:${string}`, 'SiteCommandResourceRef:pass-redemption'>;
+export type OrderRef = Brand<`order:${string}`, 'SiteCommandResourceRef:order'>;
+export type AppointmentServiceRef = Brand<`appointment-service:${string}`, 'SiteCommandResourceRef:appointment-service'>;
+export type AppointmentResourceRef = Brand<`appointment-resource:${string}`, 'SiteCommandResourceRef:appointment-resource'>;
+export type AppointmentAvailabilityRef = Brand<`availability:${string}`, 'SiteCommandResourceRef:availability'>;
+export type SiteCommandSiteRef = Brand<`site:${string}`, 'SiteCommandSiteRef'>;
+export type ResourceRefByKind = Readonly<{
+    'site-style': SiteStyleRef;
+    media: MediaRef;
+    page: PageRef;
+    block: BlockRef;
+    blocks: BlocksRef;
+    nav: NavigationRef;
+    form: FormRef;
+    footer: FooterRef;
+    content: ContentEntryRef;
+    staff: StaffRef;
+    venue: VenueRef;
+    event: EventSeriesRef;
+    course: CourseRef;
+    ticket: TicketTypeRef;
+    pass: PassProductRef;
+    membership: MembershipProductRef;
+    customer: BookingCustomerRef;
+    'customer-pass': CustomerPassRef;
+    'customer-membership': CustomerMembershipRef;
+    appointment: AppointmentBookingRef;
+    'course-enrollment': CourseEnrollmentRef;
+    'event-registration': EventRegistrationRef;
+    'pass-redemption': PassRedemptionRef;
+    order: OrderRef;
+    'appointment-service': AppointmentServiceRef;
+    'appointment-resource': AppointmentResourceRef;
+    availability: AppointmentAvailabilityRef;
+}>;
+export type ResourceRef = ResourceRefByKind[ResourceKind];
+export type SiteCommandRef = CommandRef | ResourceRef;
+export declare const commandRefPattern: RegExp;
+export declare const siteCommandSiteRefPattern: RegExp;
+export type RefParseError = Readonly<{
+    code: 'invalid_ref_format';
+    ref: string;
+}> | Readonly<{
+    code: 'unknown_resource_kind';
+    ref: string;
+    kind: string;
+}>;
+export declare function isCommandRef(value: string): boolean;
+export declare function createCommandRef(prefix: string, parts: readonly string[]): CommandRef;
+export declare function createContentEntryRef(parts: readonly string[]): ContentEntryRef;
+export declare function createPageRef(parts: readonly string[]): PageRef;
+export declare function createBlockRef(parts: readonly string[]): BlockRef;
+export declare function createBlocksRef(parts: readonly string[]): BlocksRef;
+export declare function createNavigationRef(parts: readonly string[]): NavigationRef;
+export declare function createFormRef(parts: readonly string[]): FormRef;
+export declare function createFooterRef(parts: readonly string[]): FooterRef;
+export declare function createSiteCommandSiteRef(parts: readonly string[]): SiteCommandSiteRef;
+export declare function refSlug(ref: SiteCommandRef | string): string;
+export declare function parseResourceRef(value: string): Result<ResourceRef, RefParseError>;
+export declare function resourceKindOf(ref: ResourceRef): ResourceKind;
+export declare function slugPart(value: string): string;

package/dist/_dts/site-commands/src/staticExecutionGaps.d.ts

@@ -0,0 +1,10 @@
+import type { StaticExecutionGapCode } from './capabilityGaps';
+import type { SiteCommand, SiteCommandOf } from './commands';
+export type StaticExecutionGap = Readonly<{
+    code: StaticExecutionGapCode;
+    message: string;
+}>;
+export declare function staticExecutionGapsForCommand(command: SiteCommand): readonly StaticExecutionGap[];
+export declare function eventSeriesStaticExecutionGaps(command: SiteCommandOf<'upsertEventSeries'>): readonly StaticExecutionGap[];
+export declare function eventTicketTypeStaticExecutionGaps(command: SiteCommandOf<'upsertEventTicketType'>): readonly StaticExecutionGap[];
+export declare function courseStaticExecutionGaps(command: SiteCommandOf<'upsertCourse'>): readonly StaticExecutionGap[];

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