@oracle/oraclejet-preact 14.0.5 → 14.0.7

package/amd/hooks/PRIVATE_useMessagesFocusManager.js

@@ -1,2 +1,352 @@
-define(["exports","preact/hooks"],function(e,n){"use strict";const t=new Map,o=[],u=new Map;let r,c,l=!1;function i(e){0===t.size||"F6"!==e.key||e.defaultPrevented||function(e){var n,u,r,l,i;for(let s=function(e,n,t=-1){const o=e.indexOf(n);return-1!==o?o:t}(o,c,o.length)-1;s>-1;s--){const d=o[s],{ref:a}=null!==(n=t.get(d))&&void 0!==n?n:{};if(null===(r=null===(u=null==a?void 0:a.current)||void 0===u?void 0:u.focus)||void 0===r?void 0:r.call(u)){if(e.preventDefault(),c){const{callbacks:e}=null!==(l=t.get(c))&&void 0!==l?l:{};null===(i=null==e?void 0:e.onFocusLeave)||void 0===i||i.call(e)}return!0}}return!1}(e)||c&&v(c,e)}function s(e){r=e.target}function d(e,n){var o;if(!t.has(e)||n.defaultPrevented)return;c=e;const{callbacks:l}=t.get(e);r&&!function(e){var n;for(const{ref:o}of t.values())if(null===(n=o.current)||void 0===n?void 0:n.contains(e))return!0;return!1}(r)&&(u.set(e,r),null===(o=null==l?void 0:l.onFocus)||void 0===o||o.call(l))}function a(e,n){t.set(e,n),o.push(e)}function f(e){t.has(e)&&(t.delete(e),o.splice(o.indexOf(e),1))}function v(e,n){var r,c;const l=function(e){for(let n=o.indexOf(e);n<o.length;n++)if(u.has(o[n]))return u.get(o[n]);return null}(e),{callbacks:i}=null!==(r=t.get(e))&&void 0!==r?r:{};return!(!l||!document.body.contains(l))&&(l.focus(),null===(c=null==i?void 0:i.onFocusLeave)||void 0===c||c.call(i),u.clear(),null==n||n.preventDefault(),!0)}const g={prioritize:function(e){if(!t.has(e))return;const n=t.get(e);f(e),a(e,n)},register:function(e,n,o={handleEscapeKey:!0}){l||(document.documentElement.addEventListener("keydown",i,!0),document.documentElement.addEventListener("blur",s,!0),l=!0),a(e,n);const u={onfocusin:n=>d(e,n),onfocusout:n=>function(e,n){t.has(e)&&!n.defaultPrevented&&(c=void 0)}(e,n)};return o.handleEscapeKey&&(u.onKeyUp=n=>function(e,n){t.has(e)&&!n.defaultPrevented&&"keyup"===n.type&&["Escape"].includes(n.key)&&v(e,n)}(e,n)),u},togglePreviousFocus:v,unregister:function(e){f(e),function(e){u.delete(e)}(e),l&&0===t.size&&(document.documentElement.removeEventListener("keydown",i,!0),document.documentElement.removeEventListener("blur",s,!0),l=!1)}};e.useMessageFocusManager=function(e,t,o){const u=n.useRef(Symbol()),r=n.useRef(g),[c,l]=n.useState({}),i=n.useMemo(()=>({prioritize:()=>r.current.prioritize(u.current),restorePriorFocus:()=>r.current.togglePreviousFocus(u.current)}),[]);return n.useEffect(()=>{const n=r.current,c=u.current;return l(n.register(c,{ref:e,callbacks:t},o)),()=>n.unregister(c)},[]),{handlers:c,controller:i}},Object.defineProperty(e,"__esModule",{value:!0})});
+/* @oracle/oraclejet-preact: 14.0.7 */
+define(['exports', 'preact/hooks'], (function (exports, hooks) { 'use strict';
+
+    /**
+     * @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;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+/*  */
 //# sourceMappingURL=PRIVATE_useMessagesFocusManager.js.map

package/amd/hooks/PRIVATE_useMessagesFocusManager.js.map

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

package/amd/hooks/PRIVATE_useSelection.js

@@ -1,2 +1,174 @@
-define(["exports","preact/hooks","../utils/UNSAFE_arrayUtils","../utils/UNSAFE_keys"],function(e,t,r,n){"use strict";r.stringLiteralArray(["toggle","replace"]);const l=(e,t,r,l,o,s,i,a,y,u)=>{const c=t(e.target);if(null==c)return;if(e.shiftKey&&void 0!==a&&u&&((e,t,r,l)=>"multiple"===r&&"toggle"!==l&&n.containsKey(t,e))(a,r,l,o))return u({value:{start:a,end:c}}),void(i&&(i.current=c));let k=r;n.containsKey(r,c)?"Enter"!==e.key&&("toggle"===o||e.ctrlKey||e.metaKey||" "===e.key?k=n.removeKey(r,c,s):"multiple"===l&&(r.all||r.keys.size>1)&&(k={all:!1,keys:new Set([c])})):k="single"===l||"Enter"===e.key||"replace"===o&&!e.ctrlKey&&!e.metaKey?{all:!1,keys:new Set([c])}:n.addKey(r,c),r!=k&&y&&(y({value:k,target:e.target}),"click"===e.type&&e.stopPropagation())};e.useSelection=function(e,r,o,s,i,a,y,u,c,k,K){const f=t.useRef(),d=t.useCallback(t=>{l(t,e,r,o,i,s,f,y,a,K),t.shiftKey||(f.current=void 0)},[e,r,o,i,s,f,y,a,K]),g=t.useCallback(t=>{" "!==t.key&&"Enter"!==t.key||l(t,e,r,o,i,s,f,y,a,t.shiftKey&&" "===t.key?K:void 0)},[e,r,o,i,s,y,a,K]),p=t.useCallback(e=>{if(" "!==e.key){if("ArrowDown"===e.key||"ArrowUp"===e.key)if(e.shiftKey&&c&&k){let t=r;!f.current&&n.isKeyDefined(u)&&(t={all:!1,keys:new Set([u])});const l=c(f.current||u,"ArrowDown"!==e.key)();null!=l&&(n.containsKey(t,l)?null!=f.current&&f.current!==l&&(t=n.removeKey(t,f.current,s)):t=n.addKey(t,l),f.current=l,k(l)),r!=t&&a&&a({value:t,target:e.target})}else f.current=void 0}else e.preventDefault()},[r,s,a,u,c,k]);return{selectionProps:"none"===o||null==a?{}:{onClick:d,onKeyDown:p,onKeyUp:g}}},Object.defineProperty(e,"__esModule",{value:!0})});
+/* @oracle/oraclejet-preact: 14.0.7 */
+define(['exports', 'preact/hooks', '../utils/UNSAFE_arrayUtils', '../utils/UNSAFE_keys'], (function (exports, hooks, utils_UNSAFE_arrayUtils, utils_UNSAFE_keys) { 'use strict';
+
+    /**
+     * Type for selection behavior.  See useMultipleSelection hook for details.
+     */
+    const behaviors = utils_UNSAFE_arrayUtils.stringLiteralArray(['toggle', 'replace']);
+    const isShiftModeSupported = (anchorKey, selectedKeys, selectionMode, selectionBehavior) => {
+        return (selectionMode === 'multiple' &&
+            selectionBehavior !== 'toggle' &&
+            utils_UNSAFE_keys.containsKey(selectedKeys, anchorKey));
+    };
+    const handleSelect = (event, keyExtractor, selectedKeys, selectionMode, selectionBehavior, isSelectionRequired, keyboardCursorRef, anchorKey, onChange, onRangeChange) => {
+        const itemKey = keyExtractor(event.target);
+        if (itemKey == null) {
+            return;
+        }
+        // handle shift key selection
+        if (event.shiftKey &&
+            anchorKey !== undefined &&
+            onRangeChange &&
+            isShiftModeSupported(anchorKey, selectedKeys, selectionMode, selectionBehavior)) {
+            onRangeChange({ value: { start: anchorKey, end: itemKey } });
+            // set keyboard selection cursor in case user extends with SHIFT+ARROW
+            if (keyboardCursorRef) {
+                keyboardCursorRef.current = itemKey;
+            }
+            return;
+        }
+        const selected = utils_UNSAFE_keys.containsKey(selectedKeys, itemKey);
+        let keySet = selectedKeys;
+        if (!selected) {
+            if (selectionMode === 'single' ||
+                event.key === 'Enter' ||
+                (selectionBehavior === 'replace' && !(event.ctrlKey || event.metaKey))) {
+                // should only contains this item key
+                keySet = { all: false, keys: new Set([itemKey]) };
+            }
+            else {
+                // add to existing selected keys
+                keySet = utils_UNSAFE_keys.addKey(selectedKeys, itemKey);
+            }
+        }
+        else if (event.key !== 'Enter') {
+            // no de-select for enter key
+            if (selectionBehavior === 'toggle' ||
+                event.ctrlKey ||
+                event.metaKey ||
+                event.key === ' ') {
+                // de-select only when ctrl/meta key is pressed or selectionBehavior is
+                // explicitly set to toggle
+                keySet = utils_UNSAFE_keys.removeKey(selectedKeys, itemKey, isSelectionRequired);
+            }
+            else if (selectionMode === 'multiple' && (selectedKeys.all || selectedKeys.keys.size > 1)) {
+                // in this case everything should be de-selected except for this key
+                keySet = { all: false, keys: new Set([itemKey]) };
+            }
+        }
+        // only invoke callback if there is really a change
+        // note onSelectionChange should never be null here
+        if (selectedKeys != keySet && onChange) {
+            onChange({ value: keySet, target: event.target });
+            if (event.type === 'click') {
+                event.stopPropagation();
+            }
+        }
+    };
+    /**
+     * Hook for handling various selection mode.  This can be reuse by all Collection components.
+     * @param keyExtractor function to extract the key based on provided element
+     * @param selectedKeys the currently selected keys
+     * @param selectionMode the selection mode
+     * @param selectionBehavior the selection behavior.  If the value is 'toggle', then the key is
+     *                          added/removed from the current selected keys.  If the value is 'replace',
+     *                          then the current selected keys are cleared first before the key is added
+     *                          unless the ctrl/shift/meta key is pressed.
+     * @param onSelectionChange callback function that is invoked when selection has changed.
+     * @returns an event map that the consumer can register as event listeners
+     */
+    function useSelection(keyExtractor, selectedKeys, selectionMode, isSelectionRequired, selectionBehavior, onChange, anchorKey, currentKey, getPrevNextKey, scrollToKey, onRangeChange) {
+        // ref to track the cursor for the SHIFT+ARROW keyboard selection separately than the anchor of the selection.
+        const keyboardSelectionCursor = hooks.useRef();
+        const onClick = hooks.useCallback((event) => {
+            handleSelect(event, keyExtractor, selectedKeys, selectionMode, selectionBehavior, isSelectionRequired, keyboardSelectionCursor, anchorKey, onChange, onRangeChange);
+            if (!event.shiftKey) {
+                // reset keyboard cursor when using mouse to select
+                keyboardSelectionCursor.current = undefined;
+            }
+        }, [
+            keyExtractor,
+            selectedKeys,
+            selectionMode,
+            selectionBehavior,
+            isSelectionRequired,
+            keyboardSelectionCursor,
+            anchorKey,
+            onChange,
+            onRangeChange
+        ]);
+        // general keyboard events listen to keyUp for a11y
+        const onKeyUp = hooks.useCallback((event) => {
+            // older browser that we don't support returns 'Spacebar' for space key
+            if (event.key === ' ' || event.key === 'Enter') {
+                handleSelect(event, keyExtractor, selectedKeys, selectionMode, selectionBehavior, isSelectionRequired, keyboardSelectionCursor, anchorKey, onChange, event.shiftKey && event.key === ' ' ? onRangeChange : undefined);
+            }
+        }, [
+            keyExtractor,
+            selectedKeys,
+            selectionMode,
+            selectionBehavior,
+            isSelectionRequired,
+            anchorKey,
+            onChange,
+            onRangeChange
+        ]);
+        // arrowKey events listen to keyDown so they can support holding them down
+        const onKeyDown = hooks.useCallback((event) => {
+            // prevent default (propagation) for keyDown to space bar causing container to scroll
+            if (event.key === ' ') {
+                event.preventDefault();
+                return;
+            }
+            if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+                if (event.shiftKey && getPrevNextKey && scrollToKey) {
+                    let keySet = selectedKeys;
+                    // on first selection event, set keyboard cursor to start at currentKey
+                    if (!keyboardSelectionCursor.current && utils_UNSAFE_keys.isKeyDefined(currentKey)) {
+                        keySet = { all: false, keys: new Set([currentKey]) };
+                    }
+                    const newAnchorKey = getPrevNextKey(keyboardSelectionCursor.current || currentKey, event.key === 'ArrowDown' ? false : true);
+                    const cursorKey = newAnchorKey();
+                    if (cursorKey != null) {
+                        // extend selection
+                        if (!utils_UNSAFE_keys.containsKey(keySet, cursorKey)) {
+                            keySet = utils_UNSAFE_keys.addKey(keySet, cursorKey);
+                            // subtract from selection
+                        }
+                        else if (keyboardSelectionCursor.current != null &&
+                            keyboardSelectionCursor.current !== cursorKey) {
+                            keySet = utils_UNSAFE_keys.removeKey(keySet, keyboardSelectionCursor.current, isSelectionRequired);
+                        }
+                        keyboardSelectionCursor.current = cursorKey;
+                        // keep visible
+                        scrollToKey(cursorKey);
+                    }
+                    if (selectedKeys != keySet && onChange) {
+                        onChange({ value: keySet, target: event.target });
+                    }
+                }
+                else {
+                    // reset keyBoard on non-shifted arrow use as this interrupts the extend mode (and would make for messy logic that doesn't align with current Jet behavior)
+                    keyboardSelectionCursor.current = undefined;
+                }
+            }
+        }, [selectedKeys, isSelectionRequired, onChange, currentKey, getPrevNextKey, scrollToKey]);
+        const selectionProps = selectionMode === 'none' || onChange == null ? {} : { onClick, onKeyDown, onKeyUp };
+        return { selectionProps };
+    }
+
+    /**
+     * @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.useSelection = useSelection;
+
+    Object.defineProperty(exports, '__esModule', { value: true });
+
+}));
+/*  */
 //# sourceMappingURL=PRIVATE_useSelection.js.map