@riverbankcms/sdk 0.62.4 → 0.64.0

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

@@ -0,0 +1,17 @@
+/**
+ * BoxStyleWidget - Modal dialog for section/container/card styling
+ *
+ * Similar to ModalGroupField but specialized for box styling contexts.
+ * Supports future enhancement for tabs when both section and container styles exist.
+ *
+ * Configuration via config.ui.modalConfig:
+ * - buttonLabel: Text for trigger button (default: based on config.label)
+ * - description: Helper text in dialog header
+ * - buttonVariant: 'default' | 'outline' (default: 'outline')
+ * - showCustomizedIndicator: Show "(customized)" badge (default: true)
+ * - maxWidth: Dialog max width class (default: 'max-w-3xl')
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { GroupFieldConfig } from '../../fields/types';
+export declare function BoxStyleWidget({ path, backend, config, renderChild, }: FieldWidgetProps<Record<string, unknown>, GroupFieldConfig>): ReactNode;

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

@@ -0,0 +1 @@
+export { BoxStyleWidget } from './BoxStyleWidget';

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

@@ -0,0 +1,3 @@
+import type { ContentTypeSelectFieldConfig } from '../../fields/types';
+import type { DefaultValueContext } from '../GroupField';
+export declare function getContentTypeSelectFieldDefault(field: ContentTypeSelectFieldConfig, _ctx: DefaultValueContext): string;

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

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { ContentTypeSelectFieldConfig } from '../../fields/types';
+import type { SchemaContext } from '../GroupField';
+export declare function buildContentTypeSelectFieldSchema(field: ContentTypeSelectFieldConfig, _ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,23 @@
+/**
+ * DateField - Date picker input widget
+ *
+ * Uses DatePickerPopover for calendar-based date selection.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { DateFieldConfig } from '../../fields/types';
+export interface DateFieldProps extends FieldWidgetProps<string | null, DateFieldConfig> {
+}
+/**
+ * DateField - Renders a date picker field
+ *
+ * @example
+ * ```tsx
+ * <DateField
+ *   path="publishDate"
+ *   backend={backend}
+ *   config={{ id: 'publishDate', type: 'date', label: 'Publish Date' }}
+ * />
+ * ```
+ */
+export declare function DateField({ path, backend, config }: DateFieldProps): ReactNode;

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

@@ -0,0 +1,8 @@
+/**
+ * Date Field - Default Values
+ */
+import type { DateFieldConfig } from '../../fields/types';
+/**
+ * Get default value for Date field
+ */
+export declare function getDateFieldDefault(field: DateFieldConfig): string | null;

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

@@ -0,0 +1,9 @@
+/**
+ * Date Field - Validation Schema
+ */
+import { z } from 'zod';
+import type { DateFieldConfig } from '../../fields/types';
+/**
+ * Build Zod validation schema for Date field
+ */
+export declare function buildDateFieldSchema(field: DateFieldConfig): z.ZodTypeAny;

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

@@ -0,0 +1,32 @@
+import { type ReactNode } from 'react';
+import { Calendar } from '@riverbankcms/ui';
+export type DateParseResult = Date | null;
+export declare function parseDateValue(value: unknown): DateParseResult;
+export type DatePickerPopoverRenderArgs = {
+    selectedDate: DateParseResult;
+    setDate: (date: DateParseResult) => void;
+    close: () => void;
+};
+export type DatePickerTriggerRenderArgs = {
+    selectedDate: DateParseResult;
+    open: boolean;
+    openPopover: () => void;
+    closePopover: () => void;
+    togglePopover: () => void;
+    buttonLabel: string;
+    placeholder: string;
+};
+export type DatePickerPopoverProps = {
+    selectedDate: DateParseResult;
+    onSelectDate: (date: DateParseResult) => void;
+    onOpenChange?: (open: boolean) => void;
+    placeholder: string;
+    formatButtonLabel: (date: Date) => string;
+    closeOnSelect?: boolean;
+    renderExtras?: (args: DatePickerPopoverRenderArgs) => ReactNode;
+    renderFooter?: (args: DatePickerPopoverRenderArgs) => ReactNode;
+    renderTrigger?: (args: DatePickerTriggerRenderArgs) => ReactNode;
+    open?: boolean;
+    disabled?: React.ComponentProps<typeof Calendar>['disabled'];
+};
+export declare function DatePickerPopover({ selectedDate, onSelectDate, onOpenChange, placeholder, formatButtonLabel, closeOnSelect, renderExtras, renderFooter, renderTrigger, open: controlledOpen, disabled, }: DatePickerPopoverProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { DateField } from './DateField';
+export { buildDateFieldSchema } from './dateFieldSchema';
+export { getDateFieldDefault } from './dateFieldDefaults';
+export { DatePickerPopover, parseDateValue, type DateParseResult, type DatePickerPopoverProps, } from './datePickerPopover';

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

@@ -0,0 +1,30 @@
+/**
+ * DateTimeField - Combined date and time picker widget
+ *
+ * Provides a calendar picker with time input and manual date entry.
+ * Stores values as ISO 8601 strings.
+ */
+import { type ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { DateTimeFieldConfig } from '../../fields/types';
+export interface DateTimeFieldProps extends FieldWidgetProps<string | null, DateTimeFieldConfig> {
+}
+/**
+ * DateTimeField - Renders a combined date and time picker
+ *
+ * Features:
+ * - Calendar picker with button trigger
+ * - Manual date entry in dd/MM/yyyy format
+ * - Time picker in calendar popover
+ * - Stores as ISO 8601 string
+ *
+ * @example
+ * ```tsx
+ * <DateTimeField
+ *   path="publishedAt"
+ *   backend={backend}
+ *   config={{ id: 'publishedAt', type: 'datetime', label: 'Published At' }}
+ * />
+ * ```
+ */
+export declare function DateTimeField({ path, backend, config }: DateTimeFieldProps): ReactNode;

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

@@ -0,0 +1,8 @@
+/**
+ * DateTime Field - Default Values
+ */
+import type { DateTimeFieldConfig } from '../../fields/types';
+/**
+ * Get default value for DateTime field
+ */
+export declare function getDateTimeFieldDefault(field: DateTimeFieldConfig): string | null;

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

@@ -0,0 +1,11 @@
+/**
+ * DateTime Field - Validation Schema
+ */
+import { z } from 'zod';
+import type { DateTimeFieldConfig } from '../../fields/types';
+/**
+ * Build Zod validation schema for DateTime field
+ *
+ * Validates ISO 8601 date-time strings
+ */
+export declare function buildDateTimeFieldSchema(field: DateTimeFieldConfig): z.ZodTypeAny;

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

@@ -0,0 +1,4 @@
+export { DateTimeField } from './DateTimeField';
+export { buildDateTimeFieldSchema } from './dateTimeFieldSchema';
+export { getDateTimeFieldDefault } from './dateTimeFieldDefaults';
+export { applyTime, formatDisplayDate, parseDisplayDate, DISPLAY_DATE_FORMAT } from './utils';

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

@@ -0,0 +1,22 @@
+/**
+ * DateTime Field Utilities
+ *
+ * Utilities for parsing, formatting, and manipulating date-time values.
+ */
+export declare const DISPLAY_DATE_FORMAT = "dd/MM/yyyy";
+/**
+ * Apply time components to a date, returning a new Date object
+ */
+export declare function applyTime(base: Date, hours: number, minutes: number): Date;
+/**
+ * Format a date as dd/MM/yyyy
+ */
+export declare function formatDisplayDate(date: Date): string;
+/**
+ * Parse a date string in dd/MM/yyyy format
+ *
+ * @param value - The input string to parse
+ * @param fallback - Optional date to use for time components
+ * @returns Parsed Date or null if invalid
+ */
+export declare function parseDisplayDate(value: string, fallback?: Date): Date | null;

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

@@ -0,0 +1 @@
+export { applyTime, formatDisplayDate, parseDisplayDate, DISPLAY_DATE_FORMAT } from './dateTimeUtils';

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

@@ -0,0 +1,3 @@
+import type { EntryPickerFieldConfig } from '../../fields/types';
+import type { DefaultValueContext } from '../GroupField';
+export declare function getEntryPickerFieldDefault(field: EntryPickerFieldConfig, _ctx: DefaultValueContext): string;

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

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { EntryPickerFieldConfig } from '../../fields/types';
+import type { SchemaContext } from '../GroupField';
+export declare function buildEntryPickerFieldSchema(field: EntryPickerFieldConfig, _ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,21 @@
+import type { ReactNode } from 'react';
+import { type FieldFrameProps, type FieldFrameRenderProps, type FieldFrameMessageProps } from './FieldFrame';
+export type WidgetFieldProps = Omit<FieldFrameProps, 'label'> & {
+    /** Optional id applied to the control element. */
+    id?: string;
+    /** Field label displayed above the control. */
+    label: string | ReactNode;
+    /** Render-prop child allowing access to the generated control id. */
+    children: (props: FieldFrameRenderProps) => ReactNode;
+};
+/**
+ * Backwards-compatible wrapper around FieldFrame. Maintains the historic WidgetField
+ * API while delegating all layout and messaging behaviour to the shared frame.
+ */
+export declare function WidgetField(props: WidgetFieldProps): import("react/jsx-runtime").JSX.Element;
+export type WidgetFieldMessageProps = FieldFrameMessageProps;
+/**
+ * Utility helper for widgets that render their own control container (e.g. boolean toggle)
+ * but still need consistent spacing for error/hint copy.
+ */
+export declare function WidgetFieldMessage(props: WidgetFieldMessageProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,32 @@
+import type { ReactNode } from "react";
+export type FieldFrameRenderProps = {
+    id: string;
+    descriptionId?: string;
+    messageId?: string;
+};
+export type FieldFrameProps = {
+    id?: string;
+    fieldPath?: string;
+    label?: ReactNode;
+    required?: boolean;
+    labelClassName?: string;
+    description?: ReactNode;
+    descriptionClassName?: string;
+    hint?: ReactNode;
+    error?: ReactNode;
+    className?: string;
+    beforeControl?: ReactNode;
+    afterControl?: ReactNode;
+    children: (props: FieldFrameRenderProps) => ReactNode;
+};
+export declare function FieldFrame(props: FieldFrameProps): import("react/jsx-runtime").JSX.Element;
+export type FieldFrameMessageProps = {
+    id: string;
+    error?: ReactNode;
+    hint?: ReactNode;
+};
+export declare function FieldFrameMessage({ id, error, hint }: FieldFrameMessageProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function FieldLabelText({ label, required, }: {
+    label: ReactNode;
+    required?: boolean;
+}): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,34 @@
+/**
+ * FieldSettingsModal - Reusable modal for non-content nested fields.
+ *
+ * Used by nested container widgets (group/repeater) to keep content fields
+ * inline while moving display/behavior/style fields into a compact settings UI.
+ */
+import type { ReactNode } from 'react';
+import type { FieldConfig } from '../../fields/types';
+import type { FormBackend } from '../../backend/types';
+export type FieldSettingsModalProps = {
+    /** Fields to render in the modal */
+    fields: FieldConfig[];
+    /** Base path for field values */
+    basePath: string;
+    /** Form backend for reading values */
+    backend: FormBackend;
+    /** Function to render each child field */
+    renderChild: (field: FieldConfig, path: string) => ReactNode;
+    /** Title shown in modal header */
+    title?: string;
+    /** Description shown below title */
+    description?: string;
+    /** Tooltip text for the trigger button */
+    tooltip?: string;
+    /** Button size variant */
+    size?: 'sm' | 'default' | 'icon';
+    /** Additional class for the trigger button */
+    className?: string;
+    /** Maximum width class for modal content */
+    maxWidth?: string;
+    /** Height class for modal content */
+    height?: string;
+};
+export declare function FieldSettingsModal({ fields, basePath, backend, renderChild, title, description, tooltip, size, className, maxWidth, height, }: FieldSettingsModalProps): ReactNode;

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

@@ -0,0 +1,2 @@
+export { FieldSettingsModal } from './FieldSettingsModal';
+export type { FieldSettingsModalProps } from './FieldSettingsModal';

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

@@ -0,0 +1,23 @@
+/**
+ * GroupField - Container widget for nested object fields
+ *
+ * Supports two layout modes via config.ui.layout:
+ * - 'stack' (default): Vertical stack of fields
+ * - 'grid': Grid layout with configurable columns and row grouping
+ *
+ * Grid layout features:
+ * - ui.columns (2-4): Number of grid columns (default 2)
+ * - ui.row on child fields: Group fields into named rows
+ * - ui.colSpan on child fields: Span multiple columns (1-4)
+ *
+ * Also supports:
+ * - 'disclosure' preset: Collapsible accordion with error indicators
+ * - flattenInRepeater: For cleaner repeater item structures
+ * - ui.intent on child fields: non-content fields can be shown in a settings modal
+ *
+ * Note: For modal-based groups, use ModalGroupField widget (type: 'group', ui.widget: 'modal')
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { GroupFieldConfig } from '../../fields/types';
+export declare function GroupField({ path, backend, config, renderChild, }: FieldWidgetProps<Record<string, unknown>, GroupFieldConfig>): ReactNode;

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

@@ -0,0 +1,9 @@
+/**
+ * GroupField default value builder
+ * Server-safe - no React, no browser APIs
+ */
+import type { GroupFieldConfig, FieldConfig } from '../../fields/types';
+export type DefaultValueContext = {
+    resolve: (field: FieldConfig) => unknown;
+};
+export declare function getGroupFieldDefault(field: GroupFieldConfig, ctx: DefaultValueContext): Record<string, unknown>;

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

@@ -0,0 +1,10 @@
+/**
+ * GroupField validation schema builder
+ * Server-safe - no React, no browser APIs
+ */
+import { z } from 'zod';
+import type { GroupFieldConfig, FieldConfig } from '../../fields/types';
+export type SchemaContext = {
+    getFieldSchema: (field: FieldConfig) => z.ZodTypeAny;
+};
+export declare function buildGroupFieldSchema(field: GroupFieldConfig, ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,3 @@
+export { GroupField } from './GroupField';
+export { buildGroupFieldSchema, type SchemaContext } from './groupFieldSchema';
+export { getGroupFieldDefault, type DefaultValueContext } from './groupFieldDefaults';

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

@@ -0,0 +1,10 @@
+/**
+ * LinkField Default Value
+ *
+ * Server-safe default value builder for LinkField.
+ */
+import type { LinkFieldConfig } from '../../fields/types';
+/**
+ * Get default value for LinkField
+ */
+export declare function getLinkFieldDefault(field: LinkFieldConfig): unknown;

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

@@ -0,0 +1,3 @@
+import type { z } from 'zod';
+import type { LinkFieldConfig } from '../../fields/types';
+export declare function buildLinkFieldSchema(field: LinkFieldConfig): z.ZodTypeAny;

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

@@ -0,0 +1,6 @@
+import type { 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;

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

@@ -0,0 +1,6 @@
+import type { 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>>;

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

@@ -0,0 +1,17 @@
+/**
+ * ModalGroupField - Generic modal dialog for grouped fields
+ *
+ * Renders as a button that opens a modal dialog containing nested fields.
+ * Button label, description, and behavior are configurable via config.ui.modalConfig.
+ *
+ * Configuration options (config.ui.modalConfig):
+ * - buttonLabel: Text for the trigger button
+ * - description: Helper text shown in dialog header
+ * - buttonVariant: 'default' | 'outline' (default: 'outline')
+ * - showCustomizedIndicator: Show "(customized)" when values exist (default: true)
+ * - maxWidth: Dialog max width class (default: 'max-w-3xl')
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { GroupFieldConfig, ModalFieldConfig } from '../../fields/types';
+export declare function ModalGroupField({ path, backend, config, renderChild, }: FieldWidgetProps<Record<string, unknown>, GroupFieldConfig | ModalFieldConfig>): ReactNode;

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

@@ -0,0 +1,3 @@
+export { ModalGroupField } from './ModalGroupField';
+export { buildModalFieldSchema, type SchemaContext } from './modalFieldSchema';
+export { getModalFieldDefault, type DefaultValueContext } from './modalFieldDefaults';

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

@@ -0,0 +1,18 @@
+/**
+ * ModalGroupField default value builder
+ * Server-safe - no React, no browser APIs
+ *
+ * Modal fields are structurally identical to group fields - they just render differently in the UI.
+ */
+import type { GroupFieldConfig, FieldConfig } from '../../fields/types';
+export type DefaultValueContext = {
+    resolve: (field: FieldConfig) => unknown;
+};
+/** Modal field can have fields nested under schema.fields (ModalFieldDefinition) or directly as fields (GroupFieldConfig) */
+type ModalFieldInput = GroupFieldConfig & {
+    schema?: {
+        fields?: FieldConfig[];
+    };
+};
+export declare function getModalFieldDefault(field: ModalFieldInput, ctx: DefaultValueContext): Record<string, unknown>;
+export {};

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

@@ -0,0 +1,14 @@
+/**
+ * ModalGroupField validation schema builder
+ * Server-safe - no React, no browser APIs
+ *
+ * Modal fields are structurally identical to group fields - they just render differently in the UI.
+ */
+import { z } from 'zod';
+import type { FieldConfig, ModalFieldConfig } from '../../fields/types';
+export type SchemaContext = {
+    getFieldSchema: (field: FieldConfig) => z.ZodTypeAny;
+};
+type ModalFieldInput = ModalFieldConfig;
+export declare function buildModalFieldSchema(field: ModalFieldInput, ctx: SchemaContext): z.ZodTypeAny;
+export {};

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

@@ -0,0 +1,7 @@
+/**
+ * NumberField - Number input widget
+ * Pure UI component with no validation or default value logic
+ */
+import type { FieldWidgetProps } from '../../fields/props';
+import type { NumberFieldConfig } from '../../fields/types';
+export declare function NumberField({ path, backend, config }: FieldWidgetProps<number, NumberFieldConfig>): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,3 @@
+export { NumberField } from './NumberField';
+export { buildNumberFieldSchema } from './numberFieldSchema';
+export { getNumberFieldDefault } from './numberFieldDefaults';

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

@@ -0,0 +1,6 @@
+/**
+ * NumberField default value builder
+ * Server-safe - no React, no browser APIs
+ */
+import type { NumberFieldConfig } from '../../fields/types';
+export declare function getNumberFieldDefault(field: NumberFieldConfig): number | null;

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

@@ -0,0 +1,7 @@
+/**
+ * NumberField validation schema builder
+ * Server-safe - no React, no browser APIs
+ */
+import type { z } from 'zod';
+import type { NumberFieldConfig } from '../../fields/types';
+export declare function buildNumberFieldSchema(field: NumberFieldConfig): z.ZodTypeAny;

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

@@ -0,0 +1,11 @@
+/**
+ * PresetOrCustomField - Widget that combines preset selection with custom text input
+ *
+ * Provides a dropdown of preset options with a "Custom..." option that reveals
+ * a text input field for entering custom values.
+ *
+ * Useful for fields like: scale presets, spacing presets, duration presets, etc.
+ */
+import type { FieldWidgetProps } from '../../fields/props';
+import type { PresetOrCustomFieldConfig } from './types';
+export declare function PresetOrCustomField({ path, backend, config, }: FieldWidgetProps<string, PresetOrCustomFieldConfig>): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { PresetOrCustomField } from './PresetOrCustomField';
+export type { PresetOrCustomFieldConfig, PresetOption } from './types';
+export { buildPresetOrCustomFieldSchema } from './presetOrCustomFieldSchema';
+export { getPresetOrCustomFieldDefault } from './presetOrCustomFieldDefaults';

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

@@ -0,0 +1,3 @@
+import type { PresetOrCustomFieldConfig } from './types';
+import type { DefaultValueContext } from '../GroupField';
+export declare function getPresetOrCustomFieldDefault(field: PresetOrCustomFieldConfig, _ctx: DefaultValueContext): string;

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

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { PresetOrCustomFieldConfig } from './types';
+import type { SchemaContext } from '../GroupField';
+export declare function buildPresetOrCustomFieldSchema(field: PresetOrCustomFieldConfig, _ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,37 @@
+import type { BaseFieldConfig } from '../../fields/types';
+/**
+ * Preset option for PresetOrCustomField
+ */
+export interface PresetOption {
+    /** Value to store when this preset is selected */
+    value: string;
+    /** Display label for this preset */
+    label: string;
+}
+/**
+ * PresetOrCustomField configuration
+ */
+export interface PresetOrCustomFieldConfig extends BaseFieldConfig {
+    type: 'presetOrCustom';
+    /** Preset options to show in dropdown */
+    presets: PresetOption[];
+    /** Custom input configuration */
+    customInput?: {
+        /** Placeholder for custom input field */
+        placeholder?: string;
+        /** Regex pattern for validation */
+        pattern?: string;
+        /** Help text shown when custom mode is active */
+        helpText?: string;
+    };
+    ui?: {
+        /** Hide the entire field */
+        hidden?: boolean;
+        /** Hide the field label */
+        hideLabel?: boolean;
+        /** Label for preset dropdown (default: "Preset") */
+        presetLabel?: string;
+        /** Label for custom input (default: "Custom value") */
+        customLabel?: string;
+    };
+}

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

@@ -0,0 +1,3 @@
+import type { ReferenceFieldConfig } from '../../fields/types';
+import type { DefaultValueContext } from '../GroupField';
+export declare function getReferenceFieldDefault(field: ReferenceFieldConfig, _ctx: DefaultValueContext): string;

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

@@ -0,0 +1,4 @@
+import type { z } from 'zod';
+import type { ReferenceFieldConfig } from '../../fields/types';
+import type { SchemaContext } from '../GroupField';
+export declare function buildReferenceFieldSchema(field: ReferenceFieldConfig, _ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,26 @@
+/**
+ * RepeaterField - Array field widget with drag-drop reordering
+ *
+ * Supports both monomorphic (single schema) and polymorphic (multiple item types) repeaters.
+ * Uses FieldWidgetProps pattern with renderChild for nested field rendering.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps, RenderChildField } from '../../fields/props';
+import type { RepeaterFieldConfig } from '../../fields/types';
+export interface RepeaterFieldProps extends FieldWidgetProps<unknown, RepeaterFieldConfig> {
+    renderChild: RenderChildField;
+}
+/**
+ * RepeaterField - Renders an array of items with add/remove/reorder capabilities
+ *
+ * @example
+ * ```tsx
+ * <RepeaterField
+ *   path="items"
+ *   backend={backend}
+ *   config={repeaterConfig}
+ *   renderChild={(field, path) => <TextField path={path} backend={backend} config={field} />}
+ * />
+ * ```
+ */
+export declare function RepeaterField({ path, backend, config, renderChild }: RepeaterFieldProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterDragHandle.d.ts

@@ -0,0 +1,8 @@
+import { type ButtonHTMLAttributes, type ReactNode } from 'react';
+export type RepeaterDragHandleTone = 'dark' | 'subtle';
+export interface RepeaterDragHandleProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    placement?: 'inline' | 'overlay';
+    tone?: RepeaterDragHandleTone;
+    icon?: ReactNode;
+}
+export declare const RepeaterDragHandle: import("react").ForwardRefExoticComponent<RepeaterDragHandleProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterError.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Repeater field error display
+ */
+import type { ReactNode } from 'react';
+export interface RepeaterErrorProps {
+    error?: {
+        message?: string;
+    };
+    fieldPath?: string;
+}
+export declare function RepeaterError({ error, fieldPath }: RepeaterErrorProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterHeader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Repeater field header - displays label and description
+ */
+import type { ReactNode } from 'react';
+export interface RepeaterHeaderProps {
+    label: string;
+    description?: string;
+    required?: boolean;
+}
+export declare function RepeaterHeader({ label, description, required }: RepeaterHeaderProps): ReactNode;