@eagami/ui 2.2.0 → 2.4.0

package/README.md

@@ -42,10 +42,11 @@ See the [Setup](https://eagami.com/ui/setup) page for fonts and your first compo
 
 ## What's included
 
-- **Form controls**: Input, Textarea, Checkbox, Switch, Radio, Dropdown, Autocomplete, Date picker, Slider, Code input, Segmented, Avatar editor
-- **Overlays**: Dialog, Drawer, Tooltip, Menu, Toast
-- **Navigation**: Tabs, Breadcrumbs, Paginator, Accordion
-- **Display**: Card, Badge, Tag, Alert, Avatar, Skeleton, Spinner, Progress bar, Empty state, Divider, Eagami wordmark, Data table
+- **Actions**: Button, Command Palette
+- **Form controls**: Autocomplete, Avatar Editor, Checkbox, Code Input, Color Picker, Date Picker, Dropdown, File Uploader, Input, Multi-Select, Radio, Range Slider, Rating, Segmented, Slider, Switch, Textarea, Time Picker, Transfer List
+- **Overlays**: Dialog, Drawer, Menu, Popover, Toast, Tooltip
+- **Navigation**: Breadcrumbs, Paginator, Stepper, Tabs
+- **Display**: Accordion, Alert, Avatar, Badge, Card, Data Table, Divider, Eagami Wordmark, Empty State, Progress Bar, Skeleton, Spinner, Tag, Tree, Virtual List
 
 Full API and live demos at [eagami.com/ui/components](https://eagami.com/ui/components).
 
@@ -74,6 +75,23 @@ See [icons](https://eagami.com/ui/icons) for the full set, per-brand guideline l
 
 Every visual property is a CSS custom property on `:root`, so overriding any token retunes the whole library. See [design tokens](https://eagami.com/ui/design-tokens) for the full reference and theming examples.
 
+For the brand colour specifically, pass a single hex to `provideEagamiUi` and the library derives a full ten-shade scale (50 through 900) in [OKLCH](https://www.w3.org/TR/css-color-4/#ok-lab) space:
+
+```ts
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideEagamiUi({
+      palette: {
+        primary: { base: '#2563eb' },
+        secondary: { base: '#f97316' },
+      },
+    }),
+  ],
+});
+```
+
+Every brand-role pairing is checked against WCAG 2.1 AA at bootstrap; a contrast violation throws before the app loads. Pin specific shades with `overrides` or remap which derived shade backs each role with `roles`. See [design tokens](https://eagami.com/ui/design-tokens) for the full API.
+
 ## Internationalization
 
 Built-in strings ship in English, French (France), Greek, Polish, and Spanish (Spain), with runtime switching via `EagamiI18nService`. See [internationalization](https://eagami.com/ui/i18n) for setup and per-string overrides.