@soroush.tech/design-system 2.0.0-rc.4 → 2.0.0-rc.5

package/dist/Sidebar/SidebarItem.cjs

@@ -1,17 +1,26 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("../src-DU81aGy9.cjs");
+const require_src = require("../src-yC1f5WR2.cjs");
 const require_utils = require("../utils.cjs");
 const require_Typography = require("../Typography.cjs");
-const require_Icon = require("../Icon-BE7bRsqR.cjs");
+const require_Icon = require("../Icon-C5Iz5ekp.cjs");
 const require_Flex = require("../Flex.cjs");
 const require_Portal = require("../Portal.cjs");
 const require_Pressable = require("../Pressable.cjs");
-const require_SidebarContext = require("../SidebarContext-jG6OioC-.cjs");
+const require_SidebarContext = require("../SidebarContext-mXrB4z8v.cjs");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
-//#region src/Sidebar/SidebarItem/SidebarItem.tsx
-const densityStyles = ({ theme, size }) => {
+// src/Sidebar/SidebarItem/SidebarItem.tsx
+const densityStyles = ({ theme, size, layout }) => {
 	const s = theme.sizes[size];
+	if (layout === "stacked") return {
+		paddingTop: theme.space[.5],
+		paddingBottom: theme.space[.5],
+		paddingLeft: 0,
+		paddingRight: 0,
+		fontSize: theme.fontSizes[0],
+		lineHeight: 1.2,
+		whiteSpace: "nowrap"
+	};
 	return {
 		paddingTop: theme.space[s.paddingTop],
 		paddingBottom: theme.space[s.paddingBottom],
@@ -22,13 +31,30 @@ const densityStyles = ({ theme, size }) => {
 		whiteSpace: "nowrap"
 	};
 };
-const layoutStyles = ({ anchor }) => ({
+const justifyFor = ({ anchor, layout }) => {
+	if (layout === "stacked") return "center";
+	return anchor === "right" ? "flex-end" : "flex-start";
+};
+const layoutStyles = (props) => ({
 	width: "100%",
 	alignItems: "center",
-	justifyContent: anchor === "right" ? "flex-end" : "flex-start"
+	justifyContent: justifyFor(props)
 });
-const stateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
+const stackedStateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
+	const { main } = theme.palette[color];
+	return {
+		border: `${theme.borderWidths.thin} solid transparent`,
+		borderRadius: theme.radii.sq,
+		color: isSelected ? main : (0, require_src.src_exports.get)(theme, "text.primary"),
+		fontWeight: isSelected ? 600 : 400,
+		"&:disabled, &[aria-disabled=\"true\"]": { opacity: .5 },
+		...disabled || itemVariant === "plain" ? {} : { "&:hover [data-sidebar-pill]": { backgroundColor: require_utils.alpha(main, isSelected ? .32 : .08) } }
+	};
+};
+const stateStyles = (props) => {
+	const { theme, color, isSelected, itemVariant, layout, disabled } = props;
 	const { main } = theme.palette[color];
+	if (layout === "stacked") return stackedStateStyles(props);
 	const outlined = itemVariant === "outlined";
 	const base = {
 		border: `${theme.borderWidths.thin} solid ${outlined ? (0, require_src.src_exports.get)(theme, "border.light") : "transparent"}`,
@@ -57,8 +83,26 @@ const stateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
 const SidebarItemRoot = require_src.styled(require_Pressable.Pressable, {
 	name: "SidebarItem",
 	label: "SidebarItem",
-	shouldForwardProp: (prop) => prop !== "anchor" && prop !== "isSelected" && prop !== "itemVariant" && prop !== "size"
+	shouldForwardProp: (prop) => prop !== "anchor" && prop !== "layout" && prop !== "isSelected" && prop !== "itemVariant" && prop !== "size"
 })(densityStyles, layoutStyles, stateStyles);
+const SidebarItemPill = require_src.styled("span", {
+	name: "SidebarItem",
+	slot: "pill",
+	label: "SidebarItemPill",
+	shouldForwardProp: (prop) => prop !== "isSelected" && prop !== "itemVariant" && prop !== "color"
+})(({ theme, color, isSelected, itemVariant }) => {
+	const { main } = theme.palette[color];
+	return {
+		display: "inline-flex",
+		alignItems: "center",
+		justifyContent: "center",
+		width: "3.5rem",
+		height: "2rem",
+		borderRadius: "1rem",
+		transition: "background-color 150ms",
+		backgroundColor: isSelected && !(itemVariant === "plain") ? require_utils.alpha(main, .24) : "transparent"
+	};
+});
 /**
 * One entry of a `Sidebar`: an icon pinned to the anchored edge, plus content
 * shown while the rail is open - the `label` by default, or custom `children`
@@ -67,8 +111,9 @@ const SidebarItemRoot = require_src.styled(require_Pressable.Pressable, {
 * here - no inherited uppercase, weight, or tracking.
 */
 function SidebarItem({ icon, label, variant, size = "sm", color = "primary", children, onSelect, onClick, isSelected, ...rest }) {
-	const { isOpen, anchor, variant: railVariant, hasPanel, panelId, panelNode, setPanelLabel } = (0, react.useContext)(require_SidebarContext.SidebarContext);
+	const { isOpen, anchor, variant: railVariant, layout, hasPanel, panelId, panelNode, setPanelLabel } = (0, react.useContext)(require_SidebarContext.SidebarContext);
 	const resolvedVariant = variant ?? railVariant;
+	const isStacked = layout === "stacked";
 	const ownsPanel = hasPanel && children != null;
 	const isPorting = ownsPanel && (isSelected ?? false);
 	(0, react.useEffect)(() => {
@@ -85,12 +130,13 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		onSelect?.();
 	};
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarItemRoot, {
-		feedback: resolvedVariant === "plain" ? "none" : "highlight",
+		feedback: resolvedVariant === "plain" || isStacked ? "none" : "highlight",
 		color,
 		size,
 		itemVariant: resolvedVariant,
 		isSelected,
 		anchor,
+		layout,
 		"aria-label": label,
 		"aria-pressed": isSelected ?? false,
 		...ownsPanel && {
@@ -99,7 +145,29 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		},
 		onClick: handleClick,
 		...rest,
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_Flex.Flex, {
+		children: isStacked ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_Flex.Flex, {
+			as: "span",
+			flexDirection: "column",
+			alignItems: "center",
+			gap: .5,
+			flexShrink: 0,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarItemPill, {
+				"data-sidebar-pill": true,
+				color,
+				isSelected,
+				itemVariant: resolvedVariant,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icon.Icon, {
+					name: icon,
+					size: "1.5rem",
+					color: "inherit"
+				})
+			}), (ownsPanel ? null : children) ?? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Typography.Typography, {
+				as: "span",
+				variant: "inherit",
+				m: 0,
+				children: label
+			})]
+		}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_Flex.Flex, {
 			as: "span",
 			flexDirection: anchor === "right" ? "row-reverse" : "row",
 			alignItems: "center",
@@ -121,5 +189,4 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		children
 	})] });
 }
-//#endregion
 exports.SidebarItem = SidebarItem;

package/dist/Sidebar/SidebarItem.d.cts

@@ -1,9 +1,8 @@
-import { nt as Theme } from "../index-XN4-ZqTB.cjs";
-import { r as IconName } from "../index-05VGk0y_.cjs";
-import { i as PressableProps } from "../index-BUeqNHjb.cjs";
-import { i as SidebarItemVariant } from "../SidebarContext-B1lWrt77.cjs";
+import { nt as Theme } from "../index-Lsm4v8fB.cjs";
+import { r as IconName } from "../index-CAt0-L4i.cjs";
+import { i as PressableProps } from "../index-Cjh607-v.cjs";
+import { i as SidebarItemVariant } from "../SidebarContext-Bod_oUMi.cjs";
 import { ReactNode } from "react";
-//#region src/Sidebar/SidebarItem/SidebarItem.d.ts
 /** Density token - controls padding and font size. Resolves against `theme.sizes`. */
 type SidebarItemSize = keyof Theme['sizes'];
 interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback' | 'activeOpacity' | 'size'> {
@@ -15,7 +14,11 @@ interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback'
   variant?: SidebarItemVariant;
   /** Padding and font size - resolves against `theme.sizes`. Default: `'sm'`. */
   size?: SidebarItemSize;
-  /** Active state - drives `aria-pressed` and the selected fill. */
+  /**
+   * Active state - drives `aria-pressed` and the selected fill. A link (an item given `href`)
+   * is marked the current page with `aria-current` by the caller instead: pass
+   * `aria-current="page"` and `aria-pressed={undefined}`, which win over the item's own.
+   */
   isSelected?: boolean;
   /**
    * Custom open-state content rendered instead of the label text (badges,
@@ -34,5 +37,4 @@ interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback'
  * here - no inherited uppercase, weight, or tracking.
  */
 declare function SidebarItem({ icon, label, variant, size, color, children, onSelect, onClick, isSelected, ...rest }: Readonly<SidebarItemProps>): import("react").JSX.Element;
-//#endregion
 export { SidebarItem, SidebarItemProps, SidebarItemSize };

package/dist/Sidebar/SidebarItem.d.mts

@@ -1,9 +1,8 @@
-import { nt as Theme } from "../index-CRQ7XLri.mjs";
-import { r as IconName } from "../index-DNj5P2NH.mjs";
-import { i as PressableProps } from "../index-CWPvdEjP.mjs";
-import { i as SidebarItemVariant } from "../SidebarContext-B1lWrt77.mjs";
+import { nt as Theme } from "../index-CR8qkP8U.mjs";
+import { r as IconName } from "../index-D48qVo1X.mjs";
+import { i as PressableProps } from "../index-CnVvfG9_.mjs";
+import { i as SidebarItemVariant } from "../SidebarContext-Bod_oUMi.mjs";
 import { ReactNode } from "react";
-//#region src/Sidebar/SidebarItem/SidebarItem.d.ts
 /** Density token - controls padding and font size. Resolves against `theme.sizes`. */
 type SidebarItemSize = keyof Theme['sizes'];
 interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback' | 'activeOpacity' | 'size'> {
@@ -15,7 +14,11 @@ interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback'
   variant?: SidebarItemVariant;
   /** Padding and font size - resolves against `theme.sizes`. Default: `'sm'`. */
   size?: SidebarItemSize;
-  /** Active state - drives `aria-pressed` and the selected fill. */
+  /**
+   * Active state - drives `aria-pressed` and the selected fill. A link (an item given `href`)
+   * is marked the current page with `aria-current` by the caller instead: pass
+   * `aria-current="page"` and `aria-pressed={undefined}`, which win over the item's own.
+   */
   isSelected?: boolean;
   /**
    * Custom open-state content rendered instead of the label text (badges,
@@ -34,5 +37,4 @@ interface SidebarItemProps extends Omit<PressableProps, 'children' | 'feedback'
  * here - no inherited uppercase, weight, or tracking.
  */
 declare function SidebarItem({ icon, label, variant, size, color, children, onSelect, onClick, isSelected, ...rest }: Readonly<SidebarItemProps>): import("react").JSX.Element;
-//#endregion
 export { SidebarItem, SidebarItemProps, SidebarItemSize };

package/dist/Sidebar/SidebarItem.mjs

@@ -1,16 +1,25 @@
-import { a as src_exports, o as styled } from "../src-DLGYOJMh.mjs";
+import { a as src_exports, o as styled } from "../src-B-rNjHIL.mjs";
 import { alpha } from "../utils.mjs";
 import { Typography } from "../Typography.mjs";
-import { t as Icon } from "../Icon-0hPpk-WZ.mjs";
+import { t as Icon } from "../Icon-XpXU-SuF.mjs";
 import { Flex } from "../Flex.mjs";
 import { Portal } from "../Portal.mjs";
 import { Pressable } from "../Pressable.mjs";
-import { t as SidebarContext } from "../SidebarContext-DgSLwjur.mjs";
+import { t as SidebarContext } from "../SidebarContext-D3bF-Q4N.mjs";
 import { useContext, useEffect } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-//#region src/Sidebar/SidebarItem/SidebarItem.tsx
-const densityStyles = ({ theme, size }) => {
+// src/Sidebar/SidebarItem/SidebarItem.tsx
+const densityStyles = ({ theme, size, layout }) => {
 	const s = theme.sizes[size];
+	if (layout === "stacked") return {
+		paddingTop: theme.space[.5],
+		paddingBottom: theme.space[.5],
+		paddingLeft: 0,
+		paddingRight: 0,
+		fontSize: theme.fontSizes[0],
+		lineHeight: 1.2,
+		whiteSpace: "nowrap"
+	};
 	return {
 		paddingTop: theme.space[s.paddingTop],
 		paddingBottom: theme.space[s.paddingBottom],
@@ -21,13 +30,30 @@ const densityStyles = ({ theme, size }) => {
 		whiteSpace: "nowrap"
 	};
 };
-const layoutStyles = ({ anchor }) => ({
+const justifyFor = ({ anchor, layout }) => {
+	if (layout === "stacked") return "center";
+	return anchor === "right" ? "flex-end" : "flex-start";
+};
+const layoutStyles = (props) => ({
 	width: "100%",
 	alignItems: "center",
-	justifyContent: anchor === "right" ? "flex-end" : "flex-start"
+	justifyContent: justifyFor(props)
 });
-const stateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
+const stackedStateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
+	const { main } = theme.palette[color];
+	return {
+		border: `${theme.borderWidths.thin} solid transparent`,
+		borderRadius: theme.radii.sq,
+		color: isSelected ? main : (0, src_exports.get)(theme, "text.primary"),
+		fontWeight: isSelected ? 600 : 400,
+		"&:disabled, &[aria-disabled=\"true\"]": { opacity: .5 },
+		...disabled || itemVariant === "plain" ? {} : { "&:hover [data-sidebar-pill]": { backgroundColor: alpha(main, isSelected ? .32 : .08) } }
+	};
+};
+const stateStyles = (props) => {
+	const { theme, color, isSelected, itemVariant, layout, disabled } = props;
 	const { main } = theme.palette[color];
+	if (layout === "stacked") return stackedStateStyles(props);
 	const outlined = itemVariant === "outlined";
 	const base = {
 		border: `${theme.borderWidths.thin} solid ${outlined ? (0, src_exports.get)(theme, "border.light") : "transparent"}`,
@@ -56,8 +82,26 @@ const stateStyles = ({ theme, color, isSelected, itemVariant, disabled }) => {
 const SidebarItemRoot = styled(Pressable, {
 	name: "SidebarItem",
 	label: "SidebarItem",
-	shouldForwardProp: (prop) => prop !== "anchor" && prop !== "isSelected" && prop !== "itemVariant" && prop !== "size"
+	shouldForwardProp: (prop) => prop !== "anchor" && prop !== "layout" && prop !== "isSelected" && prop !== "itemVariant" && prop !== "size"
 })(densityStyles, layoutStyles, stateStyles);
+const SidebarItemPill = styled("span", {
+	name: "SidebarItem",
+	slot: "pill",
+	label: "SidebarItemPill",
+	shouldForwardProp: (prop) => prop !== "isSelected" && prop !== "itemVariant" && prop !== "color"
+})(({ theme, color, isSelected, itemVariant }) => {
+	const { main } = theme.palette[color];
+	return {
+		display: "inline-flex",
+		alignItems: "center",
+		justifyContent: "center",
+		width: "3.5rem",
+		height: "2rem",
+		borderRadius: "1rem",
+		transition: "background-color 150ms",
+		backgroundColor: isSelected && !(itemVariant === "plain") ? alpha(main, .24) : "transparent"
+	};
+});
 /**
 * One entry of a `Sidebar`: an icon pinned to the anchored edge, plus content
 * shown while the rail is open - the `label` by default, or custom `children`
@@ -66,8 +110,9 @@ const SidebarItemRoot = styled(Pressable, {
 * here - no inherited uppercase, weight, or tracking.
 */
 function SidebarItem({ icon, label, variant, size = "sm", color = "primary", children, onSelect, onClick, isSelected, ...rest }) {
-	const { isOpen, anchor, variant: railVariant, hasPanel, panelId, panelNode, setPanelLabel } = useContext(SidebarContext);
+	const { isOpen, anchor, variant: railVariant, layout, hasPanel, panelId, panelNode, setPanelLabel } = useContext(SidebarContext);
 	const resolvedVariant = variant ?? railVariant;
+	const isStacked = layout === "stacked";
 	const ownsPanel = hasPanel && children != null;
 	const isPorting = ownsPanel && (isSelected ?? false);
 	useEffect(() => {
@@ -84,12 +129,13 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		onSelect?.();
 	};
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(SidebarItemRoot, {
-		feedback: resolvedVariant === "plain" ? "none" : "highlight",
+		feedback: resolvedVariant === "plain" || isStacked ? "none" : "highlight",
 		color,
 		size,
 		itemVariant: resolvedVariant,
 		isSelected,
 		anchor,
+		layout,
 		"aria-label": label,
 		"aria-pressed": isSelected ?? false,
 		...ownsPanel && {
@@ -98,7 +144,29 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		},
 		onClick: handleClick,
 		...rest,
-		children: /* @__PURE__ */ jsxs(Flex, {
+		children: isStacked ? /* @__PURE__ */ jsxs(Flex, {
+			as: "span",
+			flexDirection: "column",
+			alignItems: "center",
+			gap: .5,
+			flexShrink: 0,
+			children: [/* @__PURE__ */ jsx(SidebarItemPill, {
+				"data-sidebar-pill": true,
+				color,
+				isSelected,
+				itemVariant: resolvedVariant,
+				children: /* @__PURE__ */ jsx(Icon, {
+					name: icon,
+					size: "1.5rem",
+					color: "inherit"
+				})
+			}), (ownsPanel ? null : children) ?? /* @__PURE__ */ jsx(Typography, {
+				as: "span",
+				variant: "inherit",
+				m: 0,
+				children: label
+			})]
+		}) : /* @__PURE__ */ jsxs(Flex, {
 			as: "span",
 			flexDirection: anchor === "right" ? "row-reverse" : "row",
 			alignItems: "center",
@@ -120,5 +188,4 @@ function SidebarItem({ icon, label, variant, size = "sm", color = "primary", chi
 		children
 	})] });
 }
-//#endregion
 export { SidebarItem };

package/dist/Sidebar.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_SidebarContext = require("./SidebarContext-jG6OioC-.cjs");
+const require_SidebarContext = require("./SidebarContext-mXrB4z8v.cjs");
 const require_Sidebar_Sidebar = require("./Sidebar/Sidebar.cjs");
 const require_Sidebar_SidebarItem = require("./Sidebar/SidebarItem.cjs");
 exports.Sidebar = require_Sidebar_Sidebar.Sidebar;

package/dist/Sidebar.d.cts

@@ -1,4 +1,4 @@
-import { i as SidebarItemVariant, n as SidebarContext, r as SidebarContextValue, t as SidebarAnchor } from "./SidebarContext-B1lWrt77.cjs";
+import { a as SidebarLayout, i as SidebarItemVariant, n as SidebarContext, r as SidebarContextValue, t as SidebarAnchor } from "./SidebarContext-Bod_oUMi.cjs";
 import { Sidebar, SidebarProps } from "./Sidebar/Sidebar.cjs";
 import { SidebarItem, SidebarItemProps, SidebarItemSize } from "./Sidebar/SidebarItem.cjs";
-export { Sidebar, SidebarAnchor, SidebarContext, SidebarContextValue, SidebarItem, SidebarItemProps, SidebarItemSize, SidebarItemVariant, SidebarProps };
+export { Sidebar, SidebarAnchor, SidebarContext, SidebarContextValue, SidebarItem, SidebarItemProps, SidebarItemSize, SidebarItemVariant, SidebarLayout, SidebarProps };

package/dist/Sidebar.d.mts

@@ -1,4 +1,4 @@
-import { i as SidebarItemVariant, n as SidebarContext, r as SidebarContextValue, t as SidebarAnchor } from "./SidebarContext-B1lWrt77.mjs";
+import { a as SidebarLayout, i as SidebarItemVariant, n as SidebarContext, r as SidebarContextValue, t as SidebarAnchor } from "./SidebarContext-Bod_oUMi.mjs";
 import { Sidebar, SidebarProps } from "./Sidebar/Sidebar.mjs";
 import { SidebarItem, SidebarItemProps, SidebarItemSize } from "./Sidebar/SidebarItem.mjs";
-export { Sidebar, SidebarAnchor, SidebarContext, SidebarContextValue, SidebarItem, SidebarItemProps, SidebarItemSize, SidebarItemVariant, SidebarProps };
+export { Sidebar, SidebarAnchor, SidebarContext, SidebarContextValue, SidebarItem, SidebarItemProps, SidebarItemSize, SidebarItemVariant, SidebarLayout, SidebarProps };

package/dist/Sidebar.mjs

@@ -1,4 +1,4 @@
-import { t as SidebarContext } from "./SidebarContext-DgSLwjur.mjs";
+import { t as SidebarContext } from "./SidebarContext-D3bF-Q4N.mjs";
 import { Sidebar } from "./Sidebar/Sidebar.mjs";
 import { SidebarItem } from "./Sidebar/SidebarItem.mjs";
 export { Sidebar, SidebarContext, SidebarItem };

package/dist/{SidebarContext-B1lWrt77.d.cts → SidebarContext-Bod_oUMi.d.cts}

@@ -1,6 +1,11 @@
-//#region src/Sidebar/SidebarContext.d.ts
 /** Screen edge a `Sidebar` hugs - item labels render away from that edge. */
 type SidebarAnchor = 'left' | 'right';
+/**
+ * How a `Sidebar` lays its items out: `inline` (default) is the collapsible icon rail, a label
+ * beside its icon while open; `stacked` is a navigation rail - each label under its icon, always
+ * shown, in a rail of a fixed width.
+ */
+type SidebarLayout = 'inline' | 'stacked';
 /**
  * Visual style of a `SidebarItem`: borderless (`text`, default), `outlined`, or
  * `plain` - no fill and no hover or press feedback, so selection reads through
@@ -10,13 +15,16 @@ type SidebarItemVariant = 'outlined' | 'text' | 'plain';
 /**
  * State provided by `Sidebar` and consumed by `SidebarItem`: whether labels
  * are shown, which side the rail hugs (decides the label side), the rail-wide
- * default item variant (an item's own `variant` wins), and whether the rail
- * renders a panel column - which decides where an item's `children` go.
+ * default item variant (an item's own `variant` wins), how the items are laid
+ * out, and whether the rail renders a panel column - which decides where an
+ * item's `children` go.
  */
 interface SidebarContextValue {
   isOpen: boolean;
   anchor: SidebarAnchor;
   variant: SidebarItemVariant;
+  /** How the items are laid out - an inline row, or an icon with its label under it. */
+  layout: SidebarLayout;
   /** Whether the rail renders a panel column; items port their children into it. */
   hasPanel: boolean;
   /** `id` of the panel element, so the selected item can point `aria-controls` at it. */
@@ -33,5 +41,4 @@ interface SidebarContextValue {
   setPanelLabel?: (label: string | null) => void;
 }
 declare const SidebarContext: import("react").Context<SidebarContextValue>;
-//#endregion
-export { SidebarItemVariant as i, SidebarContext as n, SidebarContextValue as r, SidebarAnchor as t };
+export { SidebarLayout as a, SidebarItemVariant as i, SidebarContext as n, SidebarContextValue as r, SidebarAnchor as t };

package/dist/{SidebarContext-B1lWrt77.d.mts → SidebarContext-Bod_oUMi.d.mts}

@@ -1,6 +1,11 @@
-//#region src/Sidebar/SidebarContext.d.ts
 /** Screen edge a `Sidebar` hugs - item labels render away from that edge. */
 type SidebarAnchor = 'left' | 'right';
+/**
+ * How a `Sidebar` lays its items out: `inline` (default) is the collapsible icon rail, a label
+ * beside its icon while open; `stacked` is a navigation rail - each label under its icon, always
+ * shown, in a rail of a fixed width.
+ */
+type SidebarLayout = 'inline' | 'stacked';
 /**
  * Visual style of a `SidebarItem`: borderless (`text`, default), `outlined`, or
  * `plain` - no fill and no hover or press feedback, so selection reads through
@@ -10,13 +15,16 @@ type SidebarItemVariant = 'outlined' | 'text' | 'plain';
 /**
  * State provided by `Sidebar` and consumed by `SidebarItem`: whether labels
  * are shown, which side the rail hugs (decides the label side), the rail-wide
- * default item variant (an item's own `variant` wins), and whether the rail
- * renders a panel column - which decides where an item's `children` go.
+ * default item variant (an item's own `variant` wins), how the items are laid
+ * out, and whether the rail renders a panel column - which decides where an
+ * item's `children` go.
  */
 interface SidebarContextValue {
   isOpen: boolean;
   anchor: SidebarAnchor;
   variant: SidebarItemVariant;
+  /** How the items are laid out - an inline row, or an icon with its label under it. */
+  layout: SidebarLayout;
   /** Whether the rail renders a panel column; items port their children into it. */
   hasPanel: boolean;
   /** `id` of the panel element, so the selected item can point `aria-controls` at it. */
@@ -33,5 +41,4 @@ interface SidebarContextValue {
   setPanelLabel?: (label: string | null) => void;
 }
 declare const SidebarContext: import("react").Context<SidebarContextValue>;
-//#endregion
-export { SidebarItemVariant as i, SidebarContext as n, SidebarContextValue as r, SidebarAnchor as t };
+export { SidebarLayout as a, SidebarItemVariant as i, SidebarContext as n, SidebarContextValue as r, SidebarAnchor as t };

package/dist/{SidebarContext-DgSLwjur.mjs → SidebarContext-D3bF-Q4N.mjs}

@@ -1,10 +1,10 @@
 import { createContext } from "react";
-//#region src/Sidebar/SidebarContext.ts
+// src/Sidebar/SidebarContext.ts
 const SidebarContext = createContext({
 	isOpen: false,
 	anchor: "left",
 	variant: "text",
+	layout: "inline",
 	hasPanel: false
 });
-//#endregion
 export { SidebarContext as t };

package/dist/{SidebarContext-jG6OioC-.cjs → SidebarContext-mXrB4z8v.cjs}

@@ -1,11 +1,11 @@
-//#region src/Sidebar/SidebarContext.ts
+// src/Sidebar/SidebarContext.ts
 const SidebarContext = (0, require("react").createContext)({
 	isOpen: false,
 	anchor: "left",
 	variant: "text",
+	layout: "inline",
 	hasPanel: false
 });
-//#endregion
 Object.defineProperty(exports, "SidebarContext", {
 	enumerable: true,
 	get: function() {

package/dist/Skeleton.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-DU81aGy9.cjs");
+const require_src = require("./src-yC1f5WR2.cjs");
 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");
 let _emotion_react = require("@emotion/react");
-//#region src/Skeleton/Skeleton.tsx
+// src/Skeleton/Skeleton.tsx
 const shouldForwardProp = (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)([
 	..._soroush_tech_styled_system_should_forward_prop.props,
 	"variant",
@@ -78,5 +78,4 @@ function Skeleton({ variant = "text", animation = "pulse", width, height, childr
 		children: hasChildren ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HiddenContent, { children }) : null
 	});
 }
-//#endregion
 exports.Skeleton = Skeleton;

package/dist/Skeleton.d.cts

@@ -1,7 +1,6 @@
-import { nt as Theme } from "./index-XN4-ZqTB.cjs";
+import { nt as Theme } from "./index-Lsm4v8fB.cjs";
 import { HTMLAttributes } from "react";
 import { PaddingProps, SpaceProps } from "@soroush.tech/styled-system";
-//#region src/Skeleton/Skeleton.d.ts
 type SkeletonVariant = 'text' | 'circular' | 'rectangular';
 type SkeletonAnimation = 'pulse' | 'wave' | false;
 type SkeletonRadius = keyof Theme['radii'];
@@ -18,5 +17,4 @@ interface SkeletonProps extends HTMLAttributes<HTMLSpanElement>, Omit<SpaceProps
   height?: number | string;
 }
 declare function Skeleton({ variant, animation, width, height, children, ...rest }: Readonly<SkeletonProps>): import("react").JSX.Element;
-//#endregion
 export { Skeleton, SkeletonAnimation, SkeletonProps, SkeletonRadius, SkeletonVariant };

package/dist/Skeleton.d.mts

@@ -1,7 +1,6 @@
-import { nt as Theme } from "./index-CRQ7XLri.mjs";
+import { nt as Theme } from "./index-CR8qkP8U.mjs";
 import { PaddingProps, SpaceProps } from "@soroush.tech/styled-system";
 import { HTMLAttributes } from "react";
-//#region src/Skeleton/Skeleton.d.ts
 type SkeletonVariant = 'text' | 'circular' | 'rectangular';
 type SkeletonAnimation = 'pulse' | 'wave' | false;
 type SkeletonRadius = keyof Theme['radii'];
@@ -18,5 +17,4 @@ interface SkeletonProps extends HTMLAttributes<HTMLSpanElement>, Omit<SpaceProps
   height?: number | string;
 }
 declare function Skeleton({ variant, animation, width, height, children, ...rest }: Readonly<SkeletonProps>): import("react").JSX.Element;
-//#endregion
 export { Skeleton, SkeletonAnimation, SkeletonProps, SkeletonRadius, SkeletonVariant };

package/dist/Skeleton.mjs

@@ -1,7 +1,7 @@
-import { a as src_exports, i as props, o as styled, r as keyframes, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
+import { a as src_exports, i as props, o as styled, r as keyframes, t as createShouldForwardProp } from "./src-B-rNjHIL.mjs";
 import "react";
 import { jsx } from "react/jsx-runtime";
-//#region src/Skeleton/Skeleton.tsx
+// src/Skeleton/Skeleton.tsx
 const shouldForwardProp = createShouldForwardProp([
 	...props,
 	"variant",
@@ -75,5 +75,4 @@ function Skeleton({ variant = "text", animation = "pulse", width, height, childr
 		children: hasChildren ? /* @__PURE__ */ jsx(HiddenContent, { children }) : null
 	});
 }
-//#endregion
 export { Skeleton };

package/dist/Slide.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_isRtl = require("./isRtl-DTkYHRPo.cjs");
-const require_useTransitionChild = require("./useTransitionChild-CikpU0Yh.cjs");
+const require_isRtl = require("./isRtl-Dl6QQWib.cjs");
+const require_useTransitionChild = require("./useTransitionChild-COlRozbU.cjs");
 let react = require("react");
-//#region src/Slide/Slide.tsx
+// src/Slide/Slide.tsx
 const mirrored = {
 	up: "up",
 	down: "down",
@@ -47,5 +47,4 @@ function Slide({ direction = "down", ...props }) {
 		onExit: measure
 	});
 }
-//#endregion
 exports.Slide = Slide;

package/dist/Slide.d.cts

@@ -1,5 +1,4 @@
-import { n as TransitionProps } from "./useTransition-l9dv83-Y.cjs";
-//#region src/Slide/Slide.d.ts
+import { n as TransitionProps } from "./useTransition-C89K0mS7.cjs";
 /** The edge of the window the child slides in from. */
 type SlideDirection = 'up' | 'down' | 'left' | 'right';
 interface SlideProps extends TransitionProps {
@@ -13,5 +12,4 @@ interface SlideProps extends TransitionProps {
  * once.
  */
 declare function Slide({ direction, ...props }: Readonly<SlideProps>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
-//#endregion
 export { Slide, SlideDirection, SlideProps };

package/dist/Slide.d.mts

@@ -1,5 +1,4 @@
-import { n as TransitionProps } from "./useTransition-C1F7MuHO.mjs";
-//#region src/Slide/Slide.d.ts
+import { n as TransitionProps } from "./useTransition-3EoagwIe.mjs";
 /** The edge of the window the child slides in from. */
 type SlideDirection = 'up' | 'down' | 'left' | 'right';
 interface SlideProps extends TransitionProps {
@@ -13,5 +12,4 @@ interface SlideProps extends TransitionProps {
  * once.
  */
 declare function Slide({ direction, ...props }: Readonly<SlideProps>): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
-//#endregion
 export { Slide, SlideDirection, SlideProps };

package/dist/Slide.mjs

@@ -1,7 +1,7 @@
-import { t as isRtl } from "./isRtl-BJDtm86G.mjs";
-import { t as useTransitionChild } from "./useTransitionChild-Dvg9hO-F.mjs";
+import { t as isRtl } from "./isRtl-DN-EdUlg.mjs";
+import { t as useTransitionChild } from "./useTransitionChild-CFhlMm65.mjs";
 import { useRef } from "react";
-//#region src/Slide/Slide.tsx
+// src/Slide/Slide.tsx
 const mirrored = {
 	up: "up",
 	down: "down",
@@ -46,5 +46,4 @@ function Slide({ direction = "down", ...props }) {
 		onExit: measure
 	});
 }
-//#endregion
 export { Slide };