@recursica/mui-adapter 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @recursica/mui-adapter
 
+## 0.31.0
+
+### Minor Changes
+
+- e4759d1: Slider: fixed the raw numeric value duplicating next to the track when `tooltipLabel` is a formatter (now reuses the same formatter), added `minLabel`/`maxLabel` overrides for the track's end labels, and added a `trailingIcon` prop alongside the existing leading `icon`.
+
+### Patch Changes
+
+- Updated dependencies [e4759d1]
+  - @recursica/adapter-common@0.22.0
+
+## 0.30.0
+
+### Minor Changes
+
+- 0bb2dab: **Breaking:** `Chip`'s `onRemove` prop is renamed to `onDelete` in both adapters, matching MUI's own `onDelete` naming and removing the previous internal aliasing between the two. Update any `Chip` usage passing `onRemove` to `onDelete` — the behavior (rendering the remove/X icon and firing on click or Enter/Space) is unchanged. `FileInput` and `FileUpload`'s own public props are unaffected; they only consume `Chip` internally.
+- 0bb2dab: Updated props with breaking changes
+
+### Patch Changes
+
+- Updated dependencies [0bb2dab]
+- Updated dependencies [0bb2dab]
+  - @recursica/adapter-common@0.21.0
+
 ## 0.29.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -155,7 +155,9 @@ declare const AccordionPanel_2: default_2.ForwardRefExoticComponent<(Omit<Omit<W
 
 declare type AccordionPanelWrapperProps = RecursicaOverStyled<AccordionDetailsProps & RecursicaAccordionPanelProps>;
 
-declare type AccordionProps = RecursicaOverStyled<default_2.HTMLAttributes<HTMLDivElement> & RecursicaAccordionProps>;
+declare type AccordionProps = RecursicaOverStyled<default_2.HTMLAttributes<HTMLDivElement> & RecursicaAccordionProps & {
+    onChange?: (value: string | string[] | null) => void;
+}>;
 
 export declare const AssistiveElement: typeof rawComponents.AssistiveElement;
 
@@ -1441,8 +1443,6 @@ export declare interface RecursicaAccordionProps {
     value?: string | string[];
     /** Initial expanded value(s) in uncontrolled mode */
     defaultValue?: string | string[];
-    /** Callback triggered when value changes */
-    onChange?: (value: string | string[] | null) => void;
     /** Allow multiple panels to be open simultaneously */
     multiple?: boolean;
     /** Custom chevron icon to replace the default expand/collapse indicator. Applies to every
@@ -1484,9 +1484,9 @@ declare interface RecursicaAutocompleteProps_2 {
     id?: string;
     /** Initial default value */
     defaultValue?: unknown;
-    /** Left section decoration (e.g. icon) */
+    /** Left section decoration (e.g. icon). Naming rationale: see `RecursicaTextFieldProps.leftSection`. */
     leftSection?: default_2.ReactNode;
-    /** Right section decoration (e.g. action button) */
+    /** Right section decoration (e.g. action button). Same rationale as `leftSection` above. */
     rightSection?: default_2.ReactNode;
     /** Placeholder text */
     placeholder?: string;
@@ -1562,13 +1562,10 @@ export declare interface RecursicaCheckboxGroupProps {
     value?: unknown[];
     /** Default selected values in uncontrolled mode */
     defaultValue?: unknown[];
-    /** Callback triggered on selection change */
-    onChange?: (value: unknown[]) => void;
-    /** Toggle horizontal row display */
-    row?: boolean;
 }
 
 declare interface RecursicaCheckboxGroupProps_2 extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "onChange" | "classes" | "withAsterisk" | "defaultValue">, ReadOnlyControlProps, RecursicaCheckboxGroupProps {
+    onChange?: (value: unknown[]) => void;
 }
 
 /**
@@ -1594,22 +1591,22 @@ export declare interface RecursicaChipProps {
     /** Leading icon content */
     icon?: default_2.ReactNode;
     /** Called when the remove (X) icon is clicked. If provided, the remove icon will be displayed. */
-    onRemove?: (e: default_2.MouseEvent<HTMLSpanElement, MouseEvent>) => void;
-    /** Screen reader label for the remove button. Defaults to 'Remove' */
-    removeLabel?: string;
+    onDelete?: (e: default_2.MouseEvent<HTMLSpanElement, MouseEvent>) => void;
+    /** Screen reader label for the delete button. Defaults to 'Delete' */
+    deleteLabel?: string;
     /** Checked state for the chip (acts as a checkbox) */
     checked?: boolean;
     /**
-     * Tab index for the remove (X) icon. Defaults to `0`. Lets a parent implement a roving-tabindex
+     * Tab index for the delete (X) icon. Defaults to `0`. Lets a parent implement a roving-tabindex
      * pattern across a group of chips (e.g. FileUpload's file list) by setting this to `-1` on every
      * chip except the currently-active one.
      */
-    removeTabIndex?: number;
+    deleteTabIndex?: number;
     /**
-     * Ref to the remove (X) icon element, so a parent can move focus to it imperatively — e.g.
+     * Ref to the delete (X) icon element, so a parent can move focus to it imperatively — e.g.
      * arrow-key navigation across a group of chips.
      */
-    removeIconRef?: default_2.Ref<HTMLSpanElement>;
+    deleteIconRef?: default_2.Ref<HTMLSpanElement>;
 }
 
 /**
@@ -1739,6 +1736,12 @@ export declare interface RecursicaFileInputProps {
     maxFilesMessage?: default_2.ReactNode;
     /** Leading icon shown inside the control. Defaults to the built-in upload icon. */
     icon?: default_2.ReactNode;
+    /**
+     * Trailing clear-all icon shown once a file is selected. Defaults to the built-in X icon.
+     * Forge's `file-input` token set exposes a `trailing-icon` color alongside `leading-icon`
+     * for exactly this slot.
+     */
+    clearIcon?: 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"`. */
@@ -1910,7 +1913,12 @@ export declare interface RecursicaFormControlWrapperProps extends Omit<FormContr
 declare interface RecursicaFormControlWrapperProps_2 extends RecursicaLabelProps {
     /** Overall structural flow mapping the Form Control natively cascading down to Label and Input logic. */
     formLayout?: "stacked" | "side-by-side";
-    /** Securely replaces standard descriptions safely providing standard Assistive properties. */
+    /**
+     * Securely replaces standard descriptions safely providing standard Assistive properties.
+     * Not renamed to Forge's `helpText`/`errorText`: our own vocabulary, covering both help and
+     * error copy via one prop plus `assistiveVariant`; `description`/`helperText` below already
+     * exist as native-API fallback aliases.
+     */
     assistiveText?: default_2.ReactNode;
     /** Fallback description prop to match native APIs safely. */
     description?: default_2.ReactNode;
@@ -2010,15 +2018,24 @@ export declare interface RecursicaHoverCardProps {
 export declare interface RecursicaLabelProps {
     /** Specifies the sizing metrics natively mapping the Label boundaries. */
     labelSize?: "default" | "small" | "md";
-    /** Overall alignment directive for the label strings natively forcing Left/Right justification. */
+    /**
+     * Overall alignment directive for the label strings natively forcing Left/Right justification.
+     * Not renamed to Forge's `labelAlign`: our own vocabulary, not either kit's native term.
+     */
     labelAlignment?: "left" | "right";
-    /** Injects an indicator text block alongside the label. Can be boolean (`true` maps to '(Optional)') or custom React nodes. */
+    /**
+     * Injects an indicator text block alongside the label. Can be boolean (`true` maps to '(Optional)') or custom React nodes.
+     * Not renamed to Forge's `optional`: same reason as `labelAlignment` above.
+     */
     labelOptionalText?: boolean | default_2.ReactNode;
     /** When true, forces the native Edit Icon to replace the standard asterisk visually. */
     labelWithEditIcon?: boolean;
     /** Custom action area to render alongside the label instead of the default edit icon. */
     labelActionArea?: default_2.ReactNode;
-    /** Interaction hook invoked whenever a generated edit icon block natively triggers a click event. */
+    /**
+     * Interaction hook invoked whenever a generated edit icon block natively triggers a click event.
+     * Not renamed to Forge's `onEditIconClick`: same reason as `labelAlignment` above.
+     */
     onLabelEditClick?: default_2.MouseEventHandler<HTMLButtonElement>;
 }
 
@@ -2090,9 +2107,9 @@ export declare interface RecursicaNumberInputProps extends Omit<TextFieldProps,
 declare interface RecursicaNumberInputProps_2 {
     /** Enables/disables the controls to increment and decrement the value */
     hideControls?: boolean;
-    /** Content rendered on the left side of the input (e.g. icon) */
+    /** Content rendered on the left side of the input (e.g. icon). Naming rationale: see `RecursicaTextFieldProps.leftSection`. */
     leftSection?: React.ReactNode;
-    /** Content rendered on the right side of the input (e.g. percentage sign) */
+    /** Content rendered on the right side of the input (e.g. percentage sign). Same rationale as `leftSection` above. */
     rightSection?: React.ReactNode;
     /** Minimum possible value */
     min?: number;
@@ -2129,9 +2146,13 @@ export declare interface RecursicaPaginationProps {
  * Props for the Recursica Panel component.
  */
 export declare interface RecursicaPanelProps {
-    /** Forces header text onto a single line truncating overflow with ellipsis */
+    /** Forces header text onto a single line truncating overflow with ellipsis.  Default is true */
     wrapHeaderText?: boolean;
-    /** Direction or placement where the panel slides out from */
+    /**
+     * Direction the panel slides out from.
+     * Named `placement`, not `position`: `position` is a global `BlockedStylingKeys` entry, so
+     * it's typed `never` and stripped unless `overStyled: true`.
+     */
     placement?: "top" | "bottom" | "left" | "right";
     /** Control visibility state */
     opened?: boolean;
@@ -2159,16 +2180,9 @@ export declare interface RecursicaRadioGroupProps {
     value?: unknown;
     /** Initial selected value in uncontrolled mode */
     defaultValue?: unknown;
-    /**
-     * Callback triggered when active value changes.
-     * Single-argument by design (no event): matches Mantine's native RadioGroup
-     * onChange, the cross-adapter source of truth. mui-adapter's RadioGroup
-     * normalizes MUI's native two-argument (event, value) callback down to this.
-     */
-    onChange?: (value: string) => void;
 }
 
-declare interface RecursicaRadioGroupProps_2 extends Omit<RadioGroupProps_2, "size" | "labelProps" | "classes" | "ref" | "onChange" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | keyof RadioGroupProps_2>, ReadOnlyControlProps, RecursicaRadioGroupProps {
+declare interface RecursicaRadioGroupProps_2 extends Omit<RadioGroupProps_2, "size" | "labelProps" | "classes" | "ref" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | keyof RadioGroupProps_2>, ReadOnlyControlProps, RecursicaRadioGroupProps {
 }
 
 /**
@@ -2215,18 +2229,18 @@ export declare interface RecursicaSegmentedControlProps {
     orientation?: "horizontal" | "vertical";
     /** If true, the control will stretch full-width */
     fullWidth?: boolean;
-    /** SegmentedControl explicitly forbids disabled prop */
-    disabled?: never;
+    /** Disables every item in the control at once; a single item can still be disabled via `data` */
+    disabled?: boolean;
     /** Data configuration options array */
     data?: Array<string | {
         label: default_2.ReactNode;
         value: string;
         disabled?: boolean;
+        /** Optional leading icon rendered alongside the item's label */
+        icon?: default_2.ReactNode;
     }>;
     /** Active selected item value key */
     value?: string;
-    /** Callback triggered when selected item changes */
-    onChange?: (value: string) => void;
 }
 
 /**
@@ -2257,10 +2271,16 @@ declare interface RecursicaSliderProps_2 {
     tooltipLabel?: default_2.ReactNode | ((value: number) => default_2.ReactNode);
     /** Icon shown to the left of the slider track */
     icon?: default_2.ReactNode;
+    /** Icon shown to the right of the slider track */
+    trailingIcon?: default_2.ReactNode;
     /** Render numeric input side-by-side or stacked */
     showInput?: boolean;
     /** Show min and max labels below track */
     showMinMaxLabels?: boolean;
+    /** Override the label shown at the minimum end of the track. Defaults to the numeric `min`. */
+    minLabel?: default_2.ReactNode;
+    /** Override the label shown at the maximum end of the track. Defaults to the numeric `max`. */
+    maxLabel?: default_2.ReactNode;
 }
 
 /**
@@ -2301,11 +2321,10 @@ export declare interface RecursicaSwitchGroupProps {
     value?: string[];
     /** Checked default values list in uncontrolled mode */
     defaultValue?: string[];
-    /** Callback triggered when any switch toggles state */
-    onChange?: (value: string[]) => void;
 }
 
 declare interface RecursicaSwitchGroupProps_2 extends Omit<FormGroupProps, "size" | "labelProps" | "onChange" | "classes" | "ref" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | "defaultValue">, ReadOnlyControlProps, RecursicaSwitchGroupProps {
+    onChange?: (value: string[]) => void;
 }
 
 /**
@@ -2404,9 +2423,13 @@ export declare interface RecursicaTextFieldProps extends Omit<InputBaseProps, "c
  * Props for the Recursica TextField component.
  */
 declare interface RecursicaTextFieldProps_2 {
-    /** Section rendered inside input on the left (e.g. icon) */
+    /**
+     * Section rendered inside input on the left (e.g. icon).
+     * Not renamed to Forge's `leadingIcon`: deliberately reuses Mantine's own native name;
+     * MUI's own (`startAdornment`) is more implementation-specific and isn't icon-only either.
+     */
     leftSection?: default_2.ReactNode;
-    /** Section rendered inside input on the right (e.g. clear button) */
+    /** Section rendered inside input on the right (e.g. clear button). Same naming rationale as `leftSection` above. */
     rightSection?: default_2.ReactNode;
 }
 
@@ -2647,12 +2670,12 @@ export declare const SegmentedControl: typeof rawComponents.SegmentedControl;
 /**
  * Recursica SegmentedControl component wrapping Mui's SegmentedControl.
  */
-declare const SegmentedControl_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<ToggleButtonGroupProps, "className" | "color" | "value" | "classNames" | "onChange" | "variant" | "disabled" | "size" | "radius"> & {
+declare const SegmentedControl_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<ToggleButtonGroupProps, "className" | "color" | "value" | "classNames" | "variant" | "size" | "radius"> & {
 className?: string;
 classNames?: Partial<Record<string, string>>;
 } & RecursicaSegmentedControlProps>, BlockedStylingKeys> & ForbiddenStyles & {
 overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<Omit<ToggleButtonGroupProps, "className" | "color" | "value" | "classNames" | "onChange" | "variant" | "disabled" | "size" | "radius"> & {
+}, "ref"> | Omit<Omit<Omit<ToggleButtonGroupProps, "className" | "color" | "value" | "classNames" | "variant" | "size" | "radius"> & {
 className?: string;
 classNames?: Partial<Record<string, string>>;
 } & RecursicaSegmentedControlProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
@@ -2670,7 +2693,7 @@ columnGap?: string | number | RecursicaSpacing;
 overStyled: true;
 }, "ref">) & RefAttributes<HTMLDivElement>>;
 
-declare type SegmentedControlProps = RecursicaOverStyled<Omit<ToggleButtonGroupProps, "variant" | "size" | "radius" | "color" | "classNames" | "className" | "disabled" | "value" | "onChange"> & {
+declare type SegmentedControlProps = RecursicaOverStyled<Omit<ToggleButtonGroupProps, "variant" | "size" | "radius" | "color" | "classNames" | "className" | "value"> & {
     className?: string;
     classNames?: Partial<Record<string, string>>;
 } & RecursicaSegmentedControlProps>;
@@ -2681,7 +2704,8 @@ export declare const Slider: typeof rawComponents.Slider;
  * Recursica Slider component wrapping Mui's Slider.
  *
  * Implements a bidirectional text input field next to the slider track, responsive layouts,
- * custom typography-bound min/max labels, an optional leading icon, and an explicit read-only layout.
+ * custom typography-bound min/max labels (optionally overridden via `minLabel`/`maxLabel`),
+ * optional leading/trailing icons, and an explicit read-only layout.
  */
 declare const Slider_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<RecursicaSliderProps>, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;