@mozaic-ds/angular 2.1.2 → 2.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozaic-ds/angular",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "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,7 +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 _cdr;
+    /** 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,
@@ -2465,6 +2467,30 @@ declare class MozComboboxComponent<T = string> implements ControlValueAccessor {
     onSearchKeydown(event: KeyboardEvent): void;
     onOverlayOutsideClick(): void;
     onOverlayAttached(): void;
+    /**
+     * 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;