@metamask-previews/design-system-react 0.24.0-preview.a0fe3894 → 0.25.0-preview.1f40f69f

package/dist/components/Popover/Popover.cjs

@@ -0,0 +1,129 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Popover = void 0;
+const react_dom_1 = require("@floating-ui/react-dom");
+const react_1 = __importStar(require("react"));
+const react_dom_2 = require("react-dom");
+const tw_merge_1 = require("../../utils/tw-merge.cjs");
+const Box_1 = require("../Box/index.cjs");
+const Popover_constants_1 = require("./Popover.constants.cjs");
+const Popover_types_1 = require("./Popover.types.cjs");
+const CAPTURE_EVENT_LISTENER_OPTIONS = { capture: true };
+exports.Popover = (0, react_1.forwardRef)(({ children, className, style, position = Popover_types_1.PopoverPosition.Auto, role = Popover_types_1.PopoverRole.Tooltip, hasArrow = false, matchWidth = false, preventOverflow = false, offset: offsetProp = [0, 8], flip: flipEnabled = false, referenceHidden = true, referenceElement, isOpen, isPortal = false, arrowProps, onClickOutside, onPressEscKey, ...props }, ref) => {
+    const arrowRef = (0, react_1.useRef)(null);
+    const popoverRef = (0, react_1.useRef)(null);
+    const isAuto = position === Popover_types_1.PopoverPosition.Auto;
+    const [offsetSkidding, offsetDistance] = offsetProp;
+    const middleware = [
+        (0, react_dom_1.offset)({ mainAxis: offsetDistance, crossAxis: offsetSkidding }),
+    ];
+    if (isAuto) {
+        middleware.push((0, react_dom_1.autoPlacement)());
+    }
+    else if (flipEnabled) {
+        middleware.push((0, react_dom_1.flip)());
+    }
+    if (isAuto || preventOverflow) {
+        middleware.push((0, react_dom_1.shift)());
+    }
+    if (hasArrow) {
+        middleware.push((0, react_dom_1.arrow)({ element: arrowRef }));
+    }
+    middleware.push((0, react_dom_1.hide)());
+    const { refs, floatingStyles, placement, middlewareData } = (0, react_dom_1.useFloating)({
+        open: isOpen,
+        whileElementsMounted: react_dom_1.autoUpdate,
+        placement: isAuto ? 'bottom' : position,
+        elements: { reference: referenceElement ?? null },
+        middleware,
+    });
+    (0, react_1.useEffect)(() => {
+        if (!isOpen || (!onPressEscKey && !onClickOutside)) {
+            return undefined;
+        }
+        const handleEscKey = (event) => {
+            if (event.key === 'Escape') {
+                onPressEscKey?.();
+            }
+        };
+        const handleClickOutside = (event) => {
+            if (popoverRef.current &&
+                !popoverRef.current.contains(event.target) &&
+                !referenceElement?.contains(event.target)) {
+                onClickOutside?.();
+            }
+        };
+        if (onPressEscKey) {
+            document.addEventListener('keydown', handleEscKey, CAPTURE_EVENT_LISTENER_OPTIONS);
+        }
+        if (onClickOutside) {
+            document.addEventListener('click', handleClickOutside, CAPTURE_EVENT_LISTENER_OPTIONS);
+        }
+        return () => {
+            if (onPressEscKey) {
+                document.removeEventListener('keydown', handleEscKey, CAPTURE_EVENT_LISTENER_OPTIONS);
+            }
+            if (onClickOutside) {
+                document.removeEventListener('click', handleClickOutside, CAPTURE_EVENT_LISTENER_OPTIONS);
+            }
+        };
+    }, [onPressEscKey, isOpen, onClickOutside, referenceElement]);
+    if (!isOpen) {
+        return null;
+    }
+    const arrowSide = placement.split('-')[0];
+    const arrowPlacementStyle = Popover_constants_1.POPOVER_ARROW_PLACEMENT_STYLES[arrowSide];
+    const referenceHiddenValue = Boolean(middlewareData.hide?.referenceHidden);
+    const popoverStyle = {
+        ...floatingStyles,
+        width: matchWidth ? referenceElement?.clientWidth : 'auto',
+        ...style,
+    };
+    const setPopoverRef = (element) => {
+        if (typeof ref === 'function') {
+            ref(element);
+        }
+        else if (ref) {
+            ref.current = element;
+        }
+        refs.setFloating(element);
+        popoverRef.current = element;
+    };
+    const popoverContent = (react_1.default.createElement(Box_1.Box, { backgroundColor: Box_1.BoxBackgroundColor.BackgroundDefault, borderColor: Box_1.BoxBorderColor.BorderMuted, borderWidth: 1, padding: 4, role: role, ref: setPopoverRef, "data-popper-placement": placement, "data-popper-reference-hidden": referenceHiddenValue, className: (0, tw_merge_1.twMerge)('rounded-lg shadow-md', referenceHidden &&
+            'data-[popper-reference-hidden=true]:pointer-events-none data-[popper-reference-hidden=true]:invisible', className), ...props, style: popoverStyle },
+        children,
+        hasArrow && (react_1.default.createElement(Box_1.Box, { "data-testid": "popover-arrow", ...arrowProps, ref: arrowRef, className: (0, tw_merge_1.twMerge)('invisible absolute size-10', arrowProps?.className), style: {
+                left: middlewareData.arrow?.x,
+                top: middlewareData.arrow?.y,
+                ...arrowPlacementStyle.container,
+            } },
+            react_1.default.createElement(Box_1.Box, { backgroundColor: Box_1.BoxBackgroundColor.BackgroundDefault, borderColor: Box_1.BoxBorderColor.BorderMuted, borderWidth: 1, "data-testid": "popover-arrow-visual", className: "visible absolute left-1/2 top-1/2 -ml-1 -mt-1 size-2 rounded-tl-sm border-b-transparent border-r-transparent", style: arrowPlacementStyle.visual })))));
+    return isPortal
+        ? (0, react_dom_2.createPortal)(popoverContent, document.body)
+        : popoverContent;
+});
+exports.Popover.displayName = 'Popover';
+//# sourceMappingURL=Popover.cjs.map

package/dist/components/Popover/Popover.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.cjs","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  arrow,\n  autoPlacement,\n  autoUpdate,\n  flip,\n  hide,\n  offset,\n  shift,\n  useFloating,\n} from '@floating-ui/react-dom';\nimport type { Middleware, Placement } from '@floating-ui/react-dom';\nimport React, { forwardRef, useEffect, useRef } from 'react';\nimport { createPortal } from 'react-dom';\n\nimport { twMerge } from '../../utils/tw-merge';\nimport { Box, BoxBackgroundColor, BoxBorderColor } from '../Box';\n\nimport { POPOVER_ARROW_PLACEMENT_STYLES } from './Popover.constants';\nimport { PopoverPosition, PopoverRole } from './Popover.types';\nimport type { PopoverProps } from './Popover.types';\n\ntype ArrowPlacementKey = keyof typeof POPOVER_ARROW_PLACEMENT_STYLES;\n\nconst CAPTURE_EVENT_LISTENER_OPTIONS = { capture: true };\n\nexport const Popover = forwardRef<HTMLDivElement, PopoverProps>(\n  (\n    {\n      children,\n      className,\n      style,\n      position = PopoverPosition.Auto,\n      role = PopoverRole.Tooltip,\n      hasArrow = false,\n      matchWidth = false,\n      preventOverflow = false,\n      offset: offsetProp = [0, 8],\n      flip: flipEnabled = false,\n      referenceHidden = true,\n      referenceElement,\n      isOpen,\n      isPortal = false,\n      arrowProps,\n      onClickOutside,\n      onPressEscKey,\n      ...props\n    },\n    ref,\n  ) => {\n    const arrowRef = useRef<HTMLDivElement | null>(null);\n    const popoverRef = useRef<HTMLDivElement | null>(null);\n\n    const isAuto = position === PopoverPosition.Auto;\n    const [offsetSkidding, offsetDistance] = offsetProp;\n\n    const middleware: Middleware[] = [\n      offset({ mainAxis: offsetDistance, crossAxis: offsetSkidding }),\n    ];\n    if (isAuto) {\n      middleware.push(autoPlacement());\n    } else if (flipEnabled) {\n      middleware.push(flip());\n    }\n    if (isAuto || preventOverflow) {\n      middleware.push(shift());\n    }\n    if (hasArrow) {\n      middleware.push(arrow({ element: arrowRef }));\n    }\n    middleware.push(hide());\n\n    const { refs, floatingStyles, placement, middlewareData } = useFloating({\n      open: isOpen,\n      whileElementsMounted: autoUpdate,\n      placement: isAuto ? 'bottom' : (position as Placement),\n      elements: { reference: referenceElement ?? null },\n      middleware,\n    });\n\n    useEffect(() => {\n      if (!isOpen || (!onPressEscKey && !onClickOutside)) {\n        return undefined;\n      }\n\n      const handleEscKey = (event: KeyboardEvent) => {\n        if (event.key === 'Escape') {\n          onPressEscKey?.();\n        }\n      };\n\n      const handleClickOutside = (event: MouseEvent) => {\n        if (\n          popoverRef.current &&\n          !popoverRef.current.contains(event.target as Node) &&\n          !referenceElement?.contains(event.target as Node)\n        ) {\n          onClickOutside?.();\n        }\n      };\n\n      if (onPressEscKey) {\n        document.addEventListener(\n          'keydown',\n          handleEscKey,\n          CAPTURE_EVENT_LISTENER_OPTIONS,\n        );\n      }\n\n      if (onClickOutside) {\n        document.addEventListener(\n          'click',\n          handleClickOutside,\n          CAPTURE_EVENT_LISTENER_OPTIONS,\n        );\n      }\n\n      return () => {\n        if (onPressEscKey) {\n          document.removeEventListener(\n            'keydown',\n            handleEscKey,\n            CAPTURE_EVENT_LISTENER_OPTIONS,\n          );\n        }\n\n        if (onClickOutside) {\n          document.removeEventListener(\n            'click',\n            handleClickOutside,\n            CAPTURE_EVENT_LISTENER_OPTIONS,\n          );\n        }\n      };\n    }, [onPressEscKey, isOpen, onClickOutside, referenceElement]);\n\n    if (!isOpen) {\n      return null;\n    }\n\n    const arrowSide = placement.split('-')[0] as ArrowPlacementKey;\n    const arrowPlacementStyle = POPOVER_ARROW_PLACEMENT_STYLES[arrowSide];\n    const referenceHiddenValue = Boolean(middlewareData.hide?.referenceHidden);\n\n    const popoverStyle: React.CSSProperties = {\n      ...floatingStyles,\n      width: matchWidth ? referenceElement?.clientWidth : 'auto',\n      ...style,\n    };\n\n    const setPopoverRef = (element: HTMLDivElement | null) => {\n      if (typeof ref === 'function') {\n        ref(element);\n      } else if (ref) {\n        ref.current = element;\n      }\n      refs.setFloating(element);\n      popoverRef.current = element;\n    };\n\n    const popoverContent = (\n      <Box\n        backgroundColor={BoxBackgroundColor.BackgroundDefault}\n        borderColor={BoxBorderColor.BorderMuted}\n        borderWidth={1}\n        padding={4}\n        role={role}\n        ref={setPopoverRef}\n        data-popper-placement={placement}\n        data-popper-reference-hidden={referenceHiddenValue}\n        className={twMerge(\n          'rounded-lg shadow-md',\n          referenceHidden &&\n            'data-[popper-reference-hidden=true]:pointer-events-none data-[popper-reference-hidden=true]:invisible',\n          className,\n        )}\n        {...props}\n        style={popoverStyle}\n      >\n        {children}\n        {hasArrow && (\n          <Box\n            data-testid=\"popover-arrow\"\n            {...arrowProps}\n            ref={arrowRef}\n            className={twMerge(\n              'invisible absolute size-10',\n              arrowProps?.className,\n            )}\n            style={{\n              left: middlewareData.arrow?.x,\n              top: middlewareData.arrow?.y,\n              ...arrowPlacementStyle.container,\n            }}\n          >\n            <Box\n              backgroundColor={BoxBackgroundColor.BackgroundDefault}\n              borderColor={BoxBorderColor.BorderMuted}\n              borderWidth={1}\n              data-testid=\"popover-arrow-visual\"\n              className=\"visible absolute left-1/2 top-1/2 -ml-1 -mt-1 size-2 rounded-tl-sm border-b-transparent border-r-transparent\"\n              style={arrowPlacementStyle.visual}\n            />\n          </Box>\n        )}\n      </Box>\n    );\n\n    return isPortal\n      ? createPortal(popoverContent, document.body)\n      : popoverContent;\n  },\n);\n\nPopover.displayName = 'Popover';\n"]}

package/dist/components/Popover/Popover.constants.cjs

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POPOVER_ARROW_PLACEMENT_STYLES = void 0;
+/**
+ * Per-placement offsets and rotations applied on top of `react-popper`'s
+ * computed arrow position. Keys are the leading segment of
+ * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same
+ * offset/rotation).
+ */
+exports.POPOVER_ARROW_PLACEMENT_STYLES = {
+    top: {
+        container: { bottom: -20 },
+        visual: { transform: 'rotate(-135deg)' },
+    },
+    bottom: {
+        container: { top: -20 },
+        visual: { transform: 'rotate(45deg)' },
+    },
+    left: {
+        container: { right: -20 },
+        visual: { transform: 'rotate(135deg)' },
+    },
+    right: {
+        container: { left: -20 },
+        visual: { transform: 'rotate(-45deg)' },
+    },
+};
+//# sourceMappingURL=Popover.constants.cjs.map

package/dist/components/Popover/Popover.constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.constants.cjs","sourceRoot":"","sources":["../../../src/components/Popover/Popover.constants.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACU,QAAA,8BAA8B,GAGvC;IACF,GAAG,EAAE;QACH,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE;KACzC;IACD,MAAM,EAAE;QACN,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;KACvC;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;KACxC;IACD,KAAK,EAAE;QACL,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;KACxC;CACF,CAAC","sourcesContent":["import type { CSSProperties } from 'react';\n\n/**\n * Per-placement offsets and rotations applied on top of `react-popper`'s\n * computed arrow position. Keys are the leading segment of\n * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same\n * offset/rotation).\n */\nexport const POPOVER_ARROW_PLACEMENT_STYLES: Record<\n  'top' | 'bottom' | 'left' | 'right',\n  { container: CSSProperties; visual: CSSProperties }\n> = {\n  top: {\n    container: { bottom: -20 },\n    visual: { transform: 'rotate(-135deg)' },\n  },\n  bottom: {\n    container: { top: -20 },\n    visual: { transform: 'rotate(45deg)' },\n  },\n  left: {\n    container: { right: -20 },\n    visual: { transform: 'rotate(135deg)' },\n  },\n  right: {\n    container: { left: -20 },\n    visual: { transform: 'rotate(-45deg)' },\n  },\n};\n"]}

package/dist/components/Popover/Popover.constants.d.cts

@@ -0,0 +1,12 @@
+import type { CSSProperties } from "react";
+/**
+ * Per-placement offsets and rotations applied on top of `react-popper`'s
+ * computed arrow position. Keys are the leading segment of
+ * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same
+ * offset/rotation).
+ */
+export declare const POPOVER_ARROW_PLACEMENT_STYLES: Record<'top' | 'bottom' | 'left' | 'right', {
+    container: CSSProperties;
+    visual: CSSProperties;
+}>;
+//# sourceMappingURL=Popover.constants.d.cts.map

package/dist/components/Popover/Popover.constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.constants.d.cts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,EACnC;IAAE,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAkBpD,CAAC"}

package/dist/components/Popover/Popover.constants.d.mts

@@ -0,0 +1,12 @@
+import type { CSSProperties } from "react";
+/**
+ * Per-placement offsets and rotations applied on top of `react-popper`'s
+ * computed arrow position. Keys are the leading segment of
+ * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same
+ * offset/rotation).
+ */
+export declare const POPOVER_ARROW_PLACEMENT_STYLES: Record<'top' | 'bottom' | 'left' | 'right', {
+    container: CSSProperties;
+    visual: CSSProperties;
+}>;
+//# sourceMappingURL=Popover.constants.d.mts.map

package/dist/components/Popover/Popover.constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.constants.d.mts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CACjD,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,EACnC;IAAE,SAAS,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAkBpD,CAAC"}

package/dist/components/Popover/Popover.constants.mjs

@@ -0,0 +1,25 @@
+/**
+ * Per-placement offsets and rotations applied on top of `react-popper`'s
+ * computed arrow position. Keys are the leading segment of
+ * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same
+ * offset/rotation).
+ */
+export const POPOVER_ARROW_PLACEMENT_STYLES = {
+    top: {
+        container: { bottom: -20 },
+        visual: { transform: 'rotate(-135deg)' },
+    },
+    bottom: {
+        container: { top: -20 },
+        visual: { transform: 'rotate(45deg)' },
+    },
+    left: {
+        container: { right: -20 },
+        visual: { transform: 'rotate(135deg)' },
+    },
+    right: {
+        container: { left: -20 },
+        visual: { transform: 'rotate(-45deg)' },
+    },
+};
+//# sourceMappingURL=Popover.constants.mjs.map

package/dist/components/Popover/Popover.constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.constants.mjs","sourceRoot":"","sources":["../../../src/components/Popover/Popover.constants.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAGvC;IACF,GAAG,EAAE;QACH,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE;KACzC;IACD,MAAM,EAAE;QACN,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;KACvC;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;KACxC;IACD,KAAK,EAAE;QACL,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE;KACxC;CACF,CAAC","sourcesContent":["import type { CSSProperties } from 'react';\n\n/**\n * Per-placement offsets and rotations applied on top of `react-popper`'s\n * computed arrow position. Keys are the leading segment of\n * `data-popper-placement` (`'top'`, `'top-start'`, etc. all share the same\n * offset/rotation).\n */\nexport const POPOVER_ARROW_PLACEMENT_STYLES: Record<\n  'top' | 'bottom' | 'left' | 'right',\n  { container: CSSProperties; visual: CSSProperties }\n> = {\n  top: {\n    container: { bottom: -20 },\n    visual: { transform: 'rotate(-135deg)' },\n  },\n  bottom: {\n    container: { top: -20 },\n    visual: { transform: 'rotate(45deg)' },\n  },\n  left: {\n    container: { right: -20 },\n    visual: { transform: 'rotate(135deg)' },\n  },\n  right: {\n    container: { left: -20 },\n    visual: { transform: 'rotate(-45deg)' },\n  },\n};\n"]}

package/dist/components/Popover/Popover.d.cts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { PopoverProps } from "./Popover.types.cjs";
+export declare const Popover: React.ForwardRefExoticComponent<Omit<PopoverProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Popover.d.cts.map

package/dist/components/Popover/Popover.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.cts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAwC,cAAc;AAQ7D,OAAO,KAAK,EAAE,YAAY,EAAE,4BAAwB;AAMpD,eAAO,MAAM,OAAO,kGA0LnB,CAAC"}

package/dist/components/Popover/Popover.d.mts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { PopoverProps } from "./Popover.types.mjs";
+export declare const Popover: React.ForwardRefExoticComponent<Omit<PopoverProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Popover.d.mts.map

package/dist/components/Popover/Popover.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.d.mts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAwC,cAAc;AAQ7D,OAAO,KAAK,EAAE,YAAY,EAAE,4BAAwB;AAMpD,eAAO,MAAM,OAAO,kGA0LnB,CAAC"}

package/dist/components/Popover/Popover.mjs

@@ -0,0 +1,110 @@
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { arrow, autoPlacement, autoUpdate, flip, hide, offset, shift, useFloating } from "@floating-ui/react-dom";
+import $React, { forwardRef, useEffect, useRef } from "react";
+const React = $importDefault($React);
+import { createPortal } from "react-dom";
+import { twMerge } from "../../utils/tw-merge.mjs";
+import { Box, BoxBackgroundColor, BoxBorderColor } from "../Box/index.mjs";
+import { POPOVER_ARROW_PLACEMENT_STYLES } from "./Popover.constants.mjs";
+import { PopoverPosition, PopoverRole } from "./Popover.types.mjs";
+const CAPTURE_EVENT_LISTENER_OPTIONS = { capture: true };
+export const Popover = forwardRef(({ children, className, style, position = PopoverPosition.Auto, role = PopoverRole.Tooltip, hasArrow = false, matchWidth = false, preventOverflow = false, offset: offsetProp = [0, 8], flip: flipEnabled = false, referenceHidden = true, referenceElement, isOpen, isPortal = false, arrowProps, onClickOutside, onPressEscKey, ...props }, ref) => {
+    const arrowRef = useRef(null);
+    const popoverRef = useRef(null);
+    const isAuto = position === PopoverPosition.Auto;
+    const [offsetSkidding, offsetDistance] = offsetProp;
+    const middleware = [
+        offset({ mainAxis: offsetDistance, crossAxis: offsetSkidding }),
+    ];
+    if (isAuto) {
+        middleware.push(autoPlacement());
+    }
+    else if (flipEnabled) {
+        middleware.push(flip());
+    }
+    if (isAuto || preventOverflow) {
+        middleware.push(shift());
+    }
+    if (hasArrow) {
+        middleware.push(arrow({ element: arrowRef }));
+    }
+    middleware.push(hide());
+    const { refs, floatingStyles, placement, middlewareData } = useFloating({
+        open: isOpen,
+        whileElementsMounted: autoUpdate,
+        placement: isAuto ? 'bottom' : position,
+        elements: { reference: referenceElement ?? null },
+        middleware,
+    });
+    useEffect(() => {
+        if (!isOpen || (!onPressEscKey && !onClickOutside)) {
+            return undefined;
+        }
+        const handleEscKey = (event) => {
+            if (event.key === 'Escape') {
+                onPressEscKey?.();
+            }
+        };
+        const handleClickOutside = (event) => {
+            if (popoverRef.current &&
+                !popoverRef.current.contains(event.target) &&
+                !referenceElement?.contains(event.target)) {
+                onClickOutside?.();
+            }
+        };
+        if (onPressEscKey) {
+            document.addEventListener('keydown', handleEscKey, CAPTURE_EVENT_LISTENER_OPTIONS);
+        }
+        if (onClickOutside) {
+            document.addEventListener('click', handleClickOutside, CAPTURE_EVENT_LISTENER_OPTIONS);
+        }
+        return () => {
+            if (onPressEscKey) {
+                document.removeEventListener('keydown', handleEscKey, CAPTURE_EVENT_LISTENER_OPTIONS);
+            }
+            if (onClickOutside) {
+                document.removeEventListener('click', handleClickOutside, CAPTURE_EVENT_LISTENER_OPTIONS);
+            }
+        };
+    }, [onPressEscKey, isOpen, onClickOutside, referenceElement]);
+    if (!isOpen) {
+        return null;
+    }
+    const arrowSide = placement.split('-')[0];
+    const arrowPlacementStyle = POPOVER_ARROW_PLACEMENT_STYLES[arrowSide];
+    const referenceHiddenValue = Boolean(middlewareData.hide?.referenceHidden);
+    const popoverStyle = {
+        ...floatingStyles,
+        width: matchWidth ? referenceElement?.clientWidth : 'auto',
+        ...style,
+    };
+    const setPopoverRef = (element) => {
+        if (typeof ref === 'function') {
+            ref(element);
+        }
+        else if (ref) {
+            ref.current = element;
+        }
+        refs.setFloating(element);
+        popoverRef.current = element;
+    };
+    const popoverContent = (React.createElement(Box, { backgroundColor: BoxBackgroundColor.BackgroundDefault, borderColor: BoxBorderColor.BorderMuted, borderWidth: 1, padding: 4, role: role, ref: setPopoverRef, "data-popper-placement": placement, "data-popper-reference-hidden": referenceHiddenValue, className: twMerge('rounded-lg shadow-md', referenceHidden &&
+            'data-[popper-reference-hidden=true]:pointer-events-none data-[popper-reference-hidden=true]:invisible', className), ...props, style: popoverStyle },
+        children,
+        hasArrow && (React.createElement(Box, { "data-testid": "popover-arrow", ...arrowProps, ref: arrowRef, className: twMerge('invisible absolute size-10', arrowProps?.className), style: {
+                left: middlewareData.arrow?.x,
+                top: middlewareData.arrow?.y,
+                ...arrowPlacementStyle.container,
+            } },
+            React.createElement(Box, { backgroundColor: BoxBackgroundColor.BackgroundDefault, borderColor: BoxBorderColor.BorderMuted, borderWidth: 1, "data-testid": "popover-arrow-visual", className: "visible absolute left-1/2 top-1/2 -ml-1 -mt-1 size-2 rounded-tl-sm border-b-transparent border-r-transparent", style: arrowPlacementStyle.visual })))));
+    return isPortal
+        ? createPortal(popoverContent, document.body)
+        : popoverContent;
+});
+Popover.displayName = 'Popover';
+//# sourceMappingURL=Popover.mjs.map

package/dist/components/Popover/Popover.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.mjs","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  arrow,\n  autoPlacement,\n  autoUpdate,\n  flip,\n  hide,\n  offset,\n  shift,\n  useFloating,\n} from '@floating-ui/react-dom';\nimport type { Middleware, Placement } from '@floating-ui/react-dom';\nimport React, { forwardRef, useEffect, useRef } from 'react';\nimport { createPortal } from 'react-dom';\n\nimport { twMerge } from '../../utils/tw-merge';\nimport { Box, BoxBackgroundColor, BoxBorderColor } from '../Box';\n\nimport { POPOVER_ARROW_PLACEMENT_STYLES } from './Popover.constants';\nimport { PopoverPosition, PopoverRole } from './Popover.types';\nimport type { PopoverProps } from './Popover.types';\n\ntype ArrowPlacementKey = keyof typeof POPOVER_ARROW_PLACEMENT_STYLES;\n\nconst CAPTURE_EVENT_LISTENER_OPTIONS = { capture: true };\n\nexport const Popover = forwardRef<HTMLDivElement, PopoverProps>(\n  (\n    {\n      children,\n      className,\n      style,\n      position = PopoverPosition.Auto,\n      role = PopoverRole.Tooltip,\n      hasArrow = false,\n      matchWidth = false,\n      preventOverflow = false,\n      offset: offsetProp = [0, 8],\n      flip: flipEnabled = false,\n      referenceHidden = true,\n      referenceElement,\n      isOpen,\n      isPortal = false,\n      arrowProps,\n      onClickOutside,\n      onPressEscKey,\n      ...props\n    },\n    ref,\n  ) => {\n    const arrowRef = useRef<HTMLDivElement | null>(null);\n    const popoverRef = useRef<HTMLDivElement | null>(null);\n\n    const isAuto = position === PopoverPosition.Auto;\n    const [offsetSkidding, offsetDistance] = offsetProp;\n\n    const middleware: Middleware[] = [\n      offset({ mainAxis: offsetDistance, crossAxis: offsetSkidding }),\n    ];\n    if (isAuto) {\n      middleware.push(autoPlacement());\n    } else if (flipEnabled) {\n      middleware.push(flip());\n    }\n    if (isAuto || preventOverflow) {\n      middleware.push(shift());\n    }\n    if (hasArrow) {\n      middleware.push(arrow({ element: arrowRef }));\n    }\n    middleware.push(hide());\n\n    const { refs, floatingStyles, placement, middlewareData } = useFloating({\n      open: isOpen,\n      whileElementsMounted: autoUpdate,\n      placement: isAuto ? 'bottom' : (position as Placement),\n      elements: { reference: referenceElement ?? null },\n      middleware,\n    });\n\n    useEffect(() => {\n      if (!isOpen || (!onPressEscKey && !onClickOutside)) {\n        return undefined;\n      }\n\n      const handleEscKey = (event: KeyboardEvent) => {\n        if (event.key === 'Escape') {\n          onPressEscKey?.();\n        }\n      };\n\n      const handleClickOutside = (event: MouseEvent) => {\n        if (\n          popoverRef.current &&\n          !popoverRef.current.contains(event.target as Node) &&\n          !referenceElement?.contains(event.target as Node)\n        ) {\n          onClickOutside?.();\n        }\n      };\n\n      if (onPressEscKey) {\n        document.addEventListener(\n          'keydown',\n          handleEscKey,\n          CAPTURE_EVENT_LISTENER_OPTIONS,\n        );\n      }\n\n      if (onClickOutside) {\n        document.addEventListener(\n          'click',\n          handleClickOutside,\n          CAPTURE_EVENT_LISTENER_OPTIONS,\n        );\n      }\n\n      return () => {\n        if (onPressEscKey) {\n          document.removeEventListener(\n            'keydown',\n            handleEscKey,\n            CAPTURE_EVENT_LISTENER_OPTIONS,\n          );\n        }\n\n        if (onClickOutside) {\n          document.removeEventListener(\n            'click',\n            handleClickOutside,\n            CAPTURE_EVENT_LISTENER_OPTIONS,\n          );\n        }\n      };\n    }, [onPressEscKey, isOpen, onClickOutside, referenceElement]);\n\n    if (!isOpen) {\n      return null;\n    }\n\n    const arrowSide = placement.split('-')[0] as ArrowPlacementKey;\n    const arrowPlacementStyle = POPOVER_ARROW_PLACEMENT_STYLES[arrowSide];\n    const referenceHiddenValue = Boolean(middlewareData.hide?.referenceHidden);\n\n    const popoverStyle: React.CSSProperties = {\n      ...floatingStyles,\n      width: matchWidth ? referenceElement?.clientWidth : 'auto',\n      ...style,\n    };\n\n    const setPopoverRef = (element: HTMLDivElement | null) => {\n      if (typeof ref === 'function') {\n        ref(element);\n      } else if (ref) {\n        ref.current = element;\n      }\n      refs.setFloating(element);\n      popoverRef.current = element;\n    };\n\n    const popoverContent = (\n      <Box\n        backgroundColor={BoxBackgroundColor.BackgroundDefault}\n        borderColor={BoxBorderColor.BorderMuted}\n        borderWidth={1}\n        padding={4}\n        role={role}\n        ref={setPopoverRef}\n        data-popper-placement={placement}\n        data-popper-reference-hidden={referenceHiddenValue}\n        className={twMerge(\n          'rounded-lg shadow-md',\n          referenceHidden &&\n            'data-[popper-reference-hidden=true]:pointer-events-none data-[popper-reference-hidden=true]:invisible',\n          className,\n        )}\n        {...props}\n        style={popoverStyle}\n      >\n        {children}\n        {hasArrow && (\n          <Box\n            data-testid=\"popover-arrow\"\n            {...arrowProps}\n            ref={arrowRef}\n            className={twMerge(\n              'invisible absolute size-10',\n              arrowProps?.className,\n            )}\n            style={{\n              left: middlewareData.arrow?.x,\n              top: middlewareData.arrow?.y,\n              ...arrowPlacementStyle.container,\n            }}\n          >\n            <Box\n              backgroundColor={BoxBackgroundColor.BackgroundDefault}\n              borderColor={BoxBorderColor.BorderMuted}\n              borderWidth={1}\n              data-testid=\"popover-arrow-visual\"\n              className=\"visible absolute left-1/2 top-1/2 -ml-1 -mt-1 size-2 rounded-tl-sm border-b-transparent border-r-transparent\"\n              style={arrowPlacementStyle.visual}\n            />\n          </Box>\n        )}\n      </Box>\n    );\n\n    return isPortal\n      ? createPortal(popoverContent, document.body)\n      : popoverContent;\n  },\n);\n\nPopover.displayName = 'Popover';\n"]}

package/dist/components/Popover/Popover.types.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PopoverRole = exports.PopoverPosition = void 0;
+/**
+ * Popover - placement of the floating element relative to the reference element.
+ * Mirrors the placements supported by `react-popper` (`Auto` enables both
+ * `flip` and `preventOverflow` automatically).
+ */
+exports.PopoverPosition = {
+    Auto: 'auto',
+    Top: 'top',
+    TopStart: 'top-start',
+    TopEnd: 'top-end',
+    Right: 'right',
+    RightStart: 'right-start',
+    RightEnd: 'right-end',
+    Bottom: 'bottom',
+    BottomStart: 'bottom-start',
+    BottomEnd: 'bottom-end',
+    Left: 'left',
+    LeftStart: 'left-start',
+    LeftEnd: 'left-end',
+};
+/**
+ * Popover - ARIA role for the floating element.
+ * Use `Dialog` when the contents are interactive, `Tooltip` for purely
+ * informational content.
+ */
+exports.PopoverRole = {
+    Tooltip: 'tooltip',
+    Dialog: 'dialog',
+};
+//# sourceMappingURL=Popover.types.cjs.map

package/dist/components/Popover/Popover.types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.types.cjs","sourceRoot":"","sources":["../../../src/components/Popover/Popover.types.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,YAAY;IACvB,OAAO,EAAE,UAAU;CACX,CAAC;AAIX;;;;GAIG;AACU,QAAA,WAAW,GAAG;IACzB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC","sourcesContent":["import type { ComponentProps, CSSProperties, ReactNode } from 'react';\n\n/**\n * Popover - placement of the floating element relative to the reference element.\n * Mirrors the placements supported by `react-popper` (`Auto` enables both\n * `flip` and `preventOverflow` automatically).\n */\nexport const PopoverPosition = {\n  Auto: 'auto',\n  Top: 'top',\n  TopStart: 'top-start',\n  TopEnd: 'top-end',\n  Right: 'right',\n  RightStart: 'right-start',\n  RightEnd: 'right-end',\n  Bottom: 'bottom',\n  BottomStart: 'bottom-start',\n  BottomEnd: 'bottom-end',\n  Left: 'left',\n  LeftStart: 'left-start',\n  LeftEnd: 'left-end',\n} as const;\nexport type PopoverPosition =\n  (typeof PopoverPosition)[keyof typeof PopoverPosition];\n\n/**\n * Popover - ARIA role for the floating element.\n * Use `Dialog` when the contents are interactive, `Tooltip` for purely\n * informational content.\n */\nexport const PopoverRole = {\n  Tooltip: 'tooltip',\n  Dialog: 'dialog',\n} as const;\nexport type PopoverRole = (typeof PopoverRole)[keyof typeof PopoverRole];\n\nexport type PopoverProps = Omit<ComponentProps<'div'>, 'role'> & {\n  /**\n   * The contents of the Popover.\n   */\n  children?: ReactNode;\n  /**\n   * Additional class names to merge onto the Popover root.\n   */\n  className?: string;\n  /**\n   * Inline styles applied to the Popover root. Merged after the styles\n   * computed by `react-popper`.\n   */\n  style?: CSSProperties;\n  /**\n   * Placement relative to `referenceElement`. When `PopoverPosition.Auto`,\n   * `flip` and `preventOverflow` are forced on regardless of their props.\n   *\n   * @default PopoverPosition.Auto\n   */\n  position?: PopoverPosition;\n  /**\n   * ARIA role applied to the Popover root.\n   *\n   * @default PopoverRole.Tooltip\n   */\n  role?: PopoverRole;\n  /**\n   * Render an arrow pointing at the reference element.\n   *\n   * @default false\n   */\n  hasArrow?: boolean;\n  /**\n   * Props forwarded to the arrow element. `ref`, `style`, and `children` are\n   * reserved for internal use (popper positioning, rotation styles, and the\n   * arrow visual) and cannot be overridden.\n   */\n  arrowProps?: Omit<ComponentProps<'div'>, 'ref' | 'style' | 'children'>;\n  /**\n   * Match the popover width to the reference element's `clientWidth`.\n   *\n   * @default false\n   */\n  matchWidth?: boolean;\n  /**\n   * Keep the Popover within the viewport. Forced on when\n   * `position === PopoverPosition.Auto`.\n   *\n   * @default false\n   */\n  preventOverflow?: boolean;\n  /**\n   * Allow flipping to the opposite side when there is not enough space.\n   * Forced on when `position === PopoverPosition.Auto`.\n   *\n   * @default false\n   */\n  flip?: boolean;\n  /**\n   * Hide the Popover when the reference element is scrolled out of view.\n   *\n   * @default true\n   */\n  referenceHidden?: boolean;\n  /**\n   * The element the Popover is positioned against.\n   */\n  referenceElement?: HTMLElement | null;\n  /**\n   * Whether the Popover is open. Nothing is rendered when `false`.\n   */\n  isOpen?: boolean;\n  /**\n   * `[skidding, distance]` offset (in px) applied to the Popover.\n   *\n   * @default [0, 8]\n   */\n  offset?: [number, number];\n  /**\n   * Render the Popover into `document.body` via `createPortal`.\n   *\n   * @default false\n   */\n  isPortal?: boolean;\n  /**\n   * Called when the user presses the Escape key while the Popover is open.\n   */\n  onPressEscKey?: () => void;\n  /**\n   * Called when the user clicks outside the Popover and the reference element\n   * while the Popover is open.\n   */\n  onClickOutside?: () => void;\n};\n"]}

package/dist/components/Popover/Popover.types.d.cts

@@ -0,0 +1,128 @@
+import type { ComponentProps, CSSProperties, ReactNode } from "react";
+/**
+ * Popover - placement of the floating element relative to the reference element.
+ * Mirrors the placements supported by `react-popper` (`Auto` enables both
+ * `flip` and `preventOverflow` automatically).
+ */
+export declare const PopoverPosition: {
+    readonly Auto: "auto";
+    readonly Top: "top";
+    readonly TopStart: "top-start";
+    readonly TopEnd: "top-end";
+    readonly Right: "right";
+    readonly RightStart: "right-start";
+    readonly RightEnd: "right-end";
+    readonly Bottom: "bottom";
+    readonly BottomStart: "bottom-start";
+    readonly BottomEnd: "bottom-end";
+    readonly Left: "left";
+    readonly LeftStart: "left-start";
+    readonly LeftEnd: "left-end";
+};
+export type PopoverPosition = (typeof PopoverPosition)[keyof typeof PopoverPosition];
+/**
+ * Popover - ARIA role for the floating element.
+ * Use `Dialog` when the contents are interactive, `Tooltip` for purely
+ * informational content.
+ */
+export declare const PopoverRole: {
+    readonly Tooltip: "tooltip";
+    readonly Dialog: "dialog";
+};
+export type PopoverRole = (typeof PopoverRole)[keyof typeof PopoverRole];
+export type PopoverProps = Omit<ComponentProps<'div'>, 'role'> & {
+    /**
+     * The contents of the Popover.
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names to merge onto the Popover root.
+     */
+    className?: string;
+    /**
+     * Inline styles applied to the Popover root. Merged after the styles
+     * computed by `react-popper`.
+     */
+    style?: CSSProperties;
+    /**
+     * Placement relative to `referenceElement`. When `PopoverPosition.Auto`,
+     * `flip` and `preventOverflow` are forced on regardless of their props.
+     *
+     * @default PopoverPosition.Auto
+     */
+    position?: PopoverPosition;
+    /**
+     * ARIA role applied to the Popover root.
+     *
+     * @default PopoverRole.Tooltip
+     */
+    role?: PopoverRole;
+    /**
+     * Render an arrow pointing at the reference element.
+     *
+     * @default false
+     */
+    hasArrow?: boolean;
+    /**
+     * Props forwarded to the arrow element. `ref`, `style`, and `children` are
+     * reserved for internal use (popper positioning, rotation styles, and the
+     * arrow visual) and cannot be overridden.
+     */
+    arrowProps?: Omit<ComponentProps<'div'>, 'ref' | 'style' | 'children'>;
+    /**
+     * Match the popover width to the reference element's `clientWidth`.
+     *
+     * @default false
+     */
+    matchWidth?: boolean;
+    /**
+     * Keep the Popover within the viewport. Forced on when
+     * `position === PopoverPosition.Auto`.
+     *
+     * @default false
+     */
+    preventOverflow?: boolean;
+    /**
+     * Allow flipping to the opposite side when there is not enough space.
+     * Forced on when `position === PopoverPosition.Auto`.
+     *
+     * @default false
+     */
+    flip?: boolean;
+    /**
+     * Hide the Popover when the reference element is scrolled out of view.
+     *
+     * @default true
+     */
+    referenceHidden?: boolean;
+    /**
+     * The element the Popover is positioned against.
+     */
+    referenceElement?: HTMLElement | null;
+    /**
+     * Whether the Popover is open. Nothing is rendered when `false`.
+     */
+    isOpen?: boolean;
+    /**
+     * `[skidding, distance]` offset (in px) applied to the Popover.
+     *
+     * @default [0, 8]
+     */
+    offset?: [number, number];
+    /**
+     * Render the Popover into `document.body` via `createPortal`.
+     *
+     * @default false
+     */
+    isPortal?: boolean;
+    /**
+     * Called when the user presses the Escape key while the Popover is open.
+     */
+    onPressEscKey?: () => void;
+    /**
+     * Called when the user clicks outside the Popover and the reference element
+     * while the Popover is open.
+     */
+    onClickOutside?: () => void;
+};
+//# sourceMappingURL=Popover.types.d.cts.map

package/dist/components/Popover/Popover.types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Popover.types.d.cts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc;AAEtE;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;CAclB,CAAC;AACX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;CAGd,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG;IAC/D;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IACvE;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC"}