@whity/ui 0.5.0 → 1.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.
Files changed (208) hide show
  1. package/README.md +107 -107
  2. package/package.json +223 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +125 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +399 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1687 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +457 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +59 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +92 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-input.tsx +252 -0
  151. package/src/phone-tab-bar.tsx +152 -0
  152. package/src/plugin-card.stories.tsx +208 -180
  153. package/src/plugin-card.tsx +931 -848
  154. package/src/popover.stories.tsx +48 -48
  155. package/src/popover.tsx +55 -55
  156. package/src/radio-group.stories.tsx +26 -26
  157. package/src/radio-group.tsx +44 -44
  158. package/src/role-summary.stories.tsx +143 -0
  159. package/src/role-summary.tsx +120 -0
  160. package/src/route-flow/editor.tsx +1087 -1014
  161. package/src/route-flow/model.ts +771 -716
  162. package/src/save-bar.tsx +94 -0
  163. package/src/scope-grant.tsx +139 -139
  164. package/src/screen-too-small.stories.tsx +61 -61
  165. package/src/screen-too-small.tsx +104 -104
  166. package/src/search-field.tsx +65 -0
  167. package/src/select.stories.tsx +44 -44
  168. package/src/select.tsx +197 -197
  169. package/src/separator.stories.tsx +34 -34
  170. package/src/separator.tsx +34 -34
  171. package/src/sheet.stories.tsx +49 -49
  172. package/src/sheet.tsx +168 -168
  173. package/src/skeleton.stories.tsx +28 -28
  174. package/src/skeleton.tsx +19 -19
  175. package/src/slider.stories.tsx +78 -78
  176. package/src/slider.tsx +300 -300
  177. package/src/spinner.stories.tsx +33 -33
  178. package/src/spinner.tsx +55 -55
  179. package/src/stepper.tsx +85 -0
  180. package/src/switch.stories.tsx +42 -42
  181. package/src/switch.tsx +41 -41
  182. package/src/switcher.stories.tsx +111 -111
  183. package/src/switcher.tsx +131 -131
  184. package/src/system-state.tsx +55 -0
  185. package/src/table.stories.tsx +48 -48
  186. package/src/table.tsx +121 -121
  187. package/src/tabs.stories.tsx +74 -74
  188. package/src/tabs.tsx +90 -90
  189. package/src/tag-input.stories.tsx +67 -67
  190. package/src/tag-input.tsx +117 -117
  191. package/src/tenant-logo.tsx +63 -63
  192. package/src/tenant-switcher.stories.tsx +38 -38
  193. package/src/tenant-switcher.tsx +185 -164
  194. package/src/textarea.stories.tsx +27 -27
  195. package/src/textarea.tsx +18 -18
  196. package/src/theme-mode.ts +74 -52
  197. package/src/time-grid.tsx +163 -0
  198. package/src/time-picker.stories.tsx +62 -62
  199. package/src/time-picker.tsx +616 -615
  200. package/src/toggle-group.tsx +139 -138
  201. package/src/tooltip.stories.tsx +43 -43
  202. package/src/tooltip.tsx +73 -73
  203. package/src/top-nav.stories.tsx +58 -58
  204. package/src/top-nav.tsx +324 -324
  205. package/src/undo-bar.tsx +107 -107
  206. package/src/utils.ts +45 -45
  207. package/src/view-toggle.stories.tsx +84 -84
  208. package/src/view-toggle.tsx +111 -110
package/README.md CHANGED
@@ -1,107 +1,107 @@
1
- # @whity/ui
2
-
3
- Shared UI primitives for Whity products, built on Radix + Tailwind v4.
4
-
5
- ## Consuming from a non-Next.js client (Tauri, plain Vite SPA, etc.)
6
-
7
- Every component in `src/` is plain React with zero Next.js dependency —
8
- confirmed by a CI guard (`.github/workflows/publish-ui.yml`) that fails the
9
- build if a `next/*` import ever appears here. `"use client"` directives exist
10
- on the components below for Next.js/RSC's benefit only; they're inert
11
- (harmless no-ops) outside Next, so a plain Vite/Tauri SPA can import and use
12
- every component in this package as-is:
13
-
14
- `alert-dialog`, `checkbox`, `data-table`, `dialog`, `dropdown-menu`, `select`,
15
- `sheet`, `switch`, `tabs`, `tooltip`.
16
-
17
- Everything else has no directive at all (nothing RSC-sensitive to mark).
18
-
19
- ### Getting the components
20
-
21
- Two ways to consume this package, matching how it's used inside whity-core
22
- itself:
23
-
24
- 1. **npm package** — `npm install @whity/ui` (published to public npm
25
- under the `@whity` scope, no token needed) for the components' compiled
26
- exports and the theme (`@whity/ui/globals.css`, itself built on top of
27
- `@whity/tokens` — see below).
28
- 2. **shadcn registry** — for a locally-customizable, re-pullable copy of a
29
- component's actual source (the same mechanism whity-core's own `web/`
30
- package uses): add a `registries` entry to your own project's
31
- `components.json`:
32
- ```json
33
- {
34
- "registries": {
35
- "@whity": "https://whity.jameedium.org/r/{name}.json"
36
- }
37
- }
38
- ```
39
- then `npx shadcn add @whity/button` (or any other component name from
40
- `web/registry.json`). Re-run the same command to pull updates.
41
-
42
- ### Design tokens without the component library
43
-
44
- If a client only needs the design tokens (colors, typography, spacing,
45
- radius) — not the React components — depend on `@whity/tokens` directly
46
- instead:
47
-
48
- ```css
49
- @import "tailwindcss";
50
- @import "@whity/tokens/css"; /* colors + typography theme */
51
- @import "@whity/tokens/base.css"; /* shadcn/Tailwind base-reset layer */
52
- @import "@whity/tokens/fonts.css"; /* self-hosted Noto Sans, Noto Sans Arabic, Geist Mono */
53
- ```
54
-
55
- ```ts
56
- import tokens from "@whity/tokens"; // tokens.json
57
- ```
58
-
59
- `./css` gives you the color/typography custom properties and the Tailwind v4
60
- `@theme inline` mapping. `./base.css` is the same border/ring reset,
61
- `body` background/foreground, and default font that `web/app/globals.css`
62
- and this package's own `src/globals.css` used to hand-duplicate — import it
63
- once instead of re-typing that `@layer base` block per client. `./fonts.css`
64
- declares `@font-face` rules for the three type families `--font-sans` /
65
- `--font-mono` reference, backed by the woff2 binaries in this package's
66
- `fonts/` directory (OFL-licensed, see `fonts/LICENSE-*.txt`) — no network
67
- fetch, no Next.js font-loader dependency. A Next.js app can skip `fonts.css`
68
- and keep using `next/font` (as `web/` does) since it gets equivalent
69
- self-hosting plus build-time optimization for free; `fonts.css` exists for
70
- every client that doesn't have that pipeline (Tauri, plain Vite, Storybook).
71
-
72
- Flutter clients use the same color/typography source of truth via a git
73
- dependency — see `flutter/whity_tokens/README.md` in this repo. Font
74
- *binaries* aren't bundled there yet; a Flutter app should declare its own
75
- font assets in `pubspec.yaml` (family names must match
76
- `typography.fontFamilyDart` in `src/design/tokens/base.json`: `Noto Sans`,
77
- `Noto Sans Arabic`, `Geist Mono`).
78
-
79
- All three (`@whity/ui`, `@whity/tokens`, `flutter/whity_tokens`) are
80
- generated from the same single source of truth,
81
- `src/design/tokens/base.json` — run `npm run tokens:generate` (from `web/`)
82
- after changing it to regenerate every target.
83
-
84
- ### Theme mode (light/dark/system) contract
85
-
86
- Every client should implement light/dark switching the same way so a toggle
87
- built in one client looks and behaves identically in another:
88
-
89
- - **Strategy**: apply/remove a `.dark` class on the root element (`<html>` on
90
- web) — the exact selector `@custom-variant dark (&:is(.dark *));` (in
91
- `@whity/tokens/css`) and every `.dark { ... }` token block target. No
92
- class means light mode.
93
- - **Persistence key**: `whity.theme`, storing the raw preference —
94
- `'light' | 'dark' | 'system'`, not the resolved value.
95
- - **Default**: `'system'` when nothing is stored yet, resolved against the
96
- OS/platform light-dark setting.
97
- - **FOUC**: apply the class before first paint. On web this is a small
98
- blocking inline `<script>` in `<head>`, before any stylesheet.
99
-
100
- `src/theme-mode.ts` (exported as `@whity/ui/theme-mode`, also available
101
- via the shadcn registry as `@whity/theme-mode`) is the framework-agnostic
102
- (no React) half of this contract — the storage key constant, the
103
- `resolveIsDark()` resolution rule, and `buildThemeInitScript()` for the
104
- anti-FOUC script source. `web/lib/theme-mode-context.tsx` is the React
105
- provider built on top of it. A non-JS client (Flutter) can't import this file
106
- directly but should replicate the same key, values, and resolution rule by
107
- hand.
1
+ # @whity/ui
2
+
3
+ Shared UI primitives for Whity products, built on Radix + Tailwind v4.
4
+
5
+ ## Consuming from a non-Next.js client (Tauri, plain Vite SPA, etc.)
6
+
7
+ Every component in `src/` is plain React with zero Next.js dependency —
8
+ confirmed by a CI guard (`.github/workflows/publish-ui.yml`) that fails the
9
+ build if a `next/*` import ever appears here. `"use client"` directives exist
10
+ on the components below for Next.js/RSC's benefit only; they're inert
11
+ (harmless no-ops) outside Next, so a plain Vite/Tauri SPA can import and use
12
+ every component in this package as-is:
13
+
14
+ `alert-dialog`, `checkbox`, `data-table`, `dialog`, `dropdown-menu`, `select`,
15
+ `sheet`, `switch`, `tabs`, `tooltip`.
16
+
17
+ Everything else has no directive at all (nothing RSC-sensitive to mark).
18
+
19
+ ### Getting the components
20
+
21
+ Two ways to consume this package, matching how it's used inside whity-core
22
+ itself:
23
+
24
+ 1. **npm package** — `npm install @whity/ui` (published to public npm
25
+ under the `@whity` scope, no token needed) for the components' compiled
26
+ exports and the theme (`@whity/ui/globals.css`, itself built on top of
27
+ `@whity/tokens` — see below).
28
+ 2. **shadcn registry** — for a locally-customizable, re-pullable copy of a
29
+ component's actual source (the same mechanism whity-core's own `web/`
30
+ package uses): add a `registries` entry to your own project's
31
+ `components.json`:
32
+ ```json
33
+ {
34
+ "registries": {
35
+ "@whity": "https://whity.jameedium.org/r/{name}.json"
36
+ }
37
+ }
38
+ ```
39
+ then `npx shadcn add @whity/button` (or any other component name from
40
+ `web/registry.json`). Re-run the same command to pull updates.
41
+
42
+ ### Design tokens without the component library
43
+
44
+ If a client only needs the design tokens (colors, typography, spacing,
45
+ radius) — not the React components — depend on `@whity/tokens` directly
46
+ instead:
47
+
48
+ ```css
49
+ @import "tailwindcss";
50
+ @import "@whity/tokens/css"; /* colors + typography theme */
51
+ @import "@whity/tokens/base.css"; /* shadcn/Tailwind base-reset layer */
52
+ @import "@whity/tokens/fonts.css"; /* self-hosted Noto Sans, Noto Sans Arabic, Geist Mono */
53
+ ```
54
+
55
+ ```ts
56
+ import tokens from "@whity/tokens"; // tokens.json
57
+ ```
58
+
59
+ `./css` gives you the color/typography custom properties and the Tailwind v4
60
+ `@theme inline` mapping. `./base.css` is the same border/ring reset,
61
+ `body` background/foreground, and default font that `web/app/globals.css`
62
+ and this package's own `src/globals.css` used to hand-duplicate — import it
63
+ once instead of re-typing that `@layer base` block per client. `./fonts.css`
64
+ declares `@font-face` rules for the three type families `--font-sans` /
65
+ `--font-mono` reference, backed by the woff2 binaries in this package's
66
+ `fonts/` directory (OFL-licensed, see `fonts/LICENSE-*.txt`) — no network
67
+ fetch, no Next.js font-loader dependency. A Next.js app can skip `fonts.css`
68
+ and keep using `next/font` (as `web/` does) since it gets equivalent
69
+ self-hosting plus build-time optimization for free; `fonts.css` exists for
70
+ every client that doesn't have that pipeline (Tauri, plain Vite, Storybook).
71
+
72
+ Flutter clients use the same color/typography source of truth via a git
73
+ dependency — see `flutter/whity_tokens/README.md` in this repo. Font
74
+ *binaries* aren't bundled there yet; a Flutter app should declare its own
75
+ font assets in `pubspec.yaml` (family names must match
76
+ `typography.fontFamilyDart` in `src/design/tokens/base.json`: `Noto Sans`,
77
+ `Noto Sans Arabic`, `Geist Mono`).
78
+
79
+ All three (`@whity/ui`, `@whity/tokens`, `flutter/whity_tokens`) are
80
+ generated from the same single source of truth,
81
+ `src/design/tokens/base.json` — run `npm run tokens:generate` (from `web/`)
82
+ after changing it to regenerate every target.
83
+
84
+ ### Theme mode (light/dark/system) contract
85
+
86
+ Every client should implement light/dark switching the same way so a toggle
87
+ built in one client looks and behaves identically in another:
88
+
89
+ - **Strategy**: apply/remove a `.dark` class on the root element (`<html>` on
90
+ web) — the exact selector `@custom-variant dark (&:is(.dark *));` (in
91
+ `@whity/tokens/css`) and every `.dark { ... }` token block target. No
92
+ class means light mode.
93
+ - **Persistence key**: `whity.theme`, storing the raw preference —
94
+ `'light' | 'dark' | 'system'`, not the resolved value.
95
+ - **Default**: `'system'` when nothing is stored yet, resolved against the
96
+ OS/platform light-dark setting.
97
+ - **FOUC**: apply the class before first paint. On web this is a small
98
+ blocking inline `<script>` in `<head>`, before any stylesheet.
99
+
100
+ `src/theme-mode.ts` (exported as `@whity/ui/theme-mode`, also available
101
+ via the shadcn registry as `@whity/theme-mode`) is the framework-agnostic
102
+ (no React) half of this contract — the storage key constant, the
103
+ `resolveIsDark()` resolution rule, and `buildThemeInitScript()` for the
104
+ anti-FOUC script source. `web/lib/theme-mode-context.tsx` is the React
105
+ provider built on top of it. A non-JS client (Flutter) can't import this file
106
+ directly but should replicate the same key, values, and resolution rule by
107
+ hand.