@ids-group-ltd/ids-design-system 0.10.0 → 0.10.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.
@@ -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". */
@@ -1312,12 +1340,63 @@ interface DsFieldError {
1312
1340
  }
1313
1341
  /** What a field's `errors` input accepts before normalization. */
1314
1342
  type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
1343
+ /**
1344
+ * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
1345
+ * in the warning state and does NOT make the control invalid, which is how a form
1346
+ * model can raise a non-blocking remark — Angular's own `AbstractControl` has no
1347
+ * channel for one, only `errors` and the validity derived from it.
1348
+ */
1349
+ declare const DS_FIELD_WARNING_KIND = "warning";
1315
1350
  /** The single line a field shows below itself, already resolved. */
1316
1351
  interface DsFieldMessage {
1317
1352
  readonly text: string;
1318
1353
  readonly state: FieldMessageState;
1319
1354
  }
1320
1355
 
1356
+ /**
1357
+ * The inputs every DS form field has, declared once.
1358
+ *
1359
+ * Only the UNIVERSAL ones belong here. `success`, `label`, `required` and
1360
+ * `optional` stay on the components: they exist on some fields and not others, so
1361
+ * lifting them would hand a checkbox a `success` or a slider a `label` it never
1362
+ * had — a silent public-API addition.
1363
+ *
1364
+ * `@Directive()` is required, not decoration: Angular refuses to compile a base
1365
+ * class that declares inputs without it.
1366
+ */
1367
+ declare abstract class DsFieldBase {
1368
+ /** Helper text shown below the field. */
1369
+ readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1370
+ /** Error text. Shown immediately — binding it says the consumer has already
1371
+ * decided this field is in error. Takes precedence over `errors`. */
1372
+ readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1373
+ /** Advisory text, shown when there is no error. */
1374
+ readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1375
+ /** Validation errors, shown once the user has interacted. Bound automatically
1376
+ * by signal forms; reactive and template-driven forms are read through
1377
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1378
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1379
+ /** Paints the error state and sets `aria-invalid`, WITHOUT a message of its own
1380
+ * — for when the text lives elsewhere, such as a form-level error summary or
1381
+ * one message covering a whole field group. Use `error` to show text. */
1382
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1383
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1384
+ * `errors`, so a `required` error does not greet an untouched form. */
1385
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1386
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1387
+ * the layout below it when a hint/error appears. Falls back to
1388
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1389
+ * for a form that shows validation messages. */
1390
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
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>;
1396
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsFieldBase, 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>;
1398
+ }
1399
+
1321
1400
  /**
1322
1401
  * Shared `ControlValueAccessor` for DS form controls whose value is a signal
1323
1402
  * `model()`. Bridges that model with Angular forms (reactive `formControl` /
@@ -1328,7 +1407,7 @@ interface DsFieldMessage {
1328
1407
  * effective disabled state so `FormControl.disable()` actually reaches the
1329
1408
  * control; it should also call `markTouched()` from a blur handler.
1330
1409
  */
1331
- declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor {
1410
+ declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements ControlValueAccessor {
1332
1411
  /** The component's two-way value model. */
1333
1412
  abstract readonly value: ModelSignal<T>;
1334
1413
  /**
@@ -1345,14 +1424,10 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
1345
1424
  * nowhere. A control with a more precise target overrides this.
1346
1425
  */
1347
1426
  focus(options?: FocusOptions): void;
1427
+ private readonly bridge;
1348
1428
  /** Driven by the forms API via `setDisabledState`. */
1349
- protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1350
- protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
1351
- private onChange;
1352
- private onTouched;
1353
- private synced;
1354
- private hasSynced;
1355
- constructor();
1429
+ protected readonly formDisabled: WritableSignal<boolean>;
1430
+ protected readonly touchedSelf: WritableSignal<boolean>;
1356
1431
  /** Call from a blur handler so the control reports `ng-touched`. */
1357
1432
  protected markTouched(): void;
1358
1433
  writeValue(value: T): void;
@@ -1369,7 +1444,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
1369
1444
  * signal API. Subclasses must OR `formDisabled()` into their effective disabled
1370
1445
  * state and call `markTouched()` from a blur handler.
1371
1446
  */
1372
- declare abstract class DsBooleanControlValueAccessor implements ControlValueAccessor {
1447
+ declare abstract class DsBooleanControlValueAccessor extends DsFieldBase implements ControlValueAccessor {
1373
1448
  /** The component's two-way checked model. */
1374
1449
  abstract readonly checked: ModelSignal<boolean>;
1375
1450
  /** Hides the control — see the note on `DsControlValueAccessor.hidden`. */
@@ -1383,8 +1458,8 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
1383
1458
  */
1384
1459
  focus(options?: FocusOptions): void;
1385
1460
  /** Driven by the forms API via `setDisabledState`. */
1386
- protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1387
- protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
1461
+ protected readonly formDisabled: WritableSignal<boolean>;
1462
+ protected readonly touchedSelf: WritableSignal<boolean>;
1388
1463
  private onChange;
1389
1464
  private onTouched;
1390
1465
  private synced;
@@ -1414,29 +1489,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1414
1489
  /** Field height — sm/md/lg.
1415
1490
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1416
1491
  readonly size: _angular_core.InputSignal<DsSize | null>;
1417
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1492
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1418
1493
  /** Label shown above the field. */
1419
1494
  readonly label: _angular_core.InputSignal<string>;
1420
- /** Helper text shown below the field. */
1421
- readonly hint: _angular_core.InputSignal<string>;
1422
- /** Error text. Shown immediately — binding it says the consumer has already
1423
- * decided this field is in error. Takes precedence over `errors`. */
1424
- readonly error: _angular_core.InputSignal<string>;
1425
- /** Advisory text, shown when there is no error. */
1426
- readonly warning: _angular_core.InputSignal<string>;
1427
- /** Validation errors, shown once the user has interacted. Bound automatically
1428
- * by signal forms; reactive and template-driven forms are read through
1429
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1430
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1431
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1432
- * `errors`, so a `required` error does not greet an untouched form. */
1433
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1434
- /** Reserve the message-row height even when empty, so the field doesn't shift
1435
- * the layout below it when a hint/error appears. Falls back to
1436
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1437
- * for a form that shows validation messages. */
1438
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1439
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1440
1495
  /** Placeholder shown when empty. */
1441
1496
  readonly placeholder: _angular_core.InputSignal<string>;
1442
1497
  /** Disables the field and blocks all interaction. */
@@ -1449,10 +1504,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1449
1504
  */
1450
1505
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1451
1506
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1452
- /** Applies error styling and marks the field `aria-invalid`. */
1453
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1454
- /** Applies success styling to the field. */
1455
- readonly success: _angular_core.InputSignalWithTransform<boolean, unknown>;
1507
+ /** Confirmation text, shown when there is no error or warning — and it paints
1508
+ * the field's success border. A string like `warning`: the text IS the state. */
1509
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1456
1510
  /** Shows a trailing spinner — e.g. async validation in flight. The input
1457
1511
  * stays editable; pair with a `hint` like "Checking availability…". */
1458
1512
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1531,7 +1585,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1531
1585
  focus(options?: FocusOptions): void;
1532
1586
  protected clear(): void;
1533
1587
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
1534
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "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; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "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; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
1588
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "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; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "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; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
1535
1589
  }
1536
1590
 
1537
1591
  declare class NumberStepperComponent {
@@ -1546,7 +1600,7 @@ declare class NumberStepperComponent {
1546
1600
  /** Control height — sm/md/lg.
1547
1601
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1548
1602
  readonly size: _angular_core.InputSignal<DsSize | null>;
1549
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1603
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1550
1604
  /** Disables the stepper and blocks all interaction. */
1551
1605
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1552
1606
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -1570,29 +1624,9 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1570
1624
  /** Field height — sm/md/lg.
1571
1625
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1572
1626
  readonly size: _angular_core.InputSignal<DsSize | null>;
1573
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1627
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1574
1628
  /** Label shown above the field. */
1575
1629
  readonly label: _angular_core.InputSignal<string>;
1576
- /** Helper text shown below the field. */
1577
- readonly hint: _angular_core.InputSignal<string>;
1578
- /** Error text. Shown immediately — binding it says the consumer has already
1579
- * decided this field is in error. Takes precedence over `errors`. */
1580
- readonly error: _angular_core.InputSignal<string>;
1581
- /** Advisory text, shown when there is no error. */
1582
- readonly warning: _angular_core.InputSignal<string>;
1583
- /** Validation errors, shown once the user has interacted. Bound automatically
1584
- * by signal forms; reactive and template-driven forms are read through
1585
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1586
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1587
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1588
- * `errors`, so a `required` error does not greet an untouched form. */
1589
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1590
- /** Reserve the message-row height even when empty, so the field doesn't shift
1591
- * the layout below it when a hint/error appears. Falls back to
1592
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1593
- * for a form that shows validation messages. */
1594
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1595
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1596
1630
  /** Placeholder shown when empty. */
1597
1631
  readonly placeholder: _angular_core.InputSignal<string>;
1598
1632
  /** Disables the field and blocks all interaction. */
@@ -1605,8 +1639,9 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1605
1639
  */
1606
1640
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1607
1641
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1608
- /** Applies error styling and marks the field `aria-invalid`. */
1609
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1642
+ /** Confirmation text, shown when there is no error or warning — and it paints
1643
+ * the field's success border. A string like `warning`: the text IS the state. */
1644
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1610
1645
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1611
1646
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1612
1647
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1654,13 +1689,19 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1654
1689
  * deliberately, e.g. focusing the first invalid field on a failed submit. */
1655
1690
  focus(options?: FocusOptions): void;
1656
1691
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
1657
- 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; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "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; }; "invalid": { "alias": "invalid"; "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>;
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>;
1658
1693
  }
1659
1694
 
1660
- declare class SearchComponent {
1695
+ declare class SearchComponent implements ControlValueAccessor {
1661
1696
  /** Segment of a ds-field-group: the group owns the border, radius and focus
1662
1697
  * ring, so .in-group strips this control back to its bare contents. */
1663
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>;
1664
1705
  /** Search text, two-way bound. */
1665
1706
  readonly value: _angular_core.ModelSignal<string>;
1666
1707
  /** Placeholder shown when empty. */
@@ -1673,11 +1714,14 @@ declare class SearchComponent {
1673
1714
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1674
1715
  /** Accessible name for the input (placeholder is not a reliable label). */
1675
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>;
1676
1720
  /** Control height. `md` (default) keeps the 36px search-row height; `sm` (32px)
1677
1721
  * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch.
1678
1722
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1679
1723
  readonly size: _angular_core.InputSignal<DsSize | null>;
1680
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1724
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1681
1725
  /** Fires with the current value on Enter. */
1682
1726
  readonly submitted: _angular_core.OutputEmitterRef<string>;
1683
1727
  /** Milliseconds to hold each keystroke back before `value` updates — 0 (default)
@@ -1704,13 +1748,25 @@ declare class SearchComponent {
1704
1748
  focus(options?: FocusOptions): void;
1705
1749
  protected onText(next: string): void;
1706
1750
  protected onSubmit(): void;
1707
- 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;
1708
1758
  /** So Enter searches what the reader can see, not what the timer last let past. */
1709
1759
  private flush;
1710
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;
1711
1767
  private cancel;
1712
1768
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
1713
- 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>;
1714
1770
  }
1715
1771
 
1716
1772
  /**
@@ -1756,7 +1812,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1756
1812
  /** Trigger height — sm/md/lg.
1757
1813
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1758
1814
  readonly size: _angular_core.InputSignal<DsSize | null>;
1759
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1815
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
1760
1816
  /** Label shown above the trigger. */
1761
1817
  readonly label: _angular_core.InputSignal<string>;
1762
1818
  /** Disables the trigger and blocks all interaction. */
@@ -1769,28 +1825,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1769
1825
  */
1770
1826
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1771
1827
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1772
- /** Applies error styling and marks the trigger `aria-invalid`. */
1773
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1774
- /** Helper text shown below the trigger. */
1775
- readonly hint: _angular_core.InputSignal<string>;
1776
- /** Error text. Shown immediately — binding it says the consumer has already
1777
- * decided this field is in error. Takes precedence over `errors`. */
1778
- readonly error: _angular_core.InputSignal<string>;
1779
- /** Advisory text, shown when there is no error. */
1780
- readonly warning: _angular_core.InputSignal<string>;
1781
- /** Validation errors, shown once the user has interacted. Bound automatically
1782
- * by signal forms; reactive and template-driven forms are read through
1783
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1784
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1785
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1786
- * `errors`, so a `required` error does not greet an untouched form. */
1787
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1788
- /** Reserve the message-row height even when empty, so the field doesn't shift
1789
- * the layout below it when a hint/error appears. Falls back to
1790
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1791
- * for a form that shows validation messages. */
1792
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1793
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1828
+ /** Confirmation text, shown when there is no error or warning — and it paints
1829
+ * the field's success border. A string like `warning`: the text IS the state. */
1830
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1794
1831
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1795
1832
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1796
1833
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1846,7 +1883,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1846
1883
  private firstEnabledIndex;
1847
1884
  private lastEnabledIndex;
1848
1885
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1849
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "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; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1886
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "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; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1850
1887
  }
1851
1888
 
1852
1889
  /**
@@ -1990,6 +2027,12 @@ interface TableColumn<T = unknown> {
1990
2027
  /** Let the user toggle the column in the header column picker — the picker
1991
2028
  * button appears once at least one column is hideable. */
1992
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;
1993
2036
  /** Initial visibility: start hidden. The column picker (or a bound
1994
2037
  * `hiddenKeys` set) owns the state from then on; a hidden column stays
1995
2038
  * available to `filterable` matching and sorting. */
@@ -2009,6 +2052,17 @@ interface TableRowAction<T = unknown> {
2009
2052
  error?: boolean;
2010
2053
  /** Per-row predicate — return true to disable the item for that row. */
2011
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);
2012
2066
  }
2013
2067
  interface TableRowActionEvent<T = unknown> {
2014
2068
  action: TableRowAction<T>;
@@ -2218,8 +2272,8 @@ declare class TableComponent<T extends object> {
2218
2272
  readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
2219
2273
  protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
2220
2274
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
2221
- protected readonly borderedResolved: _angular_core.Signal<boolean>;
2222
- protected readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2275
+ readonly borderedResolved: _angular_core.Signal<boolean>;
2276
+ readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2223
2277
  /** Pin the first data column (and the select column) on horizontal scroll. */
2224
2278
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
2225
2279
  /**
@@ -2300,9 +2354,9 @@ declare class TableComponent<T extends object> {
2300
2354
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
2301
2355
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
2302
2356
  /** The empty row is a CLAIM about the data — "there are none" — so it must not
2303
- * appear while the table is still asking. Only `skeleton` used to suppress it,
2304
- * and `overlay` is the mode a list uses on every read after the first, so a
2305
- * 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. */
2306
2360
  protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
2307
2361
  protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
2308
2362
  /** Columns in the user-controlled order — `columnOrder` first (dropping
@@ -2507,6 +2561,14 @@ declare class TableComponent<T extends object> {
2507
2561
  protected onRowMenuClick(row: T, event: Event): void;
2508
2562
  protected isMenuOpenFor(row: T): boolean;
2509
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;
2510
2572
  protected onRowAction(action: TableRowAction<T>): void;
2511
2573
  protected isExpanded(row: T): boolean;
2512
2574
  protected onToggleExpand(row: T, event: Event): void;
@@ -2725,7 +2787,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2725
2787
  /** Trigger height — sm/md/lg.
2726
2788
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
2727
2789
  readonly size: _angular_core.InputSignal<DsSize | null>;
2728
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2790
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
2729
2791
  /** Stretch the trigger to fill its container instead of hugging the mask
2730
2792
  * width — opt in when the field shares a grid/flex track with inputs. */
2731
2793
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2735,35 +2797,15 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2735
2797
  readonly placeholder: _angular_core.InputSignal<string>;
2736
2798
  /** Field label shown above the trigger. */
2737
2799
  readonly label: _angular_core.InputSignal<string>;
2738
- /** Helper text shown below the field. */
2739
- readonly hint: _angular_core.InputSignal<string>;
2740
- /** Error text. Shown immediately — binding it says the consumer has already
2741
- * decided this field is in error. Takes precedence over `errors` and over the
2742
- * picker's own "enter a valid date" message. */
2743
- readonly error: _angular_core.InputSignal<string>;
2744
- /** Advisory text, shown when there is no error. */
2745
- readonly warning: _angular_core.InputSignal<string>;
2746
- /** Validation errors, shown once the user has interacted. Bound automatically
2747
- * by signal forms; reactive and template-driven forms are read through
2748
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2749
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2750
- /** Whether the user has interacted with the field. Bound by signal forms; gates
2751
- * `errors`, so a `required` error does not greet an untouched form. */
2752
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2753
- /** Reserve the message-row height even when empty, so the field doesn't shift
2754
- * the layout below it when a hint/error appears. Falls back to
2755
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2756
- * for a form that shows validation messages. */
2757
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2758
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2759
2800
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
2760
2801
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2761
2802
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
2762
2803
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
2763
2804
  /** Disables the picker and blocks all interaction. */
2764
2805
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2765
- /** Applies error styling and marks the trigger `aria-invalid`. */
2766
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2806
+ /** Confirmation text, shown when there is no error or warning — and it paints
2807
+ * the field's success border. A string like `warning`: the text IS the state. */
2808
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
2767
2809
  /** Accessible name when no visible `label` is provided. */
2768
2810
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2769
2811
  /** Bounds for the year dropdown in the calendar header. */
@@ -2798,7 +2840,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2798
2840
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
2799
2841
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2800
2842
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2801
- protected readonly resolvedLocale: _angular_core.Signal<string>;
2843
+ readonly resolvedLocale: _angular_core.Signal<string>;
2802
2844
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
2803
2845
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
2804
2846
  /** Slot/literal layout for the current mode — single date or doubled range. */
@@ -2934,7 +2976,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2934
2976
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
2935
2977
  protected applyPreset(preset: DatePickerPreset): void;
2936
2978
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
2937
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2979
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2938
2980
  }
2939
2981
 
2940
2982
  type TimePickerMode = 'single' | 'range';
@@ -3043,7 +3085,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3043
3085
  /** Trigger height — sm/md/lg.
3044
3086
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
3045
3087
  readonly size: _angular_core.InputSignal<DsSize | null>;
3046
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
3088
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
3047
3089
  /** Stretch the trigger to fill its container instead of hugging its content —
3048
3090
  * opt in when the field shares a grid/flex track with inputs. */
3049
3091
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -3056,28 +3098,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3056
3098
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
3057
3099
  /** Disables the picker and blocks all interaction. */
3058
3100
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
3059
- /** Applies error styling and marks the trigger `aria-invalid`. */
3060
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3061
- /** Helper text shown below the picker. */
3062
- readonly hint: _angular_core.InputSignal<string>;
3063
- /** Error text. Shown immediately — binding it says the consumer has already
3064
- * decided this field is in error. Takes precedence over `errors`. */
3065
- readonly error: _angular_core.InputSignal<string>;
3066
- /** Advisory text, shown when there is no error. */
3067
- readonly warning: _angular_core.InputSignal<string>;
3068
- /** Validation errors, shown once the user has interacted. Bound automatically
3069
- * by signal forms; reactive and template-driven forms are read through
3070
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3071
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3072
- /** Whether the user has interacted with the field. Bound by signal forms; gates
3073
- * `errors`, so a `required` error does not greet an untouched form. */
3074
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3075
- /** Reserve the message-row height even when empty, so the field doesn't shift
3076
- * the layout below it when a hint/error appears. Falls back to
3077
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3078
- * for a form that shows validation messages. */
3079
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3080
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3101
+ /** Confirmation text, shown when there is no error or warning — and it paints
3102
+ * the field's success border. A string like `warning`: the text IS the state. */
3103
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
3081
3104
  /** Shown in the trigger when no time is set. */
3082
3105
  readonly placeholder: _angular_core.InputSignal<string>;
3083
3106
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -3096,13 +3119,17 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3096
3119
  protected readonly endTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
3097
3120
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
3098
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;
3099
3126
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3100
3127
  protected readonly hintId: _angular_core.Signal<string | null>;
3101
3128
  private readonly fieldMessage;
3102
3129
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
3103
3130
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
3104
3131
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
3105
- protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
3132
+ readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
3106
3133
  protected readonly singleValue: _angular_core.Signal<string | null>;
3107
3134
  protected readonly rangeValue: _angular_core.Signal<TimeRangeValue>;
3108
3135
  protected readonly hasValue: _angular_core.Signal<boolean>;
@@ -3128,7 +3155,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3128
3155
  private minutesOf;
3129
3156
  private laterOf;
3130
3157
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
3131
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3158
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3132
3159
  }
3133
3160
 
3134
3161
  interface BreadcrumbItem {
@@ -3194,12 +3221,20 @@ declare class BreadcrumbsService {
3194
3221
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
3195
3222
  interface SidenavContract {
3196
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;
3197
3227
  }
3198
3228
  declare const SIDENAV: InjectionToken<SidenavContract>;
3199
3229
 
3200
3230
  declare class SidenavComponent implements SidenavContract {
3201
3231
  /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
3202
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>;
3203
3238
  /** Brand text at the top of the rail (auto letter-mark + name). For a custom
3204
3239
  * logo image/SVG, project it into the `[brand]` slot instead. Unset falls back
3205
3240
  * to `DS_CONFIG.brand.name`. Each field resolves on its own, so `brand=""` drops
@@ -3211,8 +3246,8 @@ declare class SidenavComponent implements SidenavContract {
3211
3246
  readonly logoLetter: _angular_core.InputSignal<string | null>;
3212
3247
  /** The template must read THIS, never the input beside it — that one is null
3213
3248
  * until bound, and the config default lives here. */
3214
- protected readonly brandName: _angular_core.Signal<string>;
3215
- protected readonly letterGlyph: _angular_core.Signal<string>;
3249
+ readonly brandName: _angular_core.Signal<string>;
3250
+ readonly letterGlyph: _angular_core.Signal<string>;
3216
3251
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
3217
3252
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
3218
3253
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
@@ -3221,7 +3256,7 @@ declare class SidenavComponent implements SidenavContract {
3221
3256
  * a surrogate pair and paints as tofu. */
3222
3257
  protected readonly markGlyph: _angular_core.Signal<string>;
3223
3258
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
3224
- 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>;
3225
3260
  }
3226
3261
 
3227
3262
  declare class SidenavGroupComponent {
@@ -3260,14 +3295,19 @@ declare class SidenavItemComponent {
3260
3295
  * scroll-spy); a `routerLink` item navigates regardless — Angular's
3261
3296
  * RouterLink ignores `defaultPrevented` — so treat it as a click hook there. */
3262
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>;
3263
3302
  private readonly sidenav;
3303
+ protected readonly railResolved: _angular_core.Signal<boolean>;
3264
3304
  protected onActivate(event: MouseEvent): void;
3265
3305
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
3266
3306
  protected readonly collapsedTooltip: _angular_core.Signal<string>;
3267
3307
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
3268
3308
  protected readonly linkClasses: _angular_core.Signal<string>;
3269
3309
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavItemComponent, never>;
3270
- 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>;
3271
3311
  }
3272
3312
 
3273
3313
  interface SidenavItemModel {
@@ -3416,7 +3456,7 @@ declare class ModalComponent implements OnDestroy {
3416
3456
  readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3417
3457
  /** Resolved here and passed down, so the card is told rather than resolving a
3418
3458
  * second time — the two would disagree if a provider sat between them. */
3419
- protected readonly dividersResolved: _angular_core.Signal<boolean>;
3459
+ readonly dividersResolved: _angular_core.Signal<boolean>;
3420
3460
  /** When false, clicking the scrim does not close the modal. */
3421
3461
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
3422
3462
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -3463,7 +3503,7 @@ declare class ModalCardComponent {
3463
3503
  * tightens the vertical padding they were sized for. Unset falls back to
3464
3504
  * `DS_CONFIG.modal.dividers`, then `true`. */
3465
3505
  readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3466
- protected readonly dividersResolved: _angular_core.Signal<boolean>;
3506
+ readonly dividersResolved: _angular_core.Signal<boolean>;
3467
3507
  /** Icon badge shown next to the title. Overrides the icon `status` would pick. */
3468
3508
  readonly icon: _angular_core.InputSignal<IconName | null>;
3469
3509
  /** ARIA role. Unset, an error or warning becomes `alertdialog` — the role for a
@@ -3627,10 +3667,20 @@ declare class MenuItemComponent implements OnDestroy {
3627
3667
  /** Renders the item muted — a secondary row like "Sign out" under a divider,
3628
3668
  * still actionable but not competing with the items above it. */
3629
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>;
3630
3679
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
3631
3680
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
3632
3681
  /** Fires on click, unless the item is disabled or opens a submenu. */
3633
3682
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
3683
+ protected readonly descriptionId: string;
3634
3684
  /** Roving tabindex, owned by ds-menu — exactly one item is tabbable (0), the
3635
3685
  * rest -1. Defaults true so a standalone item (outside ds-menu) stays
3636
3686
  * reachable. */
@@ -3657,7 +3707,7 @@ declare class MenuItemComponent implements OnDestroy {
3657
3707
  private clearOpenTimer;
3658
3708
  private clearCloseTimer;
3659
3709
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
3660
- 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>;
3661
3711
  }
3662
3712
 
3663
3713
  declare class MenuDividerComponent {
@@ -4144,42 +4194,27 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4144
4194
  readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
4145
4195
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4146
4196
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4147
- * A NUMBER caps at exactly that many, which is what you want when the trigger's
4148
- * height must be predictable whatever the width. `null` shows every chip and
4149
- * lets the trigger grow a line per selection. */
4150
- 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>;
4151
4205
  /** Trigger height — sm/md/lg.
4152
4206
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4153
4207
  readonly size: _angular_core.InputSignal<DsSize | null>;
4154
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4208
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4155
4209
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
4156
4210
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
4157
4211
  /** Placeholder shown in the input when empty. */
4158
4212
  readonly placeholder: _angular_core.InputSignal<string>;
4159
4213
  /** Disables the trigger and blocks all interaction. */
4160
4214
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4161
- /** Applies error styling and marks the field `aria-invalid`. */
4162
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4163
- /** Helper text shown below the field. */
4164
- readonly hint: _angular_core.InputSignal<string>;
4165
- /** Error text. Shown immediately — binding it says the consumer has already
4166
- * decided this field is in error. Takes precedence over `errors`. */
4167
- readonly error: _angular_core.InputSignal<string>;
4168
- /** Advisory text, shown when there is no error. */
4169
- readonly warning: _angular_core.InputSignal<string>;
4170
- /** Validation errors, shown once the user has interacted. Bound automatically
4171
- * by signal forms; reactive and template-driven forms are read through
4172
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4173
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4174
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4175
- * `errors`, so a `required` error does not greet an untouched form. */
4176
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4177
- /** Reserve the message-row height even when empty, so the field doesn't shift
4178
- * the layout below it when a hint/error appears. Falls back to
4179
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4180
- * for a form that shows validation messages. */
4181
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4182
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4215
+ /** Confirmation text, shown when there is no error or warning — and it paints
4216
+ * the field's success border. A string like `warning`: the text IS the state. */
4217
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4183
4218
  /** Shows a "Create «text»" row when the typed text matches no option. */
4184
4219
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
4185
4220
  /** Accessible name for the input. */
@@ -4214,9 +4249,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4214
4249
  /** Flat list of visible options used for keyboard navigation index. */
4215
4250
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4216
4251
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4252
+ private readonly chipsMode;
4253
+ private readonly showsEveryChip;
4217
4254
  /** True for BOTH `'fit'` and a number: a number is a ceiling ("at most N"), not a
4218
- * promise, so the row still measures and shows only what the width allows. Only
4219
- * `null` opts out of measuring. */
4255
+ * promise, so the row still measures and shows only what the width allows. */
4220
4256
  protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4221
4257
  /** How many chips the row is ASKED to render before measuring: everything for
4222
4258
  * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
@@ -4268,7 +4304,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4268
4304
  protected onCreateNew(): void;
4269
4305
  protected remove(target: T): void;
4270
4306
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
4271
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
4307
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
4272
4308
  }
4273
4309
 
4274
4310
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -4351,20 +4387,30 @@ interface SegmentedOption {
4351
4387
  disabled?: boolean;
4352
4388
  }
4353
4389
 
4354
- declare class SegmentedComponent {
4390
+ declare class SegmentedComponent extends DsControlValueAccessor<string> {
4355
4391
  /** Segments to render — each needs a `label` and `value`, optional `icon`/`disabled`. */
4356
4392
  readonly options: _angular_core.InputSignal<readonly SegmentedOption[]>;
4357
4393
  /** Selected segment's `value`, two-way bound. */
4358
4394
  readonly value: _angular_core.ModelSignal<string>;
4359
4395
  /** Accessible name for the segmented control (radiogroup role). */
4360
4396
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4397
+ /** Visible label above the track; omit to supply your own. */
4398
+ readonly label: _angular_core.InputSignal<string>;
4399
+ /** Disables every segment. */
4400
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4401
+ readonly isDisabled: _angular_core.Signal<boolean>;
4402
+ protected readonly uid: string;
4403
+ protected readonly hintId: _angular_core.Signal<string | null>;
4404
+ private readonly fieldMessage;
4405
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4406
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
4361
4407
  private readonly buttons;
4362
4408
  protected readonly focusableValue: _angular_core.Signal<string | null>;
4363
4409
  protected select(option: SegmentedOption): void;
4364
4410
  protected onKeydown(event: KeyboardEvent, index: number): void;
4365
4411
  private nextEnabled;
4366
4412
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SegmentedComponent, never>;
4367
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ds-segmented", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4413
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ds-segmented", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4368
4414
  }
4369
4415
 
4370
4416
  declare class ButtonGroupComponent {
@@ -4386,16 +4432,18 @@ declare class ListItemComponent {
4386
4432
  readonly title: _angular_core.InputSignal<string>;
4387
4433
  /** Secondary line below `title`. */
4388
4434
  readonly subtitle: _angular_core.InputSignal<string>;
4389
- /** Whole-row navigation: renders an inner button and emits `activated`. */
4435
+ /** Makes the row's text a button that emits `activated`. `[leading]` and
4436
+ * `[trailing]` stay outside it, so a row can hold its own controls as well. */
4390
4437
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
4391
- /** Marks the row current via `aria-current`. */
4438
+ /** Marks the row current — `aria-current` and the selected tint. */
4392
4439
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
4393
- /** Disables the row; only affects the button when `clickable`. */
4440
+ /** Disables the row's own button. Controls projected into `[leading]` or
4441
+ * `[trailing]` keep their own disabled state. */
4394
4442
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4395
4443
  /** Fires when the clickable row's button is activated. */
4396
4444
  readonly activated: _angular_core.OutputEmitterRef<void>;
4397
4445
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListItemComponent, never>;
4398
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListItemComponent, "ds-list-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[leading]", "*", "[trailing]"], true, never>;
4446
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListItemComponent, "ds-list-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[leading]", "[trailing]", "*"], true, never>;
4399
4447
  }
4400
4448
 
4401
4449
  type SplitButtonVariant = 'primary' | 'outline';
@@ -4461,28 +4509,9 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4461
4509
  readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
4462
4510
  /** Disables all cells and blocks interaction. */
4463
4511
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4464
- /** Applies error styling and marks each cell `aria-invalid`. */
4465
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4466
- /** Helper text shown below the cells. */
4467
- readonly hint: _angular_core.InputSignal<string>;
4468
- /** Error text. Shown immediately — binding it says the consumer has already
4469
- * decided this field is in error. Takes precedence over `errors`. */
4470
- readonly error: _angular_core.InputSignal<string>;
4471
- /** Advisory text, shown when there is no error. */
4472
- readonly warning: _angular_core.InputSignal<string>;
4473
- /** Validation errors, shown once the user has interacted. Bound automatically
4474
- * by signal forms; reactive and template-driven forms are read through
4475
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4476
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4477
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4478
- * `errors`, so a `required` error does not greet an untouched form. */
4479
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4480
- /** Reserve the message-row height even when empty, so the field doesn't shift
4481
- * the layout below it when a hint/error appears. Falls back to
4482
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4483
- * for a form that shows validation messages. */
4484
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4485
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4512
+ /** Confirmation text, shown when there is no error or warning — and it paints
4513
+ * the field's success border. A string like `warning`: the text IS the state. */
4514
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4486
4515
  /** Accessible group label for the cell row. */
4487
4516
  readonly ariaLabel: _angular_core.InputSignal<string>;
4488
4517
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -4510,7 +4539,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4510
4539
  private focusBox;
4511
4540
  private sanitize;
4512
4541
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
4513
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
4542
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
4514
4543
  }
4515
4544
 
4516
4545
  type SliderValue = number | readonly [number, number];
@@ -4529,28 +4558,6 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
4529
4558
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4530
4559
  /** Accessible name for the thumb(s) — suffixed "minimum"/"maximum" in `range` mode. */
4531
4560
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4532
- /** Applies error styling. */
4533
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4534
- /** Helper text shown below the slider. */
4535
- readonly hint: _angular_core.InputSignal<string>;
4536
- /** Error text. Shown immediately — binding it says the consumer has already
4537
- * decided this field is in error. Takes precedence over `errors`. */
4538
- readonly error: _angular_core.InputSignal<string>;
4539
- /** Advisory text, shown when there is no error. */
4540
- readonly warning: _angular_core.InputSignal<string>;
4541
- /** Validation errors, shown once the user has interacted. Bound automatically
4542
- * by signal forms; reactive and template-driven forms are read through
4543
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4544
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4545
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4546
- * `errors`, so a `required` error does not greet an untouched form. */
4547
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4548
- /** Reserve the message-row height even when empty, so the field doesn't shift
4549
- * the layout below it when a hint/error appears. Falls back to
4550
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4551
- * for a form that shows validation messages. */
4552
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4553
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4554
4561
  private readonly track;
4555
4562
  private dragging;
4556
4563
  protected readonly uid: string;
@@ -4578,7 +4585,7 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
4578
4585
  private setThumb;
4579
4586
  private snap;
4580
4587
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
4581
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4588
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4582
4589
  }
4583
4590
 
4584
4591
  declare class LoadingOverlayComponent {
@@ -4660,28 +4667,9 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4660
4667
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4661
4668
  /** Accessible name for the trigger button and panel. */
4662
4669
  readonly ariaLabel: _angular_core.InputSignal<string>;
4663
- /** Applies error styling and marks the trigger `aria-invalid`. */
4664
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4665
- /** Helper text shown below the trigger. */
4666
- readonly hint: _angular_core.InputSignal<string>;
4667
- /** Error text. Shown immediately — binding it says the consumer has already
4668
- * decided this field is in error. Takes precedence over `errors`. */
4669
- readonly error: _angular_core.InputSignal<string>;
4670
- /** Advisory text, shown when there is no error. */
4671
- readonly warning: _angular_core.InputSignal<string>;
4672
- /** Validation errors, shown once the user has interacted. Bound automatically
4673
- * by signal forms; reactive and template-driven forms are read through
4674
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4675
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4676
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4677
- * `errors`, so a `required` error does not greet an untouched form. */
4678
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4679
- /** Reserve the message-row height even when empty, so the field doesn't shift
4680
- * the layout below it when a hint/error appears. Falls back to
4681
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4682
- * for a form that shows validation messages. */
4683
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4684
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4670
+ /** Confirmation text, shown when there is no error or warning — and it paints
4671
+ * the field's success border. A string like `warning`: the text IS the state. */
4672
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4685
4673
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
4686
4674
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4687
4675
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -4724,7 +4712,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4724
4712
  private updateHue;
4725
4713
  private clampPct;
4726
4714
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
4727
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4715
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4728
4716
  }
4729
4717
 
4730
4718
  interface MultiSelectOption extends DsOption<string> {
@@ -4747,34 +4735,19 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4747
4735
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
4748
4736
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4749
4737
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4750
- * A NUMBER caps at exactly that many, which is what you want when the trigger's
4751
- * height must be predictable whatever the width. `null` shows every chip and
4752
- * lets the trigger grow a line per selection. */
4753
- 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>;
4754
4746
  /** Disables the trigger and blocks all interaction. */
4755
4747
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4756
- /** Applies error styling and marks the field `aria-invalid`. */
4757
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4758
- /** Helper text shown below the field. */
4759
- readonly hint: _angular_core.InputSignal<string>;
4760
- /** Error text. Shown immediately — binding it says the consumer has already
4761
- * decided this field is in error. Takes precedence over `errors`. */
4762
- readonly error: _angular_core.InputSignal<string>;
4763
- /** Advisory text, shown when there is no error. */
4764
- readonly warning: _angular_core.InputSignal<string>;
4765
- /** Validation errors, shown once the user has interacted. Bound automatically
4766
- * by signal forms; reactive and template-driven forms are read through
4767
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4768
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4769
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4770
- * `errors`, so a `required` error does not greet an untouched form. */
4771
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4772
- /** Reserve the message-row height even when empty, so the field doesn't shift
4773
- * the layout below it when a hint/error appears. Falls back to
4774
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4775
- * for a form that shows validation messages. */
4776
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4777
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4748
+ /** Confirmation text, shown when there is no error or warning — and it paints
4749
+ * the field's success border. A string like `warning`: the text IS the state. */
4750
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4778
4751
  /** Accessible name for the trigger — falls back to `placeholder`. */
4779
4752
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4780
4753
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -4794,11 +4767,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4794
4767
  ngOnDestroy(): void;
4795
4768
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4796
4769
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4770
+ private readonly chipsMode;
4771
+ private readonly showsEveryChip;
4797
4772
  /** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise —
4798
4773
  * "at most N" — so the row still measures and shows only what the trigger is
4799
4774
  * wide enough for. Without that, a phone-width trigger honoured the count and
4800
4775
  * wrapped the text input onto a second line, which is the one thing the cap
4801
- * exists to prevent. `null` opts out of measuring and grows, as documented. */
4776
+ * exists to prevent. */
4802
4777
  protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4803
4778
  /** How many chips the row is ASKED to render before measuring: everything for
4804
4779
  * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
@@ -4832,7 +4807,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4832
4807
  protected close(cause?: DsOverlayCloseCause): void;
4833
4808
  private moveActive;
4834
4809
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
4835
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4810
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4836
4811
  }
4837
4812
 
4838
4813
  declare class SkeletonComponent {
@@ -4866,32 +4841,10 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4866
4841
  readonly name: _angular_core.InputSignal<string | null>;
4867
4842
  /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
4868
4843
  readonly inputId: _angular_core.InputSignal<string | null>;
4869
- /** Applies error styling and marks the input `aria-invalid`. */
4870
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4871
- /** Helper text shown below the checkbox. */
4872
- readonly hint: _angular_core.InputSignal<string>;
4873
- /** Error text. Shown immediately — binding it says the consumer has already
4874
- * decided this field is in error. Takes precedence over `errors`. */
4875
- readonly error: _angular_core.InputSignal<string>;
4876
- /** Advisory text, shown when there is no error. */
4877
- readonly warning: _angular_core.InputSignal<string>;
4878
- /** Validation errors, shown once the user has interacted. Bound automatically
4879
- * by signal forms; reactive and template-driven forms are read through
4880
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4881
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4882
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4883
- * `errors`, so a `required` error does not greet an untouched form. */
4884
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4885
- /** Reserve the message-row height even when empty, so the field doesn't shift
4886
- * the layout below it when a hint/error appears. Falls back to
4887
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4888
- * for a form that shows validation messages. */
4889
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4890
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4891
4844
  /** Checkbox size — sm/md/lg.
4892
4845
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4893
4846
  readonly size: _angular_core.InputSignal<DsSize | null>;
4894
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4847
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4895
4848
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4896
4849
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4897
4850
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -4907,12 +4860,19 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4907
4860
  protected readonly fieldClass: _angular_core.Signal<string>;
4908
4861
  protected onCheckedChange(event: Event): void;
4909
4862
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
4910
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4863
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4911
4864
  }
4912
4865
 
4913
- declare class RadioComponent {
4914
- /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
4915
- * derived from the group value instead. */
4866
+ declare class RadioComponent extends DsFieldBase {
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. */
4916
4876
  readonly checked: _angular_core.ModelSignal<boolean>;
4917
4877
  /** Disables the radio; a disabled parent `ds-radio-group` also disables it. */
4918
4878
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -4922,32 +4882,10 @@ declare class RadioComponent {
4922
4882
  readonly value: _angular_core.InputSignal<unknown>;
4923
4883
  /** Overrides the auto-generated id used for the input and its label's `for`. */
4924
4884
  readonly inputId: _angular_core.InputSignal<string | null>;
4925
- /** Applies error styling and marks the input `aria-invalid`. */
4926
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4927
- /** Helper text shown below the control. */
4928
- readonly hint: _angular_core.InputSignal<string>;
4929
- /** Error text. Shown immediately — binding it says the consumer has already
4930
- * decided this field is in error. Takes precedence over `errors`. */
4931
- readonly error: _angular_core.InputSignal<string>;
4932
- /** Advisory text, shown when there is no error. */
4933
- readonly warning: _angular_core.InputSignal<string>;
4934
- /** Validation errors, shown once the user has interacted. Bound automatically
4935
- * by signal forms; reactive and template-driven forms are read through
4936
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4937
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4938
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4939
- * `errors`, so a `required` error does not greet an untouched form. */
4940
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4941
- /** Reserve the message-row height even when empty, so the field doesn't shift
4942
- * the layout below it when a hint/error appears. Falls back to
4943
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4944
- * for a form that shows validation messages. */
4945
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4946
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4947
4885
  /** Control size — sm/md/lg.
4948
4886
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4949
4887
  readonly size: _angular_core.InputSignal<DsSize | null>;
4950
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4888
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4951
4889
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
4952
4890
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4953
4891
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -4972,7 +4910,7 @@ declare class RadioComponent {
4972
4910
  focus(): void;
4973
4911
  protected onSelect(): void;
4974
4912
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
4975
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4913
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4976
4914
  }
4977
4915
 
4978
4916
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -5000,28 +4938,6 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
5000
4938
  readonly name: _angular_core.InputSignal<string | null>;
5001
4939
  /** Disables the whole group. */
5002
4940
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
5003
- /** Applies error styling and marks the group `aria-invalid`. */
5004
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
5005
- /** Helper text shown below the group. */
5006
- readonly hint: _angular_core.InputSignal<string>;
5007
- /** Error text. Shown immediately — binding it says the consumer has already
5008
- * decided this field is in error. Takes precedence over `errors`. */
5009
- readonly error: _angular_core.InputSignal<string>;
5010
- /** Advisory text, shown when there is no error. */
5011
- readonly warning: _angular_core.InputSignal<string>;
5012
- /** Validation errors, shown once the user has interacted. Bound automatically
5013
- * by signal forms; reactive and template-driven forms are read through
5014
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
5015
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
5016
- /** Whether the user has interacted with the field. Bound by signal forms; gates
5017
- * `errors`, so a `required` error does not greet an untouched form. */
5018
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
5019
- /** Reserve the message-row height even when empty, so the field doesn't shift
5020
- * the layout below it when a hint/error appears. Falls back to
5021
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
5022
- * for a form that shows validation messages. */
5023
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
5024
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
5025
4941
  /** Accessible name for the group when no visible label is provided. */
5026
4942
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
5027
4943
  /** Visible group label; omit to supply your own. */
@@ -5039,7 +4955,7 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
5039
4955
  select(value: unknown): void;
5040
4956
  protected onKeydown(event: KeyboardEvent): void;
5041
4957
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
5042
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
4958
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
5043
4959
  }
5044
4960
 
5045
4961
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
@@ -5053,32 +4969,10 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
5053
4969
  readonly variant: _angular_core.InputSignal<"error" | "success" | "default">;
5054
4970
  /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
5055
4971
  readonly inputId: _angular_core.InputSignal<string | null>;
5056
- /** Applies error styling and marks the input `aria-invalid`. */
5057
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
5058
- /** Helper text shown below the switch. */
5059
- readonly hint: _angular_core.InputSignal<string>;
5060
- /** Error text. Shown immediately — binding it says the consumer has already
5061
- * decided this field is in error. Takes precedence over `errors`. */
5062
- readonly error: _angular_core.InputSignal<string>;
5063
- /** Advisory text, shown when there is no error. */
5064
- readonly warning: _angular_core.InputSignal<string>;
5065
- /** Validation errors, shown once the user has interacted. Bound automatically
5066
- * by signal forms; reactive and template-driven forms are read through
5067
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
5068
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
5069
- /** Whether the user has interacted with the field. Bound by signal forms; gates
5070
- * `errors`, so a `required` error does not greet an untouched form. */
5071
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
5072
- /** Reserve the message-row height even when empty, so the field doesn't shift
5073
- * the layout below it when a hint/error appears. Falls back to
5074
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
5075
- * for a form that shows validation messages. */
5076
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
5077
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
5078
4972
  /** Switch size — sm/md/lg.
5079
4973
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
5080
4974
  readonly size: _angular_core.InputSignal<DsSize | null>;
5081
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4975
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
5082
4976
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
5083
4977
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
5084
4978
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -5095,7 +4989,7 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
5095
4989
  protected readonly fieldClass: _angular_core.Signal<string>;
5096
4990
  protected onCheckedChange(event: Event): void;
5097
4991
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
5098
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "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; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4992
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
5099
4993
  }
5100
4994
 
5101
4995
  /**
@@ -5115,5 +5009,5 @@ declare class FieldClickFocusDirective {
5115
5009
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
5116
5010
  }
5117
5011
 
5118
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
5119
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldGroupContext, DsIconRegistry, DsOption, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
5012
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
5013
+ export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };