@ids-group-ltd/ids-design-system 0.5.0 → 0.6.0

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.
@@ -14,6 +14,7 @@ declare const ICONS: {
14
14
  readonly chevronRight: "<path d=\"m9 6 6 6-6 6\" />";
15
15
  readonly chevronLeft: "<path d=\"m15 6-6 6 6 6\" />";
16
16
  readonly chevronUp: "<path d=\"m6 15 6-6 6 6\" />";
17
+ readonly menu: "<path d=\"M4 6h16M4 12h16M4 18h16\" />";
17
18
  readonly arrowRight: "<path d=\"M5 12h14M13 6l6 6-6 6\" />";
18
19
  readonly arrowUp: "<path d=\"M12 19V5M6 11l6-6 6 6\" />";
19
20
  readonly arrowDown: "<path d=\"M12 5v14M6 13l6 6 6-6\" />";
@@ -159,6 +160,33 @@ declare abstract class DsOverlayCloseRef {
159
160
  abstract close(): void;
160
161
  }
161
162
 
163
+ /** Canonical status vocabulary shared across status-bearing components. */
164
+ type DsStatus = 'info' | 'success' | 'warning' | 'error';
165
+ /**
166
+ * Consumer-extensible registry of product status keys for ds-badge / ds-status-dot.
167
+ * The DS ships it EMPTY — no statuses are predefined. A consumer registers keys
168
+ * via declaration merging to get autocomplete on the `status` input:
169
+ *
170
+ * // inside this repo (ds-docs imports the lib as 'ds'):
171
+ * declare module 'ds' {
172
+ * interface DsStatusRegistry { planning: true; confirmed: true; }
173
+ * }
174
+ * // external consumer of the published package:
175
+ * declare module '@ids-group-ltd/ids-design-system' {
176
+ * interface DsStatusRegistry { shipped: true; delivered: true; }
177
+ * }
178
+ */
179
+ interface DsStatusRegistry {
180
+ }
181
+ /**
182
+ * The `status` input type. When the registry is empty (unaugmented) this is an
183
+ * open `string`; once a consumer augments DsStatusRegistry it narrows to the
184
+ * union of their keys (autocomplete). The tuple wrap avoids `never` distribution.
185
+ */
186
+ type DsStatusKey = [
187
+ keyof DsStatusRegistry
188
+ ] extends [never] ? string : keyof DsStatusRegistry;
189
+
162
190
  declare class IconComponent {
163
191
  private readonly sanitizer;
164
192
  private readonly registry;
@@ -215,9 +243,13 @@ declare class ButtonComponent {
215
243
  discouraged for ALL colours — prefer the global `.link` class; it stays for
216
244
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
217
245
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
246
+ /** Button height — sm/md/lg. */
218
247
  readonly size: _angular_core.InputSignal<ButtonSize>;
248
+ /** Native `<button>` `type` attribute. */
219
249
  readonly type: _angular_core.InputSignal<ButtonType>;
250
+ /** Disables the button and blocks `pressed`. */
220
251
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
252
+ /** Busy state — disables interaction and sets `aria-busy`. */
221
253
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
222
254
  /** Stretch the button to fill its container — the host becomes block-level
223
255
  and 100% wide (the inner control is already full-width). Use for mobile
@@ -226,14 +258,17 @@ declare class ButtonComponent {
226
258
  /** Accessible name — forwarded to the inner <button> as aria-label. Use when
227
259
  the visible label is absent or non-descriptive. */
228
260
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
261
+ /** Leading icon, before the projected content. */
229
262
  readonly icon: _angular_core.InputSignal<IconName | null>;
263
+ /** Trailing icon, after the projected content. */
230
264
  readonly trailingIcon: _angular_core.InputSignal<IconName | null>;
231
265
  /** ARIA `aria-haspopup`, forwarded to the inner <button> — set when this
232
266
  * button triggers a menu/dialog/listbox overlay. */
233
- readonly ariaHasPopup: _angular_core.InputSignal<"grid" | "true" | "menu" | "listbox" | "tree" | "dialog" | null>;
267
+ readonly ariaHasPopup: _angular_core.InputSignal<"menu" | "grid" | "true" | "listbox" | "tree" | "dialog" | null>;
234
268
  /** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
235
269
  * overlay's open state on a trigger button. */
236
270
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
271
+ /** Fires on click, unless `disabled` or `loading`. */
237
272
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
238
273
  /** The inner native <button>, exposed so overlay triggers can position
239
274
  * against and restore focus to the real focusable element — e.g.
@@ -250,8 +285,11 @@ declare class ButtonComponent {
250
285
  * leading icon and a projected label. Distinct from `ds-segmented` (a
251
286
  * one-of-many value toggle) — this is a standalone on/off control. */
252
287
  declare class ToggleButtonComponent {
288
+ /** Pressed (on/off) state; two-way bound. */
253
289
  readonly pressed: _angular_core.ModelSignal<boolean>;
290
+ /** Optional leading icon name. */
254
291
  readonly icon: _angular_core.InputSignal<string>;
292
+ /** Disables the toggle. */
255
293
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
256
294
  protected toggle(): void;
257
295
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleButtonComponent, never>;
@@ -269,17 +307,24 @@ type IconButtonType = 'button' | 'submit' | 'reset';
269
307
  * for labelled actions. `ariaLabel` is REQUIRED (icon-only has no text label).
270
308
  */
271
309
  declare class IconButtonComponent {
310
+ /** Icon to render — the button's only visible content. */
272
311
  readonly icon: _angular_core.InputSignal<IconName>;
312
+ /** Accessible name — required since the button has no visible text. */
273
313
  readonly ariaLabel: _angular_core.InputSignal<string>;
314
+ /** Fill style — standard (chromeless), filled, tonal, or outlined. */
274
315
  readonly variant: _angular_core.InputSignal<IconButtonVariant>;
275
316
  /** Brand/status hue family (shared with ds-button). `variant` is the fill
276
317
  axis; `color` recolours the accent the fill consumes. Default primary. */
277
318
  readonly color: _angular_core.InputSignal<ButtonColor>;
319
+ /** Button size — sm/md/lg, matches the field/button height scale. */
278
320
  readonly size: _angular_core.InputSignal<IconButtonSize>;
321
+ /** Native `button` type attribute. */
279
322
  readonly type: _angular_core.InputSignal<IconButtonType>;
323
+ /** Disables the button and blocks `pressed`. */
280
324
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
281
325
  /** Toggle state — renders the pressed/active look and sets aria-pressed. */
282
326
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
327
+ /** Fires on click, unless disabled. */
283
328
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
284
329
  protected readonly classes: _angular_core.Signal<string>;
285
330
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
@@ -288,35 +333,30 @@ declare class IconButtonComponent {
288
333
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
289
334
  }
290
335
 
291
- type BadgeLifecycle = 'planning' | 'confirmed' | 'active' | 'completed';
292
- type BadgeSemantic = 'info' | 'success' | 'warning' | 'error' | 'neutral';
293
- type BadgeVariant = BadgeLifecycle | BadgeSemantic | 'solid' | 'count';
294
-
295
336
  declare class BadgeComponent {
296
- readonly variant: _angular_core.InputSignal<BadgeVariant>;
297
- readonly withDot: _angular_core.InputSignal<boolean>;
298
- readonly solid: _angular_core.InputSignal<boolean>;
337
+ /** Consumer-defined status key; colours are wired via styles/status. Unset → neutral. */
338
+ readonly status: _angular_core.InputSignal<string | undefined>;
339
+ /** Shows a status dot; only rendered when `count` is unset. */
340
+ readonly withDot: _angular_core.InputSignalWithTransform<boolean, unknown>;
341
+ /** Solid accent fill instead of the default subtle background. */
342
+ readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
343
+ /** Numeric count to display; overrides projected content when set. */
299
344
  readonly count: _angular_core.InputSignal<number | null>;
345
+ /** Count is capped at this value, shown as `"max+"` beyond it. */
300
346
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
301
347
  /** Display text for the count, capped at max+. */
302
348
  protected readonly countDisplay: _angular_core.Signal<string | null>;
303
349
  protected readonly classes: _angular_core.Signal<string>;
304
350
  protected readonly countAriaLabel: _angular_core.Signal<string | null>;
305
351
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeComponent, never>;
306
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeComponent, "ds-badge", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "withDot": { "alias": "withDot"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
352
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeComponent, "ds-badge", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "withDot": { "alias": "withDot"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
307
353
  }
308
354
 
309
- /**
310
- * Status dot variants — sourced from components.css `.status-dot--*` modifiers.
311
- * JSX showcase exercises `active`, `warning`, `error`; CSS defines all six.
312
- */
313
- type StatusValue = 'planning' | 'confirmed' | 'active' | 'completed' | 'warning' | 'error' | 'secondary';
314
-
315
355
  declare class StatusDotComponent {
316
- readonly status: _angular_core.InputSignal<StatusValue>;
356
+ /** Consumer-defined status key; colours are wired via styles/status. */
357
+ readonly status: _angular_core.InputSignal<string | undefined>;
317
358
  /** Override the colour-only status with a human label for assistive tech. */
318
359
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
319
- protected readonly classes: _angular_core.Signal<string>;
320
360
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatusDotComponent, never>;
321
361
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusDotComponent, "ds-status-dot", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
322
362
  }
@@ -325,8 +365,11 @@ type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
325
365
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
326
366
 
327
367
  declare class AvatarComponent {
368
+ /** Diameter — xs/sm/lg apply a size class; md is the default. */
328
369
  readonly size: _angular_core.InputSignal<AvatarSize>;
370
+ /** Fallback text shown when there's no `imageUrl`. */
329
371
  readonly initials: _angular_core.InputSignal<string>;
372
+ /** Image source; shown before `initials` or `fallbackIcon` when set. */
330
373
  readonly imageUrl: _angular_core.InputSignal<string | null>;
331
374
  /** Accessible name. When omitted, the avatar is treated as decorative
332
375
  * (hidden from AT) — correct when a visible name sits beside it. */
@@ -352,7 +395,9 @@ declare class AvatarComponent {
352
395
  }
353
396
 
354
397
  declare class AvatarGroupComponent {
398
+ /** Maximum avatars shown before the rest collapse into an overflow chip. */
355
399
  readonly max: _angular_core.InputSignal<number>;
400
+ /** Total avatar count driving the `+N` overflow; null counts the projected children. */
356
401
  readonly total: _angular_core.InputSignal<number | null>;
357
402
  protected readonly overflow: _angular_core.Signal<number | null>;
358
403
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarGroupComponent, never>;
@@ -363,8 +408,11 @@ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
363
408
  type CardPadding = 'none' | 'sm' | 'md' | 'lg';
364
409
 
365
410
  declare class CardComponent {
411
+ /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
366
412
  readonly elevation: _angular_core.InputSignal<CardElevation>;
413
+ /** Inner padding preset; `null` keeps the card's default padding. */
367
414
  readonly padding: _angular_core.InputSignal<CardPadding | null>;
415
+ /** Fires the click event when `elevation` is `interactive`. */
368
416
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
369
417
  protected readonly interactive: _angular_core.Signal<boolean>;
370
418
  protected readonly classes: _angular_core.Signal<string>;
@@ -374,14 +422,23 @@ declare class CardComponent {
374
422
  }
375
423
 
376
424
  declare class StatComponent {
425
+ /** Metric name shown above the value. */
377
426
  readonly label: _angular_core.InputSignal<string>;
427
+ /** Headline metric; `unit` is appended directly after it. */
378
428
  readonly value: _angular_core.InputSignal<string | number>;
429
+ /** Change amount; sign drives the up/down arrow and color. */
379
430
  readonly delta: _angular_core.InputSignal<number | null>;
431
+ /** Suffix appended after the delta's magnitude, e.g. "vs last month". */
380
432
  readonly deltaLabel: _angular_core.InputSignal<string>;
433
+ /** Overrides the automatic up/down coloring of the delta. */
381
434
  readonly deltaTone: _angular_core.InputSignal<"secondary" | "neutral" | null>;
435
+ /** Secondary text shown below the value when there's no `delta`. */
382
436
  readonly caption: _angular_core.InputSignal<string>;
437
+ /** Suffix appended directly after `value`, e.g. "%". */
383
438
  readonly unit: _angular_core.InputSignal<string>;
384
- readonly variant: _angular_core.InputSignal<"default" | "danger">;
439
+ /** `error` applies the error color treatment. */
440
+ readonly variant: _angular_core.InputSignal<"error" | "default">;
441
+ /** Controls the stat's overall type scale. */
385
442
  readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
386
443
  protected readonly deltaClasses: _angular_core.Signal<string>;
387
444
  protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
@@ -391,11 +448,15 @@ declare class StatComponent {
391
448
  }
392
449
 
393
450
  declare class TabComponent {
451
+ /** Text shown in the tab button. */
394
452
  readonly label: _angular_core.InputSignal<string>;
453
+ /** Icon shown before the label. */
395
454
  readonly icon: _angular_core.InputSignal<IconName | null>;
455
+ /** Numeric badge shown after the label. */
396
456
  readonly count: _angular_core.InputSignal<number | null>;
397
- readonly disabled: _angular_core.InputSignal<boolean>;
398
- /** Identifier emitted by tabClose. Falls back to label when omitted. */
457
+ /** Excludes the tab from selection and keyboard navigation. */
458
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
459
+ /** Identifier emitted by tabClosed. Falls back to label when omitted. */
399
460
  readonly value: _angular_core.InputSignal<string | null>;
400
461
  readonly content: _angular_core.Signal<TemplateRef<unknown>>;
401
462
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabComponent, never>;
@@ -406,7 +467,9 @@ type TabsVariant = 'line' | 'pills';
406
467
  type TabsOrientation = 'horizontal' | 'vertical';
407
468
 
408
469
  declare class TabsComponent {
470
+ /** Index of the active tab, two-way bound. */
409
471
  readonly selectedIndex: _angular_core.ModelSignal<number>;
472
+ /** Visual style of the tab strip. */
410
473
  readonly variant: _angular_core.InputSignal<TabsVariant>;
411
474
  /** When true, a tab's content is instantiated only on first activation and
412
475
  kept alive thereafter. When false (default), all panels render eagerly. */
@@ -414,7 +477,7 @@ declare class TabsComponent {
414
477
  /** When true, the tab strip scrolls horizontally instead of wrapping. The
415
478
  active tab is scrolled into view on selection. */
416
479
  readonly scrollable: _angular_core.InputSignalWithTransform<boolean, unknown>;
417
- /** When true, each tab shows a close button. Clicking it emits tabClose with
480
+ /** When true, each tab shows a close button. Clicking it emits tabClosed with
418
481
  the tab's value (or label as fallback) and does not switch to that tab. */
419
482
  readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
420
483
  /** Controls whether the tab list and panel are stacked horizontally (default)
@@ -423,7 +486,7 @@ declare class TabsComponent {
423
486
  /** Emitted when a close button is clicked. Carries the tab's value input, or
424
487
  its label when value is not set. The host is responsible for removing the
425
488
  tab from its list. */
426
- readonly tabClose: _angular_core.OutputEmitterRef<string>;
489
+ readonly tabClosed: _angular_core.OutputEmitterRef<string>;
427
490
  private readonly host;
428
491
  private readonly uid;
429
492
  protected readonly tabs: _angular_core.Signal<readonly TabComponent[]>;
@@ -442,7 +505,7 @@ declare class TabsComponent {
442
505
  Arrow axis follows orientation: Left/Right for horizontal, Up/Down for vertical. */
443
506
  protected onKeydown(event: KeyboardEvent, index: number): void;
444
507
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
445
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClose": "tabClose"; }, ["tabs"], never, true, never>;
508
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
446
509
  }
447
510
 
448
511
  /**
@@ -507,15 +570,25 @@ type InputSize = 'sm' | 'md' | 'lg';
507
570
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
508
571
 
509
572
  declare class InputComponent extends DsControlValueAccessor<string> {
573
+ /** Text value, two-way bound. */
510
574
  readonly value: _angular_core.ModelSignal<string>;
575
+ /** Native input type — also affects the default clear button and password toggle. */
511
576
  readonly type: _angular_core.InputSignal<InputType>;
577
+ /** Field height — sm/md/lg. */
512
578
  readonly size: _angular_core.InputSignal<InputSize>;
579
+ /** Label shown above the field, or inside it when `floating`. */
513
580
  readonly label: _angular_core.InputSignal<string>;
581
+ /** Helper text shown below the field. */
514
582
  readonly hint: _angular_core.InputSignal<string>;
583
+ /** Placeholder shown when empty. */
515
584
  readonly placeholder: _angular_core.InputSignal<string>;
516
- readonly disabled: _angular_core.InputSignal<boolean>;
585
+ /** Disables the field and blocks all interaction. */
586
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
587
+ /** Prevents editing while still allowing focus and selection. */
517
588
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
518
- readonly invalid: _angular_core.InputSignal<boolean>;
589
+ /** Applies error styling and marks the field `aria-invalid`. */
590
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
591
+ /** Applies success styling to the field. */
519
592
  readonly success: _angular_core.InputSignalWithTransform<boolean, unknown>;
520
593
  /** Shows a trailing spinner — e.g. async validation in flight. The input
521
594
  * stays editable; pair with a `hint` like "Checking availability…". */
@@ -523,17 +596,26 @@ declare class InputComponent extends DsControlValueAccessor<string> {
523
596
  /** Floating-label variant — the label sits inside a taller control instead
524
597
  * of stacked above it. */
525
598
  readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
599
+ /** Reserves space for a leading addon projected into `[dsInputPrefix]`. */
526
600
  readonly withAddon: _angular_core.InputSignalWithTransform<boolean, unknown>;
601
+ /** Reserves space for a trailing addon projected into `[dsInputSuffix]`. */
527
602
  readonly withAddonRight: _angular_core.InputSignalWithTransform<boolean, unknown>;
528
- readonly required: _angular_core.InputSignal<boolean>;
529
- readonly optional: _angular_core.InputSignal<boolean>;
603
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
604
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
605
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
606
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
607
+ /** Native `name` attribute. */
530
608
  readonly name: _angular_core.InputSignal<string | null>;
609
+ /** Native `min` attribute — applies when `type="number"`. */
531
610
  readonly min: _angular_core.InputSignal<number | null>;
611
+ /** Native `max` attribute — applies when `type="number"`. */
532
612
  readonly max: _angular_core.InputSignal<number | null>;
613
+ /** Native `step` attribute — applies when `type="number"`. */
533
614
  readonly step: _angular_core.InputSignal<number | null>;
534
615
  /** Native autocomplete token (e.g. "email", "current-password"). */
535
616
  readonly autocomplete: _angular_core.InputSignal<string | null>;
536
- readonly autofocus: _angular_core.InputSignal<boolean>;
617
+ /** Focuses the field automatically on render. */
618
+ readonly autofocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
537
619
  /** Accessible name when no visible `label` is provided (falls back to the
538
620
  * placeholder so the control is never unnamed). */
539
621
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -542,6 +624,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
542
624
  readonly maxLength: _angular_core.InputSignal<number | null>;
543
625
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
544
626
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "enter" | "done" | "go" | "next" | "previous" | "send" | null>;
627
+ /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
545
628
  readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
546
629
  /** Emits when the native input loses focus. */
547
630
  readonly blurred: _angular_core.OutputEmitterRef<void>;
@@ -553,7 +636,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
553
636
  * an explicit boolean to override.
554
637
  */
555
638
  readonly clearable: _angular_core.InputSignal<boolean | null>;
639
+ /** Shows a show/hide button when `type="password"`. */
556
640
  readonly passwordToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
641
+ /** Whether the password is currently shown as plain text, two-way bound. */
557
642
  readonly passwordVisible: _angular_core.ModelSignal<boolean>;
558
643
  protected readonly canClear: _angular_core.Signal<boolean>;
559
644
  protected readonly uid: string;
@@ -577,11 +662,17 @@ declare class InputComponent extends DsControlValueAccessor<string> {
577
662
  type NumberStepperSize = 'sm' | 'md' | 'lg';
578
663
 
579
664
  declare class NumberStepperComponent {
665
+ /** Current numeric value, two-way bound. */
580
666
  readonly value: _angular_core.ModelSignal<number>;
667
+ /** Lower bound — the decrement button and typed input clamp to it. */
581
668
  readonly min: _angular_core.InputSignal<number>;
669
+ /** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
582
670
  readonly max: _angular_core.InputSignal<number | null>;
671
+ /** Amount added or subtracted per increment/decrement. */
583
672
  readonly step: _angular_core.InputSignal<number>;
673
+ /** Control height — sm/md/lg. */
584
674
  readonly size: _angular_core.InputSignal<NumberStepperSize>;
675
+ /** Disables the stepper and blocks all interaction. */
585
676
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
586
677
  /** Accessible name for the number input (the stepper has no visible label). */
587
678
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -599,21 +690,37 @@ type TextareaSize = 'sm' | 'md' | 'lg';
599
690
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
600
691
 
601
692
  declare class TextareaComponent extends DsControlValueAccessor<string> {
693
+ /** Text value, two-way bound. */
602
694
  readonly value: _angular_core.ModelSignal<string>;
695
+ /** Field height — sm/md/lg. */
603
696
  readonly size: _angular_core.InputSignal<TextareaSize>;
697
+ /** Label shown above the field. */
604
698
  readonly label: _angular_core.InputSignal<string>;
699
+ /** Helper text shown below the field. */
605
700
  readonly hint: _angular_core.InputSignal<string>;
701
+ /** Placeholder shown when empty. */
606
702
  readonly placeholder: _angular_core.InputSignal<string>;
607
- readonly disabled: _angular_core.InputSignal<boolean>;
703
+ /** Disables the field and blocks all interaction. */
704
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
705
+ /** Prevents editing while still allowing focus and selection. */
608
706
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
609
- readonly invalid: _angular_core.InputSignal<boolean>;
610
- readonly required: _angular_core.InputSignal<boolean>;
611
- readonly optional: _angular_core.InputSignal<boolean>;
707
+ /** Applies error styling and marks the field `aria-invalid`. */
708
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
709
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
710
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
711
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
712
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
713
+ /** Native `rows` attribute — visible line count. */
612
714
  readonly rows: _angular_core.InputSignal<number>;
715
+ /** Native `name` attribute. */
613
716
  readonly name: _angular_core.InputSignal<string | null>;
717
+ /** Grows the field with content instead of scrolling; forces `resize` to none. */
614
718
  readonly autosize: _angular_core.InputSignalWithTransform<boolean, unknown>;
719
+ /** Minimum height in lines when `autosize`. */
615
720
  readonly minRows: _angular_core.InputSignal<number | null>;
721
+ /** Maximum height in lines when `autosize`, beyond which it scrolls. */
616
722
  readonly maxRows: _angular_core.InputSignal<number | null>;
723
+ /** Native CSS `resize` behaviour — ignored when `autosize`. */
617
724
  readonly resize: _angular_core.InputSignal<TextareaResize>;
618
725
  /** Accessible name when no visible `label` is provided. */
619
726
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -637,14 +744,19 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
637
744
  }
638
745
 
639
746
  declare class SearchComponent {
747
+ /** Search text, two-way bound. */
640
748
  readonly value: _angular_core.ModelSignal<string>;
749
+ /** Placeholder shown when empty. */
641
750
  readonly placeholder: _angular_core.InputSignal<string>;
751
+ /** Keyboard shortcut hint rendered in a trailing `<kbd>` badge. */
642
752
  readonly shortcut: _angular_core.InputSignal<string>;
643
- readonly showIcon: _angular_core.InputSignal<boolean>;
753
+ /** Shows the leading search icon. */
754
+ readonly showIcon: _angular_core.InputSignalWithTransform<boolean, unknown>;
644
755
  /** Show an inline clear (×) button on the right when there's a value. */
645
- readonly clearable: _angular_core.InputSignal<boolean>;
756
+ readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
646
757
  /** Accessible name for the input (placeholder is not a reliable label). */
647
758
  readonly ariaLabel: _angular_core.InputSignal<string>;
759
+ /** Fires with the current value on Enter. */
648
760
  readonly submitted: _angular_core.OutputEmitterRef<string>;
649
761
  private readonly inputEl;
650
762
  protected onSubmit(): void;
@@ -681,20 +793,33 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
681
793
  private readonly overlay;
682
794
  private readonly vcr;
683
795
  protected readonly preview: DsStaticPreview;
796
+ /** Selected option's value, two-way bound. */
684
797
  readonly value: _angular_core.ModelSignal<string>;
798
+ /** Flat options or option groups rendered in the dropdown panel. */
685
799
  readonly options: _angular_core.InputSignal<SelectItem[]>;
800
+ /** Shown in the trigger when nothing is selected. */
686
801
  readonly placeholder: _angular_core.InputSignal<string>;
802
+ /** Trigger height — sm/md/lg. */
687
803
  readonly size: _angular_core.InputSignal<SelectSize>;
804
+ /** Label shown above the trigger. */
688
805
  readonly label: _angular_core.InputSignal<string>;
689
- readonly disabled: _angular_core.InputSignal<boolean>;
806
+ /** Disables the trigger and blocks all interaction. */
807
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
808
+ /** Prevents opening the dropdown while still allowing focus. */
690
809
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
691
- readonly invalid: _angular_core.InputSignal<boolean>;
810
+ /** Applies error styling and marks the trigger `aria-invalid`. */
811
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
812
+ /** Helper text shown below the trigger. */
692
813
  readonly hint: _angular_core.InputSignal<string>;
693
- readonly required: _angular_core.InputSignal<boolean>;
694
- readonly optional: _angular_core.InputSignal<boolean>;
814
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
815
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
816
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
817
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
818
+ /** Native `name` attribute forwarded to the trigger. */
695
819
  readonly name: _angular_core.InputSignal<string | null>;
696
820
  /** Accessible name when no visible `label` is provided. */
697
821
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
822
+ /** Shows an inline clear (×) button when a value is selected. */
698
823
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
699
824
  protected readonly uid: string;
700
825
  protected readonly labelId: string;
@@ -787,44 +912,55 @@ interface SortChangeEvent {
787
912
  declare class TableComponent<T extends {
788
913
  id: string;
789
914
  }> {
915
+ /** Rows to render. */
790
916
  readonly data: _angular_core.InputSignal<readonly T[]>;
917
+ /** Column definitions driving headers, cells and sorting. */
791
918
  readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
792
- readonly selectable: _angular_core.InputSignal<boolean>;
919
+ /** Adds a checkbox column for row/select-all selection. */
920
+ readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
793
921
  /** Opt-in outer border + radius. Off by default so tables flush inside a
794
922
  * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
795
923
  * When `true`, the scroll-wrap gets a `var(--border-default)` outline and
796
924
  * `var(--radius-md)` radius — useful when the table stands alone in a padded card. */
797
- readonly bordered: _angular_core.InputSignal<boolean>;
925
+ readonly bordered: _angular_core.InputSignalWithTransform<boolean, unknown>;
798
926
  /** false — no loading state.
799
927
  * 'skeleton' — first-load placeholder; rows are replaced with shimmer
800
928
  * rows that read the global --skeleton-shimmer-x driver.
801
929
  * 'overlay' — re-fetch indicator; existing rows stay visible behind
802
930
  * a translucent overlay with a centred spinner. */
803
931
  readonly loading: _angular_core.InputSignal<false | "skeleton" | "overlay">;
804
- readonly stickyHeader: _angular_core.InputSignal<boolean>;
932
+ /** Keeps the header row pinned while the body scrolls. */
933
+ readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
934
+ /** Two-way set of currently selected row ids. */
805
935
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
936
+ /** Column key currently sorted by; `null` when unsorted. */
806
937
  readonly sortKey: _angular_core.ModelSignal<string | null>;
938
+ /** Sort direction for `sortKey`. */
807
939
  readonly sortDir: _angular_core.ModelSignal<SortDir>;
940
+ /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
808
941
  readonly skeletonRows: _angular_core.InputSignal<number>;
809
942
  /** Accessible name for the table (rendered as a visually-hidden caption).
810
943
  * Without it, screen-reader users get an unlabelled table. */
811
944
  readonly caption: _angular_core.InputSignal<string>;
812
945
  /** When true, each row becomes a keyboard-operable control (role=button,
813
- * tabindex, Enter/Space → rowClick) with an accessible name from the first
946
+ * tabindex, Enter/Space → rowClicked) with an accessible name from the first
814
947
  * column. Off by default so non-navigating tables don't advertise a false
815
948
  * click affordance. */
816
- readonly rowInteractive: _angular_core.InputSignal<boolean>;
949
+ readonly rowInteractive: _angular_core.InputSignalWithTransform<boolean, unknown>;
817
950
  /** Rows per page. `null` (default) disables pagination — all rows render. */
818
951
  readonly pageSize: _angular_core.ModelSignal<number | null>;
819
952
  /** Current 1-based page. Only meaningful when `pageSize()` is set. */
820
953
  readonly page: _angular_core.ModelSignal<number>;
954
+ /** Selectable page-size choices shown in the pagination control. */
821
955
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
822
956
  /** When true, the table sorts `data()` itself; otherwise it only emits
823
957
  * `sortChange` and leaves ordering to the consumer (default). */
824
- readonly clientSort: _angular_core.InputSignal<boolean>;
958
+ readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
825
959
  /** Pin the first data column (and the select column) on horizontal scroll. */
826
- readonly stickyFirstColumn: _angular_core.InputSignal<boolean>;
827
- readonly rowClick: _angular_core.OutputEmitterRef<T>;
960
+ readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
961
+ /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
962
+ readonly rowClicked: _angular_core.OutputEmitterRef<T>;
963
+ /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
828
964
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
829
965
  /** Cell templates supplied as an explicit map instead of (or in addition to)
830
966
  * projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
@@ -893,16 +1029,23 @@ declare class TableComponent<T extends {
893
1029
  * across re-renders. Mixes column key + row index into one of five widths. */
894
1030
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
895
1031
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
896
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClick": "rowClick"; "sortChange": "sortChange"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
1032
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
897
1033
  }
898
1034
 
899
1035
  declare class PaginationComponent {
1036
+ /** Total item count, used to compute the page count. */
900
1037
  readonly total: _angular_core.InputSignal<number>;
1038
+ /** Items per page, two-way bound. */
901
1039
  readonly pageSize: _angular_core.ModelSignal<number>;
1040
+ /** 1-based active page, two-way bound. */
902
1041
  readonly currentPage: _angular_core.ModelSignal<number>;
1042
+ /** Preset choices offered in the page-size dropdown. */
903
1043
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
904
- readonly showLabel: _angular_core.InputSignal<boolean>;
1044
+ /** Shows the "Showing X–Y of Z" range label. */
1045
+ readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1046
+ /** Fires whenever the active page changes, including the reset to page 1 after a size change. */
905
1047
  readonly pageChange: _angular_core.OutputEmitterRef<number>;
1048
+ /** Fires when the page size changes via the size dropdown. */
906
1049
  readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
907
1050
  protected readonly totalPages: _angular_core.Signal<number>;
908
1051
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
@@ -927,6 +1070,20 @@ interface DateFormatSpec {
927
1070
  length: number;
928
1071
  }[];
929
1072
  }
1073
+ /** One editable digit slot in the masked field. */
1074
+ interface FieldSlot {
1075
+ type: 'D' | 'M' | 'Y';
1076
+ maxLength: number;
1077
+ }
1078
+ /** Field layout: the slots and the literal shown after each (except the last). */
1079
+ interface FieldLayout {
1080
+ slots: FieldSlot[];
1081
+ literals: string[];
1082
+ }
1083
+ interface DisplayPart {
1084
+ text: string;
1085
+ muted: boolean;
1086
+ }
930
1087
 
931
1088
  type DatePickerMode = 'single' | 'range';
932
1089
  type DatePickerSize = 'sm' | 'md' | 'lg';
@@ -951,24 +1108,43 @@ interface DayCell {
951
1108
  }
952
1109
  declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeValue | null> implements OnDestroy {
953
1110
  constructor();
1111
+ /** Field text for the DOM: fixed-width `_`-padded once any digit exists,
1112
+ * else '' (so an untouched field is genuinely empty — no error on blur,
1113
+ * nothing for AT to read out). */
1114
+ private toFieldText;
954
1115
  private readonly overlay;
955
1116
  private readonly vcr;
956
1117
  private readonly injector;
957
1118
  private readonly config;
1119
+ private readonly host;
1120
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
1121
+ * a consumer's `ds-date-picker { --ds-date-picker-panel-*: … }` reaches it. */
1122
+ private readonly panelTokens;
1123
+ /** Selection mode — single date or start/end range. */
958
1124
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1125
+ /** Trigger height — sm/md/lg. */
959
1126
  readonly size: _angular_core.InputSignal<DatePickerSize>;
1127
+ /** Selected date (single) or `[start, end]` (range), two-way bound. */
960
1128
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1129
+ /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
961
1130
  readonly placeholder: _angular_core.InputSignal<string>;
1131
+ /** Field label shown above the trigger. */
962
1132
  readonly label: _angular_core.InputSignal<string>;
1133
+ /** Helper text shown below the field. */
963
1134
  readonly hint: _angular_core.InputSignal<string>;
964
- readonly required: _angular_core.InputSignal<boolean>;
965
- readonly optional: _angular_core.InputSignal<boolean>;
1135
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
1136
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1137
+ /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
1138
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
1139
+ /** Disables the picker and blocks all interaction. */
966
1140
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1141
+ /** Applies error styling and marks the trigger `aria-invalid`. */
967
1142
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
968
1143
  /** Accessible name when no visible `label` is provided. */
969
1144
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
970
1145
  /** Bounds for the year dropdown in the calendar header. */
971
1146
  readonly minYear: _angular_core.InputSignal<number>;
1147
+ /** Upper bound for the year dropdown in the calendar header. */
972
1148
  readonly maxYear: _angular_core.InputSignal<number>;
973
1149
  /** Earliest selectable date (inclusive). Days before this are disabled. */
974
1150
  readonly minDate: _angular_core.InputSignal<Date | null>;
@@ -996,6 +1172,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
996
1172
  protected readonly resolvedLocale: _angular_core.Signal<string>;
997
1173
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
998
1174
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
1175
+ /** Slot/literal layout for the current mode — single date or doubled range. */
1176
+ protected readonly layout: _angular_core.Signal<FieldLayout>;
999
1177
  protected readonly monthNames: _angular_core.Signal<string[]>;
1000
1178
  protected readonly weekdays: _angular_core.Signal<string[]>;
1001
1179
  /** Full weekday names for the grid column headers' accessible names. */
@@ -1037,8 +1215,13 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1037
1215
  /** Format-mask placeholder (single) or the doubled range mask. */
1038
1216
  protected readonly fieldPlaceholder: _angular_core.Signal<string>;
1039
1217
  /** `size` attribute so the field hugs its mask width instead of stretching.
1040
- * Digits render with `tabular-nums` so the width never shifts as you type. */
1218
+ * +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
1219
+ * otherwise clip the last chars of the longer range mask. Digits render with
1220
+ * `tabular-nums` so the width never shifts as you type. */
1041
1221
  protected readonly fieldSize: _angular_core.Signal<number>;
1222
+ /** Per-slot overlay runs: digits at normal weight, unfilled positions
1223
+ * (format letters or `_` padding) muted — see displayParts(). */
1224
+ protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
1042
1225
  protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
1043
1226
  protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
1044
1227
  protected readonly viewMonthIndex: _angular_core.Signal<number>;
@@ -1068,17 +1251,32 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1068
1251
  ngOnDestroy(): void;
1069
1252
  protected onFieldClick(): void;
1070
1253
  protected onFieldInput(event: Event): void;
1071
- /** Backspace/Delete hop over mask separators — only digits are editable. */
1254
+ /** Per-key editing kept inside the caret's mask slot: typed digits fill their
1255
+ * own segment, Backspace/Delete never shift digits across a separator, so a
1256
+ * correction can't corrupt a neighbouring segment or fling the caret away.
1257
+ * A non-collapsed selection is handled here too (never natively erased) —
1258
+ * only IME/paste fall through to the stream re-mask in onFieldInput/onFieldPaste. */
1072
1259
  protected onFieldKeydown(event: KeyboardEvent): void;
1260
+ /** Paste digits into the segment model at the caret slot — never a global
1261
+ * flatten — so existing digits elsewhere in the field survive untouched. */
1262
+ protected onFieldPaste(event: ClipboardEvent): void;
1073
1263
  private countDigits;
1074
- private removeDigit;
1075
- /** Mask `raw`, force it into the DOM (defeats over-typing), parse and validate. */
1264
+ /** Rebuild `raw` as a digit stream (IME / other input-event fallback), split
1265
+ * per slot by its fixed width, then render fixed-width so it matches the
1266
+ * overlay — empty when no digits remain. */
1076
1267
  private commitRaw;
1268
+ /** Write masked text + caret into the DOM, then parse and validate it. */
1269
+ private applyEditedText;
1077
1270
  protected onFieldBlur(): void;
1078
- /** Force the DOM value to the mask (over-typed digits can't accumulate) and
1079
- * place the caret after `targetDigits` digits, skipping separators. */
1080
- private writeBack;
1081
- private caretAfterDigits;
1271
+ /** Force the DOM value to `text` (over-typed digits can't accumulate) and
1272
+ * place the caret at `caret`. Setting `value` first parks the caret at the
1273
+ * end, so the explicit range must follow; the later `[value]` binding writes
1274
+ * the same string, which leaves the caret untouched. */
1275
+ private writeBackText;
1276
+ /** Caret just past the last digit filled by a flat digit stream (commitRaw's
1277
+ * fallback path) — the first slot short of its max length, or the very end
1278
+ * once every slot is full. Empty segments naturally resolve to 0. */
1279
+ private caretAfterFill;
1082
1280
  /** Parse the combined range text, flag malformed segments, commit on blur. */
1083
1281
  private applyRangeText;
1084
1282
  protected prevMonth(): void;
@@ -1163,18 +1361,35 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1163
1361
  private readonly overlay;
1164
1362
  private readonly vcr;
1165
1363
  private readonly injector;
1364
+ private readonly host;
1365
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
1366
+ * a consumer's `ds-time-picker { --ds-time-picker-panel-*: … }` reaches it. */
1367
+ private readonly panelTokens;
1368
+ /** Selected time, or `[start, end]` tuple when `mode="range"`. Two-way bound. */
1166
1369
  readonly value: _angular_core.ModelSignal<string | TimeRangeValue | null>;
1370
+ /** Single time or `[start, end]` range picker. */
1167
1371
  readonly mode: _angular_core.InputSignal<TimePickerMode>;
1372
+ /** Minute increment shown in the picker columns. */
1168
1373
  readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
1374
+ /** Earliest selectable time ("HH:MM"). */
1169
1375
  readonly minTime: _angular_core.InputSignal<string | null>;
1376
+ /** Latest selectable time ("HH:MM"). */
1170
1377
  readonly maxTime: _angular_core.InputSignal<string | null>;
1378
+ /** Predicate marking individual times unselectable. */
1171
1379
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1380
+ /** Trigger height — sm/md/lg. */
1172
1381
  readonly size: _angular_core.InputSignal<TimePickerSize>;
1382
+ /** Disables the picker and blocks all interaction. */
1173
1383
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1384
+ /** Applies error styling and marks the trigger `aria-invalid`. */
1174
1385
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1386
+ /** Helper text shown below the picker. */
1175
1387
  readonly hint: _angular_core.InputSignal<string>;
1388
+ /** Shown in the trigger when no time is set. */
1176
1389
  readonly placeholder: _angular_core.InputSignal<string>;
1390
+ /** Shows an inline clear button when a value is set — single mode only. */
1177
1391
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1392
+ /** Accessible name for the trigger(s), suffixed "(from)"/"(to)" in range mode. */
1178
1393
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1179
1394
  /** Override the DS-config format for this instance. */
1180
1395
  readonly format: _angular_core.InputSignal<TimeFormat | null>;
@@ -1230,8 +1445,11 @@ declare class BreadcrumbsComponent {
1230
1445
  * Pass an explicit array to opt out of the service (per-page override).
1231
1446
  */
1232
1447
  readonly items: _angular_core.InputSignal<BreadcrumbItem[] | null>;
1448
+ /** Icon between crumbs; falls back to `DS_CONFIG.breadcrumbs.separator`, then `chevronRight`. */
1233
1449
  readonly separator: _angular_core.InputSignal<IconName | null>;
1450
+ /** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
1234
1451
  readonly clickable: _angular_core.InputSignal<boolean | null>;
1452
+ /** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
1235
1453
  readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
1236
1454
  protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
1237
1455
  protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
@@ -1265,16 +1483,22 @@ interface SidenavContract {
1265
1483
  declare const SIDENAV: InjectionToken<SidenavContract>;
1266
1484
 
1267
1485
  declare class SidenavComponent implements SidenavContract {
1268
- readonly collapsed: _angular_core.InputSignal<boolean>;
1486
+ /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
1487
+ readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
1488
+ /** Brand/logo text shown at the top of the rail. */
1269
1489
  readonly brand: _angular_core.InputSignal<string>;
1270
1490
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
1271
1491
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1272
1492
  }
1273
1493
 
1274
1494
  declare class SidenavGroupComponent {
1495
+ /** Group heading text. */
1275
1496
  readonly label: _angular_core.InputSignal<string>;
1497
+ /** Optional group icon; omit to project custom content via the `[icon]` slot instead. */
1276
1498
  readonly icon: _angular_core.InputSignal<IconName | null>;
1277
- readonly expandable: _angular_core.InputSignal<boolean>;
1499
+ /** When true, the label/icon row becomes a clickable header that expands/collapses the group. */
1500
+ readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1501
+ /** Two-way bindable open state; defaults open so a non-expandable group always shows its items. */
1278
1502
  readonly expanded: _angular_core.ModelSignal<boolean>;
1279
1503
  protected toggle(): void;
1280
1504
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavGroupComponent, never>;
@@ -1282,13 +1506,21 @@ declare class SidenavGroupComponent {
1282
1506
  }
1283
1507
 
1284
1508
  declare class SidenavItemComponent {
1509
+ /** Icon shown before the label; omit to project a custom icon via the `[icon]` slot instead. */
1285
1510
  readonly icon: _angular_core.InputSignal<IconName | null>;
1511
+ /** Visible link text; also used as the tooltip/aria-label when the rail is collapsed. */
1286
1512
  readonly label: _angular_core.InputSignal<string>;
1513
+ /** Plain `href` target, used when `routerLink` is not set. */
1287
1514
  readonly href: _angular_core.InputSignal<string>;
1515
+ /** Angular `RouterLink` target — string or array form for dynamic segments. */
1288
1516
  readonly routerLink: _angular_core.InputSignal<string | readonly unknown[] | null>;
1289
- readonly active: _angular_core.InputSignal<boolean>;
1517
+ /** Applies the active style; also drives `aria-current` when not using `routerLink`. */
1518
+ readonly active: _angular_core.InputSignalWithTransform<boolean, unknown>;
1519
+ /** Numeric count shown at the end of the item. */
1290
1520
  readonly badge: _angular_core.InputSignal<number | null>;
1291
- readonly hasAlert: _angular_core.InputSignal<boolean>;
1521
+ /** Shows an alert dot alongside the badge. */
1522
+ readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
1523
+ /** Disables the item — non-navigable and styled as inactive. */
1292
1524
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1293
1525
  private readonly sidenav;
1294
1526
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
@@ -1314,15 +1546,21 @@ declare class TopBarComponent {
1314
1546
  }
1315
1547
 
1316
1548
  declare class PageHeaderComponent {
1549
+ /** Small label shown above the title. */
1317
1550
  readonly eyebrow: _angular_core.InputSignal<string>;
1551
+ /** Page title, rendered as the `h1`. */
1318
1552
  readonly title: _angular_core.InputSignal<string>;
1553
+ /** Supporting line shown under the title. */
1319
1554
  readonly subtitle: _angular_core.InputSignal<string>;
1320
- readonly compact: _angular_core.InputSignal<boolean>;
1321
- readonly divider: _angular_core.InputSignal<boolean>;
1322
- readonly metaDivider: _angular_core.InputSignal<boolean>;
1555
+ /** Tightens spacing for dense layouts. */
1556
+ readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
1557
+ /** Shows a rule under the whole header. */
1558
+ readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
1559
+ /** Shows a rule under the meta row only. */
1560
+ readonly metaDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
1323
1561
  protected readonly classes: _angular_core.Signal<string>;
1324
1562
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageHeaderComponent, never>;
1325
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeaderComponent, "ds-page-header", never, { "eyebrow": { "alias": "eyebrow"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "metaDivider": { "alias": "metaDivider"; "required": false; "isSignal": true; }; }, {}, never, ["[breadcrumbs]", "[title-badge]", "[meta]", "[actions]", "[tabs]"], true, never>;
1563
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeaderComponent, "ds-page-header", never, { "eyebrow": { "alias": "eyebrow"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "metaDivider": { "alias": "metaDivider"; "required": false; "isSignal": true; }; }, {}, never, ["[breadcrumbs]", "[title-badge]", "[meta]", "[actions]", "[tabs]"], true, never>;
1326
1564
  }
1327
1565
 
1328
1566
  type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
@@ -1330,11 +1568,17 @@ type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
1330
1568
  declare class ModalComponent implements OnDestroy {
1331
1569
  private readonly doc;
1332
1570
  protected readonly preview: DsStaticPreview;
1571
+ /** Open state, two-way bound. */
1333
1572
  readonly open: _angular_core.ModelSignal<boolean>;
1573
+ /** Dialog width — sm/md/lg/xl/fullscreen. */
1334
1574
  readonly size: _angular_core.InputSignal<ModalSize>;
1335
- readonly danger: _angular_core.InputSignal<boolean>;
1575
+ /** Renders the error styling on the modal card. */
1576
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1577
+ /** Dialog title, shown in the header and used for `aria-labelledby`. */
1336
1578
  readonly title: _angular_core.InputSignal<string>;
1579
+ /** Fires once the close (leave) animation finishes. */
1337
1580
  readonly closed: _angular_core.OutputEmitterRef<void>;
1581
+ /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
1338
1582
  readonly confirmed: _angular_core.OutputEmitterRef<void>;
1339
1583
  /** When false, clicking the scrim does not close the modal. */
1340
1584
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1345,32 +1589,41 @@ declare class ModalComponent implements OnDestroy {
1345
1589
  /** Playing the scrim fade-out leave animation. */
1346
1590
  protected readonly closing: _angular_core.WritableSignal<boolean>;
1347
1591
  private wasOpen;
1592
+ private closeFallbackTimer;
1348
1593
  constructor();
1349
1594
  ngOnDestroy(): void;
1350
1595
  protected onClose(): void;
1351
1596
  protected onLeaveEnd(event: AnimationEvent): void;
1597
+ private finishClose;
1352
1598
  protected onBackdrop(event: MouseEvent): void;
1353
1599
  protected onEscape(): void;
1354
1600
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
1355
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "danger": { "alias": "danger"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1601
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1356
1602
  }
1357
1603
 
1358
1604
  declare class ModalCardComponent {
1605
+ /** Card width — sm/md/lg/xl/fullscreen. */
1359
1606
  readonly size: _angular_core.InputSignal<ModalSize>;
1360
- readonly danger: _angular_core.InputSignal<boolean>;
1607
+ /** Renders the error styling (icon badge and card accent). */
1608
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1609
+ /** Card title, shown in the header and used for `aria-labelledby`. */
1361
1610
  readonly title: _angular_core.InputSignal<string>;
1362
- readonly showClose: _angular_core.InputSignal<boolean>;
1611
+ /** Shows the header close button. */
1612
+ readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
1613
+ /** Icon badge shown next to the title. */
1363
1614
  readonly icon: _angular_core.InputSignal<IconName | null>;
1615
+ /** ARIA role for the dialog element. */
1364
1616
  readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog">;
1617
+ /** Fires when the header close button is clicked. */
1365
1618
  readonly closed: _angular_core.OutputEmitterRef<void>;
1366
1619
  protected readonly titleId: string;
1367
1620
  protected readonly classes: _angular_core.Signal<string>;
1368
1621
  protected onClose(): void;
1369
1622
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
1370
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "danger": { "alias": "danger"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[body]", "[impact]", "[actions]"], true, never>;
1623
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[body]", "[impact]", "[actions]"], true, never>;
1371
1624
  }
1372
1625
 
1373
- type ModalConfirmTone = 'default' | 'danger';
1626
+ type ModalConfirmTone = 'default' | 'error';
1374
1627
  interface ModalConfirmOptions {
1375
1628
  title: string;
1376
1629
  message?: string;
@@ -1396,14 +1649,22 @@ declare class ModalService {
1396
1649
  type BannerVariant = 'info' | 'success' | 'warning' | 'severe' | 'error' | 'neutral';
1397
1650
 
1398
1651
  declare class BannerComponent {
1652
+ /** Severity — drives colour, the default icon and the ARIA role/live. */
1399
1653
  readonly variant: _angular_core.InputSignal<BannerVariant>;
1654
+ /** Optional bold heading above the message. */
1400
1655
  readonly title: _angular_core.InputSignal<string>;
1401
- readonly dismissible: _angular_core.InputSignal<boolean>;
1656
+ /** Show a close button that emits `closed`. */
1657
+ readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
1658
+ /** Override the variant's default icon. */
1402
1659
  readonly icon: _angular_core.InputSignal<IconName | null>;
1403
- readonly compact: _angular_core.InputSignal<boolean>;
1660
+ /** Tighter padding, centred items, single-line title. */
1661
+ readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
1662
+ /** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
1404
1663
  readonly layout: _angular_core.InputSignal<"stacked" | "row">;
1405
- readonly accentRail: _angular_core.InputSignal<boolean>;
1406
- readonly dismissed: _angular_core.OutputEmitterRef<void>;
1664
+ /** Coloured accent rail on the leading edge; set false to hide it. */
1665
+ readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
1666
+ /** Fires when the user dismisses the banner. */
1667
+ readonly closed: _angular_core.OutputEmitterRef<void>;
1407
1668
  protected get noRail(): boolean;
1408
1669
  protected get ariaRole(): 'alert' | 'status';
1409
1670
  protected get ariaLive(): 'assertive' | 'polite';
@@ -1411,17 +1672,22 @@ declare class BannerComponent {
1411
1672
  protected readonly defaultIcon: _angular_core.Signal<IconName>;
1412
1673
  protected onDismiss(): void;
1413
1674
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BannerComponent, never>;
1414
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BannerComponent, "ds-banner", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "accentRail": { "alias": "accentRail"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[actions]"], true, never>;
1675
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BannerComponent, "ds-banner", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "accentRail": { "alias": "accentRail"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
1415
1676
  }
1416
1677
 
1417
1678
  type AlertVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
1418
1679
 
1419
1680
  declare class AlertComponent {
1681
+ /** Severity — drives colour, the default icon and the ARIA role/live. */
1420
1682
  readonly variant: _angular_core.InputSignal<AlertVariant>;
1683
+ /** Optional bold heading above the message. */
1421
1684
  readonly title: _angular_core.InputSignal<string>;
1685
+ /** Show a close button that emits `closed`. */
1422
1686
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
1687
+ /** Override the variant's default icon. */
1423
1688
  readonly icon: _angular_core.InputSignal<IconName | null>;
1424
- readonly dismissed: _angular_core.OutputEmitterRef<void>;
1689
+ /** Fires when the user dismisses the alert. */
1690
+ readonly closed: _angular_core.OutputEmitterRef<void>;
1425
1691
  protected get ariaRole(): 'alert' | 'status';
1426
1692
  protected get ariaLive(): 'assertive' | 'polite';
1427
1693
  protected readonly classes: _angular_core.Signal<string>;
@@ -1429,7 +1695,7 @@ declare class AlertComponent {
1429
1695
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
1430
1696
  protected onDismiss(): void;
1431
1697
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
1432
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[actions]"], true, never>;
1698
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
1433
1699
  }
1434
1700
 
1435
1701
  type DropzoneFileState = 'queued' | 'uploading' | 'success' | 'error';
@@ -1445,15 +1711,20 @@ interface DropzoneFile {
1445
1711
  }
1446
1712
 
1447
1713
  declare class DropzoneComponent {
1714
+ /** Native `accept` attribute — comma-separated MIME types or extensions. */
1448
1715
  readonly accept: _angular_core.InputSignal<string>;
1449
- readonly multiple: _angular_core.InputSignal<boolean>;
1716
+ /** Allows picking more than one file at once (ignored when `single`). */
1717
+ readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
1718
+ /** Files shown in the list — the consumer owns upload state and progress. */
1450
1719
  readonly files: _angular_core.ModelSignal<DropzoneFile[]>;
1451
1720
  /** Disables the dropzone: blocks all file-picking interactions and signals unavailability. */
1452
1721
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1453
1722
  /** Restricts the dropzone to a single file; narrows the panel to `--col-cap-text`. */
1454
1723
  readonly single: _angular_core.InputSignalWithTransform<boolean, unknown>;
1455
1724
  protected readonly dragOver: _angular_core.WritableSignal<boolean>;
1725
+ /** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
1456
1726
  readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
1727
+ /** Fires when the user removes a file from the list. */
1457
1728
  readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
1458
1729
  protected readonly classes: _angular_core.Signal<string>;
1459
1730
  protected onDragOver(event: DragEvent): void;
@@ -1486,11 +1757,15 @@ declare class MenuItemComponent implements OnDestroy {
1486
1757
  private readonly vcr;
1487
1758
  private readonly hostElement;
1488
1759
  private readonly button;
1760
+ /** Leading icon shown before the projected label. */
1489
1761
  readonly icon: _angular_core.InputSignal<IconName | null>;
1490
- readonly disabled: _angular_core.InputSignal<boolean>;
1491
- readonly danger: _angular_core.InputSignal<boolean>;
1762
+ /** Disables the item and excludes it from `ds-menu`'s roving-tabindex navigation. */
1763
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1764
+ /** Renders the item in an error/destructive style. */
1765
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1492
1766
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
1493
1767
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
1768
+ /** Fires on click, unless the item is disabled or opens a submenu. */
1494
1769
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
1495
1770
  /** Roving tabindex, owned by ds-menu — exactly one item is tabbable (0), the
1496
1771
  * rest -1. Defaults true so a standalone item (outside ds-menu) stays
@@ -1518,7 +1793,7 @@ declare class MenuItemComponent implements OnDestroy {
1518
1793
  private clearOpenTimer;
1519
1794
  private clearCloseTimer;
1520
1795
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
1521
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "danger": { "alias": "danger"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
1796
+ 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; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
1522
1797
  }
1523
1798
 
1524
1799
  declare class MenuDividerComponent {
@@ -1529,9 +1804,13 @@ declare class MenuDividerComponent {
1529
1804
  type EmptyStateVariant = 'none' | 'loading' | 'error' | 'locked' | 'success';
1530
1805
 
1531
1806
  declare class EmptyStateComponent {
1807
+ /** State — drives the default icon and shows a loading overlay when `'loading'`. */
1532
1808
  readonly variant: _angular_core.InputSignal<EmptyStateVariant>;
1809
+ /** Override the variant's default icon. */
1533
1810
  readonly icon: _angular_core.InputSignal<IconName | null>;
1811
+ /** Optional heading below the icon. */
1534
1812
  readonly title: _angular_core.InputSignal<string>;
1813
+ /** Optional supporting text below the title. */
1535
1814
  readonly body: _angular_core.InputSignal<string>;
1536
1815
  protected readonly classes: _angular_core.Signal<string>;
1537
1816
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
@@ -1539,17 +1818,21 @@ declare class EmptyStateComponent {
1539
1818
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "ds-empty-state", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "body": { "alias": "body"; "required": false; "isSignal": true; }; }, {}, never, ["[actions]"], true, never>;
1540
1819
  }
1541
1820
 
1542
- type ProgressVariant = 'default' | 'success' | 'warn' | 'error' | 'indeterminate';
1821
+ type ProgressVariant = 'default' | Exclude<DsStatus, 'info'>;
1543
1822
 
1544
1823
  declare class ProgressComponent {
1824
+ /** Progress 0–100; clamped, and ignored while `indeterminate`. */
1545
1825
  readonly value: _angular_core.InputSignal<number>;
1826
+ /** Colour variant — drives the success/warning/error styling. */
1546
1827
  readonly variant: _angular_core.InputSignal<ProgressVariant>;
1828
+ /** Indeterminate (unknown-duration) animation instead of a fixed `value`. */
1829
+ readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
1547
1830
  /** Accessible name for the progress bar (e.g. "Upload progress"). */
1548
1831
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1549
1832
  protected readonly clampedValue: _angular_core.Signal<number>;
1550
1833
  protected readonly isIndet: _angular_core.Signal<boolean>;
1551
1834
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProgressComponent, never>;
1552
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressComponent, "ds-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1835
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressComponent, "ds-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1553
1836
  }
1554
1837
 
1555
1838
  /** Contract that ds-accordion-item reads from its parent ds-accordion. */
@@ -1575,8 +1858,11 @@ declare class AccordionComponent implements AccordionContract {
1575
1858
  }
1576
1859
 
1577
1860
  declare class AccordionItemComponent implements AccordionItemRef {
1861
+ /** Header text shown in the toggle button. */
1578
1862
  readonly title: _angular_core.InputSignal<string>;
1863
+ /** Open state, two-way bound. */
1579
1864
  readonly expanded: _angular_core.ModelSignal<boolean>;
1865
+ /** Disables the toggle button; state stays as-is. */
1580
1866
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1581
1867
  protected readonly uid: string;
1582
1868
  protected readonly headId: string;
@@ -1589,7 +1875,7 @@ declare class AccordionItemComponent implements AccordionItemRef {
1589
1875
  /** Called by the accordion coordinator to enforce single-open mode. */
1590
1876
  closeItem(): void;
1591
1877
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionItemComponent, never>;
1592
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionItemComponent, "ds-accordion-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[badge]", "*"], true, never>;
1878
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionItemComponent, "ds-accordion-item", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, ["[badge]", "*"], true, never>;
1593
1879
  }
1594
1880
 
1595
1881
  /** Where the step caption sits relative to its node: stacked beneath it
@@ -1598,21 +1884,26 @@ type StepperLabelPosition = 'bottom' | 'inline';
1598
1884
  /** Layout axis of the stepper. */
1599
1885
  type StepperOrientation = 'horizontal' | 'vertical';
1600
1886
  declare class StepperComponent {
1887
+ /** Step labels, in order — one node is rendered per entry. */
1601
1888
  readonly steps: _angular_core.InputSignal<readonly string[]>;
1889
+ /** Zero-based index of the active step; earlier steps render as completed. */
1602
1890
  readonly current: _angular_core.InputSignal<number>;
1891
+ /** Where the step caption sits relative to its node. */
1603
1892
  readonly labelPosition: _angular_core.InputSignal<StepperLabelPosition>;
1893
+ /** Layout axis of the stepper. */
1604
1894
  readonly orientation: _angular_core.InputSignal<StepperOrientation>;
1605
1895
  /** When true, each step node renders as a button and emits its index on activation. */
1606
1896
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1607
1897
  /** Zero-based indices of steps in an error state. Error wins over completed/current/upcoming. */
1608
1898
  readonly errorSteps: _angular_core.InputSignal<readonly number[]>;
1609
- readonly stepClick: _angular_core.OutputEmitterRef<number>;
1899
+ /** Fires with a step's index when it's activated (only when `clickable`). */
1900
+ readonly stepClicked: _angular_core.OutputEmitterRef<number>;
1610
1901
  protected stepState(index: number): 'error' | 'completed' | 'current' | 'upcoming';
1611
1902
  protected nodeClass(index: number): string;
1612
1903
  protected connectorClass(index: number): string;
1613
1904
  protected onStepClick(index: number): void;
1614
1905
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<StepperComponent, never>;
1615
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<StepperComponent, "ds-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "current": { "alias": "current"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "errorSteps": { "alias": "errorSteps"; "required": false; "isSignal": true; }; }, { "stepClick": "stepClick"; }, never, never, true, never>;
1906
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<StepperComponent, "ds-stepper", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "current": { "alias": "current"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "errorSteps": { "alias": "errorSteps"; "required": false; "isSignal": true; }; }, { "stepClicked": "stepClicked"; }, never, never, true, never>;
1616
1907
  }
1617
1908
 
1618
1909
  type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
@@ -1637,8 +1928,11 @@ declare class TooltipDirective implements OnDestroy {
1637
1928
  }
1638
1929
 
1639
1930
  declare class TooltipPanelComponent {
1931
+ /** Tooltip text content. */
1640
1932
  readonly text: _angular_core.InputSignal<string>;
1933
+ /** Side of the trigger the panel is positioned on; also drives the arrow class. */
1641
1934
  readonly placement: _angular_core.InputSignal<TooltipPlacement>;
1935
+ /** Element `id`, referenced by the trigger's `aria-describedby`. */
1642
1936
  readonly panelId: _angular_core.InputSignal<string>;
1643
1937
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipPanelComponent, never>;
1644
1938
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TooltipPanelComponent, "ds-tooltip-panel", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "placement": { "alias": "placement"; "required": true; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -1649,9 +1943,14 @@ type PopoverPlacement = 'top' | 'bottom' | 'left' | 'right';
1649
1943
  declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
1650
1944
  private readonly overlay;
1651
1945
  private readonly vcr;
1946
+ private readonly host;
1652
1947
  protected readonly preview: DsStaticPreview;
1653
1948
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown> | undefined>;
1654
1949
  private ref;
1950
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
1951
+ * a consumer's `ds-popover { --ds-popover-panel-*: … }` reaches it. */
1952
+ private readonly panelTokens;
1953
+ /** Cross-axis alignment of the panel against the trigger. */
1655
1954
  readonly align: _angular_core.InputSignal<PopoverAlign>;
1656
1955
  /** Which side of the trigger the panel prefers to appear on. */
1657
1956
  readonly placement: _angular_core.InputSignal<PopoverPlacement>;
@@ -1754,13 +2053,20 @@ declare class ToastRegionComponent {
1754
2053
  * AND by static showcases that need to display a toast specimen inline.
1755
2054
  */
1756
2055
  declare class ToastComponent {
2056
+ /** Severity — drives colour, the default icon/spinner and the ARIA role/live. */
1757
2057
  readonly variant: _angular_core.InputSignal<ToastVariant>;
2058
+ /** Optional bold heading above the message. */
1758
2059
  readonly title: _angular_core.InputSignal<string>;
2060
+ /** Body text of the toast. */
1759
2061
  readonly message: _angular_core.InputSignal<string>;
1760
- readonly dismissible: _angular_core.InputSignal<boolean>;
2062
+ /** Show a close button that emits `closed`. */
2063
+ readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
2064
+ /** Override the variant's default icon. */
1761
2065
  readonly icon: _angular_core.InputSignal<IconName | null>;
2066
+ /** Optional action button rendered before the dismiss control. */
1762
2067
  readonly action: _angular_core.InputSignal<ToastAction | null>;
1763
- readonly dismissed: _angular_core.OutputEmitterRef<void>;
2068
+ /** Fires when the toast is dismissed or its action is invoked. */
2069
+ readonly closed: _angular_core.OutputEmitterRef<void>;
1764
2070
  protected readonly isLoading: _angular_core.Signal<boolean>;
1765
2071
  protected onAction(action: ToastAction): void;
1766
2072
  protected readonly classes: _angular_core.Signal<string>;
@@ -1769,7 +2075,7 @@ declare class ToastComponent {
1769
2075
  protected readonly defaultIcon: _angular_core.Signal<IconName>;
1770
2076
  protected onDismiss(): void;
1771
2077
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
1772
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ds-toast", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "action": { "alias": "action"; "required": false; "isSignal": true; }; }, { "dismissed": "dismissed"; }, never, ["*", "[actions]"], true, never>;
2078
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ds-toast", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "action": { "alias": "action"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
1773
2079
  }
1774
2080
 
1775
2081
  declare const DS_TOAST_POSITION: InjectionToken<DsToastPosition>;
@@ -1786,10 +2092,15 @@ type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
1786
2092
 
1787
2093
  declare class DrawerComponent implements OnDestroy {
1788
2094
  private readonly doc;
2095
+ /** Open state, two-way bound. */
1789
2096
  readonly open: _angular_core.ModelSignal<boolean>;
2097
+ /** Panel size — sm/md/lg. */
1790
2098
  readonly size: _angular_core.InputSignal<DrawerSize>;
2099
+ /** Edge the panel slides in from. */
1791
2100
  readonly placement: _angular_core.InputSignal<DrawerPlacement>;
2101
+ /** Drawer title, shown in the header and used for `aria-labelledby`. */
1792
2102
  readonly title: _angular_core.InputSignal<string>;
2103
+ /** Fires once the close (slide-out) animation finishes. */
1793
2104
  readonly closed: _angular_core.OutputEmitterRef<void>;
1794
2105
  protected readonly titleId: string;
1795
2106
  /** Panel is in the DOM (kept true through the slide-out). */
@@ -1797,14 +2108,16 @@ declare class DrawerComponent implements OnDestroy {
1797
2108
  /** Playing the slide-out + scrim-fade leave animation. */
1798
2109
  protected readonly closing: _angular_core.WritableSignal<boolean>;
1799
2110
  private wasOpen;
2111
+ private closeFallbackTimer;
1800
2112
  protected readonly classes: _angular_core.Signal<string>;
1801
2113
  constructor();
1802
2114
  ngOnDestroy(): void;
1803
2115
  protected onClose(): void;
1804
2116
  protected onLeaveEnd(event: AnimationEvent): void;
2117
+ private finishClose;
1805
2118
  protected onEscape(): void;
1806
2119
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerComponent, never>;
1807
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "ds-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["[drawer-body]", "[drawer-footer]"], true, never>;
2120
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "ds-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["[drawer-body]", "[drawer-footer]"], true, never>;
1808
2121
  }
1809
2122
 
1810
2123
  /** Bottom-anchored sheet — the mobile sibling of ds-drawer. Closes on scrim
@@ -1813,9 +2126,12 @@ declare class DrawerComponent implements OnDestroy {
1813
2126
  * --ds-bottom-sheet-maxw and centred; prefer ds-modal / ds-drawer for
1814
2127
  * desktop-first layouts. position: fixed resolves against the nearest
1815
2128
  * ancestor containing block, so framed hosts contain the sheet. */
1816
- declare class BottomSheetComponent {
2129
+ declare class BottomSheetComponent implements OnDestroy {
2130
+ /** Open state, two-way bound. */
1817
2131
  readonly open: _angular_core.ModelSignal<boolean>;
2132
+ /** Sheet title, shown in the header and used for `aria-labelledby`. */
1818
2133
  readonly title: _angular_core.InputSignal<string>;
2134
+ /** Fires once the close (leave) animation finishes. */
1819
2135
  readonly closed: _angular_core.OutputEmitterRef<void>;
1820
2136
  protected readonly titleId: string;
1821
2137
  /**
@@ -1842,28 +2158,37 @@ declare class BottomSheetComponent {
1842
2158
  private velocity;
1843
2159
  private previousBodyOverflow;
1844
2160
  private wasOpen;
2161
+ private closeFallbackTimer;
1845
2162
  constructor();
2163
+ ngOnDestroy(): void;
1846
2164
  protected close(): void;
1847
2165
  protected onLeaveEnd(event: AnimationEvent): void;
2166
+ private finishClose;
1848
2167
  protected onEscape(): void;
1849
2168
  protected stop(event: Event): void;
1850
2169
  protected onGrabStart(event: PointerEvent): void;
1851
2170
  protected onGrabMove(event: PointerEvent): void;
1852
2171
  protected onGrabEnd(): void;
1853
2172
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BottomSheetComponent, never>;
1854
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BottomSheetComponent, "ds-bottom-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "snapPoints": { "alias": "snapPoints"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
2173
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BottomSheetComponent, "ds-bottom-sheet", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "snapPoints": { "alias": "snapPoints"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
1855
2174
  }
1856
2175
 
1857
2176
  type TagVariant = 'solid' | 'neutral';
1858
2177
 
1859
2178
  declare class TagComponent {
2179
+ /** Fill style — `solid` for high-emphasis, `neutral` for low-emphasis chips. */
1860
2180
  readonly variant: _angular_core.InputSignal<TagVariant>;
2181
+ /** Shows a close button that emits `closed`. */
1861
2182
  readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2183
+ /** Makes the tag clickable, emitting `toggled` on click. */
1862
2184
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
2185
+ /** Applies the active/selected visual state. */
1863
2186
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
1864
2187
  /** Accessible label for the close button (e.g. "Remove Source filter"). */
1865
2188
  readonly closeLabel: _angular_core.InputSignal<string>;
2189
+ /** Fires when the close button is clicked. */
1866
2190
  readonly closed: _angular_core.OutputEmitterRef<void>;
2191
+ /** Fires on click when `interactive` is true. */
1867
2192
  readonly toggled: _angular_core.OutputEmitterRef<void>;
1868
2193
  protected onClick(): void;
1869
2194
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
@@ -1871,9 +2196,13 @@ declare class TagComponent {
1871
2196
  }
1872
2197
 
1873
2198
  declare class W3wComponent {
2199
+ /** Marker rendered before the address (e.g. the "///" glyph). */
1874
2200
  readonly prefix: _angular_core.InputSignal<string>;
2201
+ /** The three-word address, rendered after `prefix`. */
1875
2202
  readonly address: _angular_core.InputSignal<string>;
1876
- readonly copyable: _angular_core.InputSignal<boolean>;
2203
+ /** Makes the address clickable/focusable and copies `prefix` + `address` to the clipboard. */
2204
+ readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2205
+ /** Fires with `address` after a successful copy. */
1877
2206
  readonly copied: _angular_core.OutputEmitterRef<string>;
1878
2207
  protected onKeyActivate(event: Event): void;
1879
2208
  protected onCopy(): void;
@@ -1884,6 +2213,7 @@ declare class W3wComponent {
1884
2213
  type PageFooterVariant = 'default' | 'compact' | 'save';
1885
2214
 
1886
2215
  declare class PageFooterComponent {
2216
+ /** Visual style — default, compact, or the accented `save`-bar look. */
1887
2217
  readonly variant: _angular_core.InputSignal<PageFooterVariant>;
1888
2218
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageFooterComponent, never>;
1889
2219
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
@@ -1904,19 +2234,35 @@ interface AutocompleteOptionGroup<T = unknown> {
1904
2234
  declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
1905
2235
  private readonly overlay;
1906
2236
  private readonly vcr;
2237
+ private readonly host;
2238
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
2239
+ * a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
2240
+ private readonly panelTokens;
2241
+ /** Flat option list — ignored when `optionGroups` is set. */
1907
2242
  readonly options: _angular_core.InputSignal<readonly AutocompleteOption<T>[]>;
2243
+ /** Options grouped under labelled sections, rendered instead of `options`. */
1908
2244
  readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
2245
+ /** Selected value, or an array of values when `multiple`. */
1909
2246
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
1910
- readonly multiple: _angular_core.InputSignal<boolean>;
2247
+ /** Allows selecting more than one option, shown as removable tags. */
2248
+ readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
2249
+ /** Trigger height — sm/md/lg. */
1911
2250
  readonly size: _angular_core.InputSignal<AutocompleteSize>;
2251
+ /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
1912
2252
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
2253
+ /** Placeholder shown in the input when empty. */
1913
2254
  readonly placeholder: _angular_core.InputSignal<string>;
2255
+ /** Disables the trigger and blocks all interaction. */
1914
2256
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2257
+ /** Applies error styling and marks the field `aria-invalid`. */
1915
2258
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2259
+ /** Helper text shown below the field. */
1916
2260
  readonly hint: _angular_core.InputSignal<string>;
2261
+ /** Shows a "Create «text»" row when the typed text matches no option. */
1917
2262
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
1918
2263
  /** Accessible name for the combobox input. */
1919
2264
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2265
+ /** Fires with the typed text when the user picks the create-new option. */
1920
2266
  readonly create: _angular_core.OutputEmitterRef<string>;
1921
2267
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1922
2268
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -1979,6 +2325,7 @@ declare class DividerComponent {
1979
2325
 
1980
2326
  type DescriptionListOrientation = 'horizontal' | 'stacked';
1981
2327
  declare class DescriptionListComponent {
2328
+ /** horizontal = label column + value; stacked = label above value. */
1982
2329
  readonly orientation: _angular_core.InputSignal<DescriptionListOrientation>;
1983
2330
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DescriptionListComponent, never>;
1984
2331
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<DescriptionListComponent, "ds-description-list", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -1986,7 +2333,9 @@ declare class DescriptionListComponent {
1986
2333
 
1987
2334
  declare class DescriptionItemComponent {
1988
2335
  private readonly list;
2336
+ /** The label. Plain text; rich values go in the projected content. */
1989
2337
  readonly term: _angular_core.InputSignal<string>;
2338
+ /** When set, a copy button appears that copies this string to the clipboard. */
1990
2339
  readonly copyValue: _angular_core.InputSignal<string | null>;
1991
2340
  protected readonly stacked: _angular_core.Signal<boolean>;
1992
2341
  protected readonly copied: _angular_core.WritableSignal<boolean>;
@@ -2030,8 +2379,11 @@ interface SegmentedOption {
2030
2379
  }
2031
2380
 
2032
2381
  declare class SegmentedComponent {
2382
+ /** Segments to render — each needs a `label` and `value`, optional `icon`/`disabled`. */
2033
2383
  readonly options: _angular_core.InputSignal<readonly SegmentedOption[]>;
2384
+ /** Selected segment's `value`, two-way bound. */
2034
2385
  readonly value: _angular_core.ModelSignal<string>;
2386
+ /** Accessible name for the segmented control (radiogroup role). */
2035
2387
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2036
2388
  private readonly buttons;
2037
2389
  protected readonly focusableValue: _angular_core.Signal<string | null>;
@@ -2043,23 +2395,31 @@ declare class SegmentedComponent {
2043
2395
  }
2044
2396
 
2045
2397
  declare class ButtonGroupComponent {
2398
+ /** Accessible name for the group, set as `aria-label` on the `role="group"` host. */
2046
2399
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2047
2400
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonGroupComponent, never>;
2048
2401
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonGroupComponent, "ds-button-group", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2049
2402
  }
2050
2403
 
2051
2404
  declare class ListComponent {
2405
+ /** Draw a hairline separator between adjacent items. */
2052
2406
  readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2053
2407
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
2054
2408
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "ds-list", never, { "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2055
2409
  }
2056
2410
 
2057
2411
  declare class ListItemComponent {
2412
+ /** Convenience text; richer middle content can be projected as default content. */
2058
2413
  readonly title: _angular_core.InputSignal<string>;
2414
+ /** Secondary line below `title`. */
2059
2415
  readonly subtitle: _angular_core.InputSignal<string>;
2416
+ /** Whole-row navigation: renders an inner button and emits `activated`. */
2060
2417
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2418
+ /** Marks the row current via `aria-current`. */
2061
2419
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
2420
+ /** Disables the row; only affects the button when `clickable`. */
2062
2421
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2422
+ /** Fires when the clickable row's button is activated. */
2063
2423
  readonly activated: _angular_core.OutputEmitterRef<void>;
2064
2424
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListItemComponent, never>;
2065
2425
  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>;
@@ -2071,23 +2431,30 @@ interface SplitButtonItem {
2071
2431
  value?: string;
2072
2432
  icon?: IconName;
2073
2433
  disabled?: boolean;
2074
- danger?: boolean;
2434
+ error?: boolean;
2075
2435
  }
2076
2436
 
2077
2437
  declare class SplitButtonComponent {
2438
+ /** Label text on the main button. */
2078
2439
  readonly label: _angular_core.InputSignal<string>;
2440
+ /** Visual style — primary (solid) or outline. */
2079
2441
  readonly variant: _angular_core.InputSignal<SplitButtonVariant>;
2442
+ /** Icon shown on the main button, before the label. */
2080
2443
  readonly icon: _angular_core.InputSignal<IconName | null>;
2444
+ /** Disables both the main button and the dropdown trigger. */
2081
2445
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2446
+ /** Items listed in the dropdown menu. */
2082
2447
  readonly menuItems: _angular_core.InputSignal<readonly SplitButtonItem[]>;
2083
2448
  /** Accessible name for the dropdown trigger. */
2084
2449
  readonly menuLabel: _angular_core.InputSignal<string>;
2450
+ /** Fires when the main button (not the dropdown trigger) is clicked. */
2085
2451
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
2086
- readonly itemSelect: _angular_core.OutputEmitterRef<SplitButtonItem>;
2452
+ /** Fires with the chosen menu item. */
2453
+ readonly itemSelected: _angular_core.OutputEmitterRef<SplitButtonItem>;
2087
2454
  protected onItemSelect(item: SplitButtonItem): void;
2088
2455
  protected onTriggerKeydown(event: KeyboardEvent, popover: PopoverComponent, trigger: HTMLElement): void;
2089
2456
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SplitButtonComponent, never>;
2090
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SplitButtonComponent, "ds-split-button", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "menuItems": { "alias": "menuItems"; "required": false; "isSignal": true; }; "menuLabel": { "alias": "menuLabel"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; "itemSelect": "itemSelect"; }, never, ["*"], true, never>;
2457
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SplitButtonComponent, "ds-split-button", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "menuItems": { "alias": "menuItems"; "required": false; "isSignal": true; }; "menuLabel": { "alias": "menuLabel"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; "itemSelected": "itemSelected"; }, never, ["*"], true, never>;
2091
2458
  }
2092
2459
 
2093
2460
  declare class TimelineComponent {
@@ -2097,9 +2464,13 @@ declare class TimelineComponent {
2097
2464
 
2098
2465
  type TimelineTone = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'muted';
2099
2466
  declare class TimelineItemComponent {
2467
+ /** Primary text for the entry. */
2100
2468
  readonly heading: _angular_core.InputSignal<string>;
2469
+ /** Timestamp or date label shown below the content. */
2101
2470
  readonly time: _angular_core.InputSignal<string>;
2471
+ /** Icon shown in the marker; omit for a plain dot. */
2102
2472
  readonly icon: _angular_core.InputSignal<IconName | null>;
2473
+ /** Semantic accent color for the marker. */
2103
2474
  readonly tone: _angular_core.InputSignal<TimelineTone>;
2104
2475
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineItemComponent, never>;
2105
2476
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineItemComponent, "ds-timeline-item", never, { "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -2107,14 +2478,23 @@ declare class TimelineItemComponent {
2107
2478
 
2108
2479
  type OtpMode = 'numeric' | 'alphanumeric';
2109
2480
  declare class OtpInputComponent extends DsControlValueAccessor<string> {
2481
+ /** Entered code, two-way bound. */
2110
2482
  readonly value: _angular_core.ModelSignal<string>;
2483
+ /** Number of character cells. */
2111
2484
  readonly length: _angular_core.InputSignal<number>;
2485
+ /** Restricts input and the mobile keyboard to digits-only, or allows letters too. */
2112
2486
  readonly mode: _angular_core.InputSignal<OtpMode>;
2487
+ /** Renders each cell as a password dot instead of the typed character. */
2113
2488
  readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
2489
+ /** Disables all cells and blocks interaction. */
2114
2490
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2491
+ /** Applies error styling and marks each cell `aria-invalid`. */
2115
2492
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2493
+ /** Helper text shown below the cells. */
2116
2494
  readonly hint: _angular_core.InputSignal<string>;
2495
+ /** Accessible group label for the cell row. */
2117
2496
  readonly ariaLabel: _angular_core.InputSignal<string>;
2497
+ /** Fires once, with the full code, on the partial → complete transition. */
2118
2498
  readonly completed: _angular_core.OutputEmitterRef<string>;
2119
2499
  private readonly boxes;
2120
2500
  private wasComplete;
@@ -2141,14 +2521,23 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2141
2521
 
2142
2522
  type SliderValue = number | readonly [number, number];
2143
2523
  declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2524
+ /** Current value, or `[low, high]` when `range`. Two-way bound. */
2144
2525
  readonly value: _angular_core.ModelSignal<SliderValue>;
2526
+ /** Minimum selectable value. */
2145
2527
  readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
2528
+ /** Maximum selectable value. */
2146
2529
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
2530
+ /** Increment applied when dragging (snap) or nudging with arrow keys. */
2147
2531
  readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
2532
+ /** Two-thumb range mode — `value` becomes a `[low, high]` tuple. */
2148
2533
  readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
2534
+ /** Disables the slider and blocks all interaction. */
2149
2535
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2536
+ /** Accessible name for the thumb(s) — suffixed "minimum"/"maximum" in `range` mode. */
2150
2537
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2151
- readonly invalid: _angular_core.InputSignal<boolean>;
2538
+ /** Applies error styling. */
2539
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2540
+ /** Helper text shown below the slider. */
2152
2541
  readonly hint: _angular_core.InputSignal<string>;
2153
2542
  private readonly track;
2154
2543
  private dragging;
@@ -2181,10 +2570,15 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2181
2570
  type SpinnerSize = 'sm' | 'md' | 'lg';
2182
2571
 
2183
2572
  declare class LoadingOverlayComponent {
2573
+ /** Show the scrim + spinner over the projected region. */
2184
2574
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
2575
+ /** Optional caption beneath the spinner. */
2185
2576
  readonly label: _angular_core.InputSignal<string>;
2577
+ /** Backdrop-blur the projected content behind the scrim. */
2186
2578
  readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
2579
+ /** Size of the spinner shown in the scrim. */
2187
2580
  readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
2581
+ /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
2188
2582
  readonly insetTop: _angular_core.InputSignal<string>;
2189
2583
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
2190
2584
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -2206,10 +2600,14 @@ interface VisibleNode {
2206
2600
  }
2207
2601
  declare class TreeComponent {
2208
2602
  private readonly host;
2603
+ /** Root-level nodes; nest via `children`. */
2209
2604
  readonly nodes: _angular_core.InputSignal<readonly TreeNode[]>;
2605
+ /** Two-way set of currently expanded node ids. */
2210
2606
  readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
2607
+ /** Two-way id of the currently selected node. */
2211
2608
  readonly selectedId: _angular_core.ModelSignal<string | null>;
2212
- readonly nodeSelect: _angular_core.OutputEmitterRef<TreeNode>;
2609
+ /** Fires with the node when a row is selected (click or Enter/Space). */
2610
+ readonly nodeSelected: _angular_core.OutputEmitterRef<TreeNode>;
2213
2611
  private readonly activeId;
2214
2612
  protected readonly visibleNodes: _angular_core.Signal<VisibleNode[]>;
2215
2613
  protected readonly effectiveActiveId: _angular_core.Signal<string>;
@@ -2224,7 +2622,7 @@ declare class TreeComponent {
2224
2622
  private moveToParent;
2225
2623
  private focusNode;
2226
2624
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeComponent, never>;
2227
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeComponent, "ds-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectedId": "selectedIdChange"; "nodeSelect": "nodeSelect"; }, never, never, true, never>;
2625
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeComponent, "ds-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selectedId": { "alias": "selectedId"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectedId": "selectedIdChange"; "nodeSelected": "nodeSelected"; }, never, never, true, never>;
2228
2626
  }
2229
2627
 
2230
2628
  /** Hue 0–360, saturation/value 0–100 — the model the Photoshop-style picker
@@ -2239,11 +2637,20 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2239
2637
  private readonly overlay;
2240
2638
  private readonly vcr;
2241
2639
  private readonly host;
2640
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
2641
+ * a consumer's `ds-color-picker { --ds-color-picker-panel-*: … }` reaches it. */
2642
+ private readonly panelTokens;
2643
+ /** Selected colour as a hex string, two-way bound. */
2242
2644
  readonly value: _angular_core.ModelSignal<string>;
2645
+ /** Swatches shown in the panel — defaults to a built-in palette. */
2243
2646
  readonly presets: _angular_core.InputSignal<readonly string[]>;
2647
+ /** Disables the trigger and blocks all interaction. */
2244
2648
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2649
+ /** Accessible name for the trigger button and panel. */
2245
2650
  readonly ariaLabel: _angular_core.InputSignal<string>;
2246
- readonly invalid: _angular_core.InputSignal<boolean>;
2651
+ /** Applies error styling and marks the trigger `aria-invalid`. */
2652
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2653
+ /** Helper text shown below the trigger. */
2247
2654
  readonly hint: _angular_core.InputSignal<string>;
2248
2655
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
2249
2656
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
@@ -2296,15 +2703,29 @@ interface MultiSelectOption {
2296
2703
  declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
2297
2704
  private readonly overlay;
2298
2705
  private readonly vcr;
2706
+ private readonly host;
2707
+ /** Public panel tokens forwarded onto the portaled overlay pane on open so
2708
+ * a consumer's `ds-multi-select { --ds-multi-select-panel-*: … }` reaches it. */
2709
+ private readonly panelTokens;
2710
+ /** Selected values, two-way bound. */
2299
2711
  readonly value: _angular_core.ModelSignal<string[]>;
2712
+ /** Options shown in the panel. */
2300
2713
  readonly options: _angular_core.InputSignal<readonly MultiSelectOption[]>;
2714
+ /** Placeholder shown in the trigger when nothing is selected. */
2301
2715
  readonly placeholder: _angular_core.InputSignal<string>;
2716
+ /** Placeholder for the in-panel filter input. */
2302
2717
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
2718
+ /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all. */
2303
2719
  readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
2720
+ /** Disables the trigger and blocks all interaction. */
2304
2721
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2722
+ /** Applies error styling and marks the field `aria-invalid`. */
2305
2723
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2724
+ /** Helper text shown below the field. */
2306
2725
  readonly hint: _angular_core.InputSignal<string>;
2726
+ /** Accessible name for the trigger — falls back to `placeholder`. */
2307
2727
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2728
+ /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
2308
2729
  readonly selectAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
2309
2730
  protected readonly uid: string;
2310
2731
  protected readonly listboxId: string;
@@ -2345,15 +2766,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
2345
2766
  }
2346
2767
 
2347
2768
  declare class SkeletonComponent {
2769
+ /** CSS width of the placeholder (e.g. `'120px'`, `'50%'`). */
2348
2770
  readonly width: _angular_core.InputSignal<string | undefined>;
2771
+ /** CSS height of the placeholder. */
2349
2772
  readonly height: _angular_core.InputSignal<string | undefined>;
2350
- readonly circle: _angular_core.InputSignal<boolean>;
2351
- readonly inline: _angular_core.InputSignal<boolean>;
2773
+ /** Pill radius, for avatar/dot-shaped placeholders. */
2774
+ readonly circle: _angular_core.InputSignalWithTransform<boolean, unknown>;
2775
+ /** `display: inline-block` instead of `block`, to sit inline with text. */
2776
+ readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
2352
2777
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkeletonComponent, never>;
2353
2778
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonComponent, "ds-skeleton", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "circle": { "alias": "circle"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2354
2779
  }
2355
2780
 
2356
2781
  declare class SpinnerComponent {
2782
+ /** Spinner size — sm/md/lg. */
2357
2783
  readonly size: _angular_core.InputSignal<SpinnerSize>;
2358
2784
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
2359
2785
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -2362,14 +2788,23 @@ declare class SpinnerComponent {
2362
2788
  type CheckboxSize = 'sm' | 'md' | 'lg';
2363
2789
 
2364
2790
  declare class CheckboxComponent extends DsBooleanControlValueAccessor {
2791
+ /** Checked state, two-way bound. */
2365
2792
  readonly checked: _angular_core.ModelSignal<boolean>;
2366
- readonly indeterminate: _angular_core.InputSignal<boolean>;
2367
- readonly disabled: _angular_core.InputSignal<boolean>;
2793
+ /** Shows the partial/mixed visual state — independent of `checked`. */
2794
+ readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2795
+ /** Disables the checkbox and blocks all interaction. */
2796
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2797
+ /** Native `name` attribute. */
2368
2798
  readonly name: _angular_core.InputSignal<string | null>;
2799
+ /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
2369
2800
  readonly inputId: _angular_core.InputSignal<string | null>;
2801
+ /** Applies error styling and marks the input `aria-invalid`. */
2370
2802
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2803
+ /** Helper text shown below the checkbox. */
2371
2804
  readonly hint: _angular_core.InputSignal<string>;
2805
+ /** Checkbox size — sm/md/lg. */
2372
2806
  readonly size: _angular_core.InputSignal<CheckboxSize>;
2807
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
2373
2808
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2374
2809
  /** Inline label rendered beside the box and wired via for/id. Omit to
2375
2810
  * bring your own <label>. */
@@ -2391,13 +2826,21 @@ declare class RadioComponent {
2391
2826
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
2392
2827
  * derived from the group value instead. */
2393
2828
  readonly checked: _angular_core.ModelSignal<boolean>;
2394
- readonly disabled: _angular_core.InputSignal<boolean>;
2829
+ /** Disables the radio; a disabled parent `ds-radio-group` also disables it. */
2830
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2831
+ /** Native `name` attribute — overridden by the group's name when inside `ds-radio-group`. */
2395
2832
  readonly name: _angular_core.InputSignal<string>;
2833
+ /** Value compared against the group's selection when inside `ds-radio-group`. */
2396
2834
  readonly value: _angular_core.InputSignal<unknown>;
2835
+ /** Overrides the auto-generated id used for the input and its label's `for`. */
2397
2836
  readonly inputId: _angular_core.InputSignal<string | null>;
2837
+ /** Applies error styling and marks the input `aria-invalid`. */
2398
2838
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2839
+ /** Helper text shown below the control. */
2399
2840
  readonly hint: _angular_core.InputSignal<string>;
2841
+ /** Control size — sm/md/lg. */
2400
2842
  readonly size: _angular_core.InputSignal<RadioSize>;
2843
+ /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
2401
2844
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2402
2845
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
2403
2846
  * your own <label>. */
@@ -2441,12 +2884,19 @@ interface RadioGroupChild {
2441
2884
  declare const RADIO_GROUP: InjectionToken<RadioGroupContract>;
2442
2885
 
2443
2886
  declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implements RadioGroupContract {
2887
+ /** Selected radio value; two-way bound. */
2444
2888
  readonly value: _angular_core.ModelSignal<unknown>;
2889
+ /** Native `name` shared by every radio in the group. */
2445
2890
  readonly name: _angular_core.InputSignal<string | null>;
2891
+ /** Disables the whole group. */
2446
2892
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2893
+ /** Applies error styling and marks the group `aria-invalid`. */
2447
2894
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2895
+ /** Helper text shown below the group. */
2448
2896
  readonly hint: _angular_core.InputSignal<string>;
2897
+ /** Accessible name for the group when no visible label is provided. */
2449
2898
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2899
+ /** Visible group label; omit to supply your own. */
2450
2900
  readonly label: _angular_core.InputSignal<string>;
2451
2901
  readonly isDisabled: _angular_core.Signal<boolean>;
2452
2902
  protected readonly uid: string;
@@ -2465,14 +2915,23 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
2465
2915
  type SwitchSize = 'sm' | 'md' | 'lg';
2466
2916
 
2467
2917
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
2918
+ /** On/off state, two-way bound. */
2468
2919
  readonly checked: _angular_core.ModelSignal<boolean>;
2469
- readonly disabled: _angular_core.InputSignal<boolean>;
2920
+ /** Disables the switch and blocks all interaction. */
2921
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2922
+ /** Native `name` attribute. */
2470
2923
  readonly name: _angular_core.InputSignal<string | null>;
2924
+ /** Track colour when checked. */
2471
2925
  readonly variant: _angular_core.InputSignal<"error" | "success" | "default">;
2926
+ /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
2472
2927
  readonly inputId: _angular_core.InputSignal<string | null>;
2928
+ /** Applies error styling and marks the input `aria-invalid`. */
2473
2929
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2930
+ /** Helper text shown below the switch. */
2474
2931
  readonly hint: _angular_core.InputSignal<string>;
2932
+ /** Switch size — sm/md/lg. */
2475
2933
  readonly size: _angular_core.InputSignal<SwitchSize>;
2934
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
2476
2935
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2477
2936
  /** Inline label rendered beside the track and wired via for/id. Omit to
2478
2937
  * bring your own <label>. */
@@ -2490,4 +2949,4 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
2490
2949
  }
2491
2950
 
2492
2951
  export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BottomSheetComponent, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, 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, isSelectOptionGroup, provideDsConfig, provideDsIcons, provideDsTheme };
2493
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteSize, AutocompleteWidth, AvatarSize, AvatarStatus, BadgeLifecycle, BadgeSemantic, BadgeVariant, BannerVariant, BreadcrumbItem, ButtonColor, ButtonSize, ButtonType, ButtonVariant, CardElevation, CardPadding, CheckboxSize, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerVariant, DrawerPlacement, DrawerSize, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonSize, IconButtonType, IconButtonVariant, IconName, InputSize, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, NumberStepperSize, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RadioSize, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectSize, SidenavContract, SidenavItemModel, SortChangeEvent, SortDir, SpinnerSize, SplitButtonItem, SplitButtonVariant, StatusValue, StepperLabelPosition, StepperOrientation, SwitchSize, TableColumn, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TextareaSize, TimeFormat, TimePickerMode, TimePickerSize, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
2952
+ export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteSize, AutocompleteWidth, AvatarSize, AvatarStatus, BannerVariant, BreadcrumbItem, ButtonColor, ButtonSize, ButtonType, ButtonVariant, CardElevation, CardPadding, CheckboxSize, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DrawerSize, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonSize, IconButtonType, IconButtonVariant, IconName, InputSize, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, NumberStepperSize, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RadioSize, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectSize, SidenavContract, SidenavItemModel, SortChangeEvent, SortDir, SpinnerSize, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, SwitchSize, TableColumn, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TextareaSize, TimeFormat, TimePickerMode, TimePickerSize, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };