@mozaic-ds/angular 2.1.3 → 2.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozaic-ds/angular",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "type": "module",
   "peerDependencies": {
     "@angular/common": ">=20.3.15",

package/types/mozaic-ds-angular.d.ts

@@ -8,6 +8,7 @@ import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
 import { CdkPortalOutlet } from '@angular/cdk/portal';
 import * as _mozaic_ds_angular from '@mozaic-ds/angular';
+import { CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
 import { ComponentHarness } from '@angular/cdk/testing';
 
 type MozBreadcrumbAppearance = 'standard' | 'inverse';
@@ -2316,11 +2317,8 @@ declare function isFlatOption<T>(item: FlatItem<T>): item is FlatOption<T>;
 declare class MozComboboxComponent<T = string> implements ControlValueAccessor {
     private readonly _doc;
     private readonly _overlay;
-    private readonly _appRef;
-    /** rAF handle for the scroll-driven change-detection loop (see _kickViewportTick). */
-    private _viewportTickRaf;
-    /** Timestamp of the last viewport scroll event, used to stop the tick loop when idle. */
-    private _lastViewportScrollTs;
+    /** Timestamp of the last viewport re-measure, to throttle onViewportScroll(). */
+    private _lastViewportSync;
     /**
      * No-op scroll strategy: the dropdown embeds a CDK virtual-scroll viewport,
      * which is a global `CdkScrollable`. With the default `reposition` strategy,
@@ -2470,14 +2468,29 @@ declare class MozComboboxComponent<T = string> implements ControlValueAccessor {
     onOverlayOutsideClick(): void;
     onOverlayAttached(): void;
     /**
-     * Drive change detection for a short window after a viewport scroll so the
-     * CDK virtual-scroll viewport (inside the overlay portal) applies its content
-     * transform in zoneless mode. Runs at most one rAF loop at a time; each new
-     * scroll event extends the window, and the loop stops ~200ms after the last
-     * scroll. `tick()` is guarded because it throws if called during an ongoing
-     * change-detection pass (it never is here — rAF callbacks run outside CD).
-     */
-    private _kickViewportTick;
+     * Zoneless fix for the virtual-scroll viewport.
+     *
+     * On Angular/CDK 22 in zoneless mode the viewport never recomputes its
+     * rendered range while the user scrolls: `onContentScrolled` doesn't refresh
+     * the window and the content transform stays frozen, so the panel "bounces"
+     * and never reaches the bottom of the list. (CDK 21 used a different path and
+     * was unaffected — hence Storybook on 21 looked fine while the 22 consumer
+     * bounced.) Calling the viewport's public `checkViewportSize()` re-measures
+     * and re-renders the correct window; it is idempotent at a valid scroll
+     * position (verified — repeated calls don't move the scroll), so there is no
+     * feedback loop. The handler receives the viewport through the `#viewport`
+     * template reference, which resolves correctly even though the viewport lives
+     * in the overlay portal (unlike `viewChild`).
+     *
+     * Throttled to ~one re-measure per frame (16 ms). Browsers already coalesce
+     * scroll events to roughly one per animation frame — even for a high-frequency
+     * trackpad / momentum scroll — but the throttle is a defensive cap so this
+     * synchronous reflow can never be called in a tight burst. `checkViewportSize()`
+     * is idempotent at a valid scroll offset (verified on the real CDK 22 zoneless
+     * runtime — repeated calls don't move the scroll), so it never fights the
+     * scroll position and there is no feedback loop.
+     */
+    onViewportScroll(viewport: CdkVirtualScrollViewport): void;
     /** Coerce the current value into an array (safe for .some/.filter/.every). */
     private _currentValueAsArray;
     writeValue(val: T | T[] | null): void;
@@ -2487,6 +2500,8 @@ declare class MozComboboxComponent<T = string> implements ControlValueAccessor {
     readonly isFlatSection: typeof isFlatSection;
     readonly isFlatOption: typeof isFlatOption;
     readonly itemSizePx = 48;
+    readonly minBufferPx: number;
+    readonly maxBufferPx: number;
     trackByFlatItem(_index: number, item: FlatItem<T>): string;
     /** Set of currently selected values, recomputed reactively for OnPush */
     readonly selectedValues: _angular_core.Signal<T[]>;