@metamask-previews/design-system-react 0.22.0-preview.178e60f → 0.23.1-preview.620b9f3

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.d.mts","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAqB,cAAc;AAS1C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CA8EvB,CAAC"}

package/dist/components/ModalHeader/ModalHeader.mjs

@@ -0,0 +1,36 @@
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { ButtonIconSize, IconName, TextVariant } from "@metamask-previews/design-system-shared";
+import $React, { forwardRef } from "react";
+const React = $importDefault($React);
+import { twMerge } from "../../utils/tw-merge.mjs";
+import { Box } from "../Box/index.mjs";
+import { ButtonIcon } from "../ButtonIcon/index.mjs";
+import { Text, TextAlign } from "../Text/index.mjs";
+export const ModalHeader = forwardRef((props, ref) => {
+    const { children, className, startAccessory, endAccessory, onBack, backButtonProps, onClose, closeButtonProps, ...rest } = props;
+    // The discriminated union on `ModalHeaderProps` guarantees that whenever
+    // `onBack` is set, `backButtonProps` is also set (with a required
+    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks
+    // below give TypeScript a narrowing point and double as runtime guards.
+    const resolvedStartAccessory = startAccessory ??
+        (onBack && backButtonProps ? (React.createElement(ButtonIcon, { iconName: IconName.ArrowLeft, size: ButtonIconSize.Md, onClick: onBack, ...backButtonProps })) : null);
+    const resolvedEndAccessory = endAccessory ??
+        (onClose && closeButtonProps ? (React.createElement(ButtonIcon, { iconName: IconName.Close, size: ButtonIconSize.Md, onClick: onClose, ...closeButtonProps })) : null);
+    const titleContent = typeof children === 'string' ? (React.createElement(Text, { variant: TextVariant.HeadingSm, textAlign: TextAlign.Center }, children)) : (children);
+    return (React.createElement("header", { ref: ref, className: twMerge(
+        // Three-column grid keeps the title visually centered regardless of
+        // which side accessories are present — same layout primitive as
+        // `HeaderBase`, replicated here so the outer element is the
+        // semantic `<header>` (no extra wrapper div).
+        'grid grid-cols-[1fr_auto_1fr] items-center px-4 pb-4', className), ...rest },
+        resolvedStartAccessory && (React.createElement(Box, { className: "col-start-1 justify-self-start" }, resolvedStartAccessory)),
+        titleContent !== undefined && titleContent !== null && (React.createElement(Box, { className: "col-start-2 col-end-3 w-full" }, titleContent)),
+        resolvedEndAccessory && (React.createElement(Box, { className: "col-start-3 justify-self-end" }, resolvedEndAccessory))));
+});
+ModalHeader.displayName = 'ModalHeader';
+//# sourceMappingURL=ModalHeader.mjs.map

package/dist/components/ModalHeader/ModalHeader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.mjs","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.tsx"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACL,cAAc,EACd,QAAQ,EACR,WAAW,EACZ,gDAAgD;AACjD,OAAO,QAAO,EAAE,UAAU,EAAE,cAAc;;AAE1C,OAAO,EAAE,OAAO,EAAE,iCAA6B;AAC/C,OAAO,EAAE,GAAG,EAAE,yBAAe;AAC7B,OAAO,EAAE,UAAU,EAAE,gCAAsB;AAC3C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,0BAAgB;AAI1C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CACnC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACb,MAAM,EACJ,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,MAAM,EACN,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,yEAAyE;IACzE,kEAAkE;IAClE,yEAAyE;IACzE,wEAAwE;IACxE,MAAM,sBAAsB,GAC1B,cAAc;QACd,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAC3B,oBAAC,UAAU,IACT,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAC5B,IAAI,EAAE,cAAc,CAAC,EAAE,EACvB,OAAO,EAAE,MAAM,KACX,eAAe,GACnB,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,oBAAoB,GACxB,YAAY;QACZ,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAC7B,oBAAC,UAAU,IACT,QAAQ,EAAE,QAAQ,CAAC,KAAK,EACxB,IAAI,EAAE,cAAc,CAAC,EAAE,EACvB,OAAO,EAAE,OAAO,KACZ,gBAAgB,GACpB,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,YAAY,GAChB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC7B,oBAAC,IAAI,IAAC,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,IAC9D,QAAQ,CACJ,CACR,CAAC,CAAC,CAAC,CACF,QAAQ,CACT,CAAC;IAEJ,OAAO,CACL,gCACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,OAAO;QAChB,oEAAoE;QACpE,gEAAgE;QAChE,4DAA4D;QAC5D,8CAA8C;QAC9C,sDAAsD,EACtD,SAAS,CACV,KACG,IAAI;QAEP,sBAAsB,IAAI,CACzB,oBAAC,GAAG,IAAC,SAAS,EAAC,gCAAgC,IAC5C,sBAAsB,CACnB,CACP;QACA,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,CACtD,oBAAC,GAAG,IAAC,SAAS,EAAC,8BAA8B,IAAE,YAAY,CAAO,CACnE;QACA,oBAAoB,IAAI,CACvB,oBAAC,GAAG,IAAC,SAAS,EAAC,8BAA8B,IAC1C,oBAAoB,CACjB,CACP,CACM,CACV,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC","sourcesContent":["import {\n  ButtonIconSize,\n  IconName,\n  TextVariant,\n} from '@metamask-previews/design-system-shared';\nimport React, { forwardRef } from 'react';\n\nimport { twMerge } from '../../utils/tw-merge';\nimport { Box } from '../Box';\nimport { ButtonIcon } from '../ButtonIcon';\nimport { Text, TextAlign } from '../Text';\n\nimport type { ModalHeaderProps } from './ModalHeader.types';\n\nexport const ModalHeader = forwardRef<HTMLElement, ModalHeaderProps>(\n  (props, ref) => {\n    const {\n      children,\n      className,\n      startAccessory,\n      endAccessory,\n      onBack,\n      backButtonProps,\n      onClose,\n      closeButtonProps,\n      ...rest\n    } = props;\n\n    // The discriminated union on `ModalHeaderProps` guarantees that whenever\n    // `onBack` is set, `backButtonProps` is also set (with a required\n    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks\n    // below give TypeScript a narrowing point and double as runtime guards.\n    const resolvedStartAccessory =\n      startAccessory ??\n      (onBack && backButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.ArrowLeft}\n          size={ButtonIconSize.Md}\n          onClick={onBack}\n          {...backButtonProps}\n        />\n      ) : null);\n\n    const resolvedEndAccessory =\n      endAccessory ??\n      (onClose && closeButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.Close}\n          size={ButtonIconSize.Md}\n          onClick={onClose}\n          {...closeButtonProps}\n        />\n      ) : null);\n\n    const titleContent =\n      typeof children === 'string' ? (\n        <Text variant={TextVariant.HeadingSm} textAlign={TextAlign.Center}>\n          {children}\n        </Text>\n      ) : (\n        children\n      );\n\n    return (\n      <header\n        ref={ref}\n        className={twMerge(\n          // Three-column grid keeps the title visually centered regardless of\n          // which side accessories are present — same layout primitive as\n          // `HeaderBase`, replicated here so the outer element is the\n          // semantic `<header>` (no extra wrapper div).\n          'grid grid-cols-[1fr_auto_1fr] items-center px-4 pb-4',\n          className,\n        )}\n        {...rest}\n      >\n        {resolvedStartAccessory && (\n          <Box className=\"col-start-1 justify-self-start\">\n            {resolvedStartAccessory}\n          </Box>\n        )}\n        {titleContent !== undefined && titleContent !== null && (\n          <Box className=\"col-start-2 col-end-3 w-full\">{titleContent}</Box>\n        )}\n        {resolvedEndAccessory && (\n          <Box className=\"col-start-3 justify-self-end\">\n            {resolvedEndAccessory}\n          </Box>\n        )}\n      </header>\n    );\n  },\n);\n\nModalHeader.displayName = 'ModalHeader';\n"]}

package/dist/components/ModalHeader/ModalHeader.types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ModalHeader.types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.types.cjs","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ComponentProps, ReactNode } from 'react';\n\nimport type { ButtonIconProps } from '../ButtonIcon';\n\n/**\n * Props accepted by the auto-rendered back / close `ButtonIcon`. The\n * component owns `iconName` (ArrowLeft / Close) and `size`\n * (ButtonIconSize.Md), so consumers cannot override them. The `data-*` index\n * signature lets test ids and other dataset attributes pass through\n * `Partial`/`Omit` indirection.\n *\n * `ariaLabel` is preserved as **required** (it is required on\n * `ButtonIconProps`). The component does not pull from any i18n context, so\n * consumers must pass a localized label explicitly:\n *\n * ```tsx\n * closeButtonProps={{ ariaLabel: t('close') }}\n * ```\n */\ntype ModalHeaderButtonProps = Omit<\n  ButtonIconProps,\n  'iconName' | 'size' | 'onClick'\n> & {\n  [key: `data-${string}`]: string | undefined;\n};\n\n/**\n * Discriminated pair: `onBack` and `backButtonProps` are co-required. If\n * `onBack` is set, the consumer must also provide `backButtonProps` with a\n * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at\n * compile time without an internal English default.\n */\ntype ModalHeaderBackProps =\n  | { onBack?: undefined; backButtonProps?: undefined }\n  | { onBack: () => void; backButtonProps: ModalHeaderButtonProps };\n\n/**\n * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same\n * shape and rationale as `ModalHeaderBackProps`.\n */\ntype ModalHeaderCloseProps =\n  | { onClose?: undefined; closeButtonProps?: undefined }\n  | { onClose: () => void; closeButtonProps: ModalHeaderButtonProps };\n\nexport type ModalHeaderProps = Omit<ComponentProps<'header'>, 'children'> &\n  ModalHeaderBackProps &\n  ModalHeaderCloseProps & {\n    /**\n     * Header title content. When a string, it is auto-wrapped in a\n     * `Text` with `TextVariant.HeadingSm` and `TextAlign.Center`. When a\n     * `ReactNode`, it is rendered as-is.\n     */\n    children?: ReactNode;\n    /**\n     * Optional override for the start (left in LTR) slot. When provided, it\n     * replaces the auto-rendered back button — even if `onBack` is set.\n     */\n    startAccessory?: ReactNode;\n    /**\n     * Optional override for the end (right in LTR) slot. When provided, it\n     * replaces the auto-rendered close button — even if `onClose` is set.\n     */\n    endAccessory?: ReactNode;\n    /**\n     * Optional prop for additional CSS classes to be applied to the\n     * ModalHeader root. Merged with the component's defaults via `twMerge`.\n     */\n    className?: string;\n  };\n"]}

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

@@ -0,0 +1,69 @@
+import type { ComponentProps, ReactNode } from "react";
+import type { ButtonIconProps } from "../ButtonIcon/index.cjs";
+/**
+ * Props accepted by the auto-rendered back / close `ButtonIcon`. The
+ * component owns `iconName` (ArrowLeft / Close) and `size`
+ * (ButtonIconSize.Md), so consumers cannot override them. The `data-*` index
+ * signature lets test ids and other dataset attributes pass through
+ * `Partial`/`Omit` indirection.
+ *
+ * `ariaLabel` is preserved as **required** (it is required on
+ * `ButtonIconProps`). The component does not pull from any i18n context, so
+ * consumers must pass a localized label explicitly:
+ *
+ * ```tsx
+ * closeButtonProps={{ ariaLabel: t('close') }}
+ * ```
+ */
+type ModalHeaderButtonProps = Omit<ButtonIconProps, 'iconName' | 'size' | 'onClick'> & {
+    [key: `data-${string}`]: string | undefined;
+};
+/**
+ * Discriminated pair: `onBack` and `backButtonProps` are co-required. If
+ * `onBack` is set, the consumer must also provide `backButtonProps` with a
+ * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at
+ * compile time without an internal English default.
+ */
+type ModalHeaderBackProps = {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} | {
+    onBack: () => void;
+    backButtonProps: ModalHeaderButtonProps;
+};
+/**
+ * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same
+ * shape and rationale as `ModalHeaderBackProps`.
+ */
+type ModalHeaderCloseProps = {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} | {
+    onClose: () => void;
+    closeButtonProps: ModalHeaderButtonProps;
+};
+export type ModalHeaderProps = Omit<ComponentProps<'header'>, 'children'> & ModalHeaderBackProps & ModalHeaderCloseProps & {
+    /**
+     * Header title content. When a string, it is auto-wrapped in a
+     * `Text` with `TextVariant.HeadingSm` and `TextAlign.Center`. When a
+     * `ReactNode`, it is rendered as-is.
+     */
+    children?: ReactNode;
+    /**
+     * Optional override for the start (left in LTR) slot. When provided, it
+     * replaces the auto-rendered back button — even if `onBack` is set.
+     */
+    startAccessory?: ReactNode;
+    /**
+     * Optional override for the end (right in LTR) slot. When provided, it
+     * replaces the auto-rendered close button — even if `onClose` is set.
+     */
+    endAccessory?: ReactNode;
+    /**
+     * Optional prop for additional CSS classes to be applied to the
+     * ModalHeader root. Merged with the component's defaults via `twMerge`.
+     */
+    className?: string;
+};
+export {};
+//# sourceMappingURL=ModalHeader.types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.types.d.cts","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAsB;AAErD;;;;;;;;;;;;;;GAcG;AACH,KAAK,sBAAsB,GAAG,IAAI,CAChC,eAAe,EACf,UAAU,GAAG,MAAM,GAAG,SAAS,CAChC,GAAG;IACF,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,KAAK,oBAAoB,GACrB;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,eAAe,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,KAAK,qBAAqB,GACtB;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,gBAAgB,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GACvE,oBAAoB,GACpB,qBAAqB,GAAG;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/components/ModalHeader/ModalHeader.types.d.mts

@@ -0,0 +1,69 @@
+import type { ComponentProps, ReactNode } from "react";
+import type { ButtonIconProps } from "../ButtonIcon/index.mjs";
+/**
+ * Props accepted by the auto-rendered back / close `ButtonIcon`. The
+ * component owns `iconName` (ArrowLeft / Close) and `size`
+ * (ButtonIconSize.Md), so consumers cannot override them. The `data-*` index
+ * signature lets test ids and other dataset attributes pass through
+ * `Partial`/`Omit` indirection.
+ *
+ * `ariaLabel` is preserved as **required** (it is required on
+ * `ButtonIconProps`). The component does not pull from any i18n context, so
+ * consumers must pass a localized label explicitly:
+ *
+ * ```tsx
+ * closeButtonProps={{ ariaLabel: t('close') }}
+ * ```
+ */
+type ModalHeaderButtonProps = Omit<ButtonIconProps, 'iconName' | 'size' | 'onClick'> & {
+    [key: `data-${string}`]: string | undefined;
+};
+/**
+ * Discriminated pair: `onBack` and `backButtonProps` are co-required. If
+ * `onBack` is set, the consumer must also provide `backButtonProps` with a
+ * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at
+ * compile time without an internal English default.
+ */
+type ModalHeaderBackProps = {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} | {
+    onBack: () => void;
+    backButtonProps: ModalHeaderButtonProps;
+};
+/**
+ * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same
+ * shape and rationale as `ModalHeaderBackProps`.
+ */
+type ModalHeaderCloseProps = {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} | {
+    onClose: () => void;
+    closeButtonProps: ModalHeaderButtonProps;
+};
+export type ModalHeaderProps = Omit<ComponentProps<'header'>, 'children'> & ModalHeaderBackProps & ModalHeaderCloseProps & {
+    /**
+     * Header title content. When a string, it is auto-wrapped in a
+     * `Text` with `TextVariant.HeadingSm` and `TextAlign.Center`. When a
+     * `ReactNode`, it is rendered as-is.
+     */
+    children?: ReactNode;
+    /**
+     * Optional override for the start (left in LTR) slot. When provided, it
+     * replaces the auto-rendered back button — even if `onBack` is set.
+     */
+    startAccessory?: ReactNode;
+    /**
+     * Optional override for the end (right in LTR) slot. When provided, it
+     * replaces the auto-rendered close button — even if `onClose` is set.
+     */
+    endAccessory?: ReactNode;
+    /**
+     * Optional prop for additional CSS classes to be applied to the
+     * ModalHeader root. Merged with the component's defaults via `twMerge`.
+     */
+    className?: string;
+};
+export {};
+//# sourceMappingURL=ModalHeader.types.d.mts.map

package/dist/components/ModalHeader/ModalHeader.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.types.d.mts","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAsB;AAErD;;;;;;;;;;;;;;GAcG;AACH,KAAK,sBAAsB,GAAG,IAAI,CAChC,eAAe,EACf,UAAU,GAAG,MAAM,GAAG,SAAS,CAChC,GAAG;IACF,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,KAAK,oBAAoB,GACrB;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,eAAe,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,KAAK,qBAAqB,GACtB;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,gBAAgB,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GACvE,oBAAoB,GACpB,qBAAqB,GAAG;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/components/ModalHeader/ModalHeader.types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ModalHeader.types.mjs.map

package/dist/components/ModalHeader/ModalHeader.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalHeader.types.mjs","sourceRoot":"","sources":["../../../src/components/ModalHeader/ModalHeader.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ComponentProps, ReactNode } from 'react';\n\nimport type { ButtonIconProps } from '../ButtonIcon';\n\n/**\n * Props accepted by the auto-rendered back / close `ButtonIcon`. The\n * component owns `iconName` (ArrowLeft / Close) and `size`\n * (ButtonIconSize.Md), so consumers cannot override them. The `data-*` index\n * signature lets test ids and other dataset attributes pass through\n * `Partial`/`Omit` indirection.\n *\n * `ariaLabel` is preserved as **required** (it is required on\n * `ButtonIconProps`). The component does not pull from any i18n context, so\n * consumers must pass a localized label explicitly:\n *\n * ```tsx\n * closeButtonProps={{ ariaLabel: t('close') }}\n * ```\n */\ntype ModalHeaderButtonProps = Omit<\n  ButtonIconProps,\n  'iconName' | 'size' | 'onClick'\n> & {\n  [key: `data-${string}`]: string | undefined;\n};\n\n/**\n * Discriminated pair: `onBack` and `backButtonProps` are co-required. If\n * `onBack` is set, the consumer must also provide `backButtonProps` with a\n * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at\n * compile time without an internal English default.\n */\ntype ModalHeaderBackProps =\n  | { onBack?: undefined; backButtonProps?: undefined }\n  | { onBack: () => void; backButtonProps: ModalHeaderButtonProps };\n\n/**\n * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same\n * shape and rationale as `ModalHeaderBackProps`.\n */\ntype ModalHeaderCloseProps =\n  | { onClose?: undefined; closeButtonProps?: undefined }\n  | { onClose: () => void; closeButtonProps: ModalHeaderButtonProps };\n\nexport type ModalHeaderProps = Omit<ComponentProps<'header'>, 'children'> &\n  ModalHeaderBackProps &\n  ModalHeaderCloseProps & {\n    /**\n     * Header title content. When a string, it is auto-wrapped in a\n     * `Text` with `TextVariant.HeadingSm` and `TextAlign.Center`. When a\n     * `ReactNode`, it is rendered as-is.\n     */\n    children?: ReactNode;\n    /**\n     * Optional override for the start (left in LTR) slot. When provided, it\n     * replaces the auto-rendered back button — even if `onBack` is set.\n     */\n    startAccessory?: ReactNode;\n    /**\n     * Optional override for the end (right in LTR) slot. When provided, it\n     * replaces the auto-rendered close button — even if `onClose` is set.\n     */\n    endAccessory?: ReactNode;\n    /**\n     * Optional prop for additional CSS classes to be applied to the\n     * ModalHeader root. Merged with the component's defaults via `twMerge`.\n     */\n    className?: string;\n  };\n"]}

package/dist/components/ModalHeader/index.cjs

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModalHeader = void 0;
+var ModalHeader_1 = require("./ModalHeader.cjs");
+Object.defineProperty(exports, "ModalHeader", { enumerable: true, get: function () { return ModalHeader_1.ModalHeader; } });
+//# sourceMappingURL=index.cjs.map

package/dist/components/ModalHeader/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/components/ModalHeader/index.ts"],"names":[],"mappings":";;;AAAA,iDAA4C;AAAnC,0GAAA,WAAW,OAAA","sourcesContent":["export { ModalHeader } from './ModalHeader';\nexport type { ModalHeaderProps } from './ModalHeader.types';\n"]}

package/dist/components/ModalHeader/index.d.cts

@@ -0,0 +1,3 @@
+export { ModalHeader } from "./ModalHeader.cjs";
+export type { ModalHeaderProps } from "./ModalHeader.types.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/components/ModalHeader/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/components/ModalHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAC5C,YAAY,EAAE,gBAAgB,EAAE,gCAA4B"}

package/dist/components/ModalHeader/index.d.mts

@@ -0,0 +1,3 @@
+export { ModalHeader } from "./ModalHeader.mjs";
+export type { ModalHeaderProps } from "./ModalHeader.types.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/components/ModalHeader/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/components/ModalHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,0BAAsB;AAC5C,YAAY,EAAE,gBAAgB,EAAE,gCAA4B"}

package/dist/components/ModalHeader/index.mjs

@@ -0,0 +1,2 @@
+export { ModalHeader } from "./ModalHeader.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/components/ModalHeader/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/components/ModalHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,0BAAsB","sourcesContent":["export { ModalHeader } from './ModalHeader';\nexport type { ModalHeaderProps } from './ModalHeader.types';\n"]}

package/dist/components/PopoverHeader/PopoverHeader.cjs

@@ -0,0 +1,60 @@
+"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.PopoverHeader = void 0;
+const design_system_shared_1 = require("@metamask-previews/design-system-shared");
+const react_1 = __importStar(require("react"));
+const tw_merge_1 = require("../../utils/tw-merge.cjs");
+const Box_1 = require("../Box/index.cjs");
+const ButtonIcon_1 = require("../ButtonIcon/index.cjs");
+const Text_1 = require("../Text/index.cjs");
+exports.PopoverHeader = (0, react_1.forwardRef)((props, ref) => {
+    const { children, className, startAccessory, endAccessory, onBack, backButtonProps, onClose, closeButtonProps, ...rest } = props;
+    // The discriminated union on `PopoverHeaderProps` guarantees that whenever
+    // `onBack` is set, `backButtonProps` is also set (with a required
+    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks
+    // below give TypeScript a narrowing point and double as runtime guards.
+    // The auto-rendered icon buttons default to `text-inherit` so they pick
+    // up the popover surface color (preserving the legacy `IconColor.inherit`
+    // behavior); consumers can still override via `className` on the prop bag.
+    const resolvedStartAccessory = startAccessory ??
+        (onBack && backButtonProps ? (react_1.default.createElement(ButtonIcon_1.ButtonIcon, { iconName: design_system_shared_1.IconName.ArrowLeft, size: design_system_shared_1.ButtonIconSize.Sm, onClick: onBack, ...backButtonProps, className: (0, tw_merge_1.twMerge)('text-inherit', backButtonProps.className) })) : null);
+    const resolvedEndAccessory = endAccessory ??
+        (onClose && closeButtonProps ? (react_1.default.createElement(ButtonIcon_1.ButtonIcon, { iconName: design_system_shared_1.IconName.Close, size: design_system_shared_1.ButtonIconSize.Sm, onClick: onClose, ...closeButtonProps, className: (0, tw_merge_1.twMerge)('text-inherit', closeButtonProps.className) })) : null);
+    const titleContent = typeof children === 'string' ? (react_1.default.createElement(Text_1.Text, { variant: design_system_shared_1.TextVariant.HeadingSm, textAlign: Text_1.TextAlign.Center, color: design_system_shared_1.TextColor.Inherit }, children)) : (children);
+    return (react_1.default.createElement("header", { ref: ref, className: (0, tw_merge_1.twMerge)(
+        // Three-column grid keeps the title visually centered regardless of
+        // which side accessories are present — same layout primitive as
+        // `HeaderBase`, replicated here so the outer element is the
+        // semantic `<header>` (no extra wrapper div). Unlike `ModalHeader`,
+        // PopoverHeader applies no outer padding — popover surfaces own
+        // their own spacing.
+        'grid grid-cols-[1fr_auto_1fr] items-center', className), ...rest },
+        resolvedStartAccessory && (react_1.default.createElement(Box_1.Box, { className: "col-start-1 justify-self-start" }, resolvedStartAccessory)),
+        titleContent !== undefined && titleContent !== null && (react_1.default.createElement(Box_1.Box, { className: "col-start-2 col-end-3 w-full" }, titleContent)),
+        resolvedEndAccessory && (react_1.default.createElement(Box_1.Box, { className: "col-start-3 justify-self-end" }, resolvedEndAccessory))));
+});
+exports.PopoverHeader.displayName = 'PopoverHeader';
+//# sourceMappingURL=PopoverHeader.cjs.map

package/dist/components/PopoverHeader/PopoverHeader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.cjs","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kFAKiD;AACjD,+CAA0C;AAE1C,uDAA+C;AAC/C,0CAA6B;AAC7B,wDAA2C;AAC3C,4CAA0C;AAI7B,QAAA,aAAa,GAAG,IAAA,kBAAU,EACrC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACb,MAAM,EACJ,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,MAAM,EACN,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,2EAA2E;IAC3E,kEAAkE;IAClE,yEAAyE;IACzE,wEAAwE;IACxE,wEAAwE;IACxE,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,sBAAsB,GAC1B,cAAc;QACd,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAC3B,8BAAC,uBAAU,IACT,QAAQ,EAAE,+BAAQ,CAAC,SAAS,EAC5B,IAAI,EAAE,qCAAc,CAAC,EAAE,EACvB,OAAO,EAAE,MAAM,KACX,eAAe,EACnB,SAAS,EAAE,IAAA,kBAAO,EAAC,cAAc,EAAE,eAAe,CAAC,SAAS,CAAC,GAC7D,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,oBAAoB,GACxB,YAAY;QACZ,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAC7B,8BAAC,uBAAU,IACT,QAAQ,EAAE,+BAAQ,CAAC,KAAK,EACxB,IAAI,EAAE,qCAAc,CAAC,EAAE,EACvB,OAAO,EAAE,OAAO,KACZ,gBAAgB,EACpB,SAAS,EAAE,IAAA,kBAAO,EAAC,cAAc,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAC9D,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,YAAY,GAChB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC7B,8BAAC,WAAI,IACH,OAAO,EAAE,kCAAW,CAAC,SAAS,EAC9B,SAAS,EAAE,gBAAS,CAAC,MAAM,EAC3B,KAAK,EAAE,gCAAS,CAAC,OAAO,IAEvB,QAAQ,CACJ,CACR,CAAC,CAAC,CAAC,CACF,QAAQ,CACT,CAAC;IAEJ,OAAO,CACL,0CACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,IAAA,kBAAO;QAChB,oEAAoE;QACpE,gEAAgE;QAChE,4DAA4D;QAC5D,oEAAoE;QACpE,gEAAgE;QAChE,qBAAqB;QACrB,4CAA4C,EAC5C,SAAS,CACV,KACG,IAAI;QAEP,sBAAsB,IAAI,CACzB,8BAAC,SAAG,IAAC,SAAS,EAAC,gCAAgC,IAC5C,sBAAsB,CACnB,CACP;QACA,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,CACtD,8BAAC,SAAG,IAAC,SAAS,EAAC,8BAA8B,IAAE,YAAY,CAAO,CACnE;QACA,oBAAoB,IAAI,CACvB,8BAAC,SAAG,IAAC,SAAS,EAAC,8BAA8B,IAC1C,oBAAoB,CACjB,CACP,CACM,CACV,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,qBAAa,CAAC,WAAW,GAAG,eAAe,CAAC","sourcesContent":["import {\n  ButtonIconSize,\n  IconName,\n  TextColor,\n  TextVariant,\n} from '@metamask-previews/design-system-shared';\nimport React, { forwardRef } from 'react';\n\nimport { twMerge } from '../../utils/tw-merge';\nimport { Box } from '../Box';\nimport { ButtonIcon } from '../ButtonIcon';\nimport { Text, TextAlign } from '../Text';\n\nimport type { PopoverHeaderProps } from './PopoverHeader.types';\n\nexport const PopoverHeader = forwardRef<HTMLElement, PopoverHeaderProps>(\n  (props, ref) => {\n    const {\n      children,\n      className,\n      startAccessory,\n      endAccessory,\n      onBack,\n      backButtonProps,\n      onClose,\n      closeButtonProps,\n      ...rest\n    } = props;\n\n    // The discriminated union on `PopoverHeaderProps` guarantees that whenever\n    // `onBack` is set, `backButtonProps` is also set (with a required\n    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks\n    // below give TypeScript a narrowing point and double as runtime guards.\n    // The auto-rendered icon buttons default to `text-inherit` so they pick\n    // up the popover surface color (preserving the legacy `IconColor.inherit`\n    // behavior); consumers can still override via `className` on the prop bag.\n    const resolvedStartAccessory =\n      startAccessory ??\n      (onBack && backButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.ArrowLeft}\n          size={ButtonIconSize.Sm}\n          onClick={onBack}\n          {...backButtonProps}\n          className={twMerge('text-inherit', backButtonProps.className)}\n        />\n      ) : null);\n\n    const resolvedEndAccessory =\n      endAccessory ??\n      (onClose && closeButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.Close}\n          size={ButtonIconSize.Sm}\n          onClick={onClose}\n          {...closeButtonProps}\n          className={twMerge('text-inherit', closeButtonProps.className)}\n        />\n      ) : null);\n\n    const titleContent =\n      typeof children === 'string' ? (\n        <Text\n          variant={TextVariant.HeadingSm}\n          textAlign={TextAlign.Center}\n          color={TextColor.Inherit}\n        >\n          {children}\n        </Text>\n      ) : (\n        children\n      );\n\n    return (\n      <header\n        ref={ref}\n        className={twMerge(\n          // Three-column grid keeps the title visually centered regardless of\n          // which side accessories are present — same layout primitive as\n          // `HeaderBase`, replicated here so the outer element is the\n          // semantic `<header>` (no extra wrapper div). Unlike `ModalHeader`,\n          // PopoverHeader applies no outer padding — popover surfaces own\n          // their own spacing.\n          'grid grid-cols-[1fr_auto_1fr] items-center',\n          className,\n        )}\n        {...rest}\n      >\n        {resolvedStartAccessory && (\n          <Box className=\"col-start-1 justify-self-start\">\n            {resolvedStartAccessory}\n          </Box>\n        )}\n        {titleContent !== undefined && titleContent !== null && (\n          <Box className=\"col-start-2 col-end-3 w-full\">{titleContent}</Box>\n        )}\n        {resolvedEndAccessory && (\n          <Box className=\"col-start-3 justify-self-end\">\n            {resolvedEndAccessory}\n          </Box>\n        )}\n      </header>\n    );\n  },\n);\n\nPopoverHeader.displayName = 'PopoverHeader';\n"]}

package/dist/components/PopoverHeader/PopoverHeader.d.cts

@@ -0,0 +1,55 @@
+import React from "react";
+export declare const PopoverHeader: React.ForwardRefExoticComponent<(Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} & {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} & {
+    onClose: () => void;
+    closeButtonProps: Omit<import("../ButtonIcon/index.cjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack: () => void;
+    backButtonProps: Omit<import("../ButtonIcon/index.cjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack: () => void;
+    backButtonProps: Omit<import("../ButtonIcon/index.cjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    onClose: () => void;
+    closeButtonProps: Omit<import("../ButtonIcon/index.cjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref">) & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=PopoverHeader.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.d.cts","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAqB,cAAc;AAS1C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAyFzB,CAAC"}

package/dist/components/PopoverHeader/PopoverHeader.d.mts

@@ -0,0 +1,55 @@
+import React from "react";
+export declare const PopoverHeader: React.ForwardRefExoticComponent<(Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} & {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} & {
+    onClose: () => void;
+    closeButtonProps: Omit<import("../ButtonIcon/index.mjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack: () => void;
+    backButtonProps: Omit<import("../ButtonIcon/index.mjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref"> | Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>, "children"> & {
+    onBack: () => void;
+    backButtonProps: Omit<import("../ButtonIcon/index.mjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    onClose: () => void;
+    closeButtonProps: Omit<import("../ButtonIcon/index.mjs").ButtonIconProps, "size" | "onClick" | "iconName"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+} & {
+    children?: React.ReactNode;
+    startAccessory?: React.ReactNode;
+    endAccessory?: React.ReactNode;
+    className?: string | undefined;
+}, "ref">) & React.RefAttributes<HTMLElement>>;
+//# sourceMappingURL=PopoverHeader.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.d.mts","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAqB,cAAc;AAS1C,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CAyFzB,CAAC"}

package/dist/components/PopoverHeader/PopoverHeader.mjs

@@ -0,0 +1,41 @@
+function $importDefault(module) {
+    if (module?.__esModule) {
+        return module.default;
+    }
+    return module;
+}
+import { ButtonIconSize, IconName, TextColor, TextVariant } from "@metamask-previews/design-system-shared";
+import $React, { forwardRef } from "react";
+const React = $importDefault($React);
+import { twMerge } from "../../utils/tw-merge.mjs";
+import { Box } from "../Box/index.mjs";
+import { ButtonIcon } from "../ButtonIcon/index.mjs";
+import { Text, TextAlign } from "../Text/index.mjs";
+export const PopoverHeader = forwardRef((props, ref) => {
+    const { children, className, startAccessory, endAccessory, onBack, backButtonProps, onClose, closeButtonProps, ...rest } = props;
+    // The discriminated union on `PopoverHeaderProps` guarantees that whenever
+    // `onBack` is set, `backButtonProps` is also set (with a required
+    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks
+    // below give TypeScript a narrowing point and double as runtime guards.
+    // The auto-rendered icon buttons default to `text-inherit` so they pick
+    // up the popover surface color (preserving the legacy `IconColor.inherit`
+    // behavior); consumers can still override via `className` on the prop bag.
+    const resolvedStartAccessory = startAccessory ??
+        (onBack && backButtonProps ? (React.createElement(ButtonIcon, { iconName: IconName.ArrowLeft, size: ButtonIconSize.Sm, onClick: onBack, ...backButtonProps, className: twMerge('text-inherit', backButtonProps.className) })) : null);
+    const resolvedEndAccessory = endAccessory ??
+        (onClose && closeButtonProps ? (React.createElement(ButtonIcon, { iconName: IconName.Close, size: ButtonIconSize.Sm, onClick: onClose, ...closeButtonProps, className: twMerge('text-inherit', closeButtonProps.className) })) : null);
+    const titleContent = typeof children === 'string' ? (React.createElement(Text, { variant: TextVariant.HeadingSm, textAlign: TextAlign.Center, color: TextColor.Inherit }, children)) : (children);
+    return (React.createElement("header", { ref: ref, className: twMerge(
+        // Three-column grid keeps the title visually centered regardless of
+        // which side accessories are present — same layout primitive as
+        // `HeaderBase`, replicated here so the outer element is the
+        // semantic `<header>` (no extra wrapper div). Unlike `ModalHeader`,
+        // PopoverHeader applies no outer padding — popover surfaces own
+        // their own spacing.
+        'grid grid-cols-[1fr_auto_1fr] items-center', className), ...rest },
+        resolvedStartAccessory && (React.createElement(Box, { className: "col-start-1 justify-self-start" }, resolvedStartAccessory)),
+        titleContent !== undefined && titleContent !== null && (React.createElement(Box, { className: "col-start-2 col-end-3 w-full" }, titleContent)),
+        resolvedEndAccessory && (React.createElement(Box, { className: "col-start-3 justify-self-end" }, resolvedEndAccessory))));
+});
+PopoverHeader.displayName = 'PopoverHeader';
+//# sourceMappingURL=PopoverHeader.mjs.map

package/dist/components/PopoverHeader/PopoverHeader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.mjs","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.tsx"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACL,cAAc,EACd,QAAQ,EACR,SAAS,EACT,WAAW,EACZ,gDAAgD;AACjD,OAAO,QAAO,EAAE,UAAU,EAAE,cAAc;;AAE1C,OAAO,EAAE,OAAO,EAAE,iCAA6B;AAC/C,OAAO,EAAE,GAAG,EAAE,yBAAe;AAC7B,OAAO,EAAE,UAAU,EAAE,gCAAsB;AAC3C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,0BAAgB;AAI1C,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CACrC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACb,MAAM,EACJ,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,MAAM,EACN,eAAe,EACf,OAAO,EACP,gBAAgB,EAChB,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,2EAA2E;IAC3E,kEAAkE;IAClE,yEAAyE;IACzE,wEAAwE;IACxE,wEAAwE;IACxE,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,sBAAsB,GAC1B,cAAc;QACd,CAAC,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAC3B,oBAAC,UAAU,IACT,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAC5B,IAAI,EAAE,cAAc,CAAC,EAAE,EACvB,OAAO,EAAE,MAAM,KACX,eAAe,EACnB,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,SAAS,CAAC,GAC7D,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,oBAAoB,GACxB,YAAY;QACZ,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAC7B,oBAAC,UAAU,IACT,QAAQ,EAAE,QAAQ,CAAC,KAAK,EACxB,IAAI,EAAE,cAAc,CAAC,EAAE,EACvB,OAAO,EAAE,OAAO,KACZ,gBAAgB,EACpB,SAAS,EAAE,OAAO,CAAC,cAAc,EAAE,gBAAgB,CAAC,SAAS,CAAC,GAC9D,CACH,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAEZ,MAAM,YAAY,GAChB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC7B,oBAAC,IAAI,IACH,OAAO,EAAE,WAAW,CAAC,SAAS,EAC9B,SAAS,EAAE,SAAS,CAAC,MAAM,EAC3B,KAAK,EAAE,SAAS,CAAC,OAAO,IAEvB,QAAQ,CACJ,CACR,CAAC,CAAC,CAAC,CACF,QAAQ,CACT,CAAC;IAEJ,OAAO,CACL,gCACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,OAAO;QAChB,oEAAoE;QACpE,gEAAgE;QAChE,4DAA4D;QAC5D,oEAAoE;QACpE,gEAAgE;QAChE,qBAAqB;QACrB,4CAA4C,EAC5C,SAAS,CACV,KACG,IAAI;QAEP,sBAAsB,IAAI,CACzB,oBAAC,GAAG,IAAC,SAAS,EAAC,gCAAgC,IAC5C,sBAAsB,CACnB,CACP;QACA,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,IAAI,CACtD,oBAAC,GAAG,IAAC,SAAS,EAAC,8BAA8B,IAAE,YAAY,CAAO,CACnE;QACA,oBAAoB,IAAI,CACvB,oBAAC,GAAG,IAAC,SAAS,EAAC,8BAA8B,IAC1C,oBAAoB,CACjB,CACP,CACM,CACV,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,aAAa,CAAC,WAAW,GAAG,eAAe,CAAC","sourcesContent":["import {\n  ButtonIconSize,\n  IconName,\n  TextColor,\n  TextVariant,\n} from '@metamask-previews/design-system-shared';\nimport React, { forwardRef } from 'react';\n\nimport { twMerge } from '../../utils/tw-merge';\nimport { Box } from '../Box';\nimport { ButtonIcon } from '../ButtonIcon';\nimport { Text, TextAlign } from '../Text';\n\nimport type { PopoverHeaderProps } from './PopoverHeader.types';\n\nexport const PopoverHeader = forwardRef<HTMLElement, PopoverHeaderProps>(\n  (props, ref) => {\n    const {\n      children,\n      className,\n      startAccessory,\n      endAccessory,\n      onBack,\n      backButtonProps,\n      onClose,\n      closeButtonProps,\n      ...rest\n    } = props;\n\n    // The discriminated union on `PopoverHeaderProps` guarantees that whenever\n    // `onBack` is set, `backButtonProps` is also set (with a required\n    // `ariaLabel`). Same for `onClose` / `closeButtonProps`. The `&&` checks\n    // below give TypeScript a narrowing point and double as runtime guards.\n    // The auto-rendered icon buttons default to `text-inherit` so they pick\n    // up the popover surface color (preserving the legacy `IconColor.inherit`\n    // behavior); consumers can still override via `className` on the prop bag.\n    const resolvedStartAccessory =\n      startAccessory ??\n      (onBack && backButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.ArrowLeft}\n          size={ButtonIconSize.Sm}\n          onClick={onBack}\n          {...backButtonProps}\n          className={twMerge('text-inherit', backButtonProps.className)}\n        />\n      ) : null);\n\n    const resolvedEndAccessory =\n      endAccessory ??\n      (onClose && closeButtonProps ? (\n        <ButtonIcon\n          iconName={IconName.Close}\n          size={ButtonIconSize.Sm}\n          onClick={onClose}\n          {...closeButtonProps}\n          className={twMerge('text-inherit', closeButtonProps.className)}\n        />\n      ) : null);\n\n    const titleContent =\n      typeof children === 'string' ? (\n        <Text\n          variant={TextVariant.HeadingSm}\n          textAlign={TextAlign.Center}\n          color={TextColor.Inherit}\n        >\n          {children}\n        </Text>\n      ) : (\n        children\n      );\n\n    return (\n      <header\n        ref={ref}\n        className={twMerge(\n          // Three-column grid keeps the title visually centered regardless of\n          // which side accessories are present — same layout primitive as\n          // `HeaderBase`, replicated here so the outer element is the\n          // semantic `<header>` (no extra wrapper div). Unlike `ModalHeader`,\n          // PopoverHeader applies no outer padding — popover surfaces own\n          // their own spacing.\n          'grid grid-cols-[1fr_auto_1fr] items-center',\n          className,\n        )}\n        {...rest}\n      >\n        {resolvedStartAccessory && (\n          <Box className=\"col-start-1 justify-self-start\">\n            {resolvedStartAccessory}\n          </Box>\n        )}\n        {titleContent !== undefined && titleContent !== null && (\n          <Box className=\"col-start-2 col-end-3 w-full\">{titleContent}</Box>\n        )}\n        {resolvedEndAccessory && (\n          <Box className=\"col-start-3 justify-self-end\">\n            {resolvedEndAccessory}\n          </Box>\n        )}\n      </header>\n    );\n  },\n);\n\nPopoverHeader.displayName = 'PopoverHeader';\n"]}

package/dist/components/PopoverHeader/PopoverHeader.types.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PopoverHeader.types.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.types.cjs","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ComponentProps, ReactNode } from 'react';\n\nimport type { ButtonIconProps } from '../ButtonIcon';\n\n/**\n * Props accepted by the auto-rendered back / close `ButtonIcon`. The\n * component owns `iconName` (ArrowLeft / Close) and `size`\n * (ButtonIconSize.Sm), so consumers cannot override them. The `data-*` index\n * signature lets test ids and other dataset attributes pass through\n * `Partial`/`Omit` indirection.\n *\n * `ariaLabel` is preserved as **required** (it is required on\n * `ButtonIconProps`). The component does not pull from any i18n context, so\n * consumers must pass a localized label explicitly:\n *\n * ```tsx\n * closeButtonProps={{ ariaLabel: t('close') }}\n * ```\n */\ntype PopoverHeaderButtonProps = Omit<\n  ButtonIconProps,\n  'iconName' | 'size' | 'onClick'\n> & {\n  [key: `data-${string}`]: string | undefined;\n};\n\n/**\n * Discriminated pair: `onBack` and `backButtonProps` are co-required. If\n * `onBack` is set, the consumer must also provide `backButtonProps` with a\n * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at\n * compile time without an internal English default.\n */\ntype PopoverHeaderBackProps =\n  | { onBack?: undefined; backButtonProps?: undefined }\n  | { onBack: () => void; backButtonProps: PopoverHeaderButtonProps };\n\n/**\n * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same\n * shape and rationale as `PopoverHeaderBackProps`.\n */\ntype PopoverHeaderCloseProps =\n  | { onClose?: undefined; closeButtonProps?: undefined }\n  | { onClose: () => void; closeButtonProps: PopoverHeaderButtonProps };\n\nexport type PopoverHeaderProps = Omit<ComponentProps<'header'>, 'children'> &\n  PopoverHeaderBackProps &\n  PopoverHeaderCloseProps & {\n    /**\n     * Header title content. When a string, it is auto-wrapped in a\n     * `Text` with `TextVariant.HeadingSm`, `TextAlign.Center`, and\n     * `TextColor.Inherit` so the title picks up the popover surface color.\n     * When a `ReactNode`, it is rendered as-is.\n     */\n    children?: ReactNode;\n    /**\n     * Optional override for the start (left in LTR) slot. When provided, it\n     * replaces the auto-rendered back button — even if `onBack` is set.\n     */\n    startAccessory?: ReactNode;\n    /**\n     * Optional override for the end (right in LTR) slot. When provided, it\n     * replaces the auto-rendered close button — even if `onClose` is set.\n     */\n    endAccessory?: ReactNode;\n    /**\n     * Optional override for additional CSS classes applied to the\n     * PopoverHeader root. Merged with the component's defaults via `twMerge`.\n     */\n    className?: string;\n  };\n"]}

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

@@ -0,0 +1,70 @@
+import type { ComponentProps, ReactNode } from "react";
+import type { ButtonIconProps } from "../ButtonIcon/index.cjs";
+/**
+ * Props accepted by the auto-rendered back / close `ButtonIcon`. The
+ * component owns `iconName` (ArrowLeft / Close) and `size`
+ * (ButtonIconSize.Sm), so consumers cannot override them. The `data-*` index
+ * signature lets test ids and other dataset attributes pass through
+ * `Partial`/`Omit` indirection.
+ *
+ * `ariaLabel` is preserved as **required** (it is required on
+ * `ButtonIconProps`). The component does not pull from any i18n context, so
+ * consumers must pass a localized label explicitly:
+ *
+ * ```tsx
+ * closeButtonProps={{ ariaLabel: t('close') }}
+ * ```
+ */
+type PopoverHeaderButtonProps = Omit<ButtonIconProps, 'iconName' | 'size' | 'onClick'> & {
+    [key: `data-${string}`]: string | undefined;
+};
+/**
+ * Discriminated pair: `onBack` and `backButtonProps` are co-required. If
+ * `onBack` is set, the consumer must also provide `backButtonProps` with a
+ * (required) `ariaLabel`. This enforces the no-i18n-fallback contract at
+ * compile time without an internal English default.
+ */
+type PopoverHeaderBackProps = {
+    onBack?: undefined;
+    backButtonProps?: undefined;
+} | {
+    onBack: () => void;
+    backButtonProps: PopoverHeaderButtonProps;
+};
+/**
+ * Discriminated pair: `onClose` and `closeButtonProps` are co-required. Same
+ * shape and rationale as `PopoverHeaderBackProps`.
+ */
+type PopoverHeaderCloseProps = {
+    onClose?: undefined;
+    closeButtonProps?: undefined;
+} | {
+    onClose: () => void;
+    closeButtonProps: PopoverHeaderButtonProps;
+};
+export type PopoverHeaderProps = Omit<ComponentProps<'header'>, 'children'> & PopoverHeaderBackProps & PopoverHeaderCloseProps & {
+    /**
+     * Header title content. When a string, it is auto-wrapped in a
+     * `Text` with `TextVariant.HeadingSm`, `TextAlign.Center`, and
+     * `TextColor.Inherit` so the title picks up the popover surface color.
+     * When a `ReactNode`, it is rendered as-is.
+     */
+    children?: ReactNode;
+    /**
+     * Optional override for the start (left in LTR) slot. When provided, it
+     * replaces the auto-rendered back button — even if `onBack` is set.
+     */
+    startAccessory?: ReactNode;
+    /**
+     * Optional override for the end (right in LTR) slot. When provided, it
+     * replaces the auto-rendered close button — even if `onClose` is set.
+     */
+    endAccessory?: ReactNode;
+    /**
+     * Optional override for additional CSS classes applied to the
+     * PopoverHeader root. Merged with the component's defaults via `twMerge`.
+     */
+    className?: string;
+};
+export {};
+//# sourceMappingURL=PopoverHeader.types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverHeader.types.d.cts","sourceRoot":"","sources":["../../../src/components/PopoverHeader/PopoverHeader.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,cAAc;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,gCAAsB;AAErD;;;;;;;;;;;;;;GAcG;AACH,KAAK,wBAAwB,GAAG,IAAI,CAClC,eAAe,EACf,UAAU,GAAG,MAAM,GAAG,SAAS,CAChC,GAAG;IACF,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,KAAK,sBAAsB,GACvB;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,SAAS,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,eAAe,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAEtE;;;GAGG;AACH,KAAK,uBAAuB,GACxB;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,gBAAgB,CAAC,EAAE,SAAS,CAAA;CAAE,GACrD;IAAE,OAAO,EAAE,MAAM,IAAI,CAAC;IAAC,gBAAgB,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GACzE,sBAAsB,GACtB,uBAAuB,GAAG;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}