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

package/dist/Rating.mjs

@@ -0,0 +1,371 @@
+import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
+import { clamp } from "./utils.mjs";
+import { n as useDefaultProps } from "./theme-oBfFhJm9.mjs";
+import { t as useControlled } from "./useControlled-CBRLsO-H.mjs";
+import { t as Icon } from "./Icon-0hPpk-WZ.mjs";
+import { t as FormControlContext } from "./FormControlContext-CC2kToms.mjs";
+import { useFormControl } from "./FormControl.mjs";
+import { t as isRtl } from "./isRtl-BJDtm86G.mjs";
+import { r as roundToPrecision } from "./precision-B1lhxnnO.mjs";
+import { useContext, useId, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/Rating/utils/precision.ts
+/** The value under the pointer: along the width, rounded to a step, between one step and `max`. */
+function getHoverValue({ offset, width, max, precision }) {
+	const raw = max * (offset / width) + precision / 2;
+	return clamp(roundToPrecision(raw, precision), precision, max);
+}
+//#endregion
+//#region src/Rating/hooks/useRating.ts
+const NONE = -1;
+const parseRating = (raw) => raw === "" ? null : Number.parseFloat(raw);
+const getDisplayValue = (focus, rounded) => focus === NONE ? rounded : focus;
+/**
+* A rating's state: the rating itself (controlled or not, rounded to its precision), what the
+* pointer and the focus are on, and the handlers that move them. The pointer takes priority over
+* the keys when both change at once, and pressing the chosen item again clears it.
+*/
+function useRating({ value: valueProp, defaultValue, precision, max, rootRef, onChange, onChangeActive }) {
+	const [value, setValue] = useControlled({
+		controlled: valueProp,
+		default: defaultValue ?? null
+	});
+	const rounded = roundToPrecision(value, precision);
+	const [{ hover, focus }, setActive] = useState({
+		hover: NONE,
+		focus: NONE
+	});
+	const handleMouseMove = (event) => {
+		const { left, right, width } = rootRef.current.getBoundingClientRect();
+		if (width === 0) return;
+		const next = getHoverValue({
+			offset: isRtl(rootRef.current) ? right - event.clientX : event.clientX - left,
+			width,
+			max,
+			precision
+		});
+		setActive({
+			hover: next,
+			focus: next
+		});
+		if (hover !== next) onChangeActive?.(event, next);
+	};
+	const handleMouseLeave = (event) => {
+		setActive({
+			hover: NONE,
+			focus: NONE
+		});
+		if (hover !== NONE) onChangeActive?.(event, NONE);
+	};
+	const handleChange = (event) => {
+		const next = hover === NONE ? parseRating(event.currentTarget.value) : hover;
+		setValue(next);
+		onChange?.(event, next);
+	};
+	const handleClear = (event) => {
+		if (event.clientX === 0 && event.clientY === 0) return;
+		setActive({
+			hover: NONE,
+			focus: NONE
+		});
+		setValue(null);
+		if (Number.parseFloat(event.currentTarget.value) === rounded) onChange?.(event, null);
+	};
+	const handleFocus = (event) => {
+		const next = Number.parseFloat(event.currentTarget.value);
+		setActive((previous) => ({
+			hover: previous.hover,
+			focus: next
+		}));
+	};
+	const handleBlur = () => {
+		if (hover !== NONE) return;
+		setActive((previous) => ({
+			hover: previous.hover,
+			focus: NONE
+		}));
+	};
+	return {
+		rounded,
+		displayValue: getDisplayValue(focus, rounded),
+		isActive: hover !== NONE || focus !== NONE,
+		handleMouseMove,
+		handleMouseLeave,
+		handleChange,
+		handleClear,
+		handleFocus,
+		handleBlur
+	};
+}
+//#endregion
+//#region src/Rating/Rating.tsx
+const visuallyHidden = {
+	position: "absolute",
+	width: 1,
+	height: 1,
+	margin: -1,
+	padding: 0,
+	border: 0,
+	overflow: "hidden",
+	clip: "rect(0 0 0 0)",
+	whiteSpace: "nowrap"
+};
+const RatingRoot = styled("span", {
+	name: "Rating",
+	label: "Rating",
+	shouldForwardProp: createShouldForwardProp([
+		...props,
+		"size",
+		"color",
+		"isDisabled",
+		"isReadOnly",
+		"isInField"
+	]),
+	systemProps: [src_exports.space]
+})(({ theme, size, isDisabled, isReadOnly, isInField }) => ({
+	display: isInField ? "flex" : "inline-flex",
+	position: "relative",
+	width: "min-content",
+	fontSize: theme.icon[size],
+	lineHeight: 1,
+	cursor: isReadOnly ? "default" : "pointer",
+	...isDisabled && {
+		opacity: .5,
+		cursor: "not-allowed"
+	},
+	...(isDisabled || isReadOnly) && { pointerEvents: "none" }
+}));
+const focusRing = (theme, color) => {
+	const main = (0, src_exports.get)(theme, `palette.${color}.main`);
+	return {
+		outline: `${theme.borderWidths.base} solid ${main}`,
+		outlineOffset: theme.borderWidths.thin
+	};
+};
+const RatingItem = styled("label", {
+	name: "Rating",
+	slot: "item",
+	label: "RatingItem",
+	shouldForwardProp: createShouldForwardProp(["color"])
+})(({ theme, color }) => ({
+	display: "block",
+	position: "relative",
+	cursor: "inherit",
+	"&:has(input:focus-visible)": focusRing(theme, color)
+}));
+const RatingEmptyLabel = styled("label", {
+	name: "Rating",
+	slot: "emptyLabel",
+	label: "RatingEmptyLabel",
+	shouldForwardProp: createShouldForwardProp(["color"])
+})(({ theme, color }) => ({
+	position: "absolute",
+	inset: 0,
+	pointerEvents: "none",
+	"&:has(input:focus-visible)": focusRing(theme, color)
+}));
+const RatingInput = styled("input", {
+	name: "Rating",
+	slot: "input",
+	label: "RatingInput"
+})(visuallyHidden);
+const RatingText = styled("span", {
+	name: "Rating",
+	slot: "text",
+	label: "RatingText"
+})(visuallyHidden);
+const getIconColor = (theme, { color, isFilled, isError }) => {
+	if (isFilled) return (0, src_exports.get)(theme, `palette.${color}.main`);
+	if (isError) return (0, src_exports.get)(theme, "palette.error.main");
+	return (0, src_exports.get)(theme, "text.disabled");
+};
+const activeTransform = (isActive) => isActive ? "scale(1.2)" : "none";
+const RatingIcon = styled("span", {
+	name: "Rating",
+	slot: "icon",
+	label: "RatingIcon",
+	shouldForwardProp: createShouldForwardProp([
+		"color",
+		"isFilled",
+		"isActive",
+		"isError"
+	])
+})(({ theme, ...style }) => ({
+	display: "flex",
+	flexShrink: 0,
+	width: "max-content",
+	pointerEvents: "none",
+	color: getIconColor(theme, style),
+	transition: "transform 0.2s",
+	transform: activeTransform(style.isActive),
+	"@media (prefers-reduced-motion: reduce)": { transition: "none" }
+}));
+const RatingDecimal = styled("span", {
+	name: "Rating",
+	slot: "decimal",
+	label: "RatingDecimal",
+	shouldForwardProp: createShouldForwardProp(["isActive"])
+})(({ isActive }) => ({
+	position: "relative",
+	display: "flex",
+	transition: "transform 0.2s",
+	transform: activeTransform(isActive),
+	"@media (prefers-reduced-motion: reduce)": { transition: "none" }
+}));
+function Item({ itemValue, isFilled, isActive, isChecked, isInteractive, label, labelStyle, icon, emptyIcon, name, required, disabled, color, isError, state }) {
+	const glyph = /* @__PURE__ */ jsx(RatingIcon, {
+		color,
+		isFilled,
+		isActive,
+		isError,
+		children: isFilled ? icon : emptyIcon
+	});
+	if (!isInteractive) return /* @__PURE__ */ jsx(RatingItem, {
+		as: "span",
+		color,
+		style: labelStyle,
+		children: glyph
+	});
+	return /* @__PURE__ */ jsxs(RatingItem, {
+		color,
+		style: labelStyle,
+		children: [
+			glyph,
+			/* @__PURE__ */ jsx(RatingText, { children: label }),
+			/* @__PURE__ */ jsx(RatingInput, {
+				type: "radio",
+				name,
+				value: itemValue,
+				checked: isChecked,
+				required,
+				disabled,
+				onChange: state.handleChange,
+				onClick: state.handleClear,
+				onFocus: state.handleFocus,
+				onBlur: state.handleBlur
+			})
+		]
+	});
+}
+/**
+* @description A rating: a row of icons the user sets - or, `readOnly`, shows. A group of visually
+* hidden native radio inputs, so keys (Tab to the rating, the arrows to change it), assistive
+* technology and forms work as the platform's; hovering previews the value, and pressing the
+* chosen item clears it. In a `FormControl` it takes the field's size, color, error and
+* disabled state, and its `FormLabel` names it.
+*/
+function Rating({ value, defaultValue, onChange, onChangeActive, max: maxProp, precision: precisionProp, highlightSelectedOnly: highlightSelectedOnlyProp, icon: iconProp, emptyIcon: emptyIconProp, getLabelText = String, emptyLabelText, readOnly = false, size: sizeProp, color: colorProp, disabled: disabledProp, required: requiredProp, error: errorProp, name: nameProp, id: idProp, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "aria-describedby": ariaDescribedby, "data-testid": dataTestid, ...spaceProps }) {
+	const dp = useDefaultProps("Rating");
+	const isInField = useContext(FormControlContext) !== null;
+	const fc = useFormControl({
+		id: idProp,
+		error: errorProp,
+		disabled: disabledProp,
+		required: requiredProp,
+		size: sizeProp ?? dp.size,
+		color: colorProp ?? dp.color
+	});
+	const color = fc.color ?? "warning";
+	const max = maxProp ?? dp.max ?? 5;
+	const precision = precisionProp ?? dp.precision ?? 1;
+	const highlightSelectedOnly = highlightSelectedOnlyProp ?? dp.highlightSelectedOnly ?? false;
+	const icon = iconProp ?? /* @__PURE__ */ jsx(Icon, {
+		name: "star",
+		size: "1em",
+		color: "inherit"
+	});
+	const emptyIcon = emptyIconProp ?? /* @__PURE__ */ jsx(Icon, {
+		name: "star_border",
+		size: "1em",
+		color: "inherit"
+	});
+	const generatedName = useId();
+	const name = nameProp ?? generatedName;
+	const isInput = !readOnly;
+	const rootRef = useRef(null);
+	const state = useRating({
+		value,
+		defaultValue,
+		precision,
+		max,
+		rootRef,
+		onChange,
+		onChangeActive
+	});
+	const shown = state.displayValue ?? 0;
+	const renderItem = (itemValue, labelStyle, isActive = false) => /* @__PURE__ */ jsx(Item, {
+		itemValue,
+		isFilled: highlightSelectedOnly ? itemValue === shown : itemValue <= shown,
+		isActive,
+		isChecked: itemValue === state.rounded,
+		isInteractive: isInput,
+		label: getLabelText(itemValue),
+		labelStyle,
+		icon,
+		emptyIcon,
+		name,
+		required: fc.required,
+		disabled: fc.disabled,
+		color,
+		isError: fc.error,
+		state
+	}, itemValue);
+	const items = Array.from({ length: max }, (_, index) => {
+		const itemValue = index + 1;
+		const isActive = state.isActive && itemValue === Math.ceil(shown);
+		if (precision >= 1) return renderItem(itemValue, void 0, isActive);
+		const steps = Math.round(1 / precision);
+		return /* @__PURE__ */ jsx(RatingDecimal, {
+			isActive,
+			children: Array.from({ length: steps }, (__, step) => {
+				const stepValue = roundToPrecision(itemValue - 1 + (step + 1) * precision, precision);
+				const isLast = step === steps - 1;
+				const width = stepValue === state.displayValue ? `${(step + 1) * precision * 100}%` : "0%";
+				return renderItem(stepValue, isLast ? void 0 : {
+					width,
+					overflow: "hidden",
+					position: "absolute"
+				});
+			})
+		}, itemValue);
+	});
+	const displayLabel = isInput ? void 0 : getLabelText(state.rounded ?? 0);
+	const groupProps = isInput ? {
+		role: "radiogroup",
+		"aria-labelledby": ariaLabelledby ?? fc.labelId,
+		"aria-describedby": ariaDescribedby ?? fc["aria-describedby"],
+		"aria-required": fc.required || void 0,
+		"aria-invalid": fc.error || void 0,
+		onMouseMove: state.handleMouseMove,
+		onMouseLeave: state.handleMouseLeave
+	} : {
+		role: "img",
+		"aria-labelledby": ariaLabelledby
+	};
+	return /* @__PURE__ */ jsxs(RatingRoot, {
+		ref: rootRef,
+		id: fc.id,
+		size: fc.size,
+		color,
+		isDisabled: fc.disabled,
+		isReadOnly: readOnly,
+		isInField,
+		className,
+		"data-testid": dataTestid,
+		"aria-label": ariaLabel ?? displayLabel,
+		...groupProps,
+		...spaceProps,
+		children: [items, isInput && !fc.disabled && emptyLabelText !== void 0 && /* @__PURE__ */ jsxs(RatingEmptyLabel, {
+			color,
+			children: [/* @__PURE__ */ jsx(RatingInput, {
+				type: "radio",
+				name,
+				value: "",
+				checked: state.rounded === null,
+				onChange: state.handleChange
+			}), /* @__PURE__ */ jsx(RatingText, { children: emptyLabelText })]
+		})]
+	});
+}
+//#endregion
+export { Rating };

package/dist/ScrollArea.cjs

@@ -0,0 +1,268 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("./src-DU81aGy9.cjs");
+const require_theme = require("./theme-DzfwuzMZ.cjs");
+const require_useMergedRefs = require("./useMergedRefs-2zTDXgPO.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");
+/**
+* The thumb for a box scrolled to `offset`, or `null` when nothing overflows. Its size is the
+* share of the content in view, never under `MIN_THUMB_PX`; it travels the rest of the track as
+* the box travels its scroll range, so the thumb end meets the track end at the end.
+*/
+const getThumb = ({ offset, content, view }) => {
+	const range = content - view;
+	if (range <= 0 || view <= 0) return null;
+	const size = Math.min(100, Math.max(view / content, 24 / view) * 100);
+	return {
+		start: Math.min(1, Math.max(0, offset / range)) * (100 - size),
+		size
+	};
+};
+/**
+* The scroll offset a thumb dragged `by` pixels from `from` asks for: the drag covers the thumb
+* travel, which maps onto the whole scroll range of the box.
+*/
+const getScrollForDrag = (from, by, metrics) => {
+	const thumb = getThumb(metrics);
+	if (thumb === null) return from;
+	const travel = metrics.view * (1 - thumb.size / 100);
+	const range = metrics.content - metrics.view;
+	return Math.min(range, Math.max(0, from + by * range / travel));
+};
+//#endregion
+//#region src/ScrollArea/hooks/useScrollThumb.ts
+const getMetrics = (box, axis) => axis === "y" ? {
+	offset: box.scrollTop,
+	content: box.scrollHeight,
+	view: box.clientHeight
+} : {
+	offset: box.scrollLeft,
+	content: box.scrollWidth,
+	view: box.clientWidth
+};
+const scrollTo = (box, axis, offset) => {
+	if (axis === "y") box.scrollTop = offset;
+	else box.scrollLeft = offset;
+};
+/**
+* Follows the box `ref` holds along `axis`: its thumb is measured again when it scrolls and when
+* it or its content changes size. A press on the thumb drags it, with the pointer captured so the
+* drag goes on wherever the pointer goes; a press on the track pages toward it, as a native track.
+*/
+function useScrollThumb(ref, axis) {
+	const [thumb, setThumb] = (0, react.useState)(null);
+	const [isDragging, setIsDragging] = (0, react.useState)(false);
+	(0, react.useEffect)(() => {
+		const box = ref.current;
+		const measure = () => setThumb(getThumb(getMetrics(box, axis)));
+		measure();
+		box.addEventListener("scroll", measure, { passive: true });
+		const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(measure);
+		observer?.observe(box);
+		for (const child of box.children) observer?.observe(child);
+		return () => {
+			box.removeEventListener("scroll", measure);
+			observer?.disconnect();
+		};
+	}, [ref, axis]);
+	const stopDrag = (0, react.useRef)(null);
+	(0, react.useEffect)(() => () => stopDrag.current?.(), []);
+	const startDrag = (event, box) => {
+		const target = event.currentTarget;
+		const origin = axis === "y" ? event.clientY : event.clientX;
+		const from = getMetrics(box, axis).offset;
+		const handleMove = (moved) => {
+			const by = (axis === "y" ? moved.clientY : moved.clientX) - origin;
+			scrollTo(box, axis, getScrollForDrag(from, by, getMetrics(box, axis)));
+		};
+		const end = () => {
+			target.removeEventListener("pointermove", handleMove);
+			target.removeEventListener("pointerup", end);
+			target.removeEventListener("pointercancel", end);
+			stopDrag.current = null;
+			setIsDragging(false);
+		};
+		target.setPointerCapture(event.pointerId);
+		target.addEventListener("pointermove", handleMove);
+		target.addEventListener("pointerup", end);
+		target.addEventListener("pointercancel", end);
+		stopDrag.current = end;
+		setIsDragging(true);
+	};
+	const onTrackPointerDown = (event) => {
+		const box = ref.current;
+		if (thumb === null || event.button !== 0) return;
+		event.preventDefault();
+		const track = event.currentTarget.getBoundingClientRect();
+		const at = axis === "y" ? (event.clientY - track.top) / track.height * 100 : (event.clientX - track.left) / track.width * 100;
+		if (at >= thumb.start && at <= thumb.start + thumb.size) {
+			startDrag(event, box);
+			return;
+		}
+		const page = getMetrics(box, axis).view * (at < thumb.start ? -1 : 1);
+		box.scrollBy(axis === "y" ? { top: page } : { left: page });
+	};
+	return {
+		thumb,
+		onTrackPointerDown,
+		isDragging
+	};
+}
+//#endregion
+//#region src/ScrollArea/ScrollArea.tsx
+const layoutSystem = (0, require_src.src_exports.system)({
+	width: true,
+	minWidth: true,
+	maxWidth: true,
+	height: true,
+	minHeight: true,
+	maxHeight: true
+});
+const ScrollAreaRoot = require_src.styled("div", {
+	name: "ScrollArea",
+	label: "ScrollArea",
+	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)([..._soroush_tech_styled_system_should_forward_prop.props]),
+	systemProps: [require_src.src_exports.space, layoutSystem]
+})({
+	position: "relative",
+	display: "flex",
+	flex: "1 1 auto",
+	minWidth: 0,
+	minHeight: 0,
+	"&:hover > [data-scroll-track] > [data-scroll-thumb], &:focus-within > [data-scroll-track] > [data-scroll-thumb]": { opacity: 1 }
+});
+const ScrollAreaViewport = require_src.styled("div", {
+	name: "ScrollArea",
+	slot: "viewport",
+	label: "ScrollAreaViewport",
+	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)(["axes"])
+})(({ axes }) => ({
+	flex: 1,
+	minWidth: 0,
+	minHeight: 0,
+	overflowX: axes === "y" ? "hidden" : "auto",
+	overflowY: axes === "x" ? "hidden" : "auto",
+	overscrollBehaviorX: axes === "y" ? "auto" : "none",
+	overscrollBehaviorY: axes === "x" ? "auto" : "none",
+	scrollbarWidth: "none",
+	"&::-webkit-scrollbar": { display: "none" }
+}));
+const ScrollAreaTrack = require_src.styled("div", {
+	name: "ScrollArea",
+	slot: "track",
+	label: "ScrollAreaTrack",
+	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)(["isDragging", "axis"])
+})(({ theme, isDragging, axis }) => {
+	const line = `${theme.borderWidths.thin} solid ${isDragging ? (0, require_src.src_exports.get)(theme, "border.default") : "transparent"}`;
+	return {
+		position: "absolute",
+		...axis === "y" ? {
+			top: 0,
+			right: 0,
+			bottom: 0,
+			width: theme.space[1.25],
+			borderLeft: line
+		} : {
+			left: 0,
+			right: 0,
+			bottom: 0,
+			height: theme.space[1.25],
+			borderTop: line
+		},
+		backgroundColor: isDragging ? (0, require_src.src_exports.get)(theme, "background.scrollbarTrack") : "transparent",
+		"&:hover": {
+			borderColor: (0, require_src.src_exports.get)(theme, "border.default"),
+			backgroundColor: (0, require_src.src_exports.get)(theme, "background.scrollbarTrack")
+		}
+	};
+});
+const ScrollAreaThumb = require_src.styled("div", {
+	name: "ScrollArea",
+	slot: "thumb",
+	label: "ScrollAreaThumb",
+	shouldForwardProp: (0, _soroush_tech_styled_system_should_forward_prop.createShouldForwardProp)(["isShown", "axis"])
+})(({ theme, isShown, axis }) => {
+	const inset = `calc((${theme.space[1.25]} - ${theme.space[.75]}) / 2 - ${theme.borderWidths.thin})`;
+	return {
+		position: "absolute",
+		...axis === "y" ? {
+			left: inset,
+			width: theme.space[.75]
+		} : {
+			top: inset,
+			height: theme.space[.75]
+		},
+		borderRadius: "9999px",
+		backgroundColor: (0, require_src.src_exports.get)(theme, "background.scrollbar"),
+		opacity: isShown ? 1 : 0,
+		transition: `opacity ${theme.transitions.duration.short}ms`,
+		"@media (prefers-reduced-motion: reduce)": { transition: "none" }
+	};
+});
+function ScrollBar({ box, axis }) {
+	const { thumb, onTrackPointerDown, isDragging } = useScrollThumb(box, axis);
+	if (thumb === null) return null;
+	const place = axis === "y" ? {
+		top: `${thumb.start}%`,
+		height: `${thumb.size}%`
+	} : {
+		left: `${thumb.start}%`,
+		width: `${thumb.size}%`
+	};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollAreaTrack, {
+		"aria-hidden": true,
+		"data-scroll-track": axis,
+		axis,
+		isDragging,
+		onPointerDown: onTrackPointerDown,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollAreaThumb, {
+			"data-scroll-thumb": true,
+			axis,
+			isShown: isDragging,
+			style: place
+		})
+	});
+}
+/**
+* @description A scrolling area whose scrollbars are drawn over its content rather than beside
+* it - so a rounded panel keeps its corner clean - and show only while the pointer is over it or
+* focus is inside. Scrolling itself stays native: the wheel, the keyboard and touch work as they
+* do anywhere. Each axis that overflows gets a track, down the right edge or along the bottom,
+* whose thumb drags and whose track pages. It grows to its content and no further than its
+* container, or `maxHeight`, allows. Colors come from `theme.background.scrollbar` and
+* `scrollbarTrack`, its size from `theme.space`.
+*/
+function ScrollArea({ children, axes: axesProp, viewportRef, tabIndex, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, className, "data-testid": dataTestid, ...rest }) {
+	const dp = require_theme.useDefaultProps("ScrollArea");
+	const axes = axesProp ?? dp.axes ?? "y";
+	const box = (0, react.useRef)(null);
+	const mergedRef = require_useMergedRefs.useMergedRefs(box, viewportRef);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(ScrollAreaRoot, {
+		className,
+		"data-testid": dataTestid,
+		...rest,
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollAreaViewport, {
+				ref: mergedRef,
+				axes,
+				"data-scroll-viewport": true,
+				tabIndex,
+				role: ariaLabel || ariaLabelledby ? "region" : void 0,
+				"aria-label": ariaLabel,
+				"aria-labelledby": ariaLabelledby,
+				children
+			}),
+			axes !== "x" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollBar, {
+				box,
+				axis: "y"
+			}),
+			axes !== "y" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ScrollBar, {
+				box,
+				axis: "x"
+			})
+		]
+	});
+}
+//#endregion
+exports.ScrollArea = ScrollArea;

package/dist/ScrollArea.d.cts

@@ -0,0 +1,40 @@
+import { nt as Theme } from "./index-XN4-ZqTB.cjs";
+import { ReactNode, Ref } from "react";
+import { LayoutProps, SpaceProps } from "@soroush.tech/styled-system";
+//#region src/ScrollArea/hooks/useScrollThumb.d.ts
+/** Which way a thumb runs: down the right edge, or along the bottom. */
+type ScrollAxis = 'y' | 'x';
+//#endregion
+//#region src/ScrollArea/ScrollArea.d.ts
+/** Which ways it scrolls. */
+type ScrollAxes = ScrollAxis | 'both';
+interface ScrollAreaProps extends SpaceProps<Theme>, Pick<LayoutProps<Theme>, 'width' | 'minWidth' | 'maxWidth' | 'height' | 'minHeight' | 'maxHeight'> {
+  /** What scrolls. */
+  children: ReactNode;
+  /** Which ways it scrolls. Default: `'y'`. */
+  axes?: ScrollAxes;
+  /** The scrolling element - for code that reads or sets its scroll. */
+  viewportRef?: Ref<HTMLDivElement>;
+  /**
+   * `0` puts the scrolling box in the tab order, so the keys scroll it - for content with nothing
+   * focusable in it. Default: none.
+   */
+  tabIndex?: 0;
+  /** Names the scrolling box, as a `region`. */
+  'aria-label'?: string;
+  'aria-labelledby'?: string;
+  className?: string;
+  'data-testid'?: string;
+}
+/**
+ * @description A scrolling area whose scrollbars are drawn over its content rather than beside
+ * it - so a rounded panel keeps its corner clean - and show only while the pointer is over it or
+ * focus is inside. Scrolling itself stays native: the wheel, the keyboard and touch work as they
+ * do anywhere. Each axis that overflows gets a track, down the right edge or along the bottom,
+ * whose thumb drags and whose track pages. It grows to its content and no further than its
+ * container, or `maxHeight`, allows. Colors come from `theme.background.scrollbar` and
+ * `scrollbarTrack`, its size from `theme.space`.
+ */
+declare function ScrollArea({ children, axes: axesProp, viewportRef, tabIndex, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, className, 'data-testid': dataTestid, ...rest }: Readonly<ScrollAreaProps>): import("react").JSX.Element;
+//#endregion
+export { ScrollArea, ScrollAreaProps, ScrollAxes };