@invoicebox/ui 0.1.0-alpha.325 → 0.1.0-alpha.326

package/dist/hooks/useQueryFilter/index.js

@@ -0,0 +1,163 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  useQueryFilter: true,
+  QueryFilterProvider: true,
+  DEFAULT_PAGE_PARAM_NAME: true,
+  DEFAULT_FIRST_PAGE: true
+};
+Object.defineProperty(exports, "DEFAULT_FIRST_PAGE", {
+  enumerable: true,
+  get: function get() {
+    return _context.DEFAULT_FIRST_PAGE;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_PAGE_PARAM_NAME", {
+  enumerable: true,
+  get: function get() {
+    return _context.DEFAULT_PAGE_PARAM_NAME;
+  }
+});
+Object.defineProperty(exports, "QueryFilterProvider", {
+  enumerable: true,
+  get: function get() {
+    return _context.QueryFilterProvider;
+  }
+});
+exports.useQueryFilter = void 0;
+var _react = require("react");
+var _context = require("./context");
+var _helpers = require("./helpers");
+Object.keys(_helpers).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _helpers[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _helpers[key];
+    }
+  });
+});
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+var getIsEmptyValue = function getIsEmptyValue(value) {
+  return value === '' || value === undefined || value === null || Array.isArray(value) && value.length === 0;
+};
+
+/**
+ * Значение фильтра, которое живёт в строке запроса.
+ *
+ * - `initialValue` записывается в адрес при монтировании, если параметра там ещё нет;
+ *   пустое значение (`''`, `null`, `undefined`, `[]`) удаляет параметр.
+ * - Смена значения сбрасывает номер страницы на первую (`isResetPageWhenChanged`).
+ * - Начальное значение можно передавать выражением (`new Date()`, `[]`): хук сравнивает его
+ *   по строке, которую оно даёт в адресе, а не по ссылке.
+ *
+ * Нужен `QueryFilterProvider` выше по дереву.
+ */
+var useQueryFilter = exports.useQueryFilter = function useQueryFilter(name, initialValue, fromString, toString) {
+  var _searchParams$get;
+  var isResetPageWhenChanged = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
+  var _useQueryFilterContex = (0, _context.useQueryFilterContext)(),
+    searchParams = _useQueryFilterContex.searchParams,
+    setSearchParams = _useQueryFilterContex.setSearchParams,
+    pageParamName = _useQueryFilterContex.pageParamName,
+    firstPage = _useQueryFilterContex.firstPage;
+
+  // для тех случаев когда если initialValue и в случае когда он не успел вставить в квери параметры - возвращать его
+  var _useState = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    acceptInitialValueDone = _useState2[0],
+    setAcceptInitialValueDone = _useState2[1];
+  var serialize = (0, _react.useCallback)(function (value) {
+    if (getIsEmptyValue(value)) return '';
+    return toString ? toString(value) : String(value);
+  }, [toString]);
+  var removeAttribute = (0, _react.useCallback)(function (isResetPage) {
+    if (searchParams.has(name)) {
+      searchParams["delete"](name);
+      if (isResetPage) {
+        searchParams.set(pageParamName, String(firstPage));
+      }
+      setSearchParams(searchParams);
+    }
+  }, [firstPage, name, pageParamName, searchParams, setSearchParams]);
+  var handleQueryChange = (0, _react.useCallback)(function (newValue) {
+    if (getIsEmptyValue(newValue)) {
+      removeAttribute(isResetPageWhenChanged);
+      return;
+    }
+    searchParams.set(name, serialize(newValue));
+    if (isResetPageWhenChanged) {
+      searchParams.set(pageParamName, String(firstPage));
+    }
+    setSearchParams(searchParams);
+  }, [firstPage, isResetPageWhenChanged, name, pageParamName, removeAttribute, searchParams, serialize, setSearchParams]);
+  var acceptInitialValue = (0, _react.useCallback)(function (initial) {
+    if (!searchParams.has(name)) {
+      if (getIsEmptyValue(initial)) {
+        removeAttribute(true);
+        setAcceptInitialValueDone(true);
+        return;
+      }
+      searchParams.set(name, serialize(initial));
+      setSearchParams(searchParams);
+    }
+    setAcceptInitialValueDone(true);
+  }, [name, removeAttribute, searchParams, serialize, setSearchParams]);
+
+  /**
+   * Начальное значение, стабилизированное по его строковому представлению.
+   *
+   * Вызывающие часто передают начальное значение выражением (`monthStart()`, `[]`,
+   * `new Date()`), то есть новым объектом на каждый рендер. Если зависеть от самой
+   * ссылки, эффект ниже срабатывает на каждом рендере (и возвращает в адрес значение
+   * по умолчанию, которое пользователь только что сбросил), а значение фильтра каждый
+   * раз получает новую ссылку — эффект с запросом перезапускается без конца. Поэтому
+   * ссылка меняется только когда меняется строка, которую значение даёт в адресе.
+   */
+  var initialKey = serialize(initialValue);
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  var stableInitialValue = (0, _react.useMemo)(function () {
+    return initialValue;
+  }, [initialKey]);
+  (0, _react.useEffect)(function () {
+    acceptInitialValue(stableInitialValue);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [stableInitialValue]);
+  var handleGetValueFromString = (0, _react.useCallback)(function (queryValue) {
+    if (fromString) {
+      return fromString(queryValue);
+    }
+    return queryValue || '';
+  }, [fromString]);
+
+  /**
+   * Строку читаем на каждом рендере, а не кешируем по объекту `searchParams`: эффект
+   * начального значения дописывает параметр прямо в текущий объект, а навигация
+   * (react-router 7 — переходом с низким приоритетом) приходит позже. Между ними есть
+   * рендер, где объект прежний, но строка в нём уже новая, — по ней и надо считать,
+   * иначе фильтр на один рендер «пустеет» и уходит лишний запрос.
+   *
+   * Пока строка в адресе совпадает с начальной, отдаём сам `stableInitialValue`, а не
+   * результат разбора: иначе `new Date(...)` из разборщика дал бы новую ссылку при тех
+   * же данных и эффект с запросом сработал бы ещё раз.
+   */
+  var rawQueryValue = (_searchParams$get = searchParams.get(name)) !== null && _searchParams$get !== void 0 ? _searchParams$get : '';
+  var isInitialNotAppliedYet = !acceptInitialValueDone && !searchParams.has(name);
+  var formattedValue = (0, _react.useMemo)(function () {
+    if (isInitialNotAppliedYet || rawQueryValue === initialKey) {
+      return stableInitialValue;
+    }
+    return handleGetValueFromString(rawQueryValue || null);
+  }, [handleGetValueFromString, initialKey, isInitialNotAppliedYet, rawQueryValue, stableInitialValue]);
+  return [formattedValue, handleQueryChange];
+};

package/dist/hooks/useQueryFilter/index.stories.d.ts

@@ -0,0 +1,4 @@
+import type { Meta, StoryObj } from '@storybook/react';
+declare const meta: Meta;
+export default meta;
+export declare const Default: StoryObj;

package/dist/hooks/useQueryFilter/index.stories.js

@@ -0,0 +1,75 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.Default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _ = require(".");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } /* eslint-disable react-hooks/rules-of-hooks */
+var meta = {
+  title: 'hooks/useQueryFilter',
+  tags: ['autodocs']
+};
+var _default = exports["default"] = meta; // В приложении сюда передают useSearchParams() роутера; в истории адрес живёт в состоянии
+var InMemoryRouter = function InMemoryRouter(_ref) {
+  var children = _ref.children;
+  var _useState = (0, _react.useState)(function () {
+      return new URLSearchParams();
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    searchParams = _useState2[0],
+    setSearchParamsState = _useState2[1];
+  var setSearchParams = (0, _react.useCallback)(function (next) {
+    return setSearchParamsState(new URLSearchParams(next.toString()));
+  }, []);
+  return /*#__PURE__*/_react["default"].createElement(_.QueryFilterProvider, {
+    searchParams: searchParams,
+    setSearchParams: setSearchParams
+  }, children(searchParams.toString()));
+};
+var Filters = function Filters() {
+  var _useQueryFilter = (0, _.useQueryFilter)('status', 'pending'),
+    _useQueryFilter2 = _slicedToArray(_useQueryFilter, 2),
+    status = _useQueryFilter2[0],
+    setStatus = _useQueryFilter2[1];
+  var _useQueryFilter3 = (0, _.useQueryFilter)('from', null, _.getDateOrNullFromQueryString, _.getQueryStringFromDateOrNull),
+    _useQueryFilter4 = _slicedToArray(_useQueryFilter3, 2),
+    from = _useQueryFilter4[0],
+    setFrom = _useQueryFilter4[1];
+  return /*#__PURE__*/_react["default"].createElement("div", null, /*#__PURE__*/_react["default"].createElement("p", null, "status: ", status || '—'), /*#__PURE__*/_react["default"].createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setStatus('approved');
+    }
+  }, "status = approved"), /*#__PURE__*/_react["default"].createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setStatus('');
+    }
+  }, "\u0421\u0431\u0440\u043E\u0441\u0438\u0442\u044C status"), /*#__PURE__*/_react["default"].createElement("p", null, "from: ", from ? from.toLocaleString() : '—'), /*#__PURE__*/_react["default"].createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setFrom(new Date());
+    }
+  }, "from = \u0441\u0435\u0439\u0447\u0430\u0441"), /*#__PURE__*/_react["default"].createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setFrom(null);
+    }
+  }, "\u0421\u0431\u0440\u043E\u0441\u0438\u0442\u044C from"));
+};
+var Default = exports.Default = {
+  render: function render() {
+    return /*#__PURE__*/_react["default"].createElement(InMemoryRouter, null, function (search) {
+      return /*#__PURE__*/_react["default"].createElement("div", null, /*#__PURE__*/_react["default"].createElement("p", null, "\u0410\u0434\u0440\u0435\u0441: ", /*#__PURE__*/_react["default"].createElement("code", null, "?", search)), /*#__PURE__*/_react["default"].createElement(Filters, null));
+    });
+  }
+};

package/dist/hooks/useQueryFilter/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/useQueryFilter/index.test.js

@@ -0,0 +1,183 @@
+"use strict";
+
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _react = _interopRequireWildcard(require("react"));
+var _client = require("react-dom/client");
+var _ = require(".");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; } /**
+ * @jest-environment jsdom
+ */
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+var url = '';
+
+/**
+ * Роутер в памяти, ведущий себя как react-router 7: запись адреса идёт переходом с низким
+ * приоритетом, а в следующем рендере приходит новый объект URLSearchParams.
+ */
+var MemoryRouter = function MemoryRouter(_ref) {
+  var _ref$initial = _ref.initial,
+    initial = _ref$initial === void 0 ? '' : _ref$initial,
+    children = _ref.children;
+  var _useState = (0, _react.useState)(function () {
+      return new URLSearchParams(initial);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    searchParams = _useState2[0],
+    setSearchParamsState = _useState2[1];
+  var setSearchParams = (0, _react.useCallback)(function (next) {
+    var nextString = next.toString();
+    url = nextString;
+    (0, _react.startTransition)(function () {
+      return setSearchParamsState(new URLSearchParams(nextString));
+    });
+  }, []);
+  return /*#__PURE__*/_react["default"].createElement(_.QueryFilterProvider, {
+    searchParams: searchParams,
+    setSearchParams: setSearchParams
+  }, children);
+};
+var container;
+var root;
+beforeEach(function () {
+  url = '';
+  container = document.createElement('div');
+  root = (0, _client.createRoot)(container);
+});
+afterEach(function () {
+  (0, _react.act)(function () {
+    return root.unmount();
+  });
+});
+var render = function render(node) {
+  return (0, _react.act)(function () {
+    return root.render(node);
+  });
+};
+describe('useQueryFilter', function () {
+  test('строковое значение по умолчанию: попадает в адрес, запрос один', function () {
+    var requests = [];
+    var setter = function setter() {
+      return undefined;
+    };
+    var List = function List() {
+      var _useQueryFilter = (0, _.useQueryFilter)('status', 'pending'),
+        _useQueryFilter2 = _slicedToArray(_useQueryFilter, 2),
+        status = _useQueryFilter2[0],
+        setStatus = _useQueryFilter2[1];
+      setter = setStatus;
+      (0, _react.useEffect)(function () {
+        requests.push(status);
+      }, [status]);
+      return null;
+    };
+    render(/*#__PURE__*/_react["default"].createElement(MemoryRouter, null, /*#__PURE__*/_react["default"].createElement(List, null)));
+    expect(url).toBe('status=pending');
+    expect(requests).toEqual(['pending']);
+    (0, _react.act)(function () {
+      return setter('approved');
+    });
+    expect(url).toBe('status=approved&page=1');
+    expect(requests).toEqual(['pending', 'approved']);
+  });
+  test('дата по умолчанию выражением: ни лишнего запроса, ни цикла', function () {
+    var requests = [];
+    var from = new Date(2026, 9, 1, 12, 30, 15);
+    var List = function List() {
+      // новый объект на каждом рендере — так вызывающие и пишут
+      var _useQueryFilter3 = (0, _.useQueryFilter)('from', new Date(from.getTime()), _.getDateOrNullFromQueryString, _.getQueryStringFromDateOrNull),
+        _useQueryFilter4 = _slicedToArray(_useQueryFilter3, 1),
+        dateFrom = _useQueryFilter4[0];
+      (0, _react.useEffect)(function () {
+        requests.push(String(dateFrom === null || dateFrom === void 0 ? void 0 : dateFrom.getTime()));
+      }, [dateFrom]);
+      return null;
+    };
+    render(/*#__PURE__*/_react["default"].createElement(MemoryRouter, null, /*#__PURE__*/_react["default"].createElement(List, null)));
+    expect(new URLSearchParams(url).get('from')).toBe((0, _.formatDateForQuery)(from));
+    expect(requests).toEqual([String(from.getTime())]);
+  });
+  test('значение из адреса важнее значения по умолчанию', function () {
+    var value = '';
+    var List = function List() {
+      var _useQueryFilter5 = (0, _.useQueryFilter)('status', 'pending');
+      var _useQueryFilter6 = _slicedToArray(_useQueryFilter5, 1);
+      value = _useQueryFilter6[0];
+      return null;
+    };
+    render(/*#__PURE__*/_react["default"].createElement(MemoryRouter, {
+      initial: "status=rejected&page=3"
+    }, /*#__PURE__*/_react["default"].createElement(List, null)));
+    expect(value).toBe('rejected');
+    expect(url).toBe('');
+  });
+  test('сброс фильтра с непустым значением по умолчанию не возвращает его обратно', function () {
+    var value;
+    var setter = function setter() {
+      return undefined;
+    };
+    var List = function List() {
+      var _useQueryFilter7 = (0, _.useQueryFilter)('ids', ['a', 'b'], function (raw) {
+        return raw ? raw.split(',') : undefined;
+      }, function (next) {
+        return next ? next.join(',') : '';
+      });
+      var _useQueryFilter8 = _slicedToArray(_useQueryFilter7, 2);
+      value = _useQueryFilter8[0];
+      setter = _useQueryFilter8[1];
+      return null;
+    };
+    render(/*#__PURE__*/_react["default"].createElement(MemoryRouter, null, /*#__PURE__*/_react["default"].createElement(List, null)));
+    expect(value).toEqual(['a', 'b']);
+    (0, _react.act)(function () {
+      return setter(undefined);
+    });
+    expect(url).toBe('page=1');
+    expect(value).toBeUndefined();
+  });
+  test('isResetPageWhenChanged=false не трогает страницу', function () {
+    var setter = function setter() {
+      return undefined;
+    };
+    var List = function List() {
+      var _useQueryFilter9 = (0, _.useQueryFilter)('q', '', undefined, undefined, false);
+      var _useQueryFilter0 = _slicedToArray(_useQueryFilter9, 2);
+      setter = _useQueryFilter0[1];
+      return null;
+    };
+    render(/*#__PURE__*/_react["default"].createElement(MemoryRouter, {
+      initial: "page=4"
+    }, /*#__PURE__*/_react["default"].createElement(List, null)));
+    (0, _react.act)(function () {
+      return setter('abc');
+    });
+    expect(url).toBe('page=4&q=abc');
+  });
+});
+describe('formatDateForQuery', function () {
+  test('локальное время со смещением, без миллисекунд', function () {
+    var date = new Date(2026, 0, 2, 3, 4, 5, 678);
+    var formatted = (0, _.formatDateForQuery)(date);
+    expect(formatted).toMatch(/^2026-01-02T03:04:05[+-]\d{2}:\d{2}$/);
+    expect(new Date(formatted).getTime()).toBe(new Date(2026, 0, 2, 3, 4, 5).getTime());
+  });
+});
+describe('разборщики', function () {
+  test('диапазон дат пишется без времени и читается обратно', function () {
+    var range = [new Date(2026, 9, 1, 15, 0), new Date(2026, 9, 31, 9, 0)];
+    var query = (0, _.getQueryStringFromDateArrOrNull)(range);
+    expect(query).toBe('2026-10-01!!!2026-10-31');
+    expect((0, _.getDateArrOrNullFromQueryString)(query)).toHaveLength(2);
+    expect((0, _.getDateArrOrNullFromQueryString)(null)).toBeNull();
+  });
+  test('булевы значения', function () {
+    expect((0, _.booleanFromString)('true')).toBe(true);
+    expect((0, _.booleanFromString)('false')).toBe(false);
+    expect((0, _.booleanFromString)(null)).toBeNull();
+  });
+});

package/dist/hooks/useUnupdatableHandler/index.stories.js

@@ -8,8 +8,7 @@ exports["default"] = exports.Default = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _addonActions = require("@storybook/addon-actions");
 var _ = require(".");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != _typeof(e) && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }

package/dist/index.d.ts

@@ -73,5 +73,7 @@ export { useLoadingSubmit } from './hooks/useLoadingSubmit';
 export { breakpoints } from './breakpoints';
 export { useMobile, useTablet, useLargeTablet, useMiniLaptop } from './hooks/useMedia';
 export { useModal } from './hooks/useModal';
+export { useQueryFilter, QueryFilterProvider, DEFAULT_PAGE_PARAM_NAME, DEFAULT_FIRST_PAGE, DATA_SPLITTER, formatDateForQuery, formatDateOnlyForQuery, getDateOrNullFromQueryString, getQueryStringFromDateOrNull, getDateArrOrNullFromQueryString, getQueryStringFromDateArrOrNull, getNumberOrNullFromQueryString, getQueryStringFromNumberOrNull, getQueryStringFromArrayString, getArrayStringsFromQueryString, booleanFromString, } from './hooks/useQueryFilter';
+export type { TUseQueryArgumentType, TQueryFilterProviderProps } from './hooks/useQueryFilter';
 export { LENGTH_VAT_NUMBER } from './validate/utils/vatNumberValidateHelpers';
 export { Validate } from './validate';

package/dist/index.js

@@ -75,6 +75,24 @@ Object.defineProperty(exports, "CurrencyInputString", {
     return _CurrencyInputString.CurrencyInputString;
   }
 });
+Object.defineProperty(exports, "DATA_SPLITTER", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.DATA_SPLITTER;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_FIRST_PAGE", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.DEFAULT_FIRST_PAGE;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_PAGE_PARAM_NAME", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.DEFAULT_PAGE_PARAM_NAME;
+  }
+});
 Object.defineProperty(exports, "DROPDOWN_PORTAL_ATTR", {
   enumerable: true,
   get: function get() {
@@ -189,6 +207,12 @@ Object.defineProperty(exports, "QRCode", {
     return _QRCode.QRCode;
   }
 });
+Object.defineProperty(exports, "QueryFilterProvider", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.QueryFilterProvider;
+  }
+});
 Object.defineProperty(exports, "ReadOnlyLabelValueField", {
   enumerable: true,
   get: function get() {
@@ -273,6 +297,12 @@ Object.defineProperty(exports, "WarningIcon", {
     return _WarningIcon.WarningIcon;
   }
 });
+Object.defineProperty(exports, "booleanFromString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.booleanFromString;
+  }
+});
 Object.defineProperty(exports, "breakpoints", {
   enumerable: true,
   get: function get() {
@@ -285,6 +315,66 @@ Object.defineProperty(exports, "defaultAbstractPalette", {
     return _palette.defaultAbstractPalette;
   }
 });
+Object.defineProperty(exports, "formatDateForQuery", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.formatDateForQuery;
+  }
+});
+Object.defineProperty(exports, "formatDateOnlyForQuery", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.formatDateOnlyForQuery;
+  }
+});
+Object.defineProperty(exports, "getArrayStringsFromQueryString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getArrayStringsFromQueryString;
+  }
+});
+Object.defineProperty(exports, "getDateArrOrNullFromQueryString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getDateArrOrNullFromQueryString;
+  }
+});
+Object.defineProperty(exports, "getDateOrNullFromQueryString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getDateOrNullFromQueryString;
+  }
+});
+Object.defineProperty(exports, "getNumberOrNullFromQueryString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getNumberOrNullFromQueryString;
+  }
+});
+Object.defineProperty(exports, "getQueryStringFromArrayString", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getQueryStringFromArrayString;
+  }
+});
+Object.defineProperty(exports, "getQueryStringFromDateArrOrNull", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getQueryStringFromDateArrOrNull;
+  }
+});
+Object.defineProperty(exports, "getQueryStringFromDateOrNull", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getQueryStringFromDateOrNull;
+  }
+});
+Object.defineProperty(exports, "getQueryStringFromNumberOrNull", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.getQueryStringFromNumberOrNull;
+  }
+});
 Object.defineProperty(exports, "isDropdownPortalClick", {
   enumerable: true,
   get: function get() {
@@ -345,6 +435,12 @@ Object.defineProperty(exports, "useOutsideClick", {
     return _useOutsideClick.useOutsideClick;
   }
 });
+Object.defineProperty(exports, "useQueryFilter", {
+  enumerable: true,
+  get: function get() {
+    return _useQueryFilter.useQueryFilter;
+  }
+});
 Object.defineProperty(exports, "useTablet", {
   enumerable: true,
   get: function get() {
@@ -405,5 +501,6 @@ var _useLoadingSubmit = require("./hooks/useLoadingSubmit");
 var _breakpoints = require("./breakpoints");
 var _useMedia = require("./hooks/useMedia");
 var _useModal = require("./hooks/useModal");
+var _useQueryFilter = require("./hooks/useQueryFilter");
 var _vatNumberValidateHelpers = require("./validate/utils/vatNumberValidateHelpers");
 var _validate = require("./validate");