@kanunilabs/pivotgrid-core 1.10.0 → 1.11.0

package/dist/index.d.cts

@@ -91,6 +91,7 @@ interface PivotDictionary {
     avg: string;
     min: string;
     max: string;
+    distinct: string;
     grandTotal: string;
     subTotal: string;
     absoluteValue: string;
@@ -146,20 +147,12 @@ interface PivotDictionary {
     opNotContains: string;
     opStartsWith: string;
     opEndsWith: string;
-    opIsBlank: string;
-    opIsNotBlank: string;
     /** Value filter `between` / `notBetween` (G-PIV-03); `opBetween` is the DataGrid's own string. */
     opBetween: string;
     opNotBetween: string;
     /** The field menu item and dialog title for value / label filters (G-PIV-03). */
     conditionFilter: string;
     /** Prefilter builder chrome (#210) — shared with DataGrid. */
-    builderCombine: string;
-    builderAddCondition: string;
-    builderAddGroup: string;
-    builderRemoveGroup: string;
-    builderRemoveCondition: string;
-    builderEmpty: string;
     builderValuePlaceholder: string;
     /** PDF export header (#215). */
     exportGeneratedOn: string;
@@ -1612,7 +1605,11 @@ declare function resolveConditionalVisual(value: number | undefined, field: Pivo
 type ExportFormat = 'excel-list' | 'excel-pivot' | 'pdf' | 'json' | 'json-pivot' | 'json-snapshot' | 'xml' | 'csv' | 'print' | 'clipboard';
 /** Options passed to the export pipeline — all fields optional for backward compat. */
 interface ExportOptions {
-    /** Apply prefilter to raw data before export. */
+    /**
+     * Export only the rows the filters keep (field filters and the prefilter).
+     * Default `true`; `false` writes every source row. Before 2026-10-15 the
+     * default was `false`.
+     */
     applyFilters?: boolean;
     /** Custom file name (without extension). */
     fileName?: string;
@@ -1969,8 +1966,21 @@ interface PivotStateStoringConfig {
     enabled: boolean;
     type?: 'localStorage' | 'sessionStorage' | 'custom';
     storageKey?: string;
+    /** `custom`: called (debounced) with the state to keep — the shape `getPersistedState` returns. */
     onSave?: (state: any) => void;
+    /**
+     * `custom`: the stored state, or a Promise of it (IndexedDB, a server). A
+     * Promise is applied when it resolves; nothing is saved until then, so the
+     * default layout the grid starts on never overwrites the stored one. To
+     * open on the stored layout with no visible switch, read it before mounting
+     * and return it synchronously.
+     */
     onLoad?: () => any;
+    /**
+     * Session state to keep as well — none by default. `'scroll'`: where the
+     * body was scrolled, put back once the restored pivot is drawn.
+     */
+    include?: readonly 'scroll'[];
 }
 interface PivotToolbarConfig {
     showSaveReport?: boolean;
@@ -2371,16 +2381,40 @@ type PivotStateListener = () => void;
  * documented on the features page as "persist to your own backend" was a hook
  * that nothing ever called.
  */
-/** What actually goes in and out of storage. */
+/**
+ * The version of `PersistedPivotState`. A saved state carrying another one is
+ * not read — the grid opens with its default layout, no error. A state saved
+ * before versions existed has none and is read as version 1.
+ */
+declare const PIVOT_STATE_VERSION = 1;
+/**
+ * What goes in and out of storage — and what `getPersistedState` returns and
+ * `applyPersistedState` takes. Plain JSON: store it anywhere.
+ */
 interface PersistedPivotState {
+    version?: number;
     fields?: unknown[];
     layout?: Partial<PivotLayoutState>;
     columnWidths?: Record<string, number>;
     expandedPaths?: string[];
     expandedColPaths?: string[];
+    /**
+     * State kept by layers above the core, by name (`registerReportStatePart`):
+     * the Enterprise chart panel keeps its chart under `chart`, and an app can
+     * register its own chart or panel the same way.
+     */
+    parts?: Record<string, unknown>;
+    /** SESSION state, only when asked for (`include: ['scroll']`): the body's scroll offsets. */
+    scroll?: {
+        top: number;
+        left: number;
+    };
 }
+/** Session parts a snapshot leaves out unless asked: `'scroll'`. */
+type PivotStateSession = 'scroll';
 interface PivotStatePersistence {
-    load(): PersistedPivotState | null;
+    /** May be a Promise (IndexedDB, a server); the grid applies it when it resolves. */
+    load(): PersistedPivotState | null | Promise<PersistedPivotState | null>;
     save(state: PersistedPivotState): void;
 }
 /** Immutable-snapshot state store with debounced persistence. */
@@ -2390,6 +2424,27 @@ declare class PivotStateStore<TRow> {
     private storageKey;
     private persistScheduled;
     private persistence;
+    /**
+     * The stored state, while an asynchronous `onLoad` is still reading it. No
+     * save happens meanwhile: the grid starts on its default layout, and writing
+     * that would overwrite the very state being loaded.
+     */
+    pendingLoad: Promise<PersistedPivotState | null> | null;
+    private readonly initialFields;
+    /**
+     * What lives outside the store but is saved with it — the controller's
+     * registered parts and the reported scroll. Set by the controller.
+     */
+    extras: {
+        parts?: () => Record<string, unknown> | undefined;
+        scroll?: () => {
+            top: number;
+            left: number;
+        };
+        include?: readonly PivotStateSession[];
+    };
+    /** Parts and scroll read at construction, for the controller to hand on. */
+    loadedExtras: Pick<PersistedPivotState, 'parts' | 'scroll'> | null;
     constructor(gridId: string, initialFields: PivotField<TRow>[], persistence?: PivotStatePersistence);
     getSnapshot: () => PivotControllerState<TRow>;
     subscribe: (listener: PivotStateListener) => (() => void);
@@ -2402,6 +2457,14 @@ declare class PivotStateStore<TRow> {
     setImportStatus(importStatus: PivotImportStatus): void;
     setImportPreview(importPreview: PivotControllerState<TRow>['importPreview']): void;
     private createInitialSnapshot;
+    /** A stored state as snapshot parts, or null when this build cannot read it. */
+    private revive;
+    /** Apply a stored state; its parts and scroll are returned for the controller. Null when it cannot be read. */
+    applyPersisted(state: unknown): Pick<PersistedPivotState, 'parts' | 'scroll'> | null;
+    /** The state as it is stored: JSON-safe, versioned. `include` adds session parts. */
+    serialize(include?: readonly PivotStateSession[]): PersistedPivotState;
+    /** Something saved with the state changed outside the store (a part, the scroll). */
+    requestPersist(): void;
     private schedulePersist;
     /**
      * Write a pending save NOW. The controller calls it on dispose: the write
@@ -2432,6 +2495,11 @@ interface PivotControllerEvents<TRow> {
     chartOpened: PivotChartOpenedEvent;
     chartChanged: PivotChartChangedEvent;
     chartClosed: PivotChartClosedEvent;
+    /** A restored state asks the renderer to scroll its body here (see `getPersistedState`). */
+    scrollRequested: {
+        top: number;
+        left: number;
+    };
 }
 interface PivotImportLabels {
     initializing: string;
@@ -2469,6 +2537,8 @@ declare class PivotController<TRow> {
     /** Full row set of a parsed import awaiting preview commit (kept out of observable state). */
     private pendingImportRows;
     private disposed;
+    /** The body's scroll offsets, as the renderer last reported them. */
+    private lastScroll;
     /** `applyTransactionAsync`: the batch waiting for its window, and who to tell. */
     private asyncQueue;
     private asyncCallbacks;
@@ -2481,6 +2551,36 @@ declare class PivotController<TRow> {
      */
     private externalData;
     constructor(options: PivotControllerOptions<TRow>);
+    /**
+     * Everything the reader arranged, as plain JSON — fields and their areas,
+     * order, sorting, filters, summaries and calculated fields; totals, layout
+     * options and the chart type; open members; column widths — with a
+     * `version`. What `stateStoring` saves; keep it anywhere and hand it back to
+     * `applyPersistedState`.
+     */
+    getPersistedState(options?: {
+        include?: readonly 'scroll'[];
+    }): PersistedPivotState;
+    /**
+     * Where the renderer's body is scrolled — both renderers report it, so a
+     * snapshot with `include: ['scroll']` can carry it.
+     */
+    reportScroll(top: number, left: number): void;
+    /**
+     * A part registered with `registerReportStatePart` changed: save it with the
+     * state (`stateStoring`). The Enterprise chart panel's changes do this by
+     * themselves.
+     */
+    notifyStatePartChanged(): void;
+    /** Hand a restored state's parts to their owners and ask for its scroll. */
+    private takeExtras;
+    /**
+     * Put a `getPersistedState` snapshot back. Fields the app no longer has are
+     * dropped (calculated fields the reader made stay); fields the app added
+     * since join as it defines them. Returns false and changes nothing when the
+     * snapshot cannot be read — another `version`, or not a state at all.
+     */
+    applyPersistedState(state: unknown): boolean;
     subscribe: (listener: PivotStateListener) => (() => void);
     getSnapshot: () => PivotControllerState<TRow>;
     getState(): PivotControllerState<TRow>;
@@ -2705,6 +2805,9 @@ declare class PivotController<TRow> {
     private collectNodePaths;
 }
 
+/** Wire `root`'s body scroller to `controller`. Returns the unbind function. */
+declare function bindPivotScrollMemory(root: HTMLElement, controller: PivotController<any>): () => void;
+
 interface PivotEngineServiceConfig<TRow> {
     getOptions: () => PivotControllerOptions<TRow>;
     getState: () => PivotControllerState<TRow>;
@@ -3675,4 +3778,4 @@ declare function rollupInMemory<TRow>(rows: readonly TRow[], request: PivotServe
 /** Every value of a field in rows held in memory — the reference `loadFieldValues`. */
 declare function fieldValuesInMemory<TRow>(rows: readonly TRow[], field: PivotServerField): unknown[];
 
-export { type AdvancedExportRequest, type AdvancedExporter, CHART_LEGEND_POSITIONS, CHART_PALETTE_NAMES, type CalculatedFieldTextKey, type CellClickEvent, type CellPreparedEvent, type CellType, type ChartCategoryKeyAction, type ChartFont, type ChartFormat, type ChartGridLines, type ChartImageRequest, type ChartKeyTextKey, type ChartLabelAngle, type ChartLegendPosition, type ChartMark, type ChartPaletteName, type ChartStacking, type ChartStyle, type ChartStyleDefaults, type ColHeaderCell, type ColumnSlot, type ColumnSlotOptions, type ConditionalVisual, type CsvParseProgress, CsvReader, type CustomSummaryOptions, DEFAULT_DATA_COLUMN_WIDTH, DEFAULT_ROW_HEADER_WIDTH, DataNormalizer, type DateFormatContext, DateFormatter, type DateGranularity, type DimensionFieldInfo, type DrillDownTextKey, type DropIntent, type ExportFormat, type ExportOptions, ExportStreamController, type ExportingEvent, FastTrie, type FieldDistinctEntry, type FieldMoveEvent, type FilterCondition, type FilterGroup, type FilterOperator, type FlatCellMatrix, FlatPivotEngine, type FlatRow, type FloatingFrame, type FrameRect, type FrameSize, type FunnelStage, type HeaderFilterOption, type HeaderFilterState, type HeaderFilterWrite, type HistogramBin, type IFileReader, type ImportFormat, ImportManager, type ImportManagerOptions, type ImportProgress, type ImportResult, type ImportSnapshot, ImportStreamController, type ImportWorkerKind, type ImportWorkerResult, MAX_C, type MarkTone, PIVOT_AI_FEATURES, type ParseFileOptions, type PivotAiApplyResult, type PivotAiCondition, type PivotAiFeature, type PivotAiFieldOptions, type PivotAiFilter, type PivotAiOptions, type PivotAiSort, type PivotAiState, type PivotAiTotals, type PivotAiValue, type PivotArea, type PivotCell, PivotCellAggregator, type PivotCellTemplate, type PivotCellTextAccessor, type PivotCellValueAccessor, type PivotChartChange, type PivotChartChangedEvent, type PivotChartClosedEvent, type PivotChartOpenedEvent, type PivotChartReportPart, type PivotChartState, type PivotChartWindowState, type PivotColumnWidthDefaults, type PivotConditionRule, PivotController, type PivotControllerCallbacks, type PivotControllerEvents, type PivotControllerOptions, type PivotControllerState, type PivotDataSource, type PivotDensity, type PivotDictionary, type PivotDragIntentState, PivotEngineRegistry, type PivotEngineResult, PivotEngineService, type PivotEngineServiceConfig, PivotEventEmitter, type PivotEventHandler, type PivotEventMap, PivotExportService, type PivotField, PivotFieldService, type PivotGridRef, type PivotGroupInterval, type PivotImportField, type PivotImportLabels, type PivotImportPreviewState, type PivotImportStatus, type PivotLabelFilter, type PivotLayoutProfile, type PivotLayoutState, type PivotLocale, type PivotNode, type PivotPlugin, type PivotPrefilter, type PivotReport, PivotReportManager, PivotReportService, type PivotReportState, type PivotRowKey, type PivotRowKeyResolver, type PivotRowSparkline, type PivotRowTransaction, type PivotSelectionMode, PivotSelectionModel, type PivotSelectionRange, type PivotSelectionState, type PivotSelectionStats, type PivotServerCell, type PivotServerField, type PivotServerInput, type PivotServerRequest, type PivotServerResponse, type PivotServerSource, type PivotServerSourceOptions, type PivotServerValue, type PivotStateListener, PivotStateStore, type PivotStateStoringConfig, type PivotSummaryDisplayMode, type PivotSummaryType, type PivotTheme, type PivotToolbarConfig, type PivotTransactionResult, type PivotValue, type PivotValueFilter, type PrefilterConditionSpec, type PrefilterGroupSpec, type ProcessFileStreamingOptions, type ProcessFromUrlOptions, ROW_HEADER_MAX_PINNED_FRACTION, ROW_HEADER_MIN_COL_WIDTH, ROW_HEADER_MIN_DATA_STRIP, type ReportStatePart, type RowHeaderLayout, SHAPE_CHART_TYPES, type ShapeChartInput, type ShapeChartType, type StackedSegment, type TreemapCell, type TrendShape, type ValidationResult, type ValueRange, type WaterfallStep, type WorkerComputeRequest, type WorkerFilterRequest, type WorkerFilterSpec, type WorkerInitRequest, type WorkerResponse, type WorkerTransactionRequest, type XYPair, type XYPairInput, XmlReader, applyPivotAiState, ar, attachFloatingFrame, buildCellLookup, buildColPathsList, buildColumnHeaders, buildEngineResult, buildPivotAOA, buildRowLabelCells, calculatedFieldText, cellHash, cellHashCol, cellHashRow, centredFrame, chartCategoryKey, chartKeyText, chartPalette, chartWindowFrame, classifyValue, clearFormatCache, coerceRecords, coerceValue, collatorFor, compileSafeFormula, computeFieldRanges, computePivotMatrixAsync, computeRowHeaderWidths, conditionRuleToExcelStyle, cssColorToRgb, de, dedupeHeaders, defaultPivotLayout, destroyEngineWorker, detectDelimiter, diffPivotChartState, drillDownText, en, es, escapeXmlText, executePostAggregationPhase, executeSummaryDisplayModesPhase, exportPivotData, extractGroupValue, fieldNeedsRange, fieldValuesInMemory, filterEmptySummaryTree, filterPivotEngineAsync, filterRecords, filterRecordsAsync, flattenExportRows, flattenRowTree, flattenRowTreeTabular, flattenRowTreeTree, formatCellValue, formatCellValueCached, formatDimensionValue, formatHeaderValue, fr, funnelMarks, funnelStages, getAdvancedExporter, getCellVal, getFieldDistinctValues, getPivotAiSchema, getPivotAiState, getVisibleColLeaves, getVisibleColSlots, getVisibleLeafCount, getVisibleMaxDepth, headerFilterShown, headerFilterWrite, heatColor, heatTextColor, heatmapMarks, histogramBins, histogramMarks, inferColumnType, initPivotEngineAsync, intlFormatToExcelNumFmt, invertRowHeaderWidth, it, ja, ko, logAxisTicks, nextChartWindowId, nextLiveText, pairSeriesForXY, parseBoolean, parseColor, parseCsvToRows, parseDelimited, parseFlexibleDate, parseLocaleNumber, percentAxisTicks, percentModeExcelNumFmt, percentModeText, pivotChangeAnnouncement, pivotDensityClass, pivotRowHeight, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readFrameRect, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, resolveChartPalette, resolveChartStyle, resolveColPath, resolveColumnWidthDefaults, resolveConditionalVisual, rollupInMemory, ru, safeKey, sanitizeRows, scaleColor, serverRequestFor, setActiveEngineGrid, sortPivotTree, squarify, stackSeries, stripBom, sunburstMarks, testSafeFormula, tr, treemapMarks, trendColumnPaths, trendShape, waterfallDomain, waterfallMarks, waterfallSteps, windowStartFor, zhCN };
+export { type AdvancedExportRequest, type AdvancedExporter, CHART_LEGEND_POSITIONS, CHART_PALETTE_NAMES, type CalculatedFieldTextKey, type CellClickEvent, type CellPreparedEvent, type CellType, type ChartCategoryKeyAction, type ChartFont, type ChartFormat, type ChartGridLines, type ChartImageRequest, type ChartKeyTextKey, type ChartLabelAngle, type ChartLegendPosition, type ChartMark, type ChartPaletteName, type ChartStacking, type ChartStyle, type ChartStyleDefaults, type ColHeaderCell, type ColumnSlot, type ColumnSlotOptions, type ConditionalVisual, type CsvParseProgress, CsvReader, type CustomSummaryOptions, DEFAULT_DATA_COLUMN_WIDTH, DEFAULT_ROW_HEADER_WIDTH, DataNormalizer, type DateFormatContext, DateFormatter, type DateGranularity, type DimensionFieldInfo, type DrillDownTextKey, type DropIntent, type ExportFormat, type ExportOptions, ExportStreamController, type ExportingEvent, FastTrie, type FieldDistinctEntry, type FieldMoveEvent, type FilterCondition, type FilterGroup, type FilterOperator, type FlatCellMatrix, FlatPivotEngine, type FlatRow, type FloatingFrame, type FrameRect, type FrameSize, type FunnelStage, type HeaderFilterOption, type HeaderFilterState, type HeaderFilterWrite, type HistogramBin, type IFileReader, type ImportFormat, ImportManager, type ImportManagerOptions, type ImportProgress, type ImportResult, type ImportSnapshot, ImportStreamController, type ImportWorkerKind, type ImportWorkerResult, MAX_C, type MarkTone, PIVOT_AI_FEATURES, PIVOT_STATE_VERSION, type ParseFileOptions, type PersistedPivotState, type PivotAiApplyResult, type PivotAiCondition, type PivotAiFeature, type PivotAiFieldOptions, type PivotAiFilter, type PivotAiOptions, type PivotAiSort, type PivotAiState, type PivotAiTotals, type PivotAiValue, type PivotArea, type PivotCell, PivotCellAggregator, type PivotCellTemplate, type PivotCellTextAccessor, type PivotCellValueAccessor, type PivotChartChange, type PivotChartChangedEvent, type PivotChartClosedEvent, type PivotChartOpenedEvent, type PivotChartReportPart, type PivotChartState, type PivotChartWindowState, type PivotColumnWidthDefaults, type PivotConditionRule, PivotController, type PivotControllerCallbacks, type PivotControllerEvents, type PivotControllerOptions, type PivotControllerState, type PivotDataSource, type PivotDensity, type PivotDictionary, type PivotDragIntentState, PivotEngineRegistry, type PivotEngineResult, PivotEngineService, type PivotEngineServiceConfig, PivotEventEmitter, type PivotEventHandler, type PivotEventMap, PivotExportService, type PivotField, PivotFieldService, type PivotGridRef, type PivotGroupInterval, type PivotImportField, type PivotImportLabels, type PivotImportPreviewState, type PivotImportStatus, type PivotLabelFilter, type PivotLayoutProfile, type PivotLayoutState, type PivotLocale, type PivotNode, type PivotPlugin, type PivotPrefilter, type PivotReport, PivotReportManager, PivotReportService, type PivotReportState, type PivotRowKey, type PivotRowKeyResolver, type PivotRowSparkline, type PivotRowTransaction, type PivotSelectionMode, PivotSelectionModel, type PivotSelectionRange, type PivotSelectionState, type PivotSelectionStats, type PivotServerCell, type PivotServerField, type PivotServerInput, type PivotServerRequest, type PivotServerResponse, type PivotServerSource, type PivotServerSourceOptions, type PivotServerValue, type PivotStateListener, type PivotStateSession, PivotStateStore, type PivotStateStoringConfig, type PivotSummaryDisplayMode, type PivotSummaryType, type PivotTheme, type PivotToolbarConfig, type PivotTransactionResult, type PivotValue, type PivotValueFilter, type PrefilterConditionSpec, type PrefilterGroupSpec, type ProcessFileStreamingOptions, type ProcessFromUrlOptions, ROW_HEADER_MAX_PINNED_FRACTION, ROW_HEADER_MIN_COL_WIDTH, ROW_HEADER_MIN_DATA_STRIP, type ReportStatePart, type RowHeaderLayout, SHAPE_CHART_TYPES, type ShapeChartInput, type ShapeChartType, type StackedSegment, type TreemapCell, type TrendShape, type ValidationResult, type ValueRange, type WaterfallStep, type WorkerComputeRequest, type WorkerFilterRequest, type WorkerFilterSpec, type WorkerInitRequest, type WorkerResponse, type WorkerTransactionRequest, type XYPair, type XYPairInput, XmlReader, applyPivotAiState, ar, attachFloatingFrame, bindPivotScrollMemory, buildCellLookup, buildColPathsList, buildColumnHeaders, buildEngineResult, buildPivotAOA, buildRowLabelCells, calculatedFieldText, cellHash, cellHashCol, cellHashRow, centredFrame, chartCategoryKey, chartKeyText, chartPalette, chartWindowFrame, classifyValue, clearFormatCache, coerceRecords, coerceValue, collatorFor, compileSafeFormula, computeFieldRanges, computePivotMatrixAsync, computeRowHeaderWidths, conditionRuleToExcelStyle, cssColorToRgb, de, dedupeHeaders, defaultPivotLayout, destroyEngineWorker, detectDelimiter, diffPivotChartState, drillDownText, en, es, escapeXmlText, executePostAggregationPhase, executeSummaryDisplayModesPhase, exportPivotData, extractGroupValue, fieldNeedsRange, fieldValuesInMemory, filterEmptySummaryTree, filterPivotEngineAsync, filterRecords, filterRecordsAsync, flattenExportRows, flattenRowTree, flattenRowTreeTabular, flattenRowTreeTree, formatCellValue, formatCellValueCached, formatDimensionValue, formatHeaderValue, fr, funnelMarks, funnelStages, getAdvancedExporter, getCellVal, getFieldDistinctValues, getPivotAiSchema, getPivotAiState, getVisibleColLeaves, getVisibleColSlots, getVisibleLeafCount, getVisibleMaxDepth, headerFilterShown, headerFilterWrite, heatColor, heatTextColor, heatmapMarks, histogramBins, histogramMarks, inferColumnType, initPivotEngineAsync, intlFormatToExcelNumFmt, invertRowHeaderWidth, it, ja, ko, logAxisTicks, nextChartWindowId, nextLiveText, pairSeriesForXY, parseBoolean, parseColor, parseCsvToRows, parseDelimited, parseFlexibleDate, parseLocaleNumber, percentAxisTicks, percentModeExcelNumFmt, percentModeText, pivotChangeAnnouncement, pivotDensityClass, pivotRowHeight, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readFrameRect, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, resolveChartPalette, resolveChartStyle, resolveColPath, resolveColumnWidthDefaults, resolveConditionalVisual, rollupInMemory, ru, safeKey, sanitizeRows, scaleColor, serverRequestFor, setActiveEngineGrid, sortPivotTree, squarify, stackSeries, stripBom, sunburstMarks, testSafeFormula, tr, treemapMarks, trendColumnPaths, trendShape, waterfallDomain, waterfallMarks, waterfallSteps, windowStartFor, zhCN };

package/dist/index.d.ts

@@ -91,6 +91,7 @@ interface PivotDictionary {
     avg: string;
     min: string;
     max: string;
+    distinct: string;
     grandTotal: string;
     subTotal: string;
     absoluteValue: string;
@@ -146,20 +147,12 @@ interface PivotDictionary {
     opNotContains: string;
     opStartsWith: string;
     opEndsWith: string;
-    opIsBlank: string;
-    opIsNotBlank: string;
     /** Value filter `between` / `notBetween` (G-PIV-03); `opBetween` is the DataGrid's own string. */
     opBetween: string;
     opNotBetween: string;
     /** The field menu item and dialog title for value / label filters (G-PIV-03). */
     conditionFilter: string;
     /** Prefilter builder chrome (#210) — shared with DataGrid. */
-    builderCombine: string;
-    builderAddCondition: string;
-    builderAddGroup: string;
-    builderRemoveGroup: string;
-    builderRemoveCondition: string;
-    builderEmpty: string;
     builderValuePlaceholder: string;
     /** PDF export header (#215). */
     exportGeneratedOn: string;
@@ -1612,7 +1605,11 @@ declare function resolveConditionalVisual(value: number | undefined, field: Pivo
 type ExportFormat = 'excel-list' | 'excel-pivot' | 'pdf' | 'json' | 'json-pivot' | 'json-snapshot' | 'xml' | 'csv' | 'print' | 'clipboard';
 /** Options passed to the export pipeline — all fields optional for backward compat. */
 interface ExportOptions {
-    /** Apply prefilter to raw data before export. */
+    /**
+     * Export only the rows the filters keep (field filters and the prefilter).
+     * Default `true`; `false` writes every source row. Before 2026-10-15 the
+     * default was `false`.
+     */
     applyFilters?: boolean;
     /** Custom file name (without extension). */
     fileName?: string;
@@ -1969,8 +1966,21 @@ interface PivotStateStoringConfig {
     enabled: boolean;
     type?: 'localStorage' | 'sessionStorage' | 'custom';
     storageKey?: string;
+    /** `custom`: called (debounced) with the state to keep — the shape `getPersistedState` returns. */
     onSave?: (state: any) => void;
+    /**
+     * `custom`: the stored state, or a Promise of it (IndexedDB, a server). A
+     * Promise is applied when it resolves; nothing is saved until then, so the
+     * default layout the grid starts on never overwrites the stored one. To
+     * open on the stored layout with no visible switch, read it before mounting
+     * and return it synchronously.
+     */
     onLoad?: () => any;
+    /**
+     * Session state to keep as well — none by default. `'scroll'`: where the
+     * body was scrolled, put back once the restored pivot is drawn.
+     */
+    include?: readonly 'scroll'[];
 }
 interface PivotToolbarConfig {
     showSaveReport?: boolean;
@@ -2371,16 +2381,40 @@ type PivotStateListener = () => void;
  * documented on the features page as "persist to your own backend" was a hook
  * that nothing ever called.
  */
-/** What actually goes in and out of storage. */
+/**
+ * The version of `PersistedPivotState`. A saved state carrying another one is
+ * not read — the grid opens with its default layout, no error. A state saved
+ * before versions existed has none and is read as version 1.
+ */
+declare const PIVOT_STATE_VERSION = 1;
+/**
+ * What goes in and out of storage — and what `getPersistedState` returns and
+ * `applyPersistedState` takes. Plain JSON: store it anywhere.
+ */
 interface PersistedPivotState {
+    version?: number;
     fields?: unknown[];
     layout?: Partial<PivotLayoutState>;
     columnWidths?: Record<string, number>;
     expandedPaths?: string[];
     expandedColPaths?: string[];
+    /**
+     * State kept by layers above the core, by name (`registerReportStatePart`):
+     * the Enterprise chart panel keeps its chart under `chart`, and an app can
+     * register its own chart or panel the same way.
+     */
+    parts?: Record<string, unknown>;
+    /** SESSION state, only when asked for (`include: ['scroll']`): the body's scroll offsets. */
+    scroll?: {
+        top: number;
+        left: number;
+    };
 }
+/** Session parts a snapshot leaves out unless asked: `'scroll'`. */
+type PivotStateSession = 'scroll';
 interface PivotStatePersistence {
-    load(): PersistedPivotState | null;
+    /** May be a Promise (IndexedDB, a server); the grid applies it when it resolves. */
+    load(): PersistedPivotState | null | Promise<PersistedPivotState | null>;
     save(state: PersistedPivotState): void;
 }
 /** Immutable-snapshot state store with debounced persistence. */
@@ -2390,6 +2424,27 @@ declare class PivotStateStore<TRow> {
     private storageKey;
     private persistScheduled;
     private persistence;
+    /**
+     * The stored state, while an asynchronous `onLoad` is still reading it. No
+     * save happens meanwhile: the grid starts on its default layout, and writing
+     * that would overwrite the very state being loaded.
+     */
+    pendingLoad: Promise<PersistedPivotState | null> | null;
+    private readonly initialFields;
+    /**
+     * What lives outside the store but is saved with it — the controller's
+     * registered parts and the reported scroll. Set by the controller.
+     */
+    extras: {
+        parts?: () => Record<string, unknown> | undefined;
+        scroll?: () => {
+            top: number;
+            left: number;
+        };
+        include?: readonly PivotStateSession[];
+    };
+    /** Parts and scroll read at construction, for the controller to hand on. */
+    loadedExtras: Pick<PersistedPivotState, 'parts' | 'scroll'> | null;
     constructor(gridId: string, initialFields: PivotField<TRow>[], persistence?: PivotStatePersistence);
     getSnapshot: () => PivotControllerState<TRow>;
     subscribe: (listener: PivotStateListener) => (() => void);
@@ -2402,6 +2457,14 @@ declare class PivotStateStore<TRow> {
     setImportStatus(importStatus: PivotImportStatus): void;
     setImportPreview(importPreview: PivotControllerState<TRow>['importPreview']): void;
     private createInitialSnapshot;
+    /** A stored state as snapshot parts, or null when this build cannot read it. */
+    private revive;
+    /** Apply a stored state; its parts and scroll are returned for the controller. Null when it cannot be read. */
+    applyPersisted(state: unknown): Pick<PersistedPivotState, 'parts' | 'scroll'> | null;
+    /** The state as it is stored: JSON-safe, versioned. `include` adds session parts. */
+    serialize(include?: readonly PivotStateSession[]): PersistedPivotState;
+    /** Something saved with the state changed outside the store (a part, the scroll). */
+    requestPersist(): void;
     private schedulePersist;
     /**
      * Write a pending save NOW. The controller calls it on dispose: the write
@@ -2432,6 +2495,11 @@ interface PivotControllerEvents<TRow> {
     chartOpened: PivotChartOpenedEvent;
     chartChanged: PivotChartChangedEvent;
     chartClosed: PivotChartClosedEvent;
+    /** A restored state asks the renderer to scroll its body here (see `getPersistedState`). */
+    scrollRequested: {
+        top: number;
+        left: number;
+    };
 }
 interface PivotImportLabels {
     initializing: string;
@@ -2469,6 +2537,8 @@ declare class PivotController<TRow> {
     /** Full row set of a parsed import awaiting preview commit (kept out of observable state). */
     private pendingImportRows;
     private disposed;
+    /** The body's scroll offsets, as the renderer last reported them. */
+    private lastScroll;
     /** `applyTransactionAsync`: the batch waiting for its window, and who to tell. */
     private asyncQueue;
     private asyncCallbacks;
@@ -2481,6 +2551,36 @@ declare class PivotController<TRow> {
      */
     private externalData;
     constructor(options: PivotControllerOptions<TRow>);
+    /**
+     * Everything the reader arranged, as plain JSON — fields and their areas,
+     * order, sorting, filters, summaries and calculated fields; totals, layout
+     * options and the chart type; open members; column widths — with a
+     * `version`. What `stateStoring` saves; keep it anywhere and hand it back to
+     * `applyPersistedState`.
+     */
+    getPersistedState(options?: {
+        include?: readonly 'scroll'[];
+    }): PersistedPivotState;
+    /**
+     * Where the renderer's body is scrolled — both renderers report it, so a
+     * snapshot with `include: ['scroll']` can carry it.
+     */
+    reportScroll(top: number, left: number): void;
+    /**
+     * A part registered with `registerReportStatePart` changed: save it with the
+     * state (`stateStoring`). The Enterprise chart panel's changes do this by
+     * themselves.
+     */
+    notifyStatePartChanged(): void;
+    /** Hand a restored state's parts to their owners and ask for its scroll. */
+    private takeExtras;
+    /**
+     * Put a `getPersistedState` snapshot back. Fields the app no longer has are
+     * dropped (calculated fields the reader made stay); fields the app added
+     * since join as it defines them. Returns false and changes nothing when the
+     * snapshot cannot be read — another `version`, or not a state at all.
+     */
+    applyPersistedState(state: unknown): boolean;
     subscribe: (listener: PivotStateListener) => (() => void);
     getSnapshot: () => PivotControllerState<TRow>;
     getState(): PivotControllerState<TRow>;
@@ -2705,6 +2805,9 @@ declare class PivotController<TRow> {
     private collectNodePaths;
 }
 
+/** Wire `root`'s body scroller to `controller`. Returns the unbind function. */
+declare function bindPivotScrollMemory(root: HTMLElement, controller: PivotController<any>): () => void;
+
 interface PivotEngineServiceConfig<TRow> {
     getOptions: () => PivotControllerOptions<TRow>;
     getState: () => PivotControllerState<TRow>;
@@ -3675,4 +3778,4 @@ declare function rollupInMemory<TRow>(rows: readonly TRow[], request: PivotServe
 /** Every value of a field in rows held in memory — the reference `loadFieldValues`. */
 declare function fieldValuesInMemory<TRow>(rows: readonly TRow[], field: PivotServerField): unknown[];
 
-export { type AdvancedExportRequest, type AdvancedExporter, CHART_LEGEND_POSITIONS, CHART_PALETTE_NAMES, type CalculatedFieldTextKey, type CellClickEvent, type CellPreparedEvent, type CellType, type ChartCategoryKeyAction, type ChartFont, type ChartFormat, type ChartGridLines, type ChartImageRequest, type ChartKeyTextKey, type ChartLabelAngle, type ChartLegendPosition, type ChartMark, type ChartPaletteName, type ChartStacking, type ChartStyle, type ChartStyleDefaults, type ColHeaderCell, type ColumnSlot, type ColumnSlotOptions, type ConditionalVisual, type CsvParseProgress, CsvReader, type CustomSummaryOptions, DEFAULT_DATA_COLUMN_WIDTH, DEFAULT_ROW_HEADER_WIDTH, DataNormalizer, type DateFormatContext, DateFormatter, type DateGranularity, type DimensionFieldInfo, type DrillDownTextKey, type DropIntent, type ExportFormat, type ExportOptions, ExportStreamController, type ExportingEvent, FastTrie, type FieldDistinctEntry, type FieldMoveEvent, type FilterCondition, type FilterGroup, type FilterOperator, type FlatCellMatrix, FlatPivotEngine, type FlatRow, type FloatingFrame, type FrameRect, type FrameSize, type FunnelStage, type HeaderFilterOption, type HeaderFilterState, type HeaderFilterWrite, type HistogramBin, type IFileReader, type ImportFormat, ImportManager, type ImportManagerOptions, type ImportProgress, type ImportResult, type ImportSnapshot, ImportStreamController, type ImportWorkerKind, type ImportWorkerResult, MAX_C, type MarkTone, PIVOT_AI_FEATURES, type ParseFileOptions, type PivotAiApplyResult, type PivotAiCondition, type PivotAiFeature, type PivotAiFieldOptions, type PivotAiFilter, type PivotAiOptions, type PivotAiSort, type PivotAiState, type PivotAiTotals, type PivotAiValue, type PivotArea, type PivotCell, PivotCellAggregator, type PivotCellTemplate, type PivotCellTextAccessor, type PivotCellValueAccessor, type PivotChartChange, type PivotChartChangedEvent, type PivotChartClosedEvent, type PivotChartOpenedEvent, type PivotChartReportPart, type PivotChartState, type PivotChartWindowState, type PivotColumnWidthDefaults, type PivotConditionRule, PivotController, type PivotControllerCallbacks, type PivotControllerEvents, type PivotControllerOptions, type PivotControllerState, type PivotDataSource, type PivotDensity, type PivotDictionary, type PivotDragIntentState, PivotEngineRegistry, type PivotEngineResult, PivotEngineService, type PivotEngineServiceConfig, PivotEventEmitter, type PivotEventHandler, type PivotEventMap, PivotExportService, type PivotField, PivotFieldService, type PivotGridRef, type PivotGroupInterval, type PivotImportField, type PivotImportLabels, type PivotImportPreviewState, type PivotImportStatus, type PivotLabelFilter, type PivotLayoutProfile, type PivotLayoutState, type PivotLocale, type PivotNode, type PivotPlugin, type PivotPrefilter, type PivotReport, PivotReportManager, PivotReportService, type PivotReportState, type PivotRowKey, type PivotRowKeyResolver, type PivotRowSparkline, type PivotRowTransaction, type PivotSelectionMode, PivotSelectionModel, type PivotSelectionRange, type PivotSelectionState, type PivotSelectionStats, type PivotServerCell, type PivotServerField, type PivotServerInput, type PivotServerRequest, type PivotServerResponse, type PivotServerSource, type PivotServerSourceOptions, type PivotServerValue, type PivotStateListener, PivotStateStore, type PivotStateStoringConfig, type PivotSummaryDisplayMode, type PivotSummaryType, type PivotTheme, type PivotToolbarConfig, type PivotTransactionResult, type PivotValue, type PivotValueFilter, type PrefilterConditionSpec, type PrefilterGroupSpec, type ProcessFileStreamingOptions, type ProcessFromUrlOptions, ROW_HEADER_MAX_PINNED_FRACTION, ROW_HEADER_MIN_COL_WIDTH, ROW_HEADER_MIN_DATA_STRIP, type ReportStatePart, type RowHeaderLayout, SHAPE_CHART_TYPES, type ShapeChartInput, type ShapeChartType, type StackedSegment, type TreemapCell, type TrendShape, type ValidationResult, type ValueRange, type WaterfallStep, type WorkerComputeRequest, type WorkerFilterRequest, type WorkerFilterSpec, type WorkerInitRequest, type WorkerResponse, type WorkerTransactionRequest, type XYPair, type XYPairInput, XmlReader, applyPivotAiState, ar, attachFloatingFrame, buildCellLookup, buildColPathsList, buildColumnHeaders, buildEngineResult, buildPivotAOA, buildRowLabelCells, calculatedFieldText, cellHash, cellHashCol, cellHashRow, centredFrame, chartCategoryKey, chartKeyText, chartPalette, chartWindowFrame, classifyValue, clearFormatCache, coerceRecords, coerceValue, collatorFor, compileSafeFormula, computeFieldRanges, computePivotMatrixAsync, computeRowHeaderWidths, conditionRuleToExcelStyle, cssColorToRgb, de, dedupeHeaders, defaultPivotLayout, destroyEngineWorker, detectDelimiter, diffPivotChartState, drillDownText, en, es, escapeXmlText, executePostAggregationPhase, executeSummaryDisplayModesPhase, exportPivotData, extractGroupValue, fieldNeedsRange, fieldValuesInMemory, filterEmptySummaryTree, filterPivotEngineAsync, filterRecords, filterRecordsAsync, flattenExportRows, flattenRowTree, flattenRowTreeTabular, flattenRowTreeTree, formatCellValue, formatCellValueCached, formatDimensionValue, formatHeaderValue, fr, funnelMarks, funnelStages, getAdvancedExporter, getCellVal, getFieldDistinctValues, getPivotAiSchema, getPivotAiState, getVisibleColLeaves, getVisibleColSlots, getVisibleLeafCount, getVisibleMaxDepth, headerFilterShown, headerFilterWrite, heatColor, heatTextColor, heatmapMarks, histogramBins, histogramMarks, inferColumnType, initPivotEngineAsync, intlFormatToExcelNumFmt, invertRowHeaderWidth, it, ja, ko, logAxisTicks, nextChartWindowId, nextLiveText, pairSeriesForXY, parseBoolean, parseColor, parseCsvToRows, parseDelimited, parseFlexibleDate, parseLocaleNumber, percentAxisTicks, percentModeExcelNumFmt, percentModeText, pivotChangeAnnouncement, pivotDensityClass, pivotRowHeight, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readFrameRect, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, resolveChartPalette, resolveChartStyle, resolveColPath, resolveColumnWidthDefaults, resolveConditionalVisual, rollupInMemory, ru, safeKey, sanitizeRows, scaleColor, serverRequestFor, setActiveEngineGrid, sortPivotTree, squarify, stackSeries, stripBom, sunburstMarks, testSafeFormula, tr, treemapMarks, trendColumnPaths, trendShape, waterfallDomain, waterfallMarks, waterfallSteps, windowStartFor, zhCN };
+export { type AdvancedExportRequest, type AdvancedExporter, CHART_LEGEND_POSITIONS, CHART_PALETTE_NAMES, type CalculatedFieldTextKey, type CellClickEvent, type CellPreparedEvent, type CellType, type ChartCategoryKeyAction, type ChartFont, type ChartFormat, type ChartGridLines, type ChartImageRequest, type ChartKeyTextKey, type ChartLabelAngle, type ChartLegendPosition, type ChartMark, type ChartPaletteName, type ChartStacking, type ChartStyle, type ChartStyleDefaults, type ColHeaderCell, type ColumnSlot, type ColumnSlotOptions, type ConditionalVisual, type CsvParseProgress, CsvReader, type CustomSummaryOptions, DEFAULT_DATA_COLUMN_WIDTH, DEFAULT_ROW_HEADER_WIDTH, DataNormalizer, type DateFormatContext, DateFormatter, type DateGranularity, type DimensionFieldInfo, type DrillDownTextKey, type DropIntent, type ExportFormat, type ExportOptions, ExportStreamController, type ExportingEvent, FastTrie, type FieldDistinctEntry, type FieldMoveEvent, type FilterCondition, type FilterGroup, type FilterOperator, type FlatCellMatrix, FlatPivotEngine, type FlatRow, type FloatingFrame, type FrameRect, type FrameSize, type FunnelStage, type HeaderFilterOption, type HeaderFilterState, type HeaderFilterWrite, type HistogramBin, type IFileReader, type ImportFormat, ImportManager, type ImportManagerOptions, type ImportProgress, type ImportResult, type ImportSnapshot, ImportStreamController, type ImportWorkerKind, type ImportWorkerResult, MAX_C, type MarkTone, PIVOT_AI_FEATURES, PIVOT_STATE_VERSION, type ParseFileOptions, type PersistedPivotState, type PivotAiApplyResult, type PivotAiCondition, type PivotAiFeature, type PivotAiFieldOptions, type PivotAiFilter, type PivotAiOptions, type PivotAiSort, type PivotAiState, type PivotAiTotals, type PivotAiValue, type PivotArea, type PivotCell, PivotCellAggregator, type PivotCellTemplate, type PivotCellTextAccessor, type PivotCellValueAccessor, type PivotChartChange, type PivotChartChangedEvent, type PivotChartClosedEvent, type PivotChartOpenedEvent, type PivotChartReportPart, type PivotChartState, type PivotChartWindowState, type PivotColumnWidthDefaults, type PivotConditionRule, PivotController, type PivotControllerCallbacks, type PivotControllerEvents, type PivotControllerOptions, type PivotControllerState, type PivotDataSource, type PivotDensity, type PivotDictionary, type PivotDragIntentState, PivotEngineRegistry, type PivotEngineResult, PivotEngineService, type PivotEngineServiceConfig, PivotEventEmitter, type PivotEventHandler, type PivotEventMap, PivotExportService, type PivotField, PivotFieldService, type PivotGridRef, type PivotGroupInterval, type PivotImportField, type PivotImportLabels, type PivotImportPreviewState, type PivotImportStatus, type PivotLabelFilter, type PivotLayoutProfile, type PivotLayoutState, type PivotLocale, type PivotNode, type PivotPlugin, type PivotPrefilter, type PivotReport, PivotReportManager, PivotReportService, type PivotReportState, type PivotRowKey, type PivotRowKeyResolver, type PivotRowSparkline, type PivotRowTransaction, type PivotSelectionMode, PivotSelectionModel, type PivotSelectionRange, type PivotSelectionState, type PivotSelectionStats, type PivotServerCell, type PivotServerField, type PivotServerInput, type PivotServerRequest, type PivotServerResponse, type PivotServerSource, type PivotServerSourceOptions, type PivotServerValue, type PivotStateListener, type PivotStateSession, PivotStateStore, type PivotStateStoringConfig, type PivotSummaryDisplayMode, type PivotSummaryType, type PivotTheme, type PivotToolbarConfig, type PivotTransactionResult, type PivotValue, type PivotValueFilter, type PrefilterConditionSpec, type PrefilterGroupSpec, type ProcessFileStreamingOptions, type ProcessFromUrlOptions, ROW_HEADER_MAX_PINNED_FRACTION, ROW_HEADER_MIN_COL_WIDTH, ROW_HEADER_MIN_DATA_STRIP, type ReportStatePart, type RowHeaderLayout, SHAPE_CHART_TYPES, type ShapeChartInput, type ShapeChartType, type StackedSegment, type TreemapCell, type TrendShape, type ValidationResult, type ValueRange, type WaterfallStep, type WorkerComputeRequest, type WorkerFilterRequest, type WorkerFilterSpec, type WorkerInitRequest, type WorkerResponse, type WorkerTransactionRequest, type XYPair, type XYPairInput, XmlReader, applyPivotAiState, ar, attachFloatingFrame, bindPivotScrollMemory, buildCellLookup, buildColPathsList, buildColumnHeaders, buildEngineResult, buildPivotAOA, buildRowLabelCells, calculatedFieldText, cellHash, cellHashCol, cellHashRow, centredFrame, chartCategoryKey, chartKeyText, chartPalette, chartWindowFrame, classifyValue, clearFormatCache, coerceRecords, coerceValue, collatorFor, compileSafeFormula, computeFieldRanges, computePivotMatrixAsync, computeRowHeaderWidths, conditionRuleToExcelStyle, cssColorToRgb, de, dedupeHeaders, defaultPivotLayout, destroyEngineWorker, detectDelimiter, diffPivotChartState, drillDownText, en, es, escapeXmlText, executePostAggregationPhase, executeSummaryDisplayModesPhase, exportPivotData, extractGroupValue, fieldNeedsRange, fieldValuesInMemory, filterEmptySummaryTree, filterPivotEngineAsync, filterRecords, filterRecordsAsync, flattenExportRows, flattenRowTree, flattenRowTreeTabular, flattenRowTreeTree, formatCellValue, formatCellValueCached, formatDimensionValue, formatHeaderValue, fr, funnelMarks, funnelStages, getAdvancedExporter, getCellVal, getFieldDistinctValues, getPivotAiSchema, getPivotAiState, getVisibleColLeaves, getVisibleColSlots, getVisibleLeafCount, getVisibleMaxDepth, headerFilterShown, headerFilterWrite, heatColor, heatTextColor, heatmapMarks, histogramBins, histogramMarks, inferColumnType, initPivotEngineAsync, intlFormatToExcelNumFmt, invertRowHeaderWidth, it, ja, ko, logAxisTicks, nextChartWindowId, nextLiveText, pairSeriesForXY, parseBoolean, parseColor, parseCsvToRows, parseDelimited, parseFlexibleDate, parseLocaleNumber, percentAxisTicks, percentModeExcelNumFmt, percentModeText, pivotChangeAnnouncement, pivotDensityClass, pivotRowHeight, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readFrameRect, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, resolveChartPalette, resolveChartStyle, resolveColPath, resolveColumnWidthDefaults, resolveConditionalVisual, rollupInMemory, ru, safeKey, sanitizeRows, scaleColor, serverRequestFor, setActiveEngineGrid, sortPivotTree, squarify, stackSeries, stripBom, sunburstMarks, testSafeFormula, tr, treemapMarks, trendColumnPaths, trendShape, waterfallDomain, waterfallMarks, waterfallSteps, windowStartFor, zhCN };