@mui/x-tree-view 9.6.0 → 9.8.0

package/internals/TreeViewProvider/TreeViewProvider.d.ts

@@ -1,5 +1,5 @@
-import { TreeViewProviderProps } from "./TreeViewProvider.types.js";
-import { TreeViewAnyStore } from "../models/index.js";
+import type { TreeViewProviderProps } from "./TreeViewProvider.types.js";
+import type { TreeViewAnyStore } from "../models/index.js";
 /**
  * Sets up the contexts for the underlying Tree Item components.
  *

package/internals/TreeViewProvider/TreeViewProvider.types.d.mts

@@ -1,10 +1,11 @@
-import * as React from 'react';
-import { TreeItemWrapper, TreeViewItemPluginResponse, TreeViewPublicAPI, TreeViewAnyStore } from "../models/index.mjs";
+import type * as React from 'react';
+import type { disposeSymbol } from '@mui/x-internals/disposable';
+import type { TreeItemWrapper, TreeViewItemPluginResponse, TreeViewPublicAPI, TreeViewAnyStore } from "../models/index.mjs";
 import type { TreeItemProps } from "../../TreeItem/TreeItem.types.mjs";
-import { TreeViewClasses, TreeViewSlotProps, TreeViewSlots } from "./TreeViewStyleContext.mjs";
-import { UseTreeViewBuildContextParameters } from "./useTreeViewBuildContext.mjs";
+import type { TreeViewClasses, TreeViewSlotProps, TreeViewSlots } from "./TreeViewStyleContext.mjs";
+import type { UseTreeViewBuildContextParameters } from "./useTreeViewBuildContext.mjs";
 export type TreeViewItemPluginsRunner = (props: TreeItemProps) => Required<TreeViewItemPluginResponse>;
-export type TreeViewStoreInContext<TStore extends TreeViewAnyStore> = Omit<TStore, 'setState' | 'update' | 'set' | 'updateStateFromParameters' | 'disposeEffect' | 'registerStoreEffect' | 'itemPluginManager' | 'parameters'>;
+export type TreeViewStoreInContext<TStore extends TreeViewAnyStore> = Omit<TStore, 'setState' | 'update' | 'set' | 'updateStateFromParameters' | 'disposables' | typeof disposeSymbol | 'mountEffect' | 'registerStoreEffect' | 'itemPluginManager' | 'parameters'>;
 export interface TreeViewContextValue<TStore extends TreeViewAnyStore> {
   publicAPI: TreeViewPublicAPI<TStore>;
   store: TreeViewStoreInContext<TStore>;

package/internals/TreeViewProvider/TreeViewProvider.types.d.ts

@@ -1,10 +1,11 @@
-import * as React from 'react';
-import { TreeItemWrapper, TreeViewItemPluginResponse, TreeViewPublicAPI, TreeViewAnyStore } from "../models/index.js";
+import type * as React from 'react';
+import type { disposeSymbol } from '@mui/x-internals/disposable';
+import type { TreeItemWrapper, TreeViewItemPluginResponse, TreeViewPublicAPI, TreeViewAnyStore } from "../models/index.js";
 import type { TreeItemProps } from "../../TreeItem/TreeItem.types.js";
-import { TreeViewClasses, TreeViewSlotProps, TreeViewSlots } from "./TreeViewStyleContext.js";
-import { UseTreeViewBuildContextParameters } from "./useTreeViewBuildContext.js";
+import type { TreeViewClasses, TreeViewSlotProps, TreeViewSlots } from "./TreeViewStyleContext.js";
+import type { UseTreeViewBuildContextParameters } from "./useTreeViewBuildContext.js";
 export type TreeViewItemPluginsRunner = (props: TreeItemProps) => Required<TreeViewItemPluginResponse>;
-export type TreeViewStoreInContext<TStore extends TreeViewAnyStore> = Omit<TStore, 'setState' | 'update' | 'set' | 'updateStateFromParameters' | 'disposeEffect' | 'registerStoreEffect' | 'itemPluginManager' | 'parameters'>;
+export type TreeViewStoreInContext<TStore extends TreeViewAnyStore> = Omit<TStore, 'setState' | 'update' | 'set' | 'updateStateFromParameters' | 'disposables' | typeof disposeSymbol | 'mountEffect' | 'registerStoreEffect' | 'itemPluginManager' | 'parameters'>;
 export interface TreeViewContextValue<TStore extends TreeViewAnyStore> {
   publicAPI: TreeViewPublicAPI<TStore>;
   store: TreeViewStoreInContext<TStore>;

package/internals/TreeViewProvider/TreeViewStyleContext.d.mts

@@ -1,4 +1,4 @@
-import { SlotComponentProps } from '@mui/utils/types';
+import type { SlotComponentProps } from '@mui/utils/types';
 import * as React from 'react';
 export interface TreeViewClasses {
   /** Styles applied to the root element. */

package/internals/TreeViewProvider/TreeViewStyleContext.d.ts

@@ -1,4 +1,4 @@
-import { SlotComponentProps } from '@mui/utils/types';
+import type { SlotComponentProps } from '@mui/utils/types';
 import * as React from 'react';
 export interface TreeViewClasses {
   /** Styles applied to the root element. */

package/internals/TreeViewProvider/useTreeViewBuildContext.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { TreeViewContextValue, TreeViewItemPluginsRunner, TreeViewStoreInContext } from "./TreeViewProvider.types.mjs";
-import { TreeViewAnyStore, TreeViewPublicAPI, TreeItemWrapper } from "../models/index.mjs";
+import type { TreeViewContextValue, TreeViewItemPluginsRunner, TreeViewStoreInContext } from "./TreeViewProvider.types.mjs";
+import type { TreeViewAnyStore, TreeViewPublicAPI, TreeItemWrapper } from "../models/index.mjs";
 export declare const useTreeViewBuildContext: <TStore extends TreeViewAnyStore>(parameters: UseTreeViewBuildContextParameters<TStore>) => TreeViewContextValue<TStore>;
 export interface UseTreeViewBuildContextParameters<TStore extends TreeViewAnyStore> {
   store: TStore;

package/internals/TreeViewProvider/useTreeViewBuildContext.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { TreeViewContextValue, TreeViewItemPluginsRunner, TreeViewStoreInContext } from "./TreeViewProvider.types.js";
-import { TreeViewAnyStore, TreeViewPublicAPI, TreeItemWrapper } from "../models/index.js";
+import type { TreeViewContextValue, TreeViewItemPluginsRunner, TreeViewStoreInContext } from "./TreeViewProvider.types.js";
+import type { TreeViewAnyStore, TreeViewPublicAPI, TreeItemWrapper } from "../models/index.js";
 export declare const useTreeViewBuildContext: <TStore extends TreeViewAnyStore>(parameters: UseTreeViewBuildContextParameters<TStore>) => TreeViewContextValue<TStore>;
 export interface UseTreeViewBuildContextParameters<TStore extends TreeViewAnyStore> {
   store: TStore;

package/internals/components/RichTreeViewItems.d.mts

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import { SlotComponentProps } from '@mui/utils/types';
-import { TreeItem, TreeItemProps } from "../../TreeItem/index.mjs";
-import { TreeViewItemId } from "../../models/index.mjs";
+import type { SlotComponentProps } from '@mui/utils/types';
+import type { TreeItemProps } from "../../TreeItem/index.mjs";
+import { TreeItem } from "../../TreeItem/index.mjs";
+import type { TreeViewItemId } from "../../models/index.mjs";
 export declare const RichTreeViewItem: React.MemoExoticComponent<({
   itemSlot,
   itemSlotProps,

package/internals/components/RichTreeViewItems.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
-import { SlotComponentProps } from '@mui/utils/types';
-import { TreeItem, TreeItemProps } from "../../TreeItem/index.js";
-import { TreeViewItemId } from "../../models/index.js";
+import type { SlotComponentProps } from '@mui/utils/types';
+import type { TreeItemProps } from "../../TreeItem/index.js";
+import { TreeItem } from "../../TreeItem/index.js";
+import type { TreeViewItemId } from "../../models/index.js";
 export declare const RichTreeViewItem: React.MemoExoticComponent<({
   itemSlot,
   itemSlotProps,

package/internals/hooks/useTreeViewRootProps.d.mts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-import { EventHandlers } from '@mui/utils/types';
-import { TreeViewCancellableEvent } from "../../models/index.mjs";
-import { TreeViewAnyStore } from "../models/index.mjs";
-import { TreeViewStoreInContext } from "../TreeViewProvider/index.mjs";
+import type * as React from 'react';
+import type { EventHandlers } from '@mui/utils/types';
+import type { TreeViewCancellableEvent } from "../../models/index.mjs";
+import type { TreeViewAnyStore } from "../models/index.mjs";
+import type { TreeViewStoreInContext } from "../TreeViewProvider/index.mjs";
 export declare function useTreeViewRootProps<TStore extends TreeViewAnyStore>(store: TreeViewStoreInContext<TStore>, forwardedProps: React.HTMLAttributes<HTMLUListElement>, ref: React.Ref<HTMLUListElement | null> | undefined): (otherHandlers: EventHandlers) => {
   style: React.CSSProperties;
   onFocus: (event: React.FocusEvent<HTMLUListElement> & TreeViewCancellableEvent) => void;

package/internals/hooks/useTreeViewRootProps.d.ts

@@ -1,8 +1,8 @@
-import * as React from 'react';
-import { EventHandlers } from '@mui/utils/types';
-import { TreeViewCancellableEvent } from "../../models/index.js";
-import { TreeViewAnyStore } from "../models/index.js";
-import { TreeViewStoreInContext } from "../TreeViewProvider/index.js";
+import type * as React from 'react';
+import type { EventHandlers } from '@mui/utils/types';
+import type { TreeViewCancellableEvent } from "../../models/index.js";
+import type { TreeViewAnyStore } from "../models/index.js";
+import type { TreeViewStoreInContext } from "../TreeViewProvider/index.js";
 export declare function useTreeViewRootProps<TStore extends TreeViewAnyStore>(store: TreeViewStoreInContext<TStore>, forwardedProps: React.HTMLAttributes<HTMLUListElement>, ref: React.Ref<HTMLUListElement | null> | undefined): (otherHandlers: EventHandlers) => {
   style: React.CSSProperties;
   onFocus: (event: React.FocusEvent<HTMLUListElement> & TreeViewCancellableEvent) => void;

package/internals/hooks/useTreeViewStore.d.mts

@@ -1,4 +1,4 @@
-import { TreeViewAnyStore } from "../models/index.mjs";
+import type { TreeViewAnyStore } from "../models/index.mjs";
 interface ValidTreeViewStoreConstructor<TStore extends TreeViewAnyStore> {
   new (parameters: TStore['parameters']): TStore;
 }

package/internals/hooks/useTreeViewStore.d.ts

@@ -1,4 +1,4 @@
-import { TreeViewAnyStore } from "../models/index.js";
+import type { TreeViewAnyStore } from "../models/index.js";
 interface ValidTreeViewStoreConstructor<TStore extends TreeViewAnyStore> {
   new (parameters: TStore['parameters']): TStore;
 }

package/internals/hooks/useTreeViewStore.js

@@ -7,21 +7,24 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useTreeViewStore = useTreeViewStore;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-var _useRefWithInit = require("@base-ui/utils/useRefWithInit");
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _useOnMount = require("@base-ui/utils/useOnMount");
+var _useDisposable = require("@mui/x-internals/useDisposable");
 var _RtlProvider = require("@mui/system/RtlProvider");
 /**
  * Creates a Tree View store and keep it in sync with the provided parameters.
  */
 function useTreeViewStore(StoreClass, parameters) {
   const isRtl = (0, _RtlProvider.useRtl)();
-  const store = (0, _useRefWithInit.useRefWithInit)(() => new StoreClass((0, _extends2.default)({}, parameters, {
+  const store = (0, _useDisposable.useDisposable)(() => new StoreClass((0, _extends2.default)({}, parameters, {
     isRtl
-  }))).current;
+  })));
   (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => store.updateStateFromParameters((0, _extends2.default)({}, parameters, {
     isRtl
   })), [store, isRtl, parameters]);
-  (0, _useOnMount.useOnMount)(store.disposeEffect);
+
+  // Mount-time side effects (e.g. kicking off lazy-loading fetches). The store is
+  // created during render by `useDisposable`, so these can't run in the factory.
+  (0, _useOnMount.useOnMount)(store.mountEffect);
   return store;
 }

package/internals/hooks/useTreeViewStore.mjs

@@ -1,21 +1,24 @@
 'use client';
 
 import _extends from "@babel/runtime/helpers/esm/extends";
-import { useRefWithInit } from '@base-ui/utils/useRefWithInit';
 import { useIsoLayoutEffect } from '@base-ui/utils/useIsoLayoutEffect';
 import { useOnMount } from '@base-ui/utils/useOnMount';
+import { useDisposable } from '@mui/x-internals/useDisposable';
 import { useRtl } from '@mui/system/RtlProvider';
 /**
  * Creates a Tree View store and keep it in sync with the provided parameters.
  */
 export function useTreeViewStore(StoreClass, parameters) {
   const isRtl = useRtl();
-  const store = useRefWithInit(() => new StoreClass(_extends({}, parameters, {
+  const store = useDisposable(() => new StoreClass(_extends({}, parameters, {
     isRtl
-  }))).current;
+  })));
   useIsoLayoutEffect(() => store.updateStateFromParameters(_extends({}, parameters, {
     isRtl
   })), [store, isRtl, parameters]);
-  useOnMount(store.disposeEffect);
+
+  // Mount-time side effects (e.g. kicking off lazy-loading fetches). The store is
+  // created during render by `useDisposable`, so these can't run in the factory.
+  useOnMount(store.mountEffect);
   return store;
 }

package/internals/models/events.d.mts

@@ -1,5 +1,5 @@
-import { MuiEvent } from '@mui/x-internals/types';
-import { TreeViewItemId } from "../../models/index.mjs";
+import type { MuiEvent } from '@mui/x-internals/types';
+import type { TreeViewItemId } from "../../models/index.mjs";
 interface TreeViewEventLookup {
   /**
    * Fired before an item is expanded or collapsed.

package/internals/models/events.d.ts

@@ -1,5 +1,5 @@
-import { MuiEvent } from '@mui/x-internals/types';
-import { TreeViewItemId } from "../../models/index.js";
+import type { MuiEvent } from '@mui/x-internals/types';
+import type { TreeViewItemId } from "../../models/index.js";
 interface TreeViewEventLookup {
   /**
    * Fired before an item is expanded or collapsed.

package/internals/models/itemPlugin.d.mts

@@ -1,11 +1,11 @@
-import * as React from 'react';
-import { EventHandlers } from '@mui/utils/types';
-import { TreeViewItemId } from "../../models/index.mjs";
+import type * as React from 'react';
+import type { EventHandlers } from '@mui/utils/types';
+import type { TreeViewItemId } from "../../models/index.mjs";
 import type { UseTreeItemContentSlotOwnProps, UseTreeItemDragAndDropOverlaySlotOwnProps, UseTreeItemLabelInputSlotOwnProps, UseTreeItemRootSlotOwnProps, UseTreeItemCheckboxSlotOwnProps, UseTreeItemLabelSlotOwnProps } from "../../useTreeItem/index.mjs";
 import type { UseTreeItemInteractions } from "../../hooks/useTreeItemUtils/useTreeItemUtils.mjs";
 import type { TreeItemProps } from "../../TreeItem/TreeItem.types.mjs";
-import { TreeViewAnyStore } from "./treeView.mjs";
-import { TreeViewStoreInContext } from "../TreeViewProvider/index.mjs";
+import type { TreeViewAnyStore } from "./treeView.mjs";
+import type { TreeViewStoreInContext } from "../TreeViewProvider/index.mjs";
 export interface TreeViewItemPluginSlotPropsEnhancerParams {
   rootRefObject: React.RefObject<HTMLLIElement | null>;
   contentRefObject: React.RefObject<HTMLDivElement | null>;

package/internals/models/itemPlugin.d.ts

@@ -1,11 +1,11 @@
-import * as React from 'react';
-import { EventHandlers } from '@mui/utils/types';
-import { TreeViewItemId } from "../../models/index.js";
+import type * as React from 'react';
+import type { EventHandlers } from '@mui/utils/types';
+import type { TreeViewItemId } from "../../models/index.js";
 import type { UseTreeItemContentSlotOwnProps, UseTreeItemDragAndDropOverlaySlotOwnProps, UseTreeItemLabelInputSlotOwnProps, UseTreeItemRootSlotOwnProps, UseTreeItemCheckboxSlotOwnProps, UseTreeItemLabelSlotOwnProps } from "../../useTreeItem/index.js";
 import type { UseTreeItemInteractions } from "../../hooks/useTreeItemUtils/useTreeItemUtils.js";
 import type { TreeItemProps } from "../../TreeItem/TreeItem.types.js";
-import { TreeViewAnyStore } from "./treeView.js";
-import { TreeViewStoreInContext } from "../TreeViewProvider/index.js";
+import type { TreeViewAnyStore } from "./treeView.js";
+import type { TreeViewStoreInContext } from "../TreeViewProvider/index.js";
 export interface TreeViewItemPluginSlotPropsEnhancerParams {
   rootRefObject: React.RefObject<HTMLLIElement | null>;
   contentRefObject: React.RefObject<HTMLDivElement | null>;

package/internals/models/treeView.d.mts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.mjs";
+import type { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.mjs";
 export interface TreeViewItemMeta {
   id: string;
   idAttribute: string | undefined;

package/internals/models/treeView.d.ts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.js";
+import type { MinimalTreeViewStore } from "../MinimalTreeViewStore/index.js";
 export interface TreeViewItemMeta {
   id: string;
   idAttribute: string | undefined;

package/internals/plugins/expansion/TreeViewExpansionPlugin.d.mts

@@ -1,4 +1,4 @@
-import { TreeViewItemId } from "../../../models/index.mjs";
+import type { TreeViewItemId } from "../../../models/index.mjs";
 export declare class TreeViewExpansionPlugin {
   private store;
   constructor(store: any);

package/internals/plugins/expansion/TreeViewExpansionPlugin.d.ts

@@ -1,4 +1,4 @@
-import { TreeViewItemId } from "../../../models/index.js";
+import type { TreeViewItemId } from "../../../models/index.js";
 export declare class TreeViewExpansionPlugin {
   private store;
   constructor(store: any);

package/internals/plugins/expansion/selectors.d.mts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
 export declare const expansionSelectors: {
   /**
    * Gets the expanded items as provided to the component.

package/internals/plugins/expansion/selectors.d.ts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
 export declare const expansionSelectors: {
   /**
    * Gets the expanded items as provided to the component.

package/internals/plugins/expansion/utils.d.mts

@@ -1,4 +1,4 @@
-import { RichTreeViewStoreParameters } from "../../RichTreeViewStore/index.mjs";
+import type { RichTreeViewStoreParameters } from "../../RichTreeViewStore/index.mjs";
 export declare const getExpansionTrigger: ({
   isItemEditable,
   expansionTrigger

package/internals/plugins/expansion/utils.d.ts

@@ -1,4 +1,4 @@
-import { RichTreeViewStoreParameters } from "../../RichTreeViewStore/index.js";
+import type { RichTreeViewStoreParameters } from "../../RichTreeViewStore/index.js";
 export declare const getExpansionTrigger: ({
   isItemEditable,
   expansionTrigger

package/internals/plugins/focus/TreeViewFocusPlugin.d.mts

@@ -1,4 +1,4 @@
-import { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.mjs";
+import type { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.mjs";
 export declare class TreeViewFocusPlugin {
   private store;
   constructor(store: any);

package/internals/plugins/focus/TreeViewFocusPlugin.d.ts

@@ -1,4 +1,4 @@
-import { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.js";
+import type { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.js";
 export declare class TreeViewFocusPlugin {
   private store;
   constructor(store: any);

package/internals/plugins/focus/TreeViewFocusPlugin.js

@@ -17,7 +17,7 @@ class TreeViewFocusPlugin {
     // Whenever the items change, we need to ensure the focused item is still present.
     // If the focused item was removed, focus the closest neighbor instead of the first item.
     let previousState = store.state;
-    this.store.subscribe(newState => {
+    this.store.disposables.defer(this.store.subscribe(newState => {
       // Only run when items actually changed.
       if (newState.itemMetaLookup === previousState.itemMetaLookup) {
         previousState = newState;
@@ -36,7 +36,7 @@ class TreeViewFocusPlugin {
         this.applyItemFocus(null, itemToFocusId);
       }
       previousState = newState;
-    });
+    }));
   }
   setFocusedItemId = itemId => {
     const focusedItemId = _selectors.focusSelectors.focusedItemId(this.store.state);

package/internals/plugins/focus/TreeViewFocusPlugin.mjs

@@ -11,7 +11,7 @@ export class TreeViewFocusPlugin {
     // Whenever the items change, we need to ensure the focused item is still present.
     // If the focused item was removed, focus the closest neighbor instead of the first item.
     let previousState = store.state;
-    this.store.subscribe(newState => {
+    this.store.disposables.defer(this.store.subscribe(newState => {
       // Only run when items actually changed.
       if (newState.itemMetaLookup === previousState.itemMetaLookup) {
         previousState = newState;
@@ -30,7 +30,7 @@ export class TreeViewFocusPlugin {
         this.applyItemFocus(null, itemToFocusId);
       }
       previousState = newState;
-    });
+    }));
   }
   setFocusedItemId = itemId => {
     const focusedItemId = focusSelectors.focusedItemId(this.store.state);

package/internals/plugins/focus/selectors.d.mts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
 export declare const focusSelectors: {
   /**
    * Gets the item that should be sequentially focusable (usually with the Tab key).

package/internals/plugins/focus/selectors.d.ts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
 export declare const focusSelectors: {
   /**
    * Gets the item that should be sequentially focusable (usually with the Tab key).

package/internals/plugins/id/selectors.d.mts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
 export declare const idSelectors: {
   /**
    * Get the id attribute of the tree view.

package/internals/plugins/id/selectors.d.ts

@@ -1,4 +1,4 @@
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
 export declare const idSelectors: {
   /**
    * Get the id attribute of the tree view.

package/internals/plugins/items/TreeViewItemsPlugin.d.mts

@@ -1,5 +1,5 @@
-import { TreeViewItemId, TreeViewValidItem } from "../../../models/index.mjs";
-import { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/MinimalTreeViewStore.types.mjs";
+import type { TreeViewItemId, TreeViewValidItem } from "../../../models/index.mjs";
+import type { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/MinimalTreeViewStore.types.mjs";
 export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
   private store;
   constructor(store: any);

package/internals/plugins/items/TreeViewItemsPlugin.d.ts

@@ -1,5 +1,5 @@
-import { TreeViewItemId, TreeViewValidItem } from "../../../models/index.js";
-import { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/MinimalTreeViewStore.types.js";
+import type { TreeViewItemId, TreeViewValidItem } from "../../../models/index.js";
+import type { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/MinimalTreeViewStore.types.js";
 export declare class TreeViewItemsPlugin<R extends TreeViewValidItem<R>> {
   private store;
   constructor(store: any);

package/internals/plugins/items/selectors.d.mts

@@ -1,6 +1,6 @@
-import { TreeViewItemMeta } from "../../models/index.mjs";
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
-import { RichTreeViewState } from "../../RichTreeViewStore/index.mjs";
+import type { TreeViewItemMeta } from "../../models/index.mjs";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.mjs";
+import type { RichTreeViewState } from "../../RichTreeViewStore/index.mjs";
 export declare const itemsSelectors: {
   /**
    * Gets the DOM structure of the Tree View.

package/internals/plugins/items/selectors.d.ts

@@ -1,6 +1,6 @@
-import { TreeViewItemMeta } from "../../models/index.js";
-import { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
-import { RichTreeViewState } from "../../RichTreeViewStore/index.js";
+import type { TreeViewItemMeta } from "../../models/index.js";
+import type { MinimalTreeViewState } from "../../MinimalTreeViewStore/index.js";
+import type { RichTreeViewState } from "../../RichTreeViewStore/index.js";
 export declare const itemsSelectors: {
   /**
    * Gets the DOM structure of the Tree View.

package/internals/plugins/items/utils.d.mts

@@ -1,5 +1,5 @@
-import { TreeViewValidItem, TreeViewItemId } from "../../../models/index.mjs";
-import { TreeViewItemMeta } from "../../models/index.mjs";
+import type { TreeViewValidItem, TreeViewItemId } from "../../../models/index.mjs";
+import type { TreeViewItemMeta } from "../../models/index.mjs";
 import type { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/index.mjs";
 export declare const TREE_VIEW_ROOT_PARENT_ID = "__TREE_VIEW_ROOT_PARENT_ID__";
 export declare const buildSiblingIndexes: (siblings: string[]) => {

package/internals/plugins/items/utils.d.ts

@@ -1,5 +1,5 @@
-import { TreeViewValidItem, TreeViewItemId } from "../../../models/index.js";
-import { TreeViewItemMeta } from "../../models/index.js";
+import type { TreeViewValidItem, TreeViewItemId } from "../../../models/index.js";
+import type { TreeViewItemMeta } from "../../models/index.js";
 import type { MinimalTreeViewParameters } from "../../MinimalTreeViewStore/index.js";
 export declare const TREE_VIEW_ROOT_PARENT_ID = "__TREE_VIEW_ROOT_PARENT_ID__";
 export declare const buildSiblingIndexes: (siblings: string[]) => {

package/internals/plugins/jsxItems/TreeViewJSXItemsPlugin.d.mts

@@ -1,5 +1,5 @@
-import { TreeViewItemId } from "../../../models/index.mjs";
-import { TreeViewItemMeta } from "../../models/index.mjs";
+import type { TreeViewItemId } from "../../../models/index.mjs";
+import type { TreeViewItemMeta } from "../../models/index.mjs";
 import type { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.mjs";
 export declare class TreeViewJSXItemsPlugin {
   private store;

package/internals/plugins/jsxItems/TreeViewJSXItemsPlugin.d.ts

@@ -1,5 +1,5 @@
-import { TreeViewItemId } from "../../../models/index.js";
-import { TreeViewItemMeta } from "../../models/index.js";
+import type { TreeViewItemId } from "../../../models/index.js";
+import type { TreeViewItemMeta } from "../../models/index.js";
 import type { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.js";
 export declare class TreeViewJSXItemsPlugin {
   private store;

package/internals/plugins/jsxItems/TreeViewJSXItemsPlugin.js

@@ -118,7 +118,8 @@ Two items were provided with the same id in the \`items\` prop: "${item.id}"` :
 
     // If a parent was selected while its children were unmounted (collapsed with unmountOnExit),
     // re-run selection propagation now that the children are registered.
-    if (parentId !== null && _selectors.selectionSelectors.isItemSelected(this.store.state, parentId)) {
+    // The multiSelect guard matches the documented contract: selectionPropagation only works with multiSelect.
+    if (parentId !== null && _selectors.selectionSelectors.isMultiSelectEnabled(this.store.state) && _selectors.selectionSelectors.propagationRules(this.store.state).descendants && _selectors.selectionSelectors.isItemSelected(this.store.state, parentId)) {
       this.store.selection.setItemSelection({
         itemId: parentId,
         shouldBeSelected: true,

package/internals/plugins/jsxItems/TreeViewJSXItemsPlugin.mjs

@@ -111,7 +111,8 @@ Two items were provided with the same id in the \`items\` prop: "${item.id}"` :
 
     // If a parent was selected while its children were unmounted (collapsed with unmountOnExit),
     // re-run selection propagation now that the children are registered.
-    if (parentId !== null && selectionSelectors.isItemSelected(this.store.state, parentId)) {
+    // The multiSelect guard matches the documented contract: selectionPropagation only works with multiSelect.
+    if (parentId !== null && selectionSelectors.isMultiSelectEnabled(this.store.state) && selectionSelectors.propagationRules(this.store.state).descendants && selectionSelectors.isItemSelected(this.store.state, parentId)) {
       this.store.selection.setItemSelection({
         itemId: parentId,
         shouldBeSelected: true,

package/internals/plugins/jsxItems/itemPlugin.d.mts

@@ -1,4 +1,4 @@
-import { TreeItemWrapper, TreeViewItemPlugin } from "../../models/index.mjs";
-import { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.mjs";
+import type { TreeItemWrapper, TreeViewItemPlugin } from "../../models/index.mjs";
+import type { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.mjs";
 export declare const useJSXItemsItemPlugin: TreeViewItemPlugin;
 export declare const jsxItemsitemWrapper: TreeItemWrapper<SimpleTreeViewStore<any>>;

package/internals/plugins/jsxItems/itemPlugin.d.ts

@@ -1,4 +1,4 @@
-import { TreeItemWrapper, TreeViewItemPlugin } from "../../models/index.js";
-import { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.js";
+import type { TreeItemWrapper, TreeViewItemPlugin } from "../../models/index.js";
+import type { SimpleTreeViewStore } from "../../SimpleTreeViewStore/index.js";
 export declare const useJSXItemsItemPlugin: TreeViewItemPlugin;
 export declare const jsxItemsitemWrapper: TreeItemWrapper<SimpleTreeViewStore<any>>;

package/internals/plugins/keyboardNavigation/TreeViewKeyboardNavigationPlugin.d.mts

@@ -1,4 +1,4 @@
-import { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.mjs";
+import type { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.mjs";
 type TreeViewLabelMap = {
   [itemId: string]: string;
 };

package/internals/plugins/keyboardNavigation/TreeViewKeyboardNavigationPlugin.d.ts

@@ -1,4 +1,4 @@
-import { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.js";
+import type { TreeViewCancellableEvent, TreeViewItemId } from "../../../models/index.js";
 type TreeViewLabelMap = {
   [itemId: string]: string;
 };

package/internals/plugins/labelEditing/TreeViewLabelEditingPlugin.d.mts

@@ -1,5 +1,5 @@
-import { ExtendableRichTreeViewStore } from "../../RichTreeViewStore/RichTreeViewStore.mjs";
-import { TreeViewItemId } from "../../../models/index.mjs";
+import type { ExtendableRichTreeViewStore } from "../../RichTreeViewStore/RichTreeViewStore.mjs";
+import type { TreeViewItemId } from "../../../models/index.mjs";
 export declare class TreeViewLabelEditingPlugin {
   private store;
   constructor(store: ExtendableRichTreeViewStore<any, any>);

package/internals/plugins/labelEditing/TreeViewLabelEditingPlugin.d.ts

@@ -1,5 +1,5 @@
-import { ExtendableRichTreeViewStore } from "../../RichTreeViewStore/RichTreeViewStore.js";
-import { TreeViewItemId } from "../../../models/index.js";
+import type { ExtendableRichTreeViewStore } from "../../RichTreeViewStore/RichTreeViewStore.js";
+import type { TreeViewItemId } from "../../../models/index.js";
 export declare class TreeViewLabelEditingPlugin {
   private store;
   constructor(store: ExtendableRichTreeViewStore<any, any>);

package/internals/plugins/labelEditing/itemPlugin.d.mts

@@ -1,5 +1,5 @@
-import { TreeViewItemPlugin } from "../../models/index.mjs";
-import { TreeItemLabelInputProps } from "../../../TreeItemLabelInput/index.mjs";
+import type { TreeViewItemPlugin } from "../../models/index.mjs";
+import type { TreeItemLabelInputProps } from "../../../TreeItemLabelInput/index.mjs";
 export declare const useLabelEditingItemPlugin: TreeViewItemPlugin;
 interface UseTreeItemLabelInputSlotPropsFromLabelEditing extends TreeItemLabelInputProps {}
 interface UseTreeItemLabelSlotPropsFromLabelEditing {

package/internals/plugins/labelEditing/itemPlugin.d.ts

@@ -1,5 +1,5 @@
-import { TreeViewItemPlugin } from "../../models/index.js";
-import { TreeItemLabelInputProps } from "../../../TreeItemLabelInput/index.js";
+import type { TreeViewItemPlugin } from "../../models/index.js";
+import type { TreeItemLabelInputProps } from "../../../TreeItemLabelInput/index.js";
 export declare const useLabelEditingItemPlugin: TreeViewItemPlugin;
 interface UseTreeItemLabelInputSlotPropsFromLabelEditing extends TreeItemLabelInputProps {}
 interface UseTreeItemLabelSlotPropsFromLabelEditing {

package/internals/plugins/labelEditing/selectors.d.mts

@@ -1,4 +1,4 @@
-import { RichTreeViewState } from "../../RichTreeViewStore/index.mjs";
+import type { RichTreeViewState } from "../../RichTreeViewStore/index.mjs";
 export declare const labelSelectors: {
   /**
    * Checks whether an item is editable.

package/internals/plugins/labelEditing/selectors.d.ts

@@ -1,4 +1,4 @@
-import { RichTreeViewState } from "../../RichTreeViewStore/index.js";
+import type { RichTreeViewState } from "../../RichTreeViewStore/index.js";
 export declare const labelSelectors: {
   /**
    * Checks whether an item is editable.