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