@agentero/design-system 0.11.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentero/design-system",
-	"version": "0.11.0",
+	"version": "0.13.0",
 	"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"
 		},
+		"./switch": {
+			"types": "./src/switch/index.d.ts",
+			"import": "./src/switch/index.js"
+		},
 		"./tag": {
 			"types": "./src/tag/index.d.ts",
 			"import": "./src/tag/index.js"
@@ -65,6 +69,10 @@
 			"types": "./src/toast/index.d.ts",
 			"import": "./src/toast/index.js"
 		},
+		"./tooltip": {
+			"types": "./src/tooltip/index.d.ts",
+			"import": "./src/tooltip/index.js"
+		},
 		"./lib": {
 			"types": "./lib/index.d.ts",
 			"import": "./lib/index.js"
@@ -88,6 +96,8 @@
 		"@radix-ui/react-dropdown-menu": "^2.1.16",
 		"@radix-ui/react-separator": "^1.1.8",
 		"@radix-ui/react-slot": "^1.2.4",
+		"@radix-ui/react-switch": "^1.3.2",
+		"@radix-ui/react-tooltip": "^1.2.11",
 		"clsx": "^2.1.1",
 		"sonner": "^2.0.7",
 		"tailwind-merge": "^3.5.0",

package/src/switch/index.d.ts

@@ -0,0 +1,2 @@
+export { Switch, switchRecipe } from './switch';
+export type { SwitchProps, SwitchSize } from './switch';

package/src/switch/index.js

@@ -0,0 +1,2 @@
+import { Switch as e, switchRecipe as t } from "./switch.js";
+export { e as Switch, t as switchRecipe };

package/src/switch/switch.d.ts

@@ -0,0 +1,59 @@
+import { ComponentPropsWithRef } from 'react';
+import { VariantProps } from 'tailwind-variants';
+import * as SwitchPrimitive from '@radix-ui/react-switch';
+export declare const switchRecipe: import('tailwind-variants').TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            thumb: string;
+        };
+        md: {
+            root: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string[];
+    thumb: string;
+}, undefined, {
+    size: {
+        sm: {
+            root: string;
+            thumb: string;
+        };
+        md: {
+            root: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string[];
+    thumb: string;
+}, import('tailwind-variants').TVReturnType<{
+    size: {
+        sm: {
+            root: string;
+            thumb: string;
+        };
+        md: {
+            root: string;
+            thumb: string;
+        };
+    };
+}, {
+    root: string[];
+    thumb: string;
+}, undefined, unknown, unknown, undefined>>;
+export type SwitchSize = NonNullable<VariantProps<typeof switchRecipe>['size']>;
+export type SwitchProps = ComponentPropsWithRef<typeof SwitchPrimitive.Root> & VariantProps<typeof switchRecipe>;
+/**
+ * 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.
+ *
+ * @summary Instant-effect on/off toggle built on Radix Switch
+ *
+ * @example
+ * <Switch checked={enabled} onCheckedChange={setEnabled} />
+ */
+export declare const Switch: ({ className, size, ref, ...props }: SwitchProps) => import("react/jsx-runtime").JSX.Element;

package/src/switch/switch.js

@@ -0,0 +1,42 @@
+"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";
+//#region src/switch/switch.tsx
+var i = t({
+	slots: {
+		root: [
+			"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"
+	},
+	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"
+		}
+	} },
+	defaultVariants: { size: "md" }
+}), a = ({ className: t, size: a, ref: o, ...s }) => {
+	let c = i({ size: a });
+	return /* @__PURE__ */ n(r.Root, {
+		ref: o,
+		"data-slot": "switch",
+		className: e(c.root(), t),
+		...s,
+		children: /* @__PURE__ */ n(r.Thumb, {
+			"data-slot": "switch-thumb",
+			className: c.thumb()
+		})
+	});
+};
+//#endregion
+export { a as Switch, i as switchRecipe };

package/src/tooltip/index.d.ts

@@ -0,0 +1,2 @@
+export { Tooltip, tooltipRecipe } from './tooltip';
+export type { TooltipProps } from './tooltip';

package/src/tooltip/index.js

@@ -0,0 +1,2 @@
+import { Tooltip as e, tooltipRecipe as t } from "./tooltip.js";
+export { e as Tooltip, t as tooltipRecipe };

package/src/tooltip/tooltip.d.ts

@@ -0,0 +1,45 @@
+import { ComponentProps, ReactNode } from 'react';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+export declare const tooltipRecipe: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
+type RootProps = ComponentProps<typeof TooltipPrimitive.Root>;
+export type TooltipProps = {
+    /** The trigger element. Hovering or focusing it reveals the tooltip. */
+    children: ReactNode;
+    /** The floating hint. Keep it short — labels or hints, not paragraphs. */
+    content: ReactNode;
+    /** Preferred side of the trigger; flips on collision. Defaults to `'top'`. */
+    side?: TooltipPrimitive.TooltipContentProps['side'];
+    /** Preferred alignment against the trigger. Defaults to `'center'`. */
+    align?: TooltipPrimitive.TooltipContentProps['align'];
+    /** Distance in pixels between the tooltip and its trigger. Defaults to `4`. */
+    sideOffset?: number;
+    /** Merge Radix's behavior onto an already-interactive child instead of wrapping it in a `<button>`. Defaults to `false`. */
+    asChild?: boolean;
+    /** Hide the tooltip when the trigger is clipped away (e.g. scrolled out of an `overflow` container). */
+    hideWhenDetached?: boolean;
+    /** Delay in ms before opening on hover. Defaults to `0`; focus always opens instantly. */
+    delayDuration?: number;
+    /** Extra classes for the content surface, merged last. */
+    className?: string;
+} & Pick<RootProps, 'open' | 'defaultOpen' | 'onOpenChange'>;
+/**
+ * Tooltip reveals a short, non-essential hint anchored to a trigger element on
+ * hover or focus. Pass the trigger as `children` and the hint as `content`; use
+ * `asChild` when the trigger is already interactive (a button or link) to avoid
+ * nesting interactive elements. Don't put essential or interactive content
+ * inside it — hover-only content is inaccessible to touch and keyboard users.
+ *
+ * @summary Hover/focus hint anchored to a trigger element
+ *
+ * @example
+ * ```tsx
+ * <Tooltip content="Archive this carrier" asChild>
+ *   <IconButton aria-label="Archive"><IconArchive /></IconButton>
+ * </Tooltip>
+ * ```
+ */
+export declare const Tooltip: {
+    ({ children, content, side, align, sideOffset, asChild, hideWhenDetached, delayDuration, open, defaultOpen, onOpenChange, className }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export {};

package/src/tooltip/tooltip.js

@@ -0,0 +1,43 @@
+"use client";
+import { tv as e } from "tailwind-variants";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
+import * as r from "@radix-ui/react-tooltip";
+//#region src/tooltip/tooltip.tsx
+var i = e({ base: [
+	"z-(--z-index-tooltip) max-w-[32ch] px-3 py-2",
+	"rounded-sm border border-border-default-base-primary bg-bg-default-base-primary shadow-sm",
+	"text-xs text-pretty text-text-default-base-secondary select-none",
+	"will-change-[transform,opacity]",
+	"data-[side=bottom]:animate-tooltip-slide-in-from-top",
+	"data-[side=top]:animate-tooltip-slide-in-from-bottom",
+	"data-[side=left]:animate-tooltip-slide-in-from-right",
+	"data-[side=right]:animate-tooltip-slide-in-from-left",
+	"motion-reduce:animate-none!"
+] }), a = ({ children: e, content: a, side: o = "top", align: s, sideOffset: c = 4, asChild: l = !1, hideWhenDetached: u, delayDuration: d = 0, open: f, defaultOpen: p, onOpenChange: m, className: h }) => /* @__PURE__ */ t(r.Provider, {
+	delayDuration: d,
+	skipDelayDuration: 0,
+	children: /* @__PURE__ */ n(r.Root, {
+		open: f,
+		defaultOpen: p,
+		onOpenChange: m,
+		children: [/* @__PURE__ */ t(r.Trigger, {
+			asChild: l,
+			"data-slot": "tooltip-trigger",
+			"data-testid": "tooltip-trigger",
+			className: "align-middle",
+			children: e
+		}), /* @__PURE__ */ t(r.Portal, { children: /* @__PURE__ */ t(r.Content, {
+			"data-slot": "tooltip-content",
+			side: o,
+			align: s,
+			sideOffset: c,
+			collisionPadding: 8,
+			hideWhenDetached: u,
+			className: i({ className: h }),
+			children: a
+		}) })]
+	})
+});
+a.displayName = "Tooltip";
+//#endregion
+export { a as Tooltip, i as tooltipRecipe };

package/theme/base.css

@@ -804,6 +804,10 @@
 	--animate-dropdown-slide-in-from-bottom: dropdownSlideInFromBottom 200ms ease-out;
 	--animate-dropdown-slide-in-from-left: dropdownSlideInFromLeft 200ms ease-out;
 	--animate-dropdown-slide-in-from-right: dropdownSlideInFromRight 200ms ease-out;
+	--animate-tooltip-slide-in-from-top: tooltipSlideInFromTop 200ms ease-out;
+	--animate-tooltip-slide-in-from-bottom: tooltipSlideInFromBottom 200ms ease-out;
+	--animate-tooltip-slide-in-from-left: tooltipSlideInFromLeft 200ms ease-out;
+	--animate-tooltip-slide-in-from-right: tooltipSlideInFromRight 200ms ease-out;
 
 	/* ========================================
     * Z-INDEX
@@ -996,6 +1000,50 @@
 		}
 	}
 
+	@keyframes tooltipSlideInFromTop {
+		0% {
+			opacity: 0;
+			transform: translateY(-0.25rem);
+		}
+		100% {
+			opacity: 1;
+			transform: translateY(0);
+		}
+	}
+
+	@keyframes tooltipSlideInFromBottom {
+		0% {
+			opacity: 0;
+			transform: translateY(0.25rem);
+		}
+		100% {
+			opacity: 1;
+			transform: translateY(0);
+		}
+	}
+
+	@keyframes tooltipSlideInFromLeft {
+		0% {
+			opacity: 0;
+			transform: translateX(-0.25rem);
+		}
+		100% {
+			opacity: 1;
+			transform: translateX(0);
+		}
+	}
+
+	@keyframes tooltipSlideInFromRight {
+		0% {
+			opacity: 0;
+			transform: translateX(0.25rem);
+		}
+		100% {
+			opacity: 1;
+			transform: translateX(0);
+		}
+	}
+
 	@keyframes accordionDown {
 		from {
 			height: 0;