@kanunilabs/pivotgrid-core 1.7.2 → 1.8.0

package/dist/index.d.cts

@@ -61,6 +61,9 @@ interface PivotDictionary {
     columnFilter: string;
     percentOfColumnTotal: string;
     percentOfRowTotal: string;
+    /** Display modes with the same names (share of the parent group on that axis). */
+    percentOfParentRowTotal: string;
+    percentOfParentColumnTotal: string;
     percentDifference: string;
     filterField: string;
     removeFromArea: string;
@@ -96,18 +99,14 @@ interface PivotDictionary {
     year: string;
     quarter: string;
     month: string;
+    /** The ISO week date grouping (`groupInterval: 'week'`). */
+    week: string;
     day: string;
     and: string;
     or: string;
     noConditionsAdded: string;
     calculatedMeasureDesigner: string;
-    createFormulasWithoutCode: string;
-    measureName: string;
     format: string;
-    numericStandard: string;
-    numericDecimal: string;
-    currencyTRY: string;
-    currencyUSD: string;
     percent: string;
     expand: string;
     collapse: string;
@@ -147,6 +146,11 @@ interface PivotDictionary {
     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;
@@ -155,24 +159,8 @@ interface PivotDictionary {
     builderRemoveCondition: string;
     builderEmpty: string;
     builderValuePlaceholder: string;
-    /** Drill-down modal (#212); the pager/CSV five are shared with DataGrid. */
-    exportCsv: string;
-    pagerPage: string;
-    pagerOf: string;
-    pagerPrevious: string;
-    pagerNext: string;
-    drillDown: string;
-    /** `Label: {count}` — no plural engine, so no locale is ever ungrammatical. */
-    drillDownRecords: string;
     /** PDF export header (#215). */
     exportGeneratedOn: string;
-    /** Designer level tiles and live formula verdict (#220). */
-    calcRowLevelHint: string;
-    calcSummaryLevelHint: string;
-    formulaValid: string;
-    calcFieldsHint: string;
-    /** `Uses: {fields}` — the captions the formula references. */
-    formulaUses: string;
     showFieldList: string;
     /**
      * License watermark reasons (1.3.0) — the badge shows the product name and
@@ -335,6 +323,23 @@ declare function stackSeries(series: ReadonlyArray<ArrayLike<number>>, mode: Exc
 
 /** Where the legend sits around the plot, or `'none'` to hide it. */
 type ChartLegendPosition = 'top' | 'bottom' | 'left' | 'right' | 'none';
+/**
+ * The chart's text — tick labels, axis titles, data labels, the legend. Every
+ * field left out keeps what the theme draws (rival analysis §E.3 #46).
+ */
+interface ChartFont {
+    family?: string;
+    /** Tick-label size in px (6–32); titles draw one larger, data labels one smaller. */
+    size?: number;
+    /** Any CSS colour. */
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+}
+/** Category-axis label angle: the chart's own rule, or a fixed one. */
+type ChartLabelAngle = 'auto' | 0 | 45 | 90;
+/** Grid lines behind the plot: one per value tick, plus one per category, or none. */
+type ChartGridLines = 'value' | 'both' | 'none';
 interface ChartFormat {
     /** Shown above the chart, and written into an exported image. */
     title?: string;
@@ -353,7 +358,32 @@ interface ChartFormat {
      * left out. It does not apply to a stacked layout, whose segments add up.
      */
     valueScale?: 'linear' | 'log';
+    /** Text styling (§E.3 #46). */
+    font?: ChartFont;
+    /** Category labels: `'auto'` (default — the chart's own slant) or 0, 45, 90 degrees (§E.3 #40). */
+    labelAngle?: ChartLabelAngle;
+    /** Default `'value'`. */
+    gridLines?: ChartGridLines;
+    /** Dashed grid lines (the default); `false` draws them solid. */
+    gridDashed?: boolean;
+    /** Series line width in px, 1–6 (default 2) — lines, area outlines, radar (§E.3 #41). */
+    lineWidth?: number;
+    /** Dashed series lines. Default `false`. */
+    lineDashed?: boolean;
+    /** Opacity of area, radar and bubble fills, 0.05–1. Default: the chart's own. */
+    fillOpacity?: number;
+    /**
+     * How a date axis grouped by calendar prints its categories (rival analysis,
+     * charts §E.1 #21): a preset, written in the reader's language by the
+     * browser. Absent: the grouping's own labels ("2026-03", "2026-Q1").
+     */
+    dateFormat?: ChartDateFormat;
 }
+/**
+ * The date presets an axis offers. Each is an `Intl.DateTimeFormat` shape, so
+ * month and day names come out in the chart's locale with nothing to translate.
+ */
+type ChartDateFormat = 'iso' | 'numeric' | 'dayMonth' | 'dayMonthYear' | 'long' | 'weekday' | 'month' | 'monthYear' | 'monthYearLong' | 'monthNumeric' | 'year';
 /**
  * Value-axis ticks for a log scale: every power of ten from just below `min`
  * to just above `max` (both > 0). With fewer than two decades the 2 and 5
@@ -600,12 +630,177 @@ interface SunburstInput {
  * what is that made". Zero, negative and missing leaves take no angle.
  */
 declare function sunburstMarks(input: SunburstInput): ChartMark[];
+/** One bar of a histogram: the values from `from` up to (not including) `to` — the last bar includes `to`. */
+interface HistogramBin {
+    from: number;
+    to: number;
+    count: number;
+}
+/**
+ * `values` counted into bins of one round width — 1, 2 or 5 × 10ⁿ, the width
+ * that gives about `binCount` bins — so the edges read as 0, 500, 1,000
+ * rather than 0, 473.2, 946.4. The bins start at the multiple of that width at
+ * or below the smallest value; the last one closes on the largest. Values
+ * that are not finite numbers (blanks) are left out. Every value equal: one bin.
+ */
+declare function histogramBins(values: ArrayLike<number>, binCount?: number): HistogramBin[];
+/**
+ * The first series as a histogram — how many categories fall in each band of
+ * its values ("how many products sold between 1,000 and 2,000"). Bars touch,
+ * as bands of one axis do; the edges are labelled under the axis, every other
+ * one when they would crowd; each bar's tooltip says its band and count.
+ * The bars carry no category: one bar is many categories, so it neither
+ * cross-filters nor takes the keyboard's category focus.
+ */
+declare function histogramMarks(input: ShapeChartInput & {
+    binCount?: number;
+    countLabel?: string;
+}): ChartMark[];
 /** The chart types laid out here. */
-declare const SHAPE_CHART_TYPES: readonly ["waterfall", "funnel", "treemap", "heatmap", "rangeBar", "sunburst"];
+declare const SHAPE_CHART_TYPES: readonly ["waterfall", "funnel", "treemap", "heatmap", "rangeBar", "sunburst", "histogram"];
 type ShapeChartType = (typeof SHAPE_CHART_TYPES)[number];
 
+interface ChartStyleDefaults {
+    /** Tick-label size, px. */
+    tick: number;
+    /** Data-label size, px. */
+    label: number;
+    /** Axis-title size, px. */
+    title: number;
+    /** The renderer's own category-label slant, in degrees (negative = up to the right). */
+    angle: number;
+    /** Area fill opacity, unstacked / stacked. */
+    fill: number;
+    stackedFill: number;
+}
+interface ChartStyle {
+    tickSize: number;
+    labelSize: number;
+    titleSize: number;
+    /** Undefined: the theme's. */
+    fontFamily: string | undefined;
+    /** Undefined: the theme's colour for that text. */
+    textColor: string | undefined;
+    fontWeight: 'bold' | undefined;
+    fontStyle: 'italic' | undefined;
+    /** Category-label rotation in degrees, as SVG `rotate()` takes it (0 = flat). */
+    labelAngle: number;
+    /** Grid lines at the value ticks / at the categories. */
+    valueGrid: boolean;
+    categoryGrid: boolean;
+    /** `stroke-dasharray` for grid lines; undefined = solid. */
+    gridDash: string | undefined;
+    lineWidth: number;
+    /** `stroke-dasharray` for series lines; undefined = solid. */
+    lineDash: string | undefined;
+    /** Fill opacity for an area (stacked or not). */
+    areaOpacity(stacked: boolean): number;
+    /** Fill opacity for a mark whose renderer default is `base` (radar, bubble). */
+    fillOpacity(base: number): number;
+}
+declare function resolveChartStyle(format: ChartFormat | undefined, defaults: ChartStyleDefaults): ChartStyle;
+
+interface FrameRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface FrameSize {
+    width: number;
+    height: number;
+}
+/** Where a window first appears: the preferred size, centred in the container. */
+declare function centredFrame(bounds: FrameSize, preferred: FrameSize, min?: FrameSize): FrameRect;
+/** A saved rectangle, read defensively (it came from storage, not from us). */
+declare function readFrameRect(value: unknown): FrameRect | null;
+interface FloatingFrameOptions {
+    /** The window element. Positioned absolutely inside the container. */
+    frame: HTMLElement;
+    /**
+     * Pressing here moves the window — its title bar. Controls inside it
+     * (buttons, fields, labels) keep their own clicks; only the bar itself and
+     * the move grip start a move.
+     */
+    dragHandle: HTMLElement;
+    /** A focusable grip INSIDE `dragHandle`: pointer drags move the window, arrow keys too. */
+    moveGrip?: HTMLElement;
+    /** The bottom-right grip: pointer drags and arrow keys resize. */
+    resizeGrip: HTMLElement;
+    /** The container's size now. */
+    bounds(): FrameSize;
+    min?: FrameSize;
+    /** Every step of a gesture, after the frame's style was updated. */
+    onMove?(rect: FrameRect): void;
+    /** Once per finished gesture: pointer released, or one arrow-key step. */
+    onCommit?(rect: FrameRect): void;
+    /**
+     * The stacking layer windows start above: higher than everything the grid
+     * itself stacks (sticky headers, overlays), lower than its popups and its
+     * fullscreen. Default 20 (the DataGrid's layers stop there); the PivotGrid's
+     * sticky headers go to 61 and its status layer to 70, so it passes 80 —
+     * at 21 a PivotGrid window slid UNDER the column header, which then took
+     * the clicks meant for the window's toolbar.
+     */
+    layer?: number;
+}
+interface FloatingFrame {
+    get(): FrameRect;
+    /** Place the window (kept inside the container). Reports nothing. */
+    set(rect: FrameRect): void;
+    /**
+     * Pull the window back inside a container that changed size. Reports a
+     * commit when the window had to move or shrink.
+     */
+    refit(): void;
+    dispose(): void;
+}
+declare function attachFloatingFrame(initial: FrameRect, options: FloatingFrameOptions): FloatingFrame;
+
+/** `chart-2`, `chart-3`… — the first not in `taken` (the panel itself is chart 1). */
+declare function nextChartWindowId(taken: ReadonlySet<string>): string;
+/**
+ * Where a new chart window opens: a step down and to the right of the window
+ * it was copied from (`anchor`), or centred over the grid when it came from the
+ * docked panel — never exactly on top, where it would look as if nothing
+ * happened. The step grows with the windows already open (and wraps), so a
+ * row of copies fans out instead of stacking. The frame keeps it in the grid.
+ */
+declare function chartWindowFrame(grid: FrameSize, anchor: FrameRect | null, openCount: number): FrameRect;
+
+type ChartCategoryKeyAction = 
+/** Move the focus to this category (by its index in the chart's model). */
+{
+    kind: 'focus';
+    index: number;
+}
+/** Do what a click on this category does. */
+ | {
+    kind: 'pick';
+    index: number;
+    additive: boolean;
+};
+/**
+ * What a key does to the focused category, or null when the key is not the
+ * chart's (leave it to the browser). `focus` is null before the first move;
+ * the first arrow, Home/End, Enter or Space then lands on a category instead
+ * of acting on nothing. Up/Down step too, for a horizontal bar chart.
+ */
+declare function chartCategoryKey(event: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    altKey?: boolean;
+}, focus: number | null, total: number): ChartCategoryKeyAction | null;
+/**
+ * The window start that keeps `index` in view, for a zoomed chart showing
+ * `count` of `total` categories from `start` — the focus walks off the edge
+ * and the view follows it, one category at a time.
+ */
+declare function windowStartFor(index: number, start: number, count: number, total: number): number;
+
 type DateFormatContext = 'grid' | 'chart' | 'export';
-type DateGranularity = 'year' | 'quarter' | 'month' | 'day' | 'dayOfWeek' | string | number;
+type DateGranularity = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'dayOfWeek' | string | number;
 declare class DateFormatter {
     private static intlCache;
     private static stringCache;
@@ -986,7 +1181,15 @@ interface FieldDistinctEntry {
     rawStr: string;
     rawVal: PivotValue;
 }
-/** Set the active grid context for subsequent init/compute calls. */
+/**
+ * Set the grid the engine entry points use when they are not given one.
+ *
+ * Read only at a call's START: every entry point takes the grid as a
+ * parameter that defaults to this, and keeps it across its own `await`s.
+ * Reading the global again after an `await` read whichever grid had run in
+ * the meantime — on a page with several PivotGrids one then drove another's
+ * worker (engineGridIsolation.test.ts). Callers that know their grid pass it.
+ */
 declare function setActiveEngineGrid(gridId: string): void;
 /**
  * Release a grid's worker when the grid unmounts. Termination is deferred by
@@ -1015,6 +1218,8 @@ declare function initPivotEngineAsync<TRow>(data: TRow[], rowFields: PivotField<
      * follow-up filter request.
      */
     filterState?: InitFilterState;
+    /** The grid this init is for; defaults to the active grid at the call. */
+    gridId?: string;
 }): Promise<{
     filtersApplied: boolean;
 }>;
@@ -1034,13 +1239,13 @@ declare function reconfigurePivotEngineAsync<TRow>(data: TRow[], rowFields: Pivo
 prefilterState?: {
     fields: PivotField<TRow>[];
     prefilter?: PivotPrefilter;
-}): Promise<boolean>;
+}, gridId?: string): Promise<boolean>;
 /**
  * Send filter specs to the worker. Converts field.filterValues to
  * dictionary-encoded integer IDs so the worker can do fast integer
  * set lookups on columnar data instead of string comparisons.
  */
-declare function filterPivotEngineAsync(fields: PivotField<any>[], prefilter?: PivotPrefilter): Promise<void>;
+declare function filterPivotEngineAsync(fields: PivotField<any>[], prefilter?: PivotPrefilter, gridId?: string): Promise<void>;
 /**
  * Live update (G-PIV-02): a resolved transaction, in positions of the array
  * the engine holds. See controller/rowTransaction.ts.
@@ -1052,7 +1257,7 @@ interface EngineRowChange<TRow> {
     removeIndex: number[];
     addRows: TRow[];
 }
-declare function computePivotMatrixAsync(expandedPaths: string[], expandedColPaths: string[]): Promise<PivotEngineResult>;
+declare function computePivotMatrixAsync(expandedPaths: string[], expandedColPaths: string[], gridId?: string): Promise<PivotEngineResult>;
 /**
  * Cached distinct values for a header filter.
  *
@@ -1450,14 +1655,26 @@ interface PivotTransactionResult {
 type PivotArea = 'row' | 'column' | 'data' | 'filter' | 'chooser';
 /** Aggregation function applied to data fields in worker pre-aggregation. */
 type PivotSummaryType = 'sum' | 'count' | 'avg' | 'min' | 'max' | 'distinct' | 'custom';
-/** Post-aggregation display transformation applied after cell values are computed. */
-type PivotSummaryDisplayMode = 'absolute' | 'percentOfTotal' | 'percentOfColumnTotal' | 'percentOfRowTotal' | 'runningTotal' | 'difference' | 'percentDifference';
 /**
- * Date grouping interval. `'numeric'` and `'custom'` are accepted for
- * compatibility and have no effect (the grid reports them): numeric bins are
- * set with a number on {@link PivotField.groupInterval}.
+ * Post-aggregation display transformation applied after cell values are computed.
+ *
+ * - `percentOfRowTotal` / `percentOfColumnTotal`: the cell's share of its row's
+ *   (or column's) GRAND total.
+ * - `percentOfParentRowTotal`: the share of the parent row group in the same
+ *   column — Berlin of Germany. A top-level row's parent is the grand total
+ *   row; the grand total row is 100%.
+ * - `percentOfParentColumnTotal`: the same on the column axis, in the same row.
+ *
+ * A zero or missing divisor shows 0.
+ */
+type PivotSummaryDisplayMode = 'absolute' | 'percentOfTotal' | 'percentOfColumnTotal' | 'percentOfRowTotal' | 'percentOfParentRowTotal' | 'percentOfParentColumnTotal' | 'runningTotal' | 'difference' | 'percentDifference';
+/**
+ * Date grouping interval. `'week'` is the ISO 8601 week, labelled with its
+ * week-year (`"2026-W53"`; weeks start on Monday). `'numeric'` and `'custom'`
+ * are accepted for compatibility and have no effect (the grid reports them):
+ * numeric bins are set with a number on {@link PivotField.groupInterval}.
  */
-type PivotGroupInterval = 'year' | 'quarter' | 'month' | 'day' | 'numeric' | 'custom';
+type PivotGroupInterval = 'year' | 'quarter' | 'month' | 'week' | 'day' | 'numeric' | 'custom';
 /** Supported UI locale identifiers. */
 type PivotLocale = 'tr' | 'en' | 'ar' | 'de' | 'fr' | 'es' | 'it' | 'pt' | 'ru' | 'zh-CN' | 'ja' | 'ko';
 /** Union of all value types a pivot cell, node, or filter can hold. */
@@ -1575,9 +1792,11 @@ interface PivotField<TRow = any, TCellTemplate = PivotCellTemplate, TStyle = any
     /** Custom cell render function. */
     cellTemplate?: TCellTemplate;
     /**
-     * Grouping interval: `'year' | 'quarter' | 'month' | 'day'` for a date
-     * field, or a bin width as a number for a number field (`100` → 0–99,
-     * 100–199, …). `'numeric'` and `'custom'` have no effect.
+     * Grouping interval: `'year' | 'quarter' | 'month' | 'week' | 'day'` for a
+     * date field, or a bin width as a number for a number field (`100` → 0–99,
+     * 100–199, …). `'week'` is the ISO 8601 week, Monday first, keyed by its
+     * week-year: 2027-01-01 groups under `"2026-W53"`. Dates are read as local
+     * calendar dates. `'numeric'` and `'custom'` have no effect.
      */
     groupInterval?: PivotGroupInterval | number;
     /** Active filter values for header filter (include/exclude mode). */
@@ -1598,6 +1817,36 @@ interface PivotField<TRow = any, TCellTemplate = PivotCellTemplate, TStyle = any
     topNShowOthers?: boolean;
     /** Custom caption for the "Others" row when topN is active. */
     topNOthersCaption?: string;
+    /**
+     * Keep only the members of this row or column field whose TOTAL for a data
+     * field passes a condition — "regions selling over 1 million". Applied per
+     * level after the sort and before `topN`; the totals keep counting every
+     * member, as with `topN`. Tests the summary value, before any
+     * `summaryDisplayMode`.
+     */
+    valueFilter?: PivotValueFilter;
+    /**
+     * Keep only the members whose CAPTION passes a condition — "cities starting
+     * with A". Compares the member's value as text, case-insensitively unless
+     * `caseSensitive`; a blank member reads as empty text.
+     */
+    labelFilter?: PivotLabelFilter;
+}
+/** A condition on a member's total — `PivotField.valueFilter`. */
+interface PivotValueFilter {
+    /** The id of the data field whose total is tested. */
+    dataField: string;
+    operator: '>' | '>=' | '<' | '<=' | '=' | '!=' | 'between' | 'notBetween';
+    value: number;
+    /** The other bound, for `between` and `notBetween` (inclusive, either order). */
+    value2?: number;
+}
+/** A condition on a member's caption — `PivotField.labelFilter`. */
+interface PivotLabelFilter {
+    operator: 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'endsWith';
+    value: string;
+    /** Default false: "an" matches "Ankara". Lowercased in the grid's locale, so Turkish İ matches i. */
+    caseSensitive?: boolean;
 }
 /** Controls pivot grid layout, totals visibility, and structural options. */
 interface PivotLayoutState {
@@ -1859,6 +2108,8 @@ interface PivotControllerOptions<TRow = any> extends PivotControllerCallbacks<TR
      * that is in `data` (mutated in place) and a remove cannot name a bare key.
      */
     rowKey?: PivotRowKeyResolver<TRow>;
+    /** How long `applyTransactionAsync` collects transactions before applying them together. Default 50 ms. */
+    asyncTransactionWait?: number;
 }
 /**
  * Starting widths, in pixels, for every column of a kind — the renderer's
@@ -1967,19 +2218,52 @@ interface PivotChartState {
     format: ChartFormat;
     /** Series switched off in the legend, by series key (a chart series' `dataKey`). */
     hiddenSeries: string[];
+    /**
+     * Where the panel is: floating over the grid at this rectangle (px, relative
+     * to the grid), or docked when absent — absent rather than `null`, so a
+     * docked panel's state reads as it did before windows existed (rival
+     * analysis, charts §E.1 #9). Read by the Enterprise panel, which owns it.
+     */
+    floating?: FrameRect | null;
+    /** Categories and series swapped (§E.1 #13); absent when not. Read by the Enterprise panel. */
+    switched?: boolean;
+    /** Unlinked from the pivot (§E.1 #8): the chart keeps its data. Absent while linked. */
+    unlinked?: boolean;
+    /** About how many bars a histogram cuts its values into (§E.1 #18); absent means 10. Read by the Enterprise panel. */
+    bins?: number;
 }
 /** Which part of the state a `chartChanged` event moved. */
-type PivotChartChange = 'type' | 'stacking' | 'format' | 'hiddenSeries';
+type PivotChartChange = 'type' | 'stacking' | 'format' | 'hiddenSeries'
+/** Docked or floating, or the floating window moved or resized. */
+ | 'placement'
+/** Categories and series swapped, or back. */
+ | 'switched'
+/** Unlinked from the pivot, or linked again. */
+ | 'linked'
+/** A histogram's bin count. */
+ | 'bins';
 interface PivotChartOpenedEvent {
     state: PivotChartState;
+    /** An extra chart window's id (`'chart-2'`…, §E.1 #10); absent for the grid's own panel. */
+    chartId?: string;
 }
 interface PivotChartChangedEvent {
     state: PivotChartState;
     changes: PivotChartChange[];
+    chartId?: string;
 }
 interface PivotChartClosedEvent {
     state: PivotChartState;
+    chartId?: string;
 }
+/** A window as a saved report keeps it: its state, with its id. */
+type PivotChartWindowState = PivotChartState & {
+    id: string;
+};
+/** The chart's part of a saved report: the panel's state and its extra windows. */
+type PivotChartReportPart = PivotChartState & {
+    windows?: PivotChartWindowState[];
+};
 /**
  * Read a saved chart state defensively — it came from storage, a report or an
  * older build. Fields of the wrong kind fall back to their defaults; `null`
@@ -2035,6 +2319,12 @@ declare class PivotStateStore<TRow> {
     setImportPreview(importPreview: PivotControllerState<TRow>['importPreview']): void;
     private createInitialSnapshot;
     private schedulePersist;
+    /**
+     * Write a pending save NOW. The controller calls it on dispose: the write
+     * waits for an idle moment (up to a second), so a change made just before
+     * the grid went away — a route change in a single-page app — was lost.
+     */
+    flush(): void;
     private persist;
 }
 
@@ -2086,6 +2376,7 @@ declare class PivotController<TRow> {
     private readonly reportParts;
     private pendingReportParts;
     private readonly chartReporter;
+    private readonly windowReporters;
     private options;
     private reportService;
     private engineService;
@@ -2094,6 +2385,10 @@ declare class PivotController<TRow> {
     /** Full row set of a parsed import awaiting preview commit (kept out of observable state). */
     private pendingImportRows;
     private disposed;
+    /** `applyTransactionAsync`: the batch waiting for its window, and who to tell. */
+    private asyncQueue;
+    private asyncCallbacks;
+    private asyncTimer;
     /**
      * The array the application last handed in. After a transaction the
      * controller's rows are a NEW array; a binding that re-sends every option
@@ -2112,7 +2407,7 @@ declare class PivotController<TRow> {
      * convenient: the same state twice is one event, and edits while the panel
      * is closed arrive with the next `chartOpened`.
      */
-    reportChartState(state: PivotChartState): void;
+    reportChartState(state: PivotChartState, chartId?: string): void;
     /**
      * Keep a piece of state owned outside the core inside saved reports — the
      * Enterprise chart panel keeps its chart this way. Order-independent: the
@@ -2142,6 +2437,22 @@ declare class PivotController<TRow> {
      * the recomputed pivot follows (listen for `engineCompleted`).
      */
     applyTransaction(transaction: PivotRowTransaction<TRow>): PivotTransactionResult;
+    private applyNow;
+    /**
+     * Queue a transaction for a feed that ticks faster than anyone can look.
+     * Every `applyTransaction` scans the rows for the keys it names and sends
+     * the worker a message; a hundred ticks in a moment is a hundred of each for
+     * one picture. Queued ones are merged and applied together after
+     * `asyncTransactionWait` ms (default 50), or at once on
+     * `flushAsyncTransactions()`. The callback runs when its batch has been
+     * applied. A synchronous `applyTransaction` or `setData` applies the queue
+     * first; `dispose` drops it.
+     */
+    applyTransactionAsync(transaction: PivotRowTransaction<TRow>, callback?: () => void): void;
+    /** Apply the queued transactions now, as one. */
+    flushAsyncTransactions(): void;
+    /** How many transactions are waiting to be applied. */
+    getPendingAsyncTransactionCount(): number;
     updateField(updatedField: PivotField<TRow>): void;
     deleteField(fieldId: string): void;
     changeFieldArea(fieldId: string, area: PivotArea): void;
@@ -2587,6 +2898,32 @@ interface DimensionFieldInfo {
 }
 declare function formatDimensionValue(value: unknown, field: DimensionFieldInfo | undefined, context: DateFormatContext, locale: string): string;
 
+type AnnounceKey = 'sortAsc' | 'sortDesc' | 'clearSort' | 'columnFilter';
+/** The announcement for the first field whose sort or filter changed; null when none did. */
+declare function pivotChangeAnnouncement(prev: readonly PivotField<any>[], next: readonly PivotField<any>[], t: (key: AnnounceKey) => string): string | null;
+/**
+ * Text for a polite live region. An identical message twice in a row is not
+ * re-read by screen readers, so a repeat gets a trailing no-break space.
+ */
+declare function nextLiveText(current: string, message: string): string;
+
+/** The text of a percent-mode value whose field has no format; null for every other case. */
+declare function percentModeText(value: number, field: PivotField<any> | undefined, locale: string): string | null;
+/** The Excel number format for the same case — the value stays 0-100, so the sign is literal. */
+declare function percentModeExcelNumFmt(field: PivotField<any> | undefined): string | undefined;
+
+type CalculatedFieldTextKey = 'createFormulasWithoutCode' | 'measureName' | 'numericStandard' | 'numericDecimal' | 'currencyTRY' | 'currencyUSD' | 'measureNamePlaceholder' | 'customFormat' | 'customPrefix' | 'customSuffix' | 'minFraction' | 'maxFraction' | 'calculationLevel' | 'calcRowLevel' | 'calcSummaryLevel' | 'noFieldsFound' | 'deleteCalcField' | 'formulaPlaceholder' | 'saveAndAdd' | 'measureNameEmpty' | 'formulaEmpty' | 'formulaError' | 'calcRowLevelHint' | 'calcSummaryLevelHint' | 'formulaValid' | 'calcFieldsHint' | 'formulaUses';
+/** The designer's text for `key` in `locale` (`tr-TR` → `tr`, `zh` → `zh-CN`), or undefined. */
+declare function calculatedFieldText(locale: string | undefined, key: string): string | undefined;
+
+type DrillDownTextKey = 'exportCsv' | 'pagerPage' | 'pagerOf' | 'pagerPrevious' | 'pagerNext' | 'drillDown' | 'drillDownRecords';
+/** The caption for `key` in `locale` (`tr-TR` → `tr`, `zh` → `zh-CN`), or undefined. */
+declare function drillDownText(locale: string | undefined, key: string): string | undefined;
+
+type ChartKeyTextKey = 'chartCanvasHintPick' | 'chartCategoryFocus' | 'chartCategoryFiltered';
+/** The text for `key` in `locale` (`tr-TR` → `tr`, `zh` → `zh-CN`), English when the language is unknown. */
+declare function chartKeyText(locale: string | undefined, key: ChartKeyTextKey): string;
+
 declare class ExportStreamController {
     private worker;
     private static sharedWorker;
@@ -3015,6 +3352,26 @@ interface PivotAiSort {
     /** Keep only the first N after sorting (needs `byValueField`). */
     top: number | null;
 }
+/**
+ * A condition on the members of a row or column field (`valueFilter` /
+ * `labelFilter`): by their TOTAL — "regions over 1 million" — or by their
+ * CAPTION — "cities starting with A". Applied after the sort and before `top`.
+ */
+type PivotAiCondition = {
+    fieldId: string;
+    kind: 'value';
+    /** The measure whose total is tested (one of the values). */
+    dataField: string;
+    operator: PivotValueFilter['operator'];
+    value: number;
+    /** The other bound, for between / notBetween; null otherwise. */
+    value2: number | null;
+} | {
+    fieldId: string;
+    kind: 'label';
+    operator: PivotLabelFilter['operator'];
+    text: string;
+};
 interface PivotAiTotals {
     grandTotalRow: boolean;
     grandTotalColumn: boolean;
@@ -3032,6 +3389,8 @@ interface PivotAiState {
     values?: PivotAiValue[];
     /** Every value filter; [] clears them. */
     filters?: PivotAiFilter[];
+    /** Every condition on a field's members by total or caption; [] clears them. */
+    conditions?: PivotAiCondition[];
     /** Every dimension sort; a dimension not listed keeps its data order. */
     sort?: PivotAiSort[];
     totals?: PivotAiTotals;
@@ -3155,4 +3514,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, type CellClickEvent, type CellPreparedEvent, type CellType, type ChartFormat, type ChartImageRequest, type ChartLegendPosition, type ChartMark, type ChartStacking, 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 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 FunnelStage, 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 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 PivotChartState, type PivotColumnWidthDefaults, type PivotConditionRule, PivotController, type PivotControllerCallbacks, type PivotControllerEvents, type PivotControllerOptions, type PivotControllerState, type PivotDataSource, 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 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 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, buildCellLookup, buildColPathsList, buildColumnHeaders, buildEngineResult, buildPivotAOA, buildRowLabelCells, cellHash, cellHashCol, cellHashRow, chartPalette, classifyValue, clearFormatCache, coerceRecords, coerceValue, collatorFor, compileSafeFormula, computeFieldRanges, computePivotMatrixAsync, computeRowHeaderWidths, conditionRuleToExcelStyle, cssColorToRgb, de, dedupeHeaders, defaultPivotLayout, destroyEngineWorker, detectDelimiter, diffPivotChartState, 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, heatColor, heatTextColor, heatmapMarks, inferColumnType, initPivotEngineAsync, intlFormatToExcelNumFmt, invertRowHeaderWidth, it, ja, ko, logAxisTicks, pairSeriesForXY, parseBoolean, parseColor, parseCsvToRows, parseDelimited, parseFlexibleDate, parseLocaleNumber, percentAxisTicks, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, resolveColPath, resolveColumnWidthDefaults, resolveConditionalVisual, rollupInMemory, ru, safeKey, sanitizeRows, scaleColor, serverRequestFor, setActiveEngineGrid, sortPivotTree, squarify, stackSeries, stripBom, sunburstMarks, testSafeFormula, tr, treemapMarks, trendColumnPaths, trendShape, waterfallDomain, waterfallMarks, waterfallSteps, zhCN };
+export { type AdvancedExportRequest, type AdvancedExporter, CHART_LEGEND_POSITIONS, 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 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 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 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, 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, pivotRowTrend, pivotServerSource, pt, rangeBarMarks, rangeRatio, readChartFormat, readFrameRect, readPivotChartState, reconfigurePivotEngineAsync, registerAdvancedExporter, 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 };