@oracle/oraclejet-preact 20.0.3 → 20.1.0

package/es/useSelectDrill-2f855daa.js

@@ -0,0 +1,111 @@
+/* @oracle/oraclejet-preact: undefined */
+import { m as mergeProps } from './mergeProps-88ea8306.js';
+import { u as useChartDataCursor } from './useChartDataCursor-f79f98ec.js';
+import { u as useChartDatatip } from './useChartDatatip-cba78e0f.js';
+import { g as getInfo } from './eventsUtils-14cb0a49.js';
+import './accUtils-9d5183c4.js';
+import { u as useChartDrill } from './useChartDrill-e3b9ede4.js';
+import { u as useSelection } from './useSelection-10ed8060.js';
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function useChartDatatipAndCursor({ series, leafGroupsInfo, width, height, findNearest, getMarkerInfo, onDataCursorPositionChange, isDataCursorEnabled, dataCursorPosition, dataCursorStyle, hoveredItemInfo, focusedItemInfo, getDataItem, getRefItem, getDataItemPos, getRefObjectBounds, getRefAxis, datatip, valueFormats, isHoriz, xScale, yScale, y2Scale, plotAreaSpace, timeAxisType, touchResponse, isDisabled, defaultXFormatter, defaultYFormatter, defaultY2Formatter, hasXYValues, getGroupFromPath, translations }) {
+    const { datatipContent, datatipProps } = useChartDatatip({
+        series,
+        leafGroupsInfo,
+        width,
+        height,
+        isDataCursorEnabled,
+        dataCursorPosition,
+        hoveredItemInfo,
+        getDataItem,
+        getRefItem,
+        getDataItemPos,
+        getRefObjectBounds,
+        getRefAxis,
+        focusedItemInfo,
+        datatip,
+        valueFormats,
+        isHoriz,
+        xScale,
+        findNearest,
+        timeAxisType,
+        touchResponse,
+        isDisabled,
+        defaultXFormatter,
+        defaultYFormatter,
+        defaultY2Formatter,
+        hasXYValues,
+        translations,
+        getGroupFromPath
+    });
+    const { dataCursorContent, dataCursorProps } = useChartDataCursor({
+        touchResponse,
+        findNearest,
+        dataCursorPosition,
+        onDataCursorPositionChange,
+        isDataCursorEnabled,
+        dataCursorStyle,
+        isHoriz,
+        getMarkerInfo,
+        focusedItemInfo,
+        plotAreaSpace,
+        yScale,
+        y2Scale,
+        xScale,
+        getDataItemPos
+    });
+    return {
+        datatipContent,
+        dataCursorContent,
+        datatipProps: mergeProps(dataCursorProps, datatipProps)
+    };
+}
+
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+function useSelectDrill({ selectionMode, selection, onChange, rootRef, drilling, onItemDrill, onGroupDrill, focusedGroupInfo, focusedItemInfo, levelsArray, getDataItem, getDataById, ignoreAsTrigger }) {
+    const idExtracter = (event) => {
+        const isItemFocused = focusedItemInfo.isCurrent;
+        const info = isItemFocused && event.type === 'keyup'
+            ? focusedItemInfo
+            : getInfo(rootRef, event.target);
+        return info && info.seriesIndex != null && info.groupIndex != null
+            ? getDataItem(info.seriesIndex, info.groupIndex, levelsArray[levelsArray.length - 1][info.groupIndex].path)?.id
+            : undefined;
+    };
+    const { selectionProps, selectionContent } = useSelection({
+        idExtracter,
+        isDrillEnabled: drilling === 'on',
+        selection,
+        selectionMode,
+        onChange,
+        getDataById,
+        ignoreAsTrigger
+    });
+    const drillProps = useChartDrill({
+        rootRef,
+        selectionMode,
+        drilling,
+        focusedItemInfo,
+        focusedGroupInfo,
+        levelsArray,
+        getDataItem,
+        onItemDrill,
+        onGroupDrill
+    });
+    return { selectDrillProps: mergeProps(selectionProps, drillProps), selectionContent };
+}
+
+export { useSelectDrill as a, useChartDatatipAndCursor as u };
+//# sourceMappingURL=useSelectDrill-2f855daa.js.map

package/es/useSelectDrill-2f855daa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectDrill-2f855daa.js","sources":["../../src/hooks/PRIVATE_useChartEvents/useDatatipAndCursor.ts","../../src/hooks/PRIVATE_useChartEvents/useSelectDrill.ts"],"sourcesContent":["/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * Licensed under The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { mergeProps } from '#utils/UNSAFE_mergeProps';\nimport { useChartDataCursor } from '#hooks/PRIVATE_useChartDataCursor';\nimport { useChartDatatip } from '#hooks/PRIVATE_useChartDatatip';\nimport { LineAreaItem } from '#UNSAFE_LineAreaChart/lineAreaChart.types';\nimport { ScatterItem } from '#UNSAFE_ScatterChart/scatterChart.types';\nimport { BarItemData } from '#UNSAFE_BarChart/barChart.types';\n\ntype DataCursorProps = Parameters<typeof useChartDataCursor>[0];\ntype DatatipProps<\n  K extends string | number,\n  D extends LineAreaItem<K> | ScatterItem<K> | BarItemData<K>\n> = Parameters<typeof useChartDatatip<K, D>>[0];\n\nexport function useChartDatatipAndCursor<\n  K extends string | number,\n  D extends LineAreaItem<K> | ScatterItem<K> | BarItemData<K>\n>({\n  series,\n  leafGroupsInfo,\n  width,\n  height,\n  findNearest,\n  getMarkerInfo,\n  onDataCursorPositionChange,\n  isDataCursorEnabled,\n  dataCursorPosition,\n  dataCursorStyle,\n  hoveredItemInfo,\n  focusedItemInfo,\n  getDataItem,\n  getRefItem,\n  getDataItemPos,\n  getRefObjectBounds,\n  getRefAxis,\n  datatip,\n  valueFormats,\n  isHoriz,\n  xScale,\n  yScale,\n  y2Scale,\n  plotAreaSpace,\n  timeAxisType,\n  touchResponse,\n  isDisabled,\n  defaultXFormatter,\n  defaultYFormatter,\n  defaultY2Formatter,\n  hasXYValues,\n  getGroupFromPath,\n  translations\n}: DataCursorProps & DatatipProps<K, D>) {\n  const { datatipContent, datatipProps } = useChartDatatip<K, D>({\n    series,\n    leafGroupsInfo,\n    width,\n    height,\n    isDataCursorEnabled,\n    dataCursorPosition,\n    hoveredItemInfo,\n    getDataItem,\n    getRefItem,\n    getDataItemPos,\n    getRefObjectBounds,\n    getRefAxis,\n    focusedItemInfo,\n    datatip,\n    valueFormats,\n    isHoriz,\n    xScale,\n    findNearest,\n    timeAxisType,\n    touchResponse,\n    isDisabled,\n    defaultXFormatter,\n    defaultYFormatter,\n    defaultY2Formatter,\n    hasXYValues,\n    translations,\n    getGroupFromPath\n  });\n\n  const { dataCursorContent, dataCursorProps } = useChartDataCursor({\n    touchResponse,\n    findNearest,\n    dataCursorPosition,\n    onDataCursorPositionChange,\n    isDataCursorEnabled,\n    dataCursorStyle,\n    isHoriz,\n    getMarkerInfo,\n    focusedItemInfo,\n    plotAreaSpace,\n    yScale,\n    y2Scale,\n    xScale,\n    getDataItemPos\n  });\n\n  return {\n    datatipContent,\n    dataCursorContent,\n    datatipProps: mergeProps(dataCursorProps, datatipProps)\n  };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * Licensed under The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\n\nimport { getInfo } from '#utils/UNSAFE_visUtils';\nimport { useChartDrill } from '#hooks/PRIVATE_useChartDrill';\nimport { useSelection } from '#hooks/PRIVATE_useVisSelection/useSelection';\nimport { mergeProps } from '#utils/UNSAFE_mergeProps';\nimport { BarItemData } from '#UNSAFE_BarChart/barChart.types';\nimport { LineAreaItem } from '#UNSAFE_LineAreaChart/lineAreaChart.types';\nimport { ScatterItem } from '#UNSAFE_ScatterChart/scatterChart.types';\n\ntype DrillProps<K, D extends LineAreaItem<K> | ScatterItem<K> | BarItemData<K>> = Parameters<\n  typeof useChartDrill<K, D>\n>[0];\n\ntype SelectionProps<K, D> = {\n  selection: K[];\n  onChange?: (detail: { ids: K[]; data: (D | undefined)[] }) => void;\n  getDataById: (id: K) => D | undefined;\n  ignoreAsTrigger?: (element: EventTarget | null) => boolean;\n};\n\nexport function useSelectDrill<K, D extends LineAreaItem<K> | ScatterItem<K> | BarItemData<K>>({\n  selectionMode,\n  selection,\n  onChange,\n  rootRef,\n  drilling,\n  onItemDrill,\n  onGroupDrill,\n  focusedGroupInfo,\n  focusedItemInfo,\n  levelsArray,\n  getDataItem,\n  getDataById,\n  ignoreAsTrigger\n}: DrillProps<K, D> & SelectionProps<K, D>) {\n  const idExtracter = (event: Event): K | undefined => {\n    const isItemFocused = focusedItemInfo.isCurrent;\n    const info =\n      isItemFocused && event.type === 'keyup'\n        ? focusedItemInfo\n        : getInfo(rootRef, event.target as HTMLElement);\n    return info && info.seriesIndex != null && info.groupIndex != null\n      ? getDataItem(\n          info.seriesIndex,\n          info.groupIndex,\n          levelsArray[levelsArray.length - 1][info.groupIndex].path\n        )?.id\n      : undefined;\n  };\n\n  const { selectionProps, selectionContent } = useSelection<K, D>({\n    idExtracter,\n    isDrillEnabled: drilling === 'on',\n    selection,\n    selectionMode,\n    onChange,\n    getDataById,\n    ignoreAsTrigger\n  });\n\n  const drillProps = useChartDrill<K, D>({\n    rootRef,\n    selectionMode,\n    drilling,\n    focusedItemInfo,\n    focusedGroupInfo,\n    levelsArray,\n    getDataItem,\n    onItemDrill,\n    onGroupDrill\n  });\n\n  return { selectDrillProps: mergeProps(selectionProps, drillProps), selectionContent };\n}\n"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;AAMG;AAea,SAAA,wBAAwB,CAGtC,EACA,MAAM,EACN,cAAc,EACd,KAAK,EACL,MAAM,EACN,WAAW,EACX,aAAa,EACb,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,YAAY,EACZ,OAAO,EACP,MAAM,EACN,MAAM,EACN,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACyB,EAAA;AACrC,IAAA,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,eAAe,CAAO;QAC7D,MAAM;QACN,cAAc;QACd,KAAK;QACL,MAAM;QACN,mBAAmB;QACnB,kBAAkB;QAClB,eAAe;QACf,WAAW;QACX,UAAU;QACV,cAAc;QACd,kBAAkB;QAClB,UAAU;QACV,eAAe;QACf,OAAO;QACP,YAAY;QACZ,OAAO;QACP,MAAM;QACN,WAAW;QACX,YAAY;QACZ,aAAa;QACb,UAAU;QACV,iBAAiB;QACjB,iBAAiB;QACjB,kBAAkB;QAClB,WAAW;QACX,YAAY;QACZ,gBAAgB;AACjB,KAAA,CAAC,CAAC;AAEH,IAAA,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,GAAG,kBAAkB,CAAC;QAChE,aAAa;QACb,WAAW;QACX,kBAAkB;QAClB,0BAA0B;QAC1B,mBAAmB;QACnB,eAAe;QACf,OAAO;QACP,aAAa;QACb,eAAe;QACf,aAAa;QACb,MAAM;QACN,OAAO;QACP,MAAM;QACN,cAAc;AACf,KAAA,CAAC,CAAC;IAEH,OAAO;QACL,cAAc;QACd,iBAAiB;AACjB,QAAA,YAAY,EAAE,UAAU,CAAC,eAAe,EAAE,YAAY,CAAC;KACxD,CAAC;AACJ;;AC/GA;;;;;;AAMG;AAqBa,SAAA,cAAc,CAAiE,EAC7F,aAAa,EACb,SAAS,EACT,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EACyB,EAAA;AACxC,IAAA,MAAM,WAAW,GAAG,CAAC,KAAY,KAAmB;AAClD,QAAA,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC;QAChD,MAAM,IAAI,GACR,aAAa,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;AACrC,cAAE,eAAe;cACf,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,MAAqB,CAAC,CAAC;AACpD,QAAA,OAAO,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI;AAChE,cAAE,WAAW,CACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,UAAU,EACf,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAC1D,EAAE,EAAE;cACL,SAAS,CAAC;AAChB,KAAC,CAAC;AAEF,IAAA,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,YAAY,CAAO;QAC9D,WAAW;QACX,cAAc,EAAE,QAAQ,KAAK,IAAI;QACjC,SAAS;QACT,aAAa;QACb,QAAQ;QACR,WAAW;QACX,eAAe;AAChB,KAAA,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,aAAa,CAAO;QACrC,OAAO;QACP,aAAa;QACb,QAAQ;QACR,eAAe;QACf,gBAAgB;QAChB,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;AACb,KAAA,CAAC,CAAC;AAEH,IAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;AACxF;;;;"}

package/es/useSelection-10ed8060.js

@@ -0,0 +1,186 @@
+/* @oracle/oraclejet-preact: undefined */
+import { useState, useRef, useCallback } from 'preact/hooks';
+import { i as isEqual } from './eventsUtils-14cb0a49.js';
+import { jsx } from 'preact/jsx-runtime';
+import { B as BaseButton } from './BaseButton-243d200f.js';
+import { T as Text } from './Text-834eb35e.js';
+import { u as useTranslationBundle } from './useTranslationBundle-bc6e0896.js';
+import { clearButtonStyles } from './hooks/PRIVATE_useVisSelection/themes/ClearSelection.css.js';
+import { L as Layer } from './Layer-6c27170e.js';
+import 'preact/compat';
+import './LayerHost-3cf255a6.js';
+import { F as Floating } from './Floating-be4c0cb6.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-10ed8060.js.map

package/es/useSelection-10ed8060.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelection-10ed8060.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-d6fefa3d.js

@@ -0,0 +1,258 @@
+/* @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-e543b73c.js';
+import { g as getIsSelectionPending } from './textSelectionUtils-e87a47ff.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 || event.key === ' '))) {
+            // 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 pendingKeyboardSelectionCursor = useRef(false);
+    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 onClickCapture = useCallback((event) => {
+        if (!getIsSelectionPending()) {
+            if (!event.shiftKey) {
+                // reset keyboard cursor during capture phase, because Selector doesn't propagate click event
+                keyboardSelectionCursor.current = undefined;
+                pendingKeyboardSelectionCursor.current = false;
+            }
+            else {
+                pendingKeyboardSelectionCursor.current = true;
+            }
+        }
+    }, []);
+    const onClick = useCallback((event) => {
+        if (!getIsSelectionPending()) {
+            handleSelect(event, keyExtractor, selectedKeys, selectionMode, isTouchPointerRef.current ? 'toggle' : selectionBehavior, isSelectionRequired, keyboardSelectionCursor, currentKey, onChange, onRangeChange);
+            pendingKeyboardSelectionCursor.current = false;
+        }
+    }, [
+        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;
+        }
+        if (pendingKeyboardSelectionCursor.current) {
+            keyboardSelectionCursor.current = undefined;
+            pendingKeyboardSelectionCursor.current = false;
+        }
+        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)) {
+            // check ctrl/meta keys to avoid conflict gesture with reorder, and reset the range
+            if (event.shiftKey &&
+                !(event.ctrlKey || event.metaKey) &&
+                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 (!isKeyDefined(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, onClickCapture, onKeyDown, onKeyUp };
+    return { selectionProps };
+}
+
+export { useSelection as u };
+//# sourceMappingURL=useSelection-d6fefa3d.js.map