@yahoo/uds 3.48.0 → 3.49.0

package/cli/FlattenButtonVariant.mock.tsx

@@ -0,0 +1,17 @@
+import { Button, HStack, IconButton } from '@yahoo/uds';
+import { Cross } from '@yahoo/uds-icons';
+
+export const PageA = () => {
+  return (
+    <HStack>
+     <Button variant="brand-secondary">Click me</Button><IconButton name={Cross} />
+<Button variant="primary">Click me</Button><IconButton name={Cross} variant="primary" />
+<Button variant="secondary">Click me</Button><IconButton name={Cross} variant="brand" />
+<Button variant="warning-tertiary">Click me</Button><IconButton name={Cross} variant="brand-tertiary" />
+<Button>Click me</Button><IconButton name={Cross} />
+<Button variant="tertiary">Click me</Button><IconButton name={Cross} variant="brand-tertiary" />
+<Button variant="secondary">Click me</Button><IconButton name={Cross} variant="secondary" />
+<Button variant="tertiary">Click me</Button><IconButton name={Cross} variant="tertiary" />
+    </HStack>
+  );
+}

package/dist/{Box-MHJ0-0M3.d.ts → Box-Crrq6i4h.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { b as UniversalBoxProps } from './types-Da_DnBJy.js';
+import { b as UniversalBoxProps } from './types-wpDRhNL7.js';
 
 type DivProps = React.HTMLAttributes<HTMLDivElement>;
 interface BoxProps extends UniversalBoxProps, DivProps {

package/dist/{Box-BFRDyWaq.d.cts → Box-D3tacR6r.d.cts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { b as UniversalBoxProps } from './types-Da_DnBJy.cjs';
+import { b as UniversalBoxProps } from './types-wpDRhNL7.cjs';
 
 type DivProps = React.HTMLAttributes<HTMLDivElement>;
 interface BoxProps extends UniversalBoxProps, DivProps {

package/dist/Box-DSlj_nk4.d.ts

@@ -0,0 +1,34 @@
+import * as react from 'react';
+import { b as UniversalBoxProps } from './types-Cx4ERyM0.js';
+
+type DivProps = React.HTMLAttributes<HTMLDivElement>;
+interface BoxProps extends UniversalBoxProps, DivProps {
+}
+/**
+ * **📦 A layout component that can be used to compose other components**
+ *
+ * @description
+ * The most simple component we ship - a div. But with all the power of the UDS design system.
+ * By default, `Box` is a flexbox container. When working with vertical or horizontal layouts,
+ * consider using [VStack](./v-stack) or [HStack](./h-stack) respectively.
+ *
+ * @example
+ * ```tsx
+ * import { Box } from '@yahoo/uds';
+ *
+ * <Box backgroundColor="primary" spacing="6">
+ *   Any kind of content can go here!
+ * </Box>
+ * ```
+ *
+ * @usage
+ * - If you need to div-like container to apply padding, shapes, or other styling.
+ * - If you're creating card components.
+ *
+ * @see The {@link https://uds.build/docs/components/box Box Docs} for more info
+ *
+ * @related [HStack](https://uds.build/docs/components/h-stack), [VStack](https://uds.build/docs/components/v-stack)
+ */
+declare const Box: react.ForwardRefExoticComponent<BoxProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type BoxProps as B, type DivProps as D, Box as a };

package/dist/Box-DpyU-coK.d.cts

@@ -0,0 +1,34 @@
+import * as react from 'react';
+import { b as UniversalBoxProps } from './types-Cx4ERyM0.cjs';
+
+type DivProps = React.HTMLAttributes<HTMLDivElement>;
+interface BoxProps extends UniversalBoxProps, DivProps {
+}
+/**
+ * **📦 A layout component that can be used to compose other components**
+ *
+ * @description
+ * The most simple component we ship - a div. But with all the power of the UDS design system.
+ * By default, `Box` is a flexbox container. When working with vertical or horizontal layouts,
+ * consider using [VStack](./v-stack) or [HStack](./h-stack) respectively.
+ *
+ * @example
+ * ```tsx
+ * import { Box } from '@yahoo/uds';
+ *
+ * <Box backgroundColor="primary" spacing="6">
+ *   Any kind of content can go here!
+ * </Box>
+ * ```
+ *
+ * @usage
+ * - If you need to div-like container to apply padding, shapes, or other styling.
+ * - If you're creating card components.
+ *
+ * @see The {@link https://uds.build/docs/components/box Box Docs} for more info
+ *
+ * @related [HStack](https://uds.build/docs/components/h-stack), [VStack](https://uds.build/docs/components/v-stack)
+ */
+declare const Box: react.ForwardRefExoticComponent<BoxProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type BoxProps as B, type DivProps as D, Box as a };

package/dist/{Pressable-DVLHV--n.d.ts → Pressable-B6BLEH9a.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { a as UniversalPressableProps } from './types-Da_DnBJy.js';
+import { a as UniversalPressableProps } from './types-Cx4ERyM0.js';
 
 type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
 interface PressableProps extends UniversalPressableProps, HtmlButtonProps {

package/dist/Pressable-B_tUxlD9.d.ts

@@ -0,0 +1,44 @@
+import * as react from 'react';
+import { a as UniversalPressableProps } from './types-wpDRhNL7.js';
+
+type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
+interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
+}
+/**
+ * **🖲️ A primitive component for creating button interactions with accessibility support**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * The Pressable component is a primitive component that can be used
+ * to create button interactions with accessibility support. It can be used
+ * to trigger an action, such as submitting a form, navigating to a new page,
+ * or adding interactivity to a section or card.
+ *
+ * @example
+ * ```tsx
+ * import { Pressable } from '@yahoo/uds';
+ *
+ * <Pressable
+ *   backgroundColor="secondary"
+ *   borderWidth="thin"
+ *   borderColor="primary"
+ *   borderRadius="lg"
+ *   onPress={() => console.log('Pressed!')}
+ *  >
+ *    <Text variant="body1" color="primary" spacingHorizontal="7" spacingVertical="5">Click me...</Text>
+ * </Pressable>
+ * ```
+ *
+ * @usage
+ * - If you need to add interactivity to a section or card.
+ * - If you need a highly customized version of [Button](./button)
+ *
+ * @see The {@link https://uds.build/docs/components/pressable Pressable Docs} for more info
+ *
+ * @related [Button](https://uds.build/docs/components/button), [IconButton](https://uds.build/docs/components/icon-button)
+ *
+ */
+declare const Pressable: react.ForwardRefExoticComponent<PressableProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type PressableProps as P, Pressable as a };

package/dist/{Pressable-GdByxoJg.d.cts → Pressable-C1Csw_As.d.cts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { a as UniversalPressableProps } from './types-Da_DnBJy.cjs';
+import { a as UniversalPressableProps } from './types-wpDRhNL7.cjs';
 
 type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
 interface PressableProps extends UniversalPressableProps, HtmlButtonProps {

package/dist/Pressable-CSl68bNG.d.cts

@@ -0,0 +1,44 @@
+import * as react from 'react';
+import { a as UniversalPressableProps } from './types-Cx4ERyM0.cjs';
+
+type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
+interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
+}
+/**
+ * **🖲️ A primitive component for creating button interactions with accessibility support**
+ *
+ * @componentType Client component
+ *
+ * @description
+ * The Pressable component is a primitive component that can be used
+ * to create button interactions with accessibility support. It can be used
+ * to trigger an action, such as submitting a form, navigating to a new page,
+ * or adding interactivity to a section or card.
+ *
+ * @example
+ * ```tsx
+ * import { Pressable } from '@yahoo/uds';
+ *
+ * <Pressable
+ *   backgroundColor="secondary"
+ *   borderWidth="thin"
+ *   borderColor="primary"
+ *   borderRadius="lg"
+ *   onPress={() => console.log('Pressed!')}
+ *  >
+ *    <Text variant="body1" color="primary" spacingHorizontal="7" spacingVertical="5">Click me...</Text>
+ * </Pressable>
+ * ```
+ *
+ * @usage
+ * - If you need to add interactivity to a section or card.
+ * - If you need a highly customized version of [Button](./button)
+ *
+ * @see The {@link https://uds.build/docs/components/pressable Pressable Docs} for more info
+ *
+ * @related [Button](https://uds.build/docs/components/button), [IconButton](https://uds.build/docs/components/icon-button)
+ *
+ */
+declare const Pressable: react.ForwardRefExoticComponent<PressableProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type PressableProps as P, Pressable as a };

package/dist/{Text-Buzrh-6W.d.cts → Text-BAHkYEiK.d.cts}

@@ -1,4 +1,4 @@
-import { PropsWithChildren, ElementType, ReactNode, Ref } from 'react';
+import { PropsWithChildren, ElementType, ReactNode, ReactElement, Ref } from 'react';
 import { SvgIcon, IconSize, IconVariant } from '@yahoo/uds-icons/types';
 
 declare const alwaysPalette: {
@@ -216,7 +216,23 @@ type SVGElementProps = Omit<React.HTMLAttributes<SVGSVGElement>, 'color'>;
 interface IconPropsWithSVGProps extends UniversalIconProps, SVGElementProps {
 }
 type IconSlotRenderProps = Omit<IconPropsWithSVGProps, 'name'>;
-type UniversalIconSlot = SvgIcon | ReactNode | ((iconProps: IconSlotRenderProps) => ReactNode);
+/**
+ * We are changing the slot prop from ReactNode to ReactElement to avoid
+ * confusing and useless options like number and string, however,
+ * there are cases where folks are using null/undefined to dynamically opt-out
+ * of rendering the icon. We want to still allow that.
+ */
+type BackwardsCompatibleReactElement = null | undefined | ReactElement;
+/**
+ * Used anywhere we offer an icon which can be customized.
+ *
+ * Passing an SvgIcon is the happy path.
+ *
+ * @example
+ * import { Calendar } from "@yahoo/uds-icons"
+ * <IconSlot icon={Calendar} />
+ */
+type UniversalIconSlot = SvgIcon | BackwardsCompatibleReactElement | ((iconProps: IconSlotRenderProps) => BackwardsCompatibleReactElement);
 type SwitchSize = 'sm' | 'md';
 interface UniversalSwitchProps {
     /**

package/dist/{Text-Buzrh-6W.d.ts → Text-BAHkYEiK.d.ts}

@@ -1,4 +1,4 @@
-import { PropsWithChildren, ElementType, ReactNode, Ref } from 'react';
+import { PropsWithChildren, ElementType, ReactNode, ReactElement, Ref } from 'react';
 import { SvgIcon, IconSize, IconVariant } from '@yahoo/uds-icons/types';
 
 declare const alwaysPalette: {
@@ -216,7 +216,23 @@ type SVGElementProps = Omit<React.HTMLAttributes<SVGSVGElement>, 'color'>;
 interface IconPropsWithSVGProps extends UniversalIconProps, SVGElementProps {
 }
 type IconSlotRenderProps = Omit<IconPropsWithSVGProps, 'name'>;
-type UniversalIconSlot = SvgIcon | ReactNode | ((iconProps: IconSlotRenderProps) => ReactNode);
+/**
+ * We are changing the slot prop from ReactNode to ReactElement to avoid
+ * confusing and useless options like number and string, however,
+ * there are cases where folks are using null/undefined to dynamically opt-out
+ * of rendering the icon. We want to still allow that.
+ */
+type BackwardsCompatibleReactElement = null | undefined | ReactElement;
+/**
+ * Used anywhere we offer an icon which can be customized.
+ *
+ * Passing an SvgIcon is the happy path.
+ *
+ * @example
+ * import { Calendar } from "@yahoo/uds-icons"
+ * <IconSlot icon={Calendar} />
+ */
+type UniversalIconSlot = SvgIcon | BackwardsCompatibleReactElement | ((iconProps: IconSlotRenderProps) => BackwardsCompatibleReactElement);
 type SwitchSize = 'sm' | 'md';
 interface UniversalSwitchProps {
     /**

package/dist/{Text-IGbWWF7a.d.ts → Text-BE_L9lP2.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { Ref } from 'react';
-import { U as UniversalTextProps } from './types-Da_DnBJy.js';
+import { U as UniversalTextProps } from './types-Cx4ERyM0.js';
 
 type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
 type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';

package/dist/{Text-Bq5NiVYm.d.cts → Text-CsOioZGs.d.cts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { Ref } from 'react';
-import { U as UniversalTextProps } from './types-Da_DnBJy.cjs';
+import { U as UniversalTextProps } from './types-wpDRhNL7.cjs';
 
 type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
 type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';

package/dist/Text-CvY2JUUX.d.ts

@@ -0,0 +1,88 @@
+import * as react from 'react';
+import { Ref } from 'react';
+import { U as UniversalTextProps } from './types-wpDRhNL7.js';
+
+type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
+type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';
+type VariantWithInherit = Exclude<UniversalTextProps['variant'], undefined> | 'inherit';
+type TextProps<TagName extends TextElementTagName = TextElementTagName> = {
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TagName;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & JSX.IntrinsicElements[TagName] & Omit<UniversalTextProps, 'variant' | 'color'>;
+/**
+ * **💬 A text element that can be used to display text**
+ *
+ * @description
+ * By default, the `Text` component uses text primary color and selects the
+ * correct font, weight, and leading. It also choices appropriate semantic
+ * HTML element based on the `variant` prop. For example, `body1` will use a
+ * `<p>` tag, `title1` uses an `<h1>`, etc. This behavior can be overridden
+ * with the `as` prop.
+ *
+ *
+ * @example
+ * ```tsx
+ * import { Text } from '@yahoo/uds';
+ *
+ * <Text variant="body1" color="primary">
+ *   Text goes here
+ * </Text>
+ * ```
+ *
+ * @usage
+ * - Use `Text` to display text in your app.
+ * - Use `variant` to change the size and weight of the text.
+ * - Use `color` to change the color of the text.
+ * - Use `as` to change the HTML tag used to render the text.
+ *
+ * @see The {@link https://uds.build/docs/components/text Text Docs} for more info
+ */
+declare const Text: react.ForwardRefExoticComponent<(Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLElement> & react.HTMLAttributes<HTMLElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLHeadingElement> & react.HTMLAttributes<HTMLHeadingElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLLabelElement> & react.LabelHTMLAttributes<HTMLLabelElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLLIElement> & react.LiHTMLAttributes<HTMLLIElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLParagraphElement> & react.HTMLAttributes<HTMLParagraphElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLSpanElement> & react.HTMLAttributes<HTMLSpanElement> & Omit<UniversalTextProps, "color" | "variant">, "ref">) & react.RefAttributes<HTMLElement>>;
+
+export { Text as T, type TextProps as a };

package/dist/Text-DkshZZiK.d.cts

@@ -0,0 +1,88 @@
+import * as react from 'react';
+import { Ref } from 'react';
+import { U as UniversalTextProps } from './types-Cx4ERyM0.cjs';
+
+type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
+type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';
+type VariantWithInherit = Exclude<UniversalTextProps['variant'], undefined> | 'inherit';
+type TextProps<TagName extends TextElementTagName = TextElementTagName> = {
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TagName;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & JSX.IntrinsicElements[TagName] & Omit<UniversalTextProps, 'variant' | 'color'>;
+/**
+ * **💬 A text element that can be used to display text**
+ *
+ * @description
+ * By default, the `Text` component uses text primary color and selects the
+ * correct font, weight, and leading. It also choices appropriate semantic
+ * HTML element based on the `variant` prop. For example, `body1` will use a
+ * `<p>` tag, `title1` uses an `<h1>`, etc. This behavior can be overridden
+ * with the `as` prop.
+ *
+ *
+ * @example
+ * ```tsx
+ * import { Text } from '@yahoo/uds';
+ *
+ * <Text variant="body1" color="primary">
+ *   Text goes here
+ * </Text>
+ * ```
+ *
+ * @usage
+ * - Use `Text` to display text in your app.
+ * - Use `variant` to change the size and weight of the text.
+ * - Use `color` to change the color of the text.
+ * - Use `as` to change the HTML tag used to render the text.
+ *
+ * @see The {@link https://uds.build/docs/components/text Text Docs} for more info
+ */
+declare const Text: react.ForwardRefExoticComponent<(Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLElement> & react.HTMLAttributes<HTMLElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLHeadingElement> & react.HTMLAttributes<HTMLHeadingElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLLabelElement> & react.LabelHTMLAttributes<HTMLLabelElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLLIElement> & react.LiHTMLAttributes<HTMLLIElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLParagraphElement> & react.HTMLAttributes<HTMLParagraphElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
+    /** Ref passed to the inner container. */
+    ref?: Ref<HTMLElement>;
+    /** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
+    as?: TextElementTagName | undefined;
+    variant?: VariantWithInherit;
+    color?: ColorWithInherit;
+} & react.ClassAttributes<HTMLSpanElement> & react.HTMLAttributes<HTMLSpanElement> & Omit<UniversalTextProps, "color" | "variant">, "ref">) & react.RefAttributes<HTMLElement>>;
+
+export { Text as T, type TextProps as a };

package/dist/{VStack-UmkAYRN1.d.cts → VStack-BkfbZYlc.d.cts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { n as UniversalStackProps, o as UniversalDividerProps } from './types-Da_DnBJy.cjs';
-import { B as BoxProps, D as DivProps } from './Box-BFRDyWaq.cjs';
+import { n as UniversalStackProps, o as UniversalDividerProps } from './types-Cx4ERyM0.cjs';
+import { B as BoxProps, D as DivProps } from './Box-DpyU-coK.cjs';
 
 interface DividerCoreProps extends Omit<BoxProps, 'color' | 'borderColor' | 'borderWidth'>, Omit<UniversalStackProps, 'separator' | 'asChild'>, Omit<UniversalDividerProps, 'variant'> {
     layerClassNames?: {

package/dist/VStack-C33dVmTS.d.cts

@@ -0,0 +1,83 @@
+import * as react from 'react';
+import { n as UniversalStackProps, o as UniversalDividerProps } from './types-wpDRhNL7.cjs';
+import { B as BoxProps, D as DivProps } from './Box-D3tacR6r.cjs';
+
+interface DividerCoreProps extends Omit<BoxProps, 'color' | 'borderColor' | 'borderWidth'>, Omit<UniversalStackProps, 'separator' | 'asChild'>, Omit<UniversalDividerProps, 'variant'> {
+    layerClassNames?: {
+        root?: string;
+        text?: string;
+        line?: string;
+    };
+}
+
+type VariantWithInherit = Exclude<UniversalDividerProps['variant'], undefined> | 'inherit';
+interface DividerInternalProps extends DividerCoreProps {
+    variant?: VariantWithInherit;
+}
+
+type DividerProps = Omit<DividerInternalProps, 'layerClassNames'>;
+/**
+ * **📦 A divider component that can be used to visually separate components**
+ *
+ * @description
+ * The Divider component is a visual element used to separate content and create clear groupings within a layout. It helps establish hierarchy, improve readability, and guide users through sections of an interface. Dividers can appear as horizontal or vertical lines and are commonly used between related content blocks, within menus, or in dense UI areas to reduce visual clutter.
+ *
+ * @example
+ * ```tsx
+ * import { Divider } from '@yahoo/uds';
+ *
+ * // Default primary horizontal divider. Similar to <hr />
+ * <Divider />
+ *
+ * // A vertical divider.
+ * <Divider vertical />
+ *
+ * // A horizontal divider with the secondary styling.
+ * <Divider variant="secondary" />
+ *
+ * // A vertical divider with the tertiary styling.
+ * <Divider vertical variant="tertiary" />
+ * ```
+ *
+ * @usage
+ * - Visually separating parts of a page. Usually used in conjuction with [HStack](./h-stack) or [VStack](./v-stack).
+ *
+ * @see The {@link https://uds.build/docs/components/divider Divider Docs} for more info
+ *
+ * @related [Box](https://uds.build/docs/components/box), [HStack](https://uds.build/docs/components/h-stack), [VStack](https://uds.build/docs/components/v-stack)
+ */
+declare const Divider: react.ForwardRefExoticComponent<DividerProps & react.RefAttributes<HTMLDivElement>>;
+
+type VStackProps = UniversalStackProps & DivProps;
+/**
+ * **🥞 A layout component that arranges its children in rows using flexbox**
+ *
+ * @description
+ * VStack is a layout component that arranges its children in rows using [flexbox](https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Flexbox)
+ * and can be used to compose larger layouts. VStack is similar to [Box](./box) but provides additional features like a `gap` property to
+ * add spacing between children.
+ *
+ * @example
+ * ```tsx
+ * import { VStack, Text } from '@yahoo/uds';
+ *
+ * <VStack gap="6">
+ *   <Text variant="body1" color="primary">First</Text>
+ *   <Text variant="body1" color="primary">Second</Text>
+ *   <Text variant="body1" color="primary">Third</Text>
+ * </VStack>
+ * ```
+ *
+ * @usage
+ * - Create a column of items, optionally with gaps between.
+ * - Create rows that are sized to their content (height only). By default each child will fill the width of the VStack.
+ * - Create rows that fill the available space within the parent container.
+ * - Create rows of proportionate size to each other (also known as a ratio-based layout).
+ *
+ * @see The {@link https://uds.build/docs/components/v-stack VStack Docs} for more info
+ *
+ * @related [Box](https://uds.build/docs/components/box), [HStack](https://uds.build/docs/components/h-stack)
+ **/
+declare const VStack: react.ForwardRefExoticComponent<UniversalStackProps & DivProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type DividerProps as D, type VStackProps as V, Divider as a, VStack as b };

package/dist/{VStack-CppUZHJL.d.ts → VStack-C5UmhjZX.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
-import { n as UniversalStackProps, o as UniversalDividerProps } from './types-Da_DnBJy.js';
-import { B as BoxProps, D as DivProps } from './Box-MHJ0-0M3.js';
+import { n as UniversalStackProps, o as UniversalDividerProps } from './types-Cx4ERyM0.js';
+import { B as BoxProps, D as DivProps } from './Box-DSlj_nk4.js';
 
 interface DividerCoreProps extends Omit<BoxProps, 'color' | 'borderColor' | 'borderWidth'>, Omit<UniversalStackProps, 'separator' | 'asChild'>, Omit<UniversalDividerProps, 'variant'> {
     layerClassNames?: {