@viraui/react 0.0.25 → 0.0.27

package/dist/components/dialog/dialog.guide.json

@@ -23,5 +23,19 @@
     "Relying only on backdrop press or swipe when a footer action is the primary close path",
     "Using Dialog when a centered non-gesture modal is enough and a future Dialog primitive is available"
   ],
-  "related": ["Surface", "Button", "IconButton", "Stack", "Elevator"]
+  "related": ["Surface", "Button", "IconButton", "Stack", "Elevator"],
+  "properties": {
+    "react": {
+      "Sheet.maxHeight": {
+        "description": "Maximum block size of the sheet panel.",
+        "refCss": "max-block-size"
+      }
+    },
+    "css": {
+      "max-block-size": {
+        "description": "Max block size of Dialog.Sheet popup root.",
+        "refReact": "Sheet.maxHeight"
+      }
+    }
+  }
 }

package/dist/components/dialog/dialog.js

@@ -7,15 +7,16 @@ import { DialogTrigger } from "./dialog-trigger.js";
 import { jsx } from "react/jsx-runtime";
 import { Drawer } from "@base-ui/react";
 //#region src/components/dialog/dialog.tsx
-var DialogRootComponent = ({ children, ...props }) => /* @__PURE__ */ jsx(Drawer.Root, {
-	...props,
+var { Portal: _DialogPortal, Backdrop: _DialogBackdrop, Viewport: _DialogViewport, Popup: _DialogPopup, Title: _DialogTitle, Description: _DialogDescription, Content: _DialogContent, SwipeArea: _DialogSwipeArea, VirtualKeyboardProvider: _DialogVirtualKeyboardProvider, createHandle: _DialogCreateHandle, Handle: _DialogHandle, Root: _DialogRoot, ...primitiveDrawer } = Drawer;
+var DialogRootComponent = ({ children, ...otherProps }) => /* @__PURE__ */ jsx(Drawer.Root, {
+	...otherProps,
 	children
 });
 var Dialog = Object.assign(DialogRootComponent, {
+	...primitiveDrawer,
 	Trigger: DialogTrigger,
 	Sheet: DialogSheet,
 	Close: DialogClose,
-	Provider: Drawer.Provider,
 	Indent: DialogIndent,
 	IndentBackground: DialogIndentBackground
 });

package/dist/components/dialog/dialog.module.js

@@ -1,15 +1,27 @@
+//#region src/components/dialog/dialog.module.css
+var Backdrop = "viraui__dialog-module__Backdrop_xgFhs";
+var Viewport = "viraui__dialog-module__Viewport_kmZN1";
+var Popup = "viraui__dialog-module__Popup_5qIyj";
+var Handle = "viraui__dialog-module__Handle_nd9SN";
+var HandleShape = "viraui__dialog-module__HandleShape_mEg8R";
+var Header = "viraui__dialog-module__Header_WnBly";
+var Body = "viraui__dialog-module__Body_9-UgN";
+var Content = "viraui__dialog-module__Content_r8lJc";
+var CloseButton = "viraui__dialog-module__CloseButton_U-B1r";
+var IndentBackground = "viraui__dialog-module__IndentBackground_OEfbh";
+var Indent = "viraui__dialog-module__Indent_qfiNW";
 var dialog_module_default = {
-	Backdrop: "viraui__dialog-module__Backdrop_xgFhs",
-	Viewport: "viraui__dialog-module__Viewport_kmZN1",
-	Popup: "viraui__dialog-module__Popup_5qIyj",
-	Handle: "viraui__dialog-module__Handle_nd9SN",
-	HandleShape: "viraui__dialog-module__HandleShape_mEg8R",
-	Header: "viraui__dialog-module__Header_WnBly",
-	Body: "viraui__dialog-module__Body_9-UgN",
-	Content: "viraui__dialog-module__Content_r8lJc",
-	CloseButton: "viraui__dialog-module__CloseButton_U-B1r",
-	IndentBackground: "viraui__dialog-module__IndentBackground_OEfbh",
-	Indent: "viraui__dialog-module__Indent_qfiNW"
+	Backdrop,
+	Viewport,
+	Popup,
+	Handle,
+	HandleShape,
+	Header,
+	Body,
+	Content,
+	CloseButton,
+	IndentBackground,
+	Indent
 };
 //#endregion
-export { dialog_module_default as default };
+export { Backdrop, Body, CloseButton, Content, Handle, HandleShape, Header, Indent, IndentBackground, Popup, Viewport, dialog_module_default as default };

package/dist/components/elevator/elevator.js

@@ -1,5 +1,5 @@
 import { extractIntrinsicViraProps } from "../../core/props/intrinsic-vira-props.js";
-import "../../core/elevation/elevation-types.js";
+import { ELEVATION_DEFAULTS } from "../../core/elevation/elevation-types.js";
 import { getElevationProps } from "../../core/elevation/get-elevation-props.js";
 import { Children, cloneElement, isValidElement } from "react";
 //#region src/components/elevator/elevator.tsx
@@ -26,4 +26,4 @@ var Elevator = ({ children, resting, hover, direction, shadowColor, extraShadow,
 	});
 };
 //#endregion
-export { Elevator };
+export { ELEVATION_DEFAULTS, Elevator, getElevationProps };

package/dist/components/fieldset/fieldset.js

@@ -1,7 +1,7 @@
 import { extractIntrinsicViraProps } from "../../core/props/intrinsic-vira-props.js";
-import { Stack } from "../stack/stack.js";
 import { FieldHelperCopy } from "../basic-input/field-helper-copy.js";
 import { FieldLabel } from "../basic-input/field-label.js";
+import { Stack } from "../stack/stack.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Fieldset } from "@base-ui/react";
 //#region src/components/fieldset/fieldset.tsx

package/dist/components/icon/icon.module.js

@@ -1,3 +1,5 @@
-var icon_module_default = { Icon: "viraui__icon-module__Icon_6DoBq" };
+//#region src/components/icon/icon.module.css
+var Icon = "viraui__icon-module__Icon_6DoBq";
+var icon_module_default = { Icon };
 //#endregion
-export { icon_module_default as default };
+export { Icon, icon_module_default as default };

package/dist/components/icon-button/icon-button.js

@@ -1,10 +1,10 @@
 import { Button } from "../button/button.js";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/icon-button/icon-button.tsx
-var IconButton = ({ icon, size = "medium", ...props }) => /* @__PURE__ */ jsx(Button, {
+var IconButton = ({ icon, size = "medium", ...otherProps }) => /* @__PURE__ */ jsx(Button, {
 	addon: icon,
 	size,
-	...props
+	...otherProps
 });
 //#endregion
 export { IconButton };

package/dist/components/index.d.ts

@@ -1,31 +1,39 @@
+export * from './accordion';
 export * from './avatar';
 export * from './avatar-group';
+export * from './bleed';
+export * from './button';
+export * from './checkbox';
 export * from './chip';
-export * from './dialog';
 export * from './clamp-text';
+export * from './dialog';
 export * from './elevator';
-export * from './button';
+export * from './fieldset';
+export * from './icon';
 export * from './icon-button';
 export * from './linear-progress';
 export * from './masonry';
-export * from './textfield';
-export * from './textarea';
-export * from './slider';
-export * from './switch';
-export * from './checkbox';
-export * from './fieldset';
+export * from './meter';
+export * from './popover';
+export * from './progressive-blur';
 export * from './radio';
 export * from './select';
 export * from './separator';
 export * from './shimmer';
-export * from './icon';
 export * from './skeleton';
+export * from './slider';
+export * from './spinner';
 export * from './stack';
+export * from './static-noise';
 export * from './surface';
+export * from './switch';
 export * from './tabs';
-export * from './toast';
-export * from './spinner';
-export * from './static-noise';
-export * from './progressive-blur';
 export * from './text';
+export * from './textarea';
+export * from './textfield';
 export * from './title';
+export * from './toast';
+export * from './toggle-button';
+export * from './toggle-group';
+export * from './typewriter';
+export * from './tooltip';

package/dist/components/linear-progress/linear-progress.css

@@ -1 +1 @@
-.viraui__linear-progress-module__LinearProgress_-KN0j{--linear-progress-track-size:var(--space-x-small);--linear-progress-track-background:var(--global-contrast);--linear-progress-indicator-color:var(--global-primary);& .viraui__linear-progress-module__Track_qUz8P{position:relative;overflow:hidden;block-size:var(--linear-progress-track-size);background:var(--linear-progress-track-background);border-radius:var(--radius-infinite)}& .viraui__linear-progress-module__Indicator_maaZF{block-size:100%;background:var(--linear-progress-indicator-color);border-radius:inherit;&[data-indeterminate]{position:absolute;inset:0;inline-size:100%;background:#0000;&:before{position:absolute;inset-block:0;inline-size:40%;background:var(--linear-progress-indicator-color);border-radius:inherit;animation:viraui__linear-progress-module__linear-progress-indeterminate_g0cSO 1.4s var(--easing-standard) infinite;content:""}}}}@keyframes viraui__linear-progress-module__linear-progress-indeterminate_g0cSO{0%{transform:translateX(-120%)}to{transform:translateX(260%)}}
+.viraui__linear-progress-module__LinearProgress_-KN0j{--vui-linear-progress-track-size:var(--space-x-small);--vui-linear-progress-track-background:var(--global-contrast);--vui-linear-progress-indicator-color:var(--global-primary);& .viraui__linear-progress-module__Track_qUz8P{position:relative;overflow:hidden;block-size:var(--vui-linear-progress-track-size);background:var(--vui-linear-progress-track-background);border-radius:var(--radius-infinite)}& .viraui__linear-progress-module__Indicator_maaZF{block-size:100%;background:var(--vui-linear-progress-indicator-color);border-radius:inherit;&[data-indeterminate]{position:absolute;inset:0;inline-size:100%;background:#0000;&:before{position:absolute;inset-block:0;inline-size:40%;background:var(--vui-linear-progress-indicator-color);border-radius:inherit;animation:viraui__linear-progress-module__linear-progress-indeterminate_g0cSO 1.4s var(--easing-standard) infinite;content:""}}}}@keyframes viraui__linear-progress-module__linear-progress-indeterminate_g0cSO{0%{transform:translateX(-120%)}to{transform:translateX(260%)}}

package/dist/components/linear-progress/linear-progress.guide.json

@@ -23,5 +23,18 @@
     "Do not model disabled progress; Base UI Progress does not expose a disabled state.",
     "Do not hide the task label when multiple progress indicators are visible."
   ],
-  "related": ["Slider", "Spinner", "Skeleton", "Text"]
+  "related": ["Slider", "Spinner", "Skeleton", "Text"],
+  "properties": {
+    "css": {
+      "track-size": {
+        "description": "Progress track thickness on the root."
+      },
+      "track-background": {
+        "description": "Progress track background color."
+      },
+      "indicator-color": {
+        "description": "Determinate progress indicator color."
+      }
+    }
+  }
 }

package/dist/components/linear-progress/linear-progress.js

@@ -1,9 +1,9 @@
 import './linear-progress.css';
 import { clsx } from "../../core/clsx.js";
 import { extractIntrinsicViraProps } from "../../core/props/intrinsic-vira-props.js";
-import { Stack } from "../stack/stack.js";
 import { Text } from "../text/text.js";
 import { FieldLabel } from "../basic-input/field-label.js";
+import { Stack } from "../stack/stack.js";
 import linear_progress_module_default from "./linear-progress.module.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Progress } from "@base-ui/react/progress";

package/dist/components/linear-progress/linear-progress.module.js

@@ -1,8 +1,12 @@
+//#region src/components/linear-progress/linear-progress.module.css
+var LinearProgress = "viraui__linear-progress-module__LinearProgress_-KN0j";
+var Track = "viraui__linear-progress-module__Track_qUz8P";
+var Indicator = "viraui__linear-progress-module__Indicator_maaZF";
 var linear_progress_module_default = {
-	LinearProgress: "viraui__linear-progress-module__LinearProgress_-KN0j",
+	LinearProgress,
 	"linear-progress-indeterminate": "viraui__linear-progress-module__linear-progress-indeterminate_g0cSO",
-	Track: "viraui__linear-progress-module__Track_qUz8P",
-	Indicator: "viraui__linear-progress-module__Indicator_maaZF"
+	Track,
+	Indicator
 };
 //#endregion
-export { linear_progress_module_default as default };
+export { Indicator, LinearProgress, Track, linear_progress_module_default as default };

package/dist/components/masonry/masonry.css

@@ -1 +1 @@
-.viraui__masonry-module__Masonry_l7c8U{--masonry-gap:var(--space-large);--masonry-column-fill:balance;--masonry-column-rule-color:var(--global-contrast);display:block;column-gap:var(--masonry-gap);column-fill:var(--masonry-column-fill);column-rule-color:var(--masonry-column-rule-color);columns:var(--masonry-column-width,auto) var(--masonry-column-count,auto)}.viraui__masonry-module__Item_ywXwo{display:block;break-inside:avoid;margin:0;padding-block-end:var(--masonry-gap);&[data-masonry-item-span-all=true]{column-span:all}}
+.viraui__masonry-module__Masonry_l7c8U{--vui-masonry-gap:var(--space-large);--vui-masonry-column-fill:balance;--vui-masonry-column-rule-color:var(--global-contrast);display:block;column-gap:var(--vui-masonry-gap);column-fill:var(--vui-masonry-column-fill);column-rule-color:var(--vui-masonry-column-rule-color);columns:var(--vui-masonry-column-width,auto) var(--vui-masonry-column-count,auto)}.viraui__masonry-module__Item_ywXwo{display:block;break-inside:avoid;margin:0;padding-block-end:var(--vui-masonry-gap);&[data-masonry-item-span-all=true]{column-span:all}}

package/dist/components/masonry/masonry.guide.json

@@ -20,5 +20,46 @@
     "Treating CSS columns as a true interactive grid with predictable left-to-right keyboard traversal",
     "Using arbitrary child margins instead of the component gap contract for item spacing"
   ],
-  "related": ["Stack", "Surface", "Text"]
+  "related": ["Stack", "Surface", "Text"],
+  "properties": {
+    "react": {
+      "gap": {
+        "description": "Gap between columns and block-end spacing on each item.",
+        "refCss": "gap"
+      },
+      "columnFill": {
+        "description": "How the browser balances content across columns.",
+        "refCss": "column-fill"
+      },
+      "columnWidth": {
+        "description": "CSS column-width override; takes precedence over columnCount.",
+        "refCss": "column-width"
+      },
+      "columnCount": {
+        "description": "CSS column-count when columnWidth is not set.",
+        "refCss": "column-count"
+      }
+    },
+    "css": {
+      "gap": {
+        "description": "Column gap and item block-end spacing.",
+        "refReact": "gap"
+      },
+      "column-fill": {
+        "description": "Column-fill algorithm on the root.",
+        "refReact": "columnFill"
+      },
+      "column-width": {
+        "description": "Width-based multi-column layout.",
+        "refReact": "columnWidth"
+      },
+      "column-count": {
+        "description": "Count-based multi-column layout.",
+        "refReact": "columnCount"
+      },
+      "column-rule-color": {
+        "description": "Color of the column rule between columns."
+      }
+    }
+  }
 }

package/dist/components/masonry/masonry.js

@@ -10,9 +10,9 @@ var MasonryRoot = ({ children, className, columnCount = 4, columnFill = "balance
 	const { componentProps, intrinsicAttributes } = extractIntrinsicViraProps(otherProps);
 	const usesColumnWidth = columnWidth !== void 0;
 	const dynamicStyle = {
-		"--masonry-gap": resolveThemeValue(gap, "space", "var(--space-large)"),
-		"--masonry-column-fill": columnFill,
-		...usesColumnWidth ? { "--masonry-column-width": columnWidth } : { "--masonry-column-count": `${columnCount}` },
+		"--vui-masonry-gap": resolveThemeValue(gap, "space", "var(--space-large)"),
+		"--vui-masonry-column-fill": columnFill,
+		...usesColumnWidth ? { "--vui-masonry-column-width": columnWidth } : { "--vui-masonry-column-count": `${columnCount}` },
 		columnRuleWidth,
 		columnRuleStyle,
 		...style

package/dist/components/masonry/masonry.module.js

@@ -1,6 +1,9 @@
+//#region src/components/masonry/masonry.module.css
+var Masonry = "viraui__masonry-module__Masonry_l7c8U";
+var Item = "viraui__masonry-module__Item_ywXwo";
 var masonry_module_default = {
-	Masonry: "viraui__masonry-module__Masonry_l7c8U",
-	Item: "viraui__masonry-module__Item_ywXwo"
+	Masonry,
+	Item
 };
 //#endregion
-export { masonry_module_default as default };
+export { Item, Masonry, masonry_module_default as default };

package/dist/components/meter/index.d.ts

@@ -0,0 +1,2 @@
+export { Meter } from './meter';
+export type { MeterProps } from './meter';

package/dist/components/meter/meter.css

@@ -0,0 +1 @@
+.viraui__meter-module__Meter_YRI7d{--vui-meter-track-size:var(--space-x-small);--vui-meter-track-background:var(--global-contrast);--vui-meter-indicator-color:var(--global-primary);& .viraui__meter-module__Track_uF9wy{position:relative;overflow:hidden;block-size:var(--vui-meter-track-size);background:var(--vui-meter-track-background);border-radius:var(--radius-infinite)}& .viraui__meter-module__Indicator_dNjqU{block-size:100%;background:var(--vui-meter-indicator-color);border-radius:inherit}}

package/dist/components/meter/meter.d.ts

@@ -0,0 +1,44 @@
+import { MeterRoot } from '@base-ui/react';
+import { IntrinsicViraProps } from '../../core/props/intrinsic-vira-props';
+import type * as React from 'react';
+/**
+ * Public Meter props.
+ *
+ * Includes Base UI meter root props such as `value`, `min`, `max`, `format`,
+ * and `getAriaValueText`, plus optional label, description, and value display.
+ *
+ * @default Base UI pass-through props keep upstream defaults.
+ */
+export type MeterProps = MeterRoot.Props & {
+    /**
+     * Adds `data-grow="false"` to the meter root when false.
+     *
+     * @default The meter root does not render a grow attribute.
+     */
+    grow?: IntrinsicViraProps['grow'];
+    /**
+     * Adds `data-shrink="false"` to the meter root when false.
+     *
+     * @default The meter root does not render a shrink attribute.
+     */
+    shrink?: IntrinsicViraProps['shrink'];
+    /**
+     * Visible label rendered through `Meter.Label` with shared internal `FieldLabel`.
+     *
+     * @default No label is rendered.
+     */
+    label?: React.ReactNode;
+    /**
+     * Static helper copy rendered with `Text` below the meter track.
+     *
+     * @default No description is rendered.
+     */
+    description?: React.ReactNode;
+    /**
+     * Renders the formatted current value via `Meter.Value` and `Text`.
+     *
+     * @default false
+     */
+    showValue?: boolean;
+};
+export declare const Meter: React.FC<MeterProps>;

package/dist/components/meter/meter.guide.json

@@ -0,0 +1,39 @@
+{
+  "name": "Meter",
+  "summary": "Shows a determinate metric in a compact horizontal track for static capacity, level, or score values.",
+  "whenToUse": [
+    "Use for storage usage, battery level, capacity, or score within a known range.",
+    "Use with a label when the metric needs a visible name.",
+    "Use with `showValue` when the formatted value should appear beside the label."
+  ],
+  "whenNotToUse": [
+    "Use LinearProgress for in-progress tasks or indeterminate work.",
+    "Use Slider when the user needs to choose or adjust a value.",
+    "Use Spinner for a small standalone loading affordance without metric context."
+  ],
+  "accessibility": [
+    "Provide a visible `label` or an accessible name through `aria-label` / `aria-labelledby` when the metric is not otherwise clear.",
+    "Keep `value` numeric and within `min` / `max` for accurate `aria-valuenow` semantics.",
+    "Use `description` for supplementary context that should not replace the accessible name."
+  ],
+  "antiPatterns": [
+    "Do not use Meter as an interactive value control.",
+    "Do not use Meter for indeterminate or in-progress work.",
+    "Do not hide the metric label when multiple meters are visible.",
+    "Do not model invalid or disabled meter state; Base UI Meter does not expose those states."
+  ],
+  "related": ["LinearProgress", "Slider", "Text"],
+  "properties": {
+    "css": {
+      "track-size": {
+        "description": "Meter track thickness on the root."
+      },
+      "track-background": {
+        "description": "Meter track background color."
+      },
+      "indicator-color": {
+        "description": "Determinate meter indicator color."
+      }
+    }
+  }
+}

package/dist/components/meter/meter.js

@@ -0,0 +1,59 @@
+import './meter.css';
+import { clsx } from "../../core/clsx.js";
+import { extractIntrinsicViraProps } from "../../core/props/intrinsic-vira-props.js";
+import { Text } from "../text/text.js";
+import { FieldLabel } from "../basic-input/field-label.js";
+import { Stack } from "../stack/stack.js";
+import meter_module_default from "./meter.module.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Meter } from "@base-ui/react";
+//#region src/components/meter/meter.tsx
+var Meter$1 = ({ className, description, label, showValue = false, value, ...otherProps }) => {
+	const { componentProps, intrinsicAttributes } = extractIntrinsicViraProps(otherProps);
+	return /* @__PURE__ */ jsxs(Meter.Root, {
+		...componentProps,
+		...intrinsicAttributes,
+		className: clsx(meter_module_default.Meter, className),
+		value,
+		render: /* @__PURE__ */ jsx(Stack, {
+			direction: "column",
+			fillChildren: false,
+			rowGap: "small",
+			columnGap: "x-small"
+		}),
+		children: [
+			(label || showValue) && /* @__PURE__ */ jsxs(Stack, {
+				direction: "row",
+				fillChildren: false,
+				columnGap: "small",
+				vAlign: "center",
+				hAlign: "space-between",
+				children: [label && /* @__PURE__ */ jsx(Meter.Label, {
+					render: /* @__PURE__ */ jsx(FieldLabel, {}),
+					children: label
+				}), showValue && /* @__PURE__ */ jsx(Text, {
+					size: "small",
+					tone: "muted",
+					family: "mono",
+					whiteSpace: "nowrap",
+					selection: false,
+					align: "end",
+					shrink: false,
+					render: /* @__PURE__ */ jsx(Meter.Value, { render: /* @__PURE__ */ jsx("output", {}) })
+				})]
+			}),
+			/* @__PURE__ */ jsx(Meter.Track, {
+				className: meter_module_default.Track,
+				children: /* @__PURE__ */ jsx(Meter.Indicator, { className: meter_module_default.Indicator })
+			}),
+			description && /* @__PURE__ */ jsx(Text, {
+				className: meter_module_default.Description,
+				size: "small",
+				tone: "muted",
+				children: description
+			})
+		]
+	});
+};
+//#endregion
+export { Meter$1 as Meter };

package/dist/components/meter/meter.module.js

@@ -0,0 +1,11 @@
+//#region src/components/meter/meter.module.css
+var Meter = "viraui__meter-module__Meter_YRI7d";
+var Track = "viraui__meter-module__Track_uF9wy";
+var Indicator = "viraui__meter-module__Indicator_dNjqU";
+var meter_module_default = {
+	Meter,
+	Track,
+	Indicator
+};
+//#endregion
+export { Indicator, Meter, Track, meter_module_default as default };

package/dist/components/popover/index.d.ts

@@ -0,0 +1,4 @@
+export { Popover, PopoverClose, PopoverDescription, PopoverTitle, PopoverTrigger } from './popover';
+export type { PopoverCloseProps, PopoverDescriptionProps, PopoverProps, PopoverTitleProps, PopoverTriggerProps, } from './popover';
+export { PopoverSheet } from './popover-sheet';
+export type { PopoverSheetProps } from './popover-sheet';

package/dist/components/popover/popover-sheet.d.ts

@@ -0,0 +1,65 @@
+import { PopoverPositioner } from '@base-ui/react/popover';
+import { StackProps } from '..';
+import type * as React from 'react';
+type PopoverSheetPositionerProps = Omit<PopoverPositioner.Props, 'className' | 'style' | 'render'>;
+type PopoverSheetStyledProps = PopoverSheetPositionerProps & {
+    /**
+     * Whether to skip the built-in Surface, header, and close chrome and render
+     * only the positioning/animation shell (Portal + Positioner + Popup + Viewport).
+     *
+     * @default false
+     */
+    unstyled?: false;
+    /**
+     * Accessible popover title rendered as the popup heading.
+     */
+    title: React.ReactNode;
+    /**
+     * Supporting copy announced with the title.
+     *
+     * @default No description is rendered.
+     */
+    description?: React.ReactNode;
+    /**
+     * Whether to show the built-in flat IconButton close control.
+     *
+     * @default false
+     */
+    showCloseButton?: boolean;
+    /**
+     * Aligns the header content.
+     *
+     * @default `start`
+     */
+    headerAlign?: Extract<StackProps['hAlign'], 'start' | 'center' | 'end'>;
+};
+type PopoverSheetUnstyledProps = PopoverSheetPositionerProps & {
+    /**
+     * Renders only the positioning/animation shell; compose `Popover.Title`,
+     * `Popover.Description`, and any chrome inside `children`.
+     */
+    unstyled: true;
+    title?: never;
+    description?: never;
+    showCloseButton?: never;
+    headerAlign?: never;
+};
+/**
+ * Public Popover.Sheet props.
+ *
+ * Encapsulates Portal + Positioner + Popup + Viewport + Title + Description +
+ * optional body `children`. Positioning props forward to the Positioner; `sideOffset`
+ * defaults to `8`. Always renders the internal Viewport so multi-trigger content
+ * animations work by default. Compose `Popover.Close` inside `children` when a
+ * close control is needed, or set `showCloseButton` for the built-in flat IconButton.
+ *
+ * With `unstyled`, the built-in Surface, header, and close chrome are skipped and
+ * `children` render directly inside the Viewport; the consumer owns the popup markup
+ * and must compose `Popover.Title` (and `Popover.Description` when needed) for
+ * accessible naming.
+ *
+ * @default `sideOffset` is `8`; no description, no close button, styled chrome.
+ */
+export type PopoverSheetProps = PopoverSheetStyledProps | PopoverSheetUnstyledProps;
+export declare const PopoverSheet: React.FC<PopoverSheetProps>;
+export {};

package/dist/components/popover/popover-sheet.js

@@ -0,0 +1,79 @@
+import { Text } from "../text/text.js";
+import { Stack } from "../stack/stack.js";
+import { Icon } from "../icon/icon.js";
+import { IconButton } from "../icon-button/icon-button.js";
+import popover_module_default from "./popover.module.js";
+import { Surface } from "../surface/surface.js";
+import { Title } from "../title/title.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Popover } from "@base-ui/react/popover";
+//#region src/components/popover/popover-sheet.tsx
+var PopoverSheet = ({ unstyled, title, description, children, showCloseButton = false, headerAlign = "start", sideOffset = 8, ...positionerProps }) => /* @__PURE__ */ jsx(Popover.Portal, { children: /* @__PURE__ */ jsx(Popover.Positioner, {
+	className: popover_module_default.Sheet,
+	sideOffset,
+	...positionerProps,
+	children: unstyled ? /* @__PURE__ */ jsx(Popover.Popup, {
+		className: popover_module_default.Popup,
+		children: /* @__PURE__ */ jsx(Popover.Viewport, {
+			className: popover_module_default.Viewport,
+			"data-unstyled": "",
+			children
+		})
+	}) : /* @__PURE__ */ jsx(Popover.Popup, {
+		className: popover_module_default.Popup,
+		render: /* @__PURE__ */ jsx(Surface, {
+			color: 1,
+			border: "all",
+			radius: "large",
+			vibrant: true,
+			render: /* @__PURE__ */ jsx(Stack, {
+				rowGap: "medium",
+				fillChildren: false
+			})
+		}),
+		children: /* @__PURE__ */ jsxs(Popover.Viewport, {
+			className: popover_module_default.Viewport,
+			render: /* @__PURE__ */ jsx(Stack, {
+				rowGap: "medium",
+				vPadding: "medium",
+				hPadding: "medium",
+				fillChildren: false
+			}),
+			children: [
+				/* @__PURE__ */ jsxs(Stack, {
+					hAlign: headerAlign,
+					rowGap: "small",
+					vAlign: "start",
+					vPadding: [0, children ? "medium" : 0],
+					children: [/* @__PURE__ */ jsx(Popover.Title, {
+						render: /* @__PURE__ */ jsx(Title, {
+							align: headerAlign,
+							level: "h6",
+							lineHeight: "x-small"
+						}),
+						children: title
+					}), description && /* @__PURE__ */ jsx(Popover.Description, {
+						render: /* @__PURE__ */ jsx(Text, {
+							align: headerAlign,
+							tone: "muted",
+							render: /* @__PURE__ */ jsx("p", {})
+						}),
+						children: description
+					})]
+				}),
+				showCloseButton && /* @__PURE__ */ jsx(Popover.Close, {
+					className: popover_module_default.CloseButton,
+					render: /* @__PURE__ */ jsx(IconButton, {
+						"aria-label": "Close popover",
+						icon: /* @__PURE__ */ jsx(Icon, { name: "Xmark" }),
+						size: "small",
+						variant: "flat"
+					})
+				}),
+				children
+			]
+		})
+	})
+}) });
+//#endregion
+export { PopoverSheet };

package/dist/components/popover/popover.css

@@ -0,0 +1 @@
+.viraui__popover-module__Sheet_4x-7H{width:var(--positioner-width);height:var(--positioner-height);max-width:var(--available-width);transition:top var(--duration-fast) var(--easing-standard),right var(--duration-fast) var(--easing-standard),bottom var(--duration-fast) var(--easing-standard),left var(--duration-fast) var(--easing-standard),transform var(--duration-fast) var(--easing-standard);&[data-instant=click],&[data-instant=dismiss]{transition:none}@media (prefers-reduced-motion:reduce){transition:none}}.viraui__popover-module__Popup_pJyIh{position:relative;box-sizing:border-box;width:var(--popup-width,auto);height:var(--popup-height,auto);transform-origin:var(--transform-origin);transition:width var(--duration-fast) var(--easing-standard),height var(--duration-fast) var(--easing-standard),opacity var(--duration-fast) var(--easing-entrance),transform var(--duration-fast) var(--easing-entrance);&[data-ending-style],&[data-starting-style]{opacity:0;transform:scale(.96)}&[data-instant=click],&[data-instant=dismiss]{transition:none}@media (prefers-reduced-motion:reduce){transition:none;&[data-ending-style],&[data-starting-style]{opacity:1;transform:none}}}.viraui__popover-module__Viewport_KrjBC{--vui-popover-content-fade-duration:var(--duration-fast);position:relative;display:grid;grid-template-columns:minmax(0,1fr);overflow:clip;width:100%;height:100%;&>[data-current],&>[data-previous]{grid-area:1/1;inline-size:calc(var(--popup-width) - 2px - var(--vui-stack-padding-inline-start) - var(--vui-stack-padding-inline-end))}&[data-unstyled]>:is([data-current],[data-previous]){inline-size:var(--popup-width,100%)}&[data-unstyled]>[data-previous]{block-size:var(--popup-height,100%)}&>[data-previous]{position:absolute;block-size:calc(var(--popup-height) - 2px - var(--vui-stack-padding-block-start) - var(--vui-stack-padding-block-end));overflow:clip;pointer-events:none;opacity:1;transition:opacity var(--vui-popover-content-fade-duration) var(--easing-standard)}&>[data-previous][data-ending-style]{opacity:0}&>[data-current]{opacity:1;transition:opacity var(--vui-popover-content-fade-duration) var(--easing-entrance)}&>[data-current][data-starting-style]{opacity:0}&[data-instant=click]>[data-current],&[data-instant=click]>[data-previous],&[data-instant=dismiss]>[data-current],&[data-instant=dismiss]>[data-previous]{transition:none}@media (prefers-reduced-motion:reduce){&>[data-current],&>[data-previous]{transition:none}&>[data-current][data-starting-style],&>[data-previous][data-ending-style]{opacity:1}}}.viraui__popover-module__CloseButton_YOe2L.viraui__popover-module__CloseButton_YOe2L{position:absolute;inset-block-start:var(--space-small);inset-inline-end:var(--space-small)}