@yahoo/uds 3.58.2-beta.1 → 3.59.0-beta.1

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

@@ -0,0 +1,41 @@
+import { UniversalButtonProps } from "../../tokens/types.cjs";
+import "../../tokens/index.cjs";
+import React, { ForwardRefExoticComponent } from "react";
+import { HTMLMotionProps } from "motion/react";
+
+//#region src/components/client/Button.d.ts
+type HtmlButtonProps = Omit<HTMLMotionProps<'button'>, 'color' | 'name'> & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color'>;
+interface ButtonProps extends HtmlButtonProps, UniversalButtonProps {}
+/**
+ * **🖲️ A button element that can be used to trigger an action**
+ *
+ * @componentType Client component
+ *
+ * @description A button is a fundamental component used to trigger an action or event. Buttons are interactive elements that users can click, tap, or otherwise engage with to submit forms, open dialogues, or perform any other interaction within an application or website. Consider an IconButton for buttons that only contain an icon.
+ *
+ * @see The {@link https://uds.build/docs/components/button Button Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Button, HStack } from "@yahoo/uds";
+ *
+ * export function Demo() {
+ *   return (
+ *     <HStack gap="2">
+ *       <Button onClick={console.log}>Save</Button>
+ *       <Button variant="secondary" onClick={console.log}>Cancel</Button>
+ *     </HStack>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Buttons should be used to clearly indicate and initiate actions that users can take.
+ *
+ * @related [Icon](https://uds.build/docs/components/icon), [IconButton](https://uds.build/docs/components/icon-button), [Pressable](https://uds.build/docs/components/pressable)
+ **/
+declare const Button: ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { Button, type ButtonProps };
+//# sourceMappingURL=Button.d.cts.map

package/dist/components/client/Button.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.cts","names":[],"sources":["../../../src/components/client/Button.tsx"],"sourcesContent":[],"mappings":";;;;;;KA8BK,eAAA,CAAA,CAAA,CAAkB,KAAK,+CAC1B,KAAK,KAAA,CAAM,qBAAqB;UAExB,WAAA,CAAA,OAAA,CAAoB,iBAAiB,sBAnBhC;;;;;;;AAiBT,CAAA;AAE6D,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,MAAA,CAAA,MAAA,CAAA,IAAA,CAAA,CAAA,GAAA,CAAA,IAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;cA+B7D,QAAM,0BAAA,KAAA,sBAAA,KAAA,CAAA,cAAA"}

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

@@ -0,0 +1,41 @@
+import { UniversalButtonProps } from "../../tokens/types.js";
+import "../../tokens/index.js";
+import React, { ForwardRefExoticComponent } from "react";
+import { HTMLMotionProps } from "motion/react";
+
+//#region src/components/client/Button.d.ts
+type HtmlButtonProps = Omit<HTMLMotionProps<'button'>, 'color' | 'name'> & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color'>;
+interface ButtonProps extends HtmlButtonProps, UniversalButtonProps {}
+/**
+ * **🖲️ A button element that can be used to trigger an action**
+ *
+ * @componentType Client component
+ *
+ * @description A button is a fundamental component used to trigger an action or event. Buttons are interactive elements that users can click, tap, or otherwise engage with to submit forms, open dialogues, or perform any other interaction within an application or website. Consider an IconButton for buttons that only contain an icon.
+ *
+ * @see The {@link https://uds.build/docs/components/button Button Docs} for more info
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Button, HStack } from "@yahoo/uds";
+ *
+ * export function Demo() {
+ *   return (
+ *     <HStack gap="2">
+ *       <Button onClick={console.log}>Save</Button>
+ *       <Button variant="secondary" onClick={console.log}>Cancel</Button>
+ *     </HStack>
+ *   )
+ * }
+ * ```
+ *
+ * @usage
+ * Buttons should be used to clearly indicate and initiate actions that users can take.
+ *
+ * @related [Icon](https://uds.build/docs/components/icon), [IconButton](https://uds.build/docs/components/icon-button), [Pressable](https://uds.build/docs/components/pressable)
+ **/
+declare const Button: ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+//#endregion
+export { Button, type ButtonProps };
+//# sourceMappingURL=Button.d.ts.map

package/dist/components/client/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","names":[],"sources":["../../../src/components/client/Button.tsx"],"sourcesContent":[],"mappings":";;;;;;KA8BK,eAAA,CAAA,CAAA,CAAkB,KAAK,+CAC1B,KAAK,KAAA,CAAM,qBAAqB;UAExB,WAAA,CAAA,OAAA,CAAoB,iBAAiB,sBAnBhC;;;;;;;AAiBT,CAAA;AAE6D,CAAA,CAAA,CAAA,CAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,IAAA,CAAA,KAAA,CAAA,CAAA,CAAA,GAAA,CAAA,KAAA,CAAA,IAAA,CAAA,UAAA,CAAA,MAAA,CAAA,MAAA,CAAA,IAAA,CAAA,CAAA,GAAA,CAAA,IAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;cA+B7D,QAAM,0BAAA,KAAA,sBAAA,KAAA,CAAA,cAAA"}

package/dist/components/client/Button.js

@@ -0,0 +1,225 @@
+"use client";
+/*! © 2025 Yahoo, Inc. UDS v0.0.0-development */
+import { cx, getStyles } from "../../styles/styler.js";
+import { createSlot } from "../../utils/createSlot.js";
+import { Icon } from "../Icon.js";
+import { IconSlot } from "../IconSlot.js";
+import { parseDeprecatedButtonPaletteVariant } from "../../tokens/parseButtonVariants.js";
+import { buttonMotionVariants, getGapVariant, getStartVariant, iconContainerMotionVariants, iconMotionVariants, loadingMotionVariants } from "../../tokens/consts/buttonMotionTokens.js";
+import { SpringMotionConfig } from "./SpringMotionConfig.js";
+import React, { cloneElement, forwardRef, isValidElement, useImperativeHandle, useMemo, useRef } from "react";
+import { buttonIconSvgSize } from "@yahoo/uds/fixtures";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Progress } from "@yahoo/uds-icons";
+import { AnimatePresence, m, useReducedMotion } from "motion/react";
+
+//#region src/components/client/Button.tsx
+/**
+* **🖲️ A button element that can be used to trigger an action**
+*
+* @componentType Client component
+*
+* @description A button is a fundamental component used to trigger an action or event. Buttons are interactive elements that users can click, tap, or otherwise engage with to submit forms, open dialogues, or perform any other interaction within an application or website. Consider an IconButton for buttons that only contain an icon.
+*
+* @see The {@link https://uds.build/docs/components/button Button Docs} for more info
+*
+* @example
+* ```tsx
+* 'use client';
+* import { Button, HStack } from "@yahoo/uds";
+*
+* export function Demo() {
+*   return (
+*     <HStack gap="2">
+*       <Button onClick={console.log}>Save</Button>
+*       <Button variant="secondary" onClick={console.log}>Cancel</Button>
+*     </HStack>
+*   )
+* }
+* ```
+*
+* @usage
+* Buttons should be used to clearly indicate and initiate actions that users can take.
+*
+* @related [Icon](https://uds.build/docs/components/icon), [IconButton](https://uds.build/docs/components/icon-button), [Pressable](https://uds.build/docs/components/pressable)
+**/
+const Button = forwardRef(function Button$1({ variant, size: buttonSize, startIcon, endIcon, iconVariant, loading, disableEffects, children, asChild, type = "button", className, width,...rest }, forwardedRef) {
+	const ref = useRef(null);
+	useImperativeHandle(forwardedRef, () => ref.current);
+	const Slot = useMemo(() => createSlot(), []);
+	const MotionSlot = useMemo(() => m.create(Slot), [Slot]);
+	const endVariant = endIcon ? "icon" : "hide";
+	const gapVariant = getGapVariant({
+		startIcon,
+		endIcon,
+		loading
+	});
+	const startVariant = getStartVariant({
+		loading,
+		startIcon
+	});
+	const { palette: buttonPalette_DEPRECATED, variant: buttonVariant_DEPRECATED } = useMemo(() => parseDeprecatedButtonPaletteVariant({ flatVariant: variant }), [variant]);
+	const classNames = useMemo(() => ({
+		button: getStyles({
+			width,
+			buttonSize,
+			buttonVariant: buttonVariant_DEPRECATED,
+			buttonPalette: buttonPalette_DEPRECATED,
+			className: cx("uds-button", "uds-ring", "uds-hit-target", loading && "uds-button-loading", disableEffects && "uds-button-without-effects", gapVariant === "withIcon" && "uds-button-with-gap", className)
+		}),
+		content: "uds-button-content truncate",
+		iconContainer: "uds-button-icon-container flex overflow-clip",
+		loading: "uds-button-icon start-content animate-spin",
+		start: "uds-button-icon start-content",
+		end: "uds-button-icon end-content"
+	}), [
+		width,
+		buttonSize,
+		buttonVariant_DEPRECATED,
+		buttonPalette_DEPRECATED,
+		className,
+		loading,
+		disableEffects,
+		gapVariant
+	]);
+	const layoutVariant = useReducedMotion() ? "smooth" : "subtle";
+	/**
+	* TODO see if we can get these to work as ReactElements like (ie <StartContent />)
+	* Animations aren't currently propagating if I do that
+	**/
+	const startContent = useMemo(() => /* @__PURE__ */ jsx(m.span, {
+		className: classNames.iconContainer,
+		initial: false,
+		variants: iconContainerMotionVariants,
+		animate: startVariant,
+		children: /* @__PURE__ */ jsxs(AnimatePresence, {
+			initial: false,
+			mode: "popLayout",
+			children: [loading && /* @__PURE__ */ jsx(m.span, {
+				variants: loadingMotionVariants,
+				initial: "hide",
+				animate: "loading",
+				exit: "hide",
+				children: /* @__PURE__ */ jsx(Icon, {
+					size: buttonIconSvgSize,
+					name: Progress,
+					variant: iconVariant,
+					color: "current",
+					className: classNames.loading
+				})
+			}, "loading"), startIcon && !loading && /* @__PURE__ */ jsx(m.span, {
+				variants: iconMotionVariants,
+				initial: "hide",
+				animate: "icon",
+				exit: "hide",
+				children: /* @__PURE__ */ jsx(IconSlot, {
+					className: classNames.start,
+					icon: startIcon,
+					iconProps: {
+						size: buttonIconSvgSize,
+						variant: iconVariant,
+						color: "current"
+					}
+				})
+			})]
+		})
+	}), [
+		classNames.iconContainer,
+		classNames.loading,
+		classNames.start,
+		startVariant,
+		loading,
+		iconVariant,
+		startIcon
+	]);
+	const endContent = useMemo(() => /* @__PURE__ */ jsx(m.span, {
+		className: classNames.iconContainer,
+		initial: false,
+		variants: iconContainerMotionVariants,
+		animate: endVariant,
+		children: /* @__PURE__ */ jsx(AnimatePresence, {
+			initial: false,
+			mode: "popLayout",
+			children: endIcon && /* @__PURE__ */ jsx(m.span, {
+				variants: iconMotionVariants,
+				initial: "hide",
+				animate: "icon",
+				exit: "hide",
+				children: /* @__PURE__ */ jsx(IconSlot, {
+					className: classNames.end,
+					icon: endIcon,
+					iconProps: {
+						size: buttonIconSvgSize,
+						variant: iconVariant,
+						color: "current"
+					}
+				})
+			})
+		})
+	}), [
+		classNames.iconContainer,
+		classNames.end,
+		endIcon,
+		endVariant,
+		iconVariant
+	]);
+	const buttonVariants$1 = useMemo(() => {
+		if (!disableEffects) return buttonMotionVariants;
+		return {
+			...buttonMotionVariants,
+			rest: {},
+			hover: {},
+			pressed: {}
+		};
+	}, [disableEffects]);
+	if (asChild && isValidElement(children)) return /* @__PURE__ */ jsx(SpringMotionConfig, {
+		layoutSpeed: "3",
+		layoutVariant,
+		children: /* @__PURE__ */ jsx(MotionSlot, {
+			type,
+			className: classNames.button,
+			initial: ["hide", gapVariant],
+			animate: gapVariant,
+			variants: buttonVariants$1,
+			whileHover: "hover",
+			whileTap: "pressed",
+			...rest,
+			children: cloneElement(children, children.props, /* @__PURE__ */ jsxs(Fragment, { children: [
+				startContent,
+				/* @__PURE__ */ jsx("span", {
+					className: classNames.content,
+					children: children.props.children
+				}),
+				endContent
+			] }))
+		})
+	});
+	return /* @__PURE__ */ jsx(SpringMotionConfig, {
+		layoutSpeed: "3",
+		layoutVariant,
+		children: /* @__PURE__ */ jsxs(m.button, {
+			ref,
+			type,
+			className: classNames.button,
+			initial: ["hide", gapVariant],
+			animate: gapVariant,
+			variants: buttonVariants$1,
+			whileHover: "hover",
+			whileTap: "pressed",
+			...rest,
+			children: [
+				startContent,
+				/* @__PURE__ */ jsx("span", {
+					className: classNames.content,
+					children
+				}),
+				endContent
+			]
+		})
+	});
+});
+Button.displayName = "Button";
+
+//#endregion
+export { Button };
+//# sourceMappingURL=Button.js.map

package/dist/components/client/Button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.js","names":["Button","layoutVariant: MotionVariant","buttonVariants"],"sources":["../../../src/components/client/Button.tsx"],"sourcesContent":["import { buttonIconSvgSize } from '@yahoo/uds/fixtures';\nimport type { MotionVariant, UniversalButtonProps } from '@yahoo/uds/tokens';\nimport { parseDeprecatedButtonPaletteVariant } from '@yahoo/uds/tokens';\nimport { Progress } from '@yahoo/uds-icons';\nimport type { HTMLMotionProps } from 'motion/react';\nimport { AnimatePresence, m, useReducedMotion } from 'motion/react';\nimport type { ForwardRefExoticComponent } from 'react';\nimport React, {\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n} from 'react';\n\nimport { cx, getStyles } from '../../styles/styler';\nimport {\n  buttonMotionVariants,\n  getGapVariant,\n  getStartVariant,\n  iconContainerMotionVariants,\n  iconMotionVariants,\n  loadingMotionVariants,\n} from '../../tokens/consts/buttonMotionTokens';\nimport { createSlot } from '../../utils/createSlot';\nimport { Icon } from '../Icon';\nimport { IconSlot } from '../IconSlot';\nimport { SpringMotionConfig } from './SpringMotionConfig';\n\ntype HtmlButtonProps = Omit<HTMLMotionProps<'button'>, 'color' | 'name'> &\n  Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color'>;\n\ninterface ButtonProps extends HtmlButtonProps, UniversalButtonProps {}\n\n/**\n * **🖲️ A button element that can be used to trigger an action**\n *\n * @componentType Client component\n *\n * @description A button is a fundamental component used to trigger an action or event. Buttons are interactive elements that users can click, tap, or otherwise engage with to submit forms, open dialogues, or perform any other interaction within an application or website. Consider an IconButton for buttons that only contain an icon.\n *\n * @see The {@link https://uds.build/docs/components/button Button Docs} for more info\n *\n * @example\n * ```tsx\n * 'use client';\n * import { Button, HStack } from \"@yahoo/uds\";\n *\n * export function Demo() {\n *   return (\n *     <HStack gap=\"2\">\n *       <Button onClick={console.log}>Save</Button>\n *       <Button variant=\"secondary\" onClick={console.log}>Cancel</Button>\n *     </HStack>\n *   )\n * }\n * ```\n *\n * @usage\n * Buttons should be used to clearly indicate and initiate actions that users can take.\n *\n * @related [Icon](https://uds.build/docs/components/icon), [IconButton](https://uds.build/docs/components/icon-button), [Pressable](https://uds.build/docs/components/pressable)\n **/\nconst Button = forwardRef<HTMLButtonElement, ButtonProps>(function Button(\n  {\n    // Button config props\n    variant,\n    size: buttonSize,\n    // Icon props\n    startIcon,\n    endIcon,\n    iconVariant,\n    // State props\n    loading,\n    disableEffects,\n    // Misc props\n    children,\n    asChild,\n    // HTML props (className, disabled, aria-*, data-*, onClick, etc.)\n    type = 'button',\n    className,\n    // Size props\n    width,\n    ...rest\n  },\n  forwardedRef,\n) {\n  /* ------------------------------- Setup refs ------------------------------- */\n  const ref = useRef<HTMLButtonElement>(null);\n  useImperativeHandle(forwardedRef, () => ref.current as HTMLButtonElement);\n\n  /* --------------------------- Create motion slot --------------------------- */\n  const Slot = useMemo(() => createSlot<ForwardRefExoticComponent<HtmlButtonProps>>(), []);\n  const MotionSlot = useMemo(() => m.create(Slot), [Slot]);\n\n  /* -------------------------------- Variants -------------------------------- */\n  const endVariant = endIcon ? 'icon' : 'hide';\n  const gapVariant = getGapVariant({ startIcon, endIcon, loading });\n  const startVariant = getStartVariant({ loading, startIcon });\n\n  const { palette: buttonPalette_DEPRECATED, variant: buttonVariant_DEPRECATED } = useMemo(\n    () => parseDeprecatedButtonPaletteVariant({ flatVariant: variant }),\n    [variant],\n  );\n\n  /* ---------------------------- Setup classNames ---------------------------- */\n  const classNames = useMemo(\n    () => ({\n      button: getStyles({\n        width,\n        buttonSize,\n        buttonVariant: buttonVariant_DEPRECATED,\n        buttonPalette: buttonPalette_DEPRECATED,\n        className: cx(\n          // Base class name\n          'uds-button',\n          // Focus ring\n          'uds-ring',\n          // Minimum hit target of 44px\n          'uds-hit-target',\n          // State\n          loading && 'uds-button-loading',\n          disableEffects && 'uds-button-without-effects',\n          gapVariant === 'withIcon' && 'uds-button-with-gap',\n\n          // Consumer class names\n          className,\n        ),\n      }),\n      content: 'uds-button-content truncate',\n      iconContainer: 'uds-button-icon-container flex overflow-clip',\n      loading: 'uds-button-icon start-content animate-spin',\n      start: 'uds-button-icon start-content',\n      end: 'uds-button-icon end-content',\n    }),\n    [\n      width,\n      buttonSize,\n      buttonVariant_DEPRECATED,\n      buttonPalette_DEPRECATED,\n      className,\n      loading,\n      disableEffects,\n      gapVariant,\n    ],\n  );\n\n  /* --------------------- Motion config setup for button --------------------- */\n  const prefersReducedMotion = useReducedMotion();\n  const layoutVariant: MotionVariant = prefersReducedMotion ? 'smooth' : 'subtle';\n\n  /* -------------------------- Start and end content ------------------------- */\n\n  /**\n   * TODO see if we can get these to work as ReactElements like (ie <StartContent />)\n   * Animations aren't currently propagating if I do that\n   **/\n\n  const startContent = useMemo(\n    () => (\n      <m.span\n        className={classNames.iconContainer}\n        initial={false}\n        variants={iconContainerMotionVariants}\n        animate={startVariant}\n      >\n        <AnimatePresence initial={false} mode=\"popLayout\">\n          {loading && (\n            <m.span\n              key=\"loading\"\n              variants={loadingMotionVariants}\n              initial=\"hide\"\n              animate=\"loading\"\n              exit=\"hide\"\n            >\n              <Icon\n                size={buttonIconSvgSize}\n                name={Progress}\n                variant={iconVariant}\n                color=\"current\"\n                className={classNames.loading}\n              />\n            </m.span>\n          )}\n          {startIcon && !loading && (\n            <m.span variants={iconMotionVariants} initial=\"hide\" animate=\"icon\" exit=\"hide\">\n              <IconSlot\n                className={classNames.start}\n                icon={startIcon}\n                iconProps={{\n                  size: buttonIconSvgSize,\n                  variant: iconVariant,\n                  color: 'current',\n                }}\n              />\n            </m.span>\n          )}\n        </AnimatePresence>\n      </m.span>\n    ),\n    [\n      classNames.iconContainer,\n      classNames.loading,\n      classNames.start,\n      startVariant,\n      loading,\n      iconVariant,\n      startIcon,\n    ],\n  );\n\n  const endContent = useMemo(\n    () => (\n      <m.span\n        className={classNames.iconContainer}\n        initial={false}\n        variants={iconContainerMotionVariants}\n        animate={endVariant}\n      >\n        <AnimatePresence initial={false} mode=\"popLayout\">\n          {endIcon && (\n            <m.span variants={iconMotionVariants} initial=\"hide\" animate=\"icon\" exit=\"hide\">\n              <IconSlot\n                className={classNames.end}\n                icon={endIcon}\n                iconProps={{\n                  size: buttonIconSvgSize,\n                  variant: iconVariant,\n                  color: 'current',\n                }}\n              />\n            </m.span>\n          )}\n        </AnimatePresence>\n      </m.span>\n    ),\n    [classNames.iconContainer, classNames.end, endIcon, endVariant, iconVariant],\n  );\n\n  const buttonVariants = useMemo(() => {\n    if (!disableEffects) {\n      return buttonMotionVariants;\n    }\n    return {\n      ...buttonMotionVariants,\n      rest: {},\n      hover: {},\n      pressed: {},\n    };\n  }, [disableEffects]);\n\n  /* -------------------------------------------------------------------------- */\n  /*                                 The button                                 */\n  /* -------------------------------------------------------------------------- */\n\n  /* ---------------------------------- TODO ---------------------------------- */\n  /* ----------------------------- Button asChild ----------------------------- */\n  /* ------------ Remove this cloneElement stuff when UD-734 lands ------------ */\n  if (asChild && isValidElement(children)) {\n    return (\n      <SpringMotionConfig layoutSpeed=\"3\" layoutVariant={layoutVariant}>\n        <MotionSlot\n          type={type}\n          className={classNames.button}\n          initial={['hide', gapVariant]}\n          animate={gapVariant}\n          variants={buttonVariants}\n          whileHover=\"hover\"\n          whileTap=\"pressed\"\n          {...rest}\n        >\n          {cloneElement(\n            children,\n            children.props,\n            <>\n              {startContent}\n              <span className={classNames.content}>{children.props.children}</span>\n              {endContent}\n            </>,\n          )}\n        </MotionSlot>\n      </SpringMotionConfig>\n    );\n  }\n  /* -------------------------------- End TODO -------------------------------- */\n\n  /* ----------------------------- Standard button ---------------------------- */\n  return (\n    <SpringMotionConfig layoutSpeed=\"3\" layoutVariant={layoutVariant}>\n      <m.button\n        ref={ref}\n        type={type}\n        className={classNames.button}\n        initial={['hide', gapVariant]}\n        animate={gapVariant}\n        variants={buttonVariants}\n        whileHover=\"hover\"\n        whileTap=\"pressed\"\n        {...rest}\n      >\n        {startContent}\n        <span className={classNames.content}>{children}</span>\n        {endContent}\n      </m.button>\n    </SpringMotionConfig>\n  );\n});\n\nButton.displayName = 'Button';\n\nexport { Button, type ButtonProps };\n"],"mappings":"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"}

package/dist/components/client/Checkbox.cjs

@@ -0,0 +1,215 @@
+"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_FormLabel = require('../FormLabel.cjs');
+const require_components_Icon = require('../Icon.cjs');
+const require_components_client_SpringMotionConfig = require('./SpringMotionConfig.cjs');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+let __yahoo_uds_icons = require("@yahoo/uds-icons");
+let motion_react = require("motion/react");
+
+//#region src/components/client/Checkbox.tsx
+const VARIANTS = ["primary", "secondary"];
+const SIZES = ["sm", "md"];
+const VARIANT_ERROR_MAP = {
+	primary: "alert",
+	secondary: "alert-secondary"
+};
+const isIndeterminate = (checked) => checked === "indeterminate";
+const getIcon = (checked) => {
+	if (isIndeterminate(checked)) return __yahoo_uds_icons.Minus;
+	return __yahoo_uds_icons.Check;
+};
+const MotionBox = motion_react.m.create(require_components_Box.Box);
+const hoverTransition = {
+	layoutVariant: "smooth",
+	layoutSpeed: "3"
+};
+const pressTransition = {
+	layoutVariant: "veryBouncy",
+	layoutSpeed: "4"
+};
+/**
+* **⚙️️ An checkbox.
+*
+* @componentType Client component
+*
+* @description
+* A checkbox component allows users to select one or multiple options from a set. It represents a binary state, typically as checked or unchecked, and optionally includes a third "indeterminate" state to indicate partial selection.
+*
+* @see
+* Check out the {@link https://uds.build/docs/components/checkbox Checkbox Docs} for more info
+*
+* @usage
+* - Forms: checkbox
+*
+* @example
+* ```tsx
+* 'use client';
+* import { Checkbox } from "@yahoo/uds";
+*
+* <Checkbox label="Name" required />
+*```
+*
+* @related [Radio](https://uds.build/docs/components/radio), [Switch](https://uds.build/docs/components/switch), [Input](https://uds.build/docs/components/input).
+**/
+const Checkbox = (0, react.forwardRef)(function Checkbox$1({ id, checked: checkedProp, defaultChecked, onChange, label, labelPosition = "start", variant: variantProp = "primary", size = "md", reduceMotion: forceReduceMotion, disabled, required, hasError, className, layerClassNames,...checkboxProps }, parentRef) {
+	const generatedId = (0, react.useId)();
+	const uid = id ?? `uds-input-${generatedId}`;
+	const innerRef = (0, react.useRef)(null);
+	/**
+	* State
+	*/
+	const isControlled = checkedProp !== void 0;
+	const [checked, setChecked] = (0, react.useState)(isControlled ? checkedProp : defaultChecked);
+	const [isHovered, setIsHovered] = (0, react.useState)(false);
+	const [isPressed, setIsPressed] = (0, react.useState)(false);
+	/**
+	* Derived values
+	*/
+	const variant = (0, react.useMemo)(() => hasError ? VARIANT_ERROR_MAP[variantProp] : variantProp, [hasError, variantProp]);
+	const showHoverEffect = !disabled && isHovered;
+	const showPressedEffect = !disabled && isPressed;
+	const scale = (0, react.useMemo)(() => {
+		if (showPressedEffect) return .9;
+		if (showHoverEffect) return 1.1;
+		return 1;
+	}, [showPressedEffect, showHoverEffect]);
+	const checkOpacity = (0, react.useMemo)(() => {
+		if (!checked) return "opacity-0";
+		if (showPressedEffect) return "opacity-55";
+		return "opacity-100";
+	}, [checked, showPressedEffect]);
+	const motionAnimate = (0, react.useMemo)(() => ({ scale }), [scale]);
+	const motionTransition = (0, react.useMemo)(() => isPressed ? pressTransition : hoverTransition, [isPressed]);
+	/**
+	* Handlers
+	*/
+	const handleChange = (0, react.useCallback)((e) => {
+		onChange?.(e);
+		if (!isControlled) setChecked(e.target.checked);
+	}, [isControlled, onChange]);
+	const handleHoverStart = (0, react.useCallback)(() => {
+		setIsHovered(true);
+	}, []);
+	const handleHoverEnd = (0, react.useCallback)(() => {
+		setIsHovered(false);
+	}, []);
+	const handleTapStart = (0, react.useCallback)(() => {
+		setIsPressed(true);
+	}, []);
+	const handleTapEnd = (0, react.useCallback)(() => {
+		setIsPressed(false);
+	}, []);
+	/**
+	* Helpers
+	*/
+	const setDOMIndeterminate = (checked_) => {
+		if (!innerRef.current) return;
+		innerRef.current.indeterminate = isIndeterminate(checked_);
+	};
+	const prefersReducedMotion = (0, motion_react.useReducedMotion)();
+	const reduceMotion = forceReduceMotion ? "always" : "user";
+	const cssAnimationDuration = prefersReducedMotion || forceReduceMotion ? "duration-0" : "duration-120";
+	/**
+	* Effects
+	*/
+	(0, react.useEffect)(() => {
+		if (isControlled) setChecked(checkedProp);
+	}, [checkedProp, isControlled]);
+	(0, react.useEffect)(() => {
+		setDOMIndeterminate(checked);
+	}, [checked]);
+	const valueState = isIndeterminate(checked) ? "indeterminate" : checked ? "checked" : "unchecked";
+	const classNames = {
+		root: require_styles_styler.getStyles({
+			checkboxSizeRoot: size,
+			checkboxVariantRoot: variant,
+			checkboxVariantValueRoot: valueState,
+			display: "flex",
+			flexDirection: labelPosition === "start" ? "row" : "row-reverse",
+			alignItems: "center",
+			className: require_styles_styler.cx({
+				"cursor-pointer": !disabled,
+				"cursor-default": disabled,
+				"opacity-50": disabled
+			}, className, layerClassNames?.root)
+		}),
+		checkbox: require_styles_styler.getStyles({
+			checkboxSizeCheckbox: size,
+			checkboxVariantCheckbox: variant,
+			checkboxVariantValueCheckbox: valueState,
+			className: require_styles_styler.cx("border", "rounded-[4px]", "uds-ring", "uds-ring-within", cssAnimationDuration, "transition-[background-color,border-color,box-shadow]", layerClassNames?.checkbox)
+		}),
+		check: require_styles_styler.getStyles({
+			checkboxVariantCheckboxIcon: variant,
+			checkboxVariantValueCheckboxIcon: valueState,
+			className: require_styles_styler.cx("pointer-events-none", checkOpacity, cssAnimationDuration, "transition-opacity")
+		}),
+		htmlCheckbox: require_styles_styler.cx("cursor-[inherit]", "absolute", "opacity-0", "top-1/2", "left-1/2", "w-[calc(100%+2px)]", "h-[calc(100%+2px)]", "transform", "translate-x-[-50%]", "translate-y-[-50%]"),
+		label: require_styles_styler.cx(labelPosition === "start" ? "text-start" : "text-end", layerClassNames?.label)
+	};
+	const RootElement = label ? motion_react.m.label : motion_react.m.div;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_client_SpringMotionConfig.SpringMotionConfig, {
+		reducedMotion: reduceMotion,
+		...motionTransition,
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(RootElement, {
+			className: classNames.root,
+			"data-testid": "container",
+			onHoverStart: handleHoverStart,
+			onHoverEnd: handleHoverEnd,
+			onTapStart: handleTapStart,
+			onTap: handleTapEnd,
+			onTapCancel: handleTapEnd,
+			tabIndex: -1,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(MotionBox, {
+				position: "relative",
+				className: classNames.checkbox,
+				alignItems: "center",
+				justifyContent: "center",
+				flex: "none",
+				animate: motionAnimate,
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+					type: "checkbox",
+					tabIndex: 0,
+					...checkboxProps,
+					ref: (ref) => {
+						innerRef.current = ref;
+						setDOMIndeterminate(checked);
+						if (typeof parentRef === "function") parentRef(ref);
+						else if (parentRef !== null) parentRef.current = ref;
+					},
+					id: uid,
+					disabled,
+					required,
+					"aria-invalid": hasError,
+					checked: isControlled ? isIndeterminate(checked) ? false : checked : void 0,
+					defaultChecked: isControlled ? void 0 : defaultChecked,
+					onChange: handleChange,
+					className: classNames.htmlCheckbox
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_Icon.Icon, {
+					name: getIcon(checked),
+					size: "sm",
+					className: classNames.check
+				})]
+			}), label && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_FormLabel.FormLabel, {
+				as: "div",
+				variant: "inherit",
+				color: "inherit",
+				required,
+				label,
+				className: classNames.label
+			})]
+		})
+	});
+});
+Checkbox.displayName = "Checkbox";
+
+//#endregion
+exports.Checkbox = Checkbox;
+exports.SIZES = SIZES;
+exports.VARIANTS = VARIANTS;

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

@@ -0,0 +1,43 @@
+import { UniversalCheckboxProps } from "../../tokens/types.cjs";
+import "../../tokens/index.cjs";
+import React from "react";
+
+//#region src/components/client/Checkbox.d.ts
+type NativeInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'size' | 'height' | 'width' | 'color'>;
+interface CheckboxProps extends NativeInputProps, UniversalCheckboxProps {
+  layerClassNames?: {
+    root?: string;
+    checkbox?: string;
+    label?: string;
+  };
+}
+declare const VARIANTS: ("secondary" | "primary")[];
+declare const SIZES: ("sm" | "md")[];
+/**
+ * **⚙️️ An checkbox.
+ *
+ * @componentType Client component
+ *
+ * @description
+ * A checkbox component allows users to select one or multiple options from a set. It represents a binary state, typically as checked or unchecked, and optionally includes a third "indeterminate" state to indicate partial selection.
+ *
+ * @see
+ * Check out the {@link https://uds.build/docs/components/checkbox Checkbox Docs} for more info
+ *
+ * @usage
+ * - Forms: checkbox
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Checkbox } from "@yahoo/uds";
+ *
+ * <Checkbox label="Name" required />
+ *```
+ *
+ * @related [Radio](https://uds.build/docs/components/radio), [Switch](https://uds.build/docs/components/switch), [Input](https://uds.build/docs/components/input).
+ **/
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+//#endregion
+export { Checkbox, type CheckboxProps, SIZES, VARIANTS };
+//# sourceMappingURL=Checkbox.d.cts.map

package/dist/components/client/Checkbox.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.d.cts","names":[],"sources":["../../../src/components/client/Checkbox.tsx"],"sourcesContent":[],"mappings":";;;;;KAiBK,gBAAA,CAAA,CAAA,CAAmB,KACtB,KAAA,CAAM,oBAAoB;UAMlB,aAAA,CAAA,OAAA,CAAsB,kBAAkB;;IAP7C,IAAA,CAAA,CAAA,CAAA,MAAA;IACuB,QAAA,CAAA,CAAA,CAAA,MAAA;IAApB,KAAA,CAAA,CAAA,CAAA,MAAA;EADgB,CAAA;;AAAI,OAAA,CAAA,KAAA,CAetB,QARkB,CAAA,CAAA,CAAA,CAAA,SAAA,CAAQ,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAkB;AAAsB,OAAA,CAAA,KAAA,CASlE,KAD+D,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA;AAAA,CAAA,CAAA;AAClB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;cA8C7C,UAAQ,KAAA,CAAA,0BAAA,gBAAA,KAAA,CAAA,cAAA"}

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

@@ -0,0 +1,43 @@
+import { UniversalCheckboxProps } from "../../tokens/types.js";
+import "../../tokens/index.js";
+import React from "react";
+
+//#region src/components/client/Checkbox.d.ts
+type NativeInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'size' | 'height' | 'width' | 'color'>;
+interface CheckboxProps extends NativeInputProps, UniversalCheckboxProps {
+  layerClassNames?: {
+    root?: string;
+    checkbox?: string;
+    label?: string;
+  };
+}
+declare const VARIANTS: ("secondary" | "primary")[];
+declare const SIZES: ("sm" | "md")[];
+/**
+ * **⚙️️ An checkbox.
+ *
+ * @componentType Client component
+ *
+ * @description
+ * A checkbox component allows users to select one or multiple options from a set. It represents a binary state, typically as checked or unchecked, and optionally includes a third "indeterminate" state to indicate partial selection.
+ *
+ * @see
+ * Check out the {@link https://uds.build/docs/components/checkbox Checkbox Docs} for more info
+ *
+ * @usage
+ * - Forms: checkbox
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { Checkbox } from "@yahoo/uds";
+ *
+ * <Checkbox label="Name" required />
+ *```
+ *
+ * @related [Radio](https://uds.build/docs/components/radio), [Switch](https://uds.build/docs/components/switch), [Input](https://uds.build/docs/components/input).
+ **/
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+//#endregion
+export { Checkbox, type CheckboxProps, SIZES, VARIANTS };
+//# sourceMappingURL=Checkbox.d.ts.map

package/dist/components/client/Checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.d.ts","names":[],"sources":["../../../src/components/client/Checkbox.tsx"],"sourcesContent":[],"mappings":";;;;;KAiBK,gBAAA,CAAA,CAAA,CAAmB,KACtB,KAAA,CAAM,oBAAoB;UAMlB,aAAA,CAAA,OAAA,CAAsB,kBAAkB;;IAP7C,IAAA,CAAA,CAAA,CAAA,MAAA;IACuB,QAAA,CAAA,CAAA,CAAA,MAAA;IAApB,KAAA,CAAA,CAAA,CAAA,MAAA;EADgB,CAAA;;AAAI,OAAA,CAAA,KAAA,CAetB,QARkB,CAAA,CAAA,CAAA,CAAA,SAAA,CAAQ,CAAA,CAAA,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAkB;AAAsB,OAAA,CAAA,KAAA,CASlE,KAD+D,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,CAAA;AAAA,CAAA,CAAA;AAClB,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,CAAA,EAAA,CAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;cA8C7C,UAAQ,KAAA,CAAA,0BAAA,gBAAA,KAAA,CAAA,cAAA"}