@ids-group-ltd/ids-design-system 0.15.1 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/components.md +3 -3
  3. package/docs/agent/foundations/global-helper-classes.md +1 -1
  4. package/docs/agent/foundations/tokens.md +1 -1
  5. package/docs/agent/tables/ds-table.md +1 -1
  6. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +16 -8
  7. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  8. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +2 -2
  9. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  10. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +2 -2
  11. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  12. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +289 -10
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  17. package/migrations/0.15.0.json +42 -11
  18. package/migrations/0.15.1.json +20 -13
  19. package/migrations/0.15.2.json +164 -0
  20. package/migrations/0.3.0.json +16 -9
  21. package/package.json +1 -1
  22. package/schematics/check-overrides/surface.json +3 -1
  23. package/stylelint/deprecated-tokens.json +3 -10
  24. package/styles/_link.scss +2 -7
  25. package/themes/README.md +6 -4
  26. package/themes/_semantic.scss +2 -0
  27. package/themes/dark/_theme.scss +3 -0
  28. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +5 -5
  29. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +2 -2
  30. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +34 -1
  31. package/types/ids-group-ltd-ids-design-system-core.d.ts +5 -0
@@ -0,0 +1,164 @@
1
+ {
2
+ "version": "0.15.2",
3
+ "items": [
4
+ {
5
+ "id": "link-colour-reads-text-link-role",
6
+ "kind": "behavior",
7
+ "old": "--ds-link-color",
8
+ "new": null,
9
+ "surface": "style",
10
+ "supersedes": [
11
+ "0.15.1#text-link-token-removed",
12
+ "0.15.1#links-stay-blue-under-a-brand"
13
+ ],
14
+ "searchHints": [
15
+ "--ds-link-color",
16
+ "--text-link",
17
+ "--blue-700",
18
+ "--blue-h",
19
+ "data-brand"
20
+ ],
21
+ "detect": [
22
+ "--ds-link-color:",
23
+ "var(--ds-link-color)",
24
+ "var(--blue-700)",
25
+ "hsl(var(--blue-h) 90% 74%)"
26
+ ],
27
+ "action": "Where your theme or brand sets `--ds-link-color` on `:root` as its link colour, set `--text-link` there instead, in each theme block it applies to. Where you read `var(--ds-link-color)`, or a palette value standing for the link colour (`var(--blue-700)`, `hsl(var(--blue-h) 90% 74%)`), outside `.link`, read `var(--text-link)`.",
28
+ "appliesWhen": "`--text-link` is a theme role in both themes: `var(--blue-700)` in light, `hsl(var(--blue-h) 90% 74%)` in dark, blue under any brand. `.link` reads `var(--ds-link-color, var(--text-link))` from `styles/link`, which `styles/ds` forwards, and a `ds-table` cell link reads the same role. `--ds-link-color` is the `.link` hook, set on `.link` or an ancestor; a theme that sets it on `:root` recolours `.link` and not the table cell link.",
29
+ "pitfall": "The dark theme declares `--text-link` under `:root[data-theme='dark']`, which outranks a plain `:root` rule, so a brand that sets it only on `:root` keeps the blue dark link; restate it under `[data-theme='dark']` as for `--primary`.",
30
+ "restore": ".link { --ds-link-color: var(--blue-700); } :root[data-theme='dark'] .link { --ds-link-color: hsl(var(--blue-h) 90% 74%); }",
31
+ "verify": "No stylesheet sets `--ds-link-color` on `:root` as a theme role or reads a `--blue-*` value as the link colour, and in light and dark a `.link` and a `ds-table` cell link paint in the colour the brand intends.",
32
+ "evidence": [
33
+ "tokens:--text-link",
34
+ "tokens:--ds-link-color"
35
+ ]
36
+ },
37
+ {
38
+ "id": "link-visited-reads-text-link-visited-role",
39
+ "kind": "behavior",
40
+ "old": "--ds-link-color-visited",
41
+ "new": null,
42
+ "surface": "style",
43
+ "supersedes": [
44
+ "0.15.1#link-visited-token-removed",
45
+ "0.15.1#link-visited-takes-its-own-colour"
46
+ ],
47
+ "searchHints": [
48
+ "--ds-link-color-visited",
49
+ "--text-link-visited",
50
+ "--blue-h",
51
+ ":visited"
52
+ ],
53
+ "detect": [
54
+ "--ds-link-color-visited:",
55
+ "var(--ds-link-color-visited)",
56
+ "hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)",
57
+ "hsl(var(--blue-h) 50% 70%)"
58
+ ],
59
+ "action": "Where your theme or brand sets `--ds-link-color-visited` on `:root` as its visited link colour, set `--text-link-visited` there instead, in each theme block it applies to. Where you read `var(--ds-link-color-visited)` or a palette value standing for the visited link colour outside `.link`, read `var(--text-link-visited)`. To keep visited links in the link colour, set `--text-link-visited: var(--text-link)` in both theme blocks.",
60
+ "appliesWhen": "`--text-link-visited` is a theme role in both themes: `hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%)` in light, `hsl(var(--blue-h) 50% 70%)` in dark. A visited `.link` reads `var(--ds-link-color-visited, var(--text-link-visited))` from `styles/link`, which `styles/ds` forwards. `.link.quiet`, a link with `aria-disabled=\"true\"` and a `<button class=\"link\">` keep their colour.",
61
+ "pitfall": "Browsers ignore custom properties declared inside a `:visited` rule, so `.link:visited { --text-link-visited: red; }` does nothing; set the role in the theme block or `--ds-link-color-visited` on `.link` or an ancestor.",
62
+ "restore": ".link { --ds-link-color-visited: hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%); } :root[data-theme='dark'] .link { --ds-link-color-visited: hsl(var(--blue-h) 50% 70%); }",
63
+ "verify": "No stylesheet sets `--ds-link-color-visited` on `:root` as a theme role or reads a `--blue-*` value as the visited link colour, and a visited `.link` paints in the colour the app intends in light and dark.",
64
+ "evidence": [
65
+ "tokens:--text-link-visited",
66
+ "tokens:--ds-link-color-visited"
67
+ ]
68
+ },
69
+ {
70
+ "id": "link-visited-role-is-text-link-visited",
71
+ "kind": "token-rename",
72
+ "old": "--link-visited",
73
+ "new": "--text-link-visited",
74
+ "surface": "style",
75
+ "supersedes": [
76
+ "0.15.1#link-visited-token-removed"
77
+ ],
78
+ "action": "Rewrite `--link-visited` to `--text-link-visited`, keeping the value.",
79
+ "appliesWhen": "A stylesheet written against 0.15.0 that sets `--link-visited` in a theme block or reads `var(--link-visited)`. `--text-link`, `--ds-link-color` and `--ds-link-color-visited` keep their names. The default moved with the name: 0.15.0 built `--link-visited`, and the dark `--text-link`, from `--primary-h` and `--primary-s`; `--text-link-visited` and the dark `--text-link` take `--blue-h` and `--blue-s`, so under a brand that sets `--primary-h` or `--primary-s` both stay blue.",
80
+ "pitfall": "The old name is inert rather than invalid: a declaration left behind sets nothing, and a read left behind resolves to nothing, so the element takes its inherited colour with no error. A brand that relied on 0.15.0 deriving the visited or dark link colour from `--primary-h` must set `--text-link-visited`, and the dark `--text-link`, itself.",
81
+ "restore": null,
82
+ "searchHints": [
83
+ "--link-visited",
84
+ "--primary-h",
85
+ "--primary-s"
86
+ ],
87
+ "detect": [
88
+ "--link-visited:",
89
+ "var(--link-visited)"
90
+ ],
91
+ "verify": "No stylesheet declares or reads `--link-visited`, and a visited `.link` paints in the colour the app intends in light and dark."
92
+ },
93
+ {
94
+ "id": "table-cell-link-reads-text-link",
95
+ "kind": "behavior",
96
+ "old": "--ds-table-cell-link-color",
97
+ "new": null,
98
+ "surface": "style",
99
+ "searchHints": [
100
+ "--ds-table-cell-link-color",
101
+ "--accent",
102
+ "--primary",
103
+ "data-brand",
104
+ "interactive: true",
105
+ "link:"
106
+ ],
107
+ "detect": [
108
+ "--ds-table-cell-link-color",
109
+ "--primary:"
110
+ ],
111
+ "action": "None, unless a `ds-table` cell link must stay in the brand colour: set `--ds-table-cell-link-color: var(--accent)` on `ds-table` or an ancestor.",
112
+ "appliesWhen": "A `ds-table` column with `link`, and an `interactive: true` cell of a `rowInteractive` table on row hover. `--ds-table-cell-link-color` defaults to `var(--text-link)` where it was `var(--accent)`: `--blue-700` where it was `--blue-600` in light, the light dark-theme link blue where it was the dark `--primary`, and blue under a brand that set `--primary`. A table that sets `--ds-table-cell-link-color` itself keeps its colour.",
113
+ "pitfall": "A brand that set `--primary` to colour its table links gets blue table links with no error; set `--text-link` for every link, or `--ds-table-cell-link-color` for the table alone.",
114
+ "restore": "ds-table { --ds-table-cell-link-color: var(--accent); }",
115
+ "verify": "In light and dark, a `ds-table` link cell and a hovered `interactive` cell paint in `--text-link`, or in the colour the app sets, at 4.5:1 or more on the row.",
116
+ "evidence": [
117
+ "tokens:--ds-table-cell-link-color"
118
+ ]
119
+ },
120
+ {
121
+ "id": "table-layout-auto-keeps-0-15-0-widths",
122
+ "kind": "behavior",
123
+ "old": "provideDsConfig",
124
+ "new": null,
125
+ "surface": [
126
+ "config",
127
+ "template"
128
+ ],
129
+ "searchHints": [
130
+ "provideDsConfig",
131
+ "DS_CONFIG",
132
+ "<ds-table"
133
+ ],
134
+ "detect": [
135
+ "provideDsConfig({",
136
+ "table: {",
137
+ "<ds-table"
138
+ ],
139
+ "action": "None, unless the app's tables must keep the 0.15.0 look: set `provideDsConfig({ table: { layout: 'auto' } })` to keep the 0.15.0 look until your tables are reviewed, or `layout=\"auto\"` on one `ds-table`. Keep it only until each table reads right under `'fixed'`.",
140
+ "appliesWhen": "Every `ds-table` without its own `layout`, once `DsConfig.table.layout` is `'auto'`; a `layout` on the element wins over the config. Under `'auto'` each column follows its cell content as on 0.15.0: `kind` has no effect, and a numeric `width`, `width: 'content'`, `minWidth` and `truncate` size the column as on 0.15.0. A table with `virtualScroll` keeps `table-layout: fixed`.",
141
+ "pitfall": "`'auto'` is deprecated and will be removed, and a development build warns once per page while a table uses it. A `kind` added for 0.15.1 does nothing under `'auto'`, so a table that reads right under `'auto'` still has to be reviewed under `'fixed'` before the key is deleted.",
142
+ "restore": "provideDsConfig({ table: { layout: 'auto' } })",
143
+ "verify": "With the key set, each `ds-table` shows the column widths it had on 0.15.0, and the console shows the `layout=\"auto\"` deprecation warning once.",
144
+ "evidence": [
145
+ "command:node tools/table-clip-harness.mjs layout <0.15.0 docs url>/harness/table-clip <docs url>/harness/table-clip"
146
+ ]
147
+ }
148
+ ],
149
+ "informational": [
150
+ {
151
+ "text": "`showChange` on `dsLineSeries` and `ds-line-chart` colours the stretch from a reading of 0 in `--ds-chart-positive-color` or `--ds-chart-negative-color` like any other stretch, and prints no percentage on it.",
152
+ "verify": "Hover the reading after a 0 on a ds-line-chart with showChange and confirm the stretch from the 0 is thickened in the rising or falling colour with no percentage above it."
153
+ },
154
+ {
155
+ "text": "The `showChange` stretch and percentage wait `--ds-motion-chart-mark-exit-duration` and fade in over `--ds-motion-chart-mark-enter-duration` (120ms and 400ms by default), as the chart's other marks do, such as a heatmap cell or a pie slice, and leave on `--ds-motion-chart-mark-exit-duration` and `--ds-motion-chart-mark-exit-easing`.",
156
+ "verify": "Hover a reading on a ds-line-chart with showChange and confirm the percentage appears after a short pause and fades in over about 400ms."
157
+ },
158
+ {
159
+ "text": "A `ds-table` under a `display: none` ancestor, such as an inactive `ds-tabs` panel, no longer measures its header labels or its `width: 'content'` columns there; it measures them when it is shown, so a `width: 'content'` column no longer collapses to 0px and no column shrinks below its header label after the table is shown.",
160
+ "verify": "Render a ds-table with a width: 'content' column inside an inactive ds-tabs panel, change its data there, switch to the panel, and confirm the column fits its widest cell and every column is at least as wide as its header label."
161
+ }
162
+ ],
163
+ "deleteList": []
164
+ }
@@ -26,41 +26,48 @@
26
26
  "kind": "behavior",
27
27
  "old": "--ds-*-fg",
28
28
  "new": null,
29
- "action": "For each `-fg` token you override, look the replacement up in the 0.3.0 token reference on the documentation site, which lists every `--ds-*`; the global roles are also readable in the installed package under `themes/` and `styles/`. Three suffixes are in play and the split is real: at 0.3.0 the package exposes 16 `--ds-*-text-color`, 30 `-label-color` and 10 `-icon-color` hooks (state variants such as `-hover` included).",
29
+ "action": "For each `-fg` token you override, look the replacement up in the 0.3.0 token reference on the documentation site, which lists every `--ds-*`; the global roles are also readable in the installed package under `themes/` and `styles/`. Three suffixes are in play and the split is real: at 0.3.0 the package exposes 16 `--ds-*-text-color`, 30 `-label-color` and 10 `-icon-color` hooks (state variants such as `-hover` included). A state variant keeps its state after the new suffix: `--ds-tab-fg-hover` becomes `--ds-tab-label-color-hover`, `--ds-modal-title-fg-error` becomes `--ds-modal-title-text-color-error`.",
30
30
  "appliesWhen": "Only to DS-owned tokens. A variable of your own ending in `-fg` is untouched.",
31
- "pitfall": "The suffix is NOT derivable from the old name, so guessing produces a name nothing reads and a silently unstyled element. Same shape, three answers: `--ds-modal-title-fg` became `-text-color`, `--ds-sidenav-group-fg` became `-label-color`, `--ds-icon-button-fg` became `-icon-color`.",
31
+ "pitfall": "The suffix is NOT derivable from the old name, so guessing produces a name nothing reads and a silently unstyled element. Same shape, three answers: `--ds-modal-title-fg` became `--ds-modal-title-text-color`, `--ds-sidenav-group-fg` became `--ds-sidenav-group-label-color`, `--ds-icon-button-fg` became `--ds-icon-button-icon-color`.",
32
32
  "note": "The `fg` abbreviation was dropped for a suffix that says what the token paints — text, a control or nav label, or a glyph. It covers the public `--ds-<component>-…-fg` hooks on avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state, icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs, tag and topbar, plus the `--status-*` globals and `--chart-tooltip-fg`.",
33
33
  "searchHints": [
34
34
  "-fg:",
35
35
  "-fg)",
36
+ "-fg-",
36
37
  "--chart-tooltip-fg",
37
38
  "--status-"
38
39
  ],
39
40
  "surface": "style",
40
- "verify": "No stylesheet declares or reads a --ds-*-fg token; each one names the semantic replacement its component reads (-text-color / -label-color / -icon-color)."
41
+ "verify": "No stylesheet declares or reads a --ds-*-fg or --ds-*-fg-<state> token, --chart-tooltip-fg or a --status-*-fg token; each one names the semantic replacement its component reads (-text-color / -label-color / -icon-color)."
41
42
  },
42
43
  {
43
44
  "id": "stepper-labels-now-visible",
44
45
  "kind": "behavior",
45
46
  "old": "ds-stepper",
46
47
  "new": null,
47
- "action": "Read every caption you pass in `[steps]` as on-screen text and reword the ones written to be heard rather than seen. `labelPosition` (`bottom` | `inline`, default `bottom`) sets where they sit.",
48
- "pitfall": "Nothing breaks and no build fails, so this ships unless somebody looks. Captions authored for a screen reader tend to carry the context the screen already gives — \"Step 2 of 5: enter your details\" reads fine when announced and badly when printed under a numbered dot.",
48
+ "action": "Read every caption you pass in `[steps]` as on-screen text and reword the ones written to be heard rather than seen. `labelPosition` (`bottom` | `inline`, default `bottom`) sets where they sit; where a stepper sits in a compact row beside other content, set `labelPosition=\"inline\"`. Style the captions through `--ds-stepper-label-color`, `--ds-stepper-label-color-current` and `--ds-stepper-label-font-size`.",
49
+ "pitfall": "Nothing breaks and no build fails, so this ships unless somebody looks. Captions authored for a screen reader tend to carry the context the screen already gives — \"Step 2 of 5: enter your details\" reads fine when announced and badly when printed under a numbered dot. A rule of yours on `ds-stepper .bar` now matches nothing: the connector is `.connector`, inside each step, and under `bottom` its width is the segment's, not a fixed length.",
49
50
  "note": "`[steps]` takes a `readonly string[]`, and those strings used to be screen-reader-only: on screen a step showed only its number. They render as visible labels now.",
50
51
  "searchHints": [
51
52
  "<ds-stepper",
52
- "[steps]"
53
+ "[steps]",
54
+ "--ds-stepper-label",
55
+ "--stepper-bar-w"
53
56
  ],
54
57
  "surface": [
55
58
  "template",
56
- "typescript"
59
+ "typescript",
60
+ "style"
57
61
  ],
58
62
  "detect": [
59
63
  "[steps]=",
60
64
  "steps: string[]",
61
- "readonly string[]"
65
+ "readonly string[]",
66
+ "ds-stepper .bar",
67
+ "--stepper-bar-w"
62
68
  ],
63
- "verify": "Every caption passed in [steps] is written to be READ on screen, not only announced - they render visibly now."
69
+ "verify": "Every caption passed in [steps] is written to be READ on screen, not only announced - they render visibly now, every stepper placed in a compact row sets labelPosition=\"inline\", and no stylesheet targets ds-stepper .bar.",
70
+ "appliesWhen": "Every `ds-stepper`. Under the default `labelPosition` (`bottom`) the host is `display: flex` where it was `inline-flex`, each step takes an equal share of the row, and the connector spans from node centre to node centre, so `--stepper-bar-w` sizes it only under `labelPosition=\"inline\"`."
64
71
  },
65
72
  {
66
73
  "id": "exported-class-members-grew",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.15.1",
3
+ "version": "0.15.2",
4
4
  "description": "IDS Group Angular design system: components, tokens, themes",
5
5
  "license": "MIT",
6
6
  "homepage": "https://ids-ds.proto.ids-group.co.uk/",
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "0.15.1",
2
+ "version": "0.15.2",
3
3
  "tokens": [
4
4
  "--ds-accordion-body-padding",
5
5
  "--ds-accordion-body-text-color",
@@ -2231,6 +2231,7 @@
2231
2231
  "ds-table": [
2232
2232
  "actions-col",
2233
2233
  "active",
2234
+ "auto-layout",
2234
2235
  "bordered",
2235
2236
  "bulk-bar",
2236
2237
  "cell-clip",
@@ -2268,6 +2269,7 @@
2268
2269
  "expand-panel-row",
2269
2270
  "expandable",
2270
2271
  "fit-content",
2272
+ "grows",
2271
2273
  "hscroll-hidden",
2272
2274
  "hscroll-proxy",
2273
2275
  "hscroll-spacer",
@@ -2619,10 +2619,10 @@
2619
2619
  },
2620
2620
  {
2621
2621
  "name": "--link-visited",
2622
- "replacement": "--ds-link-color-visited",
2623
- "kind": "removed",
2622
+ "replacement": "--text-link-visited",
2623
+ "kind": "renamed",
2624
2624
  "since": "0.15.1",
2625
- "itemId": "0.15.1#link-visited-token-removed"
2625
+ "itemId": "0.15.2#link-visited-role-is-text-link-visited"
2626
2626
  },
2627
2627
  {
2628
2628
  "name": "--opacity-muted",
@@ -2694,13 +2694,6 @@
2694
2694
  "since": "0.2.0",
2695
2695
  "itemId": "0.2.0#surface-subtle-token-rename"
2696
2696
  },
2697
- {
2698
- "name": "--text-link",
2699
- "replacement": "--ds-link-color",
2700
- "kind": "removed",
2701
- "since": "0.15.1",
2702
- "itemId": "0.15.1#text-link-token-removed"
2703
- },
2704
2697
  {
2705
2698
  "name": "--warning-subtle",
2706
2699
  "replacement": "--warning-subtitle",
package/styles/_link.scss CHANGED
@@ -3,10 +3,10 @@
3
3
  /* Pure CSS class so inline anchors in <p> text keep their line flow. */
4
4
 
5
5
  .link {
6
- --_link-color: var(--ds-link-color, var(--blue-700));
6
+ --_link-color: var(--ds-link-color, var(--text-link));
7
7
  --_link-color-hover: var(--ds-link-color-hover, color-mix(in srgb, var(--_link-color) 80%, black));
8
8
  --_link-color-active: var(--ds-link-color-active, color-mix(in srgb, var(--_link-color) 65%, black));
9
- --_link-color-visited: var(--ds-link-color-visited, hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%));
9
+ --_link-color-visited: var(--ds-link-color-visited, var(--text-link-visited));
10
10
  --_link-color-visited-hover: var(--ds-link-color-visited-hover, color-mix(in srgb, var(--_link-color-visited) 80%, black));
11
11
  --_link-color-visited-active: var(--ds-link-color-visited-active, color-mix(in srgb, var(--_link-color-visited) 65%, black));
12
12
  --_link-color-disabled: var(--ds-link-color-disabled, var(--text-disabled));
@@ -114,8 +114,3 @@
114
114
  &.sm { font-size: var(--font-size-s); }
115
115
  &.lg { font-size: var(--font-size-l); }
116
116
  }
117
-
118
- :root[data-theme='dark'] .link {
119
- --_link-color: var(--ds-link-color, hsl(var(--blue-h) 90% 74%));
120
- --_link-color-visited: var(--ds-link-color-visited, hsl(var(--blue-h) 50% 70%));
121
- }
package/themes/README.md CHANGED
@@ -141,14 +141,16 @@ Components never change — they consume semantic roles, which the active theme
141
141
  Every shade of the primary family takes its hue from `--primary` through relative colour syntax,
142
142
  in both themes; in light `--primary-strong` takes its saturation and lightness too. A brand that
143
143
  sets `--primary` gets all of them. Check each against your brand; set it explicitly where it fails.
144
- Links are not a brand shade: `.link` takes its colour from its own tokens, which default to the
145
- `--blue-*` palette in both themes, so a link stays blue under any brand. Set `--ds-link-color` (and
146
- `--ds-link-color-visited`) to change it.
144
+ Links are not a brand shade: `--text-link` and `--text-link-visited` stay blue (`--blue-*`) in both
145
+ themes under any brand, so a link reads as a link everywhere. They are the roles a brand sets to
146
+ recolour links: `.link` and the `ds-table` cell link read them. `--ds-link-color` and
147
+ `--ds-link-color-visited` are component hooks, set on `.link` or an ancestor, not on `:root` as a
148
+ theme role.
147
149
 
148
150
  | Token | Paints | Light default | Dark default | Must meet |
149
151
  | ------------------------ | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------ | ---------------------------------------------------- |
150
152
  | `--primary-strong` | text and icons on a tint: tag, chip, tonal button, selected row, tab, sidenav item, through `--accent-strong` | `hsl(from var(--primary) h calc(s * 0.85) calc(l - 7))` | `h 90% 72%` | 4.5:1 on every tint below and on `--surface-default` |
151
- | `--surface-tint` | active rows and items (list, tree, empty state), through `--accent-surface-tint` | `hsl(from var(--primary) h 100% 97%)` | `h 45% 16%` | `--text-primary` and a link 4.5:1 on it |
153
+ | `--surface-tint` | active rows and items (list, tree, empty state), through `--accent-surface-tint` | `hsl(from var(--primary) h 100% 97%)` | `h 45% 16%` | `--text-primary` and `--text-link` 4.5:1 on it |
152
154
  | `--primary-subtitle` | dropdown selected option; tonal fills (button, tabs, table, calendar day, sidenav item) through `--accent-subtitle` | `hsl(from var(--primary) h 100% 97%)` | `h 45% 18%` | the text on it 4.5:1 |
153
155
  | `--primary-muted` | dropdown selected option on hover; button, tag, avatar, sidenav item through `--accent-muted` | `hsl(from var(--primary) h 95% 94%)` | `h 40% 26%` | the text on it 4.5:1 |
154
156
  | `--primary-muted-strong` | tonal button hover, outline button border, through `--accent-muted-strong` | `hsl(from var(--primary) h 95% 89%)` | `h 42% 32%` | the hover label 4.5:1; the default dark holds 3.5:1 |
@@ -42,6 +42,8 @@
42
42
 
43
43
  --text-on-media: white;
44
44
  --text-on-media-shadow: 0 1px 3px hsl(0deg 0% 0% / 70%);
45
+ --text-link: var(--blue-700);
46
+ --text-link-visited: hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%);
45
47
  --text-on-primary: white;
46
48
  --text-on-success: white;
47
49
 
@@ -41,6 +41,9 @@
41
41
  --tertiary-muted-strong: hsl(var(--tertiary-h) 42% 32%);
42
42
  --tertiary-strong: hsl(var(--tertiary-h) 90% 72%);
43
43
 
44
+ --text-link: hsl(var(--blue-h) 90% 74%);
45
+ --text-link-visited: hsl(var(--blue-h) 50% 70%);
46
+
44
47
  --success-subtitle: hsl(132deg 38% 14%);
45
48
  --success-muted: hsl(132deg 34% 20%);
46
49
  --success-muted-strong: hsl(132deg 30% 28%);
@@ -692,7 +692,7 @@ declare class LineSeriesComponent implements OnDestroy {
692
692
  readonly highlighted: _angular_core.InputSignal<string | null>;
693
693
  /** On the hovered reading, thickens the stretches from the reading before it and to the reading
694
694
  * after it, each in its own rising or falling colour (`--ds-chart-positive-color`,
695
- * `--ds-chart-negative-color`) and with its own change in percent. With several series it follows the one singled out: hovered, focused or highlighted. */
695
+ * `--ds-chart-negative-color`) and, unless it starts at zero, with its own change in percent. With several series it follows the one singled out: hovered, focused or highlighted. */
696
696
  readonly showChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
697
697
  /** A dash pattern per series, in series order. A series past the end, or given `''`, draws solid. */
698
698
  readonly patterns: _angular_core.InputSignal<readonly string[]>;
@@ -787,12 +787,12 @@ declare class LineSeriesComponent implements OnDestroy {
787
787
  protected isSpotlit(seriesId: string): boolean;
788
788
  private readonly locale;
789
789
  protected readonly changes: _angular_core.Signal<{
790
- key: string;
791
- path: string;
792
- rising: boolean;
793
- label: string;
794
790
  x: number;
795
791
  y: number;
792
+ rising: boolean;
793
+ label: string | null;
794
+ key: string;
795
+ path: string;
796
796
  }[]>;
797
797
  protected readonly pinnedMarkers: _angular_core.Signal<readonly {
798
798
  index: number;
@@ -120,8 +120,8 @@ declare class LineChartComponent extends DsChartBase implements ChartDimmable, C
120
120
  * the value there in a pill on the axis. On by default. */
121
121
  readonly showAxisReadout: _angular_core.InputSignalWithTransform<boolean, unknown>;
122
122
  /** On the hovered reading, thickens the stretches from the reading before it and to the reading
123
- * after it, each in its own rising or falling colour and with its own change in percent; with
124
- * several series, for the one singled out. */
123
+ * after it, each in its own rising or falling colour and, unless it starts at zero, with its own
124
+ * change in percent; with several series, for the one singled out. */
125
125
  readonly showChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
126
126
  /** Milliseconds between one series' entrance and the next; `0` turns it off. The step narrows
127
127
  * so the last series still starts within the stagger budget. */
@@ -419,6 +419,16 @@ declare class TableComponent<T extends object> {
419
419
  * `--ds-table-sticky-scrollbar-offset` wins over both. */
420
420
  readonly stickyScrollbarOffset: _angular_core.InputSignal<string | null>;
421
421
  readonly stickyScrollbarOffsetResolved: _angular_core.Signal<string | null>;
422
+ /** `'fixed'`: a column is as wide as its `width`, else its `kind`, else an equal share of what
423
+ * the others leave, whatever its cells hold. `'auto'`, deprecated: the 0.15.0 widths, which
424
+ * follow the cell content and ignore `kind`. Unset falls back to `DS_CONFIG.table.layout`, then
425
+ * `'fixed'`.
426
+ * @deprecated `'auto'` is a temporary way back to the 0.15.0 column widths and will be removed.
427
+ * Review the table under `'fixed'`, setting `width`, `kind` or `minWidth` where a column needs
428
+ * it, then delete the binding. */
429
+ readonly layoutMode: _angular_core.InputSignal<"auto" | "fixed" | null>;
430
+ private readonly layoutResolved;
431
+ protected readonly autoLayout: _angular_core.Signal<boolean>;
422
432
  /** Pin the first data column (and the select column) on horizontal scroll. */
423
433
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
424
434
  /** Render only the rows in view, padding the rest with spacer rows. Needs `maxHeight` (dev-warned,
@@ -542,10 +552,33 @@ declare class TableComponent<T extends object> {
542
552
  protected onEditInput(event: Event): void;
543
553
  protected commitEdit(row: T, col: TableColumn<T>): void;
544
554
  protected cancelEdit(): void;
555
+ /** `layout="auto"` sizes the header cell; `'fixed'` sizes the `<col>` instead. */
556
+ protected autoLayoutWidth(col: TableColumn<T>): number | null;
557
+ protected autoLayoutMinWidth(col: TableColumn<T>): number | null;
558
+ /** A dragged column clips at its dragged width too, not at the declared one. */
559
+ protected clipGrows(col: TableColumn<T>): boolean;
560
+ protected clipMaxWidth(col: TableColumn<T>, index: number): string | null;
561
+ /** Holds the column open to its text, as far as its cap, whatever the rendered rows hold. */
562
+ protected clipMinWidth(col: TableColumn<T>, index: number): string | null;
563
+ private readonly growingClipColumns;
564
+ private clipCapsSet;
565
+ private clipFit;
566
+ private clipFitWidth;
567
+ private textCanvas;
568
+ /** One forced layout per data or column change: the table at max-content with every growing
569
+ * column at its header leaves what the other columns need to show their content. A growing
570
+ * column's text is the widest of its rendered cells and of every filtered row's value, so a
571
+ * page of short values sizes it as a page of long ones does. */
572
+ private measureGrowingClips;
573
+ /** The values a page does not render, measured as text in the cell's font. */
574
+ private widestValue;
575
+ /** No layout read: the widths come from the last measure and the wrap's width. */
576
+ private splitGrowingClips;
545
577
  private readonly headerMetrics;
546
578
  private readonly wrapWidth;
547
579
  private readonly contentWidths;
548
580
  private readonly fontsLoaded;
581
+ private readonly rendered;
549
582
  /** One per visible column; `null` leaves the column to share the slack with the others. Read
550
583
  * from the columns, the header labels and the container, never from the rows. */
551
584
  protected readonly columnWidths: _angular_core.Signal<readonly (number | null)[]>;
@@ -655,7 +688,7 @@ declare class TableComponent<T extends object> {
655
688
  private warnNoExport;
656
689
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
657
690
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
658
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDirection": { "alias": "sortDirection"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "paginationSize": { "alias": "paginationSize"; "required": false; "isSignal": true; }; "paginationLayout": { "alias": "paginationLayout"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyScrollbarOffset": { "alias": "stickyScrollbarOffset"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirectionChange": "sortDirectionChange"; "columnFilters": "columnFiltersChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
691
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDirection": { "alias": "sortDirection"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "paginationSize": { "alias": "paginationSize"; "required": false; "isSignal": true; }; "paginationLayout": { "alias": "paginationLayout"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyScrollbarOffset": { "alias": "stickyScrollbarOffset"; "required": false; "isSignal": true; }; "layoutMode": { "alias": "layout"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirectionChange": "sortDirectionChange"; "columnFilters": "columnFiltersChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
659
692
  }
660
693
 
661
694
  export { CellTemplateDirective, DsTableLayout, HeaderFilterDirective, TableComponent };
@@ -316,6 +316,11 @@ interface DsConfig {
316
316
  /** Default for `ds-table`'s `stickyScrollbarOffset`, as any CSS length. Unset, each table
317
317
  * cancels its scroll container's bottom padding. */
318
318
  stickyScrollbarOffset?: string;
319
+ /** Default for `ds-table`'s `layout`. Default `'fixed'`.
320
+ * @deprecated `'auto'` is a temporary way back to the 0.15.0 column widths, which follow the
321
+ * cell content and ignore `kind`; it will be removed. Review each table under `'fixed'`,
322
+ * setting `width`, `kind` or `minWidth` where a column needs it, then delete this key. */
323
+ layout?: 'fixed' | 'auto';
319
324
  };
320
325
  icon?: {
321
326
  /** Default pixel `size` for `ds-icon`. Default `16`. */