@ids-group-ltd/ids-design-system 0.10.1 → 0.10.3

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.
@@ -1,5 +1,5 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, OnDestroy } from '@angular/core';
2
+ import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, WritableSignal, OnDestroy } from '@angular/core';
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
4
  import { Observable } from 'rxjs';
5
5
  import { ControlValueAccessor } from '@angular/forms';
@@ -122,6 +122,24 @@ interface DsConfig {
122
122
  * on the error itself always wins, so one shared map here plus a per-case
123
123
  * override at the validator covers both. Unmapped kinds warn in dev. */
124
124
  errorMessages?: Record<string, string>;
125
+ /** Leading glyph on a field's message line, per state. Defaults carry one for
126
+ * the three states that mean something — `error`, `warn`, `success` — and NONE
127
+ * for `hint`, which is the resting text rather than a state: a form where every
128
+ * field carries an info circle reads as noise. Each key is independent, so
129
+ * `{ warning: false, hint: 'info' }` turns one off and the other on. A glyph name
130
+ * replaces the default; `false` removes it. `stateIcons: false` removes all four,
131
+ * which is the one-line way to turn the glyphs off entirely.
132
+ *
133
+ * WHY a glyph at all: colour alone carried error / warning / success, and in the
134
+ * light theme warning (#8A7400) and success (#156822) differ by hue and nothing
135
+ * else — which WCAG 1.4.1 forbids a state from resting on. */
136
+ stateIcons?: false | {
137
+ error?: IconName | false;
138
+ warning?: IconName | false;
139
+ success?: IconName | false;
140
+ /** The `default` state — the hint line. Off unless set. */
141
+ hint?: IconName | false;
142
+ };
125
143
  };
126
144
  breadcrumbs?: {
127
145
  separator?: IconName;
@@ -207,6 +225,10 @@ declare const DS_CONFIG: InjectionToken<DsConfig>;
207
225
  * A nested call MERGES with the config above it, section by section, so
208
226
  * scoping one flag cannot silently drop unrelated app-level settings. Only the
209
227
  * keys you name are replaced.
228
+ *
229
+ * ONE call per injector, though: two in the SAME `providers` array both resolve
230
+ * their parent with `skipSelf`, so the later one wins and the earlier is silently
231
+ * lost. Merging happens across injector levels, not within one array.
210
232
  */
211
233
  declare function provideDsConfig(config: DsConfig): Provider;
212
234
  /**
@@ -322,7 +344,7 @@ declare class IconComponent {
322
344
  /** Pixel size of the square glyph. Unset falls back to `DS_CONFIG.icon.size`,
323
345
  * then `16`. */
324
346
  readonly size: _angular_core.InputSignalWithTransform<number | null, unknown>;
325
- protected readonly sizeResolved: _angular_core.Signal<number>;
347
+ readonly sizeResolved: _angular_core.Signal<number>;
326
348
  readonly stroke: _angular_core.InputSignal<number>;
327
349
  /** When set, the icon is exposed to assistive tech as an image with this
328
350
  * name; otherwise it is decorative and hidden (`aria-hidden`). */
@@ -409,7 +431,7 @@ declare class ButtonComponent {
409
431
  /** Button height — sm/md/lg.
410
432
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
411
433
  readonly size: _angular_core.InputSignal<DsSize | null>;
412
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
434
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
413
435
  /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
414
436
  readonly type: _angular_core.InputSignal<ButtonType>;
415
437
  /** Disables the button and blocks `pressed`. */
@@ -486,7 +508,7 @@ declare class IconButtonComponent {
486
508
  /** Button size — sm/md/lg, matches the field/button height scale.
487
509
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
488
510
  readonly size: _angular_core.InputSignal<DsSize | null>;
489
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
511
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
490
512
  /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
491
513
  readonly type: _angular_core.InputSignal<IconButtonType>;
492
514
  /** Disables the button and blocks `pressed`. */
@@ -512,10 +534,10 @@ declare class IconButtonComponent {
512
534
  declare class BadgeComponent {
513
535
  /** Consumer-defined status key; colours are wired via styles/status. Unset → neutral. */
514
536
  readonly status: _angular_core.InputSignal<string | undefined>;
515
- /** Shows a status dot; only rendered when `count` is unset. */
516
- /** Leading status dot. Unset falls back to `DS_CONFIG.badge.withDot`, then `false`. */
537
+ /** Leading status dot, rendered only while `count` is unset — a count replaces the
538
+ * badge's whole content. Unset falls back to `DS_CONFIG.badge.withDot`, then `false`. */
517
539
  readonly withDot: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
518
- protected readonly withDotResolved: _angular_core.Signal<boolean>;
540
+ readonly withDotResolved: _angular_core.Signal<boolean>;
519
541
  /** Solid accent fill instead of the default subtle background. */
520
542
  readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
521
543
  /** Numeric count to display; overrides projected content when set. */
@@ -860,9 +882,9 @@ declare class AuthLayoutComponent {
860
882
  readonly tagline: _angular_core.InputSignal<string | null>;
861
883
  /** The template must read THIS, never the input beside it — that one is null
862
884
  * until bound, and the config default lives here. */
863
- protected readonly brandName: _angular_core.Signal<string>;
864
- protected readonly letterGlyph: _angular_core.Signal<string>;
865
- protected readonly taglineText: _angular_core.Signal<string>;
885
+ readonly brandName: _angular_core.Signal<string>;
886
+ readonly letterGlyph: _angular_core.Signal<string>;
887
+ readonly taglineText: _angular_core.Signal<string>;
866
888
  /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */
867
889
  readonly cardElevation: _angular_core.InputSignal<CardElevation>;
868
890
  /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
@@ -1031,8 +1053,8 @@ declare class AvatarComponent {
1031
1053
  /** Fallback text shown when there's no `imageUrl`. Wins over anything derived
1032
1054
  * from `name`, so a caller that already has the letters keeps passing them. */
1033
1055
  readonly initials: _angular_core.InputSignal<string>;
1034
- /** The person or thing this avatar stands for. One binding covers both jobs the
1035
- * caller used to wire by hand: the initials, and the seed the tint hashes.
1056
+ /** The person or thing this avatar stands for — one binding drives both the
1057
+ * initials and the seed the tint hashes.
1036
1058
  *
1037
1059
  * The tint keys on the NAME, never on the initials — two letters collide
1038
1060
  * wholesale, so every Alice Brown and Adam Bell would share one colour. */
@@ -1135,8 +1157,8 @@ declare class CardComponent {
1135
1157
  readonly padding: _angular_core.InputSignal<CardPadding | null>;
1136
1158
  /** Fires the click event when `elevation` is `interactive`. */
1137
1159
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
1138
- protected readonly elevationResolved: _angular_core.Signal<CardElevation>;
1139
- protected readonly paddingResolved: _angular_core.Signal<CardPadding | null>;
1160
+ readonly elevationResolved: _angular_core.Signal<CardElevation>;
1161
+ readonly paddingResolved: _angular_core.Signal<CardPadding | null>;
1140
1162
  protected readonly interactive: _angular_core.Signal<boolean>;
1141
1163
  protected readonly classes: _angular_core.Signal<string>;
1142
1164
  protected onClick(event: MouseEvent): void;
@@ -1157,8 +1179,14 @@ declare class StatComponent {
1157
1179
  *
1158
1180
  * Namespaced, unlike `[delta]`: twenty components in this library have a
1159
1181
  * `value` input, so a bare `value` attribute used to slot one of them in
1160
- * would also set that input to the empty string. */
1161
- readonly value: _angular_core.InputSignal<string | number>;
1182
+ * would also set that input to the empty string.
1183
+ *
1184
+ * Takes `null` so `[value]="count | number"` typechecks: Angular's own
1185
+ * `number`/`date`/`percent` pipes are typed `string | null`, and without the null the
1186
+ * idiomatic form fails `strictTemplates` and pushes consumers to `toLocaleString()` in
1187
+ * the template — which hardcodes a locale instead of reading LOCALE_ID. Renders as
1188
+ * nothing, like the empty default. */
1189
+ readonly value: _angular_core.InputSignal<string | number | null>;
1162
1190
  /** Change amount; sign drives the up/down arrow and color. */
1163
1191
  readonly delta: _angular_core.InputSignal<number | null>;
1164
1192
  /** Suffix appended after the delta's magnitude, e.g. "vs last month". */
@@ -1360,9 +1388,13 @@ declare abstract class DsFieldBase {
1360
1388
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1361
1389
  * for a form that shows validation messages. */
1362
1390
  readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1363
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1391
+ /** Glyph on the message line, overriding what the state resolves to. Unset
1392
+ * follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph on this field
1393
+ * alone. */
1394
+ readonly messageIcon: _angular_core.InputSignal<false | IconName | null>;
1395
+ readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1364
1396
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsFieldBase, never>;
1365
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1397
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "messageIcon": { "alias": "messageIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1366
1398
  }
1367
1399
 
1368
1400
  /**
@@ -1392,14 +1424,10 @@ declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements
1392
1424
  * nowhere. A control with a more precise target overrides this.
1393
1425
  */
1394
1426
  focus(options?: FocusOptions): void;
1427
+ private readonly bridge;
1395
1428
  /** Driven by the forms API via `setDisabledState`. */
1396
- protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1397
- protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
1398
- private onChange;
1399
- private onTouched;
1400
- private synced;
1401
- private hasSynced;
1402
- constructor();
1429
+ protected readonly formDisabled: WritableSignal<boolean>;
1430
+ protected readonly touchedSelf: WritableSignal<boolean>;
1403
1431
  /** Call from a blur handler so the control reports `ng-touched`. */
1404
1432
  protected markTouched(): void;
1405
1433
  writeValue(value: T): void;
@@ -1430,8 +1458,8 @@ declare abstract class DsBooleanControlValueAccessor extends DsFieldBase impleme
1430
1458
  */
1431
1459
  focus(options?: FocusOptions): void;
1432
1460
  /** Driven by the forms API via `setDisabledState`. */
1433
- protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1434
- protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
1461
+ protected readonly formDisabled: WritableSignal<boolean>;
1462
+ protected readonly touchedSelf: WritableSignal<boolean>;
1435
1463
  private onChange;
1436
1464
  private onTouched;
1437
1465
  private synced;
@@ -1461,7 +1489,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1461
1489
  /** Field height — sm/md/lg.
1462
1490
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1463
1491
  readonly size: _angular_core.InputSignal<DsSize | null>;
1464
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1492
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1465
1493
  /** Label shown above the field. */
1466
1494
  readonly label: _angular_core.InputSignal<string>;
1467
1495
  /** Placeholder shown when empty. */
@@ -1572,7 +1600,7 @@ declare class NumberStepperComponent {
1572
1600
  /** Control height — sm/md/lg.
1573
1601
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1574
1602
  readonly size: _angular_core.InputSignal<DsSize | null>;
1575
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1603
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1576
1604
  /** Disables the stepper and blocks all interaction. */
1577
1605
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1578
1606
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -1596,7 +1624,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1596
1624
  /** Field height — sm/md/lg.
1597
1625
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1598
1626
  readonly size: _angular_core.InputSignal<DsSize | null>;
1599
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1627
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1600
1628
  /** Label shown above the field. */
1601
1629
  readonly label: _angular_core.InputSignal<string>;
1602
1630
  /** Placeholder shown when empty. */
@@ -1664,10 +1692,16 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1664
1692
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1665
1693
  }
1666
1694
 
1667
- declare class SearchComponent {
1695
+ declare class SearchComponent implements ControlValueAccessor {
1668
1696
  /** Segment of a ds-field-group: the group owns the border, radius and focus
1669
1697
  * ring, so .in-group strips this control back to its bare contents. */
1670
1698
  protected readonly inGroup: boolean;
1699
+ private readonly bridge;
1700
+ /** Hides the control, as every other DS control does. Inline `display`, not the
1701
+ * attribute: the host sets its own, which the weaker UA rule would lose to. */
1702
+ readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
1703
+ /** Driven by the forms API — OR'd into `isDisabled` like every other control. */
1704
+ protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1671
1705
  /** Search text, two-way bound. */
1672
1706
  readonly value: _angular_core.ModelSignal<string>;
1673
1707
  /** Placeholder shown when empty. */
@@ -1680,11 +1714,14 @@ declare class SearchComponent {
1680
1714
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1681
1715
  /** Accessible name for the input (placeholder is not a reliable label). */
1682
1716
  readonly ariaLabel: _angular_core.InputSignal<string>;
1717
+ /** Disables the input and the clear button. */
1718
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1719
+ readonly isDisabled: _angular_core.Signal<boolean>;
1683
1720
  /** Control height. `md` (default) keeps the 36px search-row height; `sm` (32px)
1684
1721
  * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch.
1685
1722
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1686
1723
  readonly size: _angular_core.InputSignal<DsSize | null>;
1687
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1724
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1688
1725
  /** Fires with the current value on Enter. */
1689
1726
  readonly submitted: _angular_core.OutputEmitterRef<string>;
1690
1727
  /** Milliseconds to hold each keystroke back before `value` updates — 0 (default)
@@ -1711,13 +1748,25 @@ declare class SearchComponent {
1711
1748
  focus(options?: FocusOptions): void;
1712
1749
  protected onText(next: string): void;
1713
1750
  protected onSubmit(): void;
1714
- protected clear(): void;
1751
+ /** Empties the field, DROPS any armed keystroke, and publishes '' immediately.
1752
+ * Public for the same reason `focus()` is: a host-owned Clear button outside the
1753
+ * control needs it. Writing `''` into `value` is not equivalent — the effect
1754
+ * that watches `value` only cancels the timer when the incoming text DIFFERS
1755
+ * from what this control last pushed, so clearing an already-empty-looking field
1756
+ * mid-debounce left the keystroke armed. */
1757
+ clear(): void;
1715
1758
  /** So Enter searches what the reader can see, not what the timer last let past. */
1716
1759
  private flush;
1717
1760
  private push;
1761
+ writeValue(next: string): void;
1762
+ registerOnChange(fn: (next: string) => void): void;
1763
+ registerOnTouched(fn: () => void): void;
1764
+ setDisabledState(isDisabled: boolean): void;
1765
+ /** Reported to the forms API on blur, so a search inside a form goes `ng-touched`. */
1766
+ protected markTouched(): void;
1718
1767
  private cancel;
1719
1768
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
1720
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
1769
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
1721
1770
  }
1722
1771
 
1723
1772
  /**
@@ -1763,7 +1812,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1763
1812
  /** Trigger height — sm/md/lg.
1764
1813
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1765
1814
  readonly size: _angular_core.InputSignal<DsSize | null>;
1766
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1815
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1767
1816
  /** Label shown above the trigger. */
1768
1817
  readonly label: _angular_core.InputSignal<string>;
1769
1818
  /** Disables the trigger and blocks all interaction. */
@@ -1978,6 +2027,12 @@ interface TableColumn<T = unknown> {
1978
2027
  /** Let the user toggle the column in the header column picker — the picker
1979
2028
  * button appears once at least one column is hideable. */
1980
2029
  hideable?: boolean;
2030
+ /** Marks the cell whose TEXT tells the reader what the row opens, so it takes a link
2031
+ * colour and underline while the row is hovered. Only has an effect on a
2032
+ * `rowInteractive` table: on a passive one every hover treatment is suppressed on
2033
+ * purpose, so a tint cannot promise a click that does not happen. Style it with
2034
+ * `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`. */
2035
+ interactive?: boolean;
1981
2036
  /** Initial visibility: start hidden. The column picker (or a bound
1982
2037
  * `hiddenKeys` set) owns the state from then on; a hidden column stays
1983
2038
  * available to `filterable` matching and sorting. */
@@ -1997,6 +2052,17 @@ interface TableRowAction<T = unknown> {
1997
2052
  error?: boolean;
1998
2053
  /** Per-row predicate — return true to disable the item for that row. */
1999
2054
  disabled?: (row: T) => boolean;
2055
+ /** Per-row predicate — return true to leave the item OUT for that row. Use it
2056
+ * where the action does not apply rather than `disabled`, which greys an item
2057
+ * that is always there: a draft offers Edit + Launch and a live one Revert +
2058
+ * Delete, so greying leaves every row with a permanently dead half. When every
2059
+ * item of a row is hidden the kebab is not rendered at all, rather than opening
2060
+ * an empty menu. */
2061
+ hidden?: (row: T) => boolean;
2062
+ /** Why the item is disabled, shown as the item's second line. Only read when
2063
+ * `disabled` returns true for the row — a greyed item that does not say why is
2064
+ * the same dead control as a greyed button. */
2065
+ disabledReason?: string | ((row: T) => string);
2000
2066
  }
2001
2067
  interface TableRowActionEvent<T = unknown> {
2002
2068
  action: TableRowAction<T>;
@@ -2206,8 +2272,8 @@ declare class TableComponent<T extends object> {
2206
2272
  readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
2207
2273
  protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
2208
2274
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
2209
- protected readonly borderedResolved: _angular_core.Signal<boolean>;
2210
- protected readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2275
+ readonly borderedResolved: _angular_core.Signal<boolean>;
2276
+ readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2211
2277
  /** Pin the first data column (and the select column) on horizontal scroll. */
2212
2278
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
2213
2279
  /**
@@ -2288,9 +2354,9 @@ declare class TableComponent<T extends object> {
2288
2354
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
2289
2355
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
2290
2356
  /** The empty row is a CLAIM about the data — "there are none" — so it must not
2291
- * appear while the table is still asking. Only `skeleton` used to suppress it,
2292
- * and `overlay` is the mode a list uses on every read after the first, so a
2293
- * zero-row reload painted "No rows yet" under the spinner. */
2357
+ * appear while the table is still asking, in EITHER loading mode. `overlay` is
2358
+ * what a list uses on every read after the first, so suppressing only under
2359
+ * `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
2294
2360
  protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
2295
2361
  protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
2296
2362
  /** Columns in the user-controlled order — `columnOrder` first (dropping
@@ -2495,6 +2561,14 @@ declare class TableComponent<T extends object> {
2495
2561
  protected onRowMenuClick(row: T, event: Event): void;
2496
2562
  protected isMenuOpenFor(row: T): boolean;
2497
2563
  protected isActionDisabled(action: TableRowAction<T>): boolean;
2564
+ /** Items that apply to `row`. Called from the trigger's own gate as well as the
2565
+ * menu, so a row with nothing applicable shows no kebab instead of an empty one. */
2566
+ protected actionsFor(row: T): readonly TableRowAction<T>[];
2567
+ protected hasActionsFor(row: T): boolean;
2568
+ protected readonly visibleRowActions: _angular_core.Signal<readonly TableRowAction<T>[]>;
2569
+ /** Empty unless the item is actually disabled for this row: a reason on a live
2570
+ * item would read as a caveat on something that works. */
2571
+ protected actionReason(action: TableRowAction<T>): string;
2498
2572
  protected onRowAction(action: TableRowAction<T>): void;
2499
2573
  protected isExpanded(row: T): boolean;
2500
2574
  protected onToggleExpand(row: T, event: Event): void;
@@ -2713,7 +2787,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2713
2787
  /** Trigger height — sm/md/lg.
2714
2788
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
2715
2789
  readonly size: _angular_core.InputSignal<DsSize | null>;
2716
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2790
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
2717
2791
  /** Stretch the trigger to fill its container instead of hugging the mask
2718
2792
  * width — opt in when the field shares a grid/flex track with inputs. */
2719
2793
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2766,7 +2840,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2766
2840
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
2767
2841
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2768
2842
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2769
- protected readonly resolvedLocale: _angular_core.Signal<string>;
2843
+ readonly resolvedLocale: _angular_core.Signal<string>;
2770
2844
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
2771
2845
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
2772
2846
  /** Slot/literal layout for the current mode — single date or doubled range. */
@@ -3011,7 +3085,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3011
3085
  /** Trigger height — sm/md/lg.
3012
3086
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
3013
3087
  readonly size: _angular_core.InputSignal<DsSize | null>;
3014
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
3088
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
3015
3089
  /** Stretch the trigger to fill its container instead of hugging its content —
3016
3090
  * opt in when the field shares a grid/flex track with inputs. */
3017
3091
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -3045,13 +3119,17 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3045
3119
  protected readonly endTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
3046
3120
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
3047
3121
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
3122
+ /** Any of the three trigger boxes, not the host: a range renders two and a single
3123
+ * one renders one, while the host also carries the label and the message row —
3124
+ * clicking those has to dismiss the panel (MBP-225). */
3125
+ private insideATrigger;
3048
3126
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3049
3127
  protected readonly hintId: _angular_core.Signal<string | null>;
3050
3128
  private readonly fieldMessage;
3051
3129
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
3052
3130
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
3053
3131
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
3054
- protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
3132
+ readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
3055
3133
  protected readonly singleValue: _angular_core.Signal<string | null>;
3056
3134
  protected readonly rangeValue: _angular_core.Signal<TimeRangeValue>;
3057
3135
  protected readonly hasValue: _angular_core.Signal<boolean>;
@@ -3143,12 +3221,20 @@ declare class BreadcrumbsService {
3143
3221
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
3144
3222
  interface SidenavContract {
3145
3223
  readonly collapsed: () => boolean;
3224
+ /** Whether the active item draws its edge marker. Set once on the sidenav; an
3225
+ * item can still override it for itself. */
3226
+ readonly rail: () => boolean;
3146
3227
  }
3147
3228
  declare const SIDENAV: InjectionToken<SidenavContract>;
3148
3229
 
3149
3230
  declare class SidenavComponent implements SidenavContract {
3150
3231
  /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
3151
3232
  readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
3233
+ /** Whether the ACTIVE item draws its edge marker, for the whole sidenav. Off
3234
+ * leaves the active state on the fill and the label alone — check that is still
3235
+ * distinguishable before turning it off. An individual `ds-sidenav-item` can
3236
+ * override this with its own `rail`. */
3237
+ readonly rail: _angular_core.InputSignalWithTransform<boolean, unknown>;
3152
3238
  /** Brand text at the top of the rail (auto letter-mark + name). For a custom
3153
3239
  * logo image/SVG, project it into the `[brand]` slot instead. Unset falls back
3154
3240
  * to `DS_CONFIG.brand.name`. Each field resolves on its own, so `brand=""` drops
@@ -3160,8 +3246,8 @@ declare class SidenavComponent implements SidenavContract {
3160
3246
  readonly logoLetter: _angular_core.InputSignal<string | null>;
3161
3247
  /** The template must read THIS, never the input beside it — that one is null
3162
3248
  * until bound, and the config default lives here. */
3163
- protected readonly brandName: _angular_core.Signal<string>;
3164
- protected readonly letterGlyph: _angular_core.Signal<string>;
3249
+ readonly brandName: _angular_core.Signal<string>;
3250
+ readonly letterGlyph: _angular_core.Signal<string>;
3165
3251
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
3166
3252
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
3167
3253
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
@@ -3170,7 +3256,7 @@ declare class SidenavComponent implements SidenavContract {
3170
3256
  * a surrogate pair and paints as tofu. */
3171
3257
  protected readonly markGlyph: _angular_core.Signal<string>;
3172
3258
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
3173
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
3259
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
3174
3260
  }
3175
3261
 
3176
3262
  declare class SidenavGroupComponent {
@@ -3209,14 +3295,19 @@ declare class SidenavItemComponent {
3209
3295
  * scroll-spy); a `routerLink` item navigates regardless — Angular's
3210
3296
  * RouterLink ignores `defaultPrevented` — so treat it as a click hook there. */
3211
3297
  readonly activate: _angular_core.OutputEmitterRef<MouseEvent>;
3298
+ /** Whether THIS item draws its edge marker when active. Unset follows the parent
3299
+ * `ds-sidenav`, then on — the same "null means not deciding" reading as the rest
3300
+ * of the library, so a sidenav-wide `[rail]="false"` is not fought per item. */
3301
+ readonly rail: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3212
3302
  private readonly sidenav;
3303
+ protected readonly railResolved: _angular_core.Signal<boolean>;
3213
3304
  protected onActivate(event: MouseEvent): void;
3214
3305
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
3215
3306
  protected readonly collapsedTooltip: _angular_core.Signal<string>;
3216
3307
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
3217
3308
  protected readonly linkClasses: _angular_core.Signal<string>;
3218
3309
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavItemComponent, never>;
3219
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activate": "activate"; }, never, ["[icon]", "[trailing]"], true, never>;
3310
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; }, { "activate": "activate"; }, never, ["[icon]", "[trailing]"], true, never>;
3220
3311
  }
3221
3312
 
3222
3313
  interface SidenavItemModel {
@@ -3365,7 +3456,7 @@ declare class ModalComponent implements OnDestroy {
3365
3456
  readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3366
3457
  /** Resolved here and passed down, so the card is told rather than resolving a
3367
3458
  * second time — the two would disagree if a provider sat between them. */
3368
- protected readonly dividersResolved: _angular_core.Signal<boolean>;
3459
+ readonly dividersResolved: _angular_core.Signal<boolean>;
3369
3460
  /** When false, clicking the scrim does not close the modal. */
3370
3461
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
3371
3462
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -3412,7 +3503,7 @@ declare class ModalCardComponent {
3412
3503
  * tightens the vertical padding they were sized for. Unset falls back to
3413
3504
  * `DS_CONFIG.modal.dividers`, then `true`. */
3414
3505
  readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3415
- protected readonly dividersResolved: _angular_core.Signal<boolean>;
3506
+ readonly dividersResolved: _angular_core.Signal<boolean>;
3416
3507
  /** Icon badge shown next to the title. Overrides the icon `status` would pick. */
3417
3508
  readonly icon: _angular_core.InputSignal<IconName | null>;
3418
3509
  /** ARIA role. Unset, an error or warning becomes `alertdialog` — the role for a
@@ -3576,10 +3667,20 @@ declare class MenuItemComponent implements OnDestroy {
3576
3667
  /** Renders the item muted — a secondary row like "Sign out" under a divider,
3577
3668
  * still actionable but not competing with the items above it. */
3578
3669
  readonly quiet: _angular_core.InputSignalWithTransform<boolean, unknown>;
3670
+ /** A standing second line under the label — a limitation the action carries
3671
+ * ("will not be saved", "read-only in this workspace"). Visible without hover
3672
+ * or focus, which is what separates it from a `[dsTooltip]`.
3673
+ *
3674
+ * Reaches assistive tech as `aria-describedby`, NOT as part of the item's name:
3675
+ * the projected label names the action, and a caveat is a description of it.
3676
+ * That is why the line is `aria-hidden` in the DOM and referenced by id — inside
3677
+ * the button and visible, it would otherwise be concatenated into the name. */
3678
+ readonly description: _angular_core.InputSignal<string>;
3579
3679
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
3580
3680
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
3581
3681
  /** Fires on click, unless the item is disabled or opens a submenu. */
3582
3682
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
3683
+ protected readonly descriptionId: string;
3583
3684
  /** Roving tabindex, owned by ds-menu — exactly one item is tabbable (0), the
3584
3685
  * rest -1. Defaults true so a standalone item (outside ds-menu) stays
3585
3686
  * reachable. */
@@ -3606,7 +3707,7 @@ declare class MenuItemComponent implements OnDestroy {
3606
3707
  private clearOpenTimer;
3607
3708
  private clearCloseTimer;
3608
3709
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
3609
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "quiet": { "alias": "quiet"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
3710
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "quiet": { "alias": "quiet"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
3610
3711
  }
3611
3712
 
3612
3713
  declare class MenuDividerComponent {
@@ -4093,14 +4194,18 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4093
4194
  readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
4094
4195
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4095
4196
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4096
- * A NUMBER caps at exactly that many, which is what you want when the trigger's
4097
- * height must be predictable whatever the width. `null` shows every chip and
4098
- * lets the trigger grow a line per selection. */
4099
- readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4197
+ * A NUMBER is a CEILING, not a promise: the row still measures, so you get at
4198
+ * most that many and fewer when the trigger is narrow. `"all"` shows every chip and
4199
+ * lets the trigger grow a line per selection.
4200
+ *
4201
+ * Unset (`null`) means "not deciding", as it does on every other input in the
4202
+ * library — it resolves to `"fit"`. It does NOT mean "show all": that is
4203
+ * `"all"`, which is the loudest of the three modes and has to be asked for. */
4204
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | "all" | null, number | "fit" | "all" | null>;
4100
4205
  /** Trigger height — sm/md/lg.
4101
4206
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4102
4207
  readonly size: _angular_core.InputSignal<DsSize | null>;
4103
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4208
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4104
4209
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
4105
4210
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
4106
4211
  /** Placeholder shown in the input when empty. */
@@ -4144,9 +4249,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4144
4249
  /** Flat list of visible options used for keyboard navigation index. */
4145
4250
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4146
4251
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4252
+ private readonly chipsMode;
4253
+ private readonly showsEveryChip;
4147
4254
  /** True for BOTH `'fit'` and a number: a number is a ceiling ("at most N"), not a
4148
- * promise, so the row still measures and shows only what the width allows. Only
4149
- * `null` opts out of measuring. */
4255
+ * promise, so the row still measures and shows only what the width allows. */
4150
4256
  protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4151
4257
  /** How many chips the row is ASKED to render before measuring: everything for
4152
4258
  * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
@@ -4629,10 +4735,14 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4629
4735
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
4630
4736
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4631
4737
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4632
- * A NUMBER caps at exactly that many, which is what you want when the trigger's
4633
- * height must be predictable whatever the width. `null` shows every chip and
4634
- * lets the trigger grow a line per selection. */
4635
- readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4738
+ * A NUMBER is a CEILING, not a promise: the row still measures, so you get at
4739
+ * most that many and fewer when the trigger is narrow. `"all"` shows every chip and
4740
+ * lets the trigger grow a line per selection.
4741
+ *
4742
+ * Unset (`null`) means "not deciding", as it does on every other input in the
4743
+ * library — it resolves to `"fit"`. It does NOT mean "show all": that is
4744
+ * `"all"`, which is the loudest of the three modes and has to be asked for. */
4745
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | "all" | null, number | "fit" | "all" | null>;
4636
4746
  /** Disables the trigger and blocks all interaction. */
4637
4747
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4638
4748
  /** Confirmation text, shown when there is no error or warning — and it paints
@@ -4657,11 +4767,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4657
4767
  ngOnDestroy(): void;
4658
4768
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4659
4769
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4770
+ private readonly chipsMode;
4771
+ private readonly showsEveryChip;
4660
4772
  /** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise —
4661
4773
  * "at most N" — so the row still measures and shows only what the trigger is
4662
4774
  * wide enough for. Without that, a phone-width trigger honoured the count and
4663
4775
  * wrapped the text input onto a second line, which is the one thing the cap
4664
- * exists to prevent. `null` opts out of measuring and grows, as documented. */
4776
+ * exists to prevent. */
4665
4777
  protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4666
4778
  /** How many chips the row is ASKED to render before measuring: everything for
4667
4779
  * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
@@ -4732,7 +4844,7 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4732
4844
  /** Checkbox size — sm/md/lg.
4733
4845
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4734
4846
  readonly size: _angular_core.InputSignal<DsSize | null>;
4735
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4847
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4736
4848
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4737
4849
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4738
4850
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -4752,8 +4864,15 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4752
4864
  }
4753
4865
 
4754
4866
  declare class RadioComponent extends DsFieldBase {
4755
- /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
4756
- * derived from the group value instead. */
4867
+ /** Standalone two-way binding, and the ONLY way to drive a lone radio: this
4868
+ * component is deliberately not a `ControlValueAccessor`, so `[formControl]` and
4869
+ * `ngModel` do not bind to it. Inside `ds-radio-group` the GROUP is the form
4870
+ * control — a radio is one option of a choice, not a value of its own — and a
4871
+ * second accessor on the option would fight it. A lone radio in a form binds
4872
+ * through `[(checked)]`, or becomes a one-option `ds-radio-group`.
4873
+ *
4874
+ * When inside `ds-radio-group`, `isChecked()` derives from the group value and
4875
+ * this input is not read. */
4757
4876
  readonly checked: _angular_core.ModelSignal<boolean>;
4758
4877
  /** Disables the radio; a disabled parent `ds-radio-group` also disables it. */
4759
4878
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -4766,7 +4885,7 @@ declare class RadioComponent extends DsFieldBase {
4766
4885
  /** Control size — sm/md/lg.
4767
4886
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4768
4887
  readonly size: _angular_core.InputSignal<DsSize | null>;
4769
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4888
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4770
4889
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
4771
4890
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4772
4891
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -4853,7 +4972,7 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
4853
4972
  /** Switch size — sm/md/lg.
4854
4973
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4855
4974
  readonly size: _angular_core.InputSignal<DsSize | null>;
4856
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4975
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4857
4976
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4858
4977
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4859
4978
  /** Inline label rendered beside the track and wired via for/id. Omit to