@koobiq/components 20.3.1 → 20.4.0

package/core/index.d.ts

@@ -458,6 +458,71 @@ declare class ErrorStateMatcher {
     static ɵfac: i0.ɵɵFactoryDeclaration<ErrorStateMatcher, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ErrorStateMatcher>;
 }
+/**
+ * Resolves which controls a group-level error concerns.
+ *
+ * Called with one error of a group at a time. Return the names of the controls the error applies to, relative
+ * to the group holding it — `AbstractControl.get` paths such as `'passwords.confirm'` are supported — or
+ * `null` for errors this scope does not know.
+ *
+ * It is called from change detection, so keep it cheap and allocation-free.
+ */
+type CrossFieldErrorScope = (errorKey: string, errorValue: unknown) => readonly string[] | null;
+/**
+ * Error state matcher that also shows an error set on a `FormGroup` on the controls that error concerns,
+ * which the default matcher cannot: it is handed the field's own `FormControl` and never looks further.
+ *
+ * `scope` maps an error to those controls, so no error shape is imposed on validators. The error is revealed
+ * once every one of them is touched, or the form is submitted — override `shouldReveal` to change that.
+ *
+ * ## Usage:
+ *
+ * ```typescript
+ * providers: [
+ *     kbqErrorStateMatcherProvider(
+ *         new ShowOnCrossFieldErrorStateMatcher((key) =>
+ *             key === 'passwordsMismatch' ? ['newPassword', 'confirmPassword'] : null
+ *         )
+ *     )
+ * ]
+ * ```
+ *
+ * Always pass an instance, as above — never the bare class (or a subclass) to `kbqErrorStateMatcherProvider`.
+ * `scope` has no injection token, so Angular cannot construct this class on its own; passing the class throws
+ * `NG0204` the first time anything injects `ErrorStateMatcher`.
+ *
+ * ## Combining with another matcher
+ *
+ * Cross-field display timing is this class's one job; timing for a control's own, non-cross-field errors is
+ * not, so it is delegated to `own` (default: the plain `ErrorStateMatcher`) rather than hard-coded — pass any
+ * other matcher to combine its timing with cross-field support, instead of subclassing:
+ *
+ * ```typescript
+ * new ShowOnCrossFieldErrorStateMatcher(
+ *     (key) => (key === 'passwordsMismatch' ? ['newPassword', 'confirmPassword'] : null),
+ *     new ShowRequiredOnSubmitErrorStateMatcher()
+ * )
+ * ```
+ */
+declare class ShowOnCrossFieldErrorStateMatcher extends ErrorStateMatcher {
+    private readonly scope;
+    private readonly own;
+    private readonly warned;
+    constructor(scope: CrossFieldErrorScope, own?: ErrorStateMatcher);
+    isErrorState(control: AbstractControl | null, form: FormGroupDirective | NgForm | null): boolean;
+    /**
+     * Whether the controls a cross-field error concerns have been interacted with enough to show it.
+     *
+     * Consulted only while the form has not been submitted — a submit always reveals. A disabled control
+     * counts as satisfied, since it can never be touched by the user. Override to change the rule: when one
+     * end of a range is prefilled and the user is never expected to visit it, waiting for all of them hides
+     * the error until submit, and `controls.some(...)` is the better cue.
+     */
+    protected shouldReveal(controls: AbstractControl[]): boolean;
+    private isCrossFieldErrorState;
+    private isRevealedOn;
+    private resolve;
+}
 
 /** @docs-private */
 interface CanUpdateErrorState {
@@ -727,6 +792,10 @@ type KbqA11yLocaleConfiguration = {
     close: string;
     /** Confirm button of an inline edit. */
     save: string;
+    /** Announced while an inline edit saves a value in the background. */
+    saving: string;
+    /** Announced when a background save of an inline edit fails. */
+    saveFailed: string;
     /** Discard button of an inline edit. */
     cancel: string;
     /** Button removing every notification at once. */
@@ -766,9 +835,10 @@ type KbqActionsPanelLocaleConfiguration = {
     closeTooltip: string;
 };
 /**
- * Locale configuration shared by `KbqSelectModule` and `KbqTreeModule`: `hiddenItemsText` is read by
- * `KbqSelectModule` (`kbq-select`) only, while `selectAll` is read by both `KbqSelectModule` and
- * `KbqTreeModule` (`kbq-tree-selection`, including standalone usage outside `KbqTreeSelectModule`).
+ * Locale configuration shared by the components that render a "select all" row: `hiddenItemsText` is read
+ * by `KbqSelectModule` (`kbq-select`) only, while `selectAll` is read by `KbqSelectModule`, by
+ * `KbqTreeModule` (`kbq-tree-selection`, including standalone usage outside `KbqTreeSelectModule`) and by
+ * `KbqListModule` (`kbq-list-selection`).
  */
 type KbqSelectLocaleConfiguration = {
     /** Counter of the selected values that did not fit into the trigger. Supports the `{{ number }}` placeholder. */
@@ -830,6 +900,11 @@ type KbqTimeRangeLocaleConfig = {
         apply: string;
         cancel: string;
         rangeLabel: string;
+        /**
+         * Reported when both ends of the range leave `minDate`/`maxDate`. Supports the `{{ value }}` placeholder.
+         * Optional, so a configuration written before it existed still compiles and gets the default wording.
+         */
+        outOfBoundsError?: string;
         allTime: string;
         currentQuarter: string;
         currentYear: string;
@@ -881,6 +956,8 @@ declare const enUSLocaleData: {
     a11y: {
         close: string;
         save: string;
+        saving: string;
+        saveFailed: string;
         cancel: string;
         removeAll: string;
         expandBreadcrumbs: string;
@@ -1032,6 +1109,7 @@ declare const enUSLocaleData: {
             apply: string;
             cancel: string;
             rangeLabel: string;
+            outOfBoundsError: string;
             allTime: string;
             currentQuarter: string;
             currentYear: string;
@@ -1084,6 +1162,8 @@ declare const esLALocaleData: {
     a11y: {
         close: string;
         save: string;
+        saving: string;
+        saveFailed: string;
         cancel: string;
         removeAll: string;
         expandBreadcrumbs: string;
@@ -1234,6 +1314,7 @@ declare const esLALocaleData: {
             apply: string;
             cancel: string;
             rangeLabel: string;
+            outOfBoundsError: string;
             allTime: string;
             currentQuarter: string;
             currentYear: string;
@@ -1286,6 +1367,8 @@ declare const ptBRLocaleData: {
     a11y: {
         close: string;
         save: string;
+        saving: string;
+        saveFailed: string;
         cancel: string;
         removeAll: string;
         expandBreadcrumbs: string;
@@ -1436,6 +1519,7 @@ declare const ptBRLocaleData: {
             apply: string;
             cancel: string;
             rangeLabel: string;
+            outOfBoundsError: string;
             allTime: string;
             currentQuarter: string;
             currentYear: string;
@@ -1488,6 +1572,8 @@ declare const ruRULocaleData: {
     a11y: {
         close: string;
         save: string;
+        saving: string;
+        saveFailed: string;
         cancel: string;
         removeAll: string;
         expandBreadcrumbs: string;
@@ -1639,6 +1725,7 @@ declare const ruRULocaleData: {
             apply: string;
             cancel: string;
             rangeLabel: string;
+            outOfBoundsError: string;
             allTime: string;
             currentQuarter: string;
             currentYear: string;
@@ -1691,6 +1778,8 @@ declare const tkTMLocaleData: {
     a11y: {
         close: string;
         save: string;
+        saving: string;
+        saveFailed: string;
         cancel: string;
         removeAll: string;
         expandBreadcrumbs: string;
@@ -1842,6 +1931,7 @@ declare const tkTMLocaleData: {
             apply: string;
             cancel: string;
             rangeLabel: string;
+            outOfBoundsError: string;
             allTime: string;
             currentQuarter: string;
             currentYear: string;
@@ -2126,6 +2216,8 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
         a11y: {
             close: string;
             save: string;
+            saving: string;
+            saveFailed: string;
             cancel: string;
             removeAll: string;
             expandBreadcrumbs: string;
@@ -2277,6 +2369,7 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
                 apply: string;
                 cancel: string;
                 rangeLabel: string;
+                outOfBoundsError: string;
                 allTime: string;
                 currentQuarter: string;
                 currentYear: string;
@@ -2366,6 +2459,8 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
         a11y: {
             close: string;
             save: string;
+            saving: string;
+            saveFailed: string;
             cancel: string;
             removeAll: string;
             expandBreadcrumbs: string;
@@ -2516,6 +2611,7 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
                 apply: string;
                 cancel: string;
                 rangeLabel: string;
+                outOfBoundsError: string;
                 allTime: string;
                 currentQuarter: string;
                 currentYear: string;
@@ -2601,6 +2697,8 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
         a11y: {
             close: string;
             save: string;
+            saving: string;
+            saveFailed: string;
             cancel: string;
             removeAll: string;
             expandBreadcrumbs: string;
@@ -2751,6 +2849,7 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
                 apply: string;
                 cancel: string;
                 rangeLabel: string;
+                outOfBoundsError: string;
                 allTime: string;
                 currentQuarter: string;
                 currentYear: string;
@@ -2841,6 +2940,8 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
         a11y: {
             close: string;
             save: string;
+            saving: string;
+            saveFailed: string;
             cancel: string;
             removeAll: string;
             expandBreadcrumbs: string;
@@ -2992,6 +3093,7 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
                 apply: string;
                 cancel: string;
                 rangeLabel: string;
+                outOfBoundsError: string;
                 allTime: string;
                 currentQuarter: string;
                 currentYear: string;
@@ -3078,6 +3180,8 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
         a11y: {
             close: string;
             save: string;
+            saving: string;
+            saveFailed: string;
             cancel: string;
             removeAll: string;
             expandBreadcrumbs: string;
@@ -3229,6 +3333,7 @@ declare function KBQ_DEFAULT_LOCALE_DATA_FACTORY(): {
                 apply: string;
                 cancel: string;
                 rangeLabel: string;
+                outOfBoundsError: string;
                 allTime: string;
                 currentQuarter: string;
                 currentYear: string;
@@ -4911,6 +5016,34 @@ declare const kbqInjectNativeElement: <T extends Element = HTMLElement>() => T;
  * revealing it would shift the list out from under it.
  */
 declare const kbqFocusAndReveal: (element: HTMLElement, skipReveal?: boolean) => void;
+/** Axis a scroll-overflow check applies to. */
+type KbqScrollAxis = 'horizontal' | 'vertical';
+/**
+ * Largest disagreement (px) between an element's box metrics and the scroll offset the browser actually
+ * hands out.
+ *
+ * `scrollWidth`/`clientWidth` are rounded to whole CSS pixels (up to 1px of error) while the scroll offset
+ * snaps to the device-pixel grid, whose step is `1 / devicePixelRatio` CSS px — so the bound is
+ * `1 + 1 / devicePixelRatio` and widens as the page is zoomed out, rather than being a constant. At 50% zoom
+ * on a 1× display it is already 3px, which is why a fixed tolerance leaks the bug back in at low zoom.
+ *
+ * The view is resolved from the element rather than a global, so the helper stays usable on the server.
+ */
+declare const kbqGetScrollOverflowTolerance: (element: Element) => number;
+/**
+ * Whether `element` has scroll overflow along `axis` larger than the measurement error of the metrics it is
+ * derived from — i.e. whether there is a scroll range the user can actually reach.
+ */
+declare const kbqHasScrollOverflow: (element: Element, axis?: KbqScrollAxis) => boolean;
+/**
+ * Rendered height of an element, or `0` when it has no box.
+ *
+ * `getClientRects()` returns an empty list for elements that are not laid out and is missing entirely
+ * from the server DOM, so both the method and the first rect are read defensively rather than going
+ * through `getBoundingClientRect()`, whose zeroes are indistinguishable from a genuinely collapsed
+ * element.
+ */
+declare const kbqGetElementHeight: (element: Element) => number;
 
 declare function isBoolean(value: unknown): value is boolean;
 /** Whether the value is undefined. */
@@ -5396,6 +5529,14 @@ declare class KbqSelectFooter {
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqSelectFooter, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<KbqSelectFooter, "kbq-select-footer, [kbq-select-footer]", never, {}, {}, never, never, true, never>;
 }
+/**
+ * Action inside a `kbq-select-footer`, drawn as a row of the drop-down menu rather than as a form
+ * button. Apply it to a native `button` or `a` so activation and semantics stay native.
+ */
+declare class KbqSelectFooterItem {
+    static ɵfac: i0.ɵɵFactoryDeclaration<KbqSelectFooterItem, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqSelectFooterItem, "[kbq-select-footer-item]", never, {}, {}, never, never, true, never>;
+}
 declare class KbqSelectSearch implements AfterContentInit, OnDestroy {
     protected formField: KbqFormFieldRef;
     readonly changes: EventEmitter<string>;
@@ -5821,5 +5962,5 @@ declare const validationTooltipHideDelay = 3000;
 
 declare const VERSION: Version;
 
-export { A, ALT, APOSTROPHE, ARROW_BOTTOM_MARGIN_AND_HALF_HEIGHT, AT_SIGN, AbsoluteDateFormatterImpurePipe, AbsoluteDateFormatterPipe, AbsoluteDateShortFormatterImpurePipe, AbsoluteDateShortFormatterPipe, AbsoluteDateTimeFormatterImpurePipe, AbsoluteDateTimeFormatterPipe, AbsoluteShortDateTimeFormatterImpurePipe, AbsoluteShortDateTimeFormatterPipe, ActiveDescendantKeyManager, B, BACKSLASH, BACKSPACE, BOTTOM_LEFT_POSITION_PRIORITY, BOTTOM_POSITION_PRIORITY, BOTTOM_RIGHT_POSITION_PRIORITY, BaseFormatterPipe, BaseLocaleAwareFormatterPipe, C, CAPS_LOCK, CLOSE_SQUARE_BRACKET, COMMA, CONTEXT_MENU, CONTROL, D, DASH, DELETE, DOWN_ARROW, DateAdapter, DateFormatter, DurationLongFormatterImpurePipe, DurationLongFormatterPipe, DurationShortFormatterImpurePipe, DurationShortFormatterPipe, DurationShortestFormatterImpurePipe, DurationShortestFormatterPipe, E, EIGHT, END, ENTER, EQUALS, ESCAPE, EXTENDED_OVERLAY_POSITIONS, EmptyFocusTrapStrategy, ErrorStateMatcher, F, F1, F10, F11, F12, F2, F3, F4, F5, F6, F7, F8, F9, FF_EQUALS, FF_MINUS, FF_MUTE, FF_SEMICOLON, FF_VOLUME_DOWN, FF_VOLUME_UP, FIRST_MEDIA, FIVE, FOUR, FileValidators, FocusKeyManager, G, H, HOME, I, INSERT, J, K, KBQ_A11Y_LOCALE_CONFIGURATION, KBQ_CHECKABLE_CLICK_ACTION, KBQ_CHECKABLE_CONTROL_VALUE_ACCESSOR, KBQ_CONNECTED_OVERLAY_ABOVE_CLASS, KBQ_CONNECTED_OVERLAY_BELOW_CLASS, KBQ_CONNECTED_OVERLAY_ORIGIN, KBQ_CONNECTED_OVERLAY_OVERLAP_CLASS, KBQ_CUSTOM_SCROLL_STRATEGY_PROVIDER, KBQ_DATE_FORMATS, KBQ_DATE_LOCALE, KBQ_DATE_LOCALE_FACTORY, KBQ_DATE_TIMEZONE, KBQ_DEFAULT_LOCALE_DATA_FACTORY, KBQ_DEFAULT_LOCALE_ID, KBQ_DEFAULT_PRECISION_SEPARATOR, KBQ_FORM_FIELD_REF, KBQ_INVALID_VALUE_ERROR, KBQ_LOCALE_DATA, KBQ_LOCALE_ID, KBQ_LOCALE_SERVICE, KBQ_LOCALE_SERVICE_LANG_ATTR_NAME, KBQ_NUMBER_FORMATTER_DEFAULT_OPTIONS, KBQ_NUMBER_FORMATTER_OPTIONS, KBQ_OPTION_ACTION_PARENT, KBQ_OPTION_PARENT_COMPONENT, KBQ_OVERFLOW_SHADOW_SOURCE, KBQ_PANEL_DEFAULT_MIN_WIDTH, KBQ_PARENT_ANIMATION_COMPONENT, KBQ_PARENT_POPUP, KBQ_SELECT_SCROLL_STRATEGY, KBQ_SELECT_SCROLL_STRATEGY_PROVIDER, KBQ_SELECT_SEARCH_MIN_OPTIONS_THRESHOLD, KBQ_SHADOW_DOM_OVERLAY_HOST, KBQ_SIBLING_POPUP, KBQ_SIZE_UNITS_CONFIG, KBQ_SIZE_UNITS_DEFAULT_CONFIG, KBQ_TITLE_TEXT_REF, KBQ_WINDOW, KbqAbsoluteLongDatePipe, KbqAbsoluteLongDateTimePipe, KbqAbsoluteShortDatePipe, KbqAbsoluteShortDateTimePipe, KbqAbstractSelect, KbqActionContainer, KbqAnimationCurves, KbqAnimationDurations, KbqAutoHideScrollStrategy, KbqCheckable, KbqColorDirective, KbqComponentColors, KbqDataSizePipe, KbqDateTimezoneService, KbqDecimalPipe, KbqDefaultThemes, KbqDurationLongPipe, KbqDurationShortPipe, KbqDurationShortestPipe, KbqErrorStateTracker, KbqFieldSizingContent, KbqForm, KbqFormElement, KbqFormattersModule, KbqFormsModule, KbqHighlightBackgroundPipe, KbqHighlightModule, KbqHighlightPipe, KbqHover, KbqLine, KbqLineSetter, KbqLocaleService, KbqLocaleServiceModule, KbqMeasureScrollbarService, KbqMeasurementSystem, KbqNormalizeWhitespace, KbqOptgroup, KbqOption, KbqOptionActionComponent, KbqOptionBase, KbqOptionModule, KbqOptionSelectionChange, KbqOverflowShadowBottom, KbqOverflowShadowContainer, KbqOverflowShadowTop, KbqPopUp, KbqPopUpTrigger, KbqPseudoCheckbox, KbqPseudoCheckboxModule, KbqRangeLongDatePipe, KbqRangeLongDateTimePipe, KbqRangeMiddleDateTimePipe, KbqRangeShortDatePipe, KbqRangeShortDateTimePipe, KbqReadStateDirective, KbqRectangleItem, KbqRelativeLongDatePipe, KbqRelativeLongDateTimePipe, KbqRelativeShortDatePipe, KbqRelativeShortDateTimePipe, KbqRoundDecimalPipe, KbqSelectAllEvent, KbqSelectFooter, KbqSelectMatcher, KbqSelectSearch, KbqSelectSearchEmptyResult, KbqSelectTrigger, KbqShadowDomOverlayContainer, KbqTableNumberPipe, KbqThemeSelector, KbqVirtualOption, L, LAST_MEDIA, LEFT_ARROW, LEFT_BOTTOM_POSITION_PRIORITY, LEFT_POSITION_PRIORITY, LEFT_TOP_POSITION_PRIORITY, ListKeyManager, M, MAC_ENTER, MAC_META, MAC_WK_CMD_LEFT, MAC_WK_CMD_RIGHT, META, MUTE, MockNgZone, MultipleMode, N, NINE, NUMBER_FORMAT_REGEXP, NUMPAD_DIVIDE, NUMPAD_EIGHT, NUMPAD_FIVE, NUMPAD_FOUR, NUMPAD_MINUS, NUMPAD_MULTIPLY, NUMPAD_NINE, NUMPAD_ONE, NUMPAD_PERIOD, NUMPAD_PLUS, NUMPAD_SEVEN, NUMPAD_SIX, NUMPAD_THREE, NUMPAD_TWO, NUMPAD_ZERO, NUM_CENTER, NUM_LOCK, O, ONE, OPEN_SQUARE_BRACKET, P, PAGE_DOWN, PAGE_UP, PAUSE, PERIOD, PLUS_SIGN, POSITION_MAP, POSITION_PRIORITY_STRATEGY, POSITION_TO_CSS_MAP, PRINT_SCREEN, PasswordValidators, PopUpPlacements, PopUpSizes, PopUpTriggers, PopUpVisibility, Q, QUESTION_MARK, R, RIGHT_ARROW, RIGHT_BOTTOM_POSITION_PRIORITY, RIGHT_POSITION_PRIORITY, RIGHT_TOP_POSITION_PRIORITY, RangeDateFormatterImpurePipe, RangeDateFormatterPipe, RangeDateTimeFormatterImpurePipe, RangeDateTimeFormatterPipe, RangeMiddleDateTimeFormatterImpurePipe, RangeMiddleDateTimeFormatterPipe, RangeShortDateFormatterImpurePipe, RangeShortDateFormatterPipe, RangeShortDateTimeFormatterImpurePipe, RangeShortDateTimeFormatterPipe, RelativeDateFormatterImpurePipe, RelativeDateFormatterPipe, RelativeDateTimeFormatterImpurePipe, RelativeDateTimeFormatterPipe, RelativeShortDateFormatterImpurePipe, RelativeShortDateFormatterPipe, RelativeShortDateTimeFormatterImpurePipe, RelativeShortDateTimeFormatterPipe, S, SCROLL_LOCK, SELECT_PANEL_VIEWPORT_PADDING, SEMICOLON, SEVEN, SHIFT, SINGLE_QUOTE, SIX, SLASH, SPACE, ShowOnControlDirtyErrorStateMatcher, ShowOnFormSubmitErrorStateMatcher, ShowRequiredOnSubmitErrorStateMatcher, T, TAB, THREE, TILDE, TOP_LEFT_POSITION_PRIORITY, TOP_POSITION_PRIORITY, TOP_RIGHT_POSITION_PRIORITY, TWO, ThemePalette, ThemeService, TransitionCheckState, U, UP_ARROW, V, VERSION, VOLUME_DOWN, VOLUME_UP, W, X, Y, Z, ZERO, applyPopupMargins, checkAndNormalizeLocalizedNumber, countGroupLabelsBeforeOption, createFakeEvent, createKeyboardEvent, createMouseEvent, createSearchPredicate, createTouchEvent, defaultOffsetY, dispatchEvent, dispatchFakeEvent, dispatchKeyboardEvent, dispatchMouseEvent, dispatchTouchEvent, enUSFormattersData, enUSLocaleData, esLAFormattersData, esLALocaleData, escapeRegExp, fadeAnimation, findSearchMatchRanges, formatNumberWithLocale, getFormattedSizeParts, getHumanizedBytes, getKbqSelectDynamicMultipleError, getKbqSelectNonArrayValueError, getKbqSelectNonFunctionValueError, getNodesWithoutComments, getOptionScrollPosition, getSafeTriangleVertices, getSelectAllState, hasModifierKey, isBoolean, isControl, isCopy, isDigit, isElement, isFunctionKey, isHorizontalMovement, isHtmlElement, isHtmlElementOrNull, isInput, isLeftBracket, isLetterKey, isMac, isNull, isNumberKey, isNumpadKey, isPointInRect, isPointInTriangle, isRightBracket, isSelectAll, isUndefined, isVerticalMovement, isWithin, kbqA11yLocaleConfigurationProvider, kbqAutoHideScrollStrategyFactory, kbqDateTimezoneProvider, kbqErrorStateMatcherProvider, kbqFilesizeFormatterConfigurationProvider, kbqFocusAndReveal, kbqFocusOptionActionOnTab, kbqGetPanelWidthOrigin, kbqHighlightBackgroundMark, kbqHighlightMark, kbqInjectA11yLocaleConfiguration, kbqInjectAutofilled, kbqInjectNativeElement, kbqLocaleServiceLangAttrNameProvider, kbqResolvePanelMaxHeightToken, kbqResolvePanelWidth, kbqResolveTimezoneOffset, kbqRevealSelection, kbqSelectAnimations, kbqSelectScrollStrategyProviderFactory, kbqSetSelectionRange, kbqShadowDomOverlayProvider, kbqSiblingPopupProvider, leftIconClassName, mixinColor, mixinDisabled, mixinErrorState, mixinTabIndex, normalizeNumber, normalizeSearchValue, numberByParts, patchElementFocus, ptBRFormattersData, ptBRLocaleData, rightIconClassName, ruRUFormattersData, ruRULocaleData, runCompareWith, selectEvents, shouldSelectSearchText, tkTMFormattersData, tkTMLocaleData, toggleSelectAll, tokenizeSearchQuery, typeInElement, validationTooltipHideDelay, validationTooltipShowDelay, wrappedErrorMessage };
-export type { CanColor, CanColorCtor, CanDisable, CanDisableCtor, CanUpdateErrorState, CanUpdateErrorStateCtor, HasTabIndex, HasTabIndexCtor, Highlightable, IFocusableOption, KbqA11yLocaleConfiguration, KbqActionsPanelLocaleConfiguration, KbqAutoHideScrollStrategyConfig, KbqAutoHideScrollStrategyHooks, KbqBaseFileUploadLocaleConfig, KbqCheckableClickAction, KbqCheckableClickResult, KbqCheckedState, KbqClampedTextLocaleConfig, KbqCodeBlockLocaleConfiguration, KbqConnectedOverlayOriginProvider, KbqDateFormats, KbqDefaultSizes, KbqEnumValues, KbqFileTypeSpecifier, KbqFileUploadLocaleConfig, KbqFlexDirection, KbqFlexWrap, KbqFormFieldRef, KbqMeasurementSystemType, KbqMultipleFileUploadLocaleConfig, KbqNumberFormatOptions, KbqNumberInputLocaleConfig, KbqNumberRoundingLocaleConfig, KbqNumericPipe, KbqOptionActionParent, KbqOptionParentComponent, KbqOrientation, KbqOverflowShadowSource, KbqOverflowShadowState, KbqPanelMaxHeight, KbqPanelMaxWidth, KbqPanelMinWidth, KbqPanelWidth, KbqPanelWidthOrigin, KbqParentPopup, KbqPoint, KbqPopUpPlacementValues, KbqPopUpSizeValues, KbqPseudoCheckboxState, KbqResolvedPanelWidth, KbqSelectAllAdapter, KbqSelectLocaleConfiguration, KbqShadowDomOverlayHost, KbqSiblingPopup, KbqSizeUnitsConfig, KbqStickToWindowPlacementValues, KbqTheme, KbqTimeRangeLocaleConfig, KbqTimezoneLike, KbqTitleTextRef, KbqToggleSelectAllOptions, KbqTriangle, KbqUnitSystem, KeyboardNavigationHandler, ListKeyManagerModifierKey, ListKeyManagerOption };
+export { A, ALT, APOSTROPHE, ARROW_BOTTOM_MARGIN_AND_HALF_HEIGHT, AT_SIGN, AbsoluteDateFormatterImpurePipe, AbsoluteDateFormatterPipe, AbsoluteDateShortFormatterImpurePipe, AbsoluteDateShortFormatterPipe, AbsoluteDateTimeFormatterImpurePipe, AbsoluteDateTimeFormatterPipe, AbsoluteShortDateTimeFormatterImpurePipe, AbsoluteShortDateTimeFormatterPipe, ActiveDescendantKeyManager, B, BACKSLASH, BACKSPACE, BOTTOM_LEFT_POSITION_PRIORITY, BOTTOM_POSITION_PRIORITY, BOTTOM_RIGHT_POSITION_PRIORITY, BaseFormatterPipe, BaseLocaleAwareFormatterPipe, C, CAPS_LOCK, CLOSE_SQUARE_BRACKET, COMMA, CONTEXT_MENU, CONTROL, D, DASH, DELETE, DOWN_ARROW, DateAdapter, DateFormatter, DurationLongFormatterImpurePipe, DurationLongFormatterPipe, DurationShortFormatterImpurePipe, DurationShortFormatterPipe, DurationShortestFormatterImpurePipe, DurationShortestFormatterPipe, E, EIGHT, END, ENTER, EQUALS, ESCAPE, EXTENDED_OVERLAY_POSITIONS, EmptyFocusTrapStrategy, ErrorStateMatcher, F, F1, F10, F11, F12, F2, F3, F4, F5, F6, F7, F8, F9, FF_EQUALS, FF_MINUS, FF_MUTE, FF_SEMICOLON, FF_VOLUME_DOWN, FF_VOLUME_UP, FIRST_MEDIA, FIVE, FOUR, FileValidators, FocusKeyManager, G, H, HOME, I, INSERT, J, K, KBQ_A11Y_LOCALE_CONFIGURATION, KBQ_CHECKABLE_CLICK_ACTION, KBQ_CHECKABLE_CONTROL_VALUE_ACCESSOR, KBQ_CONNECTED_OVERLAY_ABOVE_CLASS, KBQ_CONNECTED_OVERLAY_BELOW_CLASS, KBQ_CONNECTED_OVERLAY_ORIGIN, KBQ_CONNECTED_OVERLAY_OVERLAP_CLASS, KBQ_CUSTOM_SCROLL_STRATEGY_PROVIDER, KBQ_DATE_FORMATS, KBQ_DATE_LOCALE, KBQ_DATE_LOCALE_FACTORY, KBQ_DATE_TIMEZONE, KBQ_DEFAULT_LOCALE_DATA_FACTORY, KBQ_DEFAULT_LOCALE_ID, KBQ_DEFAULT_PRECISION_SEPARATOR, KBQ_FORM_FIELD_REF, KBQ_INVALID_VALUE_ERROR, KBQ_LOCALE_DATA, KBQ_LOCALE_ID, KBQ_LOCALE_SERVICE, KBQ_LOCALE_SERVICE_LANG_ATTR_NAME, KBQ_NUMBER_FORMATTER_DEFAULT_OPTIONS, KBQ_NUMBER_FORMATTER_OPTIONS, KBQ_OPTION_ACTION_PARENT, KBQ_OPTION_PARENT_COMPONENT, KBQ_OVERFLOW_SHADOW_SOURCE, KBQ_PANEL_DEFAULT_MIN_WIDTH, KBQ_PARENT_ANIMATION_COMPONENT, KBQ_PARENT_POPUP, KBQ_SELECT_SCROLL_STRATEGY, KBQ_SELECT_SCROLL_STRATEGY_PROVIDER, KBQ_SELECT_SEARCH_MIN_OPTIONS_THRESHOLD, KBQ_SHADOW_DOM_OVERLAY_HOST, KBQ_SIBLING_POPUP, KBQ_SIZE_UNITS_CONFIG, KBQ_SIZE_UNITS_DEFAULT_CONFIG, KBQ_TITLE_TEXT_REF, KBQ_WINDOW, KbqAbsoluteLongDatePipe, KbqAbsoluteLongDateTimePipe, KbqAbsoluteShortDatePipe, KbqAbsoluteShortDateTimePipe, KbqAbstractSelect, KbqActionContainer, KbqAnimationCurves, KbqAnimationDurations, KbqAutoHideScrollStrategy, KbqCheckable, KbqColorDirective, KbqComponentColors, KbqDataSizePipe, KbqDateTimezoneService, KbqDecimalPipe, KbqDefaultThemes, KbqDurationLongPipe, KbqDurationShortPipe, KbqDurationShortestPipe, KbqErrorStateTracker, KbqFieldSizingContent, KbqForm, KbqFormElement, KbqFormattersModule, KbqFormsModule, KbqHighlightBackgroundPipe, KbqHighlightModule, KbqHighlightPipe, KbqHover, KbqLine, KbqLineSetter, KbqLocaleService, KbqLocaleServiceModule, KbqMeasureScrollbarService, KbqMeasurementSystem, KbqNormalizeWhitespace, KbqOptgroup, KbqOption, KbqOptionActionComponent, KbqOptionBase, KbqOptionModule, KbqOptionSelectionChange, KbqOverflowShadowBottom, KbqOverflowShadowContainer, KbqOverflowShadowTop, KbqPopUp, KbqPopUpTrigger, KbqPseudoCheckbox, KbqPseudoCheckboxModule, KbqRangeLongDatePipe, KbqRangeLongDateTimePipe, KbqRangeMiddleDateTimePipe, KbqRangeShortDatePipe, KbqRangeShortDateTimePipe, KbqReadStateDirective, KbqRectangleItem, KbqRelativeLongDatePipe, KbqRelativeLongDateTimePipe, KbqRelativeShortDatePipe, KbqRelativeShortDateTimePipe, KbqRoundDecimalPipe, KbqSelectAllEvent, KbqSelectFooter, KbqSelectFooterItem, KbqSelectMatcher, KbqSelectSearch, KbqSelectSearchEmptyResult, KbqSelectTrigger, KbqShadowDomOverlayContainer, KbqTableNumberPipe, KbqThemeSelector, KbqVirtualOption, L, LAST_MEDIA, LEFT_ARROW, LEFT_BOTTOM_POSITION_PRIORITY, LEFT_POSITION_PRIORITY, LEFT_TOP_POSITION_PRIORITY, ListKeyManager, M, MAC_ENTER, MAC_META, MAC_WK_CMD_LEFT, MAC_WK_CMD_RIGHT, META, MUTE, MockNgZone, MultipleMode, N, NINE, NUMBER_FORMAT_REGEXP, NUMPAD_DIVIDE, NUMPAD_EIGHT, NUMPAD_FIVE, NUMPAD_FOUR, NUMPAD_MINUS, NUMPAD_MULTIPLY, NUMPAD_NINE, NUMPAD_ONE, NUMPAD_PERIOD, NUMPAD_PLUS, NUMPAD_SEVEN, NUMPAD_SIX, NUMPAD_THREE, NUMPAD_TWO, NUMPAD_ZERO, NUM_CENTER, NUM_LOCK, O, ONE, OPEN_SQUARE_BRACKET, P, PAGE_DOWN, PAGE_UP, PAUSE, PERIOD, PLUS_SIGN, POSITION_MAP, POSITION_PRIORITY_STRATEGY, POSITION_TO_CSS_MAP, PRINT_SCREEN, PasswordValidators, PopUpPlacements, PopUpSizes, PopUpTriggers, PopUpVisibility, Q, QUESTION_MARK, R, RIGHT_ARROW, RIGHT_BOTTOM_POSITION_PRIORITY, RIGHT_POSITION_PRIORITY, RIGHT_TOP_POSITION_PRIORITY, RangeDateFormatterImpurePipe, RangeDateFormatterPipe, RangeDateTimeFormatterImpurePipe, RangeDateTimeFormatterPipe, RangeMiddleDateTimeFormatterImpurePipe, RangeMiddleDateTimeFormatterPipe, RangeShortDateFormatterImpurePipe, RangeShortDateFormatterPipe, RangeShortDateTimeFormatterImpurePipe, RangeShortDateTimeFormatterPipe, RelativeDateFormatterImpurePipe, RelativeDateFormatterPipe, RelativeDateTimeFormatterImpurePipe, RelativeDateTimeFormatterPipe, RelativeShortDateFormatterImpurePipe, RelativeShortDateFormatterPipe, RelativeShortDateTimeFormatterImpurePipe, RelativeShortDateTimeFormatterPipe, S, SCROLL_LOCK, SELECT_PANEL_VIEWPORT_PADDING, SEMICOLON, SEVEN, SHIFT, SINGLE_QUOTE, SIX, SLASH, SPACE, ShowOnControlDirtyErrorStateMatcher, ShowOnCrossFieldErrorStateMatcher, ShowOnFormSubmitErrorStateMatcher, ShowRequiredOnSubmitErrorStateMatcher, T, TAB, THREE, TILDE, TOP_LEFT_POSITION_PRIORITY, TOP_POSITION_PRIORITY, TOP_RIGHT_POSITION_PRIORITY, TWO, ThemePalette, ThemeService, TransitionCheckState, U, UP_ARROW, V, VERSION, VOLUME_DOWN, VOLUME_UP, W, X, Y, Z, ZERO, applyPopupMargins, checkAndNormalizeLocalizedNumber, countGroupLabelsBeforeOption, createFakeEvent, createKeyboardEvent, createMouseEvent, createSearchPredicate, createTouchEvent, defaultOffsetY, dispatchEvent, dispatchFakeEvent, dispatchKeyboardEvent, dispatchMouseEvent, dispatchTouchEvent, enUSFormattersData, enUSLocaleData, esLAFormattersData, esLALocaleData, escapeRegExp, fadeAnimation, findSearchMatchRanges, formatNumberWithLocale, getFormattedSizeParts, getHumanizedBytes, getKbqSelectDynamicMultipleError, getKbqSelectNonArrayValueError, getKbqSelectNonFunctionValueError, getNodesWithoutComments, getOptionScrollPosition, getSafeTriangleVertices, getSelectAllState, hasModifierKey, isBoolean, isControl, isCopy, isDigit, isElement, isFunctionKey, isHorizontalMovement, isHtmlElement, isHtmlElementOrNull, isInput, isLeftBracket, isLetterKey, isMac, isNull, isNumberKey, isNumpadKey, isPointInRect, isPointInTriangle, isRightBracket, isSelectAll, isUndefined, isVerticalMovement, isWithin, kbqA11yLocaleConfigurationProvider, kbqAutoHideScrollStrategyFactory, kbqDateTimezoneProvider, kbqErrorStateMatcherProvider, kbqFilesizeFormatterConfigurationProvider, kbqFocusAndReveal, kbqFocusOptionActionOnTab, kbqGetElementHeight, kbqGetPanelWidthOrigin, kbqGetScrollOverflowTolerance, kbqHasScrollOverflow, kbqHighlightBackgroundMark, kbqHighlightMark, kbqInjectA11yLocaleConfiguration, kbqInjectAutofilled, kbqInjectNativeElement, kbqLocaleServiceLangAttrNameProvider, kbqResolvePanelMaxHeightToken, kbqResolvePanelWidth, kbqResolveTimezoneOffset, kbqRevealSelection, kbqSelectAnimations, kbqSelectScrollStrategyProviderFactory, kbqSetSelectionRange, kbqShadowDomOverlayProvider, kbqSiblingPopupProvider, leftIconClassName, mixinColor, mixinDisabled, mixinErrorState, mixinTabIndex, normalizeNumber, normalizeSearchValue, numberByParts, patchElementFocus, ptBRFormattersData, ptBRLocaleData, rightIconClassName, ruRUFormattersData, ruRULocaleData, runCompareWith, selectEvents, shouldSelectSearchText, tkTMFormattersData, tkTMLocaleData, toggleSelectAll, tokenizeSearchQuery, typeInElement, validationTooltipHideDelay, validationTooltipShowDelay, wrappedErrorMessage };
+export type { CanColor, CanColorCtor, CanDisable, CanDisableCtor, CanUpdateErrorState, CanUpdateErrorStateCtor, CrossFieldErrorScope, HasTabIndex, HasTabIndexCtor, Highlightable, IFocusableOption, KbqA11yLocaleConfiguration, KbqActionsPanelLocaleConfiguration, KbqAutoHideScrollStrategyConfig, KbqAutoHideScrollStrategyHooks, KbqBaseFileUploadLocaleConfig, KbqCheckableClickAction, KbqCheckableClickResult, KbqCheckedState, KbqClampedTextLocaleConfig, KbqCodeBlockLocaleConfiguration, KbqConnectedOverlayOriginProvider, KbqDateFormats, KbqDefaultSizes, KbqEnumValues, KbqFileTypeSpecifier, KbqFileUploadLocaleConfig, KbqFlexDirection, KbqFlexWrap, KbqFormFieldRef, KbqMeasurementSystemType, KbqMultipleFileUploadLocaleConfig, KbqNumberFormatOptions, KbqNumberInputLocaleConfig, KbqNumberRoundingLocaleConfig, KbqNumericPipe, KbqOptionActionParent, KbqOptionParentComponent, KbqOrientation, KbqOverflowShadowSource, KbqOverflowShadowState, KbqPanelMaxHeight, KbqPanelMaxWidth, KbqPanelMinWidth, KbqPanelWidth, KbqPanelWidthOrigin, KbqParentPopup, KbqPoint, KbqPopUpPlacementValues, KbqPopUpSizeValues, KbqPseudoCheckboxState, KbqResolvedPanelWidth, KbqScrollAxis, KbqSelectAllAdapter, KbqSelectLocaleConfiguration, KbqShadowDomOverlayHost, KbqSiblingPopup, KbqSizeUnitsConfig, KbqStickToWindowPlacementValues, KbqTheme, KbqTimeRangeLocaleConfig, KbqTimezoneLike, KbqTitleTextRef, KbqToggleSelectAllOptions, KbqTriangle, KbqUnitSystem, KeyboardNavigationHandler, ListKeyManagerModifierKey, ListKeyManagerOption };

package/core/option/_option-theme.scss

@@ -87,6 +87,9 @@
         @include kbq-typography-level-to-styles-css-variables(typography, text-normal);
     }
 
+    // Ties with `kbq-normalize-text()`'s `& > * { font-size: inherit }` and wins only on source order,
+    // so keep this mixin included after `.kbq-option-text`.
+    .kbq-option-caption,
     .kbq-list-option-caption {
         @include kbq-typography-level-to-styles-css-variables(typography, text-compact);
     }

package/core/styles/common/_select.scss

@@ -234,6 +234,9 @@
     overflow: hidden auto;
 }
 
+// The tokens are left undeclared: the value lives in the fallback, so one override reaches every panel
+// that extends this placeholder — the dropdown and the autocomplete included. Declaring them in
+// `select-tokens.scss` would scope them to `.kbq-select__panel` and put those two out of reach.
 %kbq-select-footer {
     @include vendor-prefixes.user-select(none);
 
@@ -241,14 +244,61 @@
     align-items: center;
     box-sizing: border-box;
 
-    min-height: 40px;
+    min-height: var(--kbq-select-footer-size-min-height, var(--kbq-size-4xl));
 
-    border-top-width: 1px;
+    border-top-width: var(--kbq-select-footer-size-border-width, var(--kbq-size-border-width));
     border-top-style: solid;
 
-    padding: var(--kbq-size-xxs) var(--kbq-size-l);
+    padding: var(--kbq-select-footer-size-padding-vertical, var(--kbq-size-xxs))
+        var(--kbq-select-footer-size-padding-horizontal, var(--kbq-size-l));
 }
 
+// The footer's action is drawn as a row of the drop-down menu rather than as a form button: full
+// panel width, the option's own box and hover fill, so it reads as the last entry of the list
+// instead of a control parked underneath it.
+%kbq-select-footer-item {
+    @include vendor-prefixes.user-select(none);
+
+    // A native `button`/`a` flashes on tap without this; `kbq-list-item-base()`, which the option rows
+    // above use, is not included because the row zeroes the vertical padding that mixin sets.
+    -webkit-tap-highlight-color: transparent;
+
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    box-sizing: border-box;
+    outline: none;
+
+    // `flex-grow` rather than `width: 100%`: alone in the footer it fills the content box just the same,
+    // but it shares the row instead of squeezing a caption or a second action out of it. The basis stays
+    // `auto` — `flex: 1` would expand to a `0%` basis and hand two actions the same width whatever they
+    // say.
+    flex: 1 1 auto;
+    min-height: var(--kbq-select-footer-item-size-height, var(--kbq-size-3xl));
+    gap: var(--kbq-size-s);
+
+    // Transparent border, as on an option, so the row keeps the same content inset — and so the focus
+    // ring below can recolour it without shifting anything.
+    border: var(--kbq-size-3xs) solid transparent;
+    border-radius: var(--kbq-select-footer-item-size-border-radius, var(--kbq-size-xxs));
+
+    padding: 0 kbq-difference-series-css-variables([size-m, size-3xs]);
+
+    background: transparent;
+    cursor: pointer;
+
+    text-align: left;
+    text-decoration: none;
+}
+
+// Extends an item's hit area past the box it paints, with a transparent pseudo-element on the element
+// that owns the click handler — a pseudo-element is hit-tested as part of that element, so hover and
+// click both reach the gutter with no TS and no `z-index`. This one claims a fixed strip either side of
+// a plain vertical list. The same technique, sized differently, is hand-rolled where the geometry does
+// not fit: `.kbq-navbar-item`'s `:before` cancels the item's own margin (DS-2558), and
+// `--kbq-button-toggle-size-item-hit-area-*` tiles a group's `gap` between two neighbours and hands the
+// group's padding to the outermost items, per orientation (DS-4164). Any clipping ancestor eats all of
+// them — see the note on `.kbq-button-toggle`'s `overflow`.
 @mixin item-active-area($outline) {
     position: relative;
 
@@ -268,3 +318,48 @@
         left: calc(100% + $outline); // outline size
     }
 }
+
+// A mixin of its own: the row's structure is only extended under `.kbq-select__panel`, and emitting its
+// colours anywhere else would paint a half-styled control.
+@mixin kbq-select-footer-item-theme() {
+    .kbq-select__footer-item {
+        color: var(--kbq-foreground-contrast);
+
+        // The row is reachable with TAB, so it needs a focus indicator of its own; `outline: none` in
+        // the structural rule would otherwise leave it with none at all. Recolouring the 2px layout
+        // border is the whole ring — adding an outline on top of it would render 3px, half again as
+        // thick as every other focused control (a button pairs a 1px border with a 1px outline).
+        &:focus-visible {
+            border-color: var(--kbq-states-line-focus-theme);
+        }
+
+        // `:disabled` alone would miss an `a`, which the directive also supports and which cannot carry
+        // the attribute — those are marked with `.kbq-disabled`, as `.kbq-option` and `.kbq-dropdown-item` are.
+        &:hover:not(:disabled, .kbq-disabled) {
+            background: var(--kbq-states-background-transparent-hover);
+        }
+
+        &:active:not(:disabled, .kbq-disabled) {
+            background: var(--kbq-states-background-transparent-active);
+        }
+
+        &:disabled,
+        &.kbq-disabled {
+            color: var(--kbq-states-foreground-disabled);
+            cursor: default;
+
+            // A native `button` ignores the pointer once it carries `disabled`, but an `a` cannot carry the
+            // attribute, so the class has to do it — otherwise a greyed-out link still navigates on a click
+            // and closes the panel on the way. Same pair `kbq-link` uses for its own disabled state.
+            pointer-events: none;
+
+            // `.kbq-icon` is coloured from an absolute token rather than `currentColor`, so a projected
+            // icon would stay at full contrast beside a greyed label. Only the ones left at the default
+            // colour: `.kbq-empty` is what `KbqColorDirective` leaves behind when the consumer set none,
+            // and an icon button carries its own disabled state.
+            & .kbq-icon.kbq-empty:not(.kbq-icon-button, .kbq-icon-item) {
+                color: var(--kbq-states-foreground-disabled);
+            }
+        }
+    }
+}

package/core/styles/typography/_typography.scss

@@ -239,6 +239,10 @@
         @include kbq-typography-level-to-styles-css-variables(typography, mono-normal-strong);
     }
 
+    .kbq-mono-normal-medium {
+        @include kbq-typography-level-to-styles-css-variables(typography, mono-normal-medium);
+    }
+
     .kbq-mono-compact {
         @include kbq-typography-level-to-styles-css-variables(typography, mono-compact);
     }
@@ -247,6 +251,10 @@
         @include kbq-typography-level-to-styles-css-variables(typography, mono-compact-strong);
     }
 
+    .kbq-mono-codeblock {
+        @include kbq-typography-level-to-styles-css-variables(typography, mono-codeblock);
+    }
+
     .kbq-tabular-big {
         @include kbq-typography-level-to-styles-css-variables(typography, tabular-big);
     }

package/ellipsis-center/ellipsis-center.scss

@@ -0,0 +1,31 @@
+// Layout contract for the two spans `KbqEllipsisCenterDirective` renders. Loaded once by the directive
+// itself through `_CdkPrivateStyleLoader`, so a host no longer copies these declarations — every copy was a
+// chance for the directive to behave differently depending on where it was used.
+.kbq-ellipsis-center {
+    position: relative;
+    display: flex;
+
+    // The split point is measured against the host's own `clientWidth`, so the host must not grow to fit the
+    // text it is about to shorten — a shrink-to-fit host measures the full width, concludes everything fits,
+    // and leaves the text unsplit and overflowing. `min-width: 0` opts out of the `auto` minimum a flex item
+    // would otherwise inherit from the non-shrinkable end span.
+    max-width: 100%;
+    min-width: 0;
+    overflow: hidden;
+
+    .kbq-ellipsis-center_data-text-start {
+        // The only half that shrinks, and the only one carrying `text-overflow` — unsplit text lands here.
+        flex: 0 1 auto;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: pre;
+    }
+
+    .kbq-ellipsis-center_data-text-end {
+        // Holds the tail the split exists to keep visible (the file extension, the trailing digits), so it
+        // must not shrink; the directive sizes it from the width the text actually rendered at.
+        flex: 1 0 auto;
+        overflow: hidden;
+        white-space: pre;
+    }
+}

package/ellipsis-center/index.d.ts

@@ -3,20 +3,53 @@ import { OnInit, AfterViewInit, OnDestroy } from '@angular/core';
 import { KbqTooltipTrigger } from '@koobiq/components/tooltip';
 import { Subject } from 'rxjs';
 
+/**
+ * Renders text as two spans and moves the ellipsis into the middle, so the tail — a file extension, the
+ * digits that tell two reports apart — stays readable when the host is too narrow for the whole string. A
+ * tooltip spells out the full text, and is enabled only while something is actually hidden.
+ */
 declare class KbqEllipsisCenterDirective extends KbqTooltipTrigger implements OnInit, AfterViewInit, OnDestroy {
     private cdr;
+    /**
+     * Application-wide `ResizeObserver` shared by every consumer, as `KbqTitleDirective` uses. Unlike the
+     * `window:resize` listener this directive used to carry, it also reacts to container-only resizes — a
+     * splitter drag, a sidebar collapse, or the vertical scrollbar that appears once a file list fills up —
+     * none of which resize the window, all of which change where the text has to be split.
+     */
+    private readonly resizeObserver;
+    /** The two spans this directive renders have no styles of their own until this is loaded. */
+    private readonly styleLoader;
     set kbqEllipsisCenter(value: string);
+    /**
+     * Shortest text worth splitting in the middle. Anything below it keeps its natural order and is cut off
+     * at the end by the host's own `text-overflow`.
+     *
+     * Defaults to `0` — every overflowing text is split — because that is what the directive has always
+     * done: the input was declared but never read, so any other default would silently end-truncate labels
+     * that consumers expect to see split.
+     */
     readonly minVisibleLength: i0.InputSignal<number>;
+    /**
+     * Lower bound, in pixels, for the average glyph width used to decide how many characters fit in the
+     * tail. The rendered text is measured as well and the wider of the two wins, so an underestimate here
+     * can no longer push the extension out of the tail — raising it only shortens the tail further.
+     */
     readonly charWidth: i0.InputSignal<number>;
     /**
      * Debounce time (ms) for resize events before recalculating ellipsis position.
      * @default 50
      */
     readonly debounceInterval: i0.InputSignalWithTransform<number, unknown>;
-    /** @docs-private */
+    /**
+     * @deprecated No longer read. Resizes now come from the shared `ResizeObserver`, which also catches the
+     * container-only ones a `window:resize` listener cannot see; the host listener that used to feed this
+     * subject is gone, and nothing subscribes to it. Kept as a no-op and removed in the next major version.
+     * @docs-private */
     readonly resizeStream: Subject<Event>;
     private _kbqEllipsisCenter;
-    private resizeSubscription;
+    private lastMeasuredWidth;
+    private refreshTimeoutId;
+    constructor();
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;