@procore/core-react 11.12.1 → 11.13.0-rc.0

package/dist/OverlayTrigger/a11yPresets.d.ts

@@ -1,4 +1,4 @@
-import { AriaAttributes } from 'react';
+import React, { AriaAttributes } from 'react';
 import { OverlayTriggerRole } from './OverlayTrigger.types';
 declare type GetA11yProps = (props: {
     role: OverlayTriggerRole;
@@ -11,4 +11,205 @@ export declare function getA11yPreset(role?: OverlayTriggerRole): {
     getOverlayProps: GetA11yProps;
     getTriggerProps: GetA11yProps;
 };
+declare type LabelConfig = {
+    'aria-describedby'?: string;
+    'aria-details'?: string;
+    'aria-labelledby'?: string;
+    'aria-label'?: string;
+    /**
+     * ID for the widget itself
+     */
+    id?: string;
+};
+declare type DialogBase = LabelConfig & {
+    isOpen: boolean;
+    role?: 'dialog';
+};
+declare type NonModalDialogConfig = DialogBase & {
+    isModal?: never | false;
+};
+declare type ModalDialogConfig = DialogBase & {
+    /**
+     *
+     * To enable `ariaHideOutside`. Set `isModal` to false to disable.
+     * @a11y Replicates `aria-modal` inert outside content
+     * @default false
+     */
+    isModal: true;
+    ref: React.RefObject<HTMLElement>;
+};
+declare type ModalDialogLikeConfig = NonModalDialogConfig | ModalDialogConfig;
+declare type OverlayTriggerA11yConfig = LabelConfig & {
+    /**
+     * Assure `aria-hidden` is not applied. A code side-effect
+     * from `ariaHideOutside` hiding everthing outside the scope.
+     */
+    alwaysAriaVisible?: boolean;
+    /**
+     * When properties should be passed to the overlay UI itself,
+     * and not the wrapper element.
+     */
+    canPropOverlayUp: boolean;
+    isOpen: boolean;
+    role?: OverlayTriggerRole;
+};
+/**
+ * Manages labelling for an element and the other DOM. Defaults an ID for `aria-labelledby` usage.
+ *
+ * When `aria-label` and `aria-labelledby` both exist, it combines them into `aria-labelledby` for a screen reader chain.
+ * @link [W3 naming with aria-labelledby](https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/#naming_with_aria-labelledby)
+ */
+export declare function useLabelled(props?: LabelConfig): {
+    descriptionProps: {
+        id: string | undefined;
+    };
+    labelProps: {
+        id: string | undefined;
+    };
+    widgetProps: {
+        'aria-describedby': string | undefined;
+        'aria-details': string | undefined;
+        id?: string | undefined;
+        'aria-label'?: string | undefined;
+        'aria-labelledby'?: string | undefined;
+    };
+};
+/**
+ * Cover the label links for the trigger (button), the popup element (dialog), and the popup element title (heading).
+ * Similar to [React Aria useOverlayTrigger](https://github.com/adobe/react-spectrum/blob/main/packages/%40react-aria/overlays/src/useOverlayTrigger.ts)
+ * but with element title support.
+ * @link [MDN aria-haspopup](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup)
+ */
+export declare function useLabelledPopup({ 'aria-describedby': ariaDescribedby, 'aria-details': ariaDetails, 'aria-labelledby': ariaLabelledby, 'aria-label': ariaLabel, id: id_, isOpen, type, popupRole, popupId: popupId_, }: LabelConfig & {
+    isOpen: boolean;
+    popupId?: string;
+    type?: 'button' | 'combobox';
+    popupRole: 'dialog' | 'menu' | 'listbox';
+}): {
+    labelProps: {
+        id: string | undefined;
+    };
+    popupProps: {
+        'aria-activedescendant'?: string | undefined;
+        'aria-atomic'?: boolean | "true" | "false" | undefined;
+        'aria-autocomplete'?: "none" | "list" | "inline" | "both" | undefined;
+        'aria-busy'?: boolean | "true" | "false" | undefined;
+        'aria-checked'?: boolean | "true" | "false" | "mixed" | undefined;
+        'aria-colcount'?: number | undefined;
+        'aria-colindex'?: number | undefined;
+        'aria-colspan'?: number | undefined;
+        'aria-controls'?: string | undefined;
+        'aria-current'?: boolean | "time" | "true" | "false" | "step" | "page" | "location" | "date" | undefined;
+        'aria-describedby': string | undefined;
+        'aria-details': string | undefined;
+        'aria-disabled'?: boolean | "true" | "false" | undefined;
+        'aria-dropeffect'?: "none" | "link" | "copy" | "execute" | "move" | "popup" | undefined;
+        'aria-errormessage'?: string | undefined;
+        'aria-expanded'?: boolean | "true" | "false" | undefined;
+        'aria-flowto'?: string | undefined;
+        'aria-grabbed'?: boolean | "true" | "false" | undefined;
+        'aria-haspopup'?: boolean | "dialog" | "menu" | "true" | "false" | "listbox" | "tree" | "grid" | undefined;
+        'aria-hidden'?: boolean | "true" | "false" | undefined;
+        'aria-invalid'?: boolean | "true" | "false" | "grammar" | "spelling" | undefined;
+        'aria-keyshortcuts'?: string | undefined;
+        'aria-label'?: string | undefined;
+        'aria-labelledby'?: string | undefined;
+        'aria-level'?: number | undefined;
+        'aria-live'?: "off" | "assertive" | "polite" | undefined;
+        'aria-modal'?: boolean | "true" | "false" | undefined;
+        'aria-multiline'?: boolean | "true" | "false" | undefined;
+        'aria-multiselectable'?: boolean | "true" | "false" | undefined;
+        'aria-orientation'?: "horizontal" | "vertical" | undefined;
+        'aria-owns'?: string | undefined;
+        'aria-placeholder'?: string | undefined;
+        'aria-posinset'?: number | undefined;
+        'aria-pressed'?: boolean | "true" | "false" | "mixed" | undefined;
+        'aria-readonly'?: boolean | "true" | "false" | undefined;
+        'aria-relevant'?: "text" | "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals" | undefined;
+        'aria-required'?: boolean | "true" | "false" | undefined;
+        'aria-roledescription'?: string | undefined;
+        'aria-rowcount'?: number | undefined;
+        'aria-rowindex'?: number | undefined;
+        'aria-rowspan'?: number | undefined;
+        'aria-selected'?: boolean | "true" | "false" | undefined;
+        'aria-setsize'?: number | undefined;
+        'aria-sort'?: "none" | "ascending" | "descending" | "other" | undefined;
+        'aria-valuemax'?: number | undefined;
+        'aria-valuemin'?: number | undefined;
+        'aria-valuenow'?: number | undefined;
+        'aria-valuetext'?: string | undefined;
+        id?: string | undefined;
+        role: "dialog" | "menu" | "listbox";
+    };
+    triggerProps: React.AriaAttributes & {
+        id?: string | undefined;
+    };
+};
+/**
+ * For dialog experiences:
+ * - Has role dialog and aria linked title props
+ * - Focus management props to work with FocusScope
+ *
+ * For modal dialog experiences (full screen locked experiences):
+ * - Hides old and new content outside with aria-hidden with ariaHideOutside (like aria-modal)
+ * - (it will in breaking) Prevent scroll
+ *
+ * For either experiences, you still MUST support:
+ * - have Escape key to close (It should!)
+ * - have click outside, like scrim click
+ *
+ * _More about 'modal dialog' and `isModal` not using `aria-modal`:_
+ * Setting aria-modal="true" tells assistive technologies to let the user know the ability to interact with,
+ * or access other content on the page requires the modal dialog to be closed or otherwise lose focus.
+ *  Modal dialogs are when content is displayed and the user's interaction is limited to only that section until it is dismissed.
+ * [MDN aria modal](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-modal).
+ * To support the most, like Narrator in Edge, Core React uses `ariaHideOutside` to set `aria-hidden` on
+ * all elements outside the dialog, and **all elements outside added while opened**, so the dialog will act as a
+ * _modal_ even without `aria-modal` on the dialog itself. See Future Considerations below.
+ * [Screen Reader aria modal support table](https://a11ysupport.io/tech/aria/aria-modal_attribute) - [MS Narrator Edge aria modal support](https://a11ysupport.io/tests/apg__modal-dialog-example/aria__aria-modal_attribute/convey_presence/narrator/edge)
+ * _Future Considerations:_ Replace ariaHideOutside with aria-modal="true".
+ * Using aria-modal, then we would need to involve Portal and so tooltips
+ * or Toasts could mount within the visible aria-modal container.
+ */
+export declare function useModalDialogLike({ 'aria-describedby': ariaDescribedby, 'aria-details': ariaDetails, 'aria-labelledby': ariaLabelledby, 'aria-label': ariaLabel, id, isModal, isOpen, ref, role, }: ModalDialogLikeConfig): {
+    dialogProps: {
+        id: string | undefined;
+        role: "dialog";
+        tabIndex: number;
+        'aria-describedby': string | undefined;
+        'aria-details': string | undefined;
+        'aria-label'?: string | undefined;
+        'aria-labelledby'?: string | undefined;
+    };
+    labelProps: {
+        id: string | undefined;
+    };
+    focusScopeProps: {
+        autoFocus: boolean;
+        contain: boolean;
+        restoreFocus: boolean;
+    };
+};
+/**
+ * Takes many roles and determines props necessary for DOM/components.
+ * **Side effect of role="dialog"**, current and any content added later
+ * outside of the element (like by portals) will get `aria-hidden=true`
+ * to replace the `aria-modal=true` `inert` nature.
+ * @see useModalDialogLike */
+export declare function useOverlayTriggerA11y({ alwaysAriaVisible, 'aria-describedby': ariaDescribedby, 'aria-details': ariaDetails, 'aria-labelledby': ariaLabelledby, 'aria-label': ariaLabel, canPropOverlayUp, id: id_, isOpen, role, }: OverlayTriggerA11yConfig): {
+    focusScopeProps: {
+        autoFocus?: boolean | undefined;
+        contain?: boolean | undefined;
+        restoreFocus?: boolean | undefined;
+    };
+    labelProps: {
+        id: string | undefined;
+    };
+    overlayProps: {};
+    portalProps: {};
+    triggerProps: React.AriaAttributes & {
+        id?: string | undefined;
+    };
+    wrapperProps: {};
+};
 export {};

package/dist/OverlayTrigger/a11yPresets.js

@@ -1,3 +1,18 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { ariaHideOutside } from '@react-aria/overlays';
+import { useId, useLabels } from '@react-aria/utils';
+import React from 'react';
+var emptyObj = {};
 var returnEmpty = function () { return ({}); };
 var a11yPresets = {
     haspopup: {
@@ -55,4 +70,199 @@ export function getA11yPreset(role) {
             };
     }
 }
+/**
+ * Manages labelling for an element and the other DOM. Defaults an ID for `aria-labelledby` usage.
+ *
+ * When `aria-label` and `aria-labelledby` both exist, it combines them into `aria-labelledby` for a screen reader chain.
+ * @link [W3 naming with aria-labelledby](https://www.w3.org/WAI/ARIA/apg/practices/names-and-descriptions/#naming_with_aria-labelledby)
+ */
+export function useLabelled(props) {
+    var _a = props || emptyObj, ariaDescribedby = _a["aria-describedby"], ariaDetails = _a["aria-details"], ariaLabelledby = _a["aria-labelledby"], ariaLabel = _a["aria-label"], id = _a.id;
+    var ariaLabelOnly = ariaLabel && !ariaLabelledby;
+    // Generate an ID. We want to use this unless they are using only aria-label
+    var labelledId = useId(ariaLabelledby);
+    // Merges aria-label and aria-labelledby into aria-labelledby when both exist
+    var widgetId = useId(id);
+    var fieldProps = useLabels({
+        'aria-label': ariaLabel,
+        'aria-labelledby': ariaLabelOnly ? undefined : labelledId,
+        id: widgetId,
+    });
+    return {
+        descriptionProps: { id: ariaDescribedby },
+        labelProps: { id: ariaLabelOnly ? undefined : labelledId },
+        widgetProps: __assign(__assign({}, fieldProps), { 'aria-describedby': ariaDescribedby, 'aria-details': ariaDetails }),
+    };
+}
+/**
+ * Cover the label links for the trigger (button), the popup element (dialog), and the popup element title (heading).
+ * Similar to [React Aria useOverlayTrigger](https://github.com/adobe/react-spectrum/blob/main/packages/%40react-aria/overlays/src/useOverlayTrigger.ts)
+ * but with element title support.
+ * @link [MDN aria-haspopup](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-haspopup)
+ */
+export function useLabelledPopup(_a) {
+    var _b, _c, _d, _e;
+    var ariaDescribedby = _a["aria-describedby"], ariaDetails = _a["aria-details"], ariaLabelledby = _a["aria-labelledby"], ariaLabel = _a["aria-label"], id_ = _a.id, isOpen = _a.isOpen, _f = _a.type, type = _f === void 0 ? 'button' : _f, popupRole = _a.popupRole, popupId_ = _a.popupId;
+    /** Web spec default for aria-haspopup=true is menu, unless element has role combobox, which have an implicit aria-haspopup value of listbox. */
+    // const popupRole = popupRole_ || type === 'combobox' ? 'listbox' : 'menu'
+    var id = useId(id_);
+    var popupId = useId(popupId_);
+    var presetArgs = {
+        isVisible: isOpen,
+        role: popupRole,
+        overlayId: popupId,
+    };
+    var triggerProps = (_c = (_b = getA11yPreset(popupRole)).getTriggerProps) === null || _c === void 0 ? void 0 : _c.call(_b, presetArgs);
+    var overlayProps = (_e = (_d = getA11yPreset(popupRole)).getOverlayProps) === null || _e === void 0 ? void 0 : _e.call(_d, presetArgs);
+    var _g = useLabelled({
+        'aria-describedby': ariaDescribedby,
+        'aria-details': ariaDetails,
+        'aria-labelledby': ariaLabelledby,
+        'aria-label': ariaLabel,
+        id: id,
+    }), labelProps = _g.labelProps, widgetProps = _g.widgetProps;
+    return {
+        labelProps: labelProps,
+        popupProps: __assign(__assign({ role: popupRole }, widgetProps), overlayProps),
+        triggerProps: triggerProps,
+    };
+}
+/**
+ * For dialog experiences:
+ * - Has role dialog and aria linked title props
+ * - Focus management props to work with FocusScope
+ *
+ * For modal dialog experiences (full screen locked experiences):
+ * - Hides old and new content outside with aria-hidden with ariaHideOutside (like aria-modal)
+ * - (it will in breaking) Prevent scroll
+ *
+ * For either experiences, you still MUST support:
+ * - have Escape key to close (It should!)
+ * - have click outside, like scrim click
+ *
+ * _More about 'modal dialog' and `isModal` not using `aria-modal`:_
+ * Setting aria-modal="true" tells assistive technologies to let the user know the ability to interact with,
+ * or access other content on the page requires the modal dialog to be closed or otherwise lose focus.
+ *  Modal dialogs are when content is displayed and the user's interaction is limited to only that section until it is dismissed.
+ * [MDN aria modal](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-modal).
+ * To support the most, like Narrator in Edge, Core React uses `ariaHideOutside` to set `aria-hidden` on
+ * all elements outside the dialog, and **all elements outside added while opened**, so the dialog will act as a
+ * _modal_ even without `aria-modal` on the dialog itself. See Future Considerations below.
+ * [Screen Reader aria modal support table](https://a11ysupport.io/tech/aria/aria-modal_attribute) - [MS Narrator Edge aria modal support](https://a11ysupport.io/tests/apg__modal-dialog-example/aria__aria-modal_attribute/convey_presence/narrator/edge)
+ * _Future Considerations:_ Replace ariaHideOutside with aria-modal="true".
+ * Using aria-modal, then we would need to involve Portal and so tooltips
+ * or Toasts could mount within the visible aria-modal container.
+ */
+export function useModalDialogLike(_a) {
+    var ariaDescribedby = _a["aria-describedby"], ariaDetails = _a["aria-details"], ariaLabelledby = _a["aria-labelledby"], ariaLabel = _a["aria-label"], id = _a.id, isModal = _a.isModal, isOpen = _a.isOpen, 
+    // @ts-expect-error
+    ref = _a.ref, _b = _a.role, role = _b === void 0 ? 'dialog' : _b;
+    var _c = useLabelled({
+        'aria-describedby': ariaDescribedby,
+        'aria-details': ariaDetails,
+        'aria-labelledby': ariaLabelledby,
+        'aria-label': ariaLabel,
+    }), labelProps = _c.labelProps, widgetProps = _c.widgetProps;
+    var dialogProps = __assign(__assign({}, widgetProps), { id: id, role: role, tabIndex: -1 });
+    // usePreventScroll({
+    //   isDisabled: isModal ? !isOpen : true,
+    // })
+    // Fills aria-modal=true
+    React.useLayoutEffect(function () {
+        if (isModal && isOpen && ref.current) {
+            // Could add additional visible element refs here
+            return ariaHideOutside([ref.current]);
+        }
+    }, [isModal, isOpen, ref]);
+    return {
+        dialogProps: dialogProps,
+        labelProps: labelProps,
+        focusScopeProps: {
+            autoFocus: true,
+            contain: true,
+            restoreFocus: true,
+        },
+    };
+}
+/**
+ * Takes many roles and determines props necessary for DOM/components.
+ * **Side effect of role="dialog"**, current and any content added later
+ * outside of the element (like by portals) will get `aria-hidden=true`
+ * to replace the `aria-modal=true` `inert` nature.
+ * @see useModalDialogLike */
+export function useOverlayTriggerA11y(_a) {
+    var alwaysAriaVisible = _a.alwaysAriaVisible, ariaDescribedby = _a["aria-describedby"], ariaDetails = _a["aria-details"], ariaLabelledby = _a["aria-labelledby"], ariaLabel = _a["aria-label"], 
+    // can we remove this? have it role based? be optional?
+    canPropOverlayUp = _a.canPropOverlayUp, id_ = _a.id, isOpen = _a.isOpen, role = _a.role;
+    var isDialog = role === 'dialog';
+    var id = useId(id_);
+    var _b = getA11yPreset(role), getTriggerProps = _b.getTriggerProps, getOverlayProps = _b.getOverlayProps;
+    var triggerProps = getTriggerProps === null || getTriggerProps === void 0 ? void 0 : getTriggerProps({
+        isVisible: isOpen,
+        role: role,
+        overlayId: id,
+    });
+    var overlayA11yProps = getOverlayProps === null || getOverlayProps === void 0 ? void 0 : getOverlayProps({
+        isVisible: isOpen,
+        role: role,
+        overlayId: id,
+    });
+    var wrapperA11yProps = !canPropOverlayUp ? overlayA11yProps : emptyObj;
+    var overlayProps = canPropOverlayUp ? overlayA11yProps : emptyObj;
+    var _c = useModalDialogLike({
+        'aria-describedby': ariaDescribedby,
+        'aria-details': ariaDetails,
+        'aria-labelledby': ariaLabelledby,
+        'aria-label': ariaLabel,
+        id: id,
+        isModal: false,
+        isOpen: isOpen,
+    }), dialogProps = _c.dialogProps, labelProps = _c.labelProps, focusScopeProps = _c.focusScopeProps;
+    /**  This is a code side-effect from ariaHideOutside hiding everthing */
+    var portalProps = role === 'tooltip' || alwaysAriaVisible // || !role
+        ? { 'data-react-aria-top-layer': true, 'data-live-announcer': true }
+        : emptyObj;
+    /**
+     * If it is a dialog, we can merge the dialog props with any haspopup props
+     */
+    var wrapperFinalProps = isDialog
+        ? __assign(__assign({}, wrapperA11yProps), dialogProps) : wrapperA11yProps;
+    /**
+     * If it is a dialog, we have opinions on `FocusScope` props.
+     */
+    var focusScopeFinalProps = isDialog
+        ? focusScopeProps
+        : emptyObj;
+    return {
+        focusScopeProps: focusScopeFinalProps,
+        labelProps: labelProps,
+        overlayProps: overlayProps,
+        portalProps: portalProps,
+        triggerProps: triggerProps,
+        wrapperProps: wrapperFinalProps,
+    };
+}
+// WIP Example combobox
+// function useCombox({
+//   controls,
+//   isOpen = false,
+// }: {
+//   controls: 'dialog' | 'menu' | 'listbox'
+//   isOpen: boolean
+// }) {
+//   const { labelProps, popupProps, triggerProps } = useLabelledPopup({
+//     role: controls,
+//     type: 'combobox',
+//     isOpen,
+//   })
+// dispatch between elements.
+// NOTE combobox has two labels, that could be different
+// one for the trigger input (typically the form label)
+// second for the thing it controls (listbox, dialog)
+// - label id=1
+// - input role='combobox' aria-labelledby=1
+// - div role={controls} aria-label
+// Also, any icon only buttons like clear or open should have a
+// label and -1 tabindex. No nested interactive roles.
+// }
 //# sourceMappingURL=a11yPresets.js.map

package/dist/OverlayTrigger/a11yPresets.js.map

@@ -1 +1 @@
-{"version":3,"file":"a11yPresets.js","sourceRoot":"","sources":["../../src/OverlayTrigger/a11yPresets.ts"],"names":[],"mappings":"AAGA,IAAM,WAAW,GAAiB,cAAM,OAAA,CAAC,EAAE,CAAC,EAAJ,CAAI,CAAA;AAQ5C,IAAM,WAAW,GAMb;IACF,QAAQ,EAAE;QACR,eAAe,EAAE,UAAC,EAAmB;gBAAjB,IAAI,UAAA,EAAE,SAAS,eAAA;YAAO,OAAA,CAAC;gBACzC,EAAE,EAAE,SAAS;gBACb,IAAI,MAAA;aACL,CAAC;QAHwC,CAGxC;QACF,eAAe,EAAE,UAAC,EAA8B;gBAA5B,IAAI,UAAA,EAAE,SAAS,eAAA,EAAE,SAAS,eAAA;YAAO,OAAA,CAAC;gBACpD,eAAe,EAAE,SAAS;gBAC1B,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAClD,eAAe,EAAE,IAAqC;aACvD,CAAC;QAJmD,CAInD;KACH;IACD,OAAO,EAAE;QACP,eAAe,EAAE,UAAC,EAAa;gBAAX,SAAS,eAAA;YAAO,OAAA,CAAC;gBACnC,IAAI,EAAE,SAAS;gBACf,EAAE,EAAE,SAAS;aACd,CAAC;QAHkC,CAGlC;QACF,eAAe,EAAE,UAAC,EAAwB;gBAAtB,SAAS,eAAA,EAAE,SAAS,eAAA;YACtC,OAAA,SAAS;gBACP,CAAC,CAAC;oBACE,kBAAkB,EAAE,SAAS;iBAC9B;gBACH,CAAC,CAAC,EAAE;QAJN,CAIM;KACT;CACF,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,IAAyB;IACrD,QAAQ,IAAI,EAAE;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC;QACf,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,QAAQ,CAAA;QAC7B,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,OAAO,CAAA;QAC5B,KAAK,MAAM;YACT,OAAO;gBACL,eAAe,EAAE,CAAC,cAAM,OAAA,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAlB,CAAkB,CAAiB;gBAC3D,eAAe,EAAE,WAAW;aAC7B,CAAA;QACH;YACE,OAAO;gBACL,eAAe,EAAE,WAAW;gBAC5B,eAAe,EAAE,WAAW;aAC7B,CAAA;KACJ;AACH,CAAC"}
+{"version":3,"file":"a11yPresets.js","sourceRoot":"","sources":["../../src/OverlayTrigger/a11yPresets.ts"],"names":[],"mappings":"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"}

package/dist/Popover/Popover.d.ts

@@ -1,6 +1,28 @@
 import React from 'react';
 import { DivAttributes } from '../_utils/types';
-import { PopoverContentProps, PopoverProps } from './Popover.types';
-export declare const Popover: React.ForwardRefExoticComponent<PopoverProps & React.RefAttributes<HTMLElement>> & {
+import { PopoverContentProps, PopoverProps, PopoverRole } from './Popover.types';
+/**
+
+ We use popovers to display more of an item’s information or details on hover.
+ This may be used to show additional fields in an item’s form that aren’t shown
+ by default in the UI. Oftentimes, there will be a visual queue to indicate that
+ more information is available.
+
+ Do not use popovers to display large amounts of information, perform data
+ entry, or use as a replacement for an overflow, menu, or modal.
+
+ If you want to show descriptive / educational information about an item,
+ use a tooltip.
+
+ @since 10.19.0
+
+ @see [Storybook](https://procore.github.io/core/core-react/latest/?path=/story/demos-popover--demo)
+
+ @see [Design Guidelines](https://design.procore.com/popover)
+
+ */
+declare function PopoverInner<Role extends PopoverRole>({ children, initialIsVisible, restoreFocusOnHide, placement, overlay, overlayRef, role, ...props }: PopoverProps<Role>, ref: React.ForwardedRef<HTMLElement>): JSX.Element;
+export declare const Popover: (<Role extends PopoverRole>(props: PopoverProps<Role>) => ReturnType<typeof PopoverInner>) & {
     Content: React.ForwardRefExoticComponent<DivAttributes & PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
 };
+export {};

package/dist/Popover/Popover.js

@@ -50,11 +50,13 @@ var Content = React.forwardRef(function Content(_a, ref) {
  @see [Design Guidelines](https://design.procore.com/popover)
 
  */
-var Popover_ = React.forwardRef(function Popover(_a, ref) {
-    var children = _a.children, _b = _a.initialIsVisible, initialIsVisible = _b === void 0 ? false : _b, _c = _a.placement, placement = _c === void 0 ? 'top' : _c, overlay = _a.overlay, overlayRef = _a.overlayRef, props = __rest(_a, ["children", "initialIsVisible", "placement", "overlay", "overlayRef"]);
+function PopoverInner(_a, ref) {
+    var children = _a.children, _b = _a.initialIsVisible, initialIsVisible = _b === void 0 ? false : _b, _c = _a.restoreFocusOnHide, restoreFocusOnHide = _c === void 0 ? false : _c, _d = _a.placement, placement = _d === void 0 ? 'top' : _d, overlay = _a.overlay, overlayRef = _a.overlayRef, role = _a.role, props = __rest(_a, ["children", "initialIsVisible", "restoreFocusOnHide", "placement", "overlay", "overlayRef", "role"]);
     var overlayNode = isReactElement(overlay) ? (React.cloneElement(overlay, { placement: placement })) : (React.createElement(React.Fragment, null));
-    return (React.createElement(OverlayTrigger, __assign({}, __assign(__assign({}, props), { initialIsVisible: initialIsVisible, overlay: overlayNode, placement: placement, ref: ref, restoreFocusOnHide: false, shrinkOverlay: true, arrow: true, overlayRef: overlayRef })), children));
-});
+    return (React.createElement(OverlayTrigger, __assign({}, __assign(__assign({}, props), { initialIsVisible: initialIsVisible, overlay: overlayNode, placement: placement, role: role, ref: ref, restoreFocusOnHide: restoreFocusOnHide, shrinkOverlay: true, arrow: true, overlayRef: overlayRef })), children));
+}
+var Popover_ = React.forwardRef(PopoverInner);
+// @ts-expect-error
 Popover_.displayName = 'Popover';
 Content.displayName = 'Popover.Content';
 export var Popover = addSubcomponents({ Content: Content }, Popover_);

package/dist/Popover/Popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../src/Popover/Popover.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAGtE,IAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAG9B,SAAS,OAAO,CAChB,EAAwD,EACxD,GAAG;IADD,IAAA,QAAQ,cAAA,EAAE,aAAa,EAAb,KAAK,mBAAG,KAAK,KAAA,EAAE,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EAAK,KAAK,cAAtD,kCAAwD,CAAF;IAGtD,OAAO,CACL,oBAAC,aAAa,IAAC,GAAG,EAAE,GAAG;QACrB,oBAAC,oBAAoB,eAAK,KAAK,cAAU,KAAK,gBAAc,SAAS,KAClE,QAAQ,CACY,CACT,CACjB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,IAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAA4B,SAAS,OAAO,CAC3E,EAOC,EACD,GAAG;IAPD,IAAA,QAAQ,cAAA,EACR,wBAAwB,EAAxB,gBAAgB,mBAAG,KAAK,KAAA,EACxB,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EACjB,OAAO,aAAA,EACP,UAAU,gBAAA,EACP,KAAK,cANV,sEAOC,CADS;IAIV,IAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAC5C,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,SAAS,WAAA,EAAE,CAAC,CAC3C,CAAC,CAAC,CAAC,CACF,oBAAC,KAAK,CAAC,QAAQ,OAAG,CACnB,CAAA;IAED,OAAO,CACL,oBAAC,cAAc,qCAER,KAAK,KACR,gBAAgB,kBAAA,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,WAAA,EACT,GAAG,KAAA,EACH,kBAAkB,EAAE,KAAK,EACzB,aAAa,EAAE,IAAI,EACnB,KAAK,EAAE,IAAI,EACX,UAAU,YAAA,MAGX,QAAQ,CACM,CAClB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAA;AAEhC,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAA;AAEvC,MAAM,CAAC,IAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,OAAO,SAAA,EAAE,EAAE,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"Popover.js","sourceRoot":"","sources":["../../src/Popover/Popover.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAEzD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAGtE,IAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAG9B,SAAS,OAAO,CAChB,EAAwD,EACxD,GAAG;IADD,IAAA,QAAQ,cAAA,EAAE,aAAa,EAAb,KAAK,mBAAG,KAAK,KAAA,EAAE,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EAAK,KAAK,cAAtD,kCAAwD,CAAF;IAGtD,OAAO,CACL,oBAAC,aAAa,IAAC,GAAG,EAAE,GAAG;QACrB,oBAAC,oBAAoB,eAAK,KAAK,cAAU,KAAK,gBAAc,SAAS,KAClE,QAAQ,CACY,CACT,CACjB,CAAA;AACH,CAAC,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,SAAS,YAAY,CACnB,EASqB,EACrB,GAAoC;IATlC,IAAA,QAAQ,cAAA,EACR,wBAAwB,EAAxB,gBAAgB,mBAAG,KAAK,KAAA,EACxB,0BAA0B,EAA1B,kBAAkB,mBAAG,KAAK,KAAA,EAC1B,iBAAiB,EAAjB,SAAS,mBAAG,KAAK,KAAA,EACjB,OAAO,aAAA,EACP,UAAU,gBAAA,EACV,IAAI,UAAA,EACD,KAAK,cARV,oGASC,CADS;IAIV,IAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAC5C,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,SAAS,WAAA,EAAE,CAAC,CAC3C,CAAC,CAAC,CAAC,CACF,oBAAC,KAAK,CAAC,QAAQ,OAAG,CACnB,CAAA;IAED,OAAO,CACL,oBAAC,cAAc,qCAER,KAAK,KACR,gBAAgB,kBAAA,EAChB,OAAO,EAAE,WAAW,EACpB,SAAS,WAAA,EACT,IAAI,MAAA,EACJ,GAAG,KAAA,EACH,kBAAkB,oBAAA,EAClB,aAAa,EAAE,IAAI,EACnB,KAAK,EAAE,IAAI,EACX,UAAU,YAAA,MAGX,QAAQ,CACM,CAClB,CAAA;AACH,CAAC;AAED,IAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,YAAY,CAEV,CAAA;AAEpC,mBAAmB;AACnB,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAA;AAEhC,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAA;AAEvC,MAAM,CAAC,IAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,OAAO,SAAA,EAAE,EAAE,QAAQ,CAAC,CAAA"}

package/dist/Popover/Popover.types.d.ts

@@ -2,7 +2,7 @@
 import { OverlayTriggerRef } from '../OverlayTrigger/OverlayTrigger.types';
 import { TriggerVariant } from '../_hooks/Trigger';
 import { Placement } from '../_utils/placement';
-import { Props } from '../_utils/types';
+import { AriaLabelled, Props } from '../_utils/types';
 export interface PopoverContentProps {
     /**
      * @since 10.19.0
@@ -13,7 +13,8 @@ export interface PopoverContentProps {
      */
     placement?: Placement;
 }
-export interface PopoverProps extends Props {
+export declare type PopoverRole = 'dialog' | undefined;
+export interface PopoverBaseProps<Role extends PopoverRole = undefined> extends Props {
     /**
      * Whether to show the overlay on initial render
      * @defaultValue false
@@ -33,6 +34,13 @@ export interface PopoverProps extends Props {
      * @since 10.19.0
      */
     placement?: Placement;
+    /**
+     * Return focus to trigger after the closing popover modal dialog
+     * @a11y Should be set to true.
+     * @defaultValue false
+     * @since 11.8.0
+     */
+    restoreFocusOnHide?: boolean;
     /**
      * The event to trigger the overlay
      * @defaultValue click
@@ -44,4 +52,9 @@ export interface PopoverProps extends Props {
      * @since 11.2.0
      */
     overlayRef?: React.Ref<OverlayTriggerRef>;
+    /**
+     * @since 11.11.0
+     */
+    role?: Role;
 }
+export declare type PopoverProps<Role extends PopoverRole = undefined> = Role extends 'dialog' ? AriaLabelled<PopoverBaseProps<'dialog'>> : PopoverBaseProps<undefined>;

package/dist/Portal/Portal.d.ts

@@ -5,4 +5,4 @@ import { PortalProps } from './Portal.types';
  * @deprecated Intended for internal library development.
  * @see [Storybook](https://procore.github.io/core/core-react/latest/?path=/story/coverage-portal--defaults)
  */
-export declare function Portal({ children, container, }: PortalProps): React.ReactPortal;
+export declare function Portal({ children, container, ...props }: PortalProps): React.ReactPortal;

package/dist/Portal/Portal.js

@@ -1,3 +1,25 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 import React from 'react';
 import ReactDOM from 'react-dom';
 import { useZIndexContext } from '../_hooks/ZIndex';
@@ -8,8 +30,8 @@ import { StyledPortal } from './Portal.styles';
  * @see [Storybook](https://procore.github.io/core/core-react/latest/?path=/story/coverage-portal--defaults)
  */
 export function Portal(_a) {
-    var children = _a.children, container = _a.container;
+    var children = _a.children, container = _a.container, props = __rest(_a, ["children", "container"]);
     var zIndexCtx = useZIndexContext();
-    return ReactDOM.createPortal(React.createElement(StyledPortal, { style: { zIndex: zIndexCtx.value } }, children), container || document.body);
+    return ReactDOM.createPortal(React.createElement(StyledPortal, __assign({}, props, { style: { zIndex: zIndexCtx.value } }), children), container || document.body);
 }
 //# sourceMappingURL=Portal.js.map

package/dist/Portal/Portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"Portal.js","sourceRoot":"","sources":["../../src/Portal/Portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,EAGT;QAFZ,QAAQ,cAAA,EACR,SAAS,eAAA;IAET,IAAM,SAAS,GAAG,gBAAgB,EAAE,CAAA;IAEpC,OAAO,QAAQ,CAAC,YAAY,CAC1B,oBAAC,YAAY,IAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,IAAG,QAAQ,CAAgB,EAC3E,SAAS,IAAI,QAAQ,CAAC,IAAI,CAC3B,CAAA;AACH,CAAC"}
+{"version":3,"file":"Portal.js","sourceRoot":"","sources":["../../src/Portal/Portal.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,QAAQ,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,EAIT;IAHZ,IAAA,QAAQ,cAAA,EACR,SAAS,eAAA,EACN,KAAK,cAHa,yBAItB,CADS;IAER,IAAM,SAAS,GAAG,gBAAgB,EAAE,CAAA;IAEpC,OAAO,QAAQ,CAAC,YAAY,CAC1B,oBAAC,YAAY,eAAK,KAAK,IAAE,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KACxD,QAAQ,CACI,EACf,SAAS,IAAI,QAAQ,CAAC,IAAI,CAC3B,CAAA;AACH,CAAC"}

package/dist/Section/Section.d.ts

@@ -1,6 +1,10 @@
 import React from 'react';
+import { HeadingProps } from '../Semantic/Semantic.types';
 import { SectionProps, SectionProviderProps } from './Section.types';
 export declare const LevelContext: React.Context<number>;
+export declare function Heading({ level: level_, ...props }: HeadingProps & {
+    level?: number;
+}): JSX.Element;
 export declare const SectionProvider: ({ children }: SectionProviderProps) => JSX.Element;
 /**
  * @deprecatedSince 11