@riverbankcms/sdk 0.70.2 → 0.70.4

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

@@ -4,6 +4,7 @@
  * Apply bounded site-style selections via the command-backed theme API.
  */
 import { Command } from 'commander';
+import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/index';
 import type { ThemeStyleSelectionApplyInput } from '../../client/management';
 export type StyleApplyOptions = Readonly<{
     siteStyleId: string;
@@ -15,5 +16,22 @@ export type StyleApplyOptions = Readonly<{
     headerLookId?: string;
     footerLookId?: string;
 }>;
+export type StyleCatalogListOptions = Readonly<{
+    siteStyleId?: string;
+}>;
+export type StyleCatalogChoice = Readonly<{
+    id: string;
+    label: string;
+}>;
+export type StyleCatalogListRow = Readonly<{
+    siteStyleId: string;
+    name: string;
+    palettes: readonly StyleCatalogChoice[];
+    buttonPersonalities: readonly StyleCatalogChoice[];
+    headerLooks: readonly StyleCatalogChoice[];
+    footerLooks: readonly StyleCatalogChoice[];
+}>;
 export declare function buildStyleSelectionApplyInputFromOptions(options: StyleApplyOptions): ThemeStyleSelectionApplyInput;
+export declare function buildStyleCatalogListRows(styles?: readonly CuratedSiteStyle[], options?: StyleCatalogListOptions): readonly StyleCatalogListRow[];
+export declare function formatStyleCatalogListRow(row: StyleCatalogListRow): string[];
 export declare const styleCommand: Command;

package/dist/_dts/sdk/src/cli/helpers.d.ts

@@ -5,6 +5,7 @@
  * Reduces duplication and ensures consistent behavior.
  */
 import { Command } from 'commander';
+import type { SiteId } from '../../../core/src/index';
 import type { ManagementClient } from '../client/management/types';
 import { type OutputContext } from './output';
 import { type CliErrorContext } from './errors';
@@ -52,6 +53,8 @@ export interface CommandContext {
     client: ManagementClient;
     isRemote: boolean;
     isJsonOutput: boolean;
+    targetEnv: EnvTarget;
+    siteId: SiteId;
     /** Environment targets for this operation */
     envTargets: EnvTarget[];
 }
@@ -271,6 +274,11 @@ export declare function handleCommandError(error: unknown, output: OutputContext
  * }))
  */
 export declare function withErrorHandling<TArgs extends unknown[]>(action: (...args: [...TArgs, Command]) => Promise<void>): (...args: [...TArgs, Command]) => Promise<void>;
+/**
+ * Wrap a command action so handlers receive a resolved command context instead
+ * of the raw Commander instance.
+ */
+export declare function withCommandContext<TArgs extends unknown[], TOptions = unknown>(action: (ctx: CommandContext, ...args: [...TArgs, TOptions]) => Promise<void>): (...args: [...TArgs, TOptions, Command]) => Promise<void>;
 /**
  * Wrap a destructive command action with confirmation prompt and error handling.
  *
@@ -289,39 +297,6 @@ export declare function withErrorHandling<TArgs extends unknown[]>(action: (...a
  * ))
  */
 export declare function withConfirmation<TArgs extends unknown[]>(getMessage: (...args: TArgs) => string, action: (ctx: CommandContext, ...args: TArgs) => Promise<void>): (...args: [...TArgs, ConfirmOptions, Command]) => Promise<void>;
-/**
- * Configuration for publish/unpublish command factories.
- */
-export interface PublishCommandConfig {
-    /** Resource name for display (e.g., 'entry', 'page') */
-    resourceName: string;
-    /** Argument names (e.g., ['type', 'identifier'] or ['identifier']) */
-    args: readonly string[];
-    /** Function to call the appropriate client method */
-    action: (client: ManagementClient, ...args: string[]) => Promise<void>;
-}
-/**
- * Create a publish command for a resource.
- *
- * @example
- * const publishCommand = createPublishCommand({
- *   resourceName: 'entry',
- *   args: ['type', 'identifier'],
- *   action: (client, type, id) => client.entries.publish(type, id),
- * });
- */
-export declare function createPublishCommand(config: PublishCommandConfig): Command;
-/**
- * Create an unpublish command for a resource.
- *
- * @example
- * const unpublishCommand = createUnpublishCommand({
- *   resourceName: 'entry',
- *   args: ['type', 'identifier'],
- *   action: (client, type, id) => client.entries.unpublish(type, id),
- * });
- */
-export declare function createUnpublishCommand(config: PublishCommandConfig): Command;
 /**
  * Configuration for get command factory.
  */

package/dist/_dts/sdk/src/cli/site-commands/oneOffCommands.d.ts

@@ -0,0 +1,81 @@
+import { type Result, type SiteId } from '../../../../core/src/index';
+import type { ManagementBlock, ManagementClient, ManagementEntry, ManagementNavigationMenu, ManagementPage, NavigationItemInput } from '../../client/management/types';
+import type { EnvTarget } from '../helpers';
+import { type CliCommandCompileBatchSuccessWithReports, type CliCommandValidationCompileError } from './commandRuntime';
+import { type EntryCommandReportSubject, type EntrySiteCommand, type EntrySiteCommandType } from './entryCommands';
+import { type NavigationCommandReportSubject, type NavigationSiteCommand, type NavigationSiteCommandType } from './navigationCommands';
+import { type PageCommandReportSubject, type PageSiteCommand, type PageSiteCommandType } from './pageCommands';
+export type OneOffCommandBatchSource = 'one_off_entry' | 'one_off_page' | 'one_off_block' | 'one_off_navigation';
+type OneOffCompileInput<TMutation> = Readonly<{
+    source: OneOffCommandBatchSource;
+    siteId: SiteId;
+    targetEnv: EnvTarget;
+    mutation: TMutation;
+}>;
+export type OneOffEntryMutation = Readonly<{
+    kind: 'upsert';
+    contentType: string;
+    identifier: string;
+    data: Record<string, unknown>;
+    slug?: string;
+}> | Readonly<{
+    kind: 'publish' | 'unpublish';
+    contentType: string;
+    identifier: string;
+}>;
+export type OneOffPageMutation = Readonly<{
+    kind: 'upsert';
+    identifier: string;
+    title: string;
+    path: string;
+    seoTitle?: string;
+    seoDescription?: string;
+}> | Readonly<{
+    kind: 'publish' | 'unpublish';
+    identifier: string;
+}>;
+export type OneOffBlockMutation = Readonly<{
+    kind: 'upsert';
+    pageIdentifier: string;
+    blockIdentifier: string;
+    blockKind: string;
+    data: Record<string, unknown>;
+}> | Readonly<{
+    kind: 'reorder';
+    pageIdentifier: string;
+    blockIdentifiers: readonly string[];
+}>;
+export type OneOffNavigationMutation = Readonly<{
+    kind: 'upsert';
+    menuName: string;
+    items: readonly NavigationItemInput[];
+}>;
+export type OneOffEntryCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<EntrySiteCommandType, EntryCommandReportSubject>;
+export type OneOffPageCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<PageSiteCommandType, PageCommandReportSubject>;
+export type OneOffNavigationCommandCompileSuccess = CliCommandCompileBatchSuccessWithReports<NavigationSiteCommandType, NavigationCommandReportSubject>;
+export declare function compileOneOffEntryCommand(input: OneOffCompileInput<OneOffEntryMutation>): Result<OneOffEntryCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffPageCommand(input: OneOffCompileInput<OneOffPageMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffBlockCommand(input: OneOffCompileInput<OneOffBlockMutation>): Result<OneOffPageCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function compileOneOffNavigationCommand(input: OneOffCompileInput<OneOffNavigationMutation>): Result<OneOffNavigationCommandCompileSuccess, CliCommandValidationCompileError>;
+export declare function executeOneOffEntryCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffEntryCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'entries'>;
+    apply: (command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function executeOneOffPageCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffPageCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'pages' | 'blocks'>;
+    apply: (command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function executeOneOffNavigationCommand<TResult>(input: Readonly<{
+    compiledPlan: Pick<OneOffNavigationCommandCompileSuccess, 'plan'>;
+    client: Pick<ManagementClient, 'navigation'>;
+    apply: (command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>) => Promise<TResult>;
+}>): Promise<TResult>;
+export declare function applyOneOffEntryCommand(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<ManagementEntry | void>;
+export declare function applyOneOffEntryCommandReturningEntry(command: EntrySiteCommand, client: Pick<ManagementClient, 'entries'>): Promise<ManagementEntry>;
+export declare function applyOneOffPageCommand(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage | ManagementBlock | void>;
+export declare function applyOneOffPageCommandReturningPage(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementPage>;
+export declare function applyOneOffPageCommandReturningBlock(command: PageSiteCommand, client: Pick<ManagementClient, 'pages' | 'blocks'>): Promise<ManagementBlock>;
+export declare function applyOneOffNavigationCommand(command: NavigationSiteCommand, client: Pick<ManagementClient, 'navigation'>): Promise<ManagementNavigationMenu>;
+export {};

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

@@ -27,4 +27,5 @@ export { Layout } from './rendering/components/Layout';
 export type { LayoutProps, HeaderData, FooterData } from './rendering/components/Layout';
 export { PageRenderer, ThemeScope, buildThemeRuntime, RichText, resolveImageUrl, resolveImageUrlWithContext, resolveImageSourceSetWithContext, ImagePresets, } from './rendering';
 export type { AppointmentBookingContent, BlogListingContent, BlogPostContent, BodyTextAlignment, BodyTextContent, CollectionContent, ColumnsContent, CourseDetailsContent, CourseRegistrationContent, CtaFullContent, EmbedContent, EventCalendarContent, EventDetailsContent, EventListingContent, EventRegistrationContent, EventSpotlightContent, FaqContent, FormBlockContent, GiftingContent, HeroContent, HeroMedia, ImageGalleryContent, MediaTextContent, NewsletterSignupContent, ShopContent, SingleButtonContent, SiteFooterContent, SiteHeaderContent, SystemBlockContentByKind, SystemBlockContentFor, TeamMembersContent, TestimonialEntryContent, TestimonialsBlockContent, VideoGridContent, ImageOptions, ResolveImageUrlContext, ResolveImageSourceSetOptions, ResolvedImageSourceSet, PageOutline, RouteMap, Theme, ThemeTokens, Media, TipTapNode, LinkValue, RichTextPrimitiveProps, } from './rendering';
-export type { BlockOverrideProps, BlockOverrides, BlockOverrideComponent, KnownSystemBlockOverrides, } from './rendering';
+export type { BlockOverrideProps, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, BlockOverrideComponent, KnownSystemBlockOverrides, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, } from './rendering';
+export { defineLazyBlockOverride } from './rendering';

package/dist/_dts/sdk/src/config/field-definitions.d.ts

@@ -104,9 +104,13 @@ export type RichTextFieldDefinition = FieldBase & {
 };
 export type MediaFieldDefinition = FieldBase & {
     type: 'media';
-    mediaKinds?: Array<'image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'archive'>;
+    mediaKinds?: Array<'image' | 'video' | 'audio'>;
     aspectRatio?: string;
 };
+export type FileFieldDefinition = FieldBase & {
+    type: 'file';
+    fileKinds?: Array<'document' | 'spreadsheet' | 'archive' | 'audio'>;
+};
 export type BooleanFieldDefinition = FieldBase & {
     type: 'boolean';
 };
@@ -221,5 +225,5 @@ export type EntryPickerFieldDefinition = FieldBase & {
     /** Which entry field to store as the value: 'id' (UUID), 'identifier', or 'slug'. */
     valueFrom?: 'id' | 'identifier' | 'slug';
 };
-export type FieldDefinition = TextFieldDefinition | RichTextFieldDefinition | MediaFieldDefinition | BooleanFieldDefinition | NumberFieldDefinition | DateFieldDefinition | TimeFieldDefinition | DateTimeFieldDefinition | SlugFieldDefinition | UrlFieldDefinition | LinkFieldDefinition | SelectFieldDefinition | ReferenceFieldDefinition | RepeaterFieldDefinition | GroupFieldDefinition | ModalFieldDefinition | TabGroupFieldDefinition | PresetOrCustomFieldDefinition | ContentTypeSelectFieldDefinition | EntryPickerFieldDefinition;
+export type FieldDefinition = TextFieldDefinition | RichTextFieldDefinition | MediaFieldDefinition | FileFieldDefinition | BooleanFieldDefinition | NumberFieldDefinition | DateFieldDefinition | TimeFieldDefinition | DateTimeFieldDefinition | SlugFieldDefinition | UrlFieldDefinition | LinkFieldDefinition | SelectFieldDefinition | ReferenceFieldDefinition | RepeaterFieldDefinition | GroupFieldDefinition | ModalFieldDefinition | TabGroupFieldDefinition | PresetOrCustomFieldDefinition | ContentTypeSelectFieldDefinition | EntryPickerFieldDefinition;
 export type { TipTapNode, Media, LinkValue };

package/dist/_dts/sdk/src/config/typed-entries.d.ts

@@ -30,7 +30,7 @@
  * });
  * ```
  */
-import type { BooleanFieldDefinition, ContentTypeSelectFieldDefinition, DateFieldDefinition, DateTimeFieldDefinition, EntryPickerFieldDefinition, FieldDefinition, GroupFieldDefinition, LinkFieldDefinition, MediaFieldDefinition, ModalFieldDefinition, NumberFieldDefinition, PresetOrCustomFieldDefinition, ReferenceFieldDefinition, RepeaterFieldDefinition, RichTextFieldDefinition, SelectFieldDefinition, SlugFieldDefinition, TabGroupFieldDefinition, TextFieldDefinition, TimeFieldDefinition, UrlFieldDefinition } from './field-definitions';
+import type { BooleanFieldDefinition, ContentTypeSelectFieldDefinition, DateFieldDefinition, DateTimeFieldDefinition, EntryPickerFieldDefinition, FileFieldDefinition, FieldDefinition, GroupFieldDefinition, LinkFieldDefinition, MediaFieldDefinition, ModalFieldDefinition, NumberFieldDefinition, PresetOrCustomFieldDefinition, ReferenceFieldDefinition, RepeaterFieldDefinition, RichTextFieldDefinition, SelectFieldDefinition, SlugFieldDefinition, TabGroupFieldDefinition, TextFieldDefinition, TimeFieldDefinition, UrlFieldDefinition } from './field-definitions';
 import type { LinkValue, Media, TipTapNode } from '../contracts';
 import type { ContentTypeConfig, EntryConfig } from './content-types';
 export type { TipTapNode, Media, LinkValue, InternalLinkValue, ExternalLinkValue, CustomLinkValue, } from '../contracts';
@@ -66,6 +66,8 @@ export type FieldValueType<F extends FieldDefinition> = F extends {
     type: 'richText';
 } ? TipTapNode : F extends {
     type: 'media';
+} ? Media | null : F extends {
+    type: 'file';
 } ? Media | null : F extends {
     type: 'link';
 } ? LinkValue | null : F extends {
@@ -91,7 +93,7 @@ export type FieldValueType<F extends FieldDefinition> = F extends {
     type: 'select';
 } ? string : F extends {
     type: 'entryPicker';
-} ? string | null : F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? TipTapNode : F extends MediaFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
+} ? string | null : F extends TextFieldDefinition ? string : F extends BooleanFieldDefinition ? boolean : F extends NumberFieldDefinition ? number : F extends RichTextFieldDefinition ? TipTapNode : F extends MediaFieldDefinition ? Media | null : F extends FileFieldDefinition ? Media | null : F extends LinkFieldDefinition ? LinkValue | null : F extends DateFieldDefinition ? string : F extends TimeFieldDefinition ? string : F extends DateTimeFieldDefinition ? string : F extends SlugFieldDefinition ? string : F extends UrlFieldDefinition ? string : F extends ReferenceFieldDefinition ? string : F extends PresetOrCustomFieldDefinition ? string : F extends ContentTypeSelectFieldDefinition ? string : F extends SelectFieldDefinition & {
     multiple: true;
 } ? string[] : F extends SelectFieldDefinition ? string : F extends EntryPickerFieldDefinition ? string | null : F extends GroupFieldDefinition & {
     schema: {

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

@@ -521,13 +521,14 @@ export type AudioPlayerContent = {
     }) | null;
 };
 export type PublicDownloadMedia = Media & {
-    type: 'document' | 'spreadsheet' | 'archive' | 'audio' | 'video';
+    type: 'document' | 'spreadsheet' | 'archive' | 'audio';
 };
 export type FileDownloadContent = {
     file?: PublicDownloadMedia | null;
     title?: string | null;
     description?: string | null;
     buttonLabel?: string | null;
+    buttonVariant?: 'primary' | 'secondary' | 'outline' | 'link' | null;
 };
 export type AppointmentBookingContent = {
     formId: string;

package/dist/_dts/sdk/src/manifest/prompt/examples/cta.d.ts

@@ -29,7 +29,7 @@ export declare const ctaExample: {
                 label: string;
                 required: boolean;
                 multiline: boolean;
-                readonly defaultValue?: undefined;
+                defaultValue?: undefined;
                 schema?: undefined;
             } | {
                 id: string;
@@ -49,12 +49,12 @@ export declare const ctaExample: {
                         type: string;
                         label: string;
                         required: boolean;
-                        readonly multiline?: undefined;
-                        readonly defaultValue?: undefined;
+                        multiline?: undefined;
+                        defaultValue?: undefined;
                     })[];
                 };
-                readonly multiline?: undefined;
-                readonly defaultValue?: undefined;
+                multiline?: undefined;
+                defaultValue?: undefined;
             })[];
             layout: {
                 type: string;

package/dist/_dts/sdk/src/manifest/prompt/examples/features-grid.d.ts

@@ -55,8 +55,8 @@ export declare const featuresGridExample: {
                         ui?: undefined;
                     })[];
                 };
-                readonly multiline?: undefined;
-                readonly defaultValue?: undefined;
+                multiline?: undefined;
+                defaultValue?: undefined;
             })[];
             layout: {
                 type: string;

package/dist/_dts/sdk/src/manifest/prompt/examples/hero.d.ts

@@ -27,8 +27,8 @@ export declare const heroExample: {
                 type: string;
                 label: string;
                 required: boolean;
-                readonly multiline?: undefined;
-                readonly defaultValue?: undefined;
+                multiline?: undefined;
+                defaultValue?: undefined;
             })[];
             layout: {
                 type: string;

package/dist/_dts/sdk/src/manifest/prompt/examples/pricing.d.ts

@@ -34,7 +34,7 @@ export declare const pricingExample: {
                 label: string;
                 required: boolean;
                 multiline: boolean;
-                readonly defaultValue?: undefined;
+                defaultValue?: undefined;
                 itemLabel?: undefined;
                 itemLabelSource?: undefined;
                 minItems?: undefined;
@@ -59,7 +59,7 @@ export declare const pricingExample: {
                         required: boolean;
                         multiline: boolean;
                         ui?: undefined;
-                        readonly defaultValue?: undefined;
+                        defaultValue?: undefined;
                         itemLabel?: undefined;
                         minItems?: undefined;
                         allowConversion?: undefined;
@@ -73,7 +73,7 @@ export declare const pricingExample: {
                         ui: {
                             placeholder: string;
                         };
-                        readonly defaultValue?: undefined;
+                        defaultValue?: undefined;
                         itemLabel?: undefined;
                         minItems?: undefined;
                         allowConversion?: undefined;
@@ -96,7 +96,7 @@ export declare const pricingExample: {
                         label: string;
                         required: boolean;
                         defaultValue: boolean;
-                        readonly multiline?: undefined;
+                        multiline?: undefined;
                         ui?: undefined;
                         itemLabel?: undefined;
                         minItems?: undefined;
@@ -119,25 +119,25 @@ export declare const pricingExample: {
                                 multiline: boolean;
                             }[];
                         };
-                        readonly multiline?: undefined;
+                        multiline?: undefined;
                         ui?: undefined;
-                        readonly defaultValue?: undefined;
+                        defaultValue?: undefined;
                     } | {
                         id: string;
                         type: string;
                         label: string;
                         required: boolean;
-                        readonly multiline?: undefined;
+                        multiline?: undefined;
                         ui?: undefined;
-                        readonly defaultValue?: undefined;
+                        defaultValue?: undefined;
                         itemLabel?: undefined;
                         minItems?: undefined;
                         allowConversion?: undefined;
                         schema?: undefined;
                     })[];
                 };
-                readonly multiline?: undefined;
-                readonly defaultValue?: undefined;
+                multiline?: undefined;
+                defaultValue?: undefined;
             })[];
             layout: {
                 type: string;

package/dist/_dts/sdk/src/manifest/prompt/examples/testimonials.d.ts

@@ -34,7 +34,7 @@ export declare const testimonialsExample: {
                 label: string;
                 required: boolean;
                 multiline: boolean;
-                readonly defaultValue?: undefined;
+                defaultValue?: undefined;
                 itemLabel?: undefined;
                 itemLabelSource?: undefined;
                 minItems?: undefined;
@@ -65,11 +65,11 @@ export declare const testimonialsExample: {
                         label: string;
                         required: boolean;
                         mediaKinds: string[];
-                        readonly multiline?: undefined;
+                        multiline?: undefined;
                     })[];
                 };
-                readonly multiline?: undefined;
-                readonly defaultValue?: undefined;
+                multiline?: undefined;
+                defaultValue?: undefined;
             })[];
             layout: {
                 type: string;

package/dist/_dts/sdk/src/manifest/validation/output-schema.d.ts

@@ -132,7 +132,7 @@ export declare function normalizeLlmMediaAtRule(atRule: z.infer<typeof llmMediaA
 };
 /**
  * Combined field schema for LLM output.
- * Supports: text, richText, media, boolean, link, select, number, group, repeater.
+ * Supports: text, richText, media, file, boolean, link, select, number, group, repeater.
  */
 declare const llmFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
     id: z.ZodString;
@@ -161,6 +161,16 @@ declare const llmFieldSchema: z.ZodUnion<readonly [z.ZodObject<{
         image: "image";
         video: "video";
         audio: "audio";
+    }>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    required: z.ZodBoolean;
+    defaultValue: z.ZodNullable<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>]>>;
+    type: z.ZodLiteral<"file">;
+    fileKinds: z.ZodNullable<z.ZodArray<z.ZodEnum<{
+        audio: "audio";
         document: "document";
         spreadsheet: "spreadsheet";
         archive: "archive";

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

@@ -8,7 +8,7 @@ import type { ReactNode } from 'react';
 import type { RiverbankClient } from '../client/types';
 import type { RiverbankSiteConfig } from '../config/types';
 import type { Theme } from '../contracts';
-import type { BlockOverrides } from '../rendering/overrides';
+import type { BlockOverrideRegistrations } from '../rendering/overrides';
 import type { Metadata } from '../metadata/generatePageMetadata';
 import type { LoadContentResult } from '../rendering/helpers/loadContent';
 /**
@@ -182,8 +182,10 @@ export type CreateCatchAllPageOptions = {
     /**
      * Custom block component overrides for rendering.
      * Keys can be full block kind ("block.hero") or short form ("hero").
+     * Wrap client-heavy dynamic imports with defineLazyBlockOverride(); raw
+     * promise-returning functions are not lazy override registrations.
      */
-    blockOverrides?: BlockOverrides;
+    blockOverrides?: BlockOverrideRegistrations;
     /**
      * Override site URL for metadata generation.
      * Defaults to `config.liveUrl` or `config.previewUrl` based on preview mode.

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

@@ -438,7 +438,8 @@ export type ContentEntryListItem<TContent = Record<string, unknown>> = {
 export type PublicContentTypeFieldMeta = {
     id: string;
     type: string;
-    mediaKinds: Array<"image" | "video" | "audio" | "document" | "spreadsheet" | "archive"> | null;
+    mediaKinds: Array<"image" | "video" | "audio"> | null;
+    fileKinds: Array<"document" | "spreadsheet" | "archive" | "audio"> | null;
 };
 export type PublicContentTypeMeta = {
     key: string;

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

@@ -23,7 +23,8 @@ export { ThemeScope, } from './blocks-theme-scope';
 export { buildThemeRuntime, } from './blocks-theme-runtime';
 export type { ComponentRegistry, PageRendererDataContext, PageRendererProps, SdkConfigForRenderer, } from './blocks-page-renderer';
 export type { ThemeScopeProps, } from './blocks-theme-scope';
-export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrides, KnownSystemBlockOverrides, } from './overrides';
+export type { BlockOverrideProps, BlockOverrideComponent, BlockOverrideRegistration, BlockOverrideRegistrations, BlockOverrides, KnownSystemBlockOverrides, LazyBlockOverrideFactory, LazyBlockOverrideRegistration, } from './overrides';
+export { defineLazyBlockOverride } from './overrides';
 /**
  * @example Server-side rendering (Next.js App Router)
  * ```tsx

package/dist/_dts/sdk/src/rendering/overrideResolution.d.ts

@@ -0,0 +1,10 @@
+import type { PageOutline } from '../contracts';
+import { type BlockOverrideRegistrations, type BlockOverrides } from './overrides';
+/**
+ * Resolve only override registrations used by the current page or template.
+ *
+ * Eager components are passed through unchanged. Lazy registrations created
+ * with `defineLazyBlockOverride()` are loaded only after their block kind is
+ * found in the rendered block tree.
+ */
+export declare function resolveBlockOverridesForPage(registrations: BlockOverrideRegistrations | undefined, page: PageOutline | null | undefined): Promise<BlockOverrides | undefined>;

package/dist/_dts/sdk/src/rendering/overrides.d.ts

@@ -25,8 +25,20 @@ type BivariantOverrideComponent<TContent = Record<string, unknown>> = {
     bivarianceHack(props: BlockOverrideProps<TContent, Record<string, unknown>>): React.ReactElement | null;
 }['bivarianceHack'];
 type CompatibleBlockOverrideComponent<TContent = Record<string, unknown>> = BlockOverrideComponent<TContent, Record<string, unknown>> | BivariantOverrideComponent<TContent>;
+export declare const lazyBlockOverrideSymbol: unique symbol;
+export type LazyBlockOverrideFactory<TContent = Record<string, unknown>> = () => Promise<BivariantOverrideComponent<TContent>>;
+export type LazyBlockOverrideRegistration<TContent = Record<string, unknown>> = {
+    readonly [lazyBlockOverrideSymbol]: true;
+    readonly load: LazyBlockOverrideFactory<TContent>;
+};
+export type BlockOverrideRegistration<TContent = Record<string, unknown>> = CompatibleBlockOverrideComponent<TContent> | LazyBlockOverrideRegistration<TContent>;
+export declare function defineLazyBlockOverride<TContent = Record<string, unknown>>(load: LazyBlockOverrideFactory<TContent>): LazyBlockOverrideRegistration<TContent>;
 export type KnownSystemBlockOverrides = {
     [K in keyof SystemBlockContentByKind]?: CompatibleBlockOverrideComponent<SystemBlockContentByKind[K]>;
 };
 export type BlockOverrides = KnownSystemBlockOverrides & Record<string, CompatibleBlockOverrideComponent<Record<string, unknown>>>;
+export type KnownSystemBlockOverrideRegistrations = {
+    [K in keyof SystemBlockContentByKind]?: BlockOverrideRegistration<SystemBlockContentByKind[K]>;
+};
+export type BlockOverrideRegistrations = KnownSystemBlockOverrideRegistrations & Record<string, BlockOverrideRegistration<Record<string, unknown>>>;
 export {};

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.70.2";
+export declare const SDK_VERSION = "0.70.4";