@riverbankcms/sdk 0.62.4 → 0.64.0

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

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+export type SelectWidgetOption = {
+    value: string;
+    label: ReactNode;
+    description?: ReactNode;
+    disabled?: boolean;
+};
+export type SelectWidgetProps = {
+    id?: string;
+    label: string;
+    value: string | null;
+    onChange: (value: string) => void;
+    options: SelectWidgetOption[];
+    description?: ReactNode;
+    hint?: ReactNode;
+    error?: ReactNode;
+    placeholder?: string;
+    triggerClassName?: string;
+    size?: 'sm' | 'default';
+    disabled?: boolean;
+    className?: string;
+    labelClassName?: string;
+    descriptionClassName?: string;
+    renderOption?: (option: SelectWidgetOption, state: {
+        selected: boolean;
+    }) => ReactNode;
+    renderValue?: (option: SelectWidgetOption | undefined) => ReactNode;
+    dataPath?: string;
+};
+/**
+ * Standalone select widget with block-form styling parity. Supports custom option
+ * renderers while maintaining accessible labelling and message semantics.
+ */
+export declare function SelectWidget(props: SelectWidgetProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react';
+import type { FieldConfig } from '../../fields/types';
+import type { FormBackend } from '../../backend/types';
+export type SettingsTabId = 'display' | 'behavior' | 'style';
+export type SettingsTab = {
+    id: SettingsTabId;
+    label: string;
+    fields: FieldConfig[];
+};
+export type SettingsModalProps = {
+    tabs: SettingsTab[];
+    backend: FormBackend;
+    renderField: (field: FieldConfig, path: string) => ReactNode;
+    title?: string;
+    tooltip?: string;
+};
+export declare function SettingsModal({ tabs, backend, renderField, title, tooltip, }: SettingsModalProps): ReactNode;

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

@@ -0,0 +1,2 @@
+export { SettingsModal } from './SettingsModal';
+export type { SettingsModalProps, SettingsTab, SettingsTabId } from './SettingsModal';

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

@@ -0,0 +1,16 @@
+/**
+ * SliderField - Slider input widget for percentage/range values
+ * Pure UI component with no validation or default value logic
+ *
+ * This is a **widget variant** of number fields, not a separate field type.
+ * It reuses NumberField's schema and default value builders. Applied via
+ * `ui: { widget: 'slider' }` on `type: 'number'` fields.
+ *
+ * Key behaviors:
+ * - Null/undefined values display as max (100%) since null opacity = fully opaque at runtime
+ * - Hardcodes `%` suffix (designed for 0-100 percentage fields like opacity)
+ * - Supports `ui.min`, `ui.max`, `ui.step`, `ui.showValue` configuration
+ */
+import type { FieldWidgetProps } from '../../fields/props';
+import type { NumberFieldConfig } from '../../fields/types';
+export declare function SliderField({ path, backend, config }: FieldWidgetProps<number, NumberFieldConfig>): import("react/jsx-runtime").JSX.Element;

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * SlugField - URL slug input with auto-generation
+ *
+ * Auto-generates slugs from a source field (default: title) when in draft status.
+ * Detects manual edits and stops auto-generation.
+ * Ensures unique slugs within repeaters.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { SlugFieldConfig } from '../../fields/types';
+export interface SlugFieldProps extends FieldWidgetProps<string, SlugFieldConfig> {
+}
+/**
+ * SlugField - Renders a slug input with auto-generation
+ *
+ * Features:
+ * - Auto-generates from source field (e.g., title)
+ * - Only auto-generates when status is 'draft'
+ * - Detects and respects manual edits
+ * - Ensures uniqueness in repeaters (appends -2, -3, etc.)
+ * - Validates format (lowercase, numbers, dashes, optional slashes)
+ *
+ * @example
+ * ```tsx
+ * <SlugField
+ *   path="slug"
+ *   backend={backend}
+ *   config={{
+ *     id: 'slug',
+ *     type: 'slug',
+ *     label: 'Slug',
+ *     sourceFieldId: 'title',
+ *     statusFieldId: 'status',
+ *     maxLength: 100,
+ *   }}
+ * />
+ * ```
+ */
+export declare function SlugField({ path, backend, config }: SlugFieldProps): ReactNode;

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

@@ -0,0 +1 @@
+export { useSlugAutoGeneration, type UseSlugAutoGenerationProps } from './useSlugAutoGeneration';

package/dist/_dts/block-form/src/widgets/SlugField/hooks/useSlugAutoGeneration.d.ts

@@ -0,0 +1,29 @@
+/**
+ * useSlugAutoGeneration - Auto-generate slugs from source field
+ *
+ * Watches source and status fields and automatically generates slugs when appropriate.
+ * Respects manual edits and only generates in draft status.
+ */
+import type { FormBackend } from '../../../backend/types';
+import type { SlugFieldConfig } from '../../../fields/types';
+export interface UseSlugAutoGenerationProps {
+    path: string;
+    backend: FormBackend;
+    config: SlugFieldConfig;
+    onManualEditChange?: (isManual: boolean) => void;
+}
+/**
+ * Hook to handle automatic slug generation
+ *
+ * Features:
+ * - Auto-generates from source field (default: 'title')
+ * - Only generates when status is 'draft' (default status field: 'status')
+ * - Detects manual edits and stops auto-generation
+ * - Ensures uniqueness within repeaters
+ * - Respects maxLength constraint
+ */
+export declare function useSlugAutoGeneration({ path, backend, config, onManualEditChange }: UseSlugAutoGenerationProps): {
+    isManualEdit: boolean;
+    lastAutoValue: string | null;
+    setManualEdit: (value: boolean) => void;
+};

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

@@ -0,0 +1,5 @@
+export { SlugField } from './SlugField';
+export { buildSlugFieldSchema } from './slugFieldSchema';
+export { getSlugFieldDefault } from './slugFieldDefaults';
+export { useSlugAutoGeneration, type UseSlugAutoGenerationProps } from './hooks';
+export { getSiblingPath, getParentPath, getCollectionPath, slugify, limitSlugLength, sanitizeSlugInput, ensureUniqueSlug } from './utils';

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Slug Field - Validation Schema
+ */
+import type { z } from 'zod';
+import type { SlugFieldConfig } from '../../fields/types';
+/**
+ * Build Zod validation schema for Slug field
+ *
+ * Validates:
+ * - Lowercase letters, numbers, and dashes only
+ * - Optional slashes for paths (e.g., 'parent/child')
+ * - Optional maxLength constraint
+ */
+export declare function buildSlugFieldSchema(field: SlugFieldConfig): z.ZodTypeAny;

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

@@ -0,0 +1,2 @@
+export { getSiblingPath, getParentPath, getCollectionPath } from './pathUtils';
+export { slugify, limitSlugLength, sanitizeSlugInput, ensureUniqueSlug } from './slugUtils';

package/dist/_dts/block-form/src/widgets/SlugField/utils/pathUtils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Path Utilities - Helpers for deriving relative field paths
+ */
+/**
+ * Get the path to a sibling field
+ *
+ * @example
+ * getSiblingPath('sections.0.title', 'slug') // => 'sections.0.slug'
+ * getSiblingPath('title', 'slug') // => 'slug'
+ */
+export declare function getSiblingPath(ownPath: string, siblingId: string): string;
+/**
+ * Get the parent path (for repeater uniqueness checking)
+ *
+ * @example
+ * getParentPath('sections.0.slug') // => 'sections.0'
+ * getParentPath('sections') // => null
+ */
+export declare function getParentPath(ownPath: string): string | null;
+/**
+ * Get the collection path (parent without index)
+ *
+ * @example
+ * getCollectionPath('sections.0.slug') // => { collection: 'sections', index: 0 }
+ * getCollectionPath('slug') // => null
+ */
+export declare function getCollectionPath(ownPath: string): {
+    collection: string;
+    index: number;
+} | null;

package/dist/_dts/block-form/src/widgets/SlugField/utils/slugUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Slug Utilities - Helpers for generating and validating slugs
+ */
+import { slugify, limitSlugLength, sanitizeSlugInput } from '../../../utils/slug';
+import type { FormBackend } from '../../../backend/types';
+export { slugify, limitSlugLength, sanitizeSlugInput };
+/**
+ * Ensure unique slug within a repeater by appending -2, -3, etc.
+ *
+ * @param candidate - The proposed slug
+ * @param backend - Form backend for reading repeater items
+ * @param collectionPath - Path to the repeater array
+ * @param currentIndex - Index of current item (to exclude from check)
+ * @param fieldId - ID of the slug field
+ * @param maxLength - Optional maximum length constraint
+ */
+export declare function ensureUniqueSlug(candidate: string, backend: FormBackend, collectionPath: string, currentIndex: number, fieldId: string, maxLength?: number): string;

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

@@ -0,0 +1,13 @@
+/**
+ * TabGroupField - Container widget for tabbed field groups
+ *
+ * Provides a tab interface for switching between different field groups.
+ * Each tab contains its own set of fields rendered via the generic field renderer.
+ *
+ * The active tab can be controlled by an external field (activeTabField),
+ * or managed internally if no control field is specified.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { TabGroupFieldConfig } from './types';
+export declare function TabGroupField({ path, backend, config, renderChild, }: FieldWidgetProps<Record<string, unknown>, TabGroupFieldConfig>): ReactNode;

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

@@ -0,0 +1,3 @@
+export { TabGroupField } from './TabGroupField';
+export type { TabGroupFieldConfig, TabDefinition } from './types';
+export { buildTabGroupFieldSchema, getTabGroupFieldDefault } from './tabGroupFieldSchema';

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

@@ -0,0 +1,25 @@
+/**
+ * TabGroupField validation schema builder
+ * Server-safe - no React, no browser APIs
+ */
+import { z } from 'zod';
+import type { TabGroupFieldConfig } from './types';
+import type { SchemaContext, DefaultValueContext } from '../../registry/schemas';
+/**
+ * Build validation schema for TabGroupField
+ *
+ * TabGroup is a UI container that organizes fields into tabs.
+ * It validates all child fields across all tabs, and optionally
+ * validates the activeTabField if one is specified.
+ */
+export declare function buildTabGroupFieldSchema(field: TabGroupFieldConfig, ctx: SchemaContext): z.ZodTypeAny;
+/**
+ * Get default value for TabGroupField
+ *
+ * Returns an object containing default values for all child fields
+ * across all tabs, plus the activeTabField if specified.
+ *
+ * Follows the same pattern as GroupField - includes all fields
+ * even if their default value is undefined.
+ */
+export declare function getTabGroupFieldDefault(field: TabGroupFieldConfig, ctx: DefaultValueContext): Record<string, unknown>;

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

@@ -0,0 +1,46 @@
+import type { BaseFieldConfig, FieldConfig } from '../../fields/types';
+/**
+ * Tab definition for TabGroupField
+ */
+export interface TabDefinition {
+    /** Tab identifier (used in activeTabField value) */
+    id: string;
+    /** Display label for the tab */
+    label: string;
+    /** Optional icon name (lucide) - not yet implemented */
+    icon?: string;
+    /** Optional description shown at the top of tab content */
+    description?: string;
+    /** Fields to render in this tab */
+    fields: FieldConfig[];
+    /**
+     * Optional SDK section option that controls tab visibility.
+     * When set, the tab is only shown when the SDK sectionOptions[key] is not false.
+     * If no SDK config is present, the tab is always visible.
+     */
+    sdkSectionOption?: 'backgroundColor' | 'backgroundGradient' | 'backgroundImage';
+}
+/**
+ * TabGroupField configuration
+ */
+export interface TabGroupFieldConfig extends BaseFieldConfig {
+    type: 'tabGroup';
+    /** Tab definitions */
+    tabs: TabDefinition[];
+    /**
+     * Optional: field ID that controls which tab is active
+     * If not specified, tabs use internal state
+     * If specified, the field value should match a tab.id
+     */
+    activeTabField?: string;
+    ui?: {
+        /** Hide the entire field */
+        hidden?: boolean;
+        /** Hide the field label */
+        hideLabel?: boolean;
+        /** Tab style variant (future enhancement) */
+        tabStyle?: 'pills' | 'underline' | 'buttons';
+        /** Tabs take full width */
+        fullWidth?: boolean;
+    };
+}

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

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

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

@@ -0,0 +1,3 @@
+export { TextField } from './TextField';
+export { buildTextFieldSchema } from './textFieldSchema';
+export { getTextFieldDefault } from './textFieldDefaults';

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

@@ -0,0 +1,6 @@
+/**
+ * TextField default value builder
+ * Server-safe - no React, no browser APIs
+ */
+import type { TextFieldConfig } from '../../fields/types';
+export declare function getTextFieldDefault(field: TextFieldConfig): string;

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

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

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

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+export type TextInputWidgetProps = {
+    id?: string;
+    label: string;
+    value: string;
+    onChange: (value: string) => void;
+    description?: ReactNode;
+    labelClassName?: string;
+    descriptionClassName?: string;
+    hint?: ReactNode;
+    error?: ReactNode;
+    placeholder?: string;
+    className?: string;
+    inputClassName?: string;
+    autoComplete?: string;
+    disabled?: boolean;
+    dataPath?: string;
+    maxLength?: number;
+};
+export declare function TextInputWidget(props: TextInputWidgetProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,23 @@
+/**
+ * TimeField - Time input widget
+ *
+ * Simple time picker input using HTML5 time input.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { TimeFieldConfig } from '../../fields/types';
+export interface TimeFieldProps extends FieldWidgetProps<string | null, TimeFieldConfig> {
+}
+/**
+ * TimeField - Renders a time input field
+ *
+ * @example
+ * ```tsx
+ * <TimeField
+ *   path="startTime"
+ *   backend={backend}
+ *   config={{ id: 'startTime', type: 'time', label: 'Start Time' }}
+ * />
+ * ```
+ */
+export declare function TimeField({ path, backend, config }: TimeFieldProps): ReactNode;

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

@@ -0,0 +1,3 @@
+export { TimeField } from './TimeField';
+export { buildTimeFieldSchema } from './timeFieldSchema';
+export { getTimeFieldDefault } from './timeFieldDefaults';

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

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

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

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

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

@@ -0,0 +1,16 @@
+import type { ReactNode } from 'react';
+export type ToggleWidgetProps = {
+    id?: string;
+    label: string;
+    description?: ReactNode;
+    hint?: ReactNode;
+    error?: ReactNode;
+    value: boolean;
+    onChange: (value: boolean) => void;
+    disabled?: boolean;
+    className?: string;
+};
+/**
+ * Boolean toggle widget with shared styling to match block-form boolean fields.
+ */
+export declare function ToggleWidget(props: ToggleWidgetProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,23 @@
+/**
+ * UrlField - URL input widget with validation
+ *
+ * Supports both absolute URLs (http/https) and optional relative paths.
+ */
+import type { ReactNode } from 'react';
+import type { FieldWidgetProps } from '../../fields/props';
+import type { UrlFieldConfig } from '../../fields/types';
+export interface UrlFieldProps extends FieldWidgetProps<string, UrlFieldConfig> {
+}
+/**
+ * UrlField - Renders a URL input field
+ *
+ * @example
+ * ```tsx
+ * <UrlField
+ *   path="website"
+ *   backend={backend}
+ *   config={{ id: 'website', type: 'url', label: 'Website', allowRelative: false }}
+ * />
+ * ```
+ */
+export declare function UrlField({ path, backend, config }: UrlFieldProps): ReactNode;

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

@@ -0,0 +1,3 @@
+export { UrlField } from './UrlField';
+export { buildUrlFieldSchema } from './urlFieldSchema';
+export { getUrlFieldDefault } from './urlFieldDefaults';

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

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

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Widget Name Constants
+ *
+ * Standard widget names used in field definitions' ui.widget property.
+ * These map to components in the widget registry or widgetOverrides.
+ *
+ * ## Widget Resolution Order
+ *
+ * When FormRenderer resolves a widget for a field, it uses this order:
+ * 1. `widgetOverrides[ui.widget]` - if ui.widget is set
+ * 2. `widgetOverrides[field.type]` - if no ui.widget
+ * 3. `WIDGET_COMPONENTS[field.type]` - built-in registry fallback
+ *
+ * ## Override Widgets
+ *
+ * Override widgets are passed via the `widgetOverrides` prop to FormRenderer.
+ * They're used for widgets that need app-specific context (e.g., MediaField
+ * needs siteId, LinkField needs routing info).
+ *
+ * @example
+ * ```typescript
+ * import { WIDGET_NAMES } from '@riverbankcms/block-form'
+ *
+ * const field = {
+ *   type: 'text',
+ *   ui: { widget: WIDGET_NAMES.BACKGROUND_COLOR }
+ * }
+ * ```
+ *
+ * @see FormRenderer for widget resolution implementation
+ * @see dashboardWidgetOverrides for example override map
+ */
+export declare const WIDGET_NAMES: {
+    readonly TEXT: "text";
+    readonly NUMBER: "number";
+    readonly SELECT: "select";
+    readonly BOOLEAN: "boolean";
+    readonly GROUP: "group";
+    readonly MODAL: "modal";
+    readonly TAB_GROUP: "tabGroup";
+    readonly PRESET_OR_CUSTOM: "presetOrCustom";
+    readonly REPEATER: "repeater";
+    readonly URL: "url";
+    readonly TIME: "time";
+    readonly DATE: "date";
+    readonly DATETIME: "datetime";
+    readonly SLUG: "slug";
+    readonly LINK: "link";
+    readonly MEDIA: "media";
+    readonly RICH_TEXT: "richText";
+    readonly REFERENCE: "reference";
+    readonly CONTENT_TYPE_SELECT: "contentTypeSelect";
+    readonly ENTRY_PICKER: "entryPicker";
+    readonly SLIDER: "slider";
+    readonly BACKGROUND_COLOR: "backgroundColor";
+    readonly BACKGROUND_GRADIENT: "backgroundGradient";
+};
+export type WidgetName = typeof WIDGET_NAMES[keyof typeof WIDGET_NAMES];

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

@@ -0,0 +1,61 @@
+/**
+ * GroupField helper functions
+ * Extracted for testability and reusability
+ */
+import type { GroupFieldConfig } from '../fields/types';
+/**
+ * Determines if a group field should flatten its children when inside a repeater
+ *
+ * @param path - Current field path (e.g., "items.0.meta")
+ * @param config - Group field configuration
+ * @returns true if the group should flatten (children rendered at parent level)
+ */
+export declare function shouldFlattenInRepeater(path: string, config: GroupFieldConfig): boolean;
+/**
+ * Extracts the group preset from field configuration.
+ *
+ * @param config - Group field configuration
+ * @returns Preset name or null
+ */
+export declare function getWidgetPreset(config: GroupFieldConfig): string | null;
+/**
+ * Builds a child field path, accounting for flattening behavior
+ *
+ * @param basePath - Base path for the group field
+ * @param childId - Child field ID
+ * @param shouldFlatten - Whether the group is flattened
+ * @returns Full path to the child field
+ */
+export declare function buildChildPath(basePath: string, childId: string, shouldFlatten: boolean): string;
+/**
+ * Checks if field.ui contains visibleWhen configuration
+ */
+export declare function hasVisibleWhen(config: GroupFieldConfig): boolean;
+/**
+ * Checks if field should be hidden
+ */
+export declare function isHidden(config: GroupFieldConfig): boolean;
+/**
+ * Checks if label should be hidden
+ */
+export declare function shouldHideLabel(config: GroupFieldConfig): boolean;
+/**
+ * Gets the layout mode for a group field
+ */
+export declare function getLayout(config: GroupFieldConfig): 'stack' | 'grid';
+/**
+ * Gets the number of columns for grid layout
+ */
+export declare function getColumns(config: GroupFieldConfig): number;
+/**
+ * Validates and clamps colSpan to valid range
+ */
+export declare function getValidColSpan(colSpan: number | undefined, columns: number): number;
+/**
+ * Groups fields by their ui.row property
+ * Fields without a row property each get their own row
+ */
+export declare function groupFieldsByRow<T extends {
+    id: string;
+    ui?: unknown;
+}>(fields: T[]): T[][];

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

@@ -0,0 +1,20 @@
+export { WIDGET_NAMES, type WidgetName } from './constants';
+export { FieldFrame, FieldFrameMessage, type FieldFrameProps, type FieldFrameRenderProps, type FieldFrameMessageProps, } from './FieldFrame';
+export { WidgetField, WidgetFieldMessage } from './Field';
+export type { WidgetFieldProps, WidgetFieldMessageProps } from './Field';
+export { SelectWidget } from './SelectWidget';
+export type { SelectWidgetProps, SelectWidgetOption } from './SelectWidget';
+export { ToggleWidget } from './ToggleWidget';
+export type { ToggleWidgetProps } from './ToggleWidget';
+export { TextInputWidget } from './TextInputWidget';
+export type { TextInputWidgetProps } from './TextInputWidget';
+export { BackgroundColorWidget } from './BackgroundColorWidget';
+export type { BackgroundColorWidgetProps, BackgroundColorMode } from './BackgroundColorWidget';
+export { BackgroundGradientWidget } from './BackgroundGradientWidget';
+export type { BackgroundGradientWidgetProps } from './BackgroundGradientWidget';
+export { BoxStyleWidget } from './BoxStyleWidget';
+export { DatePickerPopover, parseDateValue, type DateParseResult, type DatePickerPopoverProps, } from './DateField';
+export { FieldSettingsModal } from './FieldSettingsModal';
+export type { FieldSettingsModalProps } from './FieldSettingsModal';
+export { SettingsModal } from './SettingsModal';
+export type { SettingsModalProps, SettingsTab, SettingsTabId } from './SettingsModal';

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

@@ -0,0 +1,9 @@
+export declare const EMPTY_SELECT_OPTION_SENTINEL = "__rb:empty__";
+type OptionLike = {
+    value: string;
+};
+export declare function hasEmptyOption(options: readonly OptionLike[]): boolean;
+export declare function mapOptionValueForSelect(optionValue: string, allowEmptyOption: boolean): string;
+export declare function mapCurrentValueForSelect(value: string | null | undefined, allowEmptyOption: boolean): string | undefined;
+export declare function unmapValueFromSelect(value: string, allowEmptyOption: boolean): string;
+export {};