@ids-group-ltd/ids-design-system 1.1.1 → 1.1.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 (61) hide show
  1. package/CHANGELOG.md +114 -0
  2. package/agent/feedback/ds-empty-state.md +2 -1
  3. package/agent/feedback/ds-tree.md +3 -1
  4. package/agent/forms/ds-chat-input.md +3 -3
  5. package/agent/navigation/ds-splitter.md +1 -1
  6. package/components.md +9 -6
  7. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  8. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  9. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  10. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  11. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  12. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs +48 -6
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-chat.mjs.map +1 -1
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +2 -2
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +14 -7
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -2
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +9 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +47 -8
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +14 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  44. package/migrations/1.1.2.json +135 -0
  45. package/migrations/README.md +3 -1
  46. package/package.json +4 -1
  47. package/schematics/check-overrides/surface.json +10 -1
  48. package/stylelint/index.mjs +17 -3
  49. package/stylelint/known-tokens.mjs +139 -0
  50. package/stylelint/report.mjs +185 -0
  51. package/stylelint/tokens.mjs +160 -0
  52. package/stylelint/use-tokens.mjs +397 -0
  53. package/styles/_check-box.scss +2 -2
  54. package/styles/_tokens.scss +8 -0
  55. package/themes/_semantic.scss +9 -1
  56. package/themes/dark/_theme.scss +5 -1
  57. package/types/ids-group-ltd-ids-design-system-components-chat.d.ts +18 -2
  58. package/types/ids-group-ltd-ids-design-system-components-empty-state.d.ts +7 -2
  59. package/types/ids-group-ltd-ids-design-system-components-tree.d.ts +20 -2
  60. package/types/ids-group-ltd-ids-design-system-core.d.ts +19 -1
  61. package/types/ids-group-ltd-ids-design-system.d.ts +3 -3
@@ -0,0 +1,397 @@
1
+ // `ids-design-system/use-tokens`: reports a raw style value where the design system has a token for
2
+ // it, and names the token: the exact one when the value is on the scale, otherwise the nearest step,
3
+ // said as nearest.
4
+ import { createRequire } from 'node:module';
5
+ import { relative } from 'node:path';
6
+ import stylelint from 'stylelint';
7
+ import { normalizeColor, normalizeEase, tokens } from './tokens.mjs';
8
+
9
+ // Both ship with stylelint, so they resolve from it under any package manager.
10
+ const fromStylelint = createRequire(import.meta.resolve('stylelint'));
11
+ const valueParser = fromStylelint('postcss-value-parser');
12
+ const micromatch = fromStylelint('micromatch');
13
+
14
+ const {
15
+ createPlugin,
16
+ utils: { report, ruleMessages, validateOptions },
17
+ } = stylelint;
18
+
19
+ export const ruleName = 'ids-design-system/use-tokens';
20
+
21
+ const messages = ruleMessages(ruleName, {
22
+ exact: (category, prop, raw, suggestion) =>
23
+ `${category}: raw "${raw}" in ${prop}, use ${suggestion}`,
24
+ nearest: (category, prop, raw, suggestion, tokenValue) =>
25
+ `${category}: raw "${raw}" in ${prop} has no exact token, nearest ${suggestion} (${tokenValue})`,
26
+ none: (category, prop, raw) =>
27
+ `${category}: raw "${raw}" in ${prop} matches no design-system colour`,
28
+ });
29
+
30
+ export const CATEGORIES = [
31
+ [
32
+ 'radius',
33
+ /^border(-(top|bottom|start|end)-(left|right|start|end))?-radius$/,
34
+ ],
35
+ [
36
+ 'space',
37
+ /^(margin|padding|inset|scroll-margin|scroll-padding)(-.+)?$|^(grid-)?(row-|column-)?gap$/,
38
+ ],
39
+ ['font-size', /^font-size$/],
40
+ ['line-height', /^line-height$/],
41
+ ['font-weight', /^font-weight$/],
42
+ ['shadow', /^box-shadow$/],
43
+ ['z-index', /^z-index$/],
44
+ ['motion', /^(transition|animation)(-(duration|delay|timing-function))?$/],
45
+ ];
46
+ const CATEGORY_NAMES = ['color', ...CATEGORIES.map(([name]) => name)];
47
+
48
+ const ALWAYS_ALLOWED = new Set([
49
+ '0',
50
+ 'auto',
51
+ 'inherit',
52
+ 'initial',
53
+ 'unset',
54
+ 'revert',
55
+ 'revert-layer',
56
+ 'currentcolor',
57
+ 'transparent',
58
+ 'none',
59
+ 'normal',
60
+ '100%',
61
+ ]);
62
+ const MATH = new Set(['calc', 'min', 'max', 'clamp']);
63
+ const COLOR_FUNCTIONS = new Set(['rgb', 'rgba', 'hsl', 'hsla']);
64
+ const NAMED_COLORS = new Set([
65
+ 'white',
66
+ 'black',
67
+ 'red',
68
+ 'green',
69
+ 'blue',
70
+ 'gray',
71
+ 'grey',
72
+ 'silver',
73
+ 'orange',
74
+ 'yellow',
75
+ 'purple',
76
+ 'pink',
77
+ ]);
78
+ const EASE_KEYWORDS = {
79
+ ease: '--ease-standard',
80
+ 'ease-in-out': '--ease-standard',
81
+ 'ease-out': '--ease-decelerate',
82
+ 'ease-in': '--ease-accelerate',
83
+ };
84
+ const ROLE_PREFIX = [
85
+ [/^(color|caret-color|-webkit-text-fill-color)$/, ['--text-', '--icon-']],
86
+ [/^(fill|stroke)$/, ['--icon-', '--text-']],
87
+ [/^(border|outline|column-rule)/, ['--border-']],
88
+ [/^background/, ['--surface-', '--primary', '--secondary']],
89
+ ];
90
+
91
+ const variable = (name) => `var(${name})`;
92
+
93
+ // Exact when a token holds the number, otherwise the nearest non-zero step: a value that is not
94
+ // zero is never pointed at a zero token, and a tie goes to the smaller step.
95
+ const onScale = (list, number, format = (token) => token.value) => {
96
+ const hit = list.find((token) => token.number === number);
97
+ if (hit) return { kind: 'exact', token: hit.name };
98
+ const near = list
99
+ .filter((token) => token.number !== 0)
100
+ .sort((a, b) => a.number - b.number)
101
+ .reduce((best, token) =>
102
+ Math.abs(token.number - number) < Math.abs(best.number - number)
103
+ ? token
104
+ : best,
105
+ );
106
+ return { kind: 'nearest', token: near.name, tokenValue: format(near) };
107
+ };
108
+
109
+ const lengthInPx = ({ number, unit }) => {
110
+ const value = Math.abs(parseFloat(number));
111
+ if (unit === 'px') return value;
112
+ if (unit === 'rem') return value * 16;
113
+ return null;
114
+ };
115
+
116
+ const judgeWord = (category, word, inMath) => {
117
+ const lower = word.toLowerCase();
118
+ if (
119
+ ALWAYS_ALLOWED.has(lower) ||
120
+ lower.startsWith('$') ||
121
+ lower.startsWith('-$')
122
+ )
123
+ return null;
124
+ const parsed = valueParser.unit(word);
125
+
126
+ if (category === 'motion') {
127
+ if (EASE_KEYWORDS[lower])
128
+ return {
129
+ kind: 'nearest',
130
+ token: EASE_KEYWORDS[lower],
131
+ tokenValue: 'keyword',
132
+ };
133
+ if (!parsed || !/^m?s$/.test(parsed.unit)) return null;
134
+ const ms = parseFloat(parsed.number) * (parsed.unit === 's' ? 1000 : 1);
135
+ return ms === 0 ? null : onScale(tokens.duration, ms);
136
+ }
137
+ if (category === 'font-weight') {
138
+ const weight =
139
+ lower === 'bold'
140
+ ? 700
141
+ : parsed && parsed.unit === ''
142
+ ? +parsed.number
143
+ : null;
144
+ return weight === null ? null : onScale(tokens.fontWeight, weight);
145
+ }
146
+ if (!parsed) return null;
147
+ if (category === 'line-height')
148
+ return parsed.unit === ''
149
+ ? onScale(tokens.lineHeight, +parsed.number)
150
+ : null;
151
+ if (category === 'z-index') {
152
+ if (parsed.unit !== '' || inMath) return null;
153
+ const layer = +parsed.number;
154
+ const exact = tokens.layer.find((token) => token.number === layer);
155
+ if (exact) return { kind: 'exact', token: exact.name };
156
+ // A small or negative index orders siblings inside one stacking context; the layer scale is
157
+ // for what stacks across the page.
158
+ if (layer < 100) return null;
159
+ return onScale(tokens.layer, layer);
160
+ }
161
+ if (category === 'radius' && parsed.unit === '%')
162
+ return parsed.number === '50' && !inMath
163
+ ? { kind: 'exact', token: '--radius-pill' }
164
+ : null;
165
+ if (inMath && (parsed.unit === '' || parsed.unit === '%')) return null;
166
+ const px = lengthInPx(parsed);
167
+ if (px === null || px === 0) return null;
168
+ if (category === 'radius' && px >= 100)
169
+ return { kind: 'exact', token: '--radius-pill' };
170
+ const list = {
171
+ radius: tokens.radius,
172
+ space: tokens.space,
173
+ 'font-size': tokens.fontSize,
174
+ }[category];
175
+ const finding = onScale(list, px, (token) => `${token.number}px`);
176
+ return { ...finding, negative: parsed.number.startsWith('-') };
177
+ };
178
+
179
+ const judgeColor = (raw, prop) => {
180
+ const hex = normalizeColor(raw);
181
+ const match = hex && tokens.colorsByHex.get(hex);
182
+ if (!match) return { kind: 'none' };
183
+ if (!match.semantic.length)
184
+ return { kind: 'exact', token: match.palette[0], paletteOnly: true };
185
+ const prefixes =
186
+ ROLE_PREFIX.find(([pattern]) => pattern.test(prop))?.[1] ?? [];
187
+ const preferred = prefixes.flatMap((prefix) =>
188
+ match.semantic.filter((name) => name.startsWith(prefix)),
189
+ )[0];
190
+ return { kind: 'exact', token: preferred ?? match.semantic[0] };
191
+ };
192
+
193
+ // A layer drawn inset or with no blur is a ring or a hairline, a border by other means, so only the
194
+ // remaining layers are compared with the elevation scale.
195
+ const judgeShadow = (value) => {
196
+ const layers = [[]];
197
+ for (const node of valueParser(value).nodes) {
198
+ if (node.type === 'div' && node.value === ',') layers.push([]);
199
+ else if (node.type === 'word') layers.at(-1).push(node.value.toLowerCase());
200
+ }
201
+ const elevation = layers
202
+ .map((words) => ({
203
+ inset: words.includes('inset'),
204
+ lengths: words
205
+ .filter((word) => /^-?[\d.]+(px)?$/.test(word))
206
+ .map(parseFloat),
207
+ }))
208
+ .filter(
209
+ ({ inset, lengths }) => !inset && lengths.length >= 3 && lengths[2] > 0,
210
+ );
211
+ if (!elevation.length) return null;
212
+ const [, y, blur] = elevation[0].lengths;
213
+ const best = tokens.shadow.reduce((a, b) =>
214
+ Math.abs(b.blur - blur) < Math.abs(a.blur - blur) ? b : a,
215
+ );
216
+ return best.y === y && best.blur === blur
217
+ ? { kind: 'exact', token: best.name }
218
+ : { kind: 'nearest', token: best.name, tokenValue: 'nearest elevation' };
219
+ };
220
+
221
+ const suggestionOf = ({ token, negative, paletteOnly }) => {
222
+ if (!token) return undefined;
223
+ if (negative) return `calc(-1 * ${variable(token)})`;
224
+ return paletteOnly
225
+ ? `${variable(token)} (a palette step, no role token holds it)`
226
+ : variable(token);
227
+ };
228
+
229
+ const optionList = (value) =>
230
+ value === undefined || Array.isArray(value)
231
+ ? true
232
+ : typeof value === 'object' && value !== null;
233
+
234
+ const rule =
235
+ (primary, secondary = {}) =>
236
+ (root, result) => {
237
+ if (
238
+ !validateOptions(
239
+ result,
240
+ ruleName,
241
+ { actual: primary },
242
+ {
243
+ actual: secondary,
244
+ possible: {
245
+ allow: [(value) => typeof value === 'string' || optionList(value)],
246
+ categories: [
247
+ (value) =>
248
+ typeof value === 'object' &&
249
+ Object.entries(value).every(
250
+ ([name, setting]) =>
251
+ CATEGORY_NAMES.includes(name) &&
252
+ [true, false, 'warning', 'error'].includes(setting),
253
+ ),
254
+ ],
255
+ ignore: [(value) => typeof value === 'string'],
256
+ ignoreProperties: [(value) => typeof value === 'string'],
257
+ },
258
+ optional: true,
259
+ },
260
+ )
261
+ )
262
+ return;
263
+
264
+ const file = root.source?.input?.file;
265
+ if (
266
+ file &&
267
+ secondary.ignore?.length &&
268
+ micromatch.isMatch(
269
+ relative(process.cwd(), file).replaceAll('\\', '/'),
270
+ secondary.ignore,
271
+ )
272
+ )
273
+ return;
274
+
275
+ const allow = Array.isArray(secondary.allow)
276
+ ? { '*': secondary.allow }
277
+ : (secondary.allow ?? {});
278
+ const settings = { ...secondary.categories };
279
+ const enabled = (category) => settings[category] !== false;
280
+ const severityOf = (category) =>
281
+ typeof settings[category] === 'string' ? settings[category] : undefined;
282
+ const ignoredProperties = (secondary.ignoreProperties ?? []).map(
283
+ (pattern) => new RegExp(pattern),
284
+ );
285
+ const allowed = (category, prop, raw) =>
286
+ [allow['*'], allow[category], allow[prop]].some((list) =>
287
+ list?.includes(raw),
288
+ );
289
+
290
+ root.walkDecls((declaration) => {
291
+ const prop = declaration.prop.toLowerCase();
292
+ if (
293
+ prop.startsWith('$') ||
294
+ prop.startsWith('--') ||
295
+ declaration.value.includes('#{')
296
+ )
297
+ return;
298
+ if (ignoredProperties.some((pattern) => pattern.test(prop))) return;
299
+ const category = CATEGORIES.find(([, pattern]) =>
300
+ pattern.test(prop),
301
+ )?.[0];
302
+ const valueIndex =
303
+ declaration.prop.length + (declaration.raws.between ?? ':').length;
304
+
305
+ const emit = (finding, ofCategory, raw, index) => {
306
+ if (!finding || !enabled(ofCategory) || allowed(ofCategory, prop, raw))
307
+ return;
308
+ report({
309
+ ruleName,
310
+ result,
311
+ node: declaration,
312
+ index: valueIndex + index,
313
+ endIndex: valueIndex + index + raw.length,
314
+ severity: severityOf(ofCategory),
315
+ message: messages[finding.kind](
316
+ ofCategory,
317
+ prop,
318
+ raw,
319
+ suggestionOf(finding),
320
+ finding.tokenValue,
321
+ ),
322
+ });
323
+ };
324
+
325
+ if (category === 'shadow') {
326
+ if (
327
+ /\d+px/.test(declaration.value) &&
328
+ !/^\s*var\(/.test(declaration.value) &&
329
+ !declaration.value.includes('$')
330
+ )
331
+ emit(judgeShadow(declaration.value), 'shadow', declaration.value, 0);
332
+ return;
333
+ }
334
+
335
+ const visit = (nodes, inMath) => {
336
+ for (const node of nodes) {
337
+ if (node.type === 'function') {
338
+ const name = node.value.toLowerCase();
339
+ if (name === 'var' || name === 'env' || name === 'url') continue;
340
+ const raw = valueParser.stringify(node);
341
+ if (COLOR_FUNCTIONS.has(name)) {
342
+ if (!raw.includes('$') && !raw.includes('var('))
343
+ emit(judgeColor(raw, prop), 'color', raw, node.sourceIndex);
344
+ continue;
345
+ }
346
+ if (name === 'cubic-bezier') {
347
+ if (category === 'motion') {
348
+ const hit = tokens.ease.find(
349
+ (token) => token.normalized === normalizeEase(raw),
350
+ );
351
+ emit(
352
+ hit
353
+ ? { kind: 'exact', token: hit.name }
354
+ : {
355
+ kind: 'nearest',
356
+ token: '--ease-standard',
357
+ tokenValue: 'closest family',
358
+ },
359
+ 'motion',
360
+ raw,
361
+ node.sourceIndex,
362
+ );
363
+ }
364
+ continue;
365
+ }
366
+ visit(node.nodes, inMath || MATH.has(name));
367
+ continue;
368
+ }
369
+ if (node.type !== 'word') continue;
370
+ const word = node.value;
371
+ if (
372
+ /^#[0-9a-f]{3,8}$/i.test(word) ||
373
+ NAMED_COLORS.has(word.toLowerCase())
374
+ ) {
375
+ emit(judgeColor(word, prop), 'color', word, node.sourceIndex);
376
+ continue;
377
+ }
378
+ if (category)
379
+ emit(
380
+ judgeWord(category, word, inMath),
381
+ category,
382
+ word,
383
+ node.sourceIndex,
384
+ );
385
+ }
386
+ };
387
+ visit(valueParser(declaration.value).nodes, false);
388
+ });
389
+ };
390
+
391
+ rule.ruleName = ruleName;
392
+ rule.messages = messages;
393
+ rule.meta = {
394
+ url: 'https://www.npmjs.com/package/@ids-group-ltd/ids-design-system',
395
+ };
396
+
397
+ export default createPlugin(ruleName, rule);
@@ -5,7 +5,7 @@
5
5
  // override (error, warning) and pin the resting colour.
6
6
  @mixin resolvers {
7
7
  --_checkbox-bg-color: var(--ds-checkbox-bg-color, var(--surface-default));
8
- --_checkbox-border-color: var(--ds-checkbox-border-color, var(--border-strong));
8
+ --_checkbox-border-color: var(--ds-checkbox-border-color, var(--border-field));
9
9
  --_checkbox-hover-border-color: var(--ds-checkbox-hover-border-color, var(--accent));
10
10
  --_checkbox-selected-bg-color: var(--ds-checkbox-selected-bg-color, var(--accent));
11
11
  --_checkbox-selected-border-color: var(--ds-checkbox-selected-border-color, var(--accent));
@@ -20,7 +20,7 @@
20
20
  width: var(--_checkbox-glyph, var(--check-size));
21
21
  height: var(--_checkbox-glyph, var(--check-size));
22
22
  border: var(--check-bw) solid
23
- var(--_checkbox-border-color, var(--ds-checkbox-border-color, var(--border-strong)));
23
+ var(--_checkbox-border-color, var(--ds-checkbox-border-color, var(--border-field)));
24
24
  background: var(--_checkbox-bg-color, var(--ds-checkbox-bg-color, var(--surface-default)));
25
25
  cursor: pointer;
26
26
  display: inline-grid;
@@ -398,6 +398,7 @@
398
398
  --tooltip-border-color: var(--border-overlay);
399
399
 
400
400
  --popover-maxw: 320px;
401
+ --popover-pad: var(--space-3);
401
402
 
402
403
  --toast-minw: 320px;
403
404
  --toast-maxw: 480px;
@@ -529,6 +530,10 @@
529
530
  --table-cell-pad-x: var(--space-2);
530
531
  --table-cell-pad-y: var(--space-1);
531
532
  --table-head-pad-y: var(--space-1);
533
+ --tree-row-pad-y: var(--space-1);
534
+ --tree-row-pad-x: var(--space-2);
535
+ --tree-indent: var(--space-4);
536
+ --popover-pad: var(--space-2);
532
537
 
533
538
  /* One rung only: a card's frame reads as lost padding before its cells do (24 to 16, cells 16 to 8). */
534
539
  --ds-surface-padding: var(--space-4);
@@ -545,6 +550,9 @@
545
550
  --status-dot-size: 6px;
546
551
  --sidenav-w: 220px;
547
552
  --segmented-btn-h: 24px;
553
+ --tree-row-pad-y: var(--space-1);
554
+ --tree-row-pad-x: var(--space-2);
555
+ --tree-indent: var(--space-4);
548
556
  }
549
557
  [data-density="cozy"] {
550
558
  --hit-cozy: 40px;
@@ -39,8 +39,16 @@
39
39
 
40
40
  --border-default: var(--neutral-200);
41
41
  --border-strong: var(--neutral-300);
42
- --border-field: var(--neutral-500);
42
+ /* Every field and control boundary: at least 3:1 against the page, a card, an overlay and their
43
+ secondary and muted fills. Lowest pair --surface-muted: 3.62:1 on the default neutrals, 3.02:1
44
+ under data-neutrals="brand" at --primary-h 60 (measured 2026-11-09). */
45
+ --border-field: color-mix(in srgb, var(--neutral-500) 86%, var(--neutral-400));
43
46
  --border-field-hover: var(--neutral-600);
47
+ /* Selected segment inside a ds-segmented track, which draws no border: the fill is the boundary, at
48
+ least 3:1 against the track (4.98:1, measured 2026-11-09). Declared with the theme, so a ds-color
49
+ zone does not recolour it. */
50
+ --segmented-selected: var(--accent);
51
+ --segmented-selected-on: var(--accent-on);
44
52
  --border-overlay: var(--border-default);
45
53
  --border-subtitle: var(--neutral-150);
46
54
  --border-divider: var(--neutral-150);
@@ -37,8 +37,12 @@
37
37
  --surface-overlay-raised-tint: color-mix(in srgb, var(--primary) 30%, var(--surface-overlay-raised));
38
38
  --accent-strong-overlay: hsl(from var(--primary) h 90% 80%);
39
39
  --border-overlay: var(--border-strong);
40
- --border-field: var(--neutral-400);
40
+ // At least 3:1 on every surface; lowest pair --surface-overlay-raised-muted, 3.03:1 (measured 2026-11-09).
41
+ --border-field: color-mix(in srgb, var(--neutral-500) 80%, var(--neutral-400));
41
42
  --border-field-hover: var(--neutral-500);
43
+ // --accent is 2.86:1 against the dark track; this fill is 7.45:1 (measured 2026-11-09).
44
+ --segmented-selected: var(--accent-strong-overlay);
45
+ --segmented-selected-on: var(--surface-default);
42
46
  --text-tertiary-overlay: var(--neutral-700);
43
47
 
44
48
  --surface-tint: hsl(from var(--primary) h 45% 16%);
@@ -281,6 +281,7 @@ declare class ChatStepComponent {
281
281
  }
282
282
 
283
283
  type ChatInputLayout = 'status-bar' | 'status-above' | 'split' | 'send-outside' | 'toolbar';
284
+ type ChatInputBusyAction = 'stop' | 'queue';
284
285
 
285
286
  /**
286
287
  * Message box for a chat or an instruction: an auto-growing text area with chips above it, actions
@@ -309,6 +310,10 @@ declare class ChatInputComponent {
309
310
  /** While `busy`, the default send button becomes Stop: a square inside a turning ring that emits
310
311
  * `stopRequested`. */
311
312
  readonly stoppable: _angular_core.InputSignalWithTransform<boolean, unknown>;
313
+ /** What the default buttons offer while `busy` once text is typed. `'stop'`: the send button stays
314
+ * Stop (or the spinner). `'queue'`: Redirect, Stop (with `stoppable`) and Queue, left to right;
315
+ * Queue is the main button and Enter queues. With no text it is Stop again. */
316
+ readonly busyAction: _angular_core.InputSignal<ChatInputBusyAction>;
312
317
  /** The current step while `busy`, such as "Rebuilding"; where it shows follows `layout`. */
313
318
  readonly busyLabel: _angular_core.InputSignal<string>;
314
319
  /** Where the buttons and the step text sit. `'status-bar'`: buttons inside, the step text in the
@@ -322,6 +327,10 @@ declare class ChatInputComponent {
322
327
  readonly submitted: _angular_core.OutputEmitterRef<string>;
323
328
  /** The Stop button was pressed; fires only while `busy`, `stoppable` and not `disabled`. */
324
329
  readonly stopRequested: _angular_core.OutputEmitterRef<void>;
330
+ /** The trimmed text, on Enter or the Queue button; fires only while the Queue button shows. */
331
+ readonly queued: _angular_core.OutputEmitterRef<string>;
332
+ /** The trimmed text, on the Redirect button; fires only while the Queue button shows. */
333
+ readonly redirected: _angular_core.OutputEmitterRef<string>;
325
334
  /** Image files pasted into the text area. The paste inserts no text when it carries images. */
326
335
  readonly filesPasted: _angular_core.OutputEmitterRef<File[]>;
327
336
  /** True when Enter or the send button would submit; bind it in a `[send]` slot. */
@@ -330,18 +339,25 @@ declare class ChatInputComponent {
330
339
  protected readonly textareaLabel: _angular_core.Signal<string>;
331
340
  protected readonly sendLabel: _angular_core.Signal<string>;
332
341
  protected readonly stopLabel: _angular_core.Signal<string>;
342
+ protected readonly queueLabel: _angular_core.Signal<string>;
343
+ protected readonly redirectLabel: _angular_core.Signal<string>;
344
+ protected readonly queueShown: _angular_core.Signal<boolean>;
333
345
  protected readonly stopShown: _angular_core.Signal<boolean>;
346
+ protected readonly mainLabel: _angular_core.Signal<string>;
347
+ protected readonly mainIcon: _angular_core.Signal<"stop" | "list-plus" | "arrowUp">;
334
348
  protected readonly statusAbove: _angular_core.Signal<boolean>;
335
349
  protected readonly statusText: _angular_core.Signal<string>;
336
350
  /** Emits `submitted` when `canSubmit`; for a send button rendered in the `[send]` slot. */
337
351
  submit(): void;
352
+ private queue;
353
+ protected redirect(): void;
338
354
  protected onSendPressed(): void;
339
355
  /** Moves keyboard focus to the text area. */
340
356
  focus(options?: FocusOptions): void;
341
357
  protected onKeydown(event: KeyboardEvent): void;
342
358
  protected onPaste(event: ClipboardEvent): void;
343
359
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChatInputComponent, never>;
344
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatInputComponent, "ds-chat-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "stoppable": { "alias": "stoppable"; "required": false; "isSignal": true; }; "busyLabel": { "alias": "busyLabel"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; "stopRequested": "stopRequested"; "filesPasted": "filesPasted"; }, never, ["[attachments]", "[chips]", "[actions]", "[send]"], true, never>;
360
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChatInputComponent, "ds-chat-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "stoppable": { "alias": "stoppable"; "required": false; "isSignal": true; }; "busyAction": { "alias": "busyAction"; "required": false; "isSignal": true; }; "busyLabel": { "alias": "busyLabel"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; "stopRequested": "stopRequested"; "queued": "queued"; "redirected": "redirected"; "filesPasted": "filesPasted"; }, never, ["[attachments]", "[chips]", "[actions]", "[send]"], true, never>;
345
361
  }
346
362
 
347
363
  type AttachmentKind = 'pdf' | 'doc' | 'image' | 'file';
@@ -374,4 +390,4 @@ declare class AttachmentComponent {
374
390
  }
375
391
 
376
392
  export { AttachmentComponent, ChatAttachmentComponent, ChatInputComponent, ChatMessageComponent, ChatStepComponent, ChatStepsComponent, ChatThreadComponent };
377
- export type { AttachmentKind, ChatInputLayout, ChatMessageRole, ChatMessageStatus, ChatMessageTone, ChatStepStatus, ChatStepsEnter };
393
+ export type { AttachmentKind, ChatInputBusyAction, ChatInputLayout, ChatMessageRole, ChatMessageStatus, ChatMessageTone, ChatStepStatus, ChatStepsEnter };
@@ -3,6 +3,7 @@ import { IconName } from '@ids-group-ltd/ids-design-system/core';
3
3
 
4
4
  type EmptyStateVariant = 'none' | 'loading' | 'error' | 'locked' | 'success';
5
5
  type EmptyStateTitleOverflow = 'wrap' | 'clip';
6
+ type EmptyStateAppearance = 'tile' | 'plain';
6
7
 
7
8
  declare class EmptyStateComponent {
8
9
  /** Drives the default icon; `'loading'` shows a loading overlay. */
@@ -16,11 +17,15 @@ declare class EmptyStateComponent {
16
17
  readonly titleOverflow: _angular_core.InputSignal<EmptyStateTitleOverflow>;
17
18
  /** Optional supporting text below the title. */
18
19
  readonly body: _angular_core.InputSignal<string>;
20
+ /** `'tile'` draws the icon on a tinted tile under a bold title; `'plain'` draws a 32px icon with
21
+ * no tile, a semibold `--font-size-l` title and the body in `--text-tertiary`, for an empty
22
+ * section inside a page rather than an empty page. */
23
+ readonly appearance: _angular_core.InputSignal<EmptyStateAppearance>;
19
24
  protected readonly classes: _angular_core.Signal<string>;
20
25
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
21
26
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<EmptyStateComponent, never>;
22
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "ds-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleOverflow": { "alias": "titleOverflow"; "required": false; "isSignal": true; }; "body": { "alias": "body"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
27
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "ds-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleOverflow": { "alias": "titleOverflow"; "required": false; "isSignal": true; }; "body": { "alias": "body"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
23
28
  }
24
29
 
25
30
  export { EmptyStateComponent };
26
- export type { EmptyStateTitleOverflow, EmptyStateVariant };
31
+ export type { EmptyStateAppearance, EmptyStateTitleOverflow, EmptyStateVariant };
@@ -10,6 +10,7 @@ interface TreeNode {
10
10
  disabled?: boolean;
11
11
  }
12
12
  type TreeSelection = 'single' | 'multiple';
13
+ type TreeToggleOn = 'row' | 'caret' | 'doubleClick';
13
14
 
14
15
  /** What a `dsTreeLabel` template is handed: the row's node, its nesting level (`0` for a root
15
16
  * node) and whether the row is selected and disabled. */
@@ -81,6 +82,7 @@ interface VisibleNode {
81
82
  }
82
83
  declare class TreeComponent {
83
84
  private readonly host;
85
+ private readonly intl;
84
86
  /** Root-level nodes; nest via `children`. */
85
87
  readonly nodes: _angular_core.InputSignal<readonly TreeNode[]>;
86
88
  /** Ids of the expanded nodes. */
@@ -91,6 +93,14 @@ declare class TreeComponent {
91
93
  readonly selectedId: _angular_core.ModelSignal<string | null>;
92
94
  /** Ids of the selected nodes, in `'multiple'` selection. */
93
95
  readonly selectedIds: _angular_core.ModelSignal<string[]>;
96
+ /** What expands and collapses a parent. `'row'`: activating the row (click, Enter, Space) selects
97
+ * it and toggles it. `'caret'`: activating the row only selects it, and the chevron is a button of
98
+ * its own that toggles. `'doubleClick'`: a click selects, a double click toggles. In every mode
99
+ * ArrowRight expands and ArrowLeft collapses the focused row. */
100
+ readonly toggleOn: _angular_core.InputSignal<TreeToggleOn>;
101
+ /** Rows slide open and shut and the chevron turns when a parent expands or collapses. Off under
102
+ * `prefers-reduced-motion: reduce`. */
103
+ readonly animate: _angular_core.InputSignalWithTransform<boolean, unknown>;
94
104
  /** Fires with the node when a row is selected (click or Enter/Space), not when one is deselected. */
95
105
  readonly nodeSelected: _angular_core.OutputEmitterRef<TreeNode>;
96
106
  /** Fires with the node under the pointer or newly focused, and `null` when the pointer leaves the tree. */
@@ -100,7 +110,13 @@ declare class TreeComponent {
100
110
  protected readonly idPrefix: string;
101
111
  private readonly activeId;
102
112
  private hoveredId;
113
+ private readonly rendered;
114
+ protected readonly motion: _angular_core.Signal<boolean>;
103
115
  protected readonly multiple: _angular_core.Signal<boolean>;
116
+ protected readonly labels: _angular_core.Signal<{
117
+ expand: (label: string) => string;
118
+ collapse: (label: string) => string;
119
+ }>;
104
120
  protected readonly visibleNodes: _angular_core.Signal<VisibleNode[]>;
105
121
  protected readonly effectiveActiveId: _angular_core.Signal<string>;
106
122
  constructor();
@@ -108,6 +124,8 @@ declare class TreeComponent {
108
124
  protected isSelected(id: string): boolean;
109
125
  protected isActive(id: string): boolean;
110
126
  protected onRowClick(entry: VisibleNode, event: MouseEvent): void;
127
+ protected onRowDoubleClick(entry: VisibleNode, event: MouseEvent): void;
128
+ protected onCaretClick(entry: VisibleNode, event: MouseEvent): void;
111
129
  protected onRowFocus(entry: VisibleNode): void;
112
130
  protected hover(node: TreeNode | null): void;
113
131
  protected onKeydown(event: KeyboardEvent): void;
@@ -119,8 +137,8 @@ declare class TreeComponent {
119
137
  private fromTrailing;
120
138
  private parkTrailingTabStops;
121
139
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeComponent, never>;
122
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeComponent, "ds-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectedId": "selectedIdChange"; "selectedIds": "selectedIdsChange"; "nodeSelected": "nodeSelected"; "nodeHover": "nodeHover"; }, ["label", "trailing"], never, true, never>;
140
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeComponent, "ds-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selection": { "alias": "selection"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "toggleOn": { "alias": "toggleOn"; "required": false; "isSignal": true; }; "animate": { "alias": "animate"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectedId": "selectedIdChange"; "selectedIds": "selectedIdsChange"; "nodeSelected": "nodeSelected"; "nodeHover": "nodeHover"; }, ["label", "trailing"], never, true, never>;
123
141
  }
124
142
 
125
143
  export { TreeComponent, TreeLabelDirective, TreeTrailingDirective };
126
- export type { TreeLabelContext, TreeNode, TreeSelection, TreeTrailingContext };
144
+ export type { TreeLabelContext, TreeNode, TreeSelection, TreeToggleOn, TreeTrailingContext };