@whity/ui 0.5.0 → 1.0.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 (205) hide show
  1. package/README.md +107 -107
  2. package/package.json +221 -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 +123 -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 +398 -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 +1686 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +456 -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 +50 -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 +90 -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-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -180
  152. package/src/plugin-card.tsx +931 -848
  153. package/src/popover.stories.tsx +48 -48
  154. package/src/popover.tsx +55 -55
  155. package/src/radio-group.stories.tsx +26 -26
  156. package/src/radio-group.tsx +44 -44
  157. package/src/route-flow/editor.tsx +1087 -1014
  158. package/src/route-flow/model.ts +771 -716
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -139
  161. package/src/screen-too-small.stories.tsx +61 -61
  162. package/src/screen-too-small.tsx +104 -104
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -44
  165. package/src/select.tsx +197 -197
  166. package/src/separator.stories.tsx +34 -34
  167. package/src/separator.tsx +34 -34
  168. package/src/sheet.stories.tsx +49 -49
  169. package/src/sheet.tsx +168 -168
  170. package/src/skeleton.stories.tsx +28 -28
  171. package/src/skeleton.tsx +19 -19
  172. package/src/slider.stories.tsx +78 -78
  173. package/src/slider.tsx +300 -300
  174. package/src/spinner.stories.tsx +33 -33
  175. package/src/spinner.tsx +55 -55
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -42
  178. package/src/switch.tsx +41 -41
  179. package/src/switcher.stories.tsx +111 -111
  180. package/src/switcher.tsx +131 -131
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -48
  183. package/src/table.tsx +121 -121
  184. package/src/tabs.stories.tsx +74 -74
  185. package/src/tabs.tsx +90 -90
  186. package/src/tag-input.stories.tsx +67 -67
  187. package/src/tag-input.tsx +117 -117
  188. package/src/tenant-logo.tsx +63 -63
  189. package/src/tenant-switcher.stories.tsx +38 -38
  190. package/src/tenant-switcher.tsx +164 -164
  191. package/src/textarea.stories.tsx +27 -27
  192. package/src/textarea.tsx +18 -18
  193. package/src/theme-mode.ts +52 -52
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -62
  196. package/src/time-picker.tsx +615 -615
  197. package/src/toggle-group.tsx +138 -138
  198. package/src/tooltip.stories.tsx +43 -43
  199. package/src/tooltip.tsx +73 -73
  200. package/src/top-nav.stories.tsx +58 -58
  201. package/src/top-nav.tsx +324 -324
  202. package/src/undo-bar.tsx +107 -107
  203. package/src/utils.ts +45 -45
  204. package/src/view-toggle.stories.tsx +84 -84
  205. package/src/view-toggle.tsx +110 -110
@@ -1,45 +1,45 @@
1
- import type { Meta, StoryObj } from "@storybook/react-vite"
2
- import * as React from "react"
3
-
4
- import { Pagination } from "./pagination"
5
-
6
- const meta = {
7
- title: "Primitives/Pagination",
8
- component: Pagination,
9
- tags: ["autodocs"],
10
- } satisfies Meta<typeof Pagination>
11
-
12
- export default meta
13
- type Story = StoryObj<typeof meta>
14
-
15
- export const Default: Story = {
16
- args: { page: 2, perPage: 25, total: 214, onPageChange: () => {} },
17
- render: (args) => {
18
- const [page, setPage] = React.useState(args.page)
19
- return <Pagination {...args} page={page} onPageChange={setPage} />
20
- },
21
- }
22
-
23
- export const FirstPage: Story = {
24
- args: { page: 1, perPage: 25, total: 214, onPageChange: () => {} },
25
- render: (args) => {
26
- const [page, setPage] = React.useState(args.page)
27
- return <Pagination {...args} page={page} onPageChange={setPage} />
28
- },
29
- }
30
-
31
- export const LastPage: Story = {
32
- args: { page: 9, perPage: 25, total: 214, onPageChange: () => {} },
33
- render: (args) => {
34
- const [page, setPage] = React.useState(args.page)
35
- return <Pagination {...args} page={page} onPageChange={setPage} />
36
- },
37
- }
38
-
39
- export const SinglePage: Story = {
40
- args: { page: 1, perPage: 25, total: 12, onPageChange: () => {} },
41
- render: (args) => {
42
- const [page, setPage] = React.useState(args.page)
43
- return <Pagination {...args} page={page} onPageChange={setPage} />
44
- },
45
- }
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import * as React from "react"
3
+
4
+ import { Pagination } from "./pagination"
5
+
6
+ const meta = {
7
+ title: "Primitives/Pagination",
8
+ component: Pagination,
9
+ tags: ["autodocs"],
10
+ } satisfies Meta<typeof Pagination>
11
+
12
+ export default meta
13
+ type Story = StoryObj<typeof meta>
14
+
15
+ export const Default: Story = {
16
+ args: { page: 2, perPage: 25, total: 214, onPageChange: () => {} },
17
+ render: (args) => {
18
+ const [page, setPage] = React.useState(args.page)
19
+ return <Pagination {...args} page={page} onPageChange={setPage} />
20
+ },
21
+ }
22
+
23
+ export const FirstPage: Story = {
24
+ args: { page: 1, perPage: 25, total: 214, onPageChange: () => {} },
25
+ render: (args) => {
26
+ const [page, setPage] = React.useState(args.page)
27
+ return <Pagination {...args} page={page} onPageChange={setPage} />
28
+ },
29
+ }
30
+
31
+ export const LastPage: Story = {
32
+ args: { page: 9, perPage: 25, total: 214, onPageChange: () => {} },
33
+ render: (args) => {
34
+ const [page, setPage] = React.useState(args.page)
35
+ return <Pagination {...args} page={page} onPageChange={setPage} />
36
+ },
37
+ }
38
+
39
+ export const SinglePage: Story = {
40
+ args: { page: 1, perPage: 25, total: 12, onPageChange: () => {} },
41
+ render: (args) => {
42
+ const [page, setPage] = React.useState(args.page)
43
+ return <Pagination {...args} page={page} onPageChange={setPage} />
44
+ },
45
+ }
@@ -1,98 +1,98 @@
1
- import * as React from "react"
2
- import { IconChevronLeft, IconChevronRight } from "@tabler/icons-react"
3
-
4
- import { cn } from "./utils"
5
- import { Button } from "./button"
6
-
7
- /**
8
- * Routing-agnostic prev/next pagination — modeled on the ad-hoc pattern
9
- * already used on the audit-logs page (total/page/totalPages + prev/next
10
- * buttons disabled at the boundaries), promoted to a shared, token-styled
11
- * primitive. Migrating that page's inline markup onto this component is a
12
- * follow-up, not in scope here.
13
- *
14
- * PLATFORM NOTE: `page`/`perPage`/`total`/`onPageChange` are plain
15
- * numbers/callbacks — no coupling to Next.js routing (no useRouter/
16
- * useSearchParams anywhere here) — directly mirrorable by a future Flutter
17
- * pagination widget.
18
- */
19
- export interface PaginationProps extends Omit<React.ComponentProps<"nav">, "onChange"> {
20
- /** 1-indexed current page. */
21
- page: number
22
- perPage: number
23
- /** Total row count across all pages (not just the current page). */
24
- total: number
25
- onPageChange: (page: number) => void
26
- /** Optional override for the "N entries" label (e.g. singular/plural, i18n). */
27
- entriesLabel?: (total: number) => string
28
- /**
29
- * Optional override for "page 2 of 7".
30
- *
31
- * A function, not a string, for the same reason `entriesLabel` is one: the
32
- * numbers sit INSIDE the sentence, and word order around them differs
33
- * between languages. A caller that could only supply "page" and "of"
34
- * separately would be pinned to English order.
35
- */
36
- pageLabel?: (page: number, totalPages: number) => string
37
- /** Accessible name for the surrounding <nav>. */
38
- navLabel?: string
39
- /** Accessible name for the previous-page button. */
40
- previousLabel?: string
41
- /** Accessible name for the next-page button. */
42
- nextLabel?: string
43
- }
44
-
45
- function Pagination({
46
- className,
47
- page,
48
- perPage,
49
- total,
50
- onPageChange,
51
- entriesLabel,
52
- pageLabel,
53
- navLabel = "Pagination",
54
- previousLabel = "Previous page",
55
- nextLabel = "Next page",
56
- ...props
57
- }: PaginationProps) {
58
- const totalPages = Math.max(1, Math.ceil(total / perPage))
59
- const label = entriesLabel ?? ((n: number) => (n === 1 ? "1 entry" : `${n} entries`))
60
- const pages = pageLabel ?? ((current: number, last: number) => `page ${current} of ${last}`)
61
-
62
- return (
63
- <nav
64
- data-slot="pagination"
65
- aria-label={navLabel}
66
- className={cn("flex items-center justify-between", className)}
67
- {...props}
68
- >
69
- <p className="text-sm text-muted-foreground">
70
- {label(total)} &middot; {pages(page, totalPages)}
71
- </p>
72
- <div className="flex gap-2">
73
- <Button
74
- type="button"
75
- variant="outline"
76
- size="icon-sm"
77
- disabled={page <= 1}
78
- onClick={() => onPageChange(Math.max(1, page - 1))}
79
- aria-label={previousLabel}
80
- >
81
- <IconChevronLeft className="rtl:rotate-180" />
82
- </Button>
83
- <Button
84
- type="button"
85
- variant="outline"
86
- size="icon-sm"
87
- disabled={page >= totalPages}
88
- onClick={() => onPageChange(Math.min(totalPages, page + 1))}
89
- aria-label={nextLabel}
90
- >
91
- <IconChevronRight className="rtl:rotate-180" />
92
- </Button>
93
- </div>
94
- </nav>
95
- )
96
- }
97
-
98
- export { Pagination }
1
+ import * as React from "react"
2
+ import { IconChevronLeft, IconChevronRight } from "@tabler/icons-react"
3
+
4
+ import { cn } from "./utils"
5
+ import { Button } from "./button"
6
+
7
+ /**
8
+ * Routing-agnostic prev/next pagination — modeled on the ad-hoc pattern
9
+ * already used on the audit-logs page (total/page/totalPages + prev/next
10
+ * buttons disabled at the boundaries), promoted to a shared, token-styled
11
+ * primitive. Migrating that page's inline markup onto this component is a
12
+ * follow-up, not in scope here.
13
+ *
14
+ * PLATFORM NOTE: `page`/`perPage`/`total`/`onPageChange` are plain
15
+ * numbers/callbacks — no coupling to Next.js routing (no useRouter/
16
+ * useSearchParams anywhere here) — directly mirrorable by a future Flutter
17
+ * pagination widget.
18
+ */
19
+ export interface PaginationProps extends Omit<React.ComponentProps<"nav">, "onChange"> {
20
+ /** 1-indexed current page. */
21
+ page: number
22
+ perPage: number
23
+ /** Total row count across all pages (not just the current page). */
24
+ total: number
25
+ onPageChange: (page: number) => void
26
+ /** Optional override for the "N entries" label (e.g. singular/plural, i18n). */
27
+ entriesLabel?: (total: number) => string
28
+ /**
29
+ * Optional override for "page 2 of 7".
30
+ *
31
+ * A function, not a string, for the same reason `entriesLabel` is one: the
32
+ * numbers sit INSIDE the sentence, and word order around them differs
33
+ * between languages. A caller that could only supply "page" and "of"
34
+ * separately would be pinned to English order.
35
+ */
36
+ pageLabel?: (page: number, totalPages: number) => string
37
+ /** Accessible name for the surrounding <nav>. */
38
+ navLabel?: string
39
+ /** Accessible name for the previous-page button. */
40
+ previousLabel?: string
41
+ /** Accessible name for the next-page button. */
42
+ nextLabel?: string
43
+ }
44
+
45
+ function Pagination({
46
+ className,
47
+ page,
48
+ perPage,
49
+ total,
50
+ onPageChange,
51
+ entriesLabel,
52
+ pageLabel,
53
+ navLabel = "Pagination",
54
+ previousLabel = "Previous page",
55
+ nextLabel = "Next page",
56
+ ...props
57
+ }: PaginationProps) {
58
+ const totalPages = Math.max(1, Math.ceil(total / perPage))
59
+ const label = entriesLabel ?? ((n: number) => (n === 1 ? "1 entry" : `${n} entries`))
60
+ const pages = pageLabel ?? ((current: number, last: number) => `page ${current} of ${last}`)
61
+
62
+ return (
63
+ <nav
64
+ data-slot="pagination"
65
+ aria-label={navLabel}
66
+ className={cn("flex items-center justify-between", className)}
67
+ {...props}
68
+ >
69
+ <p className="text-sm text-muted-foreground">
70
+ {label(total)} &middot; {pages(page, totalPages)}
71
+ </p>
72
+ <div className="flex gap-2">
73
+ <Button
74
+ type="button"
75
+ variant="outline"
76
+ size="icon-sm"
77
+ disabled={page <= 1}
78
+ onClick={() => onPageChange(Math.max(1, page - 1))}
79
+ aria-label={previousLabel}
80
+ >
81
+ <IconChevronLeft className="rtl:rotate-180" />
82
+ </Button>
83
+ <Button
84
+ type="button"
85
+ variant="outline"
86
+ size="icon-sm"
87
+ disabled={page >= totalPages}
88
+ onClick={() => onPageChange(Math.min(totalPages, page + 1))}
89
+ aria-label={nextLabel}
90
+ >
91
+ <IconChevronRight className="rtl:rotate-180" />
92
+ </Button>
93
+ </div>
94
+ </nav>
95
+ )
96
+ }
97
+
98
+ export { Pagination }
@@ -0,0 +1,88 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { IconQrcode } from "@tabler/icons-react"
3
+
4
+ import { PaperEyebrow, PaperGround, PaperHeadline, PaperSheet } from "./paper-sheet"
5
+ import { Lockup } from "./lockup"
6
+
7
+ /**
8
+ * Sheets on paper (docs/design/10-patterns.md): white sheets on the grey
9
+ * ground, one on its plane under the one thing that matters.
10
+ */
11
+ const meta = {
12
+ title: "Brand/Sheets on paper",
13
+ component: PaperSheet,
14
+ tags: ["autodocs"],
15
+ parameters: { layout: "fullscreen" },
16
+ } satisfies Meta<typeof PaperSheet>
17
+
18
+ export default meta
19
+ type Story = StoryObj<typeof meta>
20
+
21
+ export const Sheet: Story = {
22
+ render: () => (
23
+ <PaperGround className="p-10">
24
+ <PaperSheet className="max-w-md space-y-3 p-8">
25
+ <PaperEyebrow>Example Bakery · Documents</PaperEyebrow>
26
+ <PaperHeadline>Every paper you issue can be checked.</PaperHeadline>
27
+ <p className="text-muted-foreground">Scan the code on a printed document to see that it is genuine.</p>
28
+ </PaperSheet>
29
+ </PaperGround>
30
+ ),
31
+ }
32
+
33
+ export const OnThePlane: Story = {
34
+ name: "On the plane (clickable)",
35
+ render: () => (
36
+ <PaperGround className="p-10">
37
+ <PaperSheet as="button" type="button" plane className="flex max-w-sm items-center gap-4 p-5">
38
+ <span className="grid size-11 shrink-0 place-items-center rounded-control-lg bg-primary-tint text-primary-tint-foreground">
39
+ <IconQrcode className="size-6" aria-hidden />
40
+ </span>
41
+ <span className="space-y-0.5">
42
+ <span className="block font-semibold">Verify a document</span>
43
+ <span className="block text-sm text-muted-foreground">Scan the QR code on a printed page.</span>
44
+ </span>
45
+ </PaperSheet>
46
+ </PaperGround>
47
+ ),
48
+ }
49
+
50
+ export const NotYet: Story = {
51
+ name: "Dashed (not yet)",
52
+ render: () => (
53
+ <PaperGround className="p-10">
54
+ <PaperSheet dashed className="max-w-sm p-5 text-muted-foreground">
55
+ An optional step that has not happened yet.
56
+ </PaperSheet>
57
+ </PaperGround>
58
+ ),
59
+ }
60
+
61
+ export const Composition: Story = {
62
+ render: () => (
63
+ <PaperGround className="flex min-h-[32rem] flex-col justify-between gap-10 p-10">
64
+ <div className="max-w-md space-y-8">
65
+ <PaperSheet className="space-y-3 p-8">
66
+ <PaperEyebrow>Open source · White-label · MCP</PaperEyebrow>
67
+ <PaperHeadline>Agents propose. Your team decides.</PaperHeadline>
68
+ <p className="text-muted-foreground">One sheet carries the message; the plane sits under the one thing that matters.</p>
69
+ </PaperSheet>
70
+ <PaperSheet as="button" type="button" plane className="ml-6 block w-[calc(100%-1.5rem)] p-5 font-semibold">
71
+ Verify a document
72
+ </PaperSheet>
73
+ </div>
74
+ <Lockup size={28} />
75
+ </PaperGround>
76
+ ),
77
+ }
78
+
79
+ export const LockupSizes: Story = {
80
+ name: "Lockup",
81
+ render: () => (
82
+ <PaperGround className="flex flex-col items-start gap-6 p-10">
83
+ <Lockup size={20} />
84
+ <Lockup size={32} />
85
+ <Lockup size={48} />
86
+ </PaperGround>
87
+ ),
88
+ }
@@ -0,0 +1,85 @@
1
+ import * as React from "react"
2
+ import { cn } from "./utils"
3
+
4
+ /**
5
+ * The everyday brand pattern, "sheets on paper" (docs/design/10-patterns.md):
6
+ * white sheets with soft corners on the grey ground, and one of them resting
7
+ * on its plane, the way the mark's sheet rests on the platform.
8
+ *
9
+ * - `PaperGround` is the grey ground the sheets lie on.
10
+ * - `PaperSheet` is one sheet. `plane` sets it on the brand-coloured plane, a
11
+ * hard offset down and to the left that never mirrors in RTL (decision 4.3).
12
+ * Use it under the one thing that matters on the piece, and only once.
13
+ * `dashed` is the "not yet" sheet: something optional or still waiting.
14
+ *
15
+ * A clickable sheet on the plane lifts on hover like any clickable card.
16
+ * Brand surfaces only (sign-in, covers, social): product screens use `Card`.
17
+ * Never on a white-label tenant's pages, which carry their own brand.
18
+ */
19
+
20
+ function PaperGround({ className, ...props }: React.ComponentProps<"div">) {
21
+ return <div data-slot="paper-ground" className={cn("bg-background", className)} {...props} />
22
+ }
23
+
24
+ type SheetProps<T extends React.ElementType> = {
25
+ as?: T
26
+ /** Rest the sheet on its plane. One per piece. */
27
+ plane?: boolean
28
+ /** The "not yet" sheet: dashed and flat. Ignored with `plane`. */
29
+ dashed?: boolean
30
+ className?: string
31
+ } & Omit<React.ComponentPropsWithoutRef<T>, "as" | "className">
32
+
33
+ /*
34
+ * The plane at sheet scale: 12px (0.75rem) down and to the start, in the brand
35
+ * colour, growing to 16px on hover for something clickable. The shadow keeps
36
+ * the sheet's corners, so the plane is the same rounded shape, like the mark.
37
+ */
38
+ const PLANE = "shadow-[-0.75rem_0.75rem_0_0_var(--brand)]"
39
+ const PLANE_LIFT =
40
+ "transition-[box-shadow,translate] duration-[var(--dur-fast)] ease-[var(--ease-out)] hover:translate-x-px hover:-translate-y-px hover:shadow-[-1rem_1rem_0_0_var(--brand)] focus-visible:translate-x-px focus-visible:-translate-y-px focus-visible:shadow-[-1rem_1rem_0_0_var(--brand)] motion-reduce:transition-none"
41
+
42
+ function PaperSheet<T extends React.ElementType = "div">({ as, plane = false, dashed = false, className, ...props }: SheetProps<T>) {
43
+ const Comp: React.ElementType = as ?? "div"
44
+ const interactive = Comp === "button" || Comp === "a"
45
+ return (
46
+ <Comp
47
+ data-slot="paper-sheet"
48
+ data-plane={plane || undefined}
49
+ data-dashed={(!plane && dashed) || undefined}
50
+ className={cn(
51
+ "rounded-dialog bg-card text-card-foreground",
52
+ plane ? PLANE : dashed ? "border border-dashed border-input" : "border border-border",
53
+ plane && interactive && PLANE_LIFT,
54
+ interactive &&
55
+ "cursor-pointer text-start outline-none focus-visible:outline-2 focus-visible:outline-offset-4 focus-visible:outline-ring",
56
+ className
57
+ )}
58
+ {...props}
59
+ />
60
+ )
61
+ }
62
+
63
+ /** The mono eyebrow above a brand headline: Geist Mono, uppercase, tracked +6%. Arabic has no mono cut or case, so in RTL it is plain Noto Sans. */
64
+ function PaperEyebrow({ className, ...props }: React.ComponentProps<"p">) {
65
+ return (
66
+ <p
67
+ data-slot="paper-eyebrow"
68
+ className={cn("font-mono text-xs font-medium tracking-[0.06em] text-primary uppercase rtl:font-sans rtl:tracking-normal", className)}
69
+ {...props}
70
+ />
71
+ )
72
+ }
73
+
74
+ /** A brand headline: Readex Pro 600, sentence case. Brand surfaces only, never product screens. */
75
+ function PaperHeadline({ className, ...props }: React.ComponentProps<"h2">) {
76
+ return (
77
+ <h2
78
+ data-slot="paper-headline"
79
+ className={cn("font-display text-2xl leading-tight font-semibold text-balance text-foreground sm:text-3xl", className)}
80
+ {...props}
81
+ />
82
+ )
83
+ }
84
+
85
+ export { PaperGround, PaperSheet, PaperEyebrow, PaperHeadline }
@@ -0,0 +1,152 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { cn } from "./utils"
6
+ import { Icon, type IconName } from "./icon"
7
+
8
+ /**
9
+ * The web app's tab bar on a phone (`PwNav`, PW.1–PW.3; M.2, CH.3).
10
+ *
11
+ * Under 640px the web app swaps its drawer for the phone app's five places:
12
+ * Home, Inbox, the centre Create button, Chat and More. Labels always show
13
+ * under the icons; counts sit on Inbox and Chat only, red, capped at 99+.
14
+ * While the on-screen keyboard is open the bar steps aside so the page's own
15
+ * button can ride on the keyboard (`useKeyboardOpen`).
16
+ *
17
+ * Chrome only: the composed wrapper decides the hrefs, labels and counts, and
18
+ * which tab is current. From 640px up the bar is not rendered at all (`sm:hidden`),
19
+ * so desktop layouts never reserve room for it.
20
+ */
21
+
22
+ export interface PhoneTab {
23
+ id: string
24
+ label: string
25
+ href: string
26
+ icon: IconName
27
+ /** Waiting count; shown only when above zero. */
28
+ count?: number
29
+ /** Accessible wording for the count ("3 waiting"). */
30
+ countLabel?: string
31
+ active?: boolean
32
+ }
33
+
34
+ export interface PhoneTabBarProps {
35
+ /**
36
+ * The two tabs before and the two after Create, in reading order. `null`
37
+ * is an empty slot, so Create stays centred when a place is missing.
38
+ */
39
+ start: (PhoneTab | null)[]
40
+ end: (PhoneTab | null)[]
41
+ createLabel: string
42
+ onCreate: () => void
43
+ /** Accessible name of the bar (`Main`). */
44
+ navLabel: string
45
+ /** Next's `Link`, or anything taking `href`. Defaults to `<a>`. */
46
+ linkComponent?: React.ElementType
47
+ className?: string
48
+ }
49
+
50
+ /** Height of the bar above the home indicator, for anything docked above it. */
51
+ export const PHONE_TAB_BAR_HEIGHT = "4rem"
52
+
53
+ /**
54
+ * True while an on-screen keyboard covers the bottom of the page.
55
+ *
56
+ * The visual viewport shrinks when a keyboard opens (with
57
+ * `interactive-widget=resizes-content`, WHIT-1006, the layout viewport does
58
+ * too), so the signal is a text field holding focus on a touch screen: that
59
+ * is the only time a phone shows its keyboard. A hardware keyboard on a
60
+ * laptop never hides the bar, because the bar only exists under 640px.
61
+ */
62
+ export function useKeyboardOpen(): boolean {
63
+ const [open, setOpen] = React.useState(false)
64
+ React.useEffect(() => {
65
+ if (typeof window === "undefined") return
66
+ const coarse = window.matchMedia?.("(pointer: coarse)")
67
+ const typing = (el: Element | null): boolean => {
68
+ if (!(el instanceof HTMLElement)) return false
69
+ if (el.isContentEditable) return true
70
+ if (el instanceof HTMLTextAreaElement) return true
71
+ if (!(el instanceof HTMLInputElement)) return false
72
+ return !["checkbox", "radio", "button", "submit", "reset", "range", "color", "file", "image", "hidden"].includes(el.type)
73
+ }
74
+ const update = () => setOpen(Boolean(coarse?.matches) && typing(document.activeElement))
75
+ // focusout fires before the next field takes focus; read on the next frame.
76
+ const later = () => requestAnimationFrame(update)
77
+ document.addEventListener("focusin", update)
78
+ document.addEventListener("focusout", later)
79
+ return () => {
80
+ document.removeEventListener("focusin", update)
81
+ document.removeEventListener("focusout", later)
82
+ }
83
+ }, [])
84
+ return open
85
+ }
86
+
87
+ export function PhoneTabBar({
88
+ start,
89
+ end,
90
+ createLabel,
91
+ onCreate,
92
+ navLabel,
93
+ linkComponent,
94
+ className,
95
+ }: PhoneTabBarProps) {
96
+ const LinkComponent = (linkComponent ?? "a") as React.ElementType
97
+ const keyboardOpen = useKeyboardOpen()
98
+
99
+ const tab = (item: PhoneTab | null, index: number) => {
100
+ if (item === null) return <span key={`empty-${index}`} aria-hidden="true" />
101
+ const count = item.count && item.count > 0 ? (item.count > 99 ? "99+" : String(item.count)) : null
102
+ return (
103
+ <LinkComponent
104
+ key={item.id}
105
+ href={item.href}
106
+ aria-current={item.active ? "page" : undefined}
107
+ data-testid={`phone-tab-${item.id}`}
108
+ className={cn(
109
+ "relative flex min-h-12 flex-col items-center justify-end gap-0.5 rounded-lg pb-1.5 text-xs text-muted-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring",
110
+ item.active && "font-semibold text-primary"
111
+ )}
112
+ >
113
+ <Icon name={item.icon} size={24} />
114
+ <span className="max-w-full truncate px-0.5">{item.label}</span>
115
+ {count && (
116
+ <b
117
+ className="absolute top-0 start-[calc(50%+6px)] grid h-5 min-w-5 place-items-center rounded-full bg-destructive px-1.5 text-xs leading-none font-semibold text-destructive-foreground"
118
+ aria-label={item.countLabel}
119
+ >
120
+ <span aria-hidden={item.countLabel ? true : undefined}>{count}</span>
121
+ </b>
122
+ )}
123
+ </LinkComponent>
124
+ )
125
+ }
126
+
127
+ return (
128
+ <nav
129
+ aria-label={navLabel}
130
+ data-slot="phone-tab-bar"
131
+ hidden={keyboardOpen || undefined}
132
+ className={cn(
133
+ "fixed inset-x-0 bottom-0 z-40 border-t border-border bg-card pb-[env(safe-area-inset-bottom)] ps-[env(safe-area-inset-left)] pe-[env(safe-area-inset-right)] sm:hidden print:hidden",
134
+ className
135
+ )}
136
+ >
137
+ <div className="grid h-16 grid-cols-5 items-end px-2 pt-1.5">
138
+ {start.map(tab)}
139
+ <button
140
+ type="button"
141
+ onClick={onCreate}
142
+ aria-label={createLabel}
143
+ data-testid="phone-tab-create"
144
+ className="mb-2 grid size-14 place-items-center justify-self-center rounded-2xl bg-primary text-primary-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2"
145
+ >
146
+ <Icon name="plus" size={28} />
147
+ </button>
148
+ {end.map(tab)}
149
+ </div>
150
+ </nav>
151
+ )
152
+ }