@ryuzaki13/react-foundation-lib 2.20.0 → 2.21.0

package/README.md

@@ -86,6 +86,7 @@ npm run pack:dry-run
 | Группировка, дедупликация, порядок и нормализация массивов                  | [`array`](./src/array/index.ts), подробный README: [`array/README.mdx`](./src/array/README.mdx)                                                                                                                                     |
 | OData metadata, values, path, filters, sorts, code/text collections и store | [`odata-service`](./src/odata-service/index.ts), подробный README: [`odata-service/README.mdx`](./src/odata-service/README.mdx), тесты в [`odata-service`](./src/odata-service)                                                     |
 | TanStack Table helpers                                                      | [`table`](./src/table/index.ts), единый подробный справочник: [`table/README.mdx`](./src/table/README.mdx), тесты в [`table`](./src/table)                                                                                          |
+| Аналитическая таблица полного снимка                                        | [`analytical-table`](./src/analytical-table/index.ts), [руководство](./src/analytical-table/README.mdx)                                                                                                                             |
 | Tree table преобразования                                                   | [`tree-table`](./src/tree-table/index.ts), документация в общем справочнике [`table/README.mdx`](./src/table/README.mdx), тесты в [`tree-table`](./src/tree-table)                                                                  |
 | Excel export                                                                | [`excel`](./src/excel/index.ts), подробный README: [`excel/README.mdx`](./src/excel/README.mdx), тесты: [`excel.test.ts`](./src/excel/excel.test.ts), [`tableExport.test.ts`](./src/excel/tableExport.test.ts)                      |
 | FileReader, изображения, base64 Blob                                        | [`file`](./src/file/index.ts), [`binary`](./src/binary/index.ts)                                                                                                                                                                    |
@@ -140,6 +141,7 @@ npm run pack:dry-run
 | `/string-comparison`   | [`string-comparison/README.mdx`](./src/string-comparison/README.mdx)           |
 | `/table`               | [`table/README.mdx`](./src/table/README.mdx)                                   |
 | `/three-scene`         | [`three-scene/README.mdx`](./src/three-scene/README.mdx)                       |
+| `/analytical-table`    | [`analytical-table/README.mdx`](./src/analytical-table/README.mdx)             |
 | `/tree-table`          | Раздел tree-table в [`table/README.mdx`](./src/table/README.mdx)               |
 | `/types`               | [`types/README.mdx`](./src/types/README.mdx)                                   |
 | `/utils`               | [`utils/README.mdx`](./src/utils/README.mdx)                                   |

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

@@ -0,0 +1,4 @@
+import { type AnalyticalAggregation } from "./types";
+/** null/пустые/нечисловые значения не превращаются в ноль; count считает непустые факты. */
+export declare function aggregateAnalyticalValues(values: readonly unknown[], aggregation: AnalyticalAggregation): number | null;
+//# sourceMappingURL=aggregation.d.ts.map

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

@@ -0,0 +1 @@
+{"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/buildAnalyticalTableModel.d.ts

@@ -0,0 +1,4 @@
+import { type AnalyticalTableModel, type BuildAnalyticalTableModelOptions } from "./types";
+/** Чистая модель полного снимка: не владеет транспортом, кэшем, DOM и жизненным циклом Query. */
+export declare function buildAnalyticalTableModel<T>(options: BuildAnalyticalTableModelOptions<T>): AnalyticalTableModel<T>;
+//# sourceMappingURL=buildAnalyticalTableModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnalyticalTableModel.d.ts","sourceRoot":"","sources":["../../src/analytical-table/buildAnalyticalTableModel.ts"],"names":[],"mappings":"AASA,OAAO,EAGN,KAAK,oBAAoB,EAEzB,KAAK,gCAAgC,EACrC,MAAM,SAAS,CAAC;AAYjB,iGAAiG;AACjG,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,EAAE,gCAAgC,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAmIlH"}

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,6 @@
+import { type AnalyticalCalculationPlan, type AnalyticalColumn, type AnalyticalValues } from "./types";
+/** Проверяет граф зависимостей до расчёта строк и компилирует каждую формулу один раз. */
+export declare function createAnalyticalCalculationPlan<T>(columns: readonly AnalyticalColumn<T>[], requiredColumnIds?: readonly string[]): AnalyticalCalculationPlan;
+/** Возвращает отдельный набор значений; исходный DTO и значения Query не мутируются. */
+export declare function calculateAnalyticalValues(values: AnalyticalValues, plan: AnalyticalCalculationPlan): AnalyticalValues;
+//# sourceMappingURL=calculations.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,30 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,14 @@
+/** Значения таблицы отделены от исходного 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,31 @@
+import { type AnalyticalAggregation } from "./columnTypes";
+import { type AnalyticalDataRow, type AnalyticalValues } from "./dataTypes";
+/** Dynamic facts уже входят в снимок: проектирование не выполняет запросов. */
+export type AnalyticalDateColumnsOptions = Readonly<{
+    id: string;
+    from: string;
+    to: string;
+    granularity: "day" | "week" | "month" | "quarter" | "year";
+    identityColumnIds: readonly string[];
+    /** Поле факта должно содержать только YYYY-MM-DD; Date/timestamp отклоняются. */
+    dateColumnId: string;
+    measureColumnId: string;
+    aggregation: AnalyticalAggregation;
+    maxColumns?: number;
+}>;
+export type AnalyticalDateColumn = Readonly<{
+    id: string;
+    label: string;
+    from: string;
+    to: string;
+}>;
+export type AnalyticalDateColumnsPlan = Readonly<{
+    options: AnalyticalDateColumnsOptions;
+    columns: readonly AnalyticalDateColumn[];
+}>;
+export type ProjectAnalyticalDateFactsOptions<TOriginal = unknown> = Readonly<{
+    rows: readonly AnalyticalDataRow<TOriginal>[];
+    facts: readonly AnalyticalValues[];
+    plan: AnalyticalDateColumnsPlan;
+}>;
+//# sourceMappingURL=dateColumnTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import { type AnalyticalDataRow, type AnalyticalDateColumnsOptions, type AnalyticalDateColumnsPlan, type AnalyticalValues, type ProjectAnalyticalDateFactsOptions } from "./types";
+/** Строит ограниченный календарный план; ISO-моменты времени сюда не передаются. */
+export declare function createAnalyticalDateColumnsPlan(options: AnalyticalDateColumnsOptions): AnalyticalDateColumnsPlan;
+/** Сопоставляет отдельные facts составному ключу строки; порядок и количество base rows неизменны. */
+export declare function projectAnalyticalDateFacts<T>(args: ProjectAnalyticalDateFactsOptions<T>): readonly AnalyticalDataRow<T>[];
+/**
+ * Общие итоги считаются по исходным facts с полным ключом: среднее от средних не подменяет взвешенный результат.
+ * Отбор допустимых непустых identities по области доступа и фильтрам выполняет вызывающий адаптер.
+ */
+export declare function aggregateAnalyticalDateFacts(facts: readonly AnalyticalValues[], plan: AnalyticalDateColumnsPlan): AnalyticalValues;
+//# sourceMappingURL=dateColumns.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+import { type AnalyticalExportProjection, type ProjectAnalyticalTableExportOptions } from "./types";
+/** Проекция для /excel или /table-document; сам runtime не скачивает файлы и не читает DOM. */
+export declare function projectAnalyticalTableExport<T>(args: ProjectAnalyticalTableExportOptions<T>): AnalyticalExportProjection;
+//# sourceMappingURL=exportProjection.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,31 @@
+import { type AnalyticalModelRow, type AnalyticalTableModel } from "./modelTypes";
+export type AnalyticalExportColumn<TOriginal = unknown> = Readonly<{
+    id: string;
+    label?: string;
+    format?: (value: unknown, row: AnalyticalModelRow<TOriginal>) => unknown;
+    /** Общий итог не является строкой исходного дерева и не имеет original/children. */
+    formatTotal?: (value: unknown) => unknown;
+}>;
+export type AnalyticalExportHeader = Readonly<{
+    id: string;
+    label: string;
+}>;
+export type AnalyticalExportRow = Readonly<{
+    id: string;
+    level: number;
+    kind: "data" | "group" | "grand";
+    values: readonly unknown[];
+}>;
+export type AnalyticalExportProjection = Readonly<{
+    columns: readonly AnalyticalExportHeader[];
+    rows: readonly AnalyticalExportRow[];
+}>;
+export type ProjectAnalyticalTableExportOptions<TOriginal = unknown> = Readonly<{
+    model: AnalyticalTableModel<TOriginal>;
+    columns?: readonly AnalyticalExportColumn<TOriginal>[];
+    scope?: "all" | "visible" | "selected";
+    selectedRowIds?: readonly string[];
+    includeGroups?: boolean;
+    includeGrandTotals?: boolean;
+}>;
+//# sourceMappingURL=exportTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,4 @@
+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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -0,0 +1,8 @@
+export { aggregateAnalyticalValues } from "./aggregation";
+export { buildAnalyticalTableModel } from "./buildAnalyticalTableModel";
+export { calculateAnalyticalValues, createAnalyticalCalculationPlan } from "./calculations";
+export { aggregateAnalyticalDateFacts, createAnalyticalDateColumnsPlan, projectAnalyticalDateFacts } from "./dateColumns";
+export { projectAnalyticalTableExpansion } from "./expansion";
+export { projectAnalyticalTableExport } from "./exportProjection";
+export type * from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytical-table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAClE,mBAAmB,SAAS,CAAC"}

package/dist/analytical-table/index.js

@@ -0,0 +1,364 @@
+import { Dt as e, Et as t, Mt as n, Nt as r, Ot as i, Pt as a, jt as o, kt as s } from "../chunks/formatters-CEltML3y.js";
+import { a as c, y as l } from "../chunks/array-D-_yMMUK.js";
+import { buildTreeTableRows as u } from "../tree-table/index.js";
+import { stableStringify as d } from "../utils/index.js";
+import { compileTableFormula as f } from "../formulas/index.js";
+import { Bt as p, hn as m, kn as h, pn as g } from "../chunks/odata-service-CWkHASdw.js";
+import { t as _ } from "../chunks/string-comparison-BKT7PXmq.js";
+//#region src/analytical-table/aggregation.ts
+function v(e, t) {
+	let n = e.filter((e) => e != null && e !== "");
+	if (t === "count") return n.length;
+	let r = 0, i = 0, a = Infinity, o = -Infinity;
+	for (let e of n) typeof e != "number" || !Number.isFinite(e) || (r += 1, i += e, a = Math.min(a, e), o = Math.max(o, e));
+	if (r === 0) return null;
+	switch (t) {
+		case "sum": return i;
+		case "min": return a;
+		case "max": return o;
+		case "avg": return i / r;
+	}
+}
+//#endregion
+//#region src/analytical-table/calculations.ts
+function y(e, t = e.map((e) => e.id)) {
+	let n = new Map(e.map((e) => [e.id, e]));
+	if (n.size !== e.length) throw Error("Идентификаторы аналитических столбцов должны быть уникальны.");
+	let r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Set(), a = [], o = [], s = (e) => {
+		if (r.has(e)) return;
+		if (i.has(e)) throw Error(`Циклическая зависимость аналитического столбца: ${e}`);
+		let t = n.get(e);
+		if (!t) throw Error(`Неизвестная зависимость аналитического столбца: ${e}`);
+		if (t.formula && t.calculate) throw Error(`Столбец ${e} содержит два способа вычисления.`);
+		i.add(e);
+		let l = c(t.formula?.dependencies ?? t.calculate?.dependencies ?? []);
+		for (let e of l) s(e);
+		if (t.formula) {
+			let n = f({
+				formulaId: t.formula.formulaId,
+				keys: t.formula.dependencies
+			});
+			if (!n.ok) throw Error(`Формула столбца ${e} не зарегистрирована: ${t.formula.formulaId}`);
+			o.push({
+				columnId: e,
+				dependencies: l,
+				compute: (t) => {
+					let r = n.execute({ ...t });
+					if (!r.ok) throw Error(`Ошибка формулы столбца ${e}: ${r.reason}`);
+					return r.value;
+				}
+			});
+		} else t.calculate && o.push({
+			columnId: e,
+			dependencies: l,
+			compute: t.calculate.compute
+		});
+		i.delete(e), r.add(e), a.push(e);
+	};
+	for (let e of t) s(e);
+	return {
+		steps: o,
+		requiredColumnIds: a
+	};
+}
+function b(e, t) {
+	let n = { ...e };
+	for (let e of t.steps) n[e.columnId] = e.compute(n);
+	return n;
+}
+//#endregion
+//#region src/analytical-table/valueComparison.ts
+function x(e, t) {
+	return d(t.map((t) => {
+		let n = e[t];
+		return [
+			t,
+			n === null ? "null" : typeof n,
+			n
+		];
+	}));
+}
+function S(e, t, n) {
+	if (Object.is(e, t)) return 0;
+	if (e == null) return 1;
+	if (t == null) return -1;
+	if (n?.compare) return n.compare(e, t);
+	if (n?.valueType === "date") {
+		let n = g(e), r = g(t);
+		if (n && r) return n.getTime() - r.getTime();
+	}
+	return typeof e == "number" && typeof t == "number" ? e - t : typeof e == "boolean" && typeof t == "boolean" ? Number(e) - Number(t) : _(String(e), String(t));
+}
+//#endregion
+//#region src/analytical-table/filtering.ts
+function C(e, t, n) {
+	let r = e.values[t.id];
+	if (n?.filter) return n.filter(r, t, e);
+	let i = t.value, a = (e) => S(r, e, n), o = r == null || r === "";
+	switch (t.operator ?? "equals") {
+		case "equals": return a(i) === 0;
+		case "notEquals": return a(i) !== 0;
+		case "contains": return l(String(r ?? "")).includes(l(String(i ?? "")));
+		case "startsWith": return l(String(r ?? "")).startsWith(l(String(i ?? "")));
+		case "in": return Array.isArray(i) && i.some((e) => a(e) === 0);
+		case "between": return Array.isArray(i) && i.length === 2 && !o && a(i[0]) >= 0 && a(i[1]) <= 0;
+		case "gt": return !o && a(i) > 0;
+		case "gte": return !o && a(i) >= 0;
+		case "lt": return !o && a(i) < 0;
+		case "lte": return !o && a(i) <= 0;
+		case "empty": return o;
+		case "notEmpty": return !o;
+	}
+}
+//#endregion
+//#region src/analytical-table/indexAnalyticalRows.ts
+function w(e) {
+	let t = [], n = [], r = /* @__PURE__ */ new Map(), i = (e, a) => {
+		for (let o of e) t.push(o), r.set(o.id, o), a && n.push(o), i(o.children, a && o.isExpanded);
+	};
+	return i(e, !0), {
+		flatRows: t,
+		visibleRows: n,
+		rowById: r
+	};
+}
+//#endregion
+//#region src/analytical-table/buildAnalyticalTableModel.ts
+function T(e) {
+	let { snapshot: t, columns: n, state: r = {} } = e, i = y(n), a = new Map(n.map((e) => [e.id, e])), o = r.grouping ?? [], s = r.sorting ?? [], l = r.filters ?? [];
+	for (let e of [...s.map((e) => e.id), ...l.map((e) => e.id)]) if (!a.has(e)) throw Error(`Неизвестный аналитический столбец: ${e}`);
+	if (c(o.map((e) => e.id)).length !== o.length) throw Error("Идентификаторы уровней группировки должны быть уникальны.");
+	for (let e of o) if (e.keyColumnIds.length === 0) throw Error(`Уровень ${e.id} не содержит ключей группировки.`);
+	let f = t.rows.map((e) => ({
+		...e,
+		values: b(e.values, i)
+	}));
+	if (f.some((e) => e.id.length === 0)) throw Error("Идентификатор аналитической строки не может быть пустым.");
+	let p = u(f, {
+		getRowId: (e) => e.id,
+		getParentRowId: (e) => e.parentId
+	}), m = new Set(p.rootRowIds), h = e.isAggregateRow ?? ((e) => m.has(e.id)), g = (e) => ({
+		id: e.id,
+		kind: "data",
+		sourceRow: p.rowById.get(e.id),
+		values: e.values,
+		children: (e.children ?? []).map(g)
+	}), _ = p.rows.map(g), T = (e) => {
+		let t = [], n = (e) => {
+			e.sourceRow && h(e.sourceRow) && t.push(e.sourceRow);
+			for (let t of e.children) n(t);
+		};
+		for (let t of e) n(t);
+		return t;
+	}, E = (t, r, a) => {
+		let o = {
+			scope: r,
+			rows: T(t),
+			groupingPath: a
+		}, s = { ...a };
+		for (let e of n) e.aggregate && (s[e.id] = typeof e.aggregate == "function" ? e.aggregate(o) : v(o.rows.map((t) => t.values[e.id]), e.aggregate));
+		return Object.assign(s, e.aggregate?.(o)), b(s, {
+			...i,
+			steps: i.steps.filter((e) => !Object.hasOwn(s, e.columnId))
+		});
+	}, D = (e) => e.flatMap((e) => {
+		let t = e.sourceRow;
+		if (t && l.every((e) => C(t, e, a.get(e.id)))) return [e];
+		let n = D(e.children);
+		return n.length > 0 ? [{
+			...e,
+			children: n
+		}] : [];
+	}), O = l.length > 0 ? D(_) : _, k = (e, t, n, r) => {
+		let i = o[t];
+		if (!i) return e;
+		let a = /* @__PURE__ */ new Map();
+		for (let t of e) {
+			let e = x(t.values, i.keyColumnIds), n = a.get(e);
+			n ? n.push(t) : a.set(e, [t]);
+		}
+		return Array.from(a, ([e, a]) => {
+			let o = [
+				...r,
+				i.id,
+				e
+			], s = `analytical-group:${d(o)}`;
+			if (p.rowById.has(s)) throw Error(`Идентификатор исходной строки совпал с группой: ${s}`);
+			let c = { ...n };
+			for (let e of [...i.keyColumnIds, ...i.displayColumnIds ?? []]) c[e] = a[0].values[e];
+			return {
+				id: s,
+				kind: "group",
+				groupingLevelId: i.id,
+				values: E(a, "group", c),
+				children: k(a, t + 1, c, o)
+			};
+		});
+	}, A = k(O, 0, {}, []), j = new Set(r.expandedRowIds === "all" ? [] : r.expandedRowIds ?? []), M = (e) => [...e].sort((e, t) => {
+		for (let n of s) {
+			let r = S(e.values[n.id], t.values[n.id], a.get(n.id));
+			if (r !== 0) return n.desc ? -r : r;
+		}
+		return 0;
+	}), N = (e, t, n) => M(e).map((e) => ({
+		id: e.id,
+		parentId: t,
+		kind: e.kind,
+		sourceRow: e.sourceRow,
+		original: e.sourceRow?.original,
+		values: e.values,
+		level: n,
+		children: N(e.children, e.id, n + 1),
+		isExpandable: e.children.length > 0,
+		isExpanded: e.children.length > 0 && (r.expandedRowIds === "all" || j.has(e.id)),
+		groupingLevelId: e.groupingLevelId
+	})), P = N(A, null, 0);
+	return {
+		columns: n,
+		rows: P,
+		...w(P),
+		grandTotals: e.grandTotals === !1 ? null : E(e.grandTotalsScope === "all" ? _ : O, "grand", {}),
+		diagnostics: {
+			orphanRowIds: p.orphanRowIds,
+			duplicateRowIds: p.duplicateRowIds,
+			cyclicRowIds: p.cyclicRowIds
+		}
+	};
+}
+//#endregion
+//#region src/analytical-table/dateColumns.ts
+var E = h("yyyy-MM-dd"), D = h("dd.MM.yyyy");
+function O(e) {
+	if (typeof e != "string" || e.length !== 10) return null;
+	let t = m(e, "yyyy-MM-dd");
+	return t?.kind === "date-time" ? t.date : null;
+}
+function k(e) {
+	return p(e, E);
+}
+function A(e, t) {
+	switch (t) {
+		case "day": return o(e);
+		case "week": return r(e, 1);
+		case "month": return n(e);
+		case "quarter": return s(e.getFullYear(), Math.floor(e.getMonth() / 3) * 3, 1);
+		case "year": return a(e);
+	}
+}
+function j(n, r) {
+	switch (r) {
+		case "day": return t(n, 1);
+		case "week": return t(n, 7);
+		case "month": return e(n, 1);
+		case "quarter": return e(n, 3);
+		case "year": return i(n, 1);
+	}
+}
+function M(e) {
+	let n = O(e.from), r = O(e.to);
+	if (!n || !r || k(n) !== e.from || k(r) !== e.to || e.from > e.to) throw Error("Некорректный календарный диапазон аналитических столбцов.");
+	let i = e.maxColumns ?? 366;
+	if (!Number.isSafeInteger(i) || i < 1) throw Error("Лимит динамических столбцов должен быть положительным целым числом.");
+	if (!e.id || e.identityColumnIds.length === 0) throw Error("Динамическим столбцам нужны идентификатор и ключи сопоставления фактов.");
+	let a = [];
+	for (let o = A(n, e.granularity); o <= r; o = j(o, e.granularity)) {
+		if (a.length >= i) throw Error(`Превышен лимит динамических столбцов: ${i}`);
+		let n = k(o), r = k(t(j(o, e.granularity), -1));
+		a.push({
+			id: `${e.id}:${e.granularity}:${n}`,
+			label: e.granularity === "day" ? p(o, D) : `${n} — ${r}`,
+			from: n < e.from ? e.from : n,
+			to: r > e.to ? e.to : r
+		});
+	}
+	return {
+		options: {
+			...e,
+			identityColumnIds: [...e.identityColumnIds]
+		},
+		columns: a
+	};
+}
+function N(e, t) {
+	if (t.options.identityColumnIds.some((t) => e[t] === void 0 || e[t] === null)) return;
+	let n = O(e[t.options.dateColumnId]);
+	if (!n) return;
+	let r = k(n);
+	if (!(r < t.options.from || r > t.options.to)) return `${t.options.id}:${t.options.granularity}:${k(A(n, t.options.granularity))}`;
+}
+function P(e) {
+	let { rows: t, facts: n, plan: r } = e, i = /* @__PURE__ */ new Map();
+	for (let e of n) {
+		let t = N(e, r);
+		if (!t) continue;
+		let n = x(e, r.options.identityColumnIds), a = i.get(n);
+		a || (a = /* @__PURE__ */ new Map(), i.set(n, a));
+		let o = a.get(t);
+		o ? o.push(e[r.options.measureColumnId]) : a.set(t, [e[r.options.measureColumnId]]);
+	}
+	return t.map((e) => {
+		let t = i.get(x(e.values, r.options.identityColumnIds)), n = { ...e.values };
+		for (let e of r.columns) {
+			if (Object.hasOwn(n, e.id)) throw Error(`Динамический столбец перезаписывает исходное поле: ${e.id}`);
+			let i = t?.get(e.id);
+			n[e.id] = i ? v(i, r.options.aggregation) : null;
+		}
+		return {
+			...e,
+			values: n
+		};
+	});
+}
+function F(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	for (let r of e) {
+		let e = N(r, t);
+		if (!e) continue;
+		let i = n.get(e);
+		i ? i.push(r[t.options.measureColumnId]) : n.set(e, [r[t.options.measureColumnId]]);
+	}
+	return Object.fromEntries(t.columns.map((e) => [e.id, n.has(e.id) ? v(n.get(e.id) ?? [], t.options.aggregation) : null]));
+}
+//#endregion
+//#region src/analytical-table/expansion.ts
+function I(e, t) {
+	let n = new Set(t === "all" ? [] : t), r = (e) => e.map((e) => ({
+		...e,
+		isExpanded: e.isExpandable && (t === "all" || n.has(e.id)),
+		children: r(e.children)
+	})), i = r(e.rows);
+	return {
+		...e,
+		rows: i,
+		...w(i)
+	};
+}
+//#endregion
+//#region src/analytical-table/exportProjection.ts
+function L(e) {
+	let { model: t } = e, n = e.columns ?? t.columns, r = new Set(e.selectedRowIds ?? []), i = (e.scope === "visible" ? t.visibleRows : t.flatRows).filter((t) => (e.includeGroups !== !1 || t.kind !== "group") && (e.scope !== "selected" || r.has(t.id))).map((e) => ({
+		id: e.id,
+		level: e.level,
+		kind: e.kind,
+		values: n.map((t) => t.format ? t.format(e.values[t.id], e) : e.values[t.id])
+	}));
+	return e.includeGrandTotals && t.grandTotals && i.push({
+		id: "analytical-grand-total",
+		level: 0,
+		kind: "grand",
+		values: n.map((e) => {
+			let n = t.grandTotals?.[e.id];
+			return e.formatTotal ? e.formatTotal(n) : n;
+		})
+	}), {
+		columns: n.map((e) => ({
+			id: e.id,
+			label: e.label ?? e.id
+		})),
+		rows: i
+	};
+}
+//#endregion
+export { F as aggregateAnalyticalDateFacts, v as aggregateAnalyticalValues, T as buildAnalyticalTableModel, b as calculateAnalyticalValues, y as createAnalyticalCalculationPlan, M as createAnalyticalDateColumnsPlan, P as projectAnalyticalDateFacts, I as projectAnalyticalTableExpansion, L as projectAnalyticalTableExport };
+
+//# sourceMappingURL=index.js.map