@riverbankcms/sdk 0.64.0 → 0.67.0

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

@@ -2,6 +2,7 @@ export * from './adapter';
 export * from './capabilityGaps';
 export * from './commands';
 export * from './domain';
+export * from './exposure';
 export * from './metadata';
 export * from './planner';
 export * from './refContributions';

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

@@ -69,7 +69,7 @@ export declare const siteCommandMetadata: {
     };
     readonly upsertBlockTree: {
         readonly scope: "block";
-        readonly risk: "low";
+        readonly risk: "high";
         readonly writeSemantics: "replace";
         readonly lifecycleIntent: "mutation";
         readonly idempotencyStrategy: "recipe_ref";
@@ -80,6 +80,45 @@ export declare const siteCommandMetadata: {
         readonly capability: "pages.blocks.write";
         readonly support: "supported";
     };
+    readonly upsertPageBlock: {
+        readonly scope: "block";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "pages.blocks.write";
+        readonly support: "supported";
+    };
+    readonly deletePageBlock: {
+        readonly scope: "block";
+        readonly risk: "medium";
+        readonly writeSemantics: "delete";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "pages.blocks.delete";
+        readonly support: "supported";
+    };
+    readonly reorderPageBlocks: {
+        readonly scope: "block";
+        readonly risk: "medium";
+        readonly writeSemantics: "order_transition";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "pages.blocks.reorder";
+        readonly support: "supported";
+    };
     readonly upsertNavigationMenu: {
         readonly scope: "navigation";
         readonly risk: "low";
@@ -93,6 +132,32 @@ export declare const siteCommandMetadata: {
         readonly capability: "navigation.write";
         readonly support: "supported";
     };
+    readonly upsertForm: {
+        readonly scope: "form";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "forms.write";
+        readonly support: "supported";
+    };
+    readonly upsertFooterContent: {
+        readonly scope: "footer";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "footer.write";
+        readonly support: "supported";
+    };
     readonly upsertContentEntry: {
         readonly scope: "content";
         readonly risk: "low";
@@ -119,6 +184,19 @@ export declare const siteCommandMetadata: {
         readonly capability: "pages.publish";
         readonly support: "supported";
     };
+    readonly unpublishPage: {
+        readonly scope: "publish";
+        readonly risk: "medium";
+        readonly writeSemantics: "status_transition";
+        readonly lifecycleIntent: "unpublish";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "pages.unpublish";
+        readonly support: "supported";
+    };
     readonly publishContentEntry: {
         readonly scope: "publish";
         readonly risk: "medium";
@@ -136,7 +214,7 @@ export declare const siteCommandMetadata: {
         readonly scope: "publish";
         readonly risk: "medium";
         readonly writeSemantics: "status_transition";
-        readonly lifecycleIntent: "publish";
+        readonly lifecycleIntent: "unpublish";
         readonly idempotencyStrategy: "existing_id";
         readonly conflictPolicy: "update_existing";
         readonly previewability: "effect_required";
@@ -353,6 +431,19 @@ export declare const siteCommandMetadata: {
         readonly capability: "bookings.pass_redemptions.write";
         readonly support: "supported";
     };
+    readonly seedPortalOrder: {
+        readonly scope: "order";
+        readonly risk: "medium";
+        readonly writeSemantics: "append";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "append_once";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "commerce.orders.write";
+        readonly support: "supported";
+    };
     readonly upsertAppointmentService: {
         readonly scope: "appointment_service";
         readonly risk: "medium";

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

@@ -2,17 +2,17 @@ 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';
-export type PlannedSiteCommandFor<TType extends SiteCommandType> = Readonly<{
-    command: SiteCommandOf<TType>;
+type PlannedSiteCommandCommon = Readonly<{
     metadata: SiteCommandMetadata;
     lifecycleIntent: LifecycleIntent;
     provides: readonly ResourceRef[];
     requires: readonly ResourceRef[];
     idempotencyKey: SiteCommandIdempotencyKey;
 }>;
-export type PlannedSiteCommand = {
-    [TType in SiteCommandType]: PlannedSiteCommandFor<TType>;
-}[SiteCommandType];
+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[];
@@ -24,8 +24,13 @@ export type PlannedSiteCommandOf<TType extends SiteCommandType> = {
 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[]>;
@@ -39,6 +44,7 @@ export type DryRunReport = Readonly<{
     commandCount: number;
     mutationCount: number;
     publishCount: number;
+    unpublishCount: number;
     seedCount: number;
     riskSummary: Readonly<Record<CommandRisk, number>>;
     executionOrder: readonly Readonly<{
@@ -48,4 +54,5 @@ export type DryRunReport = Readonly<{
     resolvedRefs: readonly ResourceRef[];
     capabilityGaps: readonly SiteCommandCapabilityGap[];
 }>;
-export declare function createDryRunReport(plan: SiteCommandPlan): DryRunReport;
+export declare function createDryRunReport<TType extends SiteCommandType>(plan: SiteCommandPlan | SiteCommandPlanFor<TType>): DryRunReport;
+export {};

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

@@ -1,5 +1,5 @@
 import { type Brand, type Result } from '@riverbankcms/core';
-export declare const resourceKinds: readonly ["site-style", "media", "page", "block", "blocks", "nav", "content", "staff", "venue", "event", "course", "ticket", "pass", "membership", "customer", "customer-pass", "customer-membership", "appointment", "course-enrollment", "event-registration", "pass-redemption", "appointment-service", "appointment-resource", "availability"];
+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'>;
@@ -8,6 +8,8 @@ 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'>;
@@ -23,6 +25,7 @@ export type AppointmentBookingRef = Brand<`appointment:${string}`, 'SiteCommandR
 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'>;
@@ -34,6 +37,8 @@ export type ResourceRefByKind = Readonly<{
     block: BlockRef;
     blocks: BlocksRef;
     nav: NavigationRef;
+    form: FormRef;
+    footer: FooterRef;
     content: ContentEntryRef;
     staff: StaffRef;
     venue: VenueRef;
@@ -49,6 +54,7 @@ export type ResourceRefByKind = Readonly<{
     'course-enrollment': CourseEnrollmentRef;
     'event-registration': EventRegistrationRef;
     'pass-redemption': PassRedemptionRef;
+    order: OrderRef;
     'appointment-service': AppointmentServiceRef;
     'appointment-resource': AppointmentResourceRef;
     availability: AppointmentAvailabilityRef;
@@ -68,6 +74,12 @@ export type RefParseError = Readonly<{
 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>;

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;