@riverbankcms/sdk 0.76.0 → 0.77.1

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

@@ -351,6 +351,11 @@ export type SiteBySlugResponse = {
     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/api/src/siteAssets.d.ts

@@ -12,6 +12,7 @@ export type FontRecord = {
     family: string;
     variants: string[];
     category: string;
+    popularity?: number;
 };
 export type SiteFontFileRecord = {
     storagePath: string;

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

@@ -1,7 +1,7 @@
 import type { SystemCustomizeFacetSelection, Theme } from '../../blocks/src/index';
 import type { ListMediaAssetsResult, MediaAssetWithLabels } from '@riverbankcms/media-storage-supabase';
 import type { DbJson } from '../../db/src/index';
-import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLookId, LayoutVariantKey, SiteStyleId } from '../../theme-core/src/site-styles/index';
+import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, BoundaryOptionId, DesignBlockId, FooterLookId, HeaderLayoutId, HeaderLookId, HeaderStyleId, LayoutVariantKey, SiteStyleId, TypographyPresetId } from '../../theme-core/src/site-styles/index';
 import type { ButtonPersonalityId } from '../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../theme-core/src/palette/index';
 import type { APIEndpoint } from './apiEndpointTypes';
@@ -23,6 +23,11 @@ export type SiteThemeSelectionsPayload = {
     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;
 };
@@ -31,7 +36,12 @@ export type ApplySiteStyleSelectionBody = Readonly<{
     buttonPersonalityId: ButtonPersonalityId | null;
     paletteVariantId: PaletteVariantId | null;
     paletteOverrides: PaletteOverrides | null;
+    typographyPresetId?: TypographyPresetId | null;
+    typographyBodyFontOverride?: string | null;
+    typographyHeadingFontOverride?: string | null;
     headerLookId: HeaderLookId | null;
+    headerLayoutId?: HeaderLayoutId | null;
+    headerStyleId?: HeaderStyleId | null;
     footerLookId: FooterLookId | null;
     baseSelectionVersion: number;
     selectionId?: string | null;
@@ -48,12 +58,19 @@ export type ApplySiteStyleSelectionResponse = Readonly<{
     buttonPersonalityId: ButtonPersonalityId;
     paletteVariantId: PaletteVariantId;
     paletteOverrides: PaletteOverrides | null;
-    headerLookId: HeaderLookId;
+    headerLayoutId: HeaderLayoutId;
+    headerStyleId: HeaderStyleId;
+    typographyPresetId: TypographyPresetId | null;
+    typographyBodyFontOverride: string | null;
+    typographyHeadingFontOverride: string | null;
+    headerLookId: HeaderLookId | null;
     footerLookId: FooterLookId;
 }>;
 export type SaveSiteChromeLookSelectionBody = Readonly<{
     surface: 'header';
     lookId: HeaderLookId | null;
+    layoutId?: HeaderLayoutId | null;
+    styleId?: HeaderStyleId | null;
     theme: Theme;
     themeId?: string | null;
     selectionId?: string | null;
@@ -74,6 +91,8 @@ export type SaveSiteChromeLookSelectionResponse = Readonly<{
     savedAt: string;
     theme: Theme;
     headerLookId: HeaderLookId | null;
+    headerLayoutId: HeaderLayoutId | null;
+    headerStyleId: HeaderStyleId | null;
     footerLookId: FooterLookId | null;
 }>;
 export type PageDesignRevisionToken = {
@@ -219,6 +238,11 @@ export type SiteRuntimeAPIEndpoints = {
         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/block-form/src/blockDraftSaveability.d.ts

@@ -25,6 +25,34 @@ export type BlockDraftSaveability = Readonly<{
     issues: readonly BlockDraftValidationIssue[];
     error: string;
 }>;
+export type BlockManifestResolution = Readonly<{
+    kind: 'builtinManifest';
+    blockKind: string;
+    manifest: BlockManifest;
+}> | Readonly<{
+    kind: 'sdkCustomManifest';
+    blockKind: string;
+    manifest: BlockManifest;
+}> | Readonly<{
+    kind: 'managedCustomManifest';
+    blockKind: string;
+    manifest: BlockManifest;
+}> | Readonly<{
+    kind: 'unknownCustomBlock';
+    blockKind: string;
+}> | Readonly<{
+    kind: 'unknownBuiltinBlock';
+    blockKind: string;
+}> | Readonly<{
+    kind: 'invalidManifest';
+    blockKind: string;
+    source: 'sdkCustom' | 'managedCustom';
+    reason: string;
+}>;
+export declare function getResolvedBlockManifest(resolution: BlockManifestResolution): BlockManifest | null;
+export declare function isResolvedBlockManifest(resolution: BlockManifestResolution): resolution is Extract<BlockManifestResolution, {
+    kind: 'builtinManifest' | 'sdkCustomManifest' | 'managedCustomManifest';
+}>;
 export declare const unfinishedBlockCopy: {
     readonly title: "Fix this block to save it";
     readonly description: "Some fields need a quick check. Your changes are safe here for now.";

package/dist/_dts/block-form/src/client/index.d.ts

@@ -8,8 +8,8 @@ export { createRHFBackend, createStoreBackend, useBackendWatch } from '../backen
 export type { FormBackend, FieldError, FieldState, SetValueOptions } from '../backend/types';
 export type { ManifestAdapterOptions, ManifestAdapterResult, ManifestFormSource, ManifestSchemaOptions, ManifestValidationResult, } from '../manifest/manifestFormAdapter';
 export { createManifestValidation } from '../manifest/manifestFormAdapter';
-export { formatPublishBlockedMessage, formatRecoveryConflictSummary, formatRecoveryConflictTitle, deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, recoveryConflictCopy, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifest, validateBlockManifestIssues, validateBlockManifestValues, } from './blockDraftSaveability';
-export type { BlockDraftSaveability, BlockDraftValidationIssue, BlockManifestValidationMode, } from './blockDraftSaveability';
+export { formatPublishBlockedMessage, formatRecoveryConflictSummary, formatRecoveryConflictTitle, deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, getResolvedBlockManifest, isResolvedBlockManifest, recoveryConflictCopy, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifest, validateBlockManifestIssues, validateBlockManifestValues, } from './blockDraftSaveability';
+export type { BlockDraftSaveability, BlockDraftValidationIssue, BlockManifestResolution, BlockManifestValidationMode, } from './blockDraftSaveability';
 export type { BaseFieldConfig, FieldConfig, TextFieldConfig, NumberFieldConfig, RichTextFieldConfig, MediaFieldConfig, FileFieldConfig, BooleanFieldConfig, DateFieldConfig, TimeFieldConfig, DateTimeFieldConfig, SlugFieldConfig, UrlFieldConfig, LinkFieldConfig, SelectFieldConfig, ReferenceFieldConfig, GroupFieldConfig, RepeaterFieldConfig, ButtonFieldConfig, ContentTypeSelectFieldConfig, EntryPickerFieldConfig, } from '../fields/types';
 export { createManifestFormAdapter } from '../manifest/manifestFormAdapter';
 export { PaletteProvider, usePalette } from '../palette/PaletteContext';

package/dist/_dts/block-form/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from './client/index';
-export { formatPublishBlockedMessage, formatRecoveryConflictSummary, formatRecoveryConflictTitle, formatUnfinishedBlocksSummary, recoveryConflictCopy, unfinishedBlockCopy, } from './blockDraftSaveability';
+export { formatPublishBlockedMessage, formatRecoveryConflictSummary, formatRecoveryConflictTitle, formatUnfinishedBlocksSummary, getResolvedBlockManifest, isResolvedBlockManifest, recoveryConflictCopy, unfinishedBlockCopy, } from './blockDraftSaveability';
+export type { BlockManifestResolution } from './blockDraftSaveability';
 export { WIDGET_NAMES, type WidgetName } from './widgets';
 export { WidgetField, WidgetFieldMessage } from './widgets';
 export type { WidgetFieldProps, WidgetFieldMessageProps } from './widgets';

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

@@ -1,7 +1,7 @@
 /**
  * Date Field - Validation Schema
  */
-import { z } from 'zod';
+import type { z } from 'zod';
 import type { DateFieldConfig } from '../../fields/types';
 /**
  * Build Zod validation schema for Date field

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

@@ -1,7 +1,7 @@
 /**
  * DateTime Field - Validation Schema
  */
-import { z } from 'zod';
+import type { z } from 'zod';
 import type { DateTimeFieldConfig } from '../../fields/types';
 /**
  * Build Zod validation schema for DateTime field

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

@@ -1,7 +1,7 @@
 /**
  * Time Field - Validation Schema
  */
-import { z } from 'zod';
+import type { z } from 'zod';
 import type { TimeFieldConfig } from '../../fields/types';
 /**
  * Build Zod validation schema for Time field

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

@@ -1,11 +1,11 @@
-import * as React from "react";
-import type { ResolverContext } from "./system";
-import type { PageOutline } from "./structure/schema";
-import type { Theme } from "../../theme-core/src/schema";
-import type { SdkCustomBlock } from "./system/manifest/schema";
-import type { ThemeTokens } from "./system/theme";
-import type { RouteMap } from "./system/transforms";
-import { type MediaAssetIndexItem, type ResolveImageUrlContext, type ResolveImageUrlContextInput } from "./system/runtime/nodes/media";
+import * as React from 'react';
+import type { ResolverContext } from './system';
+import type { PageOutline } from './structure/schema';
+import type { Theme } from '../../theme-core/src/schema';
+import type { SdkCustomBlock } from './system/manifest/schema';
+import type { ThemeTokens } from './system/theme';
+import type { RouteMap } from './system/transforms';
+import { type MediaAssetIndexItem, type ResolveImageUrlContext, type ResolveImageUrlContextInput } from './system/runtime/nodes/media';
 /**
  * Occurrence context for event pages.
  * Passed through to blocks that need occurrence information (e.g., event-registration).
@@ -41,7 +41,7 @@ type PageRendererDataContext = {
     siteId?: string;
     pageId?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
-    previewStage?: "published" | "preview";
+    previewStage?: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;
     entriesByIdentifier?: Record<string, Record<string, string>>;
@@ -152,7 +152,7 @@ interface PageRendererProps {
     dataContext?: PageRendererDataContext;
     routeMap?: RouteMap;
     wrapBlock?: (blockId: string, rendered: React.ReactNode) => React.ReactNode;
-    registry?: ResolverContext["registry"];
+    registry?: ResolverContext['registry'];
     themeTokens?: ThemeTokens;
     blockOverrides?: BlockOverrides;
     sdkConfig?: SdkConfigForRenderer | null;

package/dist/_dts/blocks/src/client/site-chrome.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import type { Theme } from '../../../theme-core/src/schema';
+export type SiteChromeThemeConfigOverride = Readonly<{
+    header?: Partial<NonNullable<Theme['header']>>;
+    footer?: Partial<NonNullable<Theme['footer']>>;
+}>;
+export type SiteChromeBlockRenderSpec = Readonly<{
+    content: Record<string, unknown>;
+    viewModelOverrides: Record<string, unknown>;
+    themeConfigOverride?: SiteChromeThemeConfigOverride;
+    canRenderReactively?: boolean;
+}>;
+export type SiteChromeRenderModel = Readonly<{
+    header: SiteChromeBlockRenderSpec;
+    footer: SiteChromeBlockRenderSpec;
+}>;
+export declare function renderSiteChromeBlock(model: SiteChromeRenderModel, surface: 'header' | 'footer', theme: Theme): ReactNode;
+export declare function SiteChromeBlockRenderer({ model, surface, theme, }: {
+    model: SiteChromeRenderModel;
+    surface: 'header' | 'footer';
+    theme: Theme;
+}): ReactNode;

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

@@ -0,0 +1,57 @@
+import type { BlockDescriptor } from './system/registry';
+import type { BlockManifest, SdkCustomBlock } from './system/manifest/schema';
+import { transformSdkBlockToDefinition, transformSdkBlockToManifest } from './sdkBlockTransform';
+export type SdkConfigForBlockPicker = {
+    customBlocks?: SdkCustomBlock[];
+};
+export type CustomBlockManifestSource = {
+    kind: 'sdk-config';
+} | {
+    kind: 'sdk-synced';
+    syncedAt: string | null;
+    contentHash: string | null;
+} | {
+    kind: 'managed-database';
+};
+export type CustomBlockSourcePolicy = {
+    kind: 'canonical-db-fallback-sdk';
+};
+export type CustomBlockConflictReason = 'db-canonical-sdk-fallback';
+export type CustomBlockRegistryConflict = {
+    kind: 'conflict';
+    blockKind: `custom.${string}`;
+    winner: CustomBlockManifestSource;
+    loser: CustomBlockManifestSource;
+    reason: CustomBlockConflictReason;
+};
+export type CustomBlockRegistryEntry = {
+    manifest: SdkCustomBlock;
+    source: CustomBlockManifestSource;
+};
+export type ResolvedCustomBlockManifest = {
+    blockKind: `custom.${string}`;
+    manifest: BlockManifest;
+    source: CustomBlockManifestSource;
+    descriptor: BlockDescriptor;
+};
+export type CustomBlockRegistry = {
+    entries: readonly ResolvedCustomBlockManifest[];
+    conflicts: readonly CustomBlockRegistryConflict[];
+    findManifest: (blockKind: string) => ResolvedCustomBlockManifest | undefined;
+};
+export type CustomBlockRegistryInput = {
+    sdkConfig?: SdkConfigForBlockPicker | null;
+    customBlocks?: readonly CustomBlockRegistryEntry[];
+    policy?: CustomBlockSourcePolicy;
+    onConflict?: (message: string) => void;
+};
+export type CustomBlockRegistryResolutionPlan = {
+    policy: CustomBlockSourcePolicy;
+    entries: readonly ResolvedCustomBlockManifest[];
+    conflicts: readonly CustomBlockRegistryConflict[];
+};
+declare function transformToBlockDescriptor(sdkBlock: SdkCustomBlock, source?: BlockDescriptor['source']): BlockDescriptor;
+export declare function planCustomBlockRegistryResolution({ sdkConfig, customBlocks, policy, }: Omit<CustomBlockRegistryInput, 'onConflict'>): CustomBlockRegistryResolutionPlan;
+export declare function createCustomBlockRegistry({ sdkConfig, customBlocks, policy, onConflict, }: CustomBlockRegistryInput): CustomBlockRegistry;
+export declare function mergeBlockDescriptorsWithRegistry(systemBlocks: readonly BlockDescriptor[], registry: CustomBlockRegistry, onConflict?: (message: string) => void): BlockDescriptor[];
+export { transformSdkBlockToManifest, transformSdkBlockToDefinition, transformToBlockDescriptor, };

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

@@ -1,4 +1,6 @@
 export { default as PageRenderer } from './PageRenderer';
+export { createCustomBlockRegistry, mergeBlockDescriptorsWithRegistry, planCustomBlockRegistryResolution, transformToBlockDescriptor, } from './customBlockRegistry';
+export type { CustomBlockConflictReason, CustomBlockManifestSource, CustomBlockRegistry, CustomBlockRegistryConflict, CustomBlockRegistryEntry, CustomBlockRegistryResolutionPlan, CustomBlockSourcePolicy, ResolvedCustomBlockManifest, SdkConfigForBlockPicker, } from './customBlockRegistry';
 export type { BlockOverrideComponent, BlockOverrideProps, BlockOverrides, EntrySubrouteContextData, OccurrenceContextData, SdkConfigForRenderer, } from './PageRenderer';
 export * from './subroutes';
 export * from './primitives/content/components/Button';

package/dist/_dts/blocks/src/system/blocks/faq.d.ts

@@ -1,5 +1,6 @@
 import type { SystemBlockDefinition } from "../registry";
-import { type CardStylesContent, type ContainerStylesContent } from "../fields/boxStyles";
+import type { NodeDefinition } from "../node";
+import { type CardStylesContent, type ContainerStylesContent, type SectionStylesContent } from "../fields/boxStyles";
 export declare const faqManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
     readonly id: "block.faq";
     readonly title: "FAQ";
@@ -30783,7 +30784,22 @@ export declare const faqManifest: import("..").DefinedBlockManifest<import("..")
         id: "_cardStyles";
         readonly __boxStyleType?: "card" | undefined;
     }];
-    readonly layout: import("..").NodeDefinition;
+    readonly layout: NodeDefinition;
+    readonly variants: {
+        readonly default: NodeDefinition;
+        readonly "two-column": NodeDefinition;
+    };
+    readonly defaultVariant: "default";
+    readonly variantOptions: {
+        readonly default: {
+            readonly label: "Default";
+            readonly description: "A centered heading above one FAQ accordion.";
+        };
+        readonly "two-column": {
+            readonly label: "Two column";
+            readonly description: "A left heading column with FAQ items on the right.";
+        };
+    };
     readonly description: "Accordion of frequently asked questions and answers.";
     readonly tags: readonly ["faq", "questions", "answers", "help", "support", "accordion", "q&a"];
     readonly icon: "HelpCircle";
@@ -30793,10 +30809,12 @@ export type FaqItem = {
     answer: unknown;
 };
 export type FaqContent = {
+    variant?: "default" | "two-column" | null;
     eyebrow?: string | null;
     title?: string | null;
     description?: unknown;
     items?: FaqItem[] | null;
+    _sectionStyles?: SectionStylesContent;
     _containerStyles?: ContainerStylesContent;
     _cardStyles?: CardStylesContent;
 };

package/dist/_dts/blocks/src/system/blocks/feature-cards.d.ts

@@ -0,0 +1,25 @@
+import type { Media } from "../../lib/media";
+import type { TipTapNode } from "../manifest/richTextSchema";
+import type { SystemBlockDefinition } from "../registry";
+import { type BlockConfig, type BlockContentShapeInput, type DefinedBlockManifest } from "../defineBlock";
+import { type StandardAspectRatio } from "../fields/aspectRatio";
+import { type BlockCtaContent } from "../fields/ctas";
+type FeatureCardsVariant = "cards";
+type FeatureCardsColumns = "2" | "3" | "4";
+export declare const featureCardsManifest: DefinedBlockManifest<BlockContentShapeInput<BlockConfig>>;
+export type FeatureCard = {
+    media?: Media | null;
+    aspectRatio?: StandardAspectRatio | null;
+    title: string;
+    body?: TipTapNode | null;
+    ctas?: BlockCtaContent[] | null;
+};
+export type FeatureCardsContent = {
+    variant?: FeatureCardsVariant | null;
+    title?: string | null;
+    description?: TipTapNode | null;
+    columns?: FeatureCardsColumns | null;
+    cards?: FeatureCard[] | null;
+};
+export declare const featureCardsBlockDefinition: SystemBlockDefinition<FeatureCardsContent>;
+export {};

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

@@ -17,6 +17,7 @@ export type { SystemBlockKind } from "../constants/blockKinds";
 export declare function ensureSystemBlockDefinitionsRegistered(): void;
 export declare function resetSystemBlockDefinitionRegistration(): void;
 export * from "./hero";
+export * from "./intro";
 export * from "./body-text";
 export * from "./location-map";
 export * from "./blog-post";
@@ -30,6 +31,7 @@ export * from "./site-footer";
 export * from "./testimonials";
 export * from "./columns";
 export * from "./collection";
+export * from "./feature-cards";
 export * from "./media-text";
 export * from "./appointment-booking";
 export * from "./event-registration";

package/dist/_dts/blocks/src/system/blocks/intro.d.ts

@@ -0,0 +1,24 @@
+import type { Media } from "../../lib/media";
+import type { TipTapNode } from "../manifest/richTextSchema";
+import type { SystemBlockDefinition } from "../registry";
+import type { SemanticSpacing } from "../spacing";
+import { type BlockConfig, type BlockContentShapeInput, type DefinedBlockManifest } from "../defineBlock";
+import { type StandardAspectRatio } from "../fields/aspectRatio";
+import { type BlockCtaContent } from "../fields/ctas";
+import { type ImageColSize } from "../fields/imageLayout";
+export type IntroVariant = "centered-copy" | "statement-copy" | "statement-media" | "media-copy";
+type IntroImagePosition = "left" | "right";
+export declare const introManifest: DefinedBlockManifest<BlockContentShapeInput<BlockConfig>>;
+export type IntroContent = {
+    variant?: IntroVariant | null;
+    title?: string | null;
+    body: TipTapNode;
+    media?: Media | null;
+    imagePosition?: IntroImagePosition | null;
+    gap?: SemanticSpacing | null;
+    ratio?: ImageColSize | null;
+    aspectRatio?: StandardAspectRatio | null;
+    ctas?: BlockCtaContent[] | null;
+};
+export declare const introBlockDefinition: SystemBlockDefinition<IntroContent>;
+export {};

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

@@ -3,10 +3,10 @@ import type { TipTapNode } from "../manifest/richTextSchema";
 import type { SystemBlockDefinition } from "../registry";
 import type { SemanticSpacing } from "../spacing";
 import { type ContentFrameIntent } from "../frame/frameStyles";
+import { type StandardAspectRatio } from "../fields/aspectRatio";
 import { type ImageColSize } from "../fields/imageLayout";
 type MediaTextAlignment = "left" | "center";
 type MediaTextImagePosition = "left" | "right";
-type MediaTextAspectRatio = "auto" | "16/9" | "4/3" | "1/1" | "3/4";
 export declare const mediaTextFrameCapability: readonly ["plain", "panel", "flush-panel"];
 export declare const mediaTextManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
     readonly description: "Two columns: media/carousel + rich text (with optional section title).";
@@ -2347,38 +2347,7 @@ export declare const mediaTextManifest: import("..").DefinedBlockManifest<import
         } | undefined;
         readonly activeTabField?: string | undefined;
         readonly tabs: import("..").TabDefinition[];
-    }, ...import("../../../../block-form/src/backend/index").FieldDefinition[], {
-        readonly id: "aspectRatio";
-        readonly type: "select";
-        readonly label: "Media aspect ratio";
-        readonly description: "Crop media to a consistent aspect ratio.";
-        readonly required: false;
-        readonly defaultValue: "auto";
-        readonly multiple: false;
-        readonly options: [{
-            readonly value: "auto";
-            readonly label: "Auto (original)";
-        }, {
-            readonly value: "16/9";
-            readonly label: "16:9 (Landscape)";
-        }, {
-            readonly value: "4/3";
-            readonly label: "4:3 (Standard)";
-        }, {
-            readonly value: "1/1";
-            readonly label: "1:1 (Square)";
-        }, {
-            readonly value: "3/4";
-            readonly label: "3:4 (Portrait)";
-        }];
-        readonly ui: {
-            readonly intent: "display";
-            readonly visibleWhen: {
-                readonly field: "images";
-                readonly notEquals: null;
-            };
-        };
-    }, {
+    }, ...import("../../../../block-form/src/backend/index").FieldDefinition[], import("../../../../block-form/src/backend/index").FieldDefinition, {
         readonly id: "text";
         readonly type: "richText";
         readonly label: "Text";
@@ -2508,7 +2477,7 @@ export type MediaTextContent = {
     imagePosition?: MediaTextImagePosition | null;
     gap?: SemanticSpacing | null;
     ratio?: ImageColSize | null;
-    aspectRatio?: MediaTextAspectRatio | null;
+    aspectRatio?: StandardAspectRatio | null;
     images?: Array<{
         image: Media | null;
     }> | null;

package/dist/_dts/blocks/src/system/blocks/site-header.d.ts

@@ -1,8 +1,8 @@
-import type { SystemBlockDefinition } from "../registry";
+import type { SystemBlockDefinition } from '../registry';
 export declare const siteHeaderManifest: import("..").DefinedBlockManifest<{
     readonly skipSectionStyles: true;
 }>;
 export type SiteHeaderManifest = typeof siteHeaderManifest;
-export type SiteHeaderVariant = "classic" | "centered" | "transparent" | "floating" | "editorial";
+export type SiteHeaderVariant = 'classic' | 'centered' | 'transparent' | 'floating';
 export type SiteHeaderContent = Record<string, never>;
 export declare const siteHeaderBlockDefinition: SystemBlockDefinition<SiteHeaderContent>;

package/dist/_dts/blocks/src/system/constants/blockKinds.d.ts

@@ -1,4 +1,4 @@
-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/blocks/src/system/fields/aspectRatio.d.ts

@@ -0,0 +1,30 @@
+import type { FieldDefinition } from '../manifest/schema';
+export type StandardAspectRatio = 'auto' | '16/9' | '4/3' | '1/1' | '3/4';
+type FieldUi = NonNullable<FieldDefinition['ui']>;
+type FieldVisibleWhen = FieldUi['visibleWhen'];
+export declare const standardAspectRatioOptions: readonly [{
+    readonly value: "auto";
+    readonly label: "Auto (original)";
+}, {
+    readonly value: "16/9";
+    readonly label: "16:9 (Landscape)";
+}, {
+    readonly value: "4/3";
+    readonly label: "4:3 (Standard)";
+}, {
+    readonly value: "1/1";
+    readonly label: "1:1 (Square)";
+}, {
+    readonly value: "3/4";
+    readonly label: "3:4 (Portrait)";
+}];
+type AspectRatioFieldOptions = Readonly<{
+    id?: string;
+    label?: string;
+    description?: string;
+    defaultValue?: StandardAspectRatio;
+    uiIntent?: 'display' | 'style';
+    visibleWhen?: FieldVisibleWhen;
+}>;
+export declare function createAspectRatioField(options?: AspectRatioFieldOptions): FieldDefinition;
+export {};

package/dist/_dts/blocks/src/system/fields/boxStyles.d.ts

@@ -1,5 +1,5 @@
 import type { ModalFieldDefinition } from '../manifest/schema';
-import type { EyebrowTreatment, TileTreatment } from '../../../../theme-core/src/site-styles/index';
+import type { AccordionIconTreatment, EyebrowTreatment, HeadingDecoration, HeadingDecorationOverride, TileTreatment } from '../../../../theme-core/src/site-styles/index';
 import type { Media } from '../../lib/media';
 /**
  * Options for customizing a section styles field.
@@ -83,6 +83,9 @@ export type SectionStylesContent = {
     minHeight?: 'none' | 'banner' | 'hero' | 'immersive' | null;
     tileTreatment?: TileTreatment | null;
     eyebrowTreatment?: EyebrowTreatment | null;
+    headingDecoration?: HeadingDecoration | null;
+    headingDecorationOverride?: HeadingDecorationOverride | null;
+    accordionIconTreatment?: AccordionIconTreatment | null;
 } | null;
 export type CardStylesContent = {
     background?: Record<string, unknown> | null;

package/dist/_dts/blocks/src/system/fields/ctas.d.ts

@@ -25,5 +25,12 @@ export type CtasRepeaterField<O extends CtasOptions = {}> = FieldDefinition & {
         ];
     };
 };
+export type BlockCtaContent = {
+    label?: string | null;
+    href?: string | null;
+    link?: unknown;
+    variant?: string | null;
+    size?: string | null;
+};
 export declare function createCtasRepeater<const O extends CtasOptions = {}>(options?: O): CtasRepeaterField<O>;
 export {};

package/dist/_dts/blocks/src/system/manifest/fieldValidation/index.d.ts

@@ -43,6 +43,15 @@ type UrlFormatConstraint = Readonly<{
     kind: "urlFormat";
     allowRelative: boolean;
 }>;
+type DateFormatConstraint = Readonly<{
+    kind: "dateFormat";
+}>;
+type TimeFormatConstraint = Readonly<{
+    kind: "timeFormat";
+}>;
+type DateTimeFormatConstraint = Readonly<{
+    kind: "datetimeFormat";
+}>;
 type NumberTypeConstraint = Readonly<{
     kind: "numberType";
 }>;
@@ -85,7 +94,7 @@ type LinkObjectConstraint = Readonly<{
 type ReferenceTextConstraint = Readonly<{
     kind: "referenceText";
 }>;
-type StringConstraint = RequiredConstraint | TextTypeConstraint | MaxLengthConstraint | EmailFormatConstraint | PhoneFormatConstraint | PatternFormatConstraint | UrlFormatConstraint | SlugFormatConstraint | ReferenceTextConstraint;
+type StringConstraint = RequiredConstraint | TextTypeConstraint | MaxLengthConstraint | EmailFormatConstraint | PhoneFormatConstraint | PatternFormatConstraint | UrlFormatConstraint | DateFormatConstraint | TimeFormatConstraint | DateTimeFormatConstraint | SlugFormatConstraint | ReferenceTextConstraint;
 type NumberConstraint = RequiredConstraint | NumberTypeConstraint | NumberMinConstraint | NumberMaxConstraint;
 type SelectConstraint = RequiredConstraint | SelectOptionConstraint;
 type ArrayConstraint = RequiredConstraint | ArrayTypeConstraint | MinItemsConstraint | MaxItemsConstraint;
@@ -105,7 +114,7 @@ export type FieldValidationIssue = BaseIssue<"required", {
     expected: string;
 }> | BaseIssue<"tooLong", {
     maximum: number;
-}> | BaseIssue<"invalidEmail"> | BaseIssue<"invalidPhone"> | BaseIssue<"invalidPattern"> | BaseIssue<"invalidUrl"> | BaseIssue<"invalidNumber"> | BaseIssue<"tooSmall", {
+}> | BaseIssue<"invalidEmail"> | BaseIssue<"invalidPhone"> | BaseIssue<"invalidPattern"> | BaseIssue<"invalidUrl"> | BaseIssue<"invalidDate"> | BaseIssue<"invalidTime"> | BaseIssue<"invalidDateTime"> | BaseIssue<"invalidNumber"> | BaseIssue<"tooSmall", {
     minimum: number;
 }> | BaseIssue<"tooLarge", {
     maximum: number;
@@ -201,5 +210,10 @@ export declare function validateFieldValue(plan: FieldValidationPlan, value: unk
 export declare function fieldPlanToZod(plan: FieldValidationPlan, options?: FieldValidationOptions): z.ZodTypeAny;
 export declare function resolveFieldValidationDescriptor(plans: readonly FieldValidationPlan[], path: FieldPath): FieldValidationDescriptor | null;
 export declare function validateManifestValues(fields: readonly FieldDefinition[], values: Record<string, unknown>, options?: FieldValidationOptions): FieldValidationIssue[];
+export declare function isCanonicalEmailValue(value: string): boolean;
+export declare function isCanonicalPhoneValue(value: string): boolean;
+export declare function isCanonicalUrlValue(value: string, options?: Readonly<{
+    allowRelative?: boolean;
+}>): boolean;
 export declare function isEmptyValue(value: unknown): boolean;
 export declare function isEmptyRichTextDoc(value: unknown): boolean;

package/dist/_dts/blocks/src/system/node/validation-constants.d.ts

@@ -20,7 +20,7 @@ export type AllowedNodeType = (typeof ALLOWED_NODE_TYPES)[number];
  * $bind.transforms within custom block layouts. Transform IDs
  * not in this list will be rejected during validation.
  */
-export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.footerRootStyle", "ui.headerNavLinkClass", "ui.headingClassFromAlignment", "ui.bodyClassFromAlignment", "ui.stackAlignFromAlignment", "ui.sectionStateTone", "ui.heroContentWrapperClass", "ui.heroCtaJustify", "ui.heroStackJustifyFromVerticalAlignment", "ui.heroGridClassFromVerticalAlignment", "ui.conditionalClass", "ui.twoColumnContainerClass", "ui.twoColumnFlexBasis", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveAllowOverflow", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "containerStyles.resolveBoxClassName"];
+export declare const ALLOWED_TRANSFORM_IDS: readonly ["string.uppercase", "value.fallback", "date.formatShort", "array.length", "value.jsonArray", "value.csv", "array.marqueeLoop", "layout.maxWidthClass", "layout.headerRootClass", "layout.footerRootClass", "layout.headerRootStyle", "layout.headerSectionBackground", "layout.footerRootStyle", "ui.headerNavLinkClass", "ui.headingClassFromAlignment", "ui.bodyClassFromAlignment", "ui.stackAlignFromAlignment", "ui.sectionStateTone", "ui.heroContentWrapperClass", "ui.heroCtaJustify", "ui.heroStackJustifyFromVerticalAlignment", "ui.heroGridClassFromVerticalAlignment", "ui.conditionalClass", "ui.twoColumnContainerClass", "ui.twoColumnFlexBasis", "ui.imageGalleryFilterClass", "ui.imageGalleryTileClass", "ui.imageGalleryTileStyle", "ui.imageGalleryMarqueeTileStyle", "ui.imageGalleryMarqueeDuration", "ui.imageGalleryMarqueeDirection", "ui.imageFragmentClass", "ui.imageFragmentSize", "media.fromUrl", "background.resolveStyle", "background.resolveColorsStyle", "background.resolveAllowOverflow", "background.resolveImageStyle", "background.resolveImageClassName", "background.resolveOverlayStyle", "links.resolve", "links.label", "content.interpolateRichTextTokens", "boxStyles.spacing", "boxStyles.resolveRootClass", "boxStyles.resolveRootStyle", "boxStyles.semanticGap", "boxStyles.semanticGapValue", "containerStyles.resolveBoxClassName"];
 export type AllowedTransformId = (typeof ALLOWED_TRANSFORM_IDS)[number];
 /**
  * Set for O(1) lookup of allowed node types.