@soroush.tech/design-system 1.3.3 → 2.0.0-alpha.1

package/README.md

@@ -22,6 +22,30 @@ npm i @soroush.tech/design-system
 
 ---
 
+## Use it with AI tools
+
+An MCP server serves this library's component inventory, every component's props
+reference, and the live token contract, so an AI assistant writes against the real API
+instead of guessing:
+
+```sh
+claude mcp add --transport http soroush https://mcp.soroush.tech/mcp
+```
+
+It also runs locally over stdio (`npx -y @soroush.tech/mcp`). Claude Code users can
+install the plugin instead, which adds a house-style skill and a UI review agent on top
+of the same server:
+
+```sh
+claude plugin marketplace add soroush-tech/design-system
+claude plugin install soroush-design-system@soroush-tech
+```
+
+Any other tool can read [docs.soroush.tech/llms.txt](https://docs.soroush.tech/llms.txt).
+See [`@soroush.tech/mcp`](../mcp) for the full tool list.
+
+---
+
 ## Importing
 
 Import components by subpath, styling primitives from the barrel:
@@ -124,13 +148,14 @@ SSR critical-CSS extraction (e.g. with `@emotion/server`) is a separate, opt-in
 
 Components never hardcode colors or sizes - props resolve against scales on the `Theme` object:
 
-| Group              | Scales                                                                                                |
-| ------------------ | ----------------------------------------------------------------------------------------------------- |
-| Color              | `palette` (main/light/dark/contrastText per color) · `text` · `background` · `border` · `colorScheme` |
-| Typography         | `typography` (variant map) · `fonts` · `fontSizes` · `fontWeights` · `lineHeights` · `letterSpacings` |
-| Space & shape      | `space` · `sizes` · `radii` · `borderWidths` · `shadows`                                              |
-| Component scales   | `avatar` (size steps) · `skeleton` (wave highlight)                                                   |
-| Layering & effects | `zOrder` (appBar/drawer/modal) · `blur` · `logoFilter` · `portraitBlend` · `portraitOpacity`          |
+| Group              | Scales                                                                                                 |
+| ------------------ | ------------------------------------------------------------------------------------------------------ |
+| Color              | `palette` (main/light/dark/contrastText per color) · `text` · `background` · `border` · `colorScheme`  |
+| Typography         | `typography` (variant map) · `fonts` · `fontSizes` · `fontWeights` · `lineHeights` · `letterSpacings`  |
+| Space & shape      | `space` · `sizes` · `radii` · `borderWidths` · `shadows`                                               |
+| Layout             | `breakpoints` (xs/sm/md/lg/xl window classes) · `layout` (columns, margins, panels, top bar per class) |
+| Component scales   | `avatar` (size steps) · `skeleton` (wave highlight)                                                    |
+| Layering & effects | `zOrder` (appBar/drawer/modal) · `blur` · `logoFilter` · `portraitBlend` · `portraitOpacity`           |
 
 Prop types are derived from the interface (`keyof Theme['text']`), so adding a token to `themes.ts` propagates everywhere automatically. See [`design-system.md`](./design-system.md) for the full scale table and the palette rules.
 
@@ -162,6 +187,19 @@ const [isDark, setIsDark] = useState(true)
 
 `createTheme(base, overrides)` (exported from `@soroush.tech/design-system/theme`) is the merge primitive: plain objects recurse, arrays (`shadows`, `fontSizes`) and functions replace wholesale, `undefined` values are ignored - keys are added or replaced, never removed.
 
+### Breakpoints and layout
+
+`theme.breakpoints` are Material 3's window classes, each a range from its start until the next:
+`xs` 0-599px (compact, the base), `sm` 600-839 (medium), `md` 840-1199 (expanded), `lg`
+1200-1599 (large), `xl` 1600+ (extra-large). Responsive props use them by name or position -
+`p={{ xs: 2, md: 4 }}`, `p={[2, 3, 4]}` - and `cqSm`-style keys write container queries;
+`theme.breakpoints.up('md')` and its siblings write queries for hand-written styles. Everything is
+CSS, so pages work with JavaScript off. `theme.layout` holds the layout tokens per class (columns,
+margins, gutters, side panels, top bar); `Grid` and `Flex` apply the column grid with
+`layout` / `layout={{ lg: { columns: 16 } }}`, and apps place `AppBar`, `Sidebar` and `Drawer`
+themselves. The full guide is the
+[Breakpoints and layout](./docs/theming.md#breakpoints-and-layout) section of the theming guide.
+
 ### Component defaults
 
 Components carry visible literal fallbacks (`size = 'md'`, `variant = 'outside'`, ...) resolved through `themeDefault(theme, key, fallback)` - so every default, including behavioral variants, is overridable via the optional `theme.defaults` map or the provider's `defaults` prop:

package/dist/AppBar.d.cts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.cjs";
-import "./index-jmy5eXpx.cjs";
-import { n as FlexProps } from "./index-DOLA1VFD.cjs";
+import { T as Theme } from "./themes-CtTQTVqe.cjs";
+import "./index-CkYiijiE.cjs";
+import { n as FlexProps } from "./index-Da9Sr6v7.cjs";
 //#region src/AppBar/AppBar.d.ts
 /** Valid values for the color prop - derived from theme.background keys. */
 type AppBarColor = keyof Theme['background'];

package/dist/AppBar.d.mts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.mjs";
-import "./index-v_otepCe.mjs";
-import { n as FlexProps } from "./index-KZKeZDAF.mjs";
+import { T as Theme } from "./themes-CCguU8uo.mjs";
+import "./index-DVG64KQ4.mjs";
+import { n as FlexProps } from "./index-C-ACdUhw.mjs";
 //#region src/AppBar/AppBar.d.ts
 /** Valid values for the color prop - derived from theme.background keys. */
 type AppBarColor = keyof Theme['background'];

package/dist/Avatar.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("./src-DU81aGy9.cjs");
 const require_Flex = require("./Flex.cjs");
 const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
-const require_theme = require("./theme-Bnc03K83.cjs");
+const require_theme = require("./theme-DfAqr7qo.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _soroush_tech_styled_system_should_forward_prop = require("@soroush.tech/styled-system/should-forward-prop");

package/dist/Avatar.d.cts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.cjs";
-import "./index-jmy5eXpx.cjs";
-import { n as FlexProps } from "./index-DOLA1VFD.cjs";
+import { T as Theme } from "./themes-CtTQTVqe.cjs";
+import "./index-CkYiijiE.cjs";
+import { n as FlexProps } from "./index-Da9Sr6v7.cjs";
 //#region src/Avatar/Avatar.d.ts
 type AvatarVariant = 'circular' | 'rounded' | 'square';
 type AvatarSize = keyof Theme['avatar'];

package/dist/Avatar.d.mts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.mjs";
-import "./index-v_otepCe.mjs";
-import { n as FlexProps } from "./index-KZKeZDAF.mjs";
+import { T as Theme } from "./themes-CCguU8uo.mjs";
+import "./index-DVG64KQ4.mjs";
+import { n as FlexProps } from "./index-C-ACdUhw.mjs";
 //#region src/Avatar/Avatar.d.ts
 type AvatarVariant = 'circular' | 'rounded' | 'square';
 type AvatarSize = keyof Theme['avatar'];

package/dist/Avatar.mjs

@@ -1,7 +1,7 @@
 import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
 import { Flex } from "./Flex.mjs";
 import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
-import { r as useTheme } from "./theme-BuqqFbsz.mjs";
+import { r as useTheme } from "./theme-C1o9qa2E.mjs";
 import { useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/Avatar/Avatar.tsx

package/dist/Backdrop.d.cts

@@ -1,4 +1,4 @@
-import { s as ViewProps } from "./index-Btmdtbpb.cjs";
+import { s as ViewProps } from "./index-B2LR3Y5d.cjs";
 //#region src/Backdrop/Backdrop.d.ts
 type BackdropProps = ViewProps;
 /**

package/dist/Backdrop.d.mts

@@ -1,4 +1,4 @@
-import { s as ViewProps } from "./index-DQ16ijxx.mjs";
+import { s as ViewProps } from "./index-AlVOmB-K.mjs";
 //#region src/Backdrop/Backdrop.d.ts
 type BackdropProps = ViewProps;
 /**

package/dist/Button.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("./src-DU81aGy9.cjs");
 const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
 const require_utils = require("./utils.cjs");
-const require_theme = require("./theme-Bnc03K83.cjs");
+const require_theme = require("./theme-DfAqr7qo.cjs");
 const require_CircularProgress = require("./CircularProgress.cjs");
 const require_ButtonGroupContext = require("./ButtonGroupContext-NtkVeDVE.cjs");
 let react = require("react");

package/dist/Button.d.cts

@@ -1,2 +1,2 @@
-import { a as ButtonShape, c as GapToken, i as ButtonProps, n as ButtonColor, o as ButtonSize, r as ButtonLoadingPosition, s as ButtonVariant, t as Button } from "./index-Oxx0z4dS.cjs";
+import { a as ButtonShape, c as GapToken, i as ButtonProps, n as ButtonColor, o as ButtonSize, r as ButtonLoadingPosition, s as ButtonVariant, t as Button } from "./index-6BHvkjdp.cjs";
 export { Button, ButtonColor, ButtonLoadingPosition, ButtonProps, ButtonShape, ButtonSize, ButtonVariant, GapToken };

package/dist/Button.d.mts

@@ -1,2 +1,2 @@
-import { a as ButtonShape, c as GapToken, i as ButtonProps, n as ButtonColor, o as ButtonSize, r as ButtonLoadingPosition, s as ButtonVariant, t as Button } from "./index-C-2VKPcp.mjs";
+import { a as ButtonShape, c as GapToken, i as ButtonProps, n as ButtonColor, o as ButtonSize, r as ButtonLoadingPosition, s as ButtonVariant, t as Button } from "./index-DLtzp-Mg.mjs";
 export { Button, ButtonColor, ButtonLoadingPosition, ButtonProps, ButtonShape, ButtonSize, ButtonVariant, GapToken };

package/dist/Button.mjs

@@ -1,7 +1,7 @@
 import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
 import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
 import { alpha } from "./utils.mjs";
-import { n as useDefaultProps, r as useTheme } from "./theme-BuqqFbsz.mjs";
+import { n as useDefaultProps, r as useTheme } from "./theme-C1o9qa2E.mjs";
 import { CircularProgress } from "./CircularProgress.mjs";
 import { t as ButtonGroupContext } from "./ButtonGroupContext-DS-kl9lG.mjs";
 import { useContext } from "react";

package/dist/ButtonGroup.d.cts

@@ -1,2 +1,2 @@
-import { a as ButtonGroupProps, i as ButtonGroupOrientation, n as ButtonGroupContextValue, o as ButtonGroupRadius, r as ButtonGroup, t as ButtonGroupContext } from "./index-C5-ZM7lt.cjs";
+import { a as ButtonGroupProps, i as ButtonGroupOrientation, n as ButtonGroupContextValue, o as ButtonGroupRadius, r as ButtonGroup, t as ButtonGroupContext } from "./index-CJWXZFFZ.cjs";
 export { ButtonGroup, ButtonGroupContext, ButtonGroupContextValue, ButtonGroupOrientation, ButtonGroupProps, ButtonGroupRadius };

package/dist/ButtonGroup.d.mts

@@ -1,2 +1,2 @@
-import { a as ButtonGroupProps, i as ButtonGroupOrientation, n as ButtonGroupContextValue, o as ButtonGroupRadius, r as ButtonGroup, t as ButtonGroupContext } from "./index-DhMAwR96.mjs";
+import { a as ButtonGroupProps, i as ButtonGroupOrientation, n as ButtonGroupContextValue, o as ButtonGroupRadius, r as ButtonGroup, t as ButtonGroupContext } from "./index-CaCfFN31.mjs";
 export { ButtonGroup, ButtonGroupContext, ButtonGroupContextValue, ButtonGroupOrientation, ButtonGroupProps, ButtonGroupRadius };

package/dist/Card.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("./src-DU81aGy9.cjs");
 const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
-const require_theme = require("./theme-Bnc03K83.cjs");
+const require_theme = require("./theme-DfAqr7qo.cjs");
 const require_Paper = require("./Paper.cjs");
 const require_Typography = require("./Typography.cjs");
-const require_Icon = require("./Icon-BAMpe9SO.cjs");
+const require_Icon = require("./Icon-Cn6Zx8wb.cjs");
 require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/Card/Card.tsx

package/dist/Card.d.cts

@@ -1,6 +1,6 @@
-import { r as PaperProps } from "./index-Cf7w9Lod.cjs";
-import { a as TypographyProps } from "./index-Csp1Wzbz.cjs";
-import { n as IconProps, r as IconName } from "./index-DCu7qjpa.cjs";
+import { r as PaperProps } from "./index-OWbQXOvw.cjs";
+import { a as TypographyProps } from "./index-DClEfecw.cjs";
+import { n as IconProps, r as IconName } from "./index-wJbUPxSk.cjs";
 import { ReactNode } from "react";
 //#region src/Card/Card.d.ts
 type CardVariant = 'paper' | 'bracketBox' | 'interactive';

package/dist/Card.d.mts

@@ -1,6 +1,6 @@
-import { r as PaperProps } from "./index-BCvkP5R1.mjs";
-import { a as TypographyProps } from "./index-BWECJgSb.mjs";
-import { n as IconProps, r as IconName } from "./index-76XH-GEc.mjs";
+import { r as PaperProps } from "./index-CorVAOY7.mjs";
+import { a as TypographyProps } from "./index-COYl2TN0.mjs";
+import { n as IconProps, r as IconName } from "./index-Dyfu-Otn.mjs";
 import { ReactNode } from "react";
 //#region src/Card/Card.d.ts
 type CardVariant = 'paper' | 'bracketBox' | 'interactive';

package/dist/Card.mjs

@@ -1,9 +1,9 @@
 import { o as styled } from "./src-DLGYOJMh.mjs";
 import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
-import { n as useDefaultProps, r as useTheme } from "./theme-BuqqFbsz.mjs";
+import { n as useDefaultProps, r as useTheme } from "./theme-C1o9qa2E.mjs";
 import { Paper } from "./Paper.mjs";
 import { Typography } from "./Typography.mjs";
-import { t as Icon } from "./Icon-gSiGgU13.mjs";
+import { t as Icon } from "./Icon-BGcd6yy0.mjs";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/Card/Card.tsx

package/dist/Checkbox.d.cts

@@ -1,5 +1,5 @@
-import { d as PaletteColor, h as Theme } from "./themes-kbuYiwCi.cjs";
-import "./index-jmy5eXpx.cjs";
+import { T as Theme, x as PaletteColor } from "./themes-CtTQTVqe.cjs";
+import "./index-CkYiijiE.cjs";
 import { ChangeEvent, ReactNode } from "react";
 import { SpaceProps } from "@soroush.tech/styled-system";
 //#region src/Checkbox/Checkbox.d.ts

package/dist/Checkbox.d.mts

@@ -1,5 +1,5 @@
-import { d as PaletteColor, h as Theme } from "./themes-kbuYiwCi.mjs";
-import "./index-v_otepCe.mjs";
+import { T as Theme, x as PaletteColor } from "./themes-CCguU8uo.mjs";
+import "./index-DVG64KQ4.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 import { ChangeEvent, ReactNode } from "react";
 //#region src/Checkbox/Checkbox.d.ts

package/dist/CircularProgress.d.cts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.cjs";
-import "./index-jmy5eXpx.cjs";
-import { n as ButtonColor } from "./index-Oxx0z4dS.cjs";
+import { T as Theme } from "./themes-CtTQTVqe.cjs";
+import "./index-CkYiijiE.cjs";
+import { n as ButtonColor } from "./index-6BHvkjdp.cjs";
 import { HTMLAttributes } from "react";
 import { LayoutProps, PaddingProps, SpaceProps } from "@soroush.tech/styled-system";
 //#region src/CircularProgress/CircularProgress.d.ts

package/dist/CircularProgress.d.mts

@@ -1,6 +1,6 @@
-import { h as Theme } from "./themes-kbuYiwCi.mjs";
-import "./index-v_otepCe.mjs";
-import { n as ButtonColor } from "./index-C-2VKPcp.mjs";
+import { T as Theme } from "./themes-CCguU8uo.mjs";
+import "./index-DVG64KQ4.mjs";
+import { n as ButtonColor } from "./index-DLtzp-Mg.mjs";
 import { LayoutProps, PaddingProps, SpaceProps } from "@soroush.tech/styled-system";
 import { HTMLAttributes } from "react";
 //#region src/CircularProgress/CircularProgress.d.ts

package/dist/Drawer.cjs

@@ -1,8 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_src = require("./src-DU81aGy9.cjs");
+const require_Button = require("./Button.cjs");
 const require_Paper = require("./Paper.cjs");
-const require_Modal = require("./Modal-CApyh_V5.cjs");
-require("react");
+const require_FocusTrap = require("./FocusTrap.cjs");
+let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 let _emotion_react = require("@emotion/react");
 let _soroush_tech_styled_system_should_forward_prop = require("@soroush.tech/styled-system/should-forward-prop");
@@ -39,32 +40,123 @@ const anchorPosition = {
 		width: "100%"
 	}
 };
-const shouldForwardProp = (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)(["anchor", "duration"]);
-const DrawerPanel = require_src.styled(require_Paper.Paper, {
+const shouldForwardProp = (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)([
+	"anchor",
+	"duration",
+	"hasBackdrop"
+]);
+const DrawerPanel = require_src.styled("div", {
 	name: "Drawer",
 	label: "Drawer",
 	shouldForwardProp
-})(({ anchor, duration }) => ({
+})(({ theme, anchor, duration, hasBackdrop }) => ({
 	position: "fixed",
+	inset: "auto",
+	margin: 0,
+	padding: 0,
+	border: "none",
+	background: "transparent",
+	color: "inherit",
+	maxWidth: "100%",
+	maxHeight: "100%",
+	overflow: "visible",
 	...anchorPosition[anchor],
-	animation: `${slideIn[anchor]} ${duration}ms ease-out`,
-	"@media (prefers-reduced-motion: reduce)": { animation: "none" }
+	"&:popover-open": { animation: `${slideIn[anchor]} ${duration}ms ease-out` },
+	"&::backdrop": { backgroundColor: hasBackdrop ? theme.background.backdrop : "transparent" },
+	"@media (prefers-reduced-motion: reduce)": { "&:popover-open": { animation: "none" } }
 }));
 /**
-* @description A panel that slides in from a screen edge, built on Modal. Portals,
-* dims the page, traps focus, locks scroll, and closes on Escape or backdrop click.
+* @description A panel that slides in from a screen edge. It is an HTML `popover`: a
+* `DrawerToggle` opens it, and Escape or a click outside closes it - all without JavaScript,
+* so it works on a prerendered page with scripts off. With JavaScript it can be controlled with
+* `isOpen` / `onClose`, and it moves focus in, traps Tab and locks scroll while open.
 */
-function Drawer({ children, anchor = "left", elevation = 16, transitionDuration = 225, ...modalProps }) {
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Modal.Modal, {
-		...modalProps,
-		layer: "drawer",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DrawerPanel, {
-			anchor,
-			duration: transitionDuration,
+function Drawer({ id, children, isOpen, onClose, anchor = "left", elevation = 16, transitionDuration = 225, hasBackdrop = true, shouldLockScroll = true, shouldAutoFocus = true, shouldTrapFocus = true, shouldRestoreFocus = true }) {
+	const panelRef = (0, react.useRef)(null);
+	const [isShown, setIsShown] = (0, react.useState)(false);
+	const isShownRef = (0, react.useRef)(false);
+	const closingByProp = (0, react.useRef)(false);
+	const onCloseRef = (0, react.useRef)(onClose);
+	(0, react.useEffect)(() => {
+		onCloseRef.current = onClose;
+	}, [onClose]);
+	(0, react.useEffect)(() => {
+		const panel = panelRef.current;
+		let escaped = false;
+		const handleKeyDown = (event) => {
+			escaped = event.key === "Escape" && isShownRef.current;
+		};
+		const handleToggle = (event) => {
+			const open = event.newState === "open";
+			isShownRef.current = open;
+			setIsShown(open);
+			if (!open && !closingByProp.current) onCloseRef.current?.(event, escaped ? "escapeKey" : "dismiss");
+			closingByProp.current = false;
+			escaped = false;
+		};
+		const doc = panel.ownerDocument;
+		doc.addEventListener("keydown", handleKeyDown, true);
+		panel.addEventListener("toggle", handleToggle);
+		return () => {
+			doc.removeEventListener("keydown", handleKeyDown, true);
+			panel.removeEventListener("toggle", handleToggle);
+		};
+	}, []);
+	(0, react.useEffect)(() => {
+		if (isOpen === void 0 || isOpen === isShownRef.current) return;
+		const panel = panelRef.current;
+		isShownRef.current = isOpen;
+		if (isOpen) panel.showPopover();
+		else {
+			closingByProp.current = true;
+			panel.hidePopover();
+		}
+	}, [isOpen]);
+	(0, react.useEffect)(() => {
+		if (!isShown || !shouldLockScroll) return;
+		const { body } = panelRef.current.ownerDocument;
+		const previous = body.style.overflow;
+		body.style.overflow = "hidden";
+		return () => {
+			body.style.overflow = previous;
+		};
+	}, [isShown, shouldLockScroll]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DrawerPanel, {
+		ref: panelRef,
+		id,
+		popover: "auto",
+		anchor,
+		duration: transitionDuration,
+		hasBackdrop,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Paper.Paper, {
 			elevation,
-			children
+			width: "100%",
+			height: "100%",
+			overflow: "auto",
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FocusTrap.FocusTrap, {
+				isEnabled: isShown,
+				shouldAutoFocus,
+				shouldTrapFocus,
+				shouldEnforceFocus: false,
+				shouldRestoreFocus,
+				children
+			})
 		})
 	});
 }
 //#endregion
+//#region src/Drawer/DrawerToggle.tsx
+/**
+* @description The button that opens and closes a `Drawer`, through the HTML
+* `popovertarget` attribute - it works without JavaScript. Takes every `Button` prop.
+*/
+function DrawerToggle({ drawer, action = "toggle", ...rest }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Button.Button, {
+		popoverTarget: drawer,
+		popoverTargetAction: action,
+		...rest
+	});
+}
+//#endregion
 exports.Drawer = Drawer;
+exports.DrawerToggle = DrawerToggle;

package/dist/Drawer.d.cts

@@ -1,22 +1,58 @@
-import { n as PaperElevation } from "./index-Cf7w9Lod.cjs";
-import { s as ModalProps } from "./index-D-QRCHiS.cjs";
+import { i as ButtonProps } from "./index-6BHvkjdp.cjs";
+import { n as PaperElevation } from "./index-OWbQXOvw.cjs";
 import { ReactNode } from "react";
 //#region src/Drawer/Drawer.d.ts
 type DrawerAnchor = 'left' | 'right' | 'top' | 'bottom';
-interface DrawerProps extends Pick<ModalProps, 'isOpen' | 'onClose' | 'hasBackdrop' | 'shouldKeepMounted' | 'shouldUsePortal' | 'portalContainer' | 'shouldLockScroll' | 'shouldAutoFocus' | 'shouldTrapFocus' | 'shouldRestoreFocus'> {
+/** Why the drawer closed: the Escape key, or any other dismissal (a click outside, its toggle). */
+type DrawerCloseReason = 'escapeKey' | 'dismiss';
+interface DrawerProps {
+  /** The element id a `DrawerToggle`'s `drawer` names. */
+  id: string;
   /** The content of the drawer. */
   children: ReactNode;
+  /**
+   * Open state, for controlled use with JavaScript. Leave it out and the drawer opens and
+   * closes from its `DrawerToggle` alone - which also works with JavaScript disabled.
+   */
+  isOpen?: boolean;
+  /** Fired when the drawer closes by itself: Escape, a click outside, or its toggle. */
+  onClose?: (event: Event, reason: DrawerCloseReason) => void;
   /** Edge the drawer slides in from. Default: 'left'. */
   anchor?: DrawerAnchor;
   /** Shadow depth of the panel (0-24), forwarded to Paper. Default: 16. */
   elevation?: PaperElevation;
   /** Slide duration in milliseconds. Default: 225. */
   transitionDuration?: number;
+  /** Dim the page behind the open drawer. Default: true. */
+  hasBackdrop?: boolean;
+  /** With JavaScript: lock body scroll while open. Default: true. */
+  shouldLockScroll?: boolean;
+  /** With JavaScript: move focus into the drawer when it opens. Default: true. */
+  shouldAutoFocus?: boolean;
+  /** With JavaScript: keep Tab cycling within the open drawer. Default: true. */
+  shouldTrapFocus?: boolean;
+  /** With JavaScript: return focus to where it was when the drawer closes. Default: true. */
+  shouldRestoreFocus?: boolean;
 }
 /**
- * @description A panel that slides in from a screen edge, built on Modal. Portals,
- * dims the page, traps focus, locks scroll, and closes on Escape or backdrop click.
+ * @description A panel that slides in from a screen edge. It is an HTML `popover`: a
+ * `DrawerToggle` opens it, and Escape or a click outside closes it - all without JavaScript,
+ * so it works on a prerendered page with scripts off. With JavaScript it can be controlled with
+ * `isOpen` / `onClose`, and it moves focus in, traps Tab and locks scroll while open.
  */
-declare function Drawer({ children, anchor, elevation, transitionDuration, ...modalProps }: Readonly<DrawerProps>): import("react").JSX.Element;
+declare function Drawer({ id, children, isOpen, onClose, anchor, elevation, transitionDuration, hasBackdrop, shouldLockScroll, shouldAutoFocus, shouldTrapFocus, shouldRestoreFocus }: Readonly<DrawerProps>): import("react").JSX.Element;
 //#endregion
-export { Drawer, DrawerAnchor, DrawerProps };
+//#region src/Drawer/DrawerToggle.d.ts
+interface DrawerToggleProps extends Omit<ButtonProps, 'href'> {
+  /** The `id` of the `Drawer` this button opens and closes. */
+  drawer: string;
+  /** What a click does to the drawer. Default: 'toggle'. */
+  action?: 'toggle' | 'show' | 'hide';
+}
+/**
+ * @description The button that opens and closes a `Drawer`, through the HTML
+ * `popovertarget` attribute - it works without JavaScript. Takes every `Button` prop.
+ */
+declare function DrawerToggle({ drawer, action, ...rest }: Readonly<DrawerToggleProps>): import("react").JSX.Element;
+//#endregion
+export { Drawer, DrawerAnchor, DrawerCloseReason, DrawerProps, DrawerToggle, DrawerToggleProps };

package/dist/Drawer.d.mts

@@ -1,22 +1,58 @@
-import { n as PaperElevation } from "./index-BCvkP5R1.mjs";
-import { s as ModalProps } from "./index-CTVFwvju.mjs";
+import { i as ButtonProps } from "./index-DLtzp-Mg.mjs";
+import { n as PaperElevation } from "./index-CorVAOY7.mjs";
 import { ReactNode } from "react";
 //#region src/Drawer/Drawer.d.ts
 type DrawerAnchor = 'left' | 'right' | 'top' | 'bottom';
-interface DrawerProps extends Pick<ModalProps, 'isOpen' | 'onClose' | 'hasBackdrop' | 'shouldKeepMounted' | 'shouldUsePortal' | 'portalContainer' | 'shouldLockScroll' | 'shouldAutoFocus' | 'shouldTrapFocus' | 'shouldRestoreFocus'> {
+/** Why the drawer closed: the Escape key, or any other dismissal (a click outside, its toggle). */
+type DrawerCloseReason = 'escapeKey' | 'dismiss';
+interface DrawerProps {
+  /** The element id a `DrawerToggle`'s `drawer` names. */
+  id: string;
   /** The content of the drawer. */
   children: ReactNode;
+  /**
+   * Open state, for controlled use with JavaScript. Leave it out and the drawer opens and
+   * closes from its `DrawerToggle` alone - which also works with JavaScript disabled.
+   */
+  isOpen?: boolean;
+  /** Fired when the drawer closes by itself: Escape, a click outside, or its toggle. */
+  onClose?: (event: Event, reason: DrawerCloseReason) => void;
   /** Edge the drawer slides in from. Default: 'left'. */
   anchor?: DrawerAnchor;
   /** Shadow depth of the panel (0-24), forwarded to Paper. Default: 16. */
   elevation?: PaperElevation;
   /** Slide duration in milliseconds. Default: 225. */
   transitionDuration?: number;
+  /** Dim the page behind the open drawer. Default: true. */
+  hasBackdrop?: boolean;
+  /** With JavaScript: lock body scroll while open. Default: true. */
+  shouldLockScroll?: boolean;
+  /** With JavaScript: move focus into the drawer when it opens. Default: true. */
+  shouldAutoFocus?: boolean;
+  /** With JavaScript: keep Tab cycling within the open drawer. Default: true. */
+  shouldTrapFocus?: boolean;
+  /** With JavaScript: return focus to where it was when the drawer closes. Default: true. */
+  shouldRestoreFocus?: boolean;
 }
 /**
- * @description A panel that slides in from a screen edge, built on Modal. Portals,
- * dims the page, traps focus, locks scroll, and closes on Escape or backdrop click.
+ * @description A panel that slides in from a screen edge. It is an HTML `popover`: a
+ * `DrawerToggle` opens it, and Escape or a click outside closes it - all without JavaScript,
+ * so it works on a prerendered page with scripts off. With JavaScript it can be controlled with
+ * `isOpen` / `onClose`, and it moves focus in, traps Tab and locks scroll while open.
  */
-declare function Drawer({ children, anchor, elevation, transitionDuration, ...modalProps }: Readonly<DrawerProps>): import("react").JSX.Element;
+declare function Drawer({ id, children, isOpen, onClose, anchor, elevation, transitionDuration, hasBackdrop, shouldLockScroll, shouldAutoFocus, shouldTrapFocus, shouldRestoreFocus }: Readonly<DrawerProps>): import("react").JSX.Element;
 //#endregion
-export { Drawer, DrawerAnchor, DrawerProps };
+//#region src/Drawer/DrawerToggle.d.ts
+interface DrawerToggleProps extends Omit<ButtonProps, 'href'> {
+  /** The `id` of the `Drawer` this button opens and closes. */
+  drawer: string;
+  /** What a click does to the drawer. Default: 'toggle'. */
+  action?: 'toggle' | 'show' | 'hide';
+}
+/**
+ * @description The button that opens and closes a `Drawer`, through the HTML
+ * `popovertarget` attribute - it works without JavaScript. Takes every `Button` prop.
+ */
+declare function DrawerToggle({ drawer, action, ...rest }: Readonly<DrawerToggleProps>): import("react").JSX.Element;
+//#endregion
+export { Drawer, DrawerAnchor, DrawerCloseReason, DrawerProps, DrawerToggle, DrawerToggleProps };