@guildofgleks/ui 21.2.3 → 21.2.4

package/types/guildofgleks-ui.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, Type, Injector, InjectionToken, OnDestroy, DoCheck, Signal, ModelSignal, ElementRef } from '@angular/core';
+import { TemplateRef, Type, Injector, InjectionToken, OnDestroy, DoCheck, Signal, ModelSignal, ElementRef, Provider } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as _angular_platform_browser from '@angular/platform-browser';
 import * as _guildofgleks_ui from '@guildofgleks/ui';
@@ -12,6 +12,20 @@ type GogTagShape = 'rounded' | 'pill';
 type GogSkeletonShape = 'text' | 'circle' | 'rect';
 type GogSkeletonAnimation = 'pulse' | 'wave' | 'none';
 type GogPaginatorRangeMode = 'window' | 'ellipsis';
+type GogScrollAxis = 'vertical' | 'horizontal' | 'both';
+type GogScrollSize = 'normal' | 'thin';
+/**
+ * Mirrors the CSS `overscroll-behavior` value space directly:
+ * - `'auto'` — scrolling past this instance's edge chains to the next scrollable ancestor
+ *   (a page, a dialog body, another gog-scroll), the same as an un-customized native
+ *   `overflow: auto` div. The default — matches what most embedded content expects.
+ * - `'contain'` — scrolling stops dead at this instance's edge; nothing behind it moves.
+ *   Suited to overlay-style panels (a dropdown, a modal) where scrolling past the end
+ *   shouldn't also scroll whatever is behind them.
+ * - `'none'` — like `'contain'`, and additionally suppresses the platform's own overscroll
+ *   affordances (rubber-banding, pull-to-refresh) for this instance.
+ */
+type GogScrollOverscrollBehavior = 'auto' | 'contain' | 'none';
 
 declare class ButtonComponent {
     variant: _angular_core.InputSignal<GogVariant>;
@@ -25,8 +39,9 @@ declare class ButtonComponent {
      * guard, not a delay before the first click fires: the first click in a
      * window is emitted immediately (leading edge), and any further clicks
      * within `debounce` ms are silently dropped until the window elapses.
+     * Unset, falls back to `GOG_CONFIG.button.debounce`, then to `300`.
      */
-    debounce: _angular_core.InputSignal<number>;
+    debounce: _angular_core.InputSignal<number | undefined>;
     /**
      * Accessible name for the button, forwarded to the native <button>.
      * Setting `aria-label` directly on <gog-button> in a template does NOT
@@ -42,6 +57,8 @@ declare class ButtonComponent {
     protected isDisabled: _angular_core.Signal<boolean>;
     private static readonly SPINNER_SIZE_BY_BUTTON_SIZE;
     protected spinnerSize: _angular_core.Signal<GogSize>;
+    private readonly globalConfig;
+    protected readonly resolvedDebounce: _angular_core.Signal<number>;
     private readonly destroyRef;
     private readonly click$;
     constructor();
@@ -144,6 +161,47 @@ declare class AccordionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionComponent, "gog-accordion", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "expandFirst": { "alias": "expandFirst"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "skeletonCount": { "alias": "skeletonCount"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; "openIds": { "alias": "openIds"; "required": false; "isSignal": true; }; }, { "openIds": "openIdsChange"; "gogToggle": "gogToggle"; }, ["headerTpl", "chevronTpl", "contentTpl"], never, true, never>;
 }
 
+/**
+ * Headless expand/collapse primitive — a trigger toggles a content region open and
+ * closed, in place (no portal/overlay, unlike `gog-select`/`gog-multiselect`). Unopinionated
+ * about markup: project any element as the trigger via `gogCollapsibleTrigger` and any
+ * element as the content via `gogCollapsibleContent`; this component only holds the shared
+ * `open` state and generates the id pair linking them for ARIA.
+ */
+declare class CollapsibleComponent {
+    private static nextUid;
+    /** Two-way bindable open state: `[(open)]="signal"`. */
+    readonly open: _angular_core.ModelSignal<boolean>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    private readonly uid;
+    readonly contentId: _angular_core.Signal<string>;
+    toggle(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CollapsibleComponent, never>;
+    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>;
+}
+
+/**
+ * Marks the element that toggles a `gog-collapsible`. Works on any clickable element
+ * (`<button>`, `<a>`, ...) — this only wires the click handler and the ARIA attributes
+ * pointing at the matching `gogCollapsibleContent`; it owns no markup of its own.
+ */
+declare class GogCollapsibleTriggerDirective {
+    protected readonly collapsible: CollapsibleComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogCollapsibleTriggerDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogCollapsibleTriggerDirective, "[gogCollapsibleTrigger]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Marks the element that a `gog-collapsible` shows and hides. Applies the open/closed
+ * CSS state and the ARIA wiring (`id`, `aria-hidden`, `inert`) to whatever element this is
+ * placed on — that element owns its own content and layout.
+ */
+declare class GogCollapsibleContentDirective {
+    protected readonly collapsible: CollapsibleComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GogCollapsibleContentDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GogCollapsibleContentDirective, "[gogCollapsibleContent]", never, {}, {}, never, never, true, never>;
+}
+
 declare class CheckboxComponent implements ControlValueAccessor {
     readonly label: _angular_core.InputSignal<string>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
@@ -155,7 +213,7 @@ declare class CheckboxComponent implements ControlValueAccessor {
     /**
      * Two-way bindable checked state: `[(checked)]="signal"`.
      * This is the same state Angular Forms drives via `writeValue`/`registerOnChange`
-     * when the component is used with `formControlName`/`[formControl]`/`ngModel`.
+     * when the component is used with `formControlName`/`[formControl]`.
      * Don't wire both a form directive AND `[(checked)]` to the same instance —
      * pick one, otherwise you end up with two competing sources of truth.
      */
@@ -185,8 +243,10 @@ declare class CheckboxComponent implements ControlValueAccessor {
     protected readonly checkboxPadding = "var(--gog-control-checkbox-padding, 6px)";
     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)">;
     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)">;
+    private readonly ngControl;
     private readonly cvaDisabled;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
+    constructor();
     writeValue(val: boolean): void;
     registerOnChange(fn: (val: boolean) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -420,17 +480,23 @@ declare class ToastContainerComponent {
  *
  * `'auto'`: shown once the attached form control has been touched and is invalid — the
  * consumer only supplies the message text, not the timing. Requires a
- * `[formControl]` / `formControlName` / `ngModel` on the element; without one this falls
- * back to `'manual'`, since there is no control state to key off.
+ * `[formControl]` / `formControlName` on the element; without one this falls back to
+ * `'manual'`, since there is no control state to key off.
  */
 type GogErrorDisplay = 'auto' | 'manual';
 
 declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
     readonly label: _angular_core.InputSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
-    readonly type: _angular_core.InputSignal<"text" | "password" | "email">;
+    readonly type: _angular_core.InputSignal<"number" | "text" | "password" | "email" | "date">;
     /** Defaults to 'current-password' for password fields, 'off' otherwise */
     readonly autocomplete: _angular_core.InputSignal<string>;
+    /** Only applied when `type="number"`. */
+    readonly min: _angular_core.InputSignal<number | null>;
+    /** Only applied when `type="number"`. */
+    readonly max: _angular_core.InputSignal<number | null>;
+    /** Only applied when `type="number"`. */
+    readonly step: _angular_core.InputSignal<number | null>;
     readonly errorMessage: _angular_core.InputSignal<string>;
     /** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
     readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
@@ -463,7 +529,12 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
     readonly showPasswordLabel: _angular_core.InputSignal<string>;
     /** aria-label for the hide-password button, shown once the password is revealed */
     readonly hidePasswordLabel: _angular_core.InputSignal<string>;
-    /** Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`. */
+    /**
+     * Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`.
+     * Always a string, including for `type="number"` — that field's `formControl`/
+     * `formControlName` value is a `number` (or `null` when empty); the string here is only
+     * the raw text shown in the native input.
+     */
     readonly value: _angular_core.ModelSignal<string>;
     private readonly ngControl;
     private readonly cvaDisabled;
@@ -471,7 +542,8 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
     private readonly passwordVisible;
     protected readonly isDisabled: _angular_core.Signal<boolean>;
     protected readonly isPasswordField: _angular_core.Signal<boolean>;
-    protected readonly effectiveType: _angular_core.Signal<"text" | "password" | "email">;
+    protected readonly isNumberField: _angular_core.Signal<boolean>;
+    protected readonly effectiveType: _angular_core.Signal<"number" | "text" | "password" | "email" | "date">;
     protected readonly effectiveAutocomplete: _angular_core.Signal<string>;
     protected readonly hasError: _angular_core.Signal<boolean>;
     protected readonly visibleError: _angular_core.Signal<string>;
@@ -482,12 +554,13 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
     protected readonly effectiveIconEndLabel: _angular_core.Signal<string>;
     protected readonly hasIconEnd: _angular_core.Signal<boolean>;
     protected readonly hasIconEndAction: _angular_core.Signal<boolean>;
+    /** `number` for a `type="number"` field (`null` when empty), `string` otherwise. */
     private _onChange;
     private _onTouched;
     constructor();
     ngDoCheck(): void;
-    writeValue(val: string): void;
-    registerOnChange(fn: (val: string) => void): void;
+    writeValue(val: string | number | null): void;
+    registerOnChange(fn: (val: string | number | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     protected onIconStartClick(): void;
@@ -495,7 +568,46 @@ declare class InputfieldComponent implements ControlValueAccessor, DoCheck {
     onInput(event: Event): void;
     onBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputfieldComponent, never>;
-    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; }; "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>;
+    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>;
+}
+
+declare class TextareaComponent implements ControlValueAccessor, DoCheck {
+    readonly label: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly errorMessage: _angular_core.InputSignal<string>;
+    /** See `GogErrorDisplay`. Defaults to `'manual'`, matching every other control in the library. */
+    readonly errorDisplay: _angular_core.InputSignal<GogErrorDisplay>;
+    readonly name: _angular_core.InputSignal<string>;
+    readonly inputId: _angular_core.InputSignal<string>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly size: _angular_core.InputSignal<GogSize>;
+    /** Native `rows` attribute, controlling the field's initial height. */
+    readonly rows: _angular_core.InputSignal<number>;
+    /**
+     * Full width of the container by default, matching every other field-style control.
+     * Set to `false` to shrink the field to fit its content instead.
+     */
+    readonly fullWidth: _angular_core.InputSignal<boolean>;
+    /** Two-way bindable value: `[(value)]="signal"` or `[value]` / `(valueChange)`. */
+    readonly value: _angular_core.ModelSignal<string>;
+    private readonly ngControl;
+    private readonly cvaDisabled;
+    private readonly errorState;
+    protected readonly isDisabled: _angular_core.Signal<boolean>;
+    protected readonly hasError: _angular_core.Signal<boolean>;
+    protected readonly visibleError: _angular_core.Signal<string>;
+    private _onChange;
+    private _onTouched;
+    constructor();
+    ngDoCheck(): void;
+    writeValue(val: string): void;
+    registerOnChange(fn: (val: string) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    onInput(event: Event): void;
+    onBlur(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
+    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>;
 }
 
 declare class ChipComponent {
@@ -876,6 +988,136 @@ declare class PaginatorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginatorComponent, "gog-paginator", never, { "page": { "alias": "page"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "totalPages": { "alias": "totalPages"; "required": false; "isSignal": true; }; "rangeMode": { "alias": "rangeMode"; "required": false; "isSignal": true; }; "visiblePages": { "alias": "visiblePages"; "required": false; "isSignal": true; }; "showFirstPage": { "alias": "showFirstPage"; "required": false; "isSignal": true; }; "showLastPage": { "alias": "showLastPage"; "required": false; "isSignal": true; }; "siblingCount": { "alias": "siblingCount"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; }, never, never, true, never>;
 }
 
+/** Snapshot of the viewport's native scroll geometry, emitted on every scroll/resize. */
+interface GogScrollMetrics {
+    scrollTop: number;
+    scrollLeft: number;
+    scrollHeight: number;
+    scrollWidth: number;
+    clientHeight: number;
+    clientWidth: number;
+}
+type GogScrollDirection = 'vertical' | 'horizontal';
+/**
+ * Drop-in replacement for a native `overflow: auto` region: the content still scrolls
+ * natively (wheel, touch, keyboard, focus-into-view all keep working unmodified), only the
+ * browser's own scrollbar chrome is hidden and replaced with a themeable, draggable
+ * overlay thumb built from plain pointer events + `ResizeObserver` — no CDK involved, to
+ * stay consistent with the rest of this library's hand-rolled overlay/positioning code.
+ */
+declare class ScrollComponent {
+    /** Which axes get an overlay thumb. Native scrolling on the other axis is unaffected. */
+    readonly axis: _angular_core.InputSignal<GogScrollAxis>;
+    /** Unset, falls back to `GOG_CONFIG.scroll.size`, then to `'normal'`. */
+    readonly size: _angular_core.InputSignal<GogScrollSize | undefined>;
+    /**
+     * Fades the thumb out after `hideDelay` ms of inactivity; false keeps it always visible.
+     * Unset, falls back to `GOG_CONFIG.scroll.autoHide`, then to `true`.
+     */
+    readonly autoHide: _angular_core.InputSignal<boolean | undefined>;
+    /** Unset, falls back to `GOG_CONFIG.scroll.hideDelay`, then to `800`. */
+    readonly hideDelay: _angular_core.InputSignal<number | undefined>;
+    /** Pixel distance from an edge that still counts as "reached" for gogReachStart/End. */
+    readonly reachThreshold: _angular_core.InputSignal<number>;
+    /**
+     * Renders the viewport as its own tab stop (`tabindex="0"`, `role="region"`) per the
+     * WAI-ARIA scrollable-region pattern. Turn off when nesting inside a component that
+     * already owns focus/keyboard handling (a listbox panel, a dialog body) so this doesn't
+     * add a redundant stop — the descendants' own focus still auto-scrolls into view either way.
+     */
+    readonly focusable: _angular_core.InputSignal<boolean>;
+    /** Accessible name for the viewport when `focusable` is true and there is no visible label. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /**
+     * What happens when a scroll gesture reaches this instance's edge. Unset, falls back to
+     * `GOG_CONFIG.scroll.overscrollBehavior`, then to `'auto'`. See `GogScrollOverscrollBehavior`
+     * for what each value does.
+     */
+    readonly overscrollBehavior: _angular_core.InputSignal<GogScrollOverscrollBehavior | undefined>;
+    readonly gogScroll: _angular_core.OutputEmitterRef<GogScrollMetrics>;
+    readonly gogReachStart: _angular_core.OutputEmitterRef<GogScrollDirection>;
+    readonly gogReachEnd: _angular_core.OutputEmitterRef<GogScrollDirection>;
+    protected readonly viewportRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
+    protected readonly contentRef: _angular_core.Signal<ElementRef<HTMLDivElement>>;
+    protected readonly showTrackV: _angular_core.WritableSignal<boolean>;
+    protected readonly showTrackH: _angular_core.WritableSignal<boolean>;
+    /**
+     * Flips true once the first real measurement has run. Before that (SSR, or the client
+     * frame before hydration/afterNextRender fires), an allowed axis defaults to `auto` — the
+     * same safe, always-clips behavior this component had before viewportOverflowY/X existed —
+     * rather than guessing `visible` from a `showTrackV`/`H` that just hasn't been measured yet.
+     */
+    private readonly measured;
+    /**
+     * `overflow-y`/`overflow-x` on the viewport, driven by measured overflow rather than a
+     * static `axis`-only class. Any axis that isn't *currently, actually* scrolling — because
+     * it's disabled by `axis`, or because it's allowed but the content doesn't overflow it —
+     * gets `visible`, never `hidden`/`auto`. A non-`visible` overflow value makes the viewport
+     * a "scroll container" per spec regardless of whether it has anything to scroll, which
+     * becomes the containing block for `position: sticky` descendants (e.g. gog-table's sticky
+     * header) and a scroll-chaining boundary for wheel input. Left non-visible on a disabled or
+     * unneeded axis, an instance nested inside another scroller — axis="horizontal" wrapping a
+     * table that fits, itself inside a taller outer gog-scroll — would silently swallow the
+     * outer axis's wheel scroll and break its sticky headers, even though this instance itself
+     * never visibly scrolls that axis. `visible` whenever the axis is inert avoids both.
+     */
+    protected readonly viewportOverflowY: _angular_core.Signal<"auto" | "visible">;
+    protected readonly viewportOverflowX: _angular_core.Signal<"auto" | "visible">;
+    /** App/subtree-wide fallbacks for the inputs above that don't set their own value. */
+    private readonly globalConfig;
+    protected readonly resolvedSize: _angular_core.Signal<GogScrollSize>;
+    protected readonly resolvedAutoHide: _angular_core.Signal<boolean>;
+    protected readonly resolvedHideDelay: _angular_core.Signal<number>;
+    protected readonly resolvedOverscrollBehavior: _angular_core.Signal<GogScrollOverscrollBehavior>;
+    /**
+     * Only applies `resolvedOverscrollBehavior` on an axis that's actually acting as a scroll
+     * container — on an axis that's `visible` (see viewportOverflowY/X above) there is no
+     * scroll boundary on it to contain in the first place.
+     */
+    protected readonly viewportOverscrollY: _angular_core.Signal<GogScrollOverscrollBehavior>;
+    protected readonly viewportOverscrollX: _angular_core.Signal<GogScrollOverscrollBehavior>;
+    protected readonly thumbSizeV: _angular_core.WritableSignal<number>;
+    protected readonly thumbPosV: _angular_core.WritableSignal<number>;
+    protected readonly thumbSizeH: _angular_core.WritableSignal<number>;
+    protected readonly thumbPosH: _angular_core.WritableSignal<number>;
+    protected readonly interacting: _angular_core.WritableSignal<boolean>;
+    protected readonly dragAxis: _angular_core.WritableSignal<GogScrollDirection | null>;
+    private readonly isBrowser;
+    private readonly destroyRef;
+    private resizeObserver;
+    private updateFrame;
+    private hideTimer;
+    /** Read once per token change instead of per drag/scroll tick — see refreshTokens(). */
+    private thumbMinSizePx;
+    private dragStartPointer;
+    private dragStartScroll;
+    private dragTrackLength;
+    private dragThumbSizePct;
+    private readonly reachState;
+    constructor();
+    /** Scrolls the viewport exactly like `Element.scrollTo` — this simply forwards to it. */
+    scrollTo(options: ScrollToOptions): void;
+    scrollToTop(behavior?: ScrollBehavior): void;
+    scrollToBottom(behavior?: ScrollBehavior): void;
+    scrollToLeft(behavior?: ScrollBehavior): void;
+    scrollToRight(behavior?: ScrollBehavior): void;
+    protected onScroll(): void;
+    protected onActivity(): void;
+    protected onTrackPointerDown(event: PointerEvent, axis: GogScrollDirection): void;
+    protected onThumbPointerDown(event: PointerEvent, axis: GogScrollDirection): void;
+    protected onThumbPointerMove(event: PointerEvent, axis: GogScrollDirection): void;
+    protected onThumbPointerUp(event: PointerEvent): void;
+    private restartHideTimer;
+    /** Reads the tokens that feed thumb-size math. Cheap, but still only once per change. */
+    private refreshTokens;
+    /** Coalesces scroll/resize bursts into one measurement per frame. */
+    private scheduleMeasure;
+    private measure;
+    private checkReach;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ScrollComponent, never>;
+    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>;
+}
+
 declare class SpinnerOverlayComponent {
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly size: _angular_core.InputSignal<GogSize>;
@@ -1018,5 +1260,58 @@ declare class ThemeService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ThemeService>;
 }
 
-export { AccordionComponent, ButtonComponent, CheckboxComponent, ChipComponent, Column, ConfirmationDialogComponent, DIALOG_DATA, DIALOG_REF, DialogComponent, DialogService, GogAccordionChevronDirective, GogAccordionContentDirective, GogAccordionHeaderDirective, GogDropdownBase, ICON_DEFS, IconComponent, InputfieldComponent, MultiselectComponent, PaginatorComponent, SelectComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SpinnerOverlayComponent, TableComponent, TagComponent, TemplateDirective, ThemeService, ToastComponent, ToastContainerComponent, ToastService, defaultCompare };
-export type { ConfirmDialogData, DialogConfig, DialogHandle, DialogRef, GogAccordionChevronContext, GogAccordionHeaderContext, GogAccordionItem, GogAccordionToggleEvent, GogDropdownDirection, GogDropdownOption, GogIconName, GogMultiselectOption, GogPaginatorRangeMode, GogSelectOption, GogSize, GogSkeletonAnimation, GogSkeletonShape, GogSpinnerVariant, GogTableBodyContext, GogTableHeaderContext, GogTagShape, GogTagVariant, GogVariant, OpenDialog, SortDirection, Toast, ToastAction, ToastConfig, ToastPosition, ToastType };
+/**
+ * App-wide defaults for the handful of component inputs where that actually makes sense —
+ * timing/behavior knobs a whole app typically wants to set once (a house style for how long
+ * scrollbars stay visible, how aggressively buttons debounce clicks), not visual ones.
+ * Visual defaults (colors, radii, animation *durations expressed in CSS*) already have a
+ * global mechanism: the `--gog-*` custom properties in `styles/theme.css`. This is only for
+ * inputs that can't be a CSS token because a component reads them in TypeScript (a
+ * `setTimeout` delay, an RxJS `timer` duration) — see `styling.instructions.md` and
+ * `gleks-ui-library.instructions.md`'s "Global configuration" section for the line between
+ * the two and for how to add a new field here when a component needs one.
+ *
+ * Every field is optional at every level: set only the ones you want to change from the
+ * component's own built-in default. An instance's own input, when set, always wins over
+ * this — this only fills in what the instance didn't specify itself.
+ */
+interface GogGlobalConfig {
+    scroll?: {
+        autoHide?: boolean;
+        hideDelay?: number;
+        size?: GogScrollSize;
+        overscrollBehavior?: GogScrollOverscrollBehavior;
+    };
+    button?: {
+        debounce?: number;
+    };
+}
+/**
+ * Resolves to `{}` — every field falls through to its component's own hardcoded default —
+ * until a `provideGogConfig(...)` call overrides it somewhere in the injector tree.
+ */
+declare const GOG_CONFIG: InjectionToken<GogGlobalConfig>;
+/**
+ * Sets app-wide (or subtree-wide, if placed in a route's or component's own `providers`
+ * instead of the bootstrap config) defaults for every `@guildofgleks/ui` component that
+ * reads `GOG_CONFIG` — one call instead of a separate injection token per setting:
+ *
+ * ```ts
+ * // app.config.ts
+ * providers: [
+ *   provideGogConfig({
+ *     scroll: { hideDelay: 1000 },
+ *     button: { debounce: 500 },
+ *   }),
+ * ]
+ * ```
+ *
+ * Providing this again further down the injector tree (a route, a single component's own
+ * `providers`) replaces the whole object for that subtree rather than merging with the
+ * parent's — pass everything you want in effect there, not just the one field you're
+ * changing.
+ */
+declare function provideGogConfig(config: GogGlobalConfig): Provider;
+
+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 };
+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 };