@tmllak-erp/ui 0.0.0-stage → 0.2.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 (295) hide show
  1. package/README.md +509 -3
  2. package/dist/account/account-menu/AccountMenu.d.ts +14 -0
  3. package/dist/account/account-menu/AccountMenu.js +10 -0
  4. package/dist/account/account-menu/AccountMenu.js.map +1 -0
  5. package/dist/account/account-menu/account-menu.css +15 -0
  6. package/dist/account/appearance/Appearance.d.ts +52 -0
  7. package/dist/account/appearance/Appearance.js +67 -0
  8. package/dist/account/appearance/Appearance.js.map +1 -0
  9. package/dist/account/appearance/appearance.css +89 -0
  10. package/dist/account/index.d.ts +4 -0
  11. package/dist/account/index.js +5 -0
  12. package/dist/account/index.js.map +1 -0
  13. package/dist/account/notifications/Notifications.d.ts +60 -0
  14. package/dist/account/notifications/Notifications.js +50 -0
  15. package/dist/account/notifications/Notifications.js.map +1 -0
  16. package/dist/account/notifications/notifications.css +148 -0
  17. package/dist/account/security/Security.d.ts +78 -0
  18. package/dist/account/security/Security.js +52 -0
  19. package/dist/account/security/Security.js.map +1 -0
  20. package/dist/account/security/security.css +116 -0
  21. package/dist/data/calendar/CalendarGrid.d.ts +60 -0
  22. package/dist/data/calendar/CalendarGrid.js +124 -0
  23. package/dist/data/calendar/CalendarGrid.js.map +1 -0
  24. package/dist/data/calendar/calendar-grid.css +168 -0
  25. package/dist/data/charts/BarChart.d.ts +17 -0
  26. package/dist/data/charts/BarChart.js +58 -0
  27. package/dist/data/charts/BarChart.js.map +1 -0
  28. package/dist/data/charts/DonutChart.d.ts +23 -0
  29. package/dist/data/charts/DonutChart.js +48 -0
  30. package/dist/data/charts/DonutChart.js.map +1 -0
  31. package/dist/data/charts/LineChart.d.ts +14 -0
  32. package/dist/data/charts/LineChart.js +45 -0
  33. package/dist/data/charts/LineChart.js.map +1 -0
  34. package/dist/data/charts/chart-utils.d.ts +68 -0
  35. package/dist/data/charts/chart-utils.js +85 -0
  36. package/dist/data/charts/chart-utils.js.map +1 -0
  37. package/dist/data/charts/charts.css +251 -0
  38. package/dist/data/conversation/Conversation.d.ts +52 -0
  39. package/dist/data/conversation/Conversation.js +64 -0
  40. package/dist/data/conversation/Conversation.js.map +1 -0
  41. package/dist/data/conversation/conversation.css +188 -0
  42. package/dist/data/hero-card/HeroCard.d.ts +21 -0
  43. package/dist/data/hero-card/HeroCard.js +9 -0
  44. package/dist/data/hero-card/HeroCard.js.map +1 -0
  45. package/dist/data/hero-card/hero-card.css +51 -0
  46. package/dist/data/index.d.ts +16 -0
  47. package/dist/data/index.js +17 -0
  48. package/dist/data/index.js.map +1 -0
  49. package/dist/data/kanban/KanbanBoard.d.ts +53 -0
  50. package/dist/data/kanban/KanbanBoard.js +169 -0
  51. package/dist/data/kanban/KanbanBoard.js.map +1 -0
  52. package/dist/data/kanban/kanban.css +160 -0
  53. package/dist/data/kpi/KpiCard.d.ts +35 -0
  54. package/dist/data/kpi/KpiCard.js +26 -0
  55. package/dist/data/kpi/KpiCard.js.map +1 -0
  56. package/dist/data/kpi/kpi-card.css +109 -0
  57. package/dist/data/lists/Lists.d.ts +79 -0
  58. package/dist/data/lists/Lists.js +50 -0
  59. package/dist/data/lists/Lists.js.map +1 -0
  60. package/dist/data/lists/lists.css +206 -0
  61. package/dist/data/pagination/Pagination.d.ts +21 -0
  62. package/dist/data/pagination/Pagination.js +34 -0
  63. package/dist/data/pagination/Pagination.js.map +1 -0
  64. package/dist/data/pagination/pagination.css +67 -0
  65. package/dist/data/record-card/RecordCard.d.ts +35 -0
  66. package/dist/data/record-card/RecordCard.js +18 -0
  67. package/dist/data/record-card/RecordCard.js.map +1 -0
  68. package/dist/data/record-card/record-card.css +111 -0
  69. package/dist/data/table/DataTable.d.ts +86 -0
  70. package/dist/data/table/DataTable.js +109 -0
  71. package/dist/data/table/DataTable.js.map +1 -0
  72. package/dist/data/table/data-table.css +194 -0
  73. package/dist/data/toolbar/DataToolbar.d.ts +34 -0
  74. package/dist/data/toolbar/DataToolbar.js +22 -0
  75. package/dist/data/toolbar/DataToolbar.js.map +1 -0
  76. package/dist/data/toolbar/data-toolbar.css +48 -0
  77. package/dist/feedback/FeedbackProvider.d.ts +44 -0
  78. package/dist/feedback/FeedbackProvider.js +106 -0
  79. package/dist/feedback/FeedbackProvider.js.map +1 -0
  80. package/dist/feedback/banner/Banner.d.ts +20 -0
  81. package/dist/feedback/banner/Banner.js +15 -0
  82. package/dist/feedback/banner/Banner.js.map +1 -0
  83. package/dist/feedback/banner/banner.css +60 -0
  84. package/dist/feedback/banner/nextPageBanner.d.ts +14 -0
  85. package/dist/feedback/banner/nextPageBanner.js +35 -0
  86. package/dist/feedback/banner/nextPageBanner.js.map +1 -0
  87. package/dist/feedback/index.d.ts +6 -0
  88. package/dist/feedback/index.js +6 -0
  89. package/dist/feedback/index.js.map +1 -0
  90. package/dist/feedback/moduleFeedback.d.ts +38 -0
  91. package/dist/feedback/moduleFeedback.js +27 -0
  92. package/dist/feedback/moduleFeedback.js.map +1 -0
  93. package/dist/feedback/toast/ToastItem.d.ts +8 -0
  94. package/dist/feedback/toast/ToastItem.js +53 -0
  95. package/dist/feedback/toast/ToastItem.js.map +1 -0
  96. package/dist/feedback/toast/ToastProvider.d.ts +17 -0
  97. package/dist/feedback/toast/ToastProvider.js +133 -0
  98. package/dist/feedback/toast/ToastProvider.js.map +1 -0
  99. package/dist/feedback/toast/toast.css +114 -0
  100. package/dist/feedback/toast/types.d.ts +42 -0
  101. package/dist/feedback/toast/types.js +2 -0
  102. package/dist/feedback/toast/types.js.map +1 -0
  103. package/dist/index.d.ts +9 -0
  104. package/dist/index.js +10 -0
  105. package/dist/index.js.map +1 -0
  106. package/dist/internal/Modal.d.ts +22 -0
  107. package/dist/internal/Modal.js +42 -0
  108. package/dist/internal/Modal.js.map +1 -0
  109. package/dist/internal/Portal.d.ts +5 -0
  110. package/dist/internal/Portal.js +8 -0
  111. package/dist/internal/Portal.js.map +1 -0
  112. package/dist/internal/calendar.d.ts +16 -0
  113. package/dist/internal/calendar.js +37 -0
  114. package/dist/internal/calendar.js.map +1 -0
  115. package/dist/internal/cx.d.ts +1 -0
  116. package/dist/internal/cx.js +4 -0
  117. package/dist/internal/cx.js.map +1 -0
  118. package/dist/internal/focus.d.ts +6 -0
  119. package/dist/internal/focus.js +57 -0
  120. package/dist/internal/focus.js.map +1 -0
  121. package/dist/internal/hooks.d.ts +17 -0
  122. package/dist/internal/hooks.js +79 -0
  123. package/dist/internal/hooks.js.map +1 -0
  124. package/dist/internal/icons.d.ts +36 -0
  125. package/dist/internal/icons.js +38 -0
  126. package/dist/internal/icons.js.map +1 -0
  127. package/dist/internal/react-compat.d.ts +7 -0
  128. package/dist/internal/react-compat.js +18 -0
  129. package/dist/internal/react-compat.js.map +1 -0
  130. package/dist/internal/styles/base.css +67 -0
  131. package/dist/internal/styles/modal.css +132 -0
  132. package/dist/locale/ErpProvider.d.ts +37 -0
  133. package/dist/locale/ErpProvider.js +114 -0
  134. package/dist/locale/ErpProvider.js.map +1 -0
  135. package/dist/navigation/app-shell/AppShell.d.ts +26 -0
  136. package/dist/navigation/app-shell/AppShell.js +38 -0
  137. package/dist/navigation/app-shell/AppShell.js.map +1 -0
  138. package/dist/navigation/app-shell/app-shell.css +87 -0
  139. package/dist/navigation/breadcrumb/Breadcrumb.d.ts +15 -0
  140. package/dist/navigation/breadcrumb/Breadcrumb.js +13 -0
  141. package/dist/navigation/breadcrumb/Breadcrumb.js.map +1 -0
  142. package/dist/navigation/breadcrumb/breadcrumb.css +37 -0
  143. package/dist/navigation/index.d.ts +8 -0
  144. package/dist/navigation/index.js +9 -0
  145. package/dist/navigation/index.js.map +1 -0
  146. package/dist/navigation/page-header/PageHeader.d.ts +15 -0
  147. package/dist/navigation/page-header/PageHeader.js +9 -0
  148. package/dist/navigation/page-header/PageHeader.js.map +1 -0
  149. package/dist/navigation/page-header/page-header.css +39 -0
  150. package/dist/navigation/portal/ApprovalRequests.d.ts +26 -0
  151. package/dist/navigation/portal/ApprovalRequests.js +22 -0
  152. package/dist/navigation/portal/ApprovalRequests.js.map +1 -0
  153. package/dist/navigation/portal/ModuleTile.d.ts +55 -0
  154. package/dist/navigation/portal/ModuleTile.js +33 -0
  155. package/dist/navigation/portal/ModuleTile.js.map +1 -0
  156. package/dist/navigation/portal/portal.css +196 -0
  157. package/dist/navigation/sidebar/Sidebar.d.ts +38 -0
  158. package/dist/navigation/sidebar/Sidebar.js +71 -0
  159. package/dist/navigation/sidebar/Sidebar.js.map +1 -0
  160. package/dist/navigation/sidebar/sidebar.css +164 -0
  161. package/dist/navigation/top-bar/TopBar.d.ts +30 -0
  162. package/dist/navigation/top-bar/TopBar.js +27 -0
  163. package/dist/navigation/top-bar/TopBar.js.map +1 -0
  164. package/dist/navigation/top-bar/top-bar.css +83 -0
  165. package/dist/navigation/types.d.ts +41 -0
  166. package/dist/navigation/types.js +38 -0
  167. package/dist/navigation/types.js.map +1 -0
  168. package/dist/overlays/confirm-dialog/ConfirmDialog.d.ts +40 -0
  169. package/dist/overlays/confirm-dialog/ConfirmDialog.js +67 -0
  170. package/dist/overlays/confirm-dialog/ConfirmDialog.js.map +1 -0
  171. package/dist/overlays/confirm-dialog/confirm-dialog.css +52 -0
  172. package/dist/overlays/date-picker/DatePicker.d.ts +28 -0
  173. package/dist/overlays/date-picker/DatePicker.js +106 -0
  174. package/dist/overlays/date-picker/DatePicker.js.map +1 -0
  175. package/dist/overlays/date-picker/date-picker.css +90 -0
  176. package/dist/overlays/dialog/Dialog.d.ts +53 -0
  177. package/dist/overlays/dialog/Dialog.js +48 -0
  178. package/dist/overlays/dialog/Dialog.js.map +1 -0
  179. package/dist/overlays/dialog/dialog.css +119 -0
  180. package/dist/overlays/drawer/Drawer.d.ts +21 -0
  181. package/dist/overlays/drawer/Drawer.js +17 -0
  182. package/dist/overlays/drawer/Drawer.js.map +1 -0
  183. package/dist/overlays/dropdown-menu/DropdownMenu.d.ts +44 -0
  184. package/dist/overlays/dropdown-menu/DropdownMenu.js +135 -0
  185. package/dist/overlays/dropdown-menu/DropdownMenu.js.map +1 -0
  186. package/dist/overlays/dropdown-menu/dropdown-menu.css +62 -0
  187. package/dist/overlays/export/Export.d.ts +33 -0
  188. package/dist/overlays/export/Export.js +33 -0
  189. package/dist/overlays/export/Export.js.map +1 -0
  190. package/dist/overlays/index.d.ts +16 -0
  191. package/dist/overlays/index.js +17 -0
  192. package/dist/overlays/index.js.map +1 -0
  193. package/dist/overlays/info-popover/InfoPopover.d.ts +20 -0
  194. package/dist/overlays/info-popover/InfoPopover.js +10 -0
  195. package/dist/overlays/info-popover/InfoPopover.js.map +1 -0
  196. package/dist/overlays/info-popover/info-popover.css +24 -0
  197. package/dist/overlays/person-picker/PersonPicker.d.ts +39 -0
  198. package/dist/overlays/person-picker/PersonPicker.js +109 -0
  199. package/dist/overlays/person-picker/PersonPicker.js.map +1 -0
  200. package/dist/overlays/person-picker/person-picker.css +37 -0
  201. package/dist/overlays/popover/Popover.d.ts +35 -0
  202. package/dist/overlays/popover/Popover.js +72 -0
  203. package/dist/overlays/popover/Popover.js.map +1 -0
  204. package/dist/overlays/popover/popover.css +48 -0
  205. package/dist/overlays/record-details/RecordDetails.d.ts +41 -0
  206. package/dist/overlays/record-details/RecordDetails.js +14 -0
  207. package/dist/overlays/record-details/RecordDetails.js.map +1 -0
  208. package/dist/overlays/result-dialog/CopyButton.d.ts +9 -0
  209. package/dist/overlays/result-dialog/CopyButton.js +47 -0
  210. package/dist/overlays/result-dialog/CopyButton.js.map +1 -0
  211. package/dist/overlays/result-dialog/ResultDialog.d.ts +39 -0
  212. package/dist/overlays/result-dialog/ResultDialog.js +32 -0
  213. package/dist/overlays/result-dialog/ResultDialog.js.map +1 -0
  214. package/dist/overlays/result-dialog/result-dialog.css +69 -0
  215. package/dist/overlays/stepper/StageProgress.d.ts +11 -0
  216. package/dist/overlays/stepper/StageProgress.js +13 -0
  217. package/dist/overlays/stepper/StageProgress.js.map +1 -0
  218. package/dist/overlays/stepper/Stepper.d.ts +16 -0
  219. package/dist/overlays/stepper/Stepper.js +15 -0
  220. package/dist/overlays/stepper/Stepper.js.map +1 -0
  221. package/dist/overlays/stepper/Wizard.d.ts +24 -0
  222. package/dist/overlays/stepper/Wizard.js +52 -0
  223. package/dist/overlays/stepper/Wizard.js.map +1 -0
  224. package/dist/overlays/stepper/stepper.css +135 -0
  225. package/dist/overlays/time-picker/TimePicker.d.ts +27 -0
  226. package/dist/overlays/time-picker/TimePicker.js +27 -0
  227. package/dist/overlays/time-picker/TimePicker.js.map +1 -0
  228. package/dist/primitives/avatar/Avatar.d.ts +27 -0
  229. package/dist/primitives/avatar/Avatar.js +29 -0
  230. package/dist/primitives/avatar/Avatar.js.map +1 -0
  231. package/dist/primitives/avatar/avatar.css +59 -0
  232. package/dist/primitives/badge/badges.css +160 -0
  233. package/dist/primitives/badge/badges.d.ts +47 -0
  234. package/dist/primitives/badge/badges.js +27 -0
  235. package/dist/primitives/badge/badges.js.map +1 -0
  236. package/dist/primitives/button/Button.d.ts +32 -0
  237. package/dist/primitives/button/Button.js +17 -0
  238. package/dist/primitives/button/Button.js.map +1 -0
  239. package/dist/primitives/button/button.css +149 -0
  240. package/dist/primitives/card/Card.d.ts +18 -0
  241. package/dist/primitives/card/Card.js +13 -0
  242. package/dist/primitives/card/Card.js.map +1 -0
  243. package/dist/primitives/card/card.css +70 -0
  244. package/dist/primitives/choice/Checkbox.d.ts +11 -0
  245. package/dist/primitives/choice/Checkbox.js +20 -0
  246. package/dist/primitives/choice/Checkbox.js.map +1 -0
  247. package/dist/primitives/choice/Switch.d.ts +16 -0
  248. package/dist/primitives/choice/Switch.js +14 -0
  249. package/dist/primitives/choice/Switch.js.map +1 -0
  250. package/dist/primitives/choice/choice.css +138 -0
  251. package/dist/primitives/empty-state/EmptyState.d.ts +14 -0
  252. package/dist/primitives/empty-state/EmptyState.js +10 -0
  253. package/dist/primitives/empty-state/EmptyState.js.map +1 -0
  254. package/dist/primitives/empty-state/empty-state.css +41 -0
  255. package/dist/primitives/field/Field.d.ts +26 -0
  256. package/dist/primitives/field/Field.js +18 -0
  257. package/dist/primitives/field/Field.js.map +1 -0
  258. package/dist/primitives/field/TextField.d.ts +29 -0
  259. package/dist/primitives/field/TextField.js +28 -0
  260. package/dist/primitives/field/TextField.js.map +1 -0
  261. package/dist/primitives/field/field.css +139 -0
  262. package/dist/primitives/filter-chips/FilterChips.d.ts +30 -0
  263. package/dist/primitives/filter-chips/FilterChips.js +38 -0
  264. package/dist/primitives/filter-chips/FilterChips.js.map +1 -0
  265. package/dist/primitives/filter-chips/filter-chips.css +60 -0
  266. package/dist/primitives/icon/Icon.d.ts +15 -0
  267. package/dist/primitives/icon/Icon.js +9 -0
  268. package/dist/primitives/icon/Icon.js.map +1 -0
  269. package/dist/primitives/index.d.ts +17 -0
  270. package/dist/primitives/index.js +18 -0
  271. package/dist/primitives/index.js.map +1 -0
  272. package/dist/primitives/progress/ProgressBar.d.ts +19 -0
  273. package/dist/primitives/progress/ProgressBar.js +18 -0
  274. package/dist/primitives/progress/ProgressBar.js.map +1 -0
  275. package/dist/primitives/progress/Spinner.d.ts +8 -0
  276. package/dist/primitives/progress/Spinner.js +10 -0
  277. package/dist/primitives/progress/Spinner.js.map +1 -0
  278. package/dist/primitives/progress/progress.css +85 -0
  279. package/dist/primitives/segmented/SegmentedControl.d.ts +28 -0
  280. package/dist/primitives/segmented/SegmentedControl.js +34 -0
  281. package/dist/primitives/segmented/SegmentedControl.js.map +1 -0
  282. package/dist/primitives/segmented/segmented.css +67 -0
  283. package/dist/primitives/select/Select.d.ts +35 -0
  284. package/dist/primitives/select/Select.js +153 -0
  285. package/dist/primitives/select/Select.js.map +1 -0
  286. package/dist/primitives/select/select.css +100 -0
  287. package/dist/primitives/tabs/Tabs.d.ts +23 -0
  288. package/dist/primitives/tabs/Tabs.js +43 -0
  289. package/dist/primitives/tabs/Tabs.js.map +1 -0
  290. package/dist/primitives/tabs/tabs.css +59 -0
  291. package/dist/primitives/tooltip/Tooltip.d.ts +27 -0
  292. package/dist/primitives/tooltip/Tooltip.js +66 -0
  293. package/dist/primitives/tooltip/Tooltip.js.map +1 -0
  294. package/dist/primitives/tooltip/tooltip.css +24 -0
  295. package/package.json +38 -6
package/README.md CHANGED
@@ -1,3 +1,509 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
1
+ # @tmllak-erp/ui
2
+
3
+ React components of the ERP design system: buttons, form fields, dialogs, tables, navigation, charts, notifications, and the application frame. They are bilingual (Arabic and English) and direction-aware (RTL and LTR). Light and dark themes, five brand colors, three densities, and three font sizes are switched through [`@tmllak-erp/tokens`](../tokens/README.md).
4
+
5
+ - [Requirements](#requirements)
6
+ - [Install](#install)
7
+ - [Set up an application](#set-up-an-application)
8
+ - [Language and direction](#language-and-direction)
9
+ - [Themes](#themes)
10
+ - [Components](#components)
11
+ - [Feedback: toasts and dialogs](#feedback-toasts-and-dialogs)
12
+ - [Next.js (App Router)](#nextjs-app-router)
13
+ - [Testing your application](#testing-your-application)
14
+ - [Server rendering](#server-rendering)
15
+ - [Versions and upgrades](#versions-and-upgrades)
16
+
17
+ ## Requirements
18
+
19
+ | | Supported |
20
+ | --- | --- |
21
+ | React and React DOM | 18 or 19 (`^18.0.0 \|\| ^19.0.0`), installed by your application. The package never bundles its own React. |
22
+ | Module format | ESM only (`import`). There is no CommonJS build. |
23
+ | Bundler | One that handles CSS imported from `node_modules`: Vite, webpack, Next.js, Rspack, Parcel. Each component imports its own stylesheet. |
24
+ | TypeScript (optional) | 5.x with `moduleResolution` `bundler`, `node16`, or `nodenext`. |
25
+ | Node.js (build tools, SSR) | 20 or newer. |
26
+
27
+ ## Install
28
+
29
+ ```bash
30
+ npm install @tmllak-erp/ui @tmllak-erp/tokens react react-dom
31
+ ```
32
+
33
+ `@tmllak-erp/tokens` provides the stylesheets every application loads once. `@tmllak-erp/formatters` and `@tmllak-erp/messages` come with `@tmllak-erp/ui`. Install them explicitly only if you import them yourself.
34
+
35
+ ## Set up an application
36
+
37
+ Load the token styles and the font once, wrap the application in `ErpProvider`, and choose a theme:
38
+
39
+ ```tsx
40
+ import '@tmllak-erp/tokens/fonts.css';
41
+ import '@tmllak-erp/tokens/tokens.css';
42
+ import { applyTheme } from '@tmllak-erp/tokens';
43
+ import { Button, Card, ErpProvider, TextField } from '@tmllak-erp/ui';
44
+ import { useState } from 'react';
45
+ import { createRoot } from 'react-dom/client';
46
+
47
+ applyTheme({ theme: 'light', brand: 'navy' });
48
+
49
+ function App() {
50
+ const [name, setName] = useState('');
51
+ return (
52
+ <Card title="New employee" footer={<Button variant="primary">Save</Button>}>
53
+ <TextField label="Full name" value={name} onChange={(event) => setName(event.target.value)} required />
54
+ </Card>
55
+ );
56
+ }
57
+
58
+ createRoot(document.getElementById('root')!).render(
59
+ <ErpProvider defaultLocale="en">
60
+ <App />
61
+ </ErpProvider>,
62
+ );
63
+ ```
64
+
65
+ Component styles load automatically with each component you import. Only the styles of components you use end up in your bundle.
66
+
67
+ ## Language and direction
68
+
69
+ `ErpProvider` owns the interface language (`ar` or `en`) and the writing direction (`rtl` or `ltr`). It is Arabic and RTL unless you say otherwise. It also writes `lang`, `dir`, and `data-erp-locale` on `<html>`, so dialogs and menus rendered in portals follow the page. Use one provider per page and do not nest them.
70
+
71
+ | Prop | Purpose |
72
+ | --- | --- |
73
+ | `defaultLocale` | Starting language when the provider manages it (`'ar'` by default). |
74
+ | `locale`, `onLocaleChange` | Control the language yourself (from a route, a cookie, or user settings). |
75
+ | `direction`, `defaultDirection`, `onDirectionChange` | Override the direction. Without them the direction follows the language: Arabic is RTL, English is LTR. |
76
+ | `syncDocument` | Set to `false` if something else owns the `<html>` attributes. |
77
+
78
+ Components read the language from the provider, and switching it re-renders them immediately, without a reload:
79
+
80
+ ```tsx
81
+ import { Button, ErpProvider, LanguagePicker, useErp } from '@tmllak-erp/ui';
82
+
83
+ function LanguageSettings() {
84
+ const { locale, direction, setLocale, setDirection } = useErp();
85
+ return (
86
+ <>
87
+ <LanguagePicker value={locale} onChange={setLocale} />
88
+ <Button onClick={() => setDirection(direction === 'rtl' ? 'ltr' : 'rtl')}>Direction: {direction}</Button>
89
+ </>
90
+ );
91
+ }
92
+
93
+ export function App() {
94
+ return (
95
+ <ErpProvider defaultLocale="ar">
96
+ <LanguageSettings />
97
+ </ErpProvider>
98
+ );
99
+ }
100
+ ```
101
+
102
+ `setLocale('en')` switches the built-in wording to English and the direction to LTR. `setDirection` changes only the direction, for example English in RTL. Layouts use logical CSS properties, and directional icons mirror in RTL.
103
+
104
+ What is translated: the built-in wording of every component (labels such as “Loading…”, “Previous page”, “Close”, pagination, table, date picker, and so on), plus number and date formatting. Your own text (titles, labels, data) is yours to translate. `localize` from `@tmllak-erp/messages` helps.
105
+
106
+ Numbers always use Western digits (0–9) and dates the Gregorian calendar, in both languages.
107
+
108
+ ## Themes
109
+
110
+ Themes are attributes on `<html>`, independent of language. Set them with `applyTheme` from `@tmllak-erp/tokens`, or let users choose with the ready-made settings panel:
111
+
112
+ ```tsx
113
+ import { applyTheme, type ThemeSelection } from '@tmllak-erp/tokens';
114
+ import { AppearanceSettings, DarkModeToggle } from '@tmllak-erp/ui';
115
+ import { useState } from 'react';
116
+
117
+ export function Appearance() {
118
+ const [selection, setSelection] = useState<ThemeSelection>({ theme: 'light', brand: 'navy', density: 'normal', fontSize: 'default' });
119
+ return (
120
+ <>
121
+ <DarkModeToggle
122
+ dark={selection.theme === 'dark'}
123
+ onChange={(dark) => {
124
+ const next = { ...selection, theme: dark ? ('dark' as const) : ('light' as const) };
125
+ setSelection(next);
126
+ applyTheme(next);
127
+ }}
128
+ />
129
+ <AppearanceSettings value={selection} onChange={setSelection} />
130
+ </>
131
+ );
132
+ }
133
+ ```
134
+
135
+ | Option | Values |
136
+ | --- | --- |
137
+ | `theme` | `light`, `dark` |
138
+ | `brand` | `navy`, `blue`, `purple`, `burgundy`, `gold` |
139
+ | `density` | `comfortable`, `normal`, `compact` |
140
+ | `fontSize` | `small`, `default`, `large` |
141
+
142
+ `AppearanceSettings` applies the selection to the document as it changes (`applyToDocument`, default `true`). Store the selection yourself (local storage, user profile) and pass it back on the next visit.
143
+
144
+ ## Components
145
+
146
+ Everything is exported from `@tmllak-erp/ui`:
147
+
148
+ ```tsx
149
+ import { Button, DataTable, Dialog, Select } from '@tmllak-erp/ui';
150
+ ```
151
+
152
+ Every component accepts `className`. Props that hold visible text accept any `ReactNode` or `string`, as typed. The TypeScript declarations document every prop.
153
+
154
+ | Group | Components |
155
+ | --- | --- |
156
+ | Actions | `Button`, `IconButton`, `DropdownMenu`, `CopyButton` |
157
+ | Form fields | `TextField`, `Textarea`, `Select`, `Checkbox`, `Switch`, `SegmentedControl`, `FilterChips`, `DatePicker`, `TimePicker`, `PersonPicker`, `Field` |
158
+ | Display | `Card`, `HeroCard`, `KpiCard`, `RecordCard`, `StatusBadge`, `PriorityBadge`, `NewIndicator`, `PresenceIndicator`, `Avatar`, `AvatarGroup`, `Icon`, `Spinner`, `ProgressBar`, `EmptyState`, `Tooltip` |
159
+ | Data | `DataTable`, `CellPerson`, `CellStack`, `Pagination`, `DataToolbar`, `ActivityFeed`, `AgendaList`, `ProgressList`, `DateBadge`, `CalendarGrid`, `KanbanBoard`, `ConversationThread`, `MessageBubble` |
160
+ | Charts | `LineChart`, `BarChart`, `DonutChart`, `ChartLegend` |
161
+ | Overlays | `Dialog`, `FormDialog`, `FormGrid`, `FormGridFull`, `Drawer`, `ConfirmDialog`, `ResultDialog`, `Popover`, `InfoPopover`, `RecordDetails`, `ExportDialog`, `ExportMenu` |
162
+ | Steps | `Stepper`, `StageProgress`, `Wizard` |
163
+ | Navigation | `AppShell`, `TopBar`, `Sidebar`, `GlobalSearch`, `PageHeader`, `Breadcrumb`, `Tabs`, `ModuleTile`, `QuickActions` |
164
+ | Account | `AccountMenu`, `NotificationBell`, `NotificationsPanel`, `NotificationRow`, `AppearanceSettings`, `ThemePicker`, `DarkModeToggle`, `DensityPicker`, `FontSizePicker`, `LanguagePicker`, `ActivityLog`, `DoNotDisturb`, `NotificationChannels`, `NotificationDestination`, `RegisteredDevices`, `TwoFactorCard` |
165
+ | Providers | `ErpProvider`, `ToastProvider`, `FeedbackProvider` |
166
+ | Hooks and helpers | `useErp`, `useToast`, `useFeedback`, `useAppShell`, `useControllableState`, `useMediaQuery`, `filterNavByRoles`, `localizeNavigation`, `createModuleFeedback`, date helpers (`addDays`, `startOfMonth`, …) |
167
+
168
+ ### Buttons
169
+
170
+ ```tsx
171
+ import { Button, IconButton } from '@tmllak-erp/ui';
172
+ import { Download, Trash2 } from 'lucide-react';
173
+
174
+ export function Toolbar({ saving }: { saving: boolean }) {
175
+ return (
176
+ <>
177
+ <Button variant="primary" loading={saving}>
178
+ Save
179
+ </Button>
180
+ <Button variant="secondary" startIcon={Download}>
181
+ Export
182
+ </Button>
183
+ <IconButton icon={Trash2} label="Delete" variant="danger" tooltip />
184
+ </>
185
+ );
186
+ }
187
+ ```
188
+
189
+ | Component | Key props |
190
+ | --- | --- |
191
+ | `Button` | `variant` (`primary`, `secondary` (default), `ghost`, `danger`), `size` (`sm`, `md`, `lg`), `loading`, `loadingLabel`, `startIcon`, `endIcon`, `mirrorEndIcon`, `fullWidth`, and every `<button>` attribute including `ref`. |
192
+ | `IconButton` | `icon` and `label` (required, the accessible name), `variant` (default `ghost`), `size`, `tooltip`, `pressed`, `mirrorInRtl`. |
193
+
194
+ Icons are [Lucide](https://lucide.dev) components (`lucide-react`, installed with `@tmllak-erp/ui`).
195
+
196
+ ### Form fields
197
+
198
+ ```tsx
199
+ import { Checkbox, Select, Switch, TextField, Textarea } from '@tmllak-erp/ui';
200
+ import { useState } from 'react';
201
+
202
+ export function EmployeeForm() {
203
+ const [department, setDepartment] = useState<'hr' | 'it' | null>(null);
204
+ return (
205
+ <form>
206
+ <TextField label="Email" type="email" ltr hint="Work address" required />
207
+ <Select
208
+ label="Department"
209
+ value={department}
210
+ onChange={setDepartment}
211
+ options={[
212
+ { value: 'hr', label: 'Human resources' },
213
+ { value: 'it', label: 'Information technology' },
214
+ ]}
215
+ />
216
+ <Textarea label="Notes" maxLength={500} />
217
+ <Checkbox label="Send a welcome email" defaultChecked />
218
+ <Switch label="Active" defaultChecked />
219
+ </form>
220
+ );
221
+ }
222
+ ```
223
+
224
+ | Component | Key props |
225
+ | --- | --- |
226
+ | `TextField` | `label` (required), `hideLabel`, `hint`, `error`, `required`, `startIcon`, `endAdornment`, `clearable`, `onClear`, `size`, `ltr` (for email, IBAN, codes), plus every `<input>` attribute and `ref`. |
227
+ | `Textarea` | `label`, `hint`, `error`, `required`, `maxLength` (shows a counter), plus every `<textarea>` attribute and `ref`. |
228
+ | `Select` | `label`, `options` (`{ value, label, description?, disabled?, icon? }`), `value` / `defaultValue`, `onChange(value)`, `placeholder`, `hint`, `error`, `required`, `disabled`, `name`, `inlineLabel`. |
229
+ | `Checkbox` | `label`, `description`, `indeterminate`, `error`, plus every `<input>` attribute and `ref`. |
230
+ | `Switch` | `label`, `description`, `checked` / `defaultChecked`, `onCheckedChange(checked)`, `disabled`, `size`. |
231
+
232
+ ### Dialogs and overlays
233
+
234
+ ```tsx
235
+ import { Button, ConfirmDialog, Dialog } from '@tmllak-erp/ui';
236
+ import { useState } from 'react';
237
+
238
+ export function DeleteReport({ onDelete }: { onDelete: () => Promise<void> }) {
239
+ const [open, setOpen] = useState(false);
240
+ const [details, setDetails] = useState(false);
241
+ return (
242
+ <>
243
+ <Button onClick={() => setDetails(true)}>Details</Button>
244
+ <Button variant="danger" onClick={() => setOpen(true)}>
245
+ Delete
246
+ </Button>
247
+ <Dialog open={details} onClose={() => setDetails(false)} title="October report" footer={<Button onClick={() => setDetails(false)}>Close</Button>}>
248
+ Generated on 5 October 2026.
249
+ </Dialog>
250
+ <ConfirmDialog
251
+ open={open}
252
+ title="Delete the October report permanently?"
253
+ description="The report and its attachments will be removed."
254
+ confirmLabel="Delete"
255
+ onConfirm={onDelete}
256
+ onCancel={() => setOpen(false)}
257
+ />
258
+ </>
259
+ );
260
+ }
261
+ ```
262
+
263
+ | Component | Key props |
264
+ | --- | --- |
265
+ | `Dialog` | `open`, `onClose`, `title` (required); `description`, `footer`, `size` (`md`, `form`), `icon`, `tone`, `initialFocusRef`, `closeOnBackdrop`, `role`. Traps focus and restores it on close. |
266
+ | `ConfirmDialog` | `open`, `title`, `onConfirm` (may return a promise), `onCancel`; `intent` (`destructive` (default), `approval`), `description`, `notice`, `confirmLabel`, `cancelLabel`, `confirmationText` (the user must type it). |
267
+ | `Drawer` | `open`, `onClose`, `title`, `children`; `subtitle`, `media`, `meta`, `footer`. |
268
+ | `Popover` | `trigger` (one button element), `label`, `children`; `title`, `open` / `defaultOpen` / `onOpenChange`, `placement`, `width`. |
269
+ | `DropdownMenu` | `label`, `items` (`{ id, label, onSelect, icon?, disabled?, tone?, shortcut? }` or `{ type: 'separator', id }`); `trigger`, `triggerVariant`, `placement`. |
270
+ | `Tooltip` | `content`, `children` (one focusable element); `placement`, `kind` (`description`, `label`), `delay`, `disabled`. |
271
+
272
+ Overlays render in a portal on `document.body` and follow the page language and direction.
273
+
274
+ ### Tables
275
+
276
+ ```tsx
277
+ import { CellPerson, DataTable, Pagination, StatusBadge, type DataTableColumn } from '@tmllak-erp/ui';
278
+ import { useState } from 'react';
279
+
280
+ interface Employee {
281
+ id: string;
282
+ name: string;
283
+ title: string;
284
+ salary: number;
285
+ active: boolean;
286
+ }
287
+
288
+ const columns: DataTableColumn<Employee>[] = [
289
+ { id: 'name', header: 'Employee', isRowHeader: true, sortable: true, sortValue: (row) => row.name, cell: (row) => <CellPerson name={row.name} secondary={row.title} /> },
290
+ { id: 'salary', header: 'Salary', numeric: true, sortable: true, sortValue: (row) => row.salary, cell: (row) => row.salary.toLocaleString('en-US') },
291
+ { id: 'status', header: 'Status', cell: (row) => <StatusBadge tone={row.active ? 'success' : 'neutral'} label={row.active ? 'Active' : 'Inactive'} /> },
292
+ ];
293
+
294
+ export function Employees({ rows }: { rows: Employee[] }) {
295
+ const [page, setPage] = useState(1);
296
+ const pageSize = 10;
297
+ return (
298
+ <DataTable
299
+ caption="Employees"
300
+ columns={columns}
301
+ rows={rows.slice((page - 1) * pageSize, page * pageSize)}
302
+ getRowId={(row) => row.id}
303
+ getRowLabel={(row) => row.name}
304
+ selectable
305
+ rowActions={(row) => [{ id: 'open', label: `Open ${row.name}`, onSelect: () => undefined }]}
306
+ footer={<Pagination page={page} onPageChange={setPage} total={rows.length} pageSize={pageSize} />}
307
+ />
308
+ );
309
+ }
310
+ ```
311
+
312
+ `DataTable` key props: `caption`, `columns`, `rows`, `getRowId` (required); `getRowLabel`, `selectable` with `selected` / `defaultSelected` / `onSelectedChange`, `sort` / `defaultSort` / `onSortChange` / `manualSort`, `rowActions`, `onRowActivate`, `loading`, `empty`, `collapsedRows`, `stickyHeader`, `footer`. A column has `id`, `header`, `cell` and optionally `sortable`, `sortValue`, `numeric`, `align`, `isRowHeader`, `width`.
313
+
314
+ `StatusBadge` takes a `tone` (`success`, `warning`, `danger`, `active`, `review`, `upcoming`, `neutral`) and a visible `label`. Status is never shown by color alone.
315
+
316
+ ### Application frame
317
+
318
+ ```tsx
319
+ import { AppShell, PageHeader, Sidebar, TopBar, type NavSection } from '@tmllak-erp/ui';
320
+ import { LayoutDashboard, Users } from 'lucide-react';
321
+ import type { ReactNode } from 'react';
322
+
323
+ const sections: NavSection[] = [
324
+ {
325
+ id: 'main',
326
+ items: [
327
+ { id: 'dashboard', label: 'Dashboard', icon: LayoutDashboard, href: '/' },
328
+ { id: 'people', label: 'People', icon: Users, href: '/people', roles: ['admin'] },
329
+ ],
330
+ },
331
+ ];
332
+
333
+ export function Layout({ children }: { children: ReactNode }) {
334
+ return (
335
+ <AppShell
336
+ topBar={<TopBar title="Company portal" homeHref="/" />}
337
+ sidebar={<Sidebar module={{ name: 'People', icon: Users }} sections={sections} activeId="people" roles={['admin']} />}
338
+ >
339
+ <PageHeader title="People" />
340
+ {children}
341
+ </AppShell>
342
+ );
343
+ }
344
+ ```
345
+
346
+ `AppShell` places the top bar, the sidebar at the inline-start, and the page. Below the tablet breakpoint the sidebar becomes a drawer. `Sidebar` hides entries whose `roles` do not match the user's `roles`. Pass `renderLink` to render links with your router.
347
+
348
+ ## Feedback: toasts and dialogs
349
+
350
+ For one-off notifications, use `ToastProvider` and `useToast`:
351
+
352
+ ```tsx
353
+ import { Button, ToastProvider, useToast } from '@tmllak-erp/ui';
354
+
355
+ function SaveButton() {
356
+ const toast = useToast();
357
+ return (
358
+ <Button variant="primary" onClick={() => toast.show({ tone: 'success', title: 'Changes saved' })}>
359
+ Save
360
+ </Button>
361
+ );
362
+ }
363
+
364
+ export function App() {
365
+ return (
366
+ <ToastProvider>
367
+ <SaveButton />
368
+ </ToastProvider>
369
+ );
370
+ }
371
+ ```
372
+
373
+ `toast.show` accepts `tone`, `title`, `description`, `action` (`{ label, onClick }`), `undo` (`{ onUndo }`), `duration`, and `onDismiss`. It returns an id for `toast.dismiss(id)`.
374
+
375
+ For consistent wording across an application, describe messages once in a catalog (see [`@tmllak-erp/messages`](../messages/README.md)) and show them by key with `FeedbackProvider`. It includes a `ToastProvider` and picks the right component for each message:
376
+
377
+ ```tsx
378
+ import { commonMessages, createRegistry } from '@tmllak-erp/messages';
379
+ import { Button, FeedbackProvider, useFeedback } from '@tmllak-erp/ui';
380
+
381
+ const registry = createRegistry(commonMessages);
382
+
383
+ function SaveButton() {
384
+ const { notify } = useFeedback();
385
+ return <Button onClick={() => notify('common.saved', { subject: 'the changes' })}>Save</Button>;
386
+ }
387
+
388
+ export function App() {
389
+ return (
390
+ <FeedbackProvider registry={registry}>
391
+ <SaveButton />
392
+ </FeedbackProvider>
393
+ );
394
+ }
395
+ ```
396
+
397
+ `useFeedback()` also provides `confirm(key, params)` (resolves `true` when the user confirms), `showDialog`, and the `toast` API. The shipped catalogs are written in Arabic. English wording appears for entries that have a reviewed `en` field.
398
+
399
+ ## Next.js (App Router)
400
+
401
+ Every module that uses state, effects, context, refs, or event handlers starts with `'use client'`, and the directive is kept in the published files. You can import components straight into Server Components. Components whose props are plain data (text, numbers, elements) render there. Interactive ones run as Client Components automatically. Passing a function prop (`onClick`, `onChange`, `rowActions`) requires a Client Component of your own, as usual in Next.js. Helpers and constants exported from client modules (for example `pageSlots`, `initialsOf`, `timeOptions`, `niceTicks`, `IRREVERSIBLE_NOTICE`, and the hooks) can only be used in Client Components. Pure helpers such as `filterNavByRoles`, `localizeNavigation`, `toneClassName`, and the date helpers (`addDays`, `startOfMonth`, …) work on the server too.
402
+
403
+ Load the styles in the root layout, put the theme attributes in the server-rendered HTML, and mount the providers in a client file:
404
+
405
+ ```tsx
406
+ // file: app/providers.tsx
407
+ 'use client';
408
+
409
+ import { ErpProvider, ToastProvider } from '@tmllak-erp/ui';
410
+ import type { ReactNode } from 'react';
411
+
412
+ export function Providers({ locale, children }: { locale: 'ar' | 'en'; children: ReactNode }) {
413
+ return (
414
+ <ErpProvider locale={locale}>
415
+ <ToastProvider>{children}</ToastProvider>
416
+ </ErpProvider>
417
+ );
418
+ }
419
+ ```
420
+
421
+ ```tsx
422
+ // file: app/layout.tsx
423
+ import '@tmllak-erp/tokens/fonts.css';
424
+ import '@tmllak-erp/tokens/tokens.css';
425
+ import { themeAttributes } from '@tmllak-erp/tokens';
426
+ import type { ReactNode } from 'react';
427
+ import { Providers } from './providers';
428
+
429
+ export default function RootLayout({ children }: { children: ReactNode }) {
430
+ const locale = 'ar';
431
+ return (
432
+ <html lang={locale} dir={locale === 'ar' ? 'rtl' : 'ltr'} {...themeAttributes({ theme: 'light', brand: 'navy' })}>
433
+ <body>
434
+ <Providers locale={locale}>{children}</Providers>
435
+ </body>
436
+ </html>
437
+ );
438
+ }
439
+ ```
440
+
441
+ ```tsx
442
+ // file: app/page.tsx
443
+ import { Card, EmptyState, StatusBadge } from '@tmllak-erp/ui';
444
+ import { SaveButton } from './save-button';
445
+
446
+ export default function Page() {
447
+ return (
448
+ <Card title="Requests" actions={<SaveButton />}>
449
+ <StatusBadge tone="success" label="Approved" />
450
+ <EmptyState title="No pending requests" />
451
+ </Card>
452
+ );
453
+ }
454
+ ```
455
+
456
+ ```tsx
457
+ // file: app/save-button.tsx
458
+ 'use client';
459
+
460
+ import { Button, useToast } from '@tmllak-erp/ui';
461
+
462
+ export function SaveButton() {
463
+ const toast = useToast();
464
+ return (
465
+ <Button variant="primary" onClick={() => toast.show({ tone: 'success', title: 'Saved' })}>
466
+ Save
467
+ </Button>
468
+ );
469
+ }
470
+ ```
471
+
472
+ No `next.config` changes are needed: the packages are ESM with conditional exports, and Next.js handles their CSS imports. To switch language per user, read it on the server (cookie, route segment) and pass it to `Providers`, `lang`, and `dir`. Next.js 15 and later use React 19. Next.js 14 uses React 18. Both are within the supported range.
473
+
474
+ ## Testing your application
475
+
476
+ Components import their stylesheets, which Node cannot load. Let your test runner process the packages:
477
+
478
+ ```ts
479
+ // file: vitest.config.ts
480
+ import { defineConfig } from 'vitest/config';
481
+
482
+ export default defineConfig({
483
+ test: {
484
+ environment: 'jsdom',
485
+ server: { deps: { inline: [/@tmllak-erp\//] } },
486
+ },
487
+ });
488
+ ```
489
+
490
+ With Jest, map `\.css$` to a stub (`moduleNameMapper`) and transform `node_modules/@tmllak-erp` (`transformIgnorePatterns`), because the packages are ESM.
491
+
492
+ ## Server rendering
493
+
494
+ - Components render on the server without touching `window` or `document`. Browser-only work runs in effects.
495
+ - The interface language is kept per request on Node.js 20.16+ / 22.3+ and on edge runtimes with `AsyncLocalStorage`. Concurrent renders in different languages, including streaming renders that resume after `Suspense`, do not mix. Elsewhere one language per server process is assumed.
496
+ - When a renderer resumes a `Suspense` boundary outside the request's async context (Next.js streaming from the RSC payload), components read the language from the nearest `ErpProvider` instead. This needs React 19, which the Next.js App Router always uses. With React 18 and such a renderer, concurrent requests in different languages can still mix inside those boundaries.
497
+ - `applyTheme` does nothing without a `document`. Use `themeAttributes` in the server-rendered `<html>` instead.
498
+ - Outside a render (route handlers, server actions), pass `locale` explicitly to the formatters in `@tmllak-erp/formatters`.
499
+
500
+ ## Versions and upgrades
501
+
502
+ All `@tmllak-erp/*` packages are released together with one version number. Keep them on the same version:
503
+
504
+ ```bash
505
+ npm install @tmllak-erp/ui@latest @tmllak-erp/tokens@latest
506
+ npm ls @tmllak-erp/ui @tmllak-erp/tokens @tmllak-erp/messages @tmllak-erp/formatters
507
+ ```
508
+
509
+ Read the `CHANGELOG.md` of each package before upgrading. While the version is `0.x`, a minor release (`0.1` → `0.2`) can contain breaking changes. Patch releases do not. Pin a minor range (`~0.1.0`) if you want to upgrade on your own schedule.
@@ -0,0 +1,14 @@
1
+ import { type MenuEntry } from '../../overlays/dropdown-menu/DropdownMenu.js';
2
+ import './account-menu.css';
3
+ export interface AccountMenuProps {
4
+ user: {
5
+ name: string;
6
+ role?: string;
7
+ avatar?: string;
8
+ };
9
+ /** Profile, settings, appearance, sign out… */
10
+ items: readonly MenuEntry[];
11
+ className?: string;
12
+ }
13
+ /** Avatar button in the top bar that opens the account menu. */
14
+ export declare function AccountMenu({ user, items, className }: AccountMenuProps): import("react").JSX.Element;
@@ -0,0 +1,10 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { UI_COPY } from '@tmllak-erp/messages';
3
+ import { DropdownMenu } from '../../overlays/dropdown-menu/DropdownMenu.js';
4
+ import { Avatar } from '../../primitives/avatar/Avatar.js';
5
+ import './account-menu.css';
6
+ /** Avatar button in the top bar that opens the account menu. */
7
+ export function AccountMenu({ user, items, className }) {
8
+ return (_jsx(DropdownMenu, { label: `${UI_COPY.topBar.account}: ${user.name}`, placement: "bottom-end", className: className, items: items, trigger: _jsx("button", { type: "button", className: "erp-account-menu__trigger", "aria-label": `${UI_COPY.topBar.account}: ${user.name}`, children: _jsx(Avatar, { name: user.name, src: user.avatar, size: "sm", decorative: true }) }) }));
9
+ }
10
+ //# sourceMappingURL=AccountMenu.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AccountMenu.js","sourceRoot":"","sources":["../../../src/account/account-menu/AccountMenu.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAkB,MAAM,2CAA2C,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,oBAAoB,CAAC;AAS5B,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAoB;IACtE,OAAO,CACL,KAAC,YAAY,IACX,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,EAChD,SAAS,EAAC,YAAY,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,OAAO,EACL,iBAAQ,IAAI,EAAC,QAAQ,EAAC,SAAS,EAAC,2BAA2B,gBAAa,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,EAAE,YAC/G,KAAC,MAAM,IAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAC,IAAI,EAAC,UAAU,SAAG,GAC3D,GAEX,CACH,CAAC;AACJ,CAAC","sourcesContent":["import { UI_COPY } from '@tmllak-erp/messages';\r\nimport { DropdownMenu, type MenuEntry } from '../../overlays/dropdown-menu/DropdownMenu';\r\nimport { Avatar } from '../../primitives/avatar/Avatar';\r\nimport './account-menu.css';\r\n\r\nexport interface AccountMenuProps {\r\n user: { name: string; role?: string; avatar?: string };\r\n /** Profile, settings, appearance, sign out… */\r\n items: readonly MenuEntry[];\r\n className?: string;\r\n}\r\n\r\n/** Avatar button in the top bar that opens the account menu. */\r\nexport function AccountMenu({ user, items, className }: AccountMenuProps) {\r\n return (\r\n <DropdownMenu\r\n label={`${UI_COPY.topBar.account}: ${user.name}`}\r\n placement=\"bottom-end\"\r\n className={className}\r\n items={items}\r\n trigger={\r\n <button type=\"button\" className=\"erp-account-menu__trigger\" aria-label={`${UI_COPY.topBar.account}: ${user.name}`}>\r\n <Avatar name={user.name} src={user.avatar} size=\"sm\" decorative />\r\n </button>\r\n }\r\n />\r\n );\r\n}\r\n"]}
@@ -0,0 +1,15 @@
1
+ .erp-account-menu__trigger {
2
+ display: inline-flex;
3
+ padding: var(--erp-space-0-5);
4
+ border: 1px solid var(--erp-color-border-default);
5
+ border-radius: var(--erp-radius-full);
6
+ background: var(--erp-color-bg-surface);
7
+ cursor: pointer;
8
+ }
9
+ .erp-account-menu__trigger:hover {
10
+ background: var(--erp-color-bg-subtle);
11
+ }
12
+ .erp-account-menu__trigger:focus-visible {
13
+ outline: 2px solid var(--erp-color-focus-ring);
14
+ outline-offset: 2px;
15
+ }
@@ -0,0 +1,52 @@
1
+ import { type Brand, type Density, type FontSizePreference, type ThemeSelection } from '@tmllak-erp/tokens';
2
+ import './appearance.css';
3
+ export interface ThemePickerProps {
4
+ value: Brand;
5
+ onChange: (brand: Brand) => void;
6
+ label?: string;
7
+ className?: string;
8
+ }
9
+ /** The five approved primary themes (Figma «اختيار اللون الرئيسي»); each swatch previews its own brand. */
10
+ export declare function ThemePicker({ value, onChange, label, className }: ThemePickerProps): import("react").JSX.Element;
11
+ export interface DarkModeToggleProps {
12
+ dark: boolean;
13
+ onChange: (dark: boolean) => void;
14
+ label?: string;
15
+ className?: string;
16
+ }
17
+ /** Sun/moon switch in the top bar (Figma «زر الوضع الداكن»). */
18
+ export declare function DarkModeToggle({ dark, onChange, label, className }: DarkModeToggleProps): import("react").JSX.Element;
19
+ export type Language = 'ar' | 'en';
20
+ export interface LanguagePickerProps {
21
+ value: Language;
22
+ onChange: (language: Language) => void;
23
+ className?: string;
24
+ }
25
+ /** Interface language (Figma «اختيار اللغة»); the app switches `dir` and `lang` accordingly. */
26
+ export declare function LanguagePicker({ value, onChange, className }: LanguagePickerProps): import("react").JSX.Element;
27
+ export interface DensityPickerProps {
28
+ value: Density;
29
+ onChange: (density: Density) => void;
30
+ className?: string;
31
+ }
32
+ /** Global display density (comfortable / normal / compact). */
33
+ export declare function DensityPicker({ value, onChange, className }: DensityPickerProps): import("react").JSX.Element;
34
+ export interface FontSizePickerProps {
35
+ value: FontSizePreference;
36
+ onChange: (size: FontSizePreference) => void;
37
+ className?: string;
38
+ }
39
+ /** Global font size preference; scales every type token. */
40
+ export declare function FontSizePicker({ value, onChange, className }: FontSizePickerProps): import("react").JSX.Element;
41
+ export interface AppearanceSettingsProps {
42
+ value: ThemeSelection;
43
+ onChange: (selection: ThemeSelection) => void;
44
+ /** Apply the selection to `<html>` immediately (default true). */
45
+ applyToDocument?: boolean;
46
+ /** When both are set, the panel includes the interface language control. */
47
+ locale?: Language;
48
+ onLocaleChange?: (language: Language) => void;
49
+ className?: string;
50
+ }
51
+ /** Appearance section of account settings: theme, mode, density and font size. */
52
+ export declare function AppearanceSettings({ value, onChange, applyToDocument, locale, onLocaleChange, className }: AppearanceSettingsProps): import("react").JSX.Element;