@oracle/oraclejet-preact 15.1.2 → 15.1.3

package/es/FocusTrap-f8afef25.js

@@ -0,0 +1,135 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx, jsxs } from 'preact/jsx-runtime';
+import { Fragment } from 'preact';
+import { forwardRef, useRef, useCallback, useEffect } from 'preact/compat';
+import './utils/UNSAFE_classNames.js';
+
+import { focusOn, focusWithin, focusOnEnd, focusOnStart, getActiveElement, isTabbableElement } from './utils/PRIVATE_tabbableUtils.js';
+import { c as classNames } from './classNames-bd44965c.js';
+
+const styles = {
+  guard: "_1bc2cx1"
+};
+/**
+ * Styled FocusTrap sub-component to render non-visible focus guards
+ */
+const FocusGuard = forwardRef(({
+  onFocus
+}, guardRef) => {
+  return jsx("div", {
+    class: styles.guard,
+    onFocus: onFocus,
+    ref: guardRef,
+    tabIndex: 0
+  });
+});
+
+/**
+ * Trap focus within a DOM node.  When a user hits Tab or Shift+Tab, focus remains in the focus trap.
+ */
+const FocusTrap = ({
+  autoFocusRef,
+  children,
+  isDisabled = false,
+  restoreFocusRef
+}) => {
+  const trapRef = useRef(null);
+  const startGuardRef = useRef(null);
+  const endGuardRef = useRef(null);
+  const lastActiveElementRef = useRef(null);
+  // classes to be set on the children wrapper
+  const classes = classNames([childrenStyles]);
+  /**
+   * contain focus if trap is enabled, and target is not already contained
+   *
+   * calling cases for side-effect of setting focus
+   *   - on initial mount of (enabled) trap, where target is not inside trap
+   *   - on enabling of a disabled trap, where target is not inside trap
+   *   - target of click event is outside of trap.
+   */
+  const conditionallyContainFocus = useCallback(target => {
+    const trap = trapRef.current;
+    //  short-circuit, if trap or target not valid
+    if (isDisabled || !trap || !target) return;
+    // just update ref if, target already has focus
+    if (target && hasFocus([trap, startGuardRef.current, endGuardRef.current], target)) {
+      lastActiveElementRef.current = target;
+      return;
+    }
+    // set focus to last active tab-stop if lastElement is defined and inside trap
+    if (lastActiveElementRef.current) {
+      focusOn(lastActiveElementRef.current);
+    } else {
+      // otherwise just contain focus within trap as target is outside enabled trap and we have no last-known tab-stop
+      focusWithin(trap);
+    }
+  }, [isDisabled]);
+  // loop focus
+  const handleStartGuardOnFocus = event => {
+    if (isDisabled || !trapRef.current) return;
+    focusOnEnd(trapRef.current);
+    // prevent scroll jump and bubbling this event up as a focus event
+    event.stopPropagation();
+    event.preventDefault();
+  };
+  const handleEndGuardOnFocus = event => {
+    if (isDisabled || !trapRef.current) return;
+    focusOnStart(trapRef.current);
+    // prevent scroll jump and bubbling guard event up as a focus event
+    event.stopPropagation();
+    event.preventDefault();
+  };
+  const handleTrapOnFocus = event => {
+    lastActiveElementRef.current = event.target;
+  };
+  // handle initial render or re-render as enabled
+  useEffect(() => {
+    const trap = trapRef.current;
+    if (!trap || isDisabled) return;
+    const originalActiveElement = getActiveElement(trap);
+    // init focus
+    if (autoFocusRef && autoFocusRef.current) {
+      focusOn(autoFocusRef.current);
+    } else {
+      conditionallyContainFocus(originalActiveElement);
+    }
+    const restoreFocusRefForCleanup = restoreFocusRef;
+    return () => {
+      if (restoreFocusRefForCleanup === false) return;
+      restoreFocusAfterUnmount(restoreFocusRefForCleanup?.current || originalActiveElement);
+    };
+  }, [autoFocusRef, conditionallyContainFocus, isDisabled, restoreFocusRef]);
+  return jsxs(Fragment, {
+    children: [!isDisabled && jsx(FocusGuard, {
+      onFocus: handleStartGuardOnFocus,
+      ref: startGuardRef
+    }), jsx("div", {
+      onFocus: handleTrapOnFocus,
+      ref: trapRef,
+      class: classes,
+      children: children
+    }), !isDisabled && jsx(FocusGuard, {
+      onFocus: handleEndGuardOnFocus,
+      ref: endGuardRef
+    })]
+  });
+};
+// setTimeout ensures that unmount lifecycle has completed
+const restoreFocusAfterUnmount = element => {
+  if (element && isTabbableElement(element)) {
+    setTimeout(() => {
+      focusOn(element);
+    }, 0);
+  }
+};
+// is focus already contained?
+const hasFocus = (elements, target) => {
+  if (elements.length === 0) return false;
+  const activeElement = target ?? getActiveElement(elements[0]);
+  return elements.some(el => el === activeElement || el?.contains(activeElement));
+};
+// remove margins from children
+const childrenStyles = "_1azvjyx";
+
+export { FocusTrap as F };
+//# sourceMappingURL=FocusTrap-f8afef25.js.map

package/es/FocusTrap-f8afef25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusTrap-f8afef25.js","sources":["../../src/UNSAFE_FocusTrap/FocusGuard.tsx","../../src/UNSAFE_FocusTrap/FocusTrap.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 */\n\nimport { forwardRef, ForwardedRef } from 'preact/compat';\nimport { cssProps } from '@oracle/oraclejet-cssprops';\n\ntype Props = {\n  onFocus: (event: FocusEvent) => void;\n};\n\nconst styles = {\n  guard: cssProps`${{\n    height: '0px',\n    left: 0,\n    position: 'fixed',\n    top: 0,\n    width: '1px'\n  }}`\n};\n\n/**\n * Styled FocusTrap sub-component to render non-visible focus guards\n */\nconst FocusGuard = forwardRef(({ onFocus }: Props, guardRef: ForwardedRef<HTMLDivElement>) => {\n  return <div class={styles.guard} onFocus={onFocus} ref={guardRef} tabIndex={0} />;\n});\n\nexport default FocusGuard;\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 */\nimport { ComponentChildren, Fragment, RefObject } from 'preact';\nimport { useCallback, useEffect, useRef } from 'preact/compat';\nimport { classNames } from '../utils/UNSAFE_classNames';\nimport { cssProps } from '@oracle/oraclejet-cssprops';\nimport {\n  focusOn,\n  focusOnEnd,\n  focusOnStart,\n  focusWithin,\n  getActiveElement,\n  isTabbableElement\n} from '../utils/PRIVATE_tabbableUtils';\nimport FocusGuard from './FocusGuard';\n\ntype Props = {\n  children: ComponentChildren;\n  /**\n   * Optional Ref to an element to focus on when component mounts\n   * @default - undefined - behavior is to focus on first tabbableElement\n   */\n  autoFocusRef?: RefObject<HTMLElement | null>;\n\n  /**\n   * Sets whether focus is managed and whether guards are present\n   * @default false\n   */\n  isDisabled?: boolean;\n\n  /**\n   * Why a isDisabled prop as compared to ONLY supporting conditional rendering?\n   *\n   *   1) We need an actual HTML Element for the trap, conditional rendering an element potentially breaks consumer CSS\n   *   2) Conditional rendering can short-circuit event bubbling in preact and lead to expected events not bubbling.\n   */\n\n  /**\n   * Optional Ref to element to focus on when component un-mounts, false to disable.\n   * @default - undefined - behavior is to focus on the original activeElement when focus trap was enabled\n   */\n  restoreFocusRef?: RefObject<HTMLElement> | false;\n};\n\n/**\n * Trap focus within a DOM node.  When a user hits Tab or Shift+Tab, focus remains in the focus trap.\n */\nexport const FocusTrap = ({\n  autoFocusRef,\n  children,\n  isDisabled = false,\n  restoreFocusRef\n}: Props) => {\n  const trapRef = useRef<HTMLDivElement>(null);\n  const startGuardRef = useRef<HTMLDivElement>(null);\n  const endGuardRef = useRef<HTMLDivElement>(null);\n  const lastActiveElementRef = useRef<HTMLElement | null>(null);\n\n  // classes to be set on the children wrapper\n  const classes = classNames([childrenStyles]);\n\n  /**\n   * contain focus if trap is enabled, and target is not already contained\n   *\n   * calling cases for side-effect of setting focus\n   *   - on initial mount of (enabled) trap, where target is not inside trap\n   *   - on enabling of a disabled trap, where target is not inside trap\n   *   - target of click event is outside of trap.\n   */\n  const conditionallyContainFocus = useCallback(\n    (target: HTMLElement | null) => {\n      const trap = trapRef.current;\n      //  short-circuit, if trap or target not valid\n      if (isDisabled || !trap || !target) return;\n\n      // just update ref if, target already has focus\n      if (target && hasFocus([trap, startGuardRef.current, endGuardRef.current], target)) {\n        lastActiveElementRef.current = target;\n        return;\n      }\n\n      // set focus to last active tab-stop if lastElement is defined and inside trap\n      if (lastActiveElementRef.current) {\n        focusOn(lastActiveElementRef.current);\n      } else {\n        // otherwise just contain focus within trap as target is outside enabled trap and we have no last-known tab-stop\n        focusWithin(trap);\n      }\n    },\n    [isDisabled]\n  );\n\n  // loop focus\n  const handleStartGuardOnFocus = (event: FocusEvent) => {\n    if (isDisabled || !trapRef.current) return;\n    focusOnEnd(trapRef.current);\n\n    // prevent scroll jump and bubbling this event up as a focus event\n    event.stopPropagation();\n    event.preventDefault();\n  };\n\n  const handleEndGuardOnFocus = (event: FocusEvent) => {\n    if (isDisabled || !trapRef.current) return;\n    focusOnStart(trapRef.current);\n\n    // prevent scroll jump and bubbling guard event up as a focus event\n    event.stopPropagation();\n    event.preventDefault();\n  };\n\n  const handleTrapOnFocus = (event: FocusEvent) => {\n    lastActiveElementRef.current = event.target as HTMLElement;\n  };\n\n  // handle initial render or re-render as enabled\n  useEffect(() => {\n    const trap = trapRef.current;\n    if (!trap || isDisabled) return;\n\n    const originalActiveElement = getActiveElement(trap);\n\n    // init focus\n    if (autoFocusRef && autoFocusRef.current) {\n      focusOn(autoFocusRef.current);\n    } else {\n      conditionallyContainFocus(originalActiveElement);\n    }\n\n    const restoreFocusRefForCleanup = restoreFocusRef;\n\n    return () => {\n      if (restoreFocusRefForCleanup === false) return;\n      restoreFocusAfterUnmount(restoreFocusRefForCleanup?.current || originalActiveElement);\n    };\n  }, [autoFocusRef, conditionallyContainFocus, isDisabled, restoreFocusRef]);\n\n  return (\n    <Fragment>\n      {!isDisabled && <FocusGuard onFocus={handleStartGuardOnFocus} ref={startGuardRef} />}\n      <div onFocus={handleTrapOnFocus} ref={trapRef} class={classes}>\n        {children}\n      </div>\n      {!isDisabled && <FocusGuard onFocus={handleEndGuardOnFocus} ref={endGuardRef} />}\n    </Fragment>\n  );\n};\n\n// setTimeout ensures that unmount lifecycle has completed\nconst restoreFocusAfterUnmount = (element: HTMLElement | null) => {\n  if (element && isTabbableElement(element)) {\n    setTimeout(() => {\n      focusOn(element);\n    }, 0);\n  }\n};\n\n// is focus already contained?\nconst hasFocus = (elements: (HTMLElement | null)[], target: Element) => {\n  if (elements.length === 0) return false;\n  const activeElement = target ?? getActiveElement(elements[0] as Node);\n  return elements.some((el) => el === activeElement || el?.contains(activeElement));\n};\n\n// remove margins from children\nconst childrenStyles = cssProps`${{\n  /* @ts-ignore */\n  '& > *': {\n    marginTop: '0 !important',\n    marginBottom: '0 !important',\n    marginLeft: '0 !important',\n    marginRight: '0 !important'\n  }\n}}`;\n"],"names":["styles","FocusGuard","forwardRef","onFocus","guardRef","_jsx","class","guard","ref","tabIndex","FocusTrap","autoFocusRef","children","isDisabled","restoreFocusRef","trapRef","useRef","startGuardRef","endGuardRef","lastActiveElementRef","conditionallyContainFocus","useCallback","target","trap","current","hasFocus","focusOn","handleStartGuardOnFocus","event","focusOnEnd","handleEndGuardOnFocus","focusOnStart","handleTrapOnFocus","originalActiveElement","getActiveElement","restoreFocusAfterUnmount","restoreFocusRefForCleanup","element","isTabbableElement","elements","length","childrenStyles"],"mappings":"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"}

package/es/Heading-86285368.js

@@ -0,0 +1,25 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx } from 'preact/jsx-runtime';
+import { stringLiteralArray } from './utils/UNSAFE_arrayUtils.js';
+import { multiVariantStyles } from './UNSAFE_Heading/themes/HeadingStyles.css.js';
+
+const headingElementTypes = stringLiteralArray(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']);
+const headingsizeMap = {
+    h1: '2xl',
+    h2: 'xl',
+    h3: 'lg',
+    h4: 'md',
+    h5: 'sm',
+    h6: 'xs'
+};
+const sizeOptions = ['xs', 'sm', 'md', 'lg', 'xl', '2xl', 'inherit'];
+function Heading({ children, as, size, id, variant }) {
+    const Component = as;
+    //@ts-ignore
+    size = size ?? headingsizeMap[Component];
+    const classes = multiVariantStyles({ size, variant });
+    return (jsx(Component, { className: classes, id: id, children: children }));
+}
+
+export { Heading as H, headingElementTypes as h, sizeOptions as s };
+//# sourceMappingURL=Heading-86285368.js.map

package/es/Heading-86285368.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Heading-86285368.js","sources":["../../src/UNSAFE_Heading/Heading.tsx"],"sourcesContent":["import { ComponentChildren } from 'preact';\nimport { stringLiteralArray } from '../utils/UNSAFE_arrayUtils';\nimport { multiVariantStyles } from './themes/HeadingStyles.css';\n\nexport const headingElementTypes = stringLiteralArray(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']);\n\ntype ElementType = typeof headingElementTypes[number];\n\ntype HeadingProps = {\n  /**\n   * Specifies the heading tag\n   */\n  as: ElementType;\n\n  /**\n   * Specifies text color. If set as \"inherit\", takes text color from its parent element. The default value of this property is theme driven.\n   */\n  variant?: 'primary' | 'secondary' | 'disabled' | 'inherit';\n\n  /**\n   * Specifies the font size and line height. The default value of this property is theme driven.\n   */\n  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'inherit';\n\n  /**\n   * Specifies the header id\n   */\n  id?: string;\n\n  /**\n   * Specifies the children\n   */\n  children: ComponentChildren;\n};\n\nconst headingsizeMap: { [headingType in ElementType]: string } = {\n  h1: '2xl',\n  h2: 'xl',\n  h3: 'lg',\n  h4: 'md',\n  h5: 'sm',\n  h6: 'xs'\n};\n\nexport const sizeOptions = ['xs', 'sm', 'md', 'lg', 'xl', '2xl', 'inherit'];\n\nexport function Heading({ children, as, size, id, variant }: HeadingProps) {\n  const Component = as;\n  //@ts-ignore\n  size = size ?? headingsizeMap[Component];\n  const classes = multiVariantStyles({ size, variant });\n  return (\n    <Component className={classes} id={id}>\n      {children}\n    </Component>\n  );\n}\n"],"names":["_jsx"],"mappings":";;;;;MAIa,mBAAmB,GAAG,kBAAkB,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;AA+B5F,MAAM,cAAc,GAA6C;AAC/D,IAAA,EAAE,EAAE,KAAK;AACT,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,EAAE,EAAE,IAAI;AACR,IAAA,EAAE,EAAE,IAAI;CACT,CAAC;AAEW,MAAA,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;AAE5D,SAAA,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAgB,EAAA;IACvE,MAAM,SAAS,GAAG,EAAE,CAAC;;AAErB,IAAA,IAAI,GAAG,IAAI,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACtD,IAAA,QACEA,GAAA,CAAC,SAAS,EAAA,EAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAA,QAAA,EAClC,QAAQ,EAAA,CACC,EACZ;AACJ;;;;"}

package/es/HiddenAccessible-ce8ac79b.js

@@ -0,0 +1,25 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx } from 'preact/jsx-runtime';
+
+
+const hiddenAccessibleStyle = "sih47c";
+/**
+ * HiddenAccessible is a helper component that hides its children visually,
+ * but keeps them visible to screen readers.
+ *
+ */
+function HiddenAccessible({
+  children,
+  id,
+  isHidden
+}) {
+  return jsx("span", {
+    id: id,
+    class: hiddenAccessibleStyle,
+    hidden: isHidden,
+    children: children
+  });
+}
+
+export { HiddenAccessible as H };
+//# sourceMappingURL=HiddenAccessible-ce8ac79b.js.map

package/es/HiddenAccessible-ce8ac79b.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HiddenAccessible-ce8ac79b.js","sources":["../../src/UNSAFE_HiddenAccessible/HiddenAccessible.tsx"],"sourcesContent":["import { ComponentChildren } from 'preact';\nimport { cssProps } from '@oracle/oraclejet-cssprops';\n\nconst hiddenAccessibleStyle = cssProps`${{\n  border: 0,\n  clip: 'rect(0 0 0 0)',\n  height: '1px',\n  margin: '-1px',\n  overflowX: 'hidden',\n  overflowY: 'hidden',\n  paddingTop: 0,\n  paddingRight: 0,\n  paddingBottom: 0,\n  paddingLeft: 0,\n  width: '1px',\n  position: 'absolute'\n}}`;\n\ntype HiddenAccessibleProps = {\n  /**\n   * Specifies the ComponentChildren\n   */\n  children?: ComponentChildren;\n\n  /**\n   * HTML id for the rendered element\n   */\n  id?: string;\n\n  /**\n   * Specifies whether the element is hidden to the screen readers by default.\n   * However, one can override it using aria-describedby/aria-labelledby. This is\n   * useful when the content should be read only as a description for another content\n   * and not as a content of the container.\n   */\n  isHidden?: boolean;\n};\n\n/**\n * HiddenAccessible is a helper component that hides its children visually,\n * but keeps them visible to screen readers.\n *\n */\nfunction HiddenAccessible({ children, id, isHidden }: HiddenAccessibleProps) {\n  return (\n    <span id={id} class={hiddenAccessibleStyle} hidden={isHidden}>\n      {children}\n    </span>\n  );\n}\n\nexport { HiddenAccessible };\n"],"names":["hiddenAccessibleStyle","HiddenAccessible","children","id","isHidden","_jsx","class","hidden"],"mappings":";;;;AAGA,MAAAA,qBAAA,GAaC,QAAA,CAAA;AAsBD;;;;AAIG;AACH,SAAAC,gBAAAA,CAAA;EAAAC,QAAA;EAAAC,EAAA;AAAAC,EAAAA,QAAAA;AAAA,CAAA,EAAA;EACE,OAAAC,GAAA,CAAA,MAAA,EAAA;AAAAF,IAAAA,EAAA,EAAAA,EAAA;AAAAG,IAAAA,KAAA,EAAAN,qBAAA;AAAAO,IAAAA,MAAA,EAAAH,QAAA;AAAAF,IAAAA,QAAA,EAAAA,QAAAA;AAAA,GAAA,CAAA,CAAA;AAKF;;;;"}

package/es/HighlightText-30b48538.js

@@ -0,0 +1,42 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx } from 'preact/jsx-runtime';
+import { Fragment } from 'preact';
+
+
+const highlightStyles = "_116zitr";
+/**
+ * Renders a text string with highlighting applied to the given text to match.
+ */
+function HighlightText({
+  children = '',
+  matchText = ''
+}) {
+  return highlighter(children, matchText);
+}
+const HIGHLIGHT_TOKEN = '__@@__';
+const HIGHLIGHT_PATTERN = `${HIGHLIGHT_TOKEN}$&${HIGHLIGHT_TOKEN}`;
+function highlighter(unhighlightedText, matchText) {
+  if (matchText.length > 0 && unhighlightedText.length > 0) {
+    const escapedMatchText = escapeRegExp(matchText);
+    const highlightedText = unhighlightedText.replace(new RegExp(escapedMatchText, 'gi'), HIGHLIGHT_PATTERN);
+    const tokens = highlightedText.split(HIGHLIGHT_TOKEN);
+    const nodes = tokens.map((current, index) => index % 2 == 0 ? current : jsx("span", {
+      class: highlightStyles,
+      children: current
+    }));
+    return jsx(Fragment, {
+      children: nodes
+    });
+  }
+  return jsx(Fragment, {
+    children: unhighlightedText
+  });
+}
+function escapeRegExp(str) {
+  // copied from:
+  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#Escaping
+  return str.replace(/[.*+\-?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+}
+
+export { HighlightText as H };
+//# sourceMappingURL=HighlightText-30b48538.js.map

package/es/HighlightText-30b48538.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HighlightText-30b48538.js","sources":["../../src/UNSAFE_HighlightText/HighlightText.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 */\n\nimport { Fragment } from 'preact';\nimport { cssProps } from '@oracle/oraclejet-cssprops';\n\nconst highlightStyles = cssProps`${{\n  fontWeight: 700\n}}`;\n\ntype Props = {\n  /**\n   * The text string to apply highlighting to.\n   */\n  children?: string;\n  /**\n   * The text string to match.\n   */\n  matchText?: string;\n};\n\n/**\n * Renders a text string with highlighting applied to the given text to match.\n */\nexport function HighlightText({ children = '', matchText = '' }: Props) {\n  return highlighter(children, matchText);\n}\n\nconst HIGHLIGHT_TOKEN = '__@@__';\nconst HIGHLIGHT_PATTERN = `${HIGHLIGHT_TOKEN}$&${HIGHLIGHT_TOKEN}`;\n\nfunction highlighter(unhighlightedText: string, matchText: string) {\n  if (matchText.length > 0 && unhighlightedText.length > 0) {\n    const escapedMatchText = escapeRegExp(matchText);\n    const highlightedText = unhighlightedText.replace(\n      new RegExp(escapedMatchText, 'gi'),\n      HIGHLIGHT_PATTERN\n    );\n    const tokens = highlightedText.split(HIGHLIGHT_TOKEN);\n    const nodes = tokens.map((current, index) =>\n      index % 2 == 0 ? current : <span class={highlightStyles}>{current}</span>\n    );\n    return <Fragment>{nodes}</Fragment>;\n  }\n  return <Fragment>{unhighlightedText}</Fragment>;\n}\n\nfunction escapeRegExp(str: string) {\n  // copied from:\n  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#Escaping\n  return str.replace(/[.*+\\-?^${}()|[\\]\\\\]/g, '\\\\$&'); // $& means the whole matched string\n}\n"],"names":["highlightStyles","HighlightText","children","matchText","highlighter","HIGHLIGHT_TOKEN","HIGHLIGHT_PATTERN","unhighlightedText","escapedMatchText","escapeRegExp","highlightedText","replace","RegExp","nodes","tokens","map","current","index","_jsx","class","Fragment","str"],"mappings":";;;;;AAWA,MAAAA,eAAA,GAEC,UAAA,CAAA;AAaD;;AAEG;AACH,SAAAC,aAAAA,CAAA;AAAAC,EAAAA,QAAA,GAAA,EAAA;AAAAC,EAAAA,SAAA,GAAA,EAAA;AAAA,CAAA,EAAA;AACE,EAAA,OAAAC,WAAA,CAAAF,QAAA,EAAAC,SAAA,CAAA,CAAA;AACF,CAAA;AAEA,MAAAE,eAAA,GAAA,QAAA,CAAA;AACA,MAAAC,iBAAA,GAAA,CAAA,EAAAD,eAAA,CAAA,EAAA,EAAAA,eAAA,CAAA,CAAA,CAAA;AAEA,SAAAD,WAAAA,CAAAG,iBAAA,EAAAJ,SAAA,EAAA;;AAEI,IAAA,MAAAK,gBAAA,GAAAC,YAAA,CAAAN,SAAA,CAAA,CAAA;AACA,IAAA,MAAAO,eAAA,GAAAH,iBAAA,CAAAI,OAAA,CAAA,IAAAC,MAAA,CAAAJ,gBAAA,EAAA,IAAA,CAAA,EAAAF,iBAAA,CAAA,CAAA;;IAKA,MAAAO,KAAA,GAAAC,MAAA,CAAAC,GAAA,CAAA,CAAAC,OAAA,EAAAC,KAAA,KAAAA,KAAA,GAAA,CAAA,IAAA,CAAA,GAAAD,OAAA,GAAAE,GAAA,CAAA,MAAA,EAAA;AAAAC,MAAAA,KAAA,EAAAnB,eAAA;AAAAE,MAAAA,QAAA,EAAAc,OAAAA;AAAA,KAAA,CAAA,CAAA,CAAA;IAGA,OAAAE,GAAA,CAAAE,QAAA,EAAA;AAAAlB,MAAAA,QAAA,EAAAW,KAAAA;AAAA,KAAA,CAAA,CAAA;AACD,GAAA;EACD,OAAAK,GAAA,CAAAE,QAAA,EAAA;AAAAlB,IAAAA,QAAA,EAAAK,iBAAAA;AAAA,GAAA,CAAA,CAAA;AACF,CAAA;AAEA,SAAAE,YAAAA,CAAAY,GAAA,EAAA;;;;AAIA;;;;"}

package/es/Icon-4c30465d.js

@@ -0,0 +1,46 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx, jsxs } from 'preact/jsx-runtime';
+import { Fragment } from 'preact';
+import { sizeToCSS } from './utils/UNSAFE_size.js';
+import { useTooltip } from './hooks/UNSAFE_useTooltip.js';
+import { styles } from './UNSAFE_Icon/themes/IconStyle.css.js';
+
+const Icon = ({ size = '1em', color = 'currentColor', accessibleLabel = '', viewBox = 'none', children }) => (jsx(Svg, { height: "1em", width: "1em", viewBox: viewBox, accessibleLabel: accessibleLabel, class: styles[color], style: { fontSize: size === '1em' ? size : `${sizeToCSS(size)}` }, children: children }));
+const Svg = ({ accessibleLabel, ...otherProps }) => accessibleLabel ? (jsx(SemanticSvg, { accessibleLabel: accessibleLabel, ...otherProps })) : (jsx(DecorativeSvg, { ...otherProps }));
+const DecorativeSvg = (props) => jsx("svg", { ...props });
+const SemanticSvg = ({ accessibleLabel, children, ...props }) => {
+    // See JET-56791.
+    // We want the same effect as specifying a SVG <title> element for showing a tooltip.
+    // When <title> is used, the SVG is not keyboard focusable by default, and the tooltip only shows up
+    // on mouse hover. Typically any accessibility requirements beyond this should be handled by making the parent
+    // element accessible. This was the approved behavior by APO, and is consistent with the behavior of icons
+    // from other libraries.
+    //
+    // We need to use useTooltip for displaying the tooltip, but it appears spreading the onFocus and onBlur event
+    // handlers generated by the useTooltip hook onto the <svg> causes it to become keyboard focusable*.
+    // To fix this we need to omit spreading the onFocus and onBlur event handlers from the tooltipProps.
+    //
+    // *Most browsers implement the SVG 1.1 spec. There's also a SVG 1.2 Tiny spec that's not
+    // fully implemented in most browsers.
+    // The non-draft version of SVG 1.1 doesn't document the focus conditions and behavior AFAICT.
+    // However it appears browsers implemented the same behavior as the focusable="auto" behavior as described
+    // in SVG 1.2 Tiny: https://www.w3.org/TR/SVGTiny12/interact.html#focus
+    // In particular, it states that if the SVG element has focus related event listeners registered on it, then it becomes focusable.
+    // The spec mentions focusin and focusout event handlers, but not focus event handlers. The reality is
+    // that having a focus event handler registered also causes the <svg> to become focusable (tested on Chrome), and that's
+    // probably because a focus event always precedes a focusin event.
+    // Note also setting focusable="false", or setting tabindex="-1" on the <svg> to prevent it from becoming focusable
+    // doesn't work based on my testing, and that's most probably because the focusable and tabindex attributes are not part
+    // of the SVG 1.1 spec.
+    const { tooltipContent, tooltipProps: { onFocus, onBlur, ...restTooltipProps } } = useTooltip({
+        text: accessibleLabel,
+        anchor: {
+            x: 'element',
+            y: 'element'
+        }
+    });
+    return (jsxs(Fragment, { children: [jsx("svg", { role: "img", ...props, ...restTooltipProps, "aria-label": accessibleLabel, children: children }), tooltipContent] }));
+};
+
+export { Icon as I };
+//# sourceMappingURL=Icon-4c30465d.js.map

package/es/Icon-4c30465d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Icon-4c30465d.js","sources":["../../src/UNSAFE_Icon/Icon.tsx"],"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 */\nimport { JSX, Fragment } from 'preact';\nimport { Size, sizeToCSS } from '../utils/UNSAFE_size';\nimport { useTooltip } from '../hooks/UNSAFE_useTooltip';\nimport { styles } from './themes/IconStyle.css';\n\ntype IntrinsicProps = JSX.SVGAttributes<SVGSVGElement>;\n\ntype Props = Pick<IntrinsicProps, 'viewBox' | 'children'> & {\n  /**\n   * The size of the component. Defaults to '1em', which means the font size of the parent is used.\n   */\n  size?: Size | '1em';\n  /**\n   * The color of the component. Defaults to 'currentColor', which behaves like the CSS 'currentColor' value.\n   */\n  color?: keyof typeof styles;\n  /**\n   * A label to be used for accessibility purposes.\n   */\n  accessibleLabel?: string;\n};\n\nexport const Icon = ({\n  size = '1em',\n  color = 'currentColor',\n  accessibleLabel = '',\n  viewBox = 'none',\n  children\n}: Props) => (\n  <Svg\n    height=\"1em\"\n    width=\"1em\"\n    viewBox={viewBox}\n    accessibleLabel={accessibleLabel}\n    class={styles[color]}\n    style={{ fontSize: size === '1em' ? size : `${sizeToCSS(size)}` }}>\n    {children}\n  </Svg>\n);\n\ntype BaseSvgProps = Pick<\n  IntrinsicProps,\n  'height' | 'width' | 'viewBox' | 'class' | 'children' | 'style'\n>;\ntype SvgProps = BaseSvgProps & {\n  accessibleLabel: string;\n};\n\nconst Svg = ({ accessibleLabel, ...otherProps }: SvgProps) =>\n  accessibleLabel ? (\n    <SemanticSvg accessibleLabel={accessibleLabel} {...otherProps} />\n  ) : (\n    <DecorativeSvg {...otherProps} />\n  );\n\nconst DecorativeSvg = (props: BaseSvgProps) => <svg {...props} />;\n\nconst SemanticSvg = ({ accessibleLabel, children, ...props }: SvgProps) => {\n  // See JET-56791.\n  // We want the same effect as specifying a SVG <title> element for showing a tooltip.\n  // When <title> is used, the SVG is not keyboard focusable by default, and the tooltip only shows up\n  // on mouse hover. Typically any accessibility requirements beyond this should be handled by making the parent\n  // element accessible. This was the approved behavior by APO, and is consistent with the behavior of icons\n  // from other libraries.\n  //\n  // We need to use useTooltip for displaying the tooltip, but it appears spreading the onFocus and onBlur event\n  // handlers generated by the useTooltip hook onto the <svg> causes it to become keyboard focusable*.\n  // To fix this we need to omit spreading the onFocus and onBlur event handlers from the tooltipProps.\n  //\n  // *Most browsers implement the SVG 1.1 spec. There's also a SVG 1.2 Tiny spec that's not\n  // fully implemented in most browsers.\n  // The non-draft version of SVG 1.1 doesn't document the focus conditions and behavior AFAICT.\n  // However it appears browsers implemented the same behavior as the focusable=\"auto\" behavior as described\n  // in SVG 1.2 Tiny: https://www.w3.org/TR/SVGTiny12/interact.html#focus\n  // In particular, it states that if the SVG element has focus related event listeners registered on it, then it becomes focusable.\n  // The spec mentions focusin and focusout event handlers, but not focus event handlers. The reality is\n  // that having a focus event handler registered also causes the <svg> to become focusable (tested on Chrome), and that's\n  // probably because a focus event always precedes a focusin event.\n  // Note also setting focusable=\"false\", or setting tabindex=\"-1\" on the <svg> to prevent it from becoming focusable\n  // doesn't work based on my testing, and that's most probably because the focusable and tabindex attributes are not part\n  // of the SVG 1.1 spec.\n  const {\n    tooltipContent,\n    tooltipProps: { onFocus, onBlur, ...restTooltipProps }\n  } = useTooltip({\n    text: accessibleLabel,\n    anchor: {\n      x: 'element',\n      y: 'element'\n    }\n  });\n\n  return (\n    <Fragment>\n      <svg role=\"img\" {...props} {...restTooltipProps} aria-label={accessibleLabel}>\n        {children}\n      </svg>\n      {tooltipContent}\n    </Fragment>\n  );\n};\n"],"names":["_jsx","_jsxs"],"mappings":";;;;;;;AA6Ba,MAAA,IAAI,GAAG,CAAC,EACnB,IAAI,GAAG,KAAK,EACZ,KAAK,GAAG,cAAc,EACtB,eAAe,GAAG,EAAE,EACpB,OAAO,GAAG,MAAM,EAChB,QAAQ,EACF,MACNA,GAAA,CAAC,GAAG,EAAA,EACF,MAAM,EAAC,KAAK,EACZ,KAAK,EAAC,KAAK,EACX,OAAO,EAAE,OAAO,EAChB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EACpB,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,KAAK,KAAK,GAAG,IAAI,GAAG,CAAG,EAAA,SAAS,CAAC,IAAI,CAAC,CAAE,CAAA,EAAE,YAChE,QAAQ,EAAA,CACL,EACN;AAUF,MAAM,GAAG,GAAG,CAAC,EAAE,eAAe,EAAE,GAAG,UAAU,EAAY,KACvD,eAAe,IACbA,GAAA,CAAC,WAAW,EAAA,EAAC,eAAe,EAAE,eAAe,EAAM,GAAA,UAAU,GAAI,KAEjEA,GAAC,CAAA,aAAa,OAAK,UAAU,EAAA,CAAI,CAClC,CAAC;AAEJ,MAAM,aAAa,GAAG,CAAC,KAAmB,KAAKA,GAAA,CAAA,KAAA,EAAA,EAAA,GAAS,KAAK,EAAA,CAAI,CAAC;AAElE,MAAM,WAAW,GAAG,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAY,KAAI;;;;;;;;;;;;;;;;;;;;;;;;AAwBxE,IAAA,MAAM,EACJ,cAAc,EACd,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,EACvD,GAAG,UAAU,CAAC;AACb,QAAA,IAAI,EAAE,eAAe;AACrB,QAAA,MAAM,EAAE;AACN,YAAA,CAAC,EAAE,SAAS;AACZ,YAAA,CAAC,EAAE,SAAS;AACb,SAAA;AACF,KAAA,CAAC,CAAC;IAEH,QACEC,KAAC,QAAQ,EAAA,EAAA,QAAA,EAAA,CACPD,aAAK,IAAI,EAAC,KAAK,EAAK,GAAA,KAAK,KAAM,gBAAgB,EAAA,YAAA,EAAc,eAAe,EACzE,QAAA,EAAA,QAAQ,GACL,EACL,cAAc,CACN,EAAA,CAAA,EACX;AACJ,CAAC;;;;"}

package/es/IconButton-00d14d5c.js

@@ -0,0 +1,19 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsxs, jsx } from 'preact/jsx-runtime';
+import { Fragment } from 'preact';
+import './UNSAFE_BaseButton.js';
+import './UNSAFE_ButtonLayout.js';
+import { forwardRef } from 'preact/compat';
+import { useTooltip } from './hooks/UNSAFE_useTooltip.js';
+import { B as BaseButton } from './BaseButton-cad1ad64.js';
+import { B as ButtonLayout } from './ButtonLayout-67cf706d.js';
+
+const IconButton = forwardRef(({ variant = 'outlined', isDisabled = false, isRepeat = false, size = 'md', autofocus, onAction, tooltip, 'aria-label': accessibleLabel, 'aria-describedby': ariaDescribedBy, ...props }, ref) => {
+    const { tooltipContent, tooltipProps } = useTooltip({
+        text: tooltip ? tooltip : accessibleLabel
+    });
+    return (jsxs(Fragment, { children: [jsx(BaseButton, { ...tooltipProps, ref: ref, isDisabled: isDisabled, isRepeat: isRepeat, size: size, autofocus: autofocus, variant: variant, styling: ['min'], onAction: onAction, "aria-describedby": ariaDescribedBy, "aria-label": accessibleLabel ?? tooltip, children: jsx(ButtonLayout, { display: 'icons', startIcon: props.children, size: size }) }), tooltipContent] }));
+});
+
+export { IconButton as I };
+//# sourceMappingURL=IconButton-00d14d5c.js.map

package/es/IconButton-00d14d5c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconButton-00d14d5c.js","sources":["../../src/UNSAFE_IconButton/IconButton.tsx"],"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 */\nimport { ComponentChild, Fragment, Ref } from 'preact';\nimport { BaseButton } from '../UNSAFE_BaseButton';\nimport { ButtonLayout } from '../UNSAFE_ButtonLayout';\nimport { forwardRef } from 'preact/compat';\nimport { HTMLAttributesSignalExcluded } from '../utils/UNSAFE_attributeUtils';\nimport { useTooltip } from '../hooks/UNSAFE_useTooltip';\n\ntype IntrinsicProps = Pick<HTMLAttributesSignalExcluded<HTMLButtonElement>, 'autofocus'>;\n\n/**\n * Note that only the ghost variant supports the xs size.\n */\ntype VariantSizeProps =\n  | {\n      /**\n       * Indicates in what states the button has chrome (background and border).\n       *     \"ghost\": \"Ghost buttons are the least prominent variant. Ghost buttons are\n       * useful for performing low-priority tasks, such as manipulating the UI.\",\n       *     \"borderless\"': \"Borderless buttons are a more prominent variant. Borderless\n       * buttons are useful for supplemental actions that require minimal emphasis.\",\n       *     \"outlined\"': \"Outlined buttons are salient, but lighter weight than\n       * solid buttons. Outlined buttons are useful for secondary actions.\",\n       *     \"solid\"': \"Solid buttons stand out, and direct the user's attention to the\n       *  most important actions in the UI.\",\n       *     \"callToAction\"': \"A Call To Action (CTA) button guides the user to take or\n       * complete the action that is the main goal of the page or page section. There\n       * should only be one CTA button on a page at any given time.\",\n       *     \"danger\"': \"A Danger button alerts the user to a dangerous situation.\"\n       */\n      variant?: 'ghost';\n      /**\n       * The size indicates how large the button is rendered.\n       */\n      size?: 'xs' | 'sm' | 'md' | 'lg';\n    }\n  | {\n      variant?: 'borderless' | 'outlined' | 'solid' | 'callToAction' | 'danger';\n\n      size?: 'sm' | 'md' | 'lg';\n    };\n\ntype BaseProps = IntrinsicProps & {\n  /**\n   * Specifies the icon for the button.\n   */\n  children?: ComponentChild;\n\n  /**\n   * Specifies that the button element should be disabled.\n   */\n  isDisabled?: boolean;\n\n  /**\n   * Specifies if repeated events are dispatched for key or pointer held down\n   */\n  isRepeat?: boolean;\n\n  /**\n   * The ID of an element (or space separated IDs of multiple elements) that\n   * describes the button.\n   */\n  'aria-describedby'?: string;\n\n  /**\n   * Triggered when a button is clicked, whether by keyboard, mouse, or touch events.\n   */\n  onAction?: () => void | null;\n};\n\n/**\n * Note that either an accessibleLabel or tooltip must be specified.\n */\ntype VariationAccessibleLabelProps =\n  | {\n      /**\n       * accessibleLabel - the aria label\n       */\n      'aria-label': string;\n\n      /**\n       * tooltip - overrides the accessibleLabel for the tooltip\n       */\n      tooltip?: string;\n    }\n  | {\n      'aria-label'?: string;\n\n      tooltip: string;\n    };\n\nexport const IconButton = forwardRef(\n  (\n    {\n      variant = 'outlined',\n      isDisabled = false,\n      isRepeat = false,\n      size = 'md',\n      autofocus,\n      onAction,\n      tooltip,\n      'aria-label': accessibleLabel,\n      'aria-describedby': ariaDescribedBy,\n      ...props\n    }: BaseProps & VariantSizeProps & VariationAccessibleLabelProps,\n    ref?: Ref<HTMLButtonElement>\n  ) => {\n    const { tooltipContent, tooltipProps } = useTooltip({\n      text: tooltip ? tooltip : accessibleLabel\n    });\n    return (\n      <Fragment>\n        <BaseButton\n          {...tooltipProps}\n          ref={ref as Ref<HTMLButtonElement> & Ref<HTMLAnchorElement> & Ref<HTMLSpanElement>}\n          isDisabled={isDisabled}\n          isRepeat={isRepeat}\n          size={size}\n          autofocus={autofocus}\n          variant={variant}\n          styling={['min']}\n          onAction={onAction}\n          aria-describedby={ariaDescribedBy}\n          aria-label={accessibleLabel ?? tooltip}>\n          <ButtonLayout display={'icons'} startIcon={props.children} size={size}></ButtonLayout>\n        </BaseButton>\n        {tooltipContent}\n      </Fragment>\n    );\n  }\n);\n"],"names":["_jsxs","_jsx"],"mappings":";;;;;;;;;;MAiGa,UAAU,GAAG,UAAU,CAClC,CACE,EACE,OAAO,GAAG,UAAU,EACpB,UAAU,GAAG,KAAK,EAClB,QAAQ,GAAG,KAAK,EAChB,IAAI,GAAG,IAAI,EACX,SAAS,EACT,QAAQ,EACR,OAAO,EACP,YAAY,EAAE,eAAe,EAC7B,kBAAkB,EAAE,eAAe,EACnC,GAAG,KAAK,EACqD,EAC/D,GAA4B,KAC1B;AACF,IAAA,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC;QAClD,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,eAAe;AAC1C,KAAA,CAAC,CAAC;AACH,IAAA,QACEA,IAAA,CAAC,QAAQ,EAAA,EAAA,QAAA,EAAA,CACPC,IAAC,UAAU,EAAA,EAAA,GACL,YAAY,EAChB,GAAG,EAAE,GAA6E,EAClF,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,CAAC,KAAK,CAAC,EAChB,QAAQ,EAAE,QAAQ,EACA,kBAAA,EAAA,eAAe,EACrB,YAAA,EAAA,eAAe,IAAI,OAAO,EAAA,QAAA,EACtCA,GAAC,CAAA,YAAY,IAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAiB,EAC3E,CAAA,EACZ,cAAc,CAAA,EAAA,CACN,EACX;AACJ,CAAC;;;;"}

package/es/IconMenuButton-c93c3f25.js

@@ -0,0 +1,39 @@
+/* @oracle/oraclejet-preact: 15.1.3 */
+import { jsx, jsxs } from 'preact/jsx-runtime';
+import './UNSAFE_ButtonLayout.js';
+import './PRIVATE_ThemedIcons/ChevronDownIcon.js';
+import './UNSAFE_Menu.js';
+import { useMenuAction } from './hooks/UNSAFE_useMenuAction.js';
+import { useTooltip } from './hooks/UNSAFE_useTooltip.js';
+import './UNSAFE_BaseButton.js';
+import { Fragment } from 'preact';
+import { forwardRef } from 'preact/compat';
+import { useRef, useImperativeHandle } from 'preact/hooks';
+import { mergeProps } from './utils/UNSAFE_mergeProps.js';
+import { B as BaseButton } from './BaseButton-cad1ad64.js';
+import { B as ButtonLayout } from './ButtonLayout-67cf706d.js';
+import { S as SvgChevronDown } from './index-7e62fa17.js';
+import { M as Menu } from './Menu-3c6e6068.js';
+
+/**
+ * A IconMenuButton is a combined action and menu button.
+ */
+const IconMenuButton = forwardRef(({ children, tooltip, accessibleLabel, variant = 'outlined', isDisabled = false, isMenuOpen = false, isIconOnly = false, onToggleMenu, size = 'md', width, icon, 'aria-describedby': ariaDescribedBy }, ref) => {
+    const buttonRef = useRef(null);
+    useImperativeHandle(ref, () => buttonRef.current, [buttonRef]);
+    const { triggerProps, menuProps } = useMenuAction({
+        isDisabled: isDisabled,
+        onToggleMenu: onToggleMenu,
+        isMenuOpen: isMenuOpen,
+        anchorRef: buttonRef
+    });
+    const { tooltipContent, tooltipProps } = useTooltip({
+        text: tooltip ? tooltip : accessibleLabel,
+        isDisabled: isMenuOpen
+    });
+    const rootButton = (jsx(Fragment, { children: jsxs(BaseButton, { ...mergeProps(tooltipProps, triggerProps), styling: isMenuOpen ? ['min', 'active'] : ['min'], isDisabled: isDisabled, variant: variant, width: width, size: size, ref: buttonRef, "aria-describedby": ariaDescribedBy, "aria-label": accessibleLabel ?? tooltip, children: [jsx(ButtonLayout, { display: 'icons', startIcon: icon, endIcon: isIconOnly ? null : jsx(SvgChevronDown, {}), size: size }), tooltipContent] }) }));
+    return isDisabled ? (rootButton) : (jsxs(Fragment, { children: [rootButton, jsx(Menu, { ...menuProps, children: children })] }));
+});
+
+export { IconMenuButton as I };
+//# sourceMappingURL=IconMenuButton-c93c3f25.js.map

package/es/IconMenuButton-c93c3f25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IconMenuButton-c93c3f25.js","sources":["../../src/UNSAFE_IconMenuButton/IconMenuButton.tsx"],"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 */\nimport { ButtonLayout } from '../UNSAFE_ButtonLayout';\n\nimport { ChevronDownIcon } from '../PRIVATE_ThemedIcons/ChevronDownIcon';\n\nimport { Menu } from '../UNSAFE_Menu';\nimport { useMenuAction, MenuToggleDetail } from '../hooks/UNSAFE_useMenuAction';\nimport { useTooltip } from '../hooks/UNSAFE_useTooltip';\n\nimport { BaseButton } from '../UNSAFE_BaseButton';\n\nimport type { DimensionProps } from '../utils/UNSAFE_interpolations/dimensions';\n\nimport { ComponentChildren, ComponentChild, Fragment } from 'preact';\nimport { forwardRef, ForwardedRef } from 'preact/compat';\nimport { useRef, useImperativeHandle } from 'preact/hooks';\nimport { mergeProps } from '../utils/UNSAFE_mergeProps';\n\ntype WidthInterpolationProps = Pick<DimensionProps, 'width'>;\n\nexport type BaseProps = WidthInterpolationProps & {\n  /**\n   * children - One or more MenuItems, dividers, or Menu groups\n   */\n  children?: ComponentChildren;\n\n  /**\n   * The icon is the button's icon.  Note that this is not the menu\n   * expand icon shown on the right (or to the left in right to left mode).\n   */\n  icon?: ComponentChild;\n\n  /**\n   * Specifies that the button element should be disabled.\n   */\n  isDisabled?: boolean;\n\n  /**\n   * Specifies if only the icon is shown, and no down chevron.\n   */\n  isIconOnly?: boolean;\n\n  /**\n   * The ID of an element (or space separated IDs of multiple elements) that\n   * describes the button.\n   */\n  'aria-describedby'?: string;\n\n  /**\n   * Specifies if the menu is open\n   */\n  isMenuOpen?: boolean;\n\n  /**\n   * Property that triggers a callback immediately when toggle happens and value of expanded property should be updated\n   */\n  onToggleMenu?: (details: MenuToggleDetail) => void;\n\n  /**\n   * Indicates in what states the button has chrome (background and border).\n   *     \"borderless\"': \"Borderless buttons are a more prominent variation. Borderless\n   * buttons are useful for supplemental actions that require minimal emphasis.\",\n   *     \"outlined\"': \"Outlined buttons are salient, but lighter weight than\n   * solid buttons. Outlined buttons are useful for secondary actions.\",\n   *     \"solid\"': \"Solid buttons stand out, and direct the user's attention to the\n   *  most important actions in the UI.\"\n   */\n  variant?: 'borderless' | 'outlined' | 'solid';\n\n  /**\n   * The size indicates how large the button is rendered: \"sm\", \"md\" (default), \"lg\".\n   */\n  size?: 'sm' | 'md' | 'lg';\n};\n\n/**\n * Note that either an accessibleLabel or tooltip must be specified.\n */\ntype VariationAccessibleLabelProps =\n  | {\n      /**\n       * accessibleLabel - the aria label\n       */\n      accessibleLabel: string;\n\n      /**\n       * tooltip - overrides the accessibleLabel for the tooltip\n       */\n      tooltip?: string;\n    }\n  | {\n      accessibleLabel?: string;\n\n      tooltip: string;\n    };\n\n/**\n * A IconMenuButton is a combined action and menu button.\n */\nexport const IconMenuButton = forwardRef(\n  (\n    {\n      children,\n      tooltip,\n      accessibleLabel,\n      variant = 'outlined',\n      isDisabled = false,\n      isMenuOpen = false,\n      isIconOnly = false,\n      onToggleMenu,\n      size = 'md',\n      width,\n      icon,\n      'aria-describedby': ariaDescribedBy\n    }: BaseProps & VariationAccessibleLabelProps,\n    ref?: ForwardedRef<HTMLButtonElement>\n  ) => {\n    const buttonRef = useRef<HTMLButtonElement>(null);\n    useImperativeHandle(ref!, () => buttonRef.current!, [buttonRef]);\n\n    const { triggerProps, menuProps } = useMenuAction({\n      isDisabled: isDisabled,\n      onToggleMenu: onToggleMenu,\n      isMenuOpen: isMenuOpen,\n      anchorRef: buttonRef\n    });\n\n    const { tooltipContent, tooltipProps } = useTooltip({\n      text: tooltip ? tooltip : accessibleLabel,\n      isDisabled: isMenuOpen\n    });\n\n    const rootButton = (\n      <Fragment>\n        <BaseButton\n          {...mergeProps(tooltipProps, triggerProps)}\n          styling={isMenuOpen ? ['min', 'active'] : ['min']}\n          isDisabled={isDisabled}\n          variant={variant}\n          width={width}\n          size={size}\n          ref={buttonRef}\n          aria-describedby={ariaDescribedBy}\n          aria-label={accessibleLabel ?? tooltip}>\n          <ButtonLayout\n            display={'icons'}\n            startIcon={icon}\n            endIcon={isIconOnly ? null : <ChevronDownIcon />}\n            size={size}></ButtonLayout>\n          {tooltipContent}\n        </BaseButton>\n      </Fragment>\n    );\n\n    return isDisabled ? (\n      rootButton\n    ) : (\n      <Fragment>\n        {rootButton}\n        <Menu {...menuProps}>{children}</Menu>\n      </Fragment>\n    );\n  }\n);\n"],"names":["_jsx","_jsxs","ChevronDownIcon"],"mappings":";;;;;;;;;;;;;;;;;AAsGA;;AAEG;MACU,cAAc,GAAG,UAAU,CACtC,CACE,EACE,QAAQ,EACR,OAAO,EACP,eAAe,EACf,OAAO,GAAG,UAAU,EACpB,UAAU,GAAG,KAAK,EAClB,UAAU,GAAG,KAAK,EAClB,UAAU,GAAG,KAAK,EAClB,YAAY,EACZ,IAAI,GAAG,IAAI,EACX,KAAK,EACL,IAAI,EACJ,kBAAkB,EAAE,eAAe,EACO,EAC5C,GAAqC,KACnC;AACF,IAAA,MAAM,SAAS,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;AAClD,IAAA,mBAAmB,CAAC,GAAI,EAAE,MAAM,SAAS,CAAC,OAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAEjE,IAAA,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC;AAChD,QAAA,UAAU,EAAE,UAAU;AACtB,QAAA,YAAY,EAAE,YAAY;AAC1B,QAAA,UAAU,EAAE,UAAU;AACtB,QAAA,SAAS,EAAE,SAAS;AACrB,KAAA,CAAC,CAAC;AAEH,IAAA,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,GAAG,UAAU,CAAC;QAClD,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,eAAe;AACzC,QAAA,UAAU,EAAE,UAAU;AACvB,KAAA,CAAC,CAAC;IAEH,MAAM,UAAU,IACdA,GAAA,CAAC,QAAQ,EACP,EAAA,QAAA,EAAAC,IAAA,CAAC,UAAU,EACL,EAAA,GAAA,UAAU,CAAC,YAAY,EAAE,YAAY,CAAC,EAC1C,OAAO,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EACjD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,SAAS,sBACI,eAAe,EAAA,YAAA,EACrB,eAAe,IAAI,OAAO,aACtCD,GAAC,CAAA,YAAY,IACX,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,UAAU,GAAG,IAAI,GAAGA,GAAC,CAAAE,cAAe,KAAG,EAChD,IAAI,EAAE,IAAI,EAAA,CAAiB,EAC5B,cAAc,CAAA,EAAA,CACJ,EACJ,CAAA,CACZ,CAAC;IAEF,OAAO,UAAU,IACf,UAAU,KAEVD,IAAA,CAAC,QAAQ,EACN,EAAA,QAAA,EAAA,CAAA,UAAU,EACXD,GAAA,CAAC,IAAI,EAAA,EAAA,GAAK,SAAS,EAAA,QAAA,EAAG,QAAQ,EAAA,CAAQ,CAC7B,EAAA,CAAA,CACZ,CAAC;AACJ,CAAC;;;;"}