feat: add LevaRootProps.clearOnUnmount to clear all inputs on unmount

- Add `clearOnUnmount` prop to `LevaRootProps` that overrides individual
  input settings, clearing all paths from the store on component unmount
- Add `clearOnUnmount` / `setClearOnUnmount` to `StoreType` and `Store`
  so the flag is readable at cleanup time without needing reactive state
- Read `store.clearOnUnmount` in the useControls cleanup, falling back
  to the per-input Set when the store-level flag is false
- Add test covering the store-level flag via `levaStore.setClearOnUnmount`

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: RodrigoHamuy

packages/leva/src/components/Leva/LevaRoot.tsx

@@ -1,4 +1,4 @@
-import React, { useMemo, useState } from 'react'
+import React, { useEffect, useMemo, useState } from 'react'
 import * as RadixTooltip from '@radix-ui/react-tooltip'
 import { buildTree } from './tree'
 import { TreeWrapper } from '../Folder'
@@ -90,10 +90,20 @@ export type LevaRootProps = {
    * If true, the copy button will be hidden
    */
   hideCopyButton?: boolean
+  /**
+   * If true, all inputs will be cleared from the store when their component unmounts,
+   * regardless of the per-input clearOnUnmount setting.
+   */
+  clearOnUnmount?: boolean
 }
 
-export function LevaRoot({ store, hidden = false, theme, collapsed = false, ...props }: LevaRootProps) {
+export function LevaRoot({ store, hidden = false, theme, collapsed = false, clearOnUnmount = false, ...props }: LevaRootProps) {
   const themeContext = useDeepMemo(() => mergeTheme(theme), [theme])
+
+  useEffect(() => {
+    if (store) store.setClearOnUnmount(clearOnUnmount)
+  }, [store, clearOnUnmount])
+
   // collapsible
   const [toggled, setToggle] = useState(!collapsed)
 

packages/leva/src/store.ts

@@ -13,6 +13,10 @@ export const Store = function (this: StoreType) {
 
   this.storeId = getUid()
   this.useStore = store
+  this.clearOnUnmount = false
+  this.setClearOnUnmount = (flag) => {
+    this.clearOnUnmount = flag
+  }
   /**
    * Folders will hold the folder settings for the pane.
    * @note possibly make this reactive

packages/leva/src/types/internal.ts

@@ -29,6 +29,8 @@ type Dispose = () => void
 export type StoreType = {
   useStore: UseBoundStore<StoreApi<State>> & SubscribeWithSelectorAPI<State>
   storeId: string
+  clearOnUnmount: boolean
+  setClearOnUnmount: (flag: boolean) => void
   orderPaths: (paths: string[]) => string[]
   setOrderedPaths: (newPaths: string[]) => void
   disposePaths: (paths: string[]) => void

packages/leva/src/useControls.test.tsx

@@ -26,6 +26,7 @@ import { levaStore } from './store'
 
 afterEach(() => {
   levaStore.dispose()
+  levaStore.setClearOnUnmount(false)
 })
 
 function NumberComponent({ id }: { id?: string }) {
@@ -123,6 +124,23 @@ describe('useControls mount/unmount lifecycle', () => {
     expect(getByTestId2('value2').textContent).toBe('5')
   })
 
+  it('store-level clearOnUnmount resets all inputs on remount', () => {
+    levaStore.setClearOnUnmount(true)
+
+    const { getByTestId, unmount } = render(<NumberComponent id="value" />)
+    expect(getByTestId('value').textContent).toBe('5')
+
+    act(() => {
+      levaStore.setValueAtPath('myNumber', 42, true)
+    })
+    expect(getByTestId('value').textContent).toBe('42')
+
+    act(() => unmount())
+
+    const { getByTestId: getByTestId2 } = render(<NumberComponent id="value2" />)
+    expect(getByTestId2('value2').textContent).toBe('5')
+  })
+
   it('resets to the initial value when remounted after clearPath', () => {
     const { getByTestId, unmount } = render(<NumberComponent id="value" />)
     expect(getByTestId('value').textContent).toBe('5')

packages/leva/src/useControls.ts

@@ -207,7 +207,8 @@ export function useControls<S extends Schema, F extends SchemaOrFn<S> | string,
     depsChanged.current = false
     return () => {
       store.disposePaths(paths)
-      clearOnUnmountPaths.forEach((path) => store.clearPath(path))
+      const pathsToClear = store.clearOnUnmount ? paths : [...clearOnUnmountPaths]
+      pathsToClear.forEach((path) => store.clearPath(path))
     }
   }, [store, paths, initialData, clearOnUnmountPaths])