@svgrid/grid 3.0.3 → 3.0.5

package/README.md

@@ -92,7 +92,7 @@ all wire up the moment you turn on the matching prop.
 - **Selection** - cell-range click+drag and Shift+arrows, copy/paste as TSV, Excel-style fill handle, row selection.
 - **Views** - row grouping with aggregation, tree data, master/detail, full-width detail rows, spreadsheet mode with formulas.
 - **Layout** - row + column pinning, sticky header + first column, header drag-to-reorder, autosize, keyboard-accessible column sizing, zebra rows, responsive mode.
-- **Data operations** - find in grid (Ctrl+F), undo / redo, transaction API, optimistic updates, server-side row model with sort / filter / group pushdown.
+- **Data operations** - find in grid (Ctrl+F), undo / redo, transaction API, optimistic updates, server-side data with sort / filter / paging / infinite-scroll pushdown (lazy grouping, tree, pivot and transactions on the server are in `@svgrid/enterprise`).
 - **AI helpers, free** - natural-language filter, smart fill, summarize, classify, anomaly detection, and "chart this". Model-agnostic: register one provider, nothing is bundled.
 - **UI components** - a Svelte 5 component suite ships in the package (inputs, selection, date/time, overlays, layout, feedback), standalone or as grid cell editors.
 - **Accessibility** - WAI-ARIA grid roles, full keyboard navigation, RTL, high-contrast theme.
@@ -154,14 +154,14 @@ See [Use sv-grid docs as LLM context](https://svgrid.com/docs/help/llm-grounding
 ## Enterprise features
 
 The MIT core is free for any use, including commercial, with **no feature gating**. Sorting, filtering,
-editing, virtualization, the **server-side row model**, and the **AI helpers** all ship in the free
-package. The optional [`@svgrid/enterprise`](https://www.npmjs.com/package/@svgrid/enterprise) pack layers
+editing, virtualization, **server-side data** (paging, infinite block scroll, sort, filter, CRUD) and the
+**AI helpers** all ship in the free package. The optional [`@svgrid/enterprise`](https://www.npmjs.com/package/@svgrid/enterprise) pack layers
 on the export- and analytics-heavy features teams tend to need last:
 
 - **Excel / PDF / CSV / TSV / HTML export** plus paginated print.
 - **Excel / CSV / TSV / JSON import** with auto-mapping and per-row validation.
 - **Pivot tables** with a drag-and-drop pivot Designer.
-- **Kanban board and scheduler / calendar renderers** for the `board` and `scheduler` props.
+- **Kanban board, scheduler / calendar and Gantt renderers** for the `board`, `scheduler` and `gantt` props.
 
 OSS projects receive an Enterprise key free. See [Pricing](https://svgrid.com/pricing/).
 
@@ -193,10 +193,11 @@ inside `@svgrid/grid`; the tools after it install separately and are entirely op
 |---|---|---|---|
 | **Svelte 5 runes native** | Yes | No, JS core + wrapper | Adapter only |
 | **Ships a renderer** | Yes, plus headless | Yes | No, headless only |
-| **Bundle (gzip)** | ~2 KB headless / ~80 KB full | ~340 KB | ~12-14 KB |
+| **Bundle (gzip)** | measured on [the comparison page](https://svgrid.com/compare/ag-grid/) | measured, same page | measured, [same method](https://svgrid.com/compare/tanstack-table/) |
 | **Master/detail, tree, range selection** | Free | Enterprise only | Build it yourself |
 
 Full detail: [SvGrid vs AG Grid vs TanStack Table](https://svgrid.com/docs/help/comparison/) ·
+[All comparisons, with dated sources](https://svgrid.com/compare/) ·
 [Migrating from AG Grid](https://svgrid.com/docs/help/migrating-from-ag-grid/)
 
 ## Documentation

package/dist/GridMenus.svelte

@@ -14,6 +14,7 @@
   import SvListBox from "./SvListBox.svelte";
   import type {
     FilterOperator,
+    MenuPosition,
   } from "./SvGrid.types";
   import {
     getEditorInputType,
@@ -175,6 +176,29 @@
       import("./SvDateRangeInput.svelte").then((m) => (MenuRangePicker = m.default));
   });
 
+  /**
+   * The context menu is placed on a guessed height (280px, flipped above the
+   * click when that would not fit) before it exists. A consumer's menu can be
+   * far taller - the spreadsheet shell's has thirteen entries - and then the
+   * guess leaves its tail below the viewport. Once the menu is in the DOM its
+   * real box is measured and the position pulled back inside: up when it runs
+   * off the bottom, left when it runs off the right. The style reads
+   * `contextMenuPos`, so writing it moves the menu; the action's `update`
+   * runs on every position change and settles in one pass.
+   */
+  function keepInViewport(node: HTMLElement, _pos: MenuPosition) {
+    const fit = () => {
+      const pos = ctrl.contextMenuPos;
+      const box = node.getBoundingClientRect();
+      if (!box.width && !box.height) return;
+      const x = Math.max(8, Math.min(pos.x, window.innerWidth - box.width - 8));
+      const y = Math.max(8, Math.min(pos.y, window.innerHeight - box.height - 8));
+      if (x !== pos.x || y !== pos.y) ctrl.contextMenuPos = { x, y };
+    };
+    fit();
+    return { update: fit };
+  }
+
   /**
    * Opening the filter popover used to leave focus on the funnel button
    * outside it, so a keyboard user landed nowhere and had to tab in past the
@@ -832,6 +856,8 @@
   {/if}
 
   {#if contextMenuFor}
+    {@const items = contextMenuItems()}
+    {@const gutter = items.some((it) => it.icon)}
     <div
       class="sv-grid-menu-backdrop"
       role="presentation"
@@ -843,8 +869,9 @@
       data-svgrid-menu={ctrl.gridDomId}
       role="menu"
       style={`left: ${contextMenuPos.x}px; top: ${contextMenuPos.y}px;`}
+      use:keepInViewport={contextMenuPos}
     >
-      {#each contextMenuItems() as item (item.key)}
+      {#each items as item (item.key)}
         {#if item.separator}
           <div class="sv-grid-menu-sep"></div>
         {:else}
@@ -854,7 +881,22 @@
             role="menuitem"
             disabled={item.disabled}
             onclick={() => { item.run?.(); closeContextMenu(); }}
-          >{item.label}</button>
+          >
+            <!-- Every item keeps the gutter once one has an icon, so the labels
+                 line up. The label is its own span with no whitespace text
+                 around it, so the button reads exactly its label. -->
+            {#if gutter}<span class="sv-grid-menu-icon" aria-hidden="true">
+                {#if typeof item.icon === "string"}
+                  {@render icon(item.icon)}
+                {:else if item.icon}
+                  <svg class="sv-grid-menu-icon-own" width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round" focusable="false">
+                    {#each item.icon.paths as path, i (i)}
+                      <path d={path.d} fill={path.fill ? "currentColor" : "none"} stroke-width={path.width} stroke-dasharray={path.dash} />
+                    {/each}
+                  </svg>
+                {/if}
+              </span>{/if}<span class="sv-grid-menu-label">{item.label}</span>
+          </button>
         {/if}
       {/each}
     </div>

package/dist/SvChartMenu.svelte

@@ -0,0 +1,69 @@
+<script lang="ts">
+  /**
+   * The chart's right-click menu: the same portalled, focus-trapped,
+   * dismissable panel `SvContextMenu` opens, without the zone `<div>` that
+   * component wraps its children in. The chart owns its own `contextmenu`
+   * handler (the SVG is the zone) and hands this the items and a position.
+   *
+   * Lazy-loaded by `SvGridChart` on the first right-click, so a chart that is
+   * never right-clicked never pays for the menu machinery.
+   */
+  import { portalToBody, popIn } from './popover'
+  import { createDismissableLayer, onScrollOutside } from './a11y/dismissable'
+  import { createFocusTrap } from './a11y/focus-trap'
+  import SvMenuList, { type MenuItem } from './SvMenuList.svelte'
+
+  type Props = {
+    items: ReadonlyArray<MenuItem>
+    x: number
+    y: number
+    onClose: () => void
+    ariaLabel?: string
+  }
+  let { items, x, y, onClose, ariaLabel = 'Chart menu' }: Props = $props()
+
+  let panelEl = $state<HTMLDivElement | null>(null)
+  const MENU_W = 220
+  const pos = $derived.by(() => {
+    if (typeof window === 'undefined') return { x, y }
+    const estH = Math.min(items.length, 12) * 34 + 8
+    return {
+      x: Math.max(6, Math.min(x, window.innerWidth - MENU_W - 6)),
+      y: Math.max(6, Math.min(y, window.innerHeight - estH - 6)),
+    }
+  })
+
+  $effect(() => {
+    if (!panelEl) return
+    const trap = createFocusTrap(panelEl, {
+      initialFocus: () => panelEl?.querySelector<HTMLElement>('[role="menuitem"]:not([disabled])') ?? null,
+    })
+    trap.activate()
+    const layer = createDismissableLayer({ element: () => panelEl, onDismiss: onClose })
+    layer.activate()
+    const offScroll = onScrollOutside(() => panelEl, onClose)
+    return () => { layer.release(); trap.release(); offScroll() }
+  })
+</script>
+
+<div
+  bind:this={panelEl}
+  class="sv-ctx sv-grid-chart-menu"
+  use:portalToBody
+  use:popIn={{}}
+  style:position="fixed"
+  style:top={`${pos.y}px`}
+  style:left={`${pos.x}px`}
+  aria-label={ariaLabel}
+>
+  <SvMenuList {items} onclose={onClose} onselect={() => onClose()} />
+</div>
+
+<style>
+  :global(.sv-grid-chart-menu) {
+    z-index: 2147483646; min-width: 220px;
+    background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--sg-border, #e2e8f0); border-radius: 10px;
+    box-shadow: 0 16px 48px -12px rgba(15, 23, 42, 0.35); font-size: 13px;
+  }
+</style>

package/dist/SvChartMenu.svelte.d.ts

@@ -0,0 +1,11 @@
+import { type MenuItem } from './SvMenuList.svelte';
+type Props = {
+    items: ReadonlyArray<MenuItem>;
+    x: number;
+    y: number;
+    onClose: () => void;
+    ariaLabel?: string;
+};
+declare const SvChartMenu: import("svelte").Component<Props, {}, "">;
+type SvChartMenu = ReturnType<typeof SvChartMenu>;
+export default SvChartMenu;

package/dist/SvChartPanes.svelte

@@ -0,0 +1,113 @@
+<script lang="ts">
+  /**
+   * SvChartPanes - a price chart with indicator panes stacked under it, the
+   * way a trading terminal lays them out: one shared x axis (labelled on the
+   * last pane only), one value-axis gutter width so the plots line up, and
+   * one crosshair / zoom window across all of them.
+   *
+   * Composition, not a new layout: every pane is a full `SvChart` in a sync
+   * group of its own, so tooltips, keyboard navigation, the screen-reader
+   * table, export and the context menu all come for free, and the geometry
+   * stays single-plot. The main chart takes every `SvChart` prop.
+   */
+  import SvGridChart from './SvGridChart.svelte'
+  import { indicatorPane, type ChartIndicatorSpec } from './chart-indicators'
+  import type { ChartSpec, ChartZoomWindow } from './chart-types'
+  import type { SvChartProps } from './SvGridChart.types'
+
+  type Props = Omit<SvChartProps, 'spec' | 'syncGroup' | 'zoom'> & {
+    /** The price spec: a candlestick / OHLC / line chart with the series the
+     *  indicators read (`ohlc` and `volumes` on it for the volume-based ones). */
+    spec: ChartSpec
+    /** The panes under the price, top to bottom. */
+    indicators?: ChartIndicatorSpec[]
+    /** A sync group to share with charts outside the stack. Default: private. */
+    syncGroup?: string
+    /** Width of the value-axis gutter every pane uses, so the plots line up.
+     *  Default 56. */
+    axisWidth?: number
+    /** The shared zoom window, bindable. */
+    zoom?: ChartZoomWindow | null
+  }
+  let {
+    spec,
+    indicators = [],
+    syncGroup,
+    axisWidth = 56,
+    zoom = $bindable(null),
+    onZoom,
+    zoomable,
+    legend,
+    toolbar,
+    ...rest
+  }: Props = $props()
+
+  const uid = `svcp-${Math.random().toString(36).slice(2, 8)}`
+  const group = $derived(syncGroup ?? uid)
+  // Every pane is laid out at the stack's pixel width, so the panes line up
+  // and none of them is a 520px viewBox stretched across a 900px column.
+  // Heights stay what the specs say; only the width follows the container.
+  let hostW = $state(0)
+  const widthOf = (s: ChartSpec) => (hostW > 0 && !s.width ? { width: Math.round(hostW) } : {})
+  /** The price chart hides its x labels when a pane below will show them. */
+  const mainSpec = $derived<ChartSpec>({
+    ...spec,
+    ...widthOf(spec),
+    xAxis: { ...spec.xAxis, ...(indicators.length ? { labels: false } : {}) },
+    yAxis: { ...spec.yAxis, width: axisWidth },
+    ...(spec.y2Axis || spec.series.some((s) => s.axis === 'right') ? { y2Axis: { ...spec.y2Axis, width: axisWidth } } : {}),
+  })
+  // The pane's title is drawn by this component as a small corner label
+  // rather than by the chart frame, which would take a third of a 100px
+  // pane for it.
+  const panes = $derived(
+    indicators.map((ind, i) => {
+      const { title, ...pane } = indicatorPane(spec, ind)
+      return {
+        title: title ?? ind.kind,
+        spec: {
+          ...pane,
+          ...widthOf(pane),
+          xAxis: { ...pane.xAxis, labels: i === indicators.length - 1 },
+          yAxis: { ...pane.yAxis, width: axisWidth },
+        } satisfies ChartSpec,
+      }
+    }),
+  )
+</script>
+
+<div class="sv-chart-panes" bind:clientWidth={hostW}>
+  <div class="sv-chart-pane is-main">
+    <SvGridChart spec={mainSpec} syncGroup={group} bind:zoom {onZoom} {zoomable} {legend} {toolbar} {...rest} />
+  </div>
+  {#each panes as pane, i (`${indicators[i]?.kind}-${i}`)}
+    <div class="sv-chart-pane is-indicator" data-indicator={indicators[i]?.kind}>
+      <span class="sv-chart-pane-title" style:left={`${axisWidth + 6}px`}>{pane.title}</span>
+      <SvGridChart spec={pane.spec} syncGroup={group} zoomable={zoomable ? { drag: false, wheel: typeof zoomable === 'object' ? zoomable.wheel : false, pan: typeof zoomable === 'object' ? zoomable.pan : false } : false} legend={false} toolbar={false} interactive localeText={rest.localeText} />
+    </div>
+  {/each}
+</div>
+
+<style>
+  .sv-chart-panes {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    min-width: 0;
+  }
+  .sv-chart-pane {
+    position: relative;
+    min-width: 0;
+  }
+  /* The title of a pane sits in its top-left corner, small, like a terminal. */
+  /* Placed just right of the value-axis gutter, clear of the tick labels. */
+  .sv-chart-pane-title {
+    position: absolute;
+    top: 2px;
+    z-index: 1;
+    font-size: 10px;
+    font-weight: 600;
+    color: var(--sg-muted, #64748b);
+    pointer-events: none;
+  }
+</style>

package/dist/SvChartPanes.svelte.d.ts

@@ -0,0 +1,20 @@
+import { type ChartIndicatorSpec } from './chart-indicators.js';
+import type { ChartSpec, ChartZoomWindow } from './chart-types.js';
+import type { SvChartProps } from './SvGridChart.types.js';
+type Props = Omit<SvChartProps, 'spec' | 'syncGroup' | 'zoom'> & {
+    /** The price spec: a candlestick / OHLC / line chart with the series the
+     *  indicators read (`ohlc` and `volumes` on it for the volume-based ones). */
+    spec: ChartSpec;
+    /** The panes under the price, top to bottom. */
+    indicators?: ChartIndicatorSpec[];
+    /** A sync group to share with charts outside the stack. Default: private. */
+    syncGroup?: string;
+    /** Width of the value-axis gutter every pane uses, so the plots line up.
+     *  Default 56. */
+    axisWidth?: number;
+    /** The shared zoom window, bindable. */
+    zoom?: ChartZoomWindow | null;
+};
+declare const SvChartPanes: import("svelte").Component<Props, {}, "zoom">;
+type SvChartPanes = ReturnType<typeof SvChartPanes>;
+export default SvChartPanes;

package/dist/SvGrid.controller.svelte.d.ts

@@ -1,7 +1,8 @@
-import { type GridPredicateExpr, type CellEditorOption, type Column, type ColumnDef, type Row, type RowData, type TableFeatures, type ChartType, type ChartSpec, type ChartValueFormat } from "./index.js";
+import { type GridPredicateExpr, type CellEditorOption, type Column, type ColumnDef, type Row, type RowData, type TableFeatures, type ChartType, type ChartSpec, type ChartReducer, type ChartTimeBucket, type ChartValueFormat, type ChartZoomWindow, type ChartPanelIndicator, type ChartFormatState, type OhlcColumns } from "./index.js";
 import "./sv-grid-scrollbar.js";
 import { type ColumnStat } from "./conditional-formatting.js";
 import type { Props, SelectionRange, CellEditState, FilterOperator, MenuPosition, ContextMenuTarget, ChartingConfig } from "./SvGrid.types.js";
+import { type HistoryStep as SharedHistoryStep } from "./history.js";
 import { operatorOption, operatorsForColumn, defaultOperatorFor, operatorLabelFor } from "./filter-operators.js";
 import { type FacetBucket, isBucketableColumn, buildBuckets, isInBucket } from "./facet-buckets.js";
 import { getColumnBaseValue, isGroupRow, toolPanelHeaderLabel, formatSummaryNumeric, getColumnAlign, getPinnedCellValue, getColumnAccessorValue, columnDefMatchesId } from "./cell-values.js";
@@ -74,14 +75,9 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     } | null;
     editedCellValues: Record<string, unknown>;
     readonly UNDO_LIMIT: number;
-    history: {
-        rowId: string;
-        columnId: string;
-        field: string;
-        before: unknown;
-        after: unknown;
-    }[];
+    history: SharedHistoryStep[];
     historyPtr: number;
+    historyGroupId: string | undefined;
     historyVersion: number;
     tooltip: {
         text: string;
@@ -104,6 +100,9 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     headerHeight: number;
     editorSelectAll: boolean;
     columnWidths: Record<string, number>;
+    readonly collapsedColumns: Record<string, boolean>;
+    readonly mergeIndex: import("./merges.js").MergeIndex | null;
+    readonly setColumnCollapsed: (columnId: string, collapsed: boolean) => void;
     readonly MIN_COLUMN_WIDTH: number;
     columnPinning: {
         left: Array<string>;
@@ -159,8 +158,6 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly scrollMetrics: {
         scrollTop: number;
         scrollLeft: number;
-        clientHeight: number;
-        clientWidth: number;
         scrollHeight: number;
         scrollWidth: number;
     };
@@ -175,6 +172,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly moveCellsEffective: boolean;
     readonly flushScheduledScrollSync: () => void;
     readonly scheduleScrollSync: (scrollTop: number, scrollLeft: number) => void;
+    readonly syncScrollNow: (scrollTop: number, scrollLeft: number) => void;
     internalData: readonly TData[];
     internalColumns: ColumnDef<TFeatures, TData>[];
     hiddenColumns: Record<string, boolean>;
@@ -299,6 +297,8 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
         rows: TData[];
         ids: string[];
     };
+    readonly selectionBarCount: number;
+    readonly selectionBarVisible: boolean;
     lastSelectionSerialized: string;
     lastCellRangeSerialized: string;
     readonly statusBarEnabled: boolean;
@@ -318,7 +318,9 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly toolPanelHeaderLabel: typeof toolPanelHeaderLabel;
     readonly toggleColumnVisibleInPanel: (columnId: string) => void;
     readonly moveColumnInPanel: (columnId: string, dir: -1 | 1) => void;
-    readonly messages: import("./grid-messages.js").GridMessages;
+    readonly messages: import("./grid-messages.js").GridChromeMessages;
+    /** The raw `localization.text` map, for the lazy chart panel's own strings. */
+    readonly localizationText: Partial<import("./grid-messages.js").GridMessages> | undefined;
     readonly pivotConfig: import("./pivot-view.svelte.js").GridPivotConfig<TData> | null;
     readonly pivotActive: boolean;
     readonly pivotResult: {
@@ -341,7 +343,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly chartIsCustom: boolean;
     chartPanelOpen: boolean;
     chartType: ChartType;
-    chartReduce: "sum" | "avg" | "count";
+    chartReduce: ChartReducer;
     chartDimensionId: string | null;
     chartMeasureId: string | null;
     chartSeriesId: string | null;
@@ -349,6 +351,21 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     chartDataLabels: boolean;
     chartLogScale: boolean;
     chartTimeAxis: boolean;
+    chartBucket: ChartTimeBucket | null;
+    chartBins: number | null;
+    chartFunnelShape: "trapezoid" | "pyramid" | "cone" | null;
+    chartCandleStyle: "classic" | "hollow" | "heikin-ashi" | null;
+    chartFormat: ChartFormatState | null;
+    readonly chartFrozen: {
+        spec: ChartSpec;
+        at: string;
+    } | null;
+    readonly chartIsOhlc: boolean;
+    chartOhlc: OhlcColumns;
+    readonly chartOhlcDateId: string | null;
+    chartIndicators: ChartPanelIndicator[];
+    readonly chartIndicatorPanes: import("./chart-indicators.js").ChartIndicatorSpec[];
+    chartZoom: ChartZoomWindow | null;
     chartValueFormat: ChartValueFormat;
     readonly chartDimensionIsDate: boolean;
     chartSize: number | null;
@@ -386,27 +403,32 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     }[];
     activeChartIndex: number;
     addChart(): void;
+    /** Unlink the active chart from the grid: it keeps the spec it has now. */
+    freezeChart(): void;
+    /** Link the active chart back to the grid's rows. */
+    unfreezeChart(): void;
     removeChart(index?: number): void;
     renameChart(index: number, title: string): void;
-    getChartsState(): {
-        title: string;
-        type: ChartType;
-        dimension: string | null;
-        series: string | null;
-        measure: string | null;
-        measure2: string | null;
-        orientation: "horizontal" | "vertical" | null;
-        stacked100: boolean | null;
-        donut: boolean | null;
-        palette: string[] | null;
-        reduce: "sum" | "avg" | "count";
-        stacked: boolean | null;
-        dataLabels: boolean | null;
-        logScale: boolean | null;
-        timeAxis: boolean | null;
-        valueFormat: ChartValueFormat | null;
-    }[];
+    getChartsState(): Record<string, unknown>[];
     applyChartsState(list: ReadonlyArray<Record<string, unknown>>, active?: number): void;
+    readonly savedCharts: {
+        name: string;
+        savedAt: string;
+        tab: Record<string, unknown>;
+    }[];
+    /** Keep the active tab's configuration under a name (replacing a same-named one). */
+    saveChart(name: string): void;
+    /** Apply a saved chart to the active tab; the tab keeps its id and title. */
+    applySavedChart(name: string): boolean;
+    removeSavedChart(name: string): void;
+    getSavedCharts(): {
+        tab: {
+            [x: string]: unknown;
+        };
+        name: string;
+        savedAt: string;
+    }[];
+    applySavedCharts(list: ReadonlyArray<Record<string, unknown>>): void;
     readonly chartCrossFilterable: boolean;
     chartOrientation: "horizontal" | "vertical";
     chartStacked100: boolean;
@@ -415,18 +437,46 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     chartMeasure2Id: string | null;
     readonly effectiveChartMeasure2Id: string | null;
     chartAiHandler: ((prompt: string) => Promise<Record<string, unknown> | null>) | null;
+    chartExplainHandler: (() => Promise<{
+        summary: string;
+        insights: string[];
+    } | null>) | null;
     applyChartConfig(config: {
         open?: boolean;
         type?: ChartType;
         dimension?: string | null;
         series?: string | null;
         measure?: string | null;
-        reduce?: "sum" | "avg" | "count";
+        reduce?: ChartReducer;
         stacked?: boolean;
         dataLabels?: boolean;
         logScale?: boolean;
         timeAxis?: boolean;
         valueFormat?: ChartValueFormat;
+        bucket?: ChartTimeBucket | null;
+        bins?: number | null;
+        funnelShape?: "trapezoid" | "pyramid" | "cone" | null;
+        candleStyle?: "classic" | "hollow" | "heikin-ashi" | null;
+        /** Second measure: scatter Y, range high end, bullet target. */
+        measure2?: string | null;
+        /** Candlestick / OHLC price columns (ids or fields). */
+        ohlc?: {
+            open?: string | null;
+            high?: string | null;
+            low?: string | null;
+            close?: string | null;
+            volume?: string | null;
+        } | null;
+        /** Indicators: panes (volume, rsi, macd, stochastic, atr, obv) and
+         *  overlays (sma, ema, bb, vwap). */
+        indicators?: ChartPanelIndicator[];
+        /** The builder's format (titles, axes, legend, series style); `null` resets it. */
+        format?: ChartFormatState | null;
+        /** Unlink the chart from the grid (true) or link it back (false). */
+        frozen?: boolean;
+        /** A saved chart's name: applied to the active tab first, then the
+         *  other keys on top. */
+        saved?: string;
     }): void;
     readonly toggleGroupInPanel: (columnId: string) => void;
     lastSortingSerialized: string;
@@ -471,8 +521,17 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly measuredRowHeightPx: (index: number) => number | undefined;
     /** True when the `rowResize` prop is on and nothing overrides it. */
     readonly rowResizeOn: boolean;
+    readonly frozenRowCount: number;
+    readonly frozenRowList: Row<TData>[];
+    readonly frozenBandHeight: number;
+    readonly frozenRowTop: (i: number) => number;
     /** Record the height the user dragged a row to. */
-    readonly setRowResizeHeight: (index: number, height: number) => void;
+    readonly setRowResizeHeight: (index: number, height: number | null) => void;
+    readonly isRowCollapsed: (index: number) => boolean;
+    readonly setRowCollapsed: (index: number, collapsed: boolean) => void;
+    readonly resizeRowByUser: (index: number, height: number | null) => void;
+    readonly resizeColumnByUser: (columnId: string, width: number, before: number) => void;
+    readonly autosizeColumnByUser: (columnId: string) => void;
     /** A row's dragged height, or undefined when it has not been resized. */
     readonly rowResizeHeightPx: (index: number) => number | undefined;
     readonly virtualRowTotalSize: number;
@@ -541,11 +600,20 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly getPinnedCellValue: typeof getPinnedCellValue;
     readonly formatPinnedValue: (column: Column<TData>, value: unknown) => string;
     readonly computePinnedCellClass: (rowData: TData, column: Column<TData>) => string;
-    readonly isRowSelected: (rowId: string) => boolean;
+    readonly isRowSelected: (rowId: string) => any;
     readonly toggleRowSelectionById: (rowId: string) => void;
-    readonly headerSelectionState: "none" | "all" | "some";
+    readonly headerSelectionState: "some" | "none" | "all";
+    readonly visibleRowRange: {
+        startIndex: number;
+        endIndex: number;
+    };
+    placeholderStateOf: (row: Row<TData>) => "loading" | "failed" | null;
+    /** Retry a failed placeholder row. No-op without `onRetryRow`. */
+    retryRow(row: Row<TData>): void;
     readonly toggleSelectAllRows: () => void;
+    readonly setSelectAllRows: (select: boolean) => void;
     userHasActivatedCell: boolean;
+    tabRunOrigin: number | null;
     readonly setActiveCell: (rowIndex: number, colIndex: number) => void;
     readonly scrollActiveCellIntoView: (rowIndex: number, colIndex: number) => void;
     readonly getColumnBaseWidth: (columnId: string) => any;
@@ -560,6 +628,22 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
         left: boolean;
         right: boolean;
     } | null;
+    readonly activeRangeRect: () => {
+        minRow: number;
+        maxRow: number;
+        minCol: number;
+        maxCol: number;
+    } | null;
+    readonly cellSelectionState: (rowIndex: number, colIndex: number) => {
+        active: boolean;
+        edges: {
+            top: boolean;
+            bottom: boolean;
+            left: boolean;
+            right: boolean;
+        } | null;
+        fillHandle: boolean;
+    } | null;
     readonly getSelectionRects: () => {
         minRow: number;
         maxRow: number;
@@ -593,6 +677,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly startFillDrag: (event: PointerEvent, rowIndex: number, colIndex: number) => void;
     readonly onFillPointerMove: (event: PointerEvent) => void;
     readonly onFillPointerUp: () => void;
+    readonly fillDownToNeighbour: () => void;
     readonly isOnMoveGrabStrip: (cell: HTMLElement, rowIndex: number, colIndex: number, clientX: number, clientY: number) => boolean;
     readonly startMoveDrag: (event: PointerEvent, rowIndex: number, colIndex: number) => boolean;
     readonly onMovePointerMove: (event: PointerEvent) => void;
@@ -626,6 +711,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly cutSelectionToClipboard: () => Promise<void>;
     readonly pasteFromClipboard: () => Promise<void>;
     readonly onGridPaste: (event: ClipboardEvent) => void;
+    readonly armPasteFallback: () => void;
     readonly clearSelectedCells: () => boolean;
     readonly onCellDoubleClick: (rowIndex: number, colIndex: number) => void;
     readonly startEditingWithChar: (rowIndex: number, colIndex: number, char: string) => boolean;
@@ -636,13 +722,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly commitFullRowEdit: () => void;
     readonly cancelFullRowEdit: () => void;
     readonly saveEditingCell: () => void;
-    readonly applyHistoryStep: (step: {
-        rowId: string;
-        columnId: string;
-        field: string;
-        before: unknown;
-        after: unknown;
-    }, direction: "undo" | "redo") => void;
+    readonly applyHistoryStep: (step: SharedHistoryStep, direction: "undo" | "redo") => void;
     readonly updateEditingCellValue: (value: unknown) => void;
     readonly onEditorKeyDown: (event: KeyboardEvent) => void;
     readonly commitAndMoveByTab: (shiftKey: boolean) => void;
@@ -657,6 +737,7 @@ export declare function createSvGridController<TFeatures extends TableFeatures =
     readonly contextMenuItems: () => {
         key: string;
         label: string;
+        icon?: import("./grid-icons.js").GridIconName | import("./SvGrid.types.js").ContextMenuIcon;
         separator?: boolean;
         disabled?: boolean;
         run?: (() => void) | undefined;