@yahoo/uds 3.161.0 → 3.162.1

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

@@ -0,0 +1,49 @@
+
+"use client";
+import { CheckboxVariant } from "../../../types/dist/index.js";
+import { getIcon } from "./checkboxConstants.js";
+import { CheckboxProps, CheckboxValueState, DataAttributes } from "./types.js";
+import React, { CSSProperties, ReactNode } from "react";
+
+//#region src/components/client/Checkbox/CheckboxBase.d.ts
+type ResolvedCheckboxVariant = CheckboxVariant | 'alert' | 'alert-secondary';
+type RenderRootArgs = {
+  className: string;
+  style?: CSSProperties;
+  rootSlotProps: DataAttributes;
+  hasLabel: boolean;
+  isPressed: boolean;
+  onHoverStart: () => void;
+  onHoverEnd: () => void;
+  onTapStart: () => void;
+  onTapEnd: () => void;
+  children: ReactNode;
+};
+type RenderIndicatorArgs = {
+  size: NonNullable<CheckboxProps['size']>;
+  variant: ResolvedCheckboxVariant;
+  valueState: CheckboxValueState;
+  checked: CheckboxProps['checked'];
+  disabled?: boolean;
+  showHoverEffect: boolean;
+  showPressedEffect: boolean;
+  cssAnimationDuration: string;
+  checkIcon: ReturnType<typeof getIcon>;
+  checkboxSlotProps: DataAttributes;
+  iconSlotProps: DataAttributes;
+  children: ReactNode;
+};
+type CheckboxBaseProps = CheckboxProps & {
+  cssAnimationDuration: string;
+  enableInteractionTracking?: boolean;
+  renderRoot: (args: RenderRootArgs) => ReactNode;
+  renderIndicator: (args: RenderIndicatorArgs) => ReactNode;
+};
+declare const CheckboxBase: React.ForwardRefExoticComponent<CheckboxProps & {
+  cssAnimationDuration: string;
+  enableInteractionTracking?: boolean;
+  renderRoot: (args: RenderRootArgs) => ReactNode;
+  renderIndicator: (args: RenderIndicatorArgs) => ReactNode;
+} & React.RefAttributes<HTMLInputElement>>;
+//#endregion
+export { CheckboxBase, type CheckboxBaseProps, type RenderIndicatorArgs, type RenderRootArgs, type ResolvedCheckboxVariant };

package/dist/components/client/Checkbox/CheckboxBase.js

@@ -0,0 +1,138 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { cx, getStyles } from "../../../styles/styler.js";
+import { FormLabel } from "../../FormLabel.js";
+import { VARIANT_ERROR_MAP, getIcon, isIndeterminate } from "./checkboxConstants.js";
+import { forwardRef, useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/client/Checkbox/CheckboxBase.tsx
+const CheckboxBase = forwardRef(function CheckboxBase({ id, checked: checkedProp, defaultChecked, onChange, label, labelPosition = "start", variant: variantProp = "primary", size = "md", reduceMotion: _reduceMotion, disabled, required, hasError, className, style, slotProps, cssAnimationDuration, enableInteractionTracking = false, renderRoot, renderIndicator, ...checkboxProps }, parentRef) {
+	const generatedId = useId();
+	const uid = id ?? `uds-input-${generatedId}`;
+	const rootSlotProps = slotProps?.root ?? {};
+	const checkboxSlotProps = slotProps?.checkbox ?? {};
+	const iconSlotProps = slotProps?.icon ?? {};
+	const labelSlotProps = slotProps?.label ?? {};
+	const innerRef = useRef(null);
+	/**
+	* State
+	*/
+	const isControlled = checkedProp !== void 0;
+	const [checked, setChecked] = useState(isControlled ? checkedProp : defaultChecked);
+	const [isHovered, setIsHovered] = useState(false);
+	const [isPressed, setIsPressed] = useState(false);
+	/**
+	* Derived values
+	*/
+	const variant = useMemo(() => hasError ? VARIANT_ERROR_MAP[variantProp] : variantProp, [hasError, variantProp]);
+	const showHoverEffect = enableInteractionTracking && !disabled && isHovered;
+	const showPressedEffect = enableInteractionTracking && !disabled && isPressed;
+	/**
+	* Handlers
+	*/
+	const handleChange = useCallback((e) => {
+		onChange?.(e);
+		if (!isControlled) setChecked(e.target.checked);
+	}, [isControlled, onChange]);
+	const handleHoverStart = useCallback(() => {
+		if (enableInteractionTracking) setIsHovered(true);
+	}, [enableInteractionTracking]);
+	const handleHoverEnd = useCallback(() => {
+		if (enableInteractionTracking) setIsHovered(false);
+	}, [enableInteractionTracking]);
+	const handleTapStart = useCallback(() => {
+		if (enableInteractionTracking) setIsPressed(true);
+	}, [enableInteractionTracking]);
+	const handleTapEnd = useCallback(() => {
+		if (enableInteractionTracking) setIsPressed(false);
+	}, [enableInteractionTracking]);
+	/**
+	* Helpers
+	*/
+	const setDOMIndeterminate = (checked_) => {
+		if (!innerRef.current) return;
+		innerRef.current.indeterminate = isIndeterminate(checked_);
+	};
+	/**
+	* Effects
+	*/
+	useEffect(() => {
+		if (isControlled) setChecked(checkedProp);
+	}, [checkedProp, isControlled]);
+	useEffect(() => {
+		setDOMIndeterminate(checked);
+	}, [checked]);
+	const valueState = isIndeterminate(checked) ? "indeterminate" : checked ? "checked" : "unchecked";
+	const classNames = {
+		root: getStyles({
+			checkboxSizeRoot: size,
+			checkboxVariantRoot: variant,
+			checkboxVariantValueRoot: valueState,
+			display: "flex",
+			flexDirection: labelPosition === "start" ? "row" : "row-reverse",
+			alignItems: "center",
+			className: cx({
+				"cursor-pointer": !disabled,
+				"cursor-default": disabled,
+				"opacity-50": disabled
+			}, className)
+		}),
+		htmlCheckbox: 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: cx(labelPosition === "start" ? "text-start" : "text-end")
+	};
+	const input = /* @__PURE__ */ 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
+	});
+	return renderRoot({
+		className: classNames.root,
+		style,
+		rootSlotProps,
+		hasLabel: Boolean(label),
+		isPressed,
+		onHoverStart: handleHoverStart,
+		onHoverEnd: handleHoverEnd,
+		onTapStart: handleTapStart,
+		onTapEnd: handleTapEnd,
+		children: /* @__PURE__ */ jsxs(Fragment$1, { children: [renderIndicator({
+			size,
+			variant,
+			valueState,
+			checked,
+			disabled,
+			showHoverEffect,
+			showPressedEffect,
+			cssAnimationDuration,
+			checkIcon: getIcon(checked),
+			checkboxSlotProps,
+			iconSlotProps,
+			children: input
+		}), label && /* @__PURE__ */ jsx(FormLabel, {
+			as: "div",
+			variant: "inherit",
+			color: "inherit",
+			required,
+			label,
+			className: classNames.label,
+			...labelSlotProps
+		})] })
+	});
+});
+CheckboxBase.displayName = "CheckboxBase";
+//#endregion
+export { CheckboxBase };

package/dist/components/client/Checkbox/checkboxConstants.cjs

@@ -0,0 +1,23 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../_virtual/_rolldown/runtime.cjs");
+let _yahoo_uds_icons = require("@yahoo/uds-icons");
+//#region src/components/client/Checkbox/checkboxConstants.ts
+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;
+};
+//#endregion
+exports.SIZES = SIZES;
+exports.VARIANTS = VARIANTS;
+exports.VARIANT_ERROR_MAP = VARIANT_ERROR_MAP;
+exports.getIcon = getIcon;
+exports.isIndeterminate = isIndeterminate;

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

@@ -0,0 +1,25 @@
+
+import { CheckboxValue, CheckboxVariant } from "../../../types/dist/index.cjs";
+import { IconVariant, SvgIconProps } from "../../../icons/dist/types.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Checkbox/checkboxConstants.d.ts
+declare const VARIANTS: ("primary" | "secondary")[];
+declare const SIZES: ("sm" | "md")[];
+declare const VARIANT_ERROR_MAP: Record<CheckboxVariant, 'alert' | 'alert-secondary'>;
+declare const isIndeterminate: (checked?: CheckboxValue) => checked is "indeterminate";
+declare const getIcon: (checked?: CheckboxValue) => {
+  ({
+    size,
+    variant
+  }: SvgIconProps): _$react_jsx_runtime0.JSX.Element;
+  metadata: {
+    name: string;
+    isSvgIcon: boolean;
+    variants: IconVariant[];
+    category: string;
+    tags: string[];
+  };
+};
+//#endregion
+export { SIZES, VARIANTS, VARIANT_ERROR_MAP, getIcon, isIndeterminate };

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

@@ -0,0 +1,26 @@
+
+"use client";
+import { CheckboxValue, CheckboxVariant } from "../../../types/dist/index.js";
+import { IconVariant, SvgIconProps } from "../../../icons/dist/types.js";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/client/Checkbox/checkboxConstants.d.ts
+declare const VARIANTS: ("primary" | "secondary")[];
+declare const SIZES: ("sm" | "md")[];
+declare const VARIANT_ERROR_MAP: Record<CheckboxVariant, 'alert' | 'alert-secondary'>;
+declare const isIndeterminate: (checked?: CheckboxValue) => checked is "indeterminate";
+declare const getIcon: (checked?: CheckboxValue) => {
+  ({
+    size,
+    variant
+  }: SvgIconProps): _$react_jsx_runtime0.JSX.Element;
+  metadata: {
+    name: string;
+    isSvgIcon: boolean;
+    variants: IconVariant[];
+    category: string;
+    tags: string[];
+  };
+};
+//#endregion
+export { SIZES, VARIANTS, VARIANT_ERROR_MAP, getIcon, isIndeterminate };

package/dist/components/client/Checkbox/checkboxConstants.js

@@ -0,0 +1,17 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { Check, Minus } from "@yahoo/uds-icons";
+//#region src/components/client/Checkbox/checkboxConstants.ts
+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 Minus;
+	return Check;
+};
+//#endregion
+export { SIZES, VARIANTS, VARIANT_ERROR_MAP, getIcon, isIndeterminate };

package/dist/components/client/Checkbox/index.cjs

@@ -0,0 +1,10 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_components_client_Checkbox_checkboxConstants = require("./checkboxConstants.cjs");
+const require_components_client_Checkbox_CheckboxBase = require("./CheckboxBase.cjs");
+const require_components_client_Checkbox_Checkbox = require("./Checkbox.cjs");
+exports.Checkbox = require_components_client_Checkbox_Checkbox.Checkbox;
+exports.CheckboxBase = require_components_client_Checkbox_CheckboxBase.CheckboxBase;
+exports.SIZES = require_components_client_Checkbox_checkboxConstants.SIZES;
+exports.VARIANTS = require_components_client_Checkbox_checkboxConstants.VARIANTS;

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

@@ -0,0 +1,6 @@
+
+import { SIZES, VARIANTS } from "./checkboxConstants.cjs";
+import { CheckboxChangeEvent, CheckboxValueState, DataAttributes } from "./types.cjs";
+import { Checkbox, CheckboxProps } from "./Checkbox.cjs";
+import { CheckboxBase, CheckboxBaseProps } from "./CheckboxBase.cjs";
+export { Checkbox, CheckboxBase, type CheckboxBaseProps, type CheckboxChangeEvent, type CheckboxProps, type CheckboxValueState, type DataAttributes, SIZES, VARIANTS };

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

@@ -0,0 +1,7 @@
+
+"use client";
+import { SIZES, VARIANTS } from "./checkboxConstants.js";
+import { CheckboxChangeEvent, CheckboxValueState, DataAttributes } from "./types.js";
+import { Checkbox, CheckboxProps } from "./Checkbox.js";
+import { CheckboxBase, CheckboxBaseProps } from "./CheckboxBase.js";
+export { Checkbox, CheckboxBase, type CheckboxBaseProps, type CheckboxChangeEvent, type CheckboxProps, type CheckboxValueState, type DataAttributes, SIZES, VARIANTS };

package/dist/components/client/Checkbox/index.js

@@ -0,0 +1,6 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";
+import { SIZES, VARIANTS } from "./checkboxConstants.js";
+import { CheckboxBase } from "./CheckboxBase.js";
+import { Checkbox } from "./Checkbox.js";
+export { Checkbox, CheckboxBase, SIZES, VARIANTS };

package/dist/components/client/Checkbox/types.cjs

@@ -0,0 +1,2 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";

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

@@ -0,0 +1,22 @@
+
+import { UniversalCheckboxProps } from "../../../types/dist/index.cjs";
+import React, { ChangeEvent } from "react";
+
+//#region src/components/client/Checkbox/types.d.ts
+type DataAttributes = {
+  [name: `data-${string}`]: string;
+};
+type NativeInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'size' | 'height' | 'width' | 'color'>;
+type CheckboxChangeEvent = ChangeEvent<HTMLInputElement>;
+type CheckboxValueState = 'checked' | 'unchecked' | 'indeterminate';
+interface CheckboxProps extends NativeInputProps, UniversalCheckboxProps {
+  /** Props to be passed into various slots within the component. */
+  slotProps?: {
+    root?: DataAttributes;
+    checkbox?: DataAttributes;
+    icon?: DataAttributes;
+    label?: DataAttributes;
+  };
+}
+//#endregion
+export { type CheckboxChangeEvent, type CheckboxProps, type CheckboxValueState, type DataAttributes, type NativeInputProps };

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

@@ -0,0 +1,23 @@
+
+"use client";
+import { UniversalCheckboxProps } from "../../../types/dist/index.js";
+import React, { ChangeEvent } from "react";
+
+//#region src/components/client/Checkbox/types.d.ts
+type DataAttributes = {
+  [name: `data-${string}`]: string;
+};
+type NativeInputProps = Omit<React.InputHTMLAttributes<HTMLInputElement>, 'type' | 'checked' | 'size' | 'height' | 'width' | 'color'>;
+type CheckboxChangeEvent = ChangeEvent<HTMLInputElement>;
+type CheckboxValueState = 'checked' | 'unchecked' | 'indeterminate';
+interface CheckboxProps extends NativeInputProps, UniversalCheckboxProps {
+  /** Props to be passed into various slots within the component. */
+  slotProps?: {
+    root?: DataAttributes;
+    checkbox?: DataAttributes;
+    icon?: DataAttributes;
+    label?: DataAttributes;
+  };
+}
+//#endregion
+export { type CheckboxChangeEvent, type CheckboxProps, type CheckboxValueState, type DataAttributes, type NativeInputProps };

package/dist/components/client/Checkbox/types.js

@@ -0,0 +1,2 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+"use client";

package/dist/components/client/Popover/UDSPopoverConfigProvider.d.cts

@@ -29,7 +29,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion

package/dist/components/client/Popover/UDSPopoverConfigProvider.d.ts

@@ -30,7 +30,7 @@ declare function usePopoverConfig(sizeProp?: PopoverSize | undefined, variantPro
   gap: SpacingAlias;
   dismissButtonSpacing: SpacingAlias;
   dismissIconSize: number;
-  ariaKitPlacement: ("bottom-start" | "bottom-end" | "top-start" | "top-end" | ("bottom" | "left" | "right" | "top") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
+  ariaKitPlacement: ("top-start" | "top-end" | "bottom-start" | "bottom-end" | ("top" | "bottom" | "left" | "right") | "left-start" | "right-start" | "left-end" | "right-end") | undefined;
   animationDuration: number;
 };
 //#endregion