@ids-group-ltd/ids-design-system 0.13.4 → 0.14.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.
- package/CHANGELOG.md +258 -0
- package/components.md +24 -14
- package/docs/agent/INDEX.md +1 -1
- package/docs/agent/charts/column-series-component.md +1 -1
- package/docs/agent/charts/ds-chart.md +3 -1
- package/docs/agent/charts/ds-line-chart.md +1 -1
- package/docs/agent/charts/line-series-component.md +1 -1
- package/docs/agent/forms/ds-search.md +1 -1
- package/docs/agent/forms/ds-switch.md +4 -2
- package/docs/agent/forms/ds-textarea.md +1 -0
- package/docs/agent/navigation/ds-pagination.md +2 -2
- package/docs/agent/platform/ds-config.md +2 -1
- package/docs/agent/tables/ds-cell-template.md +1 -1
- package/docs/agent/tables/ds-table.md +4 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +26 -19
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +13 -3
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +27 -14
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +366 -81
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +4 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +8 -17
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +6 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +42 -6
- package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +17 -9
- package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +8 -17
- package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +27 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +4 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +23 -4
- package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +20 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -22
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +21 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +91 -10
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +2 -3
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.12.2.json +4 -1
- package/migrations/0.13.3.json +32 -10
- package/migrations/0.13.4.json +1630 -132
- package/migrations/0.14.0.json +591 -0
- package/migrations/0.5.0.json +10 -4
- package/migrations/0.7.0.json +5 -2
- package/migrations/0.9.0.json +5 -2
- package/migrations/README.md +7 -2
- package/package.json +1 -1
- package/styles/_chart-frame.scss +4 -4
- package/styles/_chart-motion.scss +17 -10
- package/styles/_overlay-motion.scss +14 -6
- package/styles/_skeleton-shimmer.scss +4 -1
- package/styles/_tokens.scss +1 -1
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +3 -5
- package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +3 -0
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +11 -3
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +125 -26
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +2 -0
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +3 -5
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +4 -1
- package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +4 -0
- package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +15 -10
- package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -4
- package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +7 -1
- package/types/ids-group-ltd-ids-design-system-components-search.d.ts +2 -0
- package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +1 -0
- package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +10 -1
- package/types/ids-group-ltd-ids-design-system-components-table.d.ts +35 -24
- package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +13 -0
- package/types/ids-group-ltd-ids-design-system-components.d.ts +46 -3
- package/types/ids-group-ltd-ids-design-system-core.d.ts +13 -4
- package/types/ids-group-ltd-ids-design-system.d.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,263 @@
|
|
|
1
1
|
## Unreleased
|
|
2
2
|
|
|
3
|
+
## 0.14.0 — 2026-09-24
|
|
4
|
+
|
|
5
|
+
### Breaking
|
|
6
|
+
|
|
7
|
+
- **`ds-chart` opens the tooltip its marks describe, and a mark no longer takes one.** A mark
|
|
8
|
+
reported its context and every consumer bound `dsChartTooltip` on the mark themselves; a plot
|
|
9
|
+
holding two marks could open two panels, and a plot whose consumer forgot the binding opened
|
|
10
|
+
none. Marks now offer the container a tooltip source the way they already report a domain, and
|
|
11
|
+
the container draws the single panel.
|
|
12
|
+
|
|
13
|
+
Drop `[dsChartTooltip]`, `[dsChartTooltipOrigin]`, `[dsChartTooltipPreferBelow]` and
|
|
14
|
+
`[dsChartTooltipTemplate]` from `g[dsColumnSeries]` and `g[dsLineSeries]`. What replaces them:
|
|
15
|
+
nothing for the ordinary case, `[tooltipTemplate]` on `<ds-chart>` for a custom panel body, and
|
|
16
|
+
`[tooltipExtraGap]` there for a chart that prints value labels in the gap the panel wants.
|
|
17
|
+
|
|
18
|
+
- **The chart tooltip pane is inert unless the reading is pinned.** The pane is drawn over the plot
|
|
19
|
+
it describes, so on a funnel or a tight category axis it covered the neighbouring marks and the
|
|
20
|
+
mark underneath never saw the pointer - the panel named a segment the reader had already left.
|
|
21
|
+
A pinned pane takes the pointer again, so its text can still be selected. A rule of yours on
|
|
22
|
+
`.cdk-overlay-pane.ds-chart-tooltip-pane` that assumed `pointer-events: auto` needs
|
|
23
|
+
`.is-pinned` added to it.
|
|
24
|
+
|
|
25
|
+
- **Subclassing one of these breaks on a name collision.** `ChartComponent`,
|
|
26
|
+
`ColumnSeriesComponent`, `LineSeriesComponent`, `ColumnChartComponent`, `ScatterChartComponent`,
|
|
27
|
+
`ChartDataTableComponent`, `BarChartComponent`, `FunnelChartComponent` and `PieChartComponent`
|
|
28
|
+
each gained members, most of them while the container took over the tooltip, and so did
|
|
29
|
+
`ChartTooltipDirective`, which is internal but reachable through
|
|
30
|
+
`@ids-group-ltd/ids-design-system/components/chart-tooltip`. Outside the charts,
|
|
31
|
+
`ModalCardComponent`, `PaginationComponent`, `SearchComponent`, `SwitchComponent`,
|
|
32
|
+
`TableComponent`, `TextareaComponent`, `LineChartComponent` and `CellTemplateDirective` gained
|
|
33
|
+
members too, and so did
|
|
34
|
+
every field control: each extends one of the internal base classes `DsControlValueAccessor` or
|
|
35
|
+
`DsBooleanControlValueAccessor`, which gained `blur`. Declaring a member of the same name in a
|
|
36
|
+
subclass is a compile error - TS4114, or TS2416 where the signature differs - so rename yours or
|
|
37
|
+
add `override`. Protected members went too: the roving-focus pair on the bar, pie and funnel
|
|
38
|
+
charts and the column series, the per-mark event handlers of the column and line series, and the
|
|
39
|
+
plot's pointer handlers. A method of yours named like one of those, declared without `override`,
|
|
40
|
+
still compiles and is never called again, so delete it. Subclassing a DS component is unsupported
|
|
41
|
+
either way.
|
|
42
|
+
|
|
43
|
+
- **`ChartScales` requires two tooltip methods.** `reportTooltip(id, source)` and
|
|
44
|
+
`releaseTooltip(id)` are required members now that the container draws the single tooltip panel.
|
|
45
|
+
`<ds-chart>` implements both; a container of your own that implements `ChartScales` by hand does
|
|
46
|
+
not compile until you add them. The type of `source` is not exported - a hand-written container
|
|
47
|
+
forwards what its marks report without naming it.
|
|
48
|
+
|
|
49
|
+
- **Five tokens take their property's name.** `--ds-input-label-fw` is
|
|
50
|
+
`--ds-input-label-font-weight`, `--ds-tag-fw` is `--ds-tag-font-weight`, `--ds-tag-lh` is
|
|
51
|
+
`--ds-tag-line-height`, and `--ds-slider-thumb-bw` is `--ds-slider-thumb-border-width`. The
|
|
52
|
+
theme-level `--slider-thumb-bw` in `styles/_tokens.scss` is `--slider-thumb-border-width`; the
|
|
53
|
+
slider's own token falls back to it, then to `--border-width-strong`. An unknown custom property is
|
|
54
|
+
not an error, so a declaration left on an old name is inert and the element draws at its fallback
|
|
55
|
+
with no warning.
|
|
56
|
+
|
|
57
|
+
- **`ds-pagination`'s `layout` input is `PaginationLayout | null` and defaults to `null`.** It was
|
|
58
|
+
`PaginationLayout` with a `'grouped'` default. Writing the attribute in a template is unchanged,
|
|
59
|
+
but code that reads `layout()` back through a `viewChild` now sees `null` on a pager that was never
|
|
60
|
+
given one, and a subclass overriding `layout` must widen its type to match. The effective value -
|
|
61
|
+
the input, then `DS_CONFIG.pagination.layout`, then `'grouped'` - is `layoutResolved()`, which is
|
|
62
|
+
new and public; `sizeResolved()` is public too.
|
|
63
|
+
|
|
64
|
+
### Added
|
|
65
|
+
|
|
66
|
+
- **`dsLineSeries` takes an `outline`, on by default.** The line and its markers sit on a band of
|
|
67
|
+
the surface colour, so they stay legible where they cross columns. Set `[outline]="false"` for a
|
|
68
|
+
line on an empty plot where the band only separates it from the gridlines. `ds-line-chart` takes
|
|
69
|
+
the same `outline` input and passes it to its series.
|
|
70
|
+
|
|
71
|
+
- **`dsColumnSeries` takes `seriesKey` and `highlighted`.** Naming a series in the legend fades the
|
|
72
|
+
others to `--ds-chart-dim-opacity`, which `ds-column-chart` now wires for you.
|
|
73
|
+
|
|
74
|
+
- **`ChartScales` carries an optional `measured` signal**, true once the plot has its real width.
|
|
75
|
+
A mark of your own can wait for it before building geometry the first measurement would replace.
|
|
76
|
+
A container of your own that implements `ChartScales` may leave it out, and a mark reads it as
|
|
77
|
+
always measured then.
|
|
78
|
+
|
|
79
|
+
- **`ds-bar` reads `--ds-bar-radius` on the track and the fill.** It defaults to
|
|
80
|
+
`var(--radius-pill)`, the shape both hard-coded before, so a bar can now be squared.
|
|
81
|
+
|
|
82
|
+
- **`ds-line-chart` sizes its loading and empty states from `--ds-line-chart-placeholder-height`.**
|
|
83
|
+
It sizes the loading skeleton and the empty and error box. Unset, the skeleton falls back to the
|
|
84
|
+
plot height and the message box to the view height, as before. Since 0.13.4
|
|
85
|
+
`--ds-line-chart-plot-height` also sizes the plot, so a value you set only to size the placeholder
|
|
86
|
+
states resizes every plot - move it to the new token.
|
|
87
|
+
|
|
88
|
+
- **`ds-pagination` takes `loading`.** A boolean attribute, default false: it sets
|
|
89
|
+
`aria-busy="true"` on the `<nav>`, replaces the "N of M" range label with an inline skeleton so a
|
|
90
|
+
stale total is never quoted, and disables Prev, Next, every page button and the rows-per-page
|
|
91
|
+
select. The current page button keeps its colour while disabled.
|
|
92
|
+
|
|
93
|
+
- **`DS_CONFIG` takes `pagination`.** `pagination?: { size?: DsSize; layout?: PaginationLayout }`
|
|
94
|
+
sets the default size and layout of every pager, `ds-table`'s footer included. A pager resolves
|
|
95
|
+
`size` from its input, then `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then
|
|
96
|
+
`'sm'`; `layout` from its input, then `DS_CONFIG.pagination.layout`, then `'grouped'`.
|
|
97
|
+
|
|
98
|
+
- **`ds-table` takes `paginationSize` and `paginationLayout`.** Both default to `null`
|
|
99
|
+
(`DsSize | null` and `PaginationLayout | null`) and are forwarded to the footer pager's `size` and
|
|
100
|
+
`layout`, resolved through the same chain as a standalone pager.
|
|
101
|
+
|
|
102
|
+
- **`dsCellTemplate` types its `let-row` from `[dsCellTemplateOf]`.** The directive is generic,
|
|
103
|
+
`CellTemplateDirective<T = unknown>`, and `[dsCellTemplateOf]="rows"` - typing only, never read at
|
|
104
|
+
runtime - types `let-row` as the row type under strict templates. The new exported type
|
|
105
|
+
`CellTemplateContext<T = unknown>` is `{ readonly $implicit: T; readonly row: T }`. The
|
|
106
|
+
`rowExpandTemplate` and `cellTemplateMap` contexts stay `unknown`.
|
|
107
|
+
|
|
108
|
+
- **Every field control and `ds-search` gain `blur(): void`.** The counterpart of `focus()`: it
|
|
109
|
+
drops focus from whichever descendant of the host holds it, leaving an open overlay panel alone.
|
|
110
|
+
|
|
111
|
+
- **`ds-textarea` exposes the native selection API.** `selectionStart` and `selectionEnd` (0 before
|
|
112
|
+
the view exists), `setSelectionRange(start, end, direction?: 'forward' | 'backward' | 'none')`,
|
|
113
|
+
which does not move focus, and `select()`, each forwarded to the native textarea. A value written
|
|
114
|
+
through `value` reaches the element a microtask later and drops the caret to the end, so after
|
|
115
|
+
`value.set(...)` set the range from a `setTimeout`, not synchronously.
|
|
116
|
+
|
|
117
|
+
- **`ds-switch` takes `controlled` and emits `checkedRequested`.** `controlled` is a boolean
|
|
118
|
+
attribute, default false; `checkedRequested` is a `boolean` output carrying the value the user
|
|
119
|
+
asked for. Under `controlled` a click or Space is cancelled on the native toggle,
|
|
120
|
+
`checkedRequested` emits `!checked()`, and the switch moves only when `[checked]` changes. Because
|
|
121
|
+
the toggle is cancelled, a two-way `checked`, an `ngModel` or a form control is not updated by the
|
|
122
|
+
gesture - the host commits the value through `[checked]`. Without `controlled` nothing changes.
|
|
123
|
+
|
|
124
|
+
- **`PaginationLayout` is exported from `@ids-group-ltd/ids-design-system/core`** as well as from
|
|
125
|
+
`@ids-group-ltd/ids-design-system/components/pagination` and the package root.
|
|
126
|
+
|
|
127
|
+
- **`ds-modal` and `ds-modal-card` read `--ds-modal-actions-stacked-direction`.** Default
|
|
128
|
+
`column`, which stacks the actions in DOM order with the confirming action at the bottom;
|
|
129
|
+
`column-reverse` puts it on top. It has no effect while the actions row fits on one line.
|
|
130
|
+
|
|
131
|
+
### Changed
|
|
132
|
+
|
|
133
|
+
- **Modal actions stack full-width when they outgrow the card.** When the `[actions]` row is wider
|
|
134
|
+
than the card, `.actions` gains `.stacked` and every projected action becomes full-width in a
|
|
135
|
+
column, in DOM order - cancel then confirm, matching Tab order. A row that fits stays a
|
|
136
|
+
right-aligned single line. The row used to overflow past the card's start edge and clip the first
|
|
137
|
+
button.
|
|
138
|
+
|
|
139
|
+
- **`ds-table`'s footer pager is disabled while the table shows skeleton rows.** Whenever the
|
|
140
|
+
table draws skeletons - `loading="skeleton"`, or `loading` on a table with no rows yet - the pager
|
|
141
|
+
gets `loading`, so its controls are disabled and `aria-busy` while the placeholder rows show. The
|
|
142
|
+
overlay mode leaves the pager alone.
|
|
143
|
+
|
|
144
|
+
- **`ds-scatter-chart` fades the other series while a legend entry is hovered**, to
|
|
145
|
+
`--ds-chart-dim-opacity`, as the other charts with a legend do.
|
|
146
|
+
|
|
147
|
+
- **Under a category cursor, a line chart's active marker grows for the whole category band**, not
|
|
148
|
+
only while the pointer is on the 4px dot, and the panel anchors above the tallest reading at the
|
|
149
|
+
category rather than whichever mark reported first.
|
|
150
|
+
|
|
151
|
+
- **The chart tooltip fades out when the pointer leaves the plot** instead of vanishing, and its
|
|
152
|
+
colour dot is larger, with a surface-coloured ring; a hatched dot's stripes run at 45deg.
|
|
153
|
+
|
|
154
|
+
- **A category panel names every series at the category.** `tooltip="axis"` was documented to do
|
|
155
|
+
this and listed only the series that opened it, because a mark could not see the others. Marks
|
|
156
|
+
now offer the container what they read at the cursor's category and the container merges them,
|
|
157
|
+
so a column and a line sharing a plot appear in one panel.
|
|
158
|
+
|
|
159
|
+
- **Legend hover fades the other series whether or not `dimOthers` is set.** That input governs
|
|
160
|
+
what a pointer over a MARK does; naming a series in the legend is the reader asking for that one
|
|
161
|
+
directly. On `dsLineSeries` this is the `highlighted` input, so a `[highlighted]` binding of yours
|
|
162
|
+
now fades the other lines without `dimOthers`, where before it only thickened the named one.
|
|
163
|
+
|
|
164
|
+
- **The unpin control sits below the plot.** The panel it undoes opens above the held mark, so a
|
|
165
|
+
control at the top was the one thing that panel covered.
|
|
166
|
+
|
|
167
|
+
- **A chart's data table is built the first time it is opened.** A closed disclosure carried the
|
|
168
|
+
whole table in the DOM; it now holds only its summary until the reader opens it, and keeps the
|
|
169
|
+
table from then on. `dataTable="visible"` is unaffected. The browser's find-in-page no longer
|
|
170
|
+
reaches the numbers of a table nobody has opened.
|
|
171
|
+
|
|
172
|
+
- **A mark's entrance is a CSS animation declared on the mark, and the `mark-enter` class is
|
|
173
|
+
gone.** The entrance plays when the mark is inserted - on first render and for a mark a data
|
|
174
|
+
change adds - exactly as before. A rule of yours that restyled the entrance through
|
|
175
|
+
`.mark-enter` targets the mark itself instead.
|
|
176
|
+
|
|
177
|
+
### Fixed
|
|
178
|
+
|
|
179
|
+
- **A stacked mark answers the pointer over its own segment.** Each series carried a hit box
|
|
180
|
+
spanning the whole category slot, so stacked they lay on top of one another and only the series
|
|
181
|
+
drawn last ever answered - every segment reported the top one.
|
|
182
|
+
|
|
183
|
+
- **A tooltip anchored to a zero-value mark stays with its reading.** Such a mark is degenerate in
|
|
184
|
+
one axis - a column loses its height, a bar its width - and the overlay took the viewport corner
|
|
185
|
+
or the plot's left edge instead of the category.
|
|
186
|
+
|
|
187
|
+
- **The bar chart's tooltip points at the drawn value, not the track.** A floating bar put its
|
|
188
|
+
panel a full track width from the reading it describes.
|
|
189
|
+
|
|
190
|
+
- **A segmented bar's tooltip names its segments.** It repeated the row label the pointer was
|
|
191
|
+
already on; the row now heads the panel and each segment gets a line with its share.
|
|
192
|
+
|
|
193
|
+
- **A hatched mark's tooltip dot carries the same break its mark does**, so the panel and the plot
|
|
194
|
+
encode the distinction the same way and neither relies on hue alone.
|
|
195
|
+
|
|
196
|
+
- **The pinned-mark badge clears the column's top edge**, instead of sitting flush against it and
|
|
197
|
+
reading as part of the bar.
|
|
198
|
+
|
|
199
|
+
- **The column panel names a column whose header is visually empty.** A column declared with an
|
|
200
|
+
empty `label` and a `screenReaderLabel` - an actions column, say - was listed in the
|
|
201
|
+
`dsTableColumns` panel as a bare checkbox with no text, so nothing said which column it stood
|
|
202
|
+
for. The row now reads the `screenReaderLabel`, which also gives the checkbox its accessible
|
|
203
|
+
name.
|
|
204
|
+
|
|
205
|
+
- **A chart that enters hundreds of marks at once no longer freezes the page.** Every entering or
|
|
206
|
+
leaving mark asked the browser for its running animations, and in Chrome that call slows down with each
|
|
207
|
+
animation already running, so a scatter of a thousand points held the main thread for seconds -
|
|
208
|
+
longer still on a page with other charts entering. Under zone.js a `ds-chart` also ran two extra
|
|
209
|
+
change-detection passes of the whole application after its first render, a column or line series
|
|
210
|
+
built its geometry at a stand-in width before the real one arrived, every point, marker and column
|
|
211
|
+
carried up to eight event listeners of its own, and the default number format built a new
|
|
212
|
+
formatter for every label.
|
|
213
|
+
|
|
214
|
+
- **`ds-date-picker` keeps its border around its value in a container narrower than the mask.**
|
|
215
|
+
The value cannot clip, so the field shrank its border around it and the value and the calendar
|
|
216
|
+
button ran past the border - a range picker under `fullWidth` was the common case. The field now
|
|
217
|
+
keeps its content width as a minimum and overflows the container with its border intact. A
|
|
218
|
+
container that fits the mask renders as before.
|
|
219
|
+
|
|
220
|
+
- **A chart with an axis title reserves a band for it.** The widest tick label no longer runs
|
|
221
|
+
through the rotated title, and the secondary axis title gets its own band, so both titles stand the
|
|
222
|
+
same distance from their ticks.
|
|
223
|
+
|
|
224
|
+
- **Axis labels are measured again when their text changes.** The value gutter and the rotation and
|
|
225
|
+
thinning of category labels were decided on the first render alone, so a chart that started out
|
|
226
|
+
loading or empty, or whose categories or ticks changed later, kept overlapping labels.
|
|
227
|
+
|
|
228
|
+
- **A skeleton pauses its shimmer while it is off screen, and moves it twenty times a second.** The
|
|
229
|
+
wave is main-thread work on every update, on screen or not. Off screen it now stops, and resumes
|
|
230
|
+
where it stopped, so a placeholder that has been scrolled away can come back out of step with its
|
|
231
|
+
neighbours. On screen it advances in 68 steps over the default 3400ms instead of once per display
|
|
232
|
+
frame; a step is about one level of lightness. A `--ds-skeleton-wave-duration` of yours changes
|
|
233
|
+
the step rate with it, since the step count is fixed.
|
|
234
|
+
|
|
235
|
+
- **Reduced motion stops the skeleton shimmer.** The opt-out rule lost to the component's own
|
|
236
|
+
animation, and the wave kept running for readers who asked for less motion.
|
|
237
|
+
|
|
238
|
+
- **A chart destroyed while a reading was pinned no longer leaves a key listener on the document.**
|
|
239
|
+
|
|
240
|
+
- **An expanded `ds-table` row's panel spans every column.** The panel's `<td>` carried
|
|
241
|
+
`display: grid` for its reveal, and a cell whose display is not `table-cell` leaves the table
|
|
242
|
+
layout, so its `colspan` was ignored and the panel rendered one column wide - as narrow as its
|
|
243
|
+
first word. The grid and the `ds-table-expand` animation sit on `.expand-panel-inner`, and the
|
|
244
|
+
projected template is wrapped in `.expand-panel-content`, the track the reveal clips. A rule of
|
|
245
|
+
yours that reached your template's root through `.expand-panel-inner >` selects
|
|
246
|
+
`.expand-panel-content` now; `.expand-panel-cell > .expand-panel-inner` is unchanged.
|
|
247
|
+
|
|
248
|
+
### What you can now DELETE
|
|
249
|
+
|
|
250
|
+
| Delete | Why | Replace with |
|
|
251
|
+
| --- | --- | --- |
|
|
252
|
+
| `ds-table .expand-panel-cell { display: table-cell }`, or a `::ng-deep` rule of that shape | the expand cell is a table cell, so the rule restates the default - and while it held, it also switched the reveal animation off | nothing |
|
|
253
|
+
| `[dsChartTooltip]="` and the `[dsChartTooltipOrigin]="` / `[dsChartTooltipPreferBelow]="` beside it, on any `g[dsColumnSeries]` or `g[dsLineSeries]` | `ds-chart` opens the panel its marks describe, so a binding on the mark opens a second one | nothing for the ordinary case; `[tooltipTemplate]` and `[tooltipExtraGap]` on `ds-chart` where the panel was customised |
|
|
254
|
+
| a `ds-modal-card .actions` rule setting `flex-wrap: wrap` | the actions row stacks full-width on its own once it outgrows the card, so a wrap rule only fights it | nothing |
|
|
255
|
+
| a `.pagination.pagination` or `.pagination-button.pagination-button` rule under `ds-table` forcing the footer pager's width, layout or button height | the footer pager takes its size and layout as inputs | `paginationSize` / `paginationLayout` on `ds-table`, or `provideDsConfig({ pagination: { ... } })`; a height none of `sm`, `md` or `lg` gives stays |
|
|
256
|
+
| `querySelector('input')?.blur()` reaching into a field control to drop focus | every field control has a public `blur()` | `blur()` on the field instance |
|
|
257
|
+
| `querySelector("textarea")` reaching into `ds-textarea` for its selection | the textarea forwards the native selection API | `selectionStart` / `selectionEnd` / `setSelectionRange()` / `select()` on `ds-textarea` |
|
|
258
|
+
| a `(row: unknown)` helper doing `return row as ` your row type for a cell template | `[dsCellTemplateOf]` types `let-row` | `[dsCellTemplateOf]="rows"` on the `dsCellTemplate`; keep a caster only for `rowExpandTemplate` or `cellTemplateMap` |
|
|
259
|
+
| a wrapper around `ds-switch` that calls `preventDefault()` and does `emit(!this.checked())` to gate a change | `ds-switch` cancels its own toggle under `controlled` and reports the request | `controlled` with `(checkedRequested)`, `[checked]` bound to the committed state |
|
|
260
|
+
|
|
3
261
|
## 0.13.4 — 2026-09-23
|
|
4
262
|
|
|
5
263
|
### Breaking
|
package/components.md
CHANGED
|
@@ -140,6 +140,9 @@ Every entry below names its exported class (`ButtonComponent`, `TableComponent<T
|
|
|
140
140
|
checkbox, radio, radio-group, switch, slider, segmented, OTP): `label`, `hint`, `error`, `warning`,
|
|
141
141
|
`errors`, `invalid`, `touched`, `reserveMessage` — and one message line under the control that renders
|
|
142
142
|
whichever of them wins. The ladder is error → errors → warning → advisory errors → success → hint.
|
|
143
|
+
Every field control also has `focus(options?)` and `blur()`. `blur()` drops focus from whichever
|
|
144
|
+
descendant holds it and leaves a portaled panel alone; `ds-autocomplete.clear()` keeps focus on
|
|
145
|
+
purpose, so a host that navigates away calls `clear()` then `blur()`.
|
|
143
146
|
|
|
144
147
|
`error`, `warning` and `success` lead that line with a glyph; `hint` does not, because it is the resting
|
|
145
148
|
text rather than a state. Retune app-wide with `DS_CONFIG.field.stateIcons` (per state, independent —
|
|
@@ -218,6 +221,7 @@ Multi-line counterpart to `<ds-input>` — same wrapper/states, reuses the `--ds
|
|
|
218
221
|
Inputs: `value: model<string>`, `size: 'sm' | 'md' | 'lg' = 'md'`, `label`, `hint`, `placeholder`, `disabled`, `invalid`, `required`, `optional: boolean = false`, `name`, `rows: number = 3`
|
|
219
222
|
Tokens: same `--ds-input-*` family as `<ds-input>` (textarea overrides `--ds-input-padding-y` to `--space-3` for vertical breathing room).
|
|
220
223
|
New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `minRows`/`maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`.
|
|
224
|
+
Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
|
|
221
225
|
|
|
222
226
|
<!-- inputs:ds-textarea -->
|
|
223
227
|
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
|
|
@@ -248,10 +252,12 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
|
|
|
248
252
|
<!-- /inputs -->
|
|
249
253
|
|
|
250
254
|
#### `<ds-switch>` — `SwitchComponent`
|
|
251
|
-
Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`
|
|
255
|
+
Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `controlled: boolean = false`
|
|
256
|
+
Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the user asked for; the switch waits for `[checked]` to change.
|
|
257
|
+
Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
|
|
252
258
|
|
|
253
259
|
<!-- inputs:ds-switch -->
|
|
254
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
|
|
260
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
|
|
255
261
|
<!-- /inputs -->
|
|
256
262
|
|
|
257
263
|
#### The picker family — `<ds-select>`, `<ds-multi-select>`, `<ds-autocomplete>`
|
|
@@ -305,7 +311,7 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
|
|
|
305
311
|
Pre-styled search input with built-in icon. A form control, but not a field: no label, no message row.
|
|
306
312
|
Inputs: `value: model<string>`, `placeholder: string = 'Search'`, `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
|
|
307
313
|
Output: `(submitted): string` — emits the current value on Enter / form submit
|
|
308
|
-
Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`.
|
|
314
|
+
Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
|
|
309
315
|
Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
|
|
310
316
|
|
|
311
317
|
<!-- inputs:ds-search -->
|
|
@@ -677,11 +683,11 @@ All inputs: `steps: readonly string[] = []`, `current: number = 0`, `labelPositi
|
|
|
677
683
|
<!-- /inputs -->
|
|
678
684
|
|
|
679
685
|
#### `<ds-pagination>` — `PaginationComponent`
|
|
680
|
-
Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout =
|
|
686
|
+
Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (every control disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`.
|
|
681
687
|
Outputs: `(currentPageChange): number`, `(pageSizeChange): number`
|
|
682
688
|
|
|
683
689
|
<!-- inputs:ds-pagination -->
|
|
684
|
-
All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' =
|
|
690
|
+
All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = null`, `loading: boolean = false`
|
|
685
691
|
<!-- /inputs -->
|
|
686
692
|
|
|
687
693
|
#### `<ds-divider>` — `DividerComponent`
|
|
@@ -828,13 +834,14 @@ Inputs: `data: required readonly T[]`, `columns: required readonly TableColumn<T
|
|
|
828
834
|
Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
|
|
829
835
|
Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string }`
|
|
830
836
|
Opening a row: give one column `link: (row) => <route target> | null` and its value renders as a real `<a>` — visible without hovering, in the tab order as a link, and Ctrl/Cmd-clickable, none of which a clickable `<tr>` can do. `null` for a row leaves that cell as plain text, so a partly-reachable list stays one column; external URLs go through a `[dsCellTemplate]` instead, since `link` takes Angular route targets only. It composes with `rowInteractive` (the link stops its click from reaching the row), but the two together cost **two tab stops per row** — on a long list prefer the link alone. `interactive: true` only tints a cell on row hover, which a keyboard or touch user never sees; prefer `link` wherever the row actually leads somewhere.
|
|
831
|
-
Cell templates: `<ng-template dsCellTemplate="<colKey>" let-row>…</ng-template>` — `row` is
|
|
837
|
+
Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows" let-row>…</ng-template>` — bound to the same rows as `[data]`, `dsCellTemplateOf` types `row` as `T` under strict templates (a field typo is a compile error) and is never read at runtime. Without it `row` is `unknown`; narrow via a helper method on the host. `CellTemplateContext<T>` (`$implicit` and `row`) is exported.
|
|
832
838
|
Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
|
|
833
|
-
Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner.
|
|
839
|
+
Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
|
|
840
|
+
Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config.
|
|
834
841
|
Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`. (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
|
|
835
842
|
|
|
836
843
|
<!-- inputs:ds-table -->
|
|
837
|
-
All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
|
|
844
|
+
All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
|
|
838
845
|
$implicit: unknown;
|
|
839
846
|
row: unknown;
|
|
840
847
|
}> | null = null`
|
|
@@ -845,7 +852,7 @@ All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null =
|
|
|
845
852
|
#### `[dsCellTemplate]` — `CellTemplateDirective`
|
|
846
853
|
|
|
847
854
|
<!-- inputs:[dsCellTemplate] -->
|
|
848
|
-
All inputs: `dsCellTemplate: required string`
|
|
855
|
+
All inputs: `dsCellTemplate: required string`, `dsCellTemplateOf: readonly T[] | null = null`
|
|
849
856
|
<!-- /inputs -->
|
|
850
857
|
|
|
851
858
|
#### `<ng-template[dsHeaderFilter]>` — `HeaderFilterDirective`
|
|
@@ -1001,7 +1008,7 @@ Colour: series ARE different things, so the categorical palette applies — `--d
|
|
|
1001
1008
|
Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`, `--ds-line-chart-annotation-color`, `--ds-line-chart-annotation-font-size`, `--ds-line-chart-annotation-font-weight`, `--ds-line-chart-annotation-halo-color`, `--ds-line-chart-annotation-halo-width`.
|
|
1002
1009
|
|
|
1003
1010
|
<!-- inputs:ds-line-chart -->
|
|
1004
|
-
All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
|
|
1011
|
+
All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
|
|
1005
1012
|
<!-- /inputs -->
|
|
1006
1013
|
|
|
1007
1014
|
#### Chart defaults — what `DS_CONFIG` decides once
|
|
@@ -1038,19 +1045,21 @@ All inputs: `columns: readonly string[] = []`, `rows: readonly ChartDataRow[] =
|
|
|
1038
1045
|
#### `<ds-chart>` — `ChartComponent`
|
|
1039
1046
|
|
|
1040
1047
|
<!-- inputs:ds-chart -->
|
|
1041
|
-
All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`
|
|
1048
|
+
All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
|
|
1049
|
+
$implicit: ChartTooltipContext;
|
|
1050
|
+
}> | null = null`, `tooltipExtraGap: number = 0`
|
|
1042
1051
|
<!-- /inputs -->
|
|
1043
1052
|
|
|
1044
1053
|
#### `<g[dsColumnSeries]>` — `ColumnSeriesComponent`
|
|
1045
1054
|
|
|
1046
1055
|
<!-- inputs:g[dsColumnSeries] -->
|
|
1047
|
-
All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`
|
|
1056
|
+
All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`
|
|
1048
1057
|
<!-- /inputs -->
|
|
1049
1058
|
|
|
1050
1059
|
#### `<g[dsLineSeries]>` — `LineSeriesComponent`
|
|
1051
1060
|
|
|
1052
1061
|
<!-- inputs:g[dsLineSeries] -->
|
|
1053
|
-
All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
|
|
1062
|
+
All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
|
|
1054
1063
|
<!-- /inputs -->
|
|
1055
1064
|
|
|
1056
1065
|
#### `<g[dsSeriesAnnotation]>` — `SeriesAnnotationComponent`
|
|
@@ -1136,7 +1145,7 @@ bootstrapApplication(AppComponent, {
|
|
|
1136
1145
|
|
|
1137
1146
|
`DsConfig` shape (the exported `DsConfig` type is the full contract):
|
|
1138
1147
|
|
|
1139
|
-
|
|
1148
|
+
Eighteen sections. The exported `DsConfig` type is the source of truth — each key carries its own
|
|
1140
1149
|
doc comment there, including why it is an app-level decision at all.
|
|
1141
1150
|
|
|
1142
1151
|
```ts
|
|
@@ -1152,6 +1161,7 @@ interface DsConfig {
|
|
|
1152
1161
|
};
|
|
1153
1162
|
};
|
|
1154
1163
|
control?: { size?: DsSize }; // every control on the field-height contract
|
|
1164
|
+
pagination?: { size?: DsSize; layout?: PaginationLayout }; // every pager, ds-table's footer included
|
|
1155
1165
|
card?: { elevation?: CardElevation; padding?: CardPadding };
|
|
1156
1166
|
table?: { stickyScrollbar?: boolean; bordered?: boolean };
|
|
1157
1167
|
modal?: { dividers?: boolean }; // reaches a ModalService confirm, which has no host to bind
|
package/docs/agent/INDEX.md
CHANGED
|
@@ -75,7 +75,7 @@ and token names.** These leaves are for orientation and usage.
|
|
|
75
75
|
- [<ds-number-stepper> — NumberStepperComponent](forms/ds-number-stepper.md) — Spinbox for bounded quantities — −/+ buttons around a numeric value.
|
|
76
76
|
- [<ds-checkbox> — CheckboxComponent](forms/ds-checkbox.md) — <!-- inputs:ds-checkbox -->
|
|
77
77
|
- [<ds-radio> — RadioComponent](forms/ds-radio.md) — <!-- inputs:ds-radio -->
|
|
78
|
-
- [<ds-switch> — SwitchComponent](forms/ds-switch.md) —
|
|
78
|
+
- [<ds-switch> — SwitchComponent](forms/ds-switch.md) — Controlled: <ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" /> - a click canc
|
|
79
79
|
- [The picker family — <ds-select>, <ds-multi-select>, <ds-autocomplete>](forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md) — Five rules hold across all three: one meaning per member name, difference only where a reason is stated, one p
|
|
80
80
|
- [<ds-select> — SelectComponent](forms/ds-select.md) — Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group header
|
|
81
81
|
- [<ds-multi-select> — MultiSelectComponent](forms/ds-multi-select.md) — <!-- inputs:ds-multi-select -->
|
|
@@ -4,5 +4,5 @@
|
|
|
4
4
|
Group: Charts
|
|
5
5
|
|
|
6
6
|
<!-- inputs:g[dsColumnSeries] -->
|
|
7
|
-
All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`
|
|
7
|
+
All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`
|
|
8
8
|
<!-- /inputs -->
|
|
@@ -4,5 +4,7 @@
|
|
|
4
4
|
Group: Charts
|
|
5
5
|
|
|
6
6
|
<!-- inputs:ds-chart -->
|
|
7
|
-
All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`
|
|
7
|
+
All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
|
|
8
|
+
$implicit: ChartTooltipContext;
|
|
9
|
+
}> | null = null`, `tooltipExtraGap: number = 0`
|
|
8
10
|
<!-- /inputs -->
|
|
@@ -16,5 +16,5 @@ Colour: series ARE different things, so the categorical palette applies — `--d
|
|
|
16
16
|
Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`, `--ds-line-chart-annotation-color`, `--ds-line-chart-annotation-font-size`, `--ds-line-chart-annotation-font-weight`, `--ds-line-chart-annotation-halo-color`, `--ds-line-chart-annotation-halo-width`.
|
|
17
17
|
|
|
18
18
|
<!-- inputs:ds-line-chart -->
|
|
19
|
-
All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
|
|
19
|
+
All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
|
|
20
20
|
<!-- /inputs -->
|
|
@@ -4,5 +4,5 @@
|
|
|
4
4
|
Group: Charts
|
|
5
5
|
|
|
6
6
|
<!-- inputs:g[dsLineSeries] -->
|
|
7
|
-
All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
|
|
7
|
+
All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
|
|
8
8
|
<!-- /inputs -->
|
|
@@ -6,7 +6,7 @@ Group: Form & input
|
|
|
6
6
|
Pre-styled search input with built-in icon. A form control, but not a field: no label, no message row.
|
|
7
7
|
Inputs: `value: model<string>`, `placeholder: string = 'Search'`, `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
|
|
8
8
|
Output: `(submitted): string` — emits the current value on Enter / form submit
|
|
9
|
-
Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`.
|
|
9
|
+
Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
|
|
10
10
|
Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
|
|
11
11
|
|
|
12
12
|
<!-- inputs:ds-search -->
|
|
@@ -3,8 +3,10 @@
|
|
|
3
3
|
|
|
4
4
|
Group: Form & input
|
|
5
5
|
|
|
6
|
-
Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`
|
|
6
|
+
Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `controlled: boolean = false`
|
|
7
|
+
Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the user asked for; the switch waits for `[checked]` to change.
|
|
8
|
+
Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
|
|
7
9
|
|
|
8
10
|
<!-- inputs:ds-switch -->
|
|
9
|
-
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
|
|
11
|
+
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
|
|
10
12
|
<!-- /inputs -->
|
|
@@ -7,6 +7,7 @@ Multi-line counterpart to `<ds-input>` — same wrapper/states, reuses the `--ds
|
|
|
7
7
|
Inputs: `value: model<string>`, `size: 'sm' | 'md' | 'lg' = 'md'`, `label`, `hint`, `placeholder`, `disabled`, `invalid`, `required`, `optional: boolean = false`, `name`, `rows: number = 3`
|
|
8
8
|
Tokens: same `--ds-input-*` family as `<ds-input>` (textarea overrides `--ds-input-padding-y` to `--space-3` for vertical breathing room).
|
|
9
9
|
New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `minRows`/`maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`.
|
|
10
|
+
Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
|
|
10
11
|
|
|
11
12
|
<!-- inputs:ds-textarea -->
|
|
12
13
|
All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
|
|
4
4
|
Group: Layout & navigation
|
|
5
5
|
|
|
6
|
-
Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout =
|
|
6
|
+
Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (every control disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`.
|
|
7
7
|
Outputs: `(currentPageChange): number`, `(pageSizeChange): number`
|
|
8
8
|
|
|
9
9
|
<!-- inputs:ds-pagination -->
|
|
10
|
-
All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' =
|
|
10
|
+
All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = null`, `loading: boolean = false`
|
|
11
11
|
<!-- /inputs -->
|
|
@@ -19,7 +19,7 @@ bootstrapApplication(AppComponent, {
|
|
|
19
19
|
|
|
20
20
|
`DsConfig` shape (the exported `DsConfig` type is the full contract):
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
Eighteen sections. The exported `DsConfig` type is the source of truth — each key carries its own
|
|
23
23
|
doc comment there, including why it is an app-level decision at all.
|
|
24
24
|
|
|
25
25
|
```ts
|
|
@@ -35,6 +35,7 @@ interface DsConfig {
|
|
|
35
35
|
};
|
|
36
36
|
};
|
|
37
37
|
control?: { size?: DsSize }; // every control on the field-height contract
|
|
38
|
+
pagination?: { size?: DsSize; layout?: PaginationLayout }; // every pager, ds-table's footer included
|
|
38
39
|
card?: { elevation?: CardElevation; padding?: CardPadding };
|
|
39
40
|
table?: { stickyScrollbar?: boolean; bordered?: boolean };
|
|
40
41
|
modal?: { dividers?: boolean }; // reaches a ModalService confirm, which has no host to bind
|
|
@@ -7,13 +7,14 @@ Inputs: `data: required readonly T[]`, `columns: required readonly TableColumn<T
|
|
|
7
7
|
Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
|
|
8
8
|
Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string }`
|
|
9
9
|
Opening a row: give one column `link: (row) => <route target> | null` and its value renders as a real `<a>` — visible without hovering, in the tab order as a link, and Ctrl/Cmd-clickable, none of which a clickable `<tr>` can do. `null` for a row leaves that cell as plain text, so a partly-reachable list stays one column; external URLs go through a `[dsCellTemplate]` instead, since `link` takes Angular route targets only. It composes with `rowInteractive` (the link stops its click from reaching the row), but the two together cost **two tab stops per row** — on a long list prefer the link alone. `interactive: true` only tints a cell on row hover, which a keyboard or touch user never sees; prefer `link` wherever the row actually leads somewhere.
|
|
10
|
-
Cell templates: `<ng-template dsCellTemplate="<colKey>" let-row>…</ng-template>` — `row` is
|
|
10
|
+
Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows" let-row>…</ng-template>` — bound to the same rows as `[data]`, `dsCellTemplateOf` types `row` as `T` under strict templates (a field typo is a compile error) and is never read at runtime. Without it `row` is `unknown`; narrow via a helper method on the host. `CellTemplateContext<T>` (`$implicit` and `row`) is exported.
|
|
11
11
|
Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
|
|
12
|
-
Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner.
|
|
12
|
+
Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
|
|
13
|
+
Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config.
|
|
13
14
|
Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`. (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
|
|
14
15
|
|
|
15
16
|
<!-- inputs:ds-table -->
|
|
16
|
-
All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
|
|
17
|
+
All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
|
|
17
18
|
$implicit: unknown;
|
|
18
19
|
row: unknown;
|
|
19
20
|
}> | null = null`
|