@affino/datagrid-pivot 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 affino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# `@affino/datagrid-pivot`
+
+Community pivot API boundary for Affino DataGrid.
+
+## Purpose
+
+This package freezes the pivot-specific public boundary before first release.
+
+Current state:
+
+- community-safe pivot types and pure helper APIs live here
+- low-level row-model orchestration and pivot runtime integration still live in `@affino/datagrid-core`
+
+## Community surface
+
+The package intentionally exposes the base pivot surface:
+
+- pivot model/type contracts
+- pivot drilldown contracts
+- pivot layout snapshot contracts
+- pivot spec normalization / cloning / equality helpers
+
+## Planned enterprise surface
+
+These are reserved as future enterprise candidates and are intentionally not split into public package entrypoints yet:
+
+- premium high-cardinality pivot runtime tiers
+- advanced incremental pivot patch strategies
+- pivot profiler / diagnostics tooling
+- premium pivot UX shells and runtime controls
+- server-backed pivot acceleration and scaling layers
+
+## Boundary rule
+
+Use `@affino/datagrid-pivot` for pivot contracts and pure helper APIs.
+Keep row-model orchestration and runtime integration inside `@affino/datagrid-core` until the next extraction phase.

package/dist/contracts.d.ts

@@ -0,0 +1,32 @@
+export type DataGridPivotColumnSubtotalPosition = "after" | "before";
+export type DataGridPivotColumnGrandTotalPosition = "last" | "first";
+export type DataGridAggOp = "sum" | "avg" | "min" | "max" | "count" | "countNonNull" | "first" | "last" | "custom";
+export interface DataGridPivotValueSpec {
+    field: string;
+    agg: DataGridAggOp;
+}
+export interface DataGridPivotSpec {
+    rows: string[];
+    columns: string[];
+    values: DataGridPivotValueSpec[];
+    rowSubtotals?: boolean;
+    columnSubtotals?: boolean;
+    columnGrandTotal?: boolean;
+    columnSubtotalPosition?: DataGridPivotColumnSubtotalPosition;
+    columnGrandTotalPosition?: DataGridPivotColumnGrandTotalPosition;
+    grandTotal?: boolean;
+}
+export interface DataGridPivotColumnPathSegment {
+    field: string;
+    value: string;
+}
+export interface DataGridPivotColumn {
+    id: string;
+    valueField: string;
+    agg: DataGridAggOp;
+    columnPath: readonly DataGridPivotColumnPathSegment[];
+    label: string;
+    subtotal?: boolean;
+    grandTotal?: boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mCAAmC,GAAG,OAAO,GAAG,QAAQ,CAAA;AACpE,MAAM,MAAM,qCAAqC,GAAG,MAAM,GAAG,OAAO,CAAA;AAEpE,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,OAAO,GACP,cAAc,GACd,OAAO,GACP,MAAM,GACN,QAAQ,CAAA;AAEZ,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,aAAa,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,sBAAsB,EAAE,CAAA;IAChC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,sBAAsB,CAAC,EAAE,mCAAmC,CAAA;IAC5D,wBAAwB,CAAC,EAAE,qCAAqC,CAAA;IAChE,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,aAAa,CAAA;IAClB,UAAU,EAAE,SAAS,8BAA8B,EAAE,CAAA;IACrD,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB"}

package/dist/contracts.js

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

package/dist/coreTypes.d.ts

@@ -0,0 +1,163 @@
+import type { DataGridAggOp } from "./contracts.js";
+export type DataGridRowId = string | number;
+export type DataGridSortDirection = "asc" | "desc";
+export interface DataGridSortState {
+    key: string;
+    field?: string;
+    dependencyFields?: readonly string[];
+    direction: DataGridSortDirection;
+}
+export interface DataGridFilterClause {
+    operator: string;
+    value: unknown;
+    value2?: unknown;
+    join?: "and" | "or";
+}
+export interface DataGridAdvancedFilter {
+    type: "text" | "number" | "date" | "set";
+    clauses: DataGridFilterClause[];
+}
+export type DataGridAdvancedFilterConditionType = "text" | "number" | "date" | "set" | "boolean";
+export interface DataGridAdvancedFilterCondition {
+    kind: "condition";
+    key: string;
+    field?: string;
+    type?: DataGridAdvancedFilterConditionType;
+    operator: string;
+    value?: unknown;
+    value2?: unknown;
+}
+export interface DataGridAdvancedFilterGroup {
+    kind: "group";
+    operator: "and" | "or";
+    children: DataGridAdvancedFilterExpression[];
+}
+export interface DataGridAdvancedFilterNot {
+    kind: "not";
+    child: DataGridAdvancedFilterExpression;
+}
+export type DataGridAdvancedFilterExpression = DataGridAdvancedFilterCondition | DataGridAdvancedFilterGroup | DataGridAdvancedFilterNot;
+export interface DataGridColumnValueSetFilter {
+    kind: "valueSet";
+    tokens: string[];
+}
+export type DataGridColumnPredicateOperator = "contains" | "startsWith" | "endsWith" | "equals" | "notEquals" | "gt" | "gte" | "lt" | "lte" | "between" | "isEmpty" | "notEmpty" | "isNull" | "notNull";
+export interface DataGridColumnPredicateFilter {
+    kind: "predicate";
+    operator: DataGridColumnPredicateOperator;
+    value?: unknown;
+    value2?: unknown;
+    caseSensitive?: boolean;
+}
+export type DataGridColumnFilter = DataGridColumnValueSetFilter | DataGridColumnPredicateFilter;
+export type DataGridColumnFilterSnapshotEntry = DataGridColumnFilter;
+export interface DataGridFilterSnapshot {
+    columnFilters: Record<string, DataGridColumnFilterSnapshotEntry>;
+    advancedFilters: Record<string, DataGridAdvancedFilter>;
+    advancedExpression?: DataGridAdvancedFilterExpression | null;
+}
+export interface DataGridSortAndFilterModelInput {
+    sortModel: readonly DataGridSortState[];
+    filterModel: DataGridFilterSnapshot | null;
+}
+export interface DataGridGroupBySpec {
+    fields: string[];
+    expandedByDefault?: boolean;
+}
+export interface DataGridGroupExpansionSnapshot {
+    expandedByDefault: boolean;
+    toggledGroupKeys: readonly string[];
+}
+export type DataGridColumnPin = "left" | "right" | "none";
+type DataGridAggregationStateHandler<TState, TArgs extends readonly unknown[] = readonly [], TResult = void> = {
+    bivarianceHack(state: TState, ...args: TArgs): TResult;
+}["bivarianceHack"];
+export interface DataGridAggregationColumnSpec<T = unknown, TState = unknown> {
+    key: string;
+    field?: string;
+    op: DataGridAggOp;
+    createState?: () => TState;
+    add?: DataGridAggregationStateHandler<TState, [value: unknown, row: DataGridRowNode<T>]>;
+    merge?: DataGridAggregationStateHandler<TState, [childState: TState]>;
+    remove?: DataGridAggregationStateHandler<TState, [value: unknown, row: DataGridRowNode<T>]>;
+    finalize?: DataGridAggregationStateHandler<TState, [], unknown>;
+    coerce?: (value: unknown) => number | string | null;
+}
+export type DataGridAggregationColumnSpecAnyState<T = unknown> = DataGridAggregationColumnSpec<T, unknown>;
+export interface DataGridAggregationModel<T = unknown> {
+    columns: readonly DataGridAggregationColumnSpecAnyState<T>[];
+    basis?: "filtered" | "source";
+}
+export type DataGridAggregationFieldReader<T = unknown> = (rowNode: DataGridRowNode<T>, key: string, field: string) => unknown;
+export type DataGridIncrementalAggregationLeafContribution = Record<string, unknown>;
+export type DataGridRowKind = "leaf" | "group";
+export type DataGridRowPinState = "none" | "top" | "bottom";
+export interface DataGridRowGroupMeta {
+    groupKey: string;
+    groupField: string;
+    groupValue: string;
+    level: number;
+    childrenCount: number;
+    aggregates?: Record<string, unknown>;
+}
+export interface DataGridRowNodeState {
+    selected: boolean;
+    group: boolean;
+    pinned: DataGridRowPinState;
+    expanded: boolean;
+}
+export interface DataGridRowNode<T = unknown> {
+    kind: DataGridRowKind;
+    data: T;
+    row: T;
+    rowKey: DataGridRowId;
+    rowId: DataGridRowId;
+    sourceIndex: number;
+    originalIndex: number;
+    displayIndex: number;
+    state: DataGridRowNodeState;
+    groupMeta?: DataGridRowGroupMeta;
+}
+export interface DataGridPivotLayoutColumnModelColumnSnapshot {
+    key: string;
+    visible: boolean;
+    width: number | null;
+    pin: DataGridColumnPin;
+}
+export interface DataGridPivotLayoutColumnModelSnapshot {
+    columns: readonly DataGridPivotLayoutColumnModelColumnSnapshot[];
+    order: readonly string[];
+}
+export interface DataGridPivotLayoutColumnModel {
+    getSnapshot(): DataGridPivotLayoutColumnModelSnapshot;
+    batch?<TResult>(fn: () => TResult): TResult;
+    setColumnOrder(order: readonly string[]): void;
+    setColumnVisibility(key: string, visible: boolean): void;
+    setColumnWidth(key: string, width: number | null): void;
+    setColumnPin(key: string, pin: DataGridColumnPin): void;
+}
+export interface DataGridPivotLayoutRowModelSnapshot {
+    rowCount: number;
+    sortModel: readonly DataGridSortState[];
+    filterModel: DataGridFilterSnapshot | null;
+    groupBy: DataGridGroupBySpec | null;
+    groupExpansion: DataGridGroupExpansionSnapshot | null;
+    pivotColumns?: readonly import("./contracts.js").DataGridPivotColumn[];
+}
+export interface DataGridPivotLayoutRowModel<TRow = unknown> {
+    getSnapshot(): DataGridPivotLayoutRowModelSnapshot;
+    getPivotModel(): import("./contracts.js").DataGridPivotSpec | null;
+    getAggregationModel(): DataGridAggregationModel<TRow> | null;
+    getRowsInRange(range: {
+        start: number;
+        end: number;
+    }): readonly DataGridRowNode<TRow>[];
+    setFilterModel(filterModel: DataGridFilterSnapshot | null): void;
+    setSortModel(sortModel: readonly DataGridSortState[]): void;
+    setGroupBy(groupBy: DataGridGroupBySpec | null): void;
+    setPivotModel(pivotModel: import("./contracts.js").DataGridPivotSpec | null): void;
+    setAggregationModel(aggregationModel: DataGridAggregationModel<TRow> | null): void;
+    setGroupExpansion(groupExpansion: DataGridGroupExpansionSnapshot | null): void;
+}
+export {};
+//# sourceMappingURL=coreTypes.d.ts.map

package/dist/coreTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreTypes.d.ts","sourceRoot":"","sources":["../src/coreTypes.ts"],"names":[],"mappings":"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"}

package/dist/coreTypes.js

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

package/dist/drilldownContracts.d.ts

@@ -0,0 +1,18 @@
+import type { DataGridAggOp } from "./contracts.js";
+import type { DataGridRowId, DataGridRowNode } from "./coreTypes.js";
+export interface DataGridPivotCellDrilldownInput {
+    rowId: DataGridRowId;
+    columnId: string;
+    limit?: number;
+}
+export interface DataGridPivotCellDrilldown<T = unknown> {
+    rowId: DataGridRowId;
+    columnId: string;
+    valueField: string;
+    agg: DataGridAggOp;
+    cellValue: unknown;
+    matchCount: number;
+    truncated: boolean;
+    rows: readonly DataGridRowNode<T>[];
+}
+//# sourceMappingURL=drilldownContracts.d.ts.map

package/dist/drilldownContracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drilldownContracts.d.ts","sourceRoot":"","sources":["../src/drilldownContracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,OAAO;IACrD,KAAK,EAAE,aAAa,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,aAAa,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;CACpC"}

package/dist/drilldownContracts.js

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

package/dist/drilldownRuntime.d.ts

@@ -0,0 +1,17 @@
+import type { DataGridPivotCellDrilldown, DataGridPivotCellDrilldownInput } from "./drilldownContracts.js";
+import type { DataGridPivotColumn, DataGridPivotSpec } from "./contracts.js";
+import type { DataGridRowId, DataGridRowNode } from "./coreTypes.js";
+export interface ResolvePivotCellDrilldownInput<T> {
+    input: DataGridPivotCellDrilldownInput;
+    pivotModel: DataGridPivotSpec | null;
+    pivotColumns: readonly DataGridPivotColumn[];
+    aggregatedRowsProjection: readonly DataGridRowNode<T>[];
+    pivotedRowsProjection: readonly DataGridRowNode<T>[];
+    groupedRowsProjection: readonly DataGridRowNode<T>[];
+    sourceRows: readonly DataGridRowNode<T>[];
+    isDataGridRowId: (value: unknown) => value is DataGridRowId;
+    normalizePivotAxisValue: (value: unknown) => string;
+    readRowField: (row: DataGridRowNode<T>, key: string) => unknown;
+}
+export declare function resolvePivotCellDrilldown<T>(context: ResolvePivotCellDrilldownInput<T>): DataGridPivotCellDrilldown<T> | null;
+//# sourceMappingURL=drilldownRuntime.d.ts.map

package/dist/drilldownRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drilldownRuntime.d.ts","sourceRoot":"","sources":["../src/drilldownRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAChB,MAAM,gBAAgB,CAAA;AA6CvB,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,KAAK,EAAE,+BAA+B,CAAA;IACtC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACpC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC5C,wBAAwB,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACvD,qBAAqB,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACpD,qBAAqB,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACpD,UAAU,EAAE,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,CAAA;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,aAAa,CAAA;IAC3D,uBAAuB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACnD,YAAY,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;CAChE;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC,GACzC,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI,CAwFtC"}

package/dist/drilldownRuntime.js

@@ -0,0 +1,103 @@
+function resolvePivotDrilldownRowConstraints(row, rowFields, normalizePivotAxisValue, readRowField) {
+    var _a, _b;
+    if (String(row.rowId) === "pivot:grand-total") {
+        return [];
+    }
+    const constraints = [];
+    if (row.kind === "group") {
+        const depth = Math.max(1, Math.min(rowFields.length, Math.trunc(((_b = (_a = row.groupMeta) === null || _a === void 0 ? void 0 : _a.level) !== null && _b !== void 0 ? _b : 0) + 1)));
+        for (let index = 0; index < depth; index += 1) {
+            const field = rowFields[index];
+            if (!field) {
+                continue;
+            }
+            constraints.push({
+                field,
+                value: normalizePivotAxisValue(readRowField(row, field)),
+            });
+        }
+        return constraints;
+    }
+    for (const field of rowFields) {
+        const normalizedValue = normalizePivotAxisValue(readRowField(row, field));
+        if (normalizedValue === "Subtotal" || normalizedValue === "Grand Total") {
+            break;
+        }
+        constraints.push({
+            field,
+            value: normalizedValue,
+        });
+    }
+    return constraints;
+}
+export function resolvePivotCellDrilldown(context) {
+    var _a, _b;
+    const { input, pivotModel, pivotColumns, aggregatedRowsProjection, pivotedRowsProjection, groupedRowsProjection, sourceRows, isDataGridRowId, normalizePivotAxisValue, readRowField, } = context;
+    if (!pivotModel || !Array.isArray(pivotColumns) || pivotColumns.length === 0) {
+        return null;
+    }
+    if (!isDataGridRowId(input === null || input === void 0 ? void 0 : input.rowId)) {
+        return null;
+    }
+    const columnId = typeof input.columnId === "string" ? input.columnId.trim() : "";
+    if (columnId.length === 0) {
+        return null;
+    }
+    const pivotColumn = pivotColumns.find(column => column.id === columnId);
+    if (!pivotColumn) {
+        return null;
+    }
+    const pivotRow = (_b = (_a = aggregatedRowsProjection.find(row => row.rowId === input.rowId)) !== null && _a !== void 0 ? _a : pivotedRowsProjection.find(row => row.rowId === input.rowId)) !== null && _b !== void 0 ? _b : groupedRowsProjection.find(row => row.rowId === input.rowId);
+    if (!pivotRow) {
+        return null;
+    }
+    const normalizedLimit = Number.isFinite(input.limit)
+        ? Math.max(1, Math.min(5000, Math.trunc(input.limit)))
+        : 200;
+    const rowConstraints = resolvePivotDrilldownRowConstraints(pivotRow, pivotModel.rows, normalizePivotAxisValue, readRowField);
+    const columnConstraints = pivotColumn.columnPath.map((segment) => ({
+        field: segment.field,
+        value: segment.value,
+    }));
+    const matches = [];
+    let matchCount = 0;
+    for (const sourceRow of sourceRows) {
+        if (sourceRow.kind !== "leaf") {
+            continue;
+        }
+        let rowMatches = true;
+        for (const constraint of rowConstraints) {
+            if (normalizePivotAxisValue(readRowField(sourceRow, constraint.field)) !== constraint.value) {
+                rowMatches = false;
+                break;
+            }
+        }
+        if (!rowMatches) {
+            continue;
+        }
+        let columnMatches = true;
+        for (const constraint of columnConstraints) {
+            if (normalizePivotAxisValue(readRowField(sourceRow, constraint.field)) !== constraint.value) {
+                columnMatches = false;
+                break;
+            }
+        }
+        if (!columnMatches) {
+            continue;
+        }
+        matchCount += 1;
+        if (matches.length < normalizedLimit) {
+            matches.push(sourceRow);
+        }
+    }
+    return {
+        rowId: input.rowId,
+        columnId,
+        valueField: pivotColumn.valueField,
+        agg: pivotColumn.agg,
+        cellValue: readRowField(pivotRow, columnId),
+        matchCount,
+        truncated: matchCount > matches.length,
+        rows: matches,
+    };
+}

package/dist/fieldRuntime.d.ts

@@ -0,0 +1,8 @@
+import type { DataGridAggregationFieldReader, DataGridRowNode } from "./coreTypes.js";
+export interface DataGridPivotFieldResolver<T> {
+    field: string;
+    read: (rowNode: DataGridRowNode<T>) => unknown;
+}
+export declare function readPivotValueByPathSegments(value: unknown, segments: readonly string[]): unknown;
+export declare function createPivotFieldResolver<T>(field: string, readRowField?: DataGridAggregationFieldReader<T>): DataGridPivotFieldResolver<T> | null;
+//# sourceMappingURL=fieldRuntime.d.ts.map

package/dist/fieldRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRuntime.d.ts","sourceRoot":"","sources":["../src/fieldRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,eAAe,EAChB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;CAC/C;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAoBT;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAC/C,0BAA0B,CAAC,CAAC,CAAC,GAAG,IAAI,CA8BtC"}

package/dist/fieldRuntime.js

@@ -0,0 +1,52 @@
+export function readPivotValueByPathSegments(value, segments) {
+    if (segments.length === 0 || typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    let current = value;
+    for (const segment of segments) {
+        if (Array.isArray(current)) {
+            const index = Number(segment);
+            if (!Number.isInteger(index) || index < 0 || index >= current.length) {
+                return undefined;
+            }
+            current = current[index];
+            continue;
+        }
+        if (typeof current !== "object" || current === null || !(segment in current)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+export function createPivotFieldResolver(field, readRowField) {
+    const normalizedField = field.trim();
+    if (normalizedField.length === 0) {
+        return null;
+    }
+    if (typeof readRowField === "function") {
+        return {
+            field: normalizedField,
+            read: (rowNode) => readRowField(rowNode, normalizedField, normalizedField),
+        };
+    }
+    const segments = normalizedField.includes(".")
+        ? normalizedField.split(".").filter(Boolean)
+        : [];
+    return {
+        field: normalizedField,
+        read: (rowNode) => {
+            const source = rowNode.data;
+            const directValue = typeof source === "object" && source !== null
+                ? source[normalizedField]
+                : undefined;
+            if (typeof directValue !== "undefined") {
+                return directValue;
+            }
+            if (segments.length === 0) {
+                return undefined;
+            }
+            return readPivotValueByPathSegments(source, segments);
+        },
+    };
+}

package/dist/helpers.d.ts

@@ -0,0 +1,5 @@
+import type { DataGridPivotSpec } from "./contracts.js";
+export declare function normalizePivotSpec(pivotSpec: DataGridPivotSpec | null | undefined): DataGridPivotSpec | null;
+export declare function clonePivotSpec(pivotSpec: DataGridPivotSpec | null | undefined): DataGridPivotSpec | null;
+export declare function isSamePivotSpec(left: DataGridPivotSpec | null | undefined, right: DataGridPivotSpec | null | undefined): boolean;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,gBAAgB,CAAA;AAkCvB,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC9C,iBAAiB,GAAG,IAAI,CAyD1B;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC9C,iBAAiB,GAAG,IAAI,CAoB1B;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC1C,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAyDT"}