@oracle/oraclejet-preact 14.0.0

package/cjs/hooks/PRIVATE_useMessagesFocusManager.js.map

@@ -0,0 +1 @@
+{"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/cjs/hooks/PRIVATE_useSelection.js

@@ -0,0 +1,176 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks = require('preact/hooks');
+var utils_UNSAFE_arrayUtils = require('../utils/UNSAFE_arrayUtils.js');
+var utils_UNSAFE_keys = require('../utils/UNSAFE_keys.js');
+
+/**
+ * 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;
+/*  */
+//# sourceMappingURL=PRIVATE_useSelection.js.map

package/cjs/hooks/PRIVATE_useSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PRIVATE_useSelection.js","sources":["../../../src/hooks/PRIVATE_useSelection/useSelection.ts","../../../src/hooks/PRIVATE_useSelection/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 */\nimport { RefObject } from 'preact';\nimport { useCallback, useRef } from 'preact/hooks';\nimport { stringLiteralArray } from '../../utils/UNSAFE_arrayUtils';\nimport { Keys, containsKey, isKeyDefined, addKey, removeKey } from '../../utils/UNSAFE_keys';\nimport { SelectionDetail, SelectionMode } from '../../UNSAFE_Collection';\n\n/**\n * Type for selection behavior.  See useMultipleSelection hook for details.\n */\nexport const behaviors = stringLiteralArray(['toggle', 'replace']);\nexport type SelectionBehavior = typeof behaviors[number];\n\n/**\n * Type for payload of selection range change event handler\n */\nexport type SelectionRangeDetail<K> = {\n  value: { start: K; end: K };\n};\n\nconst isShiftModeSupported = <K>(\n  anchorKey: K,\n  selectedKeys: Keys<K>,\n  selectionMode: SelectionMode,\n  selectionBehavior: SelectionBehavior\n) => {\n  return (\n    selectionMode === 'multiple' &&\n    selectionBehavior !== 'toggle' &&\n    containsKey(selectedKeys, anchorKey)\n  );\n};\n\nconst handleSelect = <K>(\n  event: MouseEvent | KeyboardEvent,\n  keyExtractor: (element: HTMLElement) => K | null,\n  selectedKeys: Keys<K>,\n  selectionMode: SelectionMode,\n  selectionBehavior: SelectionBehavior,\n  isSelectionRequired: boolean,\n  keyboardCursorRef: RefObject<K | undefined>,\n  anchorKey?: K,\n  onChange?: (detail: SelectionDetail<K>) => void,\n  onRangeChange?: (detail: SelectionRangeDetail<K>) => void\n) => {\n  const itemKey = keyExtractor(event.target as HTMLElement);\n  if (itemKey == null) {\n    return;\n  }\n\n  // handle shift key selection\n  if (\n    event.shiftKey &&\n    anchorKey !== undefined &&\n    onRangeChange &&\n    isShiftModeSupported(anchorKey, selectedKeys, selectionMode, selectionBehavior)\n  ) {\n    onRangeChange({ value: { start: anchorKey, end: itemKey } });\n    // set keyboard selection cursor in case user extends with SHIFT+ARROW\n    if (keyboardCursorRef) {\n      keyboardCursorRef.current = itemKey;\n    }\n    return;\n  }\n\n  const selected = containsKey(selectedKeys, itemKey);\n  let keySet = selectedKeys;\n  if (!selected) {\n    if (\n      selectionMode === 'single' ||\n      (event as KeyboardEvent).key === 'Enter' ||\n      (selectionBehavior === 'replace' && !(event.ctrlKey || event.metaKey))\n    ) {\n      // should only contains this item key\n      keySet = { all: false, keys: new Set([itemKey]) };\n    } else {\n      // add to existing selected keys\n      keySet = addKey(selectedKeys, itemKey);\n    }\n  } else if ((event as KeyboardEvent).key !== 'Enter') {\n    // no de-select for enter key\n    if (\n      selectionBehavior === 'toggle' ||\n      event.ctrlKey ||\n      event.metaKey ||\n      (event as KeyboardEvent).key === ' '\n    ) {\n      // de-select only when ctrl/meta key is pressed or selectionBehavior is\n      // explicitly set to toggle\n      keySet = removeKey(selectedKeys, itemKey, isSelectionRequired);\n    } else if (selectionMode === 'multiple' && (selectedKeys.all || selectedKeys.keys.size > 1)) {\n      // in this case everything should be de-selected except for this key\n      keySet = { all: false, keys: new Set([itemKey]) };\n    }\n  }\n\n  // only invoke callback if there is really a change\n  // note onSelectionChange should never be null here\n  if (selectedKeys != keySet && onChange) {\n    onChange({ value: keySet, target: event.target });\n    if (event.type === 'click') {\n      event.stopPropagation();\n    }\n  }\n};\n\n/**\n * Hook for handling various selection mode.  This can be reuse by all Collection components.\n * @param keyExtractor function to extract the key based on provided element\n * @param selectedKeys the currently selected keys\n * @param selectionMode the selection mode\n * @param selectionBehavior the selection behavior.  If the value is 'toggle', then the key is\n *                          added/removed from the current selected keys.  If the value is 'replace',\n *                          then the current selected keys are cleared first before the key is added\n *                          unless the ctrl/shift/meta key is pressed.\n * @param onSelectionChange callback function that is invoked when selection has changed.\n * @returns an event map that the consumer can register as event listeners\n */\nexport function useSelection<K>(\n  keyExtractor: (element: HTMLElement) => K | null,\n  selectedKeys: Keys<K>,\n  selectionMode: SelectionMode,\n  isSelectionRequired: boolean,\n  selectionBehavior: SelectionBehavior,\n  onChange?: (detail: SelectionDetail<K>) => void,\n  anchorKey?: K,\n  currentKey?: K | undefined,\n  getPrevNextKey?: (currentKey: K | undefined, isPrev: boolean) => () => K | null,\n  scrollToKey?: (key: K) => void,\n  onRangeChange?: (detail: SelectionRangeDetail<K>) => void\n) {\n  // ref to track the cursor for the SHIFT+ARROW keyboard selection separately than the anchor of the selection.\n  const keyboardSelectionCursor = useRef<K>();\n\n  const onClick = useCallback(\n    (event: MouseEvent) => {\n      handleSelect(\n        event,\n        keyExtractor,\n        selectedKeys,\n        selectionMode,\n        selectionBehavior,\n        isSelectionRequired,\n        keyboardSelectionCursor,\n        anchorKey,\n        onChange,\n        onRangeChange\n      );\n      if (!event.shiftKey) {\n        // reset keyboard cursor when using mouse to select\n        keyboardSelectionCursor.current = undefined;\n      }\n    },\n    [\n      keyExtractor,\n      selectedKeys,\n      selectionMode,\n      selectionBehavior,\n      isSelectionRequired,\n      keyboardSelectionCursor,\n      anchorKey,\n      onChange,\n      onRangeChange\n    ]\n  );\n\n  // general keyboard events listen to keyUp for a11y\n  const onKeyUp = useCallback(\n    (event: KeyboardEvent) => {\n      // older browser that we don't support returns 'Spacebar' for space key\n      if (event.key === ' ' || event.key === 'Enter') {\n        handleSelect(\n          event,\n          keyExtractor,\n          selectedKeys,\n          selectionMode,\n          selectionBehavior,\n          isSelectionRequired,\n          keyboardSelectionCursor,\n          anchorKey,\n          onChange,\n          event.shiftKey && event.key === ' ' ? onRangeChange : undefined\n        );\n      }\n    },\n    [\n      keyExtractor,\n      selectedKeys,\n      selectionMode,\n      selectionBehavior,\n      isSelectionRequired,\n      anchorKey,\n      onChange,\n      onRangeChange\n    ]\n  );\n\n  // arrowKey events listen to keyDown so they can support holding them down\n  const onKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      // prevent default (propagation) for keyDown to space bar causing container to scroll\n      if (event.key === ' ') {\n        event.preventDefault();\n        return;\n      }\n\n      if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {\n        if (event.shiftKey && getPrevNextKey && scrollToKey) {\n          let keySet = selectedKeys;\n          // on first selection event, set keyboard cursor to start at currentKey\n          if (!keyboardSelectionCursor.current && isKeyDefined(currentKey)) {\n            keySet = { all: false, keys: new Set([currentKey as K]) };\n          }\n          const newAnchorKey = getPrevNextKey(\n            keyboardSelectionCursor.current || currentKey,\n            event.key === 'ArrowDown' ? false : true\n          );\n          const cursorKey = newAnchorKey();\n          if (cursorKey != null) {\n            // extend selection\n            if (!containsKey(keySet, cursorKey)) {\n              keySet = addKey(keySet, cursorKey);\n              // subtract from selection\n            } else if (\n              keyboardSelectionCursor.current != null &&\n              keyboardSelectionCursor.current !== cursorKey\n            ) {\n              keySet = removeKey(keySet, keyboardSelectionCursor.current, isSelectionRequired);\n            }\n            keyboardSelectionCursor.current = cursorKey;\n            // keep visible\n            scrollToKey(cursorKey);\n          }\n          if (selectedKeys != keySet && onChange) {\n            onChange({ value: keySet, target: event.target });\n          }\n        } else {\n          // 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)\n          keyboardSelectionCursor.current = undefined;\n        }\n      }\n    },\n    [selectedKeys, isSelectionRequired, onChange, currentKey, getPrevNextKey, scrollToKey]\n  );\n\n  const selectionProps =\n    selectionMode === 'none' || onChange == null ? {} : { onClick, onKeyDown, onKeyUp };\n  return { selectionProps };\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 { useSelection, SelectionBehavior, SelectionRangeDetail } from './useSelection';\n"],"names":["stringLiteralArray","containsKey","addKey","removeKey","useRef","useCallback","isKeyDefined"],"mappings":";;;;;;;;;AAaA;;AAEG;AACI,MAAM,SAAS,GAAGA,0CAAkB,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAUnE,MAAM,oBAAoB,GAAG,CAC3B,SAAY,EACZ,YAAqB,EACrB,aAA4B,EAC5B,iBAAoC,KAClC;IACF,QACE,aAAa,KAAK,UAAU;AAC5B,QAAA,iBAAiB,KAAK,QAAQ;AAC9B,QAAAC,6BAAW,CAAC,YAAY,EAAE,SAAS,CAAC,EACpC;AACJ,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CACnB,KAAiC,EACjC,YAAgD,EAChD,YAAqB,EACrB,aAA4B,EAC5B,iBAAoC,EACpC,mBAA4B,EAC5B,iBAA2C,EAC3C,SAAa,EACb,QAA+C,EAC/C,aAAyD,KACvD;IACF,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,MAAqB,CAAC,CAAC;IAC1D,IAAI,OAAO,IAAI,IAAI,EAAE;QACnB,OAAO;AACR,KAAA;;IAGD,IACE,KAAK,CAAC,QAAQ;AACd,QAAA,SAAS,KAAK,SAAS;QACvB,aAAa;QACb,oBAAoB,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,iBAAiB,CAAC,EAC/E;AACA,QAAA,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;;AAE7D,QAAA,IAAI,iBAAiB,EAAE;AACrB,YAAA,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAC;AACrC,SAAA;QACD,OAAO;AACR,KAAA;IAED,MAAM,QAAQ,GAAGA,6BAAW,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,GAAG,YAAY,CAAC;IAC1B,IAAI,CAAC,QAAQ,EAAE;QACb,IACE,aAAa,KAAK,QAAQ;YACzB,KAAuB,CAAC,GAAG,KAAK,OAAO;AACxC,aAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EACtE;;AAEA,YAAA,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AACnD,SAAA;AAAM,aAAA;;AAEL,YAAA,MAAM,GAAGC,wBAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACxC,SAAA;AACF,KAAA;AAAM,SAAA,IAAK,KAAuB,CAAC,GAAG,KAAK,OAAO,EAAE;;QAEnD,IACE,iBAAiB,KAAK,QAAQ;AAC9B,YAAA,KAAK,CAAC,OAAO;AACb,YAAA,KAAK,CAAC,OAAO;AACZ,YAAA,KAAuB,CAAC,GAAG,KAAK,GAAG,EACpC;;;YAGA,MAAM,GAAGC,2BAAS,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AAChE,SAAA;AAAM,aAAA,IAAI,aAAa,KAAK,UAAU,KAAK,YAAY,CAAC,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE;;AAE3F,YAAA,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;AACnD,SAAA;AACF,KAAA;;;AAID,IAAA,IAAI,YAAY,IAAI,MAAM,IAAI,QAAQ,EAAE;AACtC,QAAA,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAClD,QAAA,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE;YAC1B,KAAK,CAAC,eAAe,EAAE,CAAC;AACzB,SAAA;AACF,KAAA;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;AAWG;AACG,SAAU,YAAY,CAC1B,YAAgD,EAChD,YAAqB,EACrB,aAA4B,EAC5B,mBAA4B,EAC5B,iBAAoC,EACpC,QAA+C,EAC/C,SAAa,EACb,UAA0B,EAC1B,cAA+E,EAC/E,WAA8B,EAC9B,aAAyD,EAAA;;AAGzD,IAAA,MAAM,uBAAuB,GAAGC,YAAM,EAAK,CAAC;AAE5C,IAAA,MAAM,OAAO,GAAGC,iBAAW,CACzB,CAAC,KAAiB,KAAI;QACpB,YAAY,CACV,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,QAAQ,EACR,aAAa,CACd,CAAC;AACF,QAAA,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;;AAEnB,YAAA,uBAAuB,CAAC,OAAO,GAAG,SAAS,CAAC;AAC7C,SAAA;AACH,KAAC,EACD;QACE,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,iBAAiB;QACjB,mBAAmB;QACnB,uBAAuB;QACvB,SAAS;QACT,QAAQ;QACR,aAAa;AACd,KAAA,CACF,CAAC;;AAGF,IAAA,MAAM,OAAO,GAAGA,iBAAW,CACzB,CAAC,KAAoB,KAAI;;QAEvB,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE;AAC9C,YAAA,YAAY,CACV,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,SAAS,EACT,QAAQ,EACR,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,GAAG,aAAa,GAAG,SAAS,CAChE,CAAC;AACH,SAAA;AACH,KAAC,EACD;QACE,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,iBAAiB;QACjB,mBAAmB;QACnB,SAAS;QACT,QAAQ;QACR,aAAa;AACd,KAAA,CACF,CAAC;;AAGF,IAAA,MAAM,SAAS,GAAGA,iBAAW,CAC3B,CAAC,KAAoB,KAAI;;AAEvB,QAAA,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE;YACrB,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,OAAO;AACR,SAAA;QAED,IAAI,KAAK,CAAC,GAAG,KAAK,WAAW,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE;AACxD,YAAA,IAAI,KAAK,CAAC,QAAQ,IAAI,cAAc,IAAI,WAAW,EAAE;gBACnD,IAAI,MAAM,GAAG,YAAY,CAAC;;gBAE1B,IAAI,CAAC,uBAAuB,CAAC,OAAO,IAAIC,8BAAY,CAAC,UAAU,CAAC,EAAE;AAChE,oBAAA,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,UAAe,CAAC,CAAC,EAAE,CAAC;AAC3D,iBAAA;gBACD,MAAM,YAAY,GAAG,cAAc,CACjC,uBAAuB,CAAC,OAAO,IAAI,UAAU,EAC7C,KAAK,CAAC,GAAG,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,CACzC,CAAC;AACF,gBAAA,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;gBACjC,IAAI,SAAS,IAAI,IAAI,EAAE;;AAErB,oBAAA,IAAI,CAACL,6BAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;AACnC,wBAAA,MAAM,GAAGC,wBAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;;AAEpC,qBAAA;AAAM,yBAAA,IACL,uBAAuB,CAAC,OAAO,IAAI,IAAI;AACvC,wBAAA,uBAAuB,CAAC,OAAO,KAAK,SAAS,EAC7C;wBACA,MAAM,GAAGC,2BAAS,CAAC,MAAM,EAAE,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;AAClF,qBAAA;AACD,oBAAA,uBAAuB,CAAC,OAAO,GAAG,SAAS,CAAC;;oBAE5C,WAAW,CAAC,SAAS,CAAC,CAAC;AACxB,iBAAA;AACD,gBAAA,IAAI,YAAY,IAAI,MAAM,IAAI,QAAQ,EAAE;AACtC,oBAAA,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AACnD,iBAAA;AACF,aAAA;AAAM,iBAAA;;AAEL,gBAAA,uBAAuB,CAAC,OAAO,GAAG,SAAS,CAAC;AAC7C,aAAA;AACF,SAAA;AACH,KAAC,EACD,CAAC,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,CAAC,CACvF,CAAC;IAEF,MAAM,cAAc,GAClB,aAAa,KAAK,MAAM,IAAI,QAAQ,IAAI,IAAI,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACtF,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5B;;AC9PA;;;;;;AAMG;;;;;;;"}

package/cjs/hooks/PRIVATE_useSingleSelection.js

@@ -0,0 +1,13 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var useSingleSelection = require('../useSingleSelection-46afe62c.js');
+require('preact/hooks');
+
+
+
+exports.useSingleSelection = useSingleSelection.useSingleSelection;
+/*  */
+//# sourceMappingURL=PRIVATE_useSingleSelection.js.map

package/cjs/hooks/PRIVATE_useSingleSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PRIVATE_useSingleSelection.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/cjs/hooks/PRIVATE_useTabbableModeSet.js

@@ -0,0 +1,87 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks = require('preact/hooks');
+var utils_UNSAFE_keys = require('../utils/UNSAFE_keys.js');
+
+/**
+ * @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
+ */
+/**
+ * Hook for handling Tabbable mode set provider components.
+ *
+ * @param contains - callback to check  whether an element is in set
+ * @param keyExtractor - function to extract the key based on provided element
+ * @param currentKey - current key navigation "cursor" is on
+ * @param onTabbableModeDisable - callback to parent when set is disabled
+ * @param onTabbableModeEnable - callback to parent when set is enabled
+ * @returns isCurrentTabbableKey - callback for parent to check if key is in interactive mode
+ * @returns tabbableSetProps - event handlers mode relies on
+ */
+function useTabbableModeSet(contains, keyExtractor, currentKey, onTabbableModeDisable, onTabbableModeEnable) {
+    // Track which row is in actionable in state
+    const [currentTabbableKey, setCurrentTabbableKey] = hooks.useState();
+    const disableTabbableMode = hooks.useCallback((target, isKeyboardEvent = false) => {
+        setCurrentTabbableKey(undefined);
+        onTabbableModeDisable && onTabbableModeDisable(target, isKeyboardEvent);
+    }, [onTabbableModeDisable, setCurrentTabbableKey]);
+    const enableTabbableMode = hooks.useCallback((key) => {
+        setCurrentTabbableKey(key);
+        onTabbableModeEnable && onTabbableModeEnable(key);
+    }, [onTabbableModeEnable, setCurrentTabbableKey]);
+    const isCurrentTabbableKey = hooks.useCallback((key) => {
+        return key === currentTabbableKey;
+    }, [currentTabbableKey]);
+    const onFocus = (event) => {
+        const key = keyExtractor(event.target);
+        if (utils_UNSAFE_keys.isKeyDefined(key) && !isCurrentTabbableKey(key)) {
+            enableTabbableMode(key);
+        }
+    };
+    const onBlur = (event) => {
+        if (!event.relatedTarget || !contains(event.relatedTarget)) {
+            disableTabbableMode(event.relatedTarget);
+        }
+    };
+    const onPointerDown = (event) => {
+        const key = keyExtractor(event.target);
+        if (currentTabbableKey !== undefined && !isCurrentTabbableKey(key)) {
+            disableTabbableMode(event.target);
+        }
+    };
+    const onKeyUp = hooks.useCallback((event) => {
+        if (event.key === 'F2') {
+            currentKey !== undefined && !isCurrentTabbableKey(currentKey)
+                ? enableTabbableMode(currentKey)
+                : disableTabbableMode(event.target, true);
+        }
+        if (event.key === 'Esc' || event.key === 'Escape') {
+            disableTabbableMode(event.target, true);
+        }
+    }, [currentKey, disableTabbableMode, enableTabbableMode, isCurrentTabbableKey]);
+    const tabbableSetProps = {
+        onFocus,
+        onBlur,
+        onKeyUp,
+        onPointerDown
+    };
+    return [isCurrentTabbableKey, tabbableSetProps];
+}
+
+/**
+ * @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.useTabbableModeSet = useTabbableModeSet;
+/*  */
+//# sourceMappingURL=PRIVATE_useTabbableModeSet.js.map

package/cjs/hooks/PRIVATE_useTabbableModeSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PRIVATE_useTabbableModeSet.js","sources":["../../../src/hooks/PRIVATE_useTabbableModeSet/useTabbableModeSet.ts","../../../src/hooks/PRIVATE_useTabbableModeSet/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 */\nimport { useCallback, useState } from 'preact/hooks';\nimport { isKeyDefined } from '../../utils/UNSAFE_keys';\n\n/**\n * Hook for handling Tabbable mode set provider components.\n *\n * @param contains - callback to check  whether an element is in set\n * @param keyExtractor - function to extract the key based on provided element\n * @param currentKey - current key navigation \"cursor\" is on\n * @param onTabbableModeDisable - callback to parent when set is disabled\n * @param onTabbableModeEnable - callback to parent when set is enabled\n * @returns isCurrentTabbableKey - callback for parent to check if key is in interactive mode\n * @returns tabbableSetProps - event handlers mode relies on\n */\nexport function useTabbableModeSet<K>(\n  contains: (elem: Element | null) => boolean,\n  keyExtractor: (element: HTMLElement) => K | null,\n  currentKey?: K,\n  onTabbableModeDisable?: (target: EventTarget | null, isKeyboardEvent: boolean) => void,\n  onTabbableModeEnable?: (key: K) => void\n): [\n  (key?: K) => boolean,\n  {\n    onFocus: (event: FocusEvent) => void;\n    onBlur: (event: FocusEvent) => void;\n    onKeyUp: (event: KeyboardEvent) => void;\n    onPointerDown: (event: MouseEvent) => void;\n  }\n] {\n  // Track which row is in actionable in state\n  const [currentTabbableKey, setCurrentTabbableKey] = useState<K>();\n  const disableTabbableMode = useCallback(\n    (target: EventTarget | null, isKeyboardEvent = false) => {\n      setCurrentTabbableKey(undefined);\n      onTabbableModeDisable && onTabbableModeDisable(target, isKeyboardEvent);\n    },\n    [onTabbableModeDisable, setCurrentTabbableKey]\n  );\n  const enableTabbableMode = useCallback(\n    (key: K) => {\n      setCurrentTabbableKey(key);\n      onTabbableModeEnable && onTabbableModeEnable(key);\n    },\n    [onTabbableModeEnable, setCurrentTabbableKey]\n  );\n  const isCurrentTabbableKey = useCallback(\n    (key?: K) => {\n      return key === currentTabbableKey;\n    },\n    [currentTabbableKey]\n  );\n\n  const onFocus = (event: FocusEvent) => {\n    const key = keyExtractor(event.target as HTMLElement) as K;\n    if (isKeyDefined(key) && !isCurrentTabbableKey(key)) {\n      enableTabbableMode(key);\n    }\n  };\n\n  const onBlur = (event: FocusEvent) => {\n    if (!event.relatedTarget || !contains(event.relatedTarget as Element)) {\n      disableTabbableMode(event.relatedTarget);\n    }\n  };\n\n  const onPointerDown = (event: MouseEvent) => {\n    const key = keyExtractor(event.target as HTMLElement) as K;\n    if (currentTabbableKey !== undefined && !isCurrentTabbableKey(key)) {\n      disableTabbableMode(event.target);\n    }\n  };\n\n  const onKeyUp = useCallback(\n    (event: KeyboardEvent) => {\n      if (event.key === 'F2') {\n        currentKey !== undefined && !isCurrentTabbableKey(currentKey)\n          ? enableTabbableMode(currentKey)\n          : disableTabbableMode(event.target, true);\n      }\n      if (event.key === 'Esc' || event.key === 'Escape') {\n        disableTabbableMode(event.target, true);\n      }\n    },\n    [currentKey, disableTabbableMode, enableTabbableMode, isCurrentTabbableKey]\n  );\n\n  const tabbableSetProps = {\n    onFocus,\n    onBlur,\n    onKeyUp,\n    onPointerDown\n  };\n\n  return [isCurrentTabbableKey, tabbableSetProps];\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 { useTabbableModeSet } from './useTabbableModeSet';\n"],"names":["useState","useCallback","isKeyDefined"],"mappings":";;;;;;;;AAAA;;;;;;AAMG;AAIH;;;;;;;;;;AAUG;AACG,SAAU,kBAAkB,CAChC,QAA2C,EAC3C,YAAgD,EAChD,UAAc,EACd,qBAAsF,EACtF,oBAAuC,EAAA;;IAWvC,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAGA,cAAQ,EAAK,CAAC;IAClE,MAAM,mBAAmB,GAAGC,iBAAW,CACrC,CAAC,MAA0B,EAAE,eAAe,GAAG,KAAK,KAAI;QACtD,qBAAqB,CAAC,SAAS,CAAC,CAAC;AACjC,QAAA,qBAAqB,IAAI,qBAAqB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC1E,KAAC,EACD,CAAC,qBAAqB,EAAE,qBAAqB,CAAC,CAC/C,CAAC;AACF,IAAA,MAAM,kBAAkB,GAAGA,iBAAW,CACpC,CAAC,GAAM,KAAI;QACT,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC3B,QAAA,oBAAoB,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;AACpD,KAAC,EACD,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,CAC9C,CAAC;AACF,IAAA,MAAM,oBAAoB,GAAGA,iBAAW,CACtC,CAAC,GAAO,KAAI;QACV,OAAO,GAAG,KAAK,kBAAkB,CAAC;AACpC,KAAC,EACD,CAAC,kBAAkB,CAAC,CACrB,CAAC;AAEF,IAAA,MAAM,OAAO,GAAG,CAAC,KAAiB,KAAI;QACpC,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,MAAqB,CAAM,CAAC;QAC3D,IAAIC,8BAAY,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE;YACnD,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACzB,SAAA;AACH,KAAC,CAAC;AAEF,IAAA,MAAM,MAAM,GAAG,CAAC,KAAiB,KAAI;AACnC,QAAA,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAwB,CAAC,EAAE;AACrE,YAAA,mBAAmB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC1C,SAAA;AACH,KAAC,CAAC;AAEF,IAAA,MAAM,aAAa,GAAG,CAAC,KAAiB,KAAI;QAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,MAAqB,CAAM,CAAC;QAC3D,IAAI,kBAAkB,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE;AAClE,YAAA,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACnC,SAAA;AACH,KAAC,CAAC;AAEF,IAAA,MAAM,OAAO,GAAGD,iBAAW,CACzB,CAAC,KAAoB,KAAI;AACvB,QAAA,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,EAAE;AACtB,YAAA,UAAU,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC;AAC3D,kBAAE,kBAAkB,CAAC,UAAU,CAAC;kBAC9B,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7C,SAAA;QACD,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE;AACjD,YAAA,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACzC,SAAA;KACF,EACD,CAAC,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,CAC5E,CAAC;AAEF,IAAA,MAAM,gBAAgB,GAAG;QACvB,OAAO;QACP,MAAM;QACN,OAAO;QACP,aAAa;KACd,CAAC;AAEF,IAAA,OAAO,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;AAClD;;ACrGA;;;;;;AAMG;;;;;;;"}

package/cjs/hooks/UNSAFE_useActionable.js

@@ -0,0 +1,46 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var utils_UNSAFE_mergeProps = require('../utils/UNSAFE_mergeProps.js');
+var hooks_UNSAFE_useHover = require('./UNSAFE_useHover.js');
+var hooks_UNSAFE_useActive = require('./UNSAFE_useActive.js');
+var hooks_UNSAFE_useFocus = require('./UNSAFE_useFocus.js');
+var hooks_UNSAFE_usePress = require('./UNSAFE_usePress.js');
+require('./UNSAFE_useToggle.js');
+require('preact/hooks');
+
+const DefaultActionableOptions = {
+    isDisabled: false,
+    isRepeat: false
+};
+/**
+ * A hook that can add actionable support to a target element, turning it into a
+ * clickable button, div, card, etc.
+ * If isHover, isFocus, and isActive are only used for changing visual rendering, it would be
+ * faster to not use this hook, and instead use :hover, :focus-visible, :active and usePress.
+ * @param onActionHandler
+ * @returns
+ */
+function useActionable(onActionHandler, settings = DefaultActionableOptions) {
+    const mergedSettings = Object.assign(Object.assign({}, DefaultActionableOptions), settings);
+    const { pressProps } = hooks_UNSAFE_usePress.usePress(onActionHandler, mergedSettings);
+    const { hoverProps, isHover } = hooks_UNSAFE_useHover.useHover({ isDisabled: mergedSettings.isDisabled });
+    const { focusProps, isFocus } = hooks_UNSAFE_useFocus.useFocus({ isDisabled: mergedSettings.isDisabled });
+    const { activeProps, isActive } = hooks_UNSAFE_useActive.useActive({ isDisabled: mergedSettings.isDisabled });
+    const actionableProps = utils_UNSAFE_mergeProps.mergeProps(pressProps, hoverProps, activeProps, focusProps);
+    return { actionableProps, isActive, isHover, isFocus };
+}
+
+/**
+ * @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.useActionable = useActionable;
+/*  */
+//# sourceMappingURL=UNSAFE_useActionable.js.map

package/cjs/hooks/UNSAFE_useActionable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useActionable.js","sources":["../../../src/hooks/UNSAFE_useActionable/useActionable.ts","../../../src/hooks/UNSAFE_useActionable/index.ts"],"sourcesContent":["import { mergeProps } from '../../utils/UNSAFE_mergeProps';\nimport { useHover } from '../UNSAFE_useHover';\nimport { useActive } from '../UNSAFE_useActive';\nimport { useFocus } from '../UNSAFE_useFocus';\nimport { usePress } from '../UNSAFE_usePress';\n\nexport type ActionableOptions = {\n  isDisabled?: boolean;\n  isRepeat?: boolean;\n};\n\nconst DefaultActionableOptions = {\n  isDisabled: false,\n  isRepeat: false\n};\n\n/**\n * A hook that can add actionable support to a target element, turning it into a\n * clickable button, div, card, etc.\n * If isHover, isFocus, and isActive are only used for changing visual rendering, it would be\n * faster to not use this hook, and instead use :hover, :focus-visible, :active and usePress.\n * @param onActionHandler\n * @returns\n */\nexport function useActionable(\n  onActionHandler: (event: Event) => void,\n  settings: ActionableOptions = DefaultActionableOptions\n): { isActive: boolean; isHover: boolean; isFocus: boolean; actionableProps: Record<string, any> } {\n  const mergedSettings = { ...DefaultActionableOptions, ...settings };\n  const { pressProps } = usePress(onActionHandler, mergedSettings);\n  const { hoverProps, isHover } = useHover({ isDisabled: mergedSettings.isDisabled });\n  const { focusProps, isFocus } = useFocus({ isDisabled: mergedSettings.isDisabled });\n  const { activeProps, isActive } = useActive({ isDisabled: mergedSettings.isDisabled });\n  const actionableProps = mergeProps(pressProps, hoverProps, activeProps, focusProps);\n  return { actionableProps, isActive, isHover, isFocus };\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 * from './useActionable';\n"],"names":["usePress","useHover","useFocus","useActive","mergeProps"],"mappings":";;;;;;;;;;;;;AAWA,MAAM,wBAAwB,GAAG;AAC/B,IAAA,UAAU,EAAE,KAAK;AACjB,IAAA,QAAQ,EAAE,KAAK;CAChB,CAAC;AAEF;;;;;;;AAOG;SACa,aAAa,CAC3B,eAAuC,EACvC,WAA8B,wBAAwB,EAAA;AAEtD,IAAA,MAAM,cAAc,GAAQ,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,wBAAwB,CAAK,EAAA,QAAQ,CAAE,CAAC;IACpE,MAAM,EAAE,UAAU,EAAE,GAAGA,8BAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;AACjE,IAAA,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAGC,8BAAQ,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;AACpF,IAAA,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAGC,8BAAQ,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;AACpF,IAAA,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAGC,gCAAS,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC;AACvF,IAAA,MAAM,eAAe,GAAGC,kCAAU,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACpF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACzD;;ACnCA;;;;;;AAMG;;;;;;;"}

package/cjs/hooks/UNSAFE_useActive.js

@@ -0,0 +1,85 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks_UNSAFE_useToggle = require('./UNSAFE_useToggle.js');
+var hooks = require('preact/hooks');
+
+/**
+ * Indicates if primary mouse button is down
+ * @param e
+ * @returns
+ */
+const isPrimaryMouseButtonDown = (e) => {
+    const flags = e.buttons !== undefined ? e.buttons : e.which;
+    const primaryMouseButtonDown = (flags & 1) === 1;
+    if (primaryMouseButtonDown) {
+        return true;
+    }
+    return false;
+};
+/**
+ * Returns properties to manage active state indication
+ * @returns
+ */
+function useActive(settings = { isDisabled: false }) {
+    const { bool, setTrue, setFalse } = hooks_UNSAFE_useToggle.useToggle(false);
+    const wasActive = hooks.useRef(false);
+    const mouseDownTarget = hooks.useCallback((e) => {
+        if (isPrimaryMouseButtonDown(e)) {
+            setTrue();
+        }
+    }, [setTrue]);
+    const leftTarget = hooks.useCallback((e) => {
+        if (isPrimaryMouseButtonDown(e)) {
+            wasActive.current = true;
+        }
+        setFalse();
+    }, [setFalse]);
+    const enteredTarget = hooks.useCallback((e) => {
+        if (wasActive.current) {
+            if (isPrimaryMouseButtonDown(e)) {
+                setTrue();
+            }
+            wasActive.current = false;
+        }
+    }, [setTrue]);
+    const onKeyDown = hooks.useCallback((event) => {
+        if (event.key === ' ' || event.key === 'Enter') {
+            setTrue();
+        }
+    }, [setTrue]);
+    const onKeyUp = hooks.useCallback(() => {
+        setFalse();
+    }, [setFalse]);
+    const activeProps = settings.isDisabled
+        ? {}
+        : {
+            onMouseDown: mouseDownTarget,
+            onMouseOut: leftTarget,
+            onMouseEnter: enteredTarget,
+            onMouseUp: setFalse,
+            onTouchStart: setTrue,
+            onTouchEnd: setFalse,
+            onTouchCancel: setFalse,
+            onKeyDown,
+            onKeyUp
+        };
+    return {
+        isActive: settings.isDisabled ? false : bool,
+        activeProps: activeProps
+    };
+}
+
+/**
+ * @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.useActive = useActive;
+/*  */
+//# sourceMappingURL=UNSAFE_useActive.js.map

package/cjs/hooks/UNSAFE_useActive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useActive.js","sources":["../../../src/hooks/UNSAFE_useActive/useActive.ts","../../../src/hooks/UNSAFE_useActive/index.ts"],"sourcesContent":["import { useToggle } from '../UNSAFE_useToggle';\nimport { useRef, useCallback } from 'preact/hooks';\n\nexport type ActiveOptions = {\n  isDisabled?: boolean;\n};\n\n/**\n * Indicates if primary mouse button is down\n * @param e\n * @returns\n */\nconst isPrimaryMouseButtonDown = (e: MouseEvent) => {\n  const flags = e.buttons !== undefined ? e.buttons : e.which;\n  const primaryMouseButtonDown = (flags & 1) === 1;\n  if (primaryMouseButtonDown) {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Returns properties to manage active state indication\n * @returns\n */\nexport function useActive(settings: ActiveOptions = { isDisabled: false }): {\n  isActive: boolean;\n  activeProps: Record<string, any>;\n} {\n  const { bool, setTrue, setFalse } = useToggle(false);\n  const wasActive = useRef(false);\n\n  const mouseDownTarget = useCallback(\n    (e: MouseEvent) => {\n      if (isPrimaryMouseButtonDown(e)) {\n        setTrue();\n      }\n    },\n    [setTrue]\n  );\n\n  const leftTarget = useCallback(\n    (e: MouseEvent) => {\n      if (isPrimaryMouseButtonDown(e)) {\n        wasActive.current = true;\n      }\n      setFalse();\n    },\n    [setFalse]\n  );\n\n  const enteredTarget = useCallback(\n    (e: MouseEvent) => {\n      if (wasActive.current) {\n        if (isPrimaryMouseButtonDown(e)) {\n          setTrue();\n        }\n        wasActive.current = false;\n      }\n    },\n    [setTrue]\n  );\n\n  const onKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      if (event.key === ' ' || event.key === 'Enter') {\n        setTrue();\n      }\n    },\n    [setTrue]\n  );\n\n  const onKeyUp = useCallback(() => {\n    setFalse();\n  }, [setFalse]);\n\n  const activeProps = settings.isDisabled\n    ? {}\n    : {\n        onMouseDown: mouseDownTarget,\n        onMouseOut: leftTarget,\n        onMouseEnter: enteredTarget,\n        onMouseUp: setFalse,\n        onTouchStart: setTrue,\n        onTouchEnd: setFalse,\n        onTouchCancel: setFalse,\n        onKeyDown,\n        onKeyUp\n      };\n\n  return {\n    isActive: settings.isDisabled ? false : bool,\n    activeProps: activeProps\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 * from './useActive';\n"],"names":["useToggle","useRef","useCallback"],"mappings":";;;;;;;;AAOA;;;;AAIG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAa,KAAI;AACjD,IAAA,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC;IAC5D,MAAM,sBAAsB,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;AACjD,IAAA,IAAI,sBAAsB,EAAE;AAC1B,QAAA,OAAO,IAAI,CAAC;AACb,KAAA;AACD,IAAA,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF;;;AAGG;AACG,SAAU,SAAS,CAAC,QAAA,GAA0B,EAAE,UAAU,EAAE,KAAK,EAAE,EAAA;AAIvE,IAAA,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAGA,gCAAS,CAAC,KAAK,CAAC,CAAC;AACrD,IAAA,MAAM,SAAS,GAAGC,YAAM,CAAC,KAAK,CAAC,CAAC;AAEhC,IAAA,MAAM,eAAe,GAAGC,iBAAW,CACjC,CAAC,CAAa,KAAI;AAChB,QAAA,IAAI,wBAAwB,CAAC,CAAC,CAAC,EAAE;AAC/B,YAAA,OAAO,EAAE,CAAC;AACX,SAAA;AACH,KAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;AAEF,IAAA,MAAM,UAAU,GAAGA,iBAAW,CAC5B,CAAC,CAAa,KAAI;AAChB,QAAA,IAAI,wBAAwB,CAAC,CAAC,CAAC,EAAE;AAC/B,YAAA,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;AAC1B,SAAA;AACD,QAAA,QAAQ,EAAE,CAAC;AACb,KAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;AAEF,IAAA,MAAM,aAAa,GAAGA,iBAAW,CAC/B,CAAC,CAAa,KAAI;QAChB,IAAI,SAAS,CAAC,OAAO,EAAE;AACrB,YAAA,IAAI,wBAAwB,CAAC,CAAC,CAAC,EAAE;AAC/B,gBAAA,OAAO,EAAE,CAAC;AACX,aAAA;AACD,YAAA,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;AAC3B,SAAA;AACH,KAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;AAEF,IAAA,MAAM,SAAS,GAAGA,iBAAW,CAC3B,CAAC,KAAoB,KAAI;QACvB,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,EAAE;AAC9C,YAAA,OAAO,EAAE,CAAC;AACX,SAAA;AACH,KAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;AAEF,IAAA,MAAM,OAAO,GAAGA,iBAAW,CAAC,MAAK;AAC/B,QAAA,QAAQ,EAAE,CAAC;AACb,KAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEf,IAAA,MAAM,WAAW,GAAG,QAAQ,CAAC,UAAU;AACrC,UAAE,EAAE;AACJ,UAAE;AACE,YAAA,WAAW,EAAE,eAAe;AAC5B,YAAA,UAAU,EAAE,UAAU;AACtB,YAAA,YAAY,EAAE,aAAa;AAC3B,YAAA,SAAS,EAAE,QAAQ;AACnB,YAAA,YAAY,EAAE,OAAO;AACrB,YAAA,UAAU,EAAE,QAAQ;AACpB,YAAA,aAAa,EAAE,QAAQ;YACvB,SAAS;YACT,OAAO;SACR,CAAC;IAEN,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,UAAU,GAAG,KAAK,GAAG,IAAI;AAC5C,QAAA,WAAW,EAAE,WAAW;KACzB,CAAC;AACJ;;AC9FA;;;;;;AAMG;;;;;;;"}

package/cjs/hooks/UNSAFE_useAnimation.js

@@ -0,0 +1,14 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var useAnimation = require('../useAnimation-9e794d84.js');
+require('preact/hooks');
+require('../tslib.es6-d7adde1f.js');
+
+
+
+exports.useAnimation = useAnimation.useAnimation;
+/*  */
+//# sourceMappingURL=UNSAFE_useAnimation.js.map

package/cjs/hooks/UNSAFE_useAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useAnimation.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}

package/cjs/hooks/UNSAFE_useBreakpointValues.js

@@ -0,0 +1,27 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var hooks_UNSAFE_useBreakpoints = require('./UNSAFE_useBreakpoints.js');
+require('preact/hooks');
+
+/*
+ * Custom hook to allow the user to define custom values that are returned if a breakpoint is reached.
+ * The Responsive object is a set of one or more key/value pairs, with each breakpoint as a key.
+ *
+ * TODO: Fix breakpoint value Type:
+ *  The second arg allows arbitrary breakpoints to be specified, but the first arg only allows values for "sm", "md", "lg" and "xl"; if we allow custom breakpoints to be specified via the second arg, the first arg needs to allow values for those same custom breakpoints to be passed in.
+ */
+function useBreakpointValues(breakpointValues, breakpoints = hooks_UNSAFE_useBreakpoints.defaultBreakpoints) {
+    const current = hooks_UNSAFE_useBreakpoints.useBreakpoints(breakpoints);
+    const breakpoint = Object.entries(breakpointValues).reduce((p, c) => {
+        const key = c[0]; // first entry in breakpoint values is the key
+        return current[key] ? c : p; // if current breakpoint is true, return it, else stay with previous
+    });
+    return breakpoint[1]; // second entry in breakpoint values is the value
+}
+
+exports.useBreakpointValues = useBreakpointValues;
+/*  */
+//# sourceMappingURL=UNSAFE_useBreakpointValues.js.map

package/cjs/hooks/UNSAFE_useBreakpointValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useBreakpointValues.js","sources":["../../../src/hooks/UNSAFE_useBreakpointValues/useBreakpointValues.ts"],"sourcesContent":["import { useBreakpoints, Breakpoints, defaultBreakpoints } from '../UNSAFE_useBreakpoints';\n\n/*\n * This allows a user to define key/value pairs that map to each breakpoint.\n * The user's custom value is returned when the specific breakpoint is reached.\n */\ntype DefaultBreakpoints = keyof typeof defaultBreakpoints;\ntype DefaultType<T> = Record<DefaultBreakpoints, T>;\ntype Responsive<V> = Partial<DefaultType<V>>;\n\n/*\n * Custom hook to allow the user to define custom values that are returned if a breakpoint is reached.\n * The Responsive object is a set of one or more key/value pairs, with each breakpoint as a key.\n *\n * TODO: Fix breakpoint value Type:\n *  The second arg allows arbitrary breakpoints to be specified, but the first arg only allows values for \"sm\", \"md\", \"lg\" and \"xl\"; if we allow custom breakpoints to be specified via the second arg, the first arg needs to allow values for those same custom breakpoints to be passed in.\n */\nexport function useBreakpointValues<V>(\n  breakpointValues: Responsive<V>,\n  breakpoints: Breakpoints = defaultBreakpoints\n) {\n  const current = useBreakpoints(breakpoints);\n\n  const breakpoint = Object.entries(breakpointValues).reduce((p, c) => {\n    const key = c[0]; // first entry in breakpoint values is the key\n    return current[key] ? c : p; // if current breakpoint is true, return it, else stay with previous\n  });\n\n  return breakpoint[1]; // second entry in breakpoint values is the value\n}\n"],"names":["defaultBreakpoints","useBreakpoints"],"mappings":";;;;;;;;AAUA;;;;;;AAMG;SACa,mBAAmB,CACjC,gBAA+B,EAC/B,cAA2BA,8CAAkB,EAAA;AAE7C,IAAA,MAAM,OAAO,GAAGC,0CAAc,CAAC,WAAW,CAAC,CAAC;AAE5C,IAAA,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAI;QAClE,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjB,QAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC9B,KAAC,CAAC,CAAC;AAEH,IAAA,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB;;;;;;;"}