@whity/ui 0.0.0-stage → 0.5.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 (169) hide show
  1. package/README.md +107 -3
  2. package/package.json +192 -6
  3. package/src/access-denied.stories.tsx +179 -0
  4. package/src/access-denied.tsx +305 -0
  5. package/src/action-proposal.tsx +302 -0
  6. package/src/actor-chip.tsx +71 -0
  7. package/src/agent-activity.tsx +163 -0
  8. package/src/agent-collaboration.stories.tsx +156 -0
  9. package/src/agent-run-status.tsx +196 -0
  10. package/src/alert-dialog.stories.tsx +45 -0
  11. package/src/alert-dialog.tsx +147 -0
  12. package/src/alert.stories.tsx +91 -0
  13. package/src/alert.tsx +89 -0
  14. package/src/app-sidebar.stories.tsx +195 -0
  15. package/src/app-sidebar.tsx +500 -0
  16. package/src/approval-queue.tsx +108 -0
  17. package/src/audience-group-picker.stories.tsx +198 -0
  18. package/src/audience-group-picker.tsx +362 -0
  19. package/src/audience-people-picker.stories.tsx +102 -0
  20. package/src/audience-people-picker.tsx +279 -0
  21. package/src/avatar.tsx +83 -0
  22. package/src/badge.stories.tsx +105 -0
  23. package/src/badge.tsx +68 -0
  24. package/src/beta-warning.stories.tsx +79 -0
  25. package/src/beta-warning.tsx +189 -0
  26. package/src/bilingual-input.stories.tsx +82 -0
  27. package/src/bilingual-input.tsx +183 -0
  28. package/src/breadcrumb.stories.tsx +51 -0
  29. package/src/breadcrumb.tsx +90 -0
  30. package/src/button.stories.tsx +87 -0
  31. package/src/button.tsx +118 -0
  32. package/src/card.stories.tsx +423 -0
  33. package/src/card.tsx +180 -0
  34. package/src/chart.stories.tsx +66 -0
  35. package/src/chart.tsx +228 -0
  36. package/src/checkbox.stories.tsx +62 -0
  37. package/src/checkbox.tsx +54 -0
  38. package/src/collapsible.stories.tsx +48 -0
  39. package/src/collapsible.tsx +34 -0
  40. package/src/color-card.stories.tsx +61 -0
  41. package/src/color-card.tsx +270 -0
  42. package/src/color-picker.stories.tsx +65 -0
  43. package/src/color-picker.tsx +425 -0
  44. package/src/command-palette.tsx +306 -0
  45. package/src/copy-block.stories.tsx +38 -0
  46. package/src/copy-block.tsx +85 -0
  47. package/src/data-table.stories.tsx +200 -0
  48. package/src/data-table.tsx +1106 -0
  49. package/src/date-picker.stories.tsx +61 -0
  50. package/src/date-picker.tsx +422 -0
  51. package/src/design-cards.stories.tsx +458 -0
  52. package/src/dialog.stories.tsx +48 -0
  53. package/src/dialog.tsx +166 -0
  54. package/src/documents/barcode-svg.stories.tsx +72 -0
  55. package/src/documents/barcode-svg.tsx +79 -0
  56. package/src/dropdown-menu.stories.tsx +77 -0
  57. package/src/dropdown-menu.tsx +271 -0
  58. package/src/editor/behaviour.ts +279 -0
  59. package/src/editor/block-ids.ts +44 -0
  60. package/src/editor/block-list.tsx +101 -0
  61. package/src/editor/block-toolbar.tsx +477 -0
  62. package/src/editor/bubble.tsx +93 -0
  63. package/src/editor/catalogue.ts +103 -0
  64. package/src/editor/collab-rail.tsx +746 -0
  65. package/src/editor/collab.stories.tsx +207 -0
  66. package/src/editor/collab.ts +87 -0
  67. package/src/editor/contract.ts +408 -0
  68. package/src/editor/convert.ts +362 -0
  69. package/src/editor/doc-editor.stories.tsx +98 -0
  70. package/src/editor/doc-editor.tsx +1287 -0
  71. package/src/editor/editor.css +536 -0
  72. package/src/editor/extensions.ts +86 -0
  73. package/src/editor/field-picker.tsx +107 -0
  74. package/src/editor/fields.ts +100 -0
  75. package/src/editor/gutter.tsx +367 -0
  76. package/src/editor/index.ts +22 -0
  77. package/src/editor/label-sheet.tsx +289 -0
  78. package/src/editor/labels.ts +310 -0
  79. package/src/editor/link-tools.tsx +141 -0
  80. package/src/editor/node-views.tsx +450 -0
  81. package/src/editor/page-view.tsx +353 -0
  82. package/src/editor/publish-check.tsx +182 -0
  83. package/src/editor/rich-blocks.stories.tsx +146 -0
  84. package/src/editor/sample.ts +40 -0
  85. package/src/editor/schema-rich.ts +150 -0
  86. package/src/editor/schema.ts +315 -0
  87. package/src/editor/services.tsx +127 -0
  88. package/src/editor/slash.ts +64 -0
  89. package/src/editor/suggesting.ts +372 -0
  90. package/src/editor/suggestions.ts +763 -0
  91. package/src/editor/table-keys.ts +66 -0
  92. package/src/editor/templates.stories.tsx +324 -0
  93. package/src/editor/toolbar.tsx +358 -0
  94. package/src/empty-state.stories.tsx +51 -0
  95. package/src/empty-state.tsx +100 -0
  96. package/src/empty-state.usage-notes.md +30 -0
  97. package/src/form.stories.tsx +112 -0
  98. package/src/form.tsx +176 -0
  99. package/src/globals.css +20 -0
  100. package/src/icon-button.tsx +85 -0
  101. package/src/icon-map.ts +244 -0
  102. package/src/icon.tsx +41 -0
  103. package/src/index.ts +67 -0
  104. package/src/input.stories.tsx +157 -0
  105. package/src/input.tsx +759 -0
  106. package/src/locked-screen.stories.tsx +29 -0
  107. package/src/locked-screen.tsx +61 -0
  108. package/src/mark.tsx +62 -0
  109. package/src/math-text.stories.tsx +33 -0
  110. package/src/math-text.tsx +43 -0
  111. package/src/menu-bar.stories.tsx +198 -0
  112. package/src/menu-bar.tsx +373 -0
  113. package/src/money/currency.ts +230 -0
  114. package/src/page-header.stories.tsx +95 -0
  115. package/src/page-header.tsx +122 -0
  116. package/src/page-shell.stories.tsx +42 -0
  117. package/src/page-shell.tsx +32 -0
  118. package/src/pagination.stories.tsx +45 -0
  119. package/src/pagination.tsx +98 -0
  120. package/src/plugin-card.stories.tsx +180 -0
  121. package/src/plugin-card.tsx +848 -0
  122. package/src/popover.stories.tsx +48 -0
  123. package/src/popover.tsx +55 -0
  124. package/src/radio-group.stories.tsx +26 -0
  125. package/src/radio-group.tsx +44 -0
  126. package/src/route-flow/editor.tsx +1014 -0
  127. package/src/route-flow/model.ts +716 -0
  128. package/src/scope-grant.tsx +139 -0
  129. package/src/screen-too-small.stories.tsx +61 -0
  130. package/src/screen-too-small.tsx +104 -0
  131. package/src/select.stories.tsx +44 -0
  132. package/src/select.tsx +197 -0
  133. package/src/separator.stories.tsx +34 -0
  134. package/src/separator.tsx +34 -0
  135. package/src/sheet.stories.tsx +49 -0
  136. package/src/sheet.tsx +168 -0
  137. package/src/skeleton.stories.tsx +28 -0
  138. package/src/skeleton.tsx +19 -0
  139. package/src/slider.stories.tsx +78 -0
  140. package/src/slider.tsx +300 -0
  141. package/src/spinner.stories.tsx +33 -0
  142. package/src/spinner.tsx +55 -0
  143. package/src/switch.stories.tsx +42 -0
  144. package/src/switch.tsx +41 -0
  145. package/src/switcher.stories.tsx +111 -0
  146. package/src/switcher.tsx +131 -0
  147. package/src/table.stories.tsx +48 -0
  148. package/src/table.tsx +121 -0
  149. package/src/tabs.stories.tsx +74 -0
  150. package/src/tabs.tsx +90 -0
  151. package/src/tag-input.stories.tsx +67 -0
  152. package/src/tag-input.tsx +117 -0
  153. package/src/tenant-logo.tsx +63 -0
  154. package/src/tenant-switcher.stories.tsx +38 -0
  155. package/src/tenant-switcher.tsx +164 -0
  156. package/src/textarea.stories.tsx +27 -0
  157. package/src/textarea.tsx +18 -0
  158. package/src/theme-mode.ts +52 -0
  159. package/src/time-picker.stories.tsx +62 -0
  160. package/src/time-picker.tsx +615 -0
  161. package/src/toggle-group.tsx +138 -0
  162. package/src/tooltip.stories.tsx +43 -0
  163. package/src/tooltip.tsx +73 -0
  164. package/src/top-nav.stories.tsx +58 -0
  165. package/src/top-nav.tsx +324 -0
  166. package/src/undo-bar.tsx +107 -0
  167. package/src/utils.ts +45 -0
  168. package/src/view-toggle.stories.tsx +84 -0
  169. package/src/view-toggle.tsx +110 -0
@@ -0,0 +1,189 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { IconFlask, IconX } from "@tabler/icons-react"
5
+
6
+ import { cn } from "./utils"
7
+ import { Badge } from "./badge"
8
+ import { Button } from "./button"
9
+
10
+ export interface BetaWarningActionConfig {
11
+ label: string
12
+ onClick?: () => void
13
+ href?: string
14
+ }
15
+
16
+ // `title` is the component's own rich heading (a ReactNode rendered inside the
17
+ // banner), not the DOM's `title` tooltip attribute — which only accepts a
18
+ // string. Omitting the DOM one keeps the two from colliding: it is consumed by
19
+ // destructuring below and never reaches the underlying <div> through `...props`.
20
+ export interface BetaWarningProps extends Omit<React.ComponentProps<"div">, "title"> {
21
+ /** Title or feature name (defaults to "Experimental Feature"). */
22
+ title?: React.ReactNode
23
+ /** Description message explaining the beta/experimental status. */
24
+ description?: React.ReactNode
25
+ /** Badge text label (defaults to "Beta"). */
26
+ badgeText?: string
27
+ /** Badge color scheme variant. Defaults to "amber". */
28
+ color?: "amber" | "blue" | "purple"
29
+ /** Display format: "card" (padded container), "banner" (full-width banner bar), or "inline" (compact strip). */
30
+ variant?: "card" | "banner" | "inline"
31
+ /** Optional feedback / action button configuration. */
32
+ action?: BetaWarningActionConfig | React.ReactNode
33
+ /** Allow closing / dismissing the warning. */
34
+ dismissible?: boolean
35
+ /** Accessible name for the dismiss button. Defaults to "Dismiss beta notice". */
36
+ dismissLabel?: string
37
+ /** Callback fired when dismissed. */
38
+ onDismiss?: () => void
39
+ }
40
+
41
+ /**
42
+ * Reusable Beta / Experimental Feature Warning banner & inline indicator.
43
+ * Displays prominent BETA badges, experimental disclaimer copy, feedback actions,
44
+ * and non-squashed icon layout for experimental features.
45
+ */
46
+ export function BetaWarning({
47
+ className,
48
+ title = "Experimental Feature",
49
+ description = "This feature is currently in Beta preview. Interfaces and behaviors may be refined based on feedback.",
50
+ badgeText = "Beta",
51
+ color = "amber",
52
+ variant = "card",
53
+ action,
54
+ dismissible = false,
55
+ dismissLabel = "Dismiss beta notice",
56
+ onDismiss,
57
+ ...props
58
+ }: BetaWarningProps) {
59
+ const [dismissed, setDismissed] = React.useState(false)
60
+
61
+ if (dismissed) return null
62
+
63
+ const handleDismiss = () => {
64
+ setDismissed(true)
65
+ onDismiss?.()
66
+ }
67
+
68
+ // Status tints only (decision 7.4): warning for amber, the selected tint for
69
+ // blue and purple, since blue is kept for action and the brand (2.5b).
70
+ const colorStyles = {
71
+ amber: {
72
+ card: "border-transparent bg-warning-tint text-foreground",
73
+ badge: "warning" as const,
74
+ icon: "text-warning-text",
75
+ },
76
+ blue: {
77
+ card: "border-transparent bg-primary-tint text-foreground",
78
+ badge: "secondary" as const,
79
+ icon: "text-primary-tint-foreground",
80
+ },
81
+ purple: {
82
+ card: "border-transparent bg-primary-tint text-foreground",
83
+ badge: "secondary" as const,
84
+ icon: "text-primary-tint-foreground",
85
+ },
86
+ }[color]
87
+
88
+ if (variant === "inline") {
89
+ return (
90
+ <div
91
+ data-slot="beta-warning"
92
+ data-variant="inline"
93
+ role="status"
94
+ className={cn(
95
+ "inline-flex items-center gap-2 rounded-lg border px-2.5 py-1 text-xs/relaxed font-medium transition-all",
96
+ colorStyles.card,
97
+ className
98
+ )}
99
+ {...props}
100
+ >
101
+ <Badge variant={colorStyles.badge} className="shrink-0">
102
+ {badgeText}
103
+ </Badge>
104
+ <span className="truncate">{title}</span>
105
+ {dismissible && (
106
+ <button
107
+ type="button"
108
+ onClick={handleDismiss}
109
+ aria-label={dismissLabel}
110
+ className="ms-auto flex items-center justify-center size-3.5 text-current opacity-70 hover:opacity-100 focus-visible:outline-none shrink-0"
111
+ >
112
+ <IconX className="size-3 shrink-0" />
113
+ </button>
114
+ )}
115
+ </div>
116
+ )
117
+ }
118
+
119
+ return (
120
+ <div
121
+ data-slot="beta-warning"
122
+ data-variant={variant}
123
+ role="status"
124
+ className={cn(
125
+ "group/beta relative flex w-full gap-3 transition-all",
126
+ variant === "banner"
127
+ ? "items-center justify-between border-b px-4 py-2.5 text-xs/relaxed"
128
+ : "flex-col rounded-xl border p-3.5 text-xs/relaxed sm:flex-row sm:items-center",
129
+ colorStyles.card,
130
+ className
131
+ )}
132
+ {...props}
133
+ >
134
+ <div className="flex items-start gap-3 min-w-0">
135
+ {/* Unsquashed Flask Icon Container */}
136
+ <div className={cn("mt-0.5 shrink-0 flex items-center justify-center size-5", colorStyles.icon)}>
137
+ <IconFlask className="size-5 shrink-0" aria-hidden="true" />
138
+ </div>
139
+ <div className="space-y-0.5 min-w-0 flex-1">
140
+ <div className="flex flex-wrap items-center gap-2">
141
+ <Badge variant={colorStyles.badge} className="shrink-0">
142
+ {badgeText}
143
+ </Badge>
144
+ <span className="font-semibold text-foreground text-xs">{title}</span>
145
+ </div>
146
+ {description && (
147
+ <p className="text-xs text-muted-foreground opacity-90 leading-normal">
148
+ {description}
149
+ </p>
150
+ )}
151
+ </div>
152
+ </div>
153
+
154
+ <div className="flex items-center gap-2 shrink-0 ms-auto">
155
+ {action && (
156
+ React.isValidElement(action) ? (
157
+ action
158
+ ) : (
159
+ <Button
160
+ size="xs"
161
+ variant="outline"
162
+ onClick={(action as BetaWarningActionConfig).onClick}
163
+ asChild={Boolean((action as BetaWarningActionConfig).href)}
164
+ >
165
+ {(action as BetaWarningActionConfig).href ? (
166
+ <a href={(action as BetaWarningActionConfig).href}>
167
+ {(action as BetaWarningActionConfig).label}
168
+ </a>
169
+ ) : (
170
+ (action as BetaWarningActionConfig).label
171
+ )}
172
+ </Button>
173
+ )
174
+ )}
175
+
176
+ {dismissible && (
177
+ <button
178
+ type="button"
179
+ onClick={handleDismiss}
180
+ aria-label={dismissLabel}
181
+ className="flex items-center justify-center size-5 rounded-md text-muted-foreground hover:text-foreground hover:bg-muted/30 focus-visible:outline-none transition-colors shrink-0"
182
+ >
183
+ <IconX className="size-3.5 shrink-0" />
184
+ </button>
185
+ )}
186
+ </div>
187
+ </div>
188
+ )
189
+ }
@@ -0,0 +1,82 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { fn } from "storybook/test"
3
+ import * as React from "react"
4
+
5
+ import { BilingualInput, type BilingualValue } from "./bilingual-input"
6
+
7
+ const meta = {
8
+ title: "Primitives/BilingualInput",
9
+ component: BilingualInput,
10
+ tags: ["autodocs"],
11
+ args: {
12
+ value: {},
13
+ onChange: fn(),
14
+ },
15
+ } satisfies Meta<typeof BilingualInput>
16
+
17
+ export default meta
18
+ type Story = StoryObj<typeof meta>
19
+
20
+ /**
21
+ * `BilingualInput` is fully controlled, so the interactive stories drive it
22
+ * through this wrapper: the `value` arg seeds local state and the `onChange`
23
+ * arg still fires — so the Actions panel logs edits — while the field stays
24
+ * editable in the canvas.
25
+ */
26
+ function ControlledBilingualInput({
27
+ value,
28
+ onChange,
29
+ ...props
30
+ }: React.ComponentProps<typeof BilingualInput>) {
31
+ const [current, setCurrent] = React.useState<BilingualValue>(value)
32
+
33
+ return (
34
+ <BilingualInput
35
+ {...props}
36
+ value={current}
37
+ onChange={(next) => {
38
+ setCurrent(next)
39
+ onChange(next)
40
+ }}
41
+ />
42
+ )
43
+ }
44
+
45
+ export const WithTitleAndBadges: Story = {
46
+ args: {
47
+ id: "sb-bilingual-title",
48
+ label: "Role Title",
49
+ description: "Provide the official role title in both primary languages.",
50
+ value: { ar: "مدير النظام", en: "System Administrator" },
51
+ required: true,
52
+ },
53
+ render: (args) => <ControlledBilingualInput {...args} />,
54
+ }
55
+
56
+ export const Empty: Story = {
57
+ args: {
58
+ id: "sb-bilingual-empty",
59
+ label: "Department Name",
60
+ },
61
+ render: (args) => <ControlledBilingualInput {...args} />,
62
+ }
63
+
64
+ export const CustomLanguagePair: Story = {
65
+ args: {
66
+ id: "sb-bilingual-custom-langs",
67
+ label: "Job Title (Europe)",
68
+ primaryLang: { code: "fr", label: "French", badge: "FR" },
69
+ secondaryLang: { code: "de", label: "German", badge: "DE" },
70
+ value: { fr: "Directeur Général", de: "Geschäftsführer" },
71
+ },
72
+ render: (args) => <ControlledBilingualInput {...args} />,
73
+ }
74
+
75
+ export const Disabled: Story = {
76
+ args: {
77
+ id: "sb-bilingual-disabled",
78
+ label: "Organization Name",
79
+ value: { ar: "معطل", en: "Disabled" },
80
+ disabled: true,
81
+ },
82
+ }
@@ -0,0 +1,183 @@
1
+ "use client"
2
+
3
+
4
+ import { cn } from "./utils"
5
+ import { Input } from "./input"
6
+ import { Badge } from "./badge"
7
+
8
+ /**
9
+ * The value shape every bilingual field speaks — a plain `{ar?, en?, [key: string]: string | undefined}` pair/map,
10
+ * matching the LocalizedText convention (WC-532) used by schema-driven CRUD
11
+ * screens and any plugin storing bilingual/multilingual content.
12
+ */
13
+ export interface BilingualValue {
14
+ ar?: string
15
+ en?: string
16
+ [key: string]: string | undefined
17
+ }
18
+
19
+ export interface LanguageConfig {
20
+ /** Language ISO code (e.g. "ar", "en", "fr", "de", "es") */
21
+ code: string
22
+ /** Human-readable language name (e.g. "Arabic", "English", "French") */
23
+ label: string
24
+ /** Text direction: "rtl" or "ltr" (defaults to "rtl" for ar/fa/ur/he, "ltr" otherwise) */
25
+ dir?: "rtl" | "ltr"
26
+ /** Short badge text (defaults to uppercase code e.g. "AR") */
27
+ badge?: string
28
+ }
29
+
30
+ export interface BilingualInputProps {
31
+ /** Overall field group title/label (e.g. "Job Title" or "Organization Name"). */
32
+ label?: string
33
+ /** Subtitle or description explaining the field. */
34
+ description?: string
35
+ /** Base id; the primary/secondary inputs get `${id}-${primaryLang.code}` / `${id}-${secondaryLang.code}`. */
36
+ id?: string
37
+ value: BilingualValue
38
+ onChange: (value: BilingualValue) => void
39
+ /** Configuration for primary language input (defaults to Arabic `AR`). */
40
+ primaryLang?: LanguageConfig
41
+ /** Configuration for secondary language input (defaults to English `EN`). */
42
+ secondaryLang?: LanguageConfig
43
+ /** Backward-compatibility prop for Arabic label text. */
44
+ arLabel?: string
45
+ /** Backward-compatibility prop for English label text. */
46
+ enLabel?: string
47
+ disabled?: boolean
48
+ required?: boolean
49
+ className?: string
50
+ }
51
+
52
+ /**
53
+ * The atom of every bilingual form (WC-532): two synced fields —
54
+ * configurable for any language pair (e.g. AR/EN, FR/DE, ES/EN) —
55
+ * with an overall field title, explicit language badges (`AR`, `EN`),
56
+ * presence indicators, and a single `{ar?, en?}` value in/out.
57
+ */
58
+ export function BilingualInput({
59
+ label,
60
+ description,
61
+ id,
62
+ value,
63
+ onChange,
64
+ primaryLang,
65
+ secondaryLang,
66
+ arLabel,
67
+ enLabel,
68
+ disabled = false,
69
+ required = false,
70
+ className,
71
+ }: BilingualInputProps) {
72
+ const pCode = primaryLang?.code ?? "ar"
73
+ const sCode = secondaryLang?.code ?? "en"
74
+
75
+ const pLang: LanguageConfig = {
76
+ code: pCode,
77
+ label: arLabel ?? primaryLang?.label ?? "Arabic",
78
+ dir: primaryLang?.dir ?? (pCode === "ar" || pCode === "fa" || pCode === "ur" || pCode === "he" ? "rtl" : "ltr"),
79
+ badge: primaryLang?.badge ?? pCode.toUpperCase(),
80
+ }
81
+
82
+ const sLang: LanguageConfig = {
83
+ code: sCode,
84
+ label: enLabel ?? secondaryLang?.label ?? "English",
85
+ dir: secondaryLang?.dir ?? (sCode === "ar" || sCode === "fa" || sCode === "ur" || sCode === "he" ? "rtl" : "ltr"),
86
+ badge: secondaryLang?.badge ?? sCode.toUpperCase(),
87
+ }
88
+
89
+ const arId = id ? (id.endsWith("-ar") ? id : `${id}-ar`) : undefined
90
+ const enId = id ? (id.endsWith("-en") ? id : `${id}-en`) : undefined
91
+
92
+ const pId = pCode === "ar" ? arId : id ? `${id}-${pCode}` : undefined
93
+ const sId = sCode === "en" ? enId : id ? `${id}-${sCode}` : undefined
94
+
95
+ const pVal = value[pLang.code] ?? (pLang.code === "ar" ? value.ar : undefined) ?? ""
96
+ const sVal = value[sLang.code] ?? (sLang.code === "en" ? value.en : undefined) ?? ""
97
+
98
+ return (
99
+ <div data-slot="bilingual-input" className={cn("space-y-2", className)}>
100
+ {/* Field Title & Description */}
101
+ {label && (
102
+ <div className="flex flex-col gap-0.5">
103
+ <label className="text-xs font-semibold text-foreground">
104
+ {label}
105
+ {required && <span className="ms-0.5 text-destructive">*</span>}
106
+ </label>
107
+ {description && <p className="text-[0.6875rem] text-muted-foreground">{description}</p>}
108
+ </div>
109
+ )}
110
+
111
+ {/* Grid of Language Inputs */}
112
+ <div className="grid gap-3 sm:grid-cols-2">
113
+ {/* Primary Language Input */}
114
+ <div className="space-y-1.5">
115
+ <div className="flex items-center justify-between gap-2">
116
+ <div className="flex items-center gap-1.5 min-w-0">
117
+ <Badge variant="outline" className="font-mono font-semibold text-[9px] uppercase px-1.5 py-0 bg-muted/60 text-foreground shrink-0">
118
+ {pLang.badge}
119
+ </Badge>
120
+ <label htmlFor={pId} className="text-xs font-medium text-muted-foreground truncate">
121
+ {pLang.label}
122
+ </label>
123
+ </div>
124
+ <PresenceIndicator present={Boolean(pVal.trim())} testId="bilingual-presence-ar" />
125
+ </div>
126
+ <Input
127
+ id={pId}
128
+ dir={pLang.dir}
129
+ lang={pLang.code}
130
+ disabled={disabled}
131
+ required={required}
132
+ value={pVal}
133
+ onChange={(event) => {
134
+ const nextVal = { ...value, [pLang.code]: event.target.value }
135
+ if (pLang.code === "ar") nextVal.ar = event.target.value
136
+ onChange(nextVal)
137
+ }}
138
+ />
139
+ </div>
140
+
141
+ {/* Secondary Language Input */}
142
+ <div className="space-y-1.5">
143
+ <div className="flex items-center justify-between gap-2">
144
+ <div className="flex items-center gap-1.5 min-w-0">
145
+ <Badge variant="outline" className="font-mono font-semibold text-[9px] uppercase px-1.5 py-0 bg-muted/60 text-foreground shrink-0">
146
+ {sLang.badge}
147
+ </Badge>
148
+ <label htmlFor={sId} className="text-xs font-medium text-muted-foreground truncate">
149
+ {sLang.label}
150
+ </label>
151
+ </div>
152
+ <PresenceIndicator present={Boolean(sVal.trim())} testId="bilingual-presence-en" />
153
+ </div>
154
+ <Input
155
+ id={sId}
156
+ dir={sLang.dir}
157
+ lang={sLang.code}
158
+ disabled={disabled}
159
+ required={required}
160
+ value={sVal}
161
+ onChange={(event) => {
162
+ const nextVal = { ...value, [sLang.code]: event.target.value }
163
+ if (sLang.code === "en") nextVal.en = event.target.value
164
+ onChange(nextVal)
165
+ }}
166
+ />
167
+ </div>
168
+ </div>
169
+ </div>
170
+ )
171
+ }
172
+
173
+ function PresenceIndicator({ present, testId }: { present: boolean; testId: string }) {
174
+ return (
175
+ <Badge
176
+ variant={present ? "secondary" : "outline"}
177
+ className="text-[9px] uppercase"
178
+ data-testid={testId}
179
+ >
180
+ {present ? "Set" : "Empty"}
181
+ </Badge>
182
+ )
183
+ }
@@ -0,0 +1,51 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+ import { IconBuilding, IconFolder, IconUsers } from "@tabler/icons-react"
3
+
4
+ import { Breadcrumb } from "./breadcrumb"
5
+
6
+ const meta = {
7
+ title: "Primitives/Breadcrumb",
8
+ component: Breadcrumb,
9
+ tags: ["autodocs"],
10
+ } satisfies Meta<typeof Breadcrumb>
11
+
12
+ export default meta
13
+ type Story = StoryObj<typeof meta>
14
+
15
+ export const Default: Story = {
16
+ args: {
17
+ items: [
18
+ { label: "Admin", href: "/admin" },
19
+ { label: "Users", href: "/admin/users" },
20
+ { label: "Jane Doe" },
21
+ ],
22
+ },
23
+ }
24
+
25
+ export const WithHomeIcon: Story = {
26
+ args: {
27
+ showHomeIcon: true,
28
+ items: [
29
+ { label: "Home", href: "/" },
30
+ { label: "Settings", href: "/settings" },
31
+ { label: "Team Members" },
32
+ ],
33
+ },
34
+ }
35
+
36
+ export const WithCustomIcons: Story = {
37
+ args: {
38
+ items: [
39
+ { label: "Organization", href: "#", icon: <IconBuilding /> },
40
+ { label: "Projects", href: "#", icon: <IconFolder /> },
41
+ { label: "Engineering Team", icon: <IconUsers /> },
42
+ ],
43
+ },
44
+ }
45
+
46
+ export const SingleLevel: Story = {
47
+ args: {
48
+ showHomeIcon: true,
49
+ items: [{ label: "Dashboard" }],
50
+ },
51
+ }
@@ -0,0 +1,90 @@
1
+ import * as React from "react"
2
+ import { IconChevronRight, IconHome } from "@tabler/icons-react"
3
+
4
+ import { cn } from "./utils"
5
+
6
+ /**
7
+ * PRESENTATIONAL breadcrumb — a plain, controlled list of items with rich visual feedback.
8
+ */
9
+ export interface BreadcrumbItem {
10
+ label: string
11
+ /** Omit (or omit on the LAST item) to render plain text instead of a link — the current page is never a link. */
12
+ href?: string
13
+ /** Optional icon displayed before the label (e.g. <IconHome /> for root). */
14
+ icon?: React.ReactNode
15
+ }
16
+
17
+ export interface BreadcrumbProps extends Omit<React.ComponentProps<"nav">, "children"> {
18
+ items: BreadcrumbItem[]
19
+ /** Custom link component (e.g. Next.js <Link>) — defaults to a plain <a>. */
20
+ linkComponent?: React.ElementType
21
+ /** Automatically render a Home icon on the first item. */
22
+ showHomeIcon?: boolean
23
+ /** Custom separator node between items. Defaults to a subtle chevron. */
24
+ separator?: React.ReactNode
25
+ /** Accessible name for the <nav>. Defaults to "Breadcrumb". */
26
+ navLabel?: string
27
+ }
28
+
29
+ function Breadcrumb({
30
+ className,
31
+ items,
32
+ linkComponent,
33
+ showHomeIcon = false,
34
+ separator,
35
+ navLabel = "Breadcrumb",
36
+ ...props
37
+ }: BreadcrumbProps) {
38
+ const Link = linkComponent ?? "a"
39
+
40
+ return (
41
+ <nav data-slot="breadcrumb" aria-label={navLabel} className={className} {...props}>
42
+ <ol className="flex flex-wrap items-center gap-1 text-xs/relaxed text-muted-foreground">
43
+ {items.map((item, index) => {
44
+ const isLast = index === items.length - 1
45
+ const isFirst = index === 0
46
+ const itemIcon = item.icon ?? (isFirst && showHomeIcon ? <IconHome /> : null)
47
+
48
+ return (
49
+ <li key={`${item.label}-${index}`} className="flex items-center gap-1">
50
+ {index > 0 && (
51
+ <span className="flex items-center justify-center px-0.5 text-muted-foreground/40">
52
+ {separator ?? (
53
+ <IconChevronRight
54
+ aria-hidden="true"
55
+ className="size-3 shrink-0 rtl:rotate-180"
56
+ />
57
+ )}
58
+ </span>
59
+ )}
60
+ {isLast || !item.href ? (
61
+ <span
62
+ aria-current={isLast ? "page" : undefined}
63
+ className={cn(
64
+ "inline-flex items-center gap-1.5 rounded-md px-1.5 py-0.5 text-xs transition-colors",
65
+ isLast
66
+ ? "font-semibold text-foreground bg-muted/40 border border-border/40 shadow-2xs"
67
+ : "font-medium text-muted-foreground"
68
+ )}
69
+ >
70
+ {itemIcon && <span className="shrink-0 [&_svg]:size-3.5">{itemIcon}</span>}
71
+ {item.label}
72
+ </span>
73
+ ) : (
74
+ <Link
75
+ href={item.href}
76
+ className="inline-flex items-center gap-1.5 rounded-md px-1.5 py-0.5 text-xs font-medium transition-all hover:bg-muted/70 hover:text-foreground active:scale-95"
77
+ >
78
+ {itemIcon && <span className="shrink-0 text-muted-foreground/80 [&_svg]:size-3.5">{itemIcon}</span>}
79
+ {item.label}
80
+ </Link>
81
+ )}
82
+ </li>
83
+ )
84
+ })}
85
+ </ol>
86
+ </nav>
87
+ )
88
+ }
89
+
90
+ export { Breadcrumb }
@@ -0,0 +1,87 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import { Button } from "./button"
4
+
5
+ const meta = {
6
+ title: "Primitives/Button",
7
+ component: Button,
8
+ tags: ["autodocs"],
9
+ argTypes: {
10
+ variant: {
11
+ control: "select",
12
+ options: ["default", "outline", "secondary", "ghost", "destructive", "link"],
13
+ },
14
+ size: {
15
+ control: "select",
16
+ options: ["default", "xs", "sm", "lg", "icon", "icon-xs", "icon-sm", "icon-lg"],
17
+ },
18
+ loading: { control: "boolean" },
19
+ active: { control: "boolean" },
20
+ disabled: { control: "boolean" },
21
+ },
22
+ args: { children: "Button", variant: "default", size: "default" },
23
+ } satisfies Meta<typeof Button>
24
+
25
+ export default meta
26
+ type Story = StoryObj<typeof meta>
27
+
28
+ export const Playground: Story = {}
29
+
30
+ const VARIANTS = ["default", "outline", "secondary", "ghost", "destructive", "link"] as const
31
+
32
+ const SIZES = ["xs", "sm", "default", "lg"] as const
33
+
34
+ export const AllVariants: Story = {
35
+ render: () => (
36
+ <div className="flex flex-wrap items-center gap-3">
37
+ {VARIANTS.map((variant) => (
38
+ <Button key={variant} variant={variant}>
39
+ {variant}
40
+ </Button>
41
+ ))}
42
+ </div>
43
+ ),
44
+ }
45
+
46
+ export const Sizes: Story = {
47
+ render: () => (
48
+ <div className="flex flex-wrap items-center gap-3">
49
+ {SIZES.map((size) => (
50
+ <Button key={size} size={size}>
51
+ {size}
52
+ </Button>
53
+ ))}
54
+ </div>
55
+ ),
56
+ }
57
+
58
+ export const IconSizes: Story = {
59
+ render: () => (
60
+ <div className="flex flex-wrap items-center gap-3">
61
+ <Button size="icon-xs" aria-label="Add" icon="plus" />
62
+ <Button size="icon-sm" aria-label="Add" icon="plus" />
63
+ <Button size="icon" aria-label="Add" icon="plus" />
64
+ <Button size="icon-lg" aria-label="Add" icon="plus" />
65
+ </div>
66
+ ),
67
+ }
68
+
69
+ export const WithIcons: Story = {
70
+ render: () => (
71
+ <div className="flex flex-wrap items-center gap-3">
72
+ <Button icon="plus">New invoice</Button>
73
+ <Button variant="outline" iconEnd="arrow-right">Continue</Button>
74
+ </div>
75
+ ),
76
+ }
77
+
78
+ export const States: Story = {
79
+ render: () => (
80
+ <div className="flex flex-wrap items-center gap-3">
81
+ <Button loading>Loading</Button>
82
+ <Button active>Active Toggle</Button>
83
+ <Button disabled>Disabled</Button>
84
+ <Button aria-invalid>Invalid</Button>
85
+ </div>
86
+ ),
87
+ }