@oracle/oraclejet-preact 14.0.0

package/es/hooks/UNSAFE_usePress.js

@@ -0,0 +1,150 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useState, useRef, useCallback } from 'preact/hooks';
+
+const DefaultSettings = {
+    isDisabled: false,
+    isRepeat: false,
+    repeatDelay: 500,
+    repeatInterval: 40
+};
+/**
+ * Returns a click handler that can make a target element either clickable or keyboard pressable.
+ *
+ * @param onPressHandler function
+ * @param isRepeat boolean
+ * @param repeatInterval number number of ms between events for mouse and touch
+ * @param repeatDelay number number of ms before repeat events initiates
+ * @param isDisabled boolean
+ * @returns
+ */
+function usePress(onPressHandler, settings = DefaultSettings) {
+    const mergedSettings = Object.assign(Object.assign({}, DefaultSettings), settings);
+    const [isClickable, setIsClickable] = useState(true);
+    const [isPressed, setIsPressed] = useState(false);
+    const intervalID = useRef();
+    const isRepeating = useRef(false);
+    const repeatHandler = (event) => {
+        if (isRepeating.current) {
+            onPressHandler(event);
+        }
+        intervalID.current = setInterval(onPressHandler, mergedSettings.repeatInterval, event); // @HTMLUpdateOK
+    };
+    const onKeyDown = useCallback((event) => {
+        if ((event.code === 'Space' || event.code === 'Enter') &&
+            (mergedSettings.isRepeat || !event.repeat)) {
+            event.preventDefault();
+            setIsPressed(true);
+            if (mergedSettings.isRepeat) {
+                onPressHandler(event);
+            }
+        }
+    }, [mergedSettings.isRepeat, onPressHandler, setIsPressed]);
+    const onKeyUp = useCallback((event) => {
+        if (event.code === 'Space' || event.code === 'Enter') {
+            setIsPressed(false);
+            event.preventDefault();
+            if (!mergedSettings.isRepeat) {
+                onPressHandler(event);
+            }
+        }
+    }, [mergedSettings.isRepeat, onPressHandler, setIsPressed]);
+    const onBlur = useCallback(() => {
+        setIsPressed(false);
+    }, [setIsPressed]);
+    const onPointerDown = useCallback((event) => {
+        setIsClickable(false);
+        if (mergedSettings.isRepeat) {
+            isRepeating.current = true;
+            event.preventDefault();
+            onPressHandler(event);
+            intervalID.current = setTimeout(repeatHandler, mergedSettings.repeatDelay, event);
+        }
+    }, [mergedSettings, onPressHandler, intervalID, setIsClickable, repeatHandler]);
+    const onPointerUp = useCallback((event) => {
+        if (mergedSettings.isRepeat && intervalID.current) {
+            isRepeating.current = false;
+            clearInterval(intervalID.current);
+            intervalID.current = undefined;
+        }
+        else {
+            onPressHandler(event);
+        }
+    }, [mergedSettings.isRepeat, intervalID, onPressHandler]);
+    // Keep this to permit automated invocation of target via click event
+    // Need to ignore this for manual invocation whereby browser generates click
+    // pointerdown/pointerup/click -> ignore click
+    // keydown/keyup/click -> ignore click
+    // click without pointerup or keyup -> invoke
+    const onClick = useCallback((event) => {
+        // There are use cases where pressable/clickable components (eg. Buttons) are nested inside of other
+        // components that also process bubbling click events (eg. Collapsible). In order to avoid conflicting
+        // processing of clicks (eg. in order to avoid the click both activating a Button as well as toggling the
+        // ancestor Collapsible), we stop propagation here. That way, only the child component handles the
+        // click and the ancestor component is oblivious to the fact that the click even occurred.
+        event.stopPropagation();
+        if (isClickable && !isPressed && intervalID.current) {
+            onPressHandler(event);
+        }
+        setIsClickable(true);
+    }, [setIsClickable, onPressHandler, isClickable, intervalID, isPressed]);
+    const onClickSingle = useCallback((event) => {
+        // See note above about why propagation is stopped: to prevent nested component bubbling clicks issue
+        event.stopPropagation();
+        if (!isPressed) {
+            onPressHandler(event);
+        }
+    }, [onPressHandler, isPressed]);
+    const onPointerOut = useCallback(() => {
+        setIsClickable(true);
+        if (mergedSettings.isRepeat && intervalID.current) {
+            clearInterval(intervalID.current);
+        }
+    }, [mergedSettings.isRepeat, onPressHandler, intervalID, setIsClickable]);
+    const onPointerCancel = useCallback(() => {
+        setIsClickable(true);
+        if (mergedSettings.isRepeat && intervalID.current) {
+            clearInterval(intervalID.current);
+        }
+    }, [mergedSettings.isRepeat, onPressHandler, intervalID, setIsClickable]);
+    const onContextMenu = useCallback((event) => {
+        setIsClickable(true);
+        if (mergedSettings.isRepeat) {
+            event.preventDefault();
+        }
+    }, [mergedSettings.isRepeat, onPressHandler, setIsClickable]);
+    const pressProps = mergedSettings.isDisabled
+        ? {}
+        : mergedSettings.isRepeat
+            ? {
+                onPointerUp,
+                onPointerDown,
+                onPointerOut,
+                onPointerCancel,
+                onKeyDown,
+                onKeyUp,
+                onContextMenu,
+                onClick,
+                onBlur
+            }
+            : {
+                onKeyDown,
+                onKeyUp,
+                onBlur,
+                onClick: onClickSingle
+            };
+    return {
+        pressProps
+    };
+}
+
+/**
+ * @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
+ */
+
+export { usePress };
+/*  */
+//# sourceMappingURL=UNSAFE_usePress.js.map

package/es/hooks/UNSAFE_usePress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_usePress.js","sources":["../../../src/hooks/UNSAFE_usePress/usePress.ts","../../../src/hooks/UNSAFE_usePress/index.ts"],"sourcesContent":["import { useCallback, useState, useRef } from 'preact/hooks';\n\nexport type PressOptions = {\n  isDisabled?: boolean;\n  isRepeat?: boolean;\n  repeatDelay?: number;\n  repeatInterval?: number;\n};\n\nconst DefaultSettings = {\n  isDisabled: false,\n  isRepeat: false,\n  repeatDelay: 500,\n  repeatInterval: 40\n};\n\n/**\n * Returns a click handler that can make a target element either clickable or keyboard pressable.\n *\n * @param onPressHandler function\n * @param isRepeat boolean\n * @param repeatInterval number number of ms between events for mouse and touch\n * @param repeatDelay number number of ms before repeat events initiates\n * @param isDisabled boolean\n * @returns\n */\n\nexport function usePress(\n  onPressHandler: (event: Event) => void,\n  settings: PressOptions = DefaultSettings\n): { pressProps: Record<string, any> } {\n  const mergedSettings = { ...DefaultSettings, ...settings };\n  const [isClickable, setIsClickable] = useState<boolean>(true);\n  const [isPressed, setIsPressed] = useState<boolean>(false);\n  const intervalID = useRef<ReturnType<typeof setInterval>>();\n  const isRepeating = useRef<boolean>(false);\n  const repeatHandler = (event: Event) => {\n    if (isRepeating.current) {\n      onPressHandler(event);\n    }\n    intervalID.current = setInterval(onPressHandler, mergedSettings.repeatInterval, event); // @HTMLUpdateOK\n  };\n\n  const onKeyDown = useCallback(\n    (event: KeyboardEvent) => {\n      if (\n        (event.code === 'Space' || event.code === 'Enter') &&\n        (mergedSettings.isRepeat || !event.repeat)\n      ) {\n        event.preventDefault();\n        setIsPressed(true);\n        if (mergedSettings.isRepeat) {\n          onPressHandler(event);\n        }\n      }\n    },\n    [mergedSettings.isRepeat, onPressHandler, setIsPressed]\n  );\n\n  const onKeyUp = useCallback(\n    (event: KeyboardEvent) => {\n      if (event.code === 'Space' || event.code === 'Enter') {\n        setIsPressed(false);\n        event.preventDefault();\n        if (!mergedSettings.isRepeat) {\n          onPressHandler(event);\n        }\n      }\n    },\n    [mergedSettings.isRepeat, onPressHandler, setIsPressed]\n  );\n\n  const onBlur = useCallback(() => {\n    setIsPressed(false);\n  }, [setIsPressed]);\n\n  const onPointerDown = useCallback(\n    (event: PointerEvent) => {\n      setIsClickable(false);\n      if (mergedSettings.isRepeat) {\n        isRepeating.current = true;\n        event.preventDefault();\n        onPressHandler(event);\n        intervalID.current = setTimeout(repeatHandler, mergedSettings.repeatDelay, event);\n      }\n    },\n    [mergedSettings, onPressHandler, intervalID, setIsClickable, repeatHandler]\n  );\n\n  const onPointerUp = useCallback(\n    (event: PointerEvent) => {\n      if (mergedSettings.isRepeat && intervalID.current) {\n        isRepeating.current = false;\n        clearInterval(intervalID.current);\n        intervalID.current = undefined;\n      } else {\n        onPressHandler(event);\n      }\n    },\n    [mergedSettings.isRepeat, intervalID, onPressHandler]\n  );\n\n  // Keep this to permit automated invocation of target via click event\n  // Need to ignore this for manual invocation whereby browser generates click\n  // pointerdown/pointerup/click -> ignore click\n  // keydown/keyup/click -> ignore click\n  // click without pointerup or keyup -> invoke\n  const onClick = useCallback(\n    (event: Event) => {\n      // There are use cases where pressable/clickable components (eg. Buttons) are nested inside of other\n      // components that also process bubbling click events (eg. Collapsible). In order to avoid conflicting\n      // processing of clicks (eg. in order to avoid the click both activating a Button as well as toggling the\n      // ancestor Collapsible), we stop propagation here. That way, only the child component handles the\n      // click and the ancestor component is oblivious to the fact that the click even occurred.\n      event.stopPropagation();\n      if (isClickable && !isPressed && intervalID.current) {\n        onPressHandler(event);\n      }\n      setIsClickable(true);\n    },\n    [setIsClickable, onPressHandler, isClickable, intervalID, isPressed]\n  );\n\n  const onClickSingle = useCallback(\n    (event: Event) => {\n      // See note above about why propagation is stopped: to prevent nested component bubbling clicks issue\n      event.stopPropagation();\n      if (!isPressed) {\n        onPressHandler(event);\n      }\n    },\n    [onPressHandler, isPressed]\n  );\n\n  const onPointerOut = useCallback(() => {\n    setIsClickable(true);\n    if (mergedSettings.isRepeat && intervalID.current) {\n      clearInterval(intervalID.current);\n    }\n  }, [mergedSettings.isRepeat, onPressHandler, intervalID, setIsClickable]);\n\n  const onPointerCancel = useCallback(() => {\n    setIsClickable(true);\n    if (mergedSettings.isRepeat && intervalID.current) {\n      clearInterval(intervalID.current);\n    }\n  }, [mergedSettings.isRepeat, onPressHandler, intervalID, setIsClickable]);\n\n  const onContextMenu = useCallback(\n    (event: PointerEvent) => {\n      setIsClickable(true);\n      if (mergedSettings.isRepeat) {\n        event.preventDefault();\n      }\n    },\n    [mergedSettings.isRepeat, onPressHandler, setIsClickable]\n  );\n\n  const pressProps = mergedSettings.isDisabled\n    ? {}\n    : mergedSettings.isRepeat\n    ? {\n        onPointerUp,\n        onPointerDown,\n        onPointerOut,\n        onPointerCancel,\n        onKeyDown,\n        onKeyUp,\n        onContextMenu,\n        onClick,\n        onBlur\n      }\n    : {\n        onKeyDown,\n        onKeyUp,\n        onBlur,\n        onClick: onClickSingle\n      };\n\n  return {\n    pressProps\n  };\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\nexport * from './usePress';\n"],"names":[],"mappings":"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"}

package/es/hooks/UNSAFE_useScale.js

@@ -0,0 +1,30 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useContext } from 'preact/hooks';
+import { EnvironmentContext } from '../UNSAFE_Environment.js';
+import 'preact';
+import 'preact/jsx-runtime';
+import '../UNSAFE_Layer.js';
+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 useScale() {
+    return useContext(EnvironmentContext).scale;
+}
+
+/**
+ * @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
+ */
+
+export { useScale };
+/*  */
+//# sourceMappingURL=UNSAFE_useScale.js.map

package/es/hooks/UNSAFE_useScale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useScale.js","sources":["../../../src/hooks/UNSAFE_useScale/useScale.ts","../../../src/hooks/UNSAFE_useScale/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\nimport { useContext } from 'preact/hooks';\nimport { EnvironmentContext } from '../../UNSAFE_Environment';\n\nexport function useScale() {\n  return useContext(EnvironmentContext).scale;\n}\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\nexport { useScale } from './useScale';\n"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;AAMG;SAIa,QAAQ,GAAA;AACtB,IAAA,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC;AAC9C;;ACZA;;;;;;AAMG;;;;;;;"}

package/es/hooks/UNSAFE_useSwipe.js

@@ -0,0 +1,91 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useRef, useCallback } from 'preact/hooks';
+
+/**
+ * @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 useSwipe(onSwipe, { threshold = 10, maximumTime = 300, tolerance = 50, isDisabled = false } = {
+    threshold: 10,
+    maximumTime: 300,
+    tolerance: 50,
+    isDisabled: false
+}) {
+    const ref = useRef({
+        pointerDownId: 0,
+        startTime: null,
+        prevoffsetX: 0,
+        prevoffsetY: 0
+    });
+    const onPointerDown = useCallback((e) => {
+        if (!ref.current.pointerDownId) {
+            ref.current = {
+                pointerDownId: e.pointerId,
+                startTime: e.timeStamp,
+                prevoffsetX: e.offsetX,
+                prevoffsetY: e.offsetY
+            };
+        }
+        else {
+            clearSwipe();
+        }
+    }, []);
+    const onPointerUp = useCallback((ev) => {
+        if (ev.pointerId === ref.current.pointerDownId) {
+            if (ref.current.startTime && ev.timeStamp - ref.current.startTime < maximumTime) {
+                if (ref.current.prevoffsetX - ev.offsetX > threshold &&
+                    Math.abs(ev.offsetY - ref.current.prevoffsetY) <= tolerance) {
+                    onSwipe === null || onSwipe === void 0 ? void 0 : onSwipe({ direction: 'left' });
+                }
+                else if (ev.offsetX - ref.current.prevoffsetX > threshold &&
+                    Math.abs(ev.offsetY - ref.current.prevoffsetY) <= tolerance) {
+                    onSwipe === null || onSwipe === void 0 ? void 0 : onSwipe({ direction: 'right' });
+                }
+                else if (ref.current.prevoffsetY - ev.offsetY > threshold &&
+                    Math.abs(ev.offsetX - ref.current.prevoffsetX) <= tolerance) {
+                    onSwipe === null || onSwipe === void 0 ? void 0 : onSwipe({ direction: 'up' });
+                }
+                else if (ev.offsetY - ref.current.prevoffsetY > threshold &&
+                    Math.abs(ev.offsetX - ref.current.prevoffsetX) <= tolerance) {
+                    onSwipe === null || onSwipe === void 0 ? void 0 : onSwipe({ direction: 'down' });
+                }
+            }
+        }
+        // state would be reset to its original state whether swipe is completed or cancelled
+        clearSwipe();
+    }, [threshold, onSwipe]);
+    const clearSwipe = useCallback(() => {
+        ref.current = {
+            pointerDownId: null,
+            startTime: 0,
+            prevoffsetX: 0,
+            prevoffsetY: 0
+        };
+    }, []);
+    const swipeProps = isDisabled
+        ? {}
+        : {
+            /** event handlers to spread on the target element. */
+            onPointerDown,
+            onPointerUp,
+            onPointerCancel: clearSwipe
+        };
+    return {
+        swipeProps
+    };
+}
+
+/**
+ * @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
+ */
+
+export { useSwipe };
+/*  */
+//# sourceMappingURL=UNSAFE_useSwipe.js.map

package/es/hooks/UNSAFE_useSwipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useSwipe.js","sources":["../../../src/hooks/UNSAFE_useSwipe/useSwipe.ts","../../../src/hooks/UNSAFE_useSwipe/index.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 { useRef, useCallback } from 'preact/hooks';\n\n/*\n  threshold: Minimal threshold required before recognizing\n  tolerance: A tolerance value which allows the user to move their finger about a length measured in pixels.\n  This allows the swipe gesture to be triggered more easily since a User might not move their finger\n  in a straight line.\n*/\ntype SwipeOptions = {\n  threshold?: number;\n  maximumTime?: number;\n  tolerance?: number;\n  isDisabled?: boolean;\n};\n\ntype SwipeInfo = {\n  direction: 'left' | 'right' | 'up' | 'down';\n};\n\ntype SwipeState = {\n  pointerDownId: number | null;\n  startTime: number | null;\n  prevoffsetX: number;\n  prevoffsetY: number;\n};\n\nexport function useSwipe(\n  onSwipe: (e: SwipeInfo) => void,\n  { threshold = 10, maximumTime = 300, tolerance = 50, isDisabled = false }: SwipeOptions = {\n    threshold: 10,\n    maximumTime: 300,\n    tolerance: 50,\n    isDisabled: false\n  }\n): { swipeProps: Record<string, any> } {\n  const ref = useRef<SwipeState>({\n    pointerDownId: 0,\n    startTime: null,\n    prevoffsetX: 0,\n    prevoffsetY: 0\n  });\n\n  const onPointerDown = useCallback((e: PointerEvent) => {\n    if (!ref.current.pointerDownId) {\n      ref.current = {\n        pointerDownId: e.pointerId,\n        startTime: e.timeStamp,\n        prevoffsetX: e.offsetX,\n        prevoffsetY: e.offsetY\n      };\n    } else {\n      clearSwipe();\n    }\n  }, []);\n\n  const onPointerUp = useCallback(\n    (ev: PointerEvent) => {\n      if (ev.pointerId === ref.current.pointerDownId) {\n        if (ref.current.startTime && ev.timeStamp - ref.current.startTime < maximumTime) {\n          if (\n            ref.current.prevoffsetX - ev.offsetX > threshold &&\n            Math.abs(ev.offsetY - ref.current.prevoffsetY) <= tolerance\n          ) {\n            onSwipe?.({ direction: 'left' });\n          } else if (\n            ev.offsetX - ref.current.prevoffsetX > threshold &&\n            Math.abs(ev.offsetY - ref.current.prevoffsetY) <= tolerance\n          ) {\n            onSwipe?.({ direction: 'right' });\n          } else if (\n            ref.current.prevoffsetY - ev.offsetY > threshold &&\n            Math.abs(ev.offsetX - ref.current.prevoffsetX) <= tolerance\n          ) {\n            onSwipe?.({ direction: 'up' });\n          } else if (\n            ev.offsetY - ref.current.prevoffsetY > threshold &&\n            Math.abs(ev.offsetX - ref.current.prevoffsetX) <= tolerance\n          ) {\n            onSwipe?.({ direction: 'down' });\n          }\n        }\n      }\n      // state would be reset to its original state whether swipe is completed or cancelled\n      clearSwipe();\n    },\n    [threshold, onSwipe]\n  );\n\n  const clearSwipe = useCallback(() => {\n    ref.current = {\n      pointerDownId: null,\n      startTime: 0,\n      prevoffsetX: 0,\n      prevoffsetY: 0\n    };\n  }, []);\n\n  const swipeProps = isDisabled\n    ? {}\n    : {\n        /** event handlers to spread on the target element. */\n        onPointerDown,\n        onPointerUp,\n        onPointerCancel: clearSwipe\n      };\n\n  return {\n    swipeProps\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\nexport { useSwipe } from './useSwipe';\n"],"names":[],"mappings":"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"}

package/es/hooks/UNSAFE_useTabbableMode.js

@@ -0,0 +1,44 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { createContext } from 'preact';
+import { useContext } from 'preact/hooks';
+
+/**
+ * Context for Tabbable Mode Consumer and Provider
+ */
+const initialContext = {
+    isTabbable: true
+};
+const TabbableModeContext = createContext(initialContext);
+
+/**
+ * @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
+ */
+/**
+ * Utility hook for consuming the TabbableModeContext
+ */
+function useTabbableMode() {
+    const { isTabbable } = useContext(TabbableModeContext);
+    const tabbableModeProps = {
+        tabIndex: isTabbable === false ? -1 : 0
+    };
+    return {
+        isTabbable,
+        tabbableModeProps
+    };
+}
+
+/**
+ * @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
+ */
+
+export { TabbableModeContext, useTabbableMode };
+/*  */
+//# sourceMappingURL=UNSAFE_useTabbableMode.js.map

package/es/hooks/UNSAFE_useTabbableMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useTabbableMode.js","sources":["../../../src/hooks/UNSAFE_useTabbableMode/TabbableModeContext.tsx","../../../src/hooks/UNSAFE_useTabbableMode/useTabbableMode.ts","../../../src/hooks/UNSAFE_useTabbableMode/index.ts"],"sourcesContent":["/**\n * Context for Tabbable Mode Consumer and Provider\n */\n\nimport { createContext } from 'preact';\n\n/**\n * Context props for Tabbable Mode\n */\ntype TabbableModeContextProps = {\n  /**\n   * State of Tabbable mode\n   * @default true\n   */\n  isTabbable: boolean;\n};\n\nconst initialContext: TabbableModeContextProps = {\n  isTabbable: true\n};\n\nconst TabbableModeContext = createContext<TabbableModeContextProps>(initialContext);\n\nexport { TabbableModeContext };\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 { useContext } from 'preact/hooks';\nimport { TabbableModeContext } from './TabbableModeContext';\n\n/**\n * Utility hook for consuming the TabbableModeContext\n */\nfunction useTabbableMode() {\n  const { isTabbable } = useContext(TabbableModeContext);\n  const tabbableModeProps = {\n    tabIndex: isTabbable === false ? -1 : 0\n  };\n  return {\n    isTabbable,\n    tabbableModeProps\n  };\n}\n\nexport { useTabbableMode };\n","/**\n * @license\n * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.\n * The Universal Permissive License (UPL), Version 1.0\n * as shown at https://oss.oracle.com/licenses/upl/\n * @ignore\n */\nexport { TabbableModeContext } from './TabbableModeContext';\nexport { useTabbableMode } from './useTabbableMode';\n"],"names":[],"mappings":";;;;AAAA;;AAEG;AAeH,MAAM,cAAc,GAA6B;AAC/C,IAAA,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,MAAM,mBAAmB,GAAG,aAAa,CAA2B,cAAc;;ACrBlF;;;;;;AAMG;AAKH;;AAEG;AACH,SAAS,eAAe,GAAA;IACtB,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACvD,IAAA,MAAM,iBAAiB,GAAG;AACxB,QAAA,QAAQ,EAAE,UAAU,KAAK,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;KACxC,CAAC;IACF,OAAO;QACL,UAAU;QACV,iBAAiB;KAClB,CAAC;AACJ;;ACvBA;;;;;;AAMG;;;;;;;"}

package/es/hooks/UNSAFE_useTap.js

@@ -0,0 +1,72 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useRef, useCallback } from 'preact/hooks';
+
+/**
+ * @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
+ */
+/**
+ * Returns event handlers that can make a target element tapable.
+ * useTap is used for non-keyboard elements.
+ *
+ * @param onTap function
+ * @param settings object
+ * @returns
+ */
+function useTap(onTap, { isDisabled } = { isDisabled: false }) {
+    const ref = useRef({
+        pointerDownId: null,
+        startTime: 0
+    });
+    const onPointerDown = useCallback((e) => {
+        // return if it is not a left click
+        if (e.pointerType === 'mouse' && e.button !== 0) {
+            return;
+        }
+        if (!ref.current.pointerDownId) {
+            ref.current = { pointerDownId: e.pointerId, startTime: e.timeStamp };
+        }
+        else {
+            clearTap();
+        }
+    }, []);
+    const onPointerUp = useCallback((e) => {
+        if (e.pointerId === ref.current.pointerDownId) {
+            const tapTime = e.timeStamp - ref.current.startTime;
+            // 250ms maximum tap time based on numbers used in Hammer
+            if (tapTime <= 250) {
+                onTap({ x: e.offsetX, y: e.offsetY });
+            }
+        }
+        clearTap();
+    }, [onTap]);
+    const clearTap = useCallback(() => {
+        ref.current = { pointerDownId: null, startTime: 0 };
+    }, []);
+    const tapProps = isDisabled
+        ? {}
+        : {
+            onPointerDown,
+            onPointerUp,
+            onPointerLeave: clearTap,
+            onPointerCancel: clearTap
+        };
+    return {
+        tapProps
+    };
+}
+
+/**
+ * @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
+ */
+
+export { useTap };
+/*  */
+//# sourceMappingURL=UNSAFE_useTap.js.map

package/es/hooks/UNSAFE_useTap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useTap.js","sources":["../../../src/hooks/UNSAFE_useTap/useTap.ts","../../../src/hooks/UNSAFE_useTap/index.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 { useRef, useCallback } from 'preact/hooks';\n\ntype TapOptions = {\n  isDisabled?: boolean;\n};\n\ntype TapInfo = {\n  x: number;\n  y: number;\n};\n\ntype TapState = {\n  pointerDownId: number | null;\n  startTime: number;\n};\n\n/**\n * Returns event handlers that can make a target element tapable.\n * useTap is used for non-keyboard elements.\n *\n * @param onTap function\n * @param settings object\n * @returns\n */\n\nexport function useTap(\n  onTap: (e: TapInfo) => void,\n  { isDisabled }: TapOptions = { isDisabled: false }\n): { tapProps: Record<string, any> } {\n  const ref = useRef<TapState>({\n    pointerDownId: null,\n    startTime: 0\n  });\n\n  const onPointerDown = useCallback((e: PointerEvent) => {\n    // return if it is not a left click\n    if (e.pointerType === 'mouse' && e.button !== 0) {\n      return;\n    }\n    if (!ref.current.pointerDownId) {\n      ref.current = { pointerDownId: e.pointerId, startTime: e.timeStamp };\n    } else {\n      clearTap();\n    }\n  }, []);\n\n  const onPointerUp = useCallback(\n    (e: PointerEvent) => {\n      if (e.pointerId === ref.current.pointerDownId) {\n        const tapTime = e.timeStamp - ref.current.startTime;\n        // 250ms maximum tap time based on numbers used in Hammer\n        if (tapTime <= 250) {\n          onTap({ x: e.offsetX, y: e.offsetY });\n        }\n      }\n      clearTap();\n    },\n    [onTap]\n  );\n\n  const clearTap = useCallback(() => {\n    ref.current = { pointerDownId: null, startTime: 0 };\n  }, []);\n\n  const tapProps = isDisabled\n    ? {}\n    : {\n        onPointerDown,\n        onPointerUp,\n        onPointerLeave: clearTap,\n        onPointerCancel: clearTap\n      };\n\n  return {\n    tapProps\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\nexport { useTap } from './useTap';\n"],"names":[],"mappings":";;;AAAA;;;;;;AAMG;AAkBH;;;;;;;AAOG;AAEa,SAAA,MAAM,CACpB,KAA2B,EAC3B,EAAE,UAAU,EAAA,GAAiB,EAAE,UAAU,EAAE,KAAK,EAAE,EAAA;IAElD,MAAM,GAAG,GAAG,MAAM,CAAW;AAC3B,QAAA,aAAa,EAAE,IAAI;AACnB,QAAA,SAAS,EAAE,CAAC;AACb,KAAA,CAAC,CAAC;AAEH,IAAA,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAe,KAAI;;QAEpD,IAAI,CAAC,CAAC,WAAW,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;YAC/C,OAAO;AACR,SAAA;AACD,QAAA,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE;AAC9B,YAAA,GAAG,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;AACtE,SAAA;AAAM,aAAA;AACL,YAAA,QAAQ,EAAE,CAAC;AACZ,SAAA;KACF,EAAE,EAAE,CAAC,CAAC;AAEP,IAAA,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,CAAe,KAAI;QAClB,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE;YAC7C,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;;YAEpD,IAAI,OAAO,IAAI,GAAG,EAAE;AAClB,gBAAA,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACvC,aAAA;AACF,SAAA;AACD,QAAA,QAAQ,EAAE,CAAC;AACb,KAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;AAEF,IAAA,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAK;AAChC,QAAA,GAAG,CAAC,OAAO,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;KACrD,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,UAAU;AACzB,UAAE,EAAE;AACJ,UAAE;YACE,aAAa;YACb,WAAW;AACX,YAAA,cAAc,EAAE,QAAQ;AACxB,YAAA,eAAe,EAAE,QAAQ;SAC1B,CAAC;IAEN,OAAO;QACL,QAAQ;KACT,CAAC;AACJ;;ACpFA;;;;;;AAMG;;;;;;;"}

package/es/hooks/UNSAFE_useTextField.js

@@ -0,0 +1,95 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useMemo } from 'preact/hooks';
+import { useId } from './UNSAFE_useId.js';
+
+const rankedSeverities = ['error', 'warning', 'confirmation', 'info', 'none'];
+/**
+ * Merge multiple ids into a space-separated list
+ * @param ids The ids to be merged
+ * @returns The space separated string of ids
+ */
+function mergeIDs(...ids) {
+    return ids.filter(Boolean).join(' ') || undefined;
+}
+/**
+ * A custom hook to determine the props for a component that renders
+ * a text field
+ */
+function useTextField({ ariaDescribedBy, contentVariant, isDisabled, isFocused, isLoading, isReadonly, labelEdge, messages, styleVariant, value }) {
+    const baseId = useId();
+    const labelId = labelEdge !== 'none' ? `${baseId}-label` : undefined;
+    const inputId = !isReadonly ? `${baseId}-input` : undefined;
+    const uaId = !(isDisabled || isReadonly) ? `${baseId}-ua` : undefined;
+    // Create the form field context
+    const formFieldContext = useMemo(() => {
+        const hasValue = value !== undefined && (typeof value !== 'string' || value !== '');
+        return isReadonly
+            ? {
+                hasValue: hasValue,
+                isFocused: isFocused,
+                isLoading,
+                isReadonly: true
+            }
+            : isDisabled
+                ? {
+                    hasValue: hasValue,
+                    isDisabled: true,
+                    isLoading
+                }
+                : {
+                    hasValue: hasValue,
+                    isFocused: isFocused,
+                    isLoading
+                };
+    }, [isDisabled, isFocused, isLoading, isReadonly, value]);
+    // Determine the highest severity from the messages
+    const messageSeverity = useMemo(() => {
+        return messages === undefined
+            ? undefined
+            : messages.reduce((accSeverity, currMessage) => {
+                const currSeverity = currMessage.severity || 'error';
+                return rankedSeverities.indexOf(accSeverity) < rankedSeverities.indexOf(currSeverity)
+                    ? accSeverity
+                    : currSeverity;
+            }, 'none');
+    }, [messages]);
+    // Determine the label variant
+    const labelVariant = labelEdge === 'inside'
+        ? messageSeverity === 'error'
+            ? 'insideError'
+            : messageSeverity === 'warning'
+                ? 'insideWarning'
+                : labelEdge
+        : labelEdge !== 'none'
+            ? labelEdge
+            : undefined;
+    return {
+        baseId,
+        formFieldContext,
+        inputProps: {
+            id: inputId,
+            ariaDescribedBy: mergeIDs(uaId, ariaDescribedBy),
+            ariaInvalid: messageSeverity === 'error' ? 'true' : undefined,
+            variant: styleVariant
+        },
+        labelProps: {
+            forId: inputId,
+            id: labelId,
+            variant: labelVariant
+        },
+        textFieldProps: {
+            contentVariant,
+            statusVariant: /error|warning/.test(messageSeverity !== null && messageSeverity !== void 0 ? messageSeverity : '')
+                ? messageSeverity
+                : undefined,
+            styleVariant
+        },
+        userAssistanceProps: {
+            id: uaId
+        }
+    };
+}
+
+export { useTextField };
+/*  */
+//# sourceMappingURL=UNSAFE_useTextField.js.map

package/es/hooks/UNSAFE_useTextField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UNSAFE_useTextField.js","sources":["../../../src/hooks/UNSAFE_useTextField/useTextField.ts"],"sourcesContent":["import { ComponentProps } from 'preact';\nimport { useMemo } from 'preact/hooks';\nimport { Label } from '../../UNSAFE_Label';\nimport { TextField } from '../../UNSAFE_TextField';\nimport { InlineUserAssistance } from '../../UNSAFE_UserAssistance';\nimport { FormFieldContextProps } from '../UNSAFE_useFormFieldContext';\nimport { useId } from '../UNSAFE_useId';\n\ntype PickedUserAssistanceProps = Pick<ComponentProps<typeof InlineUserAssistance>, 'messages'>;\n\ntype UseTextFieldProps<V> = PickedUserAssistanceProps & {\n  ariaDescribedBy?: string;\n  contentVariant?: 'input' | 'textarea';\n  isDisabled?: boolean;\n  isFocused?: boolean;\n  isLoading?: boolean;\n  isReadonly?: boolean;\n  labelEdge?: ComponentProps<typeof TextField>['labelEdge'] | 'none';\n  styleVariant?: 'default' | 'embedded';\n  value?: V;\n};\n\nconst rankedSeverities = ['error', 'warning', 'confirmation', 'info', 'none'] as const;\n\n/**\n * Merge multiple ids into a space-separated list\n * @param ids The ids to be merged\n * @returns The space separated string of ids\n */\nfunction mergeIDs(...ids: (string | undefined)[]) {\n  return ids.filter(Boolean).join(' ') || undefined;\n}\n\n/**\n * A custom hook to determine the props for a component that renders\n * a text field\n */\nexport function useTextField<V>({\n  ariaDescribedBy,\n  contentVariant,\n  isDisabled,\n  isFocused,\n  isLoading,\n  isReadonly,\n  labelEdge,\n  messages,\n  styleVariant,\n  value\n}: UseTextFieldProps<V>) {\n  const baseId = useId();\n  const labelId = labelEdge !== 'none' ? `${baseId}-label` : undefined;\n  const inputId = !isReadonly ? `${baseId}-input` : undefined;\n  const uaId = !(isDisabled || isReadonly) ? `${baseId}-ua` : undefined;\n\n  // Create the form field context\n  const formFieldContext = useMemo<FormFieldContextProps>(() => {\n    const hasValue = value !== undefined && (typeof value !== 'string' || value !== '');\n    return isReadonly\n      ? {\n          hasValue: hasValue,\n          isFocused: isFocused,\n          isLoading,\n          isReadonly: true\n        }\n      : isDisabled\n      ? {\n          hasValue: hasValue,\n          isDisabled: true,\n          isLoading\n        }\n      : {\n          hasValue: hasValue,\n          isFocused: isFocused,\n          isLoading\n        };\n  }, [isDisabled, isFocused, isLoading, isReadonly, value]);\n\n  // Determine the highest severity from the messages\n  const messageSeverity = useMemo(() => {\n    return messages === undefined\n      ? undefined\n      : messages.reduce<typeof rankedSeverities[number]>((accSeverity, currMessage) => {\n          const currSeverity = currMessage.severity || 'error';\n          return rankedSeverities.indexOf(accSeverity) < rankedSeverities.indexOf(currSeverity)\n            ? accSeverity\n            : currSeverity;\n        }, 'none');\n  }, [messages]);\n\n  // Determine the label variant\n  const labelVariant: ComponentProps<typeof Label>['variant'] =\n    labelEdge === 'inside'\n      ? messageSeverity === 'error'\n        ? 'insideError'\n        : messageSeverity === 'warning'\n        ? 'insideWarning'\n        : labelEdge\n      : labelEdge !== 'none'\n      ? labelEdge\n      : undefined;\n\n  return {\n    baseId,\n    formFieldContext,\n    inputProps: {\n      id: inputId,\n      ariaDescribedBy: mergeIDs(uaId, ariaDescribedBy),\n      ariaInvalid: messageSeverity === 'error' ? 'true' : undefined,\n      variant: styleVariant\n    },\n    labelProps: {\n      forId: inputId,\n      id: labelId,\n      variant: labelVariant\n    },\n    textFieldProps: {\n      contentVariant,\n      statusVariant: /error|warning/.test(messageSeverity ?? '')\n        ? (messageSeverity as 'error' | 'warning')\n        : undefined,\n      styleVariant\n    },\n    userAssistanceProps: {\n      id: uaId\n    }\n  };\n}\n"],"names":[],"mappings":"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"}

package/es/hooks/UNSAFE_useTextFieldInputHandlers.js

@@ -0,0 +1,89 @@
+/* @oracle/oraclejet-preact: 14.0.0 */
+import { useRef, useReducer, useCallback } from 'preact/hooks';
+import { getClientHints } from '../utils/PRIVATE_clientHints.js';
+
+function useTextFieldInputHandlers({ currentCommitValue, value, onInput, onCommit, onKeyDown }) {
+    const isComposing = useRef(false);
+    // preactjs/preact #1899 - https://github.com/preactjs/preact/issues/1899
+    // Preact does not force the native input to be controlled, so we need to
+    // trigger a rerender in order to keep it fully controlled.
+    // Force update hack is from https://reactjs.org/docs/hooks-faq.html#is-there-something-like-forceupdate
+    const [, forceUpdate] = useReducer((x) => x + 1, 0);
+    // TODO: Currently, this assumes that the input field is a text field
+    // so that the change event can be simulated by capturing blur and enter keydown
+    // event. We might have to make this generic to handle other input types
+    // as well like radio, select, checkbox.
+    const handleChange = useCallback((event) => {
+        const currentValue = event.target.value;
+        // When do we *not* want to call onCommit?
+        // When the input's value
+        // is the same as the currentCommitValue (like if the user hits Enter over and over,
+        // or if the user focuses and blurs over and over).
+        // Or when the component's value is programmatically changed.
+        // (currentCommitValue is updated whenever we commit or get a programmatic change.
+        // See component code and useCurrentValueReducer hook)
+        // We only need to trigger an onCommit for user interacted changes, not programmatic changes
+        if (currentCommitValue !== currentValue) {
+            onCommit === null || onCommit === void 0 ? void 0 : onCommit({ previousValue: currentCommitValue, value: currentValue });
+        }
+    }, [onCommit, currentCommitValue]);
+    const handleKeyDown = useCallback((event) => {
+        onKeyDown === null || onKeyDown === void 0 ? void 0 : onKeyDown(event);
+        if (event.key === 'Enter') {
+            handleChange(event);
+        }
+    }, [handleChange, onKeyDown]);
+    const handleCompositionStart = useCallback(() => {
+        isComposing.current = true;
+    }, []);
+    const handleCompositionEnd = useCallback((event) => {
+        isComposing.current = false;
+        // On some browsers, compositionend event is fired before the final input event,
+        // while it's the other way around on other browsers. Just call handleInput here
+        // anyway since handleInput will compare the value before actually calling it.
+        // When all browsers support the input event's isComposing property, we can use that.
+        // https://w3c.github.io/uievents/#dom-inputevent-iscomposing
+        handleInput(event);
+    }, []);
+    const handleInput = useCallback((event) => {
+        // In android device we need to update input value even for composition events
+        // See JET-39086 for more details.
+        if (isComposing.current && getClientHints().platform !== 'android')
+            return;
+        const newValue = event.target.value;
+        if (value === newValue)
+            return;
+        onInput === null || onInput === void 0 ? void 0 : onInput({ previousValue: value, value: newValue });
+        // preactjs/preact #1899 - https://github.com/preactjs/preact/issues/1899
+        // Preact does not force the native input to be controlled, so we need to
+        // trigger a rerender in order to keep it fully controlled.
+        // Force a rerender here, so if the value was not pushed back, the input
+        // will be reset to the old value mimicking a controlled input.
+        // One minor issue here is that the cursor position will also be reverted
+        // back to the end due to the forced value update. But this behavior should
+        // be fine as it happens in our oj-input-text as well.
+        forceUpdate(null);
+    }, [value, onInput]);
+    return {
+        // With preact/compat, we will not have an onChange event.
+        // "If you're using preact/compat, most onChange events are internally converted to onInput
+        // to emulate React's behavior. This is one of the tricks we use to ensure maximum
+        // compatibility with the React ecosystem."
+        // Since we need the onChange event, we will be simulating this to match the native event
+        // as best as we can. To do this, we will be capturing `blur` event and Enter `keydown` event.
+        // https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event
+        onBlur: handleChange,
+        onKeyDown: handleKeyDown,
+        // Since, preact does not support onCompositionStart and onCompositionEnd events
+        // we need to use all lowercase event name to use the native DOM events. Also,
+        // currently we do not have any need for the event object in these two handlers
+        // so ignored the arguments here.
+        oncompositionstart: handleCompositionStart,
+        oncompositionend: handleCompositionEnd,
+        onInput: handleInput
+    };
+}
+
+export { useTextFieldInputHandlers };
+/*  */
+//# sourceMappingURL=UNSAFE_useTextFieldInputHandlers.js.map