@mui/x-tree-view 8.23.0 → 8.24.0

package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.utils.d.ts

@@ -1,21 +0,0 @@
-import { TreeViewItemId } from "../../../models/index.js";
-export declare const createTreeViewDefaultId: () => string;
-/**
- * Generate the id attribute (i.e.: the `id` attribute passed to the DOM element) of a Tree Item.
- * If the user explicitly defined an id attribute, it will be returned.
- * Otherwise, the method creates a unique id for the item based on the Tree View id attribute and the item `itemId`
- * @param {object} params The parameters to determine the id attribute of the item.
- * @param {TreeViewItemId} params.itemId The id of the item to get the id attribute of.
- * @param {string | undefined} params.idAttribute The id attribute of the item if explicitly defined by the user.
- * @param {string} params.treeId The id attribute of the Tree View.
- * @returns {string} The id attribute of the item.
- */
-export declare const generateTreeItemIdAttribute: ({
-  id,
-  treeId,
-  itemId
-}: {
-  id: TreeViewItemId | undefined;
-  treeId: string | undefined;
-  itemId: string;
-}) => string;

package/esm/internals/corePlugins/useTreeViewId/useTreeViewId.utils.js

@@ -1,26 +0,0 @@
-let globalTreeViewDefaultId = 0;
-export const createTreeViewDefaultId = () => {
-  globalTreeViewDefaultId += 1;
-  return `mui-tree-view-${globalTreeViewDefaultId}`;
-};
-
-/**
- * Generate the id attribute (i.e.: the `id` attribute passed to the DOM element) of a Tree Item.
- * If the user explicitly defined an id attribute, it will be returned.
- * Otherwise, the method creates a unique id for the item based on the Tree View id attribute and the item `itemId`
- * @param {object} params The parameters to determine the id attribute of the item.
- * @param {TreeViewItemId} params.itemId The id of the item to get the id attribute of.
- * @param {string | undefined} params.idAttribute The id attribute of the item if explicitly defined by the user.
- * @param {string} params.treeId The id attribute of the Tree View.
- * @returns {string} The id attribute of the item.
- */
-export const generateTreeItemIdAttribute = ({
-  id,
-  treeId = '',
-  itemId
-}) => {
-  if (id != null) {
-    return id;
-  }
-  return `${treeId}-${itemId}`;
-};

package/esm/internals/corePlugins/useTreeViewInstanceEvents/index.d.ts

@@ -1,2 +0,0 @@
-export { useTreeViewInstanceEvents } from "./useTreeViewInstanceEvents.js";
-export type { UseTreeViewInstanceEventsSignature } from "./useTreeViewInstanceEvents.types.js";

package/esm/internals/corePlugins/useTreeViewInstanceEvents/index.js

@@ -1 +0,0 @@
-export { useTreeViewInstanceEvents } from "./useTreeViewInstanceEvents.js";

package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.d.ts

@@ -1,3 +0,0 @@
-import type { TreeViewPlugin } from "../../models/index.js";
-import { UseTreeViewInstanceEventsSignature } from "./useTreeViewInstanceEvents.types.js";
-export declare const useTreeViewInstanceEvents: TreeViewPlugin<UseTreeViewInstanceEventsSignature>;

package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.js

@@ -1,31 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import { EventManager } from '@mui/x-internals/EventManager';
-const isSyntheticEvent = event => {
-  return event.isPropagationStopped !== undefined;
-};
-export const useTreeViewInstanceEvents = () => {
-  const [eventManager] = React.useState(() => new EventManager());
-  const publishEvent = React.useCallback((...args) => {
-    const [name, params, event = {}] = args;
-    event.defaultMuiPrevented = false;
-    if (isSyntheticEvent(event) && event.isPropagationStopped()) {
-      return;
-    }
-    eventManager.emit(name, params, event);
-  }, [eventManager]);
-  const subscribeEvent = React.useCallback((event, handler) => {
-    eventManager.on(event, handler);
-    return () => {
-      eventManager.removeListener(event, handler);
-    };
-  }, [eventManager]);
-  return {
-    instance: {
-      $$publishEvent: publishEvent,
-      $$subscribeEvent: subscribeEvent
-    }
-  };
-};
-useTreeViewInstanceEvents.params = {};

package/esm/internals/corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.d.ts

@@ -1,22 +0,0 @@
-import { TreeViewPluginSignature } from "../../models/index.js";
-import { TreeViewEventListener } from "../../models/events.js";
-export interface UseTreeViewInstanceEventsInstance {
-  /**
-   * Should never be used directly.
-   * Please use `useInstanceEventHandler` instead.
-   * @param {string} eventName Name of the event to subscribe to.
-   * @param {TreeViewEventListener<any>} handler Event handler to call when the event is published.
-   * @returns {() => void} Cleanup function.
-   */
-  $$subscribeEvent: (eventName: string, handler: TreeViewEventListener<any>) => () => void;
-  /**
-   * Should never be used directly.
-   * Please use `publishTreeViewEvent` instead.
-   * @param {string} eventName Name of the event to publish.
-   * @param {any} params The params to publish with the event.
-   */
-  $$publishEvent: (eventName: string, params: any) => void;
-}
-export type UseTreeViewInstanceEventsSignature = TreeViewPluginSignature<{
-  instance: UseTreeViewInstanceEventsInstance;
-}>;

package/esm/internals/corePlugins/useTreeViewOptionalPlugins/index.d.ts

@@ -1,2 +0,0 @@
-export { useTreeViewOptionalPlugins } from "./useTreeViewOptionalPlugins.js";
-export type { UseTreeViewOptionalPluginsSignature } from "./useTreeViewOptionalPlugins.types.js";

package/esm/internals/corePlugins/useTreeViewOptionalPlugins/index.js

@@ -1 +0,0 @@
-export { useTreeViewOptionalPlugins } from "./useTreeViewOptionalPlugins.js";

package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.d.ts

@@ -1,3 +0,0 @@
-import { TreeViewPlugin } from "../../models/index.js";
-import { UseTreeViewOptionalPluginsSignature } from "./useTreeViewOptionalPlugins.types.js";
-export declare const useTreeViewOptionalPlugins: TreeViewPlugin<UseTreeViewOptionalPluginsSignature>;

package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.js

@@ -1,12 +0,0 @@
-export const useTreeViewOptionalPlugins = ({
-  plugins
-}) => {
-  const pluginSet = new Set(plugins);
-  const getAvailablePlugins = () => pluginSet;
-  return {
-    instance: {
-      getAvailablePlugins
-    }
-  };
-};
-useTreeViewOptionalPlugins.params = {};

package/esm/internals/corePlugins/useTreeViewOptionalPlugins/useTreeViewOptionalPlugins.types.d.ts

@@ -1,8 +0,0 @@
-import { TreeViewPlugin, TreeViewAnyPluginSignature, TreeViewPluginSignature } from "../../models/index.js";
-interface UseTreeViewOptionalPluginsInstance {
-  getAvailablePlugins: () => Set<TreeViewPlugin<TreeViewAnyPluginSignature>>;
-}
-export type UseTreeViewOptionalPluginsSignature = TreeViewPluginSignature<{
-  instance: UseTreeViewOptionalPluginsInstance;
-}>;
-export {};

package/esm/internals/hooks/useInstanceEventHandler.d.ts

@@ -1,15 +0,0 @@
-import { CleanupTracking } from "../utils/cleanupTracking/CleanupTracking.js";
-import { TreeViewAnyPluginSignature, TreeViewUsedEvents } from "../models/index.js";
-import { TreeViewEventListener } from "../models/events.js";
-import { UseTreeViewInstanceEventsInstance } from "../corePlugins/useTreeViewInstanceEvents/useTreeViewInstanceEvents.types.js";
-interface RegistryContainer {
-  registry: CleanupTracking | null;
-}
-export declare function createUseInstanceEventHandler(registryContainer: RegistryContainer): <Instance extends UseTreeViewInstanceEventsInstance & {
-  $$signature: TreeViewAnyPluginSignature;
-}, E extends keyof TreeViewUsedEvents<Instance["$$signature"]>>(instance: Instance, eventName: E, handler: TreeViewEventListener<TreeViewUsedEvents<Instance["$$signature"]>[E]>) => void;
-export declare const unstable_resetCleanupTracking: () => void;
-export declare const useInstanceEventHandler: <Instance extends UseTreeViewInstanceEventsInstance & {
-  $$signature: TreeViewAnyPluginSignature;
-}, E extends keyof TreeViewUsedEvents<Instance["$$signature"]>>(instance: Instance, eventName: E, handler: TreeViewEventListener<TreeViewUsedEvents<Instance["$$signature"]>[E]>) => void;
-export {};

package/esm/internals/hooks/useInstanceEventHandler.js

@@ -1,79 +0,0 @@
-'use client';
-
-import * as React from 'react';
-import { TimerBasedCleanupTracking } from "../utils/cleanupTracking/TimerBasedCleanupTracking.js";
-import { FinalizationRegistryBasedCleanupTracking } from "../utils/cleanupTracking/FinalizationRegistryBasedCleanupTracking.js";
-// We use class to make it easier to detect in heap snapshots by name
-class ObjectToBeRetainedByReact {}
-
-// Based on https://github.com/Bnaya/use-dispose-uncommitted/blob/main/src/finalization-registry-based-impl.ts
-// Check https://github.com/facebook/react/issues/15317 to get more information
-export function createUseInstanceEventHandler(registryContainer) {
-  let cleanupTokensCounter = 0;
-  return function useInstanceEventHandler(instance, eventName, handler) {
-    if (registryContainer.registry === null) {
-      registryContainer.registry = typeof FinalizationRegistry !== 'undefined' ? new FinalizationRegistryBasedCleanupTracking() : new TimerBasedCleanupTracking();
-    }
-    const [objectRetainedByReact] = React.useState(new ObjectToBeRetainedByReact());
-    const subscription = React.useRef(null);
-    const handlerRef = React.useRef(undefined);
-    handlerRef.current = handler;
-    const cleanupTokenRef = React.useRef(null);
-    if (!subscription.current && handlerRef.current) {
-      const enhancedHandler = (params, event) => {
-        if (!event.defaultMuiPrevented) {
-          handlerRef.current?.(params, event);
-        }
-      };
-      subscription.current = instance.$$subscribeEvent(eventName, enhancedHandler);
-      cleanupTokensCounter += 1;
-      cleanupTokenRef.current = {
-        cleanupToken: cleanupTokensCounter
-      };
-      registryContainer.registry.register(objectRetainedByReact,
-      // The callback below will be called once this reference stops being retained
-      () => {
-        subscription.current?.();
-        subscription.current = null;
-        cleanupTokenRef.current = null;
-      }, cleanupTokenRef.current);
-    } else if (!handlerRef.current && subscription.current) {
-      subscription.current();
-      subscription.current = null;
-      if (cleanupTokenRef.current) {
-        registryContainer.registry.unregister(cleanupTokenRef.current);
-        cleanupTokenRef.current = null;
-      }
-    }
-    React.useEffect(() => {
-      if (!subscription.current && handlerRef.current) {
-        const enhancedHandler = (params, event) => {
-          if (!event.defaultMuiPrevented) {
-            handlerRef.current?.(params, event);
-          }
-        };
-        subscription.current = instance.$$subscribeEvent(eventName, enhancedHandler);
-      }
-      if (cleanupTokenRef.current && registryContainer.registry) {
-        // If the effect was called, it means that this render was committed
-        // so we can trust the cleanup function to remove the listener.
-        registryContainer.registry.unregister(cleanupTokenRef.current);
-        cleanupTokenRef.current = null;
-      }
-      return () => {
-        subscription.current?.();
-        subscription.current = null;
-      };
-    }, [instance, eventName]);
-  };
-}
-const registryContainer = {
-  registry: null
-};
-
-// eslint-disable-next-line @typescript-eslint/naming-convention
-export const unstable_resetCleanupTracking = () => {
-  registryContainer.registry?.reset();
-  registryContainer.registry = null;
-};
-export const useInstanceEventHandler = createUseInstanceEventHandler(registryContainer);

package/esm/internals/models/helpers.d.ts

@@ -1,7 +0,0 @@
-import type { TreeViewAnyPluginSignature, TreeViewPlugin } from "./plugin.js";
-type IsAny<T> = 0 extends 1 & T ? true : false;
-export type OptionalIfEmpty<A extends string, B> = keyof B extends never ? Partial<Record<A, B>> : IsAny<B> extends true ? Partial<Record<A, B>> : Record<A, B>;
-export type MergeSignaturesProperty<TSignatures extends readonly any[], TProperty extends keyof TreeViewAnyPluginSignature> = TSignatures extends readonly [plugin: infer P, ...otherPlugin: infer R] ? P extends TreeViewAnyPluginSignature ? P[TProperty] & MergeSignaturesProperty<R, TProperty> : {} : {};
-export type ConvertPluginsIntoSignatures<TPlugins extends readonly TreeViewPlugin<TreeViewAnyPluginSignature>[]> = TPlugins extends readonly [plugin: infer TPlugin, ...otherPlugin: infer R] ? R extends readonly TreeViewPlugin<any>[] ? TPlugin extends TreeViewPlugin<infer TSignature> ? readonly [TSignature, ...ConvertPluginsIntoSignatures<R>] : never : never : [];
-export type ConvertSignaturesIntoPlugins<TSignatures extends readonly TreeViewAnyPluginSignature[]> = TSignatures extends readonly [signature: infer TSignature, ...otherSignatures: infer R] ? R extends readonly TreeViewAnyPluginSignature[] ? TSignature extends TreeViewAnyPluginSignature ? readonly [TreeViewPlugin<TSignature>, ...ConvertSignaturesIntoPlugins<R>] : never : never : [];
-export {};

package/esm/internals/models/plugin.d.ts

@@ -1,166 +0,0 @@
-import * as React from 'react';
-import { EventHandlers } from '@mui/utils/types';
-import { TreeViewInstance, TreeViewStore } from "./treeView.js";
-import type { MergeSignaturesProperty, OptionalIfEmpty } from "./helpers.js";
-import { TreeViewEventLookupElement } from "./events.js";
-import type { TreeViewCorePluginSignatures } from "../corePlugins/index.js";
-import { TreeViewItemPlugin } from "./itemPlugin.js";
-import { TreeViewItemId } from "../../models/index.js";
-export interface TreeViewPluginOptions<TSignature extends TreeViewAnyPluginSignature> {
-  /**
-   * An imperative API available for internal use. Used to access methods from other plugins.
-   */
-  instance: TreeViewUsedInstance<TSignature>;
-  /**
-   * The Tree View parameters after being processed with the default values.
-   */
-  params: TreeViewUsedParamsWithDefaults<TSignature>;
-  /**
-   * The store that can be used to access the state of other plugins.
-   */
-  store: TreeViewUsedStore<TSignature>;
-  /**
-   * Reference to the root element.
-   */
-  rootRef: React.RefObject<HTMLUListElement | null>;
-  /**
-   * All the plugins that are used in the tree-view.
-   */
-  plugins: TreeViewPlugin<TreeViewAnyPluginSignature>[];
-}
-type TreeViewResponse<TSignature extends TreeViewAnyPluginSignature> = {
-  getRootProps?: <TOther extends EventHandlers = {}>(otherHandlers: TOther) => React.HTMLAttributes<HTMLUListElement>;
-} & OptionalIfEmpty<'publicAPI', TSignature['publicAPI']> & OptionalIfEmpty<'instance', TSignature['instance']>;
-export type TreeViewPluginSignature<T extends {
-  params?: {};
-  paramsWithDefaults?: {};
-  instance?: {};
-  publicAPI?: {};
-  events?: { [key in keyof T['events']]: TreeViewEventLookupElement };
-  state?: {};
-  dependencies?: readonly TreeViewAnyPluginSignature[];
-  optionalDependencies?: readonly TreeViewAnyPluginSignature[];
-}> = {
-  /**
-   * The raw properties that can be passed to the plugin.
-   */
-  params: T extends {
-    params: {};
-  } ? T['params'] : {};
-  /**
-   * The params after being processed with the default values.
-   */
-  paramsWithDefaults: T extends {
-    paramsWithDefaults: {};
-  } ? T['paramsWithDefaults'] : {};
-  /**
-   * An imperative api available for internal use.
-   */
-  instance: T extends {
-    instance: {};
-  } ? T['instance'] : {};
-  /**
-   * The public imperative API that will be exposed to the user.
-   * Accessed through the `apiRef` property of the plugin.
-   */
-  publicAPI: T extends {
-    publicAPI: {};
-  } ? T['publicAPI'] : {};
-  events: T extends {
-    events: {};
-  } ? T['events'] : {};
-  /**
-   * The state is the mutable data that will actually be stored in the plugin state and can be accessed by other plugins.
-   */
-  state: T extends {
-    state: {};
-  } ? T['state'] : {};
-  /**
-   * Any plugins that this plugin depends on.
-   */
-  dependencies: T extends {
-    dependencies: Array<any>;
-  } ? T['dependencies'] : [];
-  /**
-   * Same as dependencies but the plugin might not have been initialized. Used for dependencies on plugins of features that can be enabled conditionally.
-   */
-  optionalDependencies: T extends {
-    optionalDependencies: Array<any>;
-  } ? T['optionalDependencies'] : [];
-};
-export type TreeViewAnyPluginSignature = {
-  state: any;
-  instance: any;
-  params: any;
-  paramsWithDefaults: any;
-  dependencies: any;
-  optionalDependencies: any;
-  events: any;
-  publicAPI: any;
-};
-type TreeViewRequiredPlugins<TSignature extends TreeViewAnyPluginSignature> = [...TreeViewCorePluginSignatures, ...TSignature['dependencies']];
-type PluginPropertyWithDependencies<TSignature extends TreeViewAnyPluginSignature, TProperty extends keyof TreeViewAnyPluginSignature> = TSignature[TProperty] & MergeSignaturesProperty<TreeViewRequiredPlugins<TSignature>, TProperty> & Partial<MergeSignaturesProperty<TSignature['optionalDependencies'], TProperty>>;
-export type TreeViewUsedParams<TSignature extends TreeViewAnyPluginSignature> = PluginPropertyWithDependencies<TSignature, 'params'>;
-export type TreeViewUsedParamsWithDefaults<TSignature extends TreeViewAnyPluginSignature> = PluginPropertyWithDependencies<TSignature, 'paramsWithDefaults'>;
-export type TreeViewUsedInstance<TSignature extends TreeViewAnyPluginSignature> = PluginPropertyWithDependencies<TSignature, 'instance'> & {
-  /**
-   * Private property only defined in TypeScript to be able to access the plugin signature from the instance object.
-   */
-  $$signature: TSignature;
-};
-export type TreeViewUsedStore<TSignature extends TreeViewAnyPluginSignature> = TreeViewStore<[TSignature, ...TSignature['dependencies']], TSignature['optionalDependencies']>;
-export type TreeViewUsedEvents<TSignature extends TreeViewAnyPluginSignature> = TSignature['events'] & MergeSignaturesProperty<TreeViewRequiredPlugins<TSignature>, 'events'>;
-export type TreeItemWrapper<TSignatures extends readonly TreeViewAnyPluginSignature[]> = (params: {
-  itemId: TreeViewItemId;
-  children: React.ReactNode;
-  instance: TreeViewInstance<TSignatures>;
-  idAttribute: string;
-}) => React.ReactNode;
-export type TreeRootWrapper = (params: {
-  children: React.ReactNode;
-}) => React.ReactNode;
-export type TreeViewPlugin<TSignature extends TreeViewAnyPluginSignature> = {
-  /**
-   * The main function of the plugin that will be executed by the Tree View.
-   *
-   * This should be a valid React `use` function, as it will be executed in the render phase and can contain hooks.
-   */
-  (options: TreeViewPluginOptions<TSignature>): TreeViewResponse<TSignature>;
-  /**
-   * A function that receives the parameters and returns them after being processed with the default values.
-   *
-   * @param {TreeViewUsedParams<TSignature>} options The options object.
-   * @param {TreeViewUsedParams<TSignature>['params']} options.params The parameters before being processed with the default values.
-   * @returns {TSignature['paramsWithDefaults']} The parameters after being processed with the default values.
-   */
-  applyDefaultValuesToParams?: (options: {
-    params: TreeViewUsedParams<TSignature>;
-  }) => TSignature['paramsWithDefaults'];
-  /**
-   * The initial state is computed after the default values are applied.
-   * It sets up the state for the first render.
-   * Other state modifications have to be done in effects and so could not be applied on the initial render.
-   *
-   * @param {TreeViewUsedParamsWithDefaults<TSignature>} params The parameters after being processed with the default values.
-   * @returns {TSignature['state']} The initial state of the plugin.
-   */
-  getInitialState?: (params: TreeViewUsedParamsWithDefaults<TSignature>) => TSignature['state'];
-  /**
-   * An object where each property used by the plugin is set to `true`.
-   */
-  params: Record<keyof TSignature['params'], true>;
-  itemPlugin?: TreeViewItemPlugin;
-  /**
-   * Render function used to add React wrappers around the TreeItem.
-   * @param {{ nodeId: TreeViewItemId; children: React.ReactNode; }} params The params of the item.
-   * @returns {React.ReactNode} The wrapped item.
-   */
-  wrapItem?: TreeItemWrapper<[TSignature, ...TSignature['dependencies']]>;
-  /**
-   * Render function used to add React wrappers around the TreeView.
-   * @param {{ children: React.ReactNode; }} params The params of the root.
-   * @returns {React.ReactNode} The wrapped root.
-   */
-  wrapRoot?: TreeRootWrapper;
-};
-export {};

package/esm/internals/models/plugin.js

@@ -1 +0,0 @@
-export {};

package/esm/internals/plugins/useTreeViewExpansion/index.d.ts

@@ -1,3 +0,0 @@
-export { useTreeViewExpansion } from "./useTreeViewExpansion.js";
-export type { UseTreeViewExpansionSignature, UseTreeViewExpansionParameters, UseTreeViewExpansionParametersWithDefaults } from "./useTreeViewExpansion.types.js";
-export { expansionSelectors } from "./useTreeViewExpansion.selectors.js";

package/esm/internals/plugins/useTreeViewExpansion/index.js

@@ -1,2 +0,0 @@
-export { useTreeViewExpansion } from "./useTreeViewExpansion.js";
-export { expansionSelectors } from "./useTreeViewExpansion.selectors.js";

package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.d.ts

@@ -1,3 +0,0 @@
-import { TreeViewPlugin } from "../../models/index.js";
-import { UseTreeViewExpansionSignature } from "./useTreeViewExpansion.types.js";
-export declare const useTreeViewExpansion: TreeViewPlugin<UseTreeViewExpansionSignature>;

package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.js

@@ -1,149 +0,0 @@
-import _extends from "@babel/runtime/helpers/esm/extends";
-import { useAssertModelConsistency } from '@mui/x-internals/useAssertModelConsistency';
-import { useStableCallback } from '@base-ui/utils/useStableCallback';
-import { useIsoLayoutEffect } from '@base-ui/utils/useIsoLayoutEffect';
-import { expansionSelectors } from "./useTreeViewExpansion.selectors.js";
-import { getExpansionTrigger } from "./useTreeViewExpansion.utils.js";
-import { itemsSelectors } from "../useTreeViewItems/useTreeViewItems.selectors.js";
-import { publishTreeViewEvent } from "../../utils/publishTreeViewEvent.js";
-export const useTreeViewExpansion = ({
-  instance,
-  store,
-  params
-}) => {
-  useAssertModelConsistency({
-    componentName: 'Tree View',
-    propName: 'expandedItems',
-    controlled: params.expandedItems,
-    defaultValue: params.defaultExpandedItems
-  });
-  useIsoLayoutEffect(() => {
-    const newExpansionTrigger = getExpansionTrigger({
-      isItemEditable: params.isItemEditable,
-      expansionTrigger: params.expansionTrigger
-    });
-    if (store.state.expansion.expansionTrigger === newExpansionTrigger) {
-      return;
-    }
-    store.set('expansion', _extends({}, store.state.expansion, {
-      expansionTrigger: newExpansionTrigger
-    }));
-  }, [store, params.isItemEditable, params.expansionTrigger]);
-  const setExpandedItems = (event, value) => {
-    if (params.expandedItems === undefined) {
-      store.set('expansion', _extends({}, store.state.expansion, {
-        expandedItems: value
-      }));
-    }
-    params.onExpandedItemsChange?.(event, value);
-  };
-  const resetItemExpansion = useStableCallback(() => {
-    setExpandedItems(null, []);
-  });
-  const applyItemExpansion = useStableCallback(({
-    itemId,
-    event,
-    shouldBeExpanded
-  }) => {
-    const oldExpanded = expansionSelectors.expandedItemsRaw(store.state);
-    let newExpanded;
-    if (shouldBeExpanded) {
-      newExpanded = [itemId].concat(oldExpanded);
-    } else {
-      newExpanded = oldExpanded.filter(id => id !== itemId);
-    }
-    if (params.onItemExpansionToggle) {
-      params.onItemExpansionToggle(event, itemId, shouldBeExpanded);
-    }
-    setExpandedItems(event, newExpanded);
-  });
-  const setItemExpansion = useStableCallback(({
-    itemId,
-    event = null,
-    shouldBeExpanded
-  }) => {
-    const isExpandedBefore = expansionSelectors.isItemExpanded(store.state, itemId);
-    const cleanShouldBeExpanded = shouldBeExpanded ?? !isExpandedBefore;
-    if (isExpandedBefore === cleanShouldBeExpanded) {
-      return;
-    }
-    const eventParameters = {
-      isExpansionPrevented: false,
-      shouldBeExpanded: cleanShouldBeExpanded,
-      event,
-      itemId
-    };
-    publishTreeViewEvent(instance, 'beforeItemToggleExpansion', eventParameters);
-    if (eventParameters.isExpansionPrevented) {
-      return;
-    }
-    instance.applyItemExpansion({
-      itemId,
-      event,
-      shouldBeExpanded: cleanShouldBeExpanded
-    });
-  });
-  const isItemExpanded = useStableCallback(itemId => {
-    return expansionSelectors.isItemExpanded(store.state, itemId);
-  });
-  const expandAllSiblings = (event, itemId) => {
-    const itemMeta = itemsSelectors.itemMeta(store.state, itemId);
-    if (itemMeta == null) {
-      return;
-    }
-    const siblings = itemsSelectors.itemOrderedChildrenIds(store.state, itemMeta.parentId);
-    const diff = siblings.filter(child => expansionSelectors.isItemExpandable(store.state, child) && !expansionSelectors.isItemExpanded(store.state, child));
-    const newExpanded = expansionSelectors.expandedItemsRaw(store.state).concat(diff);
-    if (diff.length > 0) {
-      if (params.onItemExpansionToggle) {
-        diff.forEach(newlyExpandedItemId => {
-          params.onItemExpansionToggle(event, newlyExpandedItemId, true);
-        });
-      }
-      setExpandedItems(event, newExpanded);
-    }
-  };
-
-  /**
-   * Update the controlled model when the `expandedItems` prop changes.
-   */
-  useIsoLayoutEffect(() => {
-    const expandedItems = params.expandedItems;
-    if (expandedItems !== undefined) {
-      store.set('expansion', _extends({}, store.state.expansion, {
-        expandedItems
-      }));
-    }
-  }, [store, params.expandedItems]);
-  return {
-    publicAPI: {
-      setItemExpansion,
-      isItemExpanded
-    },
-    instance: {
-      setItemExpansion,
-      applyItemExpansion,
-      expandAllSiblings,
-      resetItemExpansion
-    }
-  };
-};
-const DEFAULT_EXPANDED_ITEMS = [];
-useTreeViewExpansion.applyDefaultValuesToParams = ({
-  params
-}) => _extends({}, params, {
-  defaultExpandedItems: params.defaultExpandedItems ?? DEFAULT_EXPANDED_ITEMS
-});
-useTreeViewExpansion.getInitialState = params => ({
-  expansion: {
-    expandedItems: params.expandedItems === undefined ? params.defaultExpandedItems : params.expandedItems,
-    expansionTrigger: getExpansionTrigger(params)
-  }
-});
-useTreeViewExpansion.params = {
-  expandedItems: true,
-  defaultExpandedItems: true,
-  onExpandedItemsChange: true,
-  onItemExpansionToggle: true,
-  expansionTrigger: true
-};

package/esm/internals/plugins/useTreeViewExpansion/useTreeViewExpansion.selectors.d.ts

@@ -1,28 +0,0 @@
-import { TreeViewState } from "../../models/index.js";
-import { UseTreeViewExpansionSignature } from "./useTreeViewExpansion.types.js";
-export declare const expansionSelectors: {
-  /**
-   * Gets the expanded items as provided to the component.
-   */
-  expandedItemsRaw: (state: TreeViewState<[UseTreeViewExpansionSignature]>) => readonly string[];
-  /**
-   * Gets the expanded items as a Map.
-   */
-  expandedItemsMap: (args_0: import("../../corePlugins/useTreeViewId/useTreeViewId.types.js").UseTreeViewIdState & import("./useTreeViewExpansion.types.js").UseTreeViewExpansionState & Partial<{}>) => Map<string, true>;
-  /**
-   * Gets the items to render as a flat list (the descendants of an expanded item are listed as siblings of the item).
-   */
-  flatList: (args_0: import("../../corePlugins/useTreeViewId/useTreeViewId.types.js").UseTreeViewIdState & import("./useTreeViewExpansion.types.js").UseTreeViewExpansionState & Partial<{}>) => string[];
-  /**
-   * Gets the slot that triggers the item's expansion when clicked.
-   */
-  triggerSlot: (state: TreeViewState<[UseTreeViewExpansionSignature]>) => "content" | "iconContainer";
-  /**
-   * Checks whether an item is expanded.
-   */
-  isItemExpanded: (args_0: import("../../corePlugins/useTreeViewId/useTreeViewId.types.js").UseTreeViewIdState & import("./useTreeViewExpansion.types.js").UseTreeViewExpansionState & Partial<{}>, itemId: string) => boolean;
-  /**
-   * Checks whether an item is expandable.
-   */
-  isItemExpandable: (args_0: import("../../corePlugins/useTreeViewId/useTreeViewId.types.js").UseTreeViewIdState & import("../useTreeViewItems/index.js").UseTreeViewItemsState<import("../../../index.js").TreeViewDefaultItemModelProperties> & Partial<{}>, _itemId: string) => boolean;
-};