@riverbankcms/sdk 0.124.0 → 0.126.0

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

@@ -2,8 +2,8 @@ export declare const navigationLocations: readonly ["main", "header", "footer"];
 export type NavigationLocation = (typeof navigationLocations)[number];
 export declare const navigationMenuRoles: readonly ["primary", "footer", "legal-policy"];
 export type NavigationMenuRole = (typeof navigationMenuRoles)[number];
-export declare const offeringArchetypes: readonly ["class", "workshop", "retreat", "performance", "custom"];
-export type OfferingArchetype = (typeof offeringArchetypes)[number];
+export declare const eventPresets: readonly ["event", "class", "course", "workshop", "retreat", "performance"];
+export type EventPreset = (typeof eventPresets)[number];
 export declare const offeringVisibilities: readonly ["draft", "unlisted", "listed", "published"];
 export type OfferingVisibility = (typeof offeringVisibilities)[number];
 export declare const bookingPassProductUseCases: readonly ["event_pass", "appointment_package"];

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

@@ -374,17 +374,18 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
         slug: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         title: z.ZodString;
-        archetype: z.ZodEnum<{
-            custom: "custom";
+        preset: z.ZodEnum<{
+            course: "course";
+            event: "event";
             performance: "performance";
             class: "class";
             workshop: "workshop";
             retreat: "retreat";
         }>;
-        bookingScope: z.ZodOptional<z.ZodEnum<{
+        bookingScope: z.ZodEnum<{
             single_occurrence: "single_occurrence";
             whole_series: "whole_series";
-        }>>;
+        }>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
             draft: "draft";
@@ -887,7 +888,34 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strict>], "styleId">>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"set-palette">;
-            command: z.ZodType<import("../../blocks/src/index").PaletteCommand, unknown, z.core.$ZodTypeInternals<import("../../blocks/src/index").PaletteCommand, unknown>>;
+            palette: z.ZodPipe<z.ZodObject<{
+                colors: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    hex: z.ZodString;
+                }, z.core.$strip>>;
+                meta: z.ZodObject<{
+                    mode: z.ZodEnum<{
+                        light: "light";
+                        dark: "dark";
+                    }>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodTransform<{
+                colors: {
+                    name: string;
+                    hex: string;
+                }[];
+                meta: {
+                    mode: "light" | "dark";
+                };
+            }, {
+                colors: {
+                    name: string;
+                    hex: string;
+                }[];
+                meta: {
+                    mode: "light" | "dark";
+                };
+            }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"set-typography">;
             typography: z.ZodNullable<z.ZodObject<{
@@ -1517,17 +1545,18 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         slug: z.ZodString;
         path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         title: z.ZodString;
-        archetype: z.ZodEnum<{
-            custom: "custom";
+        preset: z.ZodEnum<{
+            course: "course";
+            event: "event";
             performance: "performance";
             class: "class";
             workshop: "workshop";
             retreat: "retreat";
         }>;
-        bookingScope: z.ZodOptional<z.ZodEnum<{
+        bookingScope: z.ZodEnum<{
             single_occurrence: "single_occurrence";
             whole_series: "whole_series";
-        }>>;
+        }>;
         status: z.ZodOptional<z.ZodEnum<{
             active: "active";
             draft: "draft";

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

@@ -53,7 +53,34 @@ export declare const applySiteStyleSelectionCommandSchema: z.ZodObject<{
             }, z.core.$strict>], "styleId">>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"set-palette">;
-            command: z.ZodType<import("../../blocks/src/index").PaletteCommand, unknown, z.core.$ZodTypeInternals<import("../../blocks/src/index").PaletteCommand, unknown>>;
+            palette: z.ZodPipe<z.ZodObject<{
+                colors: z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    hex: z.ZodString;
+                }, z.core.$strip>>;
+                meta: z.ZodObject<{
+                    mode: z.ZodEnum<{
+                        light: "light";
+                        dark: "dark";
+                    }>;
+                }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodTransform<{
+                colors: {
+                    name: string;
+                    hex: string;
+                }[];
+                meta: {
+                    mode: "light" | "dark";
+                };
+            }, {
+                colors: {
+                    name: string;
+                    hex: string;
+                }[];
+                meta: {
+                    mode: "light" | "dark";
+                };
+            }>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"set-typography">;
             typography: z.ZodNullable<z.ZodObject<{

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

@@ -1,15 +1,15 @@
 import { z } from 'zod';
-type SiteStyleSelectionSchemaParts<TSiteStyleId extends z.ZodType, TButtonStyleSelection extends z.ZodType, TPaletteCommand extends z.ZodType, TTypography extends z.ZodType, THeaderLookId extends z.ZodType, THeaderLayoutId extends z.ZodType, THeaderStyleId extends z.ZodType, TFooterLookId extends z.ZodType> = Readonly<{
+type SiteStyleSelectionSchemaParts<TSiteStyleId extends z.ZodType, TButtonStyleSelection extends z.ZodType, TPalette extends z.ZodType, TTypography extends z.ZodType, THeaderLookId extends z.ZodType, THeaderLayoutId extends z.ZodType, THeaderStyleId extends z.ZodType, TFooterLookId extends z.ZodType> = Readonly<{
     siteStyleId: TSiteStyleId;
     buttonStyleSelection: TButtonStyleSelection;
-    paletteCommand: TPaletteCommand;
+    palette: TPalette;
     typography: TTypography;
     headerLookId: THeaderLookId;
     headerLayoutId: THeaderLayoutId;
     headerStyleId: THeaderStyleId;
     footerLookId: TFooterLookId;
 }>;
-export declare function createSiteStyleSelectionChangeSchema<TSiteStyleId extends z.ZodType, TButtonStyleSelection extends z.ZodType, TPaletteCommand extends z.ZodType, TTypography extends z.ZodType, THeaderLookId extends z.ZodType, THeaderLayoutId extends z.ZodType, THeaderStyleId extends z.ZodType, TFooterLookId extends z.ZodType>(parts: SiteStyleSelectionSchemaParts<TSiteStyleId, TButtonStyleSelection, TPaletteCommand, TTypography, THeaderLookId, THeaderLayoutId, THeaderStyleId, TFooterLookId>): z.ZodDiscriminatedUnion<[z.ZodObject<{
+export declare function createSiteStyleSelectionChangeSchema<TSiteStyleId extends z.ZodType, TButtonStyleSelection extends z.ZodType, TPalette extends z.ZodType, TTypography extends z.ZodType, THeaderLookId extends z.ZodType, THeaderLayoutId extends z.ZodType, THeaderStyleId extends z.ZodType, TFooterLookId extends z.ZodType>(parts: SiteStyleSelectionSchemaParts<TSiteStyleId, TButtonStyleSelection, TPalette, TTypography, THeaderLookId, THeaderLayoutId, THeaderStyleId, TFooterLookId>): z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"set-site-style">;
     siteStyleId: TSiteStyleId;
 }, z.core.$strict>, z.ZodObject<{
@@ -17,7 +17,7 @@ export declare function createSiteStyleSelectionChangeSchema<TSiteStyleId extend
     buttonStyleSelection: z.ZodNullable<TButtonStyleSelection>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"set-palette">;
-    command: TPaletteCommand;
+    palette: TPalette;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"set-typography">;
     typography: z.ZodNullable<TTypography>;

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

@@ -0,0 +1,20 @@
+import type { Theme } from '../schema';
+import { type PaletteColors, type PaletteMode } from './colors';
+/**
+ * The complete palette value shared by curated authoring templates and themes.
+ * It carries no catalogue identity, persistence origin, or independent version.
+ */
+export type ConcretePalette = Readonly<{
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>;
+/**
+ * Converts an already schema-validated theme palette into the canonical
+ * role-keyed representation. The theme boundary guarantees completeness and
+ * mode validity; colour notation is normalised by that boundary.
+ */
+export declare function concretePaletteFromTheme(palette: Theme['palette']): ConcretePalette;
+export declare function concretePaletteToTheme(palette: ConcretePalette): Theme['palette'];
+export declare function concretePalettesEqual(left: ConcretePalette, right: ConcretePalette): boolean;
+/** Exact semantic equality for two schema-validated theme palette values. */
+export declare function themePalettesEqual(left: Theme['palette'], right: Theme['palette']): boolean;

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

@@ -2,11 +2,9 @@
  * Curated palette library.
  *
  * Authoring keys are readable source aliases. Value keys are derived from the
- * complete mode and semantic colours and are the only curated identity used at
- * persistence and runtime boundaries.
+ * complete mode and semantic colours for picker and catalogue identity.
  */
-import { z } from 'zod';
-import { type PaletteValueKey } from '../colors';
+import type { PaletteValueKey } from '../colors';
 import type { CuratedPaletteAuthoringKey, CuratedPaletteDefinition } from './types';
 export type { CuratedPaletteAuthoringKey, CuratedPaletteDefinition, HexColor, PaletteColorEntry, PaletteColors, PaletteMode, PartialPaletteColors, PaletteTokenName, } from './types';
 export type { PaletteValueKey } from '../colors';
@@ -28,16 +26,3 @@ export type KnownCuratedPaletteAuthoringKeyValue = Unbrand<KnownCuratedPaletteAu
 export declare function findCuratedPalette(valueKey: PaletteValueKey): CuratedPalette | undefined;
 export declare function findCuratedPaletteByAuthoringKey(authoringKey: CuratedPaletteAuthoringKey): CuratedPalette | undefined;
 export declare function requireCuratedPaletteValueKey(authoringKey: CuratedPaletteAuthoringKey): KnownCuratedPaletteValueKey;
-export declare function isKnownCuratedPaletteValueKey(value: unknown): value is KnownCuratedPaletteValueKey;
-/** Parses a raw persisted key into catalogue-proven curated membership. */
-export declare const knownCuratedPaletteValueKeySchema: z.ZodPipe<z.ZodString, z.ZodTransform<KnownCuratedPaletteValueKey, string>>;
-export type PersistedCuratedPaletteValueKeyParseResult = Readonly<{
-    kind: 'known';
-    valueKey: KnownCuratedPaletteValueKey;
-}> | Readonly<{
-    kind: 'unknown';
-    raw: string;
-}> | Readonly<{
-    kind: 'empty';
-}>;
-export declare function parsePersistedCuratedPaletteValueKey(value: string | null | undefined): PersistedCuratedPaletteValueKeyParseResult;

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

@@ -9,12 +9,7 @@ export * from './utils';
 export * from './utils/paletteAccess';
 export * from './extractPalette';
 export * from './colors';
-export * from './editorState';
-export * from './libraryModel';
-export * from './persistenceReadSource';
-export * from './resolveSelection';
-export * from './selection';
-export * from './sitePalettePersistence';
+export * from './concretePalette';
 export * from './utils/fromVibrant';
 export * from './utils/suggestRecipes';
 export * from './recipes/allRecipes';

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

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const paletteColorSchema: z.ZodObject<{
+    name: z.ZodString;
+    hex: z.ZodString;
+}, z.core.$strip>;
+export declare const paletteMetaSchema: z.ZodObject<{
+    mode: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+}, z.core.$strip>;
+export declare const paletteSchema: z.ZodPipe<z.ZodObject<{
+    colors: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        hex: z.ZodString;
+    }, z.core.$strip>>;
+    meta: z.ZodObject<{
+        mode: z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+    colors: {
+        name: string;
+        hex: string;
+    }[];
+    meta: {
+        mode: "light" | "dark";
+    };
+}, {
+    colors: {
+        name: string;
+        hex: string;
+    }[];
+    meta: {
+        mode: "light" | "dark";
+    };
+}>>;

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { ExpandedPalette } from './palette/expandPalette';
+import { paletteColorSchema, paletteMetaSchema, paletteSchema } from './palette/schema';
 export declare const axesSchema: z.ZodObject<{
     tone: z.ZodEnum<{
         bold: "bold";
@@ -31,28 +32,7 @@ export declare const axesSchema: z.ZodObject<{
         expressive: "expressive";
     }>;
 }, z.core.$strip>;
-export declare const paletteColorSchema: z.ZodObject<{
-    name: z.ZodString;
-    hex: z.ZodString;
-}, z.core.$strip>;
-export declare const paletteMetaSchema: z.ZodObject<{
-    mode: z.ZodEnum<{
-        light: "light";
-        dark: "dark";
-    }>;
-}, z.core.$strip>;
-export declare const paletteSchema: z.ZodObject<{
-    colors: z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        hex: z.ZodString;
-    }, z.core.$strip>>;
-    meta: z.ZodObject<{
-        mode: z.ZodEnum<{
-            light: "light";
-            dark: "dark";
-        }>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
+export { paletteColorSchema, paletteMetaSchema, paletteSchema };
 declare const headingSizeSchema: z.ZodEnum<{
     sm: "sm";
     md: "md";
@@ -3339,7 +3319,7 @@ export declare const themeSchema: z.ZodObject<{
             expressive: "expressive";
         }>;
     }, z.core.$strip>;
-    palette: z.ZodObject<{
+    palette: z.ZodPipe<z.ZodObject<{
         colors: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             hex: z.ZodString;
@@ -3350,7 +3330,23 @@ export declare const themeSchema: z.ZodObject<{
                 dark: "dark";
             }>;
         }, z.core.$strip>;
-    }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodTransform<{
+        colors: {
+            name: string;
+            hex: string;
+        }[];
+        meta: {
+            mode: "light" | "dark";
+        };
+    }, {
+        colors: {
+            name: string;
+            hex: string;
+        }[];
+        meta: {
+            mode: "light" | "dark";
+        };
+    }>>;
     typography: z.ZodObject<{
         body: z.ZodObject<{
             family: z.ZodString;
@@ -6589,7 +6585,7 @@ export declare const themesTurnSchema: z.ZodObject<{
                 expressive: "expressive";
             }>;
         }, z.core.$strip>;
-        palette: z.ZodObject<{
+        palette: z.ZodPipe<z.ZodObject<{
             colors: z.ZodArray<z.ZodObject<{
                 name: z.ZodString;
                 hex: z.ZodString;
@@ -6600,7 +6596,23 @@ export declare const themesTurnSchema: z.ZodObject<{
                     dark: "dark";
                 }>;
             }, z.core.$strip>;
-        }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodTransform<{
+            colors: {
+                name: string;
+                hex: string;
+            }[];
+            meta: {
+                mode: "light" | "dark";
+            };
+        }, {
+            colors: {
+                name: string;
+                hex: string;
+            }[];
+            meta: {
+                mode: "light" | "dark";
+            };
+        }>>;
         typography: z.ZodObject<{
             body: z.ZodObject<{
                 family: z.ZodString;

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

@@ -1,7 +1,6 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import { type Theme } from '../schema';
 import { type ButtonStyleSelection } from '../buttons/styles';
-import type { CompleteResolvedPaletteSelection, PaletteSelection } from '../palette';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId, type FooterSelectionResult } from './footerLooks';
 import type { HeaderSelectionIdentity, SiteThemeCompilationPlan } from './compilationPlan';
@@ -34,7 +33,7 @@ export declare const previewCustomizePurpose: "preview-customize";
  * `compileSiteThemeFromSelections` with the style's default curated palette.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
-export declare function defaultResolvedPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;
+export declare function defaultConcretePaletteForSiteStyle(siteStyle: CuratedSiteStyle): Theme['palette'];
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
 export type SelectionFallbackWarning = Readonly<{
     kind: 'rejected-button-style';
@@ -45,7 +44,7 @@ type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     buttonStyleSelection: ButtonStyleSelection | null;
     typography?: Theme['typography'];
-    resolvedPalette: CompleteResolvedPaletteSelection;
+    palette: Theme['palette'];
 }>;
 export type ReplacementSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
     compilationPlan: Extract<SiteThemeCompilationPlan, {
@@ -62,7 +61,6 @@ export type SiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly
 }>;
 type ResolvedSiteThemeSelections = Readonly<{
     buttonStyleSelection: ButtonStyleSelection;
-    paletteSelection: PaletteSelection | null;
     headerLookId: HeaderLookId | null;
     headerLayoutId: HeaderLayoutId | null;
     headerStyleId: HeaderStyleId | null;
@@ -103,8 +101,8 @@ export type UpdateSiteThemeSelectionsResult = SiteThemeSelectionsBaseResult<Reso
 export type SiteThemeSelectionsResult = ReplacementSiteThemeSelectionsResult | UpdateSiteThemeSelectionsResult;
 /**
  * High-level, site-style-aware compiler. Resolves the user's button style and
- * palette selections into theme tokens. Palette authority is always supplied
- * as a complete resolved curated/site selection or an explicit draft.
+ * palette values into theme tokens. Palette authority is always supplied as a
+ * complete concrete value.
  *
  * Returns the resolved IDs so the caller can persist auto-pick decisions, plus
  * any fallback warnings the UI can surface as "we changed your selection"

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

@@ -1,7 +1,6 @@
 import { type CardStylesOverride, type ContainerStylesOverride, type SectionStylesOverride, type Theme } from '../schema';
 import { type ExpandedPalette } from '../palette/expandPalette';
 import { type ButtonStyleSelection } from '../buttons/styles';
-import type { CompleteResolvedPaletteSelection } from '../palette/resolveSelection';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
 import { type SectionBoundaryRuntimeMetrics } from './sectionTransitions';
@@ -334,8 +333,8 @@ export declare function compilePageRuntimeFields<TBlockId extends string, TPurpo
     terminalSectionAdjacency?: TerminalSectionAdjacency;
 }>): CompiledPageRuntime<TBlockId>;
 type PaletteCompileOptions = Readonly<{
-    /** A complete palette resolved from an explicit curated or site selection. */
-    resolvedPalette?: CompleteResolvedPaletteSelection;
+    /** A complete concrete palette supplied by the theme/editor boundary. */
+    palette?: Theme['palette'];
 }>;
 export type CompileTokenRecipesOptions = Readonly<{
     /** Validated button style selection. When provided, emits `theme.buttons`. */
@@ -346,9 +345,9 @@ export type CompileTokenRecipesOptions = Readonly<{
  * pure and schema-validated so generated Theme V2 choices have a concrete legacy
  * Theme output before any persistence or Phase 5 integration consumes them.
  *
- * Optional `options` accept an already-resolved palette selection and button
- * style. Sparse overrides and legacy palette IDs are deliberately not
- * compiler inputs: callers must resolve a complete palette before compiling.
+ * Optional `options` accept a complete concrete palette and button style.
+ * Sparse overrides and palette identities are deliberately not compiler
+ * inputs.
  */
 export declare function compileTokenRecipes(recipes: ThemeTokenRecipes, options?: CompileTokenRecipesOptions): Theme;
 export {};