@ids-group-ltd/ids-design-system 0.5.1 → 0.6.1
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.
- package/CHANGELOG.md +98 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +873 -153
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.6.0.json +35 -0
- package/package.json +1 -1
- package/styles/_breakpoints.scss +14 -5
- package/styles/_layout-utils.scss +27 -7
- package/styles/_page-grid.scss +3 -0
- package/styles/_tokens.scss +3 -3
- package/styles/_typography.scss +1 -1
- package/styles/ds.scss +2 -0
- package/types/ids-group-ltd-ids-design-system.d.ts +438 -14
|
@@ -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\" />";
|
|
@@ -242,9 +243,13 @@ declare class ButtonComponent {
|
|
|
242
243
|
discouraged for ALL colours — prefer the global `.link` class; it stays for
|
|
243
244
|
cases needing the ds-button API (loading/fullWidth/typed pressed). */
|
|
244
245
|
readonly variant: _angular_core.InputSignal<ButtonVariant>;
|
|
246
|
+
/** Button height — sm/md/lg. */
|
|
245
247
|
readonly size: _angular_core.InputSignal<ButtonSize>;
|
|
248
|
+
/** Native `<button>` `type` attribute. */
|
|
246
249
|
readonly type: _angular_core.InputSignal<ButtonType>;
|
|
250
|
+
/** Disables the button and blocks `pressed`. */
|
|
247
251
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
252
|
+
/** Busy state — disables interaction and sets `aria-busy`. */
|
|
248
253
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
249
254
|
/** Stretch the button to fill its container — the host becomes block-level
|
|
250
255
|
and 100% wide (the inner control is already full-width). Use for mobile
|
|
@@ -253,14 +258,17 @@ declare class ButtonComponent {
|
|
|
253
258
|
/** Accessible name — forwarded to the inner <button> as aria-label. Use when
|
|
254
259
|
the visible label is absent or non-descriptive. */
|
|
255
260
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
261
|
+
/** Leading icon, before the projected content. */
|
|
256
262
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
263
|
+
/** Trailing icon, after the projected content. */
|
|
257
264
|
readonly trailingIcon: _angular_core.InputSignal<IconName | null>;
|
|
258
265
|
/** ARIA `aria-haspopup`, forwarded to the inner <button> — set when this
|
|
259
266
|
* button triggers a menu/dialog/listbox overlay. */
|
|
260
|
-
readonly ariaHasPopup: _angular_core.InputSignal<"
|
|
267
|
+
readonly ariaHasPopup: _angular_core.InputSignal<"menu" | "grid" | "true" | "listbox" | "tree" | "dialog" | null>;
|
|
261
268
|
/** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
|
|
262
269
|
* overlay's open state on a trigger button. */
|
|
263
270
|
readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
|
|
271
|
+
/** Fires on click, unless `disabled` or `loading`. */
|
|
264
272
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
265
273
|
/** The inner native <button>, exposed so overlay triggers can position
|
|
266
274
|
* against and restore focus to the real focusable element — e.g.
|
|
@@ -277,8 +285,11 @@ declare class ButtonComponent {
|
|
|
277
285
|
* leading icon and a projected label. Distinct from `ds-segmented` (a
|
|
278
286
|
* one-of-many value toggle) — this is a standalone on/off control. */
|
|
279
287
|
declare class ToggleButtonComponent {
|
|
288
|
+
/** Pressed (on/off) state; two-way bound. */
|
|
280
289
|
readonly pressed: _angular_core.ModelSignal<boolean>;
|
|
290
|
+
/** Optional leading icon name. */
|
|
281
291
|
readonly icon: _angular_core.InputSignal<string>;
|
|
292
|
+
/** Disables the toggle. */
|
|
282
293
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
283
294
|
protected toggle(): void;
|
|
284
295
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleButtonComponent, never>;
|
|
@@ -296,17 +307,24 @@ type IconButtonType = 'button' | 'submit' | 'reset';
|
|
|
296
307
|
* for labelled actions. `ariaLabel` is REQUIRED (icon-only has no text label).
|
|
297
308
|
*/
|
|
298
309
|
declare class IconButtonComponent {
|
|
310
|
+
/** Icon to render — the button's only visible content. */
|
|
299
311
|
readonly icon: _angular_core.InputSignal<IconName>;
|
|
312
|
+
/** Accessible name — required since the button has no visible text. */
|
|
300
313
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
314
|
+
/** Fill style — standard (chromeless), filled, tonal, or outlined. */
|
|
301
315
|
readonly variant: _angular_core.InputSignal<IconButtonVariant>;
|
|
302
316
|
/** Brand/status hue family (shared with ds-button). `variant` is the fill
|
|
303
317
|
axis; `color` recolours the accent the fill consumes. Default primary. */
|
|
304
318
|
readonly color: _angular_core.InputSignal<ButtonColor>;
|
|
319
|
+
/** Button size — sm/md/lg, matches the field/button height scale. */
|
|
305
320
|
readonly size: _angular_core.InputSignal<IconButtonSize>;
|
|
321
|
+
/** Native `button` type attribute. */
|
|
306
322
|
readonly type: _angular_core.InputSignal<IconButtonType>;
|
|
323
|
+
/** Disables the button and blocks `pressed`. */
|
|
307
324
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
308
325
|
/** Toggle state — renders the pressed/active look and sets aria-pressed. */
|
|
309
326
|
readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
327
|
+
/** Fires on click, unless disabled. */
|
|
310
328
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
311
329
|
protected readonly classes: _angular_core.Signal<string>;
|
|
312
330
|
protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
|
|
@@ -318,9 +336,13 @@ declare class IconButtonComponent {
|
|
|
318
336
|
declare class BadgeComponent {
|
|
319
337
|
/** Consumer-defined status key; colours are wired via styles/status. Unset → neutral. */
|
|
320
338
|
readonly status: _angular_core.InputSignal<string | undefined>;
|
|
339
|
+
/** Shows a status dot; only rendered when `count` is unset. */
|
|
321
340
|
readonly withDot: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
341
|
+
/** Solid accent fill instead of the default subtle background. */
|
|
322
342
|
readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
343
|
+
/** Numeric count to display; overrides projected content when set. */
|
|
323
344
|
readonly count: _angular_core.InputSignal<number | null>;
|
|
345
|
+
/** Count is capped at this value, shown as `"max+"` beyond it. */
|
|
324
346
|
readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
325
347
|
/** Display text for the count, capped at max+. */
|
|
326
348
|
protected readonly countDisplay: _angular_core.Signal<string | null>;
|
|
@@ -343,8 +365,11 @@ type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
|
|
|
343
365
|
type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
|
|
344
366
|
|
|
345
367
|
declare class AvatarComponent {
|
|
368
|
+
/** Diameter — xs/sm/lg apply a size class; md is the default. */
|
|
346
369
|
readonly size: _angular_core.InputSignal<AvatarSize>;
|
|
370
|
+
/** Fallback text shown when there's no `imageUrl`. */
|
|
347
371
|
readonly initials: _angular_core.InputSignal<string>;
|
|
372
|
+
/** Image source; shown before `initials` or `fallbackIcon` when set. */
|
|
348
373
|
readonly imageUrl: _angular_core.InputSignal<string | null>;
|
|
349
374
|
/** Accessible name. When omitted, the avatar is treated as decorative
|
|
350
375
|
* (hidden from AT) — correct when a visible name sits beside it. */
|
|
@@ -370,7 +395,9 @@ declare class AvatarComponent {
|
|
|
370
395
|
}
|
|
371
396
|
|
|
372
397
|
declare class AvatarGroupComponent {
|
|
398
|
+
/** Maximum avatars shown before the rest collapse into an overflow chip. */
|
|
373
399
|
readonly max: _angular_core.InputSignal<number>;
|
|
400
|
+
/** Total avatar count driving the `+N` overflow; null counts the projected children. */
|
|
374
401
|
readonly total: _angular_core.InputSignal<number | null>;
|
|
375
402
|
protected readonly overflow: _angular_core.Signal<number | null>;
|
|
376
403
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarGroupComponent, never>;
|
|
@@ -381,8 +408,11 @@ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
|
|
|
381
408
|
type CardPadding = 'none' | 'sm' | 'md' | 'lg';
|
|
382
409
|
|
|
383
410
|
declare class CardComponent {
|
|
411
|
+
/** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
|
|
384
412
|
readonly elevation: _angular_core.InputSignal<CardElevation>;
|
|
413
|
+
/** Inner padding preset; `null` keeps the card's default padding. */
|
|
385
414
|
readonly padding: _angular_core.InputSignal<CardPadding | null>;
|
|
415
|
+
/** Fires the click event when `elevation` is `interactive`. */
|
|
386
416
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
387
417
|
protected readonly interactive: _angular_core.Signal<boolean>;
|
|
388
418
|
protected readonly classes: _angular_core.Signal<string>;
|
|
@@ -392,14 +422,23 @@ declare class CardComponent {
|
|
|
392
422
|
}
|
|
393
423
|
|
|
394
424
|
declare class StatComponent {
|
|
425
|
+
/** Metric name shown above the value. */
|
|
395
426
|
readonly label: _angular_core.InputSignal<string>;
|
|
427
|
+
/** Headline metric; `unit` is appended directly after it. */
|
|
396
428
|
readonly value: _angular_core.InputSignal<string | number>;
|
|
429
|
+
/** Change amount; sign drives the up/down arrow and color. */
|
|
397
430
|
readonly delta: _angular_core.InputSignal<number | null>;
|
|
431
|
+
/** Suffix appended after the delta's magnitude, e.g. "vs last month". */
|
|
398
432
|
readonly deltaLabel: _angular_core.InputSignal<string>;
|
|
433
|
+
/** Overrides the automatic up/down coloring of the delta. */
|
|
399
434
|
readonly deltaTone: _angular_core.InputSignal<"secondary" | "neutral" | null>;
|
|
435
|
+
/** Secondary text shown below the value when there's no `delta`. */
|
|
400
436
|
readonly caption: _angular_core.InputSignal<string>;
|
|
437
|
+
/** Suffix appended directly after `value`, e.g. "%". */
|
|
401
438
|
readonly unit: _angular_core.InputSignal<string>;
|
|
439
|
+
/** `error` applies the error color treatment. */
|
|
402
440
|
readonly variant: _angular_core.InputSignal<"error" | "default">;
|
|
441
|
+
/** Controls the stat's overall type scale. */
|
|
403
442
|
readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
|
|
404
443
|
protected readonly deltaClasses: _angular_core.Signal<string>;
|
|
405
444
|
protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
|
|
@@ -409,9 +448,13 @@ declare class StatComponent {
|
|
|
409
448
|
}
|
|
410
449
|
|
|
411
450
|
declare class TabComponent {
|
|
451
|
+
/** Text shown in the tab button. */
|
|
412
452
|
readonly label: _angular_core.InputSignal<string>;
|
|
453
|
+
/** Icon shown before the label. */
|
|
413
454
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
455
|
+
/** Numeric badge shown after the label. */
|
|
414
456
|
readonly count: _angular_core.InputSignal<number | null>;
|
|
457
|
+
/** Excludes the tab from selection and keyboard navigation. */
|
|
415
458
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
416
459
|
/** Identifier emitted by tabClosed. Falls back to label when omitted. */
|
|
417
460
|
readonly value: _angular_core.InputSignal<string | null>;
|
|
@@ -424,7 +467,9 @@ type TabsVariant = 'line' | 'pills';
|
|
|
424
467
|
type TabsOrientation = 'horizontal' | 'vertical';
|
|
425
468
|
|
|
426
469
|
declare class TabsComponent {
|
|
470
|
+
/** Index of the active tab, two-way bound. */
|
|
427
471
|
readonly selectedIndex: _angular_core.ModelSignal<number>;
|
|
472
|
+
/** Visual style of the tab strip. */
|
|
428
473
|
readonly variant: _angular_core.InputSignal<TabsVariant>;
|
|
429
474
|
/** When true, a tab's content is instantiated only on first activation and
|
|
430
475
|
kept alive thereafter. When false (default), all panels render eagerly. */
|
|
@@ -525,15 +570,25 @@ type InputSize = 'sm' | 'md' | 'lg';
|
|
|
525
570
|
type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
|
|
526
571
|
|
|
527
572
|
declare class InputComponent extends DsControlValueAccessor<string> {
|
|
573
|
+
/** Text value, two-way bound. */
|
|
528
574
|
readonly value: _angular_core.ModelSignal<string>;
|
|
575
|
+
/** Native input type — also affects the default clear button and password toggle. */
|
|
529
576
|
readonly type: _angular_core.InputSignal<InputType>;
|
|
577
|
+
/** Field height — sm/md/lg. */
|
|
530
578
|
readonly size: _angular_core.InputSignal<InputSize>;
|
|
579
|
+
/** Label shown above the field, or inside it when `floating`. */
|
|
531
580
|
readonly label: _angular_core.InputSignal<string>;
|
|
581
|
+
/** Helper text shown below the field. */
|
|
532
582
|
readonly hint: _angular_core.InputSignal<string>;
|
|
583
|
+
/** Placeholder shown when empty. */
|
|
533
584
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
585
|
+
/** Disables the field and blocks all interaction. */
|
|
534
586
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
587
|
+
/** Prevents editing while still allowing focus and selection. */
|
|
535
588
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
589
|
+
/** Applies error styling and marks the field `aria-invalid`. */
|
|
536
590
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
591
|
+
/** Applies success styling to the field. */
|
|
537
592
|
readonly success: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
538
593
|
/** Shows a trailing spinner — e.g. async validation in flight. The input
|
|
539
594
|
* stays editable; pair with a `hint` like "Checking availability…". */
|
|
@@ -541,16 +596,25 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
541
596
|
/** Floating-label variant — the label sits inside a taller control instead
|
|
542
597
|
* of stacked above it. */
|
|
543
598
|
readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
599
|
+
/** Reserves space for a leading addon projected into `[dsInputPrefix]`. */
|
|
544
600
|
readonly withAddon: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
601
|
+
/** Reserves space for a trailing addon projected into `[dsInputSuffix]`. */
|
|
545
602
|
readonly withAddonRight: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
603
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
546
604
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
605
|
+
/** Shows an "(optional)" marker next to the label (ignored when `required`). */
|
|
547
606
|
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
607
|
+
/** Native `name` attribute. */
|
|
548
608
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
609
|
+
/** Native `min` attribute — applies when `type="number"`. */
|
|
549
610
|
readonly min: _angular_core.InputSignal<number | null>;
|
|
611
|
+
/** Native `max` attribute — applies when `type="number"`. */
|
|
550
612
|
readonly max: _angular_core.InputSignal<number | null>;
|
|
613
|
+
/** Native `step` attribute — applies when `type="number"`. */
|
|
551
614
|
readonly step: _angular_core.InputSignal<number | null>;
|
|
552
615
|
/** Native autocomplete token (e.g. "email", "current-password"). */
|
|
553
616
|
readonly autocomplete: _angular_core.InputSignal<string | null>;
|
|
617
|
+
/** Focuses the field automatically on render. */
|
|
554
618
|
readonly autofocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
555
619
|
/** Accessible name when no visible `label` is provided (falls back to the
|
|
556
620
|
* placeholder so the control is never unnamed). */
|
|
@@ -560,6 +624,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
560
624
|
readonly maxLength: _angular_core.InputSignal<number | null>;
|
|
561
625
|
/** Mobile keyboard hints — forwarded to the native input as attributes. */
|
|
562
626
|
readonly enterKeyHint: _angular_core.InputSignal<"search" | "enter" | "done" | "go" | "next" | "previous" | "send" | null>;
|
|
627
|
+
/** Native `inputmode` attribute — hints the on-screen keyboard layout. */
|
|
563
628
|
readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
|
|
564
629
|
/** Emits when the native input loses focus. */
|
|
565
630
|
readonly blurred: _angular_core.OutputEmitterRef<void>;
|
|
@@ -571,7 +636,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
571
636
|
* an explicit boolean to override.
|
|
572
637
|
*/
|
|
573
638
|
readonly clearable: _angular_core.InputSignal<boolean | null>;
|
|
639
|
+
/** Shows a show/hide button when `type="password"`. */
|
|
574
640
|
readonly passwordToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
641
|
+
/** Whether the password is currently shown as plain text, two-way bound. */
|
|
575
642
|
readonly passwordVisible: _angular_core.ModelSignal<boolean>;
|
|
576
643
|
protected readonly canClear: _angular_core.Signal<boolean>;
|
|
577
644
|
protected readonly uid: string;
|
|
@@ -595,11 +662,17 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
595
662
|
type NumberStepperSize = 'sm' | 'md' | 'lg';
|
|
596
663
|
|
|
597
664
|
declare class NumberStepperComponent {
|
|
665
|
+
/** Current numeric value, two-way bound. */
|
|
598
666
|
readonly value: _angular_core.ModelSignal<number>;
|
|
667
|
+
/** Lower bound — the decrement button and typed input clamp to it. */
|
|
599
668
|
readonly min: _angular_core.InputSignal<number>;
|
|
669
|
+
/** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
|
|
600
670
|
readonly max: _angular_core.InputSignal<number | null>;
|
|
671
|
+
/** Amount added or subtracted per increment/decrement. */
|
|
601
672
|
readonly step: _angular_core.InputSignal<number>;
|
|
673
|
+
/** Control height — sm/md/lg. */
|
|
602
674
|
readonly size: _angular_core.InputSignal<NumberStepperSize>;
|
|
675
|
+
/** Disables the stepper and blocks all interaction. */
|
|
603
676
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
604
677
|
/** Accessible name for the number input (the stepper has no visible label). */
|
|
605
678
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
@@ -617,21 +690,37 @@ type TextareaSize = 'sm' | 'md' | 'lg';
|
|
|
617
690
|
type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
|
|
618
691
|
|
|
619
692
|
declare class TextareaComponent extends DsControlValueAccessor<string> {
|
|
693
|
+
/** Text value, two-way bound. */
|
|
620
694
|
readonly value: _angular_core.ModelSignal<string>;
|
|
695
|
+
/** Field height — sm/md/lg. */
|
|
621
696
|
readonly size: _angular_core.InputSignal<TextareaSize>;
|
|
697
|
+
/** Label shown above the field. */
|
|
622
698
|
readonly label: _angular_core.InputSignal<string>;
|
|
699
|
+
/** Helper text shown below the field. */
|
|
623
700
|
readonly hint: _angular_core.InputSignal<string>;
|
|
701
|
+
/** Placeholder shown when empty. */
|
|
624
702
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
703
|
+
/** Disables the field and blocks all interaction. */
|
|
625
704
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
705
|
+
/** Prevents editing while still allowing focus and selection. */
|
|
626
706
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
707
|
+
/** Applies error styling and marks the field `aria-invalid`. */
|
|
627
708
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
709
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
628
710
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
711
|
+
/** Shows an "(optional)" marker next to the label (ignored when `required`). */
|
|
629
712
|
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
713
|
+
/** Native `rows` attribute — visible line count. */
|
|
630
714
|
readonly rows: _angular_core.InputSignal<number>;
|
|
715
|
+
/** Native `name` attribute. */
|
|
631
716
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
717
|
+
/** Grows the field with content instead of scrolling; forces `resize` to none. */
|
|
632
718
|
readonly autosize: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
719
|
+
/** Minimum height in lines when `autosize`. */
|
|
633
720
|
readonly minRows: _angular_core.InputSignal<number | null>;
|
|
721
|
+
/** Maximum height in lines when `autosize`, beyond which it scrolls. */
|
|
634
722
|
readonly maxRows: _angular_core.InputSignal<number | null>;
|
|
723
|
+
/** Native CSS `resize` behaviour — ignored when `autosize`. */
|
|
635
724
|
readonly resize: _angular_core.InputSignal<TextareaResize>;
|
|
636
725
|
/** Accessible name when no visible `label` is provided. */
|
|
637
726
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
@@ -655,14 +744,19 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
|
|
|
655
744
|
}
|
|
656
745
|
|
|
657
746
|
declare class SearchComponent {
|
|
747
|
+
/** Search text, two-way bound. */
|
|
658
748
|
readonly value: _angular_core.ModelSignal<string>;
|
|
749
|
+
/** Placeholder shown when empty. */
|
|
659
750
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
751
|
+
/** Keyboard shortcut hint rendered in a trailing `<kbd>` badge. */
|
|
660
752
|
readonly shortcut: _angular_core.InputSignal<string>;
|
|
753
|
+
/** Shows the leading search icon. */
|
|
661
754
|
readonly showIcon: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
662
755
|
/** Show an inline clear (×) button on the right when there's a value. */
|
|
663
756
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
664
757
|
/** Accessible name for the input (placeholder is not a reliable label). */
|
|
665
758
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
759
|
+
/** Fires with the current value on Enter. */
|
|
666
760
|
readonly submitted: _angular_core.OutputEmitterRef<string>;
|
|
667
761
|
private readonly inputEl;
|
|
668
762
|
protected onSubmit(): void;
|
|
@@ -699,20 +793,33 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
699
793
|
private readonly overlay;
|
|
700
794
|
private readonly vcr;
|
|
701
795
|
protected readonly preview: DsStaticPreview;
|
|
796
|
+
/** Selected option's value, two-way bound. */
|
|
702
797
|
readonly value: _angular_core.ModelSignal<string>;
|
|
798
|
+
/** Flat options or option groups rendered in the dropdown panel. */
|
|
703
799
|
readonly options: _angular_core.InputSignal<SelectItem[]>;
|
|
800
|
+
/** Shown in the trigger when nothing is selected. */
|
|
704
801
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
802
|
+
/** Trigger height — sm/md/lg. */
|
|
705
803
|
readonly size: _angular_core.InputSignal<SelectSize>;
|
|
804
|
+
/** Label shown above the trigger. */
|
|
706
805
|
readonly label: _angular_core.InputSignal<string>;
|
|
806
|
+
/** Disables the trigger and blocks all interaction. */
|
|
707
807
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
808
|
+
/** Prevents opening the dropdown while still allowing focus. */
|
|
708
809
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
810
|
+
/** Applies error styling and marks the trigger `aria-invalid`. */
|
|
709
811
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
812
|
+
/** Helper text shown below the trigger. */
|
|
710
813
|
readonly hint: _angular_core.InputSignal<string>;
|
|
814
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
711
815
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
816
|
+
/** Shows an "(optional)" marker next to the label (ignored when `required`). */
|
|
712
817
|
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
818
|
+
/** Native `name` attribute forwarded to the trigger. */
|
|
713
819
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
714
820
|
/** Accessible name when no visible `label` is provided. */
|
|
715
821
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
822
|
+
/** Shows an inline clear (×) button when a value is selected. */
|
|
716
823
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
717
824
|
protected readonly uid: string;
|
|
718
825
|
protected readonly labelId: string;
|
|
@@ -805,8 +912,11 @@ interface SortChangeEvent {
|
|
|
805
912
|
declare class TableComponent<T extends {
|
|
806
913
|
id: string;
|
|
807
914
|
}> {
|
|
915
|
+
/** Rows to render. */
|
|
808
916
|
readonly data: _angular_core.InputSignal<readonly T[]>;
|
|
917
|
+
/** Column definitions driving headers, cells and sorting. */
|
|
809
918
|
readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
|
|
919
|
+
/** Adds a checkbox column for row/select-all selection. */
|
|
810
920
|
readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
811
921
|
/** Opt-in outer border + radius. Off by default so tables flush inside a
|
|
812
922
|
* `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
|
|
@@ -819,10 +929,15 @@ declare class TableComponent<T extends {
|
|
|
819
929
|
* 'overlay' — re-fetch indicator; existing rows stay visible behind
|
|
820
930
|
* a translucent overlay with a centred spinner. */
|
|
821
931
|
readonly loading: _angular_core.InputSignal<false | "skeleton" | "overlay">;
|
|
932
|
+
/** Keeps the header row pinned while the body scrolls. */
|
|
822
933
|
readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
934
|
+
/** Two-way set of currently selected row ids. */
|
|
823
935
|
readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
|
|
936
|
+
/** Column key currently sorted by; `null` when unsorted. */
|
|
824
937
|
readonly sortKey: _angular_core.ModelSignal<string | null>;
|
|
938
|
+
/** Sort direction for `sortKey`. */
|
|
825
939
|
readonly sortDir: _angular_core.ModelSignal<SortDir>;
|
|
940
|
+
/** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
|
|
826
941
|
readonly skeletonRows: _angular_core.InputSignal<number>;
|
|
827
942
|
/** Accessible name for the table (rendered as a visually-hidden caption).
|
|
828
943
|
* Without it, screen-reader users get an unlabelled table. */
|
|
@@ -836,13 +951,16 @@ declare class TableComponent<T extends {
|
|
|
836
951
|
readonly pageSize: _angular_core.ModelSignal<number | null>;
|
|
837
952
|
/** Current 1-based page. Only meaningful when `pageSize()` is set. */
|
|
838
953
|
readonly page: _angular_core.ModelSignal<number>;
|
|
954
|
+
/** Selectable page-size choices shown in the pagination control. */
|
|
839
955
|
readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
|
|
840
956
|
/** When true, the table sorts `data()` itself; otherwise it only emits
|
|
841
957
|
* `sortChange` and leaves ordering to the consumer (default). */
|
|
842
958
|
readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
843
959
|
/** Pin the first data column (and the select column) on horizontal scroll. */
|
|
844
960
|
readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
961
|
+
/** Fires with the row on click (or Enter/Space when `rowInteractive`). */
|
|
845
962
|
readonly rowClicked: _angular_core.OutputEmitterRef<T>;
|
|
963
|
+
/** Fires whenever sort key/direction changes, regardless of `clientSort`. */
|
|
846
964
|
readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
|
|
847
965
|
/** Cell templates supplied as an explicit map instead of (or in addition to)
|
|
848
966
|
* projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
|
|
@@ -915,12 +1033,19 @@ declare class TableComponent<T extends {
|
|
|
915
1033
|
}
|
|
916
1034
|
|
|
917
1035
|
declare class PaginationComponent {
|
|
1036
|
+
/** Total item count, used to compute the page count. */
|
|
918
1037
|
readonly total: _angular_core.InputSignal<number>;
|
|
1038
|
+
/** Items per page, two-way bound. */
|
|
919
1039
|
readonly pageSize: _angular_core.ModelSignal<number>;
|
|
1040
|
+
/** 1-based active page, two-way bound. */
|
|
920
1041
|
readonly currentPage: _angular_core.ModelSignal<number>;
|
|
1042
|
+
/** Preset choices offered in the page-size dropdown. */
|
|
921
1043
|
readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
|
|
1044
|
+
/** Shows the "Showing X–Y of Z" range label. */
|
|
922
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. */
|
|
923
1047
|
readonly pageChange: _angular_core.OutputEmitterRef<number>;
|
|
1048
|
+
/** Fires when the page size changes via the size dropdown. */
|
|
924
1049
|
readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
|
|
925
1050
|
protected readonly totalPages: _angular_core.Signal<number>;
|
|
926
1051
|
protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
|
|
@@ -945,6 +1070,20 @@ interface DateFormatSpec {
|
|
|
945
1070
|
length: number;
|
|
946
1071
|
}[];
|
|
947
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
|
+
}
|
|
948
1087
|
|
|
949
1088
|
type DatePickerMode = 'single' | 'range';
|
|
950
1089
|
type DatePickerSize = 'sm' | 'md' | 'lg';
|
|
@@ -969,6 +1108,10 @@ interface DayCell {
|
|
|
969
1108
|
}
|
|
970
1109
|
declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeValue | null> implements OnDestroy {
|
|
971
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;
|
|
972
1115
|
private readonly overlay;
|
|
973
1116
|
private readonly vcr;
|
|
974
1117
|
private readonly injector;
|
|
@@ -977,20 +1120,31 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
977
1120
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
978
1121
|
* a consumer's `ds-date-picker { --ds-date-picker-panel-*: … }` reaches it. */
|
|
979
1122
|
private readonly panelTokens;
|
|
1123
|
+
/** Selection mode — single date or start/end range. */
|
|
980
1124
|
readonly mode: _angular_core.InputSignal<DatePickerMode>;
|
|
1125
|
+
/** Trigger height — sm/md/lg. */
|
|
981
1126
|
readonly size: _angular_core.InputSignal<DatePickerSize>;
|
|
1127
|
+
/** Selected date (single) or `[start, end]` (range), two-way bound. */
|
|
982
1128
|
readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
|
|
1129
|
+
/** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
|
|
983
1130
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
1131
|
+
/** Field label shown above the trigger. */
|
|
984
1132
|
readonly label: _angular_core.InputSignal<string>;
|
|
1133
|
+
/** Helper text shown below the field. */
|
|
985
1134
|
readonly hint: _angular_core.InputSignal<string>;
|
|
1135
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
986
1136
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1137
|
+
/** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
|
|
987
1138
|
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1139
|
+
/** Disables the picker and blocks all interaction. */
|
|
988
1140
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1141
|
+
/** Applies error styling and marks the trigger `aria-invalid`. */
|
|
989
1142
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
990
1143
|
/** Accessible name when no visible `label` is provided. */
|
|
991
1144
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
992
1145
|
/** Bounds for the year dropdown in the calendar header. */
|
|
993
1146
|
readonly minYear: _angular_core.InputSignal<number>;
|
|
1147
|
+
/** Upper bound for the year dropdown in the calendar header. */
|
|
994
1148
|
readonly maxYear: _angular_core.InputSignal<number>;
|
|
995
1149
|
/** Earliest selectable date (inclusive). Days before this are disabled. */
|
|
996
1150
|
readonly minDate: _angular_core.InputSignal<Date | null>;
|
|
@@ -1018,6 +1172,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
1018
1172
|
protected readonly resolvedLocale: _angular_core.Signal<string>;
|
|
1019
1173
|
protected readonly resolvedFirstDay: _angular_core.Signal<number>;
|
|
1020
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>;
|
|
1021
1177
|
protected readonly monthNames: _angular_core.Signal<string[]>;
|
|
1022
1178
|
protected readonly weekdays: _angular_core.Signal<string[]>;
|
|
1023
1179
|
/** Full weekday names for the grid column headers' accessible names. */
|
|
@@ -1060,12 +1216,13 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
1060
1216
|
protected readonly fieldPlaceholder: _angular_core.Signal<string>;
|
|
1061
1217
|
/** `size` attribute so the field hugs its mask width instead of stretching.
|
|
1062
1218
|
* +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
|
|
1063
|
-
* otherwise clip the last chars of the longer range mask.
|
|
1064
|
-
* `
|
|
1219
|
+
* otherwise clip the last chars of the longer range mask. The field's
|
|
1220
|
+
* `font-family: var(--font-mono)` keeps every glyph equal width, so the
|
|
1221
|
+
* width never shifts as you type. */
|
|
1065
1222
|
protected readonly fieldSize: _angular_core.Signal<number>;
|
|
1066
|
-
/**
|
|
1067
|
-
* format
|
|
1068
|
-
protected readonly
|
|
1223
|
+
/** Per-slot overlay runs: digits at normal weight, unfilled positions
|
|
1224
|
+
* (format letters or `_` padding) muted — see displayParts(). */
|
|
1225
|
+
protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
|
|
1069
1226
|
protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
1070
1227
|
protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
1071
1228
|
protected readonly viewMonthIndex: _angular_core.Signal<number>;
|
|
@@ -1094,18 +1251,44 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
1094
1251
|
protected close(): void;
|
|
1095
1252
|
ngOnDestroy(): void;
|
|
1096
1253
|
protected onFieldClick(): void;
|
|
1254
|
+
private mobileEdit;
|
|
1097
1255
|
protected onFieldInput(event: Event): void;
|
|
1098
|
-
/**
|
|
1256
|
+
/** Physical-keyboard editing (desktop): typed digits fill the caret's slot;
|
|
1257
|
+
* Backspace/Delete never shift digits across a separator. Delegates to the
|
|
1258
|
+
* shared segment editor. */
|
|
1099
1259
|
protected onFieldKeydown(event: KeyboardEvent): void;
|
|
1260
|
+
/** Mobile keyboards don't fire a reliable `keydown` (Gboard reports keyCode 229 /
|
|
1261
|
+
* "Unidentified"), so edits are routed here via `beforeinput`'s `inputType` instead.
|
|
1262
|
+
* Android Chrome can also ignore `preventDefault()` here, so the intended result is
|
|
1263
|
+
* stashed and re-asserted in `onFieldInput`; the microtask expires the stash once
|
|
1264
|
+
* preventDefault worked (no following `input` in the same task). */
|
|
1265
|
+
protected onFieldBeforeInput(event: InputEvent): void;
|
|
1266
|
+
/** Apply one segment edit (type a digit / Backspace / Delete) at the caret or
|
|
1267
|
+
* over the selection, then write the fixed-width value + caret back. A
|
|
1268
|
+
* selection is cleared through the model so `_` placeholders are never
|
|
1269
|
+
* natively erased — only digits are editable. Shared by keydown + beforeinput. */
|
|
1270
|
+
private runSegmentEdit;
|
|
1271
|
+
/** Paste digits into the segment model at the caret slot — never a global
|
|
1272
|
+
* flatten — so existing digits elsewhere in the field survive untouched. */
|
|
1273
|
+
protected onFieldPaste(event: ClipboardEvent): void;
|
|
1100
1274
|
private countDigits;
|
|
1101
|
-
|
|
1102
|
-
|
|
1275
|
+
/** Rebuild `raw` as a digit stream (IME / autofill / suggestion fallback —
|
|
1276
|
+
* any `input` event with no preceding handled `beforeinput`), split per slot
|
|
1277
|
+
* by its fixed width, then render fixed-width so it matches the overlay —
|
|
1278
|
+
* empty when no digits remain. */
|
|
1103
1279
|
private commitRaw;
|
|
1280
|
+
/** Write masked text + caret into the DOM, then parse and validate it. */
|
|
1281
|
+
private applyEditedText;
|
|
1104
1282
|
protected onFieldBlur(): void;
|
|
1105
|
-
/** Force the DOM value to
|
|
1106
|
-
* place the caret
|
|
1107
|
-
|
|
1108
|
-
|
|
1283
|
+
/** Force the DOM value to `text` (over-typed digits can't accumulate) and
|
|
1284
|
+
* place the caret at `caret`. Setting `value` first parks the caret at the
|
|
1285
|
+
* end, so the explicit range must follow; the later `[value]` binding writes
|
|
1286
|
+
* the same string, which leaves the caret untouched. */
|
|
1287
|
+
private writeBackText;
|
|
1288
|
+
/** Caret just past the last digit filled by a flat digit stream (commitRaw's
|
|
1289
|
+
* fallback path) — the first slot short of its max length, or the very end
|
|
1290
|
+
* once every slot is full. Empty segments naturally resolve to 0. */
|
|
1291
|
+
private caretAfterFill;
|
|
1109
1292
|
/** Parse the combined range text, flag malformed segments, commit on blur. */
|
|
1110
1293
|
private applyRangeText;
|
|
1111
1294
|
protected prevMonth(): void;
|
|
@@ -1194,18 +1377,31 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
|
|
|
1194
1377
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
1195
1378
|
* a consumer's `ds-time-picker { --ds-time-picker-panel-*: … }` reaches it. */
|
|
1196
1379
|
private readonly panelTokens;
|
|
1380
|
+
/** Selected time, or `[start, end]` tuple when `mode="range"`. Two-way bound. */
|
|
1197
1381
|
readonly value: _angular_core.ModelSignal<string | TimeRangeValue | null>;
|
|
1382
|
+
/** Single time or `[start, end]` range picker. */
|
|
1198
1383
|
readonly mode: _angular_core.InputSignal<TimePickerMode>;
|
|
1384
|
+
/** Minute increment shown in the picker columns. */
|
|
1199
1385
|
readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
1386
|
+
/** Earliest selectable time ("HH:MM"). */
|
|
1200
1387
|
readonly minTime: _angular_core.InputSignal<string | null>;
|
|
1388
|
+
/** Latest selectable time ("HH:MM"). */
|
|
1201
1389
|
readonly maxTime: _angular_core.InputSignal<string | null>;
|
|
1390
|
+
/** Predicate marking individual times unselectable. */
|
|
1202
1391
|
readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
|
|
1392
|
+
/** Trigger height — sm/md/lg. */
|
|
1203
1393
|
readonly size: _angular_core.InputSignal<TimePickerSize>;
|
|
1394
|
+
/** Disables the picker and blocks all interaction. */
|
|
1204
1395
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1396
|
+
/** Applies error styling and marks the trigger `aria-invalid`. */
|
|
1205
1397
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1398
|
+
/** Helper text shown below the picker. */
|
|
1206
1399
|
readonly hint: _angular_core.InputSignal<string>;
|
|
1400
|
+
/** Shown in the trigger when no time is set. */
|
|
1207
1401
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
1402
|
+
/** Shows an inline clear button when a value is set — single mode only. */
|
|
1208
1403
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1404
|
+
/** Accessible name for the trigger(s), suffixed "(from)"/"(to)" in range mode. */
|
|
1209
1405
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
1210
1406
|
/** Override the DS-config format for this instance. */
|
|
1211
1407
|
readonly format: _angular_core.InputSignal<TimeFormat | null>;
|
|
@@ -1261,8 +1457,11 @@ declare class BreadcrumbsComponent {
|
|
|
1261
1457
|
* Pass an explicit array to opt out of the service (per-page override).
|
|
1262
1458
|
*/
|
|
1263
1459
|
readonly items: _angular_core.InputSignal<BreadcrumbItem[] | null>;
|
|
1460
|
+
/** Icon between crumbs; falls back to `DS_CONFIG.breadcrumbs.separator`, then `chevronRight`. */
|
|
1264
1461
|
readonly separator: _angular_core.InputSignal<IconName | null>;
|
|
1462
|
+
/** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
|
|
1265
1463
|
readonly clickable: _angular_core.InputSignal<boolean | null>;
|
|
1464
|
+
/** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
|
|
1266
1465
|
readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
|
|
1267
1466
|
protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
|
|
1268
1467
|
protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
|
|
@@ -1296,16 +1495,22 @@ interface SidenavContract {
|
|
|
1296
1495
|
declare const SIDENAV: InjectionToken<SidenavContract>;
|
|
1297
1496
|
|
|
1298
1497
|
declare class SidenavComponent implements SidenavContract {
|
|
1498
|
+
/** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
|
|
1299
1499
|
readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1500
|
+
/** Brand/logo text shown at the top of the rail. */
|
|
1300
1501
|
readonly brand: _angular_core.InputSignal<string>;
|
|
1301
1502
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
|
|
1302
1503
|
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>;
|
|
1303
1504
|
}
|
|
1304
1505
|
|
|
1305
1506
|
declare class SidenavGroupComponent {
|
|
1507
|
+
/** Group heading text. */
|
|
1306
1508
|
readonly label: _angular_core.InputSignal<string>;
|
|
1509
|
+
/** Optional group icon; omit to project custom content via the `[icon]` slot instead. */
|
|
1307
1510
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1511
|
+
/** When true, the label/icon row becomes a clickable header that expands/collapses the group. */
|
|
1308
1512
|
readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1513
|
+
/** Two-way bindable open state; defaults open so a non-expandable group always shows its items. */
|
|
1309
1514
|
readonly expanded: _angular_core.ModelSignal<boolean>;
|
|
1310
1515
|
protected toggle(): void;
|
|
1311
1516
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavGroupComponent, never>;
|
|
@@ -1313,13 +1518,21 @@ declare class SidenavGroupComponent {
|
|
|
1313
1518
|
}
|
|
1314
1519
|
|
|
1315
1520
|
declare class SidenavItemComponent {
|
|
1521
|
+
/** Icon shown before the label; omit to project a custom icon via the `[icon]` slot instead. */
|
|
1316
1522
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1523
|
+
/** Visible link text; also used as the tooltip/aria-label when the rail is collapsed. */
|
|
1317
1524
|
readonly label: _angular_core.InputSignal<string>;
|
|
1525
|
+
/** Plain `href` target, used when `routerLink` is not set. */
|
|
1318
1526
|
readonly href: _angular_core.InputSignal<string>;
|
|
1527
|
+
/** Angular `RouterLink` target — string or array form for dynamic segments. */
|
|
1319
1528
|
readonly routerLink: _angular_core.InputSignal<string | readonly unknown[] | null>;
|
|
1529
|
+
/** Applies the active style; also drives `aria-current` when not using `routerLink`. */
|
|
1320
1530
|
readonly active: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1531
|
+
/** Numeric count shown at the end of the item. */
|
|
1321
1532
|
readonly badge: _angular_core.InputSignal<number | null>;
|
|
1533
|
+
/** Shows an alert dot alongside the badge. */
|
|
1322
1534
|
readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1535
|
+
/** Disables the item — non-navigable and styled as inactive. */
|
|
1323
1536
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1324
1537
|
private readonly sidenav;
|
|
1325
1538
|
/** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
|
|
@@ -1345,11 +1558,17 @@ declare class TopBarComponent {
|
|
|
1345
1558
|
}
|
|
1346
1559
|
|
|
1347
1560
|
declare class PageHeaderComponent {
|
|
1561
|
+
/** Small label shown above the title. */
|
|
1348
1562
|
readonly eyebrow: _angular_core.InputSignal<string>;
|
|
1563
|
+
/** Page title, rendered as the `h1`. */
|
|
1349
1564
|
readonly title: _angular_core.InputSignal<string>;
|
|
1565
|
+
/** Supporting line shown under the title. */
|
|
1350
1566
|
readonly subtitle: _angular_core.InputSignal<string>;
|
|
1567
|
+
/** Tightens spacing for dense layouts. */
|
|
1351
1568
|
readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1569
|
+
/** Shows a rule under the whole header. */
|
|
1352
1570
|
readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1571
|
+
/** Shows a rule under the meta row only. */
|
|
1353
1572
|
readonly metaDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1354
1573
|
protected readonly classes: _angular_core.Signal<string>;
|
|
1355
1574
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageHeaderComponent, never>;
|
|
@@ -1361,11 +1580,17 @@ type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
|
|
|
1361
1580
|
declare class ModalComponent implements OnDestroy {
|
|
1362
1581
|
private readonly doc;
|
|
1363
1582
|
protected readonly preview: DsStaticPreview;
|
|
1583
|
+
/** Open state, two-way bound. */
|
|
1364
1584
|
readonly open: _angular_core.ModelSignal<boolean>;
|
|
1585
|
+
/** Dialog width — sm/md/lg/xl/fullscreen. */
|
|
1365
1586
|
readonly size: _angular_core.InputSignal<ModalSize>;
|
|
1587
|
+
/** Renders the error styling on the modal card. */
|
|
1366
1588
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1589
|
+
/** Dialog title, shown in the header and used for `aria-labelledby`. */
|
|
1367
1590
|
readonly title: _angular_core.InputSignal<string>;
|
|
1591
|
+
/** Fires once the close (leave) animation finishes. */
|
|
1368
1592
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1593
|
+
/** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
|
|
1369
1594
|
readonly confirmed: _angular_core.OutputEmitterRef<void>;
|
|
1370
1595
|
/** When false, clicking the scrim does not close the modal. */
|
|
1371
1596
|
readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
@@ -1376,10 +1601,12 @@ declare class ModalComponent implements OnDestroy {
|
|
|
1376
1601
|
/** Playing the scrim fade-out leave animation. */
|
|
1377
1602
|
protected readonly closing: _angular_core.WritableSignal<boolean>;
|
|
1378
1603
|
private wasOpen;
|
|
1604
|
+
private closeFallbackTimer;
|
|
1379
1605
|
constructor();
|
|
1380
1606
|
ngOnDestroy(): void;
|
|
1381
1607
|
protected onClose(): void;
|
|
1382
1608
|
protected onLeaveEnd(event: AnimationEvent): void;
|
|
1609
|
+
private finishClose;
|
|
1383
1610
|
protected onBackdrop(event: MouseEvent): void;
|
|
1384
1611
|
protected onEscape(): void;
|
|
1385
1612
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
|
|
@@ -1387,12 +1614,19 @@ declare class ModalComponent implements OnDestroy {
|
|
|
1387
1614
|
}
|
|
1388
1615
|
|
|
1389
1616
|
declare class ModalCardComponent {
|
|
1617
|
+
/** Card width — sm/md/lg/xl/fullscreen. */
|
|
1390
1618
|
readonly size: _angular_core.InputSignal<ModalSize>;
|
|
1619
|
+
/** Renders the error styling (icon badge and card accent). */
|
|
1391
1620
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1621
|
+
/** Card title, shown in the header and used for `aria-labelledby`. */
|
|
1392
1622
|
readonly title: _angular_core.InputSignal<string>;
|
|
1623
|
+
/** Shows the header close button. */
|
|
1393
1624
|
readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1625
|
+
/** Icon badge shown next to the title. */
|
|
1394
1626
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1627
|
+
/** ARIA role for the dialog element. */
|
|
1395
1628
|
readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog">;
|
|
1629
|
+
/** Fires when the header close button is clicked. */
|
|
1396
1630
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1397
1631
|
protected readonly titleId: string;
|
|
1398
1632
|
protected readonly classes: _angular_core.Signal<string>;
|
|
@@ -1427,13 +1661,21 @@ declare class ModalService {
|
|
|
1427
1661
|
type BannerVariant = 'info' | 'success' | 'warning' | 'severe' | 'error' | 'neutral';
|
|
1428
1662
|
|
|
1429
1663
|
declare class BannerComponent {
|
|
1664
|
+
/** Severity — drives colour, the default icon and the ARIA role/live. */
|
|
1430
1665
|
readonly variant: _angular_core.InputSignal<BannerVariant>;
|
|
1666
|
+
/** Optional bold heading above the message. */
|
|
1431
1667
|
readonly title: _angular_core.InputSignal<string>;
|
|
1668
|
+
/** Show a close button that emits `closed`. */
|
|
1432
1669
|
readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1670
|
+
/** Override the variant's default icon. */
|
|
1433
1671
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1672
|
+
/** Tighter padding, centred items, single-line title. */
|
|
1434
1673
|
readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1674
|
+
/** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
|
|
1435
1675
|
readonly layout: _angular_core.InputSignal<"stacked" | "row">;
|
|
1676
|
+
/** Coloured accent rail on the leading edge; set false to hide it. */
|
|
1436
1677
|
readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1678
|
+
/** Fires when the user dismisses the banner. */
|
|
1437
1679
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1438
1680
|
protected get noRail(): boolean;
|
|
1439
1681
|
protected get ariaRole(): 'alert' | 'status';
|
|
@@ -1448,10 +1690,15 @@ declare class BannerComponent {
|
|
|
1448
1690
|
type AlertVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
|
|
1449
1691
|
|
|
1450
1692
|
declare class AlertComponent {
|
|
1693
|
+
/** Severity — drives colour, the default icon and the ARIA role/live. */
|
|
1451
1694
|
readonly variant: _angular_core.InputSignal<AlertVariant>;
|
|
1695
|
+
/** Optional bold heading above the message. */
|
|
1452
1696
|
readonly title: _angular_core.InputSignal<string>;
|
|
1697
|
+
/** Show a close button that emits `closed`. */
|
|
1453
1698
|
readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1699
|
+
/** Override the variant's default icon. */
|
|
1454
1700
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1701
|
+
/** Fires when the user dismisses the alert. */
|
|
1455
1702
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1456
1703
|
protected get ariaRole(): 'alert' | 'status';
|
|
1457
1704
|
protected get ariaLive(): 'assertive' | 'polite';
|
|
@@ -1476,15 +1723,20 @@ interface DropzoneFile {
|
|
|
1476
1723
|
}
|
|
1477
1724
|
|
|
1478
1725
|
declare class DropzoneComponent {
|
|
1726
|
+
/** Native `accept` attribute — comma-separated MIME types or extensions. */
|
|
1479
1727
|
readonly accept: _angular_core.InputSignal<string>;
|
|
1728
|
+
/** Allows picking more than one file at once (ignored when `single`). */
|
|
1480
1729
|
readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1730
|
+
/** Files shown in the list — the consumer owns upload state and progress. */
|
|
1481
1731
|
readonly files: _angular_core.ModelSignal<DropzoneFile[]>;
|
|
1482
1732
|
/** Disables the dropzone: blocks all file-picking interactions and signals unavailability. */
|
|
1483
1733
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1484
1734
|
/** Restricts the dropzone to a single file; narrows the panel to `--col-cap-text`. */
|
|
1485
1735
|
readonly single: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1486
1736
|
protected readonly dragOver: _angular_core.WritableSignal<boolean>;
|
|
1737
|
+
/** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
|
|
1487
1738
|
readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
|
|
1739
|
+
/** Fires when the user removes a file from the list. */
|
|
1488
1740
|
readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
|
|
1489
1741
|
protected readonly classes: _angular_core.Signal<string>;
|
|
1490
1742
|
protected onDragOver(event: DragEvent): void;
|
|
@@ -1517,11 +1769,15 @@ declare class MenuItemComponent implements OnDestroy {
|
|
|
1517
1769
|
private readonly vcr;
|
|
1518
1770
|
private readonly hostElement;
|
|
1519
1771
|
private readonly button;
|
|
1772
|
+
/** Leading icon shown before the projected label. */
|
|
1520
1773
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1774
|
+
/** Disables the item and excludes it from `ds-menu`'s roving-tabindex navigation. */
|
|
1521
1775
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1776
|
+
/** Renders the item in an error/destructive style. */
|
|
1522
1777
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1523
1778
|
/** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
|
|
1524
1779
|
readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
1780
|
+
/** Fires on click, unless the item is disabled or opens a submenu. */
|
|
1525
1781
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
1526
1782
|
/** Roving tabindex, owned by ds-menu — exactly one item is tabbable (0), the
|
|
1527
1783
|
* rest -1. Defaults true so a standalone item (outside ds-menu) stays
|
|
@@ -1560,9 +1816,13 @@ declare class MenuDividerComponent {
|
|
|
1560
1816
|
type EmptyStateVariant = 'none' | 'loading' | 'error' | 'locked' | 'success';
|
|
1561
1817
|
|
|
1562
1818
|
declare class EmptyStateComponent {
|
|
1819
|
+
/** State — drives the default icon and shows a loading overlay when `'loading'`. */
|
|
1563
1820
|
readonly variant: _angular_core.InputSignal<EmptyStateVariant>;
|
|
1821
|
+
/** Override the variant's default icon. */
|
|
1564
1822
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
1823
|
+
/** Optional heading below the icon. */
|
|
1565
1824
|
readonly title: _angular_core.InputSignal<string>;
|
|
1825
|
+
/** Optional supporting text below the title. */
|
|
1566
1826
|
readonly body: _angular_core.InputSignal<string>;
|
|
1567
1827
|
protected readonly classes: _angular_core.Signal<string>;
|
|
1568
1828
|
protected readonly resolvedIcon: _angular_core.Signal<IconName>;
|
|
@@ -1573,8 +1833,11 @@ declare class EmptyStateComponent {
|
|
|
1573
1833
|
type ProgressVariant = 'default' | Exclude<DsStatus, 'info'>;
|
|
1574
1834
|
|
|
1575
1835
|
declare class ProgressComponent {
|
|
1836
|
+
/** Progress 0–100; clamped, and ignored while `indeterminate`. */
|
|
1576
1837
|
readonly value: _angular_core.InputSignal<number>;
|
|
1838
|
+
/** Colour variant — drives the success/warning/error styling. */
|
|
1577
1839
|
readonly variant: _angular_core.InputSignal<ProgressVariant>;
|
|
1840
|
+
/** Indeterminate (unknown-duration) animation instead of a fixed `value`. */
|
|
1578
1841
|
readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1579
1842
|
/** Accessible name for the progress bar (e.g. "Upload progress"). */
|
|
1580
1843
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
@@ -1607,8 +1870,11 @@ declare class AccordionComponent implements AccordionContract {
|
|
|
1607
1870
|
}
|
|
1608
1871
|
|
|
1609
1872
|
declare class AccordionItemComponent implements AccordionItemRef {
|
|
1873
|
+
/** Header text shown in the toggle button. */
|
|
1610
1874
|
readonly title: _angular_core.InputSignal<string>;
|
|
1875
|
+
/** Open state, two-way bound. */
|
|
1611
1876
|
readonly expanded: _angular_core.ModelSignal<boolean>;
|
|
1877
|
+
/** Disables the toggle button; state stays as-is. */
|
|
1612
1878
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1613
1879
|
protected readonly uid: string;
|
|
1614
1880
|
protected readonly headId: string;
|
|
@@ -1630,14 +1896,19 @@ type StepperLabelPosition = 'bottom' | 'inline';
|
|
|
1630
1896
|
/** Layout axis of the stepper. */
|
|
1631
1897
|
type StepperOrientation = 'horizontal' | 'vertical';
|
|
1632
1898
|
declare class StepperComponent {
|
|
1899
|
+
/** Step labels, in order — one node is rendered per entry. */
|
|
1633
1900
|
readonly steps: _angular_core.InputSignal<readonly string[]>;
|
|
1901
|
+
/** Zero-based index of the active step; earlier steps render as completed. */
|
|
1634
1902
|
readonly current: _angular_core.InputSignal<number>;
|
|
1903
|
+
/** Where the step caption sits relative to its node. */
|
|
1635
1904
|
readonly labelPosition: _angular_core.InputSignal<StepperLabelPosition>;
|
|
1905
|
+
/** Layout axis of the stepper. */
|
|
1636
1906
|
readonly orientation: _angular_core.InputSignal<StepperOrientation>;
|
|
1637
1907
|
/** When true, each step node renders as a button and emits its index on activation. */
|
|
1638
1908
|
readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1639
1909
|
/** Zero-based indices of steps in an error state. Error wins over completed/current/upcoming. */
|
|
1640
1910
|
readonly errorSteps: _angular_core.InputSignal<readonly number[]>;
|
|
1911
|
+
/** Fires with a step's index when it's activated (only when `clickable`). */
|
|
1641
1912
|
readonly stepClicked: _angular_core.OutputEmitterRef<number>;
|
|
1642
1913
|
protected stepState(index: number): 'error' | 'completed' | 'current' | 'upcoming';
|
|
1643
1914
|
protected nodeClass(index: number): string;
|
|
@@ -1669,8 +1940,11 @@ declare class TooltipDirective implements OnDestroy {
|
|
|
1669
1940
|
}
|
|
1670
1941
|
|
|
1671
1942
|
declare class TooltipPanelComponent {
|
|
1943
|
+
/** Tooltip text content. */
|
|
1672
1944
|
readonly text: _angular_core.InputSignal<string>;
|
|
1945
|
+
/** Side of the trigger the panel is positioned on; also drives the arrow class. */
|
|
1673
1946
|
readonly placement: _angular_core.InputSignal<TooltipPlacement>;
|
|
1947
|
+
/** Element `id`, referenced by the trigger's `aria-describedby`. */
|
|
1674
1948
|
readonly panelId: _angular_core.InputSignal<string>;
|
|
1675
1949
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipPanelComponent, never>;
|
|
1676
1950
|
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>;
|
|
@@ -1688,6 +1962,7 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
|
|
|
1688
1962
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
1689
1963
|
* a consumer's `ds-popover { --ds-popover-panel-*: … }` reaches it. */
|
|
1690
1964
|
private readonly panelTokens;
|
|
1965
|
+
/** Cross-axis alignment of the panel against the trigger. */
|
|
1691
1966
|
readonly align: _angular_core.InputSignal<PopoverAlign>;
|
|
1692
1967
|
/** Which side of the trigger the panel prefers to appear on. */
|
|
1693
1968
|
readonly placement: _angular_core.InputSignal<PopoverPlacement>;
|
|
@@ -1790,12 +2065,19 @@ declare class ToastRegionComponent {
|
|
|
1790
2065
|
* AND by static showcases that need to display a toast specimen inline.
|
|
1791
2066
|
*/
|
|
1792
2067
|
declare class ToastComponent {
|
|
2068
|
+
/** Severity — drives colour, the default icon/spinner and the ARIA role/live. */
|
|
1793
2069
|
readonly variant: _angular_core.InputSignal<ToastVariant>;
|
|
2070
|
+
/** Optional bold heading above the message. */
|
|
1794
2071
|
readonly title: _angular_core.InputSignal<string>;
|
|
2072
|
+
/** Body text of the toast. */
|
|
1795
2073
|
readonly message: _angular_core.InputSignal<string>;
|
|
2074
|
+
/** Show a close button that emits `closed`. */
|
|
1796
2075
|
readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2076
|
+
/** Override the variant's default icon. */
|
|
1797
2077
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
2078
|
+
/** Optional action button rendered before the dismiss control. */
|
|
1798
2079
|
readonly action: _angular_core.InputSignal<ToastAction | null>;
|
|
2080
|
+
/** Fires when the toast is dismissed or its action is invoked. */
|
|
1799
2081
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1800
2082
|
protected readonly isLoading: _angular_core.Signal<boolean>;
|
|
1801
2083
|
protected onAction(action: ToastAction): void;
|
|
@@ -1822,10 +2104,15 @@ type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
|
|
|
1822
2104
|
|
|
1823
2105
|
declare class DrawerComponent implements OnDestroy {
|
|
1824
2106
|
private readonly doc;
|
|
2107
|
+
/** Open state, two-way bound. */
|
|
1825
2108
|
readonly open: _angular_core.ModelSignal<boolean>;
|
|
2109
|
+
/** Panel size — sm/md/lg. */
|
|
1826
2110
|
readonly size: _angular_core.InputSignal<DrawerSize>;
|
|
2111
|
+
/** Edge the panel slides in from. */
|
|
1827
2112
|
readonly placement: _angular_core.InputSignal<DrawerPlacement>;
|
|
2113
|
+
/** Drawer title, shown in the header and used for `aria-labelledby`. */
|
|
1828
2114
|
readonly title: _angular_core.InputSignal<string>;
|
|
2115
|
+
/** Fires once the close (slide-out) animation finishes. */
|
|
1829
2116
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1830
2117
|
protected readonly titleId: string;
|
|
1831
2118
|
/** Panel is in the DOM (kept true through the slide-out). */
|
|
@@ -1833,11 +2120,13 @@ declare class DrawerComponent implements OnDestroy {
|
|
|
1833
2120
|
/** Playing the slide-out + scrim-fade leave animation. */
|
|
1834
2121
|
protected readonly closing: _angular_core.WritableSignal<boolean>;
|
|
1835
2122
|
private wasOpen;
|
|
2123
|
+
private closeFallbackTimer;
|
|
1836
2124
|
protected readonly classes: _angular_core.Signal<string>;
|
|
1837
2125
|
constructor();
|
|
1838
2126
|
ngOnDestroy(): void;
|
|
1839
2127
|
protected onClose(): void;
|
|
1840
2128
|
protected onLeaveEnd(event: AnimationEvent): void;
|
|
2129
|
+
private finishClose;
|
|
1841
2130
|
protected onEscape(): void;
|
|
1842
2131
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerComponent, never>;
|
|
1843
2132
|
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>;
|
|
@@ -1849,9 +2138,12 @@ declare class DrawerComponent implements OnDestroy {
|
|
|
1849
2138
|
* --ds-bottom-sheet-maxw and centred; prefer ds-modal / ds-drawer for
|
|
1850
2139
|
* desktop-first layouts. position: fixed resolves against the nearest
|
|
1851
2140
|
* ancestor containing block, so framed hosts contain the sheet. */
|
|
1852
|
-
declare class BottomSheetComponent {
|
|
2141
|
+
declare class BottomSheetComponent implements OnDestroy {
|
|
2142
|
+
/** Open state, two-way bound. */
|
|
1853
2143
|
readonly open: _angular_core.ModelSignal<boolean>;
|
|
2144
|
+
/** Sheet title, shown in the header and used for `aria-labelledby`. */
|
|
1854
2145
|
readonly title: _angular_core.InputSignal<string>;
|
|
2146
|
+
/** Fires once the close (leave) animation finishes. */
|
|
1855
2147
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1856
2148
|
protected readonly titleId: string;
|
|
1857
2149
|
/**
|
|
@@ -1878,9 +2170,12 @@ declare class BottomSheetComponent {
|
|
|
1878
2170
|
private velocity;
|
|
1879
2171
|
private previousBodyOverflow;
|
|
1880
2172
|
private wasOpen;
|
|
2173
|
+
private closeFallbackTimer;
|
|
1881
2174
|
constructor();
|
|
2175
|
+
ngOnDestroy(): void;
|
|
1882
2176
|
protected close(): void;
|
|
1883
2177
|
protected onLeaveEnd(event: AnimationEvent): void;
|
|
2178
|
+
private finishClose;
|
|
1884
2179
|
protected onEscape(): void;
|
|
1885
2180
|
protected stop(event: Event): void;
|
|
1886
2181
|
protected onGrabStart(event: PointerEvent): void;
|
|
@@ -1893,13 +2188,19 @@ declare class BottomSheetComponent {
|
|
|
1893
2188
|
type TagVariant = 'solid' | 'neutral';
|
|
1894
2189
|
|
|
1895
2190
|
declare class TagComponent {
|
|
2191
|
+
/** Fill style — `solid` for high-emphasis, `neutral` for low-emphasis chips. */
|
|
1896
2192
|
readonly variant: _angular_core.InputSignal<TagVariant>;
|
|
2193
|
+
/** Shows a close button that emits `closed`. */
|
|
1897
2194
|
readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2195
|
+
/** Makes the tag clickable, emitting `toggled` on click. */
|
|
1898
2196
|
readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2197
|
+
/** Applies the active/selected visual state. */
|
|
1899
2198
|
readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1900
2199
|
/** Accessible label for the close button (e.g. "Remove Source filter"). */
|
|
1901
2200
|
readonly closeLabel: _angular_core.InputSignal<string>;
|
|
2201
|
+
/** Fires when the close button is clicked. */
|
|
1902
2202
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
2203
|
+
/** Fires on click when `interactive` is true. */
|
|
1903
2204
|
readonly toggled: _angular_core.OutputEmitterRef<void>;
|
|
1904
2205
|
protected onClick(): void;
|
|
1905
2206
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
|
|
@@ -1907,9 +2208,13 @@ declare class TagComponent {
|
|
|
1907
2208
|
}
|
|
1908
2209
|
|
|
1909
2210
|
declare class W3wComponent {
|
|
2211
|
+
/** Marker rendered before the address (e.g. the "///" glyph). */
|
|
1910
2212
|
readonly prefix: _angular_core.InputSignal<string>;
|
|
2213
|
+
/** The three-word address, rendered after `prefix`. */
|
|
1911
2214
|
readonly address: _angular_core.InputSignal<string>;
|
|
2215
|
+
/** Makes the address clickable/focusable and copies `prefix` + `address` to the clipboard. */
|
|
1912
2216
|
readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2217
|
+
/** Fires with `address` after a successful copy. */
|
|
1913
2218
|
readonly copied: _angular_core.OutputEmitterRef<string>;
|
|
1914
2219
|
protected onKeyActivate(event: Event): void;
|
|
1915
2220
|
protected onCopy(): void;
|
|
@@ -1920,6 +2225,7 @@ declare class W3wComponent {
|
|
|
1920
2225
|
type PageFooterVariant = 'default' | 'compact' | 'save';
|
|
1921
2226
|
|
|
1922
2227
|
declare class PageFooterComponent {
|
|
2228
|
+
/** Visual style — default, compact, or the accented `save`-bar look. */
|
|
1923
2229
|
readonly variant: _angular_core.InputSignal<PageFooterVariant>;
|
|
1924
2230
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageFooterComponent, never>;
|
|
1925
2231
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
|
|
@@ -1944,19 +2250,31 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
1944
2250
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
1945
2251
|
* a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
|
|
1946
2252
|
private readonly panelTokens;
|
|
2253
|
+
/** Flat option list — ignored when `optionGroups` is set. */
|
|
1947
2254
|
readonly options: _angular_core.InputSignal<readonly AutocompleteOption<T>[]>;
|
|
2255
|
+
/** Options grouped under labelled sections, rendered instead of `options`. */
|
|
1948
2256
|
readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
|
|
2257
|
+
/** Selected value, or an array of values when `multiple`. */
|
|
1949
2258
|
readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
|
|
2259
|
+
/** Allows selecting more than one option, shown as removable tags. */
|
|
1950
2260
|
readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2261
|
+
/** Trigger height — sm/md/lg. */
|
|
1951
2262
|
readonly size: _angular_core.InputSignal<AutocompleteSize>;
|
|
2263
|
+
/** Trigger width — `fill` stretches to the container, `content` hugs the value. */
|
|
1952
2264
|
readonly width: _angular_core.InputSignal<AutocompleteWidth>;
|
|
2265
|
+
/** Placeholder shown in the input when empty. */
|
|
1953
2266
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
2267
|
+
/** Disables the trigger and blocks all interaction. */
|
|
1954
2268
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2269
|
+
/** Applies error styling and marks the field `aria-invalid`. */
|
|
1955
2270
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2271
|
+
/** Helper text shown below the field. */
|
|
1956
2272
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2273
|
+
/** Shows a "Create «text»" row when the typed text matches no option. */
|
|
1957
2274
|
readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1958
2275
|
/** Accessible name for the combobox input. */
|
|
1959
2276
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2277
|
+
/** Fires with the typed text when the user picks the create-new option. */
|
|
1960
2278
|
readonly create: _angular_core.OutputEmitterRef<string>;
|
|
1961
2279
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1962
2280
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -2019,6 +2337,7 @@ declare class DividerComponent {
|
|
|
2019
2337
|
|
|
2020
2338
|
type DescriptionListOrientation = 'horizontal' | 'stacked';
|
|
2021
2339
|
declare class DescriptionListComponent {
|
|
2340
|
+
/** horizontal = label column + value; stacked = label above value. */
|
|
2022
2341
|
readonly orientation: _angular_core.InputSignal<DescriptionListOrientation>;
|
|
2023
2342
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DescriptionListComponent, never>;
|
|
2024
2343
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DescriptionListComponent, "ds-description-list", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
@@ -2026,7 +2345,9 @@ declare class DescriptionListComponent {
|
|
|
2026
2345
|
|
|
2027
2346
|
declare class DescriptionItemComponent {
|
|
2028
2347
|
private readonly list;
|
|
2348
|
+
/** The label. Plain text; rich values go in the projected content. */
|
|
2029
2349
|
readonly term: _angular_core.InputSignal<string>;
|
|
2350
|
+
/** When set, a copy button appears that copies this string to the clipboard. */
|
|
2030
2351
|
readonly copyValue: _angular_core.InputSignal<string | null>;
|
|
2031
2352
|
protected readonly stacked: _angular_core.Signal<boolean>;
|
|
2032
2353
|
protected readonly copied: _angular_core.WritableSignal<boolean>;
|
|
@@ -2070,8 +2391,11 @@ interface SegmentedOption {
|
|
|
2070
2391
|
}
|
|
2071
2392
|
|
|
2072
2393
|
declare class SegmentedComponent {
|
|
2394
|
+
/** Segments to render — each needs a `label` and `value`, optional `icon`/`disabled`. */
|
|
2073
2395
|
readonly options: _angular_core.InputSignal<readonly SegmentedOption[]>;
|
|
2396
|
+
/** Selected segment's `value`, two-way bound. */
|
|
2074
2397
|
readonly value: _angular_core.ModelSignal<string>;
|
|
2398
|
+
/** Accessible name for the segmented control (radiogroup role). */
|
|
2075
2399
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2076
2400
|
private readonly buttons;
|
|
2077
2401
|
protected readonly focusableValue: _angular_core.Signal<string | null>;
|
|
@@ -2083,23 +2407,31 @@ declare class SegmentedComponent {
|
|
|
2083
2407
|
}
|
|
2084
2408
|
|
|
2085
2409
|
declare class ButtonGroupComponent {
|
|
2410
|
+
/** Accessible name for the group, set as `aria-label` on the `role="group"` host. */
|
|
2086
2411
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2087
2412
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonGroupComponent, never>;
|
|
2088
2413
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonGroupComponent, "ds-button-group", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
2089
2414
|
}
|
|
2090
2415
|
|
|
2091
2416
|
declare class ListComponent {
|
|
2417
|
+
/** Draw a hairline separator between adjacent items. */
|
|
2092
2418
|
readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2093
2419
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
|
|
2094
2420
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "ds-list", never, { "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
2095
2421
|
}
|
|
2096
2422
|
|
|
2097
2423
|
declare class ListItemComponent {
|
|
2424
|
+
/** Convenience text; richer middle content can be projected as default content. */
|
|
2098
2425
|
readonly title: _angular_core.InputSignal<string>;
|
|
2426
|
+
/** Secondary line below `title`. */
|
|
2099
2427
|
readonly subtitle: _angular_core.InputSignal<string>;
|
|
2428
|
+
/** Whole-row navigation: renders an inner button and emits `activated`. */
|
|
2100
2429
|
readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2430
|
+
/** Marks the row current via `aria-current`. */
|
|
2101
2431
|
readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2432
|
+
/** Disables the row; only affects the button when `clickable`. */
|
|
2102
2433
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2434
|
+
/** Fires when the clickable row's button is activated. */
|
|
2103
2435
|
readonly activated: _angular_core.OutputEmitterRef<void>;
|
|
2104
2436
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListItemComponent, never>;
|
|
2105
2437
|
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>;
|
|
@@ -2115,14 +2447,21 @@ interface SplitButtonItem {
|
|
|
2115
2447
|
}
|
|
2116
2448
|
|
|
2117
2449
|
declare class SplitButtonComponent {
|
|
2450
|
+
/** Label text on the main button. */
|
|
2118
2451
|
readonly label: _angular_core.InputSignal<string>;
|
|
2452
|
+
/** Visual style — primary (solid) or outline. */
|
|
2119
2453
|
readonly variant: _angular_core.InputSignal<SplitButtonVariant>;
|
|
2454
|
+
/** Icon shown on the main button, before the label. */
|
|
2120
2455
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
2456
|
+
/** Disables both the main button and the dropdown trigger. */
|
|
2121
2457
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2458
|
+
/** Items listed in the dropdown menu. */
|
|
2122
2459
|
readonly menuItems: _angular_core.InputSignal<readonly SplitButtonItem[]>;
|
|
2123
2460
|
/** Accessible name for the dropdown trigger. */
|
|
2124
2461
|
readonly menuLabel: _angular_core.InputSignal<string>;
|
|
2462
|
+
/** Fires when the main button (not the dropdown trigger) is clicked. */
|
|
2125
2463
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
2464
|
+
/** Fires with the chosen menu item. */
|
|
2126
2465
|
readonly itemSelected: _angular_core.OutputEmitterRef<SplitButtonItem>;
|
|
2127
2466
|
protected onItemSelect(item: SplitButtonItem): void;
|
|
2128
2467
|
protected onTriggerKeydown(event: KeyboardEvent, popover: PopoverComponent, trigger: HTMLElement): void;
|
|
@@ -2137,9 +2476,13 @@ declare class TimelineComponent {
|
|
|
2137
2476
|
|
|
2138
2477
|
type TimelineTone = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'muted';
|
|
2139
2478
|
declare class TimelineItemComponent {
|
|
2479
|
+
/** Primary text for the entry. */
|
|
2140
2480
|
readonly heading: _angular_core.InputSignal<string>;
|
|
2481
|
+
/** Timestamp or date label shown below the content. */
|
|
2141
2482
|
readonly time: _angular_core.InputSignal<string>;
|
|
2483
|
+
/** Icon shown in the marker; omit for a plain dot. */
|
|
2142
2484
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
2485
|
+
/** Semantic accent color for the marker. */
|
|
2143
2486
|
readonly tone: _angular_core.InputSignal<TimelineTone>;
|
|
2144
2487
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineItemComponent, never>;
|
|
2145
2488
|
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>;
|
|
@@ -2147,14 +2490,23 @@ declare class TimelineItemComponent {
|
|
|
2147
2490
|
|
|
2148
2491
|
type OtpMode = 'numeric' | 'alphanumeric';
|
|
2149
2492
|
declare class OtpInputComponent extends DsControlValueAccessor<string> {
|
|
2493
|
+
/** Entered code, two-way bound. */
|
|
2150
2494
|
readonly value: _angular_core.ModelSignal<string>;
|
|
2495
|
+
/** Number of character cells. */
|
|
2151
2496
|
readonly length: _angular_core.InputSignal<number>;
|
|
2497
|
+
/** Restricts input and the mobile keyboard to digits-only, or allows letters too. */
|
|
2152
2498
|
readonly mode: _angular_core.InputSignal<OtpMode>;
|
|
2499
|
+
/** Renders each cell as a password dot instead of the typed character. */
|
|
2153
2500
|
readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2501
|
+
/** Disables all cells and blocks interaction. */
|
|
2154
2502
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2503
|
+
/** Applies error styling and marks each cell `aria-invalid`. */
|
|
2155
2504
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2505
|
+
/** Helper text shown below the cells. */
|
|
2156
2506
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2507
|
+
/** Accessible group label for the cell row. */
|
|
2157
2508
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
2509
|
+
/** Fires once, with the full code, on the partial → complete transition. */
|
|
2158
2510
|
readonly completed: _angular_core.OutputEmitterRef<string>;
|
|
2159
2511
|
private readonly boxes;
|
|
2160
2512
|
private wasComplete;
|
|
@@ -2181,14 +2533,23 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
|
|
|
2181
2533
|
|
|
2182
2534
|
type SliderValue = number | readonly [number, number];
|
|
2183
2535
|
declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
|
|
2536
|
+
/** Current value, or `[low, high]` when `range`. Two-way bound. */
|
|
2184
2537
|
readonly value: _angular_core.ModelSignal<SliderValue>;
|
|
2538
|
+
/** Minimum selectable value. */
|
|
2185
2539
|
readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
2540
|
+
/** Maximum selectable value. */
|
|
2186
2541
|
readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
2542
|
+
/** Increment applied when dragging (snap) or nudging with arrow keys. */
|
|
2187
2543
|
readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
2544
|
+
/** Two-thumb range mode — `value` becomes a `[low, high]` tuple. */
|
|
2188
2545
|
readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2546
|
+
/** Disables the slider and blocks all interaction. */
|
|
2189
2547
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2548
|
+
/** Accessible name for the thumb(s) — suffixed "minimum"/"maximum" in `range` mode. */
|
|
2190
2549
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2550
|
+
/** Applies error styling. */
|
|
2191
2551
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2552
|
+
/** Helper text shown below the slider. */
|
|
2192
2553
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2193
2554
|
private readonly track;
|
|
2194
2555
|
private dragging;
|
|
@@ -2221,10 +2582,15 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
|
|
|
2221
2582
|
type SpinnerSize = 'sm' | 'md' | 'lg';
|
|
2222
2583
|
|
|
2223
2584
|
declare class LoadingOverlayComponent {
|
|
2585
|
+
/** Show the scrim + spinner over the projected region. */
|
|
2224
2586
|
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2587
|
+
/** Optional caption beneath the spinner. */
|
|
2225
2588
|
readonly label: _angular_core.InputSignal<string>;
|
|
2589
|
+
/** Backdrop-blur the projected content behind the scrim. */
|
|
2226
2590
|
readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2591
|
+
/** Size of the spinner shown in the scrim. */
|
|
2227
2592
|
readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
|
|
2593
|
+
/** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
|
|
2228
2594
|
readonly insetTop: _angular_core.InputSignal<string>;
|
|
2229
2595
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
|
|
2230
2596
|
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>;
|
|
@@ -2246,9 +2612,13 @@ interface VisibleNode {
|
|
|
2246
2612
|
}
|
|
2247
2613
|
declare class TreeComponent {
|
|
2248
2614
|
private readonly host;
|
|
2615
|
+
/** Root-level nodes; nest via `children`. */
|
|
2249
2616
|
readonly nodes: _angular_core.InputSignal<readonly TreeNode[]>;
|
|
2617
|
+
/** Two-way set of currently expanded node ids. */
|
|
2250
2618
|
readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
|
|
2619
|
+
/** Two-way id of the currently selected node. */
|
|
2251
2620
|
readonly selectedId: _angular_core.ModelSignal<string | null>;
|
|
2621
|
+
/** Fires with the node when a row is selected (click or Enter/Space). */
|
|
2252
2622
|
readonly nodeSelected: _angular_core.OutputEmitterRef<TreeNode>;
|
|
2253
2623
|
private readonly activeId;
|
|
2254
2624
|
protected readonly visibleNodes: _angular_core.Signal<VisibleNode[]>;
|
|
@@ -2282,11 +2652,17 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
|
|
|
2282
2652
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
2283
2653
|
* a consumer's `ds-color-picker { --ds-color-picker-panel-*: … }` reaches it. */
|
|
2284
2654
|
private readonly panelTokens;
|
|
2655
|
+
/** Selected colour as a hex string, two-way bound. */
|
|
2285
2656
|
readonly value: _angular_core.ModelSignal<string>;
|
|
2657
|
+
/** Swatches shown in the panel — defaults to a built-in palette. */
|
|
2286
2658
|
readonly presets: _angular_core.InputSignal<readonly string[]>;
|
|
2659
|
+
/** Disables the trigger and blocks all interaction. */
|
|
2287
2660
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2661
|
+
/** Accessible name for the trigger button and panel. */
|
|
2288
2662
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
2663
|
+
/** Applies error styling and marks the trigger `aria-invalid`. */
|
|
2289
2664
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2665
|
+
/** Helper text shown below the trigger. */
|
|
2290
2666
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2291
2667
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
|
|
2292
2668
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
@@ -2343,15 +2719,25 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
2343
2719
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
2344
2720
|
* a consumer's `ds-multi-select { --ds-multi-select-panel-*: … }` reaches it. */
|
|
2345
2721
|
private readonly panelTokens;
|
|
2722
|
+
/** Selected values, two-way bound. */
|
|
2346
2723
|
readonly value: _angular_core.ModelSignal<string[]>;
|
|
2724
|
+
/** Options shown in the panel. */
|
|
2347
2725
|
readonly options: _angular_core.InputSignal<readonly MultiSelectOption[]>;
|
|
2726
|
+
/** Placeholder shown in the trigger when nothing is selected. */
|
|
2348
2727
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
2728
|
+
/** Placeholder for the in-panel filter input. */
|
|
2349
2729
|
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
2730
|
+
/** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all. */
|
|
2350
2731
|
readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
2732
|
+
/** Disables the trigger and blocks all interaction. */
|
|
2351
2733
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2734
|
+
/** Applies error styling and marks the field `aria-invalid`. */
|
|
2352
2735
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2736
|
+
/** Helper text shown below the field. */
|
|
2353
2737
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2738
|
+
/** Accessible name for the trigger — falls back to `placeholder`. */
|
|
2354
2739
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2740
|
+
/** Shows a "Select all" row that toggles every filter-matching, enabled option. */
|
|
2355
2741
|
readonly selectAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2356
2742
|
protected readonly uid: string;
|
|
2357
2743
|
protected readonly listboxId: string;
|
|
@@ -2392,15 +2778,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
2392
2778
|
}
|
|
2393
2779
|
|
|
2394
2780
|
declare class SkeletonComponent {
|
|
2781
|
+
/** CSS width of the placeholder (e.g. `'120px'`, `'50%'`). */
|
|
2395
2782
|
readonly width: _angular_core.InputSignal<string | undefined>;
|
|
2783
|
+
/** CSS height of the placeholder. */
|
|
2396
2784
|
readonly height: _angular_core.InputSignal<string | undefined>;
|
|
2785
|
+
/** Pill radius, for avatar/dot-shaped placeholders. */
|
|
2397
2786
|
readonly circle: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2787
|
+
/** `display: inline-block` instead of `block`, to sit inline with text. */
|
|
2398
2788
|
readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2399
2789
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkeletonComponent, never>;
|
|
2400
2790
|
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>;
|
|
2401
2791
|
}
|
|
2402
2792
|
|
|
2403
2793
|
declare class SpinnerComponent {
|
|
2794
|
+
/** Spinner size — sm/md/lg. */
|
|
2404
2795
|
readonly size: _angular_core.InputSignal<SpinnerSize>;
|
|
2405
2796
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
|
|
2406
2797
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
@@ -2409,14 +2800,23 @@ declare class SpinnerComponent {
|
|
|
2409
2800
|
type CheckboxSize = 'sm' | 'md' | 'lg';
|
|
2410
2801
|
|
|
2411
2802
|
declare class CheckboxComponent extends DsBooleanControlValueAccessor {
|
|
2803
|
+
/** Checked state, two-way bound. */
|
|
2412
2804
|
readonly checked: _angular_core.ModelSignal<boolean>;
|
|
2805
|
+
/** Shows the partial/mixed visual state — independent of `checked`. */
|
|
2413
2806
|
readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2807
|
+
/** Disables the checkbox and blocks all interaction. */
|
|
2414
2808
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2809
|
+
/** Native `name` attribute. */
|
|
2415
2810
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
2811
|
+
/** Overrides the generated id used by the native `<input>` and its `<label for>`. */
|
|
2416
2812
|
readonly inputId: _angular_core.InputSignal<string | null>;
|
|
2813
|
+
/** Applies error styling and marks the input `aria-invalid`. */
|
|
2417
2814
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2815
|
+
/** Helper text shown below the checkbox. */
|
|
2418
2816
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2817
|
+
/** Checkbox size — sm/md/lg. */
|
|
2419
2818
|
readonly size: _angular_core.InputSignal<CheckboxSize>;
|
|
2819
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
2420
2820
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2421
2821
|
/** Inline label rendered beside the box and wired via for/id. Omit to
|
|
2422
2822
|
* bring your own <label>. */
|
|
@@ -2438,13 +2838,21 @@ declare class RadioComponent {
|
|
|
2438
2838
|
/** Standalone two-way binding. When inside ds-radio-group, isChecked() is
|
|
2439
2839
|
* derived from the group value instead. */
|
|
2440
2840
|
readonly checked: _angular_core.ModelSignal<boolean>;
|
|
2841
|
+
/** Disables the radio; a disabled parent `ds-radio-group` also disables it. */
|
|
2441
2842
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2843
|
+
/** Native `name` attribute — overridden by the group's name when inside `ds-radio-group`. */
|
|
2442
2844
|
readonly name: _angular_core.InputSignal<string>;
|
|
2845
|
+
/** Value compared against the group's selection when inside `ds-radio-group`. */
|
|
2443
2846
|
readonly value: _angular_core.InputSignal<unknown>;
|
|
2847
|
+
/** Overrides the auto-generated id used for the input and its label's `for`. */
|
|
2444
2848
|
readonly inputId: _angular_core.InputSignal<string | null>;
|
|
2849
|
+
/** Applies error styling and marks the input `aria-invalid`. */
|
|
2445
2850
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2851
|
+
/** Helper text shown below the control. */
|
|
2446
2852
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2853
|
+
/** Control size — sm/md/lg. */
|
|
2447
2854
|
readonly size: _angular_core.InputSignal<RadioSize>;
|
|
2855
|
+
/** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
|
|
2448
2856
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2449
2857
|
/** Inline label rendered beside the dot and wired via for/id. Omit to bring
|
|
2450
2858
|
* your own <label>. */
|
|
@@ -2488,12 +2896,19 @@ interface RadioGroupChild {
|
|
|
2488
2896
|
declare const RADIO_GROUP: InjectionToken<RadioGroupContract>;
|
|
2489
2897
|
|
|
2490
2898
|
declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implements RadioGroupContract {
|
|
2899
|
+
/** Selected radio value; two-way bound. */
|
|
2491
2900
|
readonly value: _angular_core.ModelSignal<unknown>;
|
|
2901
|
+
/** Native `name` shared by every radio in the group. */
|
|
2492
2902
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
2903
|
+
/** Disables the whole group. */
|
|
2493
2904
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2905
|
+
/** Applies error styling and marks the group `aria-invalid`. */
|
|
2494
2906
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2907
|
+
/** Helper text shown below the group. */
|
|
2495
2908
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2909
|
+
/** Accessible name for the group when no visible label is provided. */
|
|
2496
2910
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2911
|
+
/** Visible group label; omit to supply your own. */
|
|
2497
2912
|
readonly label: _angular_core.InputSignal<string>;
|
|
2498
2913
|
readonly isDisabled: _angular_core.Signal<boolean>;
|
|
2499
2914
|
protected readonly uid: string;
|
|
@@ -2512,14 +2927,23 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
|
|
|
2512
2927
|
type SwitchSize = 'sm' | 'md' | 'lg';
|
|
2513
2928
|
|
|
2514
2929
|
declare class SwitchComponent extends DsBooleanControlValueAccessor {
|
|
2930
|
+
/** On/off state, two-way bound. */
|
|
2515
2931
|
readonly checked: _angular_core.ModelSignal<boolean>;
|
|
2932
|
+
/** Disables the switch and blocks all interaction. */
|
|
2516
2933
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2934
|
+
/** Native `name` attribute. */
|
|
2517
2935
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
2936
|
+
/** Track colour when checked. */
|
|
2518
2937
|
readonly variant: _angular_core.InputSignal<"error" | "success" | "default">;
|
|
2938
|
+
/** Overrides the generated id used by the native `<input>` and its `<label for>`. */
|
|
2519
2939
|
readonly inputId: _angular_core.InputSignal<string | null>;
|
|
2940
|
+
/** Applies error styling and marks the input `aria-invalid`. */
|
|
2520
2941
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2942
|
+
/** Helper text shown below the switch. */
|
|
2521
2943
|
readonly hint: _angular_core.InputSignal<string>;
|
|
2944
|
+
/** Switch size — sm/md/lg. */
|
|
2522
2945
|
readonly size: _angular_core.InputSignal<SwitchSize>;
|
|
2946
|
+
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
2523
2947
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2524
2948
|
/** Inline label rendered beside the track and wired via for/id. Omit to
|
|
2525
2949
|
* bring your own <label>. */
|