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

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

@@ -0,0 +1,123 @@
+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; }
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useQueryFilterContext } from './context';
+export { QueryFilterProvider, DEFAULT_PAGE_PARAM_NAME, DEFAULT_FIRST_PAGE } from './context';
+export * from './helpers';
+var getIsEmptyValue = function getIsEmptyValue(value) {
+  return value === '' || value === undefined || value === null || Array.isArray(value) && value.length === 0;
+};
+
+/**
+ * Значение фильтра, которое живёт в строке запроса.
+ *
+ * - `initialValue` записывается в адрес при монтировании, если параметра там ещё нет;
+ *   пустое значение (`''`, `null`, `undefined`, `[]`) удаляет параметр.
+ * - Смена значения сбрасывает номер страницы на первую (`isResetPageWhenChanged`).
+ * - Начальное значение можно передавать выражением (`new Date()`, `[]`): хук сравнивает его
+ *   по строке, которую оно даёт в адресе, а не по ссылке.
+ *
+ * Нужен `QueryFilterProvider` выше по дереву.
+ */
+export var useQueryFilter = function useQueryFilter(name, initialValue, fromString, toString) {
+  var _searchParams$get;
+  var isResetPageWhenChanged = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : true;
+  var _useQueryFilterContex = useQueryFilterContext(),
+    searchParams = _useQueryFilterContex.searchParams,
+    setSearchParams = _useQueryFilterContex.setSearchParams,
+    pageParamName = _useQueryFilterContex.pageParamName,
+    firstPage = _useQueryFilterContex.firstPage;
+
+  // для тех случаев когда если initialValue и в случае когда он не успел вставить в квери параметры - возвращать его
+  var _useState = useState(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    acceptInitialValueDone = _useState2[0],
+    setAcceptInitialValueDone = _useState2[1];
+  var serialize = useCallback(function (value) {
+    if (getIsEmptyValue(value)) return '';
+    return toString ? toString(value) : String(value);
+  }, [toString]);
+  var removeAttribute = 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 = 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 = 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 = useMemo(function () {
+    return initialValue;
+  }, [initialKey]);
+  useEffect(function () {
+    acceptInitialValue(stableInitialValue);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [stableInitialValue]);
+  var handleGetValueFromString = 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 = useMemo(function () {
+    if (isInitialNotAppliedYet || rawQueryValue === initialKey) {
+      return stableInitialValue;
+    }
+    return handleGetValueFromString(rawQueryValue || null);
+  }, [handleGetValueFromString, initialKey, isInitialNotAppliedYet, rawQueryValue, stableInitialValue]);
+  return [formattedValue, handleQueryChange];
+};

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

@@ -0,0 +1,71 @@
+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; }
+import React, { useCallback, useState } from 'react';
+/* eslint-disable react-hooks/rules-of-hooks */
+
+import { QueryFilterProvider, getDateOrNullFromQueryString, getQueryStringFromDateOrNull, useQueryFilter } from '.';
+var meta = {
+  title: 'hooks/useQueryFilter',
+  tags: ['autodocs']
+};
+export default meta;
+
+// В приложении сюда передают useSearchParams() роутера; в истории адрес живёт в состоянии
+var InMemoryRouter = function InMemoryRouter(_ref) {
+  var children = _ref.children;
+  var _useState = useState(function () {
+      return new URLSearchParams();
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    searchParams = _useState2[0],
+    setSearchParamsState = _useState2[1];
+  var setSearchParams = useCallback(function (next) {
+    return setSearchParamsState(new URLSearchParams(next.toString()));
+  }, []);
+  return /*#__PURE__*/React.createElement(QueryFilterProvider, {
+    searchParams: searchParams,
+    setSearchParams: setSearchParams
+  }, children(searchParams.toString()));
+};
+var Filters = function Filters() {
+  var _useQueryFilter = useQueryFilter('status', 'pending'),
+    _useQueryFilter2 = _slicedToArray(_useQueryFilter, 2),
+    status = _useQueryFilter2[0],
+    setStatus = _useQueryFilter2[1];
+  var _useQueryFilter3 = useQueryFilter('from', null, getDateOrNullFromQueryString, getQueryStringFromDateOrNull),
+    _useQueryFilter4 = _slicedToArray(_useQueryFilter3, 2),
+    from = _useQueryFilter4[0],
+    setFrom = _useQueryFilter4[1];
+  return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("p", null, "status: ", status || '—'), /*#__PURE__*/React.createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setStatus('approved');
+    }
+  }, "status = approved"), /*#__PURE__*/React.createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setStatus('');
+    }
+  }, "\u0421\u0431\u0440\u043E\u0441\u0438\u0442\u044C status"), /*#__PURE__*/React.createElement("p", null, "from: ", from ? from.toLocaleString() : '—'), /*#__PURE__*/React.createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setFrom(new Date());
+    }
+  }, "from = \u0441\u0435\u0439\u0447\u0430\u0441"), /*#__PURE__*/React.createElement("button", {
+    type: 'button',
+    onClick: function onClick() {
+      return setFrom(null);
+    }
+  }, "\u0421\u0431\u0440\u043E\u0441\u0438\u0442\u044C from"));
+};
+export var Default = {
+  render: function render() {
+    return /*#__PURE__*/React.createElement(InMemoryRouter, null, function (search) {
+      return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("p", null, "\u0410\u0434\u0440\u0435\u0441: ", /*#__PURE__*/React.createElement("code", null, "?", search)), /*#__PURE__*/React.createElement(Filters, null));
+    });
+  }
+};

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

@@ -0,0 +1,180 @@
+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
+ */
+import React, { act, startTransition, useCallback, useEffect, useState } from 'react';
+import { createRoot } from 'react-dom/client';
+import { booleanFromString, formatDateForQuery, getDateArrOrNullFromQueryString, getQueryStringFromDateArrOrNull, getDateOrNullFromQueryString, getQueryStringFromDateOrNull, QueryFilterProvider, useQueryFilter } from '.';
+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 = useState(function () {
+      return new URLSearchParams(initial);
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    searchParams = _useState2[0],
+    setSearchParamsState = _useState2[1];
+  var setSearchParams = useCallback(function (next) {
+    var nextString = next.toString();
+    url = nextString;
+    startTransition(function () {
+      return setSearchParamsState(new URLSearchParams(nextString));
+    });
+  }, []);
+  return /*#__PURE__*/React.createElement(QueryFilterProvider, {
+    searchParams: searchParams,
+    setSearchParams: setSearchParams
+  }, children);
+};
+var container;
+var root;
+beforeEach(function () {
+  url = '';
+  container = document.createElement('div');
+  root = createRoot(container);
+});
+afterEach(function () {
+  act(function () {
+    return root.unmount();
+  });
+});
+var render = function render(node) {
+  return 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 = useQueryFilter('status', 'pending'),
+        _useQueryFilter2 = _slicedToArray(_useQueryFilter, 2),
+        status = _useQueryFilter2[0],
+        setStatus = _useQueryFilter2[1];
+      setter = setStatus;
+      useEffect(function () {
+        requests.push(status);
+      }, [status]);
+      return null;
+    };
+    render(/*#__PURE__*/React.createElement(MemoryRouter, null, /*#__PURE__*/React.createElement(List, null)));
+    expect(url).toBe('status=pending');
+    expect(requests).toEqual(['pending']);
+    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 = useQueryFilter('from', new Date(from.getTime()), getDateOrNullFromQueryString, getQueryStringFromDateOrNull),
+        _useQueryFilter4 = _slicedToArray(_useQueryFilter3, 1),
+        dateFrom = _useQueryFilter4[0];
+      useEffect(function () {
+        requests.push(String(dateFrom === null || dateFrom === void 0 ? void 0 : dateFrom.getTime()));
+      }, [dateFrom]);
+      return null;
+    };
+    render(/*#__PURE__*/React.createElement(MemoryRouter, null, /*#__PURE__*/React.createElement(List, null)));
+    expect(new URLSearchParams(url).get('from')).toBe(formatDateForQuery(from));
+    expect(requests).toEqual([String(from.getTime())]);
+  });
+  test('значение из адреса важнее значения по умолчанию', function () {
+    var value = '';
+    var List = function List() {
+      var _useQueryFilter5 = useQueryFilter('status', 'pending');
+      var _useQueryFilter6 = _slicedToArray(_useQueryFilter5, 1);
+      value = _useQueryFilter6[0];
+      return null;
+    };
+    render(/*#__PURE__*/React.createElement(MemoryRouter, {
+      initial: "status=rejected&page=3"
+    }, /*#__PURE__*/React.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 = 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.createElement(MemoryRouter, null, /*#__PURE__*/React.createElement(List, null)));
+    expect(value).toEqual(['a', 'b']);
+    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 = useQueryFilter('q', '', undefined, undefined, false);
+      var _useQueryFilter0 = _slicedToArray(_useQueryFilter9, 2);
+      setter = _useQueryFilter0[1];
+      return null;
+    };
+    render(/*#__PURE__*/React.createElement(MemoryRouter, {
+      initial: "page=4"
+    }, /*#__PURE__*/React.createElement(List, null)));
+    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 = 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 = getQueryStringFromDateArrOrNull(range);
+    expect(query).toBe('2026-10-01!!!2026-10-31');
+    expect(getDateArrOrNullFromQueryString(query)).toHaveLength(2);
+    expect(getDateArrOrNullFromQueryString(null)).toBeNull();
+  });
+  test('булевы значения', function () {
+    expect(booleanFromString('true')).toBe(true);
+    expect(booleanFromString('false')).toBe(false);
+    expect(booleanFromString(null)).toBeNull();
+  });
+});

package/dist/esm/index.js

@@ -22,7 +22,9 @@ export { ToastContainer, toast } from './components/common/Toast';
 export { AppCardLink } from './components/common/AppCardLink';
 export { InvoiceboxLogo } from './components/common/InvoiceboxLogo';
 export { QRCode } from './components/common/QRCode';
-
+export { Modal, useModalExpansion, modalExpansionFlexItem } from './components/common/Modal';
+export { AdaptiveModalDrawer } from './components/common/AdaptiveModalDrawer';
+export { WentWrongModal, WENT_WRONG_MODAL_DEFAULT_CONTACTS } from './components/common/WentWrongModal';
 // form
 export { InputLabel } from './components/form/InputLabel';
 export { PureInput } from './components/form/PureInput';
@@ -50,5 +52,6 @@ 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 { LENGTH_VAT_NUMBER } from './validate/utils/vatNumberValidateHelpers';
 export { Validate } from './validate';

package/dist/esm/palette/context.js

@@ -33,6 +33,8 @@ import { generateDateTimeInputPalette } from '../components/form/DateTimeInput/p
 import { generateDrawerHeaderPalette } from '../components/form/common/DrawerHeader/palette';
 import { generateCheckboxPalette } from '../components/form/Checkbox/palette';
 import { generateTooltipPalette } from '../components/common/Tooltip/palette';
+import { generateModalPalette } from '../components/common/Modal/palette';
+import { generateWentWrongModalPalette } from '../components/common/WentWrongModal/palette';
 export var PaletteContext = /*#__PURE__*/createContext({
   skeleton: generateSkeletonPalette(defaultAbstractPalette),
   invoiceboxSpinner: generateInvoiceboxSpinnerPalette(defaultAbstractPalette),
@@ -66,5 +68,7 @@ export var PaletteContext = /*#__PURE__*/createContext({
   dateTimeInput: generateDateTimeInputPalette(defaultAbstractPalette),
   drawerHeader: generateDrawerHeaderPalette(defaultAbstractPalette),
   checkbox: generateCheckboxPalette(defaultAbstractPalette),
-  tooltip: generateTooltipPalette(defaultAbstractPalette)
+  tooltip: generateTooltipPalette(defaultAbstractPalette),
+  modal: generateModalPalette(defaultAbstractPalette),
+  wentWrongModal: generateWentWrongModalPalette(defaultAbstractPalette)
 });

package/dist/esm/palette/provider.js

@@ -40,6 +40,8 @@ import { generateDateTimeInputPalette } from '../components/form/DateTimeInput/p
 import { generateDrawerHeaderPalette } from '../components/form/common/DrawerHeader/palette';
 import { generateCheckboxPalette } from '../components/form/Checkbox/palette';
 import { generateTooltipPalette } from '../components/common/Tooltip/palette';
+import { generateModalPalette } from '../components/common/Modal/palette';
+import { generateWentWrongModalPalette } from '../components/common/WentWrongModal/palette';
 export var PaletteProvider = function PaletteProvider(_ref) {
   var children = _ref.children,
     _abstract = _ref["abstract"],
@@ -84,7 +86,9 @@ export var PaletteProvider = function PaletteProvider(_ref) {
       dateTimeInput: generateDateTimeInputPalette(mergedAbstractPalette),
       drawerHeader: generateDrawerHeaderPalette(mergedAbstractPalette),
       checkbox: generateCheckboxPalette(mergedAbstractPalette),
-      tooltip: generateTooltipPalette(mergedAbstractPalette)
+      tooltip: generateTooltipPalette(mergedAbstractPalette),
+      modal: generateModalPalette(mergedAbstractPalette),
+      wentWrongModal: generateWentWrongModalPalette(mergedAbstractPalette)
     };
   }, [mergedSkeletonPalette, mergedAbstractPalette]);
   return /*#__PURE__*/React.createElement(PaletteContext.Provider, {

package/dist/hooks/useQueryFilter/context.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from 'react';
+export declare const DEFAULT_PAGE_PARAM_NAME = "page";
+export declare const DEFAULT_FIRST_PAGE = 1;
+export type TQueryFilterContext = {
+    /** Текущие параметры строки запроса (например, `useSearchParams()[0]` из react-router) */
+    searchParams: URLSearchParams;
+    /**
+     * Записать параметры в адрес. Хук передаёт сюда тот же объект `searchParams`, предварительно
+     * изменив его, поэтому реализация обязана довести дело до НОВОГО объекта `searchParams`
+     * в следующем рендере (react-router так и делает: пишет адрес и разбирает его заново).
+     */
+    setSearchParams: (nextSearchParams: URLSearchParams) => void;
+    /** Имя параметра страницы, который сбрасывается при смене фильтра. По умолчанию `page` */
+    pageParamName: string;
+    /** Номер первой страницы. По умолчанию `1` */
+    firstPage: number;
+};
+export type TQueryFilterProviderProps = {
+    searchParams: URLSearchParams;
+    setSearchParams: (nextSearchParams: URLSearchParams) => void;
+    pageParamName?: string;
+    firstPage?: number;
+    children: ReactNode;
+};
+/**
+ * Подключает `useQueryFilter` к роутеру приложения. Библиотека от роутера не зависит:
+ * приложение само передаёт параметры строки запроса и способ их записать.
+ *
+ * ```tsx
+ * const [searchParams, setSearchParams] = useSearchParams();
+ * <QueryFilterProvider searchParams={searchParams} setSearchParams={setSearchParams}>
+ * ```
+ */
+export declare const QueryFilterProvider: ({ searchParams, setSearchParams, pageParamName, firstPage, children, }: TQueryFilterProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useQueryFilterContext: () => TQueryFilterContext;

package/dist/hooks/useQueryFilter/context.js

@@ -0,0 +1,48 @@
+"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.useQueryFilterContext = exports.QueryFilterProvider = exports.DEFAULT_PAGE_PARAM_NAME = exports.DEFAULT_FIRST_PAGE = void 0;
+var _react = _interopRequireWildcard(require("react"));
+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); }
+var DEFAULT_PAGE_PARAM_NAME = exports.DEFAULT_PAGE_PARAM_NAME = 'page';
+var DEFAULT_FIRST_PAGE = exports.DEFAULT_FIRST_PAGE = 1;
+var QueryFilterContext = /*#__PURE__*/(0, _react.createContext)(null);
+/**
+ * Подключает `useQueryFilter` к роутеру приложения. Библиотека от роутера не зависит:
+ * приложение само передаёт параметры строки запроса и способ их записать.
+ *
+ * ```tsx
+ * const [searchParams, setSearchParams] = useSearchParams();
+ * <QueryFilterProvider searchParams={searchParams} setSearchParams={setSearchParams}>
+ * ```
+ */
+var QueryFilterProvider = exports.QueryFilterProvider = function QueryFilterProvider(_ref) {
+  var searchParams = _ref.searchParams,
+    setSearchParams = _ref.setSearchParams,
+    _ref$pageParamName = _ref.pageParamName,
+    pageParamName = _ref$pageParamName === void 0 ? DEFAULT_PAGE_PARAM_NAME : _ref$pageParamName,
+    _ref$firstPage = _ref.firstPage,
+    firstPage = _ref$firstPage === void 0 ? DEFAULT_FIRST_PAGE : _ref$firstPage,
+    children = _ref.children;
+  var value = (0, _react.useMemo)(function () {
+    return {
+      searchParams: searchParams,
+      setSearchParams: setSearchParams,
+      pageParamName: pageParamName,
+      firstPage: firstPage
+    };
+  }, [searchParams, setSearchParams, pageParamName, firstPage]);
+  return /*#__PURE__*/_react["default"].createElement(QueryFilterContext.Provider, {
+    value: value
+  }, children);
+};
+var useQueryFilterContext = exports.useQueryFilterContext = function useQueryFilterContext() {
+  var context = (0, _react.useContext)(QueryFilterContext);
+  if (!context) {
+    throw new Error('useQueryFilter must be used inside QueryFilterProvider');
+  }
+  return context;
+};

package/dist/hooks/useQueryFilter/helpers.d.ts

@@ -0,0 +1,17 @@
+export declare const DATA_SPLITTER = "!!!";
+/**
+ * Дата в строку запроса: локальное время со смещением, `yyyy-MM-dd'T'HH:mm:ssxxx`
+ * (например, `2026-10-06T19:16:00+07:00`). Миллисекунды отбрасываются.
+ */
+export declare const formatDateForQuery: (date: Date) => string;
+/** Дата без времени: `yyyy-MM-dd` по местному времени */
+export declare const formatDateOnlyForQuery: (date: Date) => string;
+export declare const getDateOrNullFromQueryString: (value: string | null) => Date | null;
+export declare const getQueryStringFromDateOrNull: (value: Date | null) => string;
+export declare const getDateArrOrNullFromQueryString: (value: string | null) => [Date, Date] | null;
+export declare const getQueryStringFromDateArrOrNull: (value: [Date, Date] | null) => string;
+export declare const getNumberOrNullFromQueryString: (value: string | null) => number | null;
+export declare const getQueryStringFromNumberOrNull: (value: number | null) => string;
+export declare const getQueryStringFromArrayString: (value: Array<string> | undefined) => string;
+export declare const getArrayStringsFromQueryString: (value: string | null) => string[] | undefined;
+export declare const booleanFromString: (value: string | null) => boolean | null;

package/dist/hooks/useQueryFilter/helpers.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getQueryStringFromNumberOrNull = exports.getQueryStringFromDateOrNull = exports.getQueryStringFromDateArrOrNull = exports.getQueryStringFromArrayString = exports.getNumberOrNullFromQueryString = exports.getDateOrNullFromQueryString = exports.getDateArrOrNullFromQueryString = exports.getArrayStringsFromQueryString = exports.formatDateOnlyForQuery = exports.formatDateForQuery = exports.booleanFromString = exports.DATA_SPLITTER = void 0;
+var DATA_SPLITTER = exports.DATA_SPLITTER = '!!!';
+var pad = function pad(value) {
+  return String(value).padStart(2, '0');
+};
+
+/**
+ * Дата в строку запроса: локальное время со смещением, `yyyy-MM-dd'T'HH:mm:ssxxx`
+ * (например, `2026-10-06T19:16:00+07:00`). Миллисекунды отбрасываются.
+ */
+var formatDateForQuery = exports.formatDateForQuery = function formatDateForQuery(date) {
+  var offsetMinutes = -date.getTimezoneOffset();
+  var sign = offsetMinutes >= 0 ? '+' : '-';
+  var absOffset = Math.abs(offsetMinutes);
+  return "".concat(date.getFullYear(), "-").concat(pad(date.getMonth() + 1), "-").concat(pad(date.getDate())) + "T".concat(pad(date.getHours()), ":").concat(pad(date.getMinutes()), ":").concat(pad(date.getSeconds())) + "".concat(sign).concat(pad(Math.floor(absOffset / 60)), ":").concat(pad(absOffset % 60));
+};
+
+/** Дата без времени: `yyyy-MM-dd` по местному времени */
+var formatDateOnlyForQuery = exports.formatDateOnlyForQuery = function formatDateOnlyForQuery(date) {
+  return "".concat(date.getFullYear(), "-").concat(pad(date.getMonth() + 1), "-").concat(pad(date.getDate()));
+};
+var getDateOrNullFromQueryString = exports.getDateOrNullFromQueryString = function getDateOrNullFromQueryString(value) {
+  return value ? new Date(value) : null;
+};
+var getQueryStringFromDateOrNull = exports.getQueryStringFromDateOrNull = function getQueryStringFromDateOrNull(value) {
+  return value ? formatDateForQuery(value) : '';
+};
+var getDateArrOrNullFromQueryString = exports.getDateArrOrNullFromQueryString = function getDateArrOrNullFromQueryString(value) {
+  if (value) {
+    var datesArray = value.split(DATA_SPLITTER).map(function (date) {
+      return new Date(date);
+    });
+    if (datesArray.length === 2) {
+      return [datesArray[0], datesArray[1]];
+    }
+  }
+  return null;
+};
+// Диапазон дат хранится в адресе без времени — так он и раньше писался в кабинете
+var getQueryStringFromDateArrOrNull = exports.getQueryStringFromDateArrOrNull = function getQueryStringFromDateArrOrNull(value) {
+  return value ? value.map(formatDateOnlyForQuery).join(DATA_SPLITTER) : '';
+};
+var getNumberOrNullFromQueryString = exports.getNumberOrNullFromQueryString = function getNumberOrNullFromQueryString(value) {
+  return value ? Number(value) : null;
+};
+var getQueryStringFromNumberOrNull = exports.getQueryStringFromNumberOrNull = function getQueryStringFromNumberOrNull(value) {
+  return value ? String(value) : '';
+};
+var getQueryStringFromArrayString = exports.getQueryStringFromArrayString = function getQueryStringFromArrayString(value) {
+  return (value === null || value === void 0 ? void 0 : value.join(DATA_SPLITTER)) || '';
+};
+var getArrayStringsFromQueryString = exports.getArrayStringsFromQueryString = function getArrayStringsFromQueryString(value) {
+  return value ? value.split(DATA_SPLITTER) : undefined;
+};
+var booleanFromString = exports.booleanFromString = function booleanFromString(value) {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  return null;
+};

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

@@ -0,0 +1,19 @@
+export { QueryFilterProvider, DEFAULT_PAGE_PARAM_NAME, DEFAULT_FIRST_PAGE } from './context';
+export type { TQueryFilterProviderProps } from './context';
+export * from './helpers';
+export type TUseQueryArgumentType = string | Array<string> | undefined | [Date, Date] | null | number | Date | boolean | {
+    start: Date;
+    end: Date;
+};
+/**
+ * Значение фильтра, которое живёт в строке запроса.
+ *
+ * - `initialValue` записывается в адрес при монтировании, если параметра там ещё нет;
+ *   пустое значение (`''`, `null`, `undefined`, `[]`) удаляет параметр.
+ * - Смена значения сбрасывает номер страницы на первую (`isResetPageWhenChanged`).
+ * - Начальное значение можно передавать выражением (`new Date()`, `[]`): хук сравнивает его
+ *   по строке, которую оно даёт в адресе, а не по ссылке.
+ *
+ * Нужен `QueryFilterProvider` выше по дереву.
+ */
+export declare const useQueryFilter: <T extends TUseQueryArgumentType>(name: string, initialValue: T, fromString?: ((value: string | null) => T) | undefined, toString?: ((value: T) => string) | undefined, isResetPageWhenChanged?: boolean) => [T, (newValue: T) => void];