@riverbankcms/sdk 0.60.3 → 0.60.7

package/dist/_dts/theme-core/src/shared/componentStyles.d.ts

@@ -16,15 +16,15 @@ import { z } from 'zod';
  */
 export declare const componentBorderSchema: z.ZodObject<{
     width: z.ZodDefault<z.ZodEnum<{
-        medium: "medium";
         none: "none";
-        thick: "thick";
+        medium: "medium";
         thin: "thin";
+        thick: "thick";
         hairline: "hairline";
     }>>;
     style: z.ZodDefault<z.ZodEnum<{
-        dashed: "dashed";
         solid: "solid";
+        dashed: "dashed";
     }>>;
     colorToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -36,10 +36,10 @@ export type ComponentBorder = z.infer<typeof componentBorderSchema>;
 export declare const componentShadowSchema: z.ZodObject<{
     elevation: z.ZodDefault<z.ZodEnum<{
         none: "none";
-        sm: "sm";
         md: "md";
         lg: "lg";
         xl: "xl";
+        sm: "sm";
         "2xl": "2xl";
     }>>;
 }, z.core.$strip>;

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

@@ -0,0 +1,27 @@
+import type { NonEmptyReadonlyArray } from './types';
+export type CuratedChoice<TId extends string> = Readonly<{
+    id: TId;
+    note?: string;
+}>;
+export type UnknownPersistedChoice = Readonly<{
+    kind: 'unknown';
+    raw: string;
+}>;
+export type CuratedChoiceRequest<TId extends string> = TId | UnknownPersistedChoice | null;
+export type CuratedChoiceResolution<TId extends string> = Readonly<{
+    kind: 'accepted';
+    resolved: TId;
+}> | Readonly<{
+    kind: 'defaulted-empty';
+    resolved: TId;
+}> | Readonly<{
+    kind: 'defaulted-rejected';
+    requested: string;
+    resolved: TId;
+    reason: 'unknown' | 'not-curated-for-style';
+}>;
+export declare function defaultCuratedChoice<TId extends string>(choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): TId;
+export declare function resolveCuratedChoice<TId extends string>(requested: CuratedChoiceRequest<TId>, choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): CuratedChoiceResolution<TId>;
+export declare function requireEntriesForCuratedChoices<TEntry extends Readonly<{
+    id: string;
+}>, TId extends TEntry['id']>(entries: readonly TEntry[], choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): NonEmptyReadonlyArray<TEntry>;

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

@@ -1,9 +1,11 @@
-import type { ButtonPersonalityId } from '../buttons/personalities';
-import type { PaletteVariantId } from '../palette/variants';
-import type { AcceptanceRegion } from './compatibility';
-import { type DesignSystemTemplate, type SiteStyleId } from './types';
+import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
+import { type KnownPaletteVariantId, type PaletteVariantId } from '../palette/variants';
+import { type CuratedChoice } from './curatedChoices';
+import { 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"];
 export type CuratedSiteStyleIdValue = typeof curatedSiteStyleIdValues[number];
+export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
+export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
 export type CuratedSiteStyle = Readonly<{
     id: SiteStyleId;
     name: string;
@@ -11,26 +13,13 @@ export type CuratedSiteStyle = Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>;
+export declare function defaultButtonPersonalityForSiteStyle(siteStyle: CuratedSiteStyle): ButtonPersonalityId;
+export declare function defaultPaletteVariantForSiteStyle(siteStyle: CuratedSiteStyle): PaletteVariantId;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
  * systems. Generators choose one of these bounded entries, then downstream
@@ -43,25 +32,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -69,25 +43,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -95,25 +54,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -121,25 +65,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -147,25 +76,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -173,25 +87,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -199,25 +98,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** 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;
@@ -225,25 +109,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>];
 export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     id: SiteStyleId;
@@ -252,24 +121,9 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
-    /**
-     * Default button personality applied when the site is generated and no
-     * explicit user selection exists. Must be compatible with `acceptedButtons`.
-     */
-    defaultButtonPersonalityId: ButtonPersonalityId;
-    /**
-     * Acceptance region for button personalities. The Style configurator UI
-     * filters the personality picker against this region; if a persisted
-     * personality stops being compatible (e.g. after a site-style switch) the
-     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
-     */
-    acceptedButtons: AcceptanceRegion;
-    /**
-     * Default palette variant when generated with no explicit user selection.
-     * Must be compatible with `acceptedPalettes`.
-     */
-    defaultPaletteVariantId: PaletteVariantId;
-    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
-    acceptedPalettes: AcceptanceRegion;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>>;
 export declare function getCuratedSiteStyle(id: SiteStyleId): CuratedSiteStyle | null;

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

@@ -122,8 +122,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         kind: z.ZodLiteral<"panel">;
         treatment: z.ZodEnum<{
             editorial: "editorial";
-            inset: "inset";
             raised: "raised";
+            inset: "inset";
         }>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"flush-panel">;
@@ -138,12 +138,12 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }, z.core.$strict>], "kind">;
     itemSurface: z.ZodEnum<{
         flat: "flat";
-        none: "none";
         default: "default";
+        none: "none";
         editorial: "editorial";
-        inset: "inset";
         raised: "raised";
         outlined: "outlined";
+        inset: "inset";
     }>;
     transitionAfter: z.ZodEnum<{
         none: "none";
@@ -153,9 +153,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         "angle-edge": "angle-edge";
     }>;
     emphasis: z.ZodEnum<{
-        medium: "medium";
         low: "low";
         high: "high";
+        medium: "medium";
     }>;
     heroLegibility: z.ZodOptional<z.ZodEnum<{
         none: "none";
@@ -166,10 +166,10 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
 export declare const styleAuthoritySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"theme-v2">;
     source: z.ZodEnum<{
+        user: "user";
         admin: "admin";
         sdk: "sdk";
         generated: "generated";
-        user: "user";
     }>;
     siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
     templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;
@@ -189,19 +189,19 @@ export declare const blockRuntimeStyleAuthoritySchema: z.ZodObject<{
     unit: z.ZodLiteral<"block-runtime-fields">;
     blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
     fields: z.ZodPipe<z.ZodArray<z.ZodEnum<{
+        styleGroup: "styleGroup";
         _sectionStyles: "_sectionStyles";
         _containerStyles: "_containerStyles";
         _cardStyles: "_cardStyles";
-        styleGroup: "styleGroup";
         _frameStyles: "_frameStyles";
-    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup" | "_frameStyles")[]>>;
+    }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("styleGroup" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_frameStyles")[]>>;
     authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"theme-v2">;
         source: z.ZodEnum<{
+            user: "user";
             admin: "admin";
             sdk: "sdk";
             generated: "generated";
-            user: "user";
         }>;
         siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
         templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;
@@ -241,8 +241,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             kind: z.ZodLiteral<"panel">;
             treatment: z.ZodEnum<{
                 editorial: "editorial";
-                inset: "inset";
                 raised: "raised";
+                inset: "inset";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"flush-panel">;
@@ -257,12 +257,12 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }, z.core.$strict>], "kind">;
         itemSurface: z.ZodEnum<{
             flat: "flat";
-            none: "none";
             default: "default";
+            none: "none";
             editorial: "editorial";
-            inset: "inset";
             raised: "raised";
             outlined: "outlined";
+            inset: "inset";
         }>;
         transitionAfter: z.ZodEnum<{
             none: "none";
@@ -272,9 +272,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             "angle-edge": "angle-edge";
         }>;
         emphasis: z.ZodEnum<{
-            medium: "medium";
             low: "low";
             high: "high";
+            medium: "medium";
         }>;
         heroLegibility: z.ZodOptional<z.ZodEnum<{
             none: "none";
@@ -286,19 +286,19 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         unit: z.ZodLiteral<"block-runtime-fields">;
         blockId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignBlockId, string>>;
         fields: z.ZodPipe<z.ZodArray<z.ZodEnum<{
+            styleGroup: "styleGroup";
             _sectionStyles: "_sectionStyles";
             _containerStyles: "_containerStyles";
             _cardStyles: "_cardStyles";
-            styleGroup: "styleGroup";
             _frameStyles: "_frameStyles";
-        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("_sectionStyles" | "_containerStyles" | "_cardStyles" | "styleGroup" | "_frameStyles")[]>>;
+        }>>, z.ZodTransform<NonEmptyRuntimeStyleFieldNames, ("styleGroup" | "_sectionStyles" | "_containerStyles" | "_cardStyles" | "_frameStyles")[]>>;
         authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"theme-v2">;
             source: z.ZodEnum<{
+                user: "user";
                 admin: "admin";
                 sdk: "sdk";
                 generated: "generated";
-                user: "user";
             }>;
             siteStyleId: z.ZodPipe<z.ZodString, z.ZodTransform<SiteStyleId, string>>;
             templateId: z.ZodPipe<z.ZodString, z.ZodTransform<DesignSystemTemplateId, string>>;

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

@@ -5,8 +5,8 @@ export declare const generatedContentFrameIntentSchema: z.ZodDiscriminatedUnion<
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"panel">;
     treatment: z.ZodEnum<{
-        inset: "inset";
         raised: "raised";
+        inset: "inset";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"flush-panel">;
@@ -52,8 +52,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"panel">;
             treatment: z.ZodEnum<{
-                inset: "inset";
                 raised: "raised";
+                inset: "inset";
             }>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"flush-panel">;
@@ -73,8 +73,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         kind: z.ZodLiteral<"explicit">;
         value: z.ZodEnum<{
             flat: "flat";
-            none: "none";
             default: "default";
+            none: "none";
             raised: "raised";
             outlined: "outlined";
         }>;
@@ -98,9 +98,9 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
         source: z.ZodLiteral<"generated">;
         kind: z.ZodLiteral<"explicit">;
         value: z.ZodEnum<{
-            medium: "medium";
             low: "low";
             high: "high";
+            medium: "medium";
         }>;
     }, z.core.$strict>], "kind">;
 }, z.core.$strict>;
@@ -193,8 +193,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"panel">;
                     treatment: z.ZodEnum<{
-                        inset: "inset";
                         raised: "raised";
+                        inset: "inset";
                     }>;
                 }, z.core.$strict>, z.ZodObject<{
                     kind: z.ZodLiteral<"flush-panel">;
@@ -214,8 +214,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 kind: z.ZodLiteral<"explicit">;
                 value: z.ZodEnum<{
                     flat: "flat";
-                    none: "none";
                     default: "default";
+                    none: "none";
                     raised: "raised";
                     outlined: "outlined";
                 }>;
@@ -239,9 +239,9 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                 source: z.ZodLiteral<"generated">;
                 kind: z.ZodLiteral<"explicit">;
                 value: z.ZodEnum<{
-                    medium: "medium";
                     low: "low";
                     high: "high";
+                    medium: "medium";
                 }>;
             }, z.core.$strict>], "kind">;
         }, z.core.$strict>;

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

@@ -1,7 +1,7 @@
 export * from './appearancePresets';
 export * from './blockFlow';
-export * from './compatibility';
 export * from './compositionBudget';
+export * from './curatedChoices';
 export * from './curatedSiteStyles';
 export * from './designState';
 export * from './generatedSchemas';
@@ -15,5 +15,6 @@ export * from './rawStyleFields';
 export * from './resolver';
 export * from './runtimeCompiler';
 export * from './sourceCatalogs';
+export * from './styleTags';
 export * from './tokenRecipes';
 export * from './types';

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

@@ -19,7 +19,8 @@ export { autoDesignChoice, reducePageDesignIntentForUserAction, resolvePageDesig
 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 { curatedSiteStyles, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
+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';
 export declare const previewCustomizePurpose: "preview-customize";
 /**
@@ -33,21 +34,17 @@ export type CuratedSiteStyleTheme = Theme & Readonly<{
 /**
  * Compiles a curated Site Style into a persisted Theme payload using the site
  * style's defaults for the Style configurator selections. Thin wrapper around
- * `compileSiteThemeFromSelections({…, null, null, null})` — kept for back-compat
- * with callers that don't yet plumb user selections through.
- *
- * @deprecated Prefer `compileSiteThemeFromSelections` directly so resolved
- * selection IDs and compatibility warnings are visible at the call site.
+ * `compileSiteThemeFromSelections({…, null, null, null})`.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
-export type CompatibilityWarning = Readonly<{
+export type SelectionFallbackWarning = Readonly<{
     kind: 'rejected-personality';
-    requested: ButtonPersonalityId;
+    requested: string;
     fellBackTo: ButtonPersonalityId;
 }> | Readonly<{
     kind: 'rejected-palette';
-    requested: PaletteVariantId;
+    requested: string;
     fellBackTo: PaletteVariantId;
 }>;
 export type SiteThemeSelectionsInput = Readonly<{
@@ -62,16 +59,17 @@ export type SiteThemeSelectionsResult = Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
         paletteVariantId: PaletteVariantId;
     }>;
-    warnings: ReadonlyArray<CompatibilityWarning>;
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
 /**
  * High-level, site-style-aware compiler. Resolves the user's personality and
- * palette selections against the site style's acceptance regions (auto-picking
- * the site style's defaults when the request is incompatible or unknown),
- * then delegates to `compileTokenRecipes` with the resolved IDs.
+ * palette selections against the site style's authored choice lists
+ * (auto-picking the first/default choice when the request is absent, unknown,
+ * or not curated for this style), then delegates to `compileTokenRecipes` with
+ * the resolved IDs.
  *
  * Returns the resolved IDs so the caller can persist auto-pick decisions, plus
- * any compatibility warnings the UI can surface as "we changed your selection"
+ * any fallback warnings the UI can surface as "we changed your selection"
  * notices.
  */
 export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult;