v4.3.2 - Update mui-components to 1.1.4, update jsdocs and bug fix for RHFFileUploader and RHFNativeSelect (#78)

* bump pkg version, mui-components to 1.1.4; update README

* add jsdoc for ConfigProvider, DefaultRHFMuiConfig; update README

* Update JSDoc for countryList and selectAllOptionValue

* RHFNativeSelect pass OptionRenderState in renderOptionLabel

Author: nishkohli96

README.md

@@ -17,11 +17,13 @@
   <b>A suite of 25+ production-ready <a href="https://mui.com/">Material UI</a> components for <a href="https://react-hook-form.com/">react-hook-form</a> — fully typed, tree-shakable, and built to cut form boilerplate down to a handful of props.</b>
 </p>
 
-> ⚡ **Powered by [Mui Components](https://mui-components-docs.vercel.app/)**
+> ⚡ **Powered by [Mui Components](https://mui-components-docs.vercel.app)**
 >
-> From **v4.2.0** onwards, every component delegates its rendering and core logic to the form-library-agnostic **[@nish1896/mui-components](https://www.npmjs.com/package/@nish1896/mui-components)** — the same Material UI components, driven by a plain `value` / `onValueChange` pair instead of RHF bindings.
+> From **v4.2.0** onwards, every component delegates its rendering and core logic to the form-library-agnostic **[@nish1896/mui-components](https://www.npmjs.com/package/@nish1896/mui-components)** - the same Material UI components, driven by a plain `value` / `onValueChange` pair instead of RHF bindings.
 >
-> Worth checking out if you're building forms with plain React state or any other form library, or need Material UI components without wiring custom UI logic for commonly used components.
+> Worth checking out if:
+> - You're building forms with plain React state or any other form library
+> - You want Material UI components for common fields, pre-wired, without writing the binding logic yourself
 
 ## ✨ Features
 

apps/rhf-mui-demo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nish1896/rhf-mui-demo",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "private": true,
   "author": "Nishant Kohli",
   "scripts": {

apps/rhf-mui-docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nish1896/rhf-mui-docs",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",

changelog/v4.md

@@ -1,5 +1,19 @@
 # Changelog - v4
 
+## [4.3.2](https://github.com/nishkohli96/rhf-mui-components/tree/v4.3.2)
+
+**Released — 28 August, 2026**
+
+### ✨ Enhancements
+- Update `mui-components` to `v1.1.4`
+- Add JSDoc for `ConfigProvider`, `DefaultRHFMuiConfig`
+- Update JSDoc for `countryList` and `selectAllOptionValue`
+
+### 🐞 Bug Fixes
+- `RHFFileUploader`: Fixed single-file mode wiping the current value to `null` when a replacement file was rejected (invalid type/size or over `maxFiles`) — the current file is now kept instead.
+- `RHFNativeSelect`: Fixed `renderOptionLabel` not receiving the option's `state` (`disabled`/`selected`) — now matches the signature used by `RHFSelect` and other option-based components.
+
+
 ## [4.3.1](https://github.com/nishkohli96/rhf-mui-components/tree/v4.3.1)
 
 **Released — 13 August, 2026**

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nish1896/rhf-mui-components-root",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "description": "A suite of 25+ production-ready react-hook-form components built with material-ui. Fully typed, tree-shakable, and optimized for enterprise-grade forms.",
   "author": "Nishant Kohli",
   "private": true,

packages/rhf-mui-components/README.md

@@ -17,11 +17,13 @@
   <b>A suite of 25+ production-ready <a href="https://mui.com/">Material UI</a> components for <a href="https://react-hook-form.com/">react-hook-form</a> — fully typed, tree-shakable, and built to cut form boilerplate down to a handful of props.</b>
 </p>
 
-> ⚡ **Powered by [Mui Components](https://mui-components-docs.vercel.app/)**
+> ⚡ **Powered by [Mui Components](https://mui-components-docs.vercel.app)**
 >
-> From **v4.2.0** onwards, every component delegates its rendering and core logic to the form-library-agnostic **[@nish1896/mui-components](https://www.npmjs.com/package/@nish1896/mui-components)** — the same Material UI components, driven by a plain `value` / `onValueChange` pair instead of RHF bindings.
+> From **v4.2.0** onwards, every component delegates its rendering and core logic to the form-library-agnostic **[@nish1896/mui-components](https://www.npmjs.com/package/@nish1896/mui-components)** - the same Material UI components, driven by a plain `value` / `onValueChange` pair instead of RHF bindings.
 >
-> Worth checking out if you're building forms with plain React state or any other form library, or need Material UI components without wiring custom UI logic for commonly used components.
+> Worth checking out if:
+> - You're building forms with plain React state or any other form library
+> - You want Material UI components for common fields, pre-wired, without writing the binding logic yourself
 
 ## ✨ Features
 

packages/rhf-mui-components/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nish1896/rhf-mui-components",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "description": "A suite of 25+ production-ready react-hook-form components built with material-ui. Fully typed, tree-shakable, and optimized for enterprise-grade forms.",
   "author": "Nishant Kohli",
   "homepage": "https://rhf-mui-components.vercel.app/",
@@ -16,7 +16,7 @@
   "type": "module",
   "sideEffects": false,
   "dependencies": {
-    "@nish1896/mui-components": "^1.1.2"
+    "@nish1896/mui-components": "^1.1.4"
   },
   "devDependencies": {
     "@ckeditor/ckeditor5-core": "43.3.0",
@@ -62,11 +62,7 @@
     "./mui-pickers/*": "./dist/mui-pickers/*/index.js",
     "./misc": "./dist/misc/index.js",
     "./misc/*": "./dist/misc/*/index.js",
-    "./types": "./dist/types/index.js",
-    "./types/*": {
-      "types": "./dist/types/*.d.ts",
-      "default": "./dist/types/index.js"
-    }
+    "./types": "./dist/types/index.js"
   },
   "types": "./index.d.ts",
   "keywords": [

packages/rhf-mui-components/src/common/types/components.ts

@@ -39,9 +39,9 @@ export type CustomOnChangeProps<T, V> = T & {
 };
 
 /**
- * Per-option state handed to `renderOptionLabel` so custom labels can react to
- * the option's current status — e.g. dim a disabled option or emphasise the
- * selected one.
+ * Per-option state handed to `renderOptionLabel` so custom labels can react
+ * to the option's current status — e.g. dim a disabled option or emphasise
+ * the selected one.
  *
  * Used by the form-control option components (radio group, checkbox group,
  * select). The Autocomplete family passes MUI's `AutocompleteRenderOptionState`
@@ -50,8 +50,8 @@ export type CustomOnChangeProps<T, V> = T & {
  */
 export type OptionRenderState = {
   /**
-   * Whether the option is currently non-interactive — either the whole field is
-   * disabled or the option was disabled via `getOptionDisabled`.
+   * Whether the option is currently non-interactive — either the whole
+   * field is disabled or the option was disabled via `getOptionDisabled`.
    */
   disabled: boolean;
   /** Whether the option is part of the current selection. */

packages/rhf-mui-components/src/config/ConfigProvider.tsx

@@ -9,6 +9,17 @@ type ConfigProviderProps = {
 export const RHFMuiConfigContext
   = createContext<RHFMuiConfig>(DefaultRHFMuiConfig);
 
+/**
+ * Context provider that sets shared defaults for all `RHF*` components
+ * mounted beneath it, including default `sx` overrides for `FormLabel`,
+ * `FormControlLabel`, and `FormHelperText`, a shared `dateAdapter` for
+ * all pickers, and whether field labels render above their controls by default.
+ *
+ * Each config key is merged on top of `DefaultRHFMuiConfig`, so you
+ * only need to pass the keys you want to override.
+ *
+ * Docs: [Customization](https://rhf-mui-components.vercel.app/v4/customization)
+ */
 export const ConfigProvider = ({
   children,
   defaultFormHelperTextSx,

packages/rhf-mui-components/src/config/DefaultConfig.ts

@@ -8,6 +8,16 @@ const DefaultStyles = Object.freeze({
   },
 });
 
+/**
+ * Baseline `RHFMuiConfig` every `RHF*` component falls back to when
+ * no `ConfigProvider` is mounted, or a given config key is left unset.
+ *
+ * Only supplies default `sx` overrides for `FormLabel`/`FormControlLabel`/
+ * `FormHelperText` spacing — `dateAdapter` and `allLabelsAboveFields` have
+ * no default and stay `undefined` until a `ConfigProvider` sets them.
+ *
+ * Docs: [Customization](https://rhf-mui-components.vercel.app/v4/customization)
+ */
 export const DefaultRHFMuiConfig: RHFMuiConfig = {
   defaultFormLabelSx: { mb: DefaultStyles.margin.bottom },
   defaultFormControlLabelSx: {},