@agentero/design-system 0.14.0 → 0.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentero/design-system",
-	"version": "0.14.0",
+	"version": "0.15.1",
 	"description": "A React component library built with Tailwind CSS v4 and Radix UI primitives",
 	"type": "module",
 	"license": "Apache-2.0",
@@ -57,6 +57,10 @@
 			"types": "./src/pagination/index.d.ts",
 			"import": "./src/pagination/index.js"
 		},
+		"./progress": {
+			"types": "./src/progress/index.d.ts",
+			"import": "./src/progress/index.js"
+		},
 		"./skeleton": {
 			"types": "./src/skeleton/index.d.ts",
 			"import": "./src/skeleton/index.js"
@@ -98,6 +102,7 @@
 		"@radix-ui/react-accordion": "^1.2.14",
 		"@radix-ui/react-avatar": "^1.1.11",
 		"@radix-ui/react-dropdown-menu": "^2.1.16",
+		"@radix-ui/react-progress": "^1.1.12",
 		"@radix-ui/react-separator": "^1.1.8",
 		"@radix-ui/react-slot": "^1.2.4",
 		"@radix-ui/react-switch": "^1.3.2",

package/src/progress/index.d.ts

@@ -0,0 +1,2 @@
+export { Progress, progressRecipe } from './progress';
+export type { ProgressProps } from './progress';

package/src/progress/index.js

@@ -0,0 +1,2 @@
+import { Progress as e, progressRecipe as t } from "./progress.js";
+export { e as Progress, t as progressRecipe };

package/src/progress/progress.d.ts

@@ -0,0 +1,89 @@
+export declare const progressRecipe: import('tailwind-variants').TVReturnType<{
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            label?: import('tailwind-merge').ClassNameValue;
+            track?: import('tailwind-merge').ClassNameValue;
+            value?: import('tailwind-merge').ClassNameValue;
+            root?: import('tailwind-merge').ClassNameValue;
+            indicator?: import('tailwind-merge').ClassNameValue;
+            labelRow?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import('tailwind-merge').ClassNameValue | {
+            label?: import('tailwind-merge').ClassNameValue;
+            track?: import('tailwind-merge').ClassNameValue;
+            value?: import('tailwind-merge').ClassNameValue;
+            root?: import('tailwind-merge').ClassNameValue;
+            indicator?: import('tailwind-merge').ClassNameValue;
+            labelRow?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string;
+    track: string;
+    indicator: string;
+    labelRow: string;
+    label: string;
+    value: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            label?: import('tailwind-merge').ClassNameValue;
+            track?: import('tailwind-merge').ClassNameValue;
+            value?: import('tailwind-merge').ClassNameValue;
+            root?: import('tailwind-merge').ClassNameValue;
+            indicator?: import('tailwind-merge').ClassNameValue;
+            labelRow?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string;
+    track: string;
+    indicator: string;
+    labelRow: string;
+    label: string;
+    value: string;
+}, import('tailwind-variants').TVReturnType<unknown, {
+    root: string;
+    track: string;
+    indicator: string;
+    labelRow: string;
+    label: string;
+    value: string;
+}, undefined, unknown, unknown, undefined>>;
+export type ProgressProps = {
+    /** Completion percentage, 0–100. Values outside the range are clamped. */
+    percentage: number;
+    /** Optional label rendered above the bar, with the percentage value on the right. */
+    label?: string;
+    /** Accessible name when no visible `label` is provided. Defaults to `'Progress'`. */
+    'aria-label'?: string;
+    /**
+     * Extra classes for the bar, merged last. The fill paints with `currentColor`,
+     * so a text color recolors it (e.g. `text-brand-400`); sizing classes resize
+     * the track (e.g. `h-3`).
+     */
+    className?: string;
+};
+/**
+ * Progress shows how far a bounded task has advanced — wizard steps, upload
+ * status, or a split of a total. Pass `percentage` (0–100) and optionally a
+ * `label`, which renders above the bar with the percentage value. Built on
+ * Radix UI Progress, so `role="progressbar"` and `aria-value*` come wired.
+ *
+ * The fill is near-black by default and paints with `currentColor` — recolor
+ * it from the consumer with a plain text color class.
+ *
+ * @summary Horizontal progress bar with optional label
+ *
+ * @example
+ * ```tsx
+ * <Progress percentage={62} label="Profile completion" className="text-brand-400" />
+ * ```
+ */
+export declare const Progress: {
+    ({ percentage, label, "aria-label": ariaLabel, className }: ProgressProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/src/progress/progress.js

@@ -0,0 +1,46 @@
+"use client";
+import { tv as e } from "tailwind-variants";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
+import { useId as r } from "react";
+import * as i from "@radix-ui/react-progress";
+//#region src/progress/progress.tsx
+var a = e({ slots: {
+	root: "flex flex-col gap-2",
+	track: "relative h-2 w-full overflow-hidden rounded-sm bg-neutrals-200 text-neutrals-900",
+	indicator: "size-full bg-current transition-transform duration-600 ease-in-out motion-reduce:transition-none",
+	labelRow: "flex items-center justify-between gap-2",
+	label: "text-sm text-text-default-base-primary",
+	value: "text-base text-text-default-base-primary"
+} }), o = ({ percentage: e, label: o, "aria-label": s, className: c }) => {
+	let l = r(), u = a(), d = Math.min(100, Math.max(0, e));
+	return /* @__PURE__ */ n("div", {
+		"data-slot": "progress",
+		className: u.root(),
+		children: [o && /* @__PURE__ */ n("div", {
+			"data-slot": "progress-label",
+			className: u.labelRow(),
+			children: [/* @__PURE__ */ t("span", {
+				id: l,
+				className: u.label(),
+				children: o
+			}), /* @__PURE__ */ n("span", {
+				className: u.value(),
+				children: [d, "%"]
+			})]
+		}), /* @__PURE__ */ t(i.Root, {
+			"data-slot": "progress-track",
+			value: d,
+			"aria-labelledby": o ? l : void 0,
+			"aria-label": o ? void 0 : s ?? "Progress",
+			className: u.track({ className: c }),
+			children: /* @__PURE__ */ t(i.Indicator, {
+				"data-slot": "progress-indicator",
+				className: u.indicator(),
+				style: { transform: `translateX(-${100 - d}%)` }
+			})
+		})]
+	});
+};
+o.displayName = "Progress";
+//#endregion
+export { o as Progress, a as progressRecipe };

package/src/switch/switch.d.ts

@@ -12,9 +12,16 @@ export declare const switchRecipe: import('tailwind-variants').TVReturnType<{
             thumb: string;
         };
     };
+    reverse: {
+        true: {
+            wrapper: string;
+        };
+    };
 }, {
+    wrapper: string;
     root: string[];
     thumb: string;
+    label: string[];
 }, undefined, {
     size: {
         sm: {
@@ -26,9 +33,16 @@ export declare const switchRecipe: import('tailwind-variants').TVReturnType<{
             thumb: string;
         };
     };
+    reverse: {
+        true: {
+            wrapper: string;
+        };
+    };
 }, {
+    wrapper: string;
     root: string[];
     thumb: string;
+    label: string[];
 }, import('tailwind-variants').TVReturnType<{
     size: {
         sm: {
@@ -40,20 +54,39 @@ export declare const switchRecipe: import('tailwind-variants').TVReturnType<{
             thumb: string;
         };
     };
+    reverse: {
+        true: {
+            wrapper: string;
+        };
+    };
 }, {
+    wrapper: string;
     root: string[];
     thumb: string;
+    label: string[];
 }, undefined, unknown, unknown, undefined>>;
 export type SwitchSize = NonNullable<VariantProps<typeof switchRecipe>['size']>;
-export type SwitchProps = ComponentPropsWithRef<typeof SwitchPrimitive.Root> & VariantProps<typeof switchRecipe>;
+export type SwitchProps = ComponentPropsWithRef<typeof SwitchPrimitive.Root> & VariantProps<typeof switchRecipe> & {
+    /**
+     * Optional text rendered beside the toggle and associated with it via
+     * `htmlFor`. Provide an `id` so the association resolves. Omit it to keep
+     * the toggle headless and supply your own `<label htmlFor>`.
+     */
+    label?: string;
+};
 /**
  * Instant-effect on/off toggle built on Radix Switch. Reach for it over a
- * Checkbox when flipping a single boolean that applies immediately. Renders
- * only the toggle — pair it with a `<label htmlFor>` for an accessible name.
+ * Checkbox when flipping a single boolean that applies immediately.
+ *
+ * Renders only the toggle by default — pair it with a `<label htmlFor>` for an
+ * accessible name. Pass `label` (with an `id`) to render an associated text
+ * label beside the toggle; `reverse` places the label before it.
  *
  * @summary Instant-effect on/off toggle built on Radix Switch
  *
  * @example
  * <Switch checked={enabled} onCheckedChange={setEnabled} />
+ * @example
+ * <Switch id="email-notifications" label="Email" checked={on} onCheckedChange={setOn} />
  */
-export declare const Switch: ({ className, size, ref, ...props }: SwitchProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Switch: ({ className, size, reverse, label, id, ref, ...props }: SwitchProps) => import("react/jsx-runtime").JSX.Element;

package/src/switch/switch.js

@@ -1,42 +1,61 @@
 "use client";
 import { cn as e } from "../../lib/utils.js";
 import { tv as t } from "tailwind-variants";
-import { jsx as n } from "react/jsx-runtime";
-import * as r from "@radix-ui/react-switch";
+import { jsx as n, jsxs as r } from "react/jsx-runtime";
+import { useId as i } from "react";
+import * as a from "@radix-ui/react-switch";
 //#region src/switch/switch.tsx
-var i = t({
+var o = t({
 	slots: {
+		wrapper: "inline-flex items-center gap-2.5",
 		root: [
-			"inline-flex shrink-0 cursor-pointer items-center rounded-full transition-colors",
+			"peer inline-flex shrink-0 cursor-pointer items-center rounded-full transition-colors",
 			"bg-bg-default-base-tertiary data-[state=checked]:bg-bg-default-base-inverse-primary",
 			"focus-visible:outline-solid focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring-button-primary",
 			"disabled:cursor-not-allowed disabled:opacity-50"
 		],
-		thumb: "block translate-x-0 rounded-full bg-bg-default-base-primary shadow-sm transition-transform"
+		thumb: "block translate-x-0 rounded-full bg-bg-default-base-primary shadow-sm transition-transform",
+		label: ["cursor-pointer text-sm text-text-default-base-primary select-none", "peer-disabled:cursor-not-allowed peer-disabled:opacity-50"]
 	},
-	variants: { size: {
-		sm: {
-			root: "h-4 w-7.5 p-0.5",
-			thumb: "size-3 data-[state=checked]:translate-x-3.5"
+	variants: {
+		size: {
+			sm: {
+				root: "h-4 w-7.5 p-0.5",
+				thumb: "size-3 data-[state=checked]:translate-x-3.5"
+			},
+			md: {
+				root: "h-6 w-12 p-0.75",
+				thumb: "size-4.5 data-[state=checked]:translate-x-6"
+			}
 		},
-		md: {
-			root: "h-6 w-12 p-0.75",
-			thumb: "size-4.5 data-[state=checked]:translate-x-6"
-		}
-	} },
+		reverse: { true: { wrapper: "flex-row-reverse" } }
+	},
 	defaultVariants: { size: "md" }
-}), a = ({ className: t, size: a, ref: o, ...s }) => {
-	let c = i({ size: a });
-	return /* @__PURE__ */ n(r.Root, {
-		ref: o,
+}), s = ({ className: t, size: s, reverse: c, label: l, id: u, ref: d, ...f }) => {
+	let p = i(), m = u ?? (l ? p : void 0), h = o({
+		size: s,
+		reverse: c
+	}), g = /* @__PURE__ */ n(a.Root, {
+		ref: d,
+		id: m,
 		"data-slot": "switch",
-		className: e(c.root(), t),
-		...s,
-		children: /* @__PURE__ */ n(r.Thumb, {
+		className: e(h.root(), t),
+		...f,
+		children: /* @__PURE__ */ n(a.Thumb, {
 			"data-slot": "switch-thumb",
-			className: c.thumb()
+			className: h.thumb()
 		})
 	});
+	return l ? /* @__PURE__ */ r("span", {
+		"data-slot": "switch-wrapper",
+		className: h.wrapper(),
+		children: [g, /* @__PURE__ */ n("label", {
+			htmlFor: m,
+			"data-slot": "switch-label",
+			className: h.label(),
+			children: l
+		})]
+	}) : g;
 };
 //#endregion
-export { a as Switch, i as switchRecipe };
+export { s as Switch, o as switchRecipe };