@atlaskit/primitives 7.0.0 → 7.0.1
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/.eslintrc.js +1 -1
- package/CHANGELOG.md +10 -1
- package/LICENSE.md +6 -8
- package/constellation/anchor/code.mdx +3 -3
- package/constellation/anchor/examples.mdx +33 -39
- package/constellation/anchor/usage.mdx +60 -30
- package/constellation/bleed/code.mdx +3 -3
- package/constellation/bleed/examples.mdx +17 -13
- package/constellation/box/code.mdx +3 -3
- package/constellation/box/examples.mdx +25 -19
- package/constellation/box/usage.mdx +15 -5
- package/constellation/flex/code.mdx +3 -3
- package/constellation/flex/examples.mdx +12 -11
- package/constellation/grid/code.mdx +3 -3
- package/constellation/grid/examples.mdx +15 -10
- package/constellation/inline/code.mdx +3 -3
- package/constellation/inline/examples.mdx +32 -38
- package/constellation/inline/usage.mdx +15 -6
- package/constellation/overview/index.mdx +29 -27
- package/constellation/pressable/code.mdx +5 -4
- package/constellation/pressable/examples.mdx +35 -52
- package/constellation/pressable/usage.mdx +50 -29
- package/constellation/responsive/01-show/code.mdx +3 -3
- package/constellation/responsive/01-show/examples.mdx +9 -13
- package/constellation/responsive/02-hide/code.mdx +3 -3
- package/constellation/responsive/02-hide/examples.mdx +9 -13
- package/constellation/responsive/03-breakpoints/examples.mdx +3 -3
- package/constellation/responsive/examples.mdx +10 -10
- package/constellation/responsive/usage.mdx +23 -15
- package/constellation/stack/code.mdx +3 -3
- package/constellation/stack/examples.mdx +26 -20
- package/constellation/stack/usage.mdx +13 -5
- package/constellation/text/code.mdx +3 -3
- package/constellation/text/examples.mdx +29 -15
- package/constellation/text/usage.mdx +6 -3
- package/constellation/xcss/examples.mdx +7 -5
- package/constellation/xcss/migration.mdx +32 -25
- package/constellation/xcss/usage.mdx +72 -60
- package/dist/cjs/components/anchor.js +1 -1
- package/dist/cjs/components/pressable.js +1 -1
- package/dist/cjs/xcss/style-maps.partial.js +13 -13
- package/dist/es2019/components/anchor.js +1 -1
- package/dist/es2019/components/pressable.js +1 -1
- package/dist/es2019/xcss/style-maps.partial.js +13 -13
- package/dist/esm/components/anchor.js +1 -1
- package/dist/esm/components/pressable.js +1 -1
- package/dist/esm/xcss/style-maps.partial.js +13 -13
- package/dist/types/responsive/index.d.ts +2 -2
- package/dist/types/xcss/style-maps.partial.d.ts +13 -13
- package/dist/types-ts4.5/responsive/index.d.ts +2 -2
- package/dist/types-ts4.5/xcss/style-maps.partial.d.ts +13 -13
- package/extract-react-types/anchor-props.tsx +108 -116
- package/extract-react-types/bleed-props.tsx +17 -22
- package/extract-react-types/box-props.tsx +67 -70
- package/extract-react-types/flex-props.tsx +61 -61
- package/extract-react-types/grid-props.tsx +92 -92
- package/extract-react-types/hide-props.tsx +35 -35
- package/extract-react-types/inline-props.tsx +68 -68
- package/extract-react-types/pressable-props.tsx +101 -107
- package/extract-react-types/show-props.tsx +35 -35
- package/extract-react-types/stack-props.tsx +55 -55
- package/package.json +2 -2
- package/report.api.md +940 -965
- package/scripts/border-codegen-template.tsx +40 -47
- package/scripts/codegen-file-templates/dimensions.tsx +8 -8
- package/scripts/codegen-file-templates/layer.tsx +9 -9
- package/scripts/codegen-styles.tsx +97 -103
- package/scripts/color-codegen-template.tsx +61 -73
- package/scripts/elevation-codegen-template.tsx +50 -62
- package/scripts/inverse-color-map-template.tsx +26 -31
- package/scripts/misc-codegen-template.tsx +4 -9
- package/scripts/spacing-codegen-template.tsx +25 -31
- package/scripts/typography-codegen-template.tsx +59 -65
- package/scripts/utils.tsx +36 -43
|
@@ -3,78 +3,78 @@ import { type ElementType, type ReactNode } from 'react';
|
|
|
3
3
|
import { type BasePrimitiveProps } from '../src/components/types';
|
|
4
4
|
|
|
5
5
|
type Space =
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
6
|
+
| 'space.0'
|
|
7
|
+
| 'space.025'
|
|
8
|
+
| 'space.050'
|
|
9
|
+
| 'space.075'
|
|
10
|
+
| 'space.100'
|
|
11
|
+
| 'space.150'
|
|
12
|
+
| 'space.200'
|
|
13
|
+
| 'space.250'
|
|
14
|
+
| 'space.300'
|
|
15
|
+
| 'space.400'
|
|
16
|
+
| 'space.500'
|
|
17
|
+
| 'space.600'
|
|
18
|
+
| 'space.800'
|
|
19
|
+
| 'space.1000';
|
|
20
20
|
|
|
21
21
|
type FlexProps<T extends ElementType = 'div'> = {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
22
|
+
/**
|
|
23
|
+
* The DOM element to render as the Flex. Defaults to `div`.
|
|
24
|
+
*/
|
|
25
|
+
as?: 'div' | 'span' | 'ul' | 'ol' | 'li';
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
27
|
+
/**
|
|
28
|
+
* Used to align children along the main axis.
|
|
29
|
+
*/
|
|
30
|
+
justifyContent?:
|
|
31
|
+
| 'start'
|
|
32
|
+
| 'center'
|
|
33
|
+
| 'end'
|
|
34
|
+
| 'space-between'
|
|
35
|
+
| 'space-around'
|
|
36
|
+
| 'space-evenly'
|
|
37
|
+
| 'stretch';
|
|
38
38
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
39
|
+
/**
|
|
40
|
+
* Used to align children along the cross axis.
|
|
41
|
+
*/
|
|
42
|
+
alignItems?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
|
|
43
43
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
44
|
+
/**
|
|
45
|
+
* Represents the space between each child.
|
|
46
|
+
*/
|
|
47
|
+
columnGap?: Space;
|
|
48
48
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
49
|
+
/**
|
|
50
|
+
* Represents the space between each child.
|
|
51
|
+
*/
|
|
52
|
+
gap?: Space;
|
|
53
53
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
54
|
+
/**
|
|
55
|
+
* Represents the space between each child.
|
|
56
|
+
*/
|
|
57
|
+
rowGap?: Space;
|
|
58
58
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
59
|
+
/**
|
|
60
|
+
* Represents the flex direction property of CSS flexbox.
|
|
61
|
+
*/
|
|
62
|
+
direction?: 'row' | 'column';
|
|
63
63
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
64
|
+
/**
|
|
65
|
+
* Represents the flex wrap property of CSS flexbox.
|
|
66
|
+
*/
|
|
67
|
+
wrap?: 'wrap' | 'nowrap';
|
|
68
68
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
69
|
+
/**
|
|
70
|
+
* Elements to be rendered inside the Flex.
|
|
71
|
+
*/
|
|
72
|
+
children: ReactNode;
|
|
73
73
|
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
74
|
+
/**
|
|
75
|
+
* Forwarded ref element
|
|
76
|
+
*/
|
|
77
|
+
ref?: React.ComponentPropsWithRef<T>['ref'];
|
|
78
78
|
} & BasePrimitiveProps;
|
|
79
79
|
|
|
80
80
|
export default function Flex(_: FlexProps) {}
|
|
@@ -3,100 +3,100 @@ import { type ElementType, type ReactNode } from 'react';
|
|
|
3
3
|
import { type BasePrimitiveProps } from '../src/components/types';
|
|
4
4
|
|
|
5
5
|
type Space =
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
6
|
+
| 'space.0'
|
|
7
|
+
| 'space.025'
|
|
8
|
+
| 'space.050'
|
|
9
|
+
| 'space.075'
|
|
10
|
+
| 'space.100'
|
|
11
|
+
| 'space.150'
|
|
12
|
+
| 'space.200'
|
|
13
|
+
| 'space.250'
|
|
14
|
+
| 'space.300'
|
|
15
|
+
| 'space.400'
|
|
16
|
+
| 'space.500'
|
|
17
|
+
| 'space.600'
|
|
18
|
+
| 'space.800'
|
|
19
|
+
| 'space.1000';
|
|
20
20
|
|
|
21
21
|
type GridProps<T extends ElementType = 'div'> = {
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
22
|
+
/**
|
|
23
|
+
* The DOM element to render as the Flex. Defaults to `div`.
|
|
24
|
+
*/
|
|
25
|
+
as?: 'div' | 'span' | 'ul' | 'ol' | 'li';
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Used to align children along the main axis.
|
|
29
|
+
*/
|
|
30
|
+
justifyContent?:
|
|
31
|
+
| 'start'
|
|
32
|
+
| 'center'
|
|
33
|
+
| 'end'
|
|
34
|
+
| 'space-between'
|
|
35
|
+
| 'space-around'
|
|
36
|
+
| 'space-evenly'
|
|
37
|
+
| 'stretch';
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Used to align children along the cross axis.
|
|
41
|
+
*/
|
|
42
|
+
alignItems?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Represents the space between each child.
|
|
46
|
+
*/
|
|
47
|
+
columnGap?: Space;
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Represents the space between each child.
|
|
51
|
+
*/
|
|
52
|
+
gap?: Space;
|
|
53
|
+
|
|
54
|
+
/**
|
|
55
|
+
* Represents the space between each child.
|
|
56
|
+
*/
|
|
57
|
+
rowGap?: Space;
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Specifies how auto-placed items get flowed into the grid. CSS `grid-auto-flow`.
|
|
61
|
+
*/
|
|
62
|
+
autoFlow?: string;
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* CSS `grid-template-rows`.
|
|
66
|
+
*/
|
|
67
|
+
templateRows?: string;
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* CSS `grid-template-columns`.
|
|
71
|
+
*/
|
|
72
|
+
templateColumns?: string;
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* CSS `grid-template-areas`.
|
|
76
|
+
*
|
|
77
|
+
* Each item in the passed array is a grid row.
|
|
78
|
+
*/
|
|
79
|
+
templateAreas?: string[];
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Represents the flex direction property of CSS flexbox.
|
|
83
|
+
*/
|
|
84
|
+
direction?: 'row' | 'column';
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* Represents the flex wrap property of CSS flexbox.
|
|
88
|
+
*/
|
|
89
|
+
wrap?: 'wrap' | 'nowrap';
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* Elements to be rendered inside the Flex.
|
|
93
|
+
*/
|
|
94
|
+
children: ReactNode;
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* Forwarded ref element
|
|
98
|
+
*/
|
|
99
|
+
ref?: React.ComponentPropsWithRef<T>['ref'];
|
|
100
100
|
} & BasePrimitiveProps;
|
|
101
101
|
|
|
102
102
|
export default function Grid(_: GridProps) {}
|
|
@@ -3,46 +3,46 @@ import { type ReactNode } from 'react';
|
|
|
3
3
|
import { type Breakpoint } from '../src/responsive/types';
|
|
4
4
|
|
|
5
5
|
type As =
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
6
|
+
| 'article'
|
|
7
|
+
| 'aside'
|
|
8
|
+
| 'dialog'
|
|
9
|
+
| 'div'
|
|
10
|
+
| 'footer'
|
|
11
|
+
| 'header'
|
|
12
|
+
| 'li'
|
|
13
|
+
| 'main'
|
|
14
|
+
| 'nav'
|
|
15
|
+
| 'ol'
|
|
16
|
+
| 'section'
|
|
17
|
+
| 'span'
|
|
18
|
+
| 'ul';
|
|
19
19
|
|
|
20
20
|
type ResponsiveHideProps = {
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
21
|
+
/**
|
|
22
|
+
* The DOM element to render as the Box. Defaults to `div`.
|
|
23
|
+
*/
|
|
24
|
+
as?: As;
|
|
25
25
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
26
|
+
/**
|
|
27
|
+
* Elements to be rendered inside the primitive.
|
|
28
|
+
*/
|
|
29
|
+
children: ReactNode;
|
|
30
30
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
31
|
+
/**
|
|
32
|
+
* Apply CSS to hide this specifically **above** this breakpoint.
|
|
33
|
+
* The smallest breakpoint is not included as it would always be shown and this would not be performant.
|
|
34
|
+
*
|
|
35
|
+
* @important do not mix `above` and `below` (TypeScript should prevent this)
|
|
36
|
+
*/
|
|
37
|
+
above?: Exclude<Breakpoint, 'xxs'>;
|
|
38
38
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
39
|
+
/**
|
|
40
|
+
* Apply CSS to hide this specifically **below** this breakpoint.
|
|
41
|
+
* The smallest breakpoint is not included as it would never be shown and this would not be performant.
|
|
42
|
+
*
|
|
43
|
+
* @important do not mix `above` and `below` (TypeScript should prevent this)
|
|
44
|
+
*/
|
|
45
|
+
below?: Exclude<Breakpoint, 'xxs'>;
|
|
46
46
|
};
|
|
47
47
|
|
|
48
48
|
export default function Hide(_: ResponsiveHideProps) {}
|
|
@@ -1,89 +1,89 @@
|
|
|
1
1
|
import { type ElementType, type ReactNode } from 'react';
|
|
2
2
|
|
|
3
3
|
import type {
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
4
|
+
AlignBlock,
|
|
5
|
+
AlignInline,
|
|
6
|
+
BasePrimitiveProps,
|
|
7
|
+
Grow,
|
|
8
|
+
Spread,
|
|
9
9
|
} from '../src/components/types';
|
|
10
10
|
|
|
11
11
|
type Space =
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
12
|
+
| 'space.0'
|
|
13
|
+
| 'space.025'
|
|
14
|
+
| 'space.050'
|
|
15
|
+
| 'space.075'
|
|
16
|
+
| 'space.100'
|
|
17
|
+
| 'space.150'
|
|
18
|
+
| 'space.200'
|
|
19
|
+
| 'space.250'
|
|
20
|
+
| 'space.300'
|
|
21
|
+
| 'space.400'
|
|
22
|
+
| 'space.500'
|
|
23
|
+
| 'space.600'
|
|
24
|
+
| 'space.800'
|
|
25
|
+
| 'space.1000';
|
|
26
26
|
|
|
27
27
|
type InlineProps<T extends ElementType = 'div'> = {
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
28
|
+
/**
|
|
29
|
+
* The DOM element to render as the Inline. Defaults to `div`.
|
|
30
|
+
*/
|
|
31
|
+
as?: 'div' | 'span' | 'ul' | 'ol';
|
|
32
|
+
/**
|
|
33
|
+
* Used to align children along the main axis.
|
|
34
|
+
*/
|
|
35
|
+
alignBlock?: AlignBlock;
|
|
36
36
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
37
|
+
/**
|
|
38
|
+
* Used to align children along the cross axis.
|
|
39
|
+
*/
|
|
40
|
+
alignInline?: AlignInline;
|
|
41
41
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
42
|
+
/**
|
|
43
|
+
* Used to set whether children are forced onto one line or will wrap onto multiple lines.
|
|
44
|
+
*/
|
|
45
|
+
shouldWrap?: boolean;
|
|
46
46
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
47
|
+
/**
|
|
48
|
+
* Used to distribute the children along the main axis.
|
|
49
|
+
*/
|
|
50
|
+
spread?: Spread;
|
|
51
51
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
52
|
+
/**
|
|
53
|
+
* Used to set whether the container should grow to fill the available space.
|
|
54
|
+
*/
|
|
55
|
+
grow?: Grow;
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
57
|
+
/**
|
|
58
|
+
* Represents the space between each child.
|
|
59
|
+
*/
|
|
60
|
+
space?: Space;
|
|
61
61
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
62
|
+
/**
|
|
63
|
+
* Represents the space between rows when content wraps.
|
|
64
|
+
* Used to override the `space` value in between rows.
|
|
65
|
+
*/
|
|
66
|
+
rowSpace?: Space;
|
|
67
67
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
68
|
+
/**
|
|
69
|
+
* Renders a separator string between each child.
|
|
70
|
+
*/
|
|
71
|
+
separator?: string;
|
|
72
72
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
73
|
+
/**
|
|
74
|
+
* A unique string that appears as data attribute data-testid in the rendered code, serving as a hook for automated tests.
|
|
75
|
+
*/
|
|
76
|
+
testId?: string;
|
|
77
77
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
78
|
+
/**
|
|
79
|
+
* Elements to be rendered inside the Inline.
|
|
80
|
+
*/
|
|
81
|
+
children: ReactNode;
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
83
|
+
/**
|
|
84
|
+
* Forwarded ref element
|
|
85
|
+
*/
|
|
86
|
+
ref?: React.ComponentPropsWithRef<T>['ref'];
|
|
87
87
|
} & BasePrimitiveProps;
|
|
88
88
|
|
|
89
89
|
export default function Inline(_: InlineProps) {}
|