@multiplatform.one/frappe-ui 7.23.2 → 7.25.0

package/dist/esm/list/listState.native.js

@@ -0,0 +1,202 @@
+function positiveInt(value) {
+  var parsed = Number.parseInt(value !== null && value !== void 0 ? value : "", 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+}
+function listStateFromParams(params, controls) {
+  var _controls_sorts, _ref, _controls_facets, _controls_ranges, _controls_views, _views_find, _params_q;
+  var _sorts_find, _sorts_;
+  var sorts = (_controls_sorts = controls.sorts) !== null && _controls_sorts !== void 0 ? _controls_sorts : [];
+  var sort = (_ref = (_sorts_find = sorts.find(function (option) {
+    return option.value === params.sort;
+  })) === null || _sorts_find === void 0 ? void 0 : _sorts_find.value) !== null && _ref !== void 0 ? _ref : (_sorts_ = sorts[0]) === null || _sorts_ === void 0 ? void 0 : _sorts_.value;
+  var facets = {};
+  var _iteratorNormalCompletion = true,
+    _didIteratorError = false,
+    _iteratorError = void 0;
+  try {
+    for (var _iterator = ((_controls_facets = controls.facets) !== null && _controls_facets !== void 0 ? _controls_facets : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      var facet = _step.value;
+      var value = params[facet.param];
+      if (value && facet.options.includes(value)) facets[facet.param] = value;
+    }
+  } catch (err) {
+    _didIteratorError = true;
+    _iteratorError = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion && _iterator.return != null) {
+        _iterator.return();
+      }
+    } finally {
+      if (_didIteratorError) {
+        throw _iteratorError;
+      }
+    }
+  }
+  var ranges = {};
+  var _iteratorNormalCompletion1 = true,
+    _didIteratorError1 = false,
+    _iteratorError1 = void 0;
+  try {
+    for (var _iterator1 = ((_controls_ranges = controls.ranges) !== null && _controls_ranges !== void 0 ? _controls_ranges : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true) {
+      var range = _step1.value;
+      var value1 = positiveInt(params[range.param]);
+      if (value1 > 0) ranges[range.param] = value1;
+    }
+  } catch (err) {
+    _didIteratorError1 = true;
+    _iteratorError1 = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+        _iterator1.return();
+      }
+    } finally {
+      if (_didIteratorError1) {
+        throw _iteratorError1;
+      }
+    }
+  }
+  var views = (_controls_views = controls.views) !== null && _controls_views !== void 0 ? _controls_views : [];
+  var view = (_views_find = views.find(function (mode) {
+    return mode === params.view;
+  })) !== null && _views_find !== void 0 ? _views_find : controls.defaultView;
+  return {
+    search: (_params_q = params.q) !== null && _params_q !== void 0 ? _params_q : "",
+    sort,
+    facets,
+    ranges,
+    favoritesOnly: params.fav === "1",
+    view
+  };
+}
+function listStateParams(patch, controls) {
+  var _patch_facets, _patch_ranges;
+  var params = {};
+  if (patch.search !== void 0) params.q = patch.search.trim() || void 0;
+  if (patch.sort !== void 0) {
+    var _controls_sorts_, _controls_sorts;
+    params.sort = patch.sort === ((_controls_sorts = controls.sorts) === null || _controls_sorts === void 0 ? void 0 : (_controls_sorts_ = _controls_sorts[0]) === null || _controls_sorts_ === void 0 ? void 0 : _controls_sorts_.value) ? void 0 : patch.sort;
+  }
+  var _iteratorNormalCompletion = true,
+    _didIteratorError = false,
+    _iteratorError = void 0;
+  try {
+    for (var _iterator = Object.entries((_patch_facets = patch.facets) !== null && _patch_facets !== void 0 ? _patch_facets : {})[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      var [param, value] = _step.value;
+      params[param] = value || void 0;
+    }
+  } catch (err) {
+    _didIteratorError = true;
+    _iteratorError = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion && _iterator.return != null) {
+        _iterator.return();
+      }
+    } finally {
+      if (_didIteratorError) {
+        throw _iteratorError;
+      }
+    }
+  }
+  var _iteratorNormalCompletion1 = true,
+    _didIteratorError1 = false,
+    _iteratorError1 = void 0;
+  try {
+    for (var _iterator1 = Object.entries((_patch_ranges = patch.ranges) !== null && _patch_ranges !== void 0 ? _patch_ranges : {})[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true) {
+      var [param1, value1] = _step1.value;
+      params[param1] = value1 > 0 ? String(value1) : void 0;
+    }
+  } catch (err) {
+    _didIteratorError1 = true;
+    _iteratorError1 = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+        _iterator1.return();
+      }
+    } finally {
+      if (_didIteratorError1) {
+        throw _iteratorError1;
+      }
+    }
+  }
+  if (patch.favoritesOnly !== void 0) params.fav = patch.favoritesOnly ? "1" : void 0;
+  if (patch.view !== void 0) {
+    params.view = patch.view === controls.defaultView ? void 0 : patch.view;
+  }
+  return params;
+}
+function isListNarrowed(state) {
+  return state.search.trim() !== "" || Object.values(state.facets).some(Boolean) || Object.values(state.ranges).some(function (value) {
+    return value > 0;
+  }) || state.favoritesOnly;
+}
+function listStateFilters(state, controls) {
+  var options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
+  var _options_base, _controls_facets, _controls_ranges, _options_favorites;
+  var filters = [...((_options_base = options.base) !== null && _options_base !== void 0 ? _options_base : [])];
+  var query = state.search.trim();
+  if (query && options.search) filters.push(...options.search(query));
+  var _iteratorNormalCompletion = true,
+    _didIteratorError = false,
+    _iteratorError = void 0;
+  try {
+    for (var _iterator = ((_controls_facets = controls.facets) !== null && _controls_facets !== void 0 ? _controls_facets : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+      var facet = _step.value;
+      var value = state.facets[facet.param];
+      if (!value) continue;
+      filters.push(facet.doctype ? [facet.doctype, facet.field, "=", value] : [facet.field, "=", value]);
+    }
+  } catch (err) {
+    _didIteratorError = true;
+    _iteratorError = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion && _iterator.return != null) {
+        _iterator.return();
+      }
+    } finally {
+      if (_didIteratorError) {
+        throw _iteratorError;
+      }
+    }
+  }
+  var _iteratorNormalCompletion1 = true,
+    _didIteratorError1 = false,
+    _iteratorError1 = void 0;
+  try {
+    for (var _iterator1 = ((_controls_ranges = controls.ranges) !== null && _controls_ranges !== void 0 ? _controls_ranges : [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true) {
+      var range = _step1.value;
+      var _state_ranges_range_param;
+      var value1 = (_state_ranges_range_param = state.ranges[range.param]) !== null && _state_ranges_range_param !== void 0 ? _state_ranges_range_param : 0;
+      if (value1 > 0) filters.push([range.field, ">=", value1]);
+    }
+  } catch (err) {
+    _didIteratorError1 = true;
+    _iteratorError1 = err;
+  } finally {
+    try {
+      if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+        _iterator1.return();
+      }
+    } finally {
+      if (_didIteratorError1) {
+        throw _iteratorError1;
+      }
+    }
+  }
+  if (state.favoritesOnly) filters.push(["name", "in", [...((_options_favorites = options.favorites) !== null && _options_favorites !== void 0 ? _options_favorites : [])].sort()]);
+  return filters.length > 0 ? filters : void 0;
+}
+function listStateOrderBy(state, controls, fallback) {
+  var _controls_sorts, _ref, _sorts_find;
+  var _this;
+  var sorts = (_controls_sorts = controls.sorts) !== null && _controls_sorts !== void 0 ? _controls_sorts : [];
+  return (_ref = (_this = (_sorts_find = sorts.find(function (option) {
+    return option.value === state.sort;
+  })) !== null && _sorts_find !== void 0 ? _sorts_find : sorts[0]) === null || _this === void 0 ? void 0 : _this.orderBy) !== null && _ref !== void 0 ? _ref : fallback;
+}
+export { isListNarrowed, listStateFilters, listStateFromParams, listStateOrderBy, listStateParams };
+//# sourceMappingURL=listState.native.js.map

package/dist/esm/list/listState.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["positiveInt","value","parsed","Number","parseInt","isFinite","listStateFromParams","params","controls","_controls_sorts","_ref","_controls_facets","_controls_ranges","_controls_views","_views_find","_params_q","_sorts_find","_sorts_","sorts","sort","find","option","facets","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","next","done","facet","param","options","includes","err","return","ranges","_iteratorNormalCompletion1","_didIteratorError1","_iteratorError1","_iterator1","_step1","range","value1","views","view","mode","defaultView","search","q","favoritesOnly","fav","listStateParams","patch","_patch_facets","_patch_ranges"],"sources":["../../../src/list/listState.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/list/recordLook.mjs

@@ -0,0 +1,10 @@
+function recordTitle(doc, look, titleField) {
+  const custom = look?.title?.(doc);
+  if (custom) return custom;
+  const row = doc;
+  const field = titleField ? row[titleField] : void 0;
+  if (typeof field === "string" && field) return field;
+  return typeof row.name === "string" ? row.name : "";
+}
+export { recordTitle };
+//# sourceMappingURL=recordLook.mjs.map

package/dist/esm/list/recordLook.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["recordTitle","doc","look","titleField","custom","title","row","field","name"],"sources":["../../../src/list/recordLook.ts"],"sourcesContent":[null],"mappings":"AAyBO,SAASA,YACdC,GAAA,EACAC,IAAA,EACAC,UAAA,EACQ;EACR,MAAMC,MAAA,GAASF,IAAA,EAAMG,KAAA,GAAQJ,GAAG;EAChC,IAAIG,MAAA,EAAQ,OAAOA,MAAA;EACnB,MAAME,GAAA,GAAML,GAAA;EACZ,MAAMM,KAAA,GAAQJ,UAAA,GAAaG,GAAA,CAAIH,UAAU,IAAI;EAC7C,IAAI,OAAOI,KAAA,KAAU,YAAYA,KAAA,EAAO,OAAOA,KAAA;EAC/C,OAAO,OAAOD,GAAA,CAAIE,IAAA,KAAS,WAAWF,GAAA,CAAIE,IAAA,GAAO;AACnD","ignoreList":[]}

package/dist/esm/list/recordLook.native.js

@@ -0,0 +1,11 @@
+function recordTitle(doc, look, titleField) {
+  var _look_title;
+  var custom = look === null || look === void 0 ? void 0 : (_look_title = look.title) === null || _look_title === void 0 ? void 0 : _look_title.call(look, doc);
+  if (custom) return custom;
+  var row = doc;
+  var field = titleField ? row[titleField] : void 0;
+  if (typeof field === "string" && field) return field;
+  return typeof row.name === "string" ? row.name : "";
+}
+export { recordTitle };
+//# sourceMappingURL=recordLook.native.js.map

package/dist/esm/list/recordLook.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["recordTitle","doc","look","titleField","_look_title","custom","title","call","row","field","name"],"sources":["../../../src/list/recordLook.ts"],"sourcesContent":[null],"mappings":"AAyBO,SAASA,YACdC,GAAA,EACAC,IAAA,EACAC,UAAA,EACQ;EACR,IAAAC,WAAe;EACf,IAAIC,MAAA,GAAQH,IAAA,KAAO,QAAAA,IAAA,wBAAAE,WAAA,GAAAF,IAAA,CAAAI,KAAA,cAAAF,WAAA,uBAAAA,WAAA,CAAAG,IAAA,CAAAL,IAAA,EAAAD,GAAA;EACnB,IAAAI,MAAM,EAAM,OAAAA,MAAA;EACZ,IAAAG,GAAM,GAAAP,GAAA;EACN,IAAIQ,KAAA,GAAON,UAAU,GAAAK,GAAA,CAAAL,UAAmB,SAAO;EAC/C,WAAOM,KAAO,KAAI,QAAS,IAAAA,KAAW,SAAIA,KAAO;EACnD,cAAAD,GAAA,CAAAE,IAAA,gBAAAF,GAAA,CAAAE,IAAA","ignoreList":[]}

package/dist/esm/list/useListControls.mjs

@@ -0,0 +1,164 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { FrappeRowsReader } from "../FrappeRowsReader.mjs";
+import { facetRead, readFacet } from "./facetReading.mjs";
+import { useFavorites } from "./favorites.mjs";
+import { listStateFromParams, listStateParams } from "./listState.mjs";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function mergeState(prev, patch) {
+  return {
+    ...prev,
+    ...patch,
+    facets: patch.facets ? {
+      ...prev.facets,
+      ...patch.facets
+    } : prev.facets,
+    ranges: patch.ranges ? {
+      ...prev.ranges,
+      ...patch.ranges
+    } : prev.ranges
+  };
+}
+function useListControls({
+  doctype,
+  controls,
+  connections,
+  connection,
+  limit,
+  favoritesKey,
+  router,
+  readBase
+}) {
+  const controlsRef = useRef(controls);
+  controlsRef.current = controls;
+  const setParams = router?.setSearchParams;
+  const setParamsRef = useRef(setParams);
+  setParamsRef.current = setParams;
+  const [state, setState] = useState(() => listStateFromParams(router?.searchParams ?? {}, controls));
+  const [searchText, setSearchText] = useState(state.search);
+  const pending = useRef({});
+  const [flushTick, setFlushTick] = useState(0);
+  const update = useCallback(patch => {
+    setState(prev => mergeState(prev, patch));
+    if (!setParamsRef.current) return;
+    pending.current = {
+      ...pending.current,
+      ...listStateParams(patch, controlsRef.current)
+    };
+    setFlushTick(tick => tick + 1);
+  }, []);
+  useEffect(() => {
+    if (flushTick === 0) return;
+    const patch = pending.current;
+    pending.current = {};
+    if (Object.keys(patch).length === 0) return;
+    try {
+      setParamsRef.current?.(patch);
+    } catch {}
+  }, [flushTick]);
+  const clear = useCallback(() => {
+    setSearchText("");
+    const current = controlsRef.current;
+    update({
+      search: "",
+      favoritesOnly: false,
+      facets: Object.fromEntries((current.facets ?? []).map(facet => [facet.param, ""])),
+      ranges: Object.fromEntries((current.ranges ?? []).map(range => [range.param, 0]))
+    });
+  }, [update]);
+  const favorites = useFavorites(favoritesKey);
+  const [snapshots, setSnapshots] = useState({});
+  const handlers = useRef(/* @__PURE__ */new Map());
+  const handlerFor = useCallback(key => {
+    let handler = handlers.current.get(key);
+    if (!handler) {
+      handler = snapshot => setSnapshots(prev => ({
+        ...prev,
+        [key]: snapshot
+      }));
+      handlers.current.set(key, handler);
+    }
+    return handler;
+  }, []);
+  const facetsKey = JSON.stringify((controls.facets ?? []).map(({
+    param,
+    field,
+    doctype: on,
+    orderBy
+  }) => [param, field, on, orderBy]));
+  const rangeFieldsKey = JSON.stringify((controls.ranges ?? []).map(range => range.field));
+  const connectionsKey = JSON.stringify(connections ?? null);
+  const reads = useMemo(() => {
+    const declared = JSON.parse(connectionsKey);
+    const facetReads = (controlsRef.current.facets ?? []).map(facet => ({
+      key: `facet:${facet.param}`,
+      facet,
+      ...facetRead(facet, doctype, declared ?? void 0, limit)
+    }));
+    const rangeFields = JSON.parse(rangeFieldsKey);
+    const base = readBase ? {
+      key: "base",
+      doctype,
+      options: {
+        fields: ["name", ...rangeFields],
+        limit: limit ?? 0
+      }
+    } : void 0;
+    return {
+      facetReads: facetReads.filter(read => read.ready),
+      base
+    };
+  }, [facetsKey, rangeFieldsKey, connectionsKey, doctype, limit, readBase]);
+  const facetReadings = useMemo(() => {
+    const readings = {};
+    for (const read of reads.facetReads) {
+      const rows = snapshots[read.key]?.rows ?? [];
+      readings[read.facet.param] = readFacet(read.facet, read.linkField, rows);
+    }
+    return readings;
+  }, [reads, snapshots]);
+  const baseRows = reads.base ? snapshots.base?.rows : void 0;
+  const {
+    total,
+    highest
+  } = useMemo(() => {
+    if (!baseRows) return {
+      total: void 0,
+      highest: {}
+    };
+    const peaks = {};
+    for (const range of controlsRef.current.ranges ?? []) {
+      peaks[range.param] = baseRows.reduce((acc, row) => Math.max(acc, Number(row[range.field]) || 0), 0);
+    }
+    return {
+      total: baseRows.length,
+      highest: peaks
+    };
+  }, [baseRows]);
+  const readers = /* @__PURE__ */jsxs(Fragment, {
+    children: [reads.facetReads.map(read => /* @__PURE__ */jsx(FrappeRowsReader, {
+      connection,
+      doctype: read.doctype,
+      options: read.options,
+      onChange: handlerFor(read.key)
+    }, read.key)), reads.base ? /* @__PURE__ */jsx(FrappeRowsReader, {
+      connection,
+      doctype: reads.base.doctype,
+      options: reads.base.options,
+      onChange: handlerFor("base")
+    }, "base") : null]
+  });
+  return {
+    state,
+    searchText,
+    setSearchText,
+    update,
+    clear,
+    favorites,
+    facets: facetReadings,
+    total,
+    highest,
+    readers
+  };
+}
+export { useListControls };
+//# sourceMappingURL=useListControls.mjs.map

package/dist/esm/list/useListControls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useMemo","useRef","useState","FrappeRowsReader","facetRead","readFacet","useFavorites","listStateFromParams","listStateParams","Fragment","jsx","jsxs","mergeState","prev","patch","facets","ranges","useListControls","doctype","controls","connections","connection","limit","favoritesKey","router","readBase","controlsRef","current","setParams","setSearchParams","setParamsRef","state","setState","searchParams","searchText","setSearchText","search","pending","flushTick","setFlushTick","update","tick","Object","keys","length","clear","favoritesOnly","fromEntries","map","facet","param","range","favorites","snapshots","setSnapshots","handlers","Map","handlerFor","key","handler","get","snapshot","set","facetsKey","JSON","stringify","field","on","orderBy","rangeFieldsKey","connectionsKey","reads","declared","parse","facetReads","rangeFields","base","options","fields","filter","read","ready","facetReadings","readings","rows","linkField","baseRows","total","highest","peaks","reduce","acc","row","Math","max","Number","readers","children","onChange"],"sources":["../../../src/list/useListControls.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/list/useListControls.native.js

@@ -0,0 +1,244 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { FrappeRowsReader } from "../FrappeRowsReader.native.js";
+import { facetRead, readFacet } from "./facetReading.native.js";
+import { useFavorites } from "./favorites.native.js";
+import { listStateFromParams, listStateParams } from "./listState.native.js";
+function mergeState(prev, patch) {
+  return {
+    ...prev,
+    ...patch,
+    facets: patch.facets ? {
+      ...prev.facets,
+      ...patch.facets
+    } : prev.facets,
+    ranges: patch.ranges ? {
+      ...prev.ranges,
+      ...patch.ranges
+    } : prev.ranges
+  };
+}
+function useListControls(param) {
+  var {
+    doctype,
+    controls,
+    connections,
+    connection,
+    limit,
+    favoritesKey,
+    router,
+    readBase
+  } = param;
+  var _controls_facets, _controls_ranges;
+  var _snapshots_base;
+  var controlsRef = useRef(controls);
+  controlsRef.current = controls;
+  var setParams = router === null || router === void 0 ? void 0 : router.setSearchParams;
+  var setParamsRef = useRef(setParams);
+  setParamsRef.current = setParams;
+  var [state, setState] = useState(function () {
+    var _ref;
+    return listStateFromParams((_ref = router === null || router === void 0 ? void 0 : router.searchParams) !== null && _ref !== void 0 ? _ref : {}, controls);
+  });
+  var [searchText, setSearchText] = useState(state.search);
+  var pending = useRef({});
+  var [flushTick, setFlushTick] = useState(0);
+  var update = useCallback(function (patch) {
+    setState(function (prev) {
+      return mergeState(prev, patch);
+    });
+    if (!setParamsRef.current) return;
+    pending.current = {
+      ...pending.current,
+      ...listStateParams(patch, controlsRef.current)
+    };
+    setFlushTick(function (tick) {
+      return tick + 1;
+    });
+  }, []);
+  useEffect(function () {
+    if (flushTick === 0) return;
+    var patch = pending.current;
+    pending.current = {};
+    if (Object.keys(patch).length === 0) return;
+    try {
+      var _setParamsRef_current;
+      (_setParamsRef_current = setParamsRef.current) === null || _setParamsRef_current === void 0 ? void 0 : _setParamsRef_current.call(setParamsRef, patch);
+    } catch (unused) {}
+  },
+  // A host router that cannot take params right now; local state holds.
+  [flushTick]);
+  var clear = useCallback(function () {
+    var _current_facets, _current_ranges;
+    setSearchText("");
+    var current = controlsRef.current;
+    update({
+      search: "",
+      favoritesOnly: false,
+      facets: Object.fromEntries(((_current_facets = current.facets) !== null && _current_facets !== void 0 ? _current_facets : []).map(function (facet) {
+        return [facet.param, ""];
+      })),
+      ranges: Object.fromEntries(((_current_ranges = current.ranges) !== null && _current_ranges !== void 0 ? _current_ranges : []).map(function (range) {
+        return [range.param, 0];
+      }))
+    });
+  }, [update]);
+  var favorites = useFavorites(favoritesKey);
+  var [snapshots, setSnapshots] = useState({});
+  var handlers = useRef(/* @__PURE__ */new Map());
+  var handlerFor = useCallback(function (key) {
+    var handler = handlers.current.get(key);
+    if (!handler) {
+      handler = function handler2(snapshot) {
+        return setSnapshots(function (prev) {
+          return {
+            ...prev,
+            [key]: snapshot
+          };
+        });
+      };
+      handlers.current.set(key, handler);
+    }
+    return handler;
+  }, []);
+  var facetsKey = JSON.stringify(((_controls_facets = controls.facets) !== null && _controls_facets !== void 0 ? _controls_facets : []).map(function (param2) {
+    var {
+      param: _$param,
+      field,
+      doctype: on,
+      orderBy
+    } = param2;
+    return [_$param, field, on, orderBy];
+  }));
+  var rangeFieldsKey = JSON.stringify(((_controls_ranges = controls.ranges) !== null && _controls_ranges !== void 0 ? _controls_ranges : []).map(function (range) {
+    return range.field;
+  }));
+  var connectionsKey = JSON.stringify(connections !== null && connections !== void 0 ? connections : null);
+  var reads = useMemo(function () {
+    var _controlsRef_current_facets;
+    var declared = JSON.parse(connectionsKey);
+    var facetReads = ((_controlsRef_current_facets = controlsRef.current.facets) !== null && _controlsRef_current_facets !== void 0 ? _controlsRef_current_facets : []).map(function (facet) {
+      return {
+        key: `facet:${facet.param}`,
+        facet,
+        ...facetRead(facet, doctype, declared !== null && declared !== void 0 ? declared : void 0, limit)
+      };
+    });
+    var rangeFields = JSON.parse(rangeFieldsKey);
+    var base = readBase ? {
+      key: "base",
+      doctype,
+      options: {
+        fields: ["name", ...rangeFields],
+        limit: limit !== null && limit !== void 0 ? limit : 0
+      }
+    } : void 0;
+    return {
+      facetReads: facetReads.filter(function (read) {
+        return read.ready;
+      }),
+      base
+    };
+  },
+  // facetsKey stands for controls.facets, read through the ref.
+  [facetsKey, rangeFieldsKey, connectionsKey, doctype, limit, readBase]);
+  var facetReadings = useMemo(function () {
+    var readings = {};
+    var _iteratorNormalCompletion = true,
+      _didIteratorError = false,
+      _iteratorError = void 0;
+    try {
+      for (var _iterator = reads.facetReads[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+        var read = _step.value;
+        var _ref;
+        var _snapshots_read_key;
+        var rows = (_ref = (_snapshots_read_key = snapshots[read.key]) === null || _snapshots_read_key === void 0 ? void 0 : _snapshots_read_key.rows) !== null && _ref !== void 0 ? _ref : [];
+        readings[read.facet.param] = readFacet(read.facet, read.linkField, rows);
+      }
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator.return != null) {
+          _iterator.return();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+    return readings;
+  }, [reads, snapshots]);
+  var baseRows = reads.base ? (_snapshots_base = snapshots.base) === null || _snapshots_base === void 0 ? void 0 : _snapshots_base.rows : void 0;
+  var {
+    total,
+    highest
+  } = useMemo(function () {
+    var _controlsRef_current_ranges;
+    if (!baseRows) return {
+      total: void 0,
+      highest: {}
+    };
+    var peaks = {};
+    var _iteratorNormalCompletion = true,
+      _didIteratorError = false,
+      _iteratorError = void 0;
+    try {
+      var _loop = function () {
+        var range = _step.value;
+        peaks[range.param] = baseRows.reduce(function (acc, row) {
+          return Math.max(acc, Number(row[range.field]) || 0);
+        }, 0);
+      };
+      for (var _iterator = ((_controlsRef_current_ranges = controlsRef.current.ranges) !== null && _controlsRef_current_ranges !== void 0 ? _controlsRef_current_ranges : [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) _loop();
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator.return != null) {
+          _iterator.return();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+    return {
+      total: baseRows.length,
+      highest: peaks
+    };
+  }, [baseRows]);
+  var readers = /* @__PURE__ */_jsxs(_Fragment, {
+    children: [reads.facetReads.map(function (read) {
+      return /* @__PURE__ */_jsx(FrappeRowsReader, {
+        connection,
+        doctype: read.doctype,
+        options: read.options,
+        onChange: handlerFor(read.key)
+      }, read.key);
+    }), reads.base ? /* @__PURE__ */_jsx(FrappeRowsReader, {
+      connection,
+      doctype: reads.base.doctype,
+      options: reads.base.options,
+      onChange: handlerFor("base")
+    }, "base") : null]
+  });
+  return {
+    state,
+    searchText,
+    setSearchText,
+    update,
+    clear,
+    favorites,
+    facets: facetReadings,
+    total,
+    highest,
+    readers
+  };
+}
+export { useListControls };
+//# sourceMappingURL=useListControls.native.js.map