@llmnative/react 0.1.1 → 1.1.0

package/dist/types/src/components/ui/fields/CodeEditor.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import { FormFieldProps } from '../../widgets/Form';
+import type { FieldValue } from '../../../providers/data/DataProvider';
+import { type EditorCommand } from './ContextMenu';
+export type CodeEditorLanguage = 'liquid' | 'html' | 'json' | 'js' | 'ts' | 'css';
+export interface CodeSyntaxErrorDetails {
+    language: CodeEditorLanguage;
+    from: number;
+    to: number;
+    line: number;
+    column: number;
+    nodeName?: string;
+}
+export declare class CodeSyntaxError extends Error {
+    readonly language: CodeEditorLanguage;
+    readonly from: number;
+    readonly to: number;
+    readonly line: number;
+    readonly column: number;
+    readonly nodeName?: string;
+    constructor(message: string, details: CodeSyntaxErrorDetails);
+}
+export interface CodeValidationResult {
+    valid: boolean;
+    error?: CodeSyntaxError;
+}
+export declare const validateCodeSyntax: (code: string, language: CodeEditorLanguage) => Promise<void>;
+export declare const getCodeValidationResult: (code: string, language: CodeEditorLanguage) => Promise<CodeValidationResult>;
+export interface CodeEditorProps extends FormFieldProps {
+    language?: CodeEditorLanguage;
+    placeholder?: string;
+    minHeight?: number;
+    maxHeight?: number;
+    label?: string;
+    required?: boolean;
+    disabled?: boolean;
+    feedback?: string;
+    labelClassName?: string;
+    validateSyntax?: boolean;
+    validator?: (value: FieldValue) => string | undefined | Promise<string | undefined>;
+    extensions?: unknown[];
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
+}
+export declare const CodeEditor: React.FC<CodeEditorProps>;
+export default CodeEditor;

package/dist/types/src/components/ui/fields/ContextMenu.d.ts

@@ -0,0 +1,87 @@
+import React from 'react';
+import type { UIProps } from '../../types';
+export interface ContextMenuItem {
+    label: string;
+    value: string;
+    icon?: string;
+}
+export interface EditorContext {
+    value: string;
+    textBeforeCaret: string;
+    textAfterCaret: string;
+    trigger: string;
+    query: string;
+    triggerRange: {
+        start: number;
+        end: number;
+    };
+    insert: (text: string) => void;
+    replace: (start: number, end: number, text: string) => void;
+}
+export interface TextCommandContext {
+    value: string;
+    textBeforeCaret: string;
+    textAfterCaret: string;
+    trigger: string;
+    query: string;
+}
+export interface EditorCommand {
+    name: string;
+    description?: string;
+    icon?: string;
+    handler?: (context: TextCommandContext) => string | Promise<string>;
+}
+export interface ContextMenuControlledState {
+    open: boolean;
+    anchorPosition: {
+        top: number;
+        left: number;
+    } | null;
+    query: string;
+    editorContext: EditorContext;
+    onClose: () => void;
+}
+export interface ContextMenuHandle {
+    moveNext: () => void;
+    movePrev: () => void;
+    selectActive: () => void;
+    close: () => void;
+}
+export declare const CONTEXT_MENU_SEARCH_THRESHOLD = 10;
+interface ContextMenuProps extends UIProps {
+    trigger: string;
+    searchable?: boolean;
+    controlled?: ContextMenuControlledState;
+    onSelect?: (item: ContextMenuItem, context: EditorContext) => void;
+    children: React.ReactNode;
+}
+interface ContextMenuItemProps extends UIProps {
+    label: string;
+    value: string;
+    icon?: string;
+}
+interface ContextMenuHeadingProps {
+    children: React.ReactNode;
+    className?: string;
+}
+interface ContextMenuSeparatorProps {
+    className?: string;
+}
+type ContextMenuComponent = React.ForwardRefExoticComponent<ContextMenuProps & React.RefAttributes<ContextMenuHandle>> & {
+    Item: React.FC<ContextMenuItemProps>;
+    Heading: React.FC<ContextMenuHeadingProps>;
+    Separator: React.FC<ContextMenuSeparatorProps>;
+};
+type QueryMatch = {
+    query: string;
+    start: number;
+    end: number;
+};
+type CommandTriggerMatchOptions = {
+    queryPattern?: RegExp;
+    requireWhitespacePrefix?: boolean;
+};
+export declare const matchCommandTrigger: (value: string, caret: number, trigger: string, options?: CommandTriggerMatchOptions) => QueryMatch | null;
+export declare const buildTextCommandContext: (context: EditorContext) => TextCommandContext;
+declare const ContextMenu: ContextMenuComponent;
+export { ContextMenu };

package/dist/types/src/components/ui/fields/Crop.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { FileProps } from "./Upload";
-interface CropProps {
+export interface CropProps {
     fileName: string;
     type: string;
     scale: string;
@@ -16,6 +16,8 @@ interface ImageProps extends FileProps {
 export declare const CropImage: React.ForwardRefExoticComponent<{
     img: ImageProps;
     title?: string;
+    /** Custom aspect ratios. Defaults to { "1:1": 1, "3:4": 0.75, "4:3": 1.33 }. */
+    scales?: Record<string, number>;
 } & React.RefAttributes<unknown>>;
 interface FileNameEditorProps {
     value: string;
@@ -23,5 +25,5 @@ interface FileNameEditorProps {
     scale?: string;
     label?: string;
 }
-export declare const FileNameEditor: ({ value, onChange, label, scale, }: FileNameEditorProps) => React.JSX.Element;
+export declare const FileNameEditor: ({ value, onChange, label, scale }: FileNameEditorProps) => React.JSX.Element;
 export {};

package/dist/types/src/components/ui/fields/ImageField.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { FormFieldProps } from '../../widgets/Form';
+export interface ImageFieldValue {
+    src: string;
+    alt: string;
+    srcset?: string;
+    sizes?: string;
+}
+export interface ImageFieldProps extends FormFieldProps {
+    /**
+     * Pixel widths to generate as responsive srcset variants.
+     * Each width produces a canvas-resized copy.
+     * Default: [] (no variants).
+     * Example: [400, 800]
+     */
+    srcsetWidths?: number[];
+    /**
+     * Storage path prefix for uploading resized variants.
+     * Requires a StorageProvider ancestor.
+     * If omitted, variants are kept as local blob URLs.
+     * Example: "/content/posts/images"
+     */
+    uploadPath?: string;
+    label?: string;
+    required?: boolean;
+    disabled?: boolean;
+    feedback?: string;
+    id?: string;
+    labelClassName?: string;
+}
+export declare const ImageField: ({ name, onChange, defaultValue, label, required, disabled, feedback, srcsetWidths, uploadPath, id, labelClassName, inheritWrapperClassName, wrapperClassName, className, before, after, }: ImageFieldProps) => React.JSX.Element;

package/dist/types/src/components/ui/fields/Input.d.ts

@@ -1,15 +1,22 @@
 import React from 'react';
 import { UIProps } from '../../..';
 import { FormFieldProps, InputType } from '../../widgets/Form';
+import type { FieldValue } from '../../../providers/data/DataProvider';
 interface BaseInputProps extends FormFieldProps {
     placeholder?: string;
     type?: InputType;
-    updatable?: boolean;
+    /** When `true`, the field becomes read-only (disabled) once a value has been set. */
+    readOnlyAfterSet?: boolean;
     disabled?: boolean;
     feedback?: string;
     min?: number;
     max?: number;
     step?: number;
+    id?: string;
+    labelClassName?: string;
+    validator?: (value: FieldValue) => string | undefined | Promise<string | undefined>;
+    /** Content rendered as an absolute overlay inside the input (right side). No addon border/bg. */
+    afterInset?: React.ReactNode;
 }
 interface LabelProps {
     label: string;
@@ -20,15 +27,27 @@ interface LabelProps {
 export type InputProps = Omit<BaseInputProps, 'type'>;
 export interface CheckboxProps extends FormFieldProps {
     title?: string;
+    ariaLabel?: string;
     valueChecked?: string | number;
 }
+export interface HiddenProps extends FormFieldProps {
+    id?: string;
+}
 export interface TextAreaProps extends FormFieldProps {
     placeholder?: string;
-    updatable?: boolean;
+    /** When `true`, the textarea becomes read-only (disabled) once a value has been set. */
+    readOnlyAfterSet?: boolean;
     disabled?: boolean;
-    rows?: number;
+    minHeight?: number;
+    maxHeight?: number;
     feedback?: string;
-    useRef?: any;
+    textareaRef?: React.RefObject<HTMLTextAreaElement | null> | ((el: HTMLTextAreaElement | null) => void) | undefined;
+    id?: string;
+    labelClassName?: string;
+    validator?: (value: FieldValue) => string | undefined | Promise<string | undefined>;
+    onKeyDown?: React.KeyboardEventHandler<HTMLTextAreaElement>;
+    onClick?: React.MouseEventHandler<HTMLTextAreaElement>;
+    onBlur?: React.FocusEventHandler<HTMLTextAreaElement>;
 }
 export interface ListGroupProps extends UIProps {
     children: React.ReactNode[];
@@ -36,17 +55,26 @@ export interface ListGroupProps extends UIProps {
     label?: string;
     draggable?: boolean;
     onDrop?: (text: string) => string;
-    actives?: number[];
-    disables?: number[];
-    loaders?: number[];
-    itemClass?: string;
+    activeIndices?: number[];
+    disabledIndices?: number[];
+    loadingIndices?: number[];
+    itemClassName?: string;
 }
-export declare const Input: ({ name, onChange, defaultValue, placeholder, label, type, required, updatable, disabled, pre, post, feedback, min, max, step, wrapClass, className }: BaseInputProps) => React.JSX.Element;
+export declare const fieldLabelClass = "mb-1 block text-sm font-medium leading-5 text-foreground";
+export declare const fieldFeedbackClass = "mt-1 text-xs text-muted-foreground";
+export declare const fieldControlBaseClass = "flex h-9 w-full rounded-md border border-input bg-background px-3 py-1 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50";
+export declare const fieldTextAreaBaseClass = "flex min-h-[5rem] w-full rounded-md border border-input bg-background px-3 py-2 text-sm shadow-sm transition-colors placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50";
+export declare const fieldGroupClass = "flex w-full items-stretch";
+export declare const fieldAddonClass = "inline-flex shrink-0 items-center border border-input bg-muted px-3 py-1 text-sm text-muted-foreground";
+export declare const FieldError: ({ message }: {
+    message: string;
+}) => React.JSX.Element;
+export declare const Input: ({ name, onChange, defaultValue, placeholder, label, type, required, readOnlyAfterSet, disabled, before, after, afterInset, feedback, min, max, step, id, labelClassName, inheritWrapperClassName, wrapperClassName, className, validator, labelMode, }: BaseInputProps) => React.JSX.Element;
 export declare const String: (props: InputProps) => React.JSX.Element;
 export declare const Number: (props: InputProps) => React.JSX.Element;
 export declare const Email: (props: InputProps) => React.JSX.Element;
 export declare const Password: (props: InputProps) => React.JSX.Element;
-export declare const Color: (props: InputProps) => React.JSX.Element;
+export declare const Color: ({ className, ...props }: InputProps) => React.JSX.Element;
 export declare const Date: (props: InputProps) => React.JSX.Element;
 export declare const Time: (props: InputProps) => React.JSX.Element;
 export declare const DateTime: (props: InputProps) => React.JSX.Element;
@@ -54,9 +82,10 @@ export declare const Week: (props: InputProps) => React.JSX.Element;
 export declare const Month: (props: InputProps) => React.JSX.Element;
 export declare const Range: (props: InputProps) => React.JSX.Element;
 export declare const Url: (props: InputProps) => React.JSX.Element;
-export declare const Checkbox: ({ name, onChange, defaultValue, label, title, required, valueChecked, pre, post, wrapClass, className }: CheckboxProps) => React.JSX.Element;
-export declare const Switch: (props: CheckboxProps) => React.JSX.Element;
+export declare const Hidden: ({ name, onChange, defaultValue, value, id, inheritWrapperClassName, wrapperClassName, }: HiddenProps) => React.JSX.Element;
+export declare const Checkbox: ({ name, onChange, defaultValue, label, title, ariaLabel, required, valueChecked, before, after, inheritWrapperClassName, wrapperClassName, className }: CheckboxProps) => React.JSX.Element;
+export declare const Switch: ({ name, onChange, defaultValue, label, title, ariaLabel, required, valueChecked, before, after, inheritWrapperClassName, wrapperClassName, className }: CheckboxProps) => React.JSX.Element;
 export declare const Label: ({ label, required, htmlFor, className }: LabelProps) => React.JSX.Element;
-export declare const TextArea: ({ name, onChange, defaultValue, placeholder, label, required, updatable, disabled, rows, useRef, pre, post, feedback, className, wrapClass }: TextAreaProps) => React.JSX.Element;
-export declare const ListGroup: ({ children, onClick, label, actives, draggable, onDrop, disables, loaders, pre, post, wrapClass, className, itemClass }: ListGroupProps) => React.JSX.Element;
+export declare const TextArea: ({ name, onChange, defaultValue, placeholder, label, required, readOnlyAfterSet, disabled, minHeight, maxHeight, textareaRef, before, after, feedback, id, labelClassName, inheritWrapperClassName, className, wrapperClassName, validator, onKeyDown, onClick, onBlur, labelMode, }: TextAreaProps) => React.JSX.Element;
+export declare const ListGroup: ({ children, onClick, label, activeIndices, draggable, onDrop, disabledIndices, loadingIndices, before, after, wrapperClassName, className, itemClassName }: ListGroupProps) => React.JSX.Element;
 export {};

package/dist/types/src/components/ui/fields/Prompt.d.ts

@@ -1,31 +1,2 @@
-import React from 'react';
-import { AIFetchConfig } from '../../../providers/ai';
-import { PromptVariables } from '../../../conf/Prompt';
-import { FormFieldProps } from '../../widgets/Form';
-export declare enum PromptMode {
-    EDITOR = "editor",
-    LIVE = "live"
-}
-type PromptOptions = AIFetchConfig & {
-    value: string;
-};
-type OnRunPrompt = (prompt: string, config: AIFetchConfig, data?: PromptVariables) => Promise<string>;
-export interface PromptProps extends FormFieldProps {
-    mode?: PromptMode;
-    onRunPrompt?: OnRunPrompt;
-    renderPromptDisabled?: (props: Omit<FormFieldProps, "defaultValue">) => React.ReactNode;
-    rows?: number;
-    defaultValue?: {
-        value?: string;
-        enabled?: boolean;
-        role?: string;
-        language?: string;
-        voice?: string;
-        style?: string;
-        model?: string;
-        temperature?: number;
-    };
-}
-export declare const Prompt: ({ mode, onRunPrompt, renderPromptDisabled, ...props }: PromptProps) => React.JSX.Element;
-export declare const runPrompt: (options: PromptOptions, data?: PromptVariables, onRunPrompt?: OnRunPrompt) => Promise<string>;
-export {};
+export { default, Prompt, PromptMode, runPrompt } from '../../widgets/Prompt';
+export type { PromptProps } from '../../widgets/Prompt';

package/dist/types/src/components/ui/fields/RichText.d.ts

@@ -0,0 +1,89 @@
+import React from 'react';
+import { FormFieldProps } from '../../widgets/Form';
+import type { FieldValue } from '../../../providers/data/DataProvider';
+import { type EditorCommand } from './ContextMenu';
+export type ToolbarCommand = 'bold' | 'italic' | 'underline' | 'strike' | 'headings' | 'heading1' | 'heading2' | 'heading3' | 'bulletList' | 'orderedList' | 'blockquote' | 'code' | 'codeBlock' | 'link' | 'table' | 'imageUpload' | 'documentUpload' | 'sourceCode' | 'undo' | 'redo' | 'clearFormat' | '|';
+export interface StatusBarConfig {
+    /** Show the DOM ancestor tag breadcrumb at the cursor (e.g. p › strong). Default: true. */
+    tagBreadcrumb?: boolean;
+    /** Show the word count. Default: true. */
+    wordCount?: boolean;
+    /** Show the character count. Default: false. */
+    charCount?: boolean;
+}
+export interface RichTextImageUploadConfig {
+    /**
+     * Storage path prefix for uploaded images.
+     * Requires a StorageProvider ancestor.
+     * Example: "/content/posts/hero"
+     */
+    path?: string;
+    /**
+     * Pixel widths to generate as responsive srcset variants.
+     * Each width produces a canvas-resized copy stored as <name>_<width>w.<ext>.
+     * Pass [] to disable srcset generation entirely.
+     * Default: [400, 800]
+     */
+    srcsetWidths?: number[];
+    /**
+     * Accepted MIME types for the image file picker.
+     * Default: "image/*"
+     */
+    accept?: string;
+    /**
+     * Maximum file size in bytes.
+     * Default: 10_485_760 (10 MB)
+     */
+    maxBytes?: number;
+}
+export interface RichTextDocumentUploadConfig {
+    /**
+     * Storage path prefix for uploaded documents.
+     * Requires a StorageProvider ancestor.
+     * Example: "/content/posts/attachments"
+     */
+    path?: string;
+    /**
+     * Accepted MIME types / file extensions for the document file picker.
+     * Default: ".pdf,.doc,.docx,.txt,.csv"
+     */
+    accept?: string;
+    /**
+     * Maximum file size in bytes.
+     * Default: 20_971_520 (20 MB)
+     */
+    maxBytes?: number;
+}
+export interface RichTextProps extends FormFieldProps {
+    placeholder?: string;
+    disabled?: boolean;
+    feedback?: string;
+    /** Position of the formatting toolbar. false hides it entirely. Default: 'fixed'. */
+    toolbar?: 'fixed' | 'floating' | false;
+    /** Ordered list of toolbar commands to show. Defaults to all commands. */
+    toolbarCommands?: ToolbarCommand[];
+    /** Format used to read/write the field value. Default: 'html'. */
+    outputFormat?: 'html' | 'json' | 'text';
+    /** Show the status bar below the editor. Pass true for defaults or a config object. Default: false. */
+    statusBar?: boolean | StatusBarConfig;
+    /** Minimum editor height in px. Default: 120. */
+    minHeight?: number;
+    /** Maximum editor height in px; content scrolls beyond this. */
+    maxHeight?: number;
+    /**
+     * Image upload behaviour for the imageUpload toolbar command.
+     * Pass an object to enable uploads; omit to keep images as base64 data URIs.
+     */
+    imageUpload?: RichTextImageUploadConfig;
+    /**
+     * Document upload behaviour for the documentUpload toolbar command.
+     * Pass an object to enable cloud storage uploads; omit to use data URI fallback.
+     */
+    documentUpload?: RichTextDocumentUploadConfig;
+    labelClassName?: string;
+    validator?: (value: FieldValue) => string | undefined;
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
+}
+export declare const RichText: ({ name, onChange, defaultValue, label, required, placeholder, disabled, feedback, toolbar, toolbarCommands, outputFormat, statusBar, minHeight, maxHeight, imageUpload, documentUpload, labelClassName, inheritWrapperClassName, wrapperClassName, className, before, after, validator, commands, commandsTrigger, }: RichTextProps) => React.JSX.Element;
+export default RichText;

package/dist/types/src/components/ui/fields/Select.d.ts

@@ -1,38 +1,41 @@
 import React from 'react';
 import { type OrderConfig } from "../../../libs/order";
-import { DBConfig, RecordProps } from "../../../providers/data/DataProvider";
+import { DBConfig, FieldValue, RecordProps } from "../../../providers/data/DataProvider";
 import { FormFieldProps } from '../../widgets/Form';
 interface Option extends RecordProps {
     label: string;
     value: string;
+    group?: string;
 }
 type OptionOrderConfig = OrderConfig & {
     field: 'label' | 'value';
 };
 interface BaseProps extends FormFieldProps {
-    updatable?: boolean;
+    /** When `true`, the select becomes read-only (disabled) once a value has been set. */
+    readOnlyAfterSet?: boolean;
     disabled?: boolean;
     title?: string;
     feedback?: string;
     options?: Option[] | string[] | number[];
-    db?: DBConfig;
+    optionsSource?: DBConfig;
     order?: OptionOrderConfig;
+    validator?: (value: FieldValue) => string | undefined;
 }
 export interface SelectProps extends BaseProps {
-    optionEmpty?: Option;
+    placeholderOption?: Option;
     value?: string | number;
 }
 export interface AutocompleteProps extends BaseProps {
-    min?: number;
-    max?: number;
+    minItems?: number;
+    maxItems?: number;
     placeholder?: string;
     creatable?: boolean;
     onCreate?: (value: string) => Promise<void> | void;
 }
 export interface ChecklistProps extends BaseProps {
-    checkClass?: string;
+    itemClassName?: string;
 }
-export declare const Select: ({ name, onChange, defaultValue, required, updatable, disabled, optionEmpty, label, title, pre, post, feedback, options, db, order, wrapClass, className, }: SelectProps) => React.JSX.Element;
-export declare const Autocomplete: ({ name, defaultValue, min, max, onChange, required, updatable, disabled, label, title, placeholder, pre, post, feedback, options, db, order, wrapClass, className, creatable, onCreate, }: AutocompleteProps) => React.JSX.Element;
-export declare const Checklist: ({ name, defaultValue, onChange, required, updatable, disabled, label, title, pre, post, feedback, options, db, order, wrapClass, className, checkClass, }: ChecklistProps) => React.JSX.Element;
+export declare const Select: ({ name, onChange, defaultValue, required, readOnlyAfterSet, disabled, placeholderOption, label, title, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, }: SelectProps) => React.JSX.Element;
+export declare const Autocomplete: ({ name, defaultValue, minItems, maxItems, onChange, required, readOnlyAfterSet, disabled, label, title, placeholder, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, creatable, onCreate, }: AutocompleteProps) => React.JSX.Element;
+export declare const Checklist: ({ name, defaultValue, onChange, required, readOnlyAfterSet, disabled, label, title, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, itemClassName, }: ChecklistProps) => React.JSX.Element;
 export {};

package/dist/types/src/components/ui/fields/Upload.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { FormFieldProps } from "../../widgets/Form";
+import type { StorageProviderAdapter } from "../../../providers/storage/StorageProvider";
 export interface FileProps {
     key: string;
     fileName: string;
@@ -9,17 +10,64 @@ export interface FileProps {
     url: string;
     base64?: string;
     variants: Record<string, any>;
+    srcset?: string;
+    sizes?: string;
 }
+export interface UseFileUploadCoreOptions {
+    /** Called on every files state update. Use for Form sync. */
+    onFilesChange?: (files: FileProps[]) => void;
+    /** Called once when a file reaches progress 100. Use to trigger insert dialogs. */
+    onFileReady?: (file: FileProps) => void;
+    /** StorageProvider path. When set with a storage provider, files are auto-uploaded. */
+    uploadPath?: string;
+    /**
+     * Pixel widths for responsive image variants. When set with uploadPath, generates
+     * canvas-resized variants at each width and populates file.srcset / file.sizes.
+     * Each variant is stored as <name>_<width>w.<ext>. Default: undefined (no variants).
+     * Example: [400, 800] produces _400w and _800w files.
+     */
+    srcsetWidths?: number[];
+    /** Initial file list (e.g. from a form record on load). */
+    initialFiles?: FileProps[];
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /**
+     * Direct adapter instance — takes priority over `storageKey` when set. For callers that
+     * already computed the right adapter themselves (e.g. a per-record bucket resolved from
+     * that record's own fields, not from a registry key) rather than one registered globally.
+     */
+    storageProvider?: StorageProviderAdapter | null;
+}
+export declare const useFileUploadCore: ({ onFilesChange, onFileReady, uploadPath, srcsetWidths, initialFiles, storageKey, storageProvider, }: UseFileUploadCoreOptions) => {
+    files: FileProps[];
+    setFiles: React.Dispatch<React.SetStateAction<FileProps[]>>;
+    fileInputRef: React.MutableRefObject<HTMLInputElement | null>;
+    updateFile: (key: string, updates: Partial<FileProps>) => void;
+    handleFiles: (selectedFiles: File[]) => void;
+    handleUpload: () => void | undefined;
+    handleUploadChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    handleRemove: (key: string) => void;
+};
 export interface UploadDocumentProps extends FormFieldProps {
     editable?: boolean;
     multiple?: boolean;
     accept?: string;
     max?: number;
+    /** StorageProvider path — when set, files are auto-uploaded on selection. */
+    uploadPath?: string;
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /** Direct adapter instance — takes priority over `storageKey` when set. */
+    storageProvider?: StorageProviderAdapter | null;
 }
 export interface UploadImageProps extends UploadDocumentProps {
     previewHeight?: number;
     previewWidth?: number;
+    /** Text shown inside the empty-state drop zone, below the upload icon. */
+    feedback?: string;
+    /** Pixel widths for responsive variants. Set with uploadPath to generate <name>_400w.jpg etc. and populate srcset/sizes in the Form record. */
+    srcsetWidths?: number[];
 }
 export declare const getFileUrl: (file: FileProps, suffix?: string) => string;
-export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, pre, post, wrapClass, className, }: UploadDocumentProps) => React.JSX.Element;
-export declare const UploadImage: ({ name, onChange, label, editable, multiple, accept, required, max, previewHeight, previewWidth, pre, post, wrapClass, className, }: UploadImageProps) => React.JSX.Element;
+export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, uploadPath, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadDocumentProps) => React.JSX.Element;
+export declare const UploadImage: ({ name, onChange, label, feedback, editable, multiple, accept, required, max, previewHeight, previewWidth, uploadPath, srcsetWidths, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadImageProps) => React.JSX.Element;

package/dist/types/src/components/ui/fields/UploadCSV.d.ts

@@ -15,12 +15,14 @@ export type UploadCSVParseFieldHandler = (field: UploadCSVParseField) => UploadC
 interface UploadCSVProps extends UIProps {
     name: string;
     onDataLoaded: UploadCSVDataLoadedHandler;
+    onClear?: () => void;
     onParseField?: UploadCSVParseFieldHandler;
     label?: string;
     icon?: string;
     delimiter?: string;
     normalizeKeys?: boolean;
     removeEmptyFields?: boolean;
+    required?: boolean;
 }
 export declare const UploadCSV: React.FC<UploadCSVProps>;
 export {};

package/dist/types/src/components/ui/useRecordSelection.d.ts

@@ -7,11 +7,10 @@ export type RecordSelectionState<TRecord> = {
 type UseRecordSelectionArgs<TRecord> = {
     records: TRecord[];
     selectedKeys?: string[];
-    legacySelectedKeys?: string[];
     onSelectionChange?: (selection: RecordSelectionState<TRecord>) => void;
     getRecordKey: (record: TRecord, index: number) => string;
 };
-export declare function useRecordSelection<TRecord>({ records, selectedKeys, legacySelectedKeys, onSelectionChange, getRecordKey, }: UseRecordSelectionArgs<TRecord>): {
+export declare function useRecordSelection<TRecord>({ records, selectedKeys, onSelectionChange, getRecordKey, }: UseRecordSelectionArgs<TRecord>): {
     activeSelectedKeys: string[];
     selectionState: RecordSelectionState<TRecord>;
     showSelection: boolean;