@ryuzaki13/react-foundation-lib 2.22.0 → 2.24.0

package/src/analytical-table/README.mdx

@@ -1,41 +1,22 @@
-# Analytical Table: чистая модель полного снимка
-
-Модуль `@ryuzaki13/react-foundation-lib/analytical-table` предоставляет вычислительный
-слой аналитической таблицы. Он подходит для SSR и браузера, не использует React hooks,
-QueryClient, serverFn, OData-запросы, SAP metadata, DOM или browser storage. Загрузкой, ошибками,
-отменой и авторизацией владеет транспорт приложения. Результат запроса передаётся
-как неизменяемый `AnalyticalSnapshot`; дополнительных запросов при группировке,
-сортировке или раскрытии нет.
-
-## Контракт и владельцы состояния
-
-`AnalyticalSnapshot<T>` содержит `rows`. Каждая `AnalyticalDataRow<T>` содержит
-стабильный `id`, необязательный `parentId`, значения `values`, исходную запись
-`original` и необязательный предметный `kind`. Нельзя использовать номер позиции
-строки как идентификатор: сортировка и обновление снимка должны сохранять выбор и
-раскрытие. Runtime не изменяет исходные строки и не копирует предметные DTO
-рекурсивно: `original` остаётся ссылкой на неизменяемую запись потребителя.
-
-`AnalyticalColumn<T>` задаёт идентификатор, подпись, тип значения, необязательные
-сравнение, фильтр, агрегацию и вычисление. В столбцах должны присутствовать также
-скрытые зависимости формул. Ключи и отображаемые поля группировки могут ссылаться
-прямо на поля values, не создавая технических столбцов интерфейса. Видимость, ширина,
-закрепление и порядок столбцов относятся к UI и не должны пересчитывать модель.
-Форматирование значений выполняется существующим `/formatters` на границе UI или
-экспорта; runtime сохраняет числа числами.
-
-`AnalyticalViewState` содержит группировки, сортировку, фильтры и идентификаторы
-раскрытых строк. Оно сериализуемо, но не является загружаемыми данными.
-`AnalyticalTableModel` содержит дерево `rows`, все строки `flatRows`, видимые строки
-`visibleRows`, индекс `rowById`, общие итоги `grandTotals` и диагностику иерархии.
-`Map` результата вычисляется локально: передавать его через serverFn не требуется.
+# Analytical Table: модель полного снимка
+
+`@ryuzaki13/react-foundation-lib/analytical-table` строит дерево, группировки,
+фильтры, вычисляемые значения и итоги уже загруженных данных. Модуль работает в
+SSR и браузере без React hooks, DOM, QueryClient, serverFn или OData. Загрузка,
+отмена запросов, ошибки и авторизация остаются у транспорта потребителя.
+
+Для одного расчёта используйте `buildAnalyticalTableModel`. Для таблицы, в которой
+пользователь меняет фильтры, сортировку и раскрытие, один раз скомпилируйте описание
+и создайте runtime на текущий снимок. Оба способа используют один вычислительный
+конвейер и возвращают `AnalyticalTableModel`.
+
+## Один вызов
+
+Прежняя точка входа сохраняет сигнатуру и подходит для разового построения модели,
+экспорта или простого потребителя без повторных изменений представления.
 
 ```ts
-import {
-	buildAnalyticalTableModel,
-	projectAnalyticalTableExpansion,
-	type AnalyticalSnapshot
-} from "@ryuzaki13/react-foundation-lib/analytical-table";
+import { buildAnalyticalTableModel, type AnalyticalSnapshot } from "@ryuzaki13/react-foundation-lib/analytical-table";
 
 const snapshot: AnalyticalSnapshot = {
 	rows: [
@@ -51,119 +32,227 @@ const model = buildAnalyticalTableModel({
 	],
 	state: {
 		grouping: [{ id: "customer", keyColumnIds: ["customer"] }],
-		sorting: [{ id: "amount", desc: true }]
+		sorting: [{ id: "amount", desc: true }],
+		expandedRowIds: "all"
 	}
 });
-const expanded = projectAnalyticalTableExpansion(model, "all");
+// Общий итог — 100: дочерняя детализация не прибавляется к корню второй раз.
 ```
 
-## Иерархия и группировки
+## Описание и runtime для интерактивной таблицы
+
+`compileAnalyticalTableDefinition` проверяет описание, индексирует поля и
+компилирует зависимости формул. `createAnalyticalTableRuntime` готовит исходные
+строки одного снимка; `runtime.getModel(state)` меняет его представление.
+
+```ts
+import {
+	compileAnalyticalTableDefinition,
+	createAnalyticalTableRuntime,
+	type AnalyticalGroupingLevel,
+	type AnalyticalSnapshot,
+	type AnalyticalSorting
+} from "@ryuzaki13/react-foundation-lib/analytical-table";
+
+const definition = compileAnalyticalTableDefinition({
+	columns: [
+		{ id: "customerName", label: "Покупатель", kind: "dimension" },
+		{
+			id: "averagePrice",
+			label: "Средняя цена",
+			kind: "measure",
+			calculate: {
+				dependencies: ["amount", "quantity"],
+				compute: (values) => (Number(values.quantity) > 0 ? Number(values.amount) / Number(values.quantity) : null)
+			}
+		}
+	],
+	dataFields: [
+		{ id: "customerId" },
+		{ id: "quantity", aggregate: "sum" },
+		{ id: "price" },
+		{
+			id: "amount",
+			aggregate: "sum",
+			calculate: { dependencies: ["quantity", "price"], compute: (values) => Number(values.quantity) * Number(values.price) }
+		}
+	],
+	grandTotalsScope: "filtered"
+});
+const snapshot: AnalyticalSnapshot = {
+	rows: [
+		{ id: "order:1", values: { customerId: "a", customerName: "Компания А", quantity: 2, price: 30 } },
+		{ id: "order:2", values: { customerId: "a", customerName: "Компания А", quantity: 1, price: 120 } }
+	]
+};
+const runtime = createAnalyticalTableRuntime({ definition, snapshot });
+const grouping: readonly AnalyticalGroupingLevel[] = [{ id: "customer", keyColumnIds: ["customerId"], displayColumnIds: ["customerName"] }];
+const sorting: readonly AnalyticalSorting[] = [{ id: "averagePrice", desc: true }];
+
+const initial = runtime.getModel({ grouping });
+const sorted = runtime.getModel({ grouping, sorting });
+const expanded = runtime.getModel({ grouping, sorting, expandedRowIds: "all" });
+// Итоговая средняя цена — 60: (2 × 30 + 1 × 120) / (2 + 1).
+// Сортировка и раскрытие не запускают формулы и агрегации повторно.
+```
+
+`columns` — столбцы представления. Колонка, которую пользователь временно скрыл,
+остаётся в этом массиве: её видимость управляется UI. `dataFields` — служебные
+поля с теми же возможностями вычисления, сравнения и агрегации; они доступны
+формулам и итогам, но не попадают в `model.columns`. Поэтому зависимость вроде
+`amount` не требует фиктивной скрытой колонки интерфейса. Идентификаторы уникальны
+в общем каталоге `columns` + `dataFields`; зависимости формул должны быть объявлены
+в одном из этих массивов. Поля, используемые только как ключи или подписи групп,
+могут ссылаться прямо на `values` без отдельного дескриптора.
+
+Runtime хранит **последний результат каждого этапа** внутри своего экземпляра.
+Глобального кэша, истории снимков или транспортного кэша здесь нет. Массивы фильтров,
+группировок, сортировки и раскрытия сравниваются по ссылке. Сохраняйте ссылку, пока
+содержимое не изменилось; новый равный массив может повторно запустить свой этап.
+Мутировать описание, снимок, элементы состояния или их массивы после передачи нельзя.
+
+| Что изменилось                         | Что пересчитывается                                                                                 |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| Описание, поля или правила вычисления  | Новая компиляция и новый runtime: исходные формулы и все следующие этапы.                           |
+| `snapshot.rows`                        | Новый runtime с прежним скомпилированным описанием: исходные формулы и все следующие этапы.         |
+| Фильтры                                | Отбор, группировки и итоги, затем сортировка и раскрытие. Исходные формулы повторно не исполняются. |
+| Группировки                            | Группировки и итоги, затем сортировка и раскрытие. Исходные формулы и готовый отбор сохраняются.    |
+| Сортировка                             | Порядок соседних строк и индексы; затем применяется раскрытие. Формулы и итоги сохраняются.         |
+| Раскрытие                              | Флаги раскрытия и индексы видимости. Формулы, группировки и итоги сохраняются.                      |
+| Ширины, закрепление, видимость колонок | Это состояние UI; оно не входит в вычислительный runtime.                                           |
 
-Построение исходной иерархии использует `/tree-table`. Повторяющиеся идентификаторы,
-сироты и циклы диагностируются по правилам этого модуля. Идентификатор строки не
-может быть пустым. Дополнительная группировка объединяет только корневые ветви:
-исходные дети остаются под своими родителями. Это позволяет сохранять обязательный
-предметный уровень и одновременно группировать его по нескольким признакам.
+Для новых `rows` создавайте новый runtime: существующий экземпляр не переключает
+снимок. В React описание можно мемоизировать по его конфигурации, runtime — по
+скомпилированному описанию и `snapshot.rows`. Обновление времени запроса при прежней
+ссылке `rows` не требует нового runtime. Изменение реестра используемых формул также
+требует повторной компиляции описания.
+
+## Данные и карта исходников
+
+`AnalyticalSnapshot<T>` содержит `rows`. Строка имеет стабильный `id`, необязательный
+`parentId`, `values`, предметный `kind` и исходный DTO `original`. Номер позиции не
+подходит для ID: обновление и сортировка должны сохранять identity. Runtime не
+мутирует снимок и не копирует DTO рекурсивно — `original` сохраняет исходную ссылку.
+
+`AnalyticalViewState` содержит только группировки, сортировку, фильтры и раскрытие.
+Результат содержит дерево `rows`, все строки `flatRows`, видимые `visibleRows`,
+`rowById`, `grandTotals` и `diagnostics`. Индекс `Map` вычисляется локально; передавать
+модель через serverFn не требуется. Числа остаются числами; отображение использует
+`/formatters` на границе UI или экспорта.
+
+| Каталог           | Ответственность                                                                |
+| ----------------- | ------------------------------------------------------------------------------ |
+| `definition`      | Контракты описания, каталог полей, проверка зависимостей и компиляция формул.  |
+| `runtime`         | Подготовка одного снимка, дерево, фильтрация, группировка, итоги и сортировка. |
+| `dynamic-columns` | Календарные интервалы и проекция уже загруженных фактов в динамические ячейки. |
+| `projections`     | Раскрытие, согласованные индексы дерева и подготовка экспорта.                 |
+
+Эта карта предназначена для сопровождения исходников. Потребители импортируют
+публичные функции и типы только из `/analytical-table`.
+
+## Иерархия, группировки и фильтры
+
+Исходная иерархия строится через `/tree-table`: повторяющиеся ID, сироты и циклы
+попадают в диагностику по правилам этого модуля. Пустой ID запрещён. Дополнительная
+группировка объединяет только корневые ветви; исходные дети сохраняют родителей.
 
 `AnalyticalGroupingLevel` задаёт `id`, составной `keyColumnIds` и отдельные
-`displayColumnIds`. Идентификатор группы зависит от всего пути ключей и типов
-значений, а не от подписи или порядка строк. Число, строка, null и undefined
-различаются. Отображаемые поля берутся из первой строки группы: потребитель обязан
-обеспечить, что они однозначно определяются ключом. Уровень не может иметь пустой
-список ключей. Повторяющиеся уровни отклоняются; сортировка и фильтры требуют
-известных дескрипторов столбцов.
-
-Сортировка применяется между соседними узлами на каждом уровне; она не отделяет
-детей от родителей. При равенстве сохраняется исходный порядок. Строковое сравнение
-использует `/string-comparison`, календарные значения — `/formatters`. Для иной
-семантики столбец задаёт `compare`.
-
-Фильтры поддерживают equals, notEquals, contains, startsWith, in, between, gt, gte,
-lt, lte, empty и notEmpty; текстовый поиск не зависит от регистра. Условия разных
-столбцов объединяются через AND. Фильтрация работает над исходными вычисленными
-строками **до** дополнительных группировок: совпавший родитель сохраняет ветвь
-целиком, совпавший ребёнок сохраняет путь к нему. Для предметной семантики есть
-`column.filter`.
-
-## Итоги и зернистость
-
-По умолчанию агрегируются только исходные корневые строки. Дочерняя детализация не
-удваивает их меры. `isAggregateRow` позволяет явно выбрать другую зернистость.
-`column.aggregate` поддерживает sum, min, max, avg, count и callback. Числовые
-агрегации принимают только конечные числа; строковое преобразование внешних DTO
-выполняется в адаптере источника. Пустое числовое множество возвращает null;
-count считает непустые значения и возвращает 0 для пустого множества.
-
-`aggregate(context)` возвращает значения групповых/общих итогов и может переопределить
-результаты стандартных агрегаций. Контекст содержит `scope`, `groupingPath` и только
-исходные строки выбранной зернистости. Например, доля должна вычисляться как
-отношение сумм числителя и знаменателя, если предметный учёт требует взвешенного
-результата. Библиотека не усредняет проценты вместо этого правила.
-
-`grandTotalsScope: "filtered"` (по умолчанию) учитывает оставшиеся ветви, `"all"`
-сохраняет общие итоги полного снимка при визуальной фильтрации. `grandTotals: false`
-отключает их вычисление. Раскрытие и выбор строк общие итоги не меняют.
-
-## Формулы и зависимые вычисления
-
-`createAnalyticalCalculationPlan(columns, requiredColumnIds?)` проверяет уникальность
-столбцов, зависимости и циклы, затем строит топологический порядок. `formula`
-содержит `formulaId` и упорядоченные `dependencies`: исполнение использует уже
-существующий реестр `/formulas`, который настраивает composition root приложения.
-`calculate` содержит зависимости и чистый `compute(values)` для вычислений,
-не представленных реестром. Одновременно задать formula и calculate нельзя.
-
-`calculateAnalyticalValues` возвращает отдельные значения. План компилируется один
-раз при построении модели и применяется к данным, затем к рассчитанным итогам.
-Явная агрегация колонки, результат `aggregate(context)` и значения пути группировки
-имеют приоритет над построчной формулой этой колонки. Зависимые формулы читают
-готовые итоги: сумма произведений сохраняется, а отношение сумм вычисляется заново.
-Вычисление должно учитывать отсутствующие значения в итоговой строке. Ошибки
-конфигурации и выполнения формул не скрываются успешным нулём.
-
-## Динамические календарные столбцы
-
-`createAnalyticalDateColumnsPlan` строит day/week/month/quarter/year buckets с
-включительными `from`/`to`; неделя начинается в понедельник. Идентификатор содержит
-гранулярность и календарное начало bucket, а крайние интервалы обрезаются диапазоном.
-По умолчанию допустимо не более 366 столбцов; превышение лимита приводит к ошибке.
-
-Границы диапазона и поле даты каждого факта имеют контракт **YYYY-MM-DD**.
-`Date`, числа и ISO timestamp с временем не принимаются как календарные факты.
-Их приведение с явной timezone-политикой выполняет адаптер до передачи в runtime.
-Неверные границы — ошибка; неверные факты и факты вне диапазона пропускаются.
+`displayColumnIds`. ID группы зависит от пути ключей и типов, а не от подписи или
+порядка строк. Число, строка, `null` и `undefined` различаются. Отображаемые поля
+берутся из первой строки группы и должны однозначно определяться ключом. Пустой
+список ключей и повторяющиеся уровни отклоняются. Сортировка и фильтры требуют
+дескриптора поля из `columns` или `dataFields`.
+
+Сортировка действует между соседями каждого уровня и сохраняет исходный порядок
+при равенстве. Строки сравниваются через `/string-comparison`, календарные значения —
+через `/formatters`; собственная семантика задаётся `compare`.
+
+Фильтры поддерживают `equals`, `notEquals`, `contains`, `startsWith`, `in`, `between`,
+`gt`, `gte`, `lt`, `lte`, `empty`, `notEmpty`. Текстовые `contains` и `startsWith` не
+зависят от регистра. Условия объединяются через AND и применяются к вычисленным
+исходным строкам **до** группировки: совпавший родитель сохраняет всю ветвь,
+совпавший ребёнок — путь к нему. Для предметной семантики предусмотрен `filter` поля.
+
+## Итоги и формулы
+
+По умолчанию агрегируются исходные корни: дочерняя детализация не удваивает их
+меры. `isAggregateRow` задаёт другую зернистость. `aggregate` поля поддерживает
+`sum`, `min`, `max`, `avg`, `count` и callback. Числовые операции принимают только
+конечные числа; преобразование DTO выполняет адаптер. Пустое числовое множество
+даёт `null`; `count` считает непустые значения, включая ноль и `false`, и даёт 0
+для пустого множества.
+
+`aggregate(context)` описания возвращает групповые/общие значения и может
+переопределить стандартные агрегаты. Контекст содержит `scope`, `groupingPath` и
+исходные строки выбранной зернистости. Взвешенные доли следует вычислять из сумм
+числителя и знаменателя, а не усреднять готовые проценты.
+
+`grandTotalsScope: "filtered"` по умолчанию учитывает оставшиеся ветви; `"all"`
+сохраняет итог полного снимка при фильтрации. `grandTotals: false` отключает его
+расчёт. Сортировка, раскрытие и выбор строк не изменяют состав общих итогов.
+
+`formula` задаёт `formulaId` и упорядоченные `dependencies` для существующего
+реестра `/formulas`; им владеет composition root приложения. `calculate` задаёт
+зависимости и чистый `compute(values)`. Одновременно задать оба способа нельзя.
+Компиляция проверяет уникальность полей, неизвестные зависимости и циклы.
+
+Исходные формулы вычисляются один раз при создании runtime. При изменении фильтров
+или группировок зависимые итоговые формулы выполняются над новыми итогами. Явный
+агрегат поля, результат `aggregate(context)` и значения пути имеют приоритет над
+построчной формулой этого поля: сумма произведений сохраняется, а отношение сумм
+вычисляется заново. Формулы должны учитывать отсутствующие поля итоговой строки;
+ошибки конфигурации и исполнения не скрываются успешным нулём.
+
+Низкоуровневые `createAnalyticalCalculationPlan(fields, requiredColumnIds?)` и
+`calculateAnalyticalValues(values, plan)` остаются доступны для самостоятельных
+вычислений; обычному потребителю достаточно скомпилированного описания.
+
+## Календарные столбцы
+
+`createAnalyticalDateColumnsPlan` строит `day/week/month/quarter/year` интервалы с
+включительными `from`/`to`; неделя начинается в понедельник. ID содержит
+гранулярность и начало периода; крайние интервалы обрезаются диапазоном. По
+умолчанию разрешено до 366 столбцов; превышение лимита — ошибка.
+
+Границы и даты фактов имеют контракт **YYYY-MM-DD**. `Date`, число и ISO timestamp
+с временем не принимаются как календарные факты: их приводит адаптер с явной
+политикой времени. Используются существующий календарный parser и форматтеры:
+`formatDateAsODataDate` для машинных дат, `formatDateAsDate` для подписи дня.
+Потребитель согласует настройки форматирования и календарную/timezone-политику
+SSR и браузера. Неверный диапазон отклоняется; неверные факты и даты вне диапазона
+пропускаются.
 
 `projectAnalyticalDateFacts({ rows, facts, plan })` сопоставляет факты по составному
-`identityColumnIds`, добавляя ячейки к копиям значений. Не меняются количество,
-порядок и идентичность исходных строк. Факты с отсутствующей частью ключа
-пропускаются. Без фактов ячейка равна null; существующее одноимённое поле не
-перезаписывается молча. Это отдельная проекция уже загруженных данных, не схема
-дополнительной загрузки.
-
-`aggregateAnalyticalDateFacts` считает общие значения по исходным фактам. Особенно
-важно использовать его для avg: среднее от средних разных строк обычно неверно.
-Групповые итоги для таких данных следует считать тем же способом по соответствующему
-набору исходных фактов через aggregate callback. Факты с неполным ключом исключаются
-и из строк, и из итогов. Область переданного набора фактов определяет потребитель.
-
-## Экспорт и производительность
-
-`projectAnalyticalTableExport` принимает модель, упорядоченные столбцы с необязательным
-`format(value, row)`, область all/visible/selected, `includeGroups` и
-`includeGrandTotals`. Результат содержит заголовки и массивы значений; дальнейшее
-создание XLSX или документа принадлежит `/excel` или `/table-document`. По умолчанию
-экспортируются все строки отфильтрованной модели, включая свёрнутые ветви.
-Предметные строки-родители не считаются синтетическими группами. Общие итоги
-форматируются отдельным `formatTotal(value)`: у них нет исходной строки `original`.
-Без него итоги сохраняют исходные значения, даже если форматтер строк задан отдельно.
-
-Для React следует мемоизировать базовую модель по `snapshot.rows`, колонкам,
-группировкам, сортировке, фильтрам и правилам итогов. Время последнего запроса не
-является зависимостью, когда данные структурно не изменились. Затем отдельно
-вызывается `projectAnalyticalTableExpansion(model, expandedRowIds)`; раскрытие не
-повторяет формулы, группировки и агрегации. Selection и layout остаются в UI.
-
-Полный снимок не требует LRU страниц, sparse placeholders, remote paging или
-второго кэша персональных данных. Если отдельный источник позднее потребует
-постраничную серверную агрегацию, она оформляется отдельной транспортной
-возможностью без изменения предметных правил существующего снимка.
+`identityColumnIds`, добавляя ячейки к копиям значений. Порядок, количество и ID
+строк сохраняются. Факты с неполным ключом пропускаются, отсутствие фактов даёт
+`null`; конфликт с существующим одноимённым полем вызывает ошибку.
+
+`aggregateAnalyticalDateFacts` считает итоги по исходным фактам — это существенно
+для `avg`, где среднее от средних неверно. Групповые итоги получают тем же способом
+через aggregate callback. Факты с неполным ключом исключаются и из проекции, и из
+итогов; допустимую область остальных фактов задаёт потребитель. Дополнительных
+запросов эти функции не выполняют.
+
+## Раскрытие и экспорт
+
+`projectAnalyticalTableExpansion(model, expandedRowIds)` доступен отдельно; runtime
+уже вызывает его на последнем этапе. Он сохраняет ссылки неизменённых ветвей,
+игнорирует неизвестные ID и листья и возвращает переданную модель при неизменном
+эффективном раскрытии. При изменении дерева все индексы указывают на актуальные
+узлы, а рассчитанные итоги сохраняются.
+
+`projectAnalyticalTableExport` принимает модель, упорядоченные столбцы с
+`format(value, row)`, область `all/visible/selected`, `includeGroups` и
+`includeGrandTotals`. По умолчанию экспортируются все строки отфильтрованной модели,
+включая свёрнутые ветви. `includeGroups: false` убирает только синтетические группы,
+сохраняя предметных родителей. Результат содержит заголовки и массивы значений;
+создание файла относится к `/excel` или `/table-document`.
+
+Итоги форматируются отдельным `formatTotal(value)`, поскольку у них нет исходной
+строки `original`. Без него сохраняются raw значения независимо от форматтера
+обычных строк. ID итога — `analytical-grand-total`; при конфликте со строкой модели
+подбирается свободный детерминированный суффикс. Выбор области экспорта его не меняет.
+
+Runtime полного снимка не содержит remote paging, sparse placeholders, LRU страниц
+или второй кэш загруженных данных. Возможный серверный источник с постраничной
+агрегацией должен иметь отдельный транспортный контракт.

package/src/formatters/README.mdx

@@ -68,6 +68,24 @@ import { formatDate, formatNumber } from "@ryuzaki13/react-foundation-lib/format
 
 ## Общие правила
 
+### Длительность в минутах
+
+`formatDurationMinutes(minutes)` показывает целые неотрицательные минуты с
+переходом к часам и суткам. Это продолжительность, а не дата: сутки равны
+24 часам независимо от часового пояса. Остатки сохраняются, включая нулевые.
+
+```ts
+import { formatDurationMinutes } from "@ryuzaki13/react-foundation-lib/formatters";
+
+formatDurationMinutes(59); // "59 мин"
+formatDurationMinutes(60); // "1 ч 0 мин"
+formatDurationMinutes(1565); // "1 дн 2 ч 5 мин"
+```
+
+Отрицательные, дробные, бесконечные и небезопасные значения вызывают
+`RangeError`. Неизвестное начало периода и SSR fallback принадлежат
+потребителю; formatter не читает часы и не создаёт таймеров.
+
 ### Formatter обычно не является validator-ом
 
 Функция может иметь fallback для невалидного значения, но это не делает данные валидными:

package/dist/analytical-table/aggregation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aggregation.d.ts","sourceRoot":"","sources":["../../src/analytical-table/aggregation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,WAAW,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAyBvH"}

package/dist/analytical-table/calculationTypes.d.ts

@@ -1,11 +0,0 @@
-import { type AnalyticalValues } from "./dataTypes";
-export type AnalyticalCalculationStep = Readonly<{
-    columnId: string;
-    dependencies: readonly string[];
-    compute: (values: AnalyticalValues) => unknown;
-}>;
-export type AnalyticalCalculationPlan = Readonly<{
-    steps: readonly AnalyticalCalculationStep[];
-    requiredColumnIds: readonly string[];
-}>;
-//# sourceMappingURL=calculationTypes.d.ts.map

package/dist/analytical-table/calculationTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"calculationTypes.d.ts","sourceRoot":"","sources":["../../src/analytical-table/calculationTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAChD,KAAK,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5C,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC,CAAC"}

package/dist/analytical-table/calculations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"calculations.d.ts","sourceRoot":"","sources":["../../src/analytical-table/calculations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,yBAAyB,EAAkC,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvI,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAAC,CAAC,EAChD,OAAO,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,EACvC,iBAAiB,GAAE,SAAS,MAAM,EAAuC,GACvE,yBAAyB,CAsC3B;AAED,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,yBAAyB,GAAG,gBAAgB,CAIrH"}

package/dist/analytical-table/columnTypes.d.ts

@@ -1,30 +0,0 @@
-import { type AnalyticalDataRow, type AnalyticalValues } from "./dataTypes";
-import { type AnalyticalFilter } from "./viewTypes";
-export type AnalyticalAggregation = "sum" | "min" | "max" | "avg" | "count";
-export type AnalyticalAggregateContext<TOriginal = unknown> = Readonly<{
-    scope: "group" | "grand";
-    /** Только исходные строки выбранной зернистости, без синтетических групп. */
-    rows: readonly AnalyticalDataRow<TOriginal>[];
-    groupingPath: AnalyticalValues;
-}>;
-export type AnalyticalFormula = Readonly<{
-    formulaId: string;
-    dependencies: readonly string[];
-}>;
-export type AnalyticalCalculation = Readonly<{
-    dependencies: readonly string[];
-    compute: (values: AnalyticalValues) => unknown;
-}>;
-export type AnalyticalColumn<TOriginal = unknown> = Readonly<{
-    id: string;
-    label?: string;
-    kind?: "dimension" | "measure";
-    valueType?: "string" | "number" | "boolean" | "date";
-    compare?: (left: unknown, right: unknown) => number;
-    filter?: (value: unknown, filter: AnalyticalFilter, row: AnalyticalDataRow<TOriginal>) => boolean;
-    aggregate?: AnalyticalAggregation | ((context: AnalyticalAggregateContext<TOriginal>) => unknown);
-    /** Исполнение использует реестр /formulas; зависимости определяют порядок расчёта. */
-    formula?: AnalyticalFormula;
-    calculate?: AnalyticalCalculation;
-}>;
-//# sourceMappingURL=columnTypes.d.ts.map

package/dist/analytical-table/columnTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"columnTypes.d.ts","sourceRoot":"","sources":["../../src/analytical-table/columnTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAE5E,MAAM,MAAM,0BAA0B,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IACtE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,6EAA6E;IAC7E,IAAI,EAAE,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9C,YAAY,EAAE,gBAAgB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC;AAEjG,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAA;CAAE,CAAC,CAAC;AAElI,MAAM,MAAM,gBAAgB,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;IAClG,SAAS,CAAC,EAAE,qBAAqB,GAAG,CAAC,CAAC,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC;IAClG,sFAAsF;IACtF,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAClC,CAAC,CAAC"}

package/dist/analytical-table/dataTypes.d.ts

@@ -1,14 +0,0 @@
-/** Значения таблицы отделены от исходного DTO: runtime не изменяет снимок Query. */
-export type AnalyticalValues = Readonly<Record<string, unknown>>;
-export type AnalyticalDataRow<TOriginal = unknown> = Readonly<{
-    id: string;
-    parentId?: string | null;
-    kind?: string;
-    original?: TOriginal;
-    values: AnalyticalValues;
-}>;
-/** Готовый полный снимок. Его загрузкой и отменой владеет транспорт потребителя. */
-export type AnalyticalSnapshot<TOriginal = unknown> = Readonly<{
-    rows: readonly AnalyticalDataRow<TOriginal>[];
-}>;
-//# sourceMappingURL=dataTypes.d.ts.map

package/dist/analytical-table/dataTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dataTypes.d.ts","sourceRoot":"","sources":["../../src/analytical-table/dataTypes.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,iBAAiB,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CACzB,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,MAAM,kBAAkB,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAC9D,IAAI,EAAE,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;CAC9C,CAAC,CAAC"}

package/dist/analytical-table/dateColumnTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dateColumnTypes.d.ts","sourceRoot":"","sources":["../../src/analytical-table/dateColumnTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE5E,+EAA+E;AAC/E,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3D,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iFAAiF;IACjF,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,qBAAqB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACX,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAChD,OAAO,EAAE,4BAA4B,CAAC;IACtC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,MAAM,iCAAiC,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAC7E,IAAI,EAAE,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9C,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,IAAI,EAAE,yBAAyB,CAAC;CAChC,CAAC,CAAC"}

package/dist/analytical-table/dateColumns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dateColumns.d.ts","sourceRoot":"","sources":["../../src/analytical-table/dateColumns.ts"],"names":[],"mappings":"AAeA,OAAO,EACN,KAAK,iBAAiB,EAEtB,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,iCAAiC,EACtC,MAAM,SAAS,CAAC;AA+CjB,oFAAoF;AACpF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,4BAA4B,GAAG,yBAAyB,CAuBhH;AAYD,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,IAAI,EAAE,iCAAiC,CAAC,CAAC,CAAC,GAAG,SAAS,iBAAiB,CAAC,CAAC,CAAC,EAAE,CA0BzH;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,yBAAyB,GAAG,gBAAgB,CAelI"}

package/dist/analytical-table/expansion.d.ts

@@ -1,4 +0,0 @@
-import { type AnalyticalTableModel } from "./types";
-/** Раскрытие не меняет группировки, формулы и итоги; UI мемоизирует базовую модель отдельно. */
-export declare function projectAnalyticalTableExpansion<T>(model: AnalyticalTableModel<T>, expandedRowIds: readonly string[] | "all"): AnalyticalTableModel<T>;
-//# sourceMappingURL=expansion.d.ts.map

package/dist/analytical-table/expansion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"expansion.d.ts","sourceRoot":"","sources":["../../src/analytical-table/expansion.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7E,gGAAgG;AAChG,wBAAgB,+BAA+B,CAAC,CAAC,EAChD,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,KAAK,GACvC,oBAAoB,CAAC,CAAC,CAAC,CAUzB"}

package/dist/analytical-table/exportProjection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exportProjection.d.ts","sourceRoot":"","sources":["../../src/analytical-table/exportProjection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,0BAA0B,EAAE,KAAK,mCAAmC,EAAE,MAAM,SAAS,CAAC;AAEjI,+FAA+F;AAC/F,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,IAAI,EAAE,mCAAmC,CAAC,CAAC,CAAC,GAAG,0BAA0B,CAwBxH"}

package/dist/analytical-table/exportTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exportTypes.d.ts","sourceRoot":"","sources":["../../src/analytical-table/exportTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAElF,MAAM,MAAM,sBAAsB,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;IACzE,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE7E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC,CAAC;AAExI,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,IAAI,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,MAAM,mCAAmC,CAAC,SAAS,GAAG,OAAO,IAAI,QAAQ,CAAC;IAC/E,KAAK,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,SAAS,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;IACvD,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,CAAC;IACvC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC,CAAC"}

package/dist/analytical-table/filtering.d.ts

@@ -1,4 +0,0 @@
-import { type AnalyticalColumn, type AnalyticalDataRow, type AnalyticalFilter } from "./types";
-/** Операции фильтра относятся к данным, поэтому одинаково работают при SSR и в браузере. */
-export declare function matchesAnalyticalFilter<T>(row: AnalyticalDataRow<T>, filter: AnalyticalFilter, column?: AnalyticalColumn<T>): boolean;
-//# sourceMappingURL=filtering.d.ts.map

package/dist/analytical-table/filtering.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../src/analytical-table/filtering.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG/F,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAgCrI"}

package/dist/analytical-table/indexAnalyticalRows.d.ts

@@ -1,4 +0,0 @@
-import { type AnalyticalModelRow, type AnalyticalTableModel } from "./types";
-/** Единственный обход индексов полной и видимой проекций дерева. */
-export declare function indexAnalyticalRows<T>(rows: readonly AnalyticalModelRow<T>[]): Pick<AnalyticalTableModel<T>, "flatRows" | "visibleRows" | "rowById">;
-//# sourceMappingURL=indexAnalyticalRows.d.ts.map

package/dist/analytical-table/indexAnalyticalRows.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"indexAnalyticalRows.d.ts","sourceRoot":"","sources":["../../src/analytical-table/indexAnalyticalRows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7E,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,CAAC,EACpC,IAAI,EAAE,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,GACpC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,CAcvE"}