@atom63/ui-react 0.2.0-beta.1 → 0.2.0-beta.10
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/LICENSE +21 -0
- package/README.md +54 -50
- package/dist/{button-sktq-nvV.d.ts → button-CfLIHg-R.d.ts} +1 -1
- package/dist/chunk-GDUMA6FI.js +2678 -0
- package/dist/chunk-GDUMA6FI.js.map +1 -0
- package/dist/{chunk-STCXERLM.js → chunk-J77BAGTA.js} +8 -148
- package/dist/chunk-J77BAGTA.js.map +1 -0
- package/dist/chunk-NBHGMMQN.js +135 -0
- package/dist/chunk-NBHGMMQN.js.map +1 -0
- package/dist/{chunk-7VSPECOH.js → chunk-R67OZVA2.js} +4 -14
- package/dist/chunk-R67OZVA2.js.map +1 -0
- package/dist/chunk-UPPHQLZ2.js +18 -0
- package/dist/chunk-UPPHQLZ2.js.map +1 -0
- package/dist/{chunk-MXNO63TC.js → chunk-X5L5DEUZ.js} +597 -290
- package/dist/chunk-X5L5DEUZ.js.map +1 -0
- package/dist/{destination-link-C9NKeKLe.d.ts → destination-link-DMLeR-oF.d.ts} +1 -1
- package/dist/index-BDzW8upQ.d.ts +442 -0
- package/dist/index.d.ts +56 -454
- package/dist/index.js +402 -2987
- package/dist/index.js.map +1 -1
- package/dist/layout/index.js +4 -4
- package/dist/layout/index.js.map +1 -1
- package/dist/media/index.d.ts +15 -4
- package/dist/media/index.js +213 -46
- package/dist/media/index.js.map +1 -1
- package/dist/media/media-lightbox/parts/index.d.ts +23 -15
- package/dist/media/media-lightbox/parts/index.js +3 -2
- package/dist/preview/index.d.ts +16 -0
- package/dist/preview/index.js +6 -0
- package/dist/preview/index.js.map +1 -0
- package/dist/theme/index.d.ts +2 -2
- package/dist/theme/index.js +81 -36
- package/dist/theme/index.js.map +1 -1
- package/package.json +31 -27
- package/src/components/accordion/accordion.css +2 -4
- package/src/components/alert-dialog/alert-dialog.css +1 -1
- package/src/components/autocomplete/autocomplete.css +3 -7
- package/src/components/badge/badge.css +5 -8
- package/src/components/breadcrumb/breadcrumb.css +1 -2
- package/src/components/button/button.css +8 -6
- package/src/components/button-group/button-group.css +17 -1
- package/src/components/calendar/calendar.css +5 -8
- package/src/components/card/card.css +2 -2
- package/src/components/carousel/carousel.css +4 -8
- package/src/components/checkbox/checkbox.css +1 -1
- package/src/components/command/command.css +8 -0
- package/src/components/connected-panel/connected-panel.css +3 -2
- package/src/components/dialog/dialog.css +1 -1
- package/src/components/drawer/drawer.css +1 -1
- package/src/components/empty/empty.css +2 -2
- package/src/components/feedback-state/feedback-state.css +1 -1
- package/src/components/field/field.css +4 -4
- package/src/components/form/form.css +2 -2
- package/src/components/input/input.css +2 -6
- package/src/components/input-otp/input-otp.css +4 -11
- package/src/components/item/item.css +3 -3
- package/src/components/menu/menu.css +5 -4
- package/src/components/menubar/menubar.css +4 -1
- package/src/components/navigation-menu/navigation-menu.css +5 -1
- package/src/components/panel-setting-button/panel-setting-button.css +1 -1
- package/src/components/radio/radio.css +1 -1
- package/src/components/resizable/resizable.css +1 -1
- package/src/components/scroll-area/scroll-area.css +1 -2
- package/src/components/segmented-control/segmented-control.css +8 -1
- package/src/components/select/select.css +2 -6
- package/src/components/sidebar/sidebar.css +12 -12
- package/src/components/sidebar-nav-tree/sidebar-nav-tree.css +8 -8
- package/src/components/slider/slider.css +6 -6
- package/src/components/switch/switch.css +3 -3
- package/src/components/table/table.css +7 -1
- package/src/components/tabs/tabs.css +15 -1
- package/src/components/textarea/textarea.css +2 -6
- package/src/components/toggle/toggle.css +5 -4
- package/src/components/toggle-group/toggle-group.css +4 -4
- package/src/media/media-lightbox/media-lightbox.css +15 -5
- package/src/styles/index.css +1 -0
- package/src/styles/utilities.css +2253 -0
- package/dist/chunk-7VSPECOH.js.map +0 -1
- package/dist/chunk-MXNO63TC.js.map +0 -1
- package/dist/chunk-STCXERLM.js.map +0 -1
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 You Zhang (ATOM63)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -6,60 +6,42 @@ The primary React renderer for Atom63. It provides accessible components,
|
|
|
6
6
|
layout primitives, media, and theme controls backed by `@atom63/ui-foundation`
|
|
7
7
|
contracts and `@atom63/styles` tokens.
|
|
8
8
|
|
|
9
|
-
Built by You Zhang through Hermes Agent
|
|
10
|
-
|
|
11
9
|
## Install
|
|
12
10
|
|
|
13
11
|
The package name is `@atom63/ui-react`, with React 19 and React DOM 19 as peer
|
|
14
|
-
dependencies.
|
|
15
|
-
|
|
16
|
-
publishing requires YZ approval and confirmation of the npm organization policy.
|
|
17
|
-
|
|
18
|
-
After an approved public release, install by package name:
|
|
12
|
+
dependencies. It is available as a public npm beta, not a stable API. Install
|
|
13
|
+
the explicit `beta` tags:
|
|
19
14
|
|
|
20
15
|
```sh
|
|
21
|
-
pnpm add @atom63/
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
Until then, use workspace dependencies:
|
|
25
|
-
|
|
26
|
-
```json
|
|
27
|
-
{
|
|
28
|
-
"dependencies": {
|
|
29
|
-
"@atom63/styles": "workspace:*",
|
|
30
|
-
"@atom63/ui-react": "workspace:*",
|
|
31
|
-
"react": "^19.1.0",
|
|
32
|
-
"react-dom": "^19.1.0"
|
|
33
|
-
}
|
|
34
|
-
}
|
|
16
|
+
pnpm add @atom63/styles@beta @atom63/ui-react@beta
|
|
35
17
|
```
|
|
36
18
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
19
|
+
Add React 19 and React DOM 19 if the app does not already provide them. For the
|
|
20
|
+
complete external-consumer path, start with the
|
|
21
|
+
[public beta quickstart](../../docs/design-system/quickstart.md).
|
|
40
22
|
|
|
41
23
|
## Minimum setup
|
|
42
24
|
|
|
43
|
-
Load the shared CSS once,
|
|
25
|
+
Load the shared CSS once, wrap your app with `Atom63Theme`, then render
|
|
26
|
+
components from the root entry point.
|
|
44
27
|
|
|
45
28
|
## CSS imports
|
|
46
29
|
|
|
47
|
-
Import the
|
|
48
|
-
application entry:
|
|
30
|
+
Import the React stylesheet once from the application entry:
|
|
49
31
|
|
|
50
32
|
```tsx
|
|
51
|
-
import '@atom63/styles'
|
|
52
33
|
import '@atom63/ui-react/styles.css'
|
|
53
34
|
```
|
|
54
35
|
|
|
55
|
-
The
|
|
56
|
-
|
|
57
|
-
|
|
36
|
+
The stylesheet includes the Atom63 foundation, reset, and component recipes.
|
|
37
|
+
Keep `@atom63/styles` installed because it is a package dependency, but no
|
|
38
|
+
second CSS import is needed for the standard React setup.
|
|
58
39
|
|
|
59
40
|
## First component
|
|
60
41
|
|
|
61
42
|
```tsx
|
|
62
43
|
import {
|
|
44
|
+
Atom63Theme,
|
|
63
45
|
Badge,
|
|
64
46
|
Button,
|
|
65
47
|
Card,
|
|
@@ -71,18 +53,20 @@ import {
|
|
|
71
53
|
|
|
72
54
|
export function Example() {
|
|
73
55
|
return (
|
|
74
|
-
<
|
|
75
|
-
<
|
|
76
|
-
<
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
<
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
56
|
+
<Atom63Theme mode="light" theme="modern">
|
|
57
|
+
<Card>
|
|
58
|
+
<CardHeader>
|
|
59
|
+
<Badge>Preview</Badge>
|
|
60
|
+
<CardTitle>Invite a collaborator</CardTitle>
|
|
61
|
+
</CardHeader>
|
|
62
|
+
<CardContent>
|
|
63
|
+
<Input aria-label="Email address" placeholder="you@example.com" type="email" />
|
|
64
|
+
<Button type="button" variant="primary">
|
|
65
|
+
Send invite
|
|
66
|
+
</Button>
|
|
67
|
+
</CardContent>
|
|
68
|
+
</Card>
|
|
69
|
+
</Atom63Theme>
|
|
86
70
|
)
|
|
87
71
|
}
|
|
88
72
|
```
|
|
@@ -91,10 +75,14 @@ These imports match the packed-package smoke path and the package root exports.
|
|
|
91
75
|
|
|
92
76
|
## Theming
|
|
93
77
|
|
|
94
|
-
|
|
78
|
+
`Atom63Theme` sets `data-a63-mode`, `data-a63-theme`, and the matching `light`
|
|
79
|
+
or `dark` class on its wrapper. It renders a `div` by default; use the `render`
|
|
80
|
+
prop when a different wrapper is needed.
|
|
95
81
|
|
|
96
|
-
```
|
|
97
|
-
<
|
|
82
|
+
```tsx
|
|
83
|
+
<Atom63Theme mode="dark" render={<main />} theme="modern">
|
|
84
|
+
<App />
|
|
85
|
+
</Atom63Theme>
|
|
98
86
|
```
|
|
99
87
|
|
|
100
88
|
The bundled themes are `modern`, `aqua`, `retro`, and `terminal`. Use `light` or
|
|
@@ -105,17 +93,33 @@ documentation.
|
|
|
105
93
|
## Stable vs preview
|
|
106
94
|
|
|
107
95
|
The production consumption path is verified by `pnpm check:ds-pack-smoke`
|
|
108
|
-
against packed tarballs, including the CSS imports and components above.
|
|
109
|
-
|
|
96
|
+
against packed tarballs, including the CSS imports and components above. The
|
|
97
|
+
package is publicly available under the `beta` tag, but it is not yet a
|
|
98
|
+
stable/latest compatibility promise.
|
|
110
99
|
|
|
111
100
|
For the first public beta, the package keeps the current broad root export to
|
|
112
101
|
avoid pre-release churn, but the support promise is tiered. Core controls are the
|
|
113
102
|
primary compatibility surface; monitor/preview-candidate exports may remain
|
|
114
|
-
importable while their evidence and API shape harden.
|
|
115
|
-
|
|
103
|
+
importable while their evidence and API shape harden. Preview candidates are also
|
|
104
|
+
available from `@atom63/ui-react/preview`; that subpath is public but is not a
|
|
105
|
+
stable-compatibility promise. See the design-system handbook's root API audit
|
|
106
|
+
before treating a less common export as stable.
|
|
107
|
+
|
|
108
|
+
Preview escape hatches should use the explicit preview subpath:
|
|
109
|
+
|
|
110
|
+
```tsx
|
|
111
|
+
import { DialogPrimitive } from '@atom63/ui-react/preview'
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
The broad beta root still exports those names today, but stable/latest may narrow
|
|
115
|
+
the root. Treat `@atom63/ui-react/preview` as the safer import path for APIs that
|
|
116
|
+
are not part of the stable root promise.
|
|
116
117
|
|
|
117
118
|
## Docs
|
|
118
119
|
|
|
120
|
+
- [Public beta quickstart](../../docs/design-system/quickstart.md)
|
|
121
|
+
- [Support and governance policy](../../docs/design-system/support-governance.md)
|
|
119
122
|
- [Design system handbook](../../docs/design-system/README.md)
|
|
123
|
+
- [Preview migration guidance](../../docs/design-system/ui-react-preview-migration.md)
|
|
120
124
|
- [Component review and stability criteria](../../docs/design-system/ui-react-component-review.md)
|
|
121
125
|
- [Production readiness audit](../../docs/design-system/production-readiness-audit.md)
|
|
@@ -10,4 +10,4 @@ interface ButtonProps extends useRender.ComponentProps<'button'> {
|
|
|
10
10
|
}
|
|
11
11
|
declare function Button({ children, className, disabled, loading, render, size, type, variant, 'data-slot': triggerSlot, ...props }: ButtonProps): React.ReactElement;
|
|
12
12
|
|
|
13
|
-
export {
|
|
13
|
+
export { Button as B, type ButtonProps as a };
|