pixel-react 1.21.91 → 1.21.93

package/lib/hooks/useFocusTrap.d.ts

@@ -0,0 +1,29 @@
+import { RefObject } from 'react';
+/**
+ * Remembers the element that had focus when `isOpen` became true, read during
+ * render — before children with autoFocus take focus — so it can be restored.
+ */
+export declare const useOpenerElement: (isOpen: boolean) => import("react").MutableRefObject<HTMLElement | null>;
+interface FocusTrapOptions {
+    active: boolean;
+    /** Element to focus on activation; defaults to the first focusable child. */
+    initialFocusRef?: RefObject<HTMLElement>;
+    /** Return focus to the element that was focused before activation. */
+    restoreFocus?: boolean;
+    /** Explicit element to return focus to (see useOpenerElement). */
+    returnFocusRef?: RefObject<HTMLElement | null>;
+    /**
+     * Keep Tab/Shift+Tab inside the container (modal). When false, focus only
+     * moves in on activation and back out afterwards (non-modal panel).
+     */
+    trapTab?: boolean;
+}
+export declare const isTopMostFocusTrap: (container: HTMLElement | null) => boolean;
+export declare const getTopMostFocusTrap: () => HTMLElement | null;
+/**
+ * Moves keyboard focus into a dialog when it opens, optionally keeps it there
+ * while it is modal, and restores it to the trigger afterwards — WCAG 2.4.3
+ * Focus Order and 2.1.2 No Keyboard Trap (focus is released on close).
+ */
+declare const useFocusTrap: (containerRef: RefObject<HTMLElement>, { active, initialFocusRef, restoreFocus, trapTab, returnFocusRef, }: FocusTrapOptions) => void;
+export default useFocusTrap;

package/lib/hooks/useFocusTrap.js

@@ -0,0 +1,97 @@
+import { useEffect, useRef } from 'react';
+import { getFocusableElements } from '../utils/a11y/a11y';
+/**
+ * Remembers the element that had focus when `isOpen` became true, read during
+ * render — before children with autoFocus take focus — so it can be restored.
+ */
+export const useOpenerElement = (isOpen) => {
+    const openerRef = useRef(null);
+    const wasOpenRef = useRef(false);
+    if (isOpen && !wasOpenRef.current && typeof document !== 'undefined') {
+        const focused = document.activeElement;
+        openerRef.current =
+            focused instanceof HTMLElement && focused !== document.body
+                ? focused
+                : null;
+    }
+    wasOpenRef.current = isOpen;
+    return openerRef;
+};
+// Traps are stacked so only the top-most dialog handles Tab and Escape.
+const trapStack = [];
+export const isTopMostFocusTrap = (container) => !!container && trapStack[trapStack.length - 1] === container;
+export const getTopMostFocusTrap = () => trapStack[trapStack.length - 1] ?? null;
+/**
+ * Moves keyboard focus into a dialog when it opens, optionally keeps it there
+ * while it is modal, and restores it to the trigger afterwards — WCAG 2.4.3
+ * Focus Order and 2.1.2 No Keyboard Trap (focus is released on close).
+ */
+const useFocusTrap = (containerRef, { active, initialFocusRef, restoreFocus = true, trapTab = true, returnFocusRef, }) => {
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!active || !container)
+            return undefined;
+        const focusedNow = document.activeElement instanceof HTMLElement
+            ? document.activeElement
+            : null;
+        // Prefer the opener captured at render; otherwise whatever had focus,
+        // unless that is already inside the container (e.g. an autoFocus field).
+        const previouslyFocused = returnFocusRef?.current ??
+            (focusedNow && !container.contains(focusedNow) ? focusedNow : null);
+        if (trapTab)
+            trapStack.push(container);
+        // Deferred so children using autoFocus win, and portal content is laid out.
+        const frame = requestAnimationFrame(() => {
+            if (container.contains(document.activeElement))
+                return;
+            const target = initialFocusRef?.current ??
+                getFocusableElements(container)[0] ??
+                container;
+            target.focus({ preventScroll: true });
+        });
+        const handleKeyDown = (event) => {
+            if (event.key !== 'Tab' ||
+                // Composite widgets (e.g. a spreadsheet) may use Tab internally.
+                event.defaultPrevented ||
+                !isTopMostFocusTrap(container)) {
+                return;
+            }
+            const focusable = getFocusableElements(container);
+            const first = focusable[0];
+            const last = focusable[focusable.length - 1];
+            if (!first || !last) {
+                event.preventDefault();
+                container.focus({ preventScroll: true });
+                return;
+            }
+            const activeElement = document.activeElement;
+            const focusIsOutside = !container.contains(activeElement);
+            if (event.shiftKey && (activeElement === first || focusIsOutside)) {
+                event.preventDefault();
+                last.focus();
+            }
+            else if (!event.shiftKey && (activeElement === last || focusIsOutside)) {
+                event.preventDefault();
+                first.focus();
+            }
+        };
+        if (trapTab)
+            document.addEventListener('keydown', handleKeyDown);
+        return () => {
+            cancelAnimationFrame(frame);
+            document.removeEventListener('keydown', handleKeyDown);
+            const index = trapStack.lastIndexOf(container);
+            if (index !== -1)
+                trapStack.splice(index, 1);
+            // Only restore when focus would otherwise be lost (inside the closing
+            // container or already on <body>), never steal it from elsewhere.
+            const focused = document.activeElement;
+            const focusWouldBeLost = !focused || focused === document.body || container.contains(focused);
+            if (restoreFocus && focusWouldBeLost && previouslyFocused?.isConnected) {
+                previouslyFocused.focus({ preventScroll: true });
+            }
+        };
+    }, [active, containerRef, initialFocusRef, restoreFocus, trapTab, returnFocusRef]);
+};
+export default useFocusTrap;
+//# sourceMappingURL=useFocusTrap.js.map

package/lib/hooks/useFocusTrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusTrap.js","sourceRoot":"","sources":["../../src/hooks/useFocusTrap.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAe,EAAE,EAAE;IAClD,MAAM,SAAS,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACrE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;QACvC,SAAS,CAAC,OAAO;YACf,OAAO,YAAY,WAAW,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI;gBACzD,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,CAAC;IACb,CAAC;IACD,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC;IAC5B,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAiBF,wEAAwE;AACxE,MAAM,SAAS,GAAkB,EAAE,CAAC;AAEpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAA6B,EAAE,EAAE,CAClE,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;AAE/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AAEjF;;;;GAIG;AACH,MAAM,YAAY,GAAG,CACnB,YAAoC,EACpC,EACE,MAAM,EACN,eAAe,EACf,YAAY,GAAG,IAAI,EACnB,OAAO,GAAG,IAAI,EACd,cAAc,GACG,EACnB,EAAE;IACF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QAE5C,MAAM,UAAU,GACd,QAAQ,CAAC,aAAa,YAAY,WAAW;YAC3C,CAAC,CAAC,QAAQ,CAAC,aAAa;YACxB,CAAC,CAAC,IAAI,CAAC;QACX,sEAAsE;QACtE,yEAAyE;QACzE,MAAM,iBAAiB,GACrB,cAAc,EAAE,OAAO;YACvB,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtE,IAAI,OAAO;YAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEvC,4EAA4E;QAC5E,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE;YACvC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAAE,OAAO;YACvD,MAAM,MAAM,GACV,eAAe,EAAE,OAAO;gBACxB,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAClC,SAAS,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAE,EAAE;YAC7C,IACE,KAAK,CAAC,GAAG,KAAK,KAAK;gBACnB,iEAAiE;gBACjE,KAAK,CAAC,gBAAgB;gBACtB,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAC9B,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,OAAO;YACT,CAAC;YAED,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;YAC7C,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1D,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,aAAa,KAAK,KAAK,IAAI,cAAc,CAAC,EAAE,CAAC;gBAClE,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;iBAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,aAAa,KAAK,IAAI,IAAI,cAAc,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,cAAc,EAAE,CAAC;gBACvB,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QAEF,IAAI,OAAO;YAAE,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAEjE,OAAO,GAAG,EAAE;YACV,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC5B,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAE7C,sEAAsE;YACtE,kEAAkE;YAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;YACvC,MAAM,gBAAgB,GACpB,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvE,IAAI,YAAY,IAAI,gBAAgB,IAAI,iBAAiB,EAAE,WAAW,EAAE,CAAC;gBACvE,iBAAiB,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;AACrF,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/lib/hooks/useInteractiveAncestor.d.ts

@@ -0,0 +1,7 @@
+import { RefObject } from 'react';
+/**
+ * True when the element is rendered inside a control that already handles
+ * keyboard activation, so the element should not add its own tab stop.
+ */
+declare const useInteractiveAncestor: (ref: RefObject<HTMLElement>, enabled: boolean) => boolean;
+export default useInteractiveAncestor;

package/lib/hooks/useInteractiveAncestor.js

@@ -0,0 +1,18 @@
+import { useLayoutEffect, useState } from 'react';
+import { hasInteractiveAncestor } from '../utils/a11y/a11y';
+/**
+ * True when the element is rendered inside a control that already handles
+ * keyboard activation, so the element should not add its own tab stop.
+ */
+const useInteractiveAncestor = (ref, enabled) => {
+    const [isNested, setIsNested] = useState(false);
+    useLayoutEffect(() => {
+        if (!enabled)
+            return;
+        const nested = hasInteractiveAncestor(ref.current);
+        setIsNested((previous) => (previous === nested ? previous : nested));
+    }, [enabled, ref]);
+    return enabled && isNested;
+};
+export default useInteractiveAncestor;
+//# sourceMappingURL=useInteractiveAncestor.js.map

package/lib/hooks/useInteractiveAncestor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInteractiveAncestor.js","sourceRoot":"","sources":["../../src/hooks/useInteractiveAncestor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAC7B,GAA2B,EAC3B,OAAgB,EAChB,EAAE;IACF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhD,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,WAAW,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAEnB,OAAO,OAAO,IAAI,QAAQ,CAAC;AAC7B,CAAC,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React__default, { ReactNode, FC, RefObject, LegacyRef, CSSProperties, ReactElement, Ref, ComponentProps, Component, ErrorInfo } from 'react';
+import React__default, { ReactNode, FC, KeyboardEventHandler, RefObject, LegacyRef, CSSProperties, ReactElement, Ref, ComponentProps, Component, ErrorInfo, KeyboardEvent } from 'react';
 import * as LazyLoad from 'react-window';
 export { LazyLoad };
 import * as Form from 'react-hook-form';
@@ -400,6 +400,7 @@ interface IconProps$2 {
     width?: number;
     color?: string;
     onClick?: (data?: any) => void;
+    onKeyDown?: KeyboardEventHandler<Element>;
     hoverEffect?: boolean;
     isSelected?: boolean;
     disabled?: boolean;
@@ -1268,6 +1269,8 @@ interface MenuOptionProps {
      * @optional
      */
     labelName?: string;
+    /** Accessible name of the trigger when the icon alone does not describe it */
+    ariaLabel?: string;
     /**
      * The name of the icon to be displayed.
      * @type {string}
@@ -1366,7 +1369,7 @@ interface MenuOptionProps {
     selectedValue?: string;
 }
 
-declare const MenuOption: ({ labelName, iconName, tooltipTitle, tooltipPlacement, options, onClick, onOptionClick, iconButtonSize, iconButtonBorderRadius, iconSize, variant, zIndex, dropdownPlacement, optionCardVariant, targetRef, treeRowRef, isAddResourceButton, disabled, alignOption, displayCard, didMouseEntered, tableMenu, dropdownHeight, selectedValue, }: MenuOptionProps) => React$1.JSX.Element;
+declare const MenuOption: ({ labelName, ariaLabel, iconName, tooltipTitle, tooltipPlacement, options, onClick, onOptionClick, iconButtonSize, iconButtonBorderRadius, iconSize, variant, zIndex, dropdownPlacement, optionCardVariant, targetRef, treeRowRef, isAddResourceButton, disabled, alignOption, displayCard, didMouseEntered, tableMenu, dropdownHeight, selectedValue, }: MenuOptionProps) => React$1.JSX.Element;
 
 interface DataProps$3 {
     /**
@@ -1519,6 +1522,11 @@ interface TableProps$2 {
     };
     uniqueRowIdForAccordion?: string | number;
     openAccordionId?: string | number | null;
+    /**
+     * Accessible name of the scrollable table region, announced when it
+     * receives keyboard focus
+     */
+    ariaLabel?: string;
 }
 
 declare const Table: React$1.ForwardRefExoticComponent<TableProps$2 & React$1.RefAttributes<any>>;
@@ -1720,6 +1728,13 @@ interface FileDropzoneProps {
     showRejectedFileDetails?: boolean;
     disabledDragAndDrop?: boolean;
     tooltipPosition?: TooltipPosition;
+    /**
+     *  Controls whether the built-in accepted-file preview list is rendered.
+     *  Defaults to true. Set to false to compose a custom layout using the
+     *  FileDropzone.AcceptedFilePreview / FileDropzone.RejectedFilePreview
+     *  subcomponents together with getAcceptedFiles / getRejectedFiles.
+     **/
+    showPreview?: boolean;
 }
 interface FileError {
     message: string;
@@ -1778,6 +1793,23 @@ interface DroppableProps {
     setFileContent?: (data: string) => void;
     fileContent?: string;
 }
+interface FilePreviewAction {
+    /**
+     *  Unique key for the action, also used to derive a CSS hook
+     *  (ff-file-actions__icon-{key}) for styling a specific action.
+     **/
+    key: string;
+    /**
+     *  Icon name (rendered via the Icon component) or a fully custom node.
+     **/
+    icon: ReactNode | string;
+    tooltip?: string;
+    ariaLabel?: string;
+    disabled?: boolean;
+    hidden?: boolean;
+    color?: string;
+    onClick: (file: File) => void;
+}
 interface FilePreviewProps {
     file: File;
     error?: string;
@@ -1790,14 +1822,65 @@ interface FilePreviewProps {
     isError?: boolean;
     isIndependentPreview?: boolean;
     tooltipPosition?: TooltipPosition;
+    /**
+     *  Overrides the leading file icon. Defaults to the built-in file icon.
+     **/
+    icon?: ReactNode;
+    /**
+     *  Overrides how the file name is rendered. Defaults to a truncated,
+     *  tooltip-wrapped Typography of file.name.
+     **/
+    renderFileName?: (file: File) => ReactNode;
+    /**
+     *  Overrides how the error message is rendered when isError is true.
+     **/
+    renderError?: (error?: string) => ReactNode;
+    /**
+     *  Fully replaces the default replace/remove/upload action buttons with
+     *  a custom, config-driven set of actions.
+     **/
+    actions?: FilePreviewAction[];
+    className?: string;
+}
+interface RejectedFilePreviewProps {
+    fileRejection: FileRejection;
+    onRemoveClick?: (file: File) => void;
+    tooltipPosition?: TooltipPosition;
+    /**
+     *  Overrides the leading icon. Defaults to the built-in alert icon.
+     **/
+    icon?: ReactNode;
+    /**
+     *  Overrides how the file name is rendered. Defaults to a truncated,
+     *  tooltip-wrapped Typography of file.name.
+     **/
+    renderFileName?: (file: File) => ReactNode;
+    /**
+     *  Overrides how the rejection reasons are rendered. Defaults to the
+     *  joined error messages.
+     **/
+    renderError?: (errors: FileError[]) => ReactNode;
+    /**
+     *  Fully replaces the default remove action button with a custom,
+     *  config-driven set of actions.
+     **/
+    actions?: FilePreviewAction[];
+    className?: string;
 }
-
-declare const FileDropzone: React.FC<FileDropzoneProps>;
 
 declare const Dropzone: FC<DroppableProps>;
 
 declare const FilePreview: React.FC<FilePreviewProps>;
 
+declare const RejectedFilePreview: React.FC<RejectedFilePreviewProps>;
+
+type FileDropzoneComponent = React.FC<FileDropzoneProps> & {
+    Dropzone: typeof Dropzone;
+    AcceptedFilePreview: typeof FilePreview;
+    RejectedFilePreview: typeof RejectedFilePreview;
+};
+declare const FileDropzone: FileDropzoneComponent;
+
 type Theme = 'ff-light-theme' | 'ff-dark-theme' | 'ff-grey-theme' | 'ff-blue-theme';
 interface ThemeContextType {
     currentTheme: Theme;
@@ -2792,6 +2875,12 @@ interface ModalProps {
     ariaHideApp?: boolean;
     /*** Whether the modal should close when clicking outside of it (on the overlay) */
     shouldCloseOnOverlayClick?: boolean;
+    /*** Keep keyboard focus inside the dialog while it is open (WCAG 2.4.3) */
+    trapFocus?: boolean;
+    /*** Return focus to the triggering element after the dialog closes */
+    shouldReturnFocusAfterClose?: boolean;
+    /*** Element to focus when the dialog opens; defaults to the first focusable element */
+    initialFocusRef?: RefObject<HTMLElement>;
     headerContent?: string | ReactNode;
     footerContent?: ReactNode;
     /***Content to be displayed inside the modal */
@@ -6331,8 +6420,8 @@ interface RiskZone {
     color: string;
 }
 interface ScoreGaugeChartProps {
-    /** Score value between 0 and 100 */
-    score: number;
+    /** Score value between 0 and 100, or `"NA"` when no score is available */
+    score: number | string;
     /** Outer radius of the gauge arc (default: 90) */
     radius?: number;
     /** Thickness of the gauge arc (default: 14) */
@@ -6568,5 +6657,46 @@ interface DotLoaderProps {
 
 declare const DotLoader: ({ dotCount, label, labelFontSize, labelFontWeight, dotFontSize, dotFontWeight }: DotLoaderProps) => React$1.JSX.Element;
 
-export { AADHAAR_REGEX, ALPHABET_ONLY_REGEX, ALPHABET_WITH_SPACES_ONLY_REGEX, ALPHANUMERIC_PARENTHESIS_REGEX, ALPHANUMERIC_REGEX, ALPHANUMERIC_WITH_DOT_REGEX, ALPHANUMERIC_WITH_ROUND_BRACES_REGEX, ALPHA_NUM_EXTENDED_REGEX, ALPHA_NUM_REGEX, Accordion, AddContentButton, AddResourceButton, AiToggle, AllProjectsDropdown, AnimatedSetting, AppHeader, AttachMedia, AttachmentButton, AudioPlayer, AutoTruncateText, Avatar, BASE64_REGEX, BIG_END_WHITESPACE, BINARY_NUMBER_REGEX, BODY_TAG_TYPE_VALIDATION, BarChart, Card as Box, BrowserTabs, Button, CAMEL_CASE_REGEX, CERTIFICATES_NAME_REGEX, CHECK_CAMEL_CASE, CREDIT_CARD_REGEX, CURRENCY_GENERIC_REGEX, CardPanel, ChatModal, ChatModalAi, Checkbox, Chip, ChipWithCount, ChooseFile, Col, Comments, ConditionalDropdown, ConnectingBranch, Container, ContentCard, CreateVariableSlider, DATE_REGEX, DECIMAL_NUMBER_REGEX, DRIVING_LICENSE_REGEX, DYNAMIC_VALUE_PATTERN_REGEX, DYNAMIC_VALUE_TYPE_REGEX, DYNAMIC_VALUE_WITH_VALID_BRACKETS_REGEX, DYNAMIC_VALUE__PLACEHOLDER_REGEX, DashboardDonutChart, CustomDatePicker as DatePicker, DebugToolsPanel, DonutChart, DotLoader, DownloadClient, DragAndDrop, Drawer, Dropzone, ELEMENTS_TRAILING_SPACE_REGEX, ELEMENTS_WHITE_SPACE_REGEX, EMAIL_FORMAT_REGEX, EMAIL_REGEX, EMAIL_VALIDATION_REGEX, EXCEL_SPACING_REGEX, EXECUTION_ID_VALIDATION, EditLabel, EditTextField, Editor, ErrorBoundary, ExcelFile as Excel, ExpandableMenu, FILENAME_VALIDATION_REGEX, FILE_EXTENSION_REGEX, FILE_NAME_REGEX, FieldSet, FileDropzone, FilePreview, ForwardedForms as Form, formatString as FormatString, GSTIN_REGEX, HEXADECIMAL_NUMBER_REGEX, HEX_COLOR_REGEX, HSL_COLOR_REGEX, HTML_ATTRIBUTE_REGEX, HTML_FILE_TYPE_VALIDATION, HTML_TAG_REGEX, HighlightText, HistoryCard, INDIAN_CURRENCY_REGEX, INDIAN_PASSPORT_REGEX, INDIAN_PHONE_REGEX, INDIAN_PIN_CODE_REGEX, INTERNATIONAL_PHONE_REGEX, INVALID_EMAIL_REGEX, IPV4_REGEX, IPV6_REGEX, Icon, IconButton, IconRadialChart, IconRadioGroup, Input, InputWithDropdown, JAVASCRIPT_FILE_TYPE_VALIDATION, LINKEDIN_PROFILE_REGEX, LINK_VALIDATION_REGEX, LabelEditTextField, LayoutWithDrawer, LineChart, LineLoader, Link, Loader, MAC_ADDRESS_REGEX, MEMORY_VALIDATION_REGEX, MachineInputField, MediaPreview, MediaViewerModal as MediaViewerModel, MenuOption, MessageBox, MiniModal, MobileSkin, Modal, ModuleChip, MultiRadialChart, MultiSelect, NlpInput as NLPInput, NLP_DESCRIPTION_REGEX, NO_LEADING_TRAILING_SPACE_REGEX, NUMBERS_ONLY_REGEX, NUMBER_REGEX, NetworkErrorBoundary, NoDataAvailable, NoDataContent, NoResultFound, OsTree, OtpVerification, OverviewModal, PAN_CARD_REGEX, PARAMETER_ALPHANUMERIC_REGEX, PASSWORD_COMPLEX_REGEX, PASSWORD_SIMPLE_REGEX, PHONE_REGEX, POSTAL_CODE_REGEX, Paper, PhoneInputField, PieChart, PopUpModal, PrePostTable, ProcessedSourceSelector, ProgressBar, Prompt, PromptContainer, RGB_COLOR_REGEX, ROMAN_NUMERALS_REGEX, RadialChart, RadioButton, RadioGroup, Recaptcha, Row, SCRIPT_REGEX, SERVER_HOST_REGEX, SSN_REGEX, START_END_WHITESPACE_REGEX, STEP_GROUP_NAME_REGEX, ScoreGaugeChart, ScriptGenerationLoader, ScriptSwitchButton, Search, Select, SelectionSwitcher, SequentialConnectingBranch, SessionDropdown, SessionManager, StackedBarChart, StateDropdown, StatusBadge, StatusButton, StatusCard, StatusIndicator, StepLandingTable, StepResultStats, StorageUsageBar, SwitchButton, TIME_REGEX, TWITTER_HANDLE_REGEX, Table, TreeTable as TableTree, TableTreeFn, TableWithAccordion, Tabs, TabsWithSilder, Textarea as TextArea, TextEditor, ThemeProvider, Toaster, Toastify, Toggle, ToggleSwitch, Tooltip, TooltipService, TruncatedTooltip, Typography, UNIT_REGEX, URL_REGEX, USERNAME_REGEX, USERNAME_SPECIAL_REGEX, US_ZIP_CODE_REGEX, UUID_REGEX, VALID_NAME_PATTERN, VEHICLE_REGISTRATION_REGEX, VariableDropdown, VariableInput, VariableSuggestionInputDropDown, WHITESPACE_REGEX, WeightageTable, XML_FILE_TYPE_VALIDATION, ZoomControl, addPrePostStepGroup, addStepGroup, autoScrollToTableLastRow, capitalize, checkEmpty, checkMicrophoneAccess, cleanAllTooltips, clearStore, compareArrays, compareObjects, computeTreeCountsAndFormatNodes, convertFormDataToObject, convertToBytes, convertToGB, convertToISO, copyToClipboard, debounce, deleteStoreValue, ffid, findAndInsert, formatDate, formatResponseDate, getEncryptedData, getExtension, getExtensionWithPeriod, getFiltersFromUrl, getNavigateToKey, getSequentialPayload, getStoreValue, getTopVisibleNodeKey, getTreeDetails, handleTimeZoneChange, handleTreeExpandAllCollapseAll, handleTreeNodeExpandCollapse, handleTreeNodeSect, handleUnCheckAllTreeNodesWithUpdates, hasDuplicateFile, isEmptyObject, isTextTruncated, nlpInputDelay, passesFilters, rearrangeDragItem, restoreSelectedFilters, saveFileFromBlob, scrollToView, setStoreValue, throttle, toCamelCase, toast, toggleShowHideEntity, truncateText, updateSearchTree, updateTreeState, useBeforeUnload, useClickOutside, useDeviceType, useFileDropzone, useKeyboardActions, useTheme, useTriggerControl, validateFileContent };
+interface FocusTrapOptions {
+    active: boolean;
+    /** Element to focus on activation; defaults to the first focusable child. */
+    initialFocusRef?: RefObject<HTMLElement>;
+    /** Return focus to the element that was focused before activation. */
+    restoreFocus?: boolean;
+    /** Explicit element to return focus to (see useOpenerElement). */
+    returnFocusRef?: RefObject<HTMLElement | null>;
+    /**
+     * Keep Tab/Shift+Tab inside the container (modal). When false, focus only
+     * moves in on activation and back out afterwards (non-modal panel).
+     */
+    trapTab?: boolean;
+}
+declare const isTopMostFocusTrap: (container: HTMLElement | null) => boolean;
+/**
+ * Moves keyboard focus into a dialog when it opens, optionally keeps it there
+ * while it is modal, and restores it to the trigger afterwards — WCAG 2.4.3
+ * Focus Order and 2.1.2 No Keyboard Trap (focus is released on close).
+ */
+declare const useFocusTrap: (containerRef: RefObject<HTMLElement>, { active, initialFocusRef, restoreFocus, trapTab, returnFocusRef, }: FocusTrapOptions) => void;
+
+declare const isActivationKey: (key: string) => key is "Enter" | " " | "Spacebar";
+declare const getFocusableElements: (container: HTMLElement | null) => HTMLElement[];
+interface ButtonA11yOptions<T extends HTMLElement> {
+    onActivate: (event: KeyboardEvent<T>) => void;
+    disabled?: boolean;
+    role?: 'button' | 'link';
+}
+/**
+ * Makes a non-semantic element (div/span) keyboard operable like a native
+ * button or link — WCAG 2.1.1 Keyboard and 4.1.2 Name, Role, Value.
+ * Links activate on Enter only, buttons on Enter and Space.
+ */
+declare const getButtonA11yProps: <T extends HTMLElement>({ onActivate, disabled, role, }: ButtonA11yOptions<T>) => {
+    role: "button" | "link";
+    tabIndex: number;
+    'aria-disabled': true | undefined;
+    onKeyDown: (event: KeyboardEvent<T>) => void;
+};
+
+export { AADHAAR_REGEX, ALPHABET_ONLY_REGEX, ALPHABET_WITH_SPACES_ONLY_REGEX, ALPHANUMERIC_PARENTHESIS_REGEX, ALPHANUMERIC_REGEX, ALPHANUMERIC_WITH_DOT_REGEX, ALPHANUMERIC_WITH_ROUND_BRACES_REGEX, ALPHA_NUM_EXTENDED_REGEX, ALPHA_NUM_REGEX, Accordion, AddContentButton, AddResourceButton, AiToggle, AllProjectsDropdown, AnimatedSetting, AppHeader, AttachMedia, AttachmentButton, AudioPlayer, AutoTruncateText, Avatar, BASE64_REGEX, BIG_END_WHITESPACE, BINARY_NUMBER_REGEX, BODY_TAG_TYPE_VALIDATION, BarChart, Card as Box, BrowserTabs, Button, CAMEL_CASE_REGEX, CERTIFICATES_NAME_REGEX, CHECK_CAMEL_CASE, CREDIT_CARD_REGEX, CURRENCY_GENERIC_REGEX, CardPanel, ChatModal, ChatModalAi, Checkbox, Chip, ChipWithCount, ChooseFile, Col, Comments, ConditionalDropdown, ConnectingBranch, Container, ContentCard, CreateVariableSlider, DATE_REGEX, DECIMAL_NUMBER_REGEX, DRIVING_LICENSE_REGEX, DYNAMIC_VALUE_PATTERN_REGEX, DYNAMIC_VALUE_TYPE_REGEX, DYNAMIC_VALUE_WITH_VALID_BRACKETS_REGEX, DYNAMIC_VALUE__PLACEHOLDER_REGEX, DashboardDonutChart, CustomDatePicker as DatePicker, DebugToolsPanel, DonutChart, DotLoader, DownloadClient, DragAndDrop, Drawer, Dropzone, ELEMENTS_TRAILING_SPACE_REGEX, ELEMENTS_WHITE_SPACE_REGEX, EMAIL_FORMAT_REGEX, EMAIL_REGEX, EMAIL_VALIDATION_REGEX, EXCEL_SPACING_REGEX, EXECUTION_ID_VALIDATION, EditLabel, EditTextField, Editor, ErrorBoundary, ExcelFile as Excel, ExpandableMenu, FILENAME_VALIDATION_REGEX, FILE_EXTENSION_REGEX, FILE_NAME_REGEX, FieldSet, FileDropzone, FilePreview, ForwardedForms as Form, formatString as FormatString, GSTIN_REGEX, HEXADECIMAL_NUMBER_REGEX, HEX_COLOR_REGEX, HSL_COLOR_REGEX, HTML_ATTRIBUTE_REGEX, HTML_FILE_TYPE_VALIDATION, HTML_TAG_REGEX, HighlightText, HistoryCard, INDIAN_CURRENCY_REGEX, INDIAN_PASSPORT_REGEX, INDIAN_PHONE_REGEX, INDIAN_PIN_CODE_REGEX, INTERNATIONAL_PHONE_REGEX, INVALID_EMAIL_REGEX, IPV4_REGEX, IPV6_REGEX, Icon, IconButton, IconRadialChart, IconRadioGroup, Input, InputWithDropdown, JAVASCRIPT_FILE_TYPE_VALIDATION, LINKEDIN_PROFILE_REGEX, LINK_VALIDATION_REGEX, LabelEditTextField, LayoutWithDrawer, LineChart, LineLoader, Link, Loader, MAC_ADDRESS_REGEX, MEMORY_VALIDATION_REGEX, MachineInputField, MediaPreview, MediaViewerModal as MediaViewerModel, MenuOption, MessageBox, MiniModal, MobileSkin, Modal, ModuleChip, MultiRadialChart, MultiSelect, NlpInput as NLPInput, NLP_DESCRIPTION_REGEX, NO_LEADING_TRAILING_SPACE_REGEX, NUMBERS_ONLY_REGEX, NUMBER_REGEX, NetworkErrorBoundary, NoDataAvailable, NoDataContent, NoResultFound, OsTree, OtpVerification, OverviewModal, PAN_CARD_REGEX, PARAMETER_ALPHANUMERIC_REGEX, PASSWORD_COMPLEX_REGEX, PASSWORD_SIMPLE_REGEX, PHONE_REGEX, POSTAL_CODE_REGEX, Paper, PhoneInputField, PieChart, PopUpModal, PrePostTable, ProcessedSourceSelector, ProgressBar, Prompt, PromptContainer, RGB_COLOR_REGEX, ROMAN_NUMERALS_REGEX, RadialChart, RadioButton, RadioGroup, Recaptcha, RejectedFilePreview, Row, SCRIPT_REGEX, SERVER_HOST_REGEX, SSN_REGEX, START_END_WHITESPACE_REGEX, STEP_GROUP_NAME_REGEX, ScoreGaugeChart, ScriptGenerationLoader, ScriptSwitchButton, Search, Select, SelectionSwitcher, SequentialConnectingBranch, SessionDropdown, SessionManager, StackedBarChart, StateDropdown, StatusBadge, StatusButton, StatusCard, StatusIndicator, StepLandingTable, StepResultStats, StorageUsageBar, SwitchButton, TIME_REGEX, TWITTER_HANDLE_REGEX, Table, TreeTable as TableTree, TableTreeFn, TableWithAccordion, Tabs, TabsWithSilder, Textarea as TextArea, TextEditor, ThemeProvider, Toaster, Toastify, Toggle, ToggleSwitch, Tooltip, TooltipService, TruncatedTooltip, Typography, UNIT_REGEX, URL_REGEX, USERNAME_REGEX, USERNAME_SPECIAL_REGEX, US_ZIP_CODE_REGEX, UUID_REGEX, VALID_NAME_PATTERN, VEHICLE_REGISTRATION_REGEX, VariableDropdown, VariableInput, VariableSuggestionInputDropDown, WHITESPACE_REGEX, WeightageTable, XML_FILE_TYPE_VALIDATION, ZoomControl, addPrePostStepGroup, addStepGroup, autoScrollToTableLastRow, capitalize, checkEmpty, checkMicrophoneAccess, cleanAllTooltips, clearStore, compareArrays, compareObjects, computeTreeCountsAndFormatNodes, convertFormDataToObject, convertToBytes, convertToGB, convertToISO, copyToClipboard, debounce, deleteStoreValue, ffid, findAndInsert, formatDate, formatResponseDate, getButtonA11yProps, getEncryptedData, getExtension, getExtensionWithPeriod, getFiltersFromUrl, getFocusableElements, getNavigateToKey, getSequentialPayload, getStoreValue, getTopVisibleNodeKey, getTreeDetails, handleTimeZoneChange, handleTreeExpandAllCollapseAll, handleTreeNodeExpandCollapse, handleTreeNodeSect, handleUnCheckAllTreeNodesWithUpdates, hasDuplicateFile, isActivationKey, isEmptyObject, isTextTruncated, isTopMostFocusTrap, nlpInputDelay, passesFilters, rearrangeDragItem, restoreSelectedFilters, saveFileFromBlob, scrollToView, setStoreValue, throttle, toCamelCase, toast, toggleShowHideEntity, truncateText, updateSearchTree, updateTreeState, useBeforeUnload, useClickOutside, useDeviceType, useFileDropzone, useFocusTrap, useKeyboardActions, useTheme, useTriggerControl, validateFileContent };
 export type { RootNode$1 as RootNode, TreeNodeProps, WeightageCellRenderProps, WeightageColumnLabels, WeightageGroup, WeightageRow, WeightageTableProps };