@guildofgleks/ui 21.2.4 → 21.3.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/LICENSE +201 -21
- package/README.md +139 -23
- package/fesm2022/guildofgleks-ui.mjs +7042 -1707
- package/fesm2022/guildofgleks-ui.mjs.map +1 -1
- package/package.json +2 -2
- package/src/styles/index.css +17 -17
- package/src/styles/presets/one-dark.css +48 -0
- package/src/styles/presets/one-light.css +47 -0
- package/src/styles/presets/slate.css +55 -0
- package/src/styles/theme.css +723 -40
- package/src/styles/utilities.css +170 -69
- package/types/guildofgleks-ui.d.ts +2429 -336
|
@@ -1,17 +1,24 @@
|
|
|
1
1
|
import * as _angular_core from '@angular/core';
|
|
2
|
-
import { TemplateRef,
|
|
2
|
+
import { TemplateRef, DoCheck, Signal, ModelSignal, ElementRef, InjectionToken, Type, Injector, OnDestroy, Provider } from '@angular/core';
|
|
3
3
|
import { ControlValueAccessor } from '@angular/forms';
|
|
4
4
|
import * as _angular_platform_browser from '@angular/platform-browser';
|
|
5
5
|
import * as _guildofgleks_ui from '@guildofgleks/ui';
|
|
6
6
|
|
|
7
7
|
type GogSize = 'xsm' | 'sm' | 'md' | 'lg' | 'slg';
|
|
8
8
|
type GogVariant = 'primary' | 'secondary' | 'outline' | 'ghost';
|
|
9
|
+
/**
|
|
10
|
+
* Which way a component lays its children out. Shared rather than re-declared per component:
|
|
11
|
+
* `gog-radio-group`, `gog-slider`, `gog-divider`, `gog-tabs` and `gog-button-toggle-group` all
|
|
12
|
+
* mean the same thing by it, and `roving-focus.ts` picks its arrow pair from this.
|
|
13
|
+
*/
|
|
14
|
+
type GogOrientation = 'horizontal' | 'vertical';
|
|
9
15
|
type GogSpinnerVariant = 'runic' | 'ring' | 'custom';
|
|
10
16
|
type GogTagVariant = 'success' | 'danger' | 'warning' | 'info';
|
|
11
17
|
type GogTagShape = 'rounded' | 'pill';
|
|
12
18
|
type GogSkeletonShape = 'text' | 'circle' | 'rect';
|
|
13
19
|
type GogSkeletonAnimation = 'pulse' | 'wave' | 'none';
|
|
14
20
|
type GogPaginatorRangeMode = 'window' | 'ellipsis';
|
|
21
|
+
type GogSliderOrientation = GogOrientation;
|
|
15
22
|
type GogScrollAxis = 'vertical' | 'horizontal' | 'both';
|
|
16
23
|
type GogScrollSize = 'normal' | 'thin';
|
|
17
24
|
/**
|
|
@@ -26,10 +33,65 @@ type GogScrollSize = 'normal' | 'thin';
|
|
|
26
33
|
* affordances (rubber-banding, pull-to-refresh) for this instance.
|
|
27
34
|
*/
|
|
28
35
|
type GogScrollOverscrollBehavior = 'auto' | 'contain' | 'none';
|
|
36
|
+
/**
|
|
37
|
+
* Which side of the trigger the tooltip bubble renders on. `'auto'` (the default) picks
|
|
38
|
+
* whichever of the four sides has room for the bubble, preferring top, then bottom, then
|
|
39
|
+
* right, then left — see `resolveTooltipPlacement` in `tooltip-position.ts`. An explicit
|
|
40
|
+
* side still flips to its opposite if the requested side has no room but the opposite does.
|
|
41
|
+
*/
|
|
42
|
+
type GogTooltipPosition = 'auto' | 'top' | 'bottom' | 'left' | 'right';
|
|
43
|
+
/**
|
|
44
|
+
* Where a field's label sits once it "floats" out of its resting position (overlapping the
|
|
45
|
+
* field like a placeholder) on focus or once the field has content. `'none'` (the default)
|
|
46
|
+
* keeps today's static label-above-the-field layout — nothing floats.
|
|
47
|
+
* - `'in'` — floats up but stays fully inside the field's border.
|
|
48
|
+
* - `'on'` — floats up until vertically centered on the top border line.
|
|
49
|
+
* - `'over'` — floats all the way above the field, outside the border.
|
|
50
|
+
*/
|
|
51
|
+
type GogFloatLabelVariant = 'none' | 'in' | 'on' | 'over';
|
|
52
|
+
/**
|
|
53
|
+
* Which end of a dropdown panel the search box sticks to. Matches `gog-multiselect`'s
|
|
54
|
+
* `controlsPosition` vocabulary — the same idea applied to its select-all row.
|
|
55
|
+
*/
|
|
56
|
+
type GogDropdownFilterPosition = 'top' | 'bottom';
|
|
57
|
+
/** How `gog-divider` paints its rule. */
|
|
58
|
+
type GogDividerVariant = 'solid' | 'dashed' | 'dotted';
|
|
59
|
+
/**
|
|
60
|
+
* Which corner of its host a `gogBadge` sits on. Named by block/inline edge rather than
|
|
61
|
+
* left/right so it follows the writing direction in an RTL layout.
|
|
62
|
+
*/
|
|
63
|
+
type GogBadgePosition = 'top-end' | 'top-start' | 'bottom-end' | 'bottom-start';
|
|
64
|
+
/**
|
|
65
|
+
* - `'determinate'` — the bar reflects `value`.
|
|
66
|
+
* - `'indeterminate'` — work of unknown length; the bar animates and reports no value to
|
|
67
|
+
* assistive tech, which is what marks it indeterminate.
|
|
68
|
+
* - `'buffer'` — `value` plus a second, lighter `buffer` level ahead of it (streaming/preload).
|
|
69
|
+
*/
|
|
70
|
+
type GogProgressbarMode = 'determinate' | 'indeterminate' | 'buffer';
|
|
71
|
+
/**
|
|
72
|
+
* `gog-progressbar`'s colour. Wider than `GogTagVariant` by one: progress is usually just
|
|
73
|
+
* "the app is working", which is the accent colour rather than any of the four status hues —
|
|
74
|
+
* so `'accent'` is the default and the status names are the exception.
|
|
75
|
+
*/
|
|
76
|
+
type GogProgressbarVariant = 'accent' | 'success' | 'danger' | 'warning' | 'info';
|
|
77
|
+
/**
|
|
78
|
+
* - `'joined'` — one segmented control, buttons sharing borders (Material's look).
|
|
79
|
+
* - `'separated'` — discrete buttons with a gap between them.
|
|
80
|
+
*/
|
|
81
|
+
type GogButtonToggleAppearance = 'joined' | 'separated';
|
|
82
|
+
/** How the tab headers distribute along the tablist. `'stretch'` makes them share the width. */
|
|
83
|
+
type GogTabsAlign = 'start' | 'center' | 'end' | 'stretch';
|
|
84
|
+
/** Whether `gog-datepicker` picks one day or a start/end pair. */
|
|
85
|
+
type GogDateSelectionMode = 'single' | 'range';
|
|
86
|
+
/** Clock convention for `gog-datepicker`'s time section. */
|
|
87
|
+
type GogHourFormat = '12' | '24';
|
|
88
|
+
/** Matches the native CSS `resize` value space, applied to `gog-textarea`'s field. */
|
|
89
|
+
type GogTextareaResize = 'vertical' | 'horizontal' | 'both' | 'none';
|
|
29
90
|
|
|
30
91
|
declare class ButtonComponent {
|
|
31
92
|
variant: _angular_core.InputSignal<GogVariant>;
|
|
32
|
-
size
|
|
93
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
94
|
+
size: _angular_core.InputSignal<GogSize | undefined>;
|
|
33
95
|
disabled: _angular_core.InputSignal<boolean>;
|
|
34
96
|
fullWidth: _angular_core.InputSignal<boolean>;
|
|
35
97
|
type: _angular_core.InputSignal<"button" | "submit" | "reset">;
|
|
@@ -56,9 +118,16 @@ declare class ButtonComponent {
|
|
|
56
118
|
/** Logically blocked from activating (disabled OR loading), used to guard click handling. */
|
|
57
119
|
protected isDisabled: _angular_core.Signal<boolean>;
|
|
58
120
|
private static readonly SPINNER_SIZE_BY_BUTTON_SIZE;
|
|
59
|
-
protected spinnerSize: _angular_core.Signal<GogSize>;
|
|
60
121
|
private readonly globalConfig;
|
|
122
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
123
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
124
|
+
protected spinnerSize: _angular_core.Signal<GogSize>;
|
|
61
125
|
protected readonly resolvedDebounce: _angular_core.Signal<number>;
|
|
126
|
+
/**
|
|
127
|
+
* The single size modifier, replacing one `[class.gog-btn--<size>]` binding per size.
|
|
128
|
+
* Always emitted — `gog-btn` has a rule for every size, `md` included.
|
|
129
|
+
*/
|
|
130
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
62
131
|
private readonly destroyRef;
|
|
63
132
|
private readonly click$;
|
|
64
133
|
constructor();
|
|
@@ -106,6 +175,12 @@ declare class GogAccordionChevronDirective {
|
|
|
106
175
|
declare class AccordionComponent {
|
|
107
176
|
private static nextUid;
|
|
108
177
|
readonly items: _angular_core.InputSignal<GogAccordionItem[]>;
|
|
178
|
+
/**
|
|
179
|
+
* The single size modifier, replacing one `[class.gog-accordion--<size>]` binding per size.
|
|
180
|
+
* Empty for `'lg'`: that is this component's default size, and its tokens are what every
|
|
181
|
+
* `--gog-accordion-*` chain bottoms out at, so it has no modifier rule of its own.
|
|
182
|
+
*/
|
|
183
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
109
184
|
readonly size: _angular_core.InputSignal<GogSize>;
|
|
110
185
|
readonly expandFirst: _angular_core.InputSignal<boolean>;
|
|
111
186
|
readonly multi: _angular_core.InputSignal<boolean>;
|
|
@@ -125,7 +200,7 @@ declare class AccordionComponent {
|
|
|
125
200
|
* Left unset by default since not every accordion instance represents document structure
|
|
126
201
|
* (e.g. one nested inside a card).
|
|
127
202
|
*/
|
|
128
|
-
readonly headingLevel: _angular_core.InputSignal<
|
|
203
|
+
readonly headingLevel: _angular_core.InputSignal<2 | 3 | 4 | 5 | 6 | undefined>;
|
|
129
204
|
/**
|
|
130
205
|
* Two-way bindable set of currently open item ids. Exposed as a model so consumers
|
|
131
206
|
* can drive the accordion externally (e.g. `[(openIds)]="mySet"`) instead of only
|
|
@@ -173,11 +248,21 @@ declare class CollapsibleComponent {
|
|
|
173
248
|
/** Two-way bindable open state: `[(open)]="signal"`. */
|
|
174
249
|
readonly open: _angular_core.ModelSignal<boolean>;
|
|
175
250
|
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
251
|
+
/**
|
|
252
|
+
* Closes the panel once focus leaves both the trigger and the content — e.g. Tabbing past
|
|
253
|
+
* the last focusable element inside, or a click landing somewhere else on the page. Off by
|
|
254
|
+
* default: plenty of consumers (an FAQ list, a settings section someone reads top to bottom)
|
|
255
|
+
* want the panel to stay open regardless of where focus goes next, so this is opt-in rather
|
|
256
|
+
* than baked in.
|
|
257
|
+
*/
|
|
258
|
+
readonly collapseOnFocusOut: _angular_core.InputSignal<boolean>;
|
|
259
|
+
private readonly elementRef;
|
|
176
260
|
private readonly uid;
|
|
177
261
|
readonly contentId: _angular_core.Signal<string>;
|
|
178
262
|
toggle(): void;
|
|
263
|
+
protected onFocusOut(event: FocusEvent): void;
|
|
179
264
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<CollapsibleComponent, never>;
|
|
180
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<CollapsibleComponent, "gog-collapsible", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
|
|
265
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<CollapsibleComponent, "gog-collapsible", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "collapseOnFocusOut": { "alias": "collapseOnFocusOut"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["*"], true, never>;
|
|
181
266
|
}
|
|
182
267
|
|
|
183
268
|
/**
|
|
@@ -202,22 +287,1562 @@ declare class GogCollapsibleContentDirective {
|
|
|
202
287
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogCollapsibleContentDirective, "[gogCollapsibleContent]", never, {}, {}, never, never, true, never>;
|
|
203
288
|
}
|
|
204
289
|
|
|
205
|
-
|
|
290
|
+
type GogDropdownDirection = 'auto' | 'up' | 'down';
|
|
291
|
+
interface GogDropdownPlacement {
|
|
292
|
+
direction: 'up' | 'down';
|
|
293
|
+
top: number;
|
|
294
|
+
left: number;
|
|
295
|
+
width: number;
|
|
296
|
+
maxHeight: number;
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* `'manual'` (default): the field shows `errorMessage` for as long as it is non-empty — the
|
|
301
|
+
* consumer decides when to clear it, e.g.
|
|
302
|
+
* `errorMessage="control.invalid && control.touched ? 'Required' : ''"`.
|
|
303
|
+
*
|
|
304
|
+
* `'auto'`: shown once the attached form control has been touched and is invalid — the
|
|
305
|
+
* consumer only supplies the message text, not the timing. Requires a
|
|
306
|
+
* `[formControl]` / `formControlName` on the element; without one this falls back to
|
|
307
|
+
* `'manual'`, since there is no control state to key off.
|
|
308
|
+
*/
|
|
309
|
+
type GogErrorDisplay = 'auto' | 'manual';
|
|
310
|
+
|
|
311
|
+
/**
|
|
312
|
+
* How a collection-driven component reads one field off a consumer's own object.
|
|
313
|
+
*
|
|
314
|
+
* A `string` is a property name, or a dot-path into a nested one (`'profile.city'`). A function
|
|
315
|
+
* is anything else. This is what lets `gog-select` / `gog-multiselect` take a consumer's real
|
|
316
|
+
* DTO instead of forcing everything through a `{ id, name }` shape first.
|
|
317
|
+
*/
|
|
318
|
+
type GogOptionAccessor<TOption, TResult> = string | ((option: TOption) => TResult);
|
|
319
|
+
/** Resolves `field` against `source`, following dot-paths (e.g. `"address.city"`). */
|
|
320
|
+
declare function getByPath(source: unknown, field: string): unknown;
|
|
321
|
+
/** Applies an accessor — a property path or a function — to one option. */
|
|
322
|
+
declare function readOption<TOption, TResult>(option: TOption, accessor: GogOptionAccessor<TOption, TResult>): TResult;
|
|
323
|
+
/**
|
|
324
|
+
* Whether two resolved option values refer to the same option.
|
|
325
|
+
*
|
|
326
|
+
* Primitives are compared as strings, so a `formControl` holding `'1'` still matches an option
|
|
327
|
+
* whose value is the number `1` — the library behaved this way before option values could be
|
|
328
|
+
* anything, and forms routinely stringify. Objects are compared by identity instead: coercing
|
|
329
|
+
* them would make every plain object equal to every other (`"[object Object]"`).
|
|
330
|
+
*/
|
|
331
|
+
declare function isSameOptionValue(a: unknown, b: unknown): boolean;
|
|
332
|
+
|
|
333
|
+
/**
|
|
334
|
+
* Custom markup for the trigger's chevron, on `gog-select` and `gog-multiselect`:
|
|
335
|
+
*
|
|
336
|
+
* ```html
|
|
337
|
+
* <gog-select [options]="opts">
|
|
338
|
+
* <ng-template gogDropdownChevron><gog-icon name="sort" /></ng-template>
|
|
339
|
+
* </gog-select>
|
|
340
|
+
* ```
|
|
341
|
+
*/
|
|
342
|
+
declare class GogDropdownChevronDirective {
|
|
343
|
+
readonly templateRef: TemplateRef<unknown>;
|
|
344
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogDropdownChevronDirective, never>;
|
|
345
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogDropdownChevronDirective, "[gogDropdownChevron]", never, {}, {}, never, never, true, never>;
|
|
346
|
+
}
|
|
347
|
+
/** Context handed to a `gogDropdownOption` template. */
|
|
348
|
+
interface GogDropdownOptionContext<TOption> {
|
|
349
|
+
/** The consumer's own option object, untouched. */
|
|
350
|
+
$implicit: TOption;
|
|
351
|
+
selected: boolean;
|
|
352
|
+
disabled: boolean;
|
|
353
|
+
/** The resolved label, so a custom row can decorate it rather than re-derive it. */
|
|
354
|
+
label: string;
|
|
355
|
+
}
|
|
356
|
+
/**
|
|
357
|
+
* Custom markup for one option row, on `gog-select` and `gog-multiselect`:
|
|
358
|
+
*
|
|
359
|
+
* ```html
|
|
360
|
+
* <gog-select [options]="users" optionLabel="fullName" optionValue="id" [(value)]="userId">
|
|
361
|
+
* <ng-template gogDropdownOption let-user let-selected="selected">
|
|
362
|
+
* <img [src]="user.avatar" alt="" /> {{ user.fullName }}
|
|
363
|
+
* </ng-template>
|
|
364
|
+
* </gog-select>
|
|
365
|
+
* ```
|
|
366
|
+
*/
|
|
367
|
+
declare class GogDropdownOptionDirective<TOption = unknown> {
|
|
368
|
+
readonly templateRef: TemplateRef<GogDropdownOptionContext<TOption>>;
|
|
369
|
+
static ngTemplateContextGuard<TOption>(_dir: GogDropdownOptionDirective<TOption>, ctx: unknown): ctx is GogDropdownOptionContext<TOption>;
|
|
370
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogDropdownOptionDirective<any>, never>;
|
|
371
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogDropdownOptionDirective<any>, "[gogDropdownOption]", never, {}, {}, never, never, true, never>;
|
|
372
|
+
}
|
|
373
|
+
/**
|
|
374
|
+
* The shape the listbox controls assume when their accessor inputs are left at their defaults.
|
|
375
|
+
*
|
|
376
|
+
* It is no longer required: `optionLabel` / `optionValue` / `optionDisabled` accept any property
|
|
377
|
+
* path or function, so a consumer can pass their own DTO straight through. This interface just
|
|
378
|
+
* describes what the *default* accessors (`'name'` / `'id'` / `'disabled'`) expect to find.
|
|
379
|
+
*/
|
|
380
|
+
interface GogDropdownOption {
|
|
381
|
+
id: string | number;
|
|
382
|
+
name: string;
|
|
383
|
+
disabled?: boolean;
|
|
384
|
+
}
|
|
385
|
+
/**
|
|
386
|
+
* Shared behaviour for the listbox-style controls: open/close, placement, the
|
|
387
|
+
* append-to-body overlay, click-outside, keyboard navigation and `ControlValueAccessor`
|
|
388
|
+
* plumbing. Subclasses supply only what actually differs — the value type, the panel
|
|
389
|
+
* markup, and the BEM class names used to find the trigger and the options.
|
|
390
|
+
*
|
|
391
|
+
* Exported because it appears in the public type signatures of the components that
|
|
392
|
+
* extend it; it is not meant to be used or subclassed by consumers.
|
|
393
|
+
*/
|
|
394
|
+
declare abstract class GogDropdownBase<TValue, TOption = GogDropdownOption> implements ControlValueAccessor, DoCheck {
|
|
395
|
+
private static nextUid;
|
|
396
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
397
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
398
|
+
readonly placeholder: _angular_core.InputSignal<string>;
|
|
399
|
+
readonly options: _angular_core.InputSignal<TOption[]>;
|
|
400
|
+
/**
|
|
401
|
+
* How to read an option's visible text — a property path (`'name'`, `'profile.title'`) or a
|
|
402
|
+
* function. Defaults to `'name'`, matching `GogDropdownOption`.
|
|
403
|
+
*/
|
|
404
|
+
readonly optionLabel: _angular_core.InputSignal<GogOptionAccessor<TOption, string>>;
|
|
405
|
+
/**
|
|
406
|
+
* How to read the value this control emits for an option. A property path or a function, or
|
|
407
|
+
* `null` to emit **the option object itself** — which is what lets a consumer keep their own
|
|
408
|
+
* DTO end to end instead of mapping ids back to objects on every change.
|
|
409
|
+
*
|
|
410
|
+
* Defaults to `'id'`, matching `GogDropdownOption`, so existing code is unaffected.
|
|
411
|
+
*/
|
|
412
|
+
readonly optionValue: _angular_core.InputSignal<GogOptionAccessor<TOption, unknown> | null>;
|
|
413
|
+
/** How to read whether an option is disabled. Defaults to `'disabled'`. */
|
|
414
|
+
readonly optionDisabled: _angular_core.InputSignal<GogOptionAccessor<TOption, boolean>>;
|
|
415
|
+
/**
|
|
416
|
+
* Whether to offer a clear button once something is selected. Unset, falls back to
|
|
417
|
+
* `GOG_CONFIG.control.clearable`, then to the control's own default.
|
|
418
|
+
*/
|
|
419
|
+
readonly clearable: _angular_core.InputSignal<boolean | undefined>;
|
|
420
|
+
/** Accessible name for the clear button. */
|
|
421
|
+
readonly clearAriaLabel: _angular_core.InputSignal<string>;
|
|
422
|
+
/**
|
|
423
|
+
* Smallest width the trigger may shrink to, as any CSS length. Only meaningful with
|
|
424
|
+
* `[fullWidth]="false"`, where the trigger otherwise sizes to whatever is currently selected
|
|
425
|
+
* and can collapse to almost nothing on a short option. Left unset it falls back to the
|
|
426
|
+
* `--gog-{select,multiselect}-min-width` token.
|
|
427
|
+
*/
|
|
428
|
+
readonly minWidth: _angular_core.InputSignal<string | null>;
|
|
429
|
+
/**
|
|
430
|
+
* Whether the panel shows a search box that narrows the option list. Unset, falls back to
|
|
431
|
+
* `GOG_CONFIG.dropdown.filter`, then to `false`.
|
|
432
|
+
*/
|
|
433
|
+
readonly filter: _angular_core.InputSignal<boolean | undefined>;
|
|
434
|
+
readonly filterPlaceholder: _angular_core.InputSignal<string>;
|
|
435
|
+
/**
|
|
436
|
+
* Which end of the panel the search box sticks to. Named to match `gog-multiselect`'s
|
|
437
|
+
* `controlsPosition`, which is the same idea for its select-all row. Unset, falls back to
|
|
438
|
+
* `GOG_CONFIG.dropdown.filterPosition`, then to `'top'`.
|
|
439
|
+
*/
|
|
440
|
+
readonly filterPosition: _angular_core.InputSignal<GogDropdownFilterPosition | undefined>;
|
|
441
|
+
/** Shown in place of the list when the query matches nothing. */
|
|
442
|
+
readonly filterEmptyMessage: _angular_core.InputSignal<string>;
|
|
443
|
+
/**
|
|
444
|
+
* How an option is matched against the query. Left null, the resolved `optionLabel` is
|
|
445
|
+
* matched case-insensitively as a substring — pass a function to search other fields, match
|
|
446
|
+
* on a prefix, or plug in your own fuzzy matcher.
|
|
447
|
+
*/
|
|
448
|
+
readonly filterMatch: _angular_core.InputSignal<((option: TOption, query: string) => boolean) | null>;
|
|
449
|
+
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
450
|
+
/**
|
|
451
|
+
* See `GogErrorDisplay`. Unset, falls back to `GOG_CONFIG.control.errorDisplay`, then to
|
|
452
|
+
* `'manual'` — matching every other control in the library.
|
|
453
|
+
*/
|
|
454
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
455
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
456
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
457
|
+
/** Unset, falls back to `GOG_CONFIG.dropdown.direction`, then to `'auto'`. */
|
|
458
|
+
readonly dropdownDirection: _angular_core.InputSignal<GogDropdownDirection | undefined>;
|
|
459
|
+
/**
|
|
460
|
+
* Explicit stacking order for the panel. Left unset the panel falls back to the
|
|
461
|
+
* stylesheet's `--gog-dropdown-z`, so the default lives in CSS where a consumer can
|
|
462
|
+
* retheme it, rather than being baked into the component.
|
|
463
|
+
*/
|
|
464
|
+
readonly dropdownZIndex: _angular_core.InputSignal<number | null>;
|
|
465
|
+
/**
|
|
466
|
+
* Fixed panel width as any CSS length (`'320px'`, `'40ch'`, `'100%'`, …), applied only
|
|
467
|
+
* when `appendToBody` is set. Left unset the panel matches the trigger's width, same as
|
|
468
|
+
* the inline panel already does via CSS.
|
|
469
|
+
*/
|
|
470
|
+
readonly dropdownWidth: _angular_core.InputSignal<string | null>;
|
|
471
|
+
/**
|
|
472
|
+
* Fixed panel max-height as any CSS length, applied only when `appendToBody` is set.
|
|
473
|
+
* `px`, `%` and `vh` also feed the up/down placement math (see `resolveCssLengthPx`); any
|
|
474
|
+
* other unit still renders correctly but is invisible to that heuristic, so the panel may
|
|
475
|
+
* pick the "wrong" side close to a viewport edge. Left unset the panel keeps the existing
|
|
476
|
+
* viewport-derived, auto-flipping height.
|
|
477
|
+
*/
|
|
478
|
+
readonly dropdownMaxHeight: _angular_core.InputSignal<string | null>;
|
|
479
|
+
/** Unset, falls back to `GOG_CONFIG.dropdown.appendToBody`, then to `false`. */
|
|
480
|
+
readonly appendToBody: _angular_core.InputSignal<boolean | undefined>;
|
|
481
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
482
|
+
/**
|
|
483
|
+
* @deprecated since 21.3.0 (2026-08-07) — project an `<ng-template gogDropdownChevron>` into
|
|
484
|
+
* the control instead. Removed in 21.5.0.
|
|
485
|
+
*/
|
|
486
|
+
readonly chevronTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
487
|
+
/** Projected `gogDropdownChevron` template; wins over the deprecated `chevronTemplate`. */
|
|
488
|
+
protected readonly chevronSlot: Signal<GogDropdownChevronDirective | undefined>;
|
|
489
|
+
/**
|
|
490
|
+
* Full width of the container by default, matching every other field-style control.
|
|
491
|
+
* Set to `false` to shrink the trigger to fit its selected label instead.
|
|
492
|
+
*/
|
|
493
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
494
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.variant`, then to `'none'` (off). */
|
|
495
|
+
readonly floatLabel: _angular_core.InputSignal<GogFloatLabelVariant | undefined>;
|
|
496
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.showPlaceholder`, then to `false`. */
|
|
497
|
+
readonly floatLabelShowPlaceholder: _angular_core.InputSignal<boolean | undefined>;
|
|
498
|
+
readonly isOpen: _angular_core.WritableSignal<boolean>;
|
|
499
|
+
/** Projected `gogDropdownOption` template, if the consumer supplied one. */
|
|
500
|
+
protected readonly optionSlot: Signal<GogDropdownOptionDirective<any> | undefined>;
|
|
501
|
+
/** An option's visible text, via `optionLabel`. */
|
|
502
|
+
protected labelOf(option: TOption): string;
|
|
503
|
+
/**
|
|
504
|
+
* The value this control emits for an option, via `optionValue` — or the option object
|
|
505
|
+
* itself when `optionValue` is `null`.
|
|
506
|
+
*/
|
|
507
|
+
protected valueOf(option: TOption): unknown;
|
|
508
|
+
/** Whether an option is disabled, via `optionDisabled`. Anything falsy counts as enabled. */
|
|
509
|
+
protected isOptionDisabled(option: TOption): boolean;
|
|
510
|
+
/** Context for a projected `gogDropdownOption` row. */
|
|
511
|
+
protected optionContext(option: TOption, selected: boolean): GogDropdownOptionContext<TOption>;
|
|
512
|
+
/** Shared by both controls to match a resolved option value against the current value. */
|
|
513
|
+
protected sameValue(a: unknown, b: unknown): boolean;
|
|
514
|
+
/** The `<ng-template>` holding the panel markup, rendered inline or into `<body>`. */
|
|
515
|
+
protected abstract readonly panelTemplate: Signal<TemplateRef<unknown> | undefined>;
|
|
516
|
+
/** Declared by the subclass so each control keeps its own value type. */
|
|
517
|
+
protected abstract readonly value: ModelSignal<TValue>;
|
|
518
|
+
/** Value applied when a form writes `null` / the control is reset. */
|
|
519
|
+
protected abstract readonly emptyValue: TValue;
|
|
520
|
+
/** BEM class of one option button, used to collect keyboard-navigable elements. */
|
|
521
|
+
protected abstract readonly optionClass: string;
|
|
522
|
+
/** BEM class of the focusable trigger. */
|
|
523
|
+
protected abstract readonly triggerClass: string;
|
|
524
|
+
/**
|
|
525
|
+
* BEM block that carries the size modifier — `.gog-select` vs `.gog-ms-wrapper`. Separate
|
|
526
|
+
* from `triggerClass` because in `gog-multiselect` the two are different elements.
|
|
527
|
+
*/
|
|
528
|
+
protected abstract readonly sizeBlockClass: string;
|
|
529
|
+
/** BEM block of the panel, which repeats the size modifier when appended to `<body>`. */
|
|
530
|
+
protected abstract readonly panelBlockClass: string;
|
|
531
|
+
/** Whether the control currently has a selection — drives the float-label "filled" state. */
|
|
532
|
+
protected abstract readonly hasFloatValue: Signal<boolean>;
|
|
533
|
+
/**
|
|
534
|
+
* Spacing tokens feeding the height estimate. Overridable so each control keeps the
|
|
535
|
+
* `--gog-<block>-*` names it already exposes to consumers for theming.
|
|
536
|
+
*/
|
|
537
|
+
protected readonly optionGapToken: string;
|
|
538
|
+
protected readonly optionsPaddingToken: string;
|
|
539
|
+
/** Keep in sync with the real `max-height` on the subclass's `__dropdown` block. */
|
|
540
|
+
protected readonly panelMaxHeightToken: string;
|
|
541
|
+
/** Estimated row height fed into the placement math; not a real layout property. */
|
|
542
|
+
protected readonly optionHeightToken: string;
|
|
543
|
+
/** Unique per-instance suffix, so several dropdowns on a page can't collide on DOM ids. */
|
|
544
|
+
protected readonly uid: number;
|
|
545
|
+
protected readonly elRef: ElementRef<any>;
|
|
546
|
+
protected readonly isBrowser: boolean;
|
|
547
|
+
private readonly document;
|
|
548
|
+
private readonly appRef;
|
|
549
|
+
private readonly destroyRef;
|
|
550
|
+
private readonly ngControl;
|
|
551
|
+
private readonly globalConfig;
|
|
552
|
+
private readonly overlay;
|
|
553
|
+
/** Set from `(focus)`/`(blur)` on the trigger — see `onFocusIn`/`onFocusOut`. */
|
|
554
|
+
protected readonly isFocused: _angular_core.WritableSignal<boolean>;
|
|
555
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
556
|
+
protected readonly resolvedSize: Signal<GogSize>;
|
|
557
|
+
protected readonly resolvedErrorDisplay: Signal<GogErrorDisplay>;
|
|
558
|
+
protected readonly resolvedAppendToBody: Signal<boolean>;
|
|
559
|
+
protected readonly resolvedDropdownDirection: Signal<GogDropdownDirection>;
|
|
560
|
+
/**
|
|
561
|
+
* The single size modifier for the wrapper, replacing one `[class.<block>--<size>]` binding
|
|
562
|
+
* per size. Empty for `'md'`: that is the default size and has no modifier rule of its own —
|
|
563
|
+
* every `--gog-<block>-size-*` chain bottoms out at the `md` tokens.
|
|
564
|
+
*/
|
|
565
|
+
protected readonly sizeClass: Signal<string>;
|
|
566
|
+
/**
|
|
567
|
+
* Same modifier repeated on the panel, but only when it is appended to `<body>` — outside
|
|
568
|
+
* the component's subtree the panel no longer inherits the wrapper's size tokens, so it has
|
|
569
|
+
* to carry them itself. See the `--portal` blocks in the component stylesheets.
|
|
570
|
+
*/
|
|
571
|
+
protected readonly panelSizeClass: Signal<string>;
|
|
572
|
+
private readonly cvaDisabled;
|
|
573
|
+
private readonly errorState;
|
|
574
|
+
protected readonly isDisabled: Signal<boolean>;
|
|
575
|
+
protected readonly dropdownDirectionState: _angular_core.WritableSignal<"up" | "down">;
|
|
576
|
+
protected readonly panelPlacement: _angular_core.WritableSignal<GogDropdownPlacement | null>;
|
|
577
|
+
/**
|
|
578
|
+
* Stacking order to write onto the panel, or null to leave it to the stylesheet.
|
|
579
|
+
*
|
|
580
|
+
* Only needed when appending to `<body>`: an inline panel inherits `--gog-dropdown-z` from
|
|
581
|
+
* its surroundings — which is how a dropdown inside a dialog ends up above the dialog —
|
|
582
|
+
* but an appended one sits outside that subtree and inherits nothing, so the value has
|
|
583
|
+
* to be resolved from the trigger and written out explicitly.
|
|
584
|
+
*/
|
|
585
|
+
protected readonly panelZIndex: _angular_core.WritableSignal<number | null>;
|
|
586
|
+
/**
|
|
587
|
+
* Explicit panel width, or null to let it size to its own content.
|
|
588
|
+
*
|
|
589
|
+
* The panel used to be pinned to the trigger's width, which broke a trigger narrower than its
|
|
590
|
+
* options: with `[fullWidth]="false"` the trigger shrinks to the *current* selection, so
|
|
591
|
+
* picking a short option cut the longer ones off in the list. It now sizes to its content with
|
|
592
|
+
* the trigger width as a floor — see `resolvedPanelMinWidth`.
|
|
593
|
+
*/
|
|
594
|
+
protected readonly resolvedPanelWidth: Signal<string | null>;
|
|
595
|
+
/** The trigger's width, used as the panel's minimum so it never renders narrower than it. */
|
|
596
|
+
protected readonly resolvedPanelMinWidth: Signal<string | null>;
|
|
597
|
+
/** `dropdownMaxHeight`, or the viewport-derived max-height from `panelPlacement`. */
|
|
598
|
+
protected readonly resolvedPanelMaxHeight: Signal<string | null>;
|
|
599
|
+
protected readonly hasError: Signal<boolean>;
|
|
600
|
+
protected readonly visibleError: Signal<string>;
|
|
601
|
+
/**
|
|
602
|
+
* Each control supplies its own default: `gog-multiselect` shipped a clear button before
|
|
603
|
+
* `clearable` existed, so it keeps one; `gog-select` opts in.
|
|
604
|
+
*/
|
|
605
|
+
protected abstract readonly clearableByDefault: boolean;
|
|
606
|
+
private readonly clearableState;
|
|
607
|
+
/** Whether to render the clear button right now — see `GogClearableState`. */
|
|
608
|
+
protected readonly showClear: Signal<boolean>;
|
|
609
|
+
protected readonly resolvedFilter: Signal<boolean>;
|
|
610
|
+
protected readonly resolvedFilterPosition: Signal<GogDropdownFilterPosition>;
|
|
611
|
+
/** Current search text. Cleared whenever the panel closes, so reopening starts fresh. */
|
|
612
|
+
protected readonly filterQuery: _angular_core.WritableSignal<string>;
|
|
613
|
+
/**
|
|
614
|
+
* The options actually rendered. Everything downstream — the loops, the keyboard navigation
|
|
615
|
+
* target list, the panel height estimate, and multiselect's select-all — reads this rather
|
|
616
|
+
* than `options()`, so filtering stays consistent instead of only hiding rows visually.
|
|
617
|
+
*/
|
|
618
|
+
protected readonly visibleOptions: Signal<TOption[]>;
|
|
619
|
+
protected onFilterInput(event: Event): void;
|
|
620
|
+
/** Resets the control to its empty value and notifies any attached form. */
|
|
621
|
+
protected clearValue(event: Event): void;
|
|
622
|
+
/**
|
|
623
|
+
* `hasFloatValue` is wrapped in a `computed` rather than passed straight through: these
|
|
624
|
+
* field initializers run before the *subclass's* do, so `this.hasFloatValue` is still
|
|
625
|
+
* undefined right here. The arrow defers the read until the signal is first evaluated, by
|
|
626
|
+
* which time the subclass has assigned it.
|
|
627
|
+
*/
|
|
628
|
+
private readonly floatLabelState;
|
|
629
|
+
protected readonly resolvedFloatLabel: Signal<GogFloatLabelVariant>;
|
|
630
|
+
protected readonly isFloatLabelActive: Signal<boolean>;
|
|
631
|
+
protected readonly isFloatLabelFloated: Signal<boolean>;
|
|
632
|
+
protected readonly effectivePlaceholder: Signal<string>;
|
|
633
|
+
/** Measured once per open rather than per scroll tick — see `refreshPanelMetrics`. */
|
|
634
|
+
private optionGap;
|
|
635
|
+
private optionsPadding;
|
|
636
|
+
private maxPanelHeight;
|
|
637
|
+
private optionHeight;
|
|
638
|
+
private repositionFrame;
|
|
639
|
+
private onChangeFn;
|
|
640
|
+
private onTouchedFn;
|
|
641
|
+
constructor();
|
|
642
|
+
/**
|
|
643
|
+
* Binds the click-outside and reposition listeners only for as long as the panel is
|
|
644
|
+
* open. Bound permanently — as host listeners were — every dropdown on the page runs a
|
|
645
|
+
* handler on every document click and every scroll frame, whether or not it is showing
|
|
646
|
+
* anything.
|
|
647
|
+
*/
|
|
648
|
+
private bindWhileOpen;
|
|
649
|
+
ngDoCheck(): void;
|
|
650
|
+
writeValue(val: TValue | null): void;
|
|
651
|
+
registerOnChange(fn: (val: TValue) => void): void;
|
|
652
|
+
registerOnTouched(fn: () => void): void;
|
|
653
|
+
setDisabledState(isDisabled: boolean): void;
|
|
654
|
+
/** Bound to `(focus)` on the trigger — only drives the float-label floated state. */
|
|
655
|
+
protected onFocusIn(): void;
|
|
656
|
+
/** Bound to `(blur)` on the trigger — only drives the float-label floated state. */
|
|
657
|
+
protected onFocusOut(): void;
|
|
658
|
+
protected toggle(): void;
|
|
659
|
+
protected open(): void;
|
|
660
|
+
protected close(): void;
|
|
661
|
+
/** Writes a new selection out to both the model and the attached form control. */
|
|
662
|
+
protected commitValue(next: TValue): void;
|
|
663
|
+
protected markTouched(): void;
|
|
664
|
+
private closeIfClickedOutside;
|
|
665
|
+
/**
|
|
666
|
+
* Coalesces bursts of scroll/resize events into one reposition per frame. Placement
|
|
667
|
+
* reads layout, so running it per event is what makes a scroll janky.
|
|
668
|
+
*/
|
|
669
|
+
private scheduleReposition;
|
|
670
|
+
/** Jumps from the trigger into the option list on ArrowDown/ArrowUp while open. */
|
|
671
|
+
protected onTriggerArrowKeydown(event: Event): void;
|
|
672
|
+
protected onOptionKeydown(event: KeyboardEvent): void;
|
|
673
|
+
protected focusTrigger(): void;
|
|
674
|
+
/** Extra chrome stacked above the options (e.g. a select-all row), in px. */
|
|
675
|
+
protected extraPanelHeight(): number;
|
|
676
|
+
private enabledOptionElements;
|
|
677
|
+
private attachOverlay;
|
|
678
|
+
/**
|
|
679
|
+
* Reads the spacing tokens that feed the height estimate. Done once per open instead of
|
|
680
|
+
* on every scroll tick, because `getComputedStyle` forces a style recalculation and the
|
|
681
|
+
* tokens cannot change while the panel is on screen.
|
|
682
|
+
*/
|
|
683
|
+
private refreshPanelMetrics;
|
|
684
|
+
/**
|
|
685
|
+
* Rough height, used only to choose up/down and to cap `max-height` before the panel
|
|
686
|
+
* has been laid out. Deliberately an estimate: measuring would require rendering the
|
|
687
|
+
* panel first, which is what we are trying to position. A resolvable `dropdownMaxHeight`
|
|
688
|
+
* replaces the row-count guess outright, since it is exact rather than estimated.
|
|
689
|
+
*/
|
|
690
|
+
private estimatePanelHeight;
|
|
691
|
+
/**
|
|
692
|
+
* The trigger's own rect, not the whole component's — a label above it or an error
|
|
693
|
+
* message below it sit in normal document flow and are not part of what the panel needs
|
|
694
|
+
* to clear. This also keeps `appendToBody` placement consistent with the inline panel,
|
|
695
|
+
* which is already positioned purely relative to the trigger via CSS.
|
|
696
|
+
*/
|
|
697
|
+
private triggerRect;
|
|
698
|
+
/** The stacking order the panel would have had if it were still inside the subtree. */
|
|
699
|
+
private resolvePanelZIndex;
|
|
700
|
+
private updatePlacement;
|
|
701
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogDropdownBase<any, any>, never>;
|
|
702
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogDropdownBase<any, any>, never, never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; "isSignal": true; }; "filterPosition": { "alias": "filterPosition"; "required": false; "isSignal": true; }; "filterEmptyMessage": { "alias": "filterEmptyMessage"; "required": false; "isSignal": true; }; "filterMatch": { "alias": "filterMatch"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dropdownDirection": { "alias": "dropdownDirection"; "required": false; "isSignal": true; }; "dropdownZIndex": { "alias": "dropdownZIndex"; "required": false; "isSignal": true; }; "dropdownWidth": { "alias": "dropdownWidth"; "required": false; "isSignal": true; }; "dropdownMaxHeight": { "alias": "dropdownMaxHeight"; "required": false; "isSignal": true; }; "appendToBody": { "alias": "appendToBody"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "chevronTemplate": { "alias": "chevronTemplate"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "floatLabelShowPlaceholder": { "alias": "floatLabelShowPlaceholder"; "required": false; "isSignal": true; }; }, {}, ["chevronSlot", "optionSlot"], never, true, never>;
|
|
703
|
+
}
|
|
704
|
+
|
|
705
|
+
/**
|
|
706
|
+
* A text field that suggests options as you type.
|
|
707
|
+
*
|
|
708
|
+
* ```html
|
|
709
|
+
* <gog-autocomplete
|
|
710
|
+
* [options]="users"
|
|
711
|
+
* optionLabel="profile.fullName"
|
|
712
|
+
* [optionValue]="null"
|
|
713
|
+
* [(value)]="user"
|
|
714
|
+
* (gogSearch)="load($event)"
|
|
715
|
+
* [loading]="loading()"
|
|
716
|
+
* />
|
|
717
|
+
* ```
|
|
718
|
+
*
|
|
719
|
+
* Shares `GogDropdownBase` with `gog-select` — placement, the append-to-body overlay, the
|
|
720
|
+
* option accessors, float label, error state and `ControlValueAccessor` all come from there.
|
|
721
|
+
* What makes it a separate control rather than a mode of `gog-select` is the trigger: here it
|
|
722
|
+
* is a real `<input>`, which changes the ARIA contract completely. The input keeps DOM focus
|
|
723
|
+
* the whole time and the highlighted option is pointed at with `aria-activedescendant`, where
|
|
724
|
+
* a listbox moves focus onto the option itself.
|
|
725
|
+
*/
|
|
726
|
+
declare class AutocompleteComponent<TOption = GogDropdownOption, TValue = string | number | null> extends GogDropdownBase<TValue, TOption> {
|
|
727
|
+
readonly inputId: _angular_core.InputSignal<string>;
|
|
728
|
+
/**
|
|
729
|
+
* Two-way bindable selected value: `[(value)]="signal"`. Carries whatever `optionValue`
|
|
730
|
+
* resolves to — an id by default, or the option object itself when `optionValue` is `null`.
|
|
731
|
+
*/
|
|
732
|
+
readonly value: _angular_core.ModelSignal<TValue>;
|
|
733
|
+
/**
|
|
734
|
+
* Whether to narrow `options` in the browser as the user types.
|
|
735
|
+
*
|
|
736
|
+
* Leave it on for a list you already hold. Turn it **off** when `gogSearch` fetches an
|
|
737
|
+
* already-filtered list from a server: filtering that answer a second time against the same
|
|
738
|
+
* query is the classic double-filtering bug, and it silently drops rows whose match the
|
|
739
|
+
* server found in a field this component cannot see.
|
|
740
|
+
*/
|
|
741
|
+
readonly filterLocal: _angular_core.InputSignal<boolean>;
|
|
742
|
+
/** How many characters before the panel opens at all. */
|
|
743
|
+
readonly minLength: _angular_core.InputSignal<number | undefined>;
|
|
744
|
+
/**
|
|
745
|
+
* Whether focusing the field opens the panel immediately, showing the full option list —
|
|
746
|
+
* before `minLength` would otherwise have let anything through. Off, the field behaves as
|
|
747
|
+
* before: nothing opens until enough has been typed. Unset, falls back to
|
|
748
|
+
* `GOG_CONFIG.autocomplete.openOnFocus`, then to `true`.
|
|
749
|
+
*/
|
|
750
|
+
readonly openOnFocus: _angular_core.InputSignal<boolean | undefined>;
|
|
751
|
+
/** Milliseconds of quiet before `gogSearch` fires. `0` emits on every keystroke. */
|
|
752
|
+
readonly searchDebounce: _angular_core.InputSignal<number | undefined>;
|
|
753
|
+
/** Shows a spinner in the trailing slot — for a server-backed source that is still loading. */
|
|
754
|
+
readonly loading: _angular_core.InputSignal<boolean>;
|
|
755
|
+
/** Shown in place of the list when nothing matches. */
|
|
756
|
+
readonly emptyMessage: _angular_core.InputSignal<string>;
|
|
757
|
+
/**
|
|
758
|
+
* Whether free text that matches no option is discarded when the field loses focus.
|
|
759
|
+
*
|
|
760
|
+
* On (the default) the field always ends up reflecting a real selection: editing is treated
|
|
761
|
+
* as transient, so the current `value` survives keystrokes and Escape or blur snaps the text
|
|
762
|
+
* back to it.
|
|
763
|
+
*
|
|
764
|
+
* Off, what the user typed is itself meaningful — a create-as-you-type flow. The text is left
|
|
765
|
+
* alone on blur and `value` is dropped as soon as it stops matching, so the two never
|
|
766
|
+
* disagree. Read the typed text from `gogSearch` rather than from `value`.
|
|
767
|
+
*/
|
|
768
|
+
readonly forceSelection: _angular_core.InputSignal<boolean>;
|
|
769
|
+
/** The current query, debounced. Wire a server-side lookup to this. */
|
|
770
|
+
readonly gogSearch: _angular_core.OutputEmitterRef<string>;
|
|
771
|
+
/**
|
|
772
|
+
* Fires when the panel is scrolled to the end of the option list — the signal to fetch and
|
|
773
|
+
* append another page of a large or server-backed source, rather than handing the whole
|
|
774
|
+
* thing over up front. Forwarded from the panel's own `gog-scroll`.
|
|
775
|
+
*/
|
|
776
|
+
readonly gogLoadMore: _angular_core.OutputEmitterRef<void>;
|
|
777
|
+
protected readonly panelTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
|
|
778
|
+
/** A cleared autocomplete is `null`, whatever `TValue` the consumer bound. */
|
|
779
|
+
protected readonly emptyValue: TValue;
|
|
780
|
+
protected readonly optionClass = "gog-autocomplete__option";
|
|
781
|
+
protected readonly triggerClass = "gog-autocomplete__control";
|
|
782
|
+
protected readonly sizeBlockClass = "gog-autocomplete";
|
|
783
|
+
protected readonly panelBlockClass = "gog-autocomplete__dropdown";
|
|
784
|
+
/** Opt-in, matching `gog-select` and `gog-inputfield`. */
|
|
785
|
+
protected readonly clearableByDefault = false;
|
|
786
|
+
protected readonly optionGapToken = "--gog-autocomplete-option-gap";
|
|
787
|
+
protected readonly panelMaxHeightToken = "--gog-autocomplete-panel-max-height";
|
|
788
|
+
protected readonly optionHeightToken = "--gog-autocomplete-option-height";
|
|
789
|
+
private readonly config;
|
|
790
|
+
private readonly ownDestroyRef;
|
|
791
|
+
protected readonly triggerId: _angular_core.Signal<string>;
|
|
792
|
+
protected readonly listboxId: _angular_core.Signal<string>;
|
|
793
|
+
protected readonly labelId: _angular_core.Signal<string>;
|
|
794
|
+
protected readonly errorId: _angular_core.Signal<string | null>;
|
|
795
|
+
protected optionId(index: number): string;
|
|
796
|
+
protected readonly resolvedMinLength: _angular_core.Signal<number>;
|
|
797
|
+
private readonly resolvedDebounce;
|
|
798
|
+
protected readonly resolvedOpenOnFocus: _angular_core.Signal<boolean>;
|
|
799
|
+
/** What is actually in the `<input>`. Not the same thing as the committed `value`. */
|
|
800
|
+
protected readonly query: _angular_core.WritableSignal<string>;
|
|
801
|
+
/**
|
|
802
|
+
* True right after `openOnFocus` opens the panel, until the user actually types. The field
|
|
803
|
+
* may already be showing a previously-selected label at that point — this keeps the panel's
|
|
804
|
+
* list unfiltered by it, so focusing shows every option rather than just the one that
|
|
805
|
+
* happens to match the current text. Cleared on the first keystroke, so filtering resumes
|
|
806
|
+
* exactly as before.
|
|
807
|
+
*/
|
|
808
|
+
protected readonly browsingAll: _angular_core.WritableSignal<boolean>;
|
|
809
|
+
/**
|
|
810
|
+
* Which option the arrows have highlighted. `-1` means none — Enter then does nothing rather
|
|
811
|
+
* than committing whichever row happened to be first, which is what stops a fast typist from
|
|
812
|
+
* selecting something they never looked at.
|
|
813
|
+
*/
|
|
814
|
+
protected readonly activeIndex: _angular_core.WritableSignal<number>;
|
|
815
|
+
protected readonly selectedOption: _angular_core.Signal<NonNullable<TOption> | null>;
|
|
816
|
+
protected readonly selectedLabel: _angular_core.Signal<string>;
|
|
817
|
+
protected readonly hasFloatValue: _angular_core.Signal<boolean>;
|
|
818
|
+
/**
|
|
819
|
+
* Local filtering, replacing the base's panel-filter behaviour: here the query comes from the
|
|
820
|
+
* trigger, not from a search box inside the panel. Overriding this rather than duplicating a
|
|
821
|
+
* second filtered list keeps the keyboard targets, the empty state and the panel height
|
|
822
|
+
* estimate all reading the same set.
|
|
823
|
+
*/
|
|
824
|
+
protected readonly visibleOptions: _angular_core.Signal<TOption[]>;
|
|
825
|
+
protected readonly activeOptionId: _angular_core.Signal<string | null>;
|
|
826
|
+
private searchTimer;
|
|
827
|
+
constructor();
|
|
828
|
+
protected isSelected(option: TOption): boolean;
|
|
829
|
+
protected onInput(event: Event): void;
|
|
830
|
+
/**
|
|
831
|
+
* The input owns its arrow keys; the base's option-focusing handlers are deliberately not
|
|
832
|
+
* wired up here. Moving DOM focus into the list would take the caret out of the field, which
|
|
833
|
+
* is exactly what a combobox must not do.
|
|
834
|
+
*/
|
|
835
|
+
protected onInputKeydown(event: KeyboardEvent): void;
|
|
836
|
+
protected onOptionClick(option: TOption, event: MouseEvent): void;
|
|
837
|
+
/**
|
|
838
|
+
* Keeps the caret in the field while an option is clicked. Without it the input blurs first,
|
|
839
|
+
* `forceSelection` wipes the text, and the click lands on a list that has already closed.
|
|
840
|
+
*/
|
|
841
|
+
protected onOptionMousedown(event: MouseEvent): void;
|
|
842
|
+
protected onInputFocus(): void;
|
|
843
|
+
protected onInputBlur(): void;
|
|
844
|
+
protected close(): void;
|
|
845
|
+
/** Clearing has to empty the *text* as well; the base only knows about the value. */
|
|
846
|
+
protected clearValue(event: Event): void;
|
|
847
|
+
private pick;
|
|
848
|
+
/** Snaps the field back to whatever `value` holds — the empty string when nothing is picked. */
|
|
849
|
+
private restoreSelectedText;
|
|
850
|
+
private moveActive;
|
|
851
|
+
private setActive;
|
|
852
|
+
private scrollActiveIntoView;
|
|
853
|
+
private scheduleSearch;
|
|
854
|
+
private cancelPendingSearch;
|
|
855
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any, any>, never>;
|
|
856
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any, any>, "gog-autocomplete", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "filterLocal": { "alias": "filterLocal"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "openOnFocus": { "alias": "openOnFocus"; "required": false; "isSignal": true; }; "searchDebounce": { "alias": "searchDebounce"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "forceSelection": { "alias": "forceSelection"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "gogSearch": "gogSearch"; "gogLoadMore": "gogLoadMore"; }, never, never, true, never>;
|
|
857
|
+
}
|
|
858
|
+
|
|
859
|
+
/**
|
|
860
|
+
* A count or status dot pinned to the corner of another element.
|
|
861
|
+
*
|
|
862
|
+
* ```html
|
|
863
|
+
* <gog-button gogBadge="12" badgeAriaLabel="12 непрочитанных">Входящие</gog-button>
|
|
864
|
+
* <gog-icon name="info" gogBadge badgeDot />
|
|
865
|
+
* ```
|
|
866
|
+
*
|
|
867
|
+
* A **directive, not a component**, because a badge decorates something that already exists —
|
|
868
|
+
* a button, an icon, an avatar. As a component it would have to wrap its host, which changes
|
|
869
|
+
* that host's layout, and it would duplicate `gog-tag` for the sake of one different radius.
|
|
870
|
+
*
|
|
871
|
+
* It renders **nothing at all** when the value is `0`, `null` or empty and `badgeDot` is off:
|
|
872
|
+
* a badge reading "0" is the defining bug of this component class, so it is not reachable.
|
|
873
|
+
*/
|
|
874
|
+
declare class GogBadgeDirective {
|
|
875
|
+
/** The badge content. Numbers above `badgeMax` render as `N+`. */
|
|
876
|
+
readonly gogBadge: _angular_core.InputSignal<string | number | null>;
|
|
877
|
+
readonly badgePosition: _angular_core.InputSignal<GogBadgePosition>;
|
|
878
|
+
/** Reuses the library's semantic colour set — the same four names `gog-tag` takes. */
|
|
879
|
+
readonly badgeVariant: _angular_core.InputSignal<GogTagVariant>;
|
|
880
|
+
/** Renders a bare dot with no text: "something changed here", with no count to give. */
|
|
881
|
+
readonly badgeDot: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
882
|
+
readonly badgeMax: _angular_core.InputSignal<number>;
|
|
883
|
+
/** Keeps the badge out of the DOM without removing the directive. */
|
|
884
|
+
readonly badgeHidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
885
|
+
/**
|
|
886
|
+
* What assistive tech should hear instead of the bare number.
|
|
887
|
+
*
|
|
888
|
+
* Left empty, the badge text is announced inline with the host's own label, which reads as
|
|
889
|
+
* "Входящие 12" — acceptable, and what Material does. Set this and the visible badge becomes
|
|
890
|
+
* `aria-hidden` while this wording is announced in its place, so the host reads as
|
|
891
|
+
* "Входящие, 12 непрочитанных" instead.
|
|
892
|
+
*/
|
|
893
|
+
readonly badgeAriaLabel: _angular_core.InputSignal<string>;
|
|
894
|
+
private readonly hostRef;
|
|
895
|
+
private readonly renderer;
|
|
896
|
+
private readonly isBrowser;
|
|
897
|
+
private badgeEl;
|
|
898
|
+
private descriptionEl;
|
|
899
|
+
/** `0` and `''` count as "nothing to show" — see the class comment. */
|
|
900
|
+
private readonly hasContent;
|
|
901
|
+
protected readonly visible: _angular_core.Signal<boolean>;
|
|
902
|
+
protected readonly text: _angular_core.Signal<string>;
|
|
903
|
+
private readonly classNames;
|
|
904
|
+
constructor();
|
|
905
|
+
private render;
|
|
906
|
+
private removeDescription;
|
|
907
|
+
private teardown;
|
|
908
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogBadgeDirective, never>;
|
|
909
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogBadgeDirective, "[gogBadge]", never, { "gogBadge": { "alias": "gogBadge"; "required": false; "isSignal": true; }; "badgePosition": { "alias": "badgePosition"; "required": false; "isSignal": true; }; "badgeVariant": { "alias": "badgeVariant"; "required": false; "isSignal": true; }; "badgeDot": { "alias": "badgeDot"; "required": false; "isSignal": true; }; "badgeMax": { "alias": "badgeMax"; "required": false; "isSignal": true; }; "badgeHidden": { "alias": "badgeHidden"; "required": false; "isSignal": true; }; "badgeAriaLabel": { "alias": "badgeAriaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
910
|
+
}
|
|
911
|
+
|
|
912
|
+
type GogIconName = 'check' | 'close' | 'chevron-up' | 'chevron-down' | 'chevron-left' | 'chevron-right' | 'calendar' | 'clock' | 'sort' | 'sort-up' | 'sort-down' | 'success' | 'error' | 'warning' | 'info' | 'checkbox' | 'checkbox-checked' | 'eye' | 'eye-off' | 'copy';
|
|
913
|
+
declare const ICON_DEFS: Record<GogIconName, string>;
|
|
914
|
+
|
|
915
|
+
declare class IconComponent {
|
|
916
|
+
private readonly sanitizer;
|
|
917
|
+
readonly name: _angular_core.InputSignal<GogIconName>;
|
|
918
|
+
readonly template: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
919
|
+
readonly title: _angular_core.InputSignal<string>;
|
|
920
|
+
readonly ariaHidden: _angular_core.InputSignal<boolean>;
|
|
921
|
+
protected readonly ariaLabel: _angular_core.Signal<string | null>;
|
|
922
|
+
protected readonly iconSvg: _angular_core.Signal<_angular_platform_browser.SafeHtml>;
|
|
923
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
|
|
924
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "gog-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "template": { "alias": "template"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "ariaHidden": { "alias": "ariaHidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
925
|
+
}
|
|
926
|
+
|
|
927
|
+
/** Context handed to a `gogButtonToggleOption` template. */
|
|
928
|
+
interface GogButtonToggleOptionContext<TOption> {
|
|
929
|
+
/** The consumer's own option object, untouched. */
|
|
930
|
+
$implicit: TOption;
|
|
931
|
+
selected: boolean;
|
|
932
|
+
disabled: boolean;
|
|
933
|
+
/** The resolved label, so custom markup can decorate it rather than re-derive it. */
|
|
934
|
+
label: string;
|
|
935
|
+
}
|
|
936
|
+
/**
|
|
937
|
+
* Custom markup for one button in the group:
|
|
938
|
+
*
|
|
939
|
+
* ```html
|
|
940
|
+
* <gog-button-toggle-group [options]="views">
|
|
941
|
+
* <ng-template gogButtonToggleOption let-view let-selected="selected">
|
|
942
|
+
* <gog-icon [name]="view.icon" /> {{ view.title }}
|
|
943
|
+
* </ng-template>
|
|
944
|
+
* </gog-button-toggle-group>
|
|
945
|
+
* ```
|
|
946
|
+
*/
|
|
947
|
+
declare class GogButtonToggleOptionDirective<TOption = unknown> {
|
|
948
|
+
readonly templateRef: TemplateRef<GogButtonToggleOptionContext<TOption>>;
|
|
949
|
+
static ngTemplateContextGuard<TOption>(_dir: GogButtonToggleOptionDirective<TOption>, ctx: unknown): ctx is GogButtonToggleOptionContext<TOption>;
|
|
950
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogButtonToggleOptionDirective<any>, never>;
|
|
951
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogButtonToggleOptionDirective<any>, "[gogButtonToggleOption]", never, {}, {}, never, never, true, never>;
|
|
952
|
+
}
|
|
953
|
+
/**
|
|
954
|
+
* A row of buttons where one — or, with `multiple`, several — can be picked.
|
|
955
|
+
*
|
|
956
|
+
* ```html
|
|
957
|
+
* <gog-button-toggle-group [options]="alignments" [(value)]="align" />
|
|
958
|
+
* <gog-button-toggle-group [options]="tools" [multiple]="true" [(value)]="active" />
|
|
959
|
+
* ```
|
|
960
|
+
*
|
|
961
|
+
* Takes the consumer's own objects through `optionLabel` / `optionValue` / `optionDisabled`
|
|
962
|
+
* accessors — the same ones `gog-select` uses — rather than a fixed `{ id, label }` shape.
|
|
963
|
+
*
|
|
964
|
+
* **Single and multiple are different widgets to assistive tech, not a cosmetic switch.**
|
|
965
|
+
* Single mode is a radio group: `role="radiogroup"` / `role="radio"` with `aria-checked`, and
|
|
966
|
+
* the arrow keys move *and* select, because that is what a radio group does. Multiple mode is
|
|
967
|
+
* a toolbar of independent toggles: `role="group"` with `aria-pressed`, arrows only move and
|
|
968
|
+
* Space toggles. Getting this backwards is the usual defect in this component.
|
|
969
|
+
*/
|
|
970
|
+
declare class ButtonToggleGroupComponent<TOption = unknown, TValue = unknown> implements ControlValueAccessor {
|
|
971
|
+
readonly options: _angular_core.InputSignal<TOption[]>;
|
|
972
|
+
readonly optionLabel: _angular_core.InputSignal<GogOptionAccessor<TOption, string>>;
|
|
973
|
+
/**
|
|
974
|
+
* How an option turns into the emitted value. `null` emits the **option object itself**,
|
|
975
|
+
* exactly as `gog-select` does, so a consumer's DTO survives the round trip.
|
|
976
|
+
*/
|
|
977
|
+
readonly optionValue: _angular_core.InputSignal<GogOptionAccessor<TOption, unknown> | null>;
|
|
978
|
+
readonly optionDisabled: _angular_core.InputSignal<GogOptionAccessor<TOption, boolean>>;
|
|
979
|
+
/** Optional leading icon per option. Unset means no icons anywhere in the group. */
|
|
980
|
+
readonly optionIcon: _angular_core.InputSignal<GogOptionAccessor<TOption, GogIconName | null> | null>;
|
|
981
|
+
/** Whether more than one option can be active at a time. */
|
|
982
|
+
readonly multiple: _angular_core.InputSignal<boolean>;
|
|
983
|
+
readonly appearance: _angular_core.InputSignal<GogButtonToggleAppearance>;
|
|
984
|
+
readonly orientation: _angular_core.InputSignal<GogOrientation>;
|
|
985
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
986
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
987
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
988
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
989
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
990
|
+
/**
|
|
991
|
+
* Two-way bindable selection: `[(value)]="signal"`. A single value in single mode, an array
|
|
992
|
+
* in `multiple` mode. Also drivable through `formControl` / `formControlName`.
|
|
993
|
+
*/
|
|
994
|
+
readonly value: _angular_core.ModelSignal<TValue | TValue[] | null>;
|
|
995
|
+
protected readonly optionSlot: _angular_core.Signal<GogButtonToggleOptionDirective<any> | undefined>;
|
|
996
|
+
private readonly buttonRefs;
|
|
997
|
+
private readonly ngControl;
|
|
998
|
+
private readonly cvaDisabled;
|
|
999
|
+
private readonly globalConfig;
|
|
1000
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
1001
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
1002
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1003
|
+
/** The current selection as an array, whatever mode the group is in. */
|
|
1004
|
+
private readonly selectedValues;
|
|
1005
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1006
|
+
/**
|
|
1007
|
+
* A roving tabindex: the group is one tab stop and the arrows move within it. The *selected*
|
|
1008
|
+
* option is the one that keeps `tabindex="0"` so Tab returns to where the user left off;
|
|
1009
|
+
* with nothing selected, the first enabled option takes it, since a group nobody can Tab
|
|
1010
|
+
* into is unreachable by keyboard.
|
|
1011
|
+
*/
|
|
1012
|
+
protected readonly tabStopIndex: _angular_core.Signal<number>;
|
|
1013
|
+
private onChange;
|
|
1014
|
+
private onTouched;
|
|
1015
|
+
constructor();
|
|
1016
|
+
writeValue(val: TValue | TValue[] | null): void;
|
|
1017
|
+
registerOnChange(fn: (val: TValue | TValue[] | null) => void): void;
|
|
1018
|
+
registerOnTouched(fn: () => void): void;
|
|
1019
|
+
setDisabledState(isDisabled: boolean): void;
|
|
1020
|
+
protected labelOf(option: TOption): string;
|
|
1021
|
+
protected iconOf(option: TOption): GogIconName | null;
|
|
1022
|
+
protected valueOf(option: TOption): unknown;
|
|
1023
|
+
protected isOptionDisabled(option: TOption): boolean;
|
|
1024
|
+
protected isSelected(option: TOption): boolean;
|
|
1025
|
+
protected optionContext(option: TOption): GogButtonToggleOptionContext<TOption>;
|
|
1026
|
+
protected onOptionClick(option: TOption): void;
|
|
1027
|
+
/**
|
|
1028
|
+
* Arrow keys. In single mode moving also selects — that is the radio-group contract, and it
|
|
1029
|
+
* is why `role="radio"` is only used there. In multiple mode the arrows are pure navigation
|
|
1030
|
+
* and Space/Enter (handled natively by the `<button>`) does the toggling.
|
|
1031
|
+
*/
|
|
1032
|
+
protected onKeydown(event: KeyboardEvent): void;
|
|
1033
|
+
protected onBlur(): void;
|
|
1034
|
+
private commit;
|
|
1035
|
+
private setValue;
|
|
1036
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonToggleGroupComponent<any, any>, never>;
|
|
1037
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonToggleGroupComponent<any, any>, "gog-button-toggle-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionLabel": { "alias": "optionLabel"; "required": false; "isSignal": true; }; "optionValue": { "alias": "optionValue"; "required": false; "isSignal": true; }; "optionDisabled": { "alias": "optionDisabled"; "required": false; "isSignal": true; }; "optionIcon": { "alias": "optionIcon"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionSlot"], never, true, never>;
|
|
1038
|
+
}
|
|
1039
|
+
|
|
1040
|
+
/**
|
|
1041
|
+
* Marks a tab's content as **lazy**: it is built the first time the tab is shown, and kept
|
|
1042
|
+
* alive afterwards.
|
|
1043
|
+
*
|
|
1044
|
+
* ```html
|
|
1045
|
+
* <gog-tab label="Отчёт">
|
|
1046
|
+
* <ng-template gogTabContent><app-expensive-report /></ng-template>
|
|
1047
|
+
* </gog-tab>
|
|
1048
|
+
* ```
|
|
1049
|
+
*
|
|
1050
|
+
* Without it, content written directly inside `<gog-tab>` renders immediately and is merely
|
|
1051
|
+
* hidden while inactive — which is what you want for cheap content, because it preserves
|
|
1052
|
+
* scroll position, un-submitted input and any state the DOM is holding. Which behaviour you
|
|
1053
|
+
* get is decided by whether this template is present; there is no `lazy` input to keep in sync.
|
|
1054
|
+
*/
|
|
1055
|
+
declare class GogTabContentDirective {
|
|
1056
|
+
readonly templateRef: TemplateRef<unknown>;
|
|
1057
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogTabContentDirective, never>;
|
|
1058
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogTabContentDirective, "[gogTabContent]", never, {}, {}, never, never, true, never>;
|
|
1059
|
+
}
|
|
1060
|
+
/**
|
|
1061
|
+
* One tab inside a `<gog-tabs>`. Declares its own header text and holds its own content.
|
|
1062
|
+
*
|
|
1063
|
+
* ```html
|
|
1064
|
+
* <gog-tabs>
|
|
1065
|
+
* <gog-tab label="Профиль"><app-profile /></gog-tab>
|
|
1066
|
+
* <gog-tab label="Настройки" iconName="info" [disabled]="!canEdit">…</gog-tab>
|
|
1067
|
+
* </gog-tabs>
|
|
1068
|
+
* ```
|
|
1069
|
+
*/
|
|
1070
|
+
declare class TabComponent {
|
|
1071
|
+
private static nextUid;
|
|
1072
|
+
private readonly uid;
|
|
1073
|
+
/** Header text. */
|
|
1074
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
1075
|
+
/** Optional leading icon in the header. */
|
|
1076
|
+
readonly iconName: _angular_core.InputSignal<GogIconName | null>;
|
|
1077
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
1078
|
+
readonly panelId: string;
|
|
1079
|
+
readonly headerId: string;
|
|
1080
|
+
private readonly tabsState;
|
|
1081
|
+
/** Identity comparison against the group's current tab — no index bookkeeping either side. */
|
|
1082
|
+
readonly active: _angular_core.Signal<boolean>;
|
|
1083
|
+
protected readonly lazySlot: _angular_core.Signal<GogTabContentDirective | undefined>;
|
|
1084
|
+
/**
|
|
1085
|
+
* Latches on first activation and never resets, so a lazy tab pays its build cost once and
|
|
1086
|
+
* then behaves like an eager one — revisiting it does not rebuild the subtree or lose what
|
|
1087
|
+
* the user typed into it.
|
|
1088
|
+
*/
|
|
1089
|
+
private readonly everActivated;
|
|
1090
|
+
protected readonly shouldRenderLazy: _angular_core.Signal<boolean>;
|
|
1091
|
+
constructor();
|
|
1092
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabComponent, never>;
|
|
1093
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabComponent, "gog-tab", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, ["lazySlot"], ["*"], true, never>;
|
|
1094
|
+
}
|
|
1095
|
+
|
|
1096
|
+
/**
|
|
1097
|
+
* What a `gog-tab` needs from the `gog-tabs` it sits in: which tab is currently showing.
|
|
1098
|
+
*
|
|
1099
|
+
* A token rather than injecting the component directly, purely to keep the import graph
|
|
1100
|
+
* acyclic — `tabs.component.ts` has to import `TabComponent` for its `contentChildren`, so the
|
|
1101
|
+
* tab cannot import the group back. Both sides depend on this file, which depends on neither.
|
|
1102
|
+
*/
|
|
1103
|
+
interface GogTabsState {
|
|
1104
|
+
/** The active tab instance, compared by identity. `null` when the group has no tabs. */
|
|
1105
|
+
readonly activeTab: Signal<unknown | null>;
|
|
1106
|
+
}
|
|
1107
|
+
declare const GOG_TABS_STATE: InjectionToken<GogTabsState>;
|
|
1108
|
+
|
|
1109
|
+
/** Context handed to a `gogTabHeader` template. */
|
|
1110
|
+
interface GogTabHeaderContext {
|
|
1111
|
+
/** The `gog-tab` this header belongs to. */
|
|
1112
|
+
$implicit: TabComponent;
|
|
1113
|
+
active: boolean;
|
|
1114
|
+
disabled: boolean;
|
|
1115
|
+
index: number;
|
|
1116
|
+
}
|
|
1117
|
+
/**
|
|
1118
|
+
* Custom markup for a tab's header button:
|
|
1119
|
+
*
|
|
1120
|
+
* ```html
|
|
1121
|
+
* <gog-tabs>
|
|
1122
|
+
* <ng-template gogTabHeader let-tab let-active="active">
|
|
1123
|
+
* {{ tab.label() }} <gog-tag *ngIf="active">•</gog-tag>
|
|
1124
|
+
* </ng-template>
|
|
1125
|
+
* <gog-tab label="Входящие">…</gog-tab>
|
|
1126
|
+
* </gog-tabs>
|
|
1127
|
+
* ```
|
|
1128
|
+
*/
|
|
1129
|
+
declare class GogTabHeaderDirective {
|
|
1130
|
+
readonly templateRef: TemplateRef<GogTabHeaderContext>;
|
|
1131
|
+
static ngTemplateContextGuard(_dir: GogTabHeaderDirective, ctx: unknown): ctx is GogTabHeaderContext;
|
|
1132
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogTabHeaderDirective, never>;
|
|
1133
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogTabHeaderDirective, "[gogTabHeader]", never, {}, {}, never, never, true, never>;
|
|
1134
|
+
}
|
|
1135
|
+
/**
|
|
1136
|
+
* A tablist over projected `<gog-tab>` children.
|
|
1137
|
+
*
|
|
1138
|
+
* ```html
|
|
1139
|
+
* <gog-tabs [(activeIndex)]="index" align="start">
|
|
1140
|
+
* <gog-tab label="Профиль"><app-profile /></gog-tab>
|
|
1141
|
+
* <gog-tab label="Настройки"><app-settings /></gog-tab>
|
|
1142
|
+
* </gog-tabs>
|
|
1143
|
+
* ```
|
|
1144
|
+
*
|
|
1145
|
+
* The header row is built from each tab's own `label` / `iconName` / `disabled`, so a tab is
|
|
1146
|
+
* declared in exactly one place. Overflowing headers scroll inside a `<gog-scroll>` rather than
|
|
1147
|
+
* a native `overflow-x`, per the library's styling contract — a native scrollbar is the one
|
|
1148
|
+
* piece of chrome no `--gog-*` token can reach.
|
|
1149
|
+
*/
|
|
1150
|
+
declare class TabsComponent implements GogTabsState {
|
|
1151
|
+
readonly tabs: _angular_core.Signal<readonly TabComponent[]>;
|
|
1152
|
+
/** Two-way bindable index of the visible tab: `[(activeIndex)]="signal"`. */
|
|
1153
|
+
readonly activeIndex: _angular_core.ModelSignal<number>;
|
|
1154
|
+
readonly align: _angular_core.InputSignal<GogTabsAlign>;
|
|
1155
|
+
readonly orientation: _angular_core.InputSignal<GogOrientation>;
|
|
1156
|
+
readonly size: _angular_core.InputSignal<GogSize>;
|
|
1157
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
1158
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
1159
|
+
/**
|
|
1160
|
+
* Whether selecting a tab scrolls the (possibly overflowing) header row so the active tab
|
|
1161
|
+
* stays in view — centered where there's room, so its neighbours on both sides stay visible
|
|
1162
|
+
* too, the same "always show what's around the current position" idea `gog-paginator` uses
|
|
1163
|
+
* for pages. Reacts to `activeIndex` however it changes: a click, the arrow keys, or a
|
|
1164
|
+
* consumer setting it directly. On by default; turn it off for a header that never actually
|
|
1165
|
+
* overflows, or to own the scroll position yourself.
|
|
1166
|
+
*/
|
|
1167
|
+
readonly scrollActiveIntoView: _angular_core.InputSignal<boolean>;
|
|
1168
|
+
/**
|
|
1169
|
+
* Whether the header row shows its own draggable scroll thumb/track. Native scrolling
|
|
1170
|
+
* (wheel, touch, keyboard) works the same regardless; this is purely the visual affordance.
|
|
1171
|
+
*
|
|
1172
|
+
* Unset, it follows `scrollActiveIntoView`: hidden while that's on, since a second scroll
|
|
1173
|
+
* indicator sitting right next to the active-tab underline reads as two conflicting signals
|
|
1174
|
+
* for the same thing once selecting a tab already moves the row on its own; shown while it's
|
|
1175
|
+
* off, since the track is then the only way to reach an off-screen tab without a keyboard.
|
|
1176
|
+
* Set explicitly to pin it either way regardless of `scrollActiveIntoView`.
|
|
1177
|
+
*/
|
|
1178
|
+
readonly showScrollTrack: _angular_core.InputSignal<boolean | undefined>;
|
|
1179
|
+
/** Emits the newly active index whenever it changes, including via keyboard. */
|
|
1180
|
+
readonly gogTabChange: _angular_core.OutputEmitterRef<number>;
|
|
1181
|
+
protected readonly headerSlot: _angular_core.Signal<GogTabHeaderDirective | undefined>;
|
|
1182
|
+
private readonly headerRefs;
|
|
1183
|
+
/**
|
|
1184
|
+
* The index actually shown. Clamped, and never a disabled tab: `activeIndex` is a plain
|
|
1185
|
+
* number a consumer can set to anything, and silently showing nothing would be worse than
|
|
1186
|
+
* falling back to the nearest usable tab.
|
|
1187
|
+
*/
|
|
1188
|
+
protected readonly resolvedIndex: _angular_core.Signal<number>;
|
|
1189
|
+
/** Read by each `gog-tab` through `GOG_TABS_STATE`; see `tabs-state.ts`. */
|
|
1190
|
+
readonly activeTab: _angular_core.Signal<TabComponent | null>;
|
|
1191
|
+
/** See `showScrollTrack`'s doc for why this defaults off precisely when the other is on. */
|
|
1192
|
+
protected readonly resolvedShowScrollTrack: _angular_core.Signal<boolean>;
|
|
1193
|
+
private readonly isBrowser;
|
|
1194
|
+
/** Instant for the first scroll (page load shouldn't animate into place), smooth after. */
|
|
1195
|
+
private hasScrolledOnce;
|
|
1196
|
+
constructor();
|
|
1197
|
+
private prefersReducedMotion;
|
|
1198
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1199
|
+
protected selectIndex(index: number): void;
|
|
1200
|
+
protected headerContext(tab: TabComponent, index: number): GogTabHeaderContext;
|
|
1201
|
+
/**
|
|
1202
|
+
* Arrows move focus and activate in one step — the "automatic activation" variant of the
|
|
1203
|
+
* ARIA tabs pattern, which suits panels that are already in the DOM. Home/End jump to the
|
|
1204
|
+
* first/last enabled tab.
|
|
1205
|
+
*/
|
|
1206
|
+
protected onHeaderKeydown(event: KeyboardEvent): void;
|
|
1207
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
|
|
1208
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "gog-tabs", never, { "activeIndex": { "alias": "activeIndex"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "showScrollTrack": { "alias": "showScrollTrack"; "required": false; "isSignal": true; }; }, { "activeIndex": "activeIndexChange"; "gogTabChange": "gogTabChange"; }, ["tabs", "headerSlot"], ["*"], true, never>;
|
|
1209
|
+
}
|
|
1210
|
+
|
|
1211
|
+
/**
|
|
1212
|
+
* Custom markup for the checkbox's tick:
|
|
1213
|
+
*
|
|
1214
|
+
* ```html
|
|
1215
|
+
* <ng-template gogCheckboxIcon><my-icon /></ng-template>
|
|
1216
|
+
* ```
|
|
1217
|
+
*/
|
|
1218
|
+
declare class GogCheckboxIconDirective {
|
|
1219
|
+
readonly templateRef: TemplateRef<unknown>;
|
|
1220
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogCheckboxIconDirective, never>;
|
|
1221
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogCheckboxIconDirective, "[gogCheckboxIcon]", never, {}, {}, never, never, true, never>;
|
|
1222
|
+
}
|
|
1223
|
+
declare class CheckboxComponent implements ControlValueAccessor {
|
|
1224
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
1225
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
1226
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
1227
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
1228
|
+
readonly indeterminate: _angular_core.InputSignal<boolean>;
|
|
1229
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
1230
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
1231
|
+
/**
|
|
1232
|
+
* @deprecated since 21.3.0 (2026-08-07) — project an `<ng-template gogCheckboxIcon>` into the component instead. Removed in 21.5.0.
|
|
1233
|
+
*/
|
|
1234
|
+
readonly checkIconTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
1235
|
+
/** Projected `gogCheckboxIcon` template; wins over the deprecated `checkIconTemplate` input. */
|
|
1236
|
+
protected readonly checkIconSlot: _angular_core.Signal<GogCheckboxIconDirective | undefined>;
|
|
1237
|
+
/**
|
|
1238
|
+
* Two-way bindable checked state: `[(checked)]="signal"`.
|
|
1239
|
+
* This is the same state Angular Forms drives via `writeValue`/`registerOnChange`
|
|
1240
|
+
* when the component is used with `formControlName`/`[formControl]`.
|
|
1241
|
+
* Don't wire both a form directive AND `[(checked)]` to the same instance —
|
|
1242
|
+
* pick one, otherwise you end up with two competing sources of truth.
|
|
1243
|
+
*/
|
|
1244
|
+
readonly checked: _angular_core.ModelSignal<boolean>;
|
|
1245
|
+
private readonly globalConfig;
|
|
1246
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
1247
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
1248
|
+
protected readonly controlSize: _angular_core.Signal<{
|
|
1249
|
+
readonly boxSize: "var(--gog-control-checkbox-box-size-xsm, 12px)";
|
|
1250
|
+
readonly labelSize: "var(--gog-control-checkbox-label-size-xsm, 0.6875rem)";
|
|
1251
|
+
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-xsm, 10px)";
|
|
1252
|
+
} | {
|
|
1253
|
+
readonly boxSize: "var(--gog-control-checkbox-box-size-sm, 18px)";
|
|
1254
|
+
readonly labelSize: "var(--gog-control-checkbox-label-size-sm, 0.8125rem)";
|
|
1255
|
+
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-sm, 12px)";
|
|
1256
|
+
} | {
|
|
1257
|
+
readonly boxSize: "var(--gog-control-checkbox-box-size-md, 24px)";
|
|
1258
|
+
readonly labelSize: "var(--gog-control-checkbox-label-size-md, 0.9375rem)";
|
|
1259
|
+
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-md, 14px)";
|
|
1260
|
+
} | {
|
|
1261
|
+
readonly boxSize: "var(--gog-control-checkbox-box-size-lg, 32px)";
|
|
1262
|
+
readonly labelSize: "var(--gog-control-checkbox-label-size-lg, 1.0625rem)";
|
|
1263
|
+
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-lg, 18px)";
|
|
1264
|
+
} | {
|
|
1265
|
+
readonly boxSize: "var(--gog-control-checkbox-box-size-slg, 40px)";
|
|
1266
|
+
readonly labelSize: "var(--gog-control-checkbox-label-size-slg, 1.1875rem)";
|
|
1267
|
+
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-slg, 22px)";
|
|
1268
|
+
}>;
|
|
1269
|
+
protected readonly boxSize: _angular_core.Signal<"var(--gog-control-checkbox-box-size-xsm, 12px)" | "var(--gog-control-checkbox-box-size-sm, 18px)" | "var(--gog-control-checkbox-box-size-md, 24px)" | "var(--gog-control-checkbox-box-size-lg, 32px)" | "var(--gog-control-checkbox-box-size-slg, 40px)">;
|
|
1270
|
+
protected readonly checkboxPadding = "var(--gog-control-checkbox-padding, 6px)";
|
|
1271
|
+
protected readonly labelSize: _angular_core.Signal<"var(--gog-control-checkbox-label-size-xsm, 0.6875rem)" | "var(--gog-control-checkbox-label-size-sm, 0.8125rem)" | "var(--gog-control-checkbox-label-size-md, 0.9375rem)" | "var(--gog-control-checkbox-label-size-lg, 1.0625rem)" | "var(--gog-control-checkbox-label-size-slg, 1.1875rem)">;
|
|
1272
|
+
protected readonly iconSize: _angular_core.Signal<"var(--gog-control-checkbox-icon-size-xsm, 10px)" | "var(--gog-control-checkbox-icon-size-sm, 12px)" | "var(--gog-control-checkbox-icon-size-md, 14px)" | "var(--gog-control-checkbox-icon-size-lg, 18px)" | "var(--gog-control-checkbox-icon-size-slg, 22px)">;
|
|
1273
|
+
private readonly ngControl;
|
|
1274
|
+
private readonly cvaDisabled;
|
|
1275
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1276
|
+
constructor();
|
|
1277
|
+
writeValue(val: boolean): void;
|
|
1278
|
+
registerOnChange(fn: (val: boolean) => void): void;
|
|
1279
|
+
registerOnTouched(fn: () => void): void;
|
|
1280
|
+
setDisabledState(isDisabled: boolean): void;
|
|
1281
|
+
onInputChange(event: Event): void;
|
|
1282
|
+
onBlur(): void;
|
|
1283
|
+
private onCheckedChange;
|
|
1284
|
+
private onTouched;
|
|
1285
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
|
|
1286
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "gog-checkbox", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "checkIconTemplate": { "alias": "checkIconTemplate"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, ["checkIconSlot"], never, true, never>;
|
|
1287
|
+
}
|
|
1288
|
+
|
|
1289
|
+
/**
|
|
1290
|
+
* Every date calculation `gog-datepicker` and `gog-calendar` do, as pure functions.
|
|
1291
|
+
*
|
|
1292
|
+
* Kept out of the components so the arithmetic is testable without a fixture, and so a range
|
|
1293
|
+
* calculation is written once rather than once per selection mode.
|
|
1294
|
+
*
|
|
1295
|
+
* **Everything here works in local time.** Nothing round-trips through `toISOString()` or
|
|
1296
|
+
* compares `Date` objects directly: an ISO round trip converts to UTC, which moves the date
|
|
1297
|
+
* across midnight for anyone east or west of Greenwich, and two `Date`s for "the same day"
|
|
1298
|
+
* are almost never equal because they carry different times. Comparisons go through
|
|
1299
|
+
* `startOfDay` and `isSameDay` instead. This is the single most common defect in a datepicker.
|
|
1300
|
+
*/
|
|
1301
|
+
/** A start/end pair. `end` is null while a range is half-picked. */
|
|
1302
|
+
interface GogDateRange {
|
|
1303
|
+
start: Date | null;
|
|
1304
|
+
end: Date | null;
|
|
1305
|
+
}
|
|
1306
|
+
/** Midnight local time on the same calendar day. */
|
|
1307
|
+
declare function startOfDay(date: Date): Date;
|
|
1308
|
+
/** Whether two dates fall on the same calendar day, ignoring the time of day. */
|
|
1309
|
+
declare function isSameDay(a: Date | null, b: Date | null): boolean;
|
|
1310
|
+
/** Whether two dates fall in the same calendar month. */
|
|
1311
|
+
declare function isSameMonth(a: Date | null, b: Date | null): boolean;
|
|
1312
|
+
declare function addDays(date: Date, days: number): Date;
|
|
1313
|
+
/** Days in a given month. `month` is 0-based, as `Date` uses it. */
|
|
1314
|
+
declare function daysInMonth(year: number, month: number): number;
|
|
1315
|
+
/**
|
|
1316
|
+
* Adds whole months, **clamping the day** to the target month's length: 31 January plus one
|
|
1317
|
+
* month is 28 February, not 3 March. `Date.setMonth` does the latter, which is why this is
|
|
1318
|
+
* not a one-liner.
|
|
1319
|
+
*/
|
|
1320
|
+
declare function addMonths(date: Date, months: number): Date;
|
|
1321
|
+
declare function addYears(date: Date, years: number): Date;
|
|
1322
|
+
/** Day-granularity comparison: `a` is strictly before `b`'s day. */
|
|
1323
|
+
declare function isBeforeDay(a: Date, b: Date): boolean;
|
|
1324
|
+
/** Day-granularity comparison: `a` is strictly after `b`'s day. */
|
|
1325
|
+
declare function isAfterDay(a: Date, b: Date): boolean;
|
|
1326
|
+
/** Whether `date`'s day falls within `[min, max]`, either bound optional. */
|
|
1327
|
+
declare function isWithinBounds(date: Date, min: Date | null, max: Date | null): boolean;
|
|
1328
|
+
/** Whether `date`'s day falls inside a range, inclusive of both ends. */
|
|
1329
|
+
declare function isInRange(date: Date, start: Date | null, end: Date | null): boolean;
|
|
1330
|
+
/** Pulls `date` inside `[min, max]`, keeping its time of day. */
|
|
1331
|
+
declare function clampDate(date: Date, min: Date | null, max: Date | null): Date;
|
|
1332
|
+
/** A new date on `day`'s calendar day carrying `time`'s clock. */
|
|
1333
|
+
declare function copyTimeOnto(day: Date, time: Date): Date;
|
|
1334
|
+
/** A new date on the same day with the clock replaced. */
|
|
1335
|
+
declare function withTime(date: Date, hours: number, minutes: number, seconds?: number): Date;
|
|
1336
|
+
/**
|
|
1337
|
+
* The six-week grid a month is drawn on, always 6×7 so the calendar's height never changes as
|
|
1338
|
+
* you page through months — a grid that grows and shrinks pushes the rest of the page around
|
|
1339
|
+
* and moves the button you were about to click.
|
|
1340
|
+
*
|
|
1341
|
+
* `firstDayOfWeek` is 0 (Sunday) to 6 (Saturday). Leading and trailing cells come from the
|
|
1342
|
+
* neighbouring months, as every calendar does.
|
|
1343
|
+
*/
|
|
1344
|
+
declare function buildMonthGrid(year: number, month: number, firstDayOfWeek: number): Date[][];
|
|
1345
|
+
/** Weekday names in `locale`, rotated so `firstDayOfWeek` comes first. */
|
|
1346
|
+
declare function weekdayNames(locale: string, firstDayOfWeek: number, style?: 'short' | 'narrow' | 'long'): string[];
|
|
1347
|
+
/** Month names in `locale`. */
|
|
1348
|
+
declare function monthNames(locale: string, style?: 'long' | 'short'): string[];
|
|
1349
|
+
/**
|
|
1350
|
+
* The first day of the week for a locale, from `Intl.Locale.prototype.getWeekInfo` where the
|
|
1351
|
+
* engine has it, falling back to Monday.
|
|
1352
|
+
*
|
|
1353
|
+
* `getWeekInfo` reports 1–7 with 1 = Monday and 7 = Sunday; `Date.getDay()` uses 0 = Sunday.
|
|
1354
|
+
* Converting between the two is exactly the kind of off-by-one that silently shifts a whole
|
|
1355
|
+
* calendar by a day, which is why it happens here once.
|
|
1356
|
+
*/
|
|
1357
|
+
declare function localeFirstDayOfWeek(locale: string): number;
|
|
1358
|
+
/**
|
|
1359
|
+
* Formats a date against a token pattern.
|
|
1360
|
+
*
|
|
1361
|
+
* Supported tokens: `yyyy`, `MM`, `dd`, `HH` (24h), `hh` (12h), `mm`, `ss`, `a` (AM/PM).
|
|
1362
|
+
* Anything else is copied through literally.
|
|
1363
|
+
*
|
|
1364
|
+
* Deliberately **not** `Intl.DateTimeFormat`: this pattern is also what `parseDate` reads, and
|
|
1365
|
+
* a formatter whose output cannot be parsed back is how a typed date silently becomes a
|
|
1366
|
+
* different one. `Intl` is still used for month and weekday *names*, which are never parsed.
|
|
1367
|
+
*/
|
|
1368
|
+
declare function formatDate(date: Date, pattern: string): string;
|
|
1369
|
+
/**
|
|
1370
|
+
* Reads a date back out of text written in `pattern`. Returns `null` when the text doesn't
|
|
1371
|
+
* match, or matches but isn't a real date (`31.02.2026`).
|
|
1372
|
+
*
|
|
1373
|
+
* The out-of-range check matters: `new Date(2026, 1, 31)` happily rolls over to 3 March, so a
|
|
1374
|
+
* typo would be accepted as a different date rather than rejected.
|
|
1375
|
+
*/
|
|
1376
|
+
declare function parseDate(text: string, pattern: string): Date | null;
|
|
1377
|
+
|
|
1378
|
+
/** What `gog-calendar` and `gog-datepicker` carry, depending on `selectionMode`. */
|
|
1379
|
+
type GogDatepickerValue = Date | GogDateRange | null;
|
|
1380
|
+
/** One rendered day cell. Precomputed so the template stays free of logic. */
|
|
1381
|
+
interface GogCalendarDay {
|
|
1382
|
+
date: Date;
|
|
1383
|
+
label: string;
|
|
1384
|
+
outside: boolean;
|
|
1385
|
+
today: boolean;
|
|
1386
|
+
disabled: boolean;
|
|
1387
|
+
selected: boolean;
|
|
1388
|
+
rangeStart: boolean;
|
|
1389
|
+
rangeEnd: boolean;
|
|
1390
|
+
inRange: boolean;
|
|
1391
|
+
}
|
|
1392
|
+
/**
|
|
1393
|
+
* The month grid behind `gog-datepicker`, usable on its own for an always-visible calendar.
|
|
1394
|
+
*
|
|
1395
|
+
* ```html
|
|
1396
|
+
* <gog-calendar [(value)]="date" [min]="today" />
|
|
1397
|
+
* <gog-calendar selectionMode="range" [(value)]="range" [numberOfMonths]="2" />
|
|
1398
|
+
* ```
|
|
1399
|
+
*
|
|
1400
|
+
* Split out from the field deliberately: `gog-datepicker` is three widgets (a date, a range
|
|
1401
|
+
* and a time) behind one selector, and keeping the grid separate is what stops either half
|
|
1402
|
+
* from becoming unreadable. It is also exactly what `inline` mode renders.
|
|
1403
|
+
*/
|
|
1404
|
+
declare class CalendarComponent {
|
|
1405
|
+
/** Two-way bindable selection: a `Date` in `'single'` mode, a `GogDateRange` in `'range'`. */
|
|
1406
|
+
readonly value: _angular_core.ModelSignal<GogDatepickerValue>;
|
|
1407
|
+
readonly selectionMode: _angular_core.InputSignal<GogDateSelectionMode>;
|
|
1408
|
+
readonly min: _angular_core.InputSignal<Date | null>;
|
|
1409
|
+
readonly max: _angular_core.InputSignal<Date | null>;
|
|
1410
|
+
/**
|
|
1411
|
+
* Extra exclusions, as a predicate rather than a list: an array cannot express "weekends"
|
|
1412
|
+
* or "public holidays" without the consumer materialising every date in range first.
|
|
1413
|
+
*/
|
|
1414
|
+
readonly disabledDates: _angular_core.InputSignal<((date: Date) => boolean) | null>;
|
|
1415
|
+
/** BCP-47 tag driving the month and weekday names. */
|
|
1416
|
+
readonly locale: _angular_core.InputSignal<string>;
|
|
1417
|
+
/** 0 = Sunday … 6 = Saturday. Unset, it comes from the locale. */
|
|
1418
|
+
readonly firstDayOfWeek: _angular_core.InputSignal<number | null>;
|
|
1419
|
+
/** Which month to open on when there is no selection yet. */
|
|
1420
|
+
readonly defaultMonth: _angular_core.InputSignal<Date | null>;
|
|
1421
|
+
/** How many months to show side by side. Two is what makes a range picker usable. */
|
|
1422
|
+
readonly numberOfMonths: _angular_core.InputSignal<number>;
|
|
1423
|
+
readonly showTime: _angular_core.InputSignal<boolean>;
|
|
1424
|
+
readonly hourFormat: _angular_core.InputSignal<GogHourFormat>;
|
|
1425
|
+
readonly minuteStep: _angular_core.InputSignal<number>;
|
|
1426
|
+
readonly showSeconds: _angular_core.InputSignal<boolean>;
|
|
1427
|
+
/**
|
|
1428
|
+
* The "Today" button, which **selects** today's date — the view follows, because the
|
|
1429
|
+
* selection is what the calendar opens on.
|
|
1430
|
+
*
|
|
1431
|
+
* Kept separate from `showThisMonthButton` on purpose: one button that both selected and
|
|
1432
|
+
* navigated read as "jump to today" to anyone who pressed it after paging away, and there is
|
|
1433
|
+
* no wording that makes a single control unambiguous about which of the two it does.
|
|
1434
|
+
*/
|
|
1435
|
+
readonly showTodayButton: _angular_core.InputSignal<boolean>;
|
|
1436
|
+
/**
|
|
1437
|
+
* The "This month" button, which only moves the *view* back to the current month and leaves
|
|
1438
|
+
* the selection alone. Off by default — it is for browsing far from today without committing
|
|
1439
|
+
* to anything, which is the rarer of the two needs.
|
|
1440
|
+
*/
|
|
1441
|
+
readonly showThisMonthButton: _angular_core.InputSignal<boolean>;
|
|
1442
|
+
readonly size: _angular_core.InputSignal<GogSize>;
|
|
1443
|
+
readonly todayLabel: _angular_core.InputSignal<string>;
|
|
1444
|
+
readonly thisMonthLabel: _angular_core.InputSignal<string>;
|
|
1445
|
+
readonly previousMonthLabel: _angular_core.InputSignal<string>;
|
|
1446
|
+
readonly nextMonthLabel: _angular_core.InputSignal<string>;
|
|
1447
|
+
readonly previousYearLabel: _angular_core.InputSignal<string>;
|
|
1448
|
+
readonly nextYearLabel: _angular_core.InputSignal<string>;
|
|
1449
|
+
/** Emitted when a selection is *complete* — a day in single mode, both ends of a range. */
|
|
1450
|
+
readonly gogDateSelect: _angular_core.OutputEmitterRef<GogDatepickerValue>;
|
|
1451
|
+
private readonly elRef;
|
|
1452
|
+
/** First of the leftmost visible month. */
|
|
1453
|
+
private readonly viewMonth;
|
|
1454
|
+
/** The cell the keyboard is on, and the only one carrying `tabindex="0"`. */
|
|
1455
|
+
protected readonly focusedDate: _angular_core.WritableSignal<Date>;
|
|
1456
|
+
/** Drives the range preview while the second end is still being chosen. */
|
|
1457
|
+
protected readonly hoverDate: _angular_core.WritableSignal<Date | null>;
|
|
1458
|
+
/** Whether a focus move should also pull the DOM focus over — only after a keypress. */
|
|
1459
|
+
private pendingFocus;
|
|
1460
|
+
protected readonly resolvedFirstDayOfWeek: _angular_core.Signal<number>;
|
|
1461
|
+
protected readonly weekdays: _angular_core.Signal<string[]>;
|
|
1462
|
+
private readonly months;
|
|
1463
|
+
private readonly range;
|
|
1464
|
+
private readonly singleDate;
|
|
1465
|
+
/** Start/end as currently *displayed*, including the end the pointer is hovering over. */
|
|
1466
|
+
private readonly previewRange;
|
|
1467
|
+
/** One entry per visible month; each is a 6×7 grid. */
|
|
1468
|
+
protected readonly monthViews: _angular_core.Signal<{
|
|
1469
|
+
label: string;
|
|
1470
|
+
weeks: GogCalendarDay[][];
|
|
1471
|
+
}[]>;
|
|
1472
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1473
|
+
/**
|
|
1474
|
+
* Whether today can actually be picked — `min`, `max` or `disabledDates` may rule it out, and
|
|
1475
|
+
* a "Today" button that silently does nothing is worse than one that is visibly unavailable.
|
|
1476
|
+
* The signal reads inside `isDayDisabled` are what make this follow those inputs.
|
|
1477
|
+
*/
|
|
1478
|
+
protected readonly isTodaySelectable: _angular_core.Signal<boolean>;
|
|
1479
|
+
protected readonly timeSource: _angular_core.Signal<Date | null>;
|
|
1480
|
+
protected readonly hours: _angular_core.Signal<number>;
|
|
1481
|
+
protected readonly minutes: _angular_core.Signal<number>;
|
|
1482
|
+
protected readonly seconds: _angular_core.Signal<number>;
|
|
1483
|
+
protected readonly isPm: _angular_core.Signal<boolean>;
|
|
1484
|
+
protected readonly maxHour: _angular_core.Signal<12 | 23>;
|
|
1485
|
+
protected readonly minHour: _angular_core.Signal<0 | 1>;
|
|
1486
|
+
constructor();
|
|
1487
|
+
/** Steps the view by whole months or years. */
|
|
1488
|
+
protected shiftView(months: number): void;
|
|
1489
|
+
protected shiftViewYears(years: number): void;
|
|
1490
|
+
protected onDayClick(day: GogCalendarDay): void;
|
|
1491
|
+
protected onDayHover(day: GogCalendarDay): void;
|
|
1492
|
+
protected onGridLeave(): void;
|
|
1493
|
+
/**
|
|
1494
|
+
* Selects today. The view needs no separate nudge: the selection is the anchor the calendar
|
|
1495
|
+
* opens on, so moving it there moves the month too.
|
|
1496
|
+
*/
|
|
1497
|
+
protected selectToday(): void;
|
|
1498
|
+
/** Moves the view back to the current month, leaving the selection untouched. */
|
|
1499
|
+
protected goToThisMonth(): void;
|
|
1500
|
+
/**
|
|
1501
|
+
* The ARIA grid pattern's keyboard contract: arrows by day, PageUp/PageDown by month,
|
|
1502
|
+
* Shift + those by year, Home/End to the ends of the week. Movement is clamped into
|
|
1503
|
+
* `[min, max]` so the caret cannot wander into a region nothing can be picked from.
|
|
1504
|
+
*/
|
|
1505
|
+
protected onGridKeydown(event: KeyboardEvent): void;
|
|
1506
|
+
protected onHourInput(event: Event): void;
|
|
1507
|
+
protected onMinuteInput(event: Event): void;
|
|
1508
|
+
protected onSecondInput(event: Event): void;
|
|
1509
|
+
protected toggleMeridiem(): void;
|
|
1510
|
+
private selectionAnchor;
|
|
1511
|
+
private isDayDisabled;
|
|
1512
|
+
private buildWeeks;
|
|
1513
|
+
private select;
|
|
1514
|
+
private commit;
|
|
1515
|
+
private applyTime;
|
|
1516
|
+
/**
|
|
1517
|
+
* Moves the DOM focus onto the newly focused cell, but only after a key or button press —
|
|
1518
|
+
* never in response to the selection changing, which would steal focus from whatever the
|
|
1519
|
+
* consumer is doing elsewhere on the page.
|
|
1520
|
+
*/
|
|
1521
|
+
private applyPendingFocus;
|
|
1522
|
+
protected isFocusedDay(date: Date): boolean;
|
|
1523
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<CalendarComponent, never>;
|
|
1524
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<CalendarComponent, "gog-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultMonth": { "alias": "defaultMonth"; "required": false; "isSignal": true; }; "numberOfMonths": { "alias": "numberOfMonths"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "showTodayButton": { "alias": "showTodayButton"; "required": false; "isSignal": true; }; "showThisMonthButton": { "alias": "showThisMonthButton"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "todayLabel": { "alias": "todayLabel"; "required": false; "isSignal": true; }; "thisMonthLabel": { "alias": "thisMonthLabel"; "required": false; "isSignal": true; }; "previousMonthLabel": { "alias": "previousMonthLabel"; "required": false; "isSignal": true; }; "nextMonthLabel": { "alias": "nextMonthLabel"; "required": false; "isSignal": true; }; "previousYearLabel": { "alias": "previousYearLabel"; "required": false; "isSignal": true; }; "nextYearLabel": { "alias": "nextYearLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "gogDateSelect": "gogDateSelect"; }, never, never, true, never>;
|
|
1525
|
+
}
|
|
1526
|
+
|
|
1527
|
+
/**
|
|
1528
|
+
* A date field with a calendar panel.
|
|
1529
|
+
*
|
|
1530
|
+
* ```html
|
|
1531
|
+
* <gog-datepicker [(value)]="date" label="Дата рождения" [max]="today" />
|
|
1532
|
+
* <gog-datepicker selectionMode="range" [(value)]="range" [numberOfMonths]="2" />
|
|
1533
|
+
* <gog-datepicker [showTime]="true" hourFormat="24" [(value)]="when" />
|
|
1534
|
+
* ```
|
|
1535
|
+
*
|
|
1536
|
+
* Native `Date`, no date library and no adapter abstraction: this package has zero runtime
|
|
1537
|
+
* dependencies, and pulling one in for a single component would be the largest dependency
|
|
1538
|
+
* decision it has ever made. `Intl` covers month and weekday names; the display/parse format is
|
|
1539
|
+
* a token pattern (`dd.MM.yyyy`) so what is written can always be read back — see
|
|
1540
|
+
* `date-utils.ts`, which also explains why nothing here goes near `toISOString()`.
|
|
1541
|
+
*
|
|
1542
|
+
* The calendar itself is `gog-calendar`, exported separately and usable on its own. `inline`
|
|
1543
|
+
* mode is literally that component rendered without this field.
|
|
1544
|
+
*/
|
|
1545
|
+
declare class DatepickerComponent implements ControlValueAccessor, DoCheck {
|
|
1546
|
+
private static nextUid;
|
|
1547
|
+
protected readonly uid: number;
|
|
1548
|
+
readonly inputId: _angular_core.InputSignal<string>;
|
|
1549
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
1550
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
1551
|
+
readonly placeholder: _angular_core.InputSignal<string>;
|
|
1552
|
+
readonly selectionMode: _angular_core.InputSignal<GogDateSelectionMode>;
|
|
1553
|
+
readonly min: _angular_core.InputSignal<Date | null>;
|
|
1554
|
+
readonly max: _angular_core.InputSignal<Date | null>;
|
|
1555
|
+
readonly disabledDates: _angular_core.InputSignal<((date: Date) => boolean) | null>;
|
|
1556
|
+
readonly defaultMonth: _angular_core.InputSignal<Date | null>;
|
|
1557
|
+
readonly numberOfMonths: _angular_core.InputSignal<number>;
|
|
1558
|
+
readonly showTime: _angular_core.InputSignal<boolean>;
|
|
1559
|
+
readonly hourFormat: _angular_core.InputSignal<GogHourFormat>;
|
|
1560
|
+
readonly minuteStep: _angular_core.InputSignal<number>;
|
|
1561
|
+
readonly showSeconds: _angular_core.InputSignal<boolean>;
|
|
1562
|
+
/** The "Today" button in the panel's footer, which **selects** today's date. */
|
|
1563
|
+
readonly showTodayButton: _angular_core.InputSignal<boolean>;
|
|
1564
|
+
/**
|
|
1565
|
+
* A second footer button that only moves the *view* back to the current month, leaving the
|
|
1566
|
+
* selection alone. Off by default; see `gog-calendar` for why the two are separate controls.
|
|
1567
|
+
*/
|
|
1568
|
+
readonly showThisMonthButton: _angular_core.InputSignal<boolean>;
|
|
1569
|
+
readonly todayLabel: _angular_core.InputSignal<string>;
|
|
1570
|
+
readonly thisMonthLabel: _angular_core.InputSignal<string>;
|
|
1571
|
+
/**
|
|
1572
|
+
* Display and parse pattern (`dd.MM.yyyy`, `yyyy-MM-dd`, …). Left unset it is derived from
|
|
1573
|
+
* `showTime`, so switching the time section on does not also require restating the format.
|
|
1574
|
+
*/
|
|
1575
|
+
readonly format: _angular_core.InputSignal<string | null>;
|
|
1576
|
+
/** Unset, falls back to `GOG_CONFIG.datepicker.locale`, then to `'en-US'`. */
|
|
1577
|
+
readonly locale: _angular_core.InputSignal<string | undefined>;
|
|
1578
|
+
/** Unset, falls back to `GOG_CONFIG.datepicker.firstDayOfWeek`, then to the locale's own. */
|
|
1579
|
+
readonly firstDayOfWeek: _angular_core.InputSignal<number | undefined>;
|
|
1580
|
+
/**
|
|
1581
|
+
* Whether the date can be typed as well as picked. Typed text is parsed against `format`;
|
|
1582
|
+
* text that isn't a real date leaves the value untouched and is reverted on blur, rather
|
|
1583
|
+
* than silently resetting the field.
|
|
1584
|
+
*/
|
|
1585
|
+
readonly allowTextInput: _angular_core.InputSignal<boolean>;
|
|
1586
|
+
/** Renders the calendar directly, with no field and no panel. */
|
|
1587
|
+
readonly inline: _angular_core.InputSignal<boolean>;
|
|
1588
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
1589
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
1590
|
+
readonly clearable: _angular_core.InputSignal<boolean | undefined>;
|
|
1591
|
+
readonly clearAriaLabel: _angular_core.InputSignal<string>;
|
|
1592
|
+
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
1593
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
1594
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
1595
|
+
readonly floatLabel: _angular_core.InputSignal<GogFloatLabelVariant | undefined>;
|
|
1596
|
+
readonly floatLabelShowPlaceholder: _angular_core.InputSignal<boolean | undefined>;
|
|
1597
|
+
readonly appendToBody: _angular_core.InputSignal<boolean | undefined>;
|
|
1598
|
+
readonly dropdownDirection: _angular_core.InputSignal<GogDropdownDirection | undefined>;
|
|
1599
|
+
readonly dropdownZIndex: _angular_core.InputSignal<number | null>;
|
|
1600
|
+
readonly openCalendarLabel: _angular_core.InputSignal<string>;
|
|
1601
|
+
/** Two-way bindable value: a `Date` in `'single'` mode, a `GogDateRange` in `'range'`. */
|
|
1602
|
+
readonly value: _angular_core.ModelSignal<GogDatepickerValue>;
|
|
1603
|
+
readonly isOpen: _angular_core.WritableSignal<boolean>;
|
|
1604
|
+
private readonly elRef;
|
|
1605
|
+
private readonly document;
|
|
1606
|
+
private readonly isBrowser;
|
|
1607
|
+
private readonly destroyRef;
|
|
1608
|
+
private readonly ngControl;
|
|
1609
|
+
private readonly globalConfig;
|
|
1610
|
+
private readonly overlay;
|
|
1611
|
+
protected readonly panelTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
|
|
1612
|
+
private readonly cvaDisabled;
|
|
1613
|
+
protected readonly isFocused: _angular_core.WritableSignal<boolean>;
|
|
1614
|
+
protected readonly panelPlacement: _angular_core.WritableSignal<GogDropdownPlacement | null>;
|
|
1615
|
+
protected readonly directionState: _angular_core.WritableSignal<"up" | "down">;
|
|
1616
|
+
/** What is in the `<input>`; diverges from `value` only while the user is typing. */
|
|
1617
|
+
protected readonly text: _angular_core.WritableSignal<string>;
|
|
1618
|
+
/**
|
|
1619
|
+
* Whether the user is part-way through typing a date.
|
|
1620
|
+
*
|
|
1621
|
+
* Deliberately **not** the same thing as "the field has focus": picking a date from the
|
|
1622
|
+
* calendar hands focus back to the field, and keying the guard on focus meant the text was
|
|
1623
|
+
* then refused — you would pick a date and watch the field stay empty.
|
|
1624
|
+
*/
|
|
1625
|
+
private readonly isEditing;
|
|
1626
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1627
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
1628
|
+
protected readonly resolvedErrorDisplay: _angular_core.Signal<GogErrorDisplay>;
|
|
1629
|
+
protected readonly resolvedAppendToBody: _angular_core.Signal<boolean>;
|
|
1630
|
+
protected readonly resolvedDirection: _angular_core.Signal<GogDropdownDirection>;
|
|
1631
|
+
protected readonly resolvedLocale: _angular_core.Signal<string>;
|
|
1632
|
+
protected readonly resolvedFirstDayOfWeek: _angular_core.Signal<number | null>;
|
|
1633
|
+
/** Derived from `showTime` so turning the clock on doesn't also require a new format. */
|
|
1634
|
+
protected readonly resolvedFormat: _angular_core.Signal<string>;
|
|
1635
|
+
private readonly errorState;
|
|
1636
|
+
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
1637
|
+
protected readonly visibleError: _angular_core.Signal<string>;
|
|
1638
|
+
protected readonly hasValue: _angular_core.Signal<boolean>;
|
|
1639
|
+
private readonly clearableState;
|
|
1640
|
+
protected readonly showClear: _angular_core.Signal<boolean>;
|
|
1641
|
+
private readonly floatLabelState;
|
|
1642
|
+
protected readonly resolvedFloatLabel: _angular_core.Signal<GogFloatLabelVariant>;
|
|
1643
|
+
protected readonly isFloatLabelActive: _angular_core.Signal<boolean>;
|
|
1644
|
+
protected readonly isFloatLabelFloated: _angular_core.Signal<boolean>;
|
|
1645
|
+
protected readonly effectivePlaceholder: _angular_core.Signal<string>;
|
|
1646
|
+
protected readonly triggerId: _angular_core.Signal<string>;
|
|
1647
|
+
protected readonly panelId: _angular_core.Signal<string>;
|
|
1648
|
+
protected readonly labelId: _angular_core.Signal<string>;
|
|
1649
|
+
protected readonly errorId: _angular_core.Signal<string | null>;
|
|
1650
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
1651
|
+
/** How `value` reads in the field. A half-picked range shows only its start. */
|
|
1652
|
+
protected readonly displayText: _angular_core.Signal<string>;
|
|
1653
|
+
private onChangeFn;
|
|
1654
|
+
private onTouchedFn;
|
|
1655
|
+
private repositionFrame;
|
|
1656
|
+
constructor();
|
|
1657
|
+
ngDoCheck(): void;
|
|
1658
|
+
writeValue(val: GogDatepickerValue): void;
|
|
1659
|
+
registerOnChange(fn: (val: GogDatepickerValue) => void): void;
|
|
1660
|
+
registerOnTouched(fn: () => void): void;
|
|
1661
|
+
setDisabledState(isDisabled: boolean): void;
|
|
1662
|
+
protected toggle(): void;
|
|
1663
|
+
protected open(): void;
|
|
1664
|
+
protected close(): void;
|
|
1665
|
+
/** A completed selection closes the panel; a half-picked range leaves it open. */
|
|
1666
|
+
protected onCalendarSelect(next: GogDatepickerValue): void;
|
|
1667
|
+
/** Every calendar change, including the half-picked ones, has to reach the form. */
|
|
1668
|
+
protected onCalendarValue(next: GogDatepickerValue): void;
|
|
1669
|
+
protected onTextInput(event: Event): void;
|
|
1670
|
+
protected onFocus(): void;
|
|
1671
|
+
protected onBlur(): void;
|
|
1672
|
+
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
1673
|
+
protected clearValue(event: Event): void;
|
|
1674
|
+
protected focusTrigger(): void;
|
|
1675
|
+
private commit;
|
|
1676
|
+
/**
|
|
1677
|
+
* Binds click-outside and reposition listeners only while the panel is open — bound
|
|
1678
|
+
* permanently, every datepicker on the page would run a handler on every document click and
|
|
1679
|
+
* every scroll frame whether or not it is showing anything.
|
|
1680
|
+
*/
|
|
1681
|
+
private bindWhileOpen;
|
|
1682
|
+
private closeIfClickedOutside;
|
|
1683
|
+
private scheduleReposition;
|
|
1684
|
+
private updatePlacement;
|
|
1685
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatepickerComponent, never>;
|
|
1686
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatepickerComponent, "gog-datepicker", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabledDates": { "alias": "disabledDates"; "required": false; "isSignal": true; }; "defaultMonth": { "alias": "defaultMonth"; "required": false; "isSignal": true; }; "numberOfMonths": { "alias": "numberOfMonths"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "showTodayButton": { "alias": "showTodayButton"; "required": false; "isSignal": true; }; "showThisMonthButton": { "alias": "showThisMonthButton"; "required": false; "isSignal": true; }; "todayLabel": { "alias": "todayLabel"; "required": false; "isSignal": true; }; "thisMonthLabel": { "alias": "thisMonthLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "allowTextInput": { "alias": "allowTextInput"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "floatLabelShowPlaceholder": { "alias": "floatLabelShowPlaceholder"; "required": false; "isSignal": true; }; "appendToBody": { "alias": "appendToBody"; "required": false; "isSignal": true; }; "dropdownDirection": { "alias": "dropdownDirection"; "required": false; "isSignal": true; }; "dropdownZIndex": { "alias": "dropdownZIndex"; "required": false; "isSignal": true; }; "openCalendarLabel": { "alias": "openCalendarLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
1687
|
+
}
|
|
1688
|
+
|
|
1689
|
+
/**
|
|
1690
|
+
* A rule separating two regions, optionally with a label running through it.
|
|
1691
|
+
*
|
|
1692
|
+
* ```html
|
|
1693
|
+
* <gog-divider />
|
|
1694
|
+
* <gog-divider orientation="vertical" />
|
|
1695
|
+
* <gog-divider>ИЛИ</gog-divider>
|
|
1696
|
+
* ```
|
|
1697
|
+
*
|
|
1698
|
+
* The label is projected content rather than a `label` input: it is markup, so a consumer can
|
|
1699
|
+
* put an icon or a `<gog-tag>` in it without the component growing an input per case. There is
|
|
1700
|
+
* no `hasLabel` input either — the stylesheet keys off whether anything was actually projected,
|
|
1701
|
+
* so the two forms above are the whole API.
|
|
1702
|
+
*/
|
|
1703
|
+
declare class DividerComponent {
|
|
1704
|
+
readonly orientation: _angular_core.InputSignal<GogOrientation>;
|
|
1705
|
+
readonly variant: _angular_core.InputSignal<GogDividerVariant>;
|
|
1706
|
+
/**
|
|
1707
|
+
* Indents the rule from the leading edge so it lines up with the *text* of a list whose rows
|
|
1708
|
+
* start with an icon or avatar, instead of cutting across the whole row.
|
|
1709
|
+
*/
|
|
1710
|
+
readonly inset: _angular_core.InputSignal<boolean>;
|
|
1711
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1712
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerComponent, never>;
|
|
1713
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "gog-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inset": { "alias": "inset"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
1714
|
+
}
|
|
1715
|
+
|
|
1716
|
+
/**
|
|
1717
|
+
* A horizontal progress indicator.
|
|
1718
|
+
*
|
|
1719
|
+
* ```html
|
|
1720
|
+
* <gog-progressbar [value]="42" />
|
|
1721
|
+
* <gog-progressbar mode="indeterminate" ariaLabel="Загрузка" />
|
|
1722
|
+
* <gog-progressbar mode="buffer" [value]="42" [buffer]="70" />
|
|
1723
|
+
* ```
|
|
1724
|
+
*
|
|
1725
|
+
* `value` and `buffer` are percentages and are clamped to 0–100 rather than trusted: a bar
|
|
1726
|
+
* driven straight from `loaded / total` overshoots on the last chunk often enough that
|
|
1727
|
+
* clamping here is worth more than letting the caller find out from a broken layout.
|
|
1728
|
+
*/
|
|
1729
|
+
declare class ProgressbarComponent {
|
|
1730
|
+
protected readonly MIN = 0;
|
|
1731
|
+
protected readonly MAX = 100;
|
|
1732
|
+
/** Percentage complete, 0–100. Ignored in `'indeterminate'` mode. */
|
|
1733
|
+
readonly value: _angular_core.InputSignal<number>;
|
|
1734
|
+
/** Secondary level shown behind `value` in `'buffer'` mode — preloaded but not yet played. */
|
|
1735
|
+
readonly buffer: _angular_core.InputSignal<number>;
|
|
1736
|
+
readonly mode: _angular_core.InputSignal<GogProgressbarMode>;
|
|
1737
|
+
readonly variant: _angular_core.InputSignal<GogProgressbarVariant>;
|
|
1738
|
+
readonly size: _angular_core.InputSignal<GogSize>;
|
|
1739
|
+
/** Renders the percentage next to the bar. Off by default — most bars sit under a label. */
|
|
1740
|
+
readonly showValue: _angular_core.InputSignal<boolean>;
|
|
1741
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
1742
|
+
protected readonly isIndeterminate: _angular_core.Signal<boolean>;
|
|
1743
|
+
protected readonly clampedValue: _angular_core.Signal<number>;
|
|
1744
|
+
protected readonly clampedBuffer: _angular_core.Signal<number>;
|
|
1745
|
+
protected readonly displayValue: _angular_core.Signal<string>;
|
|
1746
|
+
/** The fill is driven to 100% in indeterminate mode; the animation moves it, not the width. */
|
|
1747
|
+
protected readonly fillPercent: _angular_core.Signal<number>;
|
|
1748
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1749
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProgressbarComponent, never>;
|
|
1750
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressbarComponent, "gog-progressbar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "buffer": { "alias": "buffer"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1751
|
+
}
|
|
1752
|
+
|
|
1753
|
+
/**
|
|
1754
|
+
* An on/off switch.
|
|
1755
|
+
*
|
|
1756
|
+
* ```html
|
|
1757
|
+
* <gog-toggle label="Уведомления" [(checked)]="on" />
|
|
1758
|
+
* <gog-toggle formControlName="darkMode" onLabel="ВКЛ" offLabel="ВЫКЛ" />
|
|
1759
|
+
* ```
|
|
1760
|
+
*
|
|
1761
|
+
* Next to `gog-checkbox` rather than a variant of it, because the two answer different
|
|
1762
|
+
* questions. A checkbox is "is this one of the things you selected"; a switch is "is this
|
|
1763
|
+
* setting on", takes effect immediately, and announces as **"switch, on"** rather than
|
|
1764
|
+
* "checkbox, checked". That announcement comes from `role="switch"` on a native
|
|
1765
|
+
* `<input type="checkbox">`, so keyboard, forms and assistive tech all still come from the
|
|
1766
|
+
* platform — only the painting differs.
|
|
1767
|
+
*/
|
|
1768
|
+
declare class ToggleComponent implements ControlValueAccessor {
|
|
1769
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
1770
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
1771
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
1772
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
1773
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
1774
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
1775
|
+
/** Which side of the switch the label sits on. */
|
|
1776
|
+
readonly labelPosition: _angular_core.InputSignal<"start" | "end">;
|
|
1777
|
+
/**
|
|
1778
|
+
* Text rendered *inside* the track — the one thing a checkbox genuinely cannot do, and what
|
|
1779
|
+
* makes a switch readable at a glance in a dense settings list. Both must be short; the
|
|
1780
|
+
* track sizes to the wider of the two.
|
|
1781
|
+
*/
|
|
1782
|
+
readonly onLabel: _angular_core.InputSignal<string>;
|
|
1783
|
+
readonly offLabel: _angular_core.InputSignal<string>;
|
|
1784
|
+
/**
|
|
1785
|
+
* Two-way bindable on/off state: `[(checked)]="signal"`.
|
|
1786
|
+
* This is the same state Angular Forms drives via `writeValue`/`registerOnChange`
|
|
1787
|
+
* when the component is used with `formControlName`/`[formControl]`.
|
|
1788
|
+
* Don't wire both a form directive AND `[(checked)]` to the same instance —
|
|
1789
|
+
* pick one, otherwise you end up with two competing sources of truth.
|
|
1790
|
+
*/
|
|
1791
|
+
readonly checked: _angular_core.ModelSignal<boolean>;
|
|
1792
|
+
private readonly ngControl;
|
|
1793
|
+
private readonly cvaDisabled;
|
|
1794
|
+
private readonly globalConfig;
|
|
1795
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
1796
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
1797
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1798
|
+
protected readonly hasTrackLabels: _angular_core.Signal<boolean>;
|
|
1799
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
1800
|
+
constructor();
|
|
1801
|
+
writeValue(val: boolean): void;
|
|
1802
|
+
registerOnChange(fn: (val: boolean) => void): void;
|
|
1803
|
+
registerOnTouched(fn: () => void): void;
|
|
1804
|
+
setDisabledState(isDisabled: boolean): void;
|
|
1805
|
+
protected onInputChange(event: Event): void;
|
|
1806
|
+
protected onBlur(): void;
|
|
1807
|
+
private onCheckedChange;
|
|
1808
|
+
private onTouched;
|
|
1809
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleComponent, never>;
|
|
1810
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToggleComponent, "gog-toggle", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "onLabel": { "alias": "onLabel"; "required": false; "isSignal": true; }; "offLabel": { "alias": "offLabel"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
|
|
1811
|
+
}
|
|
1812
|
+
|
|
1813
|
+
/** A single choice in a `gog-radio-group`. */
|
|
1814
|
+
interface GogRadioOption {
|
|
1815
|
+
id: string | number;
|
|
1816
|
+
label: string;
|
|
1817
|
+
disabled?: boolean;
|
|
1818
|
+
}
|
|
1819
|
+
declare class RadioGroupComponent implements ControlValueAccessor {
|
|
1820
|
+
private static nextUid;
|
|
1821
|
+
protected readonly uid: string;
|
|
1822
|
+
readonly options: _angular_core.InputSignal<GogRadioOption[]>;
|
|
206
1823
|
readonly label: _angular_core.InputSignal<string>;
|
|
207
1824
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
208
|
-
|
|
209
|
-
readonly
|
|
1825
|
+
/** Shared `name` for the underlying native radios. Auto-generated per instance if unset. */
|
|
1826
|
+
readonly name: _angular_core.InputSignal<string>;
|
|
1827
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
1828
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
210
1829
|
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
1830
|
+
readonly orientation: _angular_core.InputSignal<GogOrientation>;
|
|
1831
|
+
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
1832
|
+
/** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
|
|
1833
|
+
/** Unset, falls back to `GOG_CONFIG.control.errorDisplay`, then to `'manual'`. */
|
|
1834
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
211
1835
|
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
readonly
|
|
1836
|
+
/** Two-way bindable selected option id: `[(value)]="signal"`. */
|
|
1837
|
+
readonly value: _angular_core.ModelSignal<string | number | null>;
|
|
1838
|
+
private readonly ngControl;
|
|
1839
|
+
private readonly cvaDisabled;
|
|
1840
|
+
private readonly globalConfig;
|
|
1841
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
1842
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
1843
|
+
private readonly resolvedErrorDisplay;
|
|
1844
|
+
private readonly errorState;
|
|
1845
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
221
1846
|
protected readonly controlSize: _angular_core.Signal<{
|
|
222
1847
|
readonly boxSize: "var(--gog-control-checkbox-box-size-xsm, 12px)";
|
|
223
1848
|
readonly labelSize: "var(--gog-control-checkbox-label-size-xsm, 0.6875rem)";
|
|
@@ -240,23 +1865,26 @@ declare class CheckboxComponent implements ControlValueAccessor {
|
|
|
240
1865
|
readonly indicatorSize: "var(--gog-control-checkbox-icon-size-slg, 22px)";
|
|
241
1866
|
}>;
|
|
242
1867
|
protected readonly boxSize: _angular_core.Signal<"var(--gog-control-checkbox-box-size-xsm, 12px)" | "var(--gog-control-checkbox-box-size-sm, 18px)" | "var(--gog-control-checkbox-box-size-md, 24px)" | "var(--gog-control-checkbox-box-size-lg, 32px)" | "var(--gog-control-checkbox-box-size-slg, 40px)">;
|
|
243
|
-
protected readonly checkboxPadding = "var(--gog-control-checkbox-padding, 6px)";
|
|
244
1868
|
protected readonly labelSize: _angular_core.Signal<"var(--gog-control-checkbox-label-size-xsm, 0.6875rem)" | "var(--gog-control-checkbox-label-size-sm, 0.8125rem)" | "var(--gog-control-checkbox-label-size-md, 0.9375rem)" | "var(--gog-control-checkbox-label-size-lg, 1.0625rem)" | "var(--gog-control-checkbox-label-size-slg, 1.1875rem)">;
|
|
245
|
-
protected readonly
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
protected readonly
|
|
1869
|
+
protected readonly radioPadding = "var(--gog-control-checkbox-padding, 6px)";
|
|
1870
|
+
protected readonly groupName: _angular_core.Signal<string>;
|
|
1871
|
+
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
1872
|
+
protected readonly visibleError: _angular_core.Signal<string>;
|
|
1873
|
+
protected readonly errorId: _angular_core.Signal<string | null>;
|
|
1874
|
+
protected readonly labelId: _angular_core.Signal<string | null>;
|
|
1875
|
+
private onChange;
|
|
1876
|
+
private onTouched;
|
|
249
1877
|
constructor();
|
|
250
|
-
writeValue(val:
|
|
251
|
-
registerOnChange(fn: (val:
|
|
1878
|
+
writeValue(val: string | number | null): void;
|
|
1879
|
+
registerOnChange(fn: (val: string | number | null) => void): void;
|
|
252
1880
|
registerOnTouched(fn: () => void): void;
|
|
253
1881
|
setDisabledState(isDisabled: boolean): void;
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<
|
|
259
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<
|
|
1882
|
+
protected isOptionDisabled(option: GogRadioOption): boolean;
|
|
1883
|
+
protected isSelected(option: GogRadioOption): boolean;
|
|
1884
|
+
protected onOptionChange(event: Event, option: GogRadioOption): void;
|
|
1885
|
+
protected onBlur(): void;
|
|
1886
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
|
|
1887
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "gog-radio-group", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
260
1888
|
}
|
|
261
1889
|
|
|
262
1890
|
interface ConfirmDialogData {
|
|
@@ -276,21 +1904,6 @@ declare class ConfirmationDialogComponent {
|
|
|
276
1904
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmationDialogComponent, "gog-confirmation-dialog", never, {}, {}, never, never, true, never>;
|
|
277
1905
|
}
|
|
278
1906
|
|
|
279
|
-
type GogIconName = 'check' | 'close' | 'chevron-up' | 'chevron-down' | 'sort' | 'sort-up' | 'sort-down' | 'success' | 'error' | 'warning' | 'info' | 'checkbox' | 'checkbox-checked' | 'eye' | 'eye-off';
|
|
280
|
-
declare const ICON_DEFS: Record<GogIconName, string>;
|
|
281
|
-
|
|
282
|
-
declare class IconComponent {
|
|
283
|
-
private readonly sanitizer;
|
|
284
|
-
readonly name: _angular_core.InputSignal<GogIconName>;
|
|
285
|
-
readonly template: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
286
|
-
readonly title: _angular_core.InputSignal<string>;
|
|
287
|
-
readonly ariaHidden: _angular_core.InputSignal<boolean>;
|
|
288
|
-
protected readonly ariaLabel: _angular_core.Signal<string | null>;
|
|
289
|
-
protected readonly iconSvg: _angular_core.Signal<_angular_platform_browser.SafeHtml>;
|
|
290
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
|
|
291
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "gog-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "template": { "alias": "template"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "ariaHidden": { "alias": "ariaHidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
292
|
-
}
|
|
293
|
-
|
|
294
1907
|
interface DialogConfig {
|
|
295
1908
|
title?: string;
|
|
296
1909
|
component: Type<unknown>;
|
|
@@ -405,6 +2018,11 @@ interface ToastConfig {
|
|
|
405
2018
|
}
|
|
406
2019
|
declare class ToastService {
|
|
407
2020
|
readonly toasts: _angular_core.WritableSignal<Toast[]>;
|
|
2021
|
+
/**
|
|
2022
|
+
* Read once at construction rather than per `show()` call: this is a root-provided singleton,
|
|
2023
|
+
* so the config it resolves against cannot change over its lifetime anyway.
|
|
2024
|
+
*/
|
|
2025
|
+
private readonly globalConfig;
|
|
408
2026
|
private generateId;
|
|
409
2027
|
show(config: ToastConfig): string;
|
|
410
2028
|
dismiss(id: string): void;
|
|
@@ -474,17 +2092,39 @@ declare class ToastContainerComponent {
|
|
|
474
2092
|
}
|
|
475
2093
|
|
|
476
2094
|
/**
|
|
477
|
-
*
|
|
478
|
-
* consumer decides when to clear it, e.g.
|
|
479
|
-
* `errorMessage="control.invalid && control.touched ? 'Required' : ''"`.
|
|
2095
|
+
* Arbitrary markup in the field's leading slot — an icon, a button, a prefix label:
|
|
480
2096
|
*
|
|
481
|
-
*
|
|
482
|
-
*
|
|
483
|
-
*
|
|
484
|
-
*
|
|
2097
|
+
* ```html
|
|
2098
|
+
* <gog-inputfield label="Amount">
|
|
2099
|
+
* <span gogInputAddonStart>€</span>
|
|
2100
|
+
* </gog-inputfield>
|
|
2101
|
+
*
|
|
2102
|
+
* <gog-inputfield label="Search">
|
|
2103
|
+
* <button gogInputAddonStart type="button" aria-label="Search" (click)="run()">
|
|
2104
|
+
* <gog-icon name="check" />
|
|
2105
|
+
* </button>
|
|
2106
|
+
* </gog-inputfield>
|
|
2107
|
+
* ```
|
|
2108
|
+
*
|
|
2109
|
+
* Unlike the deprecated `iconStartTemplate` / `iconStartFn` / `iconStartLabel` trio this
|
|
2110
|
+
* replaces, the projected element is a normal DOM element: it carries its own `aria-label`,
|
|
2111
|
+
* its own click handler, and its own disabled state, so the component needs no input per
|
|
2112
|
+
* capability. `iconStart` — a bare icon name — stays, since that really is the common case.
|
|
485
2113
|
*/
|
|
486
|
-
|
|
487
|
-
|
|
2114
|
+
declare class GogInputAddonStartDirective {
|
|
2115
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogInputAddonStartDirective, never>;
|
|
2116
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogInputAddonStartDirective, "[gogInputAddonStart]", never, {}, {}, never, never, true, never>;
|
|
2117
|
+
}
|
|
2118
|
+
/**
|
|
2119
|
+
* Arbitrary markup in the field's trailing slot — see `GogInputAddonStartDirective`.
|
|
2120
|
+
*
|
|
2121
|
+
* On `type="password"` the built-in show/hide toggle owns this slot and a projected end addon
|
|
2122
|
+
* is ignored, so the reveal control can never be accidentally replaced by a decorative one.
|
|
2123
|
+
*/
|
|
2124
|
+
declare class GogInputAddonEndDirective {
|
|
2125
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogInputAddonEndDirective, never>;
|
|
2126
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogInputAddonEndDirective, "[gogInputAddonEnd]", never, {}, {}, never, never, true, never>;
|
|
2127
|
+
}
|
|
488
2128
|
declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
|
|
489
2129
|
readonly label: _angular_core.InputSignal<string>;
|
|
490
2130
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
@@ -497,13 +2137,31 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
|
|
|
497
2137
|
readonly max: _angular_core.InputSignal<number | null>;
|
|
498
2138
|
/** Only applied when `type="number"`. */
|
|
499
2139
|
readonly step: _angular_core.InputSignal<number | null>;
|
|
2140
|
+
/**
|
|
2141
|
+
* Whether a `type="number"` field shows the library's own increment/decrement buttons in
|
|
2142
|
+
* place of the browser's native (and inconsistently-styled across platforms) spin glyphs.
|
|
2143
|
+
* The native glyphs are always hidden on a number field regardless of this — off just means
|
|
2144
|
+
* no stepper UI at all, not a fallback to the native one. Arrow-key stepping on the focused
|
|
2145
|
+
* field keeps working either way; that's native `<input type="number">` behaviour, unrelated
|
|
2146
|
+
* to which glyphs are visible. Unset, falls back to `GOG_CONFIG.inputfield.showSpinButtons`,
|
|
2147
|
+
* then to `true`.
|
|
2148
|
+
*/
|
|
2149
|
+
readonly showSpinButtons: _angular_core.InputSignal<boolean | undefined>;
|
|
2150
|
+
/** aria-label for the number field's increment button. */
|
|
2151
|
+
readonly incrementLabel: _angular_core.InputSignal<string>;
|
|
2152
|
+
/** aria-label for the number field's decrement button. */
|
|
2153
|
+
readonly decrementLabel: _angular_core.InputSignal<string>;
|
|
500
2154
|
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
501
|
-
/**
|
|
502
|
-
|
|
2155
|
+
/**
|
|
2156
|
+
* See `GogErrorDisplay`. Unset, falls back to `GOG_CONFIG.control.errorDisplay`, then to
|
|
2157
|
+
* `'manual'` — matching every other control in the library.
|
|
2158
|
+
*/
|
|
2159
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
503
2160
|
readonly name: _angular_core.InputSignal<string>;
|
|
504
2161
|
readonly inputId: _angular_core.InputSignal<string>;
|
|
505
2162
|
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
506
|
-
|
|
2163
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
2164
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
507
2165
|
/**
|
|
508
2166
|
* Full width of the container by default, matching every other field-style control.
|
|
509
2167
|
* Set to `false` to shrink the field to fit its content instead.
|
|
@@ -513,22 +2171,47 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
|
|
|
513
2171
|
readonly iconStart: _angular_core.InputSignal<"" | GogIconName>;
|
|
514
2172
|
/** Default icon name for the trailing icon. */
|
|
515
2173
|
readonly iconEnd: _angular_core.InputSignal<"" | GogIconName>;
|
|
516
|
-
/**
|
|
2174
|
+
/**
|
|
2175
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<span gogInputAddonStart>` element instead. Removed in 21.5.0.
|
|
2176
|
+
*/
|
|
517
2177
|
readonly iconStartTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
518
|
-
/**
|
|
2178
|
+
/**
|
|
2179
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<span gogInputAddonEnd>` element instead. Removed in 21.5.0.
|
|
2180
|
+
*/
|
|
519
2181
|
readonly iconEndTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
520
|
-
/**
|
|
2182
|
+
/**
|
|
2183
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<button gogInputAddonStart>` element instead. Removed in 21.5.0. A projected button carries its own
|
|
2184
|
+
* `(click)` handler, so no input is needed for it.
|
|
2185
|
+
*/
|
|
521
2186
|
readonly iconStartFn: _angular_core.InputSignal<(() => void) | null>;
|
|
522
|
-
/**
|
|
2187
|
+
/**
|
|
2188
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<button gogInputAddonEnd>` element instead. Removed in 21.5.0. A projected button carries its own
|
|
2189
|
+
* `(click)` handler, so no input is needed for it.
|
|
2190
|
+
*/
|
|
523
2191
|
readonly iconEndFn: _angular_core.InputSignal<(() => void) | null>;
|
|
524
|
-
/**
|
|
2192
|
+
/**
|
|
2193
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<button gogInputAddonStart>` element instead. Removed in 21.5.0. Put `aria-label` on that button.
|
|
2194
|
+
*/
|
|
525
2195
|
readonly iconStartLabel: _angular_core.InputSignal<string>;
|
|
526
|
-
/**
|
|
2196
|
+
/**
|
|
2197
|
+
* @deprecated since 21.3.0 (2026-08-07) — project a `<button gogInputAddonEnd>` element instead. Removed in 21.5.0. Put `aria-label` on that button.
|
|
2198
|
+
*/
|
|
527
2199
|
readonly iconEndLabel: _angular_core.InputSignal<string>;
|
|
528
2200
|
/** aria-label for the reveal-password button, shown when `type` is `'password'` */
|
|
529
2201
|
readonly showPasswordLabel: _angular_core.InputSignal<string>;
|
|
530
2202
|
/** aria-label for the hide-password button, shown once the password is revealed */
|
|
531
2203
|
readonly hidePasswordLabel: _angular_core.InputSignal<string>;
|
|
2204
|
+
/**
|
|
2205
|
+
* Whether to offer a clear button once the field has text. Unset, falls back to
|
|
2206
|
+
* `GOG_CONFIG.control.clearable`, then to `false`.
|
|
2207
|
+
*/
|
|
2208
|
+
readonly clearable: _angular_core.InputSignal<boolean | undefined>;
|
|
2209
|
+
/** Accessible name for the clear button. */
|
|
2210
|
+
readonly clearAriaLabel: _angular_core.InputSignal<string>;
|
|
2211
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.variant`, then to `'none'` (off). */
|
|
2212
|
+
readonly floatLabel: _angular_core.InputSignal<GogFloatLabelVariant | undefined>;
|
|
2213
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.showPlaceholder`, then to `false`. */
|
|
2214
|
+
readonly floatLabelShowPlaceholder: _angular_core.InputSignal<boolean | undefined>;
|
|
532
2215
|
/**
|
|
533
2216
|
* Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`.
|
|
534
2217
|
* Always a string, including for `type="number"` — that field's `formControl`/
|
|
@@ -537,16 +2220,49 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
|
|
|
537
2220
|
*/
|
|
538
2221
|
readonly value: _angular_core.ModelSignal<string>;
|
|
539
2222
|
private readonly ngControl;
|
|
2223
|
+
private readonly globalConfig;
|
|
540
2224
|
private readonly cvaDisabled;
|
|
2225
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
2226
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
2227
|
+
private readonly resolvedErrorDisplay;
|
|
541
2228
|
private readonly errorState;
|
|
542
2229
|
private readonly passwordVisible;
|
|
2230
|
+
/** Set from `(focus)`/`(blur)` on the `<input>` — see `onFocus`/`onBlur`. */
|
|
2231
|
+
protected readonly isFocused: _angular_core.WritableSignal<boolean>;
|
|
2232
|
+
/**
|
|
2233
|
+
* The single size modifier, replacing one `[class.gog-input-wrapper--<size>]` binding per size.
|
|
2234
|
+
* Empty for `'md'`: that is this component's default size and has no modifier rule of its own — every `gog-input-wrapper--*` chain bottoms out at it.
|
|
2235
|
+
*/
|
|
2236
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
2237
|
+
protected readonly resolvedShowSpinButtons: _angular_core.Signal<boolean>;
|
|
543
2238
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
544
2239
|
protected readonly isPasswordField: _angular_core.Signal<boolean>;
|
|
545
2240
|
protected readonly isNumberField: _angular_core.Signal<boolean>;
|
|
2241
|
+
protected readonly hasSpinButtons: _angular_core.Signal<boolean>;
|
|
2242
|
+
/** Current field value as a number, or `null` while empty. */
|
|
2243
|
+
private readonly numericValue;
|
|
2244
|
+
protected readonly isAtMin: _angular_core.Signal<boolean>;
|
|
2245
|
+
protected readonly isAtMax: _angular_core.Signal<boolean>;
|
|
546
2246
|
protected readonly effectiveType: _angular_core.Signal<"number" | "text" | "password" | "email" | "date">;
|
|
547
2247
|
protected readonly effectiveAutocomplete: _angular_core.Signal<string>;
|
|
548
2248
|
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
549
2249
|
protected readonly visibleError: _angular_core.Signal<string>;
|
|
2250
|
+
private readonly floatLabelState;
|
|
2251
|
+
private readonly clearableState;
|
|
2252
|
+
/** Whether to render the clear button right now — see `GogClearableState`. */
|
|
2253
|
+
protected readonly showClear: _angular_core.Signal<boolean>;
|
|
2254
|
+
protected readonly resolvedFloatLabel: _angular_core.Signal<GogFloatLabelVariant>;
|
|
2255
|
+
protected readonly isFloatLabelActive: _angular_core.Signal<boolean>;
|
|
2256
|
+
protected readonly isFloatLabelFloated: _angular_core.Signal<boolean>;
|
|
2257
|
+
protected readonly effectivePlaceholder: _angular_core.Signal<string>;
|
|
2258
|
+
/** Projected `gogInputAddonStart` element, if any. */
|
|
2259
|
+
protected readonly addonStart: _angular_core.Signal<GogInputAddonStartDirective | undefined>;
|
|
2260
|
+
/** Projected `gogInputAddonEnd` element, if any. */
|
|
2261
|
+
protected readonly addonEnd: _angular_core.Signal<GogInputAddonEndDirective | undefined>;
|
|
2262
|
+
/**
|
|
2263
|
+
* Drives the wrapper's `--icon-start` class, which widens the field's leading gutter. Counts
|
|
2264
|
+
* a projected addon as well as the legacy icon inputs, or the addon would overlap the text.
|
|
2265
|
+
*/
|
|
550
2266
|
protected readonly hasIconStart: _angular_core.Signal<boolean>;
|
|
551
2267
|
protected readonly hasIconStartAction: _angular_core.Signal<boolean>;
|
|
552
2268
|
/** For password fields the trailing icon is always the built-in show/hide toggle. */
|
|
@@ -566,277 +2282,197 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
|
|
|
566
2282
|
protected onIconStartClick(): void;
|
|
567
2283
|
protected onIconEndClick(): void;
|
|
568
2284
|
onInput(event: Event): void;
|
|
2285
|
+
/** Increments (`direction: 1`) or decrements (`direction: -1`) by `step`, clamped to min/max. */
|
|
2286
|
+
protected stepValue(direction: 1 | -1): void;
|
|
2287
|
+
/** Clears the field and notifies any attached form, then returns focus to the input. */
|
|
2288
|
+
protected clearValue(event: Event): void;
|
|
2289
|
+
onFocus(): void;
|
|
569
2290
|
onBlur(): void;
|
|
570
2291
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputfieldComponent, never>;
|
|
571
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputfieldComponent, "gog-inputfield", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "iconStart": { "alias": "iconStart"; "required": false; "isSignal": true; }; "iconEnd": { "alias": "iconEnd"; "required": false; "isSignal": true; }; "iconStartTemplate": { "alias": "iconStartTemplate"; "required": false; "isSignal": true; }; "iconEndTemplate": { "alias": "iconEndTemplate"; "required": false; "isSignal": true; }; "iconStartFn": { "alias": "iconStartFn"; "required": false; "isSignal": true; }; "iconEndFn": { "alias": "iconEndFn"; "required": false; "isSignal": true; }; "iconStartLabel": { "alias": "iconStartLabel"; "required": false; "isSignal": true; }; "iconEndLabel": { "alias": "iconEndLabel"; "required": false; "isSignal": true; }; "showPasswordLabel": { "alias": "showPasswordLabel"; "required": false; "isSignal": true; }; "hidePasswordLabel": { "alias": "hidePasswordLabel"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; },
|
|
2292
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputfieldComponent, "gog-inputfield", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "showSpinButtons": { "alias": "showSpinButtons"; "required": false; "isSignal": true; }; "incrementLabel": { "alias": "incrementLabel"; "required": false; "isSignal": true; }; "decrementLabel": { "alias": "decrementLabel"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "iconStart": { "alias": "iconStart"; "required": false; "isSignal": true; }; "iconEnd": { "alias": "iconEnd"; "required": false; "isSignal": true; }; "iconStartTemplate": { "alias": "iconStartTemplate"; "required": false; "isSignal": true; }; "iconEndTemplate": { "alias": "iconEndTemplate"; "required": false; "isSignal": true; }; "iconStartFn": { "alias": "iconStartFn"; "required": false; "isSignal": true; }; "iconEndFn": { "alias": "iconEndFn"; "required": false; "isSignal": true; }; "iconStartLabel": { "alias": "iconStartLabel"; "required": false; "isSignal": true; }; "iconEndLabel": { "alias": "iconEndLabel"; "required": false; "isSignal": true; }; "showPasswordLabel": { "alias": "showPasswordLabel"; "required": false; "isSignal": true; }; "hidePasswordLabel": { "alias": "hidePasswordLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "floatLabelShowPlaceholder": { "alias": "floatLabelShowPlaceholder"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["addonStart", "addonEnd"], ["[gogInputAddonStart]", "[gogInputAddonEnd]"], true, never>;
|
|
572
2293
|
}
|
|
573
2294
|
|
|
574
2295
|
declare class TextareaComponent implements ControlValueAccessor, DoCheck {
|
|
575
2296
|
readonly label: _angular_core.InputSignal<string>;
|
|
576
2297
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
577
2298
|
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
578
|
-
/**
|
|
579
|
-
|
|
2299
|
+
/**
|
|
2300
|
+
* See `GogErrorDisplay`. Unset, falls back to `GOG_CONFIG.control.errorDisplay`, then to
|
|
2301
|
+
* `'manual'` — matching every other control in the library.
|
|
2302
|
+
*/
|
|
2303
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
580
2304
|
readonly name: _angular_core.InputSignal<string>;
|
|
581
2305
|
readonly inputId: _angular_core.InputSignal<string>;
|
|
582
2306
|
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
583
|
-
|
|
2307
|
+
/** Unset, falls back to `GOG_CONFIG.control.size`, then to `'md'`. */
|
|
2308
|
+
readonly size: _angular_core.InputSignal<GogSize | undefined>;
|
|
584
2309
|
/** Native `rows` attribute, controlling the field's initial height. */
|
|
585
2310
|
readonly rows: _angular_core.InputSignal<number>;
|
|
586
2311
|
/**
|
|
587
|
-
*
|
|
588
|
-
*
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
readonly value: _angular_core.ModelSignal<string>;
|
|
593
|
-
private readonly ngControl;
|
|
594
|
-
private readonly cvaDisabled;
|
|
595
|
-
private readonly errorState;
|
|
596
|
-
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
597
|
-
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
598
|
-
protected readonly visibleError: _angular_core.Signal<string>;
|
|
599
|
-
private _onChange;
|
|
600
|
-
private _onTouched;
|
|
601
|
-
constructor();
|
|
602
|
-
ngDoCheck(): void;
|
|
603
|
-
writeValue(val: string): void;
|
|
604
|
-
registerOnChange(fn: (val: string) => void): void;
|
|
605
|
-
registerOnTouched(fn: () => void): void;
|
|
606
|
-
setDisabledState(isDisabled: boolean): void;
|
|
607
|
-
onInput(event: Event): void;
|
|
608
|
-
onBlur(): void;
|
|
609
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
|
|
610
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "gog-textarea", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
611
|
-
}
|
|
612
|
-
|
|
613
|
-
declare class ChipComponent {
|
|
614
|
-
readonly size: _angular_core.InputSignal<GogSize>;
|
|
615
|
-
readonly shape: _angular_core.InputSignal<GogTagShape>;
|
|
616
|
-
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
617
|
-
readonly clickable: _angular_core.InputSignal<boolean>;
|
|
618
|
-
readonly removable: _angular_core.InputSignal<boolean>;
|
|
619
|
-
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
620
|
-
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
621
|
-
readonly removeAriaLabel: _angular_core.InputSignal<string>;
|
|
622
|
-
readonly avatarUrl: _angular_core.InputSignal<string | null>;
|
|
623
|
-
readonly avatarAlt: _angular_core.InputSignal<string>;
|
|
624
|
-
readonly iconName: _angular_core.InputSignal<GogIconName | null>;
|
|
625
|
-
readonly gogClick: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
|
|
626
|
-
readonly gogRemove: _angular_core.OutputEmitterRef<void>;
|
|
627
|
-
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
628
|
-
protected readonly isInteractive: _angular_core.Signal<boolean>;
|
|
629
|
-
protected onChipClick(event: MouseEvent): void;
|
|
630
|
-
protected onKeydown(event: KeyboardEvent): void;
|
|
631
|
-
protected onRemoveClick(event: MouseEvent): void;
|
|
632
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChipComponent, never>;
|
|
633
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChipComponent, "gog-chip", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "removeAriaLabel": { "alias": "removeAriaLabel"; "required": false; "isSignal": true; }; "avatarUrl": { "alias": "avatarUrl"; "required": false; "isSignal": true; }; "avatarAlt": { "alias": "avatarAlt"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; }, { "gogClick": "gogClick"; "gogRemove": "gogRemove"; }, never, ["*"], true, never>;
|
|
634
|
-
}
|
|
635
|
-
|
|
636
|
-
declare class TagComponent {
|
|
637
|
-
readonly variant: _angular_core.InputSignal<GogTagVariant>;
|
|
638
|
-
readonly size: _angular_core.InputSignal<GogSize>;
|
|
639
|
-
readonly shape: _angular_core.InputSignal<GogTagShape>;
|
|
640
|
-
readonly iconName: _angular_core.InputSignal<GogIconName | null>;
|
|
641
|
-
readonly iconTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
642
|
-
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
643
|
-
protected readonly hasIcon: _angular_core.Signal<boolean>;
|
|
644
|
-
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
645
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
|
|
646
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "gog-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; "iconTemplate": { "alias": "iconTemplate"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
647
|
-
}
|
|
648
|
-
|
|
649
|
-
type GogDropdownDirection = 'auto' | 'up' | 'down';
|
|
650
|
-
interface GogDropdownPlacement {
|
|
651
|
-
direction: 'up' | 'down';
|
|
652
|
-
top: number;
|
|
653
|
-
left: number;
|
|
654
|
-
width: number;
|
|
655
|
-
maxHeight: number;
|
|
656
|
-
}
|
|
657
|
-
|
|
658
|
-
/** A single choice in any of the listbox-style controls (`gog-select`, `gog-multiselect`). */
|
|
659
|
-
interface GogDropdownOption {
|
|
660
|
-
id: string | number;
|
|
661
|
-
name: string;
|
|
662
|
-
disabled?: boolean;
|
|
663
|
-
}
|
|
664
|
-
/**
|
|
665
|
-
* Shared behaviour for the listbox-style controls: open/close, placement, the
|
|
666
|
-
* append-to-body overlay, click-outside, keyboard navigation and `ControlValueAccessor`
|
|
667
|
-
* plumbing. Subclasses supply only what actually differs — the value type, the panel
|
|
668
|
-
* markup, and the BEM class names used to find the trigger and the options.
|
|
669
|
-
*
|
|
670
|
-
* Exported because it appears in the public type signatures of the components that
|
|
671
|
-
* extend it; it is not meant to be used or subclassed by consumers.
|
|
672
|
-
*/
|
|
673
|
-
declare abstract class GogDropdownBase<TValue> implements ControlValueAccessor, DoCheck {
|
|
674
|
-
private static nextUid;
|
|
675
|
-
readonly label: _angular_core.InputSignal<string>;
|
|
676
|
-
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
677
|
-
readonly placeholder: _angular_core.InputSignal<string>;
|
|
678
|
-
readonly options: _angular_core.InputSignal<GogDropdownOption[]>;
|
|
679
|
-
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
680
|
-
/** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
|
|
681
|
-
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
|
|
682
|
-
readonly size: _angular_core.InputSignal<GogSize>;
|
|
683
|
-
readonly dropdownDirection: _angular_core.InputSignal<GogDropdownDirection>;
|
|
684
|
-
/**
|
|
685
|
-
* Explicit stacking order for the panel. Left unset the panel falls back to the
|
|
686
|
-
* stylesheet's `--gog-dropdown-z`, so the default lives in CSS where a consumer can
|
|
687
|
-
* retheme it, rather than being baked into the component.
|
|
688
|
-
*/
|
|
689
|
-
readonly dropdownZIndex: _angular_core.InputSignal<number | null>;
|
|
690
|
-
/**
|
|
691
|
-
* Fixed panel width as any CSS length (`'320px'`, `'40ch'`, `'100%'`, …), applied only
|
|
692
|
-
* when `appendToBody` is set. Left unset the panel matches the trigger's width, same as
|
|
693
|
-
* the inline panel already does via CSS.
|
|
694
|
-
*/
|
|
695
|
-
readonly dropdownWidth: _angular_core.InputSignal<string | null>;
|
|
696
|
-
/**
|
|
697
|
-
* Fixed panel max-height as any CSS length, applied only when `appendToBody` is set.
|
|
698
|
-
* `px`, `%` and `vh` also feed the up/down placement math (see `resolveCssLengthPx`); any
|
|
699
|
-
* other unit still renders correctly but is invisible to that heuristic, so the panel may
|
|
700
|
-
* pick the "wrong" side close to a viewport edge. Left unset the panel keeps the existing
|
|
701
|
-
* viewport-derived, auto-flipping height.
|
|
702
|
-
*/
|
|
703
|
-
readonly dropdownMaxHeight: _angular_core.InputSignal<string | null>;
|
|
704
|
-
readonly appendToBody: _angular_core.InputSignal<boolean>;
|
|
705
|
-
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
706
|
-
readonly chevronTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
707
|
-
/**
|
|
708
|
-
* Full width of the container by default, matching every other field-style control.
|
|
709
|
-
* Set to `false` to shrink the trigger to fit its selected label instead.
|
|
710
|
-
*/
|
|
711
|
-
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
712
|
-
readonly isOpen: _angular_core.WritableSignal<boolean>;
|
|
713
|
-
/** The `<ng-template>` holding the panel markup, rendered inline or into `<body>`. */
|
|
714
|
-
protected abstract readonly panelTemplate: Signal<TemplateRef<unknown> | undefined>;
|
|
715
|
-
/** Declared by the subclass so each control keeps its own value type. */
|
|
716
|
-
protected abstract readonly value: ModelSignal<TValue>;
|
|
717
|
-
/** Value applied when a form writes `null` / the control is reset. */
|
|
718
|
-
protected abstract readonly emptyValue: TValue;
|
|
719
|
-
/** BEM class of one option button, used to collect keyboard-navigable elements. */
|
|
720
|
-
protected abstract readonly optionClass: string;
|
|
721
|
-
/** BEM class of the focusable trigger. */
|
|
722
|
-
protected abstract readonly triggerClass: string;
|
|
723
|
-
/**
|
|
724
|
-
* Spacing tokens feeding the height estimate. Overridable so each control keeps the
|
|
725
|
-
* `--gog-<block>-*` names it already exposes to consumers for theming.
|
|
2312
|
+
* Which direction(s) the field's own drag handle resizes it in — matches the native CSS
|
|
2313
|
+
* `resize` value space (`'vertical'`, `'horizontal'`, `'both'`, `'none'`). Unset, falls back
|
|
2314
|
+
* to `GOG_CONFIG.textarea.resize`, then to `'vertical'`, matching a plain `<textarea>`. The
|
|
2315
|
+
* handle itself is restyled to be more visible than the browser's default glyph; `'none'`
|
|
2316
|
+
* removes it entirely.
|
|
726
2317
|
*/
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
/**
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
2318
|
+
readonly resize: _angular_core.InputSignal<GogTextareaResize | undefined>;
|
|
2319
|
+
/**
|
|
2320
|
+
* Full width of the container by default, matching every other field-style control.
|
|
2321
|
+
* Set to `false` to shrink the field to fit its content instead.
|
|
2322
|
+
*/
|
|
2323
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
2324
|
+
/**
|
|
2325
|
+
* Whether to offer a clear button once the field has text. Unset, falls back to
|
|
2326
|
+
* `GOG_CONFIG.control.clearable`, then to `false`.
|
|
2327
|
+
*/
|
|
2328
|
+
readonly clearable: _angular_core.InputSignal<boolean | undefined>;
|
|
2329
|
+
/** Accessible name for the clear button. */
|
|
2330
|
+
readonly clearAriaLabel: _angular_core.InputSignal<string>;
|
|
2331
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.variant`, then to `'none'` (off). */
|
|
2332
|
+
readonly floatLabel: _angular_core.InputSignal<GogFloatLabelVariant | undefined>;
|
|
2333
|
+
/** Unset, falls back to `GOG_CONFIG.floatLabel.showPlaceholder`, then to `false`. */
|
|
2334
|
+
readonly floatLabelShowPlaceholder: _angular_core.InputSignal<boolean | undefined>;
|
|
2335
|
+
/** Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`. */
|
|
2336
|
+
readonly value: _angular_core.ModelSignal<string>;
|
|
740
2337
|
private readonly ngControl;
|
|
741
|
-
private readonly
|
|
2338
|
+
private readonly globalConfig;
|
|
2339
|
+
private readonly destroyRef;
|
|
742
2340
|
private readonly cvaDisabled;
|
|
2341
|
+
/** Instance input → `GOG_CONFIG` → the component's own default. See `resolveConfigured`. */
|
|
2342
|
+
protected readonly resolvedSize: _angular_core.Signal<GogSize>;
|
|
2343
|
+
protected readonly resolvedResize: _angular_core.Signal<GogTextareaResize>;
|
|
2344
|
+
private readonly resolvedErrorDisplay;
|
|
743
2345
|
private readonly errorState;
|
|
744
|
-
|
|
745
|
-
protected readonly
|
|
746
|
-
|
|
2346
|
+
/** Set from `(focus)`/`(blur)` on the `<textarea>` — see `onFocus`/`onBlur`. */
|
|
2347
|
+
protected readonly isFocused: _angular_core.WritableSignal<boolean>;
|
|
2348
|
+
private readonly fieldRef;
|
|
747
2349
|
/**
|
|
748
|
-
*
|
|
2350
|
+
* Width of the textarea's own scrollbar, published so the clear button can clear it.
|
|
749
2351
|
*
|
|
750
|
-
*
|
|
751
|
-
*
|
|
752
|
-
*
|
|
753
|
-
*
|
|
2352
|
+
* It has to be measured: the width is platform- and settings-dependent (0 on overlay
|
|
2353
|
+
* scrollbars, ~15-19px on classic ones), and it only exists once the content overflows. The
|
|
2354
|
+
* pure-CSS alternative, `scrollbar-gutter: stable`, reserves the gutter even when the field
|
|
2355
|
+
* isn't scrolling, which shifts the resting layout of every textarea.
|
|
754
2356
|
*/
|
|
755
|
-
protected readonly
|
|
756
|
-
/** `dropdownWidth`, or the trigger-derived width from `panelPlacement`, as a CSS value. */
|
|
757
|
-
protected readonly resolvedPanelWidth: Signal<string | null>;
|
|
758
|
-
/** `dropdownMaxHeight`, or the viewport-derived max-height from `panelPlacement`. */
|
|
759
|
-
protected readonly resolvedPanelMaxHeight: Signal<string | null>;
|
|
760
|
-
protected readonly hasError: Signal<boolean>;
|
|
761
|
-
protected readonly visibleError: Signal<string>;
|
|
762
|
-
/** Measured once per open rather than per scroll tick — see `refreshPanelMetrics`. */
|
|
763
|
-
private optionGap;
|
|
764
|
-
private optionsPadding;
|
|
765
|
-
private maxPanelHeight;
|
|
766
|
-
private optionHeight;
|
|
767
|
-
private repositionFrame;
|
|
768
|
-
private onChangeFn;
|
|
769
|
-
private onTouchedFn;
|
|
770
|
-
constructor();
|
|
2357
|
+
protected readonly scrollbarWidth: _angular_core.WritableSignal<number>;
|
|
771
2358
|
/**
|
|
772
|
-
*
|
|
773
|
-
*
|
|
774
|
-
*
|
|
775
|
-
*
|
|
2359
|
+
* How far the field's own right/bottom edge currently sits from its container's — 0 unless
|
|
2360
|
+
* the user has dragged the resize handle to make the field narrower/shorter than its
|
|
2361
|
+
* container. The resize grip is anchored to the container (a `<textarea>` can't reliably
|
|
2362
|
+
* host `::after`), so without this it stays put at the container's original corner instead
|
|
2363
|
+
* of following the field's own as it's resized.
|
|
776
2364
|
*/
|
|
777
|
-
|
|
2365
|
+
protected readonly resizeInsetRight: _angular_core.WritableSignal<number>;
|
|
2366
|
+
protected readonly resizeInsetBottom: _angular_core.WritableSignal<number>;
|
|
2367
|
+
/**
|
|
2368
|
+
* The single size modifier, replacing one `[class.gog-input-wrapper--<size>]` binding per size.
|
|
2369
|
+
* Empty for `'md'`: that is this component's default size and has no modifier rule of its own — every `gog-input-wrapper--*` chain bottoms out at it.
|
|
2370
|
+
*/
|
|
2371
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
2372
|
+
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
2373
|
+
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
2374
|
+
protected readonly visibleError: _angular_core.Signal<string>;
|
|
2375
|
+
private readonly floatLabelState;
|
|
2376
|
+
private readonly clearableState;
|
|
2377
|
+
/** Whether to render the clear button right now — see `GogClearableState`. */
|
|
2378
|
+
protected readonly showClear: _angular_core.Signal<boolean>;
|
|
2379
|
+
protected readonly resolvedFloatLabel: _angular_core.Signal<GogFloatLabelVariant>;
|
|
2380
|
+
protected readonly isFloatLabelActive: _angular_core.Signal<boolean>;
|
|
2381
|
+
protected readonly isFloatLabelFloated: _angular_core.Signal<boolean>;
|
|
2382
|
+
protected readonly effectivePlaceholder: _angular_core.Signal<string>;
|
|
2383
|
+
private _onChange;
|
|
2384
|
+
private _onTouched;
|
|
2385
|
+
constructor();
|
|
778
2386
|
ngDoCheck(): void;
|
|
779
|
-
writeValue(val:
|
|
780
|
-
registerOnChange(fn: (val:
|
|
2387
|
+
writeValue(val: string): void;
|
|
2388
|
+
registerOnChange(fn: (val: string) => void): void;
|
|
781
2389
|
registerOnTouched(fn: () => void): void;
|
|
782
2390
|
setDisabledState(isDisabled: boolean): void;
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
protected
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
2391
|
+
onInput(event: Event): void;
|
|
2392
|
+
/** Clears the field and notifies any attached form, then returns focus to the input. */
|
|
2393
|
+
protected clearValue(event: Event): void;
|
|
2394
|
+
onFocus(): void;
|
|
2395
|
+
onBlur(): void;
|
|
2396
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
|
|
2397
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "gog-textarea", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "floatLabel": { "alias": "floatLabel"; "required": false; "isSignal": true; }; "floatLabelShowPlaceholder": { "alias": "floatLabelShowPlaceholder"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
2398
|
+
}
|
|
2399
|
+
|
|
2400
|
+
declare class ChipComponent {
|
|
2401
|
+
readonly size: _angular_core.InputSignal<GogSize>;
|
|
2402
|
+
readonly shape: _angular_core.InputSignal<GogTagShape>;
|
|
2403
|
+
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
2404
|
+
readonly clickable: _angular_core.InputSignal<boolean>;
|
|
2405
|
+
readonly removable: _angular_core.InputSignal<boolean>;
|
|
2406
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
2407
|
+
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
2408
|
+
readonly removeAriaLabel: _angular_core.InputSignal<string>;
|
|
2409
|
+
readonly avatarUrl: _angular_core.InputSignal<string | null>;
|
|
2410
|
+
readonly avatarAlt: _angular_core.InputSignal<string>;
|
|
2411
|
+
readonly iconName: _angular_core.InputSignal<GogIconName | null>;
|
|
2412
|
+
readonly gogClick: _angular_core.OutputEmitterRef<MouseEvent | KeyboardEvent>;
|
|
2413
|
+
readonly gogRemove: _angular_core.OutputEmitterRef<void>;
|
|
2414
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
2415
|
+
protected readonly isInteractive: _angular_core.Signal<boolean>;
|
|
2416
|
+
protected onChipClick(event: MouseEvent): void;
|
|
2417
|
+
protected onKeydown(event: KeyboardEvent): void;
|
|
2418
|
+
protected onRemoveClick(event: MouseEvent): void;
|
|
2419
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChipComponent, never>;
|
|
2420
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChipComponent, "gog-chip", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "removeAriaLabel": { "alias": "removeAriaLabel"; "required": false; "isSignal": true; }; "avatarUrl": { "alias": "avatarUrl"; "required": false; "isSignal": true; }; "avatarAlt": { "alias": "avatarAlt"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; }, { "gogClick": "gogClick"; "gogRemove": "gogRemove"; }, never, ["*"], true, never>;
|
|
2421
|
+
}
|
|
2422
|
+
|
|
2423
|
+
/**
|
|
2424
|
+
* Custom markup for the tag's leading icon:
|
|
2425
|
+
*
|
|
2426
|
+
* ```html
|
|
2427
|
+
* <ng-template gogTagIcon><my-icon /></ng-template>
|
|
2428
|
+
* ```
|
|
2429
|
+
*/
|
|
2430
|
+
declare class GogTagIconDirective {
|
|
2431
|
+
readonly templateRef: TemplateRef<unknown>;
|
|
2432
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogTagIconDirective, never>;
|
|
2433
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogTagIconDirective, "[gogTagIcon]", never, {}, {}, never, never, true, never>;
|
|
2434
|
+
}
|
|
2435
|
+
declare class TagComponent {
|
|
2436
|
+
readonly variant: _angular_core.InputSignal<GogTagVariant>;
|
|
2437
|
+
readonly size: _angular_core.InputSignal<GogSize>;
|
|
2438
|
+
readonly shape: _angular_core.InputSignal<GogTagShape>;
|
|
2439
|
+
readonly iconName: _angular_core.InputSignal<GogIconName | null>;
|
|
816
2440
|
/**
|
|
817
|
-
*
|
|
818
|
-
* message below it sit in normal document flow and are not part of what the panel needs
|
|
819
|
-
* to clear. This also keeps `appendToBody` placement consistent with the inline panel,
|
|
820
|
-
* which is already positioned purely relative to the trigger via CSS.
|
|
2441
|
+
* @deprecated since 21.3.0 (2026-08-07) — project an `<ng-template gogTagIcon>` into the component instead. Removed in 21.5.0.
|
|
821
2442
|
*/
|
|
822
|
-
|
|
823
|
-
/**
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
2443
|
+
readonly iconTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
2444
|
+
/** Projected `gogTagIcon` template; wins over the deprecated `iconTemplate` input. */
|
|
2445
|
+
protected readonly iconSlot: _angular_core.Signal<GogTagIconDirective | undefined>;
|
|
2446
|
+
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
2447
|
+
protected readonly hasIcon: _angular_core.Signal<boolean>;
|
|
2448
|
+
protected readonly hostClasses: _angular_core.Signal<string>;
|
|
2449
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
|
|
2450
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "gog-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "iconName": { "alias": "iconName"; "required": false; "isSignal": true; }; "iconTemplate": { "alias": "iconTemplate"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, {}, ["iconSlot"], ["*"], true, never>;
|
|
828
2451
|
}
|
|
829
2452
|
|
|
830
|
-
/**
|
|
2453
|
+
/**
|
|
2454
|
+
* @deprecated since 21.2.2 (2026-07-30) — use `GogDropdownOption` instead. Removed in 21.4.0.
|
|
2455
|
+
*/
|
|
831
2456
|
type GogSelectOption = GogDropdownOption;
|
|
832
|
-
declare class SelectComponent
|
|
2457
|
+
declare class SelectComponent<TOption = GogDropdownOption, TValue = string | number | null> extends GogDropdownBase<TValue, TOption> {
|
|
833
2458
|
readonly inputId: _angular_core.InputSignal<string>;
|
|
834
|
-
/**
|
|
835
|
-
|
|
2459
|
+
/**
|
|
2460
|
+
* Two-way bindable selected value: `[(value)]="signal"`.
|
|
2461
|
+
*
|
|
2462
|
+
* Carries whatever `optionValue` resolves to — an id by default, or the option object itself
|
|
2463
|
+
* when `optionValue` is `null`. `TValue` is inferred from the signal you bind, so a
|
|
2464
|
+
* `WritableSignal<string | null>` keeps typing exactly as before.
|
|
2465
|
+
*/
|
|
2466
|
+
readonly value: _angular_core.ModelSignal<TValue>;
|
|
836
2467
|
protected readonly panelTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
|
|
837
|
-
|
|
2468
|
+
/** A cleared select is `null`, whatever `TValue` the consumer bound. */
|
|
2469
|
+
protected readonly emptyValue: TValue;
|
|
838
2470
|
protected readonly optionClass = "gog-select__option";
|
|
839
2471
|
protected readonly triggerClass = "gog-select__control";
|
|
2472
|
+
/** Opt-in: a select had no clear affordance before 21.3.0. */
|
|
2473
|
+
protected readonly clearableByDefault = false;
|
|
2474
|
+
protected readonly sizeBlockClass = "gog-select";
|
|
2475
|
+
protected readonly panelBlockClass = "gog-select__dropdown";
|
|
840
2476
|
protected readonly optionGapToken = "--gog-select-option-gap";
|
|
841
2477
|
protected readonly panelMaxHeightToken = "--gog-select-panel-max-height";
|
|
842
2478
|
protected readonly optionHeightToken = "--gog-select-option-height";
|
|
@@ -844,40 +2480,96 @@ declare class SelectComponent extends GogDropdownBase<string | number | null> {
|
|
|
844
2480
|
protected readonly listboxId: _angular_core.Signal<string>;
|
|
845
2481
|
protected readonly labelId: _angular_core.Signal<string>;
|
|
846
2482
|
protected readonly errorId: _angular_core.Signal<string | null>;
|
|
847
|
-
protected readonly selectedOption: _angular_core.Signal<
|
|
848
|
-
protected
|
|
849
|
-
protected
|
|
850
|
-
|
|
851
|
-
|
|
2483
|
+
protected readonly selectedOption: _angular_core.Signal<NonNullable<TOption> | null>;
|
|
2484
|
+
protected readonly selectedLabel: _angular_core.Signal<string>;
|
|
2485
|
+
protected readonly hasFloatValue: _angular_core.Signal<boolean>;
|
|
2486
|
+
protected isSelected(option: TOption): boolean;
|
|
2487
|
+
protected selectOption(option: TOption, event: MouseEvent): void;
|
|
2488
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent<any, any>, never>;
|
|
2489
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent<any, any>, "gog-select", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
852
2490
|
}
|
|
853
2491
|
|
|
854
|
-
/**
|
|
2492
|
+
/**
|
|
2493
|
+
* @deprecated since 21.2.2 (2026-07-30) — use `GogDropdownOption` instead. Removed in 21.4.0.
|
|
2494
|
+
*/
|
|
855
2495
|
type GogMultiselectOption = GogDropdownOption;
|
|
856
|
-
|
|
2496
|
+
/**
|
|
2497
|
+
* Custom markup for the multiselect's clear button:
|
|
2498
|
+
*
|
|
2499
|
+
* ```html
|
|
2500
|
+
* <ng-template gogMultiselectClearIcon><my-icon /></ng-template>
|
|
2501
|
+
* ```
|
|
2502
|
+
*/
|
|
2503
|
+
declare class GogMultiselectClearIconDirective {
|
|
2504
|
+
readonly templateRef: TemplateRef<unknown>;
|
|
2505
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogMultiselectClearIconDirective, never>;
|
|
2506
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogMultiselectClearIconDirective, "[gogMultiselectClearIcon]", never, {}, {}, never, never, true, never>;
|
|
2507
|
+
}
|
|
2508
|
+
declare class MultiselectComponent<TOption = GogDropdownOption, TValue = string | number> extends GogDropdownBase<TValue[], TOption> {
|
|
857
2509
|
readonly showControls: _angular_core.InputSignal<boolean>;
|
|
858
2510
|
/** Where the "select all"/"clear" row sits relative to the option list. Sticky either way. */
|
|
859
2511
|
readonly controlsPosition: _angular_core.InputSignal<"top" | "bottom">;
|
|
2512
|
+
/**
|
|
2513
|
+
* @deprecated since 21.3.0 (2026-08-07) — project an `<ng-template gogMultiselectClearIcon>` into the component instead. Removed in 21.5.0.
|
|
2514
|
+
*/
|
|
860
2515
|
readonly clearIconTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
861
|
-
/**
|
|
862
|
-
readonly
|
|
2516
|
+
/** Projected `gogMultiselectClearIcon` template; wins over the deprecated `clearIconTemplate` input. */
|
|
2517
|
+
protected readonly clearIconSlot: _angular_core.Signal<GogMultiselectClearIconDirective | undefined>;
|
|
2518
|
+
/**
|
|
2519
|
+
* Two-way bindable selection: `[(value)]="signal"`.
|
|
2520
|
+
*
|
|
2521
|
+
* Each entry is whatever `optionValue` resolves to — an id by default, or the option objects
|
|
2522
|
+
* themselves when `optionValue` is `null`.
|
|
2523
|
+
*/
|
|
2524
|
+
readonly value: _angular_core.ModelSignal<TValue[]>;
|
|
863
2525
|
protected readonly panelTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
|
|
864
|
-
protected readonly emptyValue:
|
|
2526
|
+
protected readonly emptyValue: TValue[];
|
|
865
2527
|
protected readonly optionClass = "gog-ms__option";
|
|
866
2528
|
protected readonly triggerClass = "gog-ms";
|
|
2529
|
+
/**
|
|
2530
|
+
* On by default: this control shipped a clear button before `clearable` existed, so the
|
|
2531
|
+
* default preserves it. Set `[clearable]="false"` to drop it.
|
|
2532
|
+
*/
|
|
2533
|
+
protected readonly clearableByDefault = true;
|
|
2534
|
+
protected readonly sizeBlockClass = "gog-ms-wrapper";
|
|
2535
|
+
protected readonly panelBlockClass = "gog-ms__dropdown";
|
|
867
2536
|
protected readonly optionGapToken = "--gog-ms-option-gap";
|
|
868
2537
|
protected readonly optionsPaddingToken = "--gog-ms-options-padding";
|
|
869
2538
|
protected readonly panelMaxHeightToken = "--gog-ms-panel-max-height";
|
|
870
2539
|
protected readonly optionHeightToken = "--gog-ms-option-height";
|
|
871
2540
|
protected readonly listboxId: _angular_core.Signal<string>;
|
|
872
2541
|
protected readonly labelId: _angular_core.Signal<string>;
|
|
2542
|
+
/** Labels of the current selection, driven off the selected *options* so it works whatever
|
|
2543
|
+
* `optionValue` resolves to. */
|
|
2544
|
+
readonly selectedLabels: _angular_core.Signal<string[]>;
|
|
2545
|
+
/** Comma-joined selection — the full text, before any overflow trimming. */
|
|
873
2546
|
readonly selectedNames: _angular_core.Signal<string>;
|
|
874
|
-
|
|
875
|
-
|
|
2547
|
+
private readonly valueRef;
|
|
2548
|
+
private readonly resizeDestroyRef;
|
|
2549
|
+
/** Width available to the summary text, tracked so the split recomputes as the field resizes. */
|
|
2550
|
+
private readonly valueWidth;
|
|
2551
|
+
private readonly valueFont;
|
|
2552
|
+
/**
|
|
2553
|
+
* Splits the selection into what fits on one line and a `+N` remainder.
|
|
2554
|
+
*
|
|
2555
|
+
* Measured with `canvas.measureText` rather than by rendering candidates and reading back
|
|
2556
|
+
* layout: the greedy fit is O(n) over the labels and costs no reflow, where a DOM-based probe
|
|
2557
|
+
* would thrash layout on every keystroke-sized change.
|
|
2558
|
+
*/
|
|
2559
|
+
protected readonly summary: _angular_core.Signal<{
|
|
2560
|
+
text: string;
|
|
2561
|
+
hidden: number;
|
|
2562
|
+
}>;
|
|
2563
|
+
protected readonly hasFloatValue: _angular_core.Signal<boolean>;
|
|
2564
|
+
protected isSelected(option: TOption): boolean;
|
|
2565
|
+
protected toggleOption(option: TOption, event: MouseEvent): void;
|
|
2566
|
+
/** Acts on the *visible* options, so "select all" under an active filter means what it says. */
|
|
876
2567
|
protected selectAll(event: MouseEvent): void;
|
|
877
2568
|
protected clearAll(event: Event): void;
|
|
2569
|
+
constructor();
|
|
878
2570
|
protected extraPanelHeight(): number;
|
|
879
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiselectComponent, never>;
|
|
880
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiselectComponent, "gog-multiselect", never, { "showControls": { "alias": "showControls"; "required": false; "isSignal": true; }; "controlsPosition": { "alias": "controlsPosition"; "required": false; "isSignal": true; }; "clearIconTemplate": { "alias": "clearIconTemplate"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; },
|
|
2571
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiselectComponent<any, any>, never>;
|
|
2572
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiselectComponent<any, any>, "gog-multiselect", never, { "showControls": { "alias": "showControls"; "required": false; "isSignal": true; }; "controlsPosition": { "alias": "controlsPosition"; "required": false; "isSignal": true; }; "clearIconTemplate": { "alias": "clearIconTemplate"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["clearIconSlot"], never, true, never>;
|
|
881
2573
|
}
|
|
882
2574
|
|
|
883
2575
|
declare class SliderComponent implements ControlValueAccessor, DoCheck {
|
|
@@ -891,7 +2583,8 @@ declare class SliderComponent implements ControlValueAccessor, DoCheck {
|
|
|
891
2583
|
readonly showThumb: _angular_core.InputSignal<boolean>;
|
|
892
2584
|
readonly errorMessage: _angular_core.InputSignal<string>;
|
|
893
2585
|
/** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
|
|
894
|
-
|
|
2586
|
+
/** Unset, falls back to `GOG_CONFIG.control.errorDisplay`, then to `'manual'`. */
|
|
2587
|
+
readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay | undefined>;
|
|
895
2588
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
896
2589
|
readonly disabled: _angular_core.InputSignal<boolean>;
|
|
897
2590
|
/**
|
|
@@ -899,18 +2592,34 @@ declare class SliderComponent implements ControlValueAccessor, DoCheck {
|
|
|
899
2592
|
* `--gog-slider-auto-width` instead — a slider's track has no content of its own to
|
|
900
2593
|
* shrink-wrap to, so unlike the other field controls this needs an explicit fallback
|
|
901
2594
|
* width rather than `fit-content`.
|
|
2595
|
+
*
|
|
2596
|
+
* Ignored when `orientation` is `'vertical'`: a vertical slider's own width is its
|
|
2597
|
+
* thickness, not its length, so it always sizes to fit its content. Its length instead
|
|
2598
|
+
* comes from `--gog-slider-vertical-length` (default `160px`), same idea as
|
|
2599
|
+
* `--gog-slider-auto-width` for the horizontal auto-width case.
|
|
902
2600
|
*/
|
|
903
2601
|
readonly fullWidth: _angular_core.InputSignal<boolean>;
|
|
2602
|
+
/**
|
|
2603
|
+
* `'horizontal'` (default) or `'vertical'`. The developer picks per instance — there is
|
|
2604
|
+
* no global default for this, since it's a layout decision tied to where the slider sits,
|
|
2605
|
+
* not a house style. Backed by a native `<input type="range">` rotated via `writing-mode`,
|
|
2606
|
+
* so dragging, touch and keyboard (Up/Down as well as Left/Right) all keep working exactly
|
|
2607
|
+
* as they do horizontally.
|
|
2608
|
+
*/
|
|
2609
|
+
readonly orientation: _angular_core.InputSignal<_guildofgleks_ui.GogOrientation>;
|
|
904
2610
|
/** Two-way bindable value: `[(value)]="signal"`. */
|
|
905
2611
|
readonly value: _angular_core.ModelSignal<number>;
|
|
906
2612
|
private readonly ngControl;
|
|
907
2613
|
private readonly cvaDisabled;
|
|
2614
|
+
private readonly globalConfig;
|
|
2615
|
+
private readonly resolvedErrorDisplay;
|
|
908
2616
|
private readonly errorState;
|
|
909
2617
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
910
2618
|
protected readonly clampedValue: _angular_core.Signal<number>;
|
|
911
2619
|
protected readonly fillPercent: _angular_core.Signal<number>;
|
|
912
2620
|
protected readonly thumbPos: _angular_core.Signal<string>;
|
|
913
2621
|
protected readonly fillScale: _angular_core.Signal<number>;
|
|
2622
|
+
protected readonly isVertical: _angular_core.Signal<boolean>;
|
|
914
2623
|
protected readonly hasError: _angular_core.Signal<boolean>;
|
|
915
2624
|
protected readonly visibleError: _angular_core.Signal<string>;
|
|
916
2625
|
protected readonly errorId: _angular_core.Signal<string | null>;
|
|
@@ -925,7 +2634,7 @@ declare class SliderComponent implements ControlValueAccessor, DoCheck {
|
|
|
925
2634
|
onInput(event: Event): void;
|
|
926
2635
|
onBlur(): void;
|
|
927
2636
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
|
|
928
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "gog-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "showThumb": { "alias": "showThumb"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
2637
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "gog-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "showThumb": { "alias": "showThumb"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorDisplay": { "alias": "errorDisplay"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
929
2638
|
}
|
|
930
2639
|
|
|
931
2640
|
declare class SkeletonComponent {
|
|
@@ -1034,6 +2743,17 @@ declare class ScrollComponent {
|
|
|
1034
2743
|
* for what each value does.
|
|
1035
2744
|
*/
|
|
1036
2745
|
readonly overscrollBehavior: _angular_core.InputSignal<GogScrollOverscrollBehavior | undefined>;
|
|
2746
|
+
/**
|
|
2747
|
+
* Whether the overlay thumb/track ever renders. Native scrolling — wheel, touch, keyboard,
|
|
2748
|
+
* focus-into-view, and any programmatic `scrollTo`/`scrollIntoView` — keeps working exactly
|
|
2749
|
+
* the same either way; this only controls the visual affordance, not `overflow` or scroll
|
|
2750
|
+
* containment (see `viewportOverflowY`/`X`). Off suits a viewport whose *position* is already
|
|
2751
|
+
* driven some other way — `gog-tabs`' `scrollActiveIntoView` is the case this exists for,
|
|
2752
|
+
* where a second, independent scroll indicator next to the active-tab underline reads as two
|
|
2753
|
+
* conflicting signals for the same thing. Unset, falls back to `GOG_CONFIG.scroll.showTrack`,
|
|
2754
|
+
* then to `true`.
|
|
2755
|
+
*/
|
|
2756
|
+
readonly showTrack: _angular_core.InputSignal<boolean | undefined>;
|
|
1037
2757
|
readonly gogScroll: _angular_core.OutputEmitterRef<GogScrollMetrics>;
|
|
1038
2758
|
readonly gogReachStart: _angular_core.OutputEmitterRef<GogScrollDirection>;
|
|
1039
2759
|
readonly gogReachEnd: _angular_core.OutputEmitterRef<GogScrollDirection>;
|
|
@@ -1069,6 +2789,7 @@ declare class ScrollComponent {
|
|
|
1069
2789
|
protected readonly resolvedAutoHide: _angular_core.Signal<boolean>;
|
|
1070
2790
|
protected readonly resolvedHideDelay: _angular_core.Signal<number>;
|
|
1071
2791
|
protected readonly resolvedOverscrollBehavior: _angular_core.Signal<GogScrollOverscrollBehavior>;
|
|
2792
|
+
protected readonly resolvedShowTrack: _angular_core.Signal<boolean>;
|
|
1072
2793
|
/**
|
|
1073
2794
|
* Only applies `resolvedOverscrollBehavior` on an axis that's actually acting as a scroll
|
|
1074
2795
|
* container — on an axis that's `visible` (see viewportOverflowY/X above) there is no
|
|
@@ -1115,7 +2836,7 @@ declare class ScrollComponent {
|
|
|
1115
2836
|
private measure;
|
|
1116
2837
|
private checkReach;
|
|
1117
2838
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ScrollComponent, never>;
|
|
1118
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScrollComponent, "gog-scroll", never, { "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "autoHide": { "alias": "autoHide"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; "reachThreshold": { "alias": "reachThreshold"; "required": false; "isSignal": true; }; "focusable": { "alias": "focusable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "overscrollBehavior": { "alias": "overscrollBehavior"; "required": false; "isSignal": true; }; }, { "gogScroll": "gogScroll"; "gogReachStart": "gogReachStart"; "gogReachEnd": "gogReachEnd"; }, never, ["*"], true, never>;
|
|
2839
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ScrollComponent, "gog-scroll", never, { "axis": { "alias": "axis"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "autoHide": { "alias": "autoHide"; "required": false; "isSignal": true; }; "hideDelay": { "alias": "hideDelay"; "required": false; "isSignal": true; }; "reachThreshold": { "alias": "reachThreshold"; "required": false; "isSignal": true; }; "focusable": { "alias": "focusable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "overscrollBehavior": { "alias": "overscrollBehavior"; "required": false; "isSignal": true; }; "showTrack": { "alias": "showTrack"; "required": false; "isSignal": true; }; }, { "gogScroll": "gogScroll"; "gogReachStart": "gogReachStart"; "gogReachEnd": "gogReachEnd"; }, never, ["*"], true, never>;
|
|
1119
2840
|
}
|
|
1120
2841
|
|
|
1121
2842
|
declare class SpinnerOverlayComponent {
|
|
@@ -1129,7 +2850,53 @@ declare class SpinnerOverlayComponent {
|
|
|
1129
2850
|
|
|
1130
2851
|
/** Default comparator: locale-aware for strings via `Intl.Collator`, `<`/`>` otherwise. */
|
|
1131
2852
|
declare function defaultCompare(a: unknown, b: unknown): number;
|
|
1132
|
-
|
|
2853
|
+
/** Context handed to a `gogColumnBody` template. */
|
|
2854
|
+
interface GogColumnBodyContext<T> {
|
|
2855
|
+
/** The row object. */
|
|
2856
|
+
$implicit: T;
|
|
2857
|
+
/** Alias for `$implicit`, for templates that prefer naming it. */
|
|
2858
|
+
row: T;
|
|
2859
|
+
/** Index within the currently rendered page, not the whole data set. */
|
|
2860
|
+
index: number;
|
|
2861
|
+
/** The already-resolved cell value for this column's `field`. */
|
|
2862
|
+
value: unknown;
|
|
2863
|
+
}
|
|
2864
|
+
/** Context handed to a `gogColumnHeader` template. */
|
|
2865
|
+
interface GogColumnHeaderContext {
|
|
2866
|
+
/** The column's own `header` text, so a custom header can decorate rather than replace it. */
|
|
2867
|
+
$implicit: string;
|
|
2868
|
+
field: string;
|
|
2869
|
+
}
|
|
2870
|
+
/**
|
|
2871
|
+
* Custom cell markup for one column:
|
|
2872
|
+
*
|
|
2873
|
+
* ```html
|
|
2874
|
+
* <gog-column field="status" header="Status">
|
|
2875
|
+
* <ng-template gogColumnBody let-row let-value="value">
|
|
2876
|
+
* <gog-tag [variant]="row.ok ? 'success' : 'danger'">{{ value }}</gog-tag>
|
|
2877
|
+
* </ng-template>
|
|
2878
|
+
* </gog-column>
|
|
2879
|
+
* ```
|
|
2880
|
+
*/
|
|
2881
|
+
declare class GogColumnBodyDirective<T = unknown> {
|
|
2882
|
+
readonly templateRef: TemplateRef<GogColumnBodyContext<T>>;
|
|
2883
|
+
static ngTemplateContextGuard<T>(_dir: GogColumnBodyDirective<T>, ctx: unknown): ctx is GogColumnBodyContext<T>;
|
|
2884
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogColumnBodyDirective<any>, never>;
|
|
2885
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogColumnBodyDirective<any>, "[gogColumnBody]", never, {}, {}, never, never, true, never>;
|
|
2886
|
+
}
|
|
2887
|
+
/** Custom header markup for one column — see `GogColumnBodyDirective` for the shape. */
|
|
2888
|
+
declare class GogColumnHeaderDirective {
|
|
2889
|
+
readonly templateRef: TemplateRef<GogColumnHeaderContext>;
|
|
2890
|
+
static ngTemplateContextGuard(_dir: GogColumnHeaderDirective, ctx: unknown): ctx is GogColumnHeaderContext;
|
|
2891
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogColumnHeaderDirective, never>;
|
|
2892
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogColumnHeaderDirective, "[gogColumnHeader]", never, {}, {}, never, never, true, never>;
|
|
2893
|
+
}
|
|
2894
|
+
/**
|
|
2895
|
+
* One column of `gog-table`. Cell and header markup are projected as `gogColumnBody` /
|
|
2896
|
+
* `gogColumnHeader` templates inside the column itself, so the column owning them is
|
|
2897
|
+
* structural rather than looked up by a matching string.
|
|
2898
|
+
*/
|
|
2899
|
+
declare class GogColumn {
|
|
1133
2900
|
/** Field name, or a dot-path into a nested property (e.g. `"address.city"`). */
|
|
1134
2901
|
readonly field: _angular_core.InputSignal<string>;
|
|
1135
2902
|
readonly header: _angular_core.InputSignal<string>;
|
|
@@ -1142,9 +2909,20 @@ declare class Column {
|
|
|
1142
2909
|
readonly maxWidth: _angular_core.InputSignal<string>;
|
|
1143
2910
|
/** Custom sort comparator for this column. Defaults to `defaultCompare`. */
|
|
1144
2911
|
readonly comparator: _angular_core.InputSignal<((a: unknown, b: unknown) => number) | null>;
|
|
1145
|
-
|
|
1146
|
-
|
|
2912
|
+
readonly bodyTemplate: _angular_core.Signal<GogColumnBodyDirective<any> | undefined>;
|
|
2913
|
+
readonly headerTemplate: _angular_core.Signal<GogColumnHeaderDirective | undefined>;
|
|
2914
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogColumn, never>;
|
|
2915
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogColumn, "gog-column, column", never, { "field": { "alias": "field"; "required": true; "isSignal": true; }; "header": { "alias": "header"; "required": false; "isSignal": true; }; "sortable": { "alias": "sortable"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "minWidth": { "alias": "minWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "comparator": { "alias": "comparator"; "required": false; "isSignal": true; }; }, {}, ["bodyTemplate", "headerTemplate"], never, true, never>;
|
|
1147
2916
|
}
|
|
2917
|
+
/**
|
|
2918
|
+
* @deprecated since 21.3.0 (2026-08-07) — use `GogColumn` instead. Removed in 21.5.0.
|
|
2919
|
+
* The same class under its old, unprefixed name.
|
|
2920
|
+
*/
|
|
2921
|
+
declare const Column: typeof GogColumn;
|
|
2922
|
+
/**
|
|
2923
|
+
* @deprecated since 21.3.0 (2026-08-07) — use `GogColumn` instead. Removed in 21.5.0.
|
|
2924
|
+
*/
|
|
2925
|
+
type Column = GogColumn;
|
|
1148
2926
|
|
|
1149
2927
|
interface GogTableBodyContext<T> {
|
|
1150
2928
|
$implicit: T;
|
|
@@ -1154,11 +2932,29 @@ interface GogTableHeaderContext {
|
|
|
1154
2932
|
$implicit: never;
|
|
1155
2933
|
}
|
|
1156
2934
|
/**
|
|
1157
|
-
* Marks a
|
|
2935
|
+
* Marks a `<ng-template>` inside `<gog-table>` with a field name and optional type:
|
|
1158
2936
|
*
|
|
1159
|
-
*
|
|
1160
|
-
*
|
|
1161
|
-
*
|
|
2937
|
+
* ```html
|
|
2938
|
+
* <ng-template template="status" type="body" let-row>…</ng-template>
|
|
2939
|
+
* ```
|
|
2940
|
+
*
|
|
2941
|
+
* @deprecated since 21.3.0 (2026-08-07) — declare the template inside its own column with
|
|
2942
|
+
* `gogColumnBody` / `gogColumnHeader` instead. Removed in 21.5.0.
|
|
2943
|
+
*
|
|
2944
|
+
* The field name here is a string the compiler cannot check, so a typo silently renders the
|
|
2945
|
+
* default cell rather than failing; the column-scoped directives bind structurally and carry a
|
|
2946
|
+
* typed context. Migration:
|
|
2947
|
+
*
|
|
2948
|
+
* ```html
|
|
2949
|
+
* <!-- before -->
|
|
2950
|
+
* <gog-column field="status" />
|
|
2951
|
+
* <ng-template template="status" type="body" let-row>…</ng-template>
|
|
2952
|
+
*
|
|
2953
|
+
* <!-- after -->
|
|
2954
|
+
* <gog-column field="status">
|
|
2955
|
+
* <ng-template gogColumnBody let-row>…</ng-template>
|
|
2956
|
+
* </gog-column>
|
|
2957
|
+
* ```
|
|
1162
2958
|
*/
|
|
1163
2959
|
declare class TemplateDirective {
|
|
1164
2960
|
readonly template: _angular_core.InputSignal<string>;
|
|
@@ -1175,6 +2971,11 @@ interface SortState {
|
|
|
1175
2971
|
direction: SortDirection;
|
|
1176
2972
|
}
|
|
1177
2973
|
declare class TableComponent<T extends object> {
|
|
2974
|
+
/**
|
|
2975
|
+
* The single size modifier, replacing one `[class.gog-table--<size>]` binding per size.
|
|
2976
|
+
* Empty for `'lg'`: that is this component's default size and has no modifier rule of its own — every `gog-table--*` chain bottoms out at it.
|
|
2977
|
+
*/
|
|
2978
|
+
protected readonly sizeClass: _angular_core.Signal<string>;
|
|
1178
2979
|
readonly value: _angular_core.InputSignal<T[]>;
|
|
1179
2980
|
/**
|
|
1180
2981
|
* Full width of the container by default. Set to `false` to shrink the table to fit
|
|
@@ -1187,7 +2988,7 @@ declare class TableComponent<T extends object> {
|
|
|
1187
2988
|
readonly showTotal: _angular_core.InputSignal<boolean>;
|
|
1188
2989
|
readonly emptyPlaceholder: _angular_core.InputSignal<string>;
|
|
1189
2990
|
/** Alignment of pagination controls */
|
|
1190
|
-
readonly paginatorPosition: _angular_core.InputSignal<"
|
|
2991
|
+
readonly paginatorPosition: _angular_core.InputSignal<"left" | "right" | "center">;
|
|
1191
2992
|
/** Alignment of total count label (only when showTotal=true) */
|
|
1192
2993
|
readonly totalPosition: _angular_core.InputSignal<"left" | "right" | "opposite">;
|
|
1193
2994
|
/** Show loading spinner instead of rows */
|
|
@@ -1198,7 +2999,7 @@ declare class TableComponent<T extends object> {
|
|
|
1198
2999
|
readonly stickyHeader: _angular_core.InputSignal<boolean>;
|
|
1199
3000
|
/** Row density: lg (default) / md (compact) / sm (dense) */
|
|
1200
3001
|
readonly size: _angular_core.InputSignal<GogSize>;
|
|
1201
|
-
readonly columns: _angular_core.Signal<readonly
|
|
3002
|
+
readonly columns: _angular_core.Signal<readonly GogColumn[]>;
|
|
1202
3003
|
readonly templates: _angular_core.Signal<readonly TemplateDirective[]>;
|
|
1203
3004
|
readonly sortState: _angular_core.WritableSignal<SortState>;
|
|
1204
3005
|
readonly sortedData: _angular_core.Signal<T[]>;
|
|
@@ -1214,19 +3015,27 @@ declare class TableComponent<T extends object> {
|
|
|
1214
3015
|
readonly visibleRows: _angular_core.Signal<T[]>;
|
|
1215
3016
|
readonly hasPagination: _angular_core.Signal<boolean>;
|
|
1216
3017
|
readonly emptyColspan: _angular_core.Signal<number>;
|
|
1217
|
-
|
|
1218
|
-
|
|
1219
|
-
|
|
3018
|
+
/**
|
|
3019
|
+
* A `gogColumnBody` template declared inside the column wins; the string-keyed
|
|
3020
|
+
* `<ng-template template="field" type="body">` is the deprecated fallback.
|
|
3021
|
+
*/
|
|
3022
|
+
getBodyTemplate(col: GogColumn): TemplateRef<unknown> | null;
|
|
3023
|
+
getHeaderTemplate(col: GogColumn): TemplateRef<unknown> | null;
|
|
3024
|
+
/** Context for a `gogColumnBody` template — see `GogColumnBodyContext`. */
|
|
3025
|
+
bodyContext(row: T, col: GogColumn, index: number): GogColumnBodyContext<T>;
|
|
3026
|
+
/** Context for a `gogColumnHeader` template — see `GogColumnHeaderContext`. */
|
|
3027
|
+
headerContext(col: GogColumn): GogColumnHeaderContext;
|
|
3028
|
+
toggleSort(col: GogColumn): void;
|
|
1220
3029
|
getSortDirection(field: string): SortDirection;
|
|
1221
3030
|
getAriaSort(field: string): 'ascending' | 'descending' | null;
|
|
1222
|
-
handleSortClick(col:
|
|
3031
|
+
handleSortClick(col: GogColumn): void;
|
|
1223
3032
|
getCellValue(row: T, field: string): unknown;
|
|
1224
3033
|
formatCellValue(row: T, field: string): string;
|
|
1225
3034
|
globalRowIndex(localIndex: number): number;
|
|
1226
3035
|
/** CSS grid-area for the total label: left slot or right slot */
|
|
1227
3036
|
readonly totalGridArea: _angular_core.Signal<"left" | "right">;
|
|
1228
3037
|
/** CSS grid-area for the pagination block */
|
|
1229
|
-
readonly paginatorGridArea: _angular_core.Signal<"
|
|
3038
|
+
readonly paginatorGridArea: _angular_core.Signal<"left" | "right" | "center">;
|
|
1230
3039
|
private readonly bodyTemplateMap;
|
|
1231
3040
|
private readonly headerTemplateMap;
|
|
1232
3041
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
@@ -1247,6 +3056,87 @@ declare class SpinnerComponent {
|
|
|
1247
3056
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "gog-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "overlay": { "alias": "overlay"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
1248
3057
|
}
|
|
1249
3058
|
|
|
3059
|
+
/**
|
|
3060
|
+
* Adds a hover/focus tooltip to any element — a `gog-*` component's host tag or a plain
|
|
3061
|
+
* native one — without that element needing to know anything about it:
|
|
3062
|
+
* `<button gogTooltip="Save changes">` or `<gog-chip [gogTooltip]="hint">` both just work,
|
|
3063
|
+
* since this only ever reads the host `ElementRef` and never assumes what created it.
|
|
3064
|
+
*
|
|
3065
|
+
* The bubble itself is a separate component (`GogTooltipBubbleComponent`) created on demand
|
|
3066
|
+
* and moved into `document.body` via `GogTooltipOverlay` — see that file for why a portal is
|
|
3067
|
+
* necessary here (clipping/position ancestors) and why it isn't built on `GogDropdownOverlay`.
|
|
3068
|
+
*/
|
|
3069
|
+
declare class GogTooltipDirective {
|
|
3070
|
+
/** The hint text, or a `TemplateRef` for richer content. Empty/null shows nothing. */
|
|
3071
|
+
readonly gogTooltip: _angular_core.InputSignal<string | TemplateRef<unknown> | null>;
|
|
3072
|
+
/** Unset, falls back to `GOG_CONFIG.tooltip.position`, then to `'auto'`. */
|
|
3073
|
+
readonly gogTooltipPosition: _angular_core.InputSignal<GogTooltipPosition | undefined>;
|
|
3074
|
+
/** Unset, falls back to `GOG_CONFIG.tooltip.showDelay`, then to `300` (ms). */
|
|
3075
|
+
readonly gogTooltipShowDelay: _angular_core.InputSignal<number | undefined>;
|
|
3076
|
+
/** Unset, falls back to `GOG_CONFIG.tooltip.hideDelay`, then to `100` (ms). */
|
|
3077
|
+
readonly gogTooltipHideDelay: _angular_core.InputSignal<number | undefined>;
|
|
3078
|
+
readonly gogTooltipDisabled: _angular_core.InputSignal<boolean>;
|
|
3079
|
+
/**
|
|
3080
|
+
* Extra class(es) applied to the bubble itself, for restyling one specific tooltip
|
|
3081
|
+
* instance. The bubble is appended to `document.body`, so a `--gog-tooltip-*` override
|
|
3082
|
+
* scoped to an ancestor (anything short of `:root`) never reaches it — a class targeting
|
|
3083
|
+
* the bubble directly, e.g. `.my-tooltip { --gog-tooltip-bg: gold; }`, is what does.
|
|
3084
|
+
*/
|
|
3085
|
+
readonly gogTooltipClass: _angular_core.InputSignal<string>;
|
|
3086
|
+
private readonly elRef;
|
|
3087
|
+
private readonly viewContainerRef;
|
|
3088
|
+
private readonly document;
|
|
3089
|
+
private readonly destroyRef;
|
|
3090
|
+
private readonly globalConfig;
|
|
3091
|
+
private readonly isBrowser;
|
|
3092
|
+
private readonly uid;
|
|
3093
|
+
private readonly overlay;
|
|
3094
|
+
private readonly isVisible;
|
|
3095
|
+
protected readonly describedById: _angular_core.Signal<string | null>;
|
|
3096
|
+
private readonly resolvedPosition;
|
|
3097
|
+
private readonly resolvedShowDelay;
|
|
3098
|
+
private readonly resolvedHideDelay;
|
|
3099
|
+
private activeRef;
|
|
3100
|
+
private showTimer;
|
|
3101
|
+
private hideTimer;
|
|
3102
|
+
private repositionFrame;
|
|
3103
|
+
private readonly onReflow;
|
|
3104
|
+
/**
|
|
3105
|
+
* Bound to the bubble itself (see `show()`) so moving the pointer off the trigger and
|
|
3106
|
+
* onto the bubble — to read more of it, or to scroll one tall enough to need it — cancels
|
|
3107
|
+
* the pending hide instead of racing it; leaving the bubble then re-queues the same hide
|
|
3108
|
+
* delay leaving the trigger would. WCAG 2.1 SC 1.4.13 "hoverable" requires exactly this:
|
|
3109
|
+
* hover-triggered content has to stay visible while the pointer is over the content, not
|
|
3110
|
+
* just the trigger.
|
|
3111
|
+
*/
|
|
3112
|
+
private readonly onBubbleMouseEnter;
|
|
3113
|
+
private readonly onBubbleMouseLeave;
|
|
3114
|
+
constructor();
|
|
3115
|
+
protected onPointerEnter(): void;
|
|
3116
|
+
protected onPointerLeave(): void;
|
|
3117
|
+
protected onFocusIn(): void;
|
|
3118
|
+
protected onFocusOut(): void;
|
|
3119
|
+
protected onEscape(): void;
|
|
3120
|
+
private queueShow;
|
|
3121
|
+
private queueHide;
|
|
3122
|
+
private cancelTimers;
|
|
3123
|
+
private show;
|
|
3124
|
+
private hide;
|
|
3125
|
+
private scheduleReposition;
|
|
3126
|
+
private applyPlacement;
|
|
3127
|
+
/**
|
|
3128
|
+
* A tooltip appended to `document.body` loses whatever `--gog-tooltip-z` an ancestor
|
|
3129
|
+
* (e.g. a `gog-dialog` panel, which raises it so nested overlays stack above the dialog)
|
|
3130
|
+
* declared, since `body` isn't part of that subtree anymore — same problem
|
|
3131
|
+
* `GogDropdownBase.resolvePanelZIndex` solves for dropdown panels, resolved here from the
|
|
3132
|
+
* trigger while it's still in its real position in the tree, before the bubble moves out.
|
|
3133
|
+
*/
|
|
3134
|
+
private resolveZIndex;
|
|
3135
|
+
private cleanup;
|
|
3136
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogTooltipDirective, never>;
|
|
3137
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogTooltipDirective, "[gogTooltip]", never, { "gogTooltip": { "alias": "gogTooltip"; "required": false; "isSignal": true; }; "gogTooltipPosition": { "alias": "gogTooltipPosition"; "required": false; "isSignal": true; }; "gogTooltipShowDelay": { "alias": "gogTooltipShowDelay"; "required": false; "isSignal": true; }; "gogTooltipHideDelay": { "alias": "gogTooltipHideDelay"; "required": false; "isSignal": true; }; "gogTooltipDisabled": { "alias": "gogTooltipDisabled"; "required": false; "isSignal": true; }; "gogTooltipClass": { "alias": "gogTooltipClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
3138
|
+
}
|
|
3139
|
+
|
|
1250
3140
|
declare class ThemeService {
|
|
1251
3141
|
private readonly document;
|
|
1252
3142
|
private readonly root;
|
|
@@ -1281,10 +3171,123 @@ interface GogGlobalConfig {
|
|
|
1281
3171
|
hideDelay?: number;
|
|
1282
3172
|
size?: GogScrollSize;
|
|
1283
3173
|
overscrollBehavior?: GogScrollOverscrollBehavior;
|
|
3174
|
+
/**
|
|
3175
|
+
* Whether the overlay thumb/track ever renders. Scrolling itself is unaffected either way
|
|
3176
|
+
* — this is purely the visual affordance. Defaults to `true`.
|
|
3177
|
+
*/
|
|
3178
|
+
showTrack?: boolean;
|
|
1284
3179
|
};
|
|
1285
3180
|
button?: {
|
|
1286
3181
|
debounce?: number;
|
|
1287
3182
|
};
|
|
3183
|
+
tooltip?: {
|
|
3184
|
+
showDelay?: number;
|
|
3185
|
+
hideDelay?: number;
|
|
3186
|
+
position?: GogTooltipPosition;
|
|
3187
|
+
};
|
|
3188
|
+
/** Applies to `gog-inputfield`, `gog-select`, `gog-multiselect` and `gog-textarea`. */
|
|
3189
|
+
floatLabel?: {
|
|
3190
|
+
variant?: GogFloatLabelVariant;
|
|
3191
|
+
/**
|
|
3192
|
+
* Whether the field's own `placeholder` reappears once its label has floated out of
|
|
3193
|
+
* the way. Defaults to `false` — the placeholder stays hidden the whole time a float
|
|
3194
|
+
* label is active, since the resting label already occupies that space.
|
|
3195
|
+
*/
|
|
3196
|
+
showPlaceholder?: boolean;
|
|
3197
|
+
};
|
|
3198
|
+
/**
|
|
3199
|
+
* Defaults for the interactive form controls — the two settings an app otherwise repeats on
|
|
3200
|
+
* literally every one of them: a compact app writes `size="sm"` everywhere, and a
|
|
3201
|
+
* Reactive-Forms app writes `errorDisplay="auto"` on every field.
|
|
3202
|
+
*
|
|
3203
|
+
* - `size` applies to `gog-button`, `gog-inputfield`, `gog-textarea`, `gog-select`,
|
|
3204
|
+
* `gog-multiselect`, `gog-checkbox` and `gog-radio-group`. Deliberately **not** to
|
|
3205
|
+
* `gog-table`, `gog-accordion` or `gog-paginator` (whose `size` means row/layout density
|
|
3206
|
+
* and whose defaults differ), nor to `gog-spinner`, `gog-skeleton`, `gog-tag` or
|
|
3207
|
+
* `gog-chip` (sized to fit whatever they sit next to, not to a form's density).
|
|
3208
|
+
* - `errorDisplay` applies to every control that renders a validation message:
|
|
3209
|
+
* `gog-inputfield`, `gog-textarea`, `gog-select`, `gog-multiselect`, `gog-radio-group`
|
|
3210
|
+
* and `gog-slider`.
|
|
3211
|
+
*
|
|
3212
|
+
* A component's own built-in default still applies when this is unset, so setting `size`
|
|
3213
|
+
* here does not flatten the different defaults those excluded components have.
|
|
3214
|
+
*/
|
|
3215
|
+
control?: {
|
|
3216
|
+
size?: GogSize;
|
|
3217
|
+
errorDisplay?: GogErrorDisplay;
|
|
3218
|
+
/**
|
|
3219
|
+
* Whether `gog-inputfield`, `gog-textarea`, `gog-select` and `gog-multiselect` offer a
|
|
3220
|
+
* clear button. The button only ever appears once the control actually has something to
|
|
3221
|
+
* clear, so switching this on app-wide adds no permanent chrome.
|
|
3222
|
+
*
|
|
3223
|
+
* Component defaults are `false`, except `gog-multiselect`, which had a clear button
|
|
3224
|
+
* before this input existed and keeps it.
|
|
3225
|
+
*/
|
|
3226
|
+
clearable?: boolean;
|
|
3227
|
+
};
|
|
3228
|
+
/** Applies to `gog-select` and `gog-multiselect`. */
|
|
3229
|
+
dropdown?: {
|
|
3230
|
+
/**
|
|
3231
|
+
* Whether the panel is rendered into `<body>` instead of inline. Worth setting app-wide
|
|
3232
|
+
* for a layout whose dropdowns generally live inside scrollable or overflow-clipped
|
|
3233
|
+
* containers, which is the case this exists for.
|
|
3234
|
+
*/
|
|
3235
|
+
appendToBody?: boolean;
|
|
3236
|
+
direction?: GogDropdownDirection;
|
|
3237
|
+
/** Whether the panel shows a search box. Off by default. */
|
|
3238
|
+
filter?: boolean;
|
|
3239
|
+
/** Which end of the panel the search box sticks to. `'top'` by default. */
|
|
3240
|
+
filterPosition?: GogDropdownFilterPosition;
|
|
3241
|
+
};
|
|
3242
|
+
/**
|
|
3243
|
+
* Applies to `gog-datepicker` and `gog-calendar`. Every field here is something an app sets
|
|
3244
|
+
* once rather than per field — a locale and a date format repeated on every date input is
|
|
3245
|
+
* exactly the boilerplate this config exists to remove.
|
|
3246
|
+
*/
|
|
3247
|
+
datepicker?: {
|
|
3248
|
+
/** BCP-47 tag driving month and weekday names. */
|
|
3249
|
+
locale?: string;
|
|
3250
|
+
/** 0 = Sunday … 6 = Saturday. Unset, it comes from the locale. */
|
|
3251
|
+
firstDayOfWeek?: number;
|
|
3252
|
+
/** Display and parse pattern (`dd.MM.yyyy`, `yyyy-MM-dd`, …). */
|
|
3253
|
+
format?: string;
|
|
3254
|
+
};
|
|
3255
|
+
/** Applies to `gog-autocomplete`. */
|
|
3256
|
+
autocomplete?: {
|
|
3257
|
+
/**
|
|
3258
|
+
* Milliseconds to wait after the last keystroke before `gogSearch` fires. A whole app
|
|
3259
|
+
* usually wants one answer here, tuned to its backend rather than to each field.
|
|
3260
|
+
*/
|
|
3261
|
+
searchDebounce?: number;
|
|
3262
|
+
/** How many characters before the panel opens at all. */
|
|
3263
|
+
minLength?: number;
|
|
3264
|
+
/**
|
|
3265
|
+
* Whether focusing the field opens the panel immediately, showing the full option list.
|
|
3266
|
+
* Defaults to `true`.
|
|
3267
|
+
*/
|
|
3268
|
+
openOnFocus?: boolean;
|
|
3269
|
+
};
|
|
3270
|
+
/** Applies to `gog-inputfield`. */
|
|
3271
|
+
inputfield?: {
|
|
3272
|
+
/**
|
|
3273
|
+
* Whether a `type="number"` field shows the library's own spin buttons in place of the
|
|
3274
|
+
* browser's native ones. Defaults to `true`.
|
|
3275
|
+
*/
|
|
3276
|
+
showSpinButtons?: boolean;
|
|
3277
|
+
};
|
|
3278
|
+
/** Applies to `gog-textarea`. */
|
|
3279
|
+
textarea?: {
|
|
3280
|
+
/**
|
|
3281
|
+
* Which direction(s) the field's own drag handle resizes it in — matches the native CSS
|
|
3282
|
+
* `resize` value space. Defaults to `'vertical'`.
|
|
3283
|
+
*/
|
|
3284
|
+
resize?: GogTextareaResize;
|
|
3285
|
+
};
|
|
3286
|
+
toast?: {
|
|
3287
|
+
position?: ToastPosition;
|
|
3288
|
+
/** How long a non-sticky toast stays up, in ms. */
|
|
3289
|
+
duration?: number;
|
|
3290
|
+
};
|
|
1288
3291
|
}
|
|
1289
3292
|
/**
|
|
1290
3293
|
* Resolves to `{}` — every field falls through to its component's own hardcoded default —
|
|
@@ -1306,12 +3309,102 @@ declare const GOG_CONFIG: InjectionToken<GogGlobalConfig>;
|
|
|
1306
3309
|
* ]
|
|
1307
3310
|
* ```
|
|
1308
3311
|
*
|
|
1309
|
-
* Providing this again further down the injector tree
|
|
1310
|
-
*
|
|
1311
|
-
*
|
|
1312
|
-
*
|
|
3312
|
+
* **Providing this again further down the injector tree layers onto the parent's config
|
|
3313
|
+
* rather than replacing it.** A route that only cares about tooltips can say so, and the
|
|
3314
|
+
* app-wide `button.debounce` stays in effect inside it:
|
|
3315
|
+
*
|
|
3316
|
+
* ```ts
|
|
3317
|
+
* // a route's providers — button.debounce from app.config.ts still applies here
|
|
3318
|
+
* provideGogConfig({ tooltip: { showDelay: 0 } })
|
|
3319
|
+
* ```
|
|
3320
|
+
*
|
|
3321
|
+
* Merging is one level deep, per component key: the nearest provider wins field by field, so
|
|
3322
|
+
* `{ tooltip: { showDelay: 0 } }` overrides only `showDelay` and leaves a parent's
|
|
3323
|
+
* `tooltip.position` alone. To drop an inherited value rather than change it, set it back to
|
|
3324
|
+
* the component's own default explicitly — there is no "unset" marker.
|
|
1313
3325
|
*/
|
|
1314
3326
|
declare function provideGogConfig(config: GogGlobalConfig): Provider;
|
|
3327
|
+
/**
|
|
3328
|
+
* The library's precedence rule for a configurable input, in one place: an instance's own
|
|
3329
|
+
* input wins, then the app-wide `GOG_CONFIG` value, then the component's built-in default.
|
|
3330
|
+
*
|
|
3331
|
+
* Every configurable input resolves through this rather than repeating the `??` chain, so the
|
|
3332
|
+
* order can't drift between components — a component that accidentally checked the config
|
|
3333
|
+
* first would silently ignore the input on that one control only, which is close to invisible
|
|
3334
|
+
* in review. Kept a plain function (no `inject`) so it works anywhere: inside a `computed`, in
|
|
3335
|
+
* a composition class like `GogFloatLabelState`, and in unit tests without an injector.
|
|
3336
|
+
*
|
|
3337
|
+
* ```ts
|
|
3338
|
+
* private readonly globalConfig = inject(GOG_CONFIG);
|
|
3339
|
+
* protected readonly resolvedDebounce = computed(() =>
|
|
3340
|
+
* resolveConfigured(this.debounce(), this.globalConfig.button?.debounce, DEFAULT_DEBOUNCE),
|
|
3341
|
+
* );
|
|
3342
|
+
* ```
|
|
3343
|
+
*/
|
|
3344
|
+
declare function resolveConfigured<T>(instanceValue: T | undefined, configuredValue: T | undefined, fallback: T): T;
|
|
3345
|
+
|
|
3346
|
+
/**
|
|
3347
|
+
* Shared float-label state for the library's field-style controls.
|
|
3348
|
+
*
|
|
3349
|
+
* A plain class rather than a base class or directive, for the same reason as `GogErrorState`:
|
|
3350
|
+
* it has to serve `gog-inputfield` and `gog-textarea`, which share no base class, as well as
|
|
3351
|
+
* `GogDropdownBase`, which is one. Each consumer owns an instance and exposes whichever
|
|
3352
|
+
* members its template needs.
|
|
3353
|
+
*
|
|
3354
|
+
* The one thing each control must supply itself is `hasValue` — "this field has content" means
|
|
3355
|
+
* something different everywhere (a non-empty string, a non-null selection, a non-empty
|
|
3356
|
+
* selection array), which is exactly why this is composed in rather than implemented as a
|
|
3357
|
+
* directive sitting outside the component.
|
|
3358
|
+
*/
|
|
3359
|
+
declare class GogFloatLabelState {
|
|
3360
|
+
private readonly variantInput;
|
|
3361
|
+
private readonly showPlaceholderInput;
|
|
3362
|
+
private readonly placeholder;
|
|
3363
|
+
private readonly isFocused;
|
|
3364
|
+
private readonly hasValue;
|
|
3365
|
+
private readonly config;
|
|
3366
|
+
/**
|
|
3367
|
+
* @param variantInput the control's own `floatLabel` input (`undefined` when unset)
|
|
3368
|
+
* @param showPlaceholderInput the control's own `floatLabelShowPlaceholder` input
|
|
3369
|
+
* @param placeholder the control's `placeholder` input
|
|
3370
|
+
* @param isFocused whether the control currently has focus
|
|
3371
|
+
* @param hasValue whether the control has a value — see the class note
|
|
3372
|
+
* @param config the injected `GOG_CONFIG`
|
|
3373
|
+
*/
|
|
3374
|
+
constructor(variantInput: Signal<GogFloatLabelVariant | undefined>, showPlaceholderInput: Signal<boolean | undefined>, placeholder: Signal<string>, isFocused: Signal<boolean>, hasValue: Signal<boolean>, config: GogGlobalConfig);
|
|
3375
|
+
/** The resolved variant: instance input, else `GOG_CONFIG.floatLabel.variant`, else `'none'`. */
|
|
3376
|
+
readonly variant: Signal<GogFloatLabelVariant>;
|
|
3377
|
+
readonly showPlaceholder: Signal<boolean>;
|
|
3378
|
+
/** Whether a float label is in effect at all — `false` keeps the static label-above layout. */
|
|
3379
|
+
readonly isActive: Signal<boolean>;
|
|
3380
|
+
/** Whether the label is at its floated target rather than resting like a placeholder. */
|
|
3381
|
+
readonly isFloated: Signal<boolean>;
|
|
3382
|
+
/**
|
|
3383
|
+
* The placeholder the control should actually render. While a float label is active the
|
|
3384
|
+
* resting label already occupies that space, so the placeholder stays hidden unless the
|
|
3385
|
+
* consumer opted into `floatLabelShowPlaceholder` — and even then only once the label has
|
|
3386
|
+
* floated out of the way.
|
|
3387
|
+
*/
|
|
3388
|
+
readonly effectivePlaceholder: Signal<string>;
|
|
3389
|
+
}
|
|
3390
|
+
|
|
3391
|
+
/** Every `--gog-*` custom property the library declares or documents as an override point. */
|
|
3392
|
+
type GogTokenName = '--gog-accent-bright' | '--gog-accent-color' | '--gog-accent-dim' | '--gog-accent-pale' | '--gog-accent-text-color' | '--gog-accordion-accent-color' | '--gog-accordion-body-bg' | '--gog-accordion-body-color' | '--gog-accordion-body-font-family' | '--gog-accordion-body-font-size' | '--gog-accordion-body-lift' | '--gog-accordion-body-line-height' | '--gog-accordion-body-padding-bottom' | '--gog-accordion-body-padding-top' | '--gog-accordion-body-radius' | '--gog-accordion-body-transition-duration' | '--gog-accordion-border-color' | '--gog-accordion-border-style' | '--gog-accordion-border-width' | '--gog-accordion-chevron-font-size' | '--gog-accordion-chevron-size' | '--gog-accordion-chevron-transition-duration' | '--gog-accordion-content-gap' | '--gog-accordion-disabled-opacity' | '--gog-accordion-focus-ring-width' | '--gog-accordion-font-family' | '--gog-accordion-font-size' | '--gog-accordion-header-bg' | '--gog-accordion-header-gap' | '--gog-accordion-header-text-transform' | '--gog-accordion-hover-bg' | '--gog-accordion-hover-ring' | '--gog-accordion-letter-spacing' | '--gog-accordion-lg-body-font-size' | '--gog-accordion-lg-body-line-height' | '--gog-accordion-lg-body-padding-bottom' | '--gog-accordion-lg-body-padding-top' | '--gog-accordion-lg-chevron-font-size' | '--gog-accordion-lg-chevron-size' | '--gog-accordion-lg-content-gap' | '--gog-accordion-lg-font-size' | '--gog-accordion-lg-letter-spacing' | '--gog-accordion-lg-padding-x' | '--gog-accordion-lg-padding-y' | '--gog-accordion-md-body-font-size' | '--gog-accordion-md-body-line-height' | '--gog-accordion-md-body-padding-bottom' | '--gog-accordion-md-body-padding-top' | '--gog-accordion-md-chevron-font-size' | '--gog-accordion-md-chevron-size' | '--gog-accordion-md-content-gap' | '--gog-accordion-md-font-size' | '--gog-accordion-md-letter-spacing' | '--gog-accordion-md-padding-x' | '--gog-accordion-md-padding-y' | '--gog-accordion-padding-x' | '--gog-accordion-padding-y' | '--gog-accordion-radius' | '--gog-accordion-slg-body-font-size' | '--gog-accordion-slg-body-line-height' | '--gog-accordion-slg-body-padding-bottom' | '--gog-accordion-slg-body-padding-top' | '--gog-accordion-slg-chevron-font-size' | '--gog-accordion-slg-chevron-size' | '--gog-accordion-slg-content-gap' | '--gog-accordion-slg-font-size' | '--gog-accordion-slg-letter-spacing' | '--gog-accordion-slg-padding-x' | '--gog-accordion-slg-padding-y' | '--gog-accordion-sm-body-font-size' | '--gog-accordion-sm-body-line-height' | '--gog-accordion-sm-body-padding-bottom' | '--gog-accordion-sm-body-padding-top' | '--gog-accordion-sm-chevron-font-size' | '--gog-accordion-sm-chevron-size' | '--gog-accordion-sm-content-gap' | '--gog-accordion-sm-font-size' | '--gog-accordion-sm-letter-spacing' | '--gog-accordion-sm-padding-x' | '--gog-accordion-sm-padding-y' | '--gog-accordion-text-color' | '--gog-accordion-transition-duration' | '--gog-accordion-xsm-body-font-size' | '--gog-accordion-xsm-body-line-height' | '--gog-accordion-xsm-body-padding-bottom' | '--gog-accordion-xsm-body-padding-top' | '--gog-accordion-xsm-chevron-font-size' | '--gog-accordion-xsm-chevron-size' | '--gog-accordion-xsm-content-gap' | '--gog-accordion-xsm-font-size' | '--gog-accordion-xsm-letter-spacing' | '--gog-accordion-xsm-padding-x' | '--gog-accordion-xsm-padding-y' | '--gog-autocomplete-actions-gap' | '--gog-autocomplete-actions-inset' | '--gog-autocomplete-actions-reserve' | '--gog-autocomplete-bg' | '--gog-autocomplete-border-color' | '--gog-autocomplete-border-style' | '--gog-autocomplete-border-width' | '--gog-autocomplete-clear-color' | '--gog-autocomplete-clear-hover-color' | '--gog-autocomplete-clear-icon-ratio' | '--gog-autocomplete-color' | '--gog-autocomplete-disabled-opacity' | '--gog-autocomplete-empty-color' | '--gog-autocomplete-empty-font-size' | '--gog-autocomplete-error-border-color' | '--gog-autocomplete-error-color' | '--gog-autocomplete-error-font-family' | '--gog-autocomplete-error-font-size' | '--gog-autocomplete-field-bg' | '--gog-autocomplete-float-label-in-top' | '--gog-autocomplete-float-label-on-bg' | '--gog-autocomplete-float-label-over-gap' | '--gog-autocomplete-float-label-over-reserve' | '--gog-autocomplete-float-label-reserve' | '--gog-autocomplete-focus-ring-color' | '--gog-autocomplete-focus-ring-offset' | '--gog-autocomplete-focus-ring-width' | '--gog-autocomplete-font-family' | '--gog-autocomplete-font-size' | '--gog-autocomplete-gap' | '--gog-autocomplete-hover-border-color' | '--gog-autocomplete-label-color' | '--gog-autocomplete-label-font-family' | '--gog-autocomplete-label-font-size' | '--gog-autocomplete-label-font-weight' | '--gog-autocomplete-label-letter-spacing' | '--gog-autocomplete-label-text-transform' | '--gog-autocomplete-line-height' | '--gog-autocomplete-min-width' | '--gog-autocomplete-option-color' | '--gog-autocomplete-option-gap' | '--gog-autocomplete-option-height' | '--gog-autocomplete-option-hover-bg' | '--gog-autocomplete-option-hover-color' | '--gog-autocomplete-option-padding' | '--gog-autocomplete-option-radius' | '--gog-autocomplete-option-selected-bg' | '--gog-autocomplete-option-selected-color' | '--gog-autocomplete-options-padding' | '--gog-autocomplete-padding-x' | '--gog-autocomplete-padding-y' | '--gog-autocomplete-panel-bg' | '--gog-autocomplete-panel-border-color' | '--gog-autocomplete-panel-border-style' | '--gog-autocomplete-panel-border-width' | '--gog-autocomplete-panel-gap' | '--gog-autocomplete-panel-max-height' | '--gog-autocomplete-panel-max-width' | '--gog-autocomplete-panel-radius' | '--gog-autocomplete-panel-shadow' | '--gog-autocomplete-placeholder-color' | '--gog-autocomplete-radius' | '--gog-autocomplete-spinner-size' | '--gog-autocomplete-text-color' | '--gog-autocomplete-transition-duration' | '--gog-background-color' | '--gog-badge-bg' | '--gog-badge-border-color' | '--gog-badge-border-style' | '--gog-badge-border-width' | '--gog-badge-color' | '--gog-badge-danger-bg' | '--gog-badge-danger-color' | '--gog-badge-dot-size' | '--gog-badge-font-family' | '--gog-badge-font-size' | '--gog-badge-font-weight' | '--gog-badge-info-bg' | '--gog-badge-info-color' | '--gog-badge-line-height' | '--gog-badge-offset' | '--gog-badge-padding-inline' | '--gog-badge-radius' | '--gog-badge-size' | '--gog-badge-success-bg' | '--gog-badge-success-color' | '--gog-badge-warning-bg' | '--gog-badge-warning-color' | '--gog-badge-z' | '--gog-border-color' | '--gog-btn-active-scale' | '--gog-btn-bg' | '--gog-btn-border' | '--gog-btn-border-style' | '--gog-btn-border-width' | '--gog-btn-color' | '--gog-btn-disabled-opacity' | '--gog-btn-focus-ring-offset' | '--gog-btn-focus-ring-width' | '--gog-btn-font-family' | '--gog-btn-font-weight' | '--gog-btn-gap' | '--gog-btn-ghost-bg' | '--gog-btn-ghost-border' | '--gog-btn-ghost-color' | '--gog-btn-ghost-hover-bg' | '--gog-btn-ghost-hover-color' | '--gog-btn-ghost-hover-shadow' | '--gog-btn-ghost-shadow' | '--gog-btn-ghost-spinner-color' | '--gog-btn-hover-bg' | '--gog-btn-hover-color' | '--gog-btn-hover-shadow' | '--gog-btn-letter-spacing' | '--gog-btn-lg-font-size' | '--gog-btn-lg-padding' | '--gog-btn-line-height' | '--gog-btn-loading-opacity' | '--gog-btn-md-font-size' | '--gog-btn-md-padding' | '--gog-btn-outline-bg' | '--gog-btn-outline-border' | '--gog-btn-outline-color' | '--gog-btn-outline-hover-bg' | '--gog-btn-outline-hover-color' | '--gog-btn-outline-hover-shadow' | '--gog-btn-outline-shadow' | '--gog-btn-outline-spinner-color' | '--gog-btn-primary-bg' | '--gog-btn-primary-border' | '--gog-btn-primary-color' | '--gog-btn-primary-hover-bg' | '--gog-btn-primary-hover-color' | '--gog-btn-primary-hover-shadow' | '--gog-btn-primary-shadow' | '--gog-btn-primary-spinner-color' | '--gog-btn-radius' | '--gog-btn-secondary-bg' | '--gog-btn-secondary-border' | '--gog-btn-secondary-color' | '--gog-btn-secondary-hover-bg' | '--gog-btn-secondary-hover-color' | '--gog-btn-secondary-hover-shadow' | '--gog-btn-secondary-shadow' | '--gog-btn-secondary-spinner-color' | '--gog-btn-shadow' | '--gog-btn-slg-font-size' | '--gog-btn-slg-padding' | '--gog-btn-sm-font-size' | '--gog-btn-sm-padding' | '--gog-btn-spinner-color' | '--gog-btn-spinner-max-size' | '--gog-btn-text-transform' | '--gog-btn-transition-duration' | '--gog-btn-xsm-font-size' | '--gog-btn-xsm-padding' | '--gog-button-toggle-bg' | '--gog-button-toggle-border-color' | '--gog-button-toggle-border-style' | '--gog-button-toggle-border-width' | '--gog-button-toggle-color' | '--gog-button-toggle-disabled-opacity' | '--gog-button-toggle-focus-ring-color' | '--gog-button-toggle-focus-ring-offset' | '--gog-button-toggle-focus-ring-width' | '--gog-button-toggle-font-family' | '--gog-button-toggle-font-size' | '--gog-button-toggle-font-weight' | '--gog-button-toggle-gap' | '--gog-button-toggle-hover-bg' | '--gog-button-toggle-hover-color' | '--gog-button-toggle-icon-size' | '--gog-button-toggle-letter-spacing' | '--gog-button-toggle-line-height' | '--gog-button-toggle-padding' | '--gog-button-toggle-radius' | '--gog-button-toggle-rest-bg' | '--gog-button-toggle-rest-color' | '--gog-button-toggle-selected-bg' | '--gog-button-toggle-selected-border-color' | '--gog-button-toggle-selected-color' | '--gog-button-toggle-separated-gap' | '--gog-button-toggle-text-transform' | '--gog-button-toggle-transition-duration' | '--gog-calendar-action-padding' | '--gog-calendar-color' | '--gog-calendar-day-bg' | '--gog-calendar-day-border-style' | '--gog-calendar-day-border-width' | '--gog-calendar-day-color' | '--gog-calendar-day-hover-bg' | '--gog-calendar-day-outside-color' | '--gog-calendar-day-radius' | '--gog-calendar-day-rest-bg' | '--gog-calendar-day-rest-color' | '--gog-calendar-day-size' | '--gog-calendar-disabled-opacity' | '--gog-calendar-divider-color' | '--gog-calendar-divider-style' | '--gog-calendar-divider-width' | '--gog-calendar-focus-ring-color' | '--gog-calendar-focus-ring-offset' | '--gog-calendar-focus-ring-width' | '--gog-calendar-font-family' | '--gog-calendar-header-gap' | '--gog-calendar-header-margin' | '--gog-calendar-lg-day-size' | '--gog-calendar-lg-font-size' | '--gog-calendar-md-day-size' | '--gog-calendar-md-font-size' | '--gog-calendar-months-gap' | '--gog-calendar-nav-bg' | '--gog-calendar-nav-color' | '--gog-calendar-nav-hover-bg' | '--gog-calendar-nav-hover-color' | '--gog-calendar-nav-icon-overlap' | '--gog-calendar-nav-icon-size' | '--gog-calendar-nav-radius' | '--gog-calendar-nav-size' | '--gog-calendar-padding' | '--gog-calendar-range-bg' | '--gog-calendar-range-color' | '--gog-calendar-selected-bg' | '--gog-calendar-selected-color' | '--gog-calendar-selected-font-weight' | '--gog-calendar-slg-day-size' | '--gog-calendar-slg-font-size' | '--gog-calendar-sm-day-size' | '--gog-calendar-sm-font-size' | '--gog-calendar-time-gap' | '--gog-calendar-time-input-bg' | '--gog-calendar-time-input-padding' | '--gog-calendar-time-input-width' | '--gog-calendar-time-margin' | '--gog-calendar-title-color' | '--gog-calendar-title-font-weight' | '--gog-calendar-today-border-color' | '--gog-calendar-today-font-weight' | '--gog-calendar-transition-duration' | '--gog-calendar-weekday-color' | '--gog-calendar-weekday-font-size' | '--gog-calendar-weekday-font-weight' | '--gog-calendar-weekday-padding' | '--gog-calendar-weekday-text-transform' | '--gog-calendar-xsm-day-size' | '--gog-calendar-xsm-font-size' | '--gog-checkbox-bg' | '--gog-checkbox-border-color' | '--gog-checkbox-border-style' | '--gog-checkbox-border-width' | '--gog-checkbox-box-size' | '--gog-checkbox-checked-bg' | '--gog-checkbox-checked-border' | '--gog-checkbox-dash-height' | '--gog-checkbox-dash-radius' | '--gog-checkbox-dash-width-ratio' | '--gog-checkbox-disabled-opacity' | '--gog-checkbox-focus-ring' | '--gog-checkbox-focus-ring-offset' | '--gog-checkbox-focus-ring-width' | '--gog-checkbox-font-family' | '--gog-checkbox-gap' | '--gog-checkbox-icon-color' | '--gog-checkbox-icon-size' | '--gog-checkbox-label-color' | '--gog-checkbox-label-line-height' | '--gog-checkbox-label-size' | '--gog-checkbox-padding' | '--gog-checkbox-radius' | '--gog-checkbox-transition-duration' | '--gog-chip-avatar-inset-ratio' | '--gog-chip-avatar-size' | '--gog-chip-bg' | '--gog-chip-border' | '--gog-chip-border-style' | '--gog-chip-border-width' | '--gog-chip-color' | '--gog-chip-disabled-opacity' | '--gog-chip-focus-ring-offset' | '--gog-chip-focus-ring-width' | '--gog-chip-font-family' | '--gog-chip-font-size' | '--gog-chip-font-weight' | '--gog-chip-gap' | '--gog-chip-hover-bg' | '--gog-chip-icon-size' | '--gog-chip-lg-avatar-size' | '--gog-chip-lg-font-size' | '--gog-chip-lg-gap' | '--gog-chip-lg-icon-size' | '--gog-chip-lg-padding-block' | '--gog-chip-lg-padding-inline' | '--gog-chip-lg-remove-size' | '--gog-chip-line-height' | '--gog-chip-md-avatar-size' | '--gog-chip-md-font-size' | '--gog-chip-md-gap' | '--gog-chip-md-icon-size' | '--gog-chip-md-padding-block' | '--gog-chip-md-padding-inline' | '--gog-chip-md-remove-size' | '--gog-chip-padding-block' | '--gog-chip-padding-inline' | '--gog-chip-pill-radius' | '--gog-chip-radius' | '--gog-chip-remove-color' | '--gog-chip-remove-hover-color' | '--gog-chip-remove-inset-ratio' | '--gog-chip-remove-scale' | '--gog-chip-remove-size' | '--gog-chip-slg-avatar-size' | '--gog-chip-slg-font-size' | '--gog-chip-slg-gap' | '--gog-chip-slg-icon-size' | '--gog-chip-slg-padding-block' | '--gog-chip-slg-padding-inline' | '--gog-chip-slg-remove-size' | '--gog-chip-sm-avatar-size' | '--gog-chip-sm-font-size' | '--gog-chip-sm-gap' | '--gog-chip-sm-icon-size' | '--gog-chip-sm-padding-block' | '--gog-chip-sm-padding-inline' | '--gog-chip-sm-remove-size' | '--gog-chip-xsm-avatar-size' | '--gog-chip-xsm-font-size' | '--gog-chip-xsm-gap' | '--gog-chip-xsm-icon-size' | '--gog-chip-xsm-padding-block' | '--gog-chip-xsm-padding-inline' | '--gog-chip-xsm-remove-size' | '--gog-collapsible-disabled-opacity' | '--gog-collapsible-max-height' | '--gog-collapsible-transition-duration' | '--gog-confirm-actions-gap' | '--gog-confirm-actions-offset' | '--gog-confirm-color' | '--gog-confirm-description-color' | '--gog-confirm-gap' | '--gog-confirm-max-width' | '--gog-confirm-min-width' | '--gog-control-border-style' | '--gog-control-border-width' | '--gog-control-checkbox-box-size-lg' | '--gog-control-checkbox-box-size-md' | '--gog-control-checkbox-box-size-slg' | '--gog-control-checkbox-box-size-sm' | '--gog-control-checkbox-box-size-xsm' | '--gog-control-checkbox-icon-size-lg' | '--gog-control-checkbox-icon-size-md' | '--gog-control-checkbox-icon-size-slg' | '--gog-control-checkbox-icon-size-sm' | '--gog-control-checkbox-icon-size-xsm' | '--gog-control-checkbox-label-size-lg' | '--gog-control-checkbox-label-size-md' | '--gog-control-checkbox-label-size-slg' | '--gog-control-checkbox-label-size-sm' | '--gog-control-checkbox-label-size-xsm' | '--gog-control-checkbox-padding' | '--gog-control-icon-offset' | '--gog-control-padding-x' | '--gog-control-padding-y' | '--gog-danger-color' | '--gog-datepicker-actions-gap' | '--gog-datepicker-actions-inset' | '--gog-datepicker-actions-reserve' | '--gog-datepicker-bg' | '--gog-datepicker-border-color' | '--gog-datepicker-border-style' | '--gog-datepicker-border-width' | '--gog-datepicker-clear-color' | '--gog-datepicker-clear-icon-ratio' | '--gog-datepicker-color' | '--gog-datepicker-disabled-opacity' | '--gog-datepicker-error-border-color' | '--gog-datepicker-error-color' | '--gog-datepicker-error-font-family' | '--gog-datepicker-error-font-size' | '--gog-datepicker-field-bg' | '--gog-datepicker-float-label-in-top' | '--gog-datepicker-float-label-on-bg' | '--gog-datepicker-float-label-over-gap' | '--gog-datepicker-float-label-over-reserve' | '--gog-datepicker-float-label-reserve' | '--gog-datepicker-focus-ring-color' | '--gog-datepicker-focus-ring-offset' | '--gog-datepicker-focus-ring-width' | '--gog-datepicker-font-family' | '--gog-datepicker-font-size' | '--gog-datepicker-gap' | '--gog-datepicker-hover-border-color' | '--gog-datepicker-icon-color' | '--gog-datepicker-icon-hover-color' | '--gog-datepicker-label-color' | '--gog-datepicker-label-font-family' | '--gog-datepicker-label-font-size' | '--gog-datepicker-label-letter-spacing' | '--gog-datepicker-label-text-transform' | '--gog-datepicker-line-height' | '--gog-datepicker-min-width' | '--gog-datepicker-padding-x' | '--gog-datepicker-padding-y' | '--gog-datepicker-panel-bg' | '--gog-datepicker-panel-border-color' | '--gog-datepicker-panel-border-style' | '--gog-datepicker-panel-border-width' | '--gog-datepicker-panel-gap' | '--gog-datepicker-panel-radius' | '--gog-datepicker-panel-shadow' | '--gog-datepicker-placeholder-color' | '--gog-datepicker-radius' | '--gog-datepicker-text-color' | '--gog-datepicker-toggle-icon-size' | '--gog-datepicker-transition-duration' | '--gog-dialog-backdrop-bg' | '--gog-dialog-backdrop-blur' | '--gog-dialog-backdrop-fade-duration' | '--gog-dialog-backdrop-padding' | '--gog-dialog-bg' | '--gog-dialog-body-max-height' | '--gog-dialog-body-padding' | '--gog-dialog-border' | '--gog-dialog-border-style' | '--gog-dialog-border-width' | '--gog-dialog-close-color' | '--gog-dialog-close-focus-ring' | '--gog-dialog-close-focus-ring-offset' | '--gog-dialog-close-focus-ring-width' | '--gog-dialog-close-font-size' | '--gog-dialog-close-hover-bg' | '--gog-dialog-close-hover-border' | '--gog-dialog-close-hover-color' | '--gog-dialog-close-size' | '--gog-dialog-color' | '--gog-dialog-enter-distance' | '--gog-dialog-enter-duration' | '--gog-dialog-font-family' | '--gog-dialog-header-border-color' | '--gog-dialog-header-gap' | '--gog-dialog-header-padding' | '--gog-dialog-max-height' | '--gog-dialog-min-width' | '--gog-dialog-offset-x' | '--gog-dialog-offset-y' | '--gog-dialog-radius' | '--gog-dialog-shadow' | '--gog-disabled-opacity' | '--gog-divider-block-spacing' | '--gog-divider-color' | '--gog-divider-dashed-style' | '--gog-divider-dotted-style' | '--gog-divider-inline-spacing' | '--gog-divider-inset-size' | '--gog-divider-label-color' | '--gog-divider-label-font-family' | '--gog-divider-label-font-size' | '--gog-divider-label-font-weight' | '--gog-divider-label-gap' | '--gog-divider-label-line-height' | '--gog-divider-line-color' | '--gog-divider-line-thickness' | '--gog-divider-solid-style' | '--gog-divider-spacing' | '--gog-divider-thickness' | '--gog-divider-vertical-length' | '--gog-dropdown-z' | '--gog-duration-base' | '--gog-duration-fast' | '--gog-duration-slow' | '--gog-easing' | '--gog-field-float-label-in-top' | '--gog-field-float-label-over-gap' | '--gog-field-float-label-over-reserve' | '--gog-field-float-label-reserve' | '--gog-field-lg-font-size' | '--gog-field-lg-icon-inset' | '--gog-field-lg-icon-offset' | '--gog-field-lg-padding-x' | '--gog-field-lg-padding-y' | '--gog-field-md-font-size' | '--gog-field-md-icon-inset' | '--gog-field-md-icon-offset' | '--gog-field-md-padding-x' | '--gog-field-md-padding-y' | '--gog-field-slg-font-size' | '--gog-field-slg-icon-inset' | '--gog-field-slg-icon-offset' | '--gog-field-slg-padding-x' | '--gog-field-slg-padding-y' | '--gog-field-sm-font-size' | '--gog-field-sm-icon-inset' | '--gog-field-sm-icon-offset' | '--gog-field-sm-padding-x' | '--gog-field-sm-padding-y' | '--gog-field-xsm-font-size' | '--gog-field-xsm-icon-inset' | '--gog-field-xsm-icon-offset' | '--gog-field-xsm-padding-x' | '--gog-field-xsm-padding-y' | '--gog-focus-ring-offset' | '--gog-focus-ring-width' | '--gog-font-body' | '--gog-font-heading' | '--gog-font-mono' | '--gog-hover-color' | '--gog-icon-fallback-size' | '--gog-icon-size' | '--gog-icon-stroke-width' | '--gog-info-color' | '--gog-input-clear-icon-ratio' | '--gog-input-clear-inset' | '--gog-input-clear-radius' | '--gog-input-disabled-opacity' | '--gog-input-error-color' | '--gog-input-error-font-size' | '--gog-input-error-offset' | '--gog-input-field-bg' | '--gog-input-field-border' | '--gog-input-field-border-style' | '--gog-input-field-border-width' | '--gog-input-field-color' | '--gog-input-float-label-in-top' | '--gog-input-float-label-on-bg' | '--gog-input-float-label-over-gap' | '--gog-input-float-label-over-reserve' | '--gog-input-float-label-reserve' | '--gog-input-focus-border' | '--gog-input-focus-glow' | '--gog-input-focus-ring' | '--gog-input-focus-ring-offset' | '--gog-input-focus-ring-width' | '--gog-input-font' | '--gog-input-font-family' | '--gog-input-gap' | '--gog-input-icon-action-radius' | '--gog-input-icon-color' | '--gog-input-icon-focus-ring-width' | '--gog-input-icon-hover-color' | '--gog-input-label-color' | '--gog-input-label-font-family' | '--gog-input-label-font-size' | '--gog-input-label-letter-spacing' | '--gog-input-label-text-transform' | '--gog-input-padding-x' | '--gog-input-padding-y' | '--gog-input-placeholder-color' | '--gog-input-radius' | '--gog-input-transition-duration' | '--gog-ms-actions-gap' | '--gog-ms-actions-inset' | '--gog-ms-arrow-icon-ratio' | '--gog-ms-arrow-transition-duration' | '--gog-ms-border-color' | '--gog-ms-checkbox-bg' | '--gog-ms-checkbox-border' | '--gog-ms-checkbox-checked-bg' | '--gog-ms-checkbox-checked-color' | '--gog-ms-clear-icon-ratio' | '--gog-ms-clear-radius' | '--gog-ms-controls-gap' | '--gog-ms-controls-padding' | '--gog-ms-disabled-opacity' | '--gog-ms-error-color' | '--gog-ms-error-font-size' | '--gog-ms-error-offset' | '--gog-ms-field-bg' | '--gog-ms-field-border' | '--gog-ms-field-border-style' | '--gog-ms-field-border-width' | '--gog-ms-field-color' | '--gog-ms-filter-border-color' | '--gog-ms-filter-border-style' | '--gog-ms-filter-border-width' | '--gog-ms-filter-empty-color' | '--gog-ms-filter-empty-padding' | '--gog-ms-filter-input-bg' | '--gog-ms-filter-input-border' | '--gog-ms-filter-input-color' | '--gog-ms-filter-input-padding-x' | '--gog-ms-filter-input-padding-y' | '--gog-ms-filter-input-radius' | '--gog-ms-filter-padding' | '--gog-ms-float-label-in-top' | '--gog-ms-float-label-over-gap' | '--gog-ms-float-label-over-reserve' | '--gog-ms-float-label-reserve' | '--gog-ms-focus-border' | '--gog-ms-focus-glow' | '--gog-ms-focus-ring' | '--gog-ms-focus-ring-offset' | '--gog-ms-focus-ring-width' | '--gog-ms-font-family' | '--gog-ms-gap' | '--gog-ms-label-color' | '--gog-ms-label-font-family' | '--gog-ms-label-font-size' | '--gog-ms-label-letter-spacing' | '--gog-ms-label-text-transform' | '--gog-ms-mark-icon-ratio' | '--gog-ms-mark-size-ratio' | '--gog-ms-min-width' | '--gog-ms-option-color' | '--gog-ms-option-disabled-opacity' | '--gog-ms-option-gap' | '--gog-ms-option-gap-inline' | '--gog-ms-option-height' | '--gog-ms-option-hover-bg' | '--gog-ms-option-radius' | '--gog-ms-option-transition-duration' | '--gog-ms-options-padding' | '--gog-ms-overflow-color' | '--gog-ms-overflow-font-size' | '--gog-ms-overflow-gap' | '--gog-ms-panel-bg' | '--gog-ms-panel-border' | '--gog-ms-panel-max-height' | '--gog-ms-panel-max-width' | '--gog-ms-panel-offset' | '--gog-ms-panel-shadow' | '--gog-ms-placeholder-color' | '--gog-ms-radius' | '--gog-ms-transition-duration' | '--gog-ms-value-color' | '--gog-multiselect-actions-gap' | '--gog-multiselect-actions-inset' | '--gog-multiselect-arrow-icon-ratio' | '--gog-multiselect-arrow-transition-duration' | '--gog-multiselect-border-color' | '--gog-multiselect-checkbox-bg' | '--gog-multiselect-checkbox-border' | '--gog-multiselect-checkbox-checked-bg' | '--gog-multiselect-checkbox-checked-color' | '--gog-multiselect-clear-icon-ratio' | '--gog-multiselect-clear-radius' | '--gog-multiselect-controls-gap' | '--gog-multiselect-controls-padding' | '--gog-multiselect-disabled-opacity' | '--gog-multiselect-error-color' | '--gog-multiselect-error-font-size' | '--gog-multiselect-error-offset' | '--gog-multiselect-field-bg' | '--gog-multiselect-field-border' | '--gog-multiselect-field-border-style' | '--gog-multiselect-field-border-width' | '--gog-multiselect-field-color' | '--gog-multiselect-filter-border-color' | '--gog-multiselect-filter-border-style' | '--gog-multiselect-filter-border-width' | '--gog-multiselect-filter-empty-color' | '--gog-multiselect-filter-empty-padding' | '--gog-multiselect-filter-input-bg' | '--gog-multiselect-filter-input-border' | '--gog-multiselect-filter-input-color' | '--gog-multiselect-filter-input-padding-x' | '--gog-multiselect-filter-input-padding-y' | '--gog-multiselect-filter-input-radius' | '--gog-multiselect-filter-padding' | '--gog-multiselect-float-label-in-top' | '--gog-multiselect-float-label-on-bg' | '--gog-multiselect-float-label-over-gap' | '--gog-multiselect-float-label-over-reserve' | '--gog-multiselect-float-label-reserve' | '--gog-multiselect-focus-border' | '--gog-multiselect-focus-glow' | '--gog-multiselect-focus-ring' | '--gog-multiselect-focus-ring-offset' | '--gog-multiselect-focus-ring-width' | '--gog-multiselect-font-family' | '--gog-multiselect-font-size' | '--gog-multiselect-gap' | '--gog-multiselect-label-color' | '--gog-multiselect-label-font-family' | '--gog-multiselect-label-font-size' | '--gog-multiselect-label-letter-spacing' | '--gog-multiselect-label-text-transform' | '--gog-multiselect-mark-icon-ratio' | '--gog-multiselect-mark-size-ratio' | '--gog-multiselect-min-width' | '--gog-multiselect-option-color' | '--gog-multiselect-option-disabled-opacity' | '--gog-multiselect-option-gap' | '--gog-multiselect-option-gap-inline' | '--gog-multiselect-option-height' | '--gog-multiselect-option-hover-bg' | '--gog-multiselect-option-radius' | '--gog-multiselect-option-transition-duration' | '--gog-multiselect-options-padding' | '--gog-multiselect-overflow-color' | '--gog-multiselect-overflow-font-size' | '--gog-multiselect-overflow-gap' | '--gog-multiselect-padding-x' | '--gog-multiselect-padding-y' | '--gog-multiselect-panel-bg' | '--gog-multiselect-panel-border' | '--gog-multiselect-panel-max-height' | '--gog-multiselect-panel-max-width' | '--gog-multiselect-panel-offset' | '--gog-multiselect-panel-shadow' | '--gog-multiselect-placeholder-color' | '--gog-multiselect-radius' | '--gog-multiselect-transition-duration' | '--gog-multiselect-value-color' | '--gog-muted-text-color' | '--gog-paginator-ellipsis-color' | '--gog-paginator-ellipsis-font-family' | '--gog-paginator-ellipsis-font-size' | '--gog-paginator-ellipsis-min-width' | '--gog-paginator-gap' | '--gog-panel-border-style' | '--gog-panel-border-width' | '--gog-panel-radius' | '--gog-panel-shadow' | '--gog-primary-color' | '--gog-progressbar-accent-bg' | '--gog-progressbar-accent-buffer-bg' | '--gog-progressbar-buffer-bg' | '--gog-progressbar-danger-bg' | '--gog-progressbar-danger-buffer-bg' | '--gog-progressbar-fill-bg' | '--gog-progressbar-height' | '--gog-progressbar-indeterminate-duration' | '--gog-progressbar-indeterminate-easing' | '--gog-progressbar-info-bg' | '--gog-progressbar-info-buffer-bg' | '--gog-progressbar-lg-height' | '--gog-progressbar-md-height' | '--gog-progressbar-radius' | '--gog-progressbar-slg-height' | '--gog-progressbar-sm-height' | '--gog-progressbar-stripe-color' | '--gog-progressbar-stripe-size' | '--gog-progressbar-success-bg' | '--gog-progressbar-success-buffer-bg' | '--gog-progressbar-track-base-bg' | '--gog-progressbar-track-bg' | '--gog-progressbar-transition-duration' | '--gog-progressbar-value-color' | '--gog-progressbar-value-font-family' | '--gog-progressbar-value-font-size' | '--gog-progressbar-value-gap' | '--gog-progressbar-value-min-width' | '--gog-progressbar-warning-bg' | '--gog-progressbar-warning-buffer-bg' | '--gog-progressbar-xsm-height' | '--gog-radio-bg' | '--gog-radio-border-color' | '--gog-radio-border-style' | '--gog-radio-border-width' | '--gog-radio-box-size' | '--gog-radio-checked-bg' | '--gog-radio-checked-border' | '--gog-radio-disabled-opacity' | '--gog-radio-dot-color' | '--gog-radio-dot-size-ratio' | '--gog-radio-error-color' | '--gog-radio-error-font-size' | '--gog-radio-focus-ring' | '--gog-radio-focus-ring-offset' | '--gog-radio-focus-ring-width' | '--gog-radio-font-family' | '--gog-radio-gap' | '--gog-radio-group-gap' | '--gog-radio-group-label-color' | '--gog-radio-group-label-size' | '--gog-radio-group-option-gap' | '--gog-radio-group-option-gap-horizontal' | '--gog-radio-label-color' | '--gog-radio-label-line-height' | '--gog-radio-label-size' | '--gog-radio-padding' | '--gog-radio-transition-duration' | '--gog-radius' | '--gog-scroll-corner-bg' | '--gog-scroll-fade-duration' | '--gog-scroll-focus-ring' | '--gog-scroll-focus-ring-width' | '--gog-scroll-normal-thumb-min-size' | '--gog-scroll-normal-track-width' | '--gog-scroll-thin-thumb-min-size' | '--gog-scroll-thin-track-width' | '--gog-scroll-thumb-active-bg' | '--gog-scroll-thumb-bg' | '--gog-scroll-thumb-hover-bg' | '--gog-scroll-thumb-inset' | '--gog-scroll-thumb-radius' | '--gog-scroll-track-bg' | '--gog-scroll-track-radius' | '--gog-secondary-color' | '--gog-select-chevron-color' | '--gog-select-chevron-icon-ratio' | '--gog-select-chevron-inset' | '--gog-select-clear-color' | '--gog-select-clear-gap' | '--gog-select-clear-hover-color' | '--gog-select-clear-icon-ratio' | '--gog-select-clear-radius' | '--gog-select-control-font' | '--gog-select-control-gap' | '--gog-select-control-padding-x' | '--gog-select-control-padding-y' | '--gog-select-disabled-opacity' | '--gog-select-error-color' | '--gog-select-error-font-size' | '--gog-select-field-bg' | '--gog-select-field-border' | '--gog-select-field-border-style' | '--gog-select-field-border-width' | '--gog-select-field-color' | '--gog-select-filter-border-color' | '--gog-select-filter-border-style' | '--gog-select-filter-border-width' | '--gog-select-filter-empty-color' | '--gog-select-filter-empty-padding' | '--gog-select-filter-input-bg' | '--gog-select-filter-input-border' | '--gog-select-filter-input-color' | '--gog-select-filter-input-padding-x' | '--gog-select-filter-input-padding-y' | '--gog-select-filter-input-radius' | '--gog-select-filter-padding' | '--gog-select-float-label-in-top' | '--gog-select-float-label-on-bg' | '--gog-select-float-label-over-gap' | '--gog-select-float-label-over-reserve' | '--gog-select-float-label-reserve' | '--gog-select-focus-border' | '--gog-select-focus-glow' | '--gog-select-focus-ring' | '--gog-select-focus-ring-offset' | '--gog-select-focus-ring-width' | '--gog-select-font-family' | '--gog-select-gap' | '--gog-select-label-color' | '--gog-select-label-font-family' | '--gog-select-label-font-size' | '--gog-select-label-letter-spacing' | '--gog-select-label-text-transform' | '--gog-select-mark-icon-ratio' | '--gog-select-mark-size-ratio' | '--gog-select-min-width' | '--gog-select-option-color' | '--gog-select-option-disabled-opacity' | '--gog-select-option-gap' | '--gog-select-option-height' | '--gog-select-option-hover-bg' | '--gog-select-option-selected-color' | '--gog-select-option-transition-duration' | '--gog-select-panel-bg' | '--gog-select-panel-max-height' | '--gog-select-panel-max-width' | '--gog-select-panel-offset' | '--gog-select-panel-shadow' | '--gog-select-placeholder-color' | '--gog-select-radius' | '--gog-select-transition-duration' | '--gog-skeleton-base' | '--gog-skeleton-circle-size-lg' | '--gog-skeleton-circle-size-md' | '--gog-skeleton-circle-size-slg' | '--gog-skeleton-circle-size-sm' | '--gog-skeleton-circle-size-xsm' | '--gog-skeleton-line-gap' | '--gog-skeleton-line-height-lg' | '--gog-skeleton-line-height-md' | '--gog-skeleton-line-height-slg' | '--gog-skeleton-line-height-sm' | '--gog-skeleton-line-height-xsm' | '--gog-skeleton-line-radius' | '--gog-skeleton-pulse-duration' | '--gog-skeleton-pulse-min-opacity' | '--gog-skeleton-radius' | '--gog-skeleton-rect-height-lg' | '--gog-skeleton-rect-height-md' | '--gog-skeleton-rect-height-slg' | '--gog-skeleton-rect-height-sm' | '--gog-skeleton-rect-height-xsm' | '--gog-skeleton-shine' | '--gog-skeleton-short-line-width' | '--gog-skeleton-square-radius' | '--gog-skeleton-wave-duration' | '--gog-slider-auto-width' | '--gog-slider-disabled-opacity' | '--gog-slider-error-color' | '--gog-slider-error-font-family' | '--gog-slider-error-font-size' | '--gog-slider-fill-bg' | '--gog-slider-focus-ring' | '--gog-slider-focus-ring-width' | '--gog-slider-gap' | '--gog-slider-label-color' | '--gog-slider-label-font-family' | '--gog-slider-label-font-size' | '--gog-slider-label-letter-spacing' | '--gog-slider-label-text-transform' | '--gog-slider-range-color' | '--gog-slider-range-font-size' | '--gog-slider-thumb-bg' | '--gog-slider-thumb-border' | '--gog-slider-thumb-border-width' | '--gog-slider-thumb-glow-size' | '--gog-slider-thumb-radius' | '--gog-slider-thumb-shadow' | '--gog-slider-thumb-size' | '--gog-slider-track-area-height' | '--gog-slider-track-bg' | '--gog-slider-track-border-color' | '--gog-slider-track-border-style' | '--gog-slider-track-border-width' | '--gog-slider-track-height' | '--gog-slider-track-radius' | '--gog-slider-value-color' | '--gog-slider-value-font-family' | '--gog-slider-value-font-size' | '--gog-slider-value-min-width' | '--gog-slider-vertical-length' | '--gog-space-2xl' | '--gog-space-lg' | '--gog-space-md' | '--gog-space-sm' | '--gog-space-xs' | '--gog-spinner-arc-inner-color' | '--gog-spinner-arc-inner-dash' | '--gog-spinner-arc-inner-glow' | '--gog-spinner-arc-inner-opacity' | '--gog-spinner-arc-inner-pulse-opacity' | '--gog-spinner-arc-inner-stroke-compact' | '--gog-spinner-arc-outer-color' | '--gog-spinner-arc-outer-dash' | '--gog-spinner-arc-outer-glow' | '--gog-spinner-arc-outer-pulse-opacity' | '--gog-spinner-diamond-color' | '--gog-spinner-diamond-glow' | '--gog-spinner-diamond-opacity' | '--gog-spinner-glow-color' | '--gog-spinner-overlay-bg' | '--gog-spinner-overlay-blur' | '--gog-spinner-overlay-fade-duration' | '--gog-spinner-overlay-z' | '--gog-spinner-pulse-duration' | '--gog-spinner-ring-duration' | '--gog-spinner-ring-glow' | '--gog-spinner-ring-padding' | '--gog-spinner-rune-color' | '--gog-spinner-rune-font-family' | '--gog-spinner-rune-glow' | '--gog-spinner-rune-pulse-opacity' | '--gog-spinner-rune-size' | '--gog-spinner-size-lg' | '--gog-spinner-size-md' | '--gog-spinner-size-slg' | '--gog-spinner-size-sm' | '--gog-spinner-size-xsm' | '--gog-spinner-spin-duration' | '--gog-spinner-spin-slow-duration' | '--gog-spinner-ticks-duration' | '--gog-spinner-track-color' | '--gog-spinner-track-opacity' | '--gog-success-color' | '--gog-surface-color' | '--gog-table-accent-bright' | '--gog-table-accent-color' | '--gog-table-border-color' | '--gog-table-border-style' | '--gog-table-border-width' | '--gog-table-empty-font-size' | '--gog-table-empty-padding' | '--gog-table-focus-ring' | '--gog-table-focus-ring-width' | '--gog-table-font-family' | '--gog-table-footer-gap' | '--gog-table-footer-min-height' | '--gog-table-gap' | '--gog-table-header-font-family' | '--gog-table-header-letter-spacing' | '--gog-table-header-text-transform' | '--gog-table-hover-bg' | '--gog-table-lg-padding-v' | '--gog-table-lg-td-font-size' | '--gog-table-lg-th-font-size' | '--gog-table-loading-opacity' | '--gog-table-loading-padding' | '--gog-table-md-padding-v' | '--gog-table-md-td-font-size' | '--gog-table-md-th-font-size' | '--gog-table-muted-color' | '--gog-table-num-col-width' | '--gog-table-num-font-size' | '--gog-table-numeric-font-family' | '--gog-table-padding-h' | '--gog-table-row-border-width' | '--gog-table-row-transition-duration' | '--gog-table-slg-padding-v' | '--gog-table-slg-td-font-size' | '--gog-table-slg-th-font-size' | '--gog-table-sm-padding-v' | '--gog-table-sm-td-font-size' | '--gog-table-sm-th-font-size' | '--gog-table-sort-icon-opacity' | '--gog-table-sort-icon-size' | '--gog-table-sort-icon-width' | '--gog-table-surface' | '--gog-table-td-font-size' | '--gog-table-td-padding-v' | '--gog-table-text-color' | '--gog-table-th-font-size' | '--gog-table-th-inner-gap' | '--gog-table-th-padding-v' | '--gog-table-total-font-size' | '--gog-table-total-letter-spacing' | '--gog-table-total-text-transform' | '--gog-table-xsm-padding-v' | '--gog-table-xsm-td-font-size' | '--gog-table-xsm-th-font-size' | '--gog-tabs-active-color' | '--gog-tabs-disabled-opacity' | '--gog-tabs-focus-ring-color' | '--gog-tabs-focus-ring-offset' | '--gog-tabs-focus-ring-width' | '--gog-tabs-font-family' | '--gog-tabs-font-weight' | '--gog-tabs-gap' | '--gog-tabs-header-border-color' | '--gog-tabs-header-border-style' | '--gog-tabs-header-border-width' | '--gog-tabs-hover-color' | '--gog-tabs-icon-size' | '--gog-tabs-indicator-color' | '--gog-tabs-indicator-radius' | '--gog-tabs-indicator-thickness' | '--gog-tabs-letter-spacing' | '--gog-tabs-lg-font-size' | '--gog-tabs-lg-padding' | '--gog-tabs-line-height' | '--gog-tabs-md-font-size' | '--gog-tabs-md-padding' | '--gog-tabs-panel-color' | '--gog-tabs-panel-padding' | '--gog-tabs-rest-bg' | '--gog-tabs-rest-color' | '--gog-tabs-slg-font-size' | '--gog-tabs-slg-padding' | '--gog-tabs-sm-font-size' | '--gog-tabs-sm-padding' | '--gog-tabs-tab-bg' | '--gog-tabs-tab-color' | '--gog-tabs-tab-font-size' | '--gog-tabs-tab-gap' | '--gog-tabs-tab-padding' | '--gog-tabs-text-transform' | '--gog-tabs-transition-duration' | '--gog-tabs-xsm-font-size' | '--gog-tabs-xsm-padding' | '--gog-tag-accent' | '--gog-tag-bg' | '--gog-tag-bg-base' | '--gog-tag-bg-mix' | '--gog-tag-border' | '--gog-tag-border-style' | '--gog-tag-border-width' | '--gog-tag-color' | '--gog-tag-color-base' | '--gog-tag-color-mix' | '--gog-tag-danger-color' | '--gog-tag-default-color' | '--gog-tag-font-family' | '--gog-tag-font-size' | '--gog-tag-font-weight' | '--gog-tag-gap' | '--gog-tag-icon-size' | '--gog-tag-info-color' | '--gog-tag-inner-border-width' | '--gog-tag-lg-font-size' | '--gog-tag-lg-gap' | '--gog-tag-lg-icon-size' | '--gog-tag-lg-padding-block' | '--gog-tag-lg-padding-inline' | '--gog-tag-line-height' | '--gog-tag-md-font-size' | '--gog-tag-md-gap' | '--gog-tag-md-icon-size' | '--gog-tag-md-padding-block' | '--gog-tag-md-padding-inline' | '--gog-tag-padding-block' | '--gog-tag-padding-inline' | '--gog-tag-pill-radius' | '--gog-tag-radius' | '--gog-tag-slg-font-size' | '--gog-tag-slg-gap' | '--gog-tag-slg-icon-size' | '--gog-tag-slg-padding-block' | '--gog-tag-slg-padding-inline' | '--gog-tag-sm-font-size' | '--gog-tag-sm-gap' | '--gog-tag-sm-icon-size' | '--gog-tag-sm-padding-block' | '--gog-tag-sm-padding-inline' | '--gog-tag-success-color' | '--gog-tag-warning-color' | '--gog-tag-xsm-font-size' | '--gog-tag-xsm-gap' | '--gog-tag-xsm-icon-size' | '--gog-tag-xsm-padding-block' | '--gog-tag-xsm-padding-inline' | '--gog-text-2xl' | '--gog-text-3xl' | '--gog-text-color' | '--gog-text-lg' | '--gog-text-md' | '--gog-text-sm' | '--gog-text-xl' | '--gog-text-xs' | '--gog-textarea-clear-icon-ratio' | '--gog-textarea-scrollbar-width' | '--gog-toast-accent-width' | '--gog-toast-action-font-size' | '--gog-toast-action-padding' | '--gog-toast-actions-gap' | '--gog-toast-base-z' | '--gog-toast-bg' | '--gog-toast-border' | '--gog-toast-close-font-size' | '--gog-toast-close-padding' | '--gog-toast-color' | '--gog-toast-content-gap' | '--gog-toast-enter-distance' | '--gog-toast-error-color' | '--gog-toast-font-family' | '--gog-toast-gap' | '--gog-toast-icon-color' | '--gog-toast-icon-line-height' | '--gog-toast-icon-size' | '--gog-toast-info-color' | '--gog-toast-main-gap' | '--gog-toast-max-width' | '--gog-toast-message-font-size' | '--gog-toast-message-line-height' | '--gog-toast-min-width' | '--gog-toast-padding' | '--gog-toast-progress-height' | '--gog-toast-progress-opacity' | '--gog-toast-radius' | '--gog-toast-shadow' | '--gog-toast-stack-expanded-gap' | '--gog-toast-stack-max-depth' | '--gog-toast-stack-min-opacity' | '--gog-toast-stack-opacity-step' | '--gog-toast-stack-padding' | '--gog-toast-stack-peek' | '--gog-toast-stack-scale-step' | '--gog-toast-success-color' | '--gog-toast-transition-duration' | '--gog-toast-warning-color' | '--gog-toast-z-index' | '--gog-toggle-border-color' | '--gog-toggle-border-style' | '--gog-toggle-border-width' | '--gog-toggle-disabled-opacity' | '--gog-toggle-focus-ring-color' | '--gog-toggle-focus-ring-offset' | '--gog-toggle-focus-ring-width' | '--gog-toggle-font-family' | '--gog-toggle-gap' | '--gog-toggle-label-color' | '--gog-toggle-label-line-height' | '--gog-toggle-lg-label-size' | '--gog-toggle-lg-state-font-size' | '--gog-toggle-lg-thumb-size' | '--gog-toggle-lg-track-height' | '--gog-toggle-lg-track-width' | '--gog-toggle-md-label-size' | '--gog-toggle-md-state-font-size' | '--gog-toggle-md-thumb-size' | '--gog-toggle-md-track-height' | '--gog-toggle-md-track-width' | '--gog-toggle-on-border-color' | '--gog-toggle-padding' | '--gog-toggle-radius' | '--gog-toggle-slg-label-size' | '--gog-toggle-slg-state-font-size' | '--gog-toggle-slg-thumb-size' | '--gog-toggle-slg-track-height' | '--gog-toggle-slg-track-width' | '--gog-toggle-sm-label-size' | '--gog-toggle-sm-state-font-size' | '--gog-toggle-sm-thumb-size' | '--gog-toggle-sm-track-height' | '--gog-toggle-sm-track-width' | '--gog-toggle-state-color' | '--gog-toggle-state-font-weight' | '--gog-toggle-state-letter-spacing' | '--gog-toggle-state-offset' | '--gog-toggle-state-padding-inline' | '--gog-toggle-state-thumb-gap' | '--gog-toggle-thumb-bg' | '--gog-toggle-thumb-inset' | '--gog-toggle-thumb-off-bg' | '--gog-toggle-thumb-on-bg' | '--gog-toggle-thumb-shadow' | '--gog-toggle-track-bg' | '--gog-toggle-track-off-bg' | '--gog-toggle-track-on-bg' | '--gog-toggle-transition-duration' | '--gog-toggle-xsm-label-size' | '--gog-toggle-xsm-state-font-size' | '--gog-toggle-xsm-thumb-size' | '--gog-toggle-xsm-track-height' | '--gog-toggle-xsm-track-width' | '--gog-tooltip-arrow-size' | '--gog-tooltip-bg' | '--gog-tooltip-border-color' | '--gog-tooltip-border-style' | '--gog-tooltip-border-width' | '--gog-tooltip-color' | '--gog-tooltip-font-family' | '--gog-tooltip-font-size' | '--gog-tooltip-gap' | '--gog-tooltip-line-height' | '--gog-tooltip-max-height' | '--gog-tooltip-max-width' | '--gog-tooltip-padding' | '--gog-tooltip-radius' | '--gog-tooltip-shadow' | '--gog-tooltip-transition-duration' | '--gog-tooltip-z' | '--gog-warning-color';
|
|
3393
|
+
/** Which of the three layers a token belongs to — see the README's theming section. */
|
|
3394
|
+
type GogTokenLayer = 'foundation' | 'component' | 'instance';
|
|
3395
|
+
interface GogTokenGroup {
|
|
3396
|
+
/** The `── Section ──` heading the token sits under in theme.css. */
|
|
3397
|
+
readonly section: string;
|
|
3398
|
+
readonly layer: GogTokenLayer;
|
|
3399
|
+
readonly tokens: readonly GogTokenName[];
|
|
3400
|
+
}
|
|
3401
|
+
/**
|
|
3402
|
+
* The token catalogue, grouped as theme.css groups it. Exported so a theme editor or docs page
|
|
3403
|
+
* can enumerate the real tokens instead of keeping a hand-copied list that drifts.
|
|
3404
|
+
*/
|
|
3405
|
+
declare const GOG_TOKEN_GROUPS: readonly GogTokenGroup[];
|
|
3406
|
+
|
|
3407
|
+
type GogTooltipSide = 'top' | 'bottom' | 'left' | 'right';
|
|
1315
3408
|
|
|
1316
|
-
export { AccordionComponent, ButtonComponent, CheckboxComponent, ChipComponent, CollapsibleComponent, Column, ConfirmationDialogComponent, DIALOG_DATA, DIALOG_REF, DialogComponent, DialogService, GOG_CONFIG, GogAccordionChevronDirective, GogAccordionContentDirective, GogAccordionHeaderDirective, GogCollapsibleContentDirective, GogCollapsibleTriggerDirective, GogDropdownBase, ICON_DEFS, IconComponent, InputfieldComponent, MultiselectComponent, PaginatorComponent, ScrollComponent, SelectComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SpinnerOverlayComponent, TableComponent, TagComponent, TemplateDirective, TextareaComponent, ThemeService, ToastComponent, ToastContainerComponent, ToastService, defaultCompare, provideGogConfig };
|
|
1317
|
-
export type { ConfirmDialogData, DialogConfig, DialogHandle, DialogRef, GogAccordionChevronContext, GogAccordionHeaderContext, GogAccordionItem, GogAccordionToggleEvent, GogDropdownDirection, GogDropdownOption, GogGlobalConfig, GogIconName, GogMultiselectOption, GogPaginatorRangeMode, GogScrollAxis, GogScrollMetrics, GogScrollOverscrollBehavior, GogScrollSize, GogSelectOption, GogSize, GogSkeletonAnimation, GogSkeletonShape, GogSpinnerVariant, GogTableBodyContext, GogTableHeaderContext, GogTagShape, GogTagVariant, GogVariant, OpenDialog, SortDirection, Toast, ToastAction, ToastConfig, ToastPosition, ToastType };
|
|
3409
|
+
export { AccordionComponent, AutocompleteComponent, ButtonComponent, ButtonToggleGroupComponent, CalendarComponent, CheckboxComponent, ChipComponent, CollapsibleComponent, Column, ConfirmationDialogComponent, DIALOG_DATA, DIALOG_REF, DatepickerComponent, DialogComponent, DialogService, DividerComponent, GOG_CONFIG, GOG_TABS_STATE, GOG_TOKEN_GROUPS, GogAccordionChevronDirective, GogAccordionContentDirective, GogAccordionHeaderDirective, GogBadgeDirective, GogButtonToggleOptionDirective, GogCheckboxIconDirective, GogCollapsibleContentDirective, GogCollapsibleTriggerDirective, GogColumn, GogColumnBodyDirective, GogColumnHeaderDirective, GogDropdownBase, GogDropdownChevronDirective, GogDropdownOptionDirective, GogFloatLabelState, GogInputAddonEndDirective, GogInputAddonStartDirective, GogMultiselectClearIconDirective, GogTabContentDirective, GogTabHeaderDirective, GogTagIconDirective, GogTooltipDirective, ICON_DEFS, IconComponent, InputfieldComponent, MultiselectComponent, PaginatorComponent, ProgressbarComponent, RadioGroupComponent, ScrollComponent, SelectComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SpinnerOverlayComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TemplateDirective, TextareaComponent, ThemeService, ToastComponent, ToastContainerComponent, ToastService, ToggleComponent, addDays, addMonths, addYears, buildMonthGrid, clampDate, copyTimeOnto, daysInMonth, defaultCompare, formatDate, getByPath, isAfterDay, isBeforeDay, isInRange, isSameDay, isSameMonth, isSameOptionValue, isWithinBounds, localeFirstDayOfWeek, monthNames, parseDate, provideGogConfig, readOption, resolveConfigured, startOfDay, weekdayNames, withTime };
|
|
3410
|
+
export type { ConfirmDialogData, DialogConfig, DialogHandle, DialogRef, GogAccordionChevronContext, GogAccordionHeaderContext, GogAccordionItem, GogAccordionToggleEvent, GogBadgePosition, GogButtonToggleAppearance, GogButtonToggleOptionContext, GogCalendarDay, GogColumnBodyContext, GogColumnHeaderContext, GogDateRange, GogDateSelectionMode, GogDatepickerValue, GogDividerVariant, GogDropdownDirection, GogDropdownFilterPosition, GogDropdownOption, GogDropdownOptionContext, GogFloatLabelVariant, GogGlobalConfig, GogHourFormat, GogIconName, GogMultiselectOption, GogOptionAccessor, GogOrientation, GogPaginatorRangeMode, GogProgressbarMode, GogProgressbarVariant, GogRadioOption, GogScrollAxis, GogScrollMetrics, GogScrollOverscrollBehavior, GogScrollSize, GogSelectOption, GogSize, GogSkeletonAnimation, GogSkeletonShape, GogSliderOrientation, GogSpinnerVariant, GogTabHeaderContext, GogTableBodyContext, GogTableHeaderContext, GogTabsAlign, GogTabsState, GogTagShape, GogTagVariant, GogTextareaResize, GogTokenGroup, GogTokenLayer, GogTokenName, GogTooltipPosition, GogTooltipSide, GogVariant, OpenDialog, SortDirection, Toast, ToastAction, ToastConfig, ToastPosition, ToastType };
|