@yahoo/uds 3.66.1 → 3.67.0-beta.1

package/dist/components/client/IconButton.d.ts

@@ -0,0 +1,37 @@
+import { UniversalIconButtonProps } from "../../tokens/types.js";
+import "../../tokens/index.js";
+import * as react7 from "react";
+import { HTMLMotionProps } from "motion/react";
+
+//#region src/components/client/IconButton.d.ts
+type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'> & Omit<HTMLMotionProps<'button'>, 'name'>;
+interface IconButtonProps extends HtmlButtonProps, UniversalIconButtonProps {}
+/**
+ * **⚙️️ An icon button element that can be used to trigger an action**
+ *
+ * @componentType Client component
+ *
+ * @description An icon button is essentially an interactive icon. They should be used to display an icon which, when clicked, allows the user to trigger an action. Icon buttons provide additional features such hover states, focus states, and pressable functionality.
+ *
+ * @see
+ * Check out the {@link https://uds.build/docs/components/icon-button IconButton Docs} for more info
+ *
+ * @usage
+ * - When you need a button that is represented by an icon rather than text. This is useful in compact spaces, toolbars, or when the action is commonly understood through a visual symbol.
+ * - If you need a button that is used to trigger a non-critical action.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { IconButton } from "@yahoo/uds";
+ * import { AddFolder } from "@yahoo/uds-icons";
+ *
+ * <IconButton name={AddFolder} variant="primary" />
+ * ```
+ *
+ * @related [Icon](https://uds.build/docs/components/icon), [Button](https://uds.build/docs/components/button), and [Pressable](https://uds.build/docs/components/pressable)
+ *
+ **/
+declare const IconButton: react7.ForwardRefExoticComponent<Omit<IconButtonProps, "ref"> & react7.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { IconButton, type IconButtonProps };

package/dist/components/client/IconButton.js

@@ -0,0 +1,128 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { BUTTON_SCALE_EFFECT_HOVER, BUTTON_SCALE_EFFECT_PRESSED, BUTTON_SCALE_EFFECT_REST } from "../../tokens/consts/cssTokens.js";
+import { cx, getStyles } from "../../styles/styler.js";
+import { Icon } from "../Icon.js";
+import { generateDefaultClassName } from "../../tokens/automation/utils/index.js";
+import { SpringMotionConfig } from "./SpringMotionConfig.js";
+import { iconMotionVariants, loadingMotionVariants } from "./Button.js";
+import { forwardRef, useImperativeHandle, useMemo, useRef } from "react";
+import { buttonIconSvgSize } from "@yahoo/uds/fixtures";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Progress } from "@yahoo/uds-icons";
+import { AnimatePresence, m, useReducedMotion } from "motion/react";
+
+//#region src/components/client/IconButton.tsx
+const defaultSizeRootClass = generateDefaultClassName("iconbutton", "size", "root");
+const defaultSizeIconClass = generateDefaultClassName("iconbutton", "size", "icon");
+const defaultVariantRootClass = generateDefaultClassName("button", "variant", "root");
+const defaultVariantIconClass = generateDefaultClassName("button", "variant", "icon");
+/**
+* **⚙️️ An icon button element that can be used to trigger an action**
+*
+* @componentType Client component
+*
+* @description An icon button is essentially an interactive icon. They should be used to display an icon which, when clicked, allows the user to trigger an action. Icon buttons provide additional features such hover states, focus states, and pressable functionality.
+*
+* @see
+* Check out the {@link https://uds.build/docs/components/icon-button IconButton Docs} for more info
+*
+* @usage
+* - When you need a button that is represented by an icon rather than text. This is useful in compact spaces, toolbars, or when the action is commonly understood through a visual symbol.
+* - If you need a button that is used to trigger a non-critical action.
+*
+* @example
+* ```tsx
+* 'use client';
+* import { IconButton } from "@yahoo/uds";
+* import { AddFolder } from "@yahoo/uds-icons";
+*
+* <IconButton name={AddFolder} variant="primary" />
+* ```
+*
+* @related [Icon](https://uds.build/docs/components/icon), [Button](https://uds.build/docs/components/button), and [Pressable](https://uds.build/docs/components/pressable)
+*
+**/
+const IconButton = forwardRef(function IconButton$1({ variant, size, iconVariant, loading, disableEffects, name, type = "button", htmlName, className, children, ...rest }, forwardedRef) {
+	const ref = useRef(null);
+	useImperativeHandle(forwardedRef, () => ref.current);
+	const prefersReducedMotion = useReducedMotion();
+	const disableMotion = !!disableEffects || !!rest?.disabled;
+	const layoutVariant = useMemo(() => prefersReducedMotion ? "smooth" : "subtle", [prefersReducedMotion]);
+	const buttonVariants = useMemo(() => ({
+		rest: { scale: disableMotion ? 1 : `var(${BUTTON_SCALE_EFFECT_REST})` },
+		hover: { scale: disableMotion ? 1 : `var(${BUTTON_SCALE_EFFECT_HOVER})` },
+		pressed: { scale: disableMotion ? 1 : `var(${BUTTON_SCALE_EFFECT_PRESSED})` }
+	}), [disableMotion]);
+	const rootSizeClass = useMemo(() => size ? getStyles({ iconbuttonSizeRoot: size }) : defaultSizeRootClass, [size]);
+	const rootVariantClass = useMemo(() => variant ? getStyles({ buttonVariantRoot: variant }) : defaultVariantRootClass, [variant]);
+	const iconSizeClass = useMemo(() => size ? getStyles({ iconbuttonSizeIcon: size }) : defaultSizeIconClass, [size]);
+	const iconVariantClass = useMemo(() => variant ? getStyles({ buttonVariantIcon: variant }) : defaultVariantIconClass, [variant]);
+	const styles = useMemo(() => ({
+		root: cx("uds-ring", "uds-hit-target", "inline-flex overflow-hidden justify-center items-center", "[transform-origin:center]", "[backface-visibility:hidden]", "[transition-property:color,background-color,border-color, box-shadow,text-decoration-color,fill,stroke]", "[transition-timing-function:cubic-bezier(0,0,0.2,1)]", "[transition-duration:220ms]", rootSizeClass, rootVariantClass, rest?.disabled && "cursor-not-allowed", loading && "uds-button-loading", disableEffects && "uds-button-without-effects", className),
+		icon: getStyles({ className: cx(iconSizeClass, iconVariantClass) }),
+		loadingIcon: getStyles({ className: cx([
+			"animate-spin",
+			iconSizeClass,
+			iconVariantClass
+		]) })
+	}), [
+		className,
+		disableEffects,
+		iconSizeClass,
+		iconVariantClass,
+		loading,
+		rest?.disabled,
+		rootSizeClass,
+		rootVariantClass
+	]);
+	return /* @__PURE__ */ jsx(SpringMotionConfig, {
+		layoutSpeed: "3",
+		layoutVariant,
+		reducedMotion: disableEffects ? "always" : "user",
+		children: /* @__PURE__ */ jsx(m.button, {
+			ref,
+			type,
+			className: styles.root,
+			name: htmlName,
+			initial: "icon",
+			variants: buttonVariants,
+			whileHover: "hover",
+			whileTap: "pressed",
+			...rest,
+			children: /* @__PURE__ */ jsxs(AnimatePresence, {
+				initial: false,
+				mode: "popLayout",
+				children: [loading && /* @__PURE__ */ jsx(m.span, {
+					variants: loadingMotionVariants,
+					initial: "loading",
+					animate: "loading",
+					exit: "hide",
+					children: /* @__PURE__ */ jsx(Icon, {
+						size: buttonIconSvgSize,
+						name: Progress,
+						variant: iconVariant,
+						color: "current",
+						className: styles.loadingIcon
+					})
+				}, "loading"), name && !loading && /* @__PURE__ */ jsx(m.span, {
+					variants: iconMotionVariants,
+					initial: "icon",
+					animate: "icon",
+					exit: "hide",
+					children: children || /* @__PURE__ */ jsx(Icon, {
+						size: buttonIconSvgSize,
+						name,
+						variant: iconVariant,
+						color: "current",
+						className: styles.icon
+					})
+				}, name.name)]
+			})
+		})
+	});
+});
+IconButton.displayName = "IconButton";
+
+//#endregion
+export { IconButton };

package/dist/components/client/Input/Input.cjs

@@ -0,0 +1,209 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_styles_styler = require('../../../styles/styler.cjs');
+const require_components_Box = require('../../Box.cjs');
+const require_components_HStack = require('../../HStack.cjs');
+const require_components_VStack = require('../../VStack.cjs');
+const require_components_IconSlot = require('../../IconSlot.cjs');
+const require_components_client_AnimateHeightChange = require('../AnimateHeightChange.cjs');
+const require_components_client_Input_InputHelpTextInternal = require('./InputHelpTextInternal.cjs');
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let lodash_isFunction_js = require("lodash/isFunction.js");
+lodash_isFunction_js = require_rolldown_runtime.__toESM(lodash_isFunction_js);
+let motion_react = require("motion/react");
+
+//#region src/components/client/Input/Input.tsx
+const HelpTextContent = (0, react.memo)(function HelpTextContentOriginal({ helpText, helperTextIcon, spacingStart, spacingTop, size, isFilled, ...rest }) {
+	if (!helpText) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_Box.Box, {
+		spacingTop,
+		spacingStart,
+		...rest,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_Input_InputHelpTextInternal.InputHelpTextInternal, {
+			startIcon: helperTextIcon,
+			size,
+			isFilled,
+			children: (0, lodash_isFunction_js.default)(helpText) ? helpText() : helpText
+		})
+	});
+});
+const StartIcon = (0, react.memo)(function StartIcon$1({ icon, className, iconProps }) {
+	if (!icon) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_IconSlot.IconSlot, {
+		icon,
+		iconProps: {
+			variant: "outline",
+			...iconProps
+		},
+		className
+	});
+});
+const EndIcon = (0, react.memo)(function EndIcon$1({ icon, className, iconProps }) {
+	if (!icon) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_IconSlot.IconSlot, {
+		icon,
+		iconProps: {
+			variant: "outline",
+			...iconProps
+		},
+		className
+	});
+});
+/**
+* **📦 An input that allows users to enter text and collect data.**
+*
+* @componentType Client component
+*
+* @description
+* An input field is a component that takes text typed into it. It can also serve as a way to display a selection and trigger a dropdown menu. Inputs are interactive elements that users can click, tap, or otherwise engage with to collect data and open dropdowns, or both.
+*
+* @see
+* Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
+*
+* @usage
+* - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
+* - Search Bars: Allowing users to enter search queries to find content.
+* - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
+* - Feedback/Comments: Letting users leave reviews, comments, or feedback.
+*
+* @example
+* ```tsx
+* 'use client';
+* import { Input } from "@yahoo/uds";
+*
+* <Input label="Name" placeholder="Enter your name" required />
+*```
+*
+* @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
+**/
+const Input = (0, react.forwardRef)(function Input$1({ id, label, type = "text", size = "md", startIcon, endIcon, helpText, helperTextIcon, hasError, width: containerWidth = "full", defaultValue, required, readOnly, disabled, reduceMotion: forceReduceMotion, onChange, slotProps, className, ...otherProps }, forwardedRef) {
+	const generatedId = (0, react.useId)();
+	const uid = id ?? `uds-input-${generatedId}`;
+	const helpTextId = `uds-input-${uid}-help-text`;
+	const { className: inputClassName, ...inputProps } = slotProps?.input ?? {};
+	const { className: inputWrapperClassName, ...inputWrapperProps } = slotProps?.inputWrapper ?? {};
+	const ref = (0, react.useRef)(null);
+	(0, react.useImperativeHandle)(forwardedRef, () => ref.current);
+	const [value, setValue] = (0, react.useState)(defaultValue ?? "");
+	const handleChange = (0, react.useCallback)((e) => {
+		setValue(e.target.value);
+		onChange?.(e);
+	}, [onChange]);
+	const layoutVariant = (0, motion_react.useReducedMotion)() ? "smooth" : "bouncy";
+	const reduceMotion = forceReduceMotion ? "always" : "user";
+	const isInteractive = !readOnly && !disabled;
+	const classNames = {
+		root: require_styles_styler.getStyles({
+			inputSizeRoot: size,
+			inputVariantRoot: "default",
+			inputVariantValueRoot: !value ? "empty" : "filled",
+			className: require_styles_styler.cx([className, disabled ? "opacity-50" : ""])
+		}),
+		inputWrapper: require_styles_styler.cx(require_styles_styler.getStyles({
+			inputSizeInputWrapper: size,
+			inputVariantInputWrapper: "default",
+			inputVariantValueInputWrapper: !value ? "empty" : "filled"
+		}), "min-w-[200px]", inputWrapperClassName),
+		input: require_styles_styler.getStyles({
+			inputSizeInput: size,
+			inputVariantInput: "default",
+			inputVariantValueInput: !value ? "empty" : "filled",
+			inputVariantInputPlaceholder: "default",
+			inputVariantValueInputPlaceholder: !value ? "empty" : "filled",
+			className: require_styles_styler.cx("grow", "uds-hit-target", "bg-clip-text", "focus:outline-none", isInteractive ? "cursor-text" : "cursor-not-allowed", inputClassName)
+		}),
+		label: require_styles_styler.cx(require_styles_styler.getStyles({
+			inputSizeLabel: size,
+			inputVariantLabel: "default",
+			inputVariantValueLabel: !value ? "empty" : "filled"
+		})),
+		labelRequired: require_styles_styler.getStyles({
+			inputVariantLabelRequired: "default",
+			inputVariantValueLabelRequired: !value ? "empty" : "filled"
+		}),
+		startIcon: require_styles_styler.getStyles({
+			inputSizeStartIcon: size,
+			inputVariantStartIcon: "default",
+			inputVariantValueStartIcon: !value ? "empty" : "filled"
+		}),
+		endIcon: require_styles_styler.getStyles({
+			inputSizeEndIcon: size,
+			inputVariantEndIcon: "default",
+			inputVariantValueEndIcon: !value ? "empty" : "filled"
+		})
+	};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_components_VStack.VStack, {
+		width: containerWidth,
+		className: classNames.root,
+		children: [
+			label && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_components_Box.Box, {
+				spacingBottom: "2",
+				columnGap: "0.5",
+				alignItems: "flex-end",
+				className: classNames.label,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+					htmlFor: uid,
+					children: (0, lodash_isFunction_js.default)(label) ? label() : label
+				}), required && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: classNames.labelRequired,
+					children: "*"
+				})]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_components_Box.Box, {
+				position: "relative",
+				alignItems: "center",
+				...inputWrapperProps,
+				className: classNames.inputWrapper,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(StartIcon, {
+						icon: startIcon,
+						className: classNames.startIcon,
+						iconProps: slotProps?.startIcon
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						ref,
+						id: uid,
+						type,
+						value,
+						required,
+						readOnly,
+						disabled,
+						"aria-describedby": helpTextId,
+						"aria-invalid": hasError,
+						onChange: handleChange,
+						className: classNames.input,
+						...otherProps,
+						...inputProps
+					}),
+					endIcon && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_HStack.HStack, {
+						alignItems: "center",
+						gap: "1",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(EndIcon, {
+							icon: endIcon,
+							className: classNames.endIcon,
+							iconProps: slotProps?.endIcon
+						})
+					})
+				]
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_AnimateHeightChange.AnimateHeightChange, {
+				reduceMotion,
+				layoutVariant,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HelpTextContent, {
+					id: helpTextId,
+					helpText,
+					spacingTop: "2",
+					size,
+					isFilled: !!value,
+					helperTextIcon
+				})
+			})
+		]
+	});
+});
+Input.displayName = "Input";
+
+//#endregion
+exports.Input = Input;

package/dist/components/client/Input/Input.d.cts

@@ -0,0 +1,56 @@
+import { IconPropsWithSVGProps, UniversalInputProps } from "../../../tokens/types.cjs";
+import "../../../tokens/index.cjs";
+import { BoxProps } from "../../Box.cjs";
+import * as react40 from "react";
+import { InputHTMLAttributes } from "react";
+import { HTMLMotionProps } from "motion/react";
+
+//#region src/components/client/Input/Input.d.ts
+type HtmlInputProps = React.InputHTMLAttributes<HTMLInputElement> & HTMLMotionProps<'input'>;
+type NativeInputProps = Omit<HtmlInputProps, 'height' | 'size' | 'width' | 'color' | 'required'>;
+type DataAttributes = {
+  [name: `data-${string}`]: string;
+};
+interface InputProps extends NativeInputProps, UniversalInputProps {
+  /** The type of the input element. Reduced set of options from the HTML input type attribute.
+   * @default 'text'
+   */
+  type?: Exclude<NativeInputProps['type'], 'button' | 'checkbox' | 'color' | 'file' | 'radio' | 'range' | 'reset' | 'submit' | 'search'>;
+  /** Props to be passed into various slots within the component. */
+  slotProps?: {
+    input?: Partial<InputHTMLAttributes<HTMLInputElement> & DataAttributes>;
+    inputWrapper?: Partial<BoxProps & DataAttributes>;
+    startIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
+    endIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
+  };
+}
+/**
+ * **📦 An input that allows users to enter text and collect data.**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * An input field is a component that takes text typed into it. It can also serve as a way to display a selection and trigger a dropdown menu. Inputs are interactive elements that users can click, tap, or otherwise engage with to collect data and open dropdowns, or both.
+ *
+ * @see
+ * Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
+ *
+ * @usage
+ * - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
+ * - Search Bars: Allowing users to enter search queries to find content.
+ * - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
+ * - Feedback/Comments: Letting users leave reviews, comments, or feedback.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Input } from "@yahoo/uds";
+ *
+ * <Input label="Name" placeholder="Enter your name" required />
+ *```
+ *
+ * @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
+ **/
+declare const Input: react40.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react40.RefAttributes<HTMLInputElement>>;
+//#endregion
+export { Input, type InputProps };

package/dist/components/client/Input/Input.d.ts

@@ -0,0 +1,56 @@
+import { IconPropsWithSVGProps, UniversalInputProps } from "../../../tokens/types.js";
+import "../../../tokens/index.js";
+import { BoxProps } from "../../Box.js";
+import * as react44 from "react";
+import { InputHTMLAttributes } from "react";
+import { HTMLMotionProps } from "motion/react";
+
+//#region src/components/client/Input/Input.d.ts
+type HtmlInputProps = React.InputHTMLAttributes<HTMLInputElement> & HTMLMotionProps<'input'>;
+type NativeInputProps = Omit<HtmlInputProps, 'height' | 'size' | 'width' | 'color' | 'required'>;
+type DataAttributes = {
+  [name: `data-${string}`]: string;
+};
+interface InputProps extends NativeInputProps, UniversalInputProps {
+  /** The type of the input element. Reduced set of options from the HTML input type attribute.
+   * @default 'text'
+   */
+  type?: Exclude<NativeInputProps['type'], 'button' | 'checkbox' | 'color' | 'file' | 'radio' | 'range' | 'reset' | 'submit' | 'search'>;
+  /** Props to be passed into various slots within the component. */
+  slotProps?: {
+    input?: Partial<InputHTMLAttributes<HTMLInputElement> & DataAttributes>;
+    inputWrapper?: Partial<BoxProps & DataAttributes>;
+    startIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
+    endIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
+  };
+}
+/**
+ * **📦 An input that allows users to enter text and collect data.**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * An input field is a component that takes text typed into it. It can also serve as a way to display a selection and trigger a dropdown menu. Inputs are interactive elements that users can click, tap, or otherwise engage with to collect data and open dropdowns, or both.
+ *
+ * @see
+ * Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
+ *
+ * @usage
+ * - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
+ * - Search Bars: Allowing users to enter search queries to find content.
+ * - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
+ * - Feedback/Comments: Letting users leave reviews, comments, or feedback.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Input } from "@yahoo/uds";
+ *
+ * <Input label="Name" placeholder="Enter your name" required />
+ *```
+ *
+ * @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
+ **/
+declare const Input: react44.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react44.RefAttributes<HTMLInputElement>>;
+//#endregion
+export { Input, type InputProps };