@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
@@ -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 }