@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
@@ -0,0 +1,252 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { Icon } from "./icon"
6
+ import { cn } from "./utils"
7
+
8
+ /**
9
+ * A country in the phone input's list (docs/design/components/PhoneInput):
10
+ * its calling code, the national lengths it accepts, which numbers are
11
+ * mobiles, and how a national number is grouped when read.
12
+ */
13
+ export interface PhoneCountry {
14
+ code: string
15
+ dial: string
16
+ name: string
17
+ ar: string
18
+ len: number[]
19
+ mobile: RegExp
20
+ group: number[] | ((digits: string) => number[])
21
+ sample: string
22
+ }
23
+
24
+ /** The region, the UK and the US (decision 2.x "Inputs": +962 default, regional list). */
25
+ export const phoneCountries: PhoneCountry[] = [
26
+ { code: "JO", dial: "962", name: "Jordan", ar: "الأردن", len: [8, 9], mobile: /^7[789]/, group: (d) => (/^7/.test(d) ? [2, 3, 4] : [1, 3, 4]), sample: "79 123 4567" },
27
+ { code: "SA", dial: "966", name: "Saudi Arabia", ar: "السعودية", len: [9], mobile: /^5/, group: [2, 3, 4], sample: "50 123 4567" },
28
+ { code: "AE", dial: "971", name: "United Arab Emirates", ar: "الإمارات", len: [9], mobile: /^5/, group: [2, 3, 4], sample: "50 123 4567" },
29
+ { code: "PS", dial: "970", name: "Palestine", ar: "فلسطين", len: [9], mobile: /^5/, group: [2, 3, 4], sample: "59 123 4567" },
30
+ { code: "IQ", dial: "964", name: "Iraq", ar: "العراق", len: [10], mobile: /^7/, group: [3, 3, 4], sample: "790 123 4567" },
31
+ { code: "EG", dial: "20", name: "Egypt", ar: "مصر", len: [10], mobile: /^1/, group: [3, 3, 4], sample: "100 123 4567" },
32
+ { code: "LB", dial: "961", name: "Lebanon", ar: "لبنان", len: [7, 8], mobile: /^(3|7|8)/, group: [2, 3, 3], sample: "71 123 456" },
33
+ { code: "KW", dial: "965", name: "Kuwait", ar: "الكويت", len: [8], mobile: /^[569]/, group: [4, 4], sample: "5012 3456" },
34
+ { code: "QA", dial: "974", name: "Qatar", ar: "قطر", len: [8], mobile: /^[3567]/, group: [4, 4], sample: "3312 3456" },
35
+ { code: "BH", dial: "973", name: "Bahrain", ar: "البحرين", len: [8], mobile: /^3/, group: [4, 4], sample: "3612 3456" },
36
+ { code: "OM", dial: "968", name: "Oman", ar: "عُمان", len: [8], mobile: /^9/, group: [4, 4], sample: "9212 3456" },
37
+ { code: "GB", dial: "44", name: "United Kingdom", ar: "المملكة المتحدة", len: [10], mobile: /^7/, group: [4, 3, 3], sample: "7400 123 456" },
38
+ { code: "US", dial: "1", name: "United States", ar: "الولايات المتحدة", len: [10], mobile: /^/, group: [3, 3, 4], sample: "201 555 0123" },
39
+ ]
40
+
41
+ /** Any other country: the person types the whole number with its code. */
42
+ const OTHER = "OTHER"
43
+
44
+ const ARABIC_INDIC = "٠١٢٣٤٥٦٧٨٩"
45
+ const EXTENDED_INDIC = "۰۱۲۳۴۵۶۷۸۹"
46
+
47
+ function westernDigits(raw: string): string {
48
+ return raw
49
+ .replace(/[٠-٩]/g, (d) => String(ARABIC_INDIC.indexOf(d)))
50
+ .replace(/[۰-۹]/g, (d) => String(EXTENDED_INDIC.indexOf(d)))
51
+ }
52
+
53
+ function groupDigits(digits: string, group: number[]): string {
54
+ const out: string[] = []
55
+ let i = 0
56
+ group.forEach((n, k) => {
57
+ if (i < digits.length) {
58
+ out.push(digits.substr(i, k === group.length - 1 ? 99 : n))
59
+ i += n
60
+ }
61
+ })
62
+ return out.join(" ")
63
+ }
64
+
65
+ /** The listed country and national digits of an E.164 number, or OTHER with all its digits. */
66
+ export function splitE164(value: string | null | undefined, fallback = "JO"): { country: string; digits: string } {
67
+ const raw = westernDigits(value ?? "").trim()
68
+ if (!raw.startsWith("+")) {
69
+ return { country: fallback, digits: raw.replace(/\D/g, "").replace(/^0+/, "") }
70
+ }
71
+ const all = raw.replace(/\D/g, "")
72
+ const match = [...phoneCountries]
73
+ .sort((a, b) => b.dial.length - a.dial.length)
74
+ .find((c) => all.startsWith(c.dial) && c.len.includes(all.length - c.dial.length))
75
+ return match ? { country: match.code, digits: all.slice(match.dial.length) } : { country: OTHER, digits: all }
76
+ }
77
+
78
+ export type PhoneInputLabels = Partial<Record<"country" | "other" | "otherSample" | "short" | "long" | "mobile" | "invalid", string>>
79
+
80
+ export interface PhoneInputProps {
81
+ label: React.ReactNode
82
+ /** ISO code of the country chosen first; Jordan by default. */
83
+ defaultCountry?: string
84
+ /** A number to start from: E.164, or a national number in `defaultCountry`. */
85
+ defaultValue?: string | null
86
+ /** Only mobiles (text messages and WhatsApp). */
87
+ mobileOnly?: boolean
88
+ /** Names the countries in Arabic. */
89
+ lang?: "en" | "ar"
90
+ labels?: PhoneInputLabels
91
+ helperText?: React.ReactNode
92
+ /** An error from the server; replaces the field's own. */
93
+ errorText?: React.ReactNode
94
+ disabled?: boolean
95
+ readOnly?: boolean
96
+ id?: string
97
+ className?: string
98
+ /**
99
+ * When the field is left, or the country changes: the number as E.164 (null
100
+ * when empty) and whether it is a whole number for its country.
101
+ */
102
+ onChange?: (e164: string | null, valid: boolean) => void
103
+ }
104
+
105
+ /**
106
+ * A phone number with its country code in the same control
107
+ * (docs/design/components/PhoneInput). Jordan (+962) first; the national
108
+ * number is grouped the way it is read, a leading 0 is dropped, Arabic-Indic
109
+ * digits are accepted. Left to right in both languages, like every number.
110
+ * Errors appear once the field is left, never while typing.
111
+ */
112
+ function PhoneInput({
113
+ label,
114
+ defaultCountry = "JO",
115
+ defaultValue,
116
+ mobileOnly = false,
117
+ lang = "en",
118
+ labels,
119
+ helperText,
120
+ errorText,
121
+ disabled,
122
+ readOnly,
123
+ id,
124
+ className,
125
+ onChange,
126
+ }: PhoneInputProps) {
127
+ const reactId = React.useId()
128
+ const baseId = id ?? reactId
129
+ const L = {
130
+ country: "Country code",
131
+ other: "Other country",
132
+ otherSample: "+33 6 12 34 56 78",
133
+ short: "This number is too short for {country}.",
134
+ long: "This number is too long for {country}.",
135
+ mobile: "Use a mobile number for text messages.",
136
+ invalid: "Enter the number with its country code, such as +33 6 12 34 56 78.",
137
+ ...labels,
138
+ }
139
+ const start = React.useMemo(() => splitE164(defaultValue, defaultCountry), [defaultValue, defaultCountry])
140
+ const [country, setCountry] = React.useState(start.country)
141
+ const [digits, setDigits] = React.useState(start.digits)
142
+ const [touched, setTouched] = React.useState(false)
143
+
144
+ const listed = phoneCountries.find((c) => c.code === country) ?? null
145
+ const name = listed ? (lang === "ar" ? listed.ar : listed.name) : L.other
146
+
147
+ const problem = (code: string, d: string): string | null => {
148
+ if (d === "") return null
149
+ const c = phoneCountries.find((x) => x.code === code)
150
+ const cname = c ? (lang === "ar" ? c.ar : c.name) : ""
151
+ if (!c) return d.length < 7 || d.length > 15 || d.startsWith("0") ? L.invalid : null
152
+ if (d.length < Math.min(...c.len)) return L.short.replace("{country}", cname)
153
+ if (d.length > Math.max(...c.len)) return L.long.replace("{country}", cname)
154
+ if (mobileOnly && !c.mobile.test(d)) return L.mobile
155
+ return null
156
+ }
157
+ const e164 = (code: string, d: string): string | null => {
158
+ if (d === "") return null
159
+ const c = phoneCountries.find((x) => x.code === code)
160
+ return "+" + (c ? c.dial : "") + d
161
+ }
162
+ const emit = (code: string, d: string) => onChange?.(e164(code, d), problem(code, d) === null)
163
+
164
+ const ownError = touched ? problem(country, digits) : null
165
+ const error = errorText ?? ownError
166
+ const describedBy = error ? `${baseId}-error` : helperText ? `${baseId}-help` : undefined
167
+
168
+ const read = (raw: string): string => {
169
+ let d = westernDigits(raw).replace(/\D/g, "")
170
+ if (listed && d.startsWith(listed.dial) && d.length > Math.max(...listed.len)) d = d.slice(listed.dial.length)
171
+ return listed ? d.replace(/^0+/, "") : d
172
+ }
173
+ const shown = listed ? groupDigits(digits, typeof listed.group === "function" ? listed.group(digits) : listed.group) : digits ? "+" + digits : ""
174
+
175
+ return (
176
+ <div className={cn("space-y-1.5", className)}>
177
+ <label htmlFor={baseId} className="block text-sm font-medium text-foreground">
178
+ {label}
179
+ </label>
180
+ <div
181
+ dir="ltr"
182
+ data-slot="phone-input"
183
+ className={cn(
184
+ "flex h-10 overflow-hidden rounded-control border bg-card focus-within:ring-2 focus-within:ring-ring",
185
+ error ? "border-destructive" : "border-input",
186
+ disabled && "opacity-50"
187
+ )}
188
+ >
189
+ <label className="relative inline-flex shrink-0 items-center gap-1 border-e border-input bg-muted pe-2 ps-2.5 font-mono text-sm text-foreground">
190
+ <span className="sr-only">{L.country}</span>
191
+ <select
192
+ className="absolute inset-0 cursor-pointer opacity-0"
193
+ value={country}
194
+ disabled={disabled || readOnly}
195
+ data-testid={`${baseId}-country`}
196
+ onChange={(event) => {
197
+ const next = event.target.value
198
+ const from = listed
199
+ // Keep what was typed: moving to Other carries the code along, and back strips it.
200
+ let d = digits
201
+ if (next === OTHER && from && d !== "") d = from.dial + d
202
+ const to = phoneCountries.find((x) => x.code === next)
203
+ if (from === null && to && d.startsWith(to.dial)) d = d.slice(to.dial.length)
204
+ setCountry(next)
205
+ setDigits(d)
206
+ emit(next, d)
207
+ }}
208
+ >
209
+ {phoneCountries.map((c) => (
210
+ <option key={c.code} value={c.code}>
211
+ {(lang === "ar" ? c.ar : c.name) + " +" + c.dial}
212
+ </option>
213
+ ))}
214
+ <option value={OTHER}>{L.other}</option>
215
+ </select>
216
+ <span aria-hidden="true">{listed ? "+" + listed.dial : "+"}</span>
217
+ <Icon name="chevron-down" size={14} className="text-muted-foreground" />
218
+ </label>
219
+ <input
220
+ id={baseId}
221
+ type="tel"
222
+ inputMode="tel"
223
+ autoComplete={listed ? "tel-national" : "tel"}
224
+ placeholder={listed ? listed.sample : L.otherSample}
225
+ className="min-w-0 flex-1 bg-transparent px-2.5 text-sm tabular-nums text-foreground outline-none"
226
+ value={shown}
227
+ disabled={disabled}
228
+ readOnly={readOnly}
229
+ aria-invalid={error ? true : undefined}
230
+ aria-describedby={describedBy}
231
+ title={name}
232
+ onChange={(event) => setDigits(read(event.target.value))}
233
+ onBlur={() => {
234
+ setTouched(true)
235
+ emit(country, digits)
236
+ }}
237
+ />
238
+ </div>
239
+ {error ? (
240
+ <p id={`${baseId}-error`} role="alert" className="text-sm text-destructive">
241
+ {error}
242
+ </p>
243
+ ) : helperText ? (
244
+ <p id={`${baseId}-help`} className="text-sm text-muted-foreground">
245
+ {helperText}
246
+ </p>
247
+ ) : null}
248
+ </div>
249
+ )
250
+ }
251
+
252
+ export { PhoneInput }
@@ -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
+ }