@koobiq/components 21.0.0 → 21.1.0

package/types/koobiq-components-splitter.d.ts

@@ -14,8 +14,9 @@ type KbqSplitterOrientation = 'horizontal' | 'vertical';
  */
 type KbqSplitterAppearance = 'divider' | 'transparent' | 'handle';
 /**
- * Size of a splitter panel: a number of pixels, a `<number>px` string, or a `<number>%` share of the
- * splitter's own size along the resize axis. A size in any other unit is ignored.
+ * Size of a splitter panel: a number of pixels, a `<number>px` string, a `<number>%` share of the splitter's own
+ * size along the resize axis, or a `<number>vw` / `<number>vh` share of the viewport's width / height. A size in
+ * any other unit is ignored.
  */
 type KbqSplitterSize = number | string;
 /**
@@ -122,8 +123,8 @@ declare class KbqSplitterPanel implements KbqSplitterPanelRef {
      */
     readonly id: InputSignal<string>;
     /**
-     * Size the panel starts at, in pixels (`240`, `'240px'`) or as a share of the splitter (`'30%'`).
-     * Panels that leave it unset share whatever the sized ones did not claim.
+     * Size the panel starts at, in pixels (`240`, `'240px'`), as a share of the splitter (`'30%'`) or as a share
+     * of the viewport (`'30vw'`, `'30vh'`). Panels that leave it unset share whatever the sized ones did not claim.
      */
     readonly size: InputSignal<KbqSplitterSize | undefined>;
     /** Smallest size the panel may be dragged to. Defaults to `0`. */
@@ -231,6 +232,7 @@ declare class KbqSplitter implements KbqSplitterGroup {
     private readonly platform;
     private readonly window;
     private readonly resizeObserver;
+    private readonly viewportRuler;
     private readonly directionality;
     private readonly options;
     /** Direction the panels are laid out in. */
@@ -255,6 +257,11 @@ declare class KbqSplitter implements KbqSplitterGroup {
     protected readonly dragging: Signal<boolean>;
     /** Splitter size along the resize axis, in pixels; `0` until the first measurement. */
     private readonly containerSize;
+    /**
+     * Viewport size `vw` and `vh` resolve against, in pixels. Known from the start rather than after the first render:
+     * tracks resolved against a zero viewport would be what a nested splitter measures itself in.
+     */
+    private readonly viewportSize;
     /** Sizes and layout captured when the drag began; every move is measured against these, so clamping cannot drift. */
     private dragSnapshot;
     private readonly rtl;
@@ -324,6 +331,8 @@ declare class KbqSplitter implements KbqSplitterGroup {
     handleSeparatorKeydown(index: number, event: KeyboardEvent): void;
     /** @docs-private */
     handleSeparatorDblClick(index: number): void;
+    /** Resolves a size in the units a panel understands into pixels, with `total` as the splitter's own size. */
+    private resolveSize;
     /**
      * Whether the panels are still the ones the drag was measured against.
      *

package/types/koobiq-components-tabs.d.ts

@@ -60,6 +60,10 @@ declare abstract class KbqPaginatedTabHeader implements OnChanges, AfterContentC
     disableScrollAfter: boolean;
     /** Whether the tab list can be scrolled more towards the beginning of the tab label list. */
     disableScrollBefore: boolean;
+    /** @docs-private */
+    protected overflowBefore: boolean;
+    /** @docs-private */
+    protected overflowAfter: boolean;
     /**
      * Whether pagination should be disabled. This can be used to avoid unnecessary
      * layout recalculations if it's known that pagination won't be required.

package/types/koobiq-components-tags.d.ts

@@ -241,6 +241,12 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnCh
     set disabled(value: boolean);
     private readonly _disabled;
     private readonly disabledState;
+    /**
+     * Value of the `disabled` attribute.
+     *
+     * @docs-private
+     */
+    protected readonly disabledAttribute: _angular_core.Signal<true | null>;
     /**
      * Whether the tag is draggable.
      *

package/types/koobiq-components-textarea.d.ts

@@ -64,6 +64,11 @@ declare class KbqTextarea implements KbqFormFieldControl<any>, OnInit, DoCheck,
      * @docs-private
      */
     readonly disabled: _angular_core.Signal<boolean>;
+    /**
+     * Whether the textarea is read-only: its value can be selected and copied, but not changed. A read-only
+     * textarea shows no placeholder. Defaults to `false`.
+     */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
     /** @docs-private */
     readonly idInput: _angular_core.InputSignal<string | undefined>;
     /**
@@ -127,8 +132,10 @@ declare class KbqTextarea implements KbqFormFieldControl<any>, OnInit, DoCheck,
     private valueAccessor;
     /** Measured once the textarea has been rendered; the growth arithmetic is in terms of these. */
     private readonly lineHeight;
-    private readonly minHeight;
+    private readonly verticalPadding;
     private readonly rowsCount;
+    /** The `min-height` growth wrote last, so that turning growth off removes it and keeps a consumer's own. */
+    private grownMinHeight;
     constructor();
     ngOnInit(): void;
     ngDoCheck(): void;
@@ -166,7 +173,7 @@ declare class KbqTextarea implements KbqFormFieldControl<any>, OnInit, DoCheck,
     protected isBadInput(): boolean;
     private isEmpty;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTextarea, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTextarea, "textarea[kbqTextarea]", ["kbqTextarea"], { "canGrow": { "alias": "canGrow"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "freeRowsHeight": { "alias": "freeRowsHeight"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.KbqNativeScrollbar; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTextarea, "textarea[kbqTextarea]", ["kbqTextarea"], { "canGrow": { "alias": "canGrow"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "freeRowsHeight": { "alias": "freeRowsHeight"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.KbqNativeScrollbar; inputs: {}; outputs: {}; }]>;
 }
 
 declare class KbqTextareaModule {

package/types/koobiq-components-timepicker.d.ts

@@ -139,6 +139,12 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     get timeFormatPlaceholder(): string;
     private readonly validator;
     private lastValueValid;
+    /**
+     * Whether a drag started in this field, so that its drop here is the field's own text.
+     *
+     * @docs-private
+     */
+    protected draggingOwnText: boolean;
     private control?;
     private separator;
     /** Start of the part a caret key selects on a timer, until the selection lands there. */
@@ -154,6 +160,13 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     focusChanged(isFocused: boolean): void;
     onBlur(): void;
     onPaste($event: any): void;
+    /**
+     * Takes dropped text the way a paste is taken. The browser would insert it at the pointer, with no event
+     * the parsing listens to.
+     *
+     * @docs-private
+     */
+    protected onDrop(event: DragEvent): void;
     onInput: () => void;
     /**
      * Implemented as part of KbqFormFieldControl.
@@ -168,6 +181,8 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     registerOnChange(fn: (value: D) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
+    /** Takes a pasted or dropped text as the whole value; one that is not a time is rejected as a letter key is. */
+    private replaceText;
     private formatUserPaste;
     private formatUserInput;
     private replaceSymbols;

package/types/koobiq-components-toggle.d.ts

@@ -34,6 +34,18 @@ declare class KbqToggleComponent extends KbqColorDirective implements OnChanges,
     readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
     /** Error text projected into the toggle. */
     private readonly error;
+    /**
+     * Whether the projected `kbq-error` is shown. Without one, nothing is rendered under the label.
+     *
+     * @docs-private
+     */
+    protected readonly showError: Signal<boolean>;
+    /**
+     * Value of `aria-invalid` of the native input: set whenever the toggle is painted as invalid.
+     *
+     * @docs-private
+     */
+    protected readonly ariaInvalid: Signal<"true" | null>;
     readonly big: _angular_core.InputSignal<boolean>;
     readonly inputElement: Signal<ElementRef<HTMLInputElement>>;
     readonly labelPosition: _angular_core.InputSignal<ToggleLabelPositionType>;
@@ -103,6 +115,24 @@ declare class KbqToggleComponent extends KbqColorDirective implements OnChanges,
     onInputClick(event: MouseEvent): void;
     /** Id of the element wrapping the projected hint, referenced by the input's `aria-describedby`. */
     protected get hintId(): string;
+    /**
+     * Id of the element wrapping the projected `kbq-error`.
+     *
+     * @docs-private
+     */
+    protected get errorId(): string;
+    /**
+     * Id of the label text, which names the native input unless `aria-label` or `aria-labelledby` is given.
+     *
+     * @docs-private
+     */
+    protected get labelId(): string;
+    /**
+     * The error, while it is shown, and the hint, in the order a form field gives them.
+     *
+     * @docs-private
+     */
+    protected get ariaDescribedBy(): string;
     /** A native checkbox only reacts to Space, so Enter is forwarded to it manually. */
     protected onEnterKeydown(event: Event): void;
     private setTransitionCheckState;

package/types/koobiq-components-tooltip.d.ts

@@ -1,11 +1,33 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, ElementRef, AfterViewInit, OnChanges, OnDestroy, InputSignal, Renderer2, WritableSignal, TemplateRef, EventEmitter, SimpleChanges, Type } from '@angular/core';
+import { InjectionToken, AfterViewInit, ElementRef, OnChanges, OnDestroy, InputSignal, Renderer2, WritableSignal, TemplateRef, EventEmitter, SimpleChanges, Type } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { FocusMonitor, FocusOrigin } from '@angular/cdk/a11y';
 import { BooleanInput } from '@angular/cdk/coercion';
 import { ScrollStrategy, Overlay, OverlayConfig, OverlayRef } from '@angular/cdk/overlay';
 import { KbqPopUp, KbqEnumValues, KbqPopUpTrigger, KbqParentPopup, KbqPopUpPlacementValues, KbqComponentColors } from '@koobiq/components/core';
 
+/**
+ * Default options inherited by every tooltip in the token's scope. A bound input still wins: `kbqTooltipOffset`
+ * overrides `offset`, and a binding that changes to `undefined` restores the inherited value.
+ */
+interface KbqTooltipDefaultOptions {
+    /**
+     * Distance in pixels between the tooltip and its trigger, used while `kbqTooltipOffset` is not bound.
+     * `null` keeps the gap of the stylesheet.
+     */
+    readonly offset?: number | null;
+    /** Extra CSS class applied to the tooltip's overlay panel. */
+    readonly panelClass?: string | string[];
+}
+/**
+ * Default options for the tooltips in the token's scope. Provided in root with an empty-object factory, so
+ * behavior stays unchanged unless a component tree — e.g. a navbar, so its items' tooltips inherit the
+ * horizontal-navbar panel class and a zero offset — provides its own values.
+ *
+ * @docs-private
+ */
+declare const KBQ_TOOLTIP_DEFAULT_OPTIONS: InjectionToken<KbqTooltipDefaultOptions>;
+
 /**
  * Default value of the `kbqTooltipSingleInstance` input. Provide `false` at the application level to
  * globally disable the "only one tooltip is visible at a time" behavior.
@@ -100,9 +122,10 @@ declare class KbqTooltipDelayTracker {
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTooltipDelayTracker, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<KbqTooltipDelayTracker>;
 }
-declare class KbqTooltipComponent extends KbqPopUp {
+declare class KbqTooltipComponent extends KbqPopUp implements AfterViewInit {
     private readonly delayTracker;
     prefix: string;
+    protected arrowCenterInset: number;
     /**
      * Id rendered on the tooltip element; the trigger points its `aria-describedby` at it.
      *
@@ -115,6 +138,9 @@ declare class KbqTooltipComponent extends KbqPopUp {
     private readonly tooltipElement;
     /** The tooltip panel, which the base pop-up measures and decorates instead of the host. */
     get elementRef(): ElementRef<HTMLElement>;
+    ngAfterViewInit(): void;
+    /** Recalculates from the settled geometry: the entrance starts from `scale(0)`, an empty measurement box. */
+    protected afterShowAnimation(): void;
     show(delay: number): void;
     /**
      * Applies `offset` as the gap between the tooltip and its trigger. Called both on show and whenever the
@@ -153,6 +179,11 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** Registry holding the single tooltip that is currently visible. */
     private readonly tooltipRegistry;
     private readonly injectedScrollStrategy;
+    /**
+     * Default options inherited from the token's scope: the initial `offset` and the overlay `panelClass`,
+     * and the value a `kbqTooltipOffset` binding changed to `undefined` restores.
+     */
+    private readonly defaultOptions;
     /**
      * Per-instance override for the scroll strategy, taking precedence over `KBQ_TOOLTIP_SCROLL_STRATEGY`
      * when set. An input rather than a DI override so it applies to this tooltip instance only, without
@@ -290,8 +321,15 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** Input (`kbqTooltipArrow`) — whether to render the tooltip's arrow/pointer. Defaults to `false`. */
     arrow: boolean;
     /**
-     * Input (`kbqTooltipOffset`) — distance in pixels between the tooltip and its trigger. `null`, the default, keeps
-     * the gap of the stylesheet.
+     * Input (`kbqTooltipArrowCentered`) — centers the arrow on the trigger while preserving the panel placement.
+     * Requires a visible arrow. Defaults to `false`.
+     */
+    arrowCentered: boolean;
+    /**
+     * Input (`kbqTooltipOffset`) — distance in pixels between the tooltip and its trigger. `null` keeps
+     * the gap of the stylesheet. Defaults to the `offset` of {@link KBQ_TOOLTIP_DEFAULT_OPTIONS}, when a
+     * provider in scope set one. Inside a provider scope such as the navbar's, `null`/`undefined` restores
+     * that inherited default.
      */
     offset: number | null;
     /** Output (`kbqPlacementChange`) that emits the new placement whenever the tooltip repositions. */
@@ -321,9 +359,9 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
      */
     header: string | TemplateRef<unknown>;
     /**
-     * Hands each bound input to its member, and pushes a later change of `modifier`, `header`, `arrow` or
-     * `offset` — plain fields — into an open tooltip, which would otherwise show stale data until the next
-     * show/hide cycle.
+     * Hands each bound input to its member, and pushes a later change of `modifier`, `header`, `arrow`,
+     * `arrowCentered` or `offset` — plain fields — into an open tooltip, which would otherwise show stale data
+     * until the next show/hide cycle.
      */
     ngOnChanges(changes: SimpleChanges): void;
     /**
@@ -390,6 +428,8 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** @docs-private */
     readonly arrowInput: i0.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
     /** @docs-private */
+    readonly arrowCenteredInput: i0.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** @docs-private */
     readonly offsetInput: i0.InputSignalWithTransform<number | undefined, string | number | null | undefined>;
     /** @docs-private */
     readonly disabledInput: i0.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
@@ -576,6 +616,11 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
         width: number;
         height: number;
     };
+    /** @docs-private */
+    protected getOriginCenter(): {
+        x: number;
+        y: number;
+    };
     /**
      * Rectangle the tooltip is anchored to: the caret or selection of the field — spanning the whole field
      * vertically when it anchors to the field — or the host element's box when the caret cannot be located or
@@ -597,7 +642,7 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** @docs-private */
     protected applyRelativeToPointer(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTooltipTrigger, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTooltipTrigger, "[kbqTooltip]", ["kbqTooltip"], { "scrollStrategyOverride": { "alias": "kbqTooltipScrollStrategy"; "required": false; "isSignal": true; }; "forDisabledComponent": { "alias": "forDisabledComponent"; "required": false; "isSignal": true; }; "ignoreTooltipPointerEvents": { "alias": "ignoreTooltipPointerEvents"; "required": false; "isSignal": true; }; "singleInstance": { "alias": "kbqTooltipSingleInstance"; "required": false; "isSignal": true; }; "triggerInput": { "alias": "kbqTrigger"; "required": false; "isSignal": true; }; "hideWithTimeoutInput": { "alias": "hideWithTimeout"; "required": false; "isSignal": true; }; "enterDelayInput": { "alias": "kbqEnterDelay"; "required": false; "isSignal": true; }; "leaveDelayInput": { "alias": "kbqLeaveDelay"; "required": false; "isSignal": true; }; "relativeToPointerInput": { "alias": "kbqRelativeToPointer"; "required": false; "isSignal": true; }; "relativeToCaretInput": { "alias": "kbqRelativeToCaret"; "required": false; "isSignal": true; }; "relativeToCaretVerticalInput": { "alias": "kbqRelativeToCaretVertical"; "required": false; "isSignal": true; }; "contentInput": { "alias": "kbqTooltip"; "required": false; "isSignal": true; }; "headerInput": { "alias": "kbqTooltipHeader"; "required": false; "isSignal": true; }; "modifierInput": { "alias": "kbqTooltipModifier"; "required": false; "isSignal": true; }; "contextInput": { "alias": "kbqTooltipContext"; "required": false; "isSignal": true; }; "customClassInput": { "alias": "kbqTooltipClass"; "required": false; "isSignal": true; }; "colorInput": { "alias": "kbqTooltipColor"; "required": false; "isSignal": true; }; "arrowInput": { "alias": "kbqTooltipArrow"; "required": false; "isSignal": true; }; "offsetInput": { "alias": "kbqTooltipOffset"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "kbqTooltipDisabled"; "required": false; "isSignal": true; }; "tooltipPlacementPriorityInput": { "alias": "kbqPlacementPriority"; "required": false; "isSignal": true; }; "tooltipPlacementInput": { "alias": "kbqPlacement"; "required": false; "isSignal": true; }; "tooltipVisibleInput": { "alias": "kbqVisible"; "required": false; "isSignal": true; }; }, { "placementChangeOutput": "kbqPlacementChange"; "visibleChangeOutput": "kbqVisibleChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTooltipTrigger, "[kbqTooltip]", ["kbqTooltip"], { "scrollStrategyOverride": { "alias": "kbqTooltipScrollStrategy"; "required": false; "isSignal": true; }; "forDisabledComponent": { "alias": "forDisabledComponent"; "required": false; "isSignal": true; }; "ignoreTooltipPointerEvents": { "alias": "ignoreTooltipPointerEvents"; "required": false; "isSignal": true; }; "singleInstance": { "alias": "kbqTooltipSingleInstance"; "required": false; "isSignal": true; }; "triggerInput": { "alias": "kbqTrigger"; "required": false; "isSignal": true; }; "hideWithTimeoutInput": { "alias": "hideWithTimeout"; "required": false; "isSignal": true; }; "enterDelayInput": { "alias": "kbqEnterDelay"; "required": false; "isSignal": true; }; "leaveDelayInput": { "alias": "kbqLeaveDelay"; "required": false; "isSignal": true; }; "relativeToPointerInput": { "alias": "kbqRelativeToPointer"; "required": false; "isSignal": true; }; "relativeToCaretInput": { "alias": "kbqRelativeToCaret"; "required": false; "isSignal": true; }; "relativeToCaretVerticalInput": { "alias": "kbqRelativeToCaretVertical"; "required": false; "isSignal": true; }; "contentInput": { "alias": "kbqTooltip"; "required": false; "isSignal": true; }; "headerInput": { "alias": "kbqTooltipHeader"; "required": false; "isSignal": true; }; "modifierInput": { "alias": "kbqTooltipModifier"; "required": false; "isSignal": true; }; "contextInput": { "alias": "kbqTooltipContext"; "required": false; "isSignal": true; }; "customClassInput": { "alias": "kbqTooltipClass"; "required": false; "isSignal": true; }; "colorInput": { "alias": "kbqTooltipColor"; "required": false; "isSignal": true; }; "arrowInput": { "alias": "kbqTooltipArrow"; "required": false; "isSignal": true; }; "arrowCenteredInput": { "alias": "kbqTooltipArrowCentered"; "required": false; "isSignal": true; }; "offsetInput": { "alias": "kbqTooltipOffset"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "kbqTooltipDisabled"; "required": false; "isSignal": true; }; "tooltipPlacementPriorityInput": { "alias": "kbqPlacementPriority"; "required": false; "isSignal": true; }; "tooltipPlacementInput": { "alias": "kbqPlacement"; "required": false; "isSignal": true; }; "tooltipVisibleInput": { "alias": "kbqVisible"; "required": false; "isSignal": true; }; }, { "placementChangeOutput": "kbqPlacementChange"; "visibleChangeOutput": "kbqVisibleChange"; }, never, never, true, never>;
 }
 
 declare class KbqToolTipModule {
@@ -606,5 +651,5 @@ declare class KbqToolTipModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<KbqToolTipModule>;
 }
 
-export { KBQ_TOOLTIP_INSTANT_SHOW_WINDOW, KBQ_TOOLTIP_OPEN_TIME, KBQ_TOOLTIP_OPEN_TIME_PROVIDER, KBQ_TOOLTIP_SCROLL_STRATEGY, KBQ_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER, KBQ_TOOLTIP_SINGLE_INSTANCE_DEFAULT, KbqToolTipModule, KbqTooltipComponent, KbqTooltipDelayTracker, KbqTooltipRegistry, KbqTooltipTrigger, MIN_TIME_FOR_DELAY, TooltipModifier, kbqTooltipScrollStrategyFactory };
-export type { KbqCaretVerticalAnchor, KbqExclusiveTooltip };
+export { KBQ_TOOLTIP_DEFAULT_OPTIONS, KBQ_TOOLTIP_INSTANT_SHOW_WINDOW, KBQ_TOOLTIP_OPEN_TIME, KBQ_TOOLTIP_OPEN_TIME_PROVIDER, KBQ_TOOLTIP_SCROLL_STRATEGY, KBQ_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER, KBQ_TOOLTIP_SINGLE_INSTANCE_DEFAULT, KbqToolTipModule, KbqTooltipComponent, KbqTooltipDelayTracker, KbqTooltipRegistry, KbqTooltipTrigger, MIN_TIME_FOR_DELAY, TooltipModifier, kbqTooltipScrollStrategyFactory };
+export type { KbqCaretVerticalAnchor, KbqExclusiveTooltip, KbqTooltipDefaultOptions };

package/types/koobiq-components-top-bar.d.ts

@@ -19,6 +19,14 @@ declare class KbqTopBarContainer {
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTopBarContainer, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTopBarContainer, "[kbqTopBarContainer]", never, { "placement": { "alias": "placement"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+/**
+ * Marks the page title of `kbq-top-bar` and sizes it like `size="big"` breadcrumbs, so the bar keeps
+ * its height and the text its baseline when a page swaps the trail for a title.
+ */
+declare class KbqTopBarTitle {
+    static ɵfac: i0.ɵɵFactoryDeclaration<KbqTopBarTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTopBarTitle, "[kbqTopBarTitle]", never, {}, {}, never, never, true, never>;
+}
 /**
  * Toolbar row for the top of a page or a panel. It expects two `[kbqTopBarContainer]` slots —
  * `placement="start"` and `placement="end"` — with an optional `[kbqTopBarSpacer]` between them.
@@ -50,12 +58,12 @@ declare class KbqTopBar {
 
 /**
  * Kept for applications that still declare NgModules. Standalone code imports `KbqTopBar`,
- * `KbqTopBarContainer` and `KbqTopBarSpacer` directly instead.
+ * `KbqTopBarContainer`, `KbqTopBarSpacer` and `KbqTopBarTitle` directly instead.
  */
 declare class KbqTopBarModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTopBarModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<KbqTopBarModule, never, [typeof KbqTopBar, typeof KbqTopBarContainer, typeof KbqTopBarSpacer], [typeof KbqTopBar, typeof KbqTopBarContainer, typeof KbqTopBarSpacer]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<KbqTopBarModule, never, [typeof KbqTopBar, typeof KbqTopBarContainer, typeof KbqTopBarSpacer, typeof KbqTopBarTitle], [typeof KbqTopBar, typeof KbqTopBarContainer, typeof KbqTopBarSpacer, typeof KbqTopBarTitle]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<KbqTopBarModule>;
 }
 
-export { KbqTopBar, KbqTopBarContainer, KbqTopBarModule, KbqTopBarSpacer };
+export { KbqTopBar, KbqTopBarContainer, KbqTopBarModule, KbqTopBarSpacer, KbqTopBarTitle };

package/types/koobiq-components-tree-select.d.ts

@@ -124,7 +124,7 @@ declare class KbqTreeSelectChange<T = any> {
     /** Every option the change is about, when it covers more than one. */
     values?: unknown[] | undefined);
 }
-declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterViewChecked, AfterContentInit, AfterViewInit, OnDestroy, OnInit, DoCheck, ControlValueAccessor, KbqFormFieldControl<KbqTreeOption>, CanUpdateErrorState, KbqSiblingPopup {
+declare class KbqTreeSelect<T = any, K = T> extends KbqAbstractSelect implements AfterViewChecked, AfterContentInit, AfterViewInit, OnDestroy, OnInit, DoCheck, ControlValueAccessor, KbqFormFieldControl<KbqTreeOption>, CanUpdateErrorState, KbqSiblingPopup {
     elementRef: ElementRef<HTMLElement>;
     protected readonly changeDetectorRef: ChangeDetectorRef;
     private readonly injector;
@@ -158,7 +158,8 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
      * Deals with the selection logic. The projected `kbq-tree-selection` shares the same instance.
      *
      * `T` is the type of the data nodes, the same as the projected tree's. A template infers it from `[clearPredicate]`
-     * alone, apart from the tree; a query names it: `viewChild.required<KbqTreeSelect<Node>>(KbqTreeSelect)`.
+     * alone, apart from the tree; a query names it: `viewChild.required<KbqTreeSelect<Node>>(KbqTreeSelect)`, and a
+     * select whose tree control has a `trackBy` names the key type too: `KbqTreeSelect<Node, string>`.
      */
     selectionModel: SelectionModel<T>;
     /** Emits once the panel has rendered (`'showing'`) or has been removed (`'void'`). */
@@ -207,7 +208,7 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
     readonly customTrigger: _angular_core.Signal<KbqSelectTrigger | undefined>;
     readonly customMatcher: _angular_core.Signal<KbqSelectMatcher | undefined>;
     readonly customTagTemplateRef: _angular_core.Signal<TemplateRef<any> | undefined>;
-    readonly tree: _angular_core.Signal<KbqTreeSelection<T> | undefined>;
+    readonly tree: _angular_core.Signal<KbqTreeSelection<T, K> | undefined>;
     readonly search: _angular_core.Signal<KbqSelectSearch | undefined>;
     /** Message projected for an empty tree — the only thing the panel opens onto without options. */
     private readonly noOptionsMessage;
@@ -245,7 +246,7 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
      * Event emitted whenever the tree's `selectAllOptions()` runs — a click on the `selectAll` master
      * checkbox, the Ctrl/Cmd + A shortcut, or a custom `selectAllHandler` that delegates to it.
      */
-    readonly onSelectAll: _angular_core.OutputEmitterRef<KbqSelectAllEvent<KbqTreeOption<T>, KbqTreeSelect<T>>>;
+    readonly onSelectAll: _angular_core.OutputEmitterRef<KbqSelectAllEvent<KbqTreeOption<T>, KbqTreeSelect<T, K>>>;
     /** Classes to be passed to the select panel. Supports the same syntax as the `[class]` binding. */
     readonly panelClass: InputSignal<string | string[] | Set<string> | {
         [key: string]: any;
@@ -268,6 +269,12 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
      * control.
      */
     readonly ariaLabelledby: InputSignal<string | null>;
+    /**
+     * Id of the element that names the control: its own `aria-labelledby`, or else the form-field label.
+     *
+     * @docs-private
+     */
+    protected readonly resolvedAriaLabelledby: _angular_core.Signal<string | null>;
     /** Object used to control when error messages are shown. */
     readonly errorStateMatcher: InputSignal<ErrorStateMatcher | undefined>;
     /**
@@ -342,11 +349,17 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
     private readonly resolvedTabIndex;
     private readonly resolvedAriaLabel;
     /** @docs-private */
-    readonly selectAllHandlerInput: _angular_core.InputSignalWithTransform<((event: KeyboardEvent, select: KbqTreeSelect<T>) => void) | undefined, ((event: KeyboardEvent, select: KbqTreeSelect<T>) => void) | undefined>;
+    protected readonly disabledAttribute: _angular_core.Signal<true | null>;
+    /** @docs-private */
+    protected readonly disabledClass: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    protected readonly invalidClass: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    readonly selectAllHandlerInput: _angular_core.InputSignalWithTransform<((event: KeyboardEvent, select: KbqTreeSelect<T, K>) => void) | undefined, ((event: KeyboardEvent, select: KbqTreeSelect<T, K>) => void) | undefined>;
     /**
      * Function for handling the combination Ctrl + A (select all). By default, the internal handler is used.
      */
-    get selectAllHandler(): (event: KeyboardEvent, select: KbqTreeSelect<T>) => void;
+    get selectAllHandler(): (event: KeyboardEvent, select: KbqTreeSelect<T, K>) => void;
     /** Function for handling the combination Ctrl + A (select all). By default, the internal handler is used. */
     private defaultSelectAllHandler;
     private readonly focusedValue;
@@ -420,6 +433,8 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
      * node inside a collapsed branch has no option to ask.
      */
     private isNodeDisabled;
+    /** The rendered option of each node, for asking `isNodeDisabled` about every selected node at once. */
+    private renderedOptionsByNode;
     /**
      * Colour of the trigger's tags and arrow.
      *
@@ -648,8 +663,8 @@ declare class KbqTreeSelect<T = any> extends KbqAbstractSelect implements AfterV
      * timer is the floor that covers that case.
      */
     private subscribeOnSearchChanges;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTreeSelect<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeSelect<any>, "kbq-tree-select", ["kbqTreeSelect"], { "hiddenItemsText": { "alias": "hiddenItemsText"; "required": false; "isSignal": true; }; "hiddenItemsTextFormatter": { "alias": "hiddenItemsTextFormatter"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "backdropClass": { "alias": "backdropClass"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "sortComparator": { "alias": "sortComparator"; "required": false; "isSignal": true; }; "clearPredicate": { "alias": "clearPredicate"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "multipleInput": { "alias": "multiple"; "required": false; "isSignal": true; }; "autoSelectInput": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectAllHandlerInput": { "alias": "selectAllHandler"; "required": false; "isSignal": true; }; "panelMinWidth": { "alias": "panelMinWidth"; "required": false; "isSignal": true; }; "panelWidth": { "alias": "panelWidth"; "required": false; "isSignal": true; }; "panelMaxWidth": { "alias": "panelMaxWidth"; "required": false; "isSignal": true; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; "isSignal": true; }; "searchMinOptionsThresholdInput": { "alias": "searchMinOptionsThreshold"; "required": false; "isSignal": true; }; }, { "openedChangeOutput": "openedChange"; "openedOutput": "opened"; "closedOutput": "closed"; "selectionChange": "selectionChange"; "onSelectAll": "onSelectAll"; }, ["cleaner", "customTrigger", "customMatcher", "customTagTemplateRef", "tree", "search", "noOptionsMessage"], ["kbq-select-matcher, [kbq-select-matcher]", "kbq-select-trigger, [kbq-select-trigger]", "kbq-cleaner", "[kbqSelectSearch]", "[kbq-select-search-empty-result]", "kbq-select-no-options, [kbq-select-no-options]", "kbq-tree-selection", "kbq-select-footer,[kbq-tree-select-footer]"], true, [{ directive: typeof i4.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTreeSelect<any, any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeSelect<any, any>, "kbq-tree-select", ["kbqTreeSelect"], { "hiddenItemsText": { "alias": "hiddenItemsText"; "required": false; "isSignal": true; }; "hiddenItemsTextFormatter": { "alias": "hiddenItemsTextFormatter"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "backdropClass": { "alias": "backdropClass"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "sortComparator": { "alias": "sortComparator"; "required": false; "isSignal": true; }; "clearPredicate": { "alias": "clearPredicate"; "required": false; "isSignal": true; }; "multiline": { "alias": "multiline"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "multipleInput": { "alias": "multiple"; "required": false; "isSignal": true; }; "autoSelectInput": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; "idInput": { "alias": "id"; "required": false; "isSignal": true; }; "hasBackdrop": { "alias": "hasBackdrop"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectAllHandlerInput": { "alias": "selectAllHandler"; "required": false; "isSignal": true; }; "panelMinWidth": { "alias": "panelMinWidth"; "required": false; "isSignal": true; }; "panelWidth": { "alias": "panelWidth"; "required": false; "isSignal": true; }; "panelMaxWidth": { "alias": "panelMaxWidth"; "required": false; "isSignal": true; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; "isSignal": true; }; "searchMinOptionsThresholdInput": { "alias": "searchMinOptionsThreshold"; "required": false; "isSignal": true; }; }, { "openedChangeOutput": "openedChange"; "openedOutput": "opened"; "closedOutput": "closed"; "selectionChange": "selectionChange"; "onSelectAll": "onSelectAll"; }, ["cleaner", "customTrigger", "customMatcher", "customTagTemplateRef", "tree", "search", "noOptionsMessage"], ["kbq-select-matcher, [kbq-select-matcher]", "kbq-select-trigger, [kbq-select-trigger]", "kbq-cleaner", "[kbqSelectSearch]", "[kbq-select-search-empty-result]", "kbq-select-no-options, [kbq-select-no-options]", "kbq-tree-selection", "kbq-select-footer,[kbq-tree-select-footer]"], true, [{ directive: typeof i4.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
 }
 
 /**