@besaitech/ng-design-system 0.0.66 → 0.0.68

package/README.md

@@ -180,6 +180,7 @@ Import names are the `Sl…` classes; the markup selectors are `sds-…`.
 | `SdsSelect` | `<sds-select>` | CVA single-select dropdown |
 | `SdsMultiSelect` | `<sds-multi-select>` | CVA multi-select with chips; `(opened)` / `(closed)` (emits the selection) |
 | `SdsDatePicker` / `SdsCalendar` | `<sds-date-picker>` / `<sds-calendar>` | CVA date field + popover calendar (`date-utils` helpers) |
+| `SdsDateRangePicker` / `SdsRangeCalendar` | `<sds-date-range-picker>` / `<sds-range-calendar>` | Range field: presets column + two-month range calendar, pending until Apply; `[(value)]` is an `SdsDateRange \| null` (`{ start, end }`, end inclusive); `(presetSelect)` emits the preset id; helpers `sdsLastDays(n)`, `sdsLastMonths(n)`, `formatDateRange()` |
 | `SdsPhoneInput` | `<sds-phone-input>` | CVA phone field with country selector (`phone-countries`) |
 | `SdsIcon` | `<sds-icon>` | Inline-SVG icon; `name`, `size`, `strokeWidth`, `filled` |
 | `SdsAvatar` | `<sds-avatar>` | Image, initials or `fallbackIcon` + status dot; `shape` (circle·rounded·square), `decorative`; broken image falls back |
@@ -204,13 +205,26 @@ Import names are the `Sl…` classes; the markup selectors are `sds-…`.
 | `SdsSidebar` + `SdsNavGroup` + `SdsNavItem` | `<sds-sidebar>` … | Collapsible nav rail; collapse state via root-provided `SidebarStore`; items render `routerLink` or `<button>` |
 
 **Charts** (D3 does the maths, Angular renders the SVG, so they are OnPush, SSR-safe and themed by tokens)
+— a **secondary entry point**, `@besaitech/ng-design-system/charts`:
+
+```ts
+import { SdsLineChart, SdsKpi, SdsChartSeries } from '@besaitech/ng-design-system/charts'; // components + chart data types
+import { provideSdsCharts, SdsChartLabels } from '@besaitech/ng-design-system';            // config + strings (root)
+```
+
+The root entry is ONE module: whatever an app uses from it anywhere — even on a lazy route — lands in
+the app's initial chunk. Keeping the charts (and d3) in their own entry lets the bundler leave them in
+the lazy chunk of the page that draws them. The configuration (`provideSdsCharts`, `SDS_CHART_CONFIG`,
+`SdsChartConfig`, `SdsChartLabels`, `SDS_CHART_LABELS_EN` and the label text types) stays in the root —
+it is tiny and d3-free — so `app.config` can provide it eagerly without pulling the charts in. Since
+0.0.68 the root no longer re-exports the chart components or chart types.
 
 | Component | Selector | Notes |
 | --- | --- | --- |
 | `SdsLineChart` | `<sds-line-chart>` | Time / numeric / category x; multi-series, `area`, `stack` (stacked · percent), `curve`, log `yScale`, `annotations`, dashed forecast series, `endLabels`, crosshair tooltip |
 | `SdsBarChart` | `<sds-bar-chart>` | `orientation`, `stack`, negatives, `showValues`, `sort`, `barColor`, `highlight`, combo `type: 'line'` series |
 | `SdsScatterChart` | `<sds-scatter-chart>` | `x`/`y`, bubble `size`, `group`, `trendline`, log/time axes, nearest-point hover |
-| `SdsDonutChart` | `<sds-donut-chart>` | Donut · pie · `half`; tail folds into "Autres" past `maxSlices`; centre total / hovered slice |
+| `SdsDonutChart` | `<sds-donut-chart>` | Donut · pie · `half`; tail folds into "Other" past `maxSlices`; centre total / hovered slice (`centerLabel=""` hides the centre readout) |
 | `SdsHeatmap` | `<sds-heatmap>` | Two categorical dims × a measure; `scheme` sequential · diverging, `showValues` |
 | `SdsTreemap` | `<sds-treemap>` | Nested `{ name, value?, children? }`; branch colours, click-to-zoom breadcrumb |
 | `SdsSparkline` | `<sds-sparkline>` | Word-sized line · area · bar; `band`, `reference`, `showMinMax` |
@@ -223,9 +237,21 @@ keyboard-navigable tooltip, a data-table twin (`tableToggle`), `loading` / empty
 (override any slot in your preset). Set app-wide defaults once:
 
 ```ts
-providers: [provideSdsCharts({ locale: 'fr-FR' })] // or locale: () => translate.currentLang()
+providers: [provideSdsCharts({ locale: 'fr-FR', labels: CHART_LABELS_FR })]
+// or, switching live with the app language (both functions are read inside computed()s):
+providers: [provideSdsCharts({ locale: () => lang(), labels: () => chartLabelsFor(lang()) })]
 ```
 
+**Chart strings.** Every built-in string — empty state, table toggle and headers, tooltip rows, the
+spoken summaries, role descriptions, the KPI's change sentence — is an `SdsChartLabels` key with an
+English default (`SDS_CHART_LABELS_EN`). Translate them once through `provideSdsCharts({ labels })`
+(a `Partial<SdsChartLabels>`, merged over the English defaults); parameterised ones are functions
+(`sliceCount(n)`, `gridSize(rows, columns)`, `labelValue(label, value)`, `zoomedTo(path)`,
+`versus(y, x)`, `sparklineSummary({ label, first, last, min, max, count })`,
+`kpiChange({ direction, delta, period, good })`, …). Per-chart inputs (`emptyText`, `otherLabel`,
+`centerLabel`, `valueLabel`, `rootLabel`, `sizeLabel`) still win for one chart; left unset (`null`)
+they fall back to the configured labels.
+
 ```html
 <sds-line-chart
   heading="Admissions"