asksuite-citrus 3.20.5 → 3.20.7

package/lib/components/combobox-v2/combobox-v2.component.d.ts

@@ -1,11 +1,13 @@
-import { ElementRef, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { SelectV2Option } from '../select-v2/select-v2.component';
 import { MenuSpacing } from '../menu/menu.component';
 import { CompareWithFn } from '../select-v2/base-multi-select';
 import * as i0 from "@angular/core";
-export declare class ComboboxV2Component implements ControlValueAccessor, OnChanges {
+export declare class ComboboxV2Component implements ControlValueAccessor, OnChanges, AfterViewInit, OnDestroy {
     private elementRef;
+    private zone;
+    private cdr;
     value: any;
     options: SelectV2Option[];
     placeholder: string;
@@ -16,18 +18,30 @@ export declare class ComboboxV2Component implements ControlValueAccessor, OnChan
     menuSpacing: MenuSpacing;
     multiple: boolean;
     maxTagWidth: number;
-    overflowThreshold: number;
+    /**
+     * @deprecated Chips now auto-fit the available trigger width. When set, acts as a
+     * hard CAP: shows at most this many chips even if more would fit.
+     */
+    overflowThreshold?: number;
     compareWith: CompareWithFn<any>;
     valueChange: EventEmitter<any>;
     selectionChange: EventEmitter<any>;
     menuSearchInput?: ElementRef<HTMLInputElement>;
+    private tagGroupRef?;
+    private measureRowRef?;
     search: string;
     showList: boolean;
     /** Index (within filteredOptions) of the keyboard-highlighted option; -1 = none. */
     activeIndex: number;
     /** Multi mode only — internal source of truth. */
     selectedValues: any[];
-    constructor(elementRef: ElementRef);
+    /** null = not measured yet → show all (clipped by overflow:hidden for a frame at most). */
+    private fitCount;
+    private measurer;
+    constructor(elementRef: ElementRef, zone: NgZone, cdr: ChangeDetectorRef);
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private readChipMeasurement;
     ngOnChanges(changes: SimpleChanges): void;
     get selectedOption(): SelectV2Option | undefined;
     get selectedOptions(): SelectV2Option[];

package/lib/components/select-v2/base-multi-select.d.ts

@@ -12,6 +12,20 @@ export declare function computeOverflow<T>(values: T[], threshold: number): {
     visible: T[];
     overflowCount: number;
 };
+/** Keep in sync with `gap: 4px` on `__tag-group` in select-v2 / combobox-v2 scss. */
+export declare const CHIP_GAP_PX = 4;
+export interface WidthOverflowResult {
+    visibleCount: number;
+    overflowCount: number;
+}
+/**
+ * Fits as many chips as possible in `containerWidth` (greedy, in order).
+ * - When ALL chips fit, no space is reserved for the `+N` chip.
+ * - Otherwise reserves `plusNWidth` and packs chips until the next one wouldn't fit.
+ * - Always keeps at least 1 chip visible — when even `chip[0] + gap + plusN` doesn't
+ *   fit, CSS degrades gracefully (the chip ellipsizes, the group clips overflow).
+ */
+export declare function computeWidthOverflow(chipWidths: number[], containerWidth: number, gap: number, plusNWidth: number): WidthOverflowResult;
 /** Normalizes the value coming from `writeValue`/`@Input value` into an internal array. */
 export declare function rehydrate<T>(raw: T | T[] | null | undefined, multiple: boolean): T[];
 /** Converts the internal array back to the shape consumers expect (scalar vs array). */

package/lib/components/select-v2/chip-overflow-measurer.d.ts

@@ -0,0 +1,32 @@
+import { NgZone } from '@angular/core';
+export interface ChipMeasurement {
+    containerWidth: number;
+    chipWidths: number[];
+    plusNWidth: number;
+}
+/**
+ * Shared by `ask-select-v2` and `ask-combobox-v2`: watches the trigger width and
+ * recomputes how many chips fit, outside the Angular zone. Re-enters the zone only
+ * when the fitted count actually changes — this keeps ResizeObserver/rAF callbacks
+ * from churning change detection or creating measure→render→measure loops.
+ */
+export declare class ChipOverflowMeasurer {
+    private zone;
+    /** Reads the DOM. Return null when there's nothing to measure (e.g. single mode). */
+    private read;
+    /** Called inside the zone, only when the fitted count changes. */
+    private apply;
+    private resizeObserver?;
+    private rafId;
+    private lastApplied;
+    constructor(zone: NgZone, 
+    /** Reads the DOM. Return null when there's nothing to measure (e.g. single mode). */
+    read: () => ChipMeasurement | null, 
+    /** Called inside the zone, only when the fitted count changes. */
+    apply: (visibleCount: number) => void);
+    observe(container: HTMLElement): void;
+    /** rAF-debounced so a selection change + resize coalesce into one measurement. */
+    schedule(): void;
+    private measureNow;
+    destroy(): void;
+}

package/lib/components/select-v2/select-v2.component.d.ts

@@ -1,4 +1,4 @@
-import { ElementRef, EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import { AfterViewInit, ChangeDetectorRef, ElementRef, EventEmitter, NgZone, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { MenuSpacing } from '../menu/menu.component';
 import { CompareWithFn } from './base-multi-select';
@@ -8,8 +8,10 @@ export interface SelectV2Option {
     label: string;
     disabled?: boolean;
 }
-export declare class SelectV2Component implements ControlValueAccessor, OnChanges {
+export declare class SelectV2Component implements ControlValueAccessor, OnChanges, AfterViewInit, OnDestroy {
     private elementRef;
+    private zone;
+    private cdr;
     value: any;
     options: SelectV2Option[];
     placeholder: string;
@@ -21,15 +23,27 @@ export declare class SelectV2Component implements ControlValueAccessor, OnChange
     /** Multi-select mode: trigger shows tags + `+N` overflow, menu items toggle on click. */
     multiple: boolean;
     maxTagWidth: number;
-    overflowThreshold: number;
+    /**
+     * @deprecated Chips now auto-fit the available trigger width. When set, acts as a
+     * hard CAP: shows at most this many chips even if more would fit.
+     */
+    overflowThreshold?: number;
     compareWith: CompareWithFn<any>;
     valueChange: EventEmitter<any>;
     selectionChange: EventEmitter<any>;
     showList: boolean;
     /** Multi mode only — internal source of truth. Single mode keeps using `value`. */
     selectedValues: any[];
-    constructor(elementRef: ElementRef);
+    private tagGroupRef?;
+    private measureRowRef?;
+    /** null = not measured yet → show all (clipped by overflow:hidden for a frame at most). */
+    private fitCount;
+    private measurer;
+    constructor(elementRef: ElementRef, zone: NgZone, cdr: ChangeDetectorRef);
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private readChipMeasurement;
     get selectedOption(): SelectV2Option | undefined;
     /** Multi mode: ordered list of selected options resolved against `options`. */
     get selectedOptions(): SelectV2Option[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asksuite-citrus",
-  "version": "3.20.5",
+  "version": "3.20.7",
   "peerDependencies": {
     "@angular/common": "^17.3.7",
     "@angular/core": "^17.3.7",