@affino/datagrid-pivot 0.1.1

package/dist/helpers.js

@@ -0,0 +1,161 @@
+function isPivotAggOp(value) {
+    return (value === "sum"
+        || value === "avg"
+        || value === "min"
+        || value === "max"
+        || value === "count"
+        || value === "countNonNull"
+        || value === "first"
+        || value === "last"
+        || value === "custom");
+}
+function normalizePivotFieldList(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    const unique = new Set();
+    for (const rawField of input) {
+        if (typeof rawField !== "string") {
+            continue;
+        }
+        const field = rawField.trim();
+        if (field.length === 0 || unique.has(field)) {
+            continue;
+        }
+        unique.add(field);
+    }
+    return Array.from(unique);
+}
+export function normalizePivotSpec(pivotSpec) {
+    if (!pivotSpec) {
+        return null;
+    }
+    const normalizedRows = normalizePivotFieldList(pivotSpec.rows);
+    const normalizedColumns = normalizePivotFieldList(pivotSpec.columns);
+    const normalizedValues = [];
+    const seenValues = new Set();
+    if (Array.isArray(pivotSpec.values)) {
+        for (const valueSpec of pivotSpec.values) {
+            const field = typeof (valueSpec === null || valueSpec === void 0 ? void 0 : valueSpec.field) === "string"
+                ? valueSpec.field.trim()
+                : "";
+            const agg = valueSpec === null || valueSpec === void 0 ? void 0 : valueSpec.agg;
+            if (field.length === 0 || !isPivotAggOp(agg)) {
+                continue;
+            }
+            const dedupeKey = `${field}::${agg}`;
+            if (seenValues.has(dedupeKey)) {
+                continue;
+            }
+            seenValues.add(dedupeKey);
+            normalizedValues.push({
+                field,
+                agg,
+            });
+        }
+    }
+    if (normalizedValues.length === 0) {
+        return null;
+    }
+    const rowSubtotals = pivotSpec.rowSubtotals === true;
+    const columnSubtotals = pivotSpec.columnSubtotals === true;
+    const columnGrandTotal = pivotSpec.columnGrandTotal === true;
+    const columnSubtotalPosition = pivotSpec.columnSubtotalPosition === "before"
+        ? "before"
+        : undefined;
+    const columnGrandTotalPosition = pivotSpec.columnGrandTotalPosition === "first"
+        ? "first"
+        : undefined;
+    const grandTotal = pivotSpec.grandTotal === true;
+    return {
+        rows: normalizedRows,
+        columns: normalizedColumns,
+        values: normalizedValues,
+        ...(rowSubtotals ? { rowSubtotals: true } : {}),
+        ...(columnSubtotals ? { columnSubtotals: true } : {}),
+        ...(columnGrandTotal ? { columnGrandTotal: true } : {}),
+        ...(columnSubtotalPosition ? { columnSubtotalPosition } : {}),
+        ...(columnGrandTotalPosition ? { columnGrandTotalPosition } : {}),
+        ...(grandTotal ? { grandTotal: true } : {}),
+    };
+}
+export function clonePivotSpec(pivotSpec) {
+    const normalized = normalizePivotSpec(pivotSpec);
+    if (!normalized) {
+        return null;
+    }
+    return {
+        rows: [...normalized.rows],
+        columns: [...normalized.columns],
+        values: normalized.values.map(value => ({ ...value })),
+        ...(normalized.rowSubtotals ? { rowSubtotals: true } : {}),
+        ...(normalized.columnSubtotals ? { columnSubtotals: true } : {}),
+        ...(normalized.columnGrandTotal ? { columnGrandTotal: true } : {}),
+        ...(normalized.columnSubtotalPosition
+            ? { columnSubtotalPosition: normalized.columnSubtotalPosition }
+            : {}),
+        ...(normalized.columnGrandTotalPosition
+            ? { columnGrandTotalPosition: normalized.columnGrandTotalPosition }
+            : {}),
+        ...(normalized.grandTotal ? { grandTotal: true } : {}),
+    };
+}
+export function isSamePivotSpec(left, right) {
+    var _a, _b, _c, _d;
+    const normalizedLeft = normalizePivotSpec(left);
+    const normalizedRight = normalizePivotSpec(right);
+    if (!normalizedLeft && !normalizedRight) {
+        return true;
+    }
+    if (!normalizedLeft || !normalizedRight) {
+        return false;
+    }
+    if (normalizedLeft.rows.length !== normalizedRight.rows.length) {
+        return false;
+    }
+    if (normalizedLeft.columns.length !== normalizedRight.columns.length) {
+        return false;
+    }
+    if (normalizedLeft.values.length !== normalizedRight.values.length) {
+        return false;
+    }
+    if (Boolean(normalizedLeft.rowSubtotals) !== Boolean(normalizedRight.rowSubtotals)) {
+        return false;
+    }
+    if (Boolean(normalizedLeft.columnSubtotals) !== Boolean(normalizedRight.columnSubtotals)) {
+        return false;
+    }
+    if (Boolean(normalizedLeft.columnGrandTotal) !== Boolean(normalizedRight.columnGrandTotal)) {
+        return false;
+    }
+    if (((_a = normalizedLeft.columnSubtotalPosition) !== null && _a !== void 0 ? _a : "after") !== ((_b = normalizedRight.columnSubtotalPosition) !== null && _b !== void 0 ? _b : "after")) {
+        return false;
+    }
+    if (((_c = normalizedLeft.columnGrandTotalPosition) !== null && _c !== void 0 ? _c : "last") !== ((_d = normalizedRight.columnGrandTotalPosition) !== null && _d !== void 0 ? _d : "last")) {
+        return false;
+    }
+    if (Boolean(normalizedLeft.grandTotal) !== Boolean(normalizedRight.grandTotal)) {
+        return false;
+    }
+    for (let index = 0; index < normalizedLeft.rows.length; index += 1) {
+        if (normalizedLeft.rows[index] !== normalizedRight.rows[index]) {
+            return false;
+        }
+    }
+    for (let index = 0; index < normalizedLeft.columns.length; index += 1) {
+        if (normalizedLeft.columns[index] !== normalizedRight.columns[index]) {
+            return false;
+        }
+    }
+    for (let index = 0; index < normalizedLeft.values.length; index += 1) {
+        const leftValue = normalizedLeft.values[index];
+        const rightValue = normalizedRight.values[index];
+        if (!leftValue || !rightValue) {
+            return false;
+        }
+        if (leftValue.field !== rightValue.field || leftValue.agg !== rightValue.agg) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/incrementalHelpers.d.ts

@@ -0,0 +1,23 @@
+import type { DataGridIncrementalAggregationLeafContribution } from "./coreTypes.js";
+import type { DataGridRowNode } from "./coreTypes.js";
+import type { DataGridPivotFieldResolver } from "./fieldRuntime.js";
+export interface DataGridPivotIncrementalTouchedKeys {
+    rowEntryKeys: readonly string[];
+    columnKeys: readonly string[];
+}
+export interface DataGridPivotIncrementalTouchedKeysState<T> {
+    rowEntries: ReadonlyMap<string, unknown>;
+    runtimeColumnsByColumnKey: ReadonlyMap<string, readonly unknown[]>;
+    rowFieldResolvers: readonly DataGridPivotFieldResolver<T>[];
+    columnFieldResolvers: readonly DataGridPivotFieldResolver<T>[];
+    normalizeFieldValue: (value: unknown) => string;
+    includeRowSubtotals: boolean;
+    includeColumnSubtotals: boolean;
+    includeGrandTotal: boolean;
+    includeColumnGrandTotal: boolean;
+    columnGrandTotalKey: string;
+}
+export declare function isSameLeafContribution(left: DataGridIncrementalAggregationLeafContribution, right: DataGridIncrementalAggregationLeafContribution): boolean;
+export declare function buildPivotIncrementalTouchedKeys<T>(row: DataGridRowNode<T>, state: DataGridPivotIncrementalTouchedKeysState<T>): DataGridPivotIncrementalTouchedKeys | null;
+export declare function isSamePivotTouchedKeys(left: DataGridPivotIncrementalTouchedKeys, right: DataGridPivotIncrementalTouchedKeys): boolean;
+//# sourceMappingURL=incrementalHelpers.d.ts.map

package/dist/incrementalHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incrementalHelpers.d.ts","sourceRoot":"","sources":["../src/incrementalHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8CAA8C,EAC/C,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,mBAAmB,CAAA;AAM1B,MAAM,WAAW,mCAAmC;IAClD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,wCAAwC,CAAC,CAAC;IACzD,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,yBAAyB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAA;IAClE,iBAAiB,EAAE,SAAS,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3D,oBAAoB,EAAE,SAAS,0BAA0B,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9D,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAC/C,mBAAmB,EAAE,OAAO,CAAA;IAC5B,sBAAsB,EAAE,OAAO,CAAA;IAC/B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,uBAAuB,EAAE,OAAO,CAAA;IAChC,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,8CAA8C,EACpD,KAAK,EAAE,8CAA8C,GACpD,OAAO,CAkCT;AAED,wBAAgB,gCAAgC,CAAC,CAAC,EAChD,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,wCAAwC,CAAC,CAAC,CAAC,GACjD,mCAAmC,GAAG,IAAI,CA2D5C;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,mCAAmC,EACzC,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAeT"}

package/dist/incrementalHelpers.js

@@ -0,0 +1,107 @@
+import { createPivotAxisKey, normalizePivotAxisValue, } from "./runtimeHelpers.js";
+export function isSameLeafContribution(left, right) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length) {
+        return false;
+    }
+    for (const key of leftKeys) {
+        const leftValue = left[key];
+        const rightValue = right[key];
+        if (typeof leftValue === "object" &&
+            leftValue !== null &&
+            typeof rightValue === "object" &&
+            rightValue !== null) {
+            const leftRecord = leftValue;
+            const rightRecord = rightValue;
+            const leftRecordKeys = Object.keys(leftRecord);
+            const rightRecordKeys = Object.keys(rightRecord);
+            if (leftRecordKeys.length !== rightRecordKeys.length) {
+                return false;
+            }
+            for (const nestedKey of leftRecordKeys) {
+                if (leftRecord[nestedKey] !== rightRecord[nestedKey]) {
+                    return false;
+                }
+            }
+            continue;
+        }
+        if (leftValue !== rightValue) {
+            return false;
+        }
+    }
+    return true;
+}
+export function buildPivotIncrementalTouchedKeys(row, state) {
+    if (row.kind !== "leaf") {
+        return null;
+    }
+    const rowPath = state.rowFieldResolvers.map(resolver => ({
+        field: resolver.field,
+        value: normalizePivotAxisValue(resolver.read(row), state.normalizeFieldValue),
+    }));
+    const columnPath = state.columnFieldResolvers.map(resolver => ({
+        field: resolver.field,
+        value: normalizePivotAxisValue(resolver.read(row), state.normalizeFieldValue),
+    }));
+    const rowKey = createPivotAxisKey("pivot:row:", rowPath);
+    const rowEntryKeys = [];
+    if (state.rowEntries.has(rowKey)) {
+        rowEntryKeys.push(rowKey);
+    }
+    if (rowPath.length > 1) {
+        for (let depth = 1; depth < rowPath.length; depth += 1) {
+            const groupPath = rowPath.slice(0, depth);
+            const groupKey = createPivotAxisKey("pivot:group:", groupPath);
+            if (state.rowEntries.has(groupKey)) {
+                rowEntryKeys.push(groupKey);
+            }
+            if (state.includeRowSubtotals) {
+                const subtotalKey = `${createPivotAxisKey("pivot:subtotal:", groupPath)}depth:${depth}`;
+                if (state.rowEntries.has(subtotalKey)) {
+                    rowEntryKeys.push(subtotalKey);
+                }
+            }
+        }
+    }
+    if (state.includeGrandTotal && state.rowEntries.has("pivot:grand-total")) {
+        rowEntryKeys.push("pivot:grand-total");
+    }
+    const columnKey = createPivotAxisKey("pivot:column:", columnPath);
+    const columnKeys = [];
+    if (state.runtimeColumnsByColumnKey.has(columnKey)) {
+        columnKeys.push(columnKey);
+    }
+    if (state.includeColumnGrandTotal && state.runtimeColumnsByColumnKey.has(state.columnGrandTotalKey)) {
+        columnKeys.push(state.columnGrandTotalKey);
+    }
+    if (state.includeColumnSubtotals) {
+        for (let depth = 1; depth < columnPath.length; depth += 1) {
+            const subtotalColumnPath = columnPath.slice(0, depth);
+            const subtotalColumnKey = `${createPivotAxisKey("pivot:column-subtotal:", subtotalColumnPath)}depth:${depth}`;
+            if (state.runtimeColumnsByColumnKey.has(subtotalColumnKey)) {
+                columnKeys.push(subtotalColumnKey);
+            }
+        }
+    }
+    return {
+        rowEntryKeys,
+        columnKeys,
+    };
+}
+export function isSamePivotTouchedKeys(left, right) {
+    if (left.rowEntryKeys.length !== right.rowEntryKeys.length || left.columnKeys.length !== right.columnKeys.length) {
+        return false;
+    }
+    for (let index = 0; index < left.rowEntryKeys.length; index += 1) {
+        if (left.rowEntryKeys[index] !== right.rowEntryKeys[index]) {
+            return false;
+        }
+    }
+    for (let index = 0; index < left.columnKeys.length; index += 1) {
+        if (left.columnKeys[index] !== right.columnKeys[index]) {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { DataGridAggOp, DataGridPivotSpec, DataGridPivotValueSpec, DataGridPivotColumn, DataGridPivotColumnPathSegment, DataGridPivotColumnSubtotalPosition, DataGridPivotColumnGrandTotalPosition, } from "./contracts.js";
+export type { DataGridAdvancedFilter, DataGridAdvancedFilterCondition, DataGridAdvancedFilterConditionType, DataGridAdvancedFilterExpression, DataGridAdvancedFilterGroup, DataGridAdvancedFilterNot, DataGridAggregationModel, DataGridAggregationColumnSpec, DataGridAggregationColumnSpecAnyState, DataGridAggregationFieldReader, DataGridColumnFilter, DataGridColumnFilterSnapshotEntry, DataGridColumnPredicateFilter, DataGridColumnPredicateOperator, DataGridColumnValueSetFilter, DataGridColumnPin, DataGridFilterClause, DataGridFilterSnapshot, DataGridGroupBySpec, DataGridGroupExpansionSnapshot, DataGridPivotLayoutColumnModel, DataGridPivotLayoutColumnModelColumnSnapshot, DataGridPivotLayoutColumnModelSnapshot, DataGridPivotLayoutRowModel, DataGridPivotLayoutRowModelSnapshot, DataGridRowId, DataGridRowNode, DataGridSortDirection, DataGridSortState, DataGridSortAndFilterModelInput, } from "./coreTypes.js";
+export type { DataGridPivotCellDrilldownInput, DataGridPivotCellDrilldown, } from "./drilldownContracts.js";
+export type { ResolvePivotCellDrilldownInput, } from "./drilldownRuntime.js";
+export type { DataGridPivotLayoutColumnState, DataGridPivotLayoutSnapshot, DataGridPivotLayoutImportOptions, DataGridPivotInteropSnapshot, } from "./layoutContracts.js";
+export type { DataGridPivotRuntimeOptions, DataGridPivotProjectionResult, DataGridPivotProjectRowsInput, DataGridPivotIncrementalPatchRow, DataGridPivotApplyValuePatchInput, DataGridPivotRuntime, } from "./runtimeContracts.js";
+export type { DataGridPivotRuntimeValueSpec, } from "./runtimeHelpers.js";
+export type { DataGridPivotFieldResolver, } from "./fieldRuntime.js";
+export type { DataGridPivotIncrementalTouchedKeys, DataGridPivotIncrementalTouchedKeysState, } from "./incrementalHelpers.js";
+export { normalizePivotSpec, clonePivotSpec, isSamePivotSpec, } from "./helpers.js";
+export { createPivotAxisKey, createPivotAggregateKey, createPivotColumnId, createPivotColumnLabel, normalizePivotAxisValue, comparePivotPathSegments, isPivotPathPrefixOrEqual, normalizePivotColumns, serializePivotModelForIncrementalState, } from "./runtimeHelpers.js";
+export { readPivotValueByPathSegments, createPivotFieldResolver, } from "./fieldRuntime.js";
+export { isSameLeafContribution, buildPivotIncrementalTouchedKeys, isSamePivotTouchedKeys, } from "./incrementalHelpers.js";
+export { resolvePivotCellDrilldown, } from "./drilldownRuntime.js";
+export type { DataGridPivotLayoutSortFilterBatchCapability, } from "./layoutRuntime.js";
+export { exportPivotLayoutSnapshot, exportPivotInteropSnapshot, importPivotLayoutSnapshot, } from "./layoutRuntime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,mCAAmC,EACnC,qCAAqC,GACtC,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,mCAAmC,EACnC,gCAAgC,EAChC,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qCAAqC,EACrC,8BAA8B,EAC9B,oBAAoB,EACpB,iCAAiC,EACjC,6BAA6B,EAC7B,+BAA+B,EAC/B,4BAA4B,EAC5B,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,4CAA4C,EAC5C,sCAAsC,EACtC,2BAA2B,EAC3B,mCAAmC,EACnC,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,+BAA+B,GAChC,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAA;AAEhC,YAAY,EACV,8BAA8B,GAC/B,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,8BAA8B,EAC9B,2BAA2B,EAC3B,gCAAgC,EAChC,4BAA4B,GAC7B,MAAM,sBAAsB,CAAA;AAE7B,YAAY,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,gCAAgC,EAChC,iCAAiC,EACjC,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,6BAA6B,GAC9B,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EACV,0BAA0B,GAC3B,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EACV,mCAAmC,EACnC,wCAAwC,GACzC,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,sCAAsC,GACvC,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,sBAAsB,GACvB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EACL,yBAAyB,GAC1B,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,4CAA4C,GAC7C,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { normalizePivotSpec, clonePivotSpec, isSamePivotSpec, } from "./helpers.js";
+export { createPivotAxisKey, createPivotAggregateKey, createPivotColumnId, createPivotColumnLabel, normalizePivotAxisValue, comparePivotPathSegments, isPivotPathPrefixOrEqual, normalizePivotColumns, serializePivotModelForIncrementalState, } from "./runtimeHelpers.js";
+export { readPivotValueByPathSegments, createPivotFieldResolver, } from "./fieldRuntime.js";
+export { isSameLeafContribution, buildPivotIncrementalTouchedKeys, isSamePivotTouchedKeys, } from "./incrementalHelpers.js";
+export { resolvePivotCellDrilldown, } from "./drilldownRuntime.js";
+export { exportPivotLayoutSnapshot, exportPivotInteropSnapshot, importPivotLayoutSnapshot, } from "./layoutRuntime.js";

package/dist/layoutContracts.d.ts

@@ -0,0 +1,28 @@
+import type { DataGridPivotColumn, DataGridPivotSpec } from "./contracts.js";
+import type { DataGridAggregationModel, DataGridColumnPin, DataGridFilterSnapshot, DataGridGroupBySpec, DataGridGroupExpansionSnapshot, DataGridRowNode, DataGridSortState } from "./coreTypes.js";
+export interface DataGridPivotLayoutColumnState {
+    order: readonly string[];
+    visibility: Readonly<Record<string, boolean>>;
+    widths: Readonly<Record<string, number | null>>;
+    pins: Readonly<Record<string, DataGridColumnPin>>;
+}
+export interface DataGridPivotLayoutSnapshot<TRow = unknown> {
+    version: 1;
+    sortModel: readonly DataGridSortState[];
+    filterModel: DataGridFilterSnapshot | null;
+    groupBy: DataGridGroupBySpec | null;
+    pivotModel: DataGridPivotSpec | null;
+    aggregationModel: DataGridAggregationModel<TRow> | null;
+    groupExpansion: DataGridGroupExpansionSnapshot | null;
+    columnState: DataGridPivotLayoutColumnState;
+}
+export interface DataGridPivotLayoutImportOptions {
+    applyColumnState?: boolean;
+}
+export interface DataGridPivotInteropSnapshot<TRow = unknown> {
+    version: 1;
+    layout: DataGridPivotLayoutSnapshot<TRow>;
+    pivotColumns: readonly DataGridPivotColumn[];
+    rows: readonly DataGridRowNode<TRow>[];
+}
+//# sourceMappingURL=layoutContracts.d.ts.map

package/dist/layoutContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutContracts.d.ts","sourceRoot":"","sources":["../src/layoutContracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,eAAe,EACf,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAA;IAC/C,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,2BAA2B,CAAC,IAAI,GAAG,OAAO;IACzD,OAAO,EAAE,CAAC,CAAA;IACV,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACvC,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAA;IAC1C,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAA;IACnC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACpC,gBAAgB,EAAE,wBAAwB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACvD,cAAc,EAAE,8BAA8B,GAAG,IAAI,CAAA;IACrD,WAAW,EAAE,8BAA8B,CAAA;CAC5C;AAED,MAAM,WAAW,gCAAgC;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,4BAA4B,CAAC,IAAI,GAAG,OAAO;IAC1D,OAAO,EAAE,CAAC,CAAA;IACV,MAAM,EAAE,2BAA2B,CAAC,IAAI,CAAC,CAAA;IACzC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC5C,IAAI,EAAE,SAAS,eAAe,CAAC,IAAI,CAAC,EAAE,CAAA;CACvC"}

package/dist/layoutContracts.js

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

package/dist/layoutRuntime.d.ts

@@ -0,0 +1,9 @@
+import type { DataGridPivotInteropSnapshot, DataGridPivotLayoutImportOptions, DataGridPivotLayoutSnapshot } from "./layoutContracts.js";
+import type { DataGridPivotLayoutColumnModel, DataGridPivotLayoutRowModel, DataGridSortAndFilterModelInput } from "./coreTypes.js";
+export interface DataGridPivotLayoutSortFilterBatchCapability {
+    setSortAndFilterModel: (input: DataGridSortAndFilterModelInput) => void;
+}
+export declare function exportPivotLayoutSnapshot<TRow = unknown>(rowModel: DataGridPivotLayoutRowModel<TRow>, columnModel: DataGridPivotLayoutColumnModel): DataGridPivotLayoutSnapshot<TRow>;
+export declare function exportPivotInteropSnapshot<TRow = unknown>(rowModel: DataGridPivotLayoutRowModel<TRow>, columnModel: DataGridPivotLayoutColumnModel): DataGridPivotInteropSnapshot<TRow> | null;
+export declare function importPivotLayoutSnapshot<TRow = unknown>(rowModel: DataGridPivotLayoutRowModel<TRow>, columnModel: DataGridPivotLayoutColumnModel, batchSortFilterCapability: DataGridPivotLayoutSortFilterBatchCapability | null, layout: DataGridPivotLayoutSnapshot<TRow>, options?: DataGridPivotLayoutImportOptions): void;
+//# sourceMappingURL=layoutRuntime.d.ts.map

package/dist/layoutRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layoutRuntime.d.ts","sourceRoot":"","sources":["../src/layoutRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,gCAAgC,EAChC,2BAA2B,EAC5B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAEV,8BAA8B,EAC9B,2BAA2B,EAC3B,+BAA+B,EAChC,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,4CAA4C;IAC3D,qBAAqB,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,CAAA;CACxE;AA0DD,wBAAgB,yBAAyB,CAAC,IAAI,GAAG,OAAO,EACtD,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAC3C,WAAW,EAAE,8BAA8B,GAC1C,2BAA2B,CAAC,IAAI,CAAC,CA0BnC;AAED,wBAAgB,0BAA0B,CAAC,IAAI,GAAG,OAAO,EACvD,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAC3C,WAAW,EAAE,8BAA8B,GAC1C,4BAA4B,CAAC,IAAI,CAAC,GAAG,IAAI,CAiB3C;AAED,wBAAgB,yBAAyB,CAAC,IAAI,GAAG,OAAO,EACtD,QAAQ,EAAE,2BAA2B,CAAC,IAAI,CAAC,EAC3C,WAAW,EAAE,8BAA8B,EAC3C,yBAAyB,EAAE,4CAA4C,GAAG,IAAI,EAC9E,MAAM,EAAE,2BAA2B,CAAC,IAAI,CAAC,EACzC,OAAO,GAAE,gCAAqC,GAC7C,IAAI,CA4DN"}

package/dist/layoutRuntime.js

@@ -0,0 +1,160 @@
+function cloneSerializable(value) {
+    const structuredCloneRef = globalThis.structuredClone;
+    if (typeof structuredCloneRef === "function") {
+        try {
+            return structuredCloneRef(value);
+        }
+        catch {
+            // Fall through to JSON fallback.
+        }
+    }
+    try {
+        return JSON.parse(JSON.stringify(value));
+    }
+    catch {
+        return value;
+    }
+}
+function areSerializableValuesEqual(left, right) {
+    if (Object.is(left, right)) {
+        return true;
+    }
+    try {
+        return JSON.stringify(left) === JSON.stringify(right);
+    }
+    catch {
+        return false;
+    }
+}
+function normalizePivotLayoutOrder(input) {
+    if (!Array.isArray(input)) {
+        return [];
+    }
+    const seen = new Set();
+    const normalized = [];
+    for (const rawKey of input) {
+        if (typeof rawKey !== "string") {
+            continue;
+        }
+        const key = rawKey.trim();
+        if (key.length === 0 || seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        normalized.push(key);
+    }
+    return normalized;
+}
+function normalizePivotLayoutPin(pin) {
+    if (pin === "left" || pin === "right" || pin === "none") {
+        return pin;
+    }
+    return null;
+}
+export function exportPivotLayoutSnapshot(rowModel, columnModel) {
+    const rowSnapshot = rowModel.getSnapshot();
+    const columnSnapshot = columnModel.getSnapshot();
+    const visibility = {};
+    const widths = {};
+    const pins = {};
+    for (const column of columnSnapshot.columns) {
+        visibility[column.key] = column.visible;
+        widths[column.key] = column.width;
+        pins[column.key] = column.pin;
+    }
+    return {
+        version: 1,
+        sortModel: cloneSerializable(rowSnapshot.sortModel),
+        filterModel: cloneSerializable(rowSnapshot.filterModel),
+        groupBy: cloneSerializable(rowSnapshot.groupBy),
+        pivotModel: cloneSerializable(rowModel.getPivotModel()),
+        aggregationModel: cloneSerializable(rowModel.getAggregationModel()),
+        groupExpansion: cloneSerializable(rowSnapshot.groupExpansion),
+        columnState: {
+            order: cloneSerializable(columnSnapshot.order),
+            visibility,
+            widths,
+            pins,
+        },
+    };
+}
+export function exportPivotInteropSnapshot(rowModel, columnModel) {
+    var _a;
+    const pivotModel = rowModel.getPivotModel();
+    if (!pivotModel) {
+        return null;
+    }
+    const rowSnapshot = rowModel.getSnapshot();
+    const rowCount = Math.max(0, Math.trunc(rowSnapshot.rowCount));
+    const rows = rowCount > 0
+        ? rowModel.getRowsInRange({ start: 0, end: rowCount - 1 })
+        : [];
+    const layout = exportPivotLayoutSnapshot(rowModel, columnModel);
+    return {
+        version: 1,
+        layout,
+        pivotColumns: cloneSerializable((_a = rowSnapshot.pivotColumns) !== null && _a !== void 0 ? _a : []),
+        rows: cloneSerializable(rows),
+    };
+}
+export function importPivotLayoutSnapshot(rowModel, columnModel, batchSortFilterCapability, layout, options = {}) {
+    var _a, _b, _c, _d;
+    if (!layout || typeof layout !== "object") {
+        return;
+    }
+    const currentLayout = exportPivotLayoutSnapshot(rowModel, columnModel);
+    if (areSerializableValuesEqual(currentLayout, layout)) {
+        return;
+    }
+    if (options.applyColumnState !== false) {
+        const applyColumnState = () => {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const order = normalizePivotLayoutOrder((_a = layout.columnState) === null || _a === void 0 ? void 0 : _a.order);
+            if (order.length > 0) {
+                columnModel.setColumnOrder(order);
+            }
+            const visibility = (_c = (_b = layout.columnState) === null || _b === void 0 ? void 0 : _b.visibility) !== null && _c !== void 0 ? _c : {};
+            for (const [key, value] of Object.entries(visibility)) {
+                columnModel.setColumnVisibility(key, Boolean(value));
+            }
+            const widths = (_e = (_d = layout.columnState) === null || _d === void 0 ? void 0 : _d.widths) !== null && _e !== void 0 ? _e : {};
+            for (const [key, value] of Object.entries(widths)) {
+                const normalizedWidth = Number.isFinite(value)
+                    ? Math.max(0, Math.trunc(value))
+                    : null;
+                columnModel.setColumnWidth(key, normalizedWidth);
+            }
+            const pins = (_g = (_f = layout.columnState) === null || _f === void 0 ? void 0 : _f.pins) !== null && _g !== void 0 ? _g : {};
+            for (const [key, value] of Object.entries(pins)) {
+                const normalizedPin = normalizePivotLayoutPin(value);
+                if (!normalizedPin) {
+                    continue;
+                }
+                columnModel.setColumnPin(key, normalizedPin);
+            }
+        };
+        if (typeof columnModel.batch === "function") {
+            columnModel.batch(applyColumnState);
+        }
+        else {
+            applyColumnState();
+        }
+    }
+    const sortModel = Array.isArray(layout.sortModel)
+        ? layout.sortModel
+        : [];
+    const filterModel = layout.filterModel == null
+        ? null
+        : layout.filterModel;
+    if (batchSortFilterCapability) {
+        batchSortFilterCapability.setSortAndFilterModel({ sortModel, filterModel });
+    }
+    else {
+        rowModel.setFilterModel(filterModel);
+        rowModel.setSortModel(sortModel);
+    }
+    rowModel.setGroupBy((_a = layout.groupBy) !== null && _a !== void 0 ? _a : null);
+    rowModel.setPivotModel((_b = layout.pivotModel) !== null && _b !== void 0 ? _b : null);
+    rowModel.setAggregationModel((_c = layout.aggregationModel) !== null && _c !== void 0 ? _c : null);
+    rowModel.setGroupExpansion((_d = layout.groupExpansion) !== null && _d !== void 0 ? _d : null);
+}

package/dist/runtimeContracts.d.ts

@@ -0,0 +1,30 @@
+import type { DataGridPivotColumn, DataGridPivotSpec } from "./contracts.js";
+import type { DataGridAggregationFieldReader, DataGridGroupExpansionSnapshot, DataGridRowNode } from "./coreTypes.js";
+export interface DataGridPivotRuntimeOptions<T> {
+    readRowField?: DataGridAggregationFieldReader<T>;
+}
+export interface DataGridPivotProjectionResult<T> {
+    rows: DataGridRowNode<T>[];
+    columns: DataGridPivotColumn[];
+}
+export interface DataGridPivotProjectRowsInput<T> {
+    inputRows: readonly DataGridRowNode<T>[];
+    pivotModel: DataGridPivotSpec;
+    normalizeFieldValue: (value: unknown) => string;
+    expansionSnapshot?: DataGridGroupExpansionSnapshot | null;
+}
+export interface DataGridPivotIncrementalPatchRow<T> {
+    previousRow: DataGridRowNode<T>;
+    nextRow: DataGridRowNode<T>;
+}
+export interface DataGridPivotApplyValuePatchInput<T> {
+    projectedRows: readonly DataGridRowNode<T>[];
+    pivotModel: DataGridPivotSpec;
+    changedRows: readonly DataGridPivotIncrementalPatchRow<T>[];
+}
+export interface DataGridPivotRuntime<T> {
+    projectRows: (input: DataGridPivotProjectRowsInput<T>) => DataGridPivotProjectionResult<T>;
+    applyValueOnlyPatch: (input: DataGridPivotApplyValuePatchInput<T>) => DataGridPivotProjectionResult<T> | null;
+    normalizeColumns: (columns: readonly DataGridPivotColumn[]) => DataGridPivotColumn[];
+}
+//# sourceMappingURL=runtimeContracts.d.ts.map

package/dist/runtimeContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeContracts.d.ts","sourceRoot":"","sources":["../src/runtimeContracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,8BAA8B,CAAC,CAAC,CAAC,CAAA;CACjD;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAC/B;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,SAAS,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACxC,UAAU,EAAE,iBAAiB,CAAA;IAC7B,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IAC/C,iBAAiB,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAA;CAC1D;AAED,MAAM,WAAW,gCAAgC,CAAC,CAAC;IACjD,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IAC/B,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,iCAAiC,CAAC,CAAC;IAClD,aAAa,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,UAAU,EAAE,iBAAiB,CAAA;IAC7B,WAAW,EAAE,SAAS,gCAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;CAC5D;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,WAAW,EAAE,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC,CAAC,KAAK,6BAA6B,CAAC,CAAC,CAAC,CAAA;IAC1F,mBAAmB,EAAE,CAAC,KAAK,EAAE,iCAAiC,CAAC,CAAC,CAAC,KAAK,6BAA6B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAC7G,gBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,CAAA;CACrF"}

package/dist/runtimeContracts.js

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

package/dist/runtimeHelpers.d.ts

@@ -0,0 +1,34 @@
+import type { DataGridAggOp, DataGridPivotColumn, DataGridPivotColumnPathSegment, DataGridPivotSpec } from "./contracts.js";
+export interface DataGridPivotRuntimeValueSpec {
+    field: string;
+    agg: DataGridAggOp;
+    aggregateKey: string;
+}
+export declare function createPivotAxisKey(prefix: "pivot:row:" | "pivot:column:" | "pivot:column-subtotal:" | "pivot:subtotal:" | "pivot:group:", segments: readonly {
+    field: string;
+    value: string;
+}[]): string;
+export declare function createPivotAggregateKey(spec: DataGridPivotRuntimeValueSpec): string;
+export declare function createPivotColumnId(columnKey: string, valueSpec: DataGridPivotRuntimeValueSpec): string;
+export declare function createPivotColumnLabel(columnPath: readonly DataGridPivotColumnPathSegment[], valueSpec: DataGridPivotRuntimeValueSpec, options?: {
+    subtotal?: boolean;
+    grandTotal?: boolean;
+}): string;
+export declare function normalizePivotAxisValue(value: unknown, normalizeFieldValue: (value: unknown) => string): string;
+export declare function comparePivotPathSegments(left: readonly {
+    field: string;
+    value: string;
+}[], right: readonly {
+    field: string;
+    value: string;
+}[]): number;
+export declare function isPivotPathPrefixOrEqual(prefix: readonly {
+    field: string;
+    value: string;
+}[], candidate: readonly {
+    field: string;
+    value: string;
+}[]): boolean;
+export declare function normalizePivotColumns(columns: readonly DataGridPivotColumn[]): DataGridPivotColumn[];
+export declare function serializePivotModelForIncrementalState(pivotModel: DataGridPivotSpec): string;
+//# sourceMappingURL=runtimeHelpers.d.ts.map

package/dist/runtimeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeHelpers.d.ts","sourceRoot":"","sources":["../src/runtimeHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,8BAA8B,EAC9B,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,aAAa,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACrB;AAOD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,GAAG,eAAe,GAAG,wBAAwB,GAAG,iBAAiB,GAAG,cAAc,EACtG,QAAQ,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACpD,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,6BAA6B,GAAG,MAAM,CAEnF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,6BAA6B,GACvC,MAAM,CAER;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,8BAA8B,EAAE,EACrD,SAAS,EAAE,6BAA6B,EACxC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,MAAM,CAQR;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAC9C,MAAM,CAMR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EACjD,KAAK,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACjD,MAAM,CA4BR;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EACnD,SAAS,EAAE,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GACrD,OAAO,CAeT;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACtC,mBAAmB,EAAE,CAavB;AAED,wBAAgB,sCAAsC,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAY5F"}