@yahoo/uds 3.37.0 → 3.39.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{Box-BM08iUR2.d.cts → Box-B2DvoAMD.d.cts} +1 -1
- package/dist/{Box-D2_1_jHu.d.ts → Box-C5GwvlME.d.ts} +1 -1
- package/dist/Box-CJ3zIj4N.d.cts +34 -0
- package/dist/Box-DggpNHav.d.ts +34 -0
- package/dist/{Pressable-CZHF_iLZ.d.cts → Pressable-BbJdaJUo.d.cts} +1 -1
- package/dist/Pressable-CE-tEoUc.d.cts +44 -0
- package/dist/{Pressable-SmBC4IjK.d.ts → Pressable-CogcHtMQ.d.ts} +1 -1
- package/dist/Pressable-DEuYwe7j.d.ts +44 -0
- package/dist/Text-CgQcjNy7.d.cts +139 -0
- package/dist/Text-Cghi693U.d.ts +139 -0
- package/dist/Text-CoY1WLeq.d.ts +139 -0
- package/dist/Text-DDathn4e.d.cts +139 -0
- package/dist/{VStack-DQsyv2sb.d.cts → VStack-BrpD0qUH.d.cts} +2 -2
- package/dist/VStack-CIUJgL-7.d.cts +83 -0
- package/dist/{VStack-D-3cxbIi.d.ts → VStack-Cpgnc5oS.d.ts} +2 -2
- package/dist/VStack-_eM5ET03.d.ts +83 -0
- package/dist/chunk-2FN7PYW3.cjs +1 -0
- package/dist/{chunk-6SQQBVSA.js → chunk-3NOPVRK3.js} +1 -1
- package/dist/{chunk-PNL4K4BQ.cjs → chunk-AX4IA6TK.cjs} +1 -1
- package/dist/chunk-BCRZ2EQO.js +2 -0
- package/dist/chunk-CWG6VECG.cjs +2 -0
- package/dist/chunk-CZH6WYYG.cjs +1 -0
- package/dist/chunk-DCZLRK3J.js +2 -0
- package/dist/chunk-ELVRZONR.cjs +1 -0
- package/dist/chunk-IVKGRXGB.cjs +1 -0
- package/dist/chunk-JP3JNLAD.js +2 -0
- package/dist/{chunk-4A2ZIK3D.cjs → chunk-KL36KHMK.cjs} +1 -1
- package/dist/{chunk-KPGAKQEP.js → chunk-KTN43MAD.js} +1 -1
- package/dist/{chunk-EXYFDTFM.js → chunk-LITEZHOE.js} +1 -1
- package/dist/chunk-NUOTAOOJ.js +2 -0
- package/dist/{chunk-VQV2OVOZ.cjs → chunk-NVU2HHNL.cjs} +1 -1
- package/dist/{chunk-F7LPH2UL.cjs → chunk-OIDUOWWP.cjs} +1 -1
- package/dist/chunk-PQNUKUFA.js +1 -0
- package/dist/chunk-QF6YIMT4.js +2 -0
- package/dist/{chunk-YBIQ3S5G.cjs → chunk-QFCUUITW.cjs} +1 -1
- package/dist/chunk-S5NRWKDP.cjs +1 -0
- package/dist/chunk-SPTEOB2R.cjs +2 -0
- package/dist/chunk-ST7Z3YRS.js +2 -0
- package/dist/{chunk-QZIQVD63.js → chunk-UAN7HYYD.js} +1 -1
- package/dist/chunk-VDZOZV5O.js +3 -0
- package/dist/chunk-VGS2HJDD.js +1 -0
- package/dist/chunk-VQ4KEVVH.cjs +1 -0
- package/dist/{chunk-QQ7BRHDQ.js → chunk-WPPJ6CMJ.js} +1 -1
- package/dist/chunk-Y5HRSSOF.cjs +1 -0
- package/dist/{chunk-I7ZFG4YT.js → chunk-ZEQ3QOPP.js} +1 -1
- package/dist/chunk-ZJIWHNVT.cjs +2 -0
- package/dist/client/Menu.cjs +2 -2
- package/dist/client/Menu.d.cts +4 -4
- package/dist/client/Menu.d.ts +4 -4
- package/dist/client/Menu.js +2 -2
- package/dist/client/index.cjs +1 -1
- package/dist/client/index.d.cts +63 -38
- package/dist/client/index.d.ts +63 -38
- package/dist/client/index.js +1 -1
- package/dist/defaultTokensConfig.d.cts +2 -2
- package/dist/defaultTokensConfig.d.ts +2 -2
- package/dist/experimental/client/SwitchV2.cjs +2 -1
- package/dist/experimental/client/SwitchV2.d.cts +1 -1
- package/dist/experimental/client/SwitchV2.d.ts +1 -1
- package/dist/experimental/client/SwitchV2.js +2 -1
- package/dist/experimental/client/index.cjs +2 -2
- package/dist/experimental/client/index.d.cts +1 -1
- package/dist/experimental/client/index.d.ts +1 -1
- package/dist/experimental/client/index.js +1 -1
- package/dist/experimental/index.cjs +2 -3
- package/dist/experimental/index.d.cts +2 -5
- package/dist/experimental/index.d.ts +2 -5
- package/dist/experimental/index.js +2 -2
- package/dist/{index-CqizU-UO.d.cts → index-BNV_bpqb.d.cts} +1 -1
- package/dist/index-DE7BJVEA.d.cts +245 -0
- package/dist/index-DviXR06Z.d.ts +245 -0
- package/dist/{index-Dn2pubkn.d.ts → index-uVTfvIWD.d.ts} +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +22 -79
- package/dist/index.d.ts +22 -79
- package/dist/index.js +1 -1
- package/dist/metafile-cjs.json +1 -1
- package/dist/metafile-esm.json +1 -1
- package/dist/tailwind/plugin.d.cts +1 -1
- package/dist/tailwind/plugin.d.ts +1 -1
- package/dist/tailwind/purger.cjs +1 -1
- package/dist/tailwind/purger.js +1 -1
- package/dist/tailwind/utils.d.cts +1 -1
- package/dist/tailwind/utils.d.ts +1 -1
- package/dist/tokens/automation/configs.d.cts +2 -2
- package/dist/tokens/automation/configs.d.ts +2 -2
- package/dist/tokens/automation/properties.d.cts +2 -2
- package/dist/tokens/automation/properties.d.ts +2 -2
- package/dist/tokens/index.d.cts +4 -4
- package/dist/tokens/index.d.ts +4 -4
- package/dist/tokens/parseTokens.d.cts +1 -1
- package/dist/tokens/parseTokens.d.ts +1 -1
- package/dist/{types-D0Rkj_1F.d.cts → types-BEsEvo0F.d.cts} +2032 -2031
- package/dist/{types-D0Rkj_1F.d.ts → types-BEsEvo0F.d.ts} +2032 -2031
- package/dist/types-rZt8SiS0.d.cts +10586 -0
- package/dist/types-rZt8SiS0.d.ts +10586 -0
- package/package.json +1 -1
- package/cli/FullWidthClassToProp.mock.tsx +0 -17
- package/dist/Input-C267CIVV.d.cts +0 -54
- package/dist/Input-CF4Kpe9f.d.ts +0 -54
- package/dist/chunk-JM4WTJDB.cjs +0 -3
- package/dist/{Box-DLjI-1wX.d.ts → Text-Buzrh-6W.d.cts} +4 -4
- package/dist/{Box-DLjI-1wX.d.cts → Text-Buzrh-6W.d.ts} +4 -4
@@ -1,5 +1,5 @@
|
|
1
1
|
import * as react from 'react';
|
2
|
-
import {
|
2
|
+
import { a as UniversalBoxProps } from './types-rZt8SiS0.cjs';
|
3
3
|
|
4
4
|
type DivProps = React.HTMLAttributes<HTMLDivElement>;
|
5
5
|
interface BoxProps extends UniversalBoxProps, DivProps {
|
@@ -1,5 +1,5 @@
|
|
1
1
|
import * as react from 'react';
|
2
|
-
import {
|
2
|
+
import { a as UniversalBoxProps } from './types-rZt8SiS0.js';
|
3
3
|
|
4
4
|
type DivProps = React.HTMLAttributes<HTMLDivElement>;
|
5
5
|
interface BoxProps extends UniversalBoxProps, DivProps {
|
@@ -0,0 +1,34 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { a as UniversalBoxProps } from './types-BEsEvo0F.cjs';
|
3
|
+
|
4
|
+
type DivProps = React.HTMLAttributes<HTMLDivElement>;
|
5
|
+
interface BoxProps extends UniversalBoxProps, DivProps {
|
6
|
+
}
|
7
|
+
/**
|
8
|
+
* **📦 A layout component that can be used to compose other components**
|
9
|
+
*
|
10
|
+
* @description
|
11
|
+
* The most simple component we ship - a div. But with all the power of the UDS design system.
|
12
|
+
* By default, `Box` is a flexbox container. When working with vertical or horizontal layouts,
|
13
|
+
* consider using [VStack](./v-stack) or [HStack](./h-stack) respectively.
|
14
|
+
*
|
15
|
+
* @example
|
16
|
+
* ```tsx
|
17
|
+
* import { Box } from '@yahoo/uds';
|
18
|
+
*
|
19
|
+
* <Box backgroundColor="primary" spacing="6">
|
20
|
+
* Any kind of content can go here!
|
21
|
+
* </Box>
|
22
|
+
* ```
|
23
|
+
*
|
24
|
+
* @usage
|
25
|
+
* - If you need to div-like container to apply padding, shapes, or other styling.
|
26
|
+
* - If you're creating card components.
|
27
|
+
*
|
28
|
+
* @see The {@link https://uds.build/docs/components/box Box Docs} for more info
|
29
|
+
*
|
30
|
+
* @related [HStack](https://uds.build/docs/components/h-stack), [VStack](https://uds.build/docs/components/v-stack)
|
31
|
+
*/
|
32
|
+
declare const Box: react.ForwardRefExoticComponent<BoxProps & react.RefAttributes<HTMLDivElement>>;
|
33
|
+
|
34
|
+
export { type BoxProps as B, type DivProps as D, Box as a };
|
@@ -0,0 +1,34 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { a as UniversalBoxProps } from './types-BEsEvo0F.js';
|
3
|
+
|
4
|
+
type DivProps = React.HTMLAttributes<HTMLDivElement>;
|
5
|
+
interface BoxProps extends UniversalBoxProps, DivProps {
|
6
|
+
}
|
7
|
+
/**
|
8
|
+
* **📦 A layout component that can be used to compose other components**
|
9
|
+
*
|
10
|
+
* @description
|
11
|
+
* The most simple component we ship - a div. But with all the power of the UDS design system.
|
12
|
+
* By default, `Box` is a flexbox container. When working with vertical or horizontal layouts,
|
13
|
+
* consider using [VStack](./v-stack) or [HStack](./h-stack) respectively.
|
14
|
+
*
|
15
|
+
* @example
|
16
|
+
* ```tsx
|
17
|
+
* import { Box } from '@yahoo/uds';
|
18
|
+
*
|
19
|
+
* <Box backgroundColor="primary" spacing="6">
|
20
|
+
* Any kind of content can go here!
|
21
|
+
* </Box>
|
22
|
+
* ```
|
23
|
+
*
|
24
|
+
* @usage
|
25
|
+
* - If you need to div-like container to apply padding, shapes, or other styling.
|
26
|
+
* - If you're creating card components.
|
27
|
+
*
|
28
|
+
* @see The {@link https://uds.build/docs/components/box Box Docs} for more info
|
29
|
+
*
|
30
|
+
* @related [HStack](https://uds.build/docs/components/h-stack), [VStack](https://uds.build/docs/components/v-stack)
|
31
|
+
*/
|
32
|
+
declare const Box: react.ForwardRefExoticComponent<BoxProps & react.RefAttributes<HTMLDivElement>>;
|
33
|
+
|
34
|
+
export { type BoxProps as B, type DivProps as D, Box as a };
|
@@ -1,5 +1,5 @@
|
|
1
1
|
import * as react from 'react';
|
2
|
-
import {
|
2
|
+
import { U as UniversalPressableProps } from './types-rZt8SiS0.cjs';
|
3
3
|
|
4
4
|
type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
|
5
5
|
interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
|
@@ -0,0 +1,44 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { U as UniversalPressableProps } from './types-BEsEvo0F.cjs';
|
3
|
+
|
4
|
+
type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
|
5
|
+
interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
|
6
|
+
}
|
7
|
+
/**
|
8
|
+
* **🖲️ A primitive component for creating button interactions with accessibility support**
|
9
|
+
*
|
10
|
+
* @componentType Client component
|
11
|
+
*
|
12
|
+
* @description
|
13
|
+
* The Pressable component is a primitive component that can be used
|
14
|
+
* to create button interactions with accessibility support. It can be used
|
15
|
+
* to trigger an action, such as submitting a form, navigating to a new page,
|
16
|
+
* or adding interactivity to a section or card.
|
17
|
+
*
|
18
|
+
* @example
|
19
|
+
* ```tsx
|
20
|
+
* import { Pressable } from '@yahoo/uds';
|
21
|
+
*
|
22
|
+
* <Pressable
|
23
|
+
* backgroundColor="secondary"
|
24
|
+
* borderWidth="thin"
|
25
|
+
* borderColor="primary"
|
26
|
+
* borderRadius="lg"
|
27
|
+
* onPress={() => console.log('Pressed!')}
|
28
|
+
* >
|
29
|
+
* <Text variant="body1" color="primary" spacingHorizontal="7" spacingVertical="5">Click me...</Text>
|
30
|
+
* </Pressable>
|
31
|
+
* ```
|
32
|
+
*
|
33
|
+
* @usage
|
34
|
+
* - If you need to add interactivity to a section or card.
|
35
|
+
* - If you need a highly customized version of [Button](./button)
|
36
|
+
*
|
37
|
+
* @see The {@link https://uds.build/docs/components/pressable Pressable Docs} for more info
|
38
|
+
*
|
39
|
+
* @related [Button](https://uds.build/docs/components/button), [IconButton](https://uds.build/docs/components/icon-button)
|
40
|
+
*
|
41
|
+
*/
|
42
|
+
declare const Pressable: react.ForwardRefExoticComponent<PressableProps & react.RefAttributes<HTMLButtonElement>>;
|
43
|
+
|
44
|
+
export { type PressableProps as P, Pressable as a };
|
@@ -1,5 +1,5 @@
|
|
1
1
|
import * as react from 'react';
|
2
|
-
import {
|
2
|
+
import { U as UniversalPressableProps } from './types-BEsEvo0F.js';
|
3
3
|
|
4
4
|
type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
|
5
5
|
interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
|
@@ -0,0 +1,44 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { U as UniversalPressableProps } from './types-rZt8SiS0.js';
|
3
|
+
|
4
|
+
type HtmlButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'color' | 'name'>;
|
5
|
+
interface PressableProps extends UniversalPressableProps, HtmlButtonProps {
|
6
|
+
}
|
7
|
+
/**
|
8
|
+
* **🖲️ A primitive component for creating button interactions with accessibility support**
|
9
|
+
*
|
10
|
+
* @componentType Client component
|
11
|
+
*
|
12
|
+
* @description
|
13
|
+
* The Pressable component is a primitive component that can be used
|
14
|
+
* to create button interactions with accessibility support. It can be used
|
15
|
+
* to trigger an action, such as submitting a form, navigating to a new page,
|
16
|
+
* or adding interactivity to a section or card.
|
17
|
+
*
|
18
|
+
* @example
|
19
|
+
* ```tsx
|
20
|
+
* import { Pressable } from '@yahoo/uds';
|
21
|
+
*
|
22
|
+
* <Pressable
|
23
|
+
* backgroundColor="secondary"
|
24
|
+
* borderWidth="thin"
|
25
|
+
* borderColor="primary"
|
26
|
+
* borderRadius="lg"
|
27
|
+
* onPress={() => console.log('Pressed!')}
|
28
|
+
* >
|
29
|
+
* <Text variant="body1" color="primary" spacingHorizontal="7" spacingVertical="5">Click me...</Text>
|
30
|
+
* </Pressable>
|
31
|
+
* ```
|
32
|
+
*
|
33
|
+
* @usage
|
34
|
+
* - If you need to add interactivity to a section or card.
|
35
|
+
* - If you need a highly customized version of [Button](./button)
|
36
|
+
*
|
37
|
+
* @see The {@link https://uds.build/docs/components/pressable Pressable Docs} for more info
|
38
|
+
*
|
39
|
+
* @related [Button](https://uds.build/docs/components/button), [IconButton](https://uds.build/docs/components/icon-button)
|
40
|
+
*
|
41
|
+
*/
|
42
|
+
declare const Pressable: react.ForwardRefExoticComponent<PressableProps & react.RefAttributes<HTMLButtonElement>>;
|
43
|
+
|
44
|
+
export { type PressableProps as P, Pressable as a };
|
@@ -0,0 +1,139 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { InputHTMLAttributes, Ref } from 'react';
|
3
|
+
import { l as UniversalInputProps, m as IconPropsWithSVGProps, n as UniversalTextProps } from './types-rZt8SiS0.cjs';
|
4
|
+
import { HTMLMotionProps } from 'motion/react';
|
5
|
+
import { B as BoxProps } from './Box-B2DvoAMD.cjs';
|
6
|
+
|
7
|
+
type HtmlInputProps = React.InputHTMLAttributes<HTMLInputElement> & HTMLMotionProps<'input'>;
|
8
|
+
type NativeInputProps = Omit<HtmlInputProps, 'height' | 'size' | 'width' | 'color' | 'required'>;
|
9
|
+
type DataAttributes = {
|
10
|
+
[name: `data-${string}`]: string;
|
11
|
+
};
|
12
|
+
interface InputProps extends NativeInputProps, UniversalInputProps {
|
13
|
+
/** The type of the input element. Reduced set of options from the HTML input type attribute.
|
14
|
+
* @default 'text'
|
15
|
+
*/
|
16
|
+
type?: Exclude<NativeInputProps['type'], 'button' | 'checkbox' | 'color' | 'file' | 'radio' | 'range' | 'reset' | 'submit' | 'search'>;
|
17
|
+
/** Props to be passed into various slots within the component. */
|
18
|
+
slotProps?: {
|
19
|
+
input?: Partial<InputHTMLAttributes<HTMLInputElement> & DataAttributes>;
|
20
|
+
inputWrapper?: Partial<BoxProps & DataAttributes>;
|
21
|
+
startIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
22
|
+
endIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
23
|
+
};
|
24
|
+
}
|
25
|
+
/**
|
26
|
+
* **📦 An input that allows users to enter text and collect data.**
|
27
|
+
*
|
28
|
+
* @componentType Client component
|
29
|
+
*
|
30
|
+
* @description
|
31
|
+
* 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.
|
32
|
+
*
|
33
|
+
* @see
|
34
|
+
* Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
|
35
|
+
*
|
36
|
+
* @usage
|
37
|
+
* - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
|
38
|
+
* - Search Bars: Allowing users to enter search queries to find content.
|
39
|
+
* - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
|
40
|
+
* - Feedback/Comments: Letting users leave reviews, comments, or feedback.
|
41
|
+
*
|
42
|
+
* @example
|
43
|
+
* ```tsx
|
44
|
+
* 'use client';
|
45
|
+
* import { Input } from "@yahoo/uds";
|
46
|
+
*
|
47
|
+
* <Input label="Name" placeholder="Enter your name" required />
|
48
|
+
*```
|
49
|
+
*
|
50
|
+
* @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
|
51
|
+
**/
|
52
|
+
declare const Input: react.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
|
53
|
+
|
54
|
+
type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
|
55
|
+
type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';
|
56
|
+
type VariantWithInherit = Exclude<UniversalTextProps['variant'], undefined> | 'inherit';
|
57
|
+
type TextProps<TagName extends TextElementTagName = TextElementTagName> = {
|
58
|
+
/** Ref passed to the inner container. */
|
59
|
+
ref?: Ref<HTMLElement>;
|
60
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
61
|
+
as?: TagName;
|
62
|
+
variant?: VariantWithInherit;
|
63
|
+
color?: ColorWithInherit;
|
64
|
+
} & JSX.IntrinsicElements[TagName] & Omit<UniversalTextProps, 'variant' | 'color'>;
|
65
|
+
/**
|
66
|
+
* **💬 A text element that can be used to display text**
|
67
|
+
*
|
68
|
+
* @description
|
69
|
+
* By default, the `Text` component uses text primary color and selects the
|
70
|
+
* correct font, weight, and leading. It also choices appropriate semantic
|
71
|
+
* HTML element based on the `variant` prop. For example, `body1` will use a
|
72
|
+
* `<p>` tag, `title1` uses an `<h1>`, etc. This behavior can be overridden
|
73
|
+
* with the `as` prop.
|
74
|
+
*
|
75
|
+
*
|
76
|
+
* @example
|
77
|
+
* ```tsx
|
78
|
+
* import { Text } from '@yahoo/uds';
|
79
|
+
*
|
80
|
+
* <Text variant="body1" color="primary">
|
81
|
+
* Text goes here
|
82
|
+
* </Text>
|
83
|
+
* ```
|
84
|
+
*
|
85
|
+
* @usage
|
86
|
+
* - Use `Text` to display text in your app.
|
87
|
+
* - Use `variant` to change the size and weight of the text.
|
88
|
+
* - Use `color` to change the color of the text.
|
89
|
+
* - Use `as` to change the HTML tag used to render the text.
|
90
|
+
*
|
91
|
+
* @see The {@link https://uds.build/docs/components/text Text Docs} for more info
|
92
|
+
*
|
93
|
+
* @related [ResponsiveText](https://uds.build/docs/components/responsive-text)
|
94
|
+
*/
|
95
|
+
declare const Text: react.ForwardRefExoticComponent<(Omit<{
|
96
|
+
/** Ref passed to the inner container. */
|
97
|
+
ref?: Ref<HTMLElement>;
|
98
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
99
|
+
as?: TextElementTagName | undefined;
|
100
|
+
variant?: VariantWithInherit;
|
101
|
+
color?: ColorWithInherit;
|
102
|
+
} & react.ClassAttributes<HTMLElement> & react.HTMLAttributes<HTMLElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
103
|
+
/** Ref passed to the inner container. */
|
104
|
+
ref?: Ref<HTMLElement>;
|
105
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
106
|
+
as?: TextElementTagName | undefined;
|
107
|
+
variant?: VariantWithInherit;
|
108
|
+
color?: ColorWithInherit;
|
109
|
+
} & react.ClassAttributes<HTMLHeadingElement> & react.HTMLAttributes<HTMLHeadingElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
110
|
+
/** Ref passed to the inner container. */
|
111
|
+
ref?: Ref<HTMLElement>;
|
112
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
113
|
+
as?: TextElementTagName | undefined;
|
114
|
+
variant?: VariantWithInherit;
|
115
|
+
color?: ColorWithInherit;
|
116
|
+
} & react.ClassAttributes<HTMLLabelElement> & react.LabelHTMLAttributes<HTMLLabelElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
117
|
+
/** Ref passed to the inner container. */
|
118
|
+
ref?: Ref<HTMLElement>;
|
119
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
120
|
+
as?: TextElementTagName | undefined;
|
121
|
+
variant?: VariantWithInherit;
|
122
|
+
color?: ColorWithInherit;
|
123
|
+
} & react.ClassAttributes<HTMLLIElement> & react.LiHTMLAttributes<HTMLLIElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
124
|
+
/** Ref passed to the inner container. */
|
125
|
+
ref?: Ref<HTMLElement>;
|
126
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
127
|
+
as?: TextElementTagName | undefined;
|
128
|
+
variant?: VariantWithInherit;
|
129
|
+
color?: ColorWithInherit;
|
130
|
+
} & react.ClassAttributes<HTMLParagraphElement> & react.HTMLAttributes<HTMLParagraphElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
131
|
+
/** Ref passed to the inner container. */
|
132
|
+
ref?: Ref<HTMLElement>;
|
133
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
134
|
+
as?: TextElementTagName | undefined;
|
135
|
+
variant?: VariantWithInherit;
|
136
|
+
color?: ColorWithInherit;
|
137
|
+
} & react.ClassAttributes<HTMLSpanElement> & react.HTMLAttributes<HTMLSpanElement> & Omit<UniversalTextProps, "color" | "variant">, "ref">) & react.RefAttributes<HTMLElement>>;
|
138
|
+
|
139
|
+
export { type InputProps as I, type TextProps as T, Text as a, Input as b };
|
@@ -0,0 +1,139 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { InputHTMLAttributes, Ref } from 'react';
|
3
|
+
import { l as UniversalInputProps, m as IconPropsWithSVGProps, n as UniversalTextProps } from './types-rZt8SiS0.js';
|
4
|
+
import { HTMLMotionProps } from 'motion/react';
|
5
|
+
import { B as BoxProps } from './Box-C5GwvlME.js';
|
6
|
+
|
7
|
+
type HtmlInputProps = React.InputHTMLAttributes<HTMLInputElement> & HTMLMotionProps<'input'>;
|
8
|
+
type NativeInputProps = Omit<HtmlInputProps, 'height' | 'size' | 'width' | 'color' | 'required'>;
|
9
|
+
type DataAttributes = {
|
10
|
+
[name: `data-${string}`]: string;
|
11
|
+
};
|
12
|
+
interface InputProps extends NativeInputProps, UniversalInputProps {
|
13
|
+
/** The type of the input element. Reduced set of options from the HTML input type attribute.
|
14
|
+
* @default 'text'
|
15
|
+
*/
|
16
|
+
type?: Exclude<NativeInputProps['type'], 'button' | 'checkbox' | 'color' | 'file' | 'radio' | 'range' | 'reset' | 'submit' | 'search'>;
|
17
|
+
/** Props to be passed into various slots within the component. */
|
18
|
+
slotProps?: {
|
19
|
+
input?: Partial<InputHTMLAttributes<HTMLInputElement> & DataAttributes>;
|
20
|
+
inputWrapper?: Partial<BoxProps & DataAttributes>;
|
21
|
+
startIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
22
|
+
endIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
23
|
+
};
|
24
|
+
}
|
25
|
+
/**
|
26
|
+
* **📦 An input that allows users to enter text and collect data.**
|
27
|
+
*
|
28
|
+
* @componentType Client component
|
29
|
+
*
|
30
|
+
* @description
|
31
|
+
* 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.
|
32
|
+
*
|
33
|
+
* @see
|
34
|
+
* Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
|
35
|
+
*
|
36
|
+
* @usage
|
37
|
+
* - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
|
38
|
+
* - Search Bars: Allowing users to enter search queries to find content.
|
39
|
+
* - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
|
40
|
+
* - Feedback/Comments: Letting users leave reviews, comments, or feedback.
|
41
|
+
*
|
42
|
+
* @example
|
43
|
+
* ```tsx
|
44
|
+
* 'use client';
|
45
|
+
* import { Input } from "@yahoo/uds";
|
46
|
+
*
|
47
|
+
* <Input label="Name" placeholder="Enter your name" required />
|
48
|
+
*```
|
49
|
+
*
|
50
|
+
* @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
|
51
|
+
**/
|
52
|
+
declare const Input: react.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
|
53
|
+
|
54
|
+
type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
|
55
|
+
type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';
|
56
|
+
type VariantWithInherit = Exclude<UniversalTextProps['variant'], undefined> | 'inherit';
|
57
|
+
type TextProps<TagName extends TextElementTagName = TextElementTagName> = {
|
58
|
+
/** Ref passed to the inner container. */
|
59
|
+
ref?: Ref<HTMLElement>;
|
60
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
61
|
+
as?: TagName;
|
62
|
+
variant?: VariantWithInherit;
|
63
|
+
color?: ColorWithInherit;
|
64
|
+
} & JSX.IntrinsicElements[TagName] & Omit<UniversalTextProps, 'variant' | 'color'>;
|
65
|
+
/**
|
66
|
+
* **💬 A text element that can be used to display text**
|
67
|
+
*
|
68
|
+
* @description
|
69
|
+
* By default, the `Text` component uses text primary color and selects the
|
70
|
+
* correct font, weight, and leading. It also choices appropriate semantic
|
71
|
+
* HTML element based on the `variant` prop. For example, `body1` will use a
|
72
|
+
* `<p>` tag, `title1` uses an `<h1>`, etc. This behavior can be overridden
|
73
|
+
* with the `as` prop.
|
74
|
+
*
|
75
|
+
*
|
76
|
+
* @example
|
77
|
+
* ```tsx
|
78
|
+
* import { Text } from '@yahoo/uds';
|
79
|
+
*
|
80
|
+
* <Text variant="body1" color="primary">
|
81
|
+
* Text goes here
|
82
|
+
* </Text>
|
83
|
+
* ```
|
84
|
+
*
|
85
|
+
* @usage
|
86
|
+
* - Use `Text` to display text in your app.
|
87
|
+
* - Use `variant` to change the size and weight of the text.
|
88
|
+
* - Use `color` to change the color of the text.
|
89
|
+
* - Use `as` to change the HTML tag used to render the text.
|
90
|
+
*
|
91
|
+
* @see The {@link https://uds.build/docs/components/text Text Docs} for more info
|
92
|
+
*
|
93
|
+
* @related [ResponsiveText](https://uds.build/docs/components/responsive-text)
|
94
|
+
*/
|
95
|
+
declare const Text: react.ForwardRefExoticComponent<(Omit<{
|
96
|
+
/** Ref passed to the inner container. */
|
97
|
+
ref?: Ref<HTMLElement>;
|
98
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
99
|
+
as?: TextElementTagName | undefined;
|
100
|
+
variant?: VariantWithInherit;
|
101
|
+
color?: ColorWithInherit;
|
102
|
+
} & react.ClassAttributes<HTMLElement> & react.HTMLAttributes<HTMLElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
103
|
+
/** Ref passed to the inner container. */
|
104
|
+
ref?: Ref<HTMLElement>;
|
105
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
106
|
+
as?: TextElementTagName | undefined;
|
107
|
+
variant?: VariantWithInherit;
|
108
|
+
color?: ColorWithInherit;
|
109
|
+
} & react.ClassAttributes<HTMLHeadingElement> & react.HTMLAttributes<HTMLHeadingElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
110
|
+
/** Ref passed to the inner container. */
|
111
|
+
ref?: Ref<HTMLElement>;
|
112
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
113
|
+
as?: TextElementTagName | undefined;
|
114
|
+
variant?: VariantWithInherit;
|
115
|
+
color?: ColorWithInherit;
|
116
|
+
} & react.ClassAttributes<HTMLLabelElement> & react.LabelHTMLAttributes<HTMLLabelElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
117
|
+
/** Ref passed to the inner container. */
|
118
|
+
ref?: Ref<HTMLElement>;
|
119
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
120
|
+
as?: TextElementTagName | undefined;
|
121
|
+
variant?: VariantWithInherit;
|
122
|
+
color?: ColorWithInherit;
|
123
|
+
} & react.ClassAttributes<HTMLLIElement> & react.LiHTMLAttributes<HTMLLIElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
124
|
+
/** Ref passed to the inner container. */
|
125
|
+
ref?: Ref<HTMLElement>;
|
126
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
127
|
+
as?: TextElementTagName | undefined;
|
128
|
+
variant?: VariantWithInherit;
|
129
|
+
color?: ColorWithInherit;
|
130
|
+
} & react.ClassAttributes<HTMLParagraphElement> & react.HTMLAttributes<HTMLParagraphElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
131
|
+
/** Ref passed to the inner container. */
|
132
|
+
ref?: Ref<HTMLElement>;
|
133
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
134
|
+
as?: TextElementTagName | undefined;
|
135
|
+
variant?: VariantWithInherit;
|
136
|
+
color?: ColorWithInherit;
|
137
|
+
} & react.ClassAttributes<HTMLSpanElement> & react.HTMLAttributes<HTMLSpanElement> & Omit<UniversalTextProps, "color" | "variant">, "ref">) & react.RefAttributes<HTMLElement>>;
|
138
|
+
|
139
|
+
export { type InputProps as I, type TextProps as T, Text as a, Input as b };
|
@@ -0,0 +1,139 @@
|
|
1
|
+
import * as react from 'react';
|
2
|
+
import { InputHTMLAttributes, Ref } from 'react';
|
3
|
+
import { l as UniversalInputProps, m as IconPropsWithSVGProps, n as UniversalTextProps } from './types-BEsEvo0F.js';
|
4
|
+
import { HTMLMotionProps } from 'motion/react';
|
5
|
+
import { B as BoxProps } from './Box-DggpNHav.js';
|
6
|
+
|
7
|
+
type HtmlInputProps = React.InputHTMLAttributes<HTMLInputElement> & HTMLMotionProps<'input'>;
|
8
|
+
type NativeInputProps = Omit<HtmlInputProps, 'height' | 'size' | 'width' | 'color' | 'required'>;
|
9
|
+
type DataAttributes = {
|
10
|
+
[name: `data-${string}`]: string;
|
11
|
+
};
|
12
|
+
interface InputProps extends NativeInputProps, UniversalInputProps {
|
13
|
+
/** The type of the input element. Reduced set of options from the HTML input type attribute.
|
14
|
+
* @default 'text'
|
15
|
+
*/
|
16
|
+
type?: Exclude<NativeInputProps['type'], 'button' | 'checkbox' | 'color' | 'file' | 'radio' | 'range' | 'reset' | 'submit' | 'search'>;
|
17
|
+
/** Props to be passed into various slots within the component. */
|
18
|
+
slotProps?: {
|
19
|
+
input?: Partial<InputHTMLAttributes<HTMLInputElement> & DataAttributes>;
|
20
|
+
inputWrapper?: Partial<BoxProps & DataAttributes>;
|
21
|
+
startIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
22
|
+
endIcon?: Partial<IconPropsWithSVGProps & DataAttributes>;
|
23
|
+
};
|
24
|
+
}
|
25
|
+
/**
|
26
|
+
* **📦 An input that allows users to enter text and collect data.**
|
27
|
+
*
|
28
|
+
* @componentType Client component
|
29
|
+
*
|
30
|
+
* @description
|
31
|
+
* 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.
|
32
|
+
*
|
33
|
+
* @see
|
34
|
+
* Check out the {@link https://uds.build/docs/components/input Input Docs} for more info
|
35
|
+
*
|
36
|
+
* @usage
|
37
|
+
* - Forms: For collecting data like names, emails, passwords, etc. (e.g., sign-up, login, or contact forms).
|
38
|
+
* - Search Bars: Allowing users to enter search queries to find content.
|
39
|
+
* - Filters/Settings: When users need to specify preferences, like selecting a date or adjusting a number value.
|
40
|
+
* - Feedback/Comments: Letting users leave reviews, comments, or feedback.
|
41
|
+
*
|
42
|
+
* @example
|
43
|
+
* ```tsx
|
44
|
+
* 'use client';
|
45
|
+
* import { Input } from "@yahoo/uds";
|
46
|
+
*
|
47
|
+
* <Input label="Name" placeholder="Enter your name" required />
|
48
|
+
*```
|
49
|
+
*
|
50
|
+
* @related [Checkbox](https://uds.build/docs/components/checkbox), [Radio](https://uds.build/docs/components/radio).
|
51
|
+
**/
|
52
|
+
declare const Input: react.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
|
53
|
+
|
54
|
+
type TextElementTagName = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'p' | 'strong' | 'span' | 'label' | 'li' | 'sup';
|
55
|
+
type ColorWithInherit = Exclude<UniversalTextProps['color'], undefined> | 'inherit';
|
56
|
+
type VariantWithInherit = Exclude<UniversalTextProps['variant'], undefined> | 'inherit';
|
57
|
+
type TextProps<TagName extends TextElementTagName = TextElementTagName> = {
|
58
|
+
/** Ref passed to the inner container. */
|
59
|
+
ref?: Ref<HTMLElement>;
|
60
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
61
|
+
as?: TagName;
|
62
|
+
variant?: VariantWithInherit;
|
63
|
+
color?: ColorWithInherit;
|
64
|
+
} & JSX.IntrinsicElements[TagName] & Omit<UniversalTextProps, 'variant' | 'color'>;
|
65
|
+
/**
|
66
|
+
* **💬 A text element that can be used to display text**
|
67
|
+
*
|
68
|
+
* @description
|
69
|
+
* By default, the `Text` component uses text primary color and selects the
|
70
|
+
* correct font, weight, and leading. It also choices appropriate semantic
|
71
|
+
* HTML element based on the `variant` prop. For example, `body1` will use a
|
72
|
+
* `<p>` tag, `title1` uses an `<h1>`, etc. This behavior can be overridden
|
73
|
+
* with the `as` prop.
|
74
|
+
*
|
75
|
+
*
|
76
|
+
* @example
|
77
|
+
* ```tsx
|
78
|
+
* import { Text } from '@yahoo/uds';
|
79
|
+
*
|
80
|
+
* <Text variant="body1" color="primary">
|
81
|
+
* Text goes here
|
82
|
+
* </Text>
|
83
|
+
* ```
|
84
|
+
*
|
85
|
+
* @usage
|
86
|
+
* - Use `Text` to display text in your app.
|
87
|
+
* - Use `variant` to change the size and weight of the text.
|
88
|
+
* - Use `color` to change the color of the text.
|
89
|
+
* - Use `as` to change the HTML tag used to render the text.
|
90
|
+
*
|
91
|
+
* @see The {@link https://uds.build/docs/components/text Text Docs} for more info
|
92
|
+
*
|
93
|
+
* @related [ResponsiveText](https://uds.build/docs/components/responsive-text)
|
94
|
+
*/
|
95
|
+
declare const Text: react.ForwardRefExoticComponent<(Omit<{
|
96
|
+
/** Ref passed to the inner container. */
|
97
|
+
ref?: Ref<HTMLElement>;
|
98
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
99
|
+
as?: TextElementTagName | undefined;
|
100
|
+
variant?: VariantWithInherit;
|
101
|
+
color?: ColorWithInherit;
|
102
|
+
} & react.ClassAttributes<HTMLElement> & react.HTMLAttributes<HTMLElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
103
|
+
/** Ref passed to the inner container. */
|
104
|
+
ref?: Ref<HTMLElement>;
|
105
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
106
|
+
as?: TextElementTagName | undefined;
|
107
|
+
variant?: VariantWithInherit;
|
108
|
+
color?: ColorWithInherit;
|
109
|
+
} & react.ClassAttributes<HTMLHeadingElement> & react.HTMLAttributes<HTMLHeadingElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
110
|
+
/** Ref passed to the inner container. */
|
111
|
+
ref?: Ref<HTMLElement>;
|
112
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
113
|
+
as?: TextElementTagName | undefined;
|
114
|
+
variant?: VariantWithInherit;
|
115
|
+
color?: ColorWithInherit;
|
116
|
+
} & react.ClassAttributes<HTMLLabelElement> & react.LabelHTMLAttributes<HTMLLabelElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
117
|
+
/** Ref passed to the inner container. */
|
118
|
+
ref?: Ref<HTMLElement>;
|
119
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
120
|
+
as?: TextElementTagName | undefined;
|
121
|
+
variant?: VariantWithInherit;
|
122
|
+
color?: ColorWithInherit;
|
123
|
+
} & react.ClassAttributes<HTMLLIElement> & react.LiHTMLAttributes<HTMLLIElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
124
|
+
/** Ref passed to the inner container. */
|
125
|
+
ref?: Ref<HTMLElement>;
|
126
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
127
|
+
as?: TextElementTagName | undefined;
|
128
|
+
variant?: VariantWithInherit;
|
129
|
+
color?: ColorWithInherit;
|
130
|
+
} & react.ClassAttributes<HTMLParagraphElement> & react.HTMLAttributes<HTMLParagraphElement> & Omit<UniversalTextProps, "color" | "variant">, "ref"> | Omit<{
|
131
|
+
/** Ref passed to the inner container. */
|
132
|
+
ref?: Ref<HTMLElement>;
|
133
|
+
/** Changes the HTML tag used to render text. Uses the most appropriate semantic tag based on the text style variant. */
|
134
|
+
as?: TextElementTagName | undefined;
|
135
|
+
variant?: VariantWithInherit;
|
136
|
+
color?: ColorWithInherit;
|
137
|
+
} & react.ClassAttributes<HTMLSpanElement> & react.HTMLAttributes<HTMLSpanElement> & Omit<UniversalTextProps, "color" | "variant">, "ref">) & react.RefAttributes<HTMLElement>>;
|
138
|
+
|
139
|
+
export { type InputProps as I, type TextProps as T, Text as a, Input as b };
|