@riverbankcms/sdk 0.70.2 → 0.70.4

package/README.md

@@ -3257,6 +3257,35 @@ export default Page;
 export { generateMetadata };
 ```
 
+### Lazy Block Overrides
+
+Eager `blockOverrides` remain supported and are a good fit for small server-safe components. For client-heavy or rarely used custom blocks, register a lazy override so `createCatchAllPage()` resolves only the override modules needed by the page or entry template being rendered:
+
+```tsx
+// src/app/[[...slug]]/page.tsx
+import { createCatchAllPage } from '@riverbankcms/sdk/next';
+import { defineLazyBlockOverride } from '@riverbankcms/sdk/rendering';
+import { getRiverbankClient } from '@/lib/builder-client';
+import config from '@/riverbank.config';
+
+const { Page, generateMetadata } = createCatchAllPage({
+  getClient: getRiverbankClient,
+  config,
+  blockOverrides: {
+    'custom.quiz': defineLazyBlockOverride(async () =>
+      import('@/components/blocks/QuizBlock').then((module) => module.QuizBlock)
+    ),
+  },
+});
+
+export default Page;
+export { generateMetadata };
+```
+
+Keep the `import()` inside the lazy factory. Wrapping a component that was imported at the top of the route file is still eager from the bundler's point of view and will not slim the catch-all route graph. Lazy factories must be wrapped with `defineLazyBlockOverride()`; raw promise-returning functions are not treated as lazy overrides.
+
+`createCatchAllPage()` filters and resolves lazy overrides per rendered page, so unused factories are not invoked. Next.js still builds the client-reference manifest from the static catch-all route graph, though, so a static `import('./HeavyClientBlock')` inside the route graph can still appear in internal build manifests even when that block is not on the current page. For client-heavy blocks, keep the server override wrapper small and put ALTCHA/forms/booking widgets behind block-local client boundaries, then verify the production build artifacts for the specific site.
+
 This single call replaces ~160 lines of typical boilerplate that handles:
 - Path resolution from URL slugs
 - Content loading (pages and entries)

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

@@ -3,7 +3,8 @@ import type { ApiClient } from './request';
 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/block-form/src/client/index.d.ts

@@ -10,7 +10,7 @@ export type { ManifestAdapterOptions, ManifestAdapterResult, ManifestFormSource,
 export { createManifestValidation } from '../manifest/manifestFormAdapter';
 export { formatPublishBlockedMessage, formatRecoveryConflictSummary, formatRecoveryConflictTitle, deriveBlockDraftSaveability, formatUnfinishedBlocksSummary, normalizeManifestIssueMessage, recoveryConflictCopy, shouldShowBlockFieldValidation, unfinishedBlockCopy, validateBlockManifest, validateBlockManifestIssues, validateBlockManifestValues, } from './blockDraftSaveability';
 export type { BlockDraftSaveability, BlockDraftValidationIssue, BlockManifestValidationMode, } from './blockDraftSaveability';
-export type { BaseFieldConfig, FieldConfig, TextFieldConfig, NumberFieldConfig, RichTextFieldConfig, MediaFieldConfig, BooleanFieldConfig, DateFieldConfig, TimeFieldConfig, DateTimeFieldConfig, SlugFieldConfig, UrlFieldConfig, LinkFieldConfig, SelectFieldConfig, ReferenceFieldConfig, GroupFieldConfig, RepeaterFieldConfig, ButtonFieldConfig, ContentTypeSelectFieldConfig, EntryPickerFieldConfig, } from '../fields/types';
+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';
 export { SdkConfigProvider, useSdkConfig, useBlockFieldOptions } from '../sdk-config';

package/dist/_dts/block-form/src/fields/types.d.ts

@@ -11,6 +11,8 @@ import type { FieldDefinition } from '../../../blocks/src/index';
 import type { ZodTypeAny } from 'zod';
 import type { TabGroupFieldConfig } from '../widgets/TabGroupField/types';
 import type { PresetOrCustomFieldConfig } from '../widgets/PresetOrCustomField/types';
+export type MediaKind = 'image' | 'video' | 'audio';
+export type FileFieldKind = 'document' | 'spreadsheet' | 'archive' | 'audio';
 /**
  * Base configuration for all field types
  */
@@ -58,9 +60,19 @@ export interface RichTextFieldConfig extends BaseFieldConfig {
  */
 export interface MediaFieldConfig extends BaseFieldConfig {
     type: 'media';
-    mediaKinds?: ('image' | 'video' | 'audio' | 'document' | 'spreadsheet' | 'archive')[];
+    mediaKinds?: MediaKind[];
     aspectRatio?: string;
 }
+/**
+ * Public file field configuration.
+ *
+ * File fields are media-backed internally but carry file/download intent for
+ * editor upload policy, picker filtering, and future file-specific workflows.
+ */
+export interface FileFieldConfig extends BaseFieldConfig {
+    type: 'file';
+    fileKinds?: FileFieldKind[];
+}
 /**
  * Boolean field configuration
  */
@@ -220,4 +232,4 @@ export interface EntryPickerFieldConfig extends BaseFieldConfig {
 /**
  * Union of all field configuration types
  */
-export type FieldConfig = TextFieldConfig | NumberFieldConfig | RichTextFieldConfig | MediaFieldConfig | BooleanFieldConfig | DateFieldConfig | TimeFieldConfig | DateTimeFieldConfig | SlugFieldConfig | UrlFieldConfig | LinkFieldConfig | SelectFieldConfig | ReferenceFieldConfig | GroupFieldConfig | ModalFieldConfig | RepeaterFieldConfig | ButtonFieldConfig | TabGroupFieldConfig | PresetOrCustomFieldConfig | ContentTypeSelectFieldConfig | EntryPickerFieldConfig;
+export type FieldConfig = TextFieldConfig | NumberFieldConfig | RichTextFieldConfig | MediaFieldConfig | FileFieldConfig | BooleanFieldConfig | DateFieldConfig | TimeFieldConfig | DateTimeFieldConfig | SlugFieldConfig | UrlFieldConfig | LinkFieldConfig | SelectFieldConfig | ReferenceFieldConfig | GroupFieldConfig | ModalFieldConfig | RepeaterFieldConfig | ButtonFieldConfig | TabGroupFieldConfig | PresetOrCustomFieldConfig | ContentTypeSelectFieldConfig | EntryPickerFieldConfig;

package/dist/_dts/block-form/src/registry/schemas.d.ts

@@ -63,6 +63,7 @@ export declare const SCHEMA_BUILDERS: {
     readonly link: typeof buildLinkFieldSchema;
     readonly richText: typeof buildRichTextFieldSchema;
     readonly media: typeof buildMediaFieldSchema;
+    readonly file: typeof buildMediaFieldSchema;
     readonly tabGroup: typeof buildTabGroupFieldSchema;
     readonly presetOrCustom: typeof buildPresetOrCustomFieldSchema;
     readonly reference: typeof buildReferenceFieldSchema;
@@ -85,6 +86,7 @@ export declare const DEFAULT_VALUE_BUILDERS: {
     readonly link: typeof getLinkFieldDefault;
     readonly richText: typeof getRichTextFieldDefaultValue;
     readonly media: typeof getMediaFieldDefaultValue;
+    readonly file: typeof getMediaFieldDefaultValue;
     readonly tabGroup: typeof getTabGroupFieldDefault;
     readonly presetOrCustom: typeof getPresetOrCustomFieldDefault;
     readonly reference: typeof getReferenceFieldDefault;

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

@@ -1,6 +1,6 @@
-import type { MediaFieldConfig } from '../../fields/types';
+import type { FileFieldConfig, MediaFieldConfig } from '../../fields/types';
 /**
  * Get default value for media field
  * Media fields default to null (no media selected)
  */
-export declare function getMediaFieldDefaultValue(_config: MediaFieldConfig): null;
+export declare function getMediaFieldDefaultValue(_config: MediaFieldConfig | FileFieldConfig): null;

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

@@ -1,6 +1,6 @@
-import type { MediaFieldConfig } from '../../fields/types';
+import type { FileFieldConfig, MediaFieldConfig } from '../../fields/types';
 /**
  * Build Zod validation schema for media field
  * Validates media object structure or null
  */
-export declare function buildMediaFieldSchema(config: MediaFieldConfig): import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+export declare function buildMediaFieldSchema(config: MediaFieldConfig | FileFieldConfig): import("zod").ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;

package/dist/_dts/blocks/src/lib/media.d.ts

@@ -1,7 +1,7 @@
 import z from "zod";
 export declare const MEDIA_TYPE_DISCRIMINANTS: readonly ["image", "video", "audio", "document", "spreadsheet", "archive"];
 export type MediaTypeDiscriminant = typeof MEDIA_TYPE_DISCRIMINANTS[number];
-export declare const PUBLIC_DOWNLOAD_MEDIA_TYPES: readonly ["document", "spreadsheet", "archive", "audio", "video"];
+export declare const PUBLIC_DOWNLOAD_MEDIA_TYPES: readonly ["document", "spreadsheet", "archive", "audio"];
 export type PublicDownloadMediaType = typeof PUBLIC_DOWNLOAD_MEDIA_TYPES[number];
 export declare function isMediaTypeDiscriminant(value: unknown): value is MediaTypeDiscriminant;
 export declare function mediaTypeDiscriminantFromMimeType(mimeType: string): MediaTypeDiscriminant | null;