@oracle/oraclejet-preact 14.0.0

package/cjs/hooks/PRIVATE_useDvtMeterEvents.js

@@ -0,0 +1,189 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks = require('preact/hooks');
+var hooks_UNSAFE_useUser = require('./UNSAFE_useUser.js');
+var hooks_UNSAFE_useTooltip = require('./UNSAFE_useTooltip.js');
+require('../UNSAFE_Environment.js');
+require('preact');
+require('preact/jsx-runtime');
+require('../UNSAFE_Layer.js');
+require('preact/compat');
+require('./UNSAFE_useId.js');
+require('../UNSAFE_Floating.js');
+require('../Floating-3eb600a1.js');
+require('../index-94b1ff28.js');
+require('../utils/PRIVATE_floatingUtils.js');
+require('../utils/PRIVATE_refUtils.js');
+require('./UNSAFE_useOutsideClick.js');
+require('../utils/UNSAFE_arrayUtils.js');
+require('./UNSAFE_useHover.js');
+require('./UNSAFE_useToggle.js');
+require('./UNSAFE_useFocus.js');
+require('./UNSAFE_useTouch.js');
+require('../utils/UNSAFE_mergeProps.js');
+require('../tslib.es6-d7adde1f.js');
+require('./UNSAFE_useAnimation.js');
+require('../useAnimation-9e794d84.js');
+
+require('../utils/UNSAFE_classNames.js');
+require('../classNames-825d80d7.js');
+
+const handleInput = (inputValue, currentInput, onInput) => {
+    onInput === null || onInput === void 0 ? void 0 : onInput({ value: inputValue });
+    currentInput.current = inputValue;
+};
+const cancelEvent = (event) => {
+    event.preventDefault();
+    event.stopPropagation();
+};
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function usePointerEvents(value, getValue, targetRef, onCommit, onInput) {
+    const currentInput = hooks.useRef();
+    const isPointerDown = hooks.useRef(false);
+    const pointerUpHandler = (event) => {
+        isPointerDown.current = false;
+        const val = getValue(event);
+        if (val !== undefined) {
+            onCommit === null || onCommit === void 0 ? void 0 : onCommit({ value: val });
+        }
+    };
+    const hoverHandler = (event) => {
+        if (isPointerDown.current) {
+            const val = getValue(event);
+            if (val !== undefined && val != currentInput.current) {
+                handleInput(val, currentInput, onInput);
+            }
+        }
+    };
+    const pointerDownHandler = (event) => {
+        var _a;
+        isPointerDown.current = true;
+        (_a = targetRef.current) === null || _a === void 0 ? void 0 : _a.setPointerCapture(event.pointerId);
+        const val = getValue(event);
+        if (val !== undefined && val != currentInput.current) {
+            handleInput(val, currentInput, onInput);
+        }
+    };
+    const blurHandler = () => {
+        isPointerDown.current = false;
+        onCommit === null || onCommit === void 0 ? void 0 : onCommit({ value: value });
+    };
+    return {
+        onPointerUp: pointerUpHandler,
+        onBlur: blurHandler,
+        onPointerMove: hoverHandler,
+        onPointerDown: pointerDownHandler
+    };
+}
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function useKeyboardEvents(value, min, max, step, onCommit, onInput) {
+    const currentInput = hooks.useRef();
+    const { direction } = hooks_UNSAFE_useUser.useUser();
+    const isRtl = direction === 'rtl';
+    const keyDownHandler = (event) => {
+        const key = event.key;
+        switch (key) {
+            case 'Tab':
+                return;
+            case 'ArrowDown':
+                handleInput(Math.max(min, value - step), currentInput, onInput);
+                break;
+            case 'ArrowUp':
+                handleInput(Math.min(max, value + step), currentInput, onInput);
+                break;
+            case 'ArrowLeft': {
+                const inputValue = isRtl ? Math.min(max, value + step) : Math.max(min, value - step);
+                handleInput(inputValue, currentInput, onInput);
+                break;
+            }
+            case 'ArrowRight': {
+                const inputValue = isRtl ? Math.max(min, value - step) : Math.min(max, value + step);
+                handleInput(inputValue, currentInput, onInput);
+                break;
+            }
+        }
+        cancelEvent(event);
+    };
+    const keyUpHandler = (event) => {
+        const key = event.key;
+        switch (key) {
+            case 'Enter':
+                onCommit === null || onCommit === void 0 ? void 0 : onCommit({ value: value });
+                break;
+            case 'Tab':
+                handleInput(value, currentInput, onInput);
+                break;
+            case 'Home':
+                handleInput(min, currentInput, onInput);
+                break;
+            case 'End':
+                handleInput(max, currentInput, onInput);
+                break;
+        }
+        cancelEvent(event);
+    };
+    return {
+        onKeyUp: keyUpHandler,
+        onKeyDown: keyDownHandler
+    };
+}
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function useMeterDatatip(value, datatip, ariaDescribedBy) {
+    const datatipText = datatip === null ? '' : datatip === undefined ? `${value}` : datatip;
+    const [isDatatipOpen, setDatatipOpen] = hooks.useState(false);
+    const { tooltipContent, tooltipProps } = hooks_UNSAFE_useTooltip.useTooltipControlled({
+        text: datatipText,
+        isOpen: isDatatipOpen,
+        position: 'top',
+        isDisabled: datatip === null,
+        anchor: { x: 'pointer', y: 'pointer' },
+        variant: 'datatip',
+        offset: {
+            mainAxis: 8,
+            crossAxis: 0
+        },
+        onToggle: ({ value }) => setDatatipOpen(value)
+    });
+    tooltipProps['aria-describedby'] = [ariaDescribedBy, tooltipProps['aria-describedby']]
+        .filter(Boolean)
+        .join(' ');
+    return { datatipContent: tooltipContent, datatipProps: tooltipProps };
+}
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+
+exports.useKeyboardEvents = useKeyboardEvents;
+exports.useMeterDatatip = useMeterDatatip;
+exports.usePointerEvents = usePointerEvents;
+/*  */
+//# sourceMappingURL=PRIVATE_useDvtMeterEvents.js.map

package/cjs/hooks/PRIVATE_useDvtMeterEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PRIVATE_useDvtMeterEvents.js","sources":["../../../src/hooks/PRIVATE_useDvtMeterEvents/events.ts","../../../src/hooks/PRIVATE_useDvtMeterEvents/usePointerEvents.ts","../../../src/hooks/PRIVATE_useDvtMeterEvents/useKeyboardEvents.ts","../../../src/hooks/PRIVATE_useDvtMeterEvents/useMeterDatatip.tsx","../../../src/hooks/PRIVATE_useDvtMeterEvents/index.ts"],"sourcesContent":["import type { MutableRef } from 'preact/hooks';\nimport { InputDetail } from '../../utils/UNSAFE_meterTypes';\n\nexport const handleInput = (\n  inputValue: number | undefined,\n  currentInput: MutableRef<number | undefined>,\n  onInput?: (detail: InputDetail) => void\n) => {\n  onInput?.({ value: inputValue } as InputDetail);\n  currentInput.current = inputValue;\n};\n\nexport const cancelEvent = (event: Event) => {\n  event.preventDefault();\n  event.stopPropagation();\n};\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { Ref, useRef } from 'preact/hooks';\nimport { handleInput } from './events';\nimport { CommitDetail, InputDetail } from '../../utils/UNSAFE_meterTypes';\n\ntype getValueFromEvent = (event: PointerEvent) => number | undefined;\n\nexport function usePointerEvents(\n  value: number | undefined,\n  getValue: getValueFromEvent,\n  targetRef: Ref<HTMLDivElement>,\n  onCommit?: (detail: CommitDetail) => void,\n  onInput?: (detail: InputDetail) => void\n) {\n  const currentInput = useRef<number>();\n  const isPointerDown = useRef<boolean>(false);\n\n  const pointerUpHandler = (event: PointerEvent) => {\n    isPointerDown.current = false;\n    const val = getValue(event);\n    if (val !== undefined) {\n      onCommit?.({ value: val } as CommitDetail);\n    }\n  };\n\n  const hoverHandler = (event: PointerEvent) => {\n    if (isPointerDown.current) {\n      const val = getValue(event);\n      if (val !== undefined && val != currentInput.current) {\n        handleInput(val, currentInput, onInput);\n      }\n    }\n  };\n\n  const pointerDownHandler = (event: PointerEvent) => {\n    isPointerDown.current = true;\n    targetRef.current?.setPointerCapture(event.pointerId);\n    const val = getValue(event);\n    if (val !== undefined && val != currentInput.current) {\n      handleInput(val, currentInput, onInput);\n    }\n  };\n\n  const blurHandler = () => {\n    isPointerDown.current = false;\n    onCommit?.({ value: value } as CommitDetail);\n  };\n\n  return {\n    onPointerUp: pointerUpHandler,\n    onBlur: blurHandler,\n    onPointerMove: hoverHandler,\n    onPointerDown: pointerDownHandler\n  };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { useRef } from 'preact/hooks';\nimport { useUser } from '../UNSAFE_useUser';\nimport { handleInput, cancelEvent } from './events';\nimport { CommitDetail, InputDetail } from '../../utils/UNSAFE_meterTypes';\n\nexport function useKeyboardEvents(\n  value: number,\n  min: number,\n  max: number,\n  step: number,\n  onCommit?: (detail: CommitDetail) => void,\n  onInput?: (detail: InputDetail) => void\n) {\n  const currentInput = useRef<number>();\n  const { direction } = useUser();\n\n  const isRtl = direction === 'rtl';\n\n  const keyDownHandler = (event: KeyboardEvent) => {\n    const key = event.key;\n\n    switch (key) {\n      case 'Tab':\n        return;\n      case 'ArrowDown':\n        handleInput(Math.max(min, value - step), currentInput, onInput);\n        break;\n      case 'ArrowUp':\n        handleInput(Math.min(max, value + step), currentInput, onInput);\n        break;\n      case 'ArrowLeft': {\n        const inputValue = isRtl ? Math.min(max, value + step) : Math.max(min, value - step);\n        handleInput(inputValue, currentInput, onInput);\n        break;\n      }\n      case 'ArrowRight': {\n        const inputValue = isRtl ? Math.max(min, value - step) : Math.min(max, value + step);\n        handleInput(inputValue, currentInput, onInput);\n        break;\n      }\n    }\n    cancelEvent(event);\n  };\n\n  const keyUpHandler = (event: KeyboardEvent) => {\n    const key = event.key;\n\n    switch (key) {\n      case 'Enter':\n        onCommit?.({ value: value } as CommitDetail);\n        break;\n      case 'Tab':\n        handleInput(value, currentInput, onInput);\n        break;\n      case 'Home':\n        handleInput(min, currentInput, onInput);\n        break;\n      case 'End':\n        handleInput(max, currentInput, onInput);\n        break;\n    }\n    cancelEvent(event);\n  };\n\n  return {\n    onKeyUp: keyUpHandler,\n    onKeyDown: keyDownHandler\n  };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { useState } from 'preact/hooks';\nimport { useTooltipControlled } from '../UNSAFE_useTooltip';\n\nexport function useMeterDatatip(value: number, datatip?: string | null, ariaDescribedBy?: string) {\n  const datatipText = datatip === null ? '' : datatip === undefined ? `${value}` : datatip;\n  const [isDatatipOpen, setDatatipOpen] = useState<boolean>(false);\n  const { tooltipContent, tooltipProps } = useTooltipControlled({\n    text: datatipText,\n    isOpen: isDatatipOpen,\n    position: 'top',\n    isDisabled: datatip === null,\n    anchor: { x: 'pointer', y: 'pointer' },\n    variant: 'datatip',\n    offset: {\n      mainAxis: 8,\n      crossAxis: 0\n    },\n    onToggle: ({ value }) => setDatatipOpen(value)\n  });\n\n  tooltipProps['aria-describedby'] = [ariaDescribedBy, tooltipProps['aria-describedby']]\n    .filter(Boolean)\n    .join(' ');\n\n  return { datatipContent: tooltipContent, datatipProps: tooltipProps };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nexport { usePointerEvents } from './usePointerEvents';\nexport { useKeyboardEvents } from './useKeyboardEvents';\nexport { useMeterDatatip } from './useMeterDatatip';\n"],"names":["useRef","useUser","useState","useTooltipControlled"],"mappings":"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"}

package/cjs/hooks/PRIVATE_useItemAction.js

@@ -0,0 +1,65 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks = require('preact/hooks');
+var utils_PRIVATE_collectionUtils = require('../utils/PRIVATE_collectionUtils.js');
+require('../utils/UNSAFE_keys.js');
+
+const useItemAction = (currentKey, dataState, onItemAction, itemSelector) => {
+    if (!dataState || !onItemAction) {
+        return {};
+    }
+    return {
+        onClick: hooks.useCallback((event) => {
+            const key = utils_PRIVATE_collectionUtils.keyExtractor(event.target, itemSelector);
+            if (handleItemAction(key, dataState, 'click', onItemAction)) {
+                event.stopPropagation();
+            }
+        }, [dataState, onItemAction]),
+        onKeyDown: hooks.useCallback((event) => {
+            if (event.key === 'Enter') {
+                handleItemAction(currentKey, dataState, 'enter', onItemAction);
+            }
+            else if (event.key === ' ') {
+                handleItemAction(currentKey, dataState, 'spacebar', onItemAction);
+                event.preventDefault();
+            }
+        }, [dataState, onItemAction, currentKey])
+    };
+};
+const handleItemAction = (key, dataState, reason, onItemAction) => {
+    if (key !== undefined) {
+        const context = findItemContext(key, dataState);
+        context && onItemAction({ context, reason });
+        return context !== undefined;
+    }
+    return false;
+};
+// returns a ListItemContext based on key
+const findItemContext = (key, dataState) => {
+    var _a, _b;
+    const index = (_b = (_a = dataState === null || dataState === void 0 ? void 0 : dataState.data) === null || _a === void 0 ? void 0 : _a.findIndex((d) => d.metadata.key === key)) !== null && _b !== void 0 ? _b : -1;
+    if (index > -1) {
+        const context = {
+            index: index + ((dataState === null || dataState === void 0 ? void 0 : dataState.offset) || 0),
+            data: dataState === null || dataState === void 0 ? void 0 : dataState.data[index].data,
+            metadata: dataState === null || dataState === void 0 ? void 0 : dataState.data[index].metadata
+        };
+        return context;
+    }
+    return undefined;
+};
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+
+exports.useItemAction = useItemAction;
+/*  */
+//# sourceMappingURL=PRIVATE_useItemAction.js.map

package/cjs/hooks/PRIVATE_useItemAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PRIVATE_useItemAction.js","sources":["../../../src/hooks/PRIVATE_useItemAction/useItemAction.tsx","../../../src/hooks/PRIVATE_useItemAction/index.ts"],"sourcesContent":["import { useCallback } from 'preact/hooks';\nimport { DataState, ItemActionDetail, ListItemContext, Metadata } from '../../UNSAFE_Collection';\n\nimport { keyExtractor } from '../../utils/PRIVATE_collectionUtils';\n\nexport const useItemAction = <K extends string | number, D>(\n  currentKey: K | undefined,\n  dataState: DataState<K, D> | null,\n  onItemAction: ((detail: ItemActionDetail<K, D>) => void) | undefined,\n  itemSelector: string\n) => {\n  if (!dataState || !onItemAction) {\n    return {};\n  }\n\n  return {\n    onClick: useCallback(\n      (event: MouseEvent) => {\n        const key = keyExtractor(event.target as HTMLElement, itemSelector) as K;\n        if (handleItemAction(key, dataState, 'click', onItemAction)) {\n          event.stopPropagation();\n        }\n      },\n      [dataState, onItemAction]\n    ),\n    onKeyDown: useCallback(\n      (event: KeyboardEvent) => {\n        if (event.key === 'Enter') {\n          handleItemAction(currentKey, dataState, 'enter', onItemAction);\n        } else if (event.key === ' ') {\n          handleItemAction(currentKey, dataState, 'spacebar', onItemAction);\n          event.preventDefault();\n        }\n      },\n      [dataState, onItemAction, currentKey]\n    )\n  };\n};\n\nconst handleItemAction = <K, D>(\n  key: K | undefined,\n  dataState: DataState<K, D>,\n  reason: ItemActionDetail<K, D>['reason'],\n  onItemAction: (detail: ItemActionDetail<K, D>) => void\n) => {\n  if (key !== undefined) {\n    const context = findItemContext(key, dataState);\n    context && onItemAction({ context, reason });\n    return context !== undefined;\n  }\n  return false;\n};\n\n// returns a ListItemContext based on key\nconst findItemContext = <K, D>(\n  key: K,\n  dataState: DataState<K, D>\n): ListItemContext<K, D> | undefined => {\n  const index = dataState?.data?.findIndex((d) => d.metadata.key === key) ?? -1;\n  if (index > -1) {\n    const context: ListItemContext<K, D> = {\n      index: index + (dataState?.offset || 0),\n      data: dataState?.data[index].data as D,\n      metadata: dataState?.data[index].metadata as Metadata<K>\n    };\n    return context;\n  }\n  return undefined;\n};\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\nexport { useItemAction } from './useItemAction';\n"],"names":["useCallback","keyExtractor"],"mappings":"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"}

package/cjs/hooks/PRIVATE_useMessagesFocusManager.js

@@ -0,0 +1,352 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks = require('preact/hooks');
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+const componentsMap = new Map();
+const componentsOrder = [];
+const priorFocusCache = new Map();
+let hasDocumentListener = false;
+let priorFocusedElement;
+let currentFocusedMessage;
+/**
+ * Handles KeyDown event in the document element during the capture phase.
+ *
+ * @param event The keydown event object
+ */
+function handleDocumentKeyDownCapture(event) {
+    // Do nothing if any of the following is true:
+    // 1. No components are registered
+    // 2. Pressed key is not F6
+    // 3. Event is defaultPrevented
+    if (componentsMap.size === 0 || event.key !== 'F6' || event.defaultPrevented) {
+        return;
+    }
+    // Try cycling focus through the messages and if that fails
+    // set the focus to the prior focused element.
+    if (!cycleFocusThroughMessages(event)) {
+        currentFocusedMessage && togglePreviousFocus(currentFocusedMessage, event);
+    }
+}
+/**
+ * Handles the blur event captured on the document
+ * @param event Blur event object
+ */
+function handleDocumentBlurCapture(event) {
+    priorFocusedElement = event.target;
+}
+/**
+ * Handles the keyup event in the component
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param event The keyup event object
+ */
+function handleComponentKeyUp(id, event) {
+    // Ignore the call if the comp is not registered anymore or event default is prevented
+    if (!componentsMap.has(id) || event.defaultPrevented) {
+        return;
+    }
+    // Additional checks for keyup event and recognized keys
+    if (event.type === 'keyup' && ['Escape'].includes(event.key)) {
+        // toggle focus to the previously focused element
+        togglePreviousFocus(id, event);
+    }
+}
+/**
+ * Handles the focus event in the component
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param event The focus event object
+ */
+function handleComponentFocus(id, event) {
+    var _a;
+    // Ignore the call if the comp is not registered anymore or event default is prevented
+    if (!componentsMap.has(id) || event.defaultPrevented) {
+        return;
+    }
+    // Store the id of the current focused message
+    currentFocusedMessage = id;
+    // Track previous focus if the priorFocused element is not a part of this or any other
+    // registered component
+    const { callbacks } = componentsMap.get(id);
+    if (priorFocusedElement && !isPartOfRegisteredMessages(priorFocusedElement)) {
+        priorFocusCache.set(id, priorFocusedElement);
+        // since the focus moved to this component from outside, call the
+        // onFocus callbacks if available
+        (_a = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onFocus) === null || _a === void 0 ? void 0 : _a.call(callbacks);
+    }
+}
+/**
+ * Handles the blur event in the component
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param event The focus event object
+ */
+function handleComponentBlur(id, event) {
+    // Ignore the call if the comp is not registered anymore or event default is prevented
+    if (!componentsMap.has(id) || event.defaultPrevented) {
+        return;
+    }
+    // reset the current focus message ID
+    currentFocusedMessage = undefined;
+}
+/**
+ * Cycles the focus through the registered messages component from the previous message of current focused
+ * message to the top of the hierarchy.
+ *
+ * @param event The event that initiated this action
+ * @returns boolean indicating the result of this action
+ */
+function cycleFocusThroughMessages(event) {
+    var _a, _b, _c, _d, _e;
+    // At this point, we need to focus the previous message from the current focused
+    // message
+    const nextPosition = indexOfOrDefaultTo(componentsOrder, currentFocusedMessage, componentsOrder.length) - 1;
+    for (let i = nextPosition; i > -1; i--) {
+        const id = componentsOrder[i];
+        const { ref } = (_a = componentsMap.get(id)) !== null && _a !== void 0 ? _a : {};
+        if ((_c = (_b = ref === null || ref === void 0 ? void 0 : ref.current) === null || _b === void 0 ? void 0 : _b.focus) === null || _c === void 0 ? void 0 : _c.call(_b)) {
+            // prevent default action as the event has transferred focus
+            event.preventDefault();
+            // invoke callback to let the current component know the focus is left
+            if (currentFocusedMessage) {
+                const { callbacks } = (_d = componentsMap.get(currentFocusedMessage)) !== null && _d !== void 0 ? _d : {};
+                (_e = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onFocusLeave) === null || _e === void 0 ? void 0 : _e.call(callbacks);
+            }
+            // Focus is set, so break the loop
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Checks if the provided element is a part of any of the registered messages
+ *
+ * @param element The candidate element
+ * @returns true if is inside any of the registered messages
+ */
+function isPartOfRegisteredMessages(element) {
+    var _a;
+    for (const { ref } of componentsMap.values()) {
+        if ((_a = ref.current) === null || _a === void 0 ? void 0 : _a.contains(element)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Finds the index of the item in the array, if it does not exist returns the
+ * default value instead
+ *
+ * @param arr The array to perform the search
+ * @param search The item to be searched
+ * @param defaultIndex The default value if the item is not found
+ * @returns The index of the item or the default value
+ */
+function indexOfOrDefaultTo(arr, search, defaultIndex = -1) {
+    const index = arr.indexOf(search);
+    if (index !== -1)
+        return index;
+    return defaultIndex;
+}
+/**
+ * Traverses through the priorFocusCache to fetch the last focused
+ * element outside of the messages region.
+ *
+ * @param id The current focused message's ID
+ * @returns The closest prior focused element, null if not found
+ */
+function getClosestPriorFocusedElement(id) {
+    // F6 navigation cycles through messages in reverse order
+    // so to get the closest prior focused element we need to
+    // traverse in natural order from the current message
+    const index = componentsOrder.indexOf(id);
+    for (let i = index; i < componentsOrder.length; i++) {
+        if (priorFocusCache.has(componentsOrder[i])) {
+            return priorFocusCache.get(componentsOrder[i]);
+        }
+    }
+    // No prior cache found, so return null
+    return null;
+}
+/**
+ * Adds the component to the internal members.
+ *
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param ref A ref handle to the focusable component
+ * @param callbacks Optional callbacks
+ */
+function addComponent(id, options) {
+    componentsMap.set(id, options);
+    componentsOrder.push(id);
+}
+/**
+ * Removes the component from the internal members
+ *
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ */
+function removeComponent(id) {
+    if (!componentsMap.has(id)) {
+        return;
+    }
+    componentsMap.delete(id);
+    componentsOrder.splice(componentsOrder.indexOf(id), 1);
+}
+/**
+ * Clears the priorFocusCache of the specified component
+ *
+ * @param id The id of the component whose cache is to be cleared
+ */
+function clearFocusCache(id) {
+    priorFocusCache.delete(id);
+}
+/**
+ * Adds event listeners to the document element
+ */
+function addDocumentListeners() {
+    // Add the events in capture phase, as we do not want this to be stopped by the elements
+    // in the DOM tree.
+    // make sure to use keydown as we need to prevent the default behavior which is moving to
+    // the address bar in some browsers & OS.
+    document.documentElement.addEventListener('keydown', handleDocumentKeyDownCapture, true);
+    document.documentElement.addEventListener('blur', handleDocumentBlurCapture, true);
+    hasDocumentListener = true;
+}
+/**
+ * Removes event listeners from the document element
+ */
+function removeDocumentListeners() {
+    document.documentElement.removeEventListener('keydown', handleDocumentKeyDownCapture, true);
+    document.documentElement.removeEventListener('blur', handleDocumentBlurCapture, true);
+    hasDocumentListener = false;
+}
+/**
+ * Registers a component for its focus to be managed.
+ *
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param componentOptions An object containing component options
+ * @param focusManagerOptions An object containing focus manager options
+ *
+ * @returns An object containing focus event listeners
+ */
+function register(id, componentOptions, focusManagerOptions = { handleEscapeKey: true }) {
+    if (!hasDocumentListener) {
+        addDocumentListeners();
+    }
+    addComponent(id, componentOptions);
+    const handlers = {
+        onfocusin: (event) => handleComponentFocus(id, event),
+        onfocusout: (event) => handleComponentBlur(id, event)
+    };
+    if (focusManagerOptions.handleEscapeKey) {
+        handlers['onKeyUp'] = (event) => handleComponentKeyUp(id, event);
+    }
+    return handlers;
+}
+/**
+ * Focuses the element which was focused prior to the passed component.
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ * @param event The event that initiated the focus transfer. The event will be default prevented if the focus
+ *              is transferred successfully.
+ * @returns true, if focus is restored. false otherwise.
+ */
+function togglePreviousFocus(id, event) {
+    var _a, _b;
+    const target = getClosestPriorFocusedElement(id);
+    const { callbacks } = (_a = componentsMap.get(id)) !== null && _a !== void 0 ? _a : {};
+    if (target && document.body.contains(target)) {
+        target.focus();
+        // invoke callback to let the component know the focus is left
+        (_b = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onFocusLeave) === null || _b === void 0 ? void 0 : _b.call(callbacks);
+        // As the prior focus is restored, empty the focus cache
+        priorFocusCache.clear();
+        event === null || event === void 0 ? void 0 : event.preventDefault();
+        return true;
+    }
+    // Prior focused element does not exist or
+    // Element does not exist in DOM.
+    return false;
+}
+/**
+ * Unregisters a component from focus management
+ *
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ */
+function unregister(id) {
+    removeComponent(id);
+    clearFocusCache(id);
+    if (hasDocumentListener && componentsMap.size === 0) {
+        // no component is registered, so remove the document listeners
+        removeDocumentListeners();
+    }
+}
+/**
+ * Moves the priority of the component with the specified id
+ *
+ * @param id A unique symbol that ids the component to be registered for managing focus
+ */
+function prioritize(id) {
+    if (!componentsMap.has(id)) {
+        // Do nothing if the component is not registered
+        return;
+    }
+    // Remove and add the component with the same ref
+    // to move it in the priority queue
+    const options = componentsMap.get(id);
+    removeComponent(id);
+    addComponent(id, options);
+}
+/**
+ * The focus manager object
+ */
+const messagesFocusManager = {
+    prioritize,
+    register,
+    togglePreviousFocus,
+    unregister
+};
+/**
+ * A custom hook that handles focus management for the messages component.
+ * @param ref The custom ref handle for the component
+ * @param callbacks Optional callbacks
+ * @returns The handlers and a controller
+ */
+function useMessageFocusManager(ref, callbacks, options) {
+    const id = hooks.useRef(Symbol());
+    const focusManager = hooks.useRef(messagesFocusManager);
+    const [handlers, setHandlers] = hooks.useState({});
+    const controller = hooks.useMemo(() => ({
+        prioritize: () => focusManager.current.prioritize(id.current),
+        restorePriorFocus: () => focusManager.current.togglePreviousFocus(id.current)
+    }), []);
+    // Register handlers for focus management
+    hooks.useEffect(() => {
+        const currentFocusManager = focusManager.current;
+        const currentId = id.current;
+        setHandlers(currentFocusManager.register(currentId, { ref, callbacks }, options));
+        return () => currentFocusManager.unregister(currentId);
+        // eslint-disable-next-line
+    }, []); // we only want this to run on mount
+    return {
+        handlers,
+        controller
+    };
+}
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+
+exports.useMessageFocusManager = useMessageFocusManager;
+/*  */
+//# sourceMappingURL=PRIVATE_useMessagesFocusManager.js.map