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

package/dist/Rating.cjs

@@ -1,24 +1,23 @@
 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_theme = require("./theme-BxXuXRgQ.cjs");
-const require_Icon = require("./Icon-D-EWsBVg.cjs");
-const require_FormControlContext = require("./FormControlContext-74gvPGFk.cjs");
+const require_theme = require("./theme-XJvMdOnY.cjs");
+const require_useControlled = require("./useControlled-CzCxM4J3.cjs");
+const require_Icon = require("./Icon-C5Iz5ekp.cjs");
+const require_FormControlContext = require("./FormControlContext-DvEyxrdM.cjs");
 const require_FormControl = require("./FormControl.cjs");
-const require_isRtl = require("./isRtl-DTkYHRPo.cjs");
-const require_useControlled = require("./useControlled-C666KpQ0.cjs");
-const require_precision = require("./precision-B58cTPB2.cjs");
+const require_isRtl = require("./isRtl-Dl6QQWib.cjs");
+const require_precision = require("./precision-DbF9gToz.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");
-//#region src/Rating/utils/precision.ts
+// 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 require_utils.clamp(require_precision.roundToPrecision(raw, precision), precision, max);
 }
-//#endregion
-//#region src/Rating/hooks/useRating.ts
+// src/Rating/hooks/useRating.ts
 const NONE = -1;
 const parseRating = (raw) => raw === "" ? null : Number.parseFloat(raw);
 const getDisplayValue = (focus, rounded) => focus === NONE ? rounded : focus;
@@ -99,8 +98,7 @@ function useRating({ value: valueProp, defaultValue, precision, max, rootRef, on
 		handleBlur
 	};
 }
-//#endregion
-//#region src/Rating/Rating.tsx
+// src/Rating/Rating.tsx
 const visuallyHidden = {
 	position: "absolute",
 	width: 1,
@@ -369,5 +367,4 @@ function Rating({ value, defaultValue, onChange, onChangeActive, max: maxProp, p
 		})]
 	});
 }
-//#endregion
 exports.Rating = Rating;

package/dist/Rating.d.cts

@@ -1,7 +1,6 @@
-import { W as Theme } from "./index-DJ0f69wh.cjs";
+import { nt as Theme } from "./index-Lsm4v8fB.cjs";
 import { MouseEvent, ReactNode, SyntheticEvent } from "react";
 import { SpaceProps } from "@soroush.tech/styled-system";
-//#region src/Rating/Rating.d.ts
 interface RatingProps extends SpaceProps<Theme> {
   /** The rating - `null` for none. Controlled with `onChange`. */
   value?: number | null;
@@ -53,5 +52,4 @@ interface RatingProps extends SpaceProps<Theme> {
  * disabled state, and its `FormLabel` names it.
  */
 declare function Rating({ value, defaultValue, onChange, onChangeActive, max: maxProp, precision: precisionProp, highlightSelectedOnly: highlightSelectedOnlyProp, icon: iconProp, emptyIcon: emptyIconProp, getLabelText, emptyLabelText, readOnly, 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 }: Readonly<RatingProps>): import("react").JSX.Element;
-//#endregion
 export { Rating, RatingProps };

package/dist/Rating.d.mts

@@ -1,7 +1,6 @@
-import { W as Theme } from "./index-CJhK7JND.mjs";
+import { nt as Theme } from "./index-CR8qkP8U.mjs";
 import { SpaceProps } from "@soroush.tech/styled-system";
 import { MouseEvent, ReactNode, SyntheticEvent } from "react";
-//#region src/Rating/Rating.d.ts
 interface RatingProps extends SpaceProps<Theme> {
   /** The rating - `null` for none. Controlled with `onChange`. */
   value?: number | null;
@@ -53,5 +52,4 @@ interface RatingProps extends SpaceProps<Theme> {
  * disabled state, and its `FormLabel` names it.
  */
 declare function Rating({ value, defaultValue, onChange, onChangeActive, max: maxProp, precision: precisionProp, highlightSelectedOnly: highlightSelectedOnlyProp, icon: iconProp, emptyIcon: emptyIconProp, getLabelText, emptyLabelText, readOnly, 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 }: Readonly<RatingProps>): import("react").JSX.Element;
-//#endregion
 export { Rating, RatingProps };

package/dist/Rating.mjs

@@ -1,22 +1,21 @@
-import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-DLGYOJMh.mjs";
+import { a as src_exports, i as props, o as styled, t as createShouldForwardProp } from "./src-B-rNjHIL.mjs";
 import { clamp } from "./utils.mjs";
-import { n as useDefaultProps } from "./theme-Z9_QludW.mjs";
-import { t as Icon } from "./Icon-BihOAP4u.mjs";
-import { t as FormControlContext } from "./FormControlContext-CC2kToms.mjs";
+import { n as useDefaultProps } from "./theme-DyyZQFzQ.mjs";
+import { t as useControlled } from "./useControlled-B4uQ9Bj6.mjs";
+import { t as Icon } from "./Icon-XpXU-SuF.mjs";
+import { t as FormControlContext } from "./FormControlContext-Dg_ommiF.mjs";
 import { useFormControl } from "./FormControl.mjs";
-import { t as isRtl } from "./isRtl-BJDtm86G.mjs";
-import { t as useControlled } from "./useControlled-CBRLsO-H.mjs";
-import { r as roundToPrecision } from "./precision-B1lhxnnO.mjs";
+import { t as isRtl } from "./isRtl-DN-EdUlg.mjs";
+import { r as roundToPrecision } from "./precision-DrmFmgMd.mjs";
 import { useContext, useId, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
-//#region src/Rating/utils/precision.ts
+// 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
+// src/Rating/hooks/useRating.ts
 const NONE = -1;
 const parseRating = (raw) => raw === "" ? null : Number.parseFloat(raw);
 const getDisplayValue = (focus, rounded) => focus === NONE ? rounded : focus;
@@ -97,8 +96,7 @@ function useRating({ value: valueProp, defaultValue, precision, max, rootRef, on
 		handleBlur
 	};
 }
-//#endregion
-//#region src/Rating/Rating.tsx
+// src/Rating/Rating.tsx
 const visuallyHidden = {
 	position: "absolute",
 	width: 1,
@@ -367,5 +365,4 @@ function Rating({ value, defaultValue, onChange, onChangeActive, max: maxProp, p
 		})]
 	});
 }
-//#endregion
 export { Rating };

package/dist/ScrollArea.cjs

@@ -0,0 +1,265 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_src = require("./src-yC1f5WR2.cjs");
+const require_theme = require("./theme-XJvMdOnY.cjs");
+const require_useMergedRefs = require("./useMergedRefs-BtctsnmX.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));
+};
+// 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
+	};
+}
+// 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"
+			})
+		]
+	});
+}
+exports.ScrollArea = ScrollArea;

package/dist/ScrollArea.d.cts

@@ -0,0 +1,36 @@
+import { nt as Theme } from "./index-Lsm4v8fB.cjs";
+import { ReactNode, Ref } from "react";
+import { LayoutProps, SpaceProps } from "@soroush.tech/styled-system";
+/** Which way a thumb runs: down the right edge, or along the bottom. */
+type ScrollAxis = 'y' | 'x';
+/** 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;
+export { ScrollArea, ScrollAreaProps, ScrollAxes };

package/dist/ScrollArea.d.mts

@@ -0,0 +1,36 @@
+import { nt as Theme } from "./index-CR8qkP8U.mjs";
+import { LayoutProps, SpaceProps } from "@soroush.tech/styled-system";
+import { ReactNode, Ref } from "react";
+/** Which way a thumb runs: down the right edge, or along the bottom. */
+type ScrollAxis = 'y' | 'x';
+/** 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;
+export { ScrollArea, ScrollAreaProps, ScrollAxes };