@riverbankcms/sdk 0.108.0 → 0.109.0

package/dist/_dts/api/src/sdkContracts.d.ts

@@ -1,4 +1,5 @@
-import type { FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, SiteFooterContent, Theme } from '../../blocks/src/index';
+import type { BlockContentSource, BlockContentSourceKind, FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, SiteFooterContent, Theme } from '../../blocks/src/index';
+import type { ContentTypeSchema } from '../../content-model/src/index';
 import type { LinkPayload } from './navigation/types';
 import type { JsonValue } from './shared-contracts';
 import type { SdkEventPricing, SdkEventPricingInput } from './sdk-event-pricing';
@@ -405,6 +406,14 @@ export type SdkPatchPageBlockOperation = Readonly<{
 export interface SdkPatchPageBlockBody {
     operations: readonly SdkPatchPageBlockOperation[];
     baseContentHash: string;
+    /**
+     * Optional catalog-coherence precondition: the `activeTheme.selectionVersion`
+     * from `catalog/blocks`. When provided and the site's current style-selection
+     * version differs (the theme changed since the catalog was read), the write is
+     * rejected with 409 and error tag `STALE_CATALOG` instead of risking a
+     * confusing validation failure on a variant the stale catalog advertised.
+     */
+    baseSelectionVersion?: number;
 }
 export declare const SDK_PATCH_STALE_CONTENT_FIELD = "baseContentHash";
 export declare const SDK_PATCH_STALE_CONTENT_CODE = "STALE_CONTENT";
@@ -421,12 +430,28 @@ export interface SdkPatchPageBlockStaleContentFieldError {
     /** Exactly the current draft content hash. */
     message: string;
 }
+/**
+ * Non-blocking warning emitted on a block write. Currently used for button-variant
+ * values that ARE valid manifest options but the ACTIVE theme does not implement:
+ * the write is accepted (themes can change under content), but the variant will not
+ * render until a personality that provides it is selected.
+ */
+export interface SdkBlockContentWarning {
+    /** Data path of the value (e.g. `ctas[0].variant`). */
+    field: string;
+    code: 'theme-unavailable-variant';
+    message: string;
+    /** The offending value. */
+    value: string;
+}
 /**
  * Success response mirrors the block GET shape; `block.contentHash` is the
  * NEW draft content hash (use it as `baseContentHash` for the next patch).
  */
 export interface SdkPatchPageBlockResponse {
     block: SdkGetPageBlock;
+    /** Non-blocking content warnings (e.g. theme-unavailable button variants). */
+    warnings?: SdkBlockContentWarning[];
 }
 export interface SdkPullNavigationItem {
     id: string;
@@ -457,6 +482,8 @@ export interface SdkPullNavigationResponse {
     meta: SdkPullMeta;
 }
 export interface SdkPullSettings {
+    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
+    siteTitle?: string;
     homepageId: string | null;
     seoDefaults: {
         title?: string;
@@ -524,6 +551,223 @@ export interface SdkPullThemeResponse {
     selectionVersion: number;
     meta: SdkPullThemeMeta;
 }
+/** One curated-style recommendation choice; the catalog lists them in preference order. */
+export interface SdkCatalogChoice {
+    id: string;
+    note?: string;
+}
+export interface SdkCatalogHeaderLayoutStyleChoice {
+    layoutId: string;
+    styleId: string;
+}
+export interface SdkCatalogSiteStyle {
+    id: string;
+    name: string;
+    description: string;
+    /** Button personality recommendations in preference order (first = default). */
+    buttonPersonalityChoices: SdkCatalogChoice[];
+    defaultButtonPersonalityId: string;
+    /** Curated palette recommendations (value-keys) in preference order (first = default). */
+    paletteRecommendations: SdkCatalogChoice[];
+    defaultPaletteValueKey: string;
+    /**
+     * Concrete typography the style applies. NOTE: current theme-core carries a resolved
+     * `typography` object per style, not a preset-choice list (see deviation notes).
+     */
+    typography: Theme['typography'];
+    /** Canonical header layout+style pair (replaces the older single `defaultHeaderSelection` look id). */
+    defaultHeaderSelection: SdkCatalogHeaderLayoutStyleChoice;
+    recommendedHeaderLookIds: string[];
+    recommendedFooterLookIds: string[];
+}
+export interface SdkCatalogButtonPersonality {
+    id: string;
+    name: string;
+    description: string;
+    /** Enabled variant ids this personality provides. */
+    variantIds: string[];
+}
+export interface SdkCatalogPalette {
+    /** Human-readable source alias. */
+    authoringKey: string;
+    /** Canonical persistence/runtime identity (colors+mode hash). */
+    valueKey: string;
+    name: string;
+    description: string;
+    mode: string;
+}
+export interface SdkCatalogTypographyPreset {
+    /** Recipe id: `serif-editorial` | `clean-sans` | `classic-serif` | `friendly-sans`. */
+    id: string;
+    /** Concrete typography this preset resolves to. */
+    typography: Theme['typography'];
+}
+/**
+ * The site's current resolved selection, so one catalog read primes an apply.
+ * Carries everything the apply endpoint requires — including `siteStyleId`
+ * (read from the active compiled theme). This is the single wire shape;
+ * services map to it explicitly (no structural pass-through of domain rows).
+ */
+export interface SdkCatalogCurrentSelection {
+    /** Pass as `baseSelectionVersion` on apply; 0 when no selection exists. */
+    selectionVersion: number;
+    /** The curated site style the active theme was compiled from (null when unknown). */
+    siteStyleId: string | null;
+    buttonPersonalityId: string | null;
+    paletteValueKey: string | null;
+    headerLayoutId: string | null;
+    headerStyleId: string | null;
+    headerLookId: string | null;
+    footerLookId: string | null;
+    typographyPresetId: string | null;
+}
+export interface SdkCatalogThemeResponse {
+    siteStyles: SdkCatalogSiteStyle[];
+    buttonPersonalities: SdkCatalogButtonPersonality[];
+    palettes: SdkCatalogPalette[];
+    typographyPresets: SdkCatalogTypographyPreset[];
+    headerLookIds: string[];
+    footerLookIds: string[];
+    headerLayoutIds: string[];
+    headerStyleIds: string[];
+    currentSelection: SdkCatalogCurrentSelection;
+    meta: SdkPullMeta;
+}
+/**
+ * Content-source classification, derived DIRECTLY from the blocks package's
+ * authoring type (`BlockContentSource` / `blockContentSourceKinds`) so the wire
+ * union can never drift from what block definitions declare.
+ */
+export type SdkCatalogContentSourceKind = BlockContentSourceKind;
+export type SdkCatalogContentSource = BlockContentSource;
+export interface SdkCatalogSelectOption {
+    value: string;
+    label: string;
+}
+export interface SdkCatalogField {
+    id: string;
+    type: string;
+    label?: string;
+    required: boolean;
+    /** Present for `select` fields. */
+    options?: SdkCatalogSelectOption[];
+    /** Present for container fields (group/repeater/tabGroup/modal). */
+    fields?: SdkCatalogField[];
+}
+/** Machine-readable reason a manifest variant option is not currently renderable. */
+export type SdkCatalogVariantUnavailableReason = 'not-implemented-by-personality';
+/** Where a resolved variant value originates. */
+export type SdkCatalogVariantSource = 'manifest' | 'theme' | 'both';
+/**
+ * One button-variant option, discriminated on `availability`:
+ * - `available`   — the active theme implements it (never carries a reason).
+ * - `unavailable` — a manifest option the active theme does NOT implement;
+ *                   always carries a machine-readable `reason`. Writes accept it
+ *                   with a warning.
+ * - `unknown`     — the site has no active theme/button system, so availability
+ *                   cannot be determined; only manifest options appear.
+ */
+export type SdkCatalogVariantOption = Readonly<{
+    value: string;
+    availability: 'available';
+    source: SdkCatalogVariantSource;
+}> | Readonly<{
+    value: string;
+    availability: 'unavailable';
+    source: 'manifest';
+    reason: SdkCatalogVariantUnavailableReason;
+}> | Readonly<{
+    value: string;
+    availability: 'unknown';
+    source: 'manifest';
+}>;
+export interface SdkCatalogVariantAvailability {
+    /** Structural field-id path of the button-variant field (e.g. `ctas.variant`). */
+    fieldPath: string;
+    variants: SdkCatalogVariantOption[];
+}
+export interface SdkCatalogBlock {
+    identifier: string;
+    title: string;
+    category?: string;
+    contentSource: SdkCatalogContentSource;
+    fields: SdkCatalogField[];
+    /** Button-variant availability against the active theme (shared resolver). */
+    variantAvailability: SdkCatalogVariantAvailability[];
+}
+/**
+ * The active-theme context the blocks catalog was computed against. `selectionVersion`
+ * doubles as an optional write precondition: pass it as `baseSelectionVersion` on block
+ * upsert/PATCH to fail loudly (409, tag `STALE_CATALOG`) if the theme changed since
+ * the catalog was read — a catalog-advertised theme-only variant may otherwise be
+ * rejected after a mid-air theme change.
+ */
+export type SdkCatalogActiveTheme = Readonly<{
+    state: 'active';
+    selectionVersion: number;
+}> | Readonly<{
+    state: 'none';
+}>;
+export interface SdkCatalogBlocksResponse {
+    blocks: SdkCatalogBlock[];
+    /** Theme context the variant availability was computed against. */
+    activeTheme: SdkCatalogActiveTheme;
+    meta: SdkPullMeta;
+}
+export interface SdkCatalogContentType {
+    key: string;
+    name: string;
+    hasPages: boolean;
+    routePattern: string | null;
+    isSingleton: boolean;
+    /** Normalized stored field DSL (NOT generated JSON Schema). */
+    schema: ContentTypeSchema;
+}
+export interface SdkCatalogContentTypesResponse {
+    contentTypes: SdkCatalogContentType[];
+    meta: SdkPullMeta;
+}
+export interface SdkCapabilityCatalogLink {
+    /** Relative path under `/api/sdk/{siteId}`. */
+    path: string;
+    /** Stable content hash of the catalog body, for caching + drift detection. */
+    contentHash: string;
+}
+export interface SdkCapabilitiesResponse {
+    apiVersion: string;
+    catalogs: {
+        theme: SdkCapabilityCatalogLink;
+        blocks: SdkCapabilityCatalogLink;
+        contentTypes: SdkCapabilityCatalogLink;
+    };
+    meta: SdkPullMeta;
+}
+/** One provenance ledger row: a resource a demo recipe run created/linked on this site. */
+export interface SdkDemoSeedProvenanceEntry {
+    id: string;
+    /** The recipe run that created/linked the resource. */
+    runId: string;
+    /** The command ref within the run (e.g. `content:testimonial-ava`). */
+    commandKey: string;
+    /** The command type (e.g. `upsertContentEntry`). */
+    commandType: string;
+    /** Closed resource kind (e.g. `content`, `customer`, `page`, `staff`). */
+    resourceKind: string;
+    /** The recipe resource ref (e.g. `content:testimonial-ava`). */
+    resourceRef: string;
+    /** The concrete resource id. */
+    resourceId: string;
+    /**
+     * `created` — the run authored this resource (a cleanup candidate);
+     * `existing` — the run only linked/configured a pre-existing resource.
+     */
+    disposition: 'created' | 'existing';
+    createdAt: string;
+}
+export interface SdkDemoContentResponse {
+    items: SdkDemoSeedProvenanceEntry[];
+    meta: SdkPullMeta;
+}
 export interface SdkPullFooterMeta extends SdkPullMeta {
     updatedAt: string | null;
 }
@@ -824,6 +1068,8 @@ export interface SdkPullDraftsResponse {
 }
 export interface SdkUpsertBlockResponse {
     block: SdkManagementBlock;
+    /** Non-blocking content warnings (e.g. theme-unavailable button variants). */
+    warnings?: SdkBlockContentWarning[];
 }
 export interface SdkDeleteResponse {
     deleted: true;

package/dist/_dts/api/src/siteInfrastructure.d.ts

@@ -250,11 +250,16 @@ export type CreateSitePreviewKeyResponse = {
     keyId: string;
     message: string;
 };
+/** Access mode for a management API key: read-only or full write access. */
+export type ManagementKeyAccessMode = 'read' | 'write';
 export type ManagementKeyRecord = {
     id: string;
     name: string | null;
     keyPrefix: string;
     keyHint: string | null;
+    accessMode: ManagementKeyAccessMode;
+    /** ISO timestamp when the key expires, or null if it never expires. */
+    expiresAt: string | null;
     createdAt: string;
     lastUsedAt: string | null;
 };
@@ -263,10 +268,18 @@ export type ListManagementKeysResponse = {
 };
 export type CreateManagementKeyRequest = {
     name?: string;
+    /** Defaults to 'write' when omitted (preserves prior all-access behavior). */
+    accessMode?: ManagementKeyAccessMode;
+    /** Optional ISO timestamp; must be in the future. Null/omitted = never expires. */
+    expiresAt?: string | null;
 };
 export type CreateManagementKeyResponse = {
     key: string;
     keyId: string;
+    /** Normalized access mode the key was issued with. */
+    accessMode: ManagementKeyAccessMode;
+    /** Normalized expiry (ISO) or null when the key never expires. */
+    expiresAt: string | null;
     message: string;
 };
 export type RevokeManagementKeyRequest = {

package/dist/_dts/api/src/siteManagementEndpoints.d.ts

@@ -1054,12 +1054,8 @@ export type SiteManagementAPIEndpoints = {
         siteId: string;
         ids?: string;
     }, {
-        services: Array<{
-            id: string;
-            siteId: string;
-            title: string;
+        services: Array<Omit<PublicBookingService, 'description'> & {
             description?: string;
-            durationMinutes?: number;
         }>;
     }>;
     getPublicBookingService: APIEndpoint<never, {

package/dist/_dts/api/src/sitePlatformEndpoints.d.ts

@@ -10,7 +10,7 @@ import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSit
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from './siteRuntimeEndpoints';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogThemeResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkDemoContentResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { StripeConnectDisconnectResponse, StripeConnectStartResponse, StripeConnectStatusResponse, UpdateStripeAutomaticTaxRequest } from './billing';
 import type { NavigationLinkInput } from './navigation/types';
@@ -186,6 +186,21 @@ export type SitePlatformAPIEndpoints = {
     sdkPullContentTypes: APIEndpoint<never, {
         siteId: string;
     }, SdkPullContentTypesResponse>;
+    sdkCatalogTheme: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogThemeResponse>;
+    sdkCatalogBlocks: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogBlocksResponse>;
+    sdkCatalogContentTypes: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogContentTypesResponse>;
+    sdkCapabilities: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCapabilitiesResponse>;
+    sdkListDemoContent: APIEndpoint<never, {
+        siteId: string;
+    }, SdkDemoContentResponse>;
     sdkPullPages: APIEndpoint<never, {
         siteId: string;
     }, SdkPullPagesResponse>;
@@ -262,6 +277,11 @@ export type SitePlatformAPIEndpoints = {
         kind: string;
         data: Record<string, unknown>;
         position?: number;
+        /**
+         * Optional catalog-coherence precondition (`catalog/blocks`
+         * `activeTheme.selectionVersion`); mismatch → 409 tag `STALE_CATALOG`.
+         */
+        baseSelectionVersion?: number;
     }, {
         siteId: string;
         identifier: string;
@@ -449,6 +469,13 @@ export type SitePlatformAPIEndpoints = {
         contentType: string;
         data: Record<string, unknown>;
         slug?: string;
+        /**
+         * Raw display ordinal, only accepted for content types with
+         * `ordering.mode: 'manual'` (400 fieldError otherwise). The server never
+         * displaces other entries; equal ordinals resolve deterministically by
+         * (manualOrder ASC, createdAt ASC, id ASC). Callers wanting insert-at-
+         * position semantics reassign ordinals for the affected entries.
+         */
         manualOrder?: number;
         blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
         publication?: 'draft' | 'publish';
@@ -484,6 +511,7 @@ export type SitePlatformAPIEndpoints = {
         identifier: string;
     }, SdkPublishOrUnpublishEntryResponse>;
     sdkUpdateSettings: APIEndpoint<{
+        siteTitle?: string;
         homepageId?: string | null;
         seoDefaults?: SdkPullSettings['seoDefaults'];
         logoIdentifier?: string | null;

package/dist/_dts/api/src/siteRuntimeEndpoints.d.ts

@@ -26,37 +26,43 @@ export type SiteThemeSelectionsPayload = {
     headerLookId?: HeaderLookId | null;
     footerLookId?: FooterLookId | null;
 };
-export type ApplySiteStyleSelectionCommonBody = Readonly<{
-    siteStyleId: SiteStyleId;
-    /** Omitted or `null` selects the first button personality recommended by the site style; a value selects that personality. */
-    buttonPersonalityId?: ButtonPersonalityId | null;
-    /** Omitted selects the site style's authoritative concrete typography; a value applies submitted concrete typography. */
-    typography?: Theme['typography'];
-    /** Omitted or `null` selects the first header Look recommended by the site style; a value selects that Look. When both header pair fields are omitted, a supplied Look derives the canonical pair when it has one. */
-    headerLookId?: HeaderLookId | null;
-    /** Omitted or `null` selects the first footer Look recommended by the site style; a value selects that Look. */
-    footerLookId?: FooterLookId | null;
-    baseSelectionVersion: number;
-    /** Omitted or `null` lets the server target the current selection; a value targets that selection row. */
-    selectionId?: string | null;
+export type SiteStyleHeaderSelectionChange = Readonly<{
+    kind: 'default';
+}> | Readonly<{
+    kind: 'legacy';
+    headerLookId: HeaderLookId | null;
+}> | Readonly<{
+    kind: 'canonical';
+    headerLookId: HeaderLookId | null;
+    layoutId: HeaderLayoutId;
+    styleId: HeaderStyleId;
 }>;
-export type ApplySiteStyleSelectionHeaderBody = Readonly<{
-    /** Omit both fields to use the curated site style's canonical header default; when `headerLookId` is supplied, derive the pair from that Look when it has a canonical alias. */
-    headerLayoutId?: undefined;
-    headerStyleId?: undefined;
+export type SiteStyleSelectionChange = Readonly<{
+    kind: 'set-site-style';
+    siteStyleId: SiteStyleId;
 }> | Readonly<{
-    /** Send both fields as `null` to use the legacy header default. */
-    headerLayoutId: null;
-    headerStyleId: null;
+    kind: 'set-button-personality';
+    buttonPersonalityId: ButtonPersonalityId | null;
 }> | Readonly<{
-    /** Canonical header selections are atomic: layout and style must be supplied together. */
-    headerLayoutId: HeaderLayoutId;
-    headerStyleId: HeaderStyleId;
+    kind: 'set-palette';
+    command: PaletteCommand;
+}> | Readonly<{
+    kind: 'set-typography';
+    typography: Theme['typography'] | null;
+}> | Readonly<{
+    kind: 'set-header';
+    selection: SiteStyleHeaderSelectionChange;
+}> | Readonly<{
+    kind: 'set-footer-look';
+    footerLookId: FooterLookId | null;
+}>;
+export type ApplySiteStyleSelectionBody = Readonly<{
+    baseSelectionVersion: number;
+    /** Omitted or `null` lets the server target the current selection. */
+    selectionId?: string | null;
+    /** A non-empty, unique-axis batch. Unmentioned axes are preserved. */
+    changes: readonly [SiteStyleSelectionChange, ...SiteStyleSelectionChange[]];
 }>;
-export type ApplySiteStyleSelectionBody = ApplySiteStyleSelectionCommonBody & Readonly<{
-    /** Omitted selects the site style's recommended curated palette; a command applies that palette operation. */
-    paletteCommand?: PaletteCommand;
-}> & ApplySiteStyleSelectionHeaderBody;
 export type ApplySiteStyleSelectionResponse = Readonly<{
     success: boolean;
     themeId: string;

package/dist/_dts/block-form/src/widgets/BackgroundGradientWidget/BackgroundGradientField.d.ts

@@ -1,6 +1,7 @@
 import type { ReactNode } from 'react';
 import type { FieldWidgetProps } from '../../fields/props';
 import type { TextFieldConfig } from '../../fields/types';
+import { type GradientConfig } from '../../../../blocks/src/index';
 /**
  * BackgroundGradientField
  *
@@ -11,3 +12,11 @@ import type { TextFieldConfig } from '../../fields/types';
  * This is registered as a widget override with key 'backgroundGradient'.
  */
 export declare function BackgroundGradientField({ path, backend, config, }: FieldWidgetProps<string | null, TextFieldConfig>): ReactNode;
+/**
+ * Attempts to find a preset that matches the given CSS gradient string.
+ *
+ * This is a best-effort reverse lookup - if the CSS was generated from a preset,
+ * we can find and highlight that preset. If it's custom CSS, we return null
+ * and the widget shows no selection.
+ */
+export declare function findPresetFromCss(css: string | null, tokens: Record<string, string>): GradientConfig | null;

package/dist/_dts/block-form/src/widgets/BackgroundGradientWidget/BackgroundGradientWidget.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { GradientConfig } from '../../../../blocks/src/index';
+import { type GradientConfig, type GradientPreset } from '../../../../blocks/src/index';
 export type BackgroundGradientWidgetProps = {
     label: string;
     value: GradientConfig | null;
@@ -9,9 +9,8 @@ export type BackgroundGradientWidgetProps = {
     dataPath?: string;
 };
 /**
- * BackgroundGradientWidget
- *
  * Select a curated gradient from the theme-based library.
  * Gradients use theme color tokens, so they adapt to the site's palette.
  */
-export declare function BackgroundGradientWidget(props: BackgroundGradientWidgetProps): import("react").JSX.Element;
+export declare function BackgroundGradientWidget({ label, value, onChange, description, error, dataPath, }: BackgroundGradientWidgetProps): import("react").JSX.Element;
+export declare function gradientConfigFromPreset(preset: GradientPreset): GradientConfig;

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -256,7 +256,7 @@ export declare const proofBlockIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -279,7 +279,7 @@ export declare const proofBlockIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1342,7 +1342,7 @@ export declare const runtimeIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;
@@ -1365,7 +1365,7 @@ export declare const runtimeIslandCodecs: {
                     className: string | null;
                     titleText: string;
                     bodyText: string;
-                    stepLabels: readonly ("Details" | "Date" | "Event" | "Tickets" | "Payment")[];
+                    stepLabels: readonly ("Date" | "Event" | "Tickets" | "Details" | "Payment")[];
                     summaryButtonText: string;
                 }>;
                 hydration: Readonly<Omit<import("../system/runtime/nodes/event-registration").EventRegistrationClientProps, "siteId" | "stage" | "className" | "buttonText" | "registrationEndpoint" | "eligibilityEndpoint" | "checkoutEndpoint">>;

package/dist/_dts/blocks/src/index.d.ts

@@ -13,7 +13,7 @@ export * from '../../theme-core/src/schema';
 export * from '../../theme-core/src/site-styles/index';
 export * from '../../theme-core/src/styles/buttons';
 export * from '../../theme-core/src/styles/buttonsLibrary';
-export { type ButtonBackground, type ButtonBorder, type ButtonGlobalSettings, type ButtonSystem, type ButtonVariant, type CornerStyle, type EffectApplication, type FontWeight, type GradientSharpness, type GradientStyle, type HoverColor, type HoverTransform, type ShadowSize, type TextTransform, buttonBackgroundSchema, buttonBorderSchema, buttonGlobalSettingsSchema, buttonSystemSchema, buttonVariantSchema, cornerStyleSchema, effectApplicationSchema, fontWeightSchema, gradientSharpnessSchema, gradientStyleSchema, hoverColorSchema, hoverTransformSchema, shadowSizeSchema, textTransformSchema, generateButtonCss, generateDefaultButtonSystem, buttonPresets, type ButtonPreset, EFFECT_PRESETS, getEffectPreset, getEffectPresetsByCategory, getAllEffectPresets, type EffectCategory, type EffectPreset, type EffectContext, type StateGroup, generateButtonCoreCss, getDefaultButtonVariants, type ButtonVariantCore, type ButtonCoreSettings, type ButtonBackgroundType, type GradientDirection, } from '../../theme-core/src/buttons/index';
+export { type ButtonBackground, type ButtonBorder, type ButtonGlobalSettings, type ButtonSystem, type ButtonVariant, type CornerStyle, type EffectApplication, type FontWeight, type GradientSharpness, type GradientStyle, type HoverColor, type HoverTransform, type ShadowSize, type TextTransform, buttonBackgroundSchema, buttonBorderSchema, buttonGlobalSettingsSchema, buttonSystemSchema, buttonVariantSchema, cornerStyleSchema, effectApplicationSchema, fontWeightSchema, gradientSharpnessSchema, gradientStyleSchema, hoverColorSchema, hoverTransformSchema, shadowSizeSchema, textTransformSchema, generateButtonCss, generateDefaultButtonSystem, buttonPresets, type ButtonPreset, EFFECT_PRESETS, getEffectPreset, getEffectPresetsByCategory, getAllEffectPresets, type EffectCategory, type EffectPreset, type EffectContext, type StateGroup, generateButtonCoreCss, getDefaultButtonVariants, type ButtonVariantCore, type ButtonCoreSettings, type GradientDirection, } from '../../theme-core/src/buttons/index';
 export { type CardBackground, type CardBorder, type CardSpacing, type CardSystem, type CardVariant, type CardVariantRole, type BoxStylesCardVariant, cardBackgroundSchema, cardBorderSchema, cardSpacingSchema, cardSystemSchema, cardVariantSchema, cardVariantRoleSchema, boxStylesCardVariantSchema, normalizeCardVariantRole, normalizeBoxStylesCardVariant, generateCardCss, generateDefaultCardSystem, generateCardCoreCss, getDefaultCardVariants, type CardVariantCore, type CardCoreSettings, type CardBackgroundType, type CardSpacingCore, } from '../../theme-core/src/cards/index';
 export { generateInputCoreCss, getDefaultInputSettings, type InputCoreSettings, } from '../../theme-core/src/inputs/core';
 export * from '../../theme-core/src/tokens/index';

package/dist/_dts/blocks/src/system/blocks/audio-player.d.ts

@@ -5,6 +5,9 @@ export declare const audioPlayerManifest: import("..").DefinedBlockManifest<impo
     readonly title: "Audio Player";
     readonly titleSource: "title";
     readonly category: "media";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly description: "Add a branded audio player for a single track.";
     readonly tags: readonly ["audio", "player", "music", "podcast", "media"];
     readonly icon: "AudioLines";

package/dist/_dts/blocks/src/system/blocks/body-text.d.ts

@@ -5,6 +5,9 @@ export declare const bodyTextManifest: import("..").DefinedBlockManifest<import(
     readonly title: "Body Text";
     readonly titleSource: "heading";
     readonly category: "content";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{

package/dist/_dts/blocks/src/system/blocks/contact-newsletter.d.ts

@@ -8,6 +8,9 @@ export declare const contactNewsletterManifest: import("..").DefinedBlockManifes
     readonly titleSource: "contactTitle";
     readonly description: "Two-column newsletter signup and contact form section.";
     readonly category: "interactive";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly layout: import("..").NodeDefinition;
     readonly defaultVariant: "default";
     readonly variants: {

package/dist/_dts/blocks/src/system/blocks/course-registration.d.ts

@@ -111,28 +111,7 @@ export declare const courseRegistrationManifest: import("..").DefinedBlockManife
         readonly multiline: false;
         readonly defaultValue: "Sign up";
         readonly maxLength: 40;
-    }, {
-        readonly id: "buttonVariant";
-        readonly type: "select";
-        readonly label: "Button style";
-        readonly description: "Choose a button style from your theme";
-        readonly required: false;
-        readonly multiple: false;
-        readonly defaultValue: "primary";
-        readonly options: [{
-            readonly value: "primary";
-            readonly label: "Primary";
-        }, {
-            readonly value: "secondary";
-            readonly label: "Secondary";
-        }, {
-            readonly value: "outline";
-            readonly label: "Outline";
-        }];
-        readonly ui: {
-            readonly intent: "style";
-        };
-    }];
+    }, import("../../../../block-form/src/backend/index").FieldDefinition];
 }>;
 export type CourseRegistrationContent = {
     heading?: string | null;

package/dist/_dts/blocks/src/system/blocks/cta-full.d.ts

@@ -5,6 +5,9 @@ declare const ctaFullConfig: {
     readonly id: "block.cta-full";
     readonly title: "Full-width CTA";
     readonly category: "marketing";
+    readonly contentSource: {
+        readonly kind: "inline";
+    };
     readonly fragments: readonly [{
         readonly fragment: import("..").DefinedFragment<{
             readonly fields: readonly [{