@ids-group-ltd/ids-design-system 0.15.0 → 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 (189) hide show
  1. package/CHANGELOG.md +496 -0
  2. package/components.md +69 -38
  3. package/docs/agent/INDEX.md +3 -3
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +1 -1
  6. package/docs/agent/charts/ds-column-chart.md +2 -1
  7. package/docs/agent/charts/ds-heatmap-chart.md +2 -1
  8. package/docs/agent/charts/ds-line-chart.md +3 -3
  9. package/docs/agent/charts/ds-pie-chart.md +3 -2
  10. package/docs/agent/charts/ds-scatter-chart.md +2 -1
  11. package/docs/agent/charts/ds-waterfall-chart.md +1 -1
  12. package/docs/agent/charts/line-series-component.md +1 -1
  13. package/docs/agent/feedback/ds-alert.md +1 -0
  14. package/docs/agent/feedback/ds-banner.md +1 -0
  15. package/docs/agent/feedback/ds-toast.md +2 -0
  16. package/docs/agent/forms/ds-autocomplete.md +1 -1
  17. package/docs/agent/forms/ds-button.md +1 -0
  18. package/docs/agent/forms/ds-checkbox.md +1 -1
  19. package/docs/agent/forms/ds-color-picker.md +1 -1
  20. package/docs/agent/forms/ds-date-picker.md +1 -1
  21. package/docs/agent/forms/ds-icon-button.md +1 -1
  22. package/docs/agent/forms/ds-input.md +1 -1
  23. package/docs/agent/forms/ds-multi-select.md +1 -1
  24. package/docs/agent/forms/ds-otp-input.md +1 -1
  25. package/docs/agent/forms/ds-radio-group.md +1 -1
  26. package/docs/agent/forms/ds-segmented.md +1 -1
  27. package/docs/agent/forms/ds-select.md +1 -1
  28. package/docs/agent/forms/ds-slider.md +1 -1
  29. package/docs/agent/forms/ds-switch.md +1 -1
  30. package/docs/agent/forms/ds-textarea.md +1 -1
  31. package/docs/agent/forms/ds-time-picker.md +1 -1
  32. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  33. package/docs/agent/foundations/global-helper-classes.md +1 -1
  34. package/docs/agent/foundations/tokens.md +1 -1
  35. package/docs/agent/navigation/ds-pagination.md +2 -1
  36. package/docs/agent/overlays/ds-definition-term.md +1 -1
  37. package/docs/agent/overlays/ds-info-hint.md +21 -2
  38. package/docs/agent/overlays/ds-tooltip-panel.md +1 -1
  39. package/docs/agent/overlays/ds-tooltip.md +1 -1
  40. package/docs/agent/tables/ds-table-columns.md +2 -0
  41. package/docs/agent/tables/ds-table.md +3 -2
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +6 -3
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +10 -4
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +6 -3
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +8 -9
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +7 -17
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +694 -77
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +2190 -1234
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -5
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +15 -5
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +44 -5
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +22 -6
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs +44 -5
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-field-message.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -18
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +49 -20
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +5 -4
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs +76 -10
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-info-hint.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +11 -7
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +33 -44
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +50 -5
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +10 -5
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +14 -6
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +102 -27
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +5 -2
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +11 -6
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +123 -23
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +10 -5
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +10 -4
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs +55 -0
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-show-dirty.mjs.map +1 -0
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +10 -5
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +3 -2
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -5
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +32 -14
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +2 -2
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs +17 -0
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-table-resize.mjs.map +1 -1
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +259 -21
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +15 -5
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +24 -7
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +17 -2
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +32 -12
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +10 -6
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  128. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +238 -67
  129. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +9 -2
  131. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  132. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  133. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  134. package/migrations/0.15.0.json +43 -12
  135. package/migrations/0.15.1.json +745 -0
  136. package/migrations/0.15.2.json +164 -0
  137. package/migrations/0.3.0.json +16 -9
  138. package/package.json +9 -1
  139. package/schematics/check-overrides/surface.json +48 -1
  140. package/stylelint/deprecated-tokens.json +7 -0
  141. package/styles/_chart-frame.scss +14 -0
  142. package/styles/_chart-interactive.scss +26 -1
  143. package/styles/_chart-motion.scss +47 -8
  144. package/styles/_link.scss +30 -12
  145. package/styles/_tokens.scss +3 -0
  146. package/themes/README.md +55 -0
  147. package/themes/_semantic.scss +6 -7
  148. package/themes/dark/_theme.scss +7 -7
  149. package/types/ids-group-ltd-ids-design-system-components-alert.d.ts +1 -1
  150. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +2 -0
  151. package/types/ids-group-ltd-ids-design-system-components-banner.d.ts +1 -1
  152. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +5 -4
  153. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +4 -4
  154. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +51 -7
  155. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +201 -28
  156. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +2 -0
  157. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +2 -0
  158. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +27 -2
  159. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +3 -1
  160. package/types/ids-group-ltd-ids-design-system-components-field-message.d.ts +19 -2
  161. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +0 -3
  162. package/types/ids-group-ltd-ids-design-system-components-heatmap-chart.d.ts +21 -8
  163. package/types/ids-group-ltd-ids-design-system-components-icon-button.d.ts +3 -2
  164. package/types/ids-group-ltd-ids-design-system-components-info-hint.d.ts +13 -4
  165. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +2 -0
  166. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +13 -7
  167. package/types/ids-group-ltd-ids-design-system-components-menu.d.ts +6 -0
  168. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +2 -0
  169. package/types/ids-group-ltd-ids-design-system-components-otp-input.d.ts +2 -0
  170. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +5 -3
  171. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +24 -7
  172. package/types/ids-group-ltd-ids-design-system-components-popover.d.ts +2 -1
  173. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +2 -0
  174. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +39 -7
  175. package/types/ids-group-ltd-ids-design-system-components-segmented.d.ts +2 -0
  176. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +2 -0
  177. package/types/ids-group-ltd-ids-design-system-components-show-dirty.d.ts +29 -0
  178. package/types/ids-group-ltd-ids-design-system-components-slider.d.ts +2 -0
  179. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +2 -0
  180. package/types/ids-group-ltd-ids-design-system-components-table-resize.d.ts +2 -0
  181. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +51 -11
  182. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +2 -0
  183. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +3 -1
  184. package/types/ids-group-ltd-ids-design-system-components-toast.d.ts +2 -0
  185. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +8 -6
  186. package/types/ids-group-ltd-ids-design-system-components-waterfall-chart.d.ts +4 -1
  187. package/types/ids-group-ltd-ids-design-system-components.d.ts +110 -34
  188. package/types/ids-group-ltd-ids-design-system-core.d.ts +44 -12
  189. package/types/ids-group-ltd-ids-design-system.d.ts +3 -2
package/styles/_link.scss CHANGED
@@ -3,39 +3,59 @@
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(--text-link));
7
- --_link-color-hover: var(--ds-link-color-hover, color-mix(in srgb, var(--_link-color) 80%, black));
6
+ --_link-color: var(--ds-link-color, var(--text-link));
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, var(--text-link-visited));
10
+ --_link-color-visited-hover: var(--ds-link-color-visited-hover, color-mix(in srgb, var(--_link-color-visited) 80%, black));
11
+ --_link-color-visited-active: var(--ds-link-color-visited-active, color-mix(in srgb, var(--_link-color-visited) 65%, black));
12
+ --_link-color-disabled: var(--ds-link-color-disabled, var(--text-disabled));
13
+ --_link-underline-color: var(--ds-link-underline-color, currentcolor);
14
+ --_link-underline-thickness: var(--ds-link-underline-thickness, 1px);
15
+ --_link-underline-offset: var(--ds-link-underline-offset, 2px);
16
+ --_link-focus-ring-color: var(--ds-link-focus-ring-color, var(--focus-ring-color));
9
17
 
10
18
  color: var(--_link-color);
11
19
  text-decoration: underline;
12
- text-decoration-color: var(--_link-color);
13
- text-underline-offset: 2px;
14
- text-decoration-thickness: 1px;
20
+ text-decoration-color: var(--_link-underline-color);
21
+ text-underline-offset: var(--_link-underline-offset);
22
+ text-decoration-thickness: var(--_link-underline-thickness);
15
23
  font-weight: var(--font-weight-medium);
16
24
  cursor: pointer;
17
25
  transition: color var(--duration-fast) var(--ease-standard), text-decoration-color var(--duration-fast) var(--ease-standard);
18
26
 
19
27
  &:hover {
20
28
  color: var(--_link-color-hover);
21
- text-decoration-color: var(--_link-color-hover);
22
29
  }
23
30
 
24
31
  &:active {
25
32
  color: var(--_link-color-active);
26
- text-decoration-color: var(--_link-color-active);
33
+ }
34
+
35
+ /* Browsers apply only colour properties under `:visited` and ignore custom properties declared there,
36
+ so the resolvers live on `.link` and these rules set `color` alone. `:where()` keeps each at the
37
+ specificity of its unvisited twin, so `.quiet` and `[aria-disabled]` below still win. */
38
+ &:where(:visited) {
39
+ color: var(--_link-color-visited);
40
+ }
41
+
42
+ &:where(:visited):hover {
43
+ color: var(--_link-color-visited-hover);
44
+ }
45
+
46
+ &:where(:visited):active {
47
+ color: var(--_link-color-visited-active);
27
48
  }
28
49
 
29
50
  &:focus-visible {
30
51
  @include focus.ring;
31
52
 
53
+ outline-color: var(--_link-focus-ring-color);
32
54
  border-radius: var(--radius-sm);
33
- text-decoration-color: var(--_link-color);
34
55
  }
35
56
 
36
57
  &[aria-disabled="true"] {
37
- color: var(--text-disabled);
38
- text-decoration-color: var(--text-disabled);
58
+ color: var(--_link-color-disabled);
39
59
  pointer-events: none;
40
60
  cursor: default;
41
61
  }
@@ -61,12 +81,10 @@
61
81
 
62
82
  &.quiet {
63
83
  color: var(--text-secondary);
64
- text-decoration-color: var(--text-secondary);
65
84
  font-weight: var(--font-weight-medium);
66
85
 
67
86
  &:hover {
68
87
  color: var(--text-primary);
69
- text-decoration-color: var(--text-primary);
70
88
  }
71
89
  }
72
90
 
@@ -159,6 +159,9 @@
159
159
  --ds-motion-chart-tooltip-move-duration: 300ms;
160
160
  --ds-motion-chart-tooltip-move-easing: var(--ease-standard);
161
161
 
162
+ /* How long the pointer rests on a heatmap cell before the scale marker moves to it; a sweep across the grid leaves it still. */
163
+ --ds-motion-chart-scale-marker-delay: var(--duration-fast);
164
+
162
165
  --opacity-disabled: 0.5;
163
166
  --opacity-text-disabled: 0.38;
164
167
  --opacity-scrim: 0.55;
package/themes/README.md CHANGED
@@ -136,6 +136,61 @@ Components never change — they consume semantic roles, which the active theme
136
136
  3. Override the brand hue (`--blue-*` ramp and/or `--primary` + channels), and any roles you want to retint (surfaces, text, secondary, status). Leave `--primary-hover`/`--primary-pressed` to the DS `color-mix()` derivation.
137
137
  4. Apply via `<html data-brand="X">`.
138
138
 
139
+ ## Brand checklist: what follows `--primary`
140
+
141
+ Every shade of the primary family takes its hue from `--primary` through relative colour syntax,
142
+ in both themes; in light `--primary-strong` takes its saturation and lightness too. A brand that
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: `--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.
149
+
150
+ | Token | Paints | Light default | Dark default | Must meet |
151
+ | ------------------------ | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------ | ---------------------------------------------------- |
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` |
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 |
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 |
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 |
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 |
157
+
158
+ Dark defaults are `hsl(from var(--primary) …)` with the hue, saturation and lightness shown.
159
+
160
+ - A light brand (yellow, lime, cyan) derives a `--primary-strong` under 4.5:1 on white: set it to
161
+ a darker step.
162
+ - An achromatic brand (black, gray) has no hue: the tints fall to hue 0, pink in light and dark red
163
+ in dark. Set the tints.
164
+ - Still read from the channels `--primary-h/s/l`, which follow `--blue-h/s/l` and not `--primary`:
165
+ the focus ring and the field halo (`--focus-ring`, `--focus-field`) and the
166
+ `data-neutrals="brand"` grays. Set the three channels to your brand's
167
+ HSL, or they stay blue.
168
+ - Dark: the dark block declares `--primary` itself and wins over a light-authored brand, so restate
169
+ `--primary` (and the channels) under `[data-theme='dark'][data-brand="X"]`; every shade follows.
170
+
171
+ Green brand, measured in Chrome 2026-10-12:
172
+
173
+ ```scss
174
+ [data-brand='green'] {
175
+ --primary: #1f7a4d;
176
+ --primary-h: 150;
177
+ --primary-s: 60%;
178
+ --primary-l: 30%;
179
+ // Derived in light: --surface-tint and --primary-subtitle #f0fff7, --primary-muted #e1fef0,
180
+ // --primary-muted-strong #c8fee3, --primary-strong #1d583b
181
+ // (8.33:1 on white, 8.07:1 on the tint). Links stay blue.
182
+ }
183
+
184
+ [data-theme='dark'][data-brand='green'] {
185
+ --primary: #1f7a4d;
186
+ --primary-h: 150;
187
+ --primary-s: 60%;
188
+ --primary-l: 30%;
189
+ // Derived: --surface-tint #163b29, --primary-subtitle #19432e, --primary-muted #285d43,
190
+ // --primary-muted-strong #2f7452, --primary-strong #77f8b8 (9.37:1 on the tint).
191
+ }
192
+ ```
193
+
139
194
  ## Rules summary
140
195
 
141
196
  - Components never reference base-palette primitives (`--blue-600`, `--neutral-200`) directly — use a Tier-2 role.
@@ -16,7 +16,7 @@
16
16
  --surface-overlay: var(--neutral-0);
17
17
  --surface-inverted: var(--neutral-900);
18
18
  --surface-inverted-hover: var(--neutral-800);
19
- --surface-tint: var(--blue-50);
19
+ --surface-tint: hsl(from var(--primary) h 100% 97%);
20
20
  --surface-disabled: var(--neutral-100);
21
21
  --surface-muted: var(--neutral-150);
22
22
 
@@ -26,8 +26,6 @@
26
26
  /* Divider on a coloured fill (split-button chevron); a translucent white reads on any brand hue. */
27
27
  --btn-split-divider: hsl(0deg 0% 100% / 25%);
28
28
 
29
- --link-visited: hsl(var(--primary-h) calc(var(--primary-s) * 0.6) 45%);
30
-
31
29
  --border-default: var(--neutral-200);
32
30
  --border-strong: var(--neutral-300);
33
31
  --border-subtitle: var(--neutral-150);
@@ -45,6 +43,7 @@
45
43
  --text-on-media: white;
46
44
  --text-on-media-shadow: 0 1px 3px hsl(0deg 0% 0% / 70%);
47
45
  --text-link: var(--blue-700);
46
+ --text-link-visited: hsl(var(--blue-h) calc(var(--blue-s) * 0.6) 45%);
48
47
  --text-on-primary: white;
49
48
  --text-on-success: white;
50
49
 
@@ -78,10 +77,10 @@
78
77
  --primary-hover: color-mix(in srgb, var(--primary) 88%, black);
79
78
  --primary-pressed: color-mix(in srgb, var(--primary) 76%, black);
80
79
  --primary-selected-hover: color-mix(in srgb, var(--primary) 88%, black);
81
- --primary-subtitle: var(--blue-50);
82
- --primary-muted: var(--blue-100);
83
- --primary-muted-strong: var(--blue-200);
84
- --primary-strong: var(--blue-700);
80
+ --primary-subtitle: hsl(from var(--primary) h 100% 97%);
81
+ --primary-muted: hsl(from var(--primary) h 95% 94%);
82
+ --primary-muted-strong: hsl(from var(--primary) h 95% 89%);
83
+ --primary-strong: hsl(from var(--primary) h calc(s * 0.85) calc(l - 7));
85
84
  --primary-on: white;
86
85
 
87
86
  /* Override --secondary-h/s/l to reskin; --secondary, hover and pressed recompose. */
@@ -25,11 +25,11 @@
25
25
  --warning-pressed: color-mix(in srgb, var(--warning) 76%, white);
26
26
  --info-hover: color-mix(in srgb, var(--info) 88%, white);
27
27
 
28
- --surface-tint: hsl(var(--primary-h) 45% 16%);
29
- --primary-subtitle: hsl(var(--primary-h) 45% 18%);
30
- --primary-muted: hsl(var(--primary-h) 40% 26%);
31
- --primary-muted-strong: hsl(var(--primary-h) 42% 32%);
32
- --primary-strong: hsl(var(--primary-h) 90% 72%);
28
+ --surface-tint: hsl(from var(--primary) h 45% 16%);
29
+ --primary-subtitle: hsl(from var(--primary) h 45% 18%);
30
+ --primary-muted: hsl(from var(--primary) h 40% 26%);
31
+ --primary-muted-strong: hsl(from var(--primary) h 42% 32%);
32
+ --primary-strong: hsl(from var(--primary) h 90% 72%);
33
33
 
34
34
  --secondary-subtitle: hsl(var(--secondary-h) 45% 18%);
35
35
  --secondary-muted: hsl(var(--secondary-h) 40% 26%);
@@ -41,8 +41,8 @@
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(--primary-h) 90% 74%);
45
- --link-visited: hsl(var(--primary-h) 50% 70%);
44
+ --text-link: hsl(var(--blue-h) 90% 74%);
45
+ --text-link-visited: hsl(var(--blue-h) 50% 70%);
46
46
 
47
47
  --success-subtitle: hsl(132deg 38% 14%);
48
48
  --success-muted: hsl(132deg 34% 20%);
@@ -27,7 +27,7 @@ declare class AlertComponent {
27
27
  protected readonly classes: _angular_core.Signal<string>;
28
28
  protected readonly defaultIcon: _angular_core.Signal<IconName>;
29
29
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
30
- protected onDismiss(): void;
30
+ protected onDismiss(leaving: HTMLElement): void;
31
31
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
32
32
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
33
33
  }
@@ -94,6 +94,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
94
94
  protected readonly hintId: _angular_core.Signal<string | null>;
95
95
  private readonly fieldMessage;
96
96
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
97
+ protected readonly pendingShown: _angular_core.Signal<boolean>;
98
+ protected readonly changedShown: _angular_core.Signal<boolean>;
97
99
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
98
100
  protected readonly groupMessage: _angular_core.Signal<string | null>;
99
101
  protected readonly describedByIds: typeof describedByIds;
@@ -34,7 +34,7 @@ declare class BannerComponent {
34
34
  constructor();
35
35
  protected readonly classes: _angular_core.Signal<string>;
36
36
  protected readonly defaultIcon: _angular_core.Signal<IconName>;
37
- protected onDismiss(): void;
37
+ protected onDismiss(leaving: HTMLElement): void;
38
38
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BannerComponent, never>;
39
39
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<BannerComponent, "ds-banner", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "accentRail": { "alias": "accentRail"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
40
40
  }
@@ -45,9 +45,9 @@ declare class ButtonComponent extends DsMessageBase {
45
45
  /** How `routerLinkActive` decides the `active` class; prefix by default. It also bounds the
46
46
  * announcement: with `{ exact: true }` a prefix match announces nothing rather than `true`.
47
47
  * Pass `ariaCurrent` alongside to keep one. */
48
- readonly routerLinkActiveOptions: _angular_core.InputSignal<{
48
+ readonly routerLinkActiveOptions: _angular_core.InputSignal<IsActiveMatchOptions | {
49
49
  exact: boolean;
50
- } | IsActiveMatchOptions>;
50
+ }>;
51
51
  /** Overrides what the link announces. Unset, an exact match announces `page` and a prefix match
52
52
  * `true`; `null` announces nothing; use `step` or `location` when the link is not a page. */
53
53
  readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
@@ -56,8 +56,9 @@ declare class ButtonComponent extends DsMessageBase {
56
56
  readonly type: _angular_core.InputSignal<ButtonType>;
57
57
  /** Disables the button and blocks `pressed`. */
58
58
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
59
- /** Busy state: disables interaction and sets `aria-busy`. Button-only; ignored on an anchor
60
- * with a dev warning. */
59
+ /** Busy state: blocks `pressed` and sets `aria-busy` and `aria-disabled`, keeping the button
60
+ * focusable so focus stays on it while the work runs. Button-only; ignored on an anchor with a
61
+ * dev warning. */
61
62
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
62
63
  /** Fills the container: the host becomes block-level and 100% wide. */
63
64
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -27,10 +27,10 @@ declare class ChartLegendComponent {
27
27
  /** The item under the pointer or holding focus, which the chart dims from; a pointer waits
28
28
  * `DS_CONFIG.chart.hoverDelayMs`. */
29
29
  readonly highlighted: _angular_core.ModelSignal<string | null>;
30
- private readonly dwell;
31
- constructor();
32
- protected onItemEnter(id: string, event: PointerEvent): void;
33
- protected onItemLeave(): void;
30
+ protected readonly highlight: {
31
+ enter(item: string, event: Event): void;
32
+ leave(): void;
33
+ };
34
34
  protected isHidden(id: string): boolean;
35
35
  protected toggle(id: string): void;
36
36
  /** Radio group name; unique per legend. */
@@ -1,7 +1,8 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { TemplateRef, Signal, InjectionToken } from '@angular/core';
2
+ import { TemplateRef, Signal, InjectionToken, OnChanges, SimpleChanges } from '@angular/core';
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
4
  import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-design-system/core';
5
+ import { ChartDataTable } from '@ids-group-ltd/ids-design-system/core';
5
6
 
6
7
  /** Which mark a chart's tooltip answers for. `'item'` is the mark under the pointer;
7
8
  * `'axis'` is every series at the category under the pointer (line charts). */
@@ -81,6 +82,12 @@ interface ChartActiveMark {
81
82
  /** Holds the activated mark, for any pointer type. Activating the already-pinned mark releases it. */
82
83
  pin(index: number, event: Event, anchor?: string | Element | null, mark?: Element): void;
83
84
  release(): void;
85
+ /** The pinned mark, looked up by its index, as a list keyed by that index: pinning another mark
86
+ * puts a new pin in the list, the same mark keeps its pin. Empty when nothing is pinned. */
87
+ pinnedAt<T>(lookup: (index: number) => T | null | undefined): Signal<readonly {
88
+ index: number;
89
+ value: T;
90
+ }[]>;
84
91
  }
85
92
  /**
86
93
  * The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
@@ -95,6 +102,24 @@ interface ChartActiveMark {
95
102
  * @internal
96
103
  */
97
104
  declare function chartActiveMark(lingerMs?: () => number, hoverDelayMs?: () => number): ChartActiveMark;
105
+ /** Whether `event` may take or drop a pin: a key or a touch always, a mouse only by its main button.
106
+ *
107
+ * @internal */
108
+ declare function isPrimaryPress(event: Event): boolean;
109
+
110
+ /**
111
+ * Adds `placed` to its host two frames after the host enters the DOM. A chart element that glides
112
+ * between positions gates its `transition` on `.placed`: the browser can compute the host's style
113
+ * before its position binding lands, and an ungated transition then starts it at the origin.
114
+ * Two frames, because after one the bound position may still be unstyled.
115
+ *
116
+ * @internal
117
+ */
118
+ declare class ChartPlacedDirective {
119
+ constructor();
120
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartPlacedDirective, never>;
121
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartPlacedDirective, "[dsChartPlaced]", never, {}, {}, never, never, true, never>;
122
+ }
98
123
 
99
124
  /** Radius of the pin disc, in plot pixels.
100
125
  *
@@ -117,7 +142,7 @@ declare class ChartPinMarkerComponent {
117
142
  protected readonly glyphOffset: number;
118
143
  protected readonly glyph: SafeHtml;
119
144
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartPinMarkerComponent, never>;
120
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartPinMarkerComponent, "g[dsChartPinMarker]", never, {}, {}, never, never, true, never>;
145
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartPinMarkerComponent, "g[dsChartPinMarker]", never, {}, {}, never, never, true, [{ directive: typeof ChartPlacedDirective; inputs: {}; outputs: {}; }]>;
121
146
  }
122
147
 
123
148
  /**
@@ -171,6 +196,12 @@ declare class ChartSkeletonComponent {
171
196
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartSkeletonComponent, "ds-chart-skeleton", never, { "marks": { "alias": "marks"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": true; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": true; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": true; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": true; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
172
197
  }
173
198
 
199
+ /** How a mark with no placeholder arrives, and a placeholder with no mark leaves: from the
200
+ * baseline under it (`up`), from its inline start (`across`), or fading in place (`null`).
201
+ *
202
+ * @internal */
203
+ type ChartMorphGrowth = 'up' | 'across' | null;
204
+
174
205
  /**
175
206
  * Context of a chart's own `message` template: the text, and whether it reports an error.
176
207
  *
@@ -189,7 +220,7 @@ interface ChartStatesMessageContext {
189
220
  *
190
221
  * @internal
191
222
  */
192
- declare class ChartStatesComponent {
223
+ declare class ChartStatesComponent implements OnChanges {
193
224
  readonly unpin: _angular_core.InputSignalWithTransform<boolean, unknown>;
194
225
  readonly pinned: _angular_core.InputSignal<boolean>;
195
226
  readonly release: _angular_core.OutputEmitterRef<void>;
@@ -198,8 +229,8 @@ declare class ChartStatesComponent {
198
229
  readonly errorText: _angular_core.InputSignal<string>;
199
230
  /** Draws `skeleton` in place of `body`: there is nothing to draw yet. */
200
231
  readonly pending: _angular_core.InputSignal<boolean>;
201
- /** Holds the room of the chart's data-table disclosure under the skeleton. */
202
- readonly dataTable: _angular_core.InputSignal<boolean>;
232
+ /** Holds the room of the chart's data-table disclosure under the skeleton, open under `'visible'`. */
233
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable>;
203
234
  /** Whether the data-table placeholder shimmers, as the chart's own skeleton does. */
204
235
  readonly shimmer: _angular_core.InputSignal<boolean>;
205
236
  /** Keeps `body` on screen under a loading overlay bound to it, the caption left uncovered. */
@@ -212,9 +243,22 @@ declare class ChartStatesComponent {
212
243
  readonly body: _angular_core.InputSignal<TemplateRef<unknown>>;
213
244
  /** Replaces the default error and empty paragraph. */
214
245
  readonly message: _angular_core.InputSignal<TemplateRef<ChartStatesMessageContext> | null>;
246
+ /** How a mark the loading skeleton had no placeholder for arrives when the data lands. */
247
+ readonly morphGrowth: _angular_core.InputSignal<ChartMorphGrowth>;
248
+ protected readonly placeholderRows: unknown[];
249
+ private readonly morphingState;
250
+ /** Whether the loading skeleton is turning into the drawn chart; a chart animating its own marks
251
+ * starts them from the skeleton while it is. */
252
+ readonly morphing: _angular_core.Signal<boolean>;
253
+ private readonly host;
254
+ private readonly zone;
255
+ private readonly isBrowser;
256
+ private stopMorph;
257
+ constructor();
258
+ ngOnChanges(changes: SimpleChanges): void;
215
259
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartStatesComponent, never>;
216
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartStatesComponent, "figure[dsChartStates]", never, { "unpin": { "alias": "unpin"; "required": false; "isSignal": true; }; "pinned": { "alias": "pinned"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; "reloading": { "alias": "reloading"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "messageAxes": { "alias": "messageAxes"; "required": false; "isSignal": true; }; "skeleton": { "alias": "skeleton"; "required": true; "isSignal": true; }; "body": { "alias": "body"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; }, { "release": "release"; }, never, never, true, never>;
260
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartStatesComponent, "figure[dsChartStates]", never, { "unpin": { "alias": "unpin"; "required": false; "isSignal": true; }; "pinned": { "alias": "pinned"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "shimmer": { "alias": "shimmer"; "required": false; "isSignal": true; }; "reloading": { "alias": "reloading"; "required": false; "isSignal": true; }; "empty": { "alias": "empty"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "messageAxes": { "alias": "messageAxes"; "required": false; "isSignal": true; }; "skeleton": { "alias": "skeleton"; "required": true; "isSignal": true; }; "body": { "alias": "body"; "required": true; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "morphGrowth": { "alias": "morphGrowth"; "required": false; "isSignal": true; }; }, { "release": "release"; }, never, never, true, never>;
217
261
  }
218
262
 
219
- export { CHART_PIN_GAP, CHART_PIN_RADIUS, CHART_SKELETON_CATEGORY_BAND, CHART_UNPIN_DRAWN_BY_HOST, ChartPinMarkerComponent, ChartSkeletonComponent, ChartStatesComponent, ChartTooltipDirective, ChartUnpinComponent, chartActiveMark };
263
+ export { CHART_PIN_GAP, CHART_PIN_RADIUS, CHART_SKELETON_CATEGORY_BAND, CHART_UNPIN_DRAWN_BY_HOST, ChartPinMarkerComponent, ChartPlacedDirective, ChartSkeletonComponent, ChartStatesComponent, ChartTooltipDirective, ChartUnpinComponent, chartActiveMark, isPrimaryPress };
220
264
  export type { ChartActiveMark, ChartItemTooltipTrigger, ChartSkeletonMarks, ChartStatesMessageContext, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };