@soroush.tech/design-system 0.1.0 → 1.1.0

package/dist/Quote.d.mts

@@ -1,2 +1,14 @@
-import { n as QuoteProps, t as Quote } from "./index-Des8BisQ.mjs";
+import { h as Theme } from "./themes-CUV79qWU.mjs";
+import "./index-D8b5OCLe.mjs";
+import { s as ViewProps } from "./index-q6EgsH9R.mjs";
+//#region src/Quote/Quote.d.ts
+type QuoteProps = ViewProps;
+/** A View with a 2px primary left-border — used for terminal readouts and markdown blockquotes. */
+declare const Quote: import("@emotion/styled").StyledComponent<Pick<{
+  theme?: Theme;
+  as?: React.ElementType;
+} & ViewProps & import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement>, "p" | "slot" | "style" | "title" | "ref" | "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onScrollEnd" | "onScrollEndCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onToggle" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture" | "aspectRatio" | "borderBottomColor" | "borderBottomLeftRadius" | "borderBottomRightRadius" | "borderBottomStyle" | "borderBottomWidth" | "borderLeftColor" | "borderLeftStyle" | "borderLeftWidth" | "borderRightColor" | "borderRightStyle" | "borderRightWidth" | "borderTopColor" | "borderTopLeftRadius" | "borderTopRightRadius" | "borderTopStyle" | "borderTopWidth" | "bottom" | "columnGap" | "cursor" | "display" | "fontFamily" | "fontSize" | "fontStyle" | "fontWeight" | "height" | "left" | "letterSpacing" | "lineHeight" | "marginBottom" | "marginLeft" | "marginRight" | "marginTop" | "maxHeight" | "maxWidth" | "minHeight" | "minWidth" | "opacity" | "order" | "overflowX" | "overflowY" | "paddingBottom" | "paddingLeft" | "paddingRight" | "paddingTop" | "position" | "right" | "rowGap" | "textAlign" | "textAlignLast" | "textDecorationColor" | "textDecorationLine" | "textDecorationStyle" | "textDecorationThickness" | "textOverflow" | "textTransform" | "top" | "verticalAlign" | "whiteSpace" | "width" | "zIndex" | "border" | "borderBottom" | "borderColor" | "borderLeft" | "borderRadius" | "borderRight" | "borderStyle" | "borderTop" | "borderWidth" | "gap" | "margin" | "overflow" | "padding" | "textDecoration" | "borderX" | "borderY" | "theme" | "as" | "bg" | "m" | "mt" | "mr" | "mb" | "ml" | "mx" | "marginX" | "my" | "marginY" | "pt" | "pr" | "pb" | "pl" | "px" | "paddingX" | "py" | "paddingY" | "size"> & {
+  theme?: Theme;
+}, {}, {}>;
+//#endregion
 export { Quote, QuoteProps };

package/dist/Quote.mjs

@@ -1,4 +1,4 @@
-import { d as styled } from "./src-DcNT2aIK.mjs";
+import { o as styled } from "./src-BJy4dM4f.mjs";
 import { View } from "./View.mjs";
 //#region src/Quote/Quote.tsx
 /** A View with a 2px primary left-border — used for terminal readouts and markdown blockquotes. */

package/dist/Radio.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-BiocWFSR.cjs");
-const require_themeDefault = require("./themeDefault-B-QjpGEO.cjs");
+const require_src = require("./src-C8PIppTy.cjs");
+const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
 const require_FormControl = require("./FormControl.cjs");
 require("react");
 let react_jsx_runtime = require("react/jsx-runtime");

package/dist/Radio.d.cts

@@ -1,5 +1,5 @@
-import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
-import { l as PaletteColor } from "./themes-D81JYbqm.cjs";
+import { r as index_d_exports } from "./index-DLJ-li1B.cjs";
+import { d as PaletteColor, h as Theme } from "./themes-CUV79qWU.cjs";
 import { ChangeEvent, InputHTMLAttributes, ReactNode } from "react";
 //#region src/Radio/Radio.d.ts
 type RadioColor = PaletteColor;

package/dist/Radio.d.mts

@@ -1,5 +1,5 @@
-import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
-import { l as PaletteColor } from "./themes-D1SAp3SL.mjs";
+import { d as PaletteColor, h as Theme } from "./themes-CUV79qWU.mjs";
+import { r as index_d_exports } from "./index-D8b5OCLe.mjs";
 import { ChangeEvent, InputHTMLAttributes, ReactNode } from "react";
 //#region src/Radio/Radio.d.ts
 type RadioColor = PaletteColor;

package/dist/Radio.mjs

@@ -1,5 +1,5 @@
-import { a as createShouldForwardProp, c as props, d as styled, l as src_exports } from "./src-DcNT2aIK.mjs";
-import { t as themeDefault } from "./themeDefault-CjXaY3ok.mjs";
+import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-BJy4dM4f.mjs";
+import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
 import { useFormControl } from "./FormControl.mjs";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/Select.cjs

@@ -1,14 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_src = require("./src-BiocWFSR.cjs");
-const require_themeDefault = require("./themeDefault-B-QjpGEO.cjs");
-const require_Icon = require("./Icon-1YtNCUKo.cjs");
+const require_src = require("./src-C8PIppTy.cjs");
+const require_themeDefault = require("./themeDefault-Cebi08Cv.cjs");
+const require_theme = require("./theme-Du6xgPsg.cjs");
+const require_Icon = require("./Icon-BOjk5r39.cjs");
 const require_FormControl = require("./FormControl.cjs");
+const require_inputVariantStyles = require("./inputVariantStyles-BBkkYQtE.cjs");
 const require_NativeSelect = require("./NativeSelect.cjs");
-const require_Popover = require("./Popover-CRDLmywF.cjs");
+const require_Popover = require("./Popover-pEVboMZO.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");
-let _emotion_react = require("@emotion/react");
 //#region src/Select/hooks/useSelectPopover.ts
 /**
 * Owns `Select`'s open state (controlled or uncontrolled) and fires the open/close
@@ -129,30 +130,6 @@ const baseStyle = ({ theme }) => ({
 	textAlign: "left",
 	transition: "border-color 0.15s ease"
 });
-const variantStyles = (0, require_src.src_exports.variant)({
-	prop: "variant",
-	variants: {
-		outlined: {
-			borderRadius: "sq",
-			borderWidth: "thin",
-			borderStyle: "solid"
-		},
-		default: {
-			borderRadius: "sq",
-			borderStyle: "none"
-		},
-		underline: {
-			borderRadius: "sq",
-			borderStyle: "none",
-			borderBottomWidth: "thin",
-			borderBottomStyle: "solid"
-		},
-		text: {
-			borderRadius: "sq",
-			borderStyle: "none"
-		}
-	}
-});
 const borderRadiusStyle = ({ variant: v, borderRadius, theme }) => {
 	if (v === "underline" || v === "text" || !borderRadius) return {};
 	return { borderRadius: (0, require_src.src_exports.get)(theme, `radii.${borderRadius}`) };
@@ -160,11 +137,12 @@ const borderRadiusStyle = ({ variant: v, borderRadius, theme }) => {
 const colorBorder = ({ color, error, theme }) => ({ borderColor: error ? (0, require_src.src_exports.get)(theme, "palette.error.main") : (0, require_src.src_exports.get)(theme, `palette.${color}.light`) });
 const activeBorder = ({ color, error, open, theme }) => {
 	const activeColor = error ? (0, require_src.src_exports.get)(theme, "palette.error.main") : (0, require_src.src_exports.get)(theme, `palette.${color}.main`);
+	const focusColor = (0, require_src.src_exports.get)(theme, `palette.${require_themeDefault.themeDefault(theme, "color", "primary")}.main`);
 	return {
 		...open ? { borderColor: activeColor } : {},
 		"&:focus": { borderColor: activeColor },
 		"&:focus-visible": {
-			outline: `2px solid ${(0, require_src.src_exports.get)(theme, `palette.${require_themeDefault.themeDefault(theme, "color", "primary")}.main`)}`,
+			outline: `2px solid ${focusColor}`,
 			outlineOffset: "2px"
 		}
 	};
@@ -205,7 +183,7 @@ const Trigger = require_src.styled("div", {
 		minWidth: true,
 		maxWidth: true
 	})]
-})(baseStyle, variantStyles, borderRadiusStyle, colorBorder, activeBorder, backgroundStyle, sizeVariants, layoutStyles);
+})(baseStyle, require_inputVariantStyles.inputVariantStyles, borderRadiusStyle, colorBorder, activeBorder, backgroundStyle, sizeVariants, layoutStyles);
 const ValueArea = require_src.styled("span", {
 	name: "Select",
 	slot: "valueArea",
@@ -263,7 +241,7 @@ function Select({ children, native = false, multiple = false, autoWidth = false,
 		textColor: textColorProp
 	});
 	const { id, error, disabled, required, size, fullWidth } = fc;
-	const theme = (0, _emotion_react.useTheme)();
+	const theme = require_theme.useTheme();
 	const color = fc.color ?? require_themeDefault.themeDefault(theme, "color", "primary");
 	const bg = bgProp ?? require_themeDefault.themeDefault(theme, "inputBg", "terminal");
 	const variant = variantProp ?? require_themeDefault.themeDefault(theme, "inputVariant", "default");

package/dist/Select.d.cts

@@ -1,5 +1,6 @@
-import { l as index_d_exports, o as Theme } from "./index-Bihpwn75.cjs";
-import { n as IconProps, r as IconName } from "./index-Dp81rWM1.cjs";
+import { r as index_d_exports } from "./index-DLJ-li1B.cjs";
+import { h as Theme } from "./themes-CUV79qWU.cjs";
+import { n as IconProps, r as IconName } from "./index-CA_X-mXg.cjs";
 import { ReactNode } from "react";
 //#region src/Select/utils/isOptionSelected.d.ts
 /** The union of value shapes `Select` holds: a single value, or an array in multiple mode. */

package/dist/Select.d.mts

@@ -1,5 +1,6 @@
-import { l as index_d_exports, o as Theme } from "./index-Dm9HfgV6.mjs";
-import { n as IconProps, r as IconName } from "./index-BLfFycfJ.mjs";
+import { h as Theme } from "./themes-CUV79qWU.mjs";
+import { r as index_d_exports } from "./index-D8b5OCLe.mjs";
+import { n as IconProps, r as IconName } from "./index-BL3jwIQU.mjs";
 import { ReactNode } from "react";
 //#region src/Select/utils/isOptionSelected.d.ts
 /** The union of value shapes `Select` holds: a single value, or an array in multiple mode. */

package/dist/Select.mjs

@@ -1,9 +1,11 @@
-import { a as createShouldForwardProp, c as props, d as styled, l as src_exports, u as useTheme } from "./src-DcNT2aIK.mjs";
-import { t as themeDefault } from "./themeDefault-CjXaY3ok.mjs";
-import { t as Icon } from "./Icon-CAKRmFz3.mjs";
+import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-BJy4dM4f.mjs";
+import { t as themeDefault } from "./themeDefault-Z3KmyIbm.mjs";
+import { r as useTheme } from "./theme-V6lYzd3j.mjs";
+import { t as Icon } from "./Icon-CYjD0Bad.mjs";
 import { useFormControl } from "./FormControl.mjs";
+import { t as inputVariantStyles } from "./inputVariantStyles-CcqpGfuP.mjs";
 import { NativeSelect } from "./NativeSelect.mjs";
-import { t as Popover } from "./Popover-B61J7C79.mjs";
+import { t as Popover } from "./Popover-Chgtjn-N.mjs";
 import { Children, cloneElement, isValidElement, useCallback, useId, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/Select/hooks/useSelectPopover.ts
@@ -126,30 +128,6 @@ const baseStyle = ({ theme }) => ({
 	textAlign: "left",
 	transition: "border-color 0.15s ease"
 });
-const variantStyles = (0, src_exports.variant)({
-	prop: "variant",
-	variants: {
-		outlined: {
-			borderRadius: "sq",
-			borderWidth: "thin",
-			borderStyle: "solid"
-		},
-		default: {
-			borderRadius: "sq",
-			borderStyle: "none"
-		},
-		underline: {
-			borderRadius: "sq",
-			borderStyle: "none",
-			borderBottomWidth: "thin",
-			borderBottomStyle: "solid"
-		},
-		text: {
-			borderRadius: "sq",
-			borderStyle: "none"
-		}
-	}
-});
 const borderRadiusStyle = ({ variant: v, borderRadius, theme }) => {
 	if (v === "underline" || v === "text" || !borderRadius) return {};
 	return { borderRadius: (0, src_exports.get)(theme, `radii.${borderRadius}`) };
@@ -157,11 +135,12 @@ const borderRadiusStyle = ({ variant: v, borderRadius, theme }) => {
 const colorBorder = ({ color, error, theme }) => ({ borderColor: error ? (0, src_exports.get)(theme, "palette.error.main") : (0, src_exports.get)(theme, `palette.${color}.light`) });
 const activeBorder = ({ color, error, open, theme }) => {
 	const activeColor = error ? (0, src_exports.get)(theme, "palette.error.main") : (0, src_exports.get)(theme, `palette.${color}.main`);
+	const focusColor = (0, src_exports.get)(theme, `palette.${themeDefault(theme, "color", "primary")}.main`);
 	return {
 		...open ? { borderColor: activeColor } : {},
 		"&:focus": { borderColor: activeColor },
 		"&:focus-visible": {
-			outline: `2px solid ${(0, src_exports.get)(theme, `palette.${themeDefault(theme, "color", "primary")}.main`)}`,
+			outline: `2px solid ${focusColor}`,
 			outlineOffset: "2px"
 		}
 	};
@@ -202,7 +181,7 @@ const Trigger = styled("div", {
 		minWidth: true,
 		maxWidth: true
 	})]
-})(baseStyle, variantStyles, borderRadiusStyle, colorBorder, activeBorder, backgroundStyle, sizeVariants, layoutStyles);
+})(baseStyle, inputVariantStyles, borderRadiusStyle, colorBorder, activeBorder, backgroundStyle, sizeVariants, layoutStyles);
 const ValueArea = styled("span", {
 	name: "Select",
 	slot: "valueArea",

package/dist/Sidebar/Sidebar.cjs

@@ -0,0 +1,94 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("../src-C8PIppTy.cjs");
+const require_Flex = require("../Flex.cjs");
+const require_SidebarContext = require("../SidebarContext-jG6OioC-.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/Sidebar/Sidebar/Sidebar.tsx
+const SidebarRoot = require_src.styled(require_Flex.Flex, {
+	name: "Sidebar",
+	label: "Sidebar"
+})({ minHeight: 0 });
+const SidebarRail = require_src.styled(require_Flex.Flex, {
+	name: "Sidebar",
+	slot: "rail",
+	label: "SidebarRail",
+	shouldForwardProp: (prop) => prop !== "isOpen" && prop !== "expandedWidth" && prop !== "collapsedWidth"
+})(({ isOpen, expandedWidth, collapsedWidth }) => ({
+	width: isOpen ? expandedWidth : collapsedWidth,
+	transition: "width 200ms ease",
+	overflowX: "hidden",
+	"@media (prefers-reduced-motion: reduce)": { transition: "none" }
+}));
+const SidebarPanelRoot = require_src.styled(require_Flex.Flex, {
+	name: "Sidebar",
+	slot: "panel",
+	label: "SidebarPanel"
+})({
+	flexDirection: "column",
+	minHeight: 0,
+	overflow: "auto",
+	"&:empty": { display: "none" }
+});
+/**
+* A collapsible vertical icon rail: collapsed it shows icon-only items; open
+* it also shows each item's label, rendered away from the anchored edge.
+* Purely controlled via `isOpen` — pair it with a menu button wherever your
+* layout keeps one (usually the app bar). Children consume the state through
+* `SidebarContext`, and any `Flex` prop (`bg`, spacing, …) applies to the rail.
+*
+* With `hasPanel`, the rail gains a second column and the selected item's
+* `children` render there instead of inside its row — an icon rail beside a
+* detail panel. The panel appears only when the selected item has children, and
+* is independent of `isOpen`, so a collapsed icons-only rail can sit beside an
+* open panel.
+*/
+function Sidebar({ children, isOpen, anchor = "left", variant = "text", expandedWidth = "14rem", collapsedWidth = "3.5rem", hasPanel = false, panelWidth = "18rem", panelProps, "aria-label": ariaLabel, ...rest }) {
+	const panelId = (0, react.useId)();
+	const [panelNode, setPanelNode] = (0, react.useState)(null);
+	const [panelLabel, setPanelLabel] = (0, react.useState)(null);
+	const context = (0, react.useMemo)(() => ({
+		isOpen,
+		anchor,
+		variant,
+		hasPanel,
+		panelId,
+		panelNode,
+		setPanelLabel
+	}), [
+		isOpen,
+		anchor,
+		variant,
+		hasPanel,
+		panelId,
+		panelNode
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(SidebarRoot, {
+		as: "nav",
+		"aria-label": ariaLabel,
+		flexDirection: anchor === "right" ? "row-reverse" : "row",
+		flexShrink: 0,
+		...rest,
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarRail, {
+			flexDirection: "column",
+			gap: 1,
+			flexShrink: 0,
+			isOpen,
+			expandedWidth,
+			collapsedWidth,
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_SidebarContext.SidebarContext.Provider, {
+				value: context,
+				children
+			})
+		}), hasPanel && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SidebarPanelRoot, {
+			as: "section",
+			width: panelWidth,
+			"aria-label": panelLabel ?? void 0,
+			...panelProps,
+			ref: setPanelNode,
+			id: panelId
+		})]
+	});
+}
+//#endregion
+exports.Sidebar = Sidebar;

package/dist/Sidebar/Sidebar.d.cts

@@ -0,0 +1,59 @@
+import { n as FlexProps } from "../index-zFYi0f1t.cjs";
+import { i as SidebarItemVariant, t as SidebarAnchor } from "../SidebarContext-ao6lRfTX.cjs";
+import { ElementType, ReactNode } from "react";
+//#region src/Sidebar/Sidebar/Sidebar.d.ts
+interface SidebarProps extends FlexProps {
+  /**
+   * Rail contents — `SidebarItem`s, but any node composes (a sponsor logo,
+   * a footer, dividers, …). Items read the open state from `SidebarContext`.
+   */
+  children: ReactNode;
+  /**
+   * Whether item labels are shown. Controlled — the toggle lives with the
+   * consumer (typically a menu button in the app bar).
+   */
+  isOpen: boolean;
+  /** Screen edge the rail hugs — labels render away from it. Default: `'left'`. */
+  anchor?: SidebarAnchor;
+  /** Default variant for every item — an item's own `variant` wins. Default: `'text'`. */
+  variant?: SidebarItemVariant;
+  /** Rail width while open. Default: `'14rem'`. */
+  expandedWidth?: string;
+  /** Rail width while collapsed (icons only). Default: `'3.5rem'`. */
+  collapsedWidth?: string;
+  /**
+   * Render a second column beside the rail holding the selected item's
+   * `children`. Off by default, where children render inline in the item row
+   * instead. Default: `false`.
+   */
+  hasPanel?: boolean;
+  /** Width of the panel column. Only meaningful with `hasPanel`. Default: `'18rem'`. */
+  panelWidth?: string;
+  /**
+   * Props for the panel column — any `Flex` prop, plus `as` to change its
+   * element. Overrides `panelWidth` and the derived `aria-label`; its `id` and
+   * ref stay owned by the rail, which needs them as the port target and the
+   * `aria-controls` anchor.
+   */
+  panelProps?: Omit<FlexProps, 'children' | 'id'> & {
+    as?: ElementType;
+  };
+  /** Accessible name of the navigation landmark — required so multiple navs stay distinguishable. */
+  'aria-label': string;
+}
+/**
+ * A collapsible vertical icon rail: collapsed it shows icon-only items; open
+ * it also shows each item's label, rendered away from the anchored edge.
+ * Purely controlled via `isOpen` — pair it with a menu button wherever your
+ * layout keeps one (usually the app bar). Children consume the state through
+ * `SidebarContext`, and any `Flex` prop (`bg`, spacing, …) applies to the rail.
+ *
+ * With `hasPanel`, the rail gains a second column and the selected item's
+ * `children` render there instead of inside its row — an icon rail beside a
+ * detail panel. The panel appears only when the selected item has children, and
+ * is independent of `isOpen`, so a collapsed icons-only rail can sit beside an
+ * open panel.
+ */
+declare function Sidebar({ children, isOpen, anchor, variant, expandedWidth, collapsedWidth, hasPanel, panelWidth, panelProps, 'aria-label': ariaLabel, ...rest }: Readonly<SidebarProps>): import("react").JSX.Element;
+//#endregion
+export { Sidebar, SidebarProps };

package/dist/Sidebar/Sidebar.d.mts

@@ -0,0 +1,59 @@
+import { n as FlexProps } from "../index-DEv2QslH.mjs";
+import { i as SidebarItemVariant, t as SidebarAnchor } from "../SidebarContext-ao6lRfTX.mjs";
+import { ElementType, ReactNode } from "react";
+//#region src/Sidebar/Sidebar/Sidebar.d.ts
+interface SidebarProps extends FlexProps {
+  /**
+   * Rail contents — `SidebarItem`s, but any node composes (a sponsor logo,
+   * a footer, dividers, …). Items read the open state from `SidebarContext`.
+   */
+  children: ReactNode;
+  /**
+   * Whether item labels are shown. Controlled — the toggle lives with the
+   * consumer (typically a menu button in the app bar).
+   */
+  isOpen: boolean;
+  /** Screen edge the rail hugs — labels render away from it. Default: `'left'`. */
+  anchor?: SidebarAnchor;
+  /** Default variant for every item — an item's own `variant` wins. Default: `'text'`. */
+  variant?: SidebarItemVariant;
+  /** Rail width while open. Default: `'14rem'`. */
+  expandedWidth?: string;
+  /** Rail width while collapsed (icons only). Default: `'3.5rem'`. */
+  collapsedWidth?: string;
+  /**
+   * Render a second column beside the rail holding the selected item's
+   * `children`. Off by default, where children render inline in the item row
+   * instead. Default: `false`.
+   */
+  hasPanel?: boolean;
+  /** Width of the panel column. Only meaningful with `hasPanel`. Default: `'18rem'`. */
+  panelWidth?: string;
+  /**
+   * Props for the panel column — any `Flex` prop, plus `as` to change its
+   * element. Overrides `panelWidth` and the derived `aria-label`; its `id` and
+   * ref stay owned by the rail, which needs them as the port target and the
+   * `aria-controls` anchor.
+   */
+  panelProps?: Omit<FlexProps, 'children' | 'id'> & {
+    as?: ElementType;
+  };
+  /** Accessible name of the navigation landmark — required so multiple navs stay distinguishable. */
+  'aria-label': string;
+}
+/**
+ * A collapsible vertical icon rail: collapsed it shows icon-only items; open
+ * it also shows each item's label, rendered away from the anchored edge.
+ * Purely controlled via `isOpen` — pair it with a menu button wherever your
+ * layout keeps one (usually the app bar). Children consume the state through
+ * `SidebarContext`, and any `Flex` prop (`bg`, spacing, …) applies to the rail.
+ *
+ * With `hasPanel`, the rail gains a second column and the selected item's
+ * `children` render there instead of inside its row — an icon rail beside a
+ * detail panel. The panel appears only when the selected item has children, and
+ * is independent of `isOpen`, so a collapsed icons-only rail can sit beside an
+ * open panel.
+ */
+declare function Sidebar({ children, isOpen, anchor, variant, expandedWidth, collapsedWidth, hasPanel, panelWidth, panelProps, 'aria-label': ariaLabel, ...rest }: Readonly<SidebarProps>): import("react").JSX.Element;
+//#endregion
+export { Sidebar, SidebarProps };

package/dist/Sidebar/Sidebar.mjs

@@ -0,0 +1,93 @@
+import { o as styled } from "../src-BJy4dM4f.mjs";
+import { Flex } from "../Flex.mjs";
+import { t as SidebarContext } from "../SidebarContext-DgSLwjur.mjs";
+import { useId, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/Sidebar/Sidebar/Sidebar.tsx
+const SidebarRoot = styled(Flex, {
+	name: "Sidebar",
+	label: "Sidebar"
+})({ minHeight: 0 });
+const SidebarRail = styled(Flex, {
+	name: "Sidebar",
+	slot: "rail",
+	label: "SidebarRail",
+	shouldForwardProp: (prop) => prop !== "isOpen" && prop !== "expandedWidth" && prop !== "collapsedWidth"
+})(({ isOpen, expandedWidth, collapsedWidth }) => ({
+	width: isOpen ? expandedWidth : collapsedWidth,
+	transition: "width 200ms ease",
+	overflowX: "hidden",
+	"@media (prefers-reduced-motion: reduce)": { transition: "none" }
+}));
+const SidebarPanelRoot = styled(Flex, {
+	name: "Sidebar",
+	slot: "panel",
+	label: "SidebarPanel"
+})({
+	flexDirection: "column",
+	minHeight: 0,
+	overflow: "auto",
+	"&:empty": { display: "none" }
+});
+/**
+* A collapsible vertical icon rail: collapsed it shows icon-only items; open
+* it also shows each item's label, rendered away from the anchored edge.
+* Purely controlled via `isOpen` — pair it with a menu button wherever your
+* layout keeps one (usually the app bar). Children consume the state through
+* `SidebarContext`, and any `Flex` prop (`bg`, spacing, …) applies to the rail.
+*
+* With `hasPanel`, the rail gains a second column and the selected item's
+* `children` render there instead of inside its row — an icon rail beside a
+* detail panel. The panel appears only when the selected item has children, and
+* is independent of `isOpen`, so a collapsed icons-only rail can sit beside an
+* open panel.
+*/
+function Sidebar({ children, isOpen, anchor = "left", variant = "text", expandedWidth = "14rem", collapsedWidth = "3.5rem", hasPanel = false, panelWidth = "18rem", panelProps, "aria-label": ariaLabel, ...rest }) {
+	const panelId = useId();
+	const [panelNode, setPanelNode] = useState(null);
+	const [panelLabel, setPanelLabel] = useState(null);
+	const context = useMemo(() => ({
+		isOpen,
+		anchor,
+		variant,
+		hasPanel,
+		panelId,
+		panelNode,
+		setPanelLabel
+	}), [
+		isOpen,
+		anchor,
+		variant,
+		hasPanel,
+		panelId,
+		panelNode
+	]);
+	return /* @__PURE__ */ jsxs(SidebarRoot, {
+		as: "nav",
+		"aria-label": ariaLabel,
+		flexDirection: anchor === "right" ? "row-reverse" : "row",
+		flexShrink: 0,
+		...rest,
+		children: [/* @__PURE__ */ jsx(SidebarRail, {
+			flexDirection: "column",
+			gap: 1,
+			flexShrink: 0,
+			isOpen,
+			expandedWidth,
+			collapsedWidth,
+			children: /* @__PURE__ */ jsx(SidebarContext.Provider, {
+				value: context,
+				children
+			})
+		}), hasPanel && /* @__PURE__ */ jsx(SidebarPanelRoot, {
+			as: "section",
+			width: panelWidth,
+			"aria-label": panelLabel ?? void 0,
+			...panelProps,
+			ref: setPanelNode,
+			id: panelId
+		})]
+	});
+}
+//#endregion
+export { Sidebar };