@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.
@@ -1,17 +1,24 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { TemplateRef, Type, Injector, InjectionToken, OnDestroy, DoCheck, Signal, ModelSignal, ElementRef, Provider } from '@angular/core';
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: _angular_core.InputSignal<GogSize>;
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<4 | 3 | 2 | 5 | 6 | undefined>;
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
- declare class CheckboxComponent implements ControlValueAccessor {
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
- readonly size: _angular_core.InputSignal<GogSize>;
209
- readonly indeterminate: _angular_core.InputSignal<boolean>;
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
- readonly checkIconTemplate: _angular_core.InputSignal<TemplateRef<unknown> | null>;
213
- /**
214
- * Two-way bindable checked state: `[(checked)]="signal"`.
215
- * This is the same state Angular Forms drives via `writeValue`/`registerOnChange`
216
- * when the component is used with `formControlName`/`[formControl]`.
217
- * Don't wire both a form directive AND `[(checked)]` to the same instance —
218
- * pick one, otherwise you end up with two competing sources of truth.
219
- */
220
- readonly checked: _angular_core.ModelSignal<boolean>;
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 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)">;
246
- private readonly ngControl;
247
- private readonly cvaDisabled;
248
- protected readonly isDisabled: _angular_core.Signal<boolean>;
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: boolean): void;
251
- registerOnChange(fn: (val: boolean) => void): void;
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
- onInputChange(event: Event): void;
255
- onBlur(): void;
256
- private onCheckedChange;
257
- private onTouched;
258
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
259
- 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"; }, never, never, true, never>;
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
- * `'manual'` (default): the field shows `errorMessage` for as long as it is non-empty — the
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
- * `'auto'`: shown once the attached form control has been touched and is invalid — the
482
- * consumer only supplies the message text, not the timing. Requires a
483
- * `[formControl]` / `formControlName` on the element; without one this falls back to
484
- * `'manual'`, since there is no control state to key off.
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
- type GogErrorDisplay = 'auto' | 'manual';
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
- /** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
502
- readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
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
- readonly size: _angular_core.InputSignal<GogSize>;
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
- /** Custom leading icon template. */
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
- /** Custom trailing icon template. */
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
- /** When provided, the start icon becomes a clickable button invoking this fn */
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
- /** When provided, the end icon becomes a clickable button invoking this fn */
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
- /** aria-label for the start icon button (required when iconStartFn is set) */
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
- /** aria-label for the end icon button (required when iconEndFn is set) */
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"; }, never, never, true, never>;
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
- /** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
579
- readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
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
- readonly size: _angular_core.InputSignal<GogSize>;
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
- * Full width of the container by default, matching every other field-style control.
588
- * Set to `false` to shrink the field to fit its content instead.
589
- */
590
- readonly fullWidth: _angular_core.InputSignal<boolean>;
591
- /** Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`. */
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
- protected readonly optionGapToken: string;
728
- protected readonly optionsPaddingToken: string;
729
- /** Keep in sync with the real `max-height` on the subclass's `__dropdown` block. */
730
- protected readonly panelMaxHeightToken: string;
731
- /** Estimated row height fed into the placement math; not a real layout property. */
732
- protected readonly optionHeightToken: string;
733
- /** Unique per-instance suffix, so several dropdowns on a page can't collide on DOM ids. */
734
- protected readonly uid: number;
735
- protected readonly elRef: ElementRef<any>;
736
- protected readonly isBrowser: boolean;
737
- private readonly document;
738
- private readonly appRef;
739
- private readonly destroyRef;
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 overlay;
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
- protected readonly isDisabled: Signal<boolean>;
745
- protected readonly dropdownDirectionState: _angular_core.WritableSignal<"up" | "down">;
746
- protected readonly panelPlacement: _angular_core.WritableSignal<GogDropdownPlacement | null>;
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
- * Stacking order to write onto the panel, or null to leave it to the stylesheet.
2350
+ * Width of the textarea's own scrollbar, published so the clear button can clear it.
749
2351
  *
750
- * Only needed when appending to `<body>`: an inline panel inherits `--gog-dropdown-z` from
751
- * its surroundings which is how a dropdown inside a dialog ends up above the dialog —
752
- * but an appended one sits outside that subtree and inherits nothing, so the value has
753
- * to be resolved from the trigger and written out explicitly.
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 panelZIndex: _angular_core.WritableSignal<number | null>;
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
- * Binds the click-outside and reposition listeners only for as long as the panel is
773
- * open. Bound permanently as host listeners were every dropdown on the page runs a
774
- * handler on every document click and every scroll frame, whether or not it is showing
775
- * anything.
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
- private bindWhileOpen;
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: TValue | null): void;
780
- registerOnChange(fn: (val: TValue) => void): void;
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
- protected toggle(): void;
784
- protected open(): void;
785
- protected close(): void;
786
- /** Writes a new selection out to both the model and the attached form control. */
787
- protected commitValue(next: TValue): void;
788
- protected markTouched(): void;
789
- private closeIfClickedOutside;
790
- /**
791
- * Coalesces bursts of scroll/resize events into one reposition per frame. Placement
792
- * reads layout, so running it per event is what makes a scroll janky.
793
- */
794
- private scheduleReposition;
795
- /** Jumps from the trigger into the option list on ArrowDown/ArrowUp while open. */
796
- protected onTriggerArrowKeydown(event: Event): void;
797
- protected onOptionKeydown(event: KeyboardEvent): void;
798
- protected focusTrigger(): void;
799
- /** Extra chrome stacked above the options (e.g. a select-all row), in px. */
800
- protected extraPanelHeight(): number;
801
- private enabledOptionElements;
802
- private attachOverlay;
803
- /**
804
- * Reads the spacing tokens that feed the height estimate. Done once per open instead of
805
- * on every scroll tick, because `getComputedStyle` forces a style recalculation and the
806
- * tokens cannot change while the panel is on screen.
807
- */
808
- private refreshPanelMetrics;
809
- /**
810
- * Rough height, used only to choose up/down and to cap `max-height` before the panel
811
- * has been laid out. Deliberately an estimate: measuring would require rendering the
812
- * panel first, which is what we are trying to position. A resolvable `dropdownMaxHeight`
813
- * replaces the row-count guess outright, since it is exact rather than estimated.
814
- */
815
- private estimatePanelHeight;
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
- * The trigger's own rect, not the whole component's a label above it or an error
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
- private triggerRect;
823
- /** The stacking order the panel would have had if it were still inside the subtree. */
824
- private resolvePanelZIndex;
825
- private updatePlacement;
826
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogDropdownBase<any>, never>;
827
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogDropdownBase<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; }; "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; }; }, {}, never, never, true, never>;
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
- /** @deprecated Prefer `GogDropdownOption`; kept as an alias so existing imports keep working. */
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 extends GogDropdownBase<string | number | null> {
2457
+ declare class SelectComponent<TOption = GogDropdownOption, TValue = string | number | null> extends GogDropdownBase<TValue, TOption> {
833
2458
  readonly inputId: _angular_core.InputSignal<string>;
834
- /** Two-way bindable selected value: `[(value)]="signal"`. */
835
- readonly value: _angular_core.ModelSignal<string | number | null>;
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
- protected readonly emptyValue: null;
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<GogDropdownOption | null>;
848
- protected isSelected(id: string | number): boolean;
849
- protected selectOption(option: GogDropdownOption, event: MouseEvent): void;
850
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
851
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "gog-select", never, { "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
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
- /** @deprecated Prefer `GogDropdownOption`; kept as an alias so existing imports keep working. */
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
- declare class MultiselectComponent extends GogDropdownBase<(string | number)[]> {
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
- /** Two-way bindable selected ids: `[(value)]="signal"`. */
862
- readonly value: _angular_core.ModelSignal<(string | number)[]>;
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: (string | number)[];
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
- protected isSelected(id: string | number): boolean;
875
- protected toggleOption(option: GogDropdownOption, event: MouseEvent): void;
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"; }, never, never, true, never>;
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
- readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
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
- declare class Column {
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
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<Column, never>;
1146
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<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; }; }, {}, never, never, true, never>;
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 <ng-template> inside <gog-table> with a field name and optional type.
2935
+ * Marks a `<ng-template>` inside `<gog-table>` with a field name and optional type:
1158
2936
  *
1159
- * Usage:
1160
- * <ng-template template="status" type="body" let-row>...</ng-template>
1161
- * <ng-template template="status" type="header">...</ng-template>
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<"center" | "left" | "right">;
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 Column[]>;
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
- getBodyTemplate(field: string): TemplateRef<unknown> | null;
1218
- getHeaderTemplate(field: string): TemplateRef<unknown> | null;
1219
- toggleSort(col: Column): void;
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: Column): void;
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<"center" | "left" | "right">;
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 (a route, a single component's own
1310
- * `providers`) replaces the whole object for that subtree rather than merging with the
1311
- * parent's pass everything you want in effect there, not just the one field you're
1312
- * changing.
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 };