@oracle/oraclejet-preact 18.1.7 → 18.1.8

package/es/useSelection-0bd0618d.js

@@ -0,0 +1,186 @@
+/* @oracle/oraclejet-preact: undefined */
+import { useState, useRef, useCallback } from 'preact/hooks';
+import { i as isEqual } from './eventsUtils-e5fc62d5.js';
+import { jsx } from 'preact/jsx-runtime';
+import { B as BaseButton } from './BaseButton-61f6baa8.js';
+import { T as Text } from './Text-f8d4ff78.js';
+import { u as useTranslationBundle } from './useTranslationBundle-09302c20.js';
+import { clearButtonStyles } from './hooks/PRIVATE_useVisSelection/themes/ClearSelection.css.js';
+import { L as Layer } from './Layer-446bf21e.js';
+import 'preact/compat';
+import './LayerHost-e6402730.js';
+import { F as Floating } from './Floating-f02677ba.js';
+
+/**
+ * Clear selection button component
+ */
+const ClearSelectionButton = ({ onAction }) => {
+    const translations = useTranslationBundle('@oracle/oraclejet-preact');
+    const clearSelectionLabel = `${translations.vis_clearSelection()}`;
+    return (jsx("div", { class: clearButtonStyles.base, children: jsx(BaseButton, { styling: ['default'], elementDetails: { type: 'span', isFocusable: false, isLabel: true }, variant: "outlined", onAction: onAction, children: jsx(Text, { truncation: 'ellipsis', weight: 'inherit', children: clearSelectionLabel }) }) }));
+};
+
+/**
+ * The default offset for clear selection mainAxis.
+ */
+const DEFAULT_OFFSET = 18;
+function useClearSelection({ clearSelection }) {
+    const [isVisible, setIsVisible] = useState(false);
+    const coordinates = useRef({ x: 0, y: 0 });
+    const tryToggleClearButton = (event, key, selectionMode, selectedIds) => {
+        if (event.pointerType === 'touch' &&
+            key === undefined &&
+            selectionMode === 'multiple' &&
+            selectedIds.size > 1) {
+            setIsVisible(!isVisible);
+            coordinates.current = { x: event.clientX, y: event.clientY };
+            return true;
+        }
+        return false;
+    };
+    const offsetValue = { mainAxis: 2 * DEFAULT_OFFSET };
+    const anchorRef = { current: coordinates.current };
+    const clearSelectionContent = isVisible ? (jsx(Layer, { children: jsx(Floating, { anchorRef: anchorRef, offsetValue: offsetValue, placement: "top", flipOptions: { crossAxis: false, mainAxis: false }, shiftOptions: { crossAxis: true, mainAxis: true }, children: jsx(ClearSelectionButton, { onAction: () => {
+                    setIsVisible(false);
+                    clearSelection();
+                } }) }) })) : null;
+    return {
+        clearSelectionContent,
+        tryToggleClearButton
+    };
+}
+
+/**
+ * @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 NAVKEYS = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'];
+/**
+ * The constant that defines time to wait to change selection after pointer up is fired.
+ * If double click didn't happen
+ */
+const DBLCLICK_THRESHOLD = 250;
+/**
+ * Handles the selection.
+ * @param itemId The id of the item.
+ * @param selectedIds The set of selected item ids.
+ * @param selectionMode The selection mode.
+ * @param selectionBehavior The selection behavior. If 'toggle', unselected item will be selected and
+ * vice versa. If 'replace', the item will replace the previous selection.
+ * @param getDataById The callback to get item data from idDataMap.
+ * @param onChange The callback to trigger when selection changes.
+ */
+const handleSelect = (itemId, selectedIds, selectionMode, selectionBehavior, getDataById, onChange) => {
+    let ids = new Set([]);
+    if (itemId != null) {
+        ids = new Set(selectedIds);
+        const isSelected = selectedIds.has(itemId);
+        if (selectionBehavior === 'toggle') {
+            if (isSelected) {
+                ids.delete(itemId);
+            }
+            else if (selectionMode === 'single') {
+                ids = new Set([itemId]); // only selection
+            }
+            else {
+                ids.add(itemId); // add to selection in "multiple" selectionMode
+            }
+        }
+        else if (!isSelected) {
+            // In "multiple" selection mode, only replace selection if unselected item is selected.
+            // In "single" selection mode, only need to replace if unselected item is selected.
+            ids = new Set([itemId]);
+        }
+    }
+    if (!isEqual(ids, selectedIds)) {
+        onChange?.({ ids: [...ids], data: [...ids].map(getDataById) });
+    }
+};
+/**
+ * The hook to handle the selection behavior in vizualization components.
+ */
+function useSelection({ selection = [], selectionMode = 'none', idExtracter, onChange, isDrillEnabled, isKeyboardSelection, getDataById, ignoreAsTrigger }) {
+    const setTimeOutRef = useRef();
+    const clearSelection = () => {
+        handleSelect(undefined, new Set(selection), selectionMode, 'replace', getDataById, onChange);
+    };
+    const { clearSelectionContent, tryToggleClearButton } = useClearSelection({ clearSelection });
+    const onPointerUp = useCallback((event) => {
+        // ignore pointer up when marquee is released
+        if (ignoreAsTrigger && ignoreAsTrigger(event.target)) {
+            return;
+        }
+        const selectedIds = new Set(selection);
+        if (setTimeOutRef.current && isDrillEnabled) {
+            clearTimeout(setTimeOutRef.current);
+            setTimeOutRef.current = undefined;
+            // doubleClick happened
+            return;
+        }
+        const key = idExtracter(event);
+        if (tryToggleClearButton(event, key, selectionMode, selectedIds)) {
+            return;
+        }
+        const isMeta = event.metaKey;
+        const isCtrl = event.ctrlKey;
+        // If there was a previous pointerUp event that occurred that should prevent selection,
+        // event.preventDefault was called
+        if (event.defaultPrevented || (key == null && (isMeta || isCtrl))) {
+            return;
+        }
+        // TODO: Encorporate more logic of dvt.EventManager.prototype._onClick
+        // this is a simple version of EventManager.prototype._onClick. Currently we are not checking
+        // for event.pageX, event.pageY to determine if they are exactly clicked on the same point.
+        // for now, the assumption is that if the pointerups are within 250ms, they are for a same double click.
+        if (isDrillEnabled) {
+            setTimeOutRef.current = setTimeout(() => {
+                // double pointer up didn't happen
+                handleSelect(key, selectedIds, selectionMode, isMeta || isCtrl || event.pointerType === 'touch' ? 'toggle' : 'replace', getDataById, onChange);
+                setTimeOutRef.current = undefined;
+            }, DBLCLICK_THRESHOLD);
+        }
+        else {
+            handleSelect(key, selectedIds, selectionMode, isMeta || isCtrl || event.pointerType === 'touch' ? 'toggle' : 'replace', getDataById, onChange);
+        }
+    }, [
+        selection,
+        selectionMode,
+        onChange,
+        idExtracter,
+        isDrillEnabled,
+        getDataById,
+        tryToggleClearButton,
+        ignoreAsTrigger
+    ]);
+    const onContextMenu = useCallback((event) => {
+        const key = idExtracter(event);
+        const isCtrl = event.ctrlKey;
+        handleSelect(key, new Set(selection), selectionMode, isCtrl ? 'toggle' : 'replace', getDataById, onChange);
+    }, [selection, selectionMode, onChange, idExtracter, getDataById]);
+    const onKeyUp = useCallback((event) => {
+        const isShift = event.shiftKey;
+        const isSpaceCtrl = event.ctrlKey && event.key === ' ';
+        const isArrowKey = NAVKEYS.indexOf(event.key) !== -1;
+        const itemKey = idExtracter(event);
+        if (isArrowKey || isSpaceCtrl || (isKeyboardSelection && isKeyboardSelection(event))) {
+            const behavior = isShift || isSpaceCtrl ? 'toggle' : 'replace';
+            handleSelect(itemKey, new Set(selection), selectionMode, behavior, getDataById, onChange);
+        }
+    }, [selection, selectionMode, onChange, idExtracter, isKeyboardSelection, getDataById]);
+    return {
+        selectionContent: clearSelectionContent,
+        selectionProps: selectionMode === 'none' || onChange == null
+            ? {}
+            : {
+                onKeyUp,
+                onContextMenu,
+                onPointerUp
+            }
+    };
+}
+
+export { useSelection as u };
+//# sourceMappingURL=useSelection-0bd0618d.js.map

package/es/useSelection-0bd0618d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection-0bd0618d.js","sources":["../../src/hooks/PRIVATE_useVisSelection/ClearSelectionButton.tsx","../../src/hooks/PRIVATE_useVisSelection/useClearSelection.tsx","../../src/hooks/PRIVATE_useVisSelection/useSelection.tsx"],"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 { BaseButton } from '#UNSAFE_BaseButton';\nimport { Text } from '#UNSAFE_Text';\nimport { useTranslationBundle } from '#hooks/UNSAFE_useTranslationBundle';\nimport type { BundleType } from '#resources/nls/bundle';\nimport { clearButtonStyles } from './themes/ClearSelection.css';\n\ntype Props = {\n  onAction: () => void;\n};\n\n/**\n * Clear selection button component\n */\nexport const ClearSelectionButton = ({ onAction }: Props) => {\n  const translations = useTranslationBundle<BundleType>('@oracle/oraclejet-preact');\n  const clearSelectionLabel = `${translations.vis_clearSelection()}`;\n  return (\n    <div class={clearButtonStyles.base}>\n      <BaseButton\n        styling={['default']}\n        elementDetails={{ type: 'span', isFocusable: false, isLabel: true }}\n        variant=\"outlined\"\n        onAction={onAction}>\n        <Text truncation={'ellipsis'} weight={'inherit'}>\n          {clearSelectionLabel}\n        </Text>\n      </BaseButton>\n    </div>\n  );\n};\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { useRef, useState } from 'preact/hooks';\nimport { ClearSelectionButton } from './ClearSelectionButton';\nimport { Layer } from '#UNSAFE_Layer';\nimport { Floating } from '#UNSAFE_Floating';\n\n/**\n * The default offset for clear selection mainAxis.\n */\nconst DEFAULT_OFFSET = 18;\ntype Props = {\n  clearSelection: () => void;\n};\ntype SelectionMode = 'none' | 'single' | 'multiple';\n\nexport function useClearSelection<K>({ clearSelection }: Props) {\n  const [isVisible, setIsVisible] = useState(false);\n  const coordinates = useRef({ x: 0, y: 0 });\n\n  const tryToggleClearButton = (\n    event: PointerEvent,\n    key: K | undefined,\n    selectionMode: SelectionMode,\n    selectedIds: Set<K>\n  ) => {\n    if (\n      event.pointerType === 'touch' &&\n      key === undefined &&\n      selectionMode === 'multiple' &&\n      selectedIds.size > 1\n    ) {\n      setIsVisible(!isVisible);\n      coordinates.current = { x: event.clientX, y: event.clientY };\n      return true;\n    }\n    return false;\n  };\n\n  const offsetValue = { mainAxis: 2 * DEFAULT_OFFSET };\n  const anchorRef = { current: coordinates.current };\n\n  const clearSelectionContent = isVisible ? (\n    <Layer>\n      <Floating\n        anchorRef={anchorRef}\n        offsetValue={offsetValue}\n        placement=\"top\"\n        flipOptions={{ crossAxis: false, mainAxis: false }}\n        shiftOptions={{ crossAxis: true, mainAxis: true }}>\n        <ClearSelectionButton\n          onAction={() => {\n            setIsVisible(false);\n            clearSelection();\n          }}\n        />\n      </Floating>\n    </Layer>\n  ) : null;\n\n  return {\n    clearSelectionContent,\n    tryToggleClearButton\n  };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { useCallback, useRef } from 'preact/hooks';\nimport { isEqual } from '#utils/UNSAFE_visUtils/eventsUtils';\nimport { useClearSelection } from './useClearSelection';\n\nexport type SelectionMode = 'none' | 'single' | 'multiple';\nexport type SelectionDetail<K, D> = {\n  ids: K[];\n  data: (D | undefined)[];\n};\ntype SelectionBehavior = 'toggle' | 'replace';\n\nconst NAVKEYS = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'];\n\n/**\n * The constant that defines time to wait to change selection after pointer up is fired.\n * If double click didn't happen\n */\nconst DBLCLICK_THRESHOLD = 250;\n\n/**\n * Handles the selection.\n * @param itemId The id of the item.\n * @param selectedIds The set of selected item ids.\n * @param selectionMode The selection mode.\n * @param selectionBehavior The selection behavior. If 'toggle', unselected item will be selected and\n * vice versa. If 'replace', the item will replace the previous selection.\n * @param getDataById The callback to get item data from idDataMap.\n * @param onChange The callback to trigger when selection changes.\n */\nconst handleSelect = <K, D>(\n  itemId: K | undefined,\n  selectedIds: Set<K>,\n  selectionMode: SelectionMode,\n  selectionBehavior: SelectionBehavior,\n  getDataById: (id: K) => D | undefined,\n  onChange?: (detail: SelectionDetail<K, D>) => void\n) => {\n  let ids = new Set<K>([]);\n  if (itemId != null) {\n    ids = new Set(selectedIds);\n    const isSelected = selectedIds.has(itemId);\n\n    if (selectionBehavior === 'toggle') {\n      if (isSelected) {\n        ids.delete(itemId);\n      } else if (selectionMode === 'single') {\n        ids = new Set([itemId]); // only selection\n      } else {\n        ids.add(itemId); // add to selection in \"multiple\" selectionMode\n      }\n    } else if (!isSelected) {\n      // In \"multiple\" selection mode, only replace selection if unselected item is selected.\n      // In \"single\" selection mode, only need to replace if unselected item is selected.\n      ids = new Set([itemId]);\n    }\n  }\n\n  if (!isEqual<K>(ids, selectedIds)) {\n    onChange?.({ ids: [...ids], data: [...ids].map(getDataById) });\n  }\n};\n\ntype Props<K, D> = {\n  selection?: K[];\n  selectionMode?: SelectionMode;\n  idExtracter: (event: Event) => K | undefined;\n  onChange?: (detail: SelectionDetail<K, D>) => void;\n  isKeyboardSelection?: (event: KeyboardEvent) => boolean;\n  isDrillEnabled?: boolean;\n  getDataById: (id: K) => D | undefined;\n  ignoreAsTrigger?: (element: EventTarget | null) => boolean;\n};\n\n/**\n * The hook to handle the selection behavior in vizualization components.\n */\nexport function useSelection<K, D>({\n  selection = [],\n  selectionMode = 'none',\n  idExtracter,\n  onChange,\n  isDrillEnabled,\n  isKeyboardSelection,\n  getDataById,\n  ignoreAsTrigger\n}: Props<K, D>) {\n  const setTimeOutRef = useRef<ReturnType<typeof setTimeout>>();\n\n  const clearSelection = () => {\n    handleSelect<K, D>(\n      undefined,\n      new Set(selection),\n      selectionMode,\n      'replace',\n      getDataById,\n      onChange\n    );\n  };\n\n  const { clearSelectionContent, tryToggleClearButton } = useClearSelection<K>({ clearSelection });\n\n  const onPointerUp = useCallback(\n    (event: PointerEvent) => {\n      // ignore pointer up when marquee is released\n      if (ignoreAsTrigger && ignoreAsTrigger(event.target)) {\n        return;\n      }\n\n      const selectedIds = new Set(selection);\n      if (setTimeOutRef.current && isDrillEnabled) {\n        clearTimeout(setTimeOutRef.current);\n        setTimeOutRef.current = undefined;\n        // doubleClick happened\n        return;\n      }\n\n      const key = idExtracter(event);\n\n      if (tryToggleClearButton(event, key, selectionMode, selectedIds)) {\n        return;\n      }\n\n      const isMeta = event.metaKey;\n      const isCtrl = event.ctrlKey;\n      // If there was a previous pointerUp event that occurred that should prevent selection,\n      // event.preventDefault was called\n      if (event.defaultPrevented || (key == null && (isMeta || isCtrl))) {\n        return;\n      }\n\n      // TODO: Encorporate more logic of dvt.EventManager.prototype._onClick\n      // this is a simple version of EventManager.prototype._onClick. Currently we are not checking\n      // for event.pageX, event.pageY to determine if they are exactly clicked on the same point.\n      // for now, the assumption is that if the pointerups are within 250ms, they are for a same double click.\n      if (isDrillEnabled) {\n        setTimeOutRef.current = setTimeout(() => {\n          // double pointer up didn't happen\n          handleSelect<K, D>(\n            key,\n            selectedIds,\n            selectionMode,\n            isMeta || isCtrl || event.pointerType === 'touch' ? 'toggle' : 'replace',\n            getDataById,\n            onChange\n          );\n          setTimeOutRef.current = undefined;\n        }, DBLCLICK_THRESHOLD);\n      } else {\n        handleSelect<K, D>(\n          key,\n          selectedIds,\n          selectionMode,\n          isMeta || isCtrl || event.pointerType === 'touch' ? 'toggle' : 'replace',\n          getDataById,\n          onChange\n        );\n      }\n    },\n    [\n      selection,\n      selectionMode,\n      onChange,\n      idExtracter,\n      isDrillEnabled,\n      getDataById,\n      tryToggleClearButton,\n      ignoreAsTrigger\n    ]\n  );\n\n  const onContextMenu = useCallback(\n    (event: MouseEvent) => {\n      const key = idExtracter(event);\n      const isCtrl = event.ctrlKey;\n      handleSelect<K, D>(\n        key,\n        new Set(selection),\n        selectionMode,\n        isCtrl ? 'toggle' : 'replace',\n        getDataById,\n        onChange\n      );\n    },\n    [selection, selectionMode, onChange, idExtracter, getDataById]\n  );\n\n  const onKeyUp = useCallback(\n    (event: KeyboardEvent) => {\n      const isShift = event.shiftKey;\n      const isSpaceCtrl = event.ctrlKey && event.key === ' ';\n      const isArrowKey = NAVKEYS.indexOf(event.key) !== -1;\n      const itemKey = idExtracter(event);\n\n      if (isArrowKey || isSpaceCtrl || (isKeyboardSelection && isKeyboardSelection(event))) {\n        const behavior = isShift || isSpaceCtrl ? 'toggle' : 'replace';\n        handleSelect<K, D>(\n          itemKey,\n          new Set(selection),\n          selectionMode,\n          behavior,\n          getDataById,\n          onChange\n        );\n      }\n    },\n    [selection, selectionMode, onChange, idExtracter, isKeyboardSelection, getDataById]\n  );\n\n  return {\n    selectionContent: clearSelectionContent,\n    selectionProps:\n      selectionMode === 'none' || onChange == null\n        ? {}\n        : {\n            onKeyUp,\n            onContextMenu,\n            onPointerUp\n          }\n  };\n}\n"],"names":["_jsx"],"mappings":"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"}

package/es/useSelection-649fd4f1.js

@@ -0,0 +1,239 @@
+/* @oracle/oraclejet-preact: undefined */
+import { useRef, useCallback } from 'preact/hooks';
+import { i as isKeyDefined, c as containsKey, a as addKey, r as removeKey } from './keys-49c92dbb.js';
+import { u as useUser } from './useUser-1cd223a9.js';
+import { g as getIsSelectionPending } from './textSelectionUtils-a6554a42.js';
+
+const arrowKeys = new Set(['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown']);
+/**
+ * To get the event type during range selection which is triggered by either of the following gestures
+ * shift+space, shift+click, and shift+arrowKeys
+ * @param event
+ */
+const getEventType = (event) => {
+    if (event.type === 'click') {
+        return 'shiftClick';
+    }
+    else if (event.type === 'keyup' && event.key === ' ') {
+        return 'shiftSpace';
+    }
+    else if (event.type === 'keydown' && arrowKeys.has(event.key)) {
+        return 'shiftArrowKeys';
+    }
+    return undefined;
+};
+const isShiftModeSupported = (anchorKey, selectedKeys, selectionMode, isClickEvent) => {
+    return selectionMode === 'multiple' && (isClickEvent || 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, event.type === 'click')) {
+        const selected = containsKey(selectedKeys, itemKey);
+        const eventType = getEventType(event);
+        if (selected && eventType === 'shiftSpace') {
+            // during shift+space, deselect the item if it's already selected
+            const keySet = removeKey(selectedKeys, itemKey, isSelectionRequired);
+            onChange?.({ value: keySet, target: event.target });
+        }
+        else {
+            onRangeChange({ value: { start: anchorKey, end: itemKey }, eventType });
+        }
+        // set keyboard selection cursor in case user extends with SHIFT+ARROW
+        if (keyboardCursorRef) {
+            keyboardCursorRef.current = itemKey;
+        }
+        return;
+    }
+    const selected = 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 = 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 = 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 isSelectionRequired true if empty selected key is not allowed, false otherwise
+ * @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 onChange callback function that is invoked when selection has changed.
+ * @param anchorKey the anchor key.  Usually this is the same as current key except when shift key is pressed.
+ * @param currentKey the current key
+ * @param getVerticalPrevNextKey function to get the previous/next key in the vertical direction based on the current key
+ * @param getHorizontalPrevNextKey function to get the previous/next key in the horizontal direction based on the current key
+ * @param scrollToKey function to scroll the item with the key to be visible
+ * @param onRangeChange callback function that is invoked when the selection range has changed.
+ * @returns an event map that the consumer can register as event listeners
+ */
+function useSelection(keyExtractor, selectedKeys, selectionMode, isSelectionRequired, selectionBehavior, onChange, anchorKey, currentKey, getVerticalPrevNextKey, getHorizontalPrevNextKey, scrollToKey, onRangeChange) {
+    // ref to track the cursor for the SHIFT+ARROW keyboard selection separately than the anchor of the selection.
+    const keyboardSelectionCursor = useRef();
+    const isTouchPointerRef = useRef(false);
+    const onPointerDown = useCallback((event) => {
+        isTouchPointerRef.current = event.pointerType === 'touch';
+        if (event.shiftKey && selectionMode === 'multiple') {
+            //Avoid text selection on pointer down
+            event.preventDefault();
+        }
+    }, [selectionMode, isTouchPointerRef]);
+    const onClick = useCallback((event) => {
+        if (!getIsSelectionPending()) {
+            handleSelect(event, keyExtractor, selectedKeys, selectionMode, isTouchPointerRef.current ? 'toggle' : selectionBehavior, isSelectionRequired, keyboardSelectionCursor, currentKey, onChange, onRangeChange);
+            if (!event.shiftKey) {
+                // reset keyboard cursor when using mouse to select
+                keyboardSelectionCursor.current = undefined;
+            }
+        }
+    }, [
+        keyExtractor,
+        selectedKeys,
+        selectionMode,
+        selectionBehavior,
+        isSelectionRequired,
+        keyboardSelectionCursor,
+        currentKey,
+        onChange,
+        onRangeChange
+    ]);
+    // general keyboard events listen to keyUp for a11y
+    const onKeyUp = useCallback((event) => {
+        // older browser that we don't support returns 'Spacebar' for space key
+        if (event.key === ' ') {
+            handleSelect(event, keyExtractor, selectedKeys, selectionMode, selectionBehavior, isSelectionRequired, keyboardSelectionCursor, anchorKey, onChange, event.shiftKey && event.key === ' ' ? onRangeChange : undefined);
+        }
+    }, [
+        keyExtractor,
+        selectedKeys,
+        selectionMode,
+        selectionBehavior,
+        isSelectionRequired,
+        anchorKey,
+        onChange,
+        onRangeChange
+    ]);
+    const { direction } = useUser();
+    // arrowKey events listen to keyDown so they can support holding them down
+    const onKeyDown = useCallback((event) => {
+        // prevent default (propagation) for keyDown to space bar causing container to scroll
+        if (event.key === ' ') {
+            event.preventDefault();
+            return;
+        }
+        const key = keyboardSelectionCursor.current || currentKey;
+        const isRtl = direction === 'rtl';
+        const keyHandlers = {
+            ArrowUp: getVerticalPrevNextKey?.(key, true),
+            ArrowDown: getVerticalPrevNextKey?.(key, false),
+            ArrowLeft: getHorizontalPrevNextKey?.(key, !isRtl),
+            ArrowRight: getHorizontalPrevNextKey?.(key, isRtl)
+        };
+        const isBothDirections = getVerticalPrevNextKey && getHorizontalPrevNextKey;
+        if (Object.keys(keyHandlers).includes(event.key)) {
+            if (event.shiftKey && scrollToKey && selectionMode === 'multiple') {
+                //Avoid increasing range of selection text selection with arrow keys
+                event.preventDefault();
+                let keySet = selectedKeys;
+                // on first selection event, set keyboard cursor to start at currentKey
+                if (!keyboardSelectionCursor.current && isKeyDefined(currentKey)) {
+                    keySet = { all: false, keys: new Set([currentKey]) };
+                }
+                const newAnchorKey = keyHandlers[event.key];
+                const cursorKey = newAnchorKey?.();
+                if (cursorKey != null) {
+                    // keep visible
+                    scrollToKey(cursorKey);
+                    // if in 2D, use range selection to extend or subtract
+                    if (isBothDirections) {
+                        if (onRangeChange && currentKey != null) {
+                            onRangeChange({
+                                value: { start: currentKey, end: cursorKey },
+                                eventType: getEventType(event)
+                            });
+                        }
+                    }
+                    else {
+                        // extend selection
+                        if (!containsKey(keySet, cursorKey)) {
+                            keySet = addKey(keySet, cursorKey);
+                            // subtract from selection
+                        }
+                        else if (keyboardSelectionCursor.current != null &&
+                            keyboardSelectionCursor.current !== cursorKey) {
+                            keySet = removeKey(keySet, keyboardSelectionCursor.current, isSelectionRequired);
+                        }
+                        if (selectedKeys != keySet && onChange) {
+                            onChange({ value: keySet, target: event.target });
+                        }
+                    }
+                    // update selection cursor
+                    keyboardSelectionCursor.current = cursorKey;
+                }
+            }
+            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,
+        getVerticalPrevNextKey,
+        getHorizontalPrevNextKey,
+        scrollToKey,
+        direction,
+        onRangeChange,
+        selectionMode
+    ]);
+    const selectionProps = selectionMode === 'none' || onChange == null
+        ? {}
+        : { onPointerDown, onClick, onKeyDown, onKeyUp };
+    return { selectionProps };
+}
+
+export { useSelection as u };
+//# sourceMappingURL=useSelection-649fd4f1.js.map

package/es/useSelection-649fd4f1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection-649fd4f1.js","sources":["../../src/hooks/PRIVATE_useSelection/useSelection.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 type { RefObject } from 'preact';\nimport { useCallback, useRef } from 'preact/hooks';\nimport { Keys, containsKey, isKeyDefined, addKey, removeKey } from '../../utils/UNSAFE_keys';\nimport { SelectionDetail, SelectionMode } from '../../UNSAFE_Collection';\nimport { useUser } from '../UNSAFE_useUser';\nimport { getIsSelectionPending } from '#utils/PRIVATE_textSelectionUtils';\nimport { SelectionBehavior, SelectionRangeDetail } from './Selection.types';\n\nconst arrowKeys = new Set(['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown']);\n\n/**\n * To get the event type during range selection which is triggered by either of the following gestures\n * shift+space, shift+click, and shift+arrowKeys\n * @param event\n */\nconst getEventType = (event: MouseEvent | KeyboardEvent) => {\n  if (event.type === 'click') {\n    return 'shiftClick';\n  } else if (event.type === 'keyup' && (event as KeyboardEvent).key === ' ') {\n    return 'shiftSpace';\n  } else if (event.type === 'keydown' && arrowKeys.has((event as KeyboardEvent).key)) {\n    return 'shiftArrowKeys';\n  }\n  return undefined;\n};\n\nconst isShiftModeSupported = <K>(\n  anchorKey: K,\n  selectedKeys: Keys<K>,\n  selectionMode: SelectionMode,\n  isClickEvent: boolean\n) => {\n  return selectionMode === 'multiple' && (isClickEvent || containsKey(selectedKeys, anchorKey));\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, event.type === 'click')\n  ) {\n    const selected = containsKey(selectedKeys, itemKey);\n    const eventType = getEventType(event);\n    if (selected && eventType === 'shiftSpace') {\n      // during shift+space, deselect the item if it's already selected\n      const keySet = removeKey(selectedKeys, itemKey, isSelectionRequired);\n      onChange?.({ value: keySet, target: event.target });\n    } else {\n      onRangeChange({ value: { start: anchorKey, end: itemKey }, eventType });\n    }\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 isSelectionRequired true if empty selected key is not allowed, false otherwise\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 onChange callback function that is invoked when selection has changed.\n * @param anchorKey the anchor key.  Usually this is the same as current key except when shift key is pressed.\n * @param currentKey the current key\n * @param getVerticalPrevNextKey function to get the previous/next key in the vertical direction based on the current key\n * @param getHorizontalPrevNextKey function to get the previous/next key in the horizontal direction based on the current key\n * @param scrollToKey function to scroll the item with the key to be visible\n * @param onRangeChange callback function that is invoked when the selection range 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  getVerticalPrevNextKey?: (currentKey: K | undefined, isPrev: boolean) => () => K | null,\n  getHorizontalPrevNextKey?: (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 isTouchPointerRef = useRef<boolean>(false);\n\n  const onPointerDown = useCallback(\n    (event: PointerEvent) => {\n      isTouchPointerRef.current = event.pointerType === 'touch';\n      if (event.shiftKey && selectionMode === 'multiple') {\n        //Avoid text selection on pointer down\n        event.preventDefault();\n      }\n    },\n    [selectionMode, isTouchPointerRef]\n  );\n\n  const onClick = useCallback(\n    (event: MouseEvent) => {\n      if (!getIsSelectionPending()) {\n        handleSelect<K>(\n          event,\n          keyExtractor,\n          selectedKeys,\n          selectionMode,\n          isTouchPointerRef.current ? 'toggle' : selectionBehavior,\n          isSelectionRequired,\n          keyboardSelectionCursor,\n          currentKey,\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    [\n      keyExtractor,\n      selectedKeys,\n      selectionMode,\n      selectionBehavior,\n      isSelectionRequired,\n      keyboardSelectionCursor,\n      currentKey,\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 === ' ') {\n        handleSelect<K>(\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  const { direction } = useUser();\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      const key = keyboardSelectionCursor.current || currentKey;\n      const isRtl = direction === 'rtl';\n\n      const keyHandlers: Record<string, (() => K | null) | undefined> = {\n        ArrowUp: getVerticalPrevNextKey?.(key, true),\n        ArrowDown: getVerticalPrevNextKey?.(key, false),\n        ArrowLeft: getHorizontalPrevNextKey?.(key, !isRtl),\n        ArrowRight: getHorizontalPrevNextKey?.(key, isRtl)\n      };\n      const isBothDirections = getVerticalPrevNextKey && getHorizontalPrevNextKey;\n      if (Object.keys(keyHandlers).includes(event.key)) {\n        if (event.shiftKey && scrollToKey && selectionMode === 'multiple') {\n          //Avoid increasing range of selection text selection with arrow keys\n          event.preventDefault();\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 = keyHandlers[event.key];\n          const cursorKey = newAnchorKey?.();\n          if (cursorKey != null) {\n            // keep visible\n            scrollToKey(cursorKey);\n\n            // if in 2D, use range selection to extend or subtract\n            if (isBothDirections) {\n              if (onRangeChange && currentKey != null) {\n                onRangeChange({\n                  value: { start: currentKey, end: cursorKey },\n                  eventType: getEventType(event)\n                });\n              }\n            } else {\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              if (selectedKeys != keySet && onChange) {\n                onChange({ value: keySet, target: event.target });\n              }\n            }\n            // update selection cursor\n            keyboardSelectionCursor.current = cursorKey;\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    [\n      selectedKeys,\n      isSelectionRequired,\n      onChange,\n      currentKey,\n      getVerticalPrevNextKey,\n      getHorizontalPrevNextKey,\n      scrollToKey,\n      direction,\n      onRangeChange,\n      selectionMode\n    ]\n  );\n\n  const selectionProps =\n    selectionMode === 'none' || onChange == null\n      ? {}\n      : { onPointerDown, onClick, onKeyDown, onKeyUp };\n  return { selectionProps };\n}\n"],"names":[],"mappings":"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"}

package/es/useTabBar-cbac0c2e.js

@@ -3,7 +3,7 @@ import { useRef, useState, useEffect, useCallback } from 'preact/hooks';
 import { m as mergeProps } from './mergeProps-88ea8306.js';
 import { a as getKey, c as getPrevNextKeyUsingRef, k as keyExtractor, f as findElementByKey, d as getFirstVisibleKey } from './collectionUtils-8a9d80a3.js';
 import { u as useCollectionFocusRing } from './useCollectionFocusRing-de20f4fc.js';
-import { u as useCurrentKey } from './useCurrentKey-b8e62707.js';
+import { u as useCurrentKey } from './useCurrentKey-7287061f.js';
 import { u as useId } from './useId-03dbfdf0.js';
 import { u as useReorderableContext } from './useReorderableContext-79b1c941.js';
 import { u as useContextMenuGesture } from './useContextMenuGesture-9b95a1bb.js';

package/es/useTestId-9b504481.js

@@ -0,0 +1,21 @@
+/* @oracle/oraclejet-preact: undefined */
+import { E as EnvironmentContext } from './LayerHost-e6402730.js';
+import 'preact/jsx-runtime';
+import { useContext } from 'preact/hooks';
+import 'preact/compat';
+
+/**
+ * Returns the set of attributes to be applied to the DOM node if the application's mode is not
+ * set to "production".
+ */
+function useTestId(testId) {
+    const context = useContext(EnvironmentContext);
+    return context.mode === 'production' || testId === ''
+        ? {}
+        : {
+            'data-testid': testId
+        };
+}
+
+export { useTestId as u };
+//# sourceMappingURL=useTestId-9b504481.js.map

package/es/useTestId-9b504481.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTestId-9b504481.js","sources":["../../src/hooks/UNSAFE_useTestId/useTestId.ts"],"sourcesContent":["import { EnvironmentContext } from '../../UNSAFE_Environment';\nimport { useContext } from 'preact/hooks';\n\nexport type TestIdProps = {\n  testId?: string;\n};\n/**\n * Returns the set of attributes to be applied to the DOM node if the application's mode is not\n * set to \"production\".\n */\nexport function useTestId(testId?: string) {\n  const context = useContext(EnvironmentContext);\n  return context.mode === 'production' || testId === ''\n    ? {}\n    : {\n        'data-testid': testId\n      };\n}\n"],"names":[],"mappings":";;;;;;AAMA;;;AAGG;AACG,SAAU,SAAS,CAAC,MAAe,EAAA;AACvC,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,KAAK,EAAE;AACnD,UAAE,EAAE;AACJ,UAAE;AACE,YAAA,aAAa,EAAE,MAAM;SACtB,CAAC;AACR;;;;"}

package/es/useTheme-93c07059.js

@@ -0,0 +1,19 @@
+/* @oracle/oraclejet-preact: undefined */
+import { useContext } from 'preact/hooks';
+import { E as EnvironmentContext } from './LayerHost-e6402730.js';
+import 'preact/jsx-runtime';
+import 'preact/compat';
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function useTheme() {
+    return useContext(EnvironmentContext).theme;
+}
+
+export { useTheme as u };
+//# sourceMappingURL=useTheme-93c07059.js.map

package/es/useTheme-93c07059.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme-93c07059.js","sources":["../../src/hooks/UNSAFE_useTheme/useTheme.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 { useContext } from 'preact/hooks';\nimport { EnvironmentContext } from '../../UNSAFE_Environment';\n\nexport function useTheme() {\n  return useContext(EnvironmentContext).theme;\n}\n"],"names":[],"mappings":";;;;;;AAAA;;;;;;AAMG;SAKa,QAAQ,GAAA;AACtB,IAAA,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC;AAC9C;;;;"}

package/es/useThemeInterpolations-8dd8029f.js

@@ -0,0 +1,57 @@
+/* @oracle/oraclejet-preact: undefined */
+import { useState, useLayoutEffect } from 'preact/hooks';
+import { u as useColorScheme } from './useColorScheme-c4e237ad.js';
+import { u as useScale } from './useScale-83881775.js';
+import { t as themeInterpolations } from './theme-63551f30.js';
+import { m as mergeInterpolations } from './mergeInterpolations-e2db2a66.js';
+import { D as DefaultEnvironment } from './LayerHost-e6402730.js';
+import { I as INVERT_CLASS, D as DARK_CLASS } from './Theme-e6dec6db.js';
+import { u as useDensity } from './useDensity-c17603b2.js';
+
+// This hook encapsulates the logic required to determine which theme style classes are needed
+// for the current environment context's colorScheme, density, and scale value.  This would be used when
+// rendering dom outside of the current dom tree, but desire to match the colorScheme, density, and scale
+// of the original dom tree.
+function useThemeInterpolations(logicalParentRef) {
+    const [colorScheme, setColorScheme] = useState(undefined);
+    const currentColorScheme = useColorScheme();
+    const currentDensity = useDensity();
+    const currentScale = useScale();
+    // We don't want to interpolate the default environment values for scale or density. Those should get picked up by default.
+    // This fixes an issue for core pack components that utilize the Layer component, when in a legacy cookbook page.
+    const density = currentDensity !== DefaultEnvironment.density ? currentDensity : undefined;
+    const scale = currentScale !== DefaultEnvironment.scale ? currentScale : undefined;
+    // We want to use useLayoutEffect instead of useEffect here. Otherwise there could be
+    // flashing due to light colorScheme initial render then dark colorScheme after useEffect.
+    useLayoutEffect(() => {
+        // for colorScheme in Legacy, things are a bit more complicated because unlike scale which is always applied to
+        // the root dom element, we can switch to dark theme by adding the .oj-color-invert class to any dom element where
+        // we want the dark theme to start.  In Legacy, you can't switch back to light theme once you switch to dark (no nesting).
+        // The problem with our core pack Components that use Layer to display the dropdown, it is not in the same dom
+        // tree as the parent component.  It is in its own dom tree off of the root dom element, so it won't see the
+        // .oj-color-invert class in the dom tree of the select single.
+        // Since in legacy .oj-color-invert can appear anywhere, not just on the root dom element, if the colorScheme
+        // is the same as the default colorScheme then we need to look at the ref to determine if it or any of its
+        // ancestors has the .oj-color-invert class.  If it does(and doesn't have the preact .oj-c-colorscheme-dark class),
+        // use 'dark' colorScheme.
+        // We only want to do this for legacy, so if the closest element that has the .oj-color-invert also has .oj-c-colorscheme-dark,
+        // then we don't want to override since this isn't a legacy color change and we already handle it in our environment context
+        // so the color scheme nesting will work in Preact/Core Pack.
+        const closestElementWithColorInvertClass = logicalParentRef &&
+            logicalParentRef.current &&
+            typeof logicalParentRef.current.closest === 'function'
+            ? logicalParentRef.current.closest(`.${INVERT_CLASS}:not(.${DARK_CLASS})`)
+            : null;
+        setColorScheme(currentColorScheme !== DefaultEnvironment.colorScheme
+            ? currentColorScheme
+            : closestElementWithColorInvertClass
+                ? 'dark'
+                : undefined);
+    }, [logicalParentRef, currentColorScheme]);
+    const interpolations = mergeInterpolations([...Object.values(themeInterpolations)]);
+    const { class: classes } = interpolations({ colorScheme, scale, density });
+    return classes;
+}
+
+export { useThemeInterpolations as u };
+//# sourceMappingURL=useThemeInterpolations-8dd8029f.js.map

package/es/useThemeInterpolations-8dd8029f.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeInterpolations-8dd8029f.js","sources":["../../src/hooks/UNSAFE_useThemeInterpolations/useThemeInterpolations.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 type { RefObject } from 'preact';\nimport { useLayoutEffect, useState } from 'preact/hooks';\nimport { useColorScheme } from '../UNSAFE_useColorScheme';\nimport { useScale } from '../UNSAFE_useScale';\nimport { themeInterpolations } from '../../utils/UNSAFE_interpolations/theme';\nimport type { ThemeProps } from '../../utils/UNSAFE_interpolations/theme';\nimport { mergeInterpolations } from '../../utils/UNSAFE_mergeInterpolations';\nimport { DefaultEnvironment } from '../../UNSAFE_Environment/EnvironmentContext';\nimport { DARK_CLASS, INVERT_CLASS } from '../../UNSAFE_Theme';\nimport { useDensity } from '#hooks/UNSAFE_useDensity';\n\n/**\n * The logical parent of the re-parented content that 'launched' it in the popup/dropdown.\n */\ntype LogicalParentRef = RefObject<Element> | null;\n\n// This hook encapsulates the logic required to determine which theme style classes are needed\n// for the current environment context's colorScheme, density, and scale value.  This would be used when\n// rendering dom outside of the current dom tree, but desire to match the colorScheme, density, and scale\n// of the original dom tree.\nexport function useThemeInterpolations(logicalParentRef?: LogicalParentRef) {\n  const [colorScheme, setColorScheme] = useState<'light' | 'dark' | undefined>(undefined);\n\n  const currentColorScheme = useColorScheme();\n  const currentDensity = useDensity();\n  const currentScale = useScale();\n  // We don't want to interpolate the default environment values for scale or density. Those should get picked up by default.\n  // This fixes an issue for core pack components that utilize the Layer component, when in a legacy cookbook page.\n  const density = currentDensity !== DefaultEnvironment.density ? currentDensity : undefined;\n  const scale = currentScale !== DefaultEnvironment.scale ? currentScale : undefined;\n\n  // We want to use useLayoutEffect instead of useEffect here. Otherwise there could be\n  // flashing due to light colorScheme initial render then dark colorScheme after useEffect.\n  useLayoutEffect(() => {\n    // for colorScheme in Legacy, things are a bit more complicated because unlike scale which is always applied to\n    // the root dom element, we can switch to dark theme by adding the .oj-color-invert class to any dom element where\n    // we want the dark theme to start.  In Legacy, you can't switch back to light theme once you switch to dark (no nesting).\n    // The problem with our core pack Components that use Layer to display the dropdown, it is not in the same dom\n    // tree as the parent component.  It is in its own dom tree off of the root dom element, so it won't see the\n    // .oj-color-invert class in the dom tree of the select single.\n    // Since in legacy .oj-color-invert can appear anywhere, not just on the root dom element, if the colorScheme\n    // is the same as the default colorScheme then we need to look at the ref to determine if it or any of its\n    // ancestors has the .oj-color-invert class.  If it does(and doesn't have the preact .oj-c-colorscheme-dark class),\n    // use 'dark' colorScheme.\n    // We only want to do this for legacy, so if the closest element that has the .oj-color-invert also has .oj-c-colorscheme-dark,\n    // then we don't want to override since this isn't a legacy color change and we already handle it in our environment context\n    // so the color scheme nesting will work in Preact/Core Pack.\n    const closestElementWithColorInvertClass =\n      logicalParentRef &&\n      logicalParentRef.current &&\n      typeof logicalParentRef.current.closest === 'function'\n        ? logicalParentRef.current.closest(`.${INVERT_CLASS}:not(.${DARK_CLASS})`)\n        : null;\n    setColorScheme(\n      currentColorScheme !== DefaultEnvironment.colorScheme\n        ? currentColorScheme\n        : closestElementWithColorInvertClass\n        ? 'dark'\n        : undefined\n    );\n  }, [logicalParentRef, currentColorScheme]);\n\n  const interpolations = mergeInterpolations<ThemeProps>([...Object.values(themeInterpolations)]);\n  const { class: classes } = interpolations({ colorScheme, scale, density });\n  return classes;\n}\n"],"names":[],"mappings":";;;;;;;;;;AAuBA;AACA;AACA;AACA;AACM,SAAU,sBAAsB,CAAC,gBAAmC,EAAA;IACxE,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAA+B,SAAS,CAAC,CAAC;AAExF,IAAA,MAAM,kBAAkB,GAAG,cAAc,EAAE,CAAC;AAC5C,IAAA,MAAM,cAAc,GAAG,UAAU,EAAE,CAAC;AACpC,IAAA,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC;;;AAGhC,IAAA,MAAM,OAAO,GAAG,cAAc,KAAK,kBAAkB,CAAC,OAAO,GAAG,cAAc,GAAG,SAAS,CAAC;AAC3F,IAAA,MAAM,KAAK,GAAG,YAAY,KAAK,kBAAkB,CAAC,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;;;IAInF,eAAe,CAAC,MAAK;;;;;;;;;;;;;;QAcnB,MAAM,kCAAkC,GACtC,gBAAgB;AAChB,YAAA,gBAAgB,CAAC,OAAO;AACxB,YAAA,OAAO,gBAAgB,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU;AACpD,cAAE,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA,CAAA,EAAI,YAAY,CAAA,MAAA,EAAS,UAAU,CAAA,CAAA,CAAG,CAAC;cACxE,IAAI,CAAC;AACX,QAAA,cAAc,CACZ,kBAAkB,KAAK,kBAAkB,CAAC,WAAW;AACnD,cAAE,kBAAkB;AACpB,cAAE,kCAAkC;AACpC,kBAAE,MAAM;kBACN,SAAS,CACd,CAAC;AACJ,KAAC,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE3C,IAAA,MAAM,cAAc,GAAG,mBAAmB,CAAa,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAChG,IAAA,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3E,IAAA,OAAO,OAAO,CAAC;AACjB;;;;"}