@atom63/ui-react 0.2.0-beta.0 → 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.
Files changed (80) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +54 -50
  3. package/dist/{button-sktq-nvV.d.ts → button-CfLIHg-R.d.ts} +1 -1
  4. package/dist/chunk-GDUMA6FI.js +2678 -0
  5. package/dist/chunk-GDUMA6FI.js.map +1 -0
  6. package/dist/{chunk-STCXERLM.js → chunk-J77BAGTA.js} +8 -148
  7. package/dist/chunk-J77BAGTA.js.map +1 -0
  8. package/dist/chunk-NBHGMMQN.js +135 -0
  9. package/dist/chunk-NBHGMMQN.js.map +1 -0
  10. package/dist/{chunk-7VSPECOH.js → chunk-R67OZVA2.js} +4 -14
  11. package/dist/chunk-R67OZVA2.js.map +1 -0
  12. package/dist/chunk-UPPHQLZ2.js +18 -0
  13. package/dist/chunk-UPPHQLZ2.js.map +1 -0
  14. package/dist/{chunk-MXNO63TC.js → chunk-X5L5DEUZ.js} +597 -290
  15. package/dist/chunk-X5L5DEUZ.js.map +1 -0
  16. package/dist/{destination-link-C9NKeKLe.d.ts → destination-link-DMLeR-oF.d.ts} +1 -1
  17. package/dist/index-BDzW8upQ.d.ts +442 -0
  18. package/dist/index.d.ts +56 -454
  19. package/dist/index.js +402 -2987
  20. package/dist/index.js.map +1 -1
  21. package/dist/layout/index.js +4 -4
  22. package/dist/layout/index.js.map +1 -1
  23. package/dist/media/index.d.ts +15 -4
  24. package/dist/media/index.js +213 -46
  25. package/dist/media/index.js.map +1 -1
  26. package/dist/media/media-lightbox/parts/index.d.ts +23 -15
  27. package/dist/media/media-lightbox/parts/index.js +3 -2
  28. package/dist/preview/index.d.ts +16 -0
  29. package/dist/preview/index.js +6 -0
  30. package/dist/preview/index.js.map +1 -0
  31. package/dist/theme/index.d.ts +2 -2
  32. package/dist/theme/index.js +81 -36
  33. package/dist/theme/index.js.map +1 -1
  34. package/package.json +47 -43
  35. package/src/components/accordion/accordion.css +2 -4
  36. package/src/components/alert-dialog/alert-dialog.css +1 -1
  37. package/src/components/autocomplete/autocomplete.css +3 -7
  38. package/src/components/badge/badge.css +5 -8
  39. package/src/components/breadcrumb/breadcrumb.css +1 -2
  40. package/src/components/button/button.css +8 -6
  41. package/src/components/button-group/button-group.css +17 -1
  42. package/src/components/calendar/calendar.css +5 -8
  43. package/src/components/card/card.css +2 -2
  44. package/src/components/carousel/carousel.css +4 -8
  45. package/src/components/checkbox/checkbox.css +1 -1
  46. package/src/components/command/command.css +8 -0
  47. package/src/components/connected-panel/connected-panel.css +3 -2
  48. package/src/components/dialog/dialog.css +1 -1
  49. package/src/components/drawer/drawer.css +1 -1
  50. package/src/components/empty/empty.css +2 -2
  51. package/src/components/feedback-state/feedback-state.css +1 -1
  52. package/src/components/field/field.css +4 -4
  53. package/src/components/form/form.css +2 -2
  54. package/src/components/input/input.css +2 -6
  55. package/src/components/input-otp/input-otp.css +4 -11
  56. package/src/components/item/item.css +3 -3
  57. package/src/components/menu/menu.css +5 -4
  58. package/src/components/menubar/menubar.css +4 -1
  59. package/src/components/navigation-menu/navigation-menu.css +5 -1
  60. package/src/components/panel-setting-button/panel-setting-button.css +1 -1
  61. package/src/components/radio/radio.css +1 -1
  62. package/src/components/resizable/resizable.css +1 -1
  63. package/src/components/scroll-area/scroll-area.css +1 -2
  64. package/src/components/segmented-control/segmented-control.css +8 -1
  65. package/src/components/select/select.css +2 -6
  66. package/src/components/sidebar/sidebar.css +12 -12
  67. package/src/components/sidebar-nav-tree/sidebar-nav-tree.css +8 -8
  68. package/src/components/slider/slider.css +6 -6
  69. package/src/components/switch/switch.css +3 -3
  70. package/src/components/table/table.css +7 -1
  71. package/src/components/tabs/tabs.css +15 -1
  72. package/src/components/textarea/textarea.css +2 -6
  73. package/src/components/toggle/toggle.css +5 -4
  74. package/src/components/toggle-group/toggle-group.css +4 -4
  75. package/src/media/media-lightbox/media-lightbox.css +15 -5
  76. package/src/styles/index.css +1 -0
  77. package/src/styles/utilities.css +2253 -0
  78. package/dist/chunk-7VSPECOH.js.map +0 -1
  79. package/dist/chunk-MXNO63TC.js.map +0 -1
  80. 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. Public npm availability is not promised yet: the currently
15
- verified paths are workspace dependencies or locally packed tarballs. Public
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/ui-react @atom63/styles react react-dom
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
- For a non-workspace consumer, use the packed artifacts for `@atom63/ui-react`
38
- and its Atom63 package dependencies. The repository smoke test exercises that
39
- exact installation shape before building a fresh Vite consumer.
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, then render components from the root entry point.
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 Atom63 foundation and the React recipe bundle once from 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 full React stylesheet also includes the foundation and reset; the explicit
56
- foundation import is retained here because it is the verified package smoke
57
- path and makes the token dependency visible.
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
- <Card>
75
- <CardHeader>
76
- <Badge>Preview</Badge>
77
- <CardTitle>Invite a collaborator</CardTitle>
78
- </CardHeader>
79
- <CardContent>
80
- <Input aria-label="Email address" placeholder="you@example.com" type="email" />
81
- <Button type="button" variant="primary">
82
- Send invite
83
- </Button>
84
- </CardContent>
85
- </Card>
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
- Set theme and mode on a shared ancestor, normally `<html>`:
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
- ```html
97
- <html class="dark" data-a63-mode="dark" data-a63-theme="modern">
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. Public
109
- publishing still requires YZ approval and npm organization policy.
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. See the design-system
115
- handbook's root API audit before treating a less common export as stable.
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 { type ButtonProps as B, Button as a };
13
+ export { Button as B, type ButtonProps as a };