react-magma-dom 4.7.0-next.5 → 4.7.0-next.50

package/dist/components/TreeView/useTreeItem.d.ts

@@ -27,9 +27,6 @@ export interface UseTreeItemProps extends React.HTMLAttributes<HTMLLIElement> {
      * Icon for the tree item
      */
     icon?: React.ReactElement<IconProps>;
-    /**
-     * @internal
-     */
     /**
      * @internal
      */
@@ -39,8 +36,6 @@ export interface UseTreeItemProps extends React.HTMLAttributes<HTMLLIElement> {
      */
     itemDepth?: number;
     /**
-     * TODO: improve functionality (issue #1305)
-     * @internal
      * If true, element is disabled
      * @default false
      */
@@ -68,6 +63,7 @@ export declare function useTreeItem(props: UseTreeItemProps, forwardedRef: any):
         selectedItems: import("./TreeViewContext").TreeItemSelectedInterface[];
         setExpanded: React.Dispatch<React.SetStateAction<boolean>>;
         treeItemChildren: (string | number | {} | React.ReactElement<any, string | ((props: any) => React.ReactElement<any, any>) | (new (props: any) => React.Component<any, any, any>)> | React.ReactNodeArray | React.ReactPortal)[];
+        isDisabled: boolean;
     };
     handleClick: (event: any, itemId: any) => void;
     handleKeyDown: (event: React.KeyboardEvent) => void;

package/dist/components/TreeView/useTreeView.d.ts

@@ -1,8 +1,9 @@
 import * as React from 'react';
 import { TreeItemSelectedInterface, TreeViewItemInterface } from './TreeViewContext';
 import { TreeViewSelectable } from './types';
+export { TreeItemSelectedInterface };
 export interface TreeViewApi {
-    selectItem({ itemId, checkedStatus }: Pick<TreeViewItemInterface, 'itemId' | 'checkedStatus'>): void;
+    selectItem({ itemId, checkedStatus, }: Pick<TreeViewItemInterface, 'itemId' | 'checkedStatus'>): void;
     selectAll(): void;
     clearAll(): void;
 }
@@ -42,8 +43,10 @@ export interface UseTreeViewProps {
     testId?: string;
     /**
      * Action that fires when an item is expanded or collapsed
+     * Return an array of itemIds of items that are expanded
+     * Example: ['item0', 'item1', 'item3']
      */
-    onExpandedChange?: (event: React.SyntheticEvent) => void;
+    onExpandedChange?: (event: React.SyntheticEvent, expandedItems: Array<string>) => void;
     /**
      * Action that fires when an item is selected
      * Return an array of objects.
@@ -63,7 +66,7 @@ export interface UseTreeViewProps {
      * @default true
      */
     checkChildren?: boolean;
-    children?: React.ReactNode[];
+    children?: React.ReactNode[] | React.ReactNode;
     /**
      * The ref object that allows TreeView manipulation.
      * Actions available:
@@ -71,17 +74,22 @@ export interface UseTreeViewProps {
      * selectAll(): void - action that allows to select all items,
      * clearAll(): void - action that allows to unselect all items.
      */
-    apiRef?: React.MutableRefObject<TreeViewApi>;
+    apiRef?: React.MutableRefObject<TreeViewApi | undefined>;
+    /**
+     * If true, every item is disabled
+     * @default false
+     */
+    isDisabled?: boolean;
 }
 export declare function useTreeView(props: UseTreeViewProps): {
     contextValue: {
         hasIcons: any;
         itemToFocus: any;
         onSelectedItemChange: (selectedItems: TreeItemSelectedInterface[]) => void;
-        onExpandedChange: (event: React.SyntheticEvent<Element, Event>) => void;
+        onExpandedChange: (event: React.SyntheticEvent<Element, Event>, expandedItems: string[]) => void;
         selectable: TreeViewSelectable;
         selectedItems: any;
-        initialExpandedItems: string[];
+        initialExpandedItems: any[];
         treeItemRefArray: React.MutableRefObject<React.MutableRefObject<Element>[]>;
         registerTreeItem: (refArray: React.MutableRefObject<React.MutableRefObject<Element>[]>, ref: React.MutableRefObject<Element>) => void;
         initialExpandedItemsNeedUpdate: boolean;
@@ -89,7 +97,9 @@ export declare function useTreeView(props: UseTreeViewProps): {
         checkChildren: boolean;
         checkParents: boolean;
         items: any;
-        selectItem: ({ itemId, checkedStatus }: Pick<TreeViewItemInterface, 'itemId' | 'checkedStatus'>) => void;
+        selectItem: ({ itemId, checkedStatus, }: Pick<TreeViewItemInterface, 'itemId'> & Partial<Pick<TreeViewItemInterface, 'checkedStatus'>>) => void;
+        handleExpandedChange: (event: React.SyntheticEvent, itemId: string) => void;
+        expandedSet: Set<string>;
     };
 };
 export declare type UseTreeViewReturn = ReturnType<typeof useTreeView>;

package/dist/components/TreeView/utils.d.ts

@@ -3,7 +3,7 @@ import { UseTreeViewProps } from './useTreeView';
 import { TreeViewSelectable } from './types';
 import React from 'react';
 import { IndeterminateCheckboxStatus } from '../IndeterminateCheckbox';
-import { TreeViewItemInterface } from './TreeViewContext';
+import { TreeItemSelectedInterface, TreeViewItemInterface } from './TreeViewContext';
 export declare enum TreeNodeType {
     branch = "branch",
     leaf = "leaf"
@@ -31,8 +31,12 @@ export declare function filterNullEntries(obj: any): {
 } | {
     current?: undefined;
 };
-export declare const getInitialItems: ({ children, preselectedItems: rawPreselectedItems, checkParents, selectable }: Pick<UseTreeViewProps, 'children' | 'preselectedItems' | 'checkParents' | 'selectable'>) => any;
-export declare const selectSingle: ({ items, itemId, checkedStatus }: {
+export declare const getChildrenIds: ({ items, itemId, }: {
+    items: TreeViewItemInterface[];
+    itemId: TreeViewItemInterface['itemId'];
+}) => any;
+export declare const getInitialItems: ({ children, preselectedItems: rawPreselectedItems, checkParents, checkChildren, selectable, isDisabled: isTreeViewDisabled, }: Pick<UseTreeViewProps, 'children' | 'preselectedItems' | 'checkParents' | 'checkChildren' | 'selectable' | 'isDisabled'>) => any;
+export declare const selectSingle: ({ items, itemId, checkedStatus, }: {
     items: TreeViewItemInterface[];
     itemId: TreeViewItemInterface['itemId'];
     checkedStatus: TreeViewItemInterface['checkedStatus'];
@@ -42,9 +46,20 @@ export declare const selectSingle: ({ items, itemId, checkedStatus }: {
     parentId?: string;
     icon?: React.ReactNode;
     hasOwnTreeItems: boolean;
+    isDisabled?: boolean;
 }[];
-export declare const selectMulti: ({ items, itemId, checkedStatus, checkChildren, checkParents }: {
+export declare const toggleMulti: ({ items, itemId, checkedStatus: rawCheckedStatus, forceCheckedStatus, checkChildren, checkParents, }: {
     items: TreeViewItemInterface[];
     itemId: TreeViewItemInterface['itemId'];
     checkedStatus: TreeViewItemInterface['checkedStatus'];
-} & Pick<UseTreeViewProps, "checkParents" | "checkChildren">) => any;
+    forceCheckedStatus?: boolean;
+} & Pick<UseTreeViewProps, "checkChildren" | "checkParents">) => any;
+export declare const toggleAllMulti: ({ items, checkedStatus, checkChildren, checkParents, }: {
+    items: TreeViewItemInterface[];
+    checkedStatus: TreeViewItemInterface['checkedStatus'];
+} & Pick<UseTreeViewProps, "checkChildren" | "checkParents">) => any;
+export declare const getInitialExpandedIds: ({ items, initialExpandedItems, }: {
+    items: TreeViewItemInterface[];
+} & Pick<UseTreeViewProps, "initialExpandedItems">) => any[];
+export declare const isEqualArrays: <T>(arrayA: T[], arrayB: T[]) => boolean;
+export declare const isSelectedItemsChanged: (prevSelectedItems: TreeItemSelectedInterface[] | null, selectedItems: TreeItemSelectedInterface[]) => boolean;