@riverbankcms/sdk 0.62.4 → 0.67.0

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

@@ -0,0 +1,26 @@
+import { type ReactNode } from 'react';
+import type { FieldConfig, RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+import { type RepeaterPresentationConfig } from '../utils';
+export interface RepeaterThumbnailCardProps {
+    index: number;
+    config: RepeaterFieldConfig;
+    backend: FormBackend;
+    basePath: string;
+    itemsLength: number;
+    minItems: number;
+    onMove: (from: number, to: number) => void;
+    onRemove: (index: number) => void;
+    renderChild: (field: FieldConfig, path: string) => ReactNode;
+    presentation: Extract<RepeaterPresentationConfig, {
+        mode: 'thumbnailGrid' | 'layoutGrid';
+    }>;
+    showReorderActions?: boolean;
+    renderDragHandle?: () => ReactNode;
+    hiddenDetailFieldIds?: Set<string>;
+    onMoveUp?: () => void;
+    onMoveDown?: () => void;
+    disableMoveUp?: boolean;
+    disableMoveDown?: boolean;
+}
+export declare function RepeaterThumbnailCard({ index, config, backend, basePath, itemsLength, minItems, onMove, onRemove, renderChild, presentation, showReorderActions, renderDragHandle, hiddenDetailFieldIds, onMoveUp, onMoveDown, disableMoveUp, disableMoveDown, }: RepeaterThumbnailCardProps): ReactNode;

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

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react';
+import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+import type { RepeaterPresentationConfig } from '../utils';
+export interface RepeaterThumbnailGridProps {
+    config: RepeaterFieldConfig;
+    backend: FormBackend;
+    basePath: string;
+    items: Array<{
+        id: string;
+    }>;
+    minItems: number;
+    onMove: (from: number, to: number) => void;
+    onRemove: (index: number) => void;
+    renderChild: (field: FieldConfig, path: string) => ReactNode;
+    presentation: Extract<RepeaterPresentationConfig, {
+        mode: 'thumbnailGrid';
+    }>;
+}
+export declare function RepeaterThumbnailGrid({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, presentation, }: RepeaterThumbnailGridProps): ReactNode;

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

@@ -0,0 +1,11 @@
+export { RepeaterHeader } from './RepeaterHeader';
+export { RepeaterError } from './RepeaterError';
+export { RepeaterDragHandle } from './RepeaterDragHandle';
+export { RepeaterList } from './RepeaterList';
+export { RepeaterRow } from './RepeaterRow';
+export { RepeaterRowActions } from './RepeaterRowActions';
+export { RepeaterRowContent } from './RepeaterRowContent';
+export { RepeaterLayoutGrid } from './RepeaterLayoutGrid';
+export type { RepeaterLayoutGridCapacityContext } from './RepeaterLayoutGrid';
+export { RepeaterThumbnailGrid } from './RepeaterThumbnailGrid';
+export { RepeaterTabbedEditDialog } from './RepeaterTabbedEditDialog';

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

@@ -0,0 +1,34 @@
+import type { RepeaterGridDropTarget, RepeaterGridPlacement } from '@riverbankcms/blocks';
+type Brand<TValue, TBrand extends string> = TValue & {
+    readonly __brand: TBrand;
+};
+export type GridColumns = Brand<number, 'GridColumns'>;
+export type LayoutGridDragState = {
+    kind: 'idle';
+} | {
+    kind: 'dragging';
+    activeId: string;
+};
+export type LayoutGridMoveIntent = {
+    kind: 'none';
+    reason: 'idle' | 'missing-over' | 'unknown-target' | 'invalid-target' | 'missing-active-placement' | 'same-position';
+} | {
+    kind: 'move';
+    activeId: string;
+    toRow: number;
+    toColStart: number;
+    swapWithId?: string;
+};
+export declare function toGridColumns(value: number): GridColumns;
+export declare function createIdleLayoutGridDragState(): LayoutGridDragState;
+export declare function createDraggingLayoutGridDragState(activeId: unknown): LayoutGridDragState;
+export declare function getActiveLayoutGridDragId(dragState: LayoutGridDragState): string | null;
+export declare function resolveLayoutGridMoveIntent(input: {
+    dragState: LayoutGridDragState;
+    overId: string | null;
+    dropTargetsById: ReadonlyMap<string, RepeaterGridDropTarget>;
+    itemDropTargetsById: ReadonlyMap<string, RepeaterGridDropTarget>;
+    placementsById: ReadonlyMap<string, RepeaterGridPlacement>;
+}): LayoutGridMoveIntent;
+export declare function buildLayoutGridOccupiedCells(placements: readonly RepeaterGridPlacement[], columns: GridColumns): Set<number>;
+export {};

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

@@ -0,0 +1,6 @@
+export { useRepeaterVisibility } from './useRepeaterVisibility';
+export { useRepeaterRowErrors, type RowFieldError } from './useRepeaterRowErrors';
+export { useResolvedItemLabel } from './useResolvedItemLabel';
+export { useLayoutGridCapacity } from './useLayoutGridCapacity';
+export { useLinearRepeaterDnd, type LinearRepeaterSortingStrategyKind } from './useLinearRepeaterDnd';
+export { useRepeaterPointerDragCapability } from './useRepeaterPointerDragCapability';

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

@@ -0,0 +1,22 @@
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { RepeaterLayoutGridCapacityContext } from '../components/RepeaterLayoutGrid';
+import type { RepeaterPresentationConfig } from '../utils';
+export type LayoutGridAddBlockedReason = 'missing-capacity-context' | 'invalid-span' | 'max-rows-reached';
+export type LayoutGridAddDecision = {
+    canAdd: true;
+    nextPlacement: {
+        row: number;
+        colStart: number;
+    };
+} | {
+    canAdd: false;
+    reason: LayoutGridAddBlockedReason;
+};
+type ResolveLayoutGridAddDecisionInput = {
+    config: RepeaterFieldConfig;
+    presentation: RepeaterPresentationConfig;
+    layoutGridCapacityContext: RepeaterLayoutGridCapacityContext | null;
+    itemType?: string;
+};
+export declare function resolveLayoutGridAddDecision({ config, presentation, layoutGridCapacityContext, itemType, }: ResolveLayoutGridAddDecisionInput): LayoutGridAddDecision;
+export {};

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

@@ -0,0 +1,20 @@
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { RepeaterPresentationConfig } from '../utils';
+import type { RepeaterLayoutGridCapacityContext } from '../components/RepeaterLayoutGrid';
+type UseLayoutGridCapacityInput = {
+    config: RepeaterFieldConfig;
+    presentation: RepeaterPresentationConfig;
+    isPolymorphic: boolean;
+};
+type UseLayoutGridCapacityResult = {
+    onLayoutGridCapacityContextChange: (next: RepeaterLayoutGridCapacityContext) => void;
+    canAppendLayoutGridDefaultItem: (itemType?: string) => boolean;
+    getNextLayoutGridPlacement: (itemType?: string) => {
+        row: number;
+        colStart: number;
+    } | null;
+    polymorphicTypeCanAdd: Map<string, boolean>;
+    layoutGridAddDisabled: boolean;
+};
+export declare function useLayoutGridCapacity({ config, presentation, isPolymorphic, }: UseLayoutGridCapacityInput): UseLayoutGridCapacityResult;
+export {};

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

@@ -0,0 +1,23 @@
+import { closestCenter, useSensors, type DragEndEvent } from '@dnd-kit/core';
+import { type SortingStrategy } from '@dnd-kit/sortable';
+import { useRepeaterPointerDragCapability } from './useRepeaterPointerDragCapability';
+export type LinearRepeaterSortingStrategyKind = 'verticalList' | 'rectGrid';
+interface UseLinearRepeaterDndInput {
+    itemIds: readonly string[];
+    sortingStrategy: LinearRepeaterSortingStrategyKind;
+    activationDistance?: number;
+    onMove: (fromIndex: number, toIndex: number) => void;
+}
+export interface UseLinearRepeaterDndResult {
+    containerRef: ReturnType<typeof useRepeaterPointerDragCapability>['containerRef'];
+    breakpoint: ReturnType<typeof useRepeaterPointerDragCapability>['breakpoint'];
+    pointerDragCapability: ReturnType<typeof useRepeaterPointerDragCapability>['pointerDragCapability'];
+    canUsePointerDrag: boolean;
+    sensors: ReturnType<typeof useSensors>;
+    collisionDetection: typeof closestCenter;
+    sortingStrategy: SortingStrategy;
+    sortableItemIds: string[];
+    handleDragEnd: (event: DragEndEvent) => void;
+}
+export declare function useLinearRepeaterDnd(input: UseLinearRepeaterDndInput): UseLinearRepeaterDndResult;
+export {};

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

@@ -0,0 +1,10 @@
+import { type RefObject } from 'react';
+import { resolveRepeaterGridBreakpointForWidth } from '@riverbankcms/blocks';
+import { type RepeaterPointerDragCapability } from '../utils';
+export interface UseRepeaterPointerDragCapabilityResult {
+    containerRef: RefObject<HTMLDivElement | null>;
+    breakpoint: ReturnType<typeof resolveRepeaterGridBreakpointForWidth>;
+    pointerDragCapability: RepeaterPointerDragCapability;
+    canUsePointerDrag: boolean;
+}
+export declare function useRepeaterPointerDragCapability(itemCount: number): UseRepeaterPointerDragCapabilityResult;

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

@@ -0,0 +1,12 @@
+/**
+ * Hook to collect validation errors for a repeater row
+ */
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+export type RowFieldError = {
+    fieldId: string;
+    path: string;
+    message?: string;
+    value: unknown;
+};
+export declare function useRepeaterRowErrors(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): RowFieldError[];

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

@@ -0,0 +1,6 @@
+/**
+ * Hook to handle repeater field visibility based on visibleWhen conditions
+ */
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+export declare function useRepeaterVisibility(field: RepeaterFieldConfig, backend: FormBackend, path: string): boolean;

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

@@ -0,0 +1,12 @@
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+/**
+ * Resolves a display label for a repeater item.
+ *
+ * When the repeater's `itemLabelSource` points to a field type that has a
+ * registered DisplayLabelResolver (e.g. entryPicker), this hook resolves the
+ * stored value to a human-readable string asynchronously. While resolution is
+ * in-flight or if no resolver exists, the sync fallback from `buildItemLabel`
+ * is returned.
+ */
+export declare function useResolvedItemLabel(config: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;

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

@@ -0,0 +1,3 @@
+export { RepeaterField } from './RepeaterField';
+export { buildRepeaterFieldSchema } from './repeaterFieldSchema';
+export { getRepeaterFieldDefault } from './repeaterFieldDefaults';

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

@@ -0,0 +1,7 @@
+/**
+ * RepeaterField default value builder
+ * Server-safe - no React, no browser APIs
+ */
+import type { RepeaterFieldConfig } from '../../fields/types';
+import type { DefaultValueContext } from '../GroupField/groupFieldDefaults';
+export declare function getRepeaterFieldDefault(field: RepeaterFieldConfig, ctx: DefaultValueContext): Array<Record<string, unknown>>;

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

@@ -0,0 +1,8 @@
+/**
+ * RepeaterField validation schema builder
+ * Server-safe - no React, no browser APIs
+ */
+import { z } from 'zod';
+import type { RepeaterFieldConfig } from '../../fields/types';
+import type { SchemaContext } from '../GroupField/groupFieldSchema';
+export declare function buildRepeaterFieldSchema(field: RepeaterFieldConfig, ctx: SchemaContext): z.ZodTypeAny;

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

@@ -0,0 +1,7 @@
+/**
+ * Build the display label for a repeater item
+ * Uses itemLabelSource if specified, otherwise falls back to index
+ */
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+export declare function buildItemLabel(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;

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

@@ -0,0 +1,7 @@
+/**
+ * Build a summary preview text for a repeater item
+ * Shows first 2 non-hidden, non-label-source field values
+ */
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+export declare function buildSummary(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;

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

@@ -0,0 +1,6 @@
+/**
+ * Create a default item for a repeater field
+ * Reads default values from field configs directly
+ */
+import type { RepeaterFieldConfig } from '../../../fields/types';
+export declare function createDefaultItem(field: RepeaterFieldConfig, itemType?: string): Record<string, unknown>;

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

@@ -0,0 +1,8 @@
+import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+export type RepeaterItemFieldGroups = {
+    contentFields: FieldConfig[];
+    settingsFields: FieldConfig[];
+    settingsFieldIds: Set<string>;
+};
+export declare function getRepeaterItemFieldGroups(config: RepeaterFieldConfig, backend: FormBackend, basePath: string, index: number): RepeaterItemFieldGroups;

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

@@ -0,0 +1,22 @@
+/**
+ * Get fields for a repeater item based on repeater configuration.
+ *
+ * Handles both monomorphic repeaters (fields defined on config) and
+ * polymorphic repeaters (fields defined per item type).
+ */
+import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
+import type { FormBackend } from '../../../backend/types';
+/**
+ * Get the fields for a specific repeater item.
+ *
+ * For monomorphic repeaters, returns config.fields.
+ * For polymorphic repeaters, looks up the item's _type and returns
+ * the fields from the corresponding itemType schema.
+ *
+ * @param config - Repeater field configuration
+ * @param backend - Form backend for reading values
+ * @param basePath - Base path to the repeater array
+ * @param index - Index of the item in the array
+ * @returns Array of field configs for this item
+ */
+export declare function getRepeaterItemFields(config: RepeaterFieldConfig, backend: FormBackend, basePath: string, index: number): FieldConfig[];

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

@@ -0,0 +1,10 @@
+export { createDefaultItem } from './createDefaultItem';
+export { buildItemLabel } from './buildItemLabel';
+export { buildSummary } from './buildSummary';
+export { getRepeaterItemFields } from './getRepeaterItemFields';
+export { getRepeaterItemFieldGroups } from './getRepeaterItemFieldGroups';
+export { areLayoutGridCapacityContextsEqual } from './layoutGridCapacityContext';
+export { handleLinearRepeaterDragEnd, resolveLinearRepeaterMoveIntent, resolveRepeaterPointerDragCapability, type LinearRepeaterDragEndEvent, type LinearRepeaterMoveIntent, type RepeaterPointerDragCapability, } from './repeaterDndDomain';
+export { resolveRepeaterPresentation } from './repeaterPresentation';
+export { resolveRepeaterThumbnail } from './resolveThumbnail';
+export type { RepeaterPresentationConfig, RepeaterCardDensity } from './repeaterPresentation';

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

@@ -0,0 +1,2 @@
+import type { RepeaterLayoutGridCapacityContext } from '../components';
+export declare function areLayoutGridCapacityContextsEqual(current: RepeaterLayoutGridCapacityContext | null, next: RepeaterLayoutGridCapacityContext): boolean;

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

@@ -0,0 +1,43 @@
+import type { RepeaterGridBreakpoint } from '@riverbankcms/blocks';
+export type RepeaterPointerDragCapability = {
+    kind: 'enabled';
+    breakpoint: RepeaterGridBreakpoint;
+} | {
+    kind: 'disabled';
+    breakpoint: RepeaterGridBreakpoint;
+    reason: 'insufficient-items' | 'small-breakpoint' | 'coarse-pointer';
+};
+export type LinearRepeaterMoveIntent = {
+    kind: 'none';
+    reason: 'missing-over' | 'same-item' | 'unknown-active' | 'unknown-over';
+} | {
+    kind: 'move';
+    fromIndex: number;
+    toIndex: number;
+};
+export interface LinearRepeaterDragEndEvent {
+    active: {
+        id: unknown;
+    };
+    over: {
+        id: unknown;
+    } | null;
+}
+type LinearRepeaterPointerDragCapabilityInput = {
+    breakpoint: RepeaterGridBreakpoint;
+    coarsePointer: boolean;
+    itemCount: number;
+};
+interface LinearRepeaterMoveIntentInput {
+    activeId: unknown;
+    overId: unknown;
+    itemIds: readonly string[];
+}
+export declare function resolveRepeaterPointerDragCapability(input: LinearRepeaterPointerDragCapabilityInput): RepeaterPointerDragCapability;
+export declare function resolveLinearRepeaterMoveIntent(input: LinearRepeaterMoveIntentInput): LinearRepeaterMoveIntent;
+export declare function handleLinearRepeaterDragEnd(input: {
+    event: LinearRepeaterDragEndEvent;
+    itemIds: readonly string[];
+    onMove: (fromIndex: number, toIndex: number) => void;
+}): LinearRepeaterMoveIntent;
+export {};

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

@@ -0,0 +1,24 @@
+import type { RepeaterFieldConfig } from '../../../fields/types';
+import { type RepeaterGridColumnsFieldBindings } from '@riverbankcms/blocks';
+export type RepeaterCardDensity = 'compact' | 'comfortable';
+type RepeaterThumbnailPresentation = {
+    thumbnailField: string;
+    thumbnailAltField?: string;
+    thumbnailLabelField?: string;
+    thumbnailAspectRatio?: string;
+    density: RepeaterCardDensity;
+};
+export type RepeaterPresentationConfig = {
+    mode: 'stack';
+} | ({
+    mode: 'thumbnailGrid';
+} & RepeaterThumbnailPresentation) | ({
+    mode: 'layoutGrid';
+    columnsFields: RepeaterGridColumnsFieldBindings;
+    spanField: string;
+    rowField: string;
+    columnField: string;
+    maxRows?: number;
+} & RepeaterThumbnailPresentation);
+export declare function resolveRepeaterPresentation(config: RepeaterFieldConfig): RepeaterPresentationConfig;
+export {};

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

@@ -0,0 +1,12 @@
+import { type ResolveImageUrlContext } from '@riverbankcms/blocks';
+type ResolveRepeaterThumbnailOptions = {
+    siteId?: string;
+    imageResolveContext?: ResolveImageUrlContext;
+};
+export type ResolvedRepeaterThumbnail = {
+    src: string | null;
+    alt: string | null;
+    kind: 'image' | 'video' | 'unknown';
+};
+export declare function resolveRepeaterThumbnail(value: unknown, options?: ResolveRepeaterThumbnailOptions): ResolvedRepeaterThumbnail;
+export {};

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

@@ -0,0 +1,20 @@
+import type { RichTextFieldConfig } from '../../fields/types';
+/**
+ * Empty TipTap document structure
+ */
+export declare const EMPTY_RICH_TEXT_DOC: {
+    type: string;
+    content: {
+        type: string;
+    }[];
+};
+/**
+ * Get default value for rich text field
+ * Returns empty TipTap document structure
+ */
+export declare function getRichTextFieldDefaultValue(_config: RichTextFieldConfig): {
+    type: string;
+    content: {
+        type: string;
+    }[];
+};

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

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import type { RichTextFieldConfig } from '../../fields/types';
+/**
+ * Build Zod validation schema for rich text field
+ *
+ * Uses the shared rich text schema from @riverbankcms/blocks to ensure consistency
+ * between the form editor and block rendering validation.
+ *
+ * @param config - Rich text field configuration
+ * @returns Zod schema for rich text validation
+ */
+export declare function buildRichTextFieldSchema(config: RichTextFieldConfig): z.ZodUnion<readonly [z.ZodType<import("@riverbankcms/blocks").TipTapNode, unknown, z.core.$ZodTypeInternals<import("@riverbankcms/blocks").TipTapNode, unknown>>, z.ZodObject<{
+    doc: z.ZodType<import("@riverbankcms/blocks").TipTapNode, unknown, z.core.$ZodTypeInternals<import("@riverbankcms/blocks").TipTapNode, unknown>>;
+}, z.core.$strip>]> | z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodType<import("@riverbankcms/blocks").TipTapNode, unknown, z.core.$ZodTypeInternals<import("@riverbankcms/blocks").TipTapNode, unknown>>, z.ZodObject<{
+    doc: z.ZodType<import("@riverbankcms/blocks").TipTapNode, unknown, z.core.$ZodTypeInternals<import("@riverbankcms/blocks").TipTapNode, unknown>>;
+}, z.core.$strip>]>, z.ZodNull]>>;

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

@@ -0,0 +1,11 @@
+/**
+ * SdkSelectField - SDK-aware select widget
+ *
+ * Extends SelectField to check for SDK-provided options first.
+ * Falls back to field-defined options when SDK options aren't available.
+ *
+ * Use `ui.widget: 'sdkSelect'` in field definitions to opt into this behavior.
+ */
+import type { FieldWidgetProps } from '../../fields/props';
+import type { SelectFieldConfig } from '../../fields/types';
+export declare function SdkSelectField({ path, backend, config }: FieldWidgetProps<string, SelectFieldConfig>): import("react/jsx-runtime").JSX.Element;

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * SelectField - Dropdown selection widget using new FieldWidgetProps pattern with @riverbankcms/ui components
+ * Used for enums, block variants, and other single-choice selections
+ */
+import type { FieldWidgetProps } from '../../fields/props';
+import type { SelectFieldConfig } from '../../fields/types';
+export declare function SelectField({ path, backend, config }: FieldWidgetProps<string | string[] | null, SelectFieldConfig>): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,3 @@
+export { SelectField } from './SelectField';
+export { buildSelectFieldSchema } from './selectFieldSchema';
+export { getSelectFieldDefault } from './selectFieldDefaults';

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

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

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

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

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';