@malva-ui/core 0.1.12

package/esm2022/dropdown/lib/option-matcher.js

@@ -0,0 +1,124 @@
+import { normalizeForMatch } from '@malva-ui/cdk/utils';
+export { normalizeForMatch };
+/**
+ * The default option matcher: a case- and diacritic-insensitive substring match
+ * on {@link MlvSelectOption.label}. An empty (or whitespace-only) query matches
+ * every option.
+ *
+ * @param option - The option to test.
+ * @param query - The current search query (already trimmed by callers).
+ * @returns Whether the option label contains the query.
+ */
+export function defaultOptionMatcher(option, query) {
+    const q = normalizeForMatch(query.trim());
+    if (!q)
+        return true;
+    return normalizeForMatch(option.label).includes(q);
+}
+/**
+ * Filters a list of resolved options against a query using `matcher`
+ * ({@link defaultOptionMatcher} by default), then ranks **prefix matches
+ * first** ({@link rankPrefixMatchesFirst}) so the top suggestion is the one an
+ * inline completion can extend (`"Pe"` ranks `"Pear"` above `"Grape"`). A blank
+ * query returns a shallow copy of every option — the "show everything" state a
+ * combobox / autocomplete shows on focus. This is the single shared
+ * implementation of the substring filter that previously lived inline in
+ * `mlv-combobox`.
+ *
+ * @param options - The resolved options to filter.
+ * @param query - The raw search query (trimmed internally).
+ * @param matcher - Optional custom predicate; defaults to substring matching.
+ * @returns The matcher-satisfying options, prefix matches ranked first (all
+ *   options, unranked, for a blank query).
+ */
+export function filterOptions(options, query, matcher = defaultOptionMatcher) {
+    const q = query.trim();
+    if (!q)
+        return [...options];
+    return rankPrefixMatchesFirst(options.filter((option) => matcher(option, q)), q);
+}
+/**
+ * Stable-partitions filtered options so labels that **start with** the query
+ * (case- and diacritic-insensitive) come before the remaining matches, keeping
+ * the original relative order inside each partition.
+ *
+ * Grouped options ({@link MlvSelectOption.group}) are ranked **within each
+ * consecutive same-group run** only — runs themselves never move or merge, so
+ * the panel's consecutive-run group rendering (sticky headers, flat-index
+ * alignment) is preserved. An ungrouped list is a single run and gets the full
+ * prefix-first ordering.
+ *
+ * @param options - The already-filtered options.
+ * @param query - The trimmed, non-empty query.
+ * @returns The options with prefix matches ranked first per group run.
+ */
+export function rankPrefixMatchesFirst(options, query) {
+    const q = normalizeForMatch(query);
+    const ranked = [];
+    let runStart = 0;
+    for (let i = 1; i <= options.length; i++) {
+        const runEnded = i === options.length ||
+            (options[i].group ?? '') !== (options[runStart].group ?? '');
+        if (!runEnded)
+            continue;
+        const run = options.slice(runStart, i);
+        const prefixed = [];
+        const rest = [];
+        for (const option of run) {
+            (normalizeForMatch(option.label).startsWith(q) ? prefixed : rest).push(option);
+        }
+        ranked.push(...prefixed, ...rest);
+        runStart = i;
+    }
+    return ranked;
+}
+/**
+ * Splits `label` into matched / unmatched {@link MlvMatchSegment}s for the first
+ * occurrence of `query`, so consumers can emphasise the matched substring in a
+ * suggestion (e.g. wrapping matched slices in `<mark>`).
+ *
+ * Matching is case- and diacritic-insensitive ({@link normalizeForMatch}); the
+ * returned segment `text` preserves the **original** label casing/diacritics.
+ * Because NFD folding can change string length (e.g. `"é"` → `"e"` + combining
+ * mark), the search runs over a per-code-point folded projection with an index
+ * map back to the original code points, keeping the highlighted slice aligned
+ * with the source label. Only the first match is highlighted.
+ *
+ * @param label - The option label to segment.
+ * @param query - The query to highlight within the label.
+ * @returns Ordered segments covering the whole label; a single unmatched
+ *   segment when the query is empty or not found.
+ */
+export function matchSegments(label, query) {
+    const q = normalizeForMatch(query.trim());
+    if (!q)
+        return [{ text: label, matched: false }];
+    // Work in code points so surrogate pairs (e.g. emoji) are not split.
+    const chars = [...label];
+    let folded = '';
+    // For each folded code-unit position, the index of the originating code point.
+    const originIndex = [];
+    chars.forEach((char, index) => {
+        const foldedChar = normalizeForMatch(char);
+        for (const unit of foldedChar) {
+            folded += unit;
+            originIndex.push(index);
+        }
+    });
+    const start = folded.indexOf(q);
+    if (start === -1)
+        return [{ text: label, matched: false }];
+    const originStart = originIndex[start];
+    const originEnd = originIndex[start + q.length - 1];
+    const before = chars.slice(0, originStart).join('');
+    const match = chars.slice(originStart, originEnd + 1).join('');
+    const after = chars.slice(originEnd + 1).join('');
+    const segments = [];
+    if (before)
+        segments.push({ text: before, matched: false });
+    segments.push({ text: match, matched: true });
+    if (after)
+        segments.push({ text: after, matched: false });
+    return segments;
+}
+//# sourceMappingURL=option-matcher.js.map

package/esm2022/dropdown/lib/option-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-matcher.js","sourceRoot":"","sources":["../../../../../../libs/core/dropdown/src/lib/option-matcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { normalizeForMatch } from '@malva-ui/cdk/utils';\nimport type { MlvSelectOption } from './select-option';\n\nexport { normalizeForMatch };\n\n/**\n * A contiguous slice of a label produced by {@link matchSegments}, tagged with\n * whether it is part of the query match. Rendered by consumers (e.g. the\n * dropdown panel's suggestion highlighting) as `<mark>` for matched slices and\n * plain text otherwise.\n */\nexport interface MlvMatchSegment {\n  /** The original (non-folded) label text for this slice. */\n  readonly text: string;\n  /** Whether this slice is part of the matched query substring. */\n  readonly matched: boolean;\n}\n\n/**\n * Predicate deciding whether an option satisfies the current query. The default\n * ({@link defaultOptionMatcher}) is a case- and diacritic-insensitive substring\n * match on the option label. Provide a custom matcher to a combobox / the\n * `[mlvAutocomplete]` directive to change how suggestions are filtered (e.g.\n * fuzzy, token-prefix, or matching against a secondary field).\n *\n * A matcher receives the already-trimmed, non-empty query — an empty query is\n * short-circuited by {@link filterOptions} to return every option.\n */\nexport type MlvOptionMatcher<T> = (\n  option: MlvSelectOption<T>,\n  query: string,\n) => boolean;\n\n/**\n * The default option matcher: a case- and diacritic-insensitive substring match\n * on {@link MlvSelectOption.label}. An empty (or whitespace-only) query matches\n * every option.\n *\n * @param option - The option to test.\n * @param query - The current search query (already trimmed by callers).\n * @returns Whether the option label contains the query.\n */\nexport function defaultOptionMatcher<T>(\n  option: MlvSelectOption<T>,\n  query: string,\n): boolean {\n  const q = normalizeForMatch(query.trim());\n  if (!q) return true;\n  return normalizeForMatch(option.label).includes(q);\n}\n\n/**\n * Filters a list of resolved options against a query using `matcher`\n * ({@link defaultOptionMatcher} by default), then ranks **prefix matches\n * first** ({@link rankPrefixMatchesFirst}) so the top suggestion is the one an\n * inline completion can extend (`\"Pe\"` ranks `\"Pear\"` above `\"Grape\"`). A blank\n * query returns a shallow copy of every option — the \"show everything\" state a\n * combobox / autocomplete shows on focus. This is the single shared\n * implementation of the substring filter that previously lived inline in\n * `mlv-combobox`.\n *\n * @param options - The resolved options to filter.\n * @param query - The raw search query (trimmed internally).\n * @param matcher - Optional custom predicate; defaults to substring matching.\n * @returns The matcher-satisfying options, prefix matches ranked first (all\n *   options, unranked, for a blank query).\n */\nexport function filterOptions<T>(\n  options: readonly MlvSelectOption<T>[],\n  query: string,\n  matcher: MlvOptionMatcher<T> = defaultOptionMatcher,\n): MlvSelectOption<T>[] {\n  const q = query.trim();\n  if (!q) return [...options];\n  return rankPrefixMatchesFirst(\n    options.filter((option) => matcher(option, q)),\n    q,\n  );\n}\n\n/**\n * Stable-partitions filtered options so labels that **start with** the query\n * (case- and diacritic-insensitive) come before the remaining matches, keeping\n * the original relative order inside each partition.\n *\n * Grouped options ({@link MlvSelectOption.group}) are ranked **within each\n * consecutive same-group run** only — runs themselves never move or merge, so\n * the panel's consecutive-run group rendering (sticky headers, flat-index\n * alignment) is preserved. An ungrouped list is a single run and gets the full\n * prefix-first ordering.\n *\n * @param options - The already-filtered options.\n * @param query - The trimmed, non-empty query.\n * @returns The options with prefix matches ranked first per group run.\n */\nexport function rankPrefixMatchesFirst<T>(\n  options: readonly MlvSelectOption<T>[],\n  query: string,\n): MlvSelectOption<T>[] {\n  const q = normalizeForMatch(query);\n  const ranked: MlvSelectOption<T>[] = [];\n  let runStart = 0;\n  for (let i = 1; i <= options.length; i++) {\n    const runEnded =\n      i === options.length ||\n      (options[i].group ?? '') !== (options[runStart].group ?? '');\n    if (!runEnded) continue;\n    const run = options.slice(runStart, i);\n    const prefixed: MlvSelectOption<T>[] = [];\n    const rest: MlvSelectOption<T>[] = [];\n    for (const option of run) {\n      (normalizeForMatch(option.label).startsWith(q) ? prefixed : rest).push(\n        option,\n      );\n    }\n    ranked.push(...prefixed, ...rest);\n    runStart = i;\n  }\n  return ranked;\n}\n\n/**\n * Splits `label` into matched / unmatched {@link MlvMatchSegment}s for the first\n * occurrence of `query`, so consumers can emphasise the matched substring in a\n * suggestion (e.g. wrapping matched slices in `<mark>`).\n *\n * Matching is case- and diacritic-insensitive ({@link normalizeForMatch}); the\n * returned segment `text` preserves the **original** label casing/diacritics.\n * Because NFD folding can change string length (e.g. `\"é\"` → `\"e\"` + combining\n * mark), the search runs over a per-code-point folded projection with an index\n * map back to the original code points, keeping the highlighted slice aligned\n * with the source label. Only the first match is highlighted.\n *\n * @param label - The option label to segment.\n * @param query - The query to highlight within the label.\n * @returns Ordered segments covering the whole label; a single unmatched\n *   segment when the query is empty or not found.\n */\nexport function matchSegments(label: string, query: string): MlvMatchSegment[] {\n  const q = normalizeForMatch(query.trim());\n  if (!q) return [{ text: label, matched: false }];\n\n  // Work in code points so surrogate pairs (e.g. emoji) are not split.\n  const chars = [...label];\n  let folded = '';\n  // For each folded code-unit position, the index of the originating code point.\n  const originIndex: number[] = [];\n  chars.forEach((char, index) => {\n    const foldedChar = normalizeForMatch(char);\n    for (const unit of foldedChar) {\n      folded += unit;\n      originIndex.push(index);\n    }\n  });\n\n  const start = folded.indexOf(q);\n  if (start === -1) return [{ text: label, matched: false }];\n\n  const originStart = originIndex[start];\n  const originEnd = originIndex[start + q.length - 1];\n\n  const before = chars.slice(0, originStart).join('');\n  const match = chars.slice(originStart, originEnd + 1).join('');\n  const after = chars.slice(originEnd + 1).join('');\n\n  const segments: MlvMatchSegment[] = [];\n  if (before) segments.push({ text: before, matched: false });\n  segments.push({ text: match, matched: true });\n  if (after) segments.push({ text: after, matched: false });\n  return segments;\n}\n"]}

package/esm2022/dropdown/lib/options-adapter.js

@@ -0,0 +1,356 @@
+import { computed, DestroyRef, effect, inject, signal, untracked, } from '@angular/core';
+import { isObservable } from 'rxjs';
+import { take } from 'rxjs/operators';
+import { MlvDataSource } from '@malva-ui/cdk/data-source';
+import { toOptionsResult } from './options-result';
+/**
+ * Normalises `T[] | Observable<T[]> | MlvDataSource<T>` (+ optional
+ * `searchFn`) into one reactive shape shared by `mlv-select`, `mlv-combobox`
+ * and `[mlvAutocomplete]`. Construct it inside an injection context (a
+ * component field initialiser or constructor) — it uses `effect()` and
+ * `DestroyRef`.
+ *
+ * Paging (`MlvDataSource` only): `connect()` emits the current page's slice and
+ * the adapter accumulates, tracking the **applied page** — the page whose slice
+ * is currently in `items` — alongside the items accumulated before it:
+ *
+ * - `page <= 1` → the slice replaces `items` and accumulation restarts.
+ * - `page === appliedPage` → the source re-emitted the page already shown (a
+ *   backing array changed, a refetch landed): its **tail is replaced**, never
+ *   appended, so rows are not duplicated.
+ * - `page > appliedPage` → the slice is appended.
+ * - A run where the slice reference has not changed (a `page` bump whose data
+ *   has not arrived yet) applies nothing.
+ *
+ * `loadMore()` is therefore a no-op while a page is pending — a scroll sentinel
+ * firing repeatedly cannot skip a page.
+ *
+ * Swapping the `searchFn` **only re-arms the lazy gate** (the next
+ * `ensureLoaded()` calls the new function): the in-flight call is left running
+ * and `items` / `ready` / `loading` are untouched, so results stay on screen
+ * until the new function answers and a control bound to an inline arrow — a
+ * fresh reference on every change detection run — is not reset on every pass.
+ */
+export class MlvOptionsAdapter {
+    _config;
+    /** @private Lifetime for the in-flight `searchFn` subscription / debounce timer. */
+    _destroyRef = inject(DestroyRef);
+    /** @private Which branch the current inputs select. `searchFn` wins over the source. */
+    _kind = computed(() => {
+        if (this._config.searchFn())
+            return 'fn';
+        const source = this._config.source();
+        if (source instanceof MlvDataSource)
+            return 'ds';
+        if (isObservable(source))
+            return 'observable';
+        return 'array';
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_kind" }] : /* istanbul ignore next */ []));
+    // ─── observable branch ────────────────────────────────────────────────────
+    /** @private Latest emission of the observable source. */
+    _obsItems = signal([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_obsItems" }] : /* istanbul ignore next */ []));
+    /** @private Whether the observable source has emitted at least once. */
+    _obsReady = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_obsReady" }] : /* istanbul ignore next */ []));
+    // ─── data-source branch ───────────────────────────────────────────────────
+    /** @private The connected source and its (memoised) `connect()` signal. */
+    _connected = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_connected" }] : /* istanbul ignore next */ []));
+    /** @private Accumulated pages. */
+    _dsItems = signal([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_dsItems" }] : /* istanbul ignore next */ []));
+    /** @private Whether the source has been observed not-loading at least once since connect. */
+    _dsReady = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_dsReady" }] : /* istanbul ignore next */ []));
+    /** @private Last slice reference applied — a `page` bump whose slice has not arrived yet must not append. */
+    _dsLastSlice = null;
+    /** @private The page whose slice is currently applied (`0` = none yet). Distinguishes an append from a re-emit of the page already shown. */
+    _dsAppliedPage = 0;
+    /** @private Items accumulated *before* the applied page — the prefix a re-emit of that page is re-appended to. */
+    _dsBase = [];
+    // ─── searchFn branch ──────────────────────────────────────────────────────
+    /** @private Last `searchFn` result. */
+    _fnItems = signal([], /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_fnItems" }] : /* istanbul ignore next */ []));
+    /** @private Whether a `searchFn` call is in flight. */
+    _fnLoading = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_fnLoading" }] : /* istanbul ignore next */ []));
+    /** @private Whether `searchFn` has produced (or failed) at least once. */
+    _fnReady = signal(false, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "_fnReady" }] : /* istanbul ignore next */ []));
+    /** @private Whether `searchFn` has been invoked at least once (lazy-load gate). */
+    _fnStarted = false;
+    /**
+     * @private The `searchFn` reference the swap effect last observed, normalised
+     * to `null` when unset. Stays `undefined` until that effect's first run, which
+     * is how `undefined → fn` at construction is told apart from a genuine swap.
+     */
+    _fnSeen;
+    /** @private In-flight `searchFn` subscription (superseded by a newer query). */
+    _fnSub = null;
+    /** @private Monotonic token discarding stale `searchFn` results. */
+    _fnToken = 0;
+    /** @private Pending debounce timer for remote searches. */
+    _debounceTimer = null;
+    /** @private Last query handed to `search()`; replayed by `ensureLoaded()`. */
+    _lastQuery = '';
+    /** `'local'` for arrays / observables (consumer filters); `'remote'` for a data source or `searchFn`. */
+    mode = computed(() => {
+        const kind = this._kind();
+        return kind === 'array' || kind === 'observable' ? 'local' : 'remote';
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "mode" }] : /* istanbul ignore next */ []));
+    /** The current raw items (accumulated pages for a data source). */
+    items = computed(() => {
+        switch (this._kind()) {
+            case 'fn':
+                return this._fnItems();
+            case 'ds':
+                return this._dsItems();
+            case 'observable':
+                return this._obsItems();
+            default:
+                return this._config.source() ?? [];
+        }
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "items" }] : /* istanbul ignore next */ []));
+    /** Source-owned "first page / search in flight" flag (drives the top spinner row). */
+    loading = computed(() => {
+        switch (this._kind()) {
+            case 'fn':
+                return this._fnLoading();
+            case 'ds': {
+                const connected = this._connected();
+                return (!!connected && connected.ds.loading() && connected.ds.page() === 1);
+            }
+            case 'observable':
+                return !this._obsReady();
+            default:
+                return false;
+        }
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "loading" }] : /* istanbul ignore next */ []));
+    /** A page beyond the first is in flight (drives the bottom spinner row). Data source only. */
+    loadingMore = computed(() => {
+        if (this._kind() !== 'ds')
+            return false;
+        const connected = this._connected();
+        return !!connected && connected.ds.loading() && connected.ds.page() > 1;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "loadingMore" }] : /* istanbul ignore next */ []));
+    /** The first payload has arrived — arrays immediately, observables on first emit, data sources once observed not-loading, `searchFn` after its first result. */
+    ready = computed(() => {
+        switch (this._kind()) {
+            case 'fn':
+                return this._fnReady();
+            case 'ds':
+                return this._dsReady();
+            case 'observable':
+                return this._obsReady();
+            default:
+                return true;
+        }
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ready" }] : /* istanbul ignore next */ []));
+    /** More pages exist (`items.length < totalItems`). Data source only. */
+    hasMore = computed(() => {
+        if (this._kind() !== 'ds')
+            return false;
+        const connected = this._connected();
+        return !!connected && this._dsItems().length < connected.ds.totalItems();
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "hasMore" }] : /* istanbul ignore next */ []));
+    constructor(_config) {
+        this._config = _config;
+        // Observable source: (re)subscribe whenever the reference changes.
+        effect((onCleanup) => {
+            const source = this._config.source();
+            if (!isObservable(source))
+                return;
+            untracked(() => {
+                this._obsReady.set(false);
+                this._obsItems.set([]);
+            });
+            const sub = source.subscribe((items) => {
+                this._obsItems.set(items);
+                this._obsReady.set(true);
+            });
+            onCleanup(() => sub.unsubscribe());
+        });
+        // Data source: connect once per source — but only while the data source is
+        // the branch in use. A `searchFn` supersedes it, and connecting anyway would
+        // fire a fetch whose slice is never read.
+        effect(() => {
+            const kind = this._kind();
+            const source = this._config.source();
+            untracked(() => {
+                if (kind === 'ds' && source instanceof MlvDataSource) {
+                    this._resetDataSource();
+                    this._connected.set({ ds: source, items: source.connect() });
+                }
+                else if (this._connected()) {
+                    this._resetDataSource();
+                    this._connected.set(null);
+                }
+            });
+        });
+        // Data source: accumulate slices against the applied page.
+        effect(() => {
+            const connected = this._connected();
+            if (!connected)
+                return;
+            const slice = connected.items();
+            const page = connected.ds.page();
+            const loading = connected.ds.loading();
+            untracked(() => {
+                // A page bump whose slice has not arrived yet applies nothing.
+                if (slice === this._dsLastSlice) {
+                    if (!loading)
+                        this._dsReady.set(true);
+                    return;
+                }
+                if (page <= 1) {
+                    this._dsBase = [];
+                    this._dsItems.set([...slice]);
+                }
+                else if (page === this._dsAppliedPage) {
+                    // Same page re-emitted — replace its tail rather than duplicating it.
+                    this._dsItems.set([...this._dsBase, ...slice]);
+                }
+                else {
+                    this._dsBase = this._dsItems();
+                    this._dsItems.set([...this._dsBase, ...slice]);
+                }
+                this._dsAppliedPage = page;
+                this._dsLastSlice = slice;
+                if (!loading)
+                    this._dsReady.set(true);
+            });
+        });
+        // searchFn: a swapped function re-arms the lazy gate so the next
+        // `ensureLoaded()` calls it — and nothing else. Tearing down the in-flight
+        // call or clearing `items` would make the control sensitive to the
+        // *reference* identity of the bound function, and an inline arrow
+        // (`[search]="(q) => api.find(q)"`) is a fresh reference on every change
+        // detection run. Stale items therefore stay until the new function answers,
+        // matching the "results kept while loading" contract; once the new function
+        // starts, a late result from the old one is discarded by the monotonic
+        // token. The effect's first run is `undefined → fn` at construction, which
+        // is not a swap.
+        effect(() => {
+            const fn = this._config.searchFn() ?? null;
+            untracked(() => {
+                const previous = this._fnSeen;
+                this._fnSeen = fn;
+                if (previous === undefined || previous === fn)
+                    return;
+                this._fnStarted = false;
+                if (this._kind() === 'fn' && this._config.eager())
+                    this.ensureLoaded();
+            });
+        });
+        // searchFn: eager first load.
+        effect(() => {
+            if (this._kind() === 'fn' && this._config.eager()) {
+                untracked(() => this.ensureLoaded());
+            }
+        });
+        this._destroyRef.onDestroy(() => {
+            this._fnSub?.unsubscribe();
+            if (this._debounceTimer)
+                clearTimeout(this._debounceTimer);
+        });
+    }
+    /**
+     * Remote-mode search entry point (debounced). Data source → `setSearch({ query, keys: [] })`
+     * (or `null` for a blank query); `searchFn` → invoked with the query. No-op in local mode.
+     */
+    search(query) {
+        this._lastQuery = query;
+        const kind = this._kind();
+        if (kind === 'ds')
+            this._debounced(() => this._searchDataSource(query));
+        else if (kind === 'fn')
+            this._debounced(() => this._runSearchFn(query));
+    }
+    /** Runs the initial `searchFn` load if it has not run yet (data sources connect eagerly; local modes need nothing). */
+    ensureLoaded() {
+        if (this._kind() === 'fn' && !this._fnStarted)
+            this._runSearchFn(this._lastQuery);
+    }
+    /**
+     * Requests the next data-source page. No-op unless `hasMore()`, nothing is in
+     * flight, and the source's current page is the one already applied — a page
+     * requested but not yet accumulated (or a search that reset the source to page
+     * one) blocks the next bump, so a scroll sentinel cannot skip a page.
+     */
+    loadMore() {
+        const connected = this._connected();
+        if (!connected ||
+            !this.hasMore() ||
+            connected.ds.loading() ||
+            connected.ds.page() !== this._dsAppliedPage)
+            return;
+        connected.ds.setPage(connected.ds.page() + 1);
+    }
+    /** @private Clears every accumulation bookkeeping field — on connect, and when a source is disconnected. */
+    _resetDataSource() {
+        this._dsLastSlice = null;
+        this._dsAppliedPage = 0;
+        this._dsBase = [];
+        this._dsItems.set([]);
+        this._dsReady.set(false);
+    }
+    /** @private Schedules `run` after `debounce` ms (immediately when 0), cancelling a pending one. */
+    _debounced(run) {
+        if (this._debounceTimer)
+            clearTimeout(this._debounceTimer);
+        const ms = Math.max(0, this._config.debounce());
+        if (ms === 0) {
+            run();
+            return;
+        }
+        this._debounceTimer = setTimeout(() => {
+            this._debounceTimer = null;
+            run();
+        }, ms);
+    }
+    /** @private Forwards a query to the connected data source using the option-control contract (`keys: []`). */
+    _searchDataSource(query) {
+        const connected = this._connected();
+        if (!connected)
+            return;
+        connected.ds.setSearch(query.trim() ? { query, keys: [] } : null);
+    }
+    /** @private Invokes `searchFn`, superseding any in-flight call; keeps stale items until the result. */
+    _runSearchFn(query) {
+        const fn = this._config.searchFn();
+        if (!fn)
+            return;
+        this._fnStarted = true;
+        const token = ++this._fnToken;
+        this._fnSub?.unsubscribe();
+        this._fnLoading.set(true);
+        this._fnSub = toOptionsResult(fn(query))
+            .pipe(take(1))
+            .subscribe({
+            next: (items) => {
+                if (token !== this._fnToken)
+                    return;
+                this._fnItems.set(items);
+                this._fnLoading.set(false);
+                this._fnReady.set(true);
+            },
+            error: () => {
+                if (token !== this._fnToken)
+                    return;
+                this._fnItems.set([]);
+                this._fnLoading.set(false);
+                this._fnReady.set(true);
+            },
+        });
+    }
+}
+//# sourceMappingURL=options-adapter.js.map

package/esm2022/dropdown/lib/options-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-adapter.js","sourceRoot":"","sources":["../../../../../../libs/core/dropdown/src/lib/options-adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  computed,\n  DestroyRef,\n  effect,\n  inject,\n  signal,\n  untracked,\n} from '@angular/core';\nimport type { Signal } from '@angular/core';\nimport { isObservable } from 'rxjs';\nimport type { Observable, Subscription } from 'rxjs';\nimport { take } from 'rxjs/operators';\nimport { MlvDataSource } from '@malva-ui/cdk/data-source';\nimport { toOptionsResult } from './options-result';\n\n/**\n * A function producing option items for a query. May return a synchronous\n * array, a `Promise`, or an `Observable`. Async results drive the loading\n * affordance; a newer query supersedes an in-flight one.\n */\nexport type MlvOptionsSearchFn<T> = (\n  query: string,\n) => T[] | Promise<T[]> | Observable<T[]>;\n\n/** Everything an option control accepts as its `options` input. */\nexport type MlvOptionsInput<T> =\n  | readonly T[]\n  | Observable<readonly T[]>\n  | MlvDataSource<T>\n  | null\n  | undefined;\n\n/**\n * `'local'` — the consumer filters `items` itself (arrays / observables).\n * `'remote'` — the source owns filtering; the consumer calls `search()` and\n * renders `items` as-is (`MlvDataSource` / `searchFn`).\n */\nexport type MlvOptionsMode = 'local' | 'remote';\n\n/**\n * Everything `MlvOptionsAdapter` reads from its owner. Every field is a\n * `Signal`, so an option control passes its own `input()`s straight through and\n * the adapter reacts to each of them — a swapped `source` reconnects, a swapped\n * `searchFn` re-arms the lazy gate, and `debounce` / `eager` are read at the\n * moment they matter rather than captured at construction.\n */\nexport interface MlvOptionsAdapterConfig<T> {\n  /** The control's `options` input. */\n  source: Signal<MlvOptionsInput<T>>;\n  /** Optional remote search function; when set it supersedes `source`. */\n  searchFn: Signal<MlvOptionsSearchFn<T> | null | undefined>;\n  /** Debounce (ms) applied to remote searches only. */\n  debounce: Signal<number>;\n  /** When `true`, a `searchFn` runs `searchFn('')` on construction instead of lazily. */\n  eager: Signal<boolean>;\n}\n\n/** @private Which of the four supported source shapes the current inputs select. */\ntype SourceKind = 'array' | 'observable' | 'ds' | 'fn';\n\n/** @private A connected `MlvDataSource` paired with the signal returned by its `connect()`. */\ninterface ConnectedSource<T> {\n  readonly ds: MlvDataSource<T>;\n  readonly items: Signal<T[]>;\n}\n\n/**\n * Normalises `T[] | Observable<T[]> | MlvDataSource<T>` (+ optional\n * `searchFn`) into one reactive shape shared by `mlv-select`, `mlv-combobox`\n * and `[mlvAutocomplete]`. Construct it inside an injection context (a\n * component field initialiser or constructor) — it uses `effect()` and\n * `DestroyRef`.\n *\n * Paging (`MlvDataSource` only): `connect()` emits the current page's slice and\n * the adapter accumulates, tracking the **applied page** — the page whose slice\n * is currently in `items` — alongside the items accumulated before it:\n *\n * - `page <= 1` → the slice replaces `items` and accumulation restarts.\n * - `page === appliedPage` → the source re-emitted the page already shown (a\n *   backing array changed, a refetch landed): its **tail is replaced**, never\n *   appended, so rows are not duplicated.\n * - `page > appliedPage` → the slice is appended.\n * - A run where the slice reference has not changed (a `page` bump whose data\n *   has not arrived yet) applies nothing.\n *\n * `loadMore()` is therefore a no-op while a page is pending — a scroll sentinel\n * firing repeatedly cannot skip a page.\n *\n * Swapping the `searchFn` **only re-arms the lazy gate** (the next\n * `ensureLoaded()` calls the new function): the in-flight call is left running\n * and `items` / `ready` / `loading` are untouched, so results stay on screen\n * until the new function answers and a control bound to an inline arrow — a\n * fresh reference on every change detection run — is not reset on every pass.\n */\nexport class MlvOptionsAdapter<T> {\n  /** @private Lifetime for the in-flight `searchFn` subscription / debounce timer. */\n  private readonly _destroyRef = inject(DestroyRef);\n\n  /** @private Which branch the current inputs select. `searchFn` wins over the source. */\n  private readonly _kind = computed<SourceKind>(() => {\n    if (this._config.searchFn()) return 'fn';\n    const source = this._config.source();\n    if (source instanceof MlvDataSource) return 'ds';\n    if (isObservable(source)) return 'observable';\n    return 'array';\n  });\n\n  // ─── observable branch ────────────────────────────────────────────────────\n  /** @private Latest emission of the observable source. */\n  private readonly _obsItems = signal<readonly T[]>([]);\n  /** @private Whether the observable source has emitted at least once. */\n  private readonly _obsReady = signal(false);\n\n  // ─── data-source branch ───────────────────────────────────────────────────\n  /** @private The connected source and its (memoised) `connect()` signal. */\n  private readonly _connected = signal<ConnectedSource<T> | null>(null);\n  /** @private Accumulated pages. */\n  private readonly _dsItems = signal<readonly T[]>([]);\n  /** @private Whether the source has been observed not-loading at least once since connect. */\n  private readonly _dsReady = signal(false);\n  /** @private Last slice reference applied — a `page` bump whose slice has not arrived yet must not append. */\n  private _dsLastSlice: readonly T[] | null = null;\n  /** @private The page whose slice is currently applied (`0` = none yet). Distinguishes an append from a re-emit of the page already shown. */\n  private _dsAppliedPage = 0;\n  /** @private Items accumulated *before* the applied page — the prefix a re-emit of that page is re-appended to. */\n  private _dsBase: readonly T[] = [];\n\n  // ─── searchFn branch ──────────────────────────────────────────────────────\n  /** @private Last `searchFn` result. */\n  private readonly _fnItems = signal<readonly T[]>([]);\n  /** @private Whether a `searchFn` call is in flight. */\n  private readonly _fnLoading = signal(false);\n  /** @private Whether `searchFn` has produced (or failed) at least once. */\n  private readonly _fnReady = signal(false);\n  /** @private Whether `searchFn` has been invoked at least once (lazy-load gate). */\n  private _fnStarted = false;\n  /**\n   * @private The `searchFn` reference the swap effect last observed, normalised\n   * to `null` when unset. Stays `undefined` until that effect's first run, which\n   * is how `undefined → fn` at construction is told apart from a genuine swap.\n   */\n  private _fnSeen: MlvOptionsSearchFn<T> | null | undefined;\n  /** @private In-flight `searchFn` subscription (superseded by a newer query). */\n  private _fnSub: Subscription | null = null;\n  /** @private Monotonic token discarding stale `searchFn` results. */\n  private _fnToken = 0;\n  /** @private Pending debounce timer for remote searches. */\n  private _debounceTimer: ReturnType<typeof setTimeout> | null = null;\n  /** @private Last query handed to `search()`; replayed by `ensureLoaded()`. */\n  private _lastQuery = '';\n\n  /** `'local'` for arrays / observables (consumer filters); `'remote'` for a data source or `searchFn`. */\n  readonly mode = computed<MlvOptionsMode>(() => {\n    const kind = this._kind();\n    return kind === 'array' || kind === 'observable' ? 'local' : 'remote';\n  });\n\n  /** The current raw items (accumulated pages for a data source). */\n  readonly items = computed<readonly T[]>(() => {\n    switch (this._kind()) {\n      case 'fn':\n        return this._fnItems();\n      case 'ds':\n        return this._dsItems();\n      case 'observable':\n        return this._obsItems();\n      default:\n        return (this._config.source() as readonly T[] | null | undefined) ?? [];\n    }\n  });\n\n  /** Source-owned \"first page / search in flight\" flag (drives the top spinner row). */\n  readonly loading = computed<boolean>(() => {\n    switch (this._kind()) {\n      case 'fn':\n        return this._fnLoading();\n      case 'ds': {\n        const connected = this._connected();\n        return (\n          !!connected && connected.ds.loading() && connected.ds.page() === 1\n        );\n      }\n      case 'observable':\n        return !this._obsReady();\n      default:\n        return false;\n    }\n  });\n\n  /** A page beyond the first is in flight (drives the bottom spinner row). Data source only. */\n  readonly loadingMore = computed<boolean>(() => {\n    if (this._kind() !== 'ds') return false;\n    const connected = this._connected();\n    return !!connected && connected.ds.loading() && connected.ds.page() > 1;\n  });\n\n  /** The first payload has arrived — arrays immediately, observables on first emit, data sources once observed not-loading, `searchFn` after its first result. */\n  readonly ready = computed<boolean>(() => {\n    switch (this._kind()) {\n      case 'fn':\n        return this._fnReady();\n      case 'ds':\n        return this._dsReady();\n      case 'observable':\n        return this._obsReady();\n      default:\n        return true;\n    }\n  });\n\n  /** More pages exist (`items.length < totalItems`). Data source only. */\n  readonly hasMore = computed<boolean>(() => {\n    if (this._kind() !== 'ds') return false;\n    const connected = this._connected();\n    return !!connected && this._dsItems().length < connected.ds.totalItems();\n  });\n\n  constructor(private readonly _config: MlvOptionsAdapterConfig<T>) {\n    // Observable source: (re)subscribe whenever the reference changes.\n    effect((onCleanup) => {\n      const source = this._config.source();\n      if (!isObservable(source)) return;\n      untracked(() => {\n        this._obsReady.set(false);\n        this._obsItems.set([]);\n      });\n      const sub = source.subscribe((items) => {\n        this._obsItems.set(items);\n        this._obsReady.set(true);\n      });\n      onCleanup(() => sub.unsubscribe());\n    });\n\n    // Data source: connect once per source — but only while the data source is\n    // the branch in use. A `searchFn` supersedes it, and connecting anyway would\n    // fire a fetch whose slice is never read.\n    effect(() => {\n      const kind = this._kind();\n      const source = this._config.source();\n      untracked(() => {\n        if (kind === 'ds' && source instanceof MlvDataSource) {\n          this._resetDataSource();\n          this._connected.set({ ds: source, items: source.connect() });\n        } else if (this._connected()) {\n          this._resetDataSource();\n          this._connected.set(null);\n        }\n      });\n    });\n\n    // Data source: accumulate slices against the applied page.\n    effect(() => {\n      const connected = this._connected();\n      if (!connected) return;\n      const slice = connected.items();\n      const page = connected.ds.page();\n      const loading = connected.ds.loading();\n      untracked(() => {\n        // A page bump whose slice has not arrived yet applies nothing.\n        if (slice === this._dsLastSlice) {\n          if (!loading) this._dsReady.set(true);\n          return;\n        }\n        if (page <= 1) {\n          this._dsBase = [];\n          this._dsItems.set([...slice]);\n        } else if (page === this._dsAppliedPage) {\n          // Same page re-emitted — replace its tail rather than duplicating it.\n          this._dsItems.set([...this._dsBase, ...slice]);\n        } else {\n          this._dsBase = this._dsItems();\n          this._dsItems.set([...this._dsBase, ...slice]);\n        }\n        this._dsAppliedPage = page;\n        this._dsLastSlice = slice;\n        if (!loading) this._dsReady.set(true);\n      });\n    });\n\n    // searchFn: a swapped function re-arms the lazy gate so the next\n    // `ensureLoaded()` calls it — and nothing else. Tearing down the in-flight\n    // call or clearing `items` would make the control sensitive to the\n    // *reference* identity of the bound function, and an inline arrow\n    // (`[search]=\"(q) => api.find(q)\"`) is a fresh reference on every change\n    // detection run. Stale items therefore stay until the new function answers,\n    // matching the \"results kept while loading\" contract; once the new function\n    // starts, a late result from the old one is discarded by the monotonic\n    // token. The effect's first run is `undefined → fn` at construction, which\n    // is not a swap.\n    effect(() => {\n      const fn = this._config.searchFn() ?? null;\n      untracked(() => {\n        const previous = this._fnSeen;\n        this._fnSeen = fn;\n        if (previous === undefined || previous === fn) return;\n        this._fnStarted = false;\n        if (this._kind() === 'fn' && this._config.eager()) this.ensureLoaded();\n      });\n    });\n\n    // searchFn: eager first load.\n    effect(() => {\n      if (this._kind() === 'fn' && this._config.eager()) {\n        untracked(() => this.ensureLoaded());\n      }\n    });\n\n    this._destroyRef.onDestroy(() => {\n      this._fnSub?.unsubscribe();\n      if (this._debounceTimer) clearTimeout(this._debounceTimer);\n    });\n  }\n\n  /**\n   * Remote-mode search entry point (debounced). Data source → `setSearch({ query, keys: [] })`\n   * (or `null` for a blank query); `searchFn` → invoked with the query. No-op in local mode.\n   */\n  search(query: string): void {\n    this._lastQuery = query;\n    const kind = this._kind();\n    if (kind === 'ds') this._debounced(() => this._searchDataSource(query));\n    else if (kind === 'fn') this._debounced(() => this._runSearchFn(query));\n  }\n\n  /** Runs the initial `searchFn` load if it has not run yet (data sources connect eagerly; local modes need nothing). */\n  ensureLoaded(): void {\n    if (this._kind() === 'fn' && !this._fnStarted)\n      this._runSearchFn(this._lastQuery);\n  }\n\n  /**\n   * Requests the next data-source page. No-op unless `hasMore()`, nothing is in\n   * flight, and the source's current page is the one already applied — a page\n   * requested but not yet accumulated (or a search that reset the source to page\n   * one) blocks the next bump, so a scroll sentinel cannot skip a page.\n   */\n  loadMore(): void {\n    const connected = this._connected();\n    if (\n      !connected ||\n      !this.hasMore() ||\n      connected.ds.loading() ||\n      connected.ds.page() !== this._dsAppliedPage\n    )\n      return;\n    connected.ds.setPage(connected.ds.page() + 1);\n  }\n\n  /** @private Clears every accumulation bookkeeping field — on connect, and when a source is disconnected. */\n  private _resetDataSource(): void {\n    this._dsLastSlice = null;\n    this._dsAppliedPage = 0;\n    this._dsBase = [];\n    this._dsItems.set([]);\n    this._dsReady.set(false);\n  }\n\n  /** @private Schedules `run` after `debounce` ms (immediately when 0), cancelling a pending one. */\n  private _debounced(run: () => void): void {\n    if (this._debounceTimer) clearTimeout(this._debounceTimer);\n    const ms = Math.max(0, this._config.debounce());\n    if (ms === 0) {\n      run();\n      return;\n    }\n    this._debounceTimer = setTimeout(() => {\n      this._debounceTimer = null;\n      run();\n    }, ms);\n  }\n\n  /** @private Forwards a query to the connected data source using the option-control contract (`keys: []`). */\n  private _searchDataSource(query: string): void {\n    const connected = this._connected();\n    if (!connected) return;\n    connected.ds.setSearch(query.trim() ? { query, keys: [] } : null);\n  }\n\n  /** @private Invokes `searchFn`, superseding any in-flight call; keeps stale items until the result. */\n  private _runSearchFn(query: string): void {\n    const fn = this._config.searchFn();\n    if (!fn) return;\n    this._fnStarted = true;\n    const token = ++this._fnToken;\n    this._fnSub?.unsubscribe();\n    this._fnLoading.set(true);\n    this._fnSub = toOptionsResult(fn(query))\n      .pipe(take(1))\n      .subscribe({\n        next: (items) => {\n          if (token !== this._fnToken) return;\n          this._fnItems.set(items);\n          this._fnLoading.set(false);\n          this._fnReady.set(true);\n        },\n        error: () => {\n          if (token !== this._fnToken) return;\n          this._fnItems.set([]);\n          this._fnLoading.set(false);\n          this._fnReady.set(true);\n        },\n      });\n  }\n}\n"]}

package/esm2022/dropdown/lib/options-result.js

@@ -0,0 +1,11 @@
+import { from, of } from 'rxjs';
+/**
+ * Normalises every supported search result into a one-shot observable. Shared
+ * by `MlvOptionsAdapter` and `[mlvAutocomplete]`.
+ */
+export function toOptionsResult(result) {
+    return Array.isArray(result)
+        ? of(result)
+        : from(result);
+}
+//# sourceMappingURL=options-result.js.map

package/esm2022/dropdown/lib/options-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-result.js","sourceRoot":"","sources":["../../../../../../libs/core/dropdown/src/lib/options-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAmB,MAAM,MAAM,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA4C;IAE5C,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1B,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACZ,CAAC,CAAC,IAAI,CAAC,MAAwC,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import { from, of, type Observable } from 'rxjs';\n\n/**\n * Normalises every supported search result into a one-shot observable. Shared\n * by `MlvOptionsAdapter` and `[mlvAutocomplete]`.\n */\nexport function toOptionsResult<T>(\n  result: T[] | Promise<T[]> | Observable<T[]>,\n): Observable<T[]> {\n  return Array.isArray(result)\n    ? of(result)\n    : from(result as Promise<T[]> | Observable<T[]>);\n}\n"]}

package/esm2022/dropdown/lib/reconciliation.js

@@ -0,0 +1,32 @@
+/**
+ * `@angular/aria`'s `ngListbox` reconciles its `value` model against the
+ * currently **rendered** options and re-emits `valueChange` whenever the
+ * rendered set changes — not only on user interaction. These helpers let an
+ * owning control tell that noise apart from a genuine selection.
+ */
+/**
+ * Whether an incoming listbox `valueChange` is pure aria reconciliation: it
+ * (a) adds no value that is not already committed and (b) only removes values
+ * whose option is currently not rendered (`visible`). An emit that exactly
+ * restates the committed selection is reconciliation too.
+ */
+export function isReconciliationEmit(incoming, committed, visible, compare) {
+    const inArr = (arr, v) => arr.some((x) => compare(x, v));
+    // (a) No additions relative to the committed selection.
+    if (incoming.some((v) => !inArr(committed, v)))
+        return false;
+    // (b) Every removed value is currently filtered out of view.
+    return committed
+        .filter((v) => !inArr(incoming, v))
+        .every((v) => !inArr(visible, v));
+}
+/**
+ * Committed values that aria dropped only because their option is not
+ * rendered (not in `visible`) and that are not in `incoming`. Re-add them to
+ * a genuine multi-select pick so earlier selections survive filtering.
+ */
+export function filteredOutCommitted(incoming, committed, visible, compare) {
+    return committed.filter((v) => !incoming.some((iv) => compare(iv, v)) &&
+        !visible.some((vv) => compare(vv, v)));
+}
+//# sourceMappingURL=reconciliation.js.map

package/esm2022/dropdown/lib/reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.js","sourceRoot":"","sources":["../../../../../../libs/core/dropdown/src/lib/reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,SAAuB,EACvB,OAAqB,EACrB,OAAgC;IAEhC,MAAM,KAAK,GAAG,CAAC,GAAiB,EAAE,CAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1E,wDAAwD;IACxD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7D,6DAA6D;IAC7D,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;SAClC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,SAAuB,EACvB,OAAqB,EACrB,OAAgC;IAEhC,OAAO,SAAS,CAAC,MAAM,CACrB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CACxC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * `@angular/aria`'s `ngListbox` reconciles its `value` model against the\n * currently **rendered** options and re-emits `valueChange` whenever the\n * rendered set changes — not only on user interaction. These helpers let an\n * owning control tell that noise apart from a genuine selection.\n */\n\n/**\n * Whether an incoming listbox `valueChange` is pure aria reconciliation: it\n * (a) adds no value that is not already committed and (b) only removes values\n * whose option is currently not rendered (`visible`). An emit that exactly\n * restates the committed selection is reconciliation too.\n */\nexport function isReconciliationEmit<T>(\n  incoming: readonly T[],\n  committed: readonly T[],\n  visible: readonly T[],\n  compare: (a: T, b: T) => boolean,\n): boolean {\n  const inArr = (arr: readonly T[], v: T) => arr.some((x) => compare(x, v));\n\n  // (a) No additions relative to the committed selection.\n  if (incoming.some((v) => !inArr(committed, v))) return false;\n\n  // (b) Every removed value is currently filtered out of view.\n  return committed\n    .filter((v) => !inArr(incoming, v))\n    .every((v) => !inArr(visible, v));\n}\n\n/**\n * Committed values that aria dropped only because their option is not\n * rendered (not in `visible`) and that are not in `incoming`. Re-add them to\n * a genuine multi-select pick so earlier selections survive filtering.\n */\nexport function filteredOutCommitted<T>(\n  incoming: readonly T[],\n  committed: readonly T[],\n  visible: readonly T[],\n  compare: (a: T, b: T) => boolean,\n): T[] {\n  return committed.filter(\n    (v) =>\n      !incoming.some((iv) => compare(iv, v)) &&\n      !visible.some((vv) => compare(vv, v)),\n  );\n}\n"]}

package/esm2022/dropdown/lib/select-data-source.js

@@ -0,0 +1,21 @@
+import { MlvArrayDataSource } from '@malva-ui/cdk/data-source';
+/**
+ * In-memory data source for option controls (`mlv-select`, `mlv-combobox`,
+ * `[mlvAutocomplete]`). Identical to `MlvArrayDataSource` except that it is
+ * **unpaged** (`perPage = Infinity`) so the whole list renders; the shared
+ * natural-field search (`setSearch({ query, keys: [] })`) and sorting are
+ * inherited. Reach for it when you want a data-source-shaped API over an
+ * in-memory array (e.g. to swap for a remote subclass later); a plain `T[]`
+ * remains the simplest input.
+ */
+export class MlvSelectDataSource extends MlvArrayDataSource {
+    /**
+     * @param data A plain array (wrapped in a signal automatically) or a
+     * `Signal<T[]>` to track reactively.
+     */
+    constructor(data) {
+        super(data);
+        this._perPage.set(Infinity);
+    }
+}
+//# sourceMappingURL=select-data-source.js.map