@genesislcap/foundation-ui 14.488.2 → 14.489.0-GENC-1351.10

package/dist/dts/combobox/combobox.d.ts

@@ -5,6 +5,7 @@ import { FilterMode } from './combobox.types';
  * @tagname %%prefix%%-combobox
  *
  * @fires change - Fired when a selection is confirmed in autocomplete-both mode
+ * @fires open-change - Fired when the dropdown opens or closes. detail: `OpenChangeEventDetail`
  */
 export declare class Combobox extends FASTComboBox {
     #private;
@@ -12,6 +13,16 @@ export declare class Combobox extends FASTComboBox {
     private needManualChangeEventDispatch;
     get activeDescendant(): string;
     slottedDatasource: HTMLSlotElement;
+    /**
+     * Enables server-side filtering: typed input refetches from the server with a criteria
+     * instead of filtering the already-loaded options client-side.
+     *
+     * @remarks
+     * Automatically forced to `true` (overriding an explicit `async="false"`) when the
+     * slotted datasource has `infinite-scroll` enabled — see
+     * {@link Combobox.enableAsyncForInfiniteScrollDatasource}. With only a page of the
+     * resource loaded, client-side filtering would silently only search that page.
+     */
     async: boolean;
     debounce: number;
     debounceChanged(oldValue: any, newValue: number): void;
@@ -42,10 +53,24 @@ export declare class Combobox extends FASTComboBox {
      * @experimental
      */
     scrollWhenSelectionChangesOptions: boolean | ScrollIntoViewOptions;
+    /**
+     * The scrollable element hosting the dropdown options. Part of the public contract for
+     * slotted datasources (e.g. options-datasource infinite scroll) to observe scrolling.
+     * @public
+     */
+    get scrollableListbox(): HTMLElement | null;
     openChanged(): void;
     get value(): string;
     set value(next: string);
     slottedOptionsChanged(prev: Element[] | undefined, next: Element[]): void;
+    /**
+     * When the slotted datasource pages its options (infinite scroll), only a page of the
+     * resource is loaded client-side, so filtering typed input locally is meaningless.
+     * Switch to async mode so input refetches from the server with a criteria instead;
+     * further pages honour that criteria. This overrides an explicit `async="false"` on
+     * the combobox — infinite-scroll datasources cannot support client-side filtering.
+     */
+    private enableAsyncForInfiniteScrollDatasource;
     filterOptions(): void;
     clickHandler(e: MouseEvent): boolean | void;
     keydownHandler(e: KeyboardEvent): boolean | void;

package/dist/dts/combobox/combobox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAalE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,YAAY;;IACxC,OAAO,CAAC,SAAS,CAAS;IAI1B,OAAO,CAAC,6BAA6B,CAAkB;IACvD,IACI,gBAAgB,WAKnB;IAEW,iBAAiB,EAAE,eAAe,CAAC;IACpB,KAAK,UAAS;IACnC,QAAQ,EAAE,MAAM,CAAiB;IACvC,eAAe,CAAC,QAAQ,KAAA,EAAE,QAAQ,EAAE,MAAM;IAG1C,qBAAqB,MAAC;IACtB,iFAAiF;IAE1E,aAAa,EAAE,OAAO,CAAS;IAEtC,wFAAwF;IAEjF,gBAAgB,EAAE,OAAO,CAAS;IAEzC,2DAA2D;IAEpD,UAAU,EAAE,UAAU,CAAgB;IAE7C;;;OAGG;IAEH,2BAA2B,EAAE,OAAO,CAAS;IAE7C;;;OAGG;IAEH,kCAAkC,EAAE,OAAO,GAAG,qBAAqB,CAGjE;IAEF;;;OAGG;IAEH,0BAA0B,EAAE,OAAO,CAAS;IAE5C;;;OAGG;IAEH,iCAAiC,EAAE,OAAO,GAAG,qBAAqB,CAGhE;IAEF,WAAW;IAmBX,IAAW,KAAK,IAKO,MAAM,CAF5B;IAED,IAAW,KAAK,CAAC,IAAI,EAAE,MAAM,EA6B5B;IAEe,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMzE,aAAa,IAAI,IAAI;IAmBrB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAuB3C,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAgDhD,YAAY,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAgC9D;;;;OAIG;IACH,SAAS,KAAK,SAAS,IAAI,OAAO,CAGjC;IAED;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAKhC,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAQpD,cAAc;IAmBd,aAAa,aAOX;IAEF,OAAO,CAAC,2BAA2B;CAUpC;AAGD,eAAO,MAAM,+BAA+B,EAAE,cAG7C,CAAC;AAEF,eAAO,MAAM,qBAAqB;;CAajC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,8SAM7B,CAAC"}
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/combobox/combobox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAclE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,YAAY;;IACxC,OAAO,CAAC,SAAS,CAAS;IAI1B,OAAO,CAAC,6BAA6B,CAAkB;IACvD,IACI,gBAAgB,WAKnB;IAEW,iBAAiB,EAAE,eAAe,CAAC;IAC/C;;;;;;;;;OASG;IACwB,KAAK,UAAS;IACnC,QAAQ,EAAE,MAAM,CAAiB;IACvC,eAAe,CAAC,QAAQ,KAAA,EAAE,QAAQ,EAAE,MAAM;IAG1C,qBAAqB,MAAC;IACtB,iFAAiF;IAE1E,aAAa,EAAE,OAAO,CAAS;IAEtC,wFAAwF;IAEjF,gBAAgB,EAAE,OAAO,CAAS;IAEzC,2DAA2D;IAEpD,UAAU,EAAE,UAAU,CAAgB;IAE7C;;;OAGG;IAEH,2BAA2B,EAAE,OAAO,CAAS;IAE7C;;;OAGG;IAEH,kCAAkC,EAAE,OAAO,GAAG,qBAAqB,CAGjE;IAEF;;;OAGG;IAEH,0BAA0B,EAAE,OAAO,CAAS;IAE5C;;;OAGG;IAEH,iCAAiC,EAAE,OAAO,GAAG,qBAAqB,CAGhE;IAEF;;;;OAIG;IACH,IAAW,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAEjD;IAED,WAAW;IAqBX,IAAW,KAAK,IAKO,MAAM,CAF5B;IAED,IAAW,KAAK,CAAC,IAAI,EAAE,MAAM,EA6B5B;IAEe,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAOzF;;;;;;OAMG;IACH,OAAO,CAAC,sCAAsC;IAY9B,aAAa,IAAI,IAAI;IAmBrB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAuB3C,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAgDhD,YAAY,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;IAgC9D;;;;OAIG;IACH,SAAS,KAAK,SAAS,IAAI,OAAO,CAGjC;IAED;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM;IAKhC,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI;IAQpD,cAAc;IAmBd,aAAa,aAOX;IAEF,OAAO,CAAC,2BAA2B;CAUpC;AAGD,eAAO,MAAM,+BAA+B,EAAE,cAG7C,CAAC;AAEF,eAAO,MAAM,qBAAqB;;CAajC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,8SAM7B,CAAC"}

package/dist/dts/index.d.ts

@@ -99,5 +99,6 @@ export * from './tree-view';
 export * from './url-input';
 export * from './utils/base-datasource';
 export * from './utils/editable-elements';
+export * from './utils/event-types';
 export { getPrefix as getDesignSystemPrefix } from './utils/dom';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,CAAC;AAExE,eAAO,MAAM,8BAA8B,yDAAuD,CAAC;AAEnG,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,SAAS,IAAI,qBAAqB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/dts/options-datasource/options-datasource.d.ts

@@ -1,3 +1,4 @@
+import { GenesisResources } from '@genesislcap/foundation-comms';
 import type { Combobox } from '../combobox';
 import type { Select } from '../select';
 import { BaseDatasource } from '../utils';
@@ -18,11 +19,30 @@ export interface ValueChangeEventDetail {
  * @fires value-change - Fired when the selected value changes. detail: `ValueChangeEventDetail`
  */
 export declare class OptionsDatasource extends BaseDatasource {
+    resources: GenesisResources;
     labelField: string;
     optionElement: string;
     valueField: string;
     emptyDataLabel: string;
     allowCustomOptions: boolean;
+    /**
+     * Enables infinite scrolling. Instead of loading everything upfront, only `page-size`
+     * options are loaded initially and the next page is requested when the user scrolls near
+     * the bottom of the dropdown. REQUEST_SERVER resources page by OFFSET; DATASERVER
+     * resources page via MORE_ROWS on a live stream (total still capped by `maxView`).
+     *
+     * @remarks
+     * When paging REQUEST_SERVER resources by OFFSET, set a stable `order-by` — without one
+     * the server has no other guaranteed ordering between requests, so rows can shift across
+     * pages (duplicates/gaps) as the underlying data changes between fetches. Also, when the
+     * parent is a combobox, this forces `async` mode on it (see `Combobox.async`), since only
+     * a page of options is loaded client-side.
+     */
+    infiniteScroll: boolean;
+    /**
+     * Number of options fetched per page when `infinite-scroll` is enabled. Defaults to 20.
+     */
+    pageSize: number;
     labelFormatter: any;
     labelRowFormatter: (any: any) => string;
     initialSelectedValue: string | number;
@@ -36,20 +56,69 @@ export declare class OptionsDatasource extends BaseDatasource {
     }[];
     baseCriteria: string;
     private resizeObserver;
+    private static readonly defaultPageSize;
+    /**
+     * Distance from the bottom of the listbox (in px) at which the next page is requested.
+     */
+    private static readonly scrollLoadThresholdPx;
+    private listboxElement;
+    private loadingMoreRows;
+    private renderedOptionsCount;
+    private lastTopUpScrollHeight;
+    private emptyDataOption;
     connectedCallback(): Promise<void>;
     disconnectedCallback(): void;
+    /**
+     * While the dropdown is closed, the listbox has no dimensions and cannot be scrolled,
+     * so re-check whether the visible listbox needs topping up every time it opens. Also
+     * retries attaching the scroll listener if the initial attempt (queued on connect)
+     * missed the listbox because the host hadn't rendered it yet.
+     */
+    private selectOpenChangeHandler;
+    /**
+     * REQUEST_SERVER resources page by OFFSET against one-shot requests, so they keep the
+     * default snapshot mode. DATASERVER resources page via MORE_ROWS, which needs the live
+     * stream's SOURCE_REF, so they switch to stream mode.
+     */
+    private applyInfiniteScrollFetchMode;
+    private attachListboxScrollListener;
+    private listboxScrollHandler;
+    private loadNextPage;
+    /**
+     * If the loaded options don't fill the visible listbox (so it can't be scrolled),
+     * keep requesting pages until it overflows or the server runs out of rows.
+     */
+    private topUpVisibleListbox;
     private resizeObserverCallback;
     selectChangeHandler: (e: any) => void;
     fetchData(): void;
     asyncModeIntialization(): Promise<void>;
     clearData(): void;
     private checkOverflow;
+    private rowToOption;
+    private renderListboxOptions;
+    private removeEmptyDataOption;
     syncComponentData(snapshotData?: any[]): void;
     getInitialLabel(): string;
     private getDisplayForValue;
     resetCombobox(): void;
+    /**
+     * Appends rows to the already rendered options. Used by REQUEST_SERVER
+     * infinite scroll paging, where each page contains only the new rows.
+     */
     handleStreamInserts(insertedRows: any[]): void;
+    /**
+     * @remarks
+     * Not implemented: rendered options are only ever appended (see `syncComponentData` /
+     * `handleStreamInserts`). For DATASERVER `infinite-scroll`, a live delete/update on a
+     * row already rendered in an open dropdown will not be reflected until the datasource
+     * is refetched (e.g. criteria change) — tracked as a known limitation, not a v1 goal.
+     */
     handleStreamDeletes(deletedRows: any[]): void;
+    /**
+     * @remarks
+     * Not implemented — see {@link OptionsDatasource.handleStreamDeletes}.
+     */
     handleStreamUpdates(updatedRows: any[]): void;
 }
 //# sourceMappingURL=options-datasource.d.ts.map

package/dist/dts/options-datasource/options-datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options-datasource.d.ts","sourceRoot":"","sources":["../../../src/options-datasource/options-datasource.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,cAAc,EAIf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,qBAGa,iBAAkB,SAAQ,cAAc;IACf,UAAU,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAyB;IAC1B,kBAAkB,UAAS;IAC7E,cAAc,MAAC;IACf,iBAAiB,EAAE,CAAC,GAAG,KAAA,KAAK,MAAM,CAAC;IAEnC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,2BAA2B,CAAC,QAAQ,KAAA,EAAE,QAAQ,KAAA;IAY9C,8BAA8B,EAAE,OAAO,CAAS;IAEhD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAQ;IAElC,SAAS,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAM;IAEjC,OAAO,CAAC,cAAc,CAAiB;IAEjC,iBAAiB;IAmBvB,oBAAoB;IAQpB,OAAO,CAAC,sBAAsB,CAI5B;IAEF,mBAAmB,GAAI,MAAC,UAQtB;IAEF,SAAS;IAcH,sBAAsB;IAa5B,SAAS,IAAI,IAAI;IAWjB,OAAO,CAAC,aAAa;IAYrB,iBAAiB,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE;IA+DtC,eAAe;IAIf,OAAO,CAAC,kBAAkB;IAS1B,aAAa;IAMb,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI;IAI9C,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;IAI7C,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;CAG9C"}
+{"version":3,"file":"options-datasource.d.ts","sourceRoot":"","sources":["../../../src/options-datasource/options-datasource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAgB,MAAM,+BAA+B,CAAC;AAY/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EACL,cAAc,EAKf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,qBAGa,iBAAkB,SAAQ,cAAc;IACjC,SAAS,EAAG,gBAAgB,CAAC;IAEX,UAAU,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAyB;IAC1B,kBAAkB,UAAS;IAEzF;;;;;;;;;;;;OAYG;IACsD,cAAc,UAAS;IAEhF;;OAEG;IAEH,QAAQ,SAAqC;IACjC,cAAc,MAAC;IACf,iBAAiB,EAAE,CAAC,GAAG,KAAA,KAAK,MAAM,CAAC;IAEnC,oBAAoB,EAAE,MAAM,GAAG,MAAM,CAAC;IAClD,2BAA2B,CAAC,QAAQ,KAAA,EAAE,QAAQ,KAAA;IAY9C,8BAA8B,EAAE,OAAO,CAAS;IAEhD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAQ;IAElC,SAAS,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAM;IAEjC,OAAO,CAAC,cAAc,CAAiB;IAEvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAM;IAC7C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAM;IACnD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,qBAAqB,CAAM;IACnC,OAAO,CAAC,eAAe,CAAkC;IAEnD,iBAAiB;IA+BvB,oBAAoB;IAYpB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB,CAM7B;IAEF;;;;OAIG;YACW,4BAA4B;IAU1C,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,oBAAoB,CAW1B;YAEY,YAAY;IAoB1B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,sBAAsB,CAI5B;IAEF,mBAAmB,GAAI,MAAC,UAQtB;IAEF,SAAS;IAcH,sBAAsB;IAa5B,SAAS,IAAI,IAAI;IAkBjB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,qBAAqB;IAO7B,iBAAiB,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE;IAuDtC,eAAe;IAIf,OAAO,CAAC,kBAAkB;IAS1B,aAAa;IAMb;;;OAGG;IACH,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,IAAI;IAc9C;;;;;;OAMG;IACH,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;IAI7C;;;OAGG;IACH,mBAAmB,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI;CAG9C"}

package/dist/dts/react.d.ts

@@ -100,7 +100,7 @@ import type { Tooltip as TooltipWC } from './tooltip/tooltip';
 import type { TreeView as TreeViewWC } from './tree-view/tree-view';
 import type { UrlInput as UrlInputWC } from './url-input/url-input';
 import type { AddGroupEventDetail, AddRuleEventDetail, DelGroupEventDetail, DelRuleEventDetail, UpdateGroupEventDetail, UpdateRuleEventDetail } from '@genesislcap/expression-builder';
-import type { ClearOptions, DailyConfig, FileReadEventDetail, FileSelectedEventDetail, FilterChangedEventDetail, FilterClearedEventDetail, MonthlyConfig, MultiselectOption, SelectedOption, StepClickEventDetail, ValidationError, ValidationFailureEventDetail, ValueChangeEventDetail, WeeklyConfig, YearlyConfig } from '@genesislcap/foundation-ui';
+import type { ClearOptions, DailyConfig, FileReadEventDetail, FileSelectedEventDetail, FilterChangedEventDetail, FilterClearedEventDetail, MonthlyConfig, MultiselectOption, OpenChangeEventDetail, SelectedOption, StepClickEventDetail, ValidationError, ValidationFailureEventDetail, ValueChangeEventDetail, WeeklyConfig, YearlyConfig } from '@genesislcap/foundation-ui';
 
 /** @internal Maps a web component class to its public props only.
  * keyof T skips private/protected members, so this avoids the TS error
@@ -131,14 +131,14 @@ interface HTMLWCProps extends React.AriaAttributes {
   onInput?(e: Event): void;
 }
 
-export declare const Accordion: React.ForwardRefExoticComponent<
+export declare const ActionsMenu: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
-    Omit<PublicOf<AccordionWC>, 'children' | 'style'> &
+    Omit<PublicOf<ActionsMenuWC>, 'children' | 'style'> &
     HTMLWCProps & {
     }
-  > & React.RefAttributes<AccordionWC>
+  > & React.RefAttributes<ActionsMenuWC>
 >;
-export type AccordionRef = AccordionWC;
+export type ActionsMenuRef = ActionsMenuWC;
 
 export declare const AccordionItem: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
@@ -149,14 +149,14 @@ export declare const AccordionItem: React.ForwardRefExoticComponent<
 >;
 export type AccordionItemRef = AccordionItemWC;
 
-export declare const ActionsMenu: React.ForwardRefExoticComponent<
+export declare const AiIndicator: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
-    Omit<PublicOf<ActionsMenuWC>, 'children' | 'style'> &
+    Omit<PublicOf<AiIndicatorWC>, 'children' | 'style'> &
     HTMLWCProps & {
     }
-  > & React.RefAttributes<ActionsMenuWC>
+  > & React.RefAttributes<AiIndicatorWC>
 >;
-export type ActionsMenuRef = ActionsMenuWC;
+export type AiIndicatorRef = AiIndicatorWC;
 
 export declare const AiCriteriaSearch: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
@@ -169,14 +169,14 @@ export declare const AiCriteriaSearch: React.ForwardRefExoticComponent<
 >;
 export type AiCriteriaSearchRef = AiCriteriaSearchWC;
 
-export declare const AiIndicator: React.ForwardRefExoticComponent<
+export declare const Accordion: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
-    Omit<PublicOf<AiIndicatorWC>, 'children' | 'style'> &
+    Omit<PublicOf<AccordionWC>, 'children' | 'style'> &
     HTMLWCProps & {
     }
-  > & React.RefAttributes<AiIndicatorWC>
+  > & React.RefAttributes<AccordionWC>
 >;
-export type AiIndicatorRef = AiIndicatorWC;
+export type AccordionRef = AccordionWC;
 
 export declare const Anchor: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
@@ -294,6 +294,7 @@ export declare const Combobox: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<ComboboxWC>, 'children' | 'style'> &
     HTMLWCProps & {
+      onOpenChange?: (event: CustomEvent<OpenChangeEventDetail>) => void;
     }
   > & React.RefAttributes<ComboboxWC>
 >;
@@ -823,6 +824,7 @@ export declare const Select: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<SelectWC>, 'children' | 'style'> &
     HTMLWCProps & {
+      onOpenChange?: (event: CustomEvent<OpenChangeEventDetail>) => void;
     }
   > & React.RefAttributes<SelectWC>
 >;

package/dist/dts/select/select.d.ts

@@ -2,8 +2,16 @@ import { Select as FASTSelect } from '@microsoft/fast-components';
 import type { ListboxOption, SelectOptions } from '@microsoft/fast-foundation';
 /**
  * @tagname %%prefix%%-select
+ *
+ * @fires open-change - Fired when the dropdown opens or closes. detail: `OpenChangeEventDetail`
  */
 export declare class Select extends FASTSelect {
+    /**
+     * The scrollable element hosting the dropdown options. Part of the public contract for
+     * slotted datasources (e.g. options-datasource infinite scroll) to observe scrolling.
+     * @public
+     */
+    get scrollableListbox(): HTMLElement | null;
     /**
      * @internal
      */

package/dist/dts/select/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/select/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK/E;;GAEG;AACH,qBAAa,MAAO,SAAQ,UAAU;IACpC;;OAEG;IACa,qBAAqB,CACnC,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAC/B,IAAI,EAAE,WAAW,EAAE,GAClB,IAAI;IAqCP;;;;;OAKG;IACH,SAAS,CAAC,4BAA4B,CACpC,aAAa,GAAE,aAAa,GAAG,IAA+B,GAC7D,IAAI;IAcE,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAuB3D,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;CAoB1D;AAGD,eAAO,MAAM,6BAA6B,EAAE,cAA0B,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;CAa/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,0SAM3B,CAAC"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/select/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK/E;;;;GAIG;AACH,qBAAa,MAAO,SAAQ,UAAU;IACpC;;;;OAIG;IACH,IAAW,iBAAiB,IAAI,WAAW,GAAG,IAAI,CAEjD;IAED;;OAEG;IACa,qBAAqB,CACnC,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAC/B,IAAI,EAAE,WAAW,EAAE,GAClB,IAAI;IAqCP;;;;;OAKG;IACH,SAAS,CAAC,4BAA4B,CACpC,aAAa,GAAE,aAAa,GAAG,IAA+B,GAC7D,IAAI;IAcE,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAyB3D,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;CAoB1D;AAGD,eAAO,MAAM,6BAA6B,EAAE,cAA0B,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;CAa/B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,0SAM3B,CAAC"}

package/dist/dts/utils/base-datasource.d.ts

@@ -379,6 +379,12 @@ export declare abstract class BaseDatasource extends BaseDatasource_base {
     isSnapshot: boolean;
     maxRows: number;
     maxView: number;
+    /**
+     * Sort field(s) for the resource. When using OFFSET-based paging (e.g.
+     * `options-datasource`'s `infinite-scroll`), the server has no other guaranteed row
+     * ordering between requests, so a stable `orderBy` is required to avoid rows shifting
+     * across pages (duplicates/gaps) as the underlying data changes between fetches.
+     */
     orderBy: string;
     request: any;
     requestChanged(oldValue: any, newValue: any): void;
@@ -394,7 +400,15 @@ export declare abstract class BaseDatasource extends BaseDatasource_base {
     set datasourceConfig(config: DatasourceOptions);
     requiresFullDataRefresh: boolean;
     dataSub: Subscription;
-    private sourceRef;
+    protected sourceRef: string;
+    /**
+     * Whether the server reported more rows are available beyond the ones already fetched.
+     */
+    protected moreRowsAvailable: boolean;
+    /**
+     * The OFFSET to request the next page from, for REQUEST_SERVER paging.
+     */
+    protected nextRequestOffset: number;
     rowsSyncedWithStream: Map<string, any>;
     dataSubWasLoggedOff: boolean;
     private criteriaFromFilters;
@@ -409,6 +423,28 @@ export declare abstract class BaseDatasource extends BaseDatasource_base {
     abstract handleStreamUpdates(updatedRows: any[]): void;
     fetchGenesisData(withFullInit?: boolean): Promise<void>;
     initDatasource(): Promise<void>;
+    /**
+     * Whether a further page of rows can be requested from the server.
+     * @public
+     */
+    canRequestMoreRows(): boolean;
+    /**
+     * Requests the next page of rows (up to `maxRows`) from the server.
+     *
+     * @remarks
+     * For DATASERVER resources a MORE_ROWS message is sent against the active stream's view and
+     * the rows are delivered as inserts on the existing stream subscription. For REQUEST_SERVER
+     * resources the next page is requested by OFFSET and delivered via `handleStreamInserts`.
+     * @public
+     */
+    requestMoreRows(): Promise<void>;
+    /**
+     * Row extraction identical to `Datasource.snapshotFiltered`, kept local so the raw
+     * response (with MORE_ROWS/NEXT_OFFSET paging metadata) remains available.
+     */
+    private filterSnapshotResult;
+    private updateRequestPagingState;
+    private initialRequestOffset;
     private datasourceOptions;
     private handleStreamUpdate;
     applyRequestServerData(requestServerResult: RequestServerResult): void;

package/dist/dts/utils/base-datasource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-datasource.d.ts","sourceRoot":"","sources":["../../../src/utils/base-datasource.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-datasource.d.ts","sourceRoot":"","sources":["../../../src/utils/base-datasource.ts"],"names":[],"mappings":"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"}

package/dist/dts/utils/event-types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Detail payload for the `open-change` event fired by `Select` and `Combobox` when their
+ * dropdown opens or closes.
+ * @public
+ */
+export interface OpenChangeEventDetail {
+    open: boolean;
+}
+//# sourceMappingURL=event-types.d.ts.map

package/dist/dts/utils/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../src/utils/event-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/dts/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from './base-datasource';
 export * from './dom';
+export * from './event-types';
 export * from './logger';
 export * from './options-datasource-utils';
 export * from './tooltip';

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC"}

package/dist/esm/combobox/combobox.js

@@ -13,6 +13,7 @@ const DEBOUNCE_TIME = 500;
  * @tagname %%prefix%%-combobox
  *
  * @fires change - Fired when a selection is confirmed in autocomplete-both mode
+ * @fires open-change - Fired when the dropdown opens or closes. detail: `OpenChangeEventDetail`
  */
 export class Combobox extends FASTComboBox {
     constructor() {
@@ -20,6 +21,16 @@ export class Combobox extends FASTComboBox {
         _Combobox_indicator.set(this, void 0);
         _Combobox_wasOpenOnEnterDown.set(this, false);
         this.needManualChangeEventDispatch = false;
+        /**
+         * Enables server-side filtering: typed input refetches from the server with a criteria
+         * instead of filtering the already-loaded options client-side.
+         *
+         * @remarks
+         * Automatically forced to `true` (overriding an explicit `async="false"`) when the
+         * slotted datasource has `infinite-scroll` enabled — see
+         * {@link Combobox.enableAsyncForInfiniteScrollDatasource}. With only a page of the
+         * resource loaded, client-side filtering would silently only search that page.
+         */
         this.async = false;
         this.debounce = DEBOUNCE_TIME;
         /** Controls whether to perform a case-sensitive search in the list of options */
@@ -73,8 +84,18 @@ export class Combobox extends FASTComboBox {
     debounceChanged(oldValue, newValue) {
         this.debouncedInputHandler = debounce(this.asyncSetFilter, newValue);
     }
+    /**
+     * The scrollable element hosting the dropdown options. Part of the public contract for
+     * slotted datasources (e.g. options-datasource infinite scroll) to observe scrolling.
+     * @public
+     */
+    get scrollableListbox() {
+        var _a, _b;
+        return (_a = this.listbox) !== null && _a !== void 0 ? _a : (_b = this.shadowRoot) === null || _b === void 0 ? void 0 : _b.querySelector('.listbox');
+    }
     openChanged() {
         super.openChanged();
+        this.$emit('open-change', { open: this.open });
         if (this.open) {
             if (this.scrollToSelectedWhenOpening) {
                 // TODO: Double-check this bit / DOM.queueUpdate do not work here
@@ -122,10 +143,27 @@ export class Combobox extends FASTComboBox {
         }
     }
     slottedOptionsChanged(prev, next) {
+        this.enableAsyncForInfiniteScrollDatasource();
         const shouldEmit = this.async ? true : false;
         super.slottedOptionsChanged(prev, next);
         this['updateValue'](shouldEmit);
     }
+    /**
+     * When the slotted datasource pages its options (infinite scroll), only a page of the
+     * resource is loaded client-side, so filtering typed input locally is meaningless.
+     * Switch to async mode so input refetches from the server with a criteria instead;
+     * further pages honour that criteria. This overrides an explicit `async="false"` on
+     * the combobox — infinite-scroll datasources cannot support client-side filtering.
+     */
+    enableAsyncForInfiniteScrollDatasource() {
+        var _a;
+        if (this.async)
+            return;
+        const datasource = (_a = this.slottedDatasource) === null || _a === void 0 ? void 0 : _a.assignedNodes().find((x) => x instanceof OptionsDatasource);
+        if (datasource === null || datasource === void 0 ? void 0 : datasource.infiniteScroll) {
+            this.async = true;
+        }
+    }
     filterOptions() {
         if (!this.autocomplete || this.autocomplete === ComboboxAutocomplete.none) {
             this['filter'] = '';

package/dist/esm/index.js

@@ -99,4 +99,5 @@ export * from './tree-view';
 export * from './url-input';
 export * from './utils/base-datasource';
 export * from './utils/editable-elements';
+export * from './utils/event-types';
 export { getPrefix as getDesignSystemPrefix } from './utils/dom';