@aglyn/shared-ui-jsx 1.0.0-beta.199 → 1.0.0-beta.201

package/src/lib/hooks/use-list-rows-filter.js

@@ -1,86 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ 'use client';
-import { useCallback, useMemo } from "react";
-import { filterListRows, listFilterGridColumns } from "../const/list-grid-filter.js";
-import { useListGridFilter } from "./use-list-grid-filter.js";
-const NO_OPTIONS = {};
-const NO_HEADERS = {};
-/**
- * The grid's Filters panel and quick search for a list that HOLDS its rows
- * (AGL-3317) — every row it read, or the window its query capped — and so
- * answers both over that whole set rather than the page on screen.
- *
- * It is `useListGridFilter` with the rest of the recipe every such list
- * repeated: the rows matched through `filterListRows`, the columns typed
- * through `listFilterGridColumns`, and the props the grid and the chips
- * take. A list whose query can serve a clause names it in `served`, puts it
- * on the query, and the rows here are not matched against it again.
-  * @deprecated AGL-3321: matches over rows a list has loaded. Serve every clause and search
- * word on the query instead — `planListQuery` (`@aglyn/shared-ui-jsx/const/list-query-plan`, with `nameSearchNormalizers`)
- * through `useListQuery` or `applyListQuery`. Removed once no list calls it.
-*/ export function useListRowsFilter(options) {
-    const { rows, fields, options: choices = NO_OPTIONS, headers = NO_HEADERS, search, served } = options;
-    const selectFields = useMemo(()=>Object.keys(choices), [
-        choices
-    ]);
-    const gridFilter = useListGridFilter({
-        clauses: options.clauses,
-        onChange: options.onChange,
-        selectFields
-    });
-    const searchKey = gridFilter.searchWords.join(' ');
-    const matched = useMemo(()=>filterListRows(rows, fields, gridFilter.clauses, {
-            paths: search,
-            words: gridFilter.searchWords
-        }, served), // `searchKey` stands for the words, which are a new array each render.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [
-        rows,
-        fields,
-        gridFilter.clauses,
-        searchKey,
-        search,
-        served
-    ]);
-    const filterColumns = useCallback((columns)=>listFilterGridColumns(columns, fields, choices, headers), [
-        fields,
-        choices,
-        headers
-    ]);
-    return {
-        rows: matched,
-        filtering: gridFilter.clauses.length > 0 || gridFilter.searchWords.length > 0,
-        gridFilter,
-        gridProps: {
-            filterMode: 'server',
-            filterModel: gridFilter.filterModel,
-            onFilterModelChange: gridFilter.onFilterModelChange,
-            quickFilter: true
-        },
-        chipsProps: {
-            fields,
-            headers,
-            clauses: gridFilter.clauses,
-            onChange: gridFilter.setClauses,
-            options: choices
-        },
-        filterColumns
-    };
-}
-export default useListRowsFilter;
-
-//# sourceMappingURL=use-list-rows-filter.js.map

package/src/lib/hooks/use-list-rows-filter.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/hooks/use-list-rows-filter.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport type { GridColDef, GridFilterModel } from '@mui/x-data-grid'\nimport { useCallback, useMemo } from 'react'\nimport type { ListFilterField } from '../const/list-filter'\nimport {\n  filterListRows,\n  type ListFilterClause,\n  type ListFilterOption,\n  listFilterGridColumns,\n} from '../const/list-grid-filter'\nimport { type ListGridFilter, useListGridFilter } from './use-list-grid-filter'\n\nexport interface ListRowsFilterOptions<Row extends object> {\n  /** Every row the list read — the whole set, or the window its query capped. */\n  rows: readonly Row[]\n  /** What the panel offers, in the `ListFilterField` grammar. */\n  fields: readonly ListFilterField[]\n  /** Choices per picked field; each field named here is shown as a select. */\n  options?: Readonly<Record<string, readonly ListFilterOption[]>>\n  /** How a field reads on a chip and as a hidden column's header. */\n  headers?: Readonly<Record<string, string>>\n  /** The row paths the quick search reads. */\n  search: readonly string[]\n  /** A clause the list's query already served, not matched again. */\n  served?: (clause: ListFilterClause) => boolean\n  /** A saved view's clauses, when the list keeps them; held here otherwise. */\n  clauses?: readonly ListFilterClause[]\n  onChange?: (clauses: ListFilterClause[]) => void\n}\n\n/** What a list that holds its rows hands its grid and its chips. */\nexport interface ListRowsFilter<Row> {\n  /** The rows that answer every clause and the search. */\n  rows: Row[]\n  /** Whether anything narrows the list — a clause or a search word. */\n  filtering: boolean\n  gridFilter: ListGridFilter\n  /** Spread onto `ListTable`: the controlled panel, answered by the list. */\n  gridProps: {\n    filterMode: 'server'\n    filterModel: GridFilterModel\n    onFilterModelChange: (model: GridFilterModel) => void\n    quickFilter: true\n  }\n  /** Spread onto `ListFilterChips`. */\n  chipsProps: {\n    fields: readonly ListFilterField[]\n    headers: Readonly<Record<string, string>>\n    clauses: readonly ListFilterClause[]\n    onChange: (clauses: ListFilterClause[]) => void\n    options: Readonly<Record<string, readonly ListFilterOption[]>>\n  }\n  /** The list's columns, typed for the panel (`listFilterGridColumns`). */\n  filterColumns: (columns: readonly GridColDef[]) => GridColDef[]\n}\n\nconst NO_OPTIONS: Readonly<Record<string, readonly ListFilterOption[]>> = {}\nconst NO_HEADERS: Readonly<Record<string, string>> = {}\n\n/**\n * The grid's Filters panel and quick search for a list that HOLDS its rows\n * (AGL-3317) — every row it read, or the window its query capped — and so\n * answers both over that whole set rather than the page on screen.\n *\n * It is `useListGridFilter` with the rest of the recipe every such list\n * repeated: the rows matched through `filterListRows`, the columns typed\n * through `listFilterGridColumns`, and the props the grid and the chips\n * take. A list whose query can serve a clause names it in `served`, puts it\n * on the query, and the rows here are not matched against it again.\n  * @deprecated AGL-3321: matches over rows a list has loaded. Serve every clause and search\n * word on the query instead — `planListQuery` (`@aglyn/shared-ui-jsx/const/list-query-plan`, with `nameSearchNormalizers`)\n * through `useListQuery` or `applyListQuery`. Removed once no list calls it.\n*/\nexport function useListRowsFilter<Row extends object>(\n  options: ListRowsFilterOptions<Row>,\n): ListRowsFilter<Row> {\n  const {\n    rows,\n    fields,\n    options: choices = NO_OPTIONS,\n    headers = NO_HEADERS,\n    search,\n    served,\n  } = options\n  const selectFields = useMemo(() => Object.keys(choices), [choices])\n  const gridFilter = useListGridFilter({\n    clauses: options.clauses,\n    onChange: options.onChange,\n    selectFields,\n  })\n  const searchKey = gridFilter.searchWords.join(' ')\n  const matched = useMemo(\n    () =>\n      filterListRows(\n        rows,\n        fields,\n        gridFilter.clauses,\n        { paths: search, words: gridFilter.searchWords },\n        served,\n      ),\n    // `searchKey` stands for the words, which are a new array each render.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [rows, fields, gridFilter.clauses, searchKey, search, served],\n  )\n  const filterColumns = useCallback(\n    (columns: readonly GridColDef[]) =>\n      listFilterGridColumns(columns, fields, choices, headers),\n    [fields, choices, headers],\n  )\n  return {\n    rows: matched,\n    filtering: gridFilter.clauses.length > 0 || gridFilter.searchWords.length > 0,\n    gridFilter,\n    gridProps: {\n      filterMode: 'server',\n      filterModel: gridFilter.filterModel,\n      onFilterModelChange: gridFilter.onFilterModelChange,\n      quickFilter: true,\n    },\n    chipsProps: {\n      fields,\n      headers,\n      clauses: gridFilter.clauses,\n      onChange: gridFilter.setClauses,\n      options: choices,\n    },\n    filterColumns,\n  }\n}\n\nexport default useListRowsFilter\n"],"names":["useCallback","useMemo","filterListRows","listFilterGridColumns","useListGridFilter","NO_OPTIONS","NO_HEADERS","useListRowsFilter","options","rows","fields","choices","headers","search","served","selectFields","Object","keys","gridFilter","clauses","onChange","searchKey","searchWords","join","matched","paths","words","filterColumns","columns","filtering","length","gridProps","filterMode","filterModel","onFilterModelChange","quickFilter","chipsProps","setClauses"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;AAGA,SAASA,WAAW,EAAEC,OAAO,QAAQ,QAAO;AAE5C,SACEC,cAAc,EAGdC,qBAAqB,QAChB,+BAA2B;AAClC,SAA8BC,iBAAiB,QAAQ,4BAAwB;AA8C/E,MAAMC,aAAoE,CAAC;AAC3E,MAAMC,aAA+C,CAAC;AAEtD;;;;;;;;;;;;;AAaA,GACA,OAAO,SAASC,kBACdC,OAAmC;IAEnC,MAAM,EACJC,IAAI,EACJC,MAAM,EACNF,SAASG,UAAUN,UAAU,EAC7BO,UAAUN,UAAU,EACpBO,MAAM,EACNC,MAAM,EACP,GAAGN;IACJ,MAAMO,eAAed,QAAQ,IAAMe,OAAOC,IAAI,CAACN,UAAU;QAACA;KAAQ;IAClE,MAAMO,aAAad,kBAAkB;QACnCe,SAASX,QAAQW,OAAO;QACxBC,UAAUZ,QAAQY,QAAQ;QAC1BL;IACF;IACA,MAAMM,YAAYH,WAAWI,WAAW,CAACC,IAAI,CAAC;IAC9C,MAAMC,UAAUvB,QACd,IACEC,eACEO,MACAC,QACAQ,WAAWC,OAAO,EAClB;YAAEM,OAAOZ;YAAQa,OAAOR,WAAWI,WAAW;QAAC,GAC/CR,SAEJ,uEAAuE;IACvE,uDAAuD;IACvD;QAACL;QAAMC;QAAQQ,WAAWC,OAAO;QAAEE;QAAWR;QAAQC;KAAO;IAE/D,MAAMa,gBAAgB3B,YACpB,CAAC4B,UACCzB,sBAAsByB,SAASlB,QAAQC,SAASC,UAClD;QAACF;QAAQC;QAASC;KAAQ;IAE5B,OAAO;QACLH,MAAMe;QACNK,WAAWX,WAAWC,OAAO,CAACW,MAAM,GAAG,KAAKZ,WAAWI,WAAW,CAACQ,MAAM,GAAG;QAC5EZ;QACAa,WAAW;YACTC,YAAY;YACZC,aAAaf,WAAWe,WAAW;YACnCC,qBAAqBhB,WAAWgB,mBAAmB;YACnDC,aAAa;QACf;QACAC,YAAY;YACV1B;YACAE;YACAO,SAASD,WAAWC,OAAO;YAC3BC,UAAUF,WAAWmB,UAAU;YAC/B7B,SAASG;QACX;QACAgB;IACF;AACF;AAEA,eAAepB,kBAAiB"}

package/src/lib/hooks/use-paged-rows-filter.d.ts

@@ -1,80 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { type ListRowsFilter, type ListRowsFilterOptions } from './use-list-rows-filter';
-/** How many rows a paged list reads while it is filtered — see below. */
-export declare const PAGED_FILTER_WINDOW = 100;
-/**
- * A paged window over a live list — the shape `usePagedCollection` returns:
- * every row from the first page to the one being read (plus, possibly, one
- * probe row past it), the page, and whether more exist.
- */
-export interface PagedRowsWindow<Row> {
-    /** Every row read so far, page 0 to the current page; may hold a probe row. */
-    data?: readonly Row[] | null;
-    /** The current page's rows, when nothing narrows the list. */
-    rows: readonly Row[];
-    hasMore: boolean;
-    page: number;
-    setPage: (page: number) => void;
-    pageSize: number;
-    setPageSize: (pageSize: number) => void;
-}
-/** What the list's grid, chips and footer take while it is paged. */
-export interface PagedRowsFilter<Row> extends Omit<ListRowsFilter<Row>, 'rows'> {
-    /** The rows the grid shows: the page, or the page of the matches. */
-    rows: Row[];
-    /** How many rows the window read — what a filter has looked through. */
-    read: number;
-    /** Spread onto `ListPagination`. */
-    pagination: {
-        page: number;
-        pageSize: number;
-        rowCount: number;
-        hasMore: boolean;
-        onPageChange: (page: number) => void;
-        onPageSizeChange: (pageSize: number) => void;
-    };
-}
-/**
- * The grid's Filters panel and quick search over a PAGED live list
- * (AGL-3317), one that reads a window growing a page at a time rather than
- * every row.
- *
- * Unfiltered it is the pager it wraps: the grid shows the page, and the
- * footer turns it. While a clause or a search word is in force the list
- * matches over EVERYTHING the window has read — every page up to the
- * current one, not the page on screen — and pages the matches instead;
- * turning past the last match widens the window by one more page, so a
- * filter reaches further the further the reader goes. `read` says how far
- * it has looked, for the list to say so while more exist.
- *
- * ## The first filter widens the window once
- *
- * A window of one ten-row page is too little to filter: a search would look
- * through ten rows and call the rest "no match". So the first clause or word
- * widens the window to `filterWindow` rows (default
- * {@link PAGED_FILTER_WINDOW}) — one listener that much wider, for as long as
- * the list is narrowed — and clearing the last one puts the reader back on
- * the page they left.
-  * @deprecated AGL-3321: matches over rows a list has loaded. Serve every clause and search
- * word on the query instead — `planListQuery` (`@aglyn/shared-ui-jsx/const/list-query-plan`, with `nameSearchNormalizers`)
- * through `useListQuery` or `applyListQuery`. Removed once no list calls it.
-*/
-export declare function usePagedRowsFilter<Row extends object>(paged: PagedRowsWindow<Row>, options: Omit<ListRowsFilterOptions<Row>, 'rows'> & {
-    filterWindow?: number;
-}): PagedRowsFilter<Row>;
-export default usePagedRowsFilter;

package/src/lib/hooks/use-paged-rows-filter.js

@@ -1,129 +0,0 @@
-/**
- * @license
- * Copyright 2026 Aglyn LLC
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */ 'use client';
-import { _ as _extends } from "@swc/helpers/_/_extends";
-import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
-import { useEffect, useMemo, useRef, useState } from "react";
-import { useListRowsFilter } from "./use-list-rows-filter.js";
-/** How many rows a paged list reads while it is filtered — see below. */ export const PAGED_FILTER_WINDOW = 100;
-/**
- * The grid's Filters panel and quick search over a PAGED live list
- * (AGL-3317), one that reads a window growing a page at a time rather than
- * every row.
- *
- * Unfiltered it is the pager it wraps: the grid shows the page, and the
- * footer turns it. While a clause or a search word is in force the list
- * matches over EVERYTHING the window has read — every page up to the
- * current one, not the page on screen — and pages the matches instead;
- * turning past the last match widens the window by one more page, so a
- * filter reaches further the further the reader goes. `read` says how far
- * it has looked, for the list to say so while more exist.
- *
- * ## The first filter widens the window once
- *
- * A window of one ten-row page is too little to filter: a search would look
- * through ten rows and call the rest "no match". So the first clause or word
- * widens the window to `filterWindow` rows (default
- * {@link PAGED_FILTER_WINDOW}) — one listener that much wider, for as long as
- * the list is narrowed — and clearing the last one puts the reader back on
- * the page they left.
-  * @deprecated AGL-3321: matches over rows a list has loaded. Serve every clause and search
- * word on the query instead — `planListQuery` (`@aglyn/shared-ui-jsx/const/list-query-plan`, with `nameSearchNormalizers`)
- * through `useListQuery` or `applyListQuery`. Removed once no list calls it.
-*/ export function usePagedRowsFilter(paged, options) {
-    const { pageSize } = paged;
-    const { filterWindow = PAGED_FILTER_WINDOW } = options, filterOptions = _object_without_properties_loose(options, [
-        "filterWindow"
-    ]);
-    const windowRows = useMemo(()=>{
-        var _paged_data;
-        return ((_paged_data = paged.data) != null ? _paged_data : paged.rows).slice(0, pageSize * (paged.page + 1));
-    }, [
-        paged.data,
-        paged.rows,
-        pageSize,
-        paged.page
-    ]);
-    const filter = useListRowsFilter(_extends({}, filterOptions, {
-        rows: windowRows
-    }));
-    const [matchPage, setMatchPage] = useState(0);
-    const searchKey = filter.gridFilter.searchWords.join(' ');
-    // A narrowed list starts again at its first page.
-    useEffect(()=>setMatchPage(0), [
-        filter.gridFilter.clauses,
-        searchKey
-    ]);
-    /** The page the reader was on before the list was narrowed. */ const before = useRef(null);
-    const { filtering } = filter;
-    useEffect(()=>{
-        if (filtering && before.current === null) {
-            before.current = paged.page;
-            const widened = Math.max(0, Math.ceil(filterWindow / pageSize) - 1);
-            if (widened > paged.page) paged.setPage(widened);
-        } else if (!filtering && before.current !== null) {
-            paged.setPage(before.current);
-            before.current = null;
-        }
-    // Only the transition into and out of a filter moves the window.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [
-        filtering
-    ]);
-    if (!filter.filtering) {
-        return _extends({}, filter, {
-            rows: [
-                ...paged.rows
-            ],
-            read: windowRows.length,
-            pagination: {
-                page: paged.page,
-                pageSize,
-                rowCount: paged.rows.length,
-                hasMore: paged.hasMore,
-                onPageChange: paged.setPage,
-                onPageSizeChange: paged.setPageSize
-            }
-        });
-    }
-    const matches = filter.rows;
-    const shown = matches.slice(matchPage * pageSize, (matchPage + 1) * pageSize);
-    const lastMatchPage = Math.max(0, Math.ceil(matches.length / pageSize) - 1);
-    return _extends({}, filter, {
-        rows: shown,
-        read: windowRows.length,
-        pagination: {
-            page: matchPage,
-            pageSize,
-            rowCount: shown.length,
-            hasMore: paged.hasMore || matchPage < lastMatchPage,
-            onPageChange: (next)=>{
-                // Past the matches read so far, the window reads another page first.
-                if ((next + 1) * pageSize > matches.length && paged.hasMore) {
-                    paged.setPage(paged.page + 1);
-                }
-                setMatchPage(next);
-            },
-            onPageSizeChange: (next)=>{
-                paged.setPageSize(next);
-                setMatchPage(0);
-            }
-        }
-    });
-}
-export default usePagedRowsFilter;
-
-//# sourceMappingURL=use-paged-rows-filter.js.map

package/src/lib/hooks/use-paged-rows-filter.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../libs/shared/ui/jsx/src/lib/hooks/use-paged-rows-filter.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n'use client'\n\nimport { useEffect, useMemo, useRef, useState } from 'react'\nimport {\n  type ListRowsFilter,\n  type ListRowsFilterOptions,\n  useListRowsFilter,\n} from './use-list-rows-filter'\n\n/** How many rows a paged list reads while it is filtered — see below. */\nexport const PAGED_FILTER_WINDOW = 100\n\n/**\n * A paged window over a live list — the shape `usePagedCollection` returns:\n * every row from the first page to the one being read (plus, possibly, one\n * probe row past it), the page, and whether more exist.\n */\nexport interface PagedRowsWindow<Row> {\n  /** Every row read so far, page 0 to the current page; may hold a probe row. */\n  data?: readonly Row[] | null\n  /** The current page's rows, when nothing narrows the list. */\n  rows: readonly Row[]\n  hasMore: boolean\n  page: number\n  setPage: (page: number) => void\n  pageSize: number\n  setPageSize: (pageSize: number) => void\n}\n\n/** What the list's grid, chips and footer take while it is paged. */\nexport interface PagedRowsFilter<Row> extends Omit<ListRowsFilter<Row>, 'rows'> {\n  /** The rows the grid shows: the page, or the page of the matches. */\n  rows: Row[]\n  /** How many rows the window read — what a filter has looked through. */\n  read: number\n  /** Spread onto `ListPagination`. */\n  pagination: {\n    page: number\n    pageSize: number\n    rowCount: number\n    hasMore: boolean\n    onPageChange: (page: number) => void\n    onPageSizeChange: (pageSize: number) => void\n  }\n}\n\n/**\n * The grid's Filters panel and quick search over a PAGED live list\n * (AGL-3317), one that reads a window growing a page at a time rather than\n * every row.\n *\n * Unfiltered it is the pager it wraps: the grid shows the page, and the\n * footer turns it. While a clause or a search word is in force the list\n * matches over EVERYTHING the window has read — every page up to the\n * current one, not the page on screen — and pages the matches instead;\n * turning past the last match widens the window by one more page, so a\n * filter reaches further the further the reader goes. `read` says how far\n * it has looked, for the list to say so while more exist.\n *\n * ## The first filter widens the window once\n *\n * A window of one ten-row page is too little to filter: a search would look\n * through ten rows and call the rest \"no match\". So the first clause or word\n * widens the window to `filterWindow` rows (default\n * {@link PAGED_FILTER_WINDOW}) — one listener that much wider, for as long as\n * the list is narrowed — and clearing the last one puts the reader back on\n * the page they left.\n  * @deprecated AGL-3321: matches over rows a list has loaded. Serve every clause and search\n * word on the query instead — `planListQuery` (`@aglyn/shared-ui-jsx/const/list-query-plan`, with `nameSearchNormalizers`)\n * through `useListQuery` or `applyListQuery`. Removed once no list calls it.\n*/\nexport function usePagedRowsFilter<Row extends object>(\n  paged: PagedRowsWindow<Row>,\n  options: Omit<ListRowsFilterOptions<Row>, 'rows'> & { filterWindow?: number },\n): PagedRowsFilter<Row> {\n  const { pageSize } = paged\n  const { filterWindow = PAGED_FILTER_WINDOW, ...filterOptions } = options\n  const windowRows = useMemo(\n    () => (paged.data ?? paged.rows).slice(0, pageSize * (paged.page + 1)),\n    [paged.data, paged.rows, pageSize, paged.page],\n  )\n  const filter = useListRowsFilter({ ...filterOptions, rows: windowRows })\n  const [matchPage, setMatchPage] = useState(0)\n  const searchKey = filter.gridFilter.searchWords.join(' ')\n  // A narrowed list starts again at its first page.\n  useEffect(() => setMatchPage(0), [filter.gridFilter.clauses, searchKey])\n\n  /** The page the reader was on before the list was narrowed. */\n  const before = useRef<number | null>(null)\n  const { filtering } = filter\n  useEffect(() => {\n    if (filtering && before.current === null) {\n      before.current = paged.page\n      const widened = Math.max(0, Math.ceil(filterWindow / pageSize) - 1)\n      if (widened > paged.page) paged.setPage(widened)\n    } else if (!filtering && before.current !== null) {\n      paged.setPage(before.current)\n      before.current = null\n    }\n    // Only the transition into and out of a filter moves the window.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [filtering])\n\n  if (!filter.filtering) {\n    return {\n      ...filter,\n      rows: [...paged.rows],\n      read: windowRows.length,\n      pagination: {\n        page: paged.page,\n        pageSize,\n        rowCount: paged.rows.length,\n        hasMore: paged.hasMore,\n        onPageChange: paged.setPage,\n        onPageSizeChange: paged.setPageSize,\n      },\n    }\n  }\n  const matches = filter.rows\n  const shown = matches.slice(matchPage * pageSize, (matchPage + 1) * pageSize)\n  const lastMatchPage = Math.max(0, Math.ceil(matches.length / pageSize) - 1)\n  return {\n    ...filter,\n    rows: shown,\n    read: windowRows.length,\n    pagination: {\n      page: matchPage,\n      pageSize,\n      rowCount: shown.length,\n      hasMore: paged.hasMore || matchPage < lastMatchPage,\n      onPageChange: (next) => {\n        // Past the matches read so far, the window reads another page first.\n        if ((next + 1) * pageSize > matches.length && paged.hasMore) {\n          paged.setPage(paged.page + 1)\n        }\n        setMatchPage(next)\n      },\n      onPageSizeChange: (next) => {\n        paged.setPageSize(next)\n        setMatchPage(0)\n      },\n    },\n  }\n}\n\nexport default usePagedRowsFilter\n"],"names":["useEffect","useMemo","useRef","useState","useListRowsFilter","PAGED_FILTER_WINDOW","usePagedRowsFilter","paged","options","pageSize","filterWindow","filterOptions","windowRows","data","rows","slice","page","filter","matchPage","setMatchPage","searchKey","gridFilter","searchWords","join","clauses","before","filtering","current","widened","Math","max","ceil","setPage","read","length","pagination","rowCount","hasMore","onPageChange","onPageSizeChange","setPageSize","matches","shown","lastMatchPage","next"],"mappings":"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"}