@atom63/ui-react 0.2.0-beta.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.
Files changed (92) hide show
  1. package/README.md +121 -0
  2. package/dist/button-sktq-nvV.d.ts +13 -0
  3. package/dist/chunk-7VSPECOH.js +73 -0
  4. package/dist/chunk-7VSPECOH.js.map +1 -0
  5. package/dist/chunk-AJLHJRK6.js +11 -0
  6. package/dist/chunk-AJLHJRK6.js.map +1 -0
  7. package/dist/chunk-MXNO63TC.js +2745 -0
  8. package/dist/chunk-MXNO63TC.js.map +1 -0
  9. package/dist/chunk-STCXERLM.js +354 -0
  10. package/dist/chunk-STCXERLM.js.map +1 -0
  11. package/dist/destination-link-C9NKeKLe.d.ts +34 -0
  12. package/dist/index.d.ts +1605 -0
  13. package/dist/index.js +7337 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/layout/index.d.ts +196 -0
  16. package/dist/layout/index.js +500 -0
  17. package/dist/layout/index.js.map +1 -0
  18. package/dist/media/index.d.ts +208 -0
  19. package/dist/media/index.js +1498 -0
  20. package/dist/media/index.js.map +1 -0
  21. package/dist/media/media-lightbox/parts/index.d.ts +284 -0
  22. package/dist/media/media-lightbox/parts/index.js +5 -0
  23. package/dist/media/media-lightbox/parts/index.js.map +1 -0
  24. package/dist/theme/index.d.ts +350 -0
  25. package/dist/theme/index.js +1173 -0
  26. package/dist/theme/index.js.map +1 -0
  27. package/dist/types-Dxe5IzjE.d.ts +145 -0
  28. package/package.json +188 -0
  29. package/src/components/accordion/accordion.css +196 -0
  30. package/src/components/alert/alert.css +189 -0
  31. package/src/components/alert-dialog/alert-dialog.css +205 -0
  32. package/src/components/autocomplete/autocomplete.css +240 -0
  33. package/src/components/avatar/avatar.css +147 -0
  34. package/src/components/badge/badge.css +223 -0
  35. package/src/components/breadcrumb/breadcrumb.css +99 -0
  36. package/src/components/button/button.css +594 -0
  37. package/src/components/button-group/button-group.css +412 -0
  38. package/src/components/calendar/calendar.css +271 -0
  39. package/src/components/card/card.css +421 -0
  40. package/src/components/carousel/carousel.css +163 -0
  41. package/src/components/checkbox/checkbox.css +113 -0
  42. package/src/components/collapsible/collapsible.css +59 -0
  43. package/src/components/command/command.css +226 -0
  44. package/src/components/connected-panel/connected-panel.css +437 -0
  45. package/src/components/copy-button/copy-button.css +57 -0
  46. package/src/components/dialog/dialog.css +221 -0
  47. package/src/components/drawer/drawer.css +265 -0
  48. package/src/components/empty/empty.css +145 -0
  49. package/src/components/feedback-state/feedback-state.css +141 -0
  50. package/src/components/field/field.css +260 -0
  51. package/src/components/form/form.css +32 -0
  52. package/src/components/frame/frame.css +115 -0
  53. package/src/components/hover-card/hover-card.css +80 -0
  54. package/src/components/input/input.css +291 -0
  55. package/src/components/input-otp/input-otp.css +145 -0
  56. package/src/components/item/item.css +216 -0
  57. package/src/components/kbd/kbd.css +72 -0
  58. package/src/components/label/label.css +37 -0
  59. package/src/components/load-more-trigger/load-more-trigger.css +109 -0
  60. package/src/components/marquee/marquee.css +79 -0
  61. package/src/components/menu/menu.css +216 -0
  62. package/src/components/menubar/menubar.css +67 -0
  63. package/src/components/navigation-menu/navigation-menu.css +275 -0
  64. package/src/components/pagination/pagination.css +86 -0
  65. package/src/components/panel-setting-button/panel-setting-button.css +76 -0
  66. package/src/components/popover/popover.css +89 -0
  67. package/src/components/preview-card/preview-card.css +69 -0
  68. package/src/components/progress/progress.css +70 -0
  69. package/src/components/radio/radio.css +115 -0
  70. package/src/components/resizable/resizable.css +99 -0
  71. package/src/components/scroll-area/scroll-area.css +130 -0
  72. package/src/components/scrollable-list/scrollable-list.css +144 -0
  73. package/src/components/segmented-control/segmented-control.css +235 -0
  74. package/src/components/select/select.css +261 -0
  75. package/src/components/separator/separator.css +43 -0
  76. package/src/components/sheet/sheet.css +209 -0
  77. package/src/components/sidebar/sidebar.css +728 -0
  78. package/src/components/sidebar-nav-tree/sidebar-nav-tree.css +179 -0
  79. package/src/components/skeleton/skeleton.css +42 -0
  80. package/src/components/slider/slider.css +124 -0
  81. package/src/components/switch/switch.css +149 -0
  82. package/src/components/table/table.css +183 -0
  83. package/src/components/tabs/tabs.css +416 -0
  84. package/src/components/text-ticker/text-ticker.css +139 -0
  85. package/src/components/textarea/textarea.css +122 -0
  86. package/src/components/toggle/toggle.css +185 -0
  87. package/src/components/toggle-group/toggle-group.css +102 -0
  88. package/src/components/tooltip/tooltip.css +133 -0
  89. package/src/media/media-lightbox/media-lightbox.css +171 -0
  90. package/src/styles/index.css +3 -0
  91. package/src/styles/recipes.css +70 -0
  92. package/src/styles/reset.css +22 -0
package/README.md ADDED
@@ -0,0 +1,121 @@
1
+ # @atom63/ui-react
2
+
3
+ ## What this package is
4
+
5
+ The primary React renderer for Atom63. It provides accessible components,
6
+ layout primitives, media, and theme controls backed by `@atom63/ui-foundation`
7
+ contracts and `@atom63/styles` tokens.
8
+
9
+ Built by You Zhang through Hermes Agent
10
+
11
+ ## Install
12
+
13
+ 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:
19
+
20
+ ```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
+ }
35
+ ```
36
+
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.
40
+
41
+ ## Minimum setup
42
+
43
+ Load the shared CSS once, then render components from the root entry point.
44
+
45
+ ## CSS imports
46
+
47
+ Import the Atom63 foundation and the React recipe bundle once from the
48
+ application entry:
49
+
50
+ ```tsx
51
+ import '@atom63/styles'
52
+ import '@atom63/ui-react/styles.css'
53
+ ```
54
+
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.
58
+
59
+ ## First component
60
+
61
+ ```tsx
62
+ import {
63
+ Badge,
64
+ Button,
65
+ Card,
66
+ CardContent,
67
+ CardHeader,
68
+ CardTitle,
69
+ Input,
70
+ } from '@atom63/ui-react'
71
+
72
+ export function Example() {
73
+ 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>
86
+ )
87
+ }
88
+ ```
89
+
90
+ These imports match the packed-package smoke path and the package root exports.
91
+
92
+ ## Theming
93
+
94
+ Set theme and mode on a shared ancestor, normally `<html>`:
95
+
96
+ ```html
97
+ <html class="dark" data-a63-mode="dark" data-a63-theme="modern">
98
+ ```
99
+
100
+ The bundled themes are `modern`, `aqua`, `retro`, and `terminal`. Use `light` or
101
+ `dark` for mode. Applications that need persisted appearance controls can use
102
+ the package's `@atom63/ui-react/theme` entry point after reviewing the theme
103
+ documentation.
104
+
105
+ ## Stable vs preview
106
+
107
+ 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.
110
+
111
+ For the first public beta, the package keeps the current broad root export to
112
+ avoid pre-release churn, but the support promise is tiered. Core controls are the
113
+ 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.
116
+
117
+ ## Docs
118
+
119
+ - [Design system handbook](../../docs/design-system/README.md)
120
+ - [Component review and stability criteria](../../docs/design-system/ui-react-component-review.md)
121
+ - [Production readiness audit](../../docs/design-system/production-readiness-audit.md)
@@ -0,0 +1,13 @@
1
+ import { ButtonSize, ButtonVariant } from '@atom63/ui-foundation';
2
+ import { useRender } from '@base-ui/react/use-render';
3
+
4
+ interface ButtonProps extends useRender.ComponentProps<'button'> {
5
+ loading?: boolean;
6
+ size?: ButtonSize;
7
+ variant?: ButtonVariant;
8
+ /** Mirrored to `data-trigger-slot`; root `data-slot` stays `"button"`. */
9
+ 'data-slot'?: string;
10
+ }
11
+ declare function Button({ children, className, disabled, loading, render, size, type, variant, 'data-slot': triggerSlot, ...props }: ButtonProps): React.ReactElement;
12
+
13
+ export { type ButtonProps as B, Button as a };
@@ -0,0 +1,73 @@
1
+ import { cn } from './chunk-AJLHJRK6.js';
2
+ import { destinationLinkContract } from '@atom63/ui-foundation';
3
+ import { mergeProps } from '@base-ui/react/merge-props';
4
+ import { useRender } from '@base-ui/react/use-render';
5
+ import { ExternalLink, Eye } from 'lucide-react';
6
+ import * as React2 from 'react';
7
+ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
8
+
9
+ function DestinationLink({
10
+ "aria-label": ariaLabel,
11
+ children,
12
+ kind,
13
+ render,
14
+ ...props
15
+ }) {
16
+ const external = kind === "external";
17
+ const resolvedAriaLabel = external && ariaLabel ? `${ariaLabel} (opens in new tab)` : ariaLabel;
18
+ const resolvedChildren = external && !ariaLabel ? /* @__PURE__ */ jsxs(Fragment, { children: [
19
+ children,
20
+ " ",
21
+ /* @__PURE__ */ jsx("span", { className: "sr-only", children: "(opens in new tab)" })
22
+ ] }) : children;
23
+ return useRender({
24
+ defaultTagName: "a",
25
+ props: mergeProps(
26
+ {
27
+ "aria-label": resolvedAriaLabel,
28
+ children: resolvedChildren,
29
+ rel: external ? "noopener noreferrer" : void 0,
30
+ target: external ? "_blank" : void 0
31
+ },
32
+ props,
33
+ {
34
+ "data-destination-kind": kind,
35
+ "data-slot": destinationLinkContract.slots[0]
36
+ }
37
+ ),
38
+ render: external ? void 0 : render,
39
+ state: {
40
+ slot: "destination-link"
41
+ }
42
+ });
43
+ }
44
+ function DestinationIndicator({
45
+ className,
46
+ kind
47
+ }) {
48
+ const Icon = kind === "external" ? ExternalLink : Eye;
49
+ return /* @__PURE__ */ jsx(
50
+ "span",
51
+ {
52
+ "aria-hidden": true,
53
+ className: cn("inline-flex shrink-0", className),
54
+ "data-destination-kind": kind,
55
+ "data-slot": destinationLinkContract.slots[1],
56
+ children: /* @__PURE__ */ jsx(Icon, { "aria-hidden": true, className: "size-full" })
57
+ }
58
+ );
59
+ }
60
+ var PortalContainerContext = React2.createContext(void 0);
61
+ function PortalContainerProvider({
62
+ children,
63
+ container
64
+ }) {
65
+ return /* @__PURE__ */ jsx(PortalContainerContext.Provider, { value: container, children });
66
+ }
67
+ function usePortalContainer() {
68
+ return React2.useContext(PortalContainerContext);
69
+ }
70
+
71
+ export { DestinationIndicator, DestinationLink, PortalContainerProvider, usePortalContainer };
72
+ //# sourceMappingURL=chunk-7VSPECOH.js.map
73
+ //# sourceMappingURL=chunk-7VSPECOH.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/components/destination-link/destination-link.tsx","../src/components/portal-container/portal-container.tsx"],"names":["jsx"],"mappings":";;;;;;;;AAmBO,SAAS,eAAA,CAAgB;AAAA,EAC9B,YAAA,EAAc,SAAA;AAAA,EACd,QAAA;AAAA,EACA,IAAA;AAAA,EACA,MAAA;AAAA,EACA,GAAG;AACL,CAAA,EAA6C;AAC3C,EAAA,MAAM,WAAW,IAAA,KAAS,UAAA;AAC1B,EAAA,MAAM,iBAAA,GAAoB,QAAA,IAAY,SAAA,GAAY,CAAA,EAAG,SAAS,CAAA,mBAAA,CAAA,GAAwB,SAAA;AACtF,EAAA,MAAM,gBAAA,GACJ,QAAA,IAAY,CAAC,SAAA,mBACX,IAAA,CAAA,QAAA,EAAA,EACG,QAAA,EAAA;AAAA,IAAA,QAAA;AAAA,IAAS,GAAA;AAAA,oBAAC,GAAA,CAAC,MAAA,EAAA,EAAK,SAAA,EAAU,SAAA,EAAU,QAAA,EAAA,oBAAA,EAAkB;AAAA,GAAA,EACzD,CAAA,GAEA,QAAA;AAGJ,EAAA,OAAO,SAAA,CAAU;AAAA,IACf,cAAA,EAAgB,GAAA;AAAA,IAChB,KAAA,EAAO,UAAA;AAAA,MACL;AAAA,QACE,YAAA,EAAc,iBAAA;AAAA,QACd,QAAA,EAAU,gBAAA;AAAA,QACV,GAAA,EAAK,WAAW,qBAAA,GAAwB,MAAA;AAAA,QACxC,MAAA,EAAQ,WAAW,QAAA,GAAW;AAAA,OAChC;AAAA,MACA,KAAA;AAAA,MACA;AAAA,QACE,uBAAA,EAAyB,IAAA;AAAA,QACzB,WAAA,EAAa,uBAAA,CAAwB,KAAA,CAAM,CAAC;AAAA;AAC9C,KACF;AAAA,IACA,MAAA,EAAQ,WAAW,MAAA,GAAY,MAAA;AAAA,IAC/B,KAAA,EAAO;AAAA,MACL,IAAA,EAAM;AAAA;AACR,GACD,CAAA;AACH;AAkBO,SAAS,oBAAA,CAAqB;AAAA,EACnC,SAAA;AAAA,EACA;AACF,CAAA,EAGuB;AACrB,EAAA,MAAM,IAAA,GAAO,IAAA,KAAS,UAAA,GAAa,YAAA,GAAe,GAAA;AAClD,EAAA,uBACE,GAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACC,aAAA,EAAW,IAAA;AAAA,MACX,SAAA,EAAW,EAAA,CAAG,sBAAA,EAAwB,SAAS,CAAA;AAAA,MAC/C,uBAAA,EAAuB,IAAA;AAAA,MACvB,WAAA,EAAW,uBAAA,CAAwB,KAAA,CAAM,CAAC,CAAA;AAAA,MAE1C,QAAA,kBAAA,GAAA,CAAC,IAAA,EAAA,EAAK,aAAA,EAAW,IAAA,EAAC,WAAU,WAAA,EAAY;AAAA;AAAA,GAC1C;AAEJ;AC9EA,IAAM,sBAAA,GAA+B,qBAA+B,MAAS,CAAA;AAO7E,SAAS,uBAAA,CAAwB;AAAA,EAC/B,QAAA;AAAA,EACA;AACF,CAAA,EAAqD;AACnD,EAAA,uBACEA,GAAAA,CAAC,sBAAA,CAAuB,UAAvB,EAAgC,KAAA,EAAO,WAAY,QAAA,EAAS,CAAA;AAEjE;AAEA,SAAS,kBAAA,GAAsC;AAC7C,EAAA,OAAa,kBAAW,sBAAsB,CAAA;AAChD","file":"chunk-7VSPECOH.js","sourcesContent":["'use client'\n\nimport { type DestinationKind, destinationLinkContract } from '@atom63/ui-foundation'\nimport { mergeProps } from '@base-ui/react/merge-props'\nimport { useRender } from '@base-ui/react/use-render'\nimport { ExternalLink, Eye } from 'lucide-react'\nimport * as React from 'react'\nimport { cn } from '../../lib/cn'\n\nexport type { DestinationKind }\n\nexport type DestinationLinkProps = Omit<useRender.ComponentProps<'a'>, 'rel' | 'target'> & {\n kind: DestinationKind\n}\n\n/**\n * Router-neutral link semantics. Internal destinations may supply a router link\n * through `render`; external destinations always use a native new-tab anchor.\n */\nexport function DestinationLink({\n 'aria-label': ariaLabel,\n children,\n kind,\n render,\n ...props\n}: DestinationLinkProps): React.ReactElement {\n const external = kind === 'external'\n const resolvedAriaLabel = external && ariaLabel ? `${ariaLabel} (opens in new tab)` : ariaLabel\n const resolvedChildren =\n external && !ariaLabel ? (\n <>\n {children} <span className=\"sr-only\">(opens in new tab)</span>\n </>\n ) : (\n children\n )\n\n return useRender({\n defaultTagName: 'a',\n props: mergeProps<'a'>(\n {\n 'aria-label': resolvedAriaLabel,\n children: resolvedChildren,\n rel: external ? 'noopener noreferrer' : undefined,\n target: external ? '_blank' : undefined,\n },\n props,\n {\n 'data-destination-kind': kind,\n 'data-slot': destinationLinkContract.slots[0],\n } as React.ComponentProps<'a'>\n ),\n render: external ? undefined : render,\n state: {\n slot: 'destination-link',\n },\n })\n}\n\n/**\n * The glyph that names a destination: it opens a new tab, or it stays in the app.\n *\n * External is `open-in-new`, not a bare diagonal arrow. Measured by rasterising\n * each candidate and taking the alpha-weighted centroid, every bare arrow in the\n * set is ~12% ink with nearly all of it in the head, so its mass sits 1.3+ units\n * off the viewBox centre and it reads as crooked in a centred box unless each\n * call site carries a magic nudge (`north-east` needs 1.24px at 16px;\n * `arrow-outward-rounded`, 1.42px). `open-in-new` needs 0.14px — under a\n * rasterised pixel — so it is self-centring wherever it is used.\n *\n * It also pairs with `eye`: 25% ink in an 18×18 square against the eye's 35%,\n * rather than a wispy 15×15 diagonal beside a solid one. And it states what the\n * link actually does, matching the \"(opens in new tab)\" that `DestinationLink`\n * appends to the accessible name.\n */\nexport function DestinationIndicator({\n className,\n kind,\n}: {\n className?: string\n kind: DestinationKind\n}): React.ReactElement {\n const Icon = kind === 'external' ? ExternalLink : Eye\n return (\n <span\n aria-hidden\n className={cn('inline-flex shrink-0', className)}\n data-destination-kind={kind}\n data-slot={destinationLinkContract.slots[1]}\n >\n <Icon aria-hidden className=\"size-full\" />\n </span>\n )\n}\n","'use client'\n\nimport * as React from 'react'\n\n/*\n * PortalContainer — a tiny context that carries the DOM node (or ShadowRoot)\n * that portalled overlays (popovers, tooltips, dialogs) should render into.\n * Faithful port of prod @atom63/ui portal-container.tsx: same API\n * (PortalContainerProvider + usePortalContainer) and the same\n * HTMLElement | ShadowRoot | null | undefined value type. Purely behavioral —\n * no chrome, so there is no recipe CSS.\n */\n\nexport type PortalContainer = HTMLElement | ShadowRoot | null | undefined\n\nconst PortalContainerContext = React.createContext<PortalContainer>(undefined)\n\nexport interface PortalContainerProviderProps {\n children: React.ReactNode\n container: PortalContainer\n}\n\nfunction PortalContainerProvider({\n children,\n container,\n}: PortalContainerProviderProps): React.ReactElement {\n return (\n <PortalContainerContext.Provider value={container}>{children}</PortalContainerContext.Provider>\n )\n}\n\nfunction usePortalContainer(): PortalContainer {\n return React.useContext(PortalContainerContext)\n}\n\nexport { PortalContainerProvider, usePortalContainer }\n"]}
@@ -0,0 +1,11 @@
1
+ import { clsx } from 'clsx';
2
+ import { twMerge } from 'tailwind-merge';
3
+
4
+ // src/lib/cn.ts
5
+ function cn(...inputs) {
6
+ return twMerge(clsx(inputs));
7
+ }
8
+
9
+ export { cn };
10
+ //# sourceMappingURL=chunk-AJLHJRK6.js.map
11
+ //# sourceMappingURL=chunk-AJLHJRK6.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/lib/cn.ts"],"names":[],"mappings":";;;;AAIO,SAAS,MAAM,MAAA,EAA8B;AAClD,EAAA,OAAO,OAAA,CAAQ,IAAA,CAAK,MAAM,CAAC,CAAA;AAC7B","file":"chunk-AJLHJRK6.js","sourcesContent":["import { type ClassValue, clsx } from 'clsx'\nimport { twMerge } from 'tailwind-merge'\n\n/** Shared Tailwind-aware class merge for `@atom63/ui-react`. */\nexport function cn(...inputs: ClassValue[]): string {\n return twMerge(clsx(inputs))\n}\n"]}