react-magma-dom 7.0.1-next.0 → 7.1.0-next.2

package/dist/components/IndeterminateCheckbox/index.d.ts

@@ -15,6 +15,12 @@ export interface IndeterminateCheckboxProps extends Omit<CheckboxProps, 'checked
      * @internal
      */
     hideFocus?: boolean;
+    /**
+     * Suppresses this checkbox's own status live region. Used by `TreeView`,
+     * which announces selection itself.
+     * @internal
+     */
+    suppressStatusAnnounce?: boolean;
 }
 export declare enum IndeterminateCheckboxStatus {
     checked = "checked",

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

@@ -0,0 +1,11 @@
+import * as React from 'react';
+export interface TreeViewAnnounceContextInterface {
+    /**
+     * Publishes a message to the tree's single live region, which is owned by
+     * `TreeView` and rendered outside the `ul[role="tree"]`. A region rendered
+     * inside a tree item would become a permanent part of that item's accessible
+     * name.
+     */
+    announce: (message: string) => void;
+}
+export declare const TreeViewAnnounceContext: React.Context<TreeViewAnnounceContextInterface>;

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

@@ -0,0 +1,9 @@
+import * as React from 'react';
+export interface TreeViewAnnouncerHandle {
+    announce: (message: string) => void;
+}
+export interface TreeViewAnnouncerProps {
+    testId?: string;
+}
+export declare const ANNOUNCE_DELAY_MS = 150;
+export declare const TreeViewAnnouncer: React.ForwardRefExoticComponent<TreeViewAnnouncerProps & React.RefAttributes<TreeViewAnnouncerHandle>>;

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

@@ -4,5 +4,10 @@ export interface TreeViewExpansionContextInterface {
     handleExpandedChange: (event: React.SyntheticEvent, expandedItemId: string) => void;
     onExpandedChange?: (event: React.SyntheticEvent, expandedItems: Array<string>) => void;
     initialExpandedItems: Array<string>;
+    /**
+     * Marks an expansion change as coming from `expandAll`/`collapseAll`. Tree
+     * items stay silent while it is set; `TreeView` announces the action once.
+     */
+    bulkExpansionRef?: React.MutableRefObject<'expand' | 'collapse' | null>;
 }
 export declare const TreeViewExpansionContext: React.Context<TreeViewExpansionContextInterface>;

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

@@ -137,6 +137,7 @@ export declare function useTreeView(props: UseTreeViewProps): {
         handleExpandedChange: (event: React.SyntheticEvent, itemId: string | string[]) => void;
         onExpandedChange: (event: React.SyntheticEvent<Element, Event>, expandedItems: string[]) => void;
         initialExpandedItems: any[];
+        bulkExpansionRef: React.MutableRefObject<"expand" | "collapse">;
     };
     configContextValue: {
         hasIcons: boolean;

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

@@ -2,12 +2,16 @@ import React from 'react';
 import { TreeItemSelectedInterface, TreeViewItemInterface } from './TreeViewContext';
 import { TreeViewSelectable } from './types';
 import { UseTreeViewProps } from './useTreeView';
+import { I18nInterface } from '../../i18n/interface';
 import { ThemeInterface } from '../../theme/magma';
 import { IndeterminateCheckboxStatus } from '../IndeterminateCheckbox';
 export declare enum TreeNodeType {
     branch = "branch",
     leaf = "leaf"
 }
+declare type TreeViewI18n = Required<NonNullable<I18nInterface['treeView']>>;
+export declare function resolveTreeViewString(i18n: I18nInterface, key: keyof TreeViewI18n): string;
+export declare function resolveExpansionAnnounceTemplate(i18n: I18nInterface, expanded: boolean): string;
 /**
  * Leaf node - 1st level has 40px of left padding.
  * Each level after that adds 56px of left padding.
@@ -66,3 +70,4 @@ export declare const getInitialExpandedIds: ({ items, initialExpandedItems, }: {
 } & Pick<UseTreeViewProps, "initialExpandedItems">) => any[];
 export declare const isEqualArrays: <T>(arrayA: T[], arrayB: T[]) => boolean;
 export declare const isSelectedItemsChanged: (prevSelectedItems: TreeItemSelectedInterface[] | null, selectedItems: TreeItemSelectedInterface[]) => boolean;
+export {};