@recursica/mantine-adapter 0.40.0 → 0.42.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @recursica/mantine-adapter
 
+## 0.42.0
+
+### Minor Changes
+
+- e0f5643: Implement `TransferList` (dual listbox) in both adapters, replacing the "coming soon" stub. Composes `FormControlWrapper`, `TextField`, `Checkbox`/`CheckboxGroup`, `Badge`, and `Button` — supports controlled/uncontrolled `data`, per-item grouping, per-pane search, and `stacked`/`side-by-side` form layout.
+- 2fb7069: Fix `Slider`'s `Disabled` story (was passing `disabled: false` in both adapters). In `mui-adapter`, also fix the disabled track showing red instead of grey, make the thumb focus ring keyboard-only (no glow on click/drag) to match Mantine, render assistive text as a `<span>`, and align mark label color/position with Mantine (which now applies its own mark label color token too).
+- 2fb7069: Fix `TextArea`: error state border now uses the recursica error color (was never triggering in either adapter). MUI disabled background/border, focus ring color, and default height now match Mantine instead of MUI's own defaults.
+
+### Patch Changes
+
+- 1616144: Fix `FileInput`'s clear-all button: pressing Enter or Space while it was focused opened the native file picker instead of clearing the selection (a regression from switching the control to the shared `Button` component, which dropped the keydown handler the previous bespoke element had).
+- 3ff5821: Fix `TransferList` checkboxes not toggling/showing checked state in either adapter (grouping-for-layout was silently overriding item selection). Add `readOnly` support and a `ReadOnly` story.
+- Updated dependencies [e0f5643]
+- Updated dependencies [1616144]
+- Updated dependencies [3ff5821]
+  - @recursica/adapter-common@0.18.0
+
+## 0.41.0
+
+### Minor Changes
+
+- 3d75770: Implement the `FileInput` component (single-line, `TextField`-shaped file picker with a native drag-and-drop drop target, single- and multiple-file modes, and a trailing clear icon) in `mantine-adapter` and `mui-adapter`, replacing the "coming soon" stub, with a shared `RecursicaFileInputProps` contract in `adapter-common` reusing `FileUpload`'s `RecursicaFileUploadItem`/validation interface (`accept`/`maxSize`/`maxFiles`/`readOnly`). Also adds `FileInput` to `RECURSICA_COMPONENTS` and moves `mui-adapter`'s export of it into the standard `wrapComponent` set (it was previously exported unwrapped, alongside the polymorphic layout primitives, as a leftover from its stub form).
+
+### Patch Changes
+
+- b86ca2b: `FileInput` now renders every selected file as a removable `Chip` in a horizontally scrollable row, in both single- and multiple-file mode (previously single-file mode showed plain filename text with no remove affordance). The trailing clear-all control is now a real shared `Button` (icon-only, "text" variant) instead of a bespoke `<span role="button">`.
+- Updated dependencies [3d75770]
+- Updated dependencies [b86ca2b]
+  - @recursica/adapter-common@0.17.0
+
 ## 0.40.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -371,9 +371,22 @@ export declare interface EmptyValueRendererProps {
 
 export declare const FileInput: typeof rawComponents.FileInput;
 
-declare const FileInput_2: default_2.FC<FileInputProps>;
+/**
+ * A single-line, `TextField`-shaped control for choosing one or more files, sharing
+ * `FileUpload`'s selection/validation interface (`accept`/`maxSize`/`maxFiles`, `readOnly`)
+ * behind a different presentation.
+ *
+ * @example
+ * <FileInput
+ *   label="Resume"
+ *   files={files}
+ *   onFilesAdded={(added) => setFiles(added.map((file) => ({ file })))}
+ *   onFileRemove={() => setFiles([])}
+ * />
+ */
+declare const FileInput_2: default_2.ForwardRefExoticComponent<FileInputProps & default_2.RefAttributes<HTMLDivElement>>;
 
-declare type FileInputProps = default_2.HTMLAttributes<HTMLDivElement>;
+declare type FileInputProps = RecursicaOverStyled<RecursicaFileInputProps_2>;
 
 /**
  * Mirrors the semantics of the native HTML `accept` attribute (comma-separated file extensions,
@@ -1348,9 +1361,10 @@ declare namespace rawComponents {
         RecursicaDropdownProps,
         DropdownProps,
         Dropdown_2 as Dropdown,
+        RecursicaFileUploadItem,
+        RecursicaFileInputProps_2 as RecursicaFileInputProps,
         FileInputProps,
         FileInput_2 as FileInput,
-        RecursicaFileUploadItem,
         RecursicaFileUploadProps_2 as RecursicaFileUploadProps,
         FileUploadProps,
         FileUpload_2 as FileUpload,
@@ -1508,6 +1522,9 @@ declare namespace rawComponents {
         TooltipFloatingProps,
         TooltipFloating,
         Tooltip_2 as Tooltip,
+        RecursicaTransferListItem,
+        RecursicaTransferListData,
+        RecursicaTransferListProps_2 as RecursicaTransferListProps,
         TransferListProps,
         TransferList_2 as TransferList,
         TreeProps,
@@ -1561,7 +1578,7 @@ declare type ReadOnlyTextFieldProps = RecursicaOverStyled<RecursicaReadOnlyTextF
 /**
  * Official list of all components in Recursica.
  */
-export declare const RECURSICA_COMPONENTS: readonly ["Accordion", "AssistiveElement", "Autocomplete", "Avatar", "Badge", "Breadcrumb", "Button", "Card", "Checkbox", "Chip", "Container", "DatePicker", "Dropdown", "EmptyValueRenderer", "Flex", "FormControlLayout", "FormControlWrapper", "Grid", "Group", "HoverCard", "Label", "Layer", "Link", "Loader", "Menu", "Modal", "NumberInput", "Pagination", "Panel", "Popover", "Radio", "ReadOnlyField", "SegmentedControl", "Slider", "Stack", "Stepper", "Switch", "Table", "Tabs", "Text", "TextArea", "TextField", "TimePicker", "Timeline", "Title", "Toast", "Tooltip", "TransferList"];
+export declare const RECURSICA_COMPONENTS: readonly ["Accordion", "AssistiveElement", "Autocomplete", "Avatar", "Badge", "Box", "Breadcrumb", "Button", "Card", "Checkbox", "CheckboxGroup", "Chip", "Container", "DatePicker", "Dropdown", "EmptyValueRenderer", "FileInput", "FileUpload", "Flex", "FormControlLayout", "FormControlWrapper", "Grid", "Group", "HoverCard", "Label", "Layer", "Link", "Loader", "Menu", "Modal", "NumberInput", "Pagination", "Panel", "Popover", "Radio", "ReadOnlyField", "SegmentedControl", "Slider", "Stack", "Stepper", "Switch", "Table", "Tabs", "Text", "TextArea", "TextField", "TimePicker", "Timeline", "Title", "Toast", "Tooltip", "TransferList", "Tree", "Typography"];
 
 /**
  * Props for the Recursica Accordion Control component.
@@ -1844,10 +1861,93 @@ declare interface RecursicaDropdownProps_2 {
     placeholder?: string;
 }
 
+/**
+ * Props for the Recursica FileInput component.
+ *
+ * `FileInput` is presented as a single-line, `TextField`-shaped control rather than
+ * `FileUpload`'s dropzone, but shares the same file-selection interface and validation
+ * behavior (`accept`/`maxSize`/`maxFiles`, `onFilesRejected`, `readOnly`) so integrators can
+ * move between them without relearning the contract.
+ */
+export declare interface RecursicaFileInputProps {
+    /**
+     * Files currently selected. This is a controlled list — `onFilesAdded`/`onFileRemove`
+     * report changes, but `FileInput` never mutates this array itself; merge the reported
+     * changes into your own state and pass the updated list back in.
+     */
+    files?: RecursicaFileUploadItem[];
+    /**
+     * Called with the files the user just picked via the native file dialog or dropped onto
+     * the control. Only the newly added files are passed — merge them into `files` yourself.
+     */
+    onFilesAdded?: (files: File[]) => void;
+    /**
+     * Called when a file's remove affordance is activated, identified by its `id` (or
+     * `file.name` when no `id` was given for that entry). In single-file mode this is also
+     * called when the trailing clear icon removes the one selected file.
+     */
+    onFileRemove?: (id: string) => void;
+    /**
+     * Native `accept` attribute for the underlying file input (e.g. `".pdf,.png"` or
+     * `"image/*"`) — constrains the native file-picker dialog. Also enforced against files
+     * dropped onto the control, the same way `FileUpload` enforces it.
+     */
+    accept?: string;
+    /** Whether more than one file can be selected/dropped at once. Defaults to `false`. */
+    multiple?: boolean;
+    /**
+     * Maximum size per file, in bytes. Files exceeding this are passed to
+     * `onFilesRejected` instead of `onFilesAdded`.
+     */
+    maxSize?: number;
+    /**
+     * Maximum total number of files allowed in `files`. Only meaningful when `multiple` is
+     * `true` — Once reached, further dropped/picked files are passed to `onFilesRejected`
+     * instead of `onFilesAdded`.
+     */
+    maxFiles?: number;
+    /**
+     * Called with any files rejected for exceeding `maxSize`/`maxFiles` or not matching
+     * `accept`.
+     */
+    onFilesRejected?: (files: File[]) => void;
+    /**
+     * Error message shown (via the standard assistive-text error slot) when a dropped/picked
+     * file's extension or MIME type doesn't match `accept`. Defaults to
+     * `"File type not accepted"`.
+     */
+    invalidFileTypeMessage?: default_2.ReactNode;
+    /**
+     * Error message shown (via the standard assistive-text error slot) when a dropped/picked
+     * file would exceed `maxFiles`. Defaults to `"Maximum of {maxFiles} files allowed"`.
+     */
+    maxFilesMessage?: default_2.ReactNode;
+    /** Leading icon shown inside the control. Defaults to the built-in upload icon. */
+    icon?: default_2.ReactNode;
+    /** Text shown when no file is selected. Defaults to `"Select a file..."`. */
+    placeholder?: default_2.ReactNode;
+    /** Screen-reader label for the control itself. Defaults to `"Choose file"`. */
+    browseLabel?: string;
+    /** Screen-reader label for a file chip's remove button. Defaults to `"Remove"`. */
+    removeFileLabel?: string;
+    /** Screen-reader label for the trailing clear-all icon. Defaults to `"Clear"`. */
+    clearLabel?: string;
+    /** Disables the control and its remove/clear icons. */
+    disabled?: boolean;
+    /**
+     * Renders `files` as a static, non-interactive display with no clear/remove icons, and
+     * disables picking or dropping new files.
+     */
+    readOnly?: boolean;
+}
+
+declare interface RecursicaFileInputProps_2 extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "children" | "onDrop" | "onChange">, Pick<InputWrapperProps, "label" | "error" | "required" | "withAsterisk" | "id">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, RecursicaFileInputProps {
+}
+
 /**
  * A single file entry rendered as a removable chip in the FileUpload's file list.
  */
-export declare interface RecursicaFileUploadItem {
+declare interface RecursicaFileUploadItem {
     /** The underlying browser File object. */
     file: File;
     /**
@@ -1856,6 +1956,8 @@ export declare interface RecursicaFileUploadItem {
      */
     id?: string;
 }
+export { RecursicaFileUploadItem as RecursicaFileInputItem }
+export { RecursicaFileUploadItem }
 
 /**
  * Props for the Recursica FileUpload component.
@@ -2542,10 +2644,47 @@ export declare interface RecursicaTooltipProps {
     withBeak?: boolean;
 }
 
+/** Controlled/uncontrolled data shape: [sourceItems, targetItems] */
+export declare type RecursicaTransferListData = [
+RecursicaTransferListItem[],
+RecursicaTransferListItem[]
+];
+
+/**
+ * A single transferable item.
+ */
+export declare interface RecursicaTransferListItem {
+    /** Unique identifier used for selection and transfer */
+    value: string;
+    /** Display text */
+    label: string;
+    /** Optional group name — items sharing a group render under a CheckboxGroup */
+    group?: string;
+}
+
 /**
  * Props for the Recursica TransferList component.
  */
 export declare interface RecursicaTransferListProps {
+    /** Controlled data: [sourceItems, targetItems] */
+    data?: RecursicaTransferListData;
+    /** Uncontrolled initial data: [sourceItems, targetItems] */
+    defaultData?: RecursicaTransferListData;
+    /** Called with the new [sourceItems, targetItems] whenever items are transferred */
+    onChange?: (data: RecursicaTransferListData) => void;
+    /** Label for the source (left) list */
+    sourceLabel?: string;
+    /** Label for the target (right) list */
+    targetLabel?: string;
+    /** Enable per-pane search filtering. Defaults to true */
+    searchable?: boolean;
+    /** Placeholder text for the search fields */
+    searchPlaceholder?: string;
+}
+
+declare interface RecursicaTransferListProps_2 extends Omit<FormControlWrapperProps, "children" | "overStyled" | "controlMaxWidth" | "controlMinWidth" | "onChange">, ReadOnlyControlProps, RecursicaTransferListProps {
+    /** Disables the whole control */
+    disabled?: boolean;
 }
 
 /**
@@ -2982,9 +3121,9 @@ declare type TooltipProps = RecursicaOverStyled<TooltipProps_2 & RecursicaToolti
 
 export declare const TransferList: typeof rawComponents.TransferList;
 
-declare const TransferList_2: default_2.FC<TransferListProps>;
+declare const TransferList_2: ForwardRefExoticComponent<TransferListProps & RefAttributes<HTMLDivElement>>;
 
-declare type TransferListProps = default_2.HTMLAttributes<HTMLDivElement> & RecursicaTransferListProps;
+declare type TransferListProps = RecursicaOverStyled<RecursicaTransferListProps_2>;
 
 export declare const Tree: typeof rawComponents.Tree;