@a.nemreen/dga-ui 0.3.13 → 0.3.15

package/CHANGELOG.md

@@ -0,0 +1,119 @@
+# Changelog
+
+What changed in the packages you install. The same notes are on the live docs: [nemreen.info/dga/docs/changelog](https://nemreen.info/dga/docs/changelog).
+
+Versions below are the ones published to npm. Work that is only in this repository is listed under **Unreleased** until the next version bump.
+
+## 2026-09-29
+
+`@a.nemreen/dga-ui` **0.3.15** · `@a.nemreen/dga-tokens` **0.3.8** · `@a.nemreen/dga-dynamic-form` **0.2.5**
+
+### Added
+
+- `@a.nemreen/dga-ui` — choice group, tree, tree select, IBAN, national ID, password strength, confirm dialog, file preview, print, offline, search bar, QR, barcode, map embed, stat strip, FAQ, event calendar, virtual list, bottom sheet, popover, rich text, signature pad, notification inbox, locale toggle, and theme toggle.
+- `@a.nemreen/dga-ui` — table data grid: pagination footer, column picker, row actions, debounced filters, typed sort, error and empty states, and auto, table, or cards on small screens.
+- `@a.nemreen/dga-ui` — icon overrides through `provideDgaIcons`, using Hugeicons instead of `@platformscode/icons`.
+- `@a.nemreen/dga-ui` — select and autocomplete can show a loading row, emit search for remote options, and offer a create row. Buttons can stretch with `fullWidth`. Menus have an icon appearance.
+
+### Changed
+
+- `@a.nemreen/dga-ui` — event calendar days follow the date picker: circular days, a ring for today, a solid fill for the selected day, and no glow. The number stays readable on hover.
+- `@a.nemreen/dga-tokens` — `host-compat.css` lists the new component selectors so a host reset does not flatten them.
+- `@a.nemreen/dga-dynamic-form` — the published package now includes `CHANGELOG.md`.
+- Demo — lighter first load with `NgOptimizedImage`, WebP heroes, and a tighter font-loading path. Docs changelog is paginated.
+
+### Fixed
+
+- `@a.nemreen/dga-ui` — image popup is moved to the document body so it is not painted under a sticky header or sidebar.
+
+## 2026-09-20
+
+`@a.nemreen/dga-ui` **0.3.14** · `@a.nemreen/dga-tokens` **0.3.7**
+
+### Added
+
+- `@a.nemreen/dga-tokens` — `DGA_FONT_STYLESHEETS` and `dgaEnsureFontStylesheet` so a font stylesheet can be injected when the user switches families.
+- `@a.nemreen/dga-tokens` **0.3.5** — National Day 96 brand pack.
+
+### Changed
+
+- `@a.nemreen/dga-ui` **0.3.14** — chart, chatbot, page transition, and Saudi cities moved to secondary entries (`@a.nemreen/dga-ui/chart`, `/chatbot`, `/page-transition`, `/saudi-cities`) so the main bundle stays smaller. Icons load on demand.
+- `@a.nemreen/dga-ui` **0.3.13** / tokens **0.3.6** — portal footers follow the active brand in light and dark. Toast outlet updated alongside the National Day 96 demo.
+
+## 2026-09-17
+
+`@a.nemreen/dga-ui` **0.3.12** · `@a.nemreen/dga-dynamic-form` **0.2.4**
+
+### Added
+
+- `@a.nemreen/dga-ui` — age range on page feedback.
+
+### Changed
+
+- `@a.nemreen/dga-dynamic-form` **0.2.4** — follows `DgaLocaleService` and updates labels when the locale changes.
+- `@a.nemreen/dga-dynamic-form` **0.2.3** / `@a.nemreen/dga-ui` **0.3.11** — field visibility can depend on the selected option. Select menu styling updated.
+
+## 2026-09-16
+
+`@a.nemreen/dga-ui` **0.3.10** · `@a.nemreen/dga-tokens` **0.3.4**
+
+### Added
+
+- `@a.nemreen/dga-ui` — weather on `dga-top-bar`.
+- `@a.nemreen/dga-ui` — shared floating-action dock for the chatbot and scroll-to-top.
+
+## 2026-09-14
+
+`@a.nemreen/dga-ui` **0.3.10** · `@a.nemreen/dga-tokens` **0.3.3**
+
+`0.3.8` and `0.3.9` were not published on their own. Those fixes shipped inside **0.3.10**.
+
+### Added
+
+- `@a.nemreen/dga-ui` **0.3.7** — footer link groups and accessibility links.
+
+### Fixed
+
+- `@a.nemreen/dga-ui` — top-bar stamp notices stack full width on small screens.
+- `@a.nemreen/dga-ui` — `NG0950` when `dga-tab` (and the content switcher) read `value` before it was bound.
+- `@a.nemreen/dga-tokens` **0.3.2** / `@a.nemreen/dga-ui` **0.3.6** — `host-compat.css` so a host reset (`*` or `a`) no longer flattens DGA components. Top-bar clock lifecycle cleaned up. Broader locale coverage.
+
+## 2026-09-03
+
+`@a.nemreen/dga-ui` **0.3.5** · `@a.nemreen/dga-dynamic-form` **0.2.0**
+
+### Added
+
+- `@a.nemreen/dga-ui` — phone input with more countries and locale-aware formatting.
+
+### Changed
+
+- Dynamic form labels and validators follow the active locale. Locale helpers expanded in tokens and UI.
+
+## 2026-09-01
+
+`@a.nemreen/dga-ui` **0.3.4** · `@a.nemreen/dga-dynamic-form` **0.1.8** · `@a.nemreen/dga-tokens` **0.3.1**
+
+### Added
+
+- `@a.nemreen/dga-dynamic-form` **0.1.8** — cross-field validators (password, Saudi phone, date range), staged uploads, and visibility fixes across the 18 field types.
+
+### Changed
+
+- `@a.nemreen/dga-ui` **0.3.4** — chart tooltips.
+
+## 2026-07-28
+
+`@a.nemreen/dga-ui` **0.3.1**
+
+### Fixed
+
+- Overlay stacking, and the drawer releasing body scroll when it closes.
+
+## 2026-07-25
+
+`@a.nemreen/dga-ui` **0.3.0** · `@a.nemreen/dga-tokens` **0.3.0**
+
+### Changed
+
+- Accessibility panel redesign, stacked toasts, and portal chrome polish.

package/README.md

@@ -14,17 +14,23 @@ Standalone Angular UI components for the DGA design system — forms, overlays,
 
 **Live demo:** [nemreen.info/dga](https://nemreen.info/dga/)
 
-> Version **0.2.x** until public API freeze.
+> Version **0.3.x** until public API freeze (1.0).
+
+## Changelog
+
+[CHANGELOG.md](https://github.com/nemreen/dga-angular/blob/main/CHANGELOG.md) ships with this package. The same notes, in Arabic and English, are at [nemreen.info/dga/docs/changelog](https://nemreen.info/dga/docs/changelog).
 
 ## Features
 
-- Standalone Angular 19 components (no NgModules)
+- Standalone Angular 19+ components (no NgModules)
 - RTL-first / Arabic-ready (logical CSS + locale-aware chrome)
-- Forms: input, select, checkbox, radio, switch, OTP, upload, date picker, …
-- Overlays: dialog, modal, drawer, toast, menu, tooltip
-- Shell: header, top bar, hero, footer, preloader
-- Feedback & a11y: alert, cookies, skip link (accessibility panel → `@a.nemreen/a11y`)
-- Layout: card, section, grid, clamp, expandable
+- Forms: input, select, autocomplete (async/creatable), checkbox, radio, switch, OTP, upload, date/time picker, signature pad, rich text, …
+- Overlays: dialog, modal, drawer, bottom sheet, popover, toast, menu, tooltip, command
+- Shell: header, top bar, hero, footer, preloader, theme toggle, locale toggle
+- Feedback & a11y: alert, cookies, skip link, notification inbox (accessibility panel → `@a.nemreen/a11y`)
+- Data: table (templates, filters, expand, bulk), virtual list, export, carousel, chart
+- Content: timeline, calendar events, FAQ, QR/barcode, metrics
+- Layout: card, section, grid, clamp, expandable, app shell
 
 ## Install
 
@@ -49,7 +55,7 @@ Sources live under `src/lib/<domain>/<component>/`. Place new work in the matchi
 | `shell/` | Page chrome (header, footer, hero, …) |
 | `content/` | Content presentation (list, quote, metric, …) |
 | `data/` | Tables, charts, export |
-| `domain/` | Locale/region data helpers (not UI) |
+| `domain/` | Locale/region data helpers (not UI). Saudi cities ship as `@a.nemreen/dga-ui/saudi-cities`. |
 | `utils/` | Internal helpers only (not exported) |
 
 Import from the public package surface — do not deep-import `src/lib/...` paths.
@@ -64,6 +70,10 @@ Heavier shell pieces ship as separate FESMs so the primary bundle stays lean:
 import { DgaHeader } from '@a.nemreen/dga-ui/header';
 import { DgaCookies } from '@a.nemreen/dga-ui/cookies';
 import { DgaDatePicker } from '@a.nemreen/dga-ui/date-picker';
+import { DgaChart } from '@a.nemreen/dga-ui/chart';
+import { DgaChatbot } from '@a.nemreen/dga-ui/chatbot';
+import { DgaPageTransition } from '@a.nemreen/dga-ui/page-transition';
+import { DGA_SAUDI_CITIES } from '@a.nemreen/dga-ui/saudi-cities';
 ```
 
 Accessibility tools live in a separate package — [`@a.nemreen/a11y`](https://www.npmjs.com/package/@a.nemreen/a11y) — mount with `Accessibility.mount()`.
@@ -103,6 +113,11 @@ import {
   DgaCard,
   DgaDivider,
   DgaIcon,
+  DgaTable,
+  DgaBottomSheet,
+  DgaPopover,
+  DgaThemeToggle,
+  DgaLocaleToggle,
 } from '@a.nemreen/dga-ui';
 ```
 
@@ -110,15 +125,16 @@ import {
 
 ### Icon
 
-Two layers:
+Two layers, both HugeIcons Stroke Rounded (DGA / Platforms Code family):
 
 1. **Chrome** — curated inline SVG via `name` (paints with the first frame; use in buttons, fields, menus).
-2. **Content** — HugeIcons Stroke Rounded font via `glyph` (opt into `@a.nemreen/dga-tokens/styles/icon-font.css`).
+2. **Content** — optional font via `glyph` (opt into `@a.nemreen/dga-tokens/styles/icon-font.css`).
 
 ```html
 <!-- Chrome (always available) -->
 <dga-icon name="search" size="sm" />
 <dga-icon name="arrowNext" size="sm" label="التالي" />
+<dga-icon name="riyal" size="md" />
 
 <!-- Content (requires icon-font.css) -->
 <dga-icon glyph="search-01" size="xl" />
@@ -129,7 +145,25 @@ Use `arrowNext` / `arrowPrev` for forward/back — they mirror under `dir="rtl"`
 
 Sizes (px): `2xs` 10 · `xs` 14 · `sm` 16 · `md` 18 · `lg` 20 · `xl` 24 · `2xl` 28 · `3xl` 32.
 
-Chrome icons are vendored in the library (no `@platformscode/icons` peer). For content glyphs, use the optional icon font from `@a.nemreen/dga-tokens`.
+`DgaIcon` inlines a small HugeIcons core map (close / menu / search / chevrons / check / user / …) and lazy-loads the curated catalog on the first non-core `name`. Apps can add icons without forking the library:
+
+```ts
+import { provideDgaIcons } from '@a.nemreen/dga-ui';
+
+bootstrapApplication(App, {
+  providers: [
+    provideDgaIcons({
+      myBrand: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">…</svg>`,
+    }),
+  ],
+});
+```
+
+```html
+<dga-icon name="myBrand" size="md" />
+```
+
+Source: `@hugeicons/core-free-icons` (same family as design.dga.gov.sa). Regenerate with `node scripts/generate-dga-icons.mjs`.
 
 ### Scroll to top