@riverbankcms/sdk 0.76.0 → 0.77.0

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.state.d.ts

@@ -12,7 +12,7 @@
  */
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, HeaderLookId } from '../../../../theme-core/src/site-styles/index';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderStyleId, type TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionFallbackWarning, SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
 export type StyleConfiguratorSaveStatus = Readonly<{
     kind: 'idle';
@@ -24,7 +24,7 @@ export type StyleConfiguratorSaveStatus = Readonly<{
     kind: 'failed';
     message: string;
 }>;
-export type StyleConfiguratorExpandedRow = 'style' | 'header' | 'footer' | 'buttons' | 'palette' | 'colours' | null;
+export type StyleConfiguratorExpandedRow = 'style' | 'header-layout' | 'header-style' | 'footer' | 'buttons' | 'typography' | 'palette' | 'colours' | null;
 /**
  * Configurator-level notices that aren't compiler selection fallback warnings.
  * Kept separate from `SelectionFallbackWarning` (which comes from
@@ -40,11 +40,16 @@ export type SelectionSnapshot = Readonly<{
     siteStyleId: SiteStyleId;
     selectionVersion: number;
     selectionUpdatedAt?: string | null;
+    headerLayoutId: HeaderLayoutId;
+    headerStyleId: HeaderStyleId;
     headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId | null;
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
+    typographyPresetId: TypographyPresetId | null;
+    typographyBodyFontOverride: string | null;
+    typographyHeadingFontOverride: string | null;
 }>;
 type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
 export type StyleConfiguratorState = Readonly<{
@@ -74,8 +79,13 @@ export declare function openRow(state: StyleConfiguratorState, row: Exclude<Styl
 export declare function isPreviewingChange(state: StyleConfiguratorState): boolean;
 export declare function previewSiteStyle(state: StyleConfiguratorState, siteStyleId: SiteStyleId): StyleConfiguratorState;
 export declare function previewButtonPersonality(state: StyleConfiguratorState, buttonPersonalityId: ButtonPersonalityId): StyleConfiguratorState;
-export declare function previewHeaderLook(state: StyleConfiguratorState, headerLookId: HeaderLookId | null): StyleConfiguratorState;
+export declare function previewHeaderLayout(state: StyleConfiguratorState, headerLayoutId: HeaderLayoutId): StyleConfiguratorState;
+export declare function previewHeaderStyle(state: StyleConfiguratorState, headerStyleId: HeaderStyleId): StyleConfiguratorState;
 export declare function previewFooterLook(state: StyleConfiguratorState, footerLookId: FooterLookId | null): StyleConfiguratorState;
+export declare function previewTypographyPreset(state: StyleConfiguratorState, typographyPresetId: TypographyPresetId): StyleConfiguratorState;
+export declare function setTypographyBodyFontOverride(state: StyleConfiguratorState, typographyBodyFontOverride: string | null): StyleConfiguratorState;
+export declare function setTypographyHeadingFontOverride(state: StyleConfiguratorState, typographyHeadingFontOverride: string | null): StyleConfiguratorState;
+export declare function clearTypographyFontOverrides(state: StyleConfiguratorState): StyleConfiguratorState;
 export declare function previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
 export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
 /**
@@ -89,7 +99,7 @@ export declare function setPaletteOverrides(state: StyleConfiguratorState, palet
  * under the previous palette ID and any draft for the new palette is restored.
  */
 export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
-    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId'>;
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId' | 'headerLayoutId' | 'headerStyleId' | 'headerLookId' | 'typographyPresetId' | 'typographyBodyFontOverride' | 'typographyHeadingFontOverride'>;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>): StyleConfiguratorState;
 export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;

package/dist/_dts/preview-next/src/client/preview/previewDesignCoordinator.d.ts

@@ -0,0 +1,73 @@
+import type { Theme } from '../../../../blocks/src/index';
+import type { Rfc6902Op } from '../utils/rfc6902';
+import type { PreviewThemeOverlaySource } from './themeOverlay';
+export type PreviewDesignProducer = 'ai-designer' | 'style-configurator' | 'site-chrome';
+export type PreviewDesignSurface = 'theme-json-patch' | 'site-style' | 'site-chrome';
+type ActivePreviewDesignState = Readonly<{
+    kind: 'active';
+    owner: PreviewDesignProducer;
+    surface: PreviewDesignSurface;
+    apply: 'idle' | 'pending';
+}>;
+export type PreviewDesignState = Readonly<{
+    kind: 'idle';
+}> | ActivePreviewDesignState;
+export type PreviewDesignCommand = Readonly<{
+    kind: 'preview-theme-patch';
+    producer: PreviewDesignProducer;
+    ops: readonly Rfc6902Op[];
+}> | Readonly<{
+    kind: 'preview-theme';
+    producer: PreviewDesignProducer;
+    theme: Theme;
+    sourcePlan: Exclude<PreviewDesignSurface, 'theme-json-patch'>;
+}> | Readonly<{
+    kind: 'clear-preview';
+    producer: PreviewDesignProducer;
+}> | Readonly<{
+    kind: 'base-theme-changed';
+}> | Readonly<{
+    kind: 'apply-started';
+    producer: PreviewDesignProducer;
+}> | Readonly<{
+    kind: 'apply-succeeded';
+    producer: PreviewDesignProducer;
+}> | Readonly<{
+    kind: 'apply-failed';
+    producer: PreviewDesignProducer;
+}>;
+export type PreviewThemeOverlayEffect = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'clear';
+}> | Readonly<{
+    kind: 'set-patch';
+    source: PreviewThemeOverlaySource;
+    ops: readonly Rfc6902Op[];
+}> | Readonly<{
+    kind: 'set-theme';
+    source: PreviewThemeOverlaySource;
+    theme: Theme;
+}>;
+export type PreviewDesignIgnoredReason = 'no-active-preview' | 'producer-does-not-own-preview' | 'apply-event-for-displaced-preview';
+export type PreviewDesignTransition = Readonly<{
+    kind: 'accepted';
+    state: PreviewDesignState;
+    effect: PreviewThemeOverlayEffect;
+}> | Readonly<{
+    kind: 'ignored';
+    state: PreviewDesignState;
+    reason: PreviewDesignIgnoredReason;
+}>;
+export declare const NO_PREVIEW_DESIGN_STATE: PreviewDesignState;
+/**
+ * Owns preview-design replacement semantics for all theme-like preview producers.
+ *
+ * Policy:
+ * - preview commands are deterministic last-writer-wins, including cross-producer replacement
+ * - clear/apply commands only affect the producer that still owns the active preview
+ * - stale apply results from displaced producers are ignored so they cannot clear a newer preview
+ * - base theme refresh is a coordinator-level command, not a producer clear
+ */
+export declare function transitionPreviewDesignState(state: PreviewDesignState, command: PreviewDesignCommand): PreviewDesignTransition;
+export {};

package/dist/_dts/preview-next/src/client/preview/siteChromeLookRows.d.ts

@@ -1,5 +1,5 @@
 import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
-import { type FooterLookId, type FooterSelectionContext, type HeaderLookId, type HeaderSelectionContext, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import { type FooterLookId, type FooterSelectionContext, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
 export type SiteChromeLookOption<TId extends string | null> = Readonly<{
     id: TId;
@@ -17,7 +17,14 @@ export type SiteChromeLookRowModel<TId extends string> = Readonly<{
     renderedLookId: TId;
 }>;
 export type SiteChromeLookModels = Readonly<{
-    header: SiteChromeLookRowModel<HeaderLookId>;
+    headerLayout: Readonly<{
+        options: readonly SiteChromeLookOption<HeaderLayoutId>[];
+        renderedLayoutId: HeaderLayoutId;
+    }>;
+    headerStyle: Readonly<{
+        options: readonly SiteChromeLookOption<HeaderStyleId>[];
+        renderedStyleId: HeaderStyleId;
+    }>;
     footer: SiteChromeLookRowModel<FooterLookId>;
 }>;
 type SiteChromeLookModelInput = Readonly<{
@@ -31,7 +38,8 @@ export declare function cycleSiteChromeLookId<TId extends string>(options: reado
 export declare function cycleableSiteChromeOptions<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[]): readonly SiteChromeLookOption<TId | null>[];
 export type SiteChromeLookSelectionCommand = Readonly<{
     surface: 'header';
-    lookId: HeaderLookId | null;
+    layoutId: HeaderLayoutId;
+    styleId: HeaderStyleId;
 }> | Readonly<{
     surface: 'footer';
     lookId: FooterLookId | null;
@@ -39,7 +47,7 @@ export type SiteChromeLookSelectionCommand = Readonly<{
 export type SiteChromeLookSelectionPlan = Readonly<{
     kind: 'header';
     writePlan: LookCustomizationWritePlan<HeaderLookId>;
-    next: Pick<SelectionSnapshot, 'headerLookId'>;
+    next: Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
 }> | Readonly<{
     kind: 'footer';
     writePlan: LookCustomizationWritePlan<FooterLookId>;

package/dist/_dts/preview-next/src/client/preview/siteStylePreviewPlanner.d.ts

@@ -0,0 +1,46 @@
+import type { Theme } from '../../../../blocks/src/index';
+import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
+import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
+import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
+import { type CuratedSiteStyle, type SelectionFallbackWarning, type SiteStyleId } from '../../../../theme-core/src/site-styles/previewCompiler';
+export type SiteStylePreviewSelection = Readonly<{
+    siteStyleId: SiteStyleId;
+    buttonPersonalityId: ButtonPersonalityId;
+    paletteVariantId: PaletteVariantId;
+    paletteOverrides: PaletteOverrides | null;
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
+    headerLayoutId?: HeaderLayoutId | null;
+    headerStyleId?: HeaderStyleId | null;
+    headerLookId: HeaderLookId | null;
+    footerLookId: FooterLookId | null;
+}>;
+export type SiteStyleChromePreviewSelection = Readonly<{
+    headerLookId: HeaderLookId | null;
+    footerLookId: FooterLookId | null;
+}>;
+export type SiteStylePreviewPlan = Readonly<{
+    themeOverlay: Theme;
+    resolvedSelections: Readonly<{
+        buttonPersonalityId: ButtonPersonalityId;
+        paletteVariantId: PaletteVariantId;
+        typographyPresetId: TypographyPresetId | null;
+        typographyBodyFontOverride: string | null;
+        typographyHeadingFontOverride: string | null;
+        headerLayoutId: HeaderLayoutId;
+        headerStyleId: HeaderStyleId;
+        headerLookId: HeaderLookId | null;
+        footerLookId: FooterLookId;
+    }>;
+    chromeSelection: SiteStyleChromePreviewSelection;
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
+}>;
+export type SiteStylePreviewPlanInput = Readonly<{
+    siteStyle: CuratedSiteStyle;
+    selection: SiteStylePreviewSelection;
+    baseTheme?: Theme | null;
+    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    footerSelectionContext?: Partial<FooterSelectionContext>;
+}>;
+export declare function planSiteStylePreviewChange(input: SiteStylePreviewPlanInput): SiteStylePreviewPlan;

package/dist/_dts/preview-next/src/client/preview/styleConfiguratorSnapshot.d.ts

@@ -1,7 +1,7 @@
 import type { Theme } from '../../../../blocks/src/index';
 import type { ButtonPersonalityId } from '../../../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../../../theme-core/src/palette/index';
-import type { FooterLookId, FooterSelectionContext, HeaderLookId, HeaderSelectionContext } from '../../../../theme-core/src/site-styles/index';
+import type { FooterLookId, FooterSelectionContext, HeaderLayoutId, HeaderLookId, HeaderSelectionContext, HeaderStyleId, TypographyPresetId } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<{
     theme?: Theme | null;
@@ -11,6 +11,11 @@ export declare function resolveStyleConfiguratorInitialSnapshot(input: Readonly<
         buttonPersonalityId: ButtonPersonalityId | null;
         paletteVariantId: PaletteVariantId | null;
         paletteOverrides: PaletteOverrides | null;
+        headerLayoutId?: HeaderLayoutId | null;
+        headerStyleId?: HeaderStyleId | null;
+        typographyPresetId?: TypographyPresetId | null;
+        typographyBodyFontOverride?: string | null;
+        typographyHeadingFontOverride?: string | null;
         headerLookId?: HeaderLookId | null;
         footerLookId?: FooterLookId | null;
     }>;

package/dist/_dts/preview-next/src/client/preview/typographySelectionInput.d.ts

@@ -0,0 +1,14 @@
+import type { Theme } from '../../../../blocks/src/index';
+import type { TypographyPresetId, TypographySelection } from '../../../../theme-core/src/site-styles/previewCompiler';
+type TypographySelectionSnapshot = Readonly<{
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
+}>;
+export declare function typographySelectionInputForSnapshot(snapshot: TypographySelectionSnapshot, theme: Theme | null | undefined): Readonly<{
+    typographySelection?: TypographySelection;
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
+}>;
+export {};

package/dist/_dts/preview-next/src/client/sdk/SdkPreviewModeRuntime.d.ts

@@ -1,2 +1,2 @@
-import type { SdkPreviewModeProps } from "./SdkPreviewMode";
+import type { SdkPreviewModeProps } from './SdkPreviewMode';
 export declare function SdkPreviewModeRuntime(props: SdkPreviewModeProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/sdk/src/cli/commands/style.d.ts

@@ -13,7 +13,12 @@ export type StyleApplyOptions = Readonly<{
     buttonPersonalityId?: string;
     paletteVariantId?: string;
     paletteOverrides?: string;
+    typographyPresetId?: string;
+    typographyBodyFontOverride?: string;
+    typographyHeadingFontOverride?: string;
     headerLookId?: string;
+    headerLayoutId?: string;
+    headerStyleId?: string;
     footerLookId?: string;
 }>;
 export type StyleCatalogListOptions = Readonly<{
@@ -28,6 +33,9 @@ export type StyleCatalogListRow = Readonly<{
     name: string;
     palettes: readonly StyleCatalogChoice[];
     buttonPersonalities: readonly StyleCatalogChoice[];
+    typographyPresets: readonly StyleCatalogChoice[];
+    headerLayouts: readonly StyleCatalogChoice[];
+    headerStyles: readonly StyleCatalogChoice[];
     headerLooks: readonly StyleCatalogChoice[];
     footerLooks: readonly StyleCatalogChoice[];
 }>;

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -484,7 +484,12 @@ export interface ThemeStyleSelectionApplyResult {
     buttonPersonalityId: string;
     paletteVariantId: string;
     paletteOverrides: Record<string, string> | null;
-    headerLookId: string;
+    headerLookId: string | null;
+    headerLayoutId: string;
+    headerStyleId: string;
+    typographyPresetId: string | null;
+    typographyBodyFontOverride: string | null;
+    typographyHeadingFontOverride: string | null;
     footerLookId: string;
 }
 /**

package/dist/_dts/sdk/src/client/types.d.ts

@@ -200,6 +200,9 @@ export type SdkAuthConfig = {
     type: 'bearer';
     token: string;
 };
+export declare const SDK_CORRELATION_HEADER_NAMES: readonly ["x-request-id", "x-correlation-id", "x-riverbank-monitor-run-id"];
+export type SdkCorrelationHeaderName = typeof SDK_CORRELATION_HEADER_NAMES[number];
+export type SdkCorrelationHeaders = Readonly<Partial<Record<SdkCorrelationHeaderName, string>>>;
 /**
  * Configuration for creating a Riverbank CMS client
  */
@@ -236,6 +239,12 @@ export interface RiverbankClientConfig {
      * Base URL for the Riverbank CMS API (required; e.g. https://dashboard.example.com/api)
      */
     baseUrl: string;
+    /**
+     * Correlation headers to attach to every SDK API request.
+     *
+     * Per-request headers still win when an individual SDK method supplies `options.headers`.
+     */
+    defaultHeaders?: SdkCorrelationHeaders;
     /**
      * Cache configuration
      */

package/dist/_dts/sdk/src/client.d.ts

@@ -30,4 +30,4 @@ export { Page } from './rendering/components/Page';
 export type { PageProps } from './rendering/components/Page';
 export type { ContentEntryData } from './rendering/helpers/loadContent';
 export { createRiverbankClient } from './client/index';
-export type { RiverbankClient, RiverbankClientConfig } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, } from './client/types';

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -10,6 +10,7 @@ type UnknownRecord = Record<string, unknown>;
 type ImageMedia = Omit<Media, 'type'> & {
     type: 'image';
 };
+type StandardAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type ImageColSize = '1/4' | '1/3' | '2/5' | '1/2' | '2/3';
 export type SectionStylesContent = {
@@ -94,6 +95,24 @@ export type BodyTextContent = {
     body: TipTapNode;
     alignment?: BodyTextAlignment | null;
 };
+export type BlockCtaContent = {
+    label?: string | null;
+    href?: string | null;
+    link?: unknown;
+    variant?: string | null;
+    size?: string | null;
+};
+export type IntroContent = {
+    variant?: 'centered-copy' | 'statement-copy' | 'statement-media' | 'media-copy' | null;
+    title?: string | null;
+    body: TipTapNode;
+    media?: Media | null;
+    imagePosition?: 'left' | 'right' | null;
+    gap?: SemanticSpacing | null;
+    ratio?: ImageColSize | null;
+    aspectRatio?: StandardAspectRatio | null;
+    ctas?: BlockCtaContent[] | null;
+};
 export type CollectionContent = {
     layout?: 'grid' | 'stack' | null;
     columns?: string | number | null;
@@ -293,6 +312,20 @@ export type FaqContent = {
     items?: FaqItem[] | null;
     _containerStyles?: ContainerStylesContent;
 };
+export type FeatureCard = {
+    media?: Media | null;
+    aspectRatio?: StandardAspectRatio | null;
+    title: string;
+    body?: TipTapNode | null;
+    ctas?: BlockCtaContent[] | null;
+};
+export type FeatureCardsContent = {
+    variant?: 'cards' | null;
+    title?: string | null;
+    description?: TipTapNode | null;
+    columns?: '2' | '3' | '4' | null;
+    cards?: FeatureCard[] | null;
+};
 export type HeroCta = {
     label: string;
     link: LinkValue;
@@ -582,8 +615,10 @@ export type GiftingContent = {
 };
 export type SystemBlockContentByFullKind = {
     'block.hero': HeroContent;
+    'block.intro': IntroContent;
     'block.columns': ColumnsContent;
     'block.collection': CollectionContent;
+    'block.feature-cards': FeatureCardsContent;
     'block.media-text': MediaTextContent;
     'block.cta-full': CtaFullContent;
     'block.single-button': SingleButtonContent;

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

@@ -18,7 +18,8 @@
  * @packageDocumentation
  */
 export { createRiverbankClient, RiverbankApiError } from './client/index';
-export type { RiverbankClient, RiverbankClientConfig, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceStatus, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
+export { SDK_CORRELATION_HEADER_NAMES } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, SdkAuthConfig, SiteResponse, PageResponse, EntriesResponse, EntriesResponseWithMeta, PaginationMeta, EntryResponse, ResilienceConfig, ResilienceStatus, ResilienceSource, CircuitState, RetryConfig, CircuitBreakerConfig, } from './client/types';
 export { prebuildCache } from './prebuild/index';
 export type { PrebuildOptions, PrebuildResult, PrebuildProgress, PrebuildManifest, PrebuildContentType, } from './prebuild/types';
 export { PrebuildLoader, createPrebuildLoader, canUsePrebuild, } from './prebuild/loader';

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -307,6 +307,11 @@ export type SiteResponse = {
     selectionButtonPersonalityId?: string | null;
     selectionPaletteVariantId?: string | null;
     selectionPaletteOverrides?: Record<string, string> | null;
+    selectionHeaderLayoutId?: string | null;
+    selectionHeaderStyleId?: string | null;
+    selectionTypographyPresetId?: string | null;
+    selectionTypographyBodyFontOverride?: string | null;
+    selectionTypographyHeadingFontOverride?: string | null;
     selectionHeaderLookId?: string | null;
     selectionFooterLookId?: string | null;
     navigation: NavigationMenuWithItems[];

package/dist/_dts/sdk/src/types/block-kinds.d.ts

@@ -7,7 +7,7 @@
  * `@riverbankcms/blocks` (which is not a public dependency). This list is a
  * stable public contract; keep it in sync with the internal blocks runtime.
  */
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.columns", "block.collection", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.76.0";
+export declare const SDK_VERSION = "0.77.0";

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

@@ -43,7 +43,12 @@ export declare const applySiteStyleSelectionCommandSchema: z.ZodObject<{
         buttonPersonalityId: z.ZodNullable<z.ZodString>;
         paletteVariantId: z.ZodNullable<z.ZodString>;
         paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        typographyPresetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typographyBodyFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typographyHeadingFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         headerLookId: z.ZodNullable<z.ZodString>;
+        headerLayoutId: z.ZodString;
+        headerStyleId: z.ZodString;
         footerLookId: z.ZodNullable<z.ZodString>;
         baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
@@ -990,7 +995,12 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         buttonPersonalityId: z.ZodNullable<z.ZodString>;
         paletteVariantId: z.ZodNullable<z.ZodString>;
         paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        typographyPresetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typographyBodyFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        typographyHeadingFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         headerLookId: z.ZodNullable<z.ZodString>;
+        headerLayoutId: z.ZodString;
+        headerStyleId: z.ZodString;
         footerLookId: z.ZodNullable<z.ZodString>;
         baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
@@ -1818,7 +1828,12 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             buttonPersonalityId: z.ZodNullable<z.ZodString>;
             paletteVariantId: z.ZodNullable<z.ZodString>;
             paletteOverrides: z.ZodNullable<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+            typographyPresetId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            typographyBodyFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            typographyHeadingFontOverride: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             headerLookId: z.ZodNullable<z.ZodString>;
+            headerLayoutId: z.ZodString;
+            headerStyleId: z.ZodString;
             footerLookId: z.ZodNullable<z.ZodString>;
             baseSelectionVersion: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>;

package/dist/_dts/theme-core/src/buttons/personalities/earth-pill.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Earth Pill - warm studio pills with compact, primary-coloured ghost CTAs.
+ * Built for grounded editorial wellness styles such as Soft Earth.
+ */
+export declare const earthPill: Readonly<{
+    id: import("./types").ButtonPersonalityId<"earth-pill">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../../../blocks/src/index").StyleTone;
+        energy: import("../../../../blocks/src/index").StyleEnergy;
+        motion: import("../../../../blocks/src/index").StyleMotion;
+        era: import("../../../../blocks/src/index").StyleEra;
+    }>>>;
+    buttonSystem: import("../../../../blocks/src/index").ButtonSystem;
+}>;

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

@@ -20,6 +20,17 @@ export declare const buttonPersonalities: readonly [Readonly<{
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
     buttonSystem: import("../../../../blocks/src/index").ButtonSystem;
+}>, Readonly<{
+    id: ButtonPersonalityId<"earth-pill">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../../../blocks/src/index").StyleTone;
+        energy: import("../../../../blocks/src/index").StyleEnergy;
+        motion: import("../../../../blocks/src/index").StyleMotion;
+        era: import("../../../../blocks/src/index").StyleEra;
+    }>>>;
+    buttonSystem: import("../../../../blocks/src/index").ButtonSystem;
 }>, Readonly<{
     id: ButtonPersonalityId<"confident-chip">;
     name: string;

package/dist/_dts/theme-core/src/fonts/types.d.ts

@@ -3,7 +3,7 @@
  *
  * Used by:
  * - packages/blocks: ThemeFontLoader
- * - apps/dashboard: Font settings, FontPicker
+ * - apps/dashboard: Font settings
  * - apps/frontend: Font loading
  */
 /**

package/dist/_dts/theme-core/src/mock-themes/all.d.ts

@@ -799,6 +799,21 @@ export declare const mockThemes: {
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
+                        headingDecoration?: {
+                            family: "none";
+                            placement: "none";
+                        } | {
+                            family: "organic-squiggle" | "short-center-rule";
+                            placement: "after-heading" | "between-heading-and-body" | "under-centered-heading";
+                            colorToken?: "text" | "primary" | "secondary" | "border" | "muted" | "accent" | undefined;
+                        } | null | undefined;
+                        headingDecorationOverride?: "off" | "site-default" | "on" | null | undefined;
+                        accordionIconTreatment?: {
+                            iconSet: "caret" | "chevron" | "plus" | "minimal-cross";
+                            colorToken: "current" | "text" | "primary" | "secondary" | "muted" | "accent";
+                            motion: "none" | "rotate" | "swap";
+                            openColorToken?: "current" | "text" | "primary" | "secondary" | "muted" | "accent" | undefined;
+                        } | null | undefined;
                     } | null | undefined;
                     containerStyles?: {
                         background?: {
@@ -1770,6 +1785,21 @@ export declare const mockThemes: {
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
+                        headingDecoration?: {
+                            family: "none";
+                            placement: "none";
+                        } | {
+                            family: "organic-squiggle" | "short-center-rule";
+                            placement: "after-heading" | "between-heading-and-body" | "under-centered-heading";
+                            colorToken?: "text" | "primary" | "secondary" | "border" | "muted" | "accent" | undefined;
+                        } | null | undefined;
+                        headingDecorationOverride?: "off" | "site-default" | "on" | null | undefined;
+                        accordionIconTreatment?: {
+                            iconSet: "caret" | "chevron" | "plus" | "minimal-cross";
+                            colorToken: "current" | "text" | "primary" | "secondary" | "muted" | "accent";
+                            motion: "none" | "rotate" | "swap";
+                            openColorToken?: "current" | "text" | "primary" | "secondary" | "muted" | "accent" | undefined;
+                        } | null | undefined;
                     } | null | undefined;
                     containerStyles?: {
                         background?: {
@@ -2741,6 +2771,21 @@ export declare const mockThemes: {
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
+                        headingDecoration?: {
+                            family: "none";
+                            placement: "none";
+                        } | {
+                            family: "organic-squiggle" | "short-center-rule";
+                            placement: "after-heading" | "between-heading-and-body" | "under-centered-heading";
+                            colorToken?: "text" | "primary" | "secondary" | "border" | "muted" | "accent" | undefined;
+                        } | null | undefined;
+                        headingDecorationOverride?: "off" | "site-default" | "on" | null | undefined;
+                        accordionIconTreatment?: {
+                            iconSet: "caret" | "chevron" | "plus" | "minimal-cross";
+                            colorToken: "current" | "text" | "primary" | "secondary" | "muted" | "accent";
+                            motion: "none" | "rotate" | "swap";
+                            openColorToken?: "current" | "text" | "primary" | "secondary" | "muted" | "accent" | undefined;
+                        } | null | undefined;
                     } | null | undefined;
                     containerStyles?: {
                         background?: {

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

@@ -103,6 +103,21 @@ export declare const paletteVariants: readonly [Readonly<{
         name: import("../../../../blocks/src/index").PaletteTokenName;
         hex: string;
     }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"warm-neutral-soft-earth">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../../../blocks/src/index").StyleTone;
+        energy: import("../../../../blocks/src/index").StyleEnergy;
+        motion: import("../../../../blocks/src/index").StyleMotion;
+        era: import("../../../../blocks/src/index").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("../../../../blocks/src/index").PaletteTokenName;
+        hex: string;
+    }>[];
 }>, Readonly<{
     id: PaletteVariantId<"warm-neutral-forest">;
     name: string;