@agile-team/mach-table 0.23.0 → 0.25.0

package/README.md

@@ -4,7 +4,7 @@
 
 # @agile-team/mach-table
 
-Enterprise-grade, framework-independent TypeScript data grid. Zero runtime dependencies, virtualized rows and columns, polished cell/full-row editing, async validation, action columns, change tracking, versioned state and resilient infinite loading.
+MachTable 0.25 的框架无关 TypeScript Core：零运行时依赖，提供行列双虚拟化、领域化 API、单元格/整行编辑、树与分组、随机访问远程数据、区段隔离状态持久化和可诊断扩展系统。
 
 ```bash
 pnpm add @agile-team/mach-table
@@ -17,133 +17,43 @@ import "@agile-team/mach-table/styles/mach-table.css";
 const api = createGrid(document.querySelector("#grid")!, {
   columnDefs: [
     { field: "id", headerName: "ID", width: 120 },
-    { field: "name", headerName: "Name", flex: 1, editable: true }
+    { field: "name", headerName: "名称", flex: 1, editable: true }
   ],
   rowData: [{ id: "1", name: "MachTable" }],
   rowKey: "id",
   enableColumnResize: true,
-  stateKey: "customer-list"
+  persistence: { key: "tenant:user:customers", sections: ["columns"] }
 });
 
-// Required for native integrations when the host is removed.
-api.destroy();
-```
-
-Complex business workflows use first-class APIs instead of adapter-specific glue:
-
-```ts
-const state = api.getState();
-await api.saveChanges((changes) => orderApi.save(changes));
-api.rollbackChanges();
-console.info(api.getDiagnostics());
-
-await api.applyTransactionAsync({ update: realtimeRows });
-api.applyState(state);
-```
-
-0.23 adds governed domain APIs, incremental update invalidation and bounded remote-resource scheduling without removing the flat 0.x API:
-
-```ts
 api.batch((grid) => {
-  grid.rows.apply({ update: changedRows });
+  grid.rows.transact({ update: [{ id: "1", name: "Updated" }] });
   grid.columns.setVisible("internalNote", false);
-  grid.refreshCells({ rowIds: changedIds, columns: ["status"] });
+  grid.view.refreshCells({ rowIds: ["1"] });
 });
 
-console.info(api.diagnostics.get().updates);
-```
-
-For very large remote datasets, opt into random-access blocks. Sequential infinite loading remains the compatibility default:
-
-```ts
-const options = {
-  datasource,
-  datasourceMode: "block" as const,
-  datasourceRowCount: 1_000_000,
-  blockSize: 200,
-  maxBlocksInCache: 12,
-  blockPrefetch: 1
-};
-
-await api.rows.ensureLoaded(40_000, 40_200, { signal });
-console.info(api.rows.getCacheSnapshot());
-```
-
-Worker runtime helpers are intentionally split from the default entry:
-
-```ts
-import { createWorkerDataProcessor, installGridDataWorker } from "@agile-team/mach-table/worker";
-```
-
-0.18 added governed runtime APIs, nested filters, named views, conflict-aware saves and performance evidence:
+const saved = await api.editing.save(orderApi.saveChanges);
+console.table(saved.conflicts);
+console.info(api.diagnostics.get());
 
-```ts
-const views = createGridViewManager(api, { scope: "tenant:user:orders" });
-await views.save("My pending orders");
-
-const result = await api.saveChangesDetailed(orderApi.saveChanges);
-console.table(result.failures);
-console.table(result.conflicts);
-console.info(api.getDiagnostics().performance);
+// 原生宿主卸载时必须销毁；Vue/React 适配器会自动处理。
+api.destroy();
 ```
 
-`GridState` v1 inputs migrate to v2 automatically. `GridFeature` manifests can declare `version`, `requires` and `conflicts`; invalid graphs are isolated before setup side effects run. JavaScript/JSON option patches are sanitized from the same metadata registry used by Core and framework adapters.
-
-0.13 added a built-in/headless column workbench and cancellable lazy trees:
-
-```ts
-api.openColumnWorkbench();
-const columns = api.getColumnWorkbenchItems();
-
-const treeOptions = {
-  treeData: true,
-  isTreeRowExpandable: ({ data }) => data.hasChildren,
-  loadTreeChildren: ({ data, signal }) => catalogApi.children(data.id, { signal })
-};
-```
+`persistence.sections` 同时约束进入 store 的数据与恢复范围；异步 store 写入有序，晚到加载不会覆盖加载期间的用户操作。
 
-XLSX stays outside Core; install `@agile-team/mach-table-xlsx` only on Excel routes.
+公共命令按 `rows`、`columns`、`selection`、`editing`、`filtering`、`sorting`、`pagination`、`hierarchy`、`view`、`state`、`io`、`diagnostics` 划分。完整签名见 [GridApi](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/api/grid-api.md)。
 
-Polished editing and row actions are built in rather than adapter-specific:
+大型本地数据 Worker 使用独立入口：
 
 ```ts
-import { rowActionsColumn } from "@agile-team/mach-table";
-
-const options = {
-  editType: "fullRow" as const,
-  columnDefs: [
-    { field: "name", editable: true },
-    { field: "age", editable: true, cellEditor: "number" },
-    rowActionsColumn({ onView, onDelete, overflow: "drawer" })
-  ]
-};
+import { createWorkerDataProcessor } from "@agile-team/mach-table/worker";
 ```
 
-Cell mode remains the default and renders a subtle pencil plus inline confirm/cancel controls. Use `editableIndicator: "always" | "hover" | "none"` to match the page density.
-
-0.14 removes common page glue with automatic GridState persistence, an explicit error overlay, compact row keys and framework-neutral toolbar commands:
-
-```ts
-import { createMachTableCommands } from "@agile-team/mach-table";
-
-const commands = createMachTableCommands({ getApi: () => api });
-commands.search("pending");
-await commands.refresh();
-
-api.setOverlay("error", () => "Request failed. Please retry.");
-```
-
-`rowKey: "id"` is shorthand for a stable field path; `getRowId` remains available for derived IDs and wins when both are present. `domLayout: "autoHeight"` is intended only for small client-side tables—normal virtual layout remains the large-data default.
-
-Column resizing is deliberately opt-in. Set `enableColumnResize: true`; add `stateKey` to remember the complete workspace, or `columnStateKey` to remember only widths/order/visibility/pinning/sort. Pointer cancellation rolls back, completed drags persist once, and untouched automatic/flex columns remain responsive.
-
-For framework applications use the official adapters:
-
-- Vue 3: [`@agile-team/mach-table-vue`](https://www.npmjs.com/package/@agile-team/mach-table-vue)
-- React 18+: [`@agile-team/mach-table-react`](https://www.npmjs.com/package/@agile-team/mach-table-react)
+Vue/React 项目请只安装对应适配包，它会自动安装并重导出 Core：
 
-Documentation: [Quick start](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/getting-started.md) · [Enterprise integration](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/enterprise-integration.md) · [API](https://github.com/ChenyCHENYU/MachTable/tree/main/docs/api)
+- [@agile-team/mach-table-vue](https://www.npmjs.com/package/@agile-team/mach-table-vue)
+- [@agile-team/mach-table-react](https://www.npmjs.com/package/@agile-team/mach-table-react)
 
-> Overlay strings render as text by default. Prefer HTMLElement factories for rich content; enable `allowUnsafeOverlayHtml` only for fully trusted static markup.
+文档：[快速开始](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/getting-started.md) · [企业接入](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/enterprise-integration.md) · [API](https://github.com/ChenyCHENYU/MachTable/tree/main/docs/api)
 
-Source-available © ChenyCHENYU (Agile Team). Any use requires prior written authorization. See the [license](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSE) and [authorization process](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSING.md).
+Source-available © ChenyCHENYU (Agile Team). 任何使用均须事先取得书面授权。详见 [LICENSE](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSE) 与[授权流程](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSING.md)。

package/dist/adapter.cjs

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var C=(e,n)=>{for(var t in n)f(e,t,{get:n[t],enumerable:!0})},w=(e,n,t,o)=>{if(n&&typeof n=="object"||typeof n=="function")for(let a of h(n))!D.call(e,a)&&a!==t&&f(e,a,{get:()=>n[a],enumerable:!(o=O(n,a))||o.enumerable});return e};var M=e=>w(f({},"__esModule",{value:!0}),e);var S={};C(S,{GRID_OPTION_KEYS:()=>g,GRID_OPTION_META:()=>c,mergeMachTableConfig:()=>T,normalizeMachTableConfig:()=>k,resolveMachTableGridOptions:()=>y});module.exports=M(S);var c={columnDefs:{kind:"array",update:"columnDefs"},rowData:{kind:"array",update:"rowData"},defaultColDef:{kind:"object",update:"options"},columnTypes:{kind:"object",update:"options"},rowKey:{kind:"unknown",update:"options"},rowHeight:{kind:"number",update:"options"},headerHeight:{kind:"number",update:"options"},rowBuffer:{kind:"number",update:"options"},columnLayout:{kind:"string",update:"options"},enableColumnResize:{kind:"boolean",update:"options"},domLayout:{kind:"string",update:"options"},rowSelection:{kind:"string",update:"options"},multiSort:{kind:"boolean",update:"options"},size:{kind:"string",update:"options"},stripedRows:{kind:"boolean",update:"options"},showCellBorders:{kind:"boolean",update:"options"},theme:{kind:"string",update:"options"},quickFilterText:{kind:"string",update:"quickFilter"},advancedFilterModel:{kind:"object",update:"options"},masterDetail:{kind:"boolean",update:"options"},detailRowHeight:{kind:"number",update:"options"},detailRowRenderer:{kind:"function",update:"options"},isRowExpandable:{kind:"function",update:"options"},detailToggleColumn:{kind:"boolean",update:"options"},columnMenu:{kind:"boolean",update:"options"},aggFuncs:{kind:"object",update:"options"},components:{kind:"object",update:"options"},actionPolicy:{kind:"object",update:"options"},features:{kind:"array",update:"options"},initialState:{kind:"object",update:"options"},persistence:{kind:"boolean-object",update:"options"},locale:{kind:"object",update:"options"},editType:{kind:"string",update:"options"},editableIndicator:{kind:"string",update:"options"},rowEditValidator:{kind:"function",update:"options"},singleClickEdit:{kind:"boolean",update:"options"},manualSorting:{kind:"boolean",update:"options"},manualFiltering:{kind:"boolean",update:"options"},showSummary:{kind:"boolean",update:"options"},summaryMethod:{kind:"function",update:"options"},treeData:{kind:"boolean",update:"options"},childrenKey:{kind:"string",update:"options"},isTreeRowExpandable:{kind:"function",update:"options"},loadTreeChildren:{kind:"function",update:"options"},autoCheckedChildren:{kind:"boolean",update:"options"},defaultExpandAll:{kind:"boolean",update:"options"},indexOffset:{kind:"number",update:"options"},applyRowDrag:{kind:"boolean",update:"options"},undoStackSize:{kind:"number",update:"options"},asyncTransactionWaitMillis:{kind:"number",update:"options"},getRowHeight:{kind:"function",update:"options"},pinnedTopRowData:{kind:"array",update:"options"},pinnedBottomRowData:{kind:"array",update:"options"},pagination:{kind:"boolean-object",update:"options"},watermark:{kind:"boolean-object",update:"options"},suppressWarnings:{kind:"boolean",update:"options"},enableRangeSelection:{kind:"boolean",update:"options"},suppressClipboard:{kind:"boolean",update:"options"},contextMenu:{kind:"boolean",update:"options"},getContextMenuItems:{kind:"function",update:"options"},tooltipComponent:{kind:"function",update:"options"},tooltipShowDelay:{kind:"number",update:"options"},flashCells:{kind:"boolean",update:"options"},fillHandle:{kind:"boolean",update:"options"},statusBar:{kind:"boolean-object",update:"options"},datasource:{kind:"object",update:"options"},datasourceMode:{kind:"string",update:"options"},blockSize:{kind:"number",update:"options"},infiniteBufferRows:{kind:"number",update:"options"},maxBlocksInCache:{kind:"number",update:"options"},datasourceMaxConcurrentRequests:{kind:"number",update:"options"},blockPrefetch:{kind:"number",update:"options"},datasourceRowCount:{kind:"number",update:"options"},dataProcessor:{kind:"object",update:"options"},dataProcessorMinRows:{kind:"number",update:"options"},datasourceRetryCount:{kind:"number",update:"options"},datasourceRetryDelay:{kind:"number",update:"options"},datasourceRetryJitter:{kind:"number",update:"options"},suppressCellFocus:{kind:"boolean",update:"options"},suppressRowHoverHighlight:{kind:"boolean",update:"options"},suppressNoRowsOverlay:{kind:"boolean",update:"options"},suppressHeaderFocus:{kind:"boolean",update:"options"},ariaLabel:{kind:"string",update:"options"},ariaLabelledBy:{kind:"string",update:"options"},ariaDescribedBy:{kind:"string",update:"options"},loading:{kind:"boolean",update:"options"},error:{kind:"unknown",update:"options"},overlayNoRowsTemplate:{kind:"unknown",update:"options"},overlayLoadingTemplate:{kind:"unknown",update:"options"},overlayErrorTemplate:{kind:"unknown",update:"options"},allowUnsafeOverlayHtml:{kind:"boolean",update:"options"},className:{kind:"string",update:"options"}},g=Object.freeze(Object.keys(c)),v=Object.freeze(g.filter(e=>c[e].update==="options"));function b(e,n){return n===void 0?e:typeof n!="object"||n===null||typeof e!="object"||e===null?n:{...e,...n}}function R(e,n){return typeof e!="function"?n:typeof n!="function"?e:(...t)=>{let o;try{e(...t)}catch(a){o=a}try{n(...t)}catch(a){o??(o=a)}if(o!==void 0)throw o}}function P(e,n){let t={...e,...n,features:n.features??e.features};if((e.defaultColDef||n.defaultColDef)&&(t.defaultColDef={...e.defaultColDef,...n.defaultColDef}),(e.locale||n.locale)&&(t.locale={...e.locale,...n.locale}),(e.components||n.components)&&(t.components={cellRenderers:{...e.components?.cellRenderers,...n.components?.cellRenderers},cellEditors:{...e.components?.cellEditors,...n.components?.cellEditors}}),e.columnTypes||n.columnTypes){let o={};for(let a of new Set([...Object.keys(e.columnTypes??{}),...Object.keys(n.columnTypes??{})]))o[a]={...e.columnTypes?.[a],...n.columnTypes?.[a]};t.columnTypes=o}(e.aggFuncs||n.aggFuncs)&&(t.aggFuncs={...e.aggFuncs,...n.aggFuncs}),t.pagination=b(e.pagination,n.pagination),t.statusBar=b(e.statusBar,n.statusBar),t.watermark=b(e.watermark,n.watermark);for(let o of new Set([...Object.keys(e),...Object.keys(n)])){if(!/^on[A-Z]/.test(o))continue;let a=e[o],i=n[o];typeof a=="function"&&typeof i=="function"&&(t[o]=R(a,i))}return t}function p(...e){return e.reduce(P,{})}function G(e){return e?(Array.isArray(e)?e:[e]).filter(n=>typeof n=="string"&&n.trim().length>0):[]}var E=new Set(["rowData","columnDefs","datasource","loading","error","initialState","persistence","components","columnTypes","stateKey","stateStore","stateSaveDebounceMs","columnStateKey","columnStateStore"]);function m(e,n,t){if(!n||typeof n!="object"||Array.isArray(n))return{};let o={};for(let[a,i]of Object.entries(n)){if(!E.has(a)){o[a]=i;continue}let d={code:t==="defaults"?"INVALID_DEFAULT_OPTION":"INVALID_PRESET_OPTION",option:a,layer:t,message:`[MachTable] "${a}" is instance-only and cannot be declared in config ${t}.`};if(e.onConfigWarning?.(d),e.strict!==!1)throw new TypeError(d.message)}return o}function k(e={}){let n=m(e,e.defaults,"defaults");return{defaults:p({columnTypes:e.columnTypes,components:e.components},n),presets:Object.fromEntries(Object.entries(e.presets??{}).map(([t,o])=>[t,p(m(e,o,`preset:${t}`))])),defaultPreset:e.defaultPreset??!1,strict:e.strict!==!1,...e.onConfigWarning?{onConfigWarning:e.onConfigWarning}:{}}}function T(e,n){let t=k({...n,strict:n.strict??e.strict,onConfigWarning:n.onConfigWarning??e.onConfigWarning}),o={...e.presets};for(let[a,i]of Object.entries(t.presets))o[a]=p(e.presets[a]??{},i);return{defaults:p(e.defaults,t.defaults),presets:o,defaultPreset:n.defaultPreset===void 0?e.defaultPreset:n.defaultPreset,strict:n.strict??e.strict,...n.onConfigWarning??e.onConfigWarning?{onConfigWarning:n.onConfigWarning??e.onConfigWarning}:{}}}function y(e,n,t,o){let a=n===void 0?e.defaultPreset:n,i=[{name:"application defaults",options:e.defaults}];for(let r of G(a)){let s=e.presets[r];if(!s){let l={code:"UNKNOWN_PRESET",preset:r,message:`[MachTable] Unknown preset "${r}". Register it in mach-table.config.ts or remove the preset.`};o?o(l):e.onConfigWarning?e.onConfigWarning(l):console.warn(l.message);continue}i.push({name:`preset:${r}`,options:s})}i.push({name:"table props",options:t});let d=p(...i.map(r=>r.options));return{options:d,explain(r){let s=i.filter(u=>Object.prototype.hasOwnProperty.call(u.options,r)).map(u=>({name:u.name,value:u.options[r]})),l=s[s.length-1];return{key:r,value:d[r],source:l?.name??"MachTable built-in",layers:s}}}}0&&(module.exports={GRID_OPTION_KEYS,GRID_OPTION_META,mergeMachTableConfig,normalizeMachTableConfig,resolveMachTableGridOptions});

package/dist/adapter.d.cts

@@ -0,0 +1,384 @@
+import { G as GridOptions, a as GridEventType } from './options-CL6BYXVZ.cjs';
+export { M as MachTableOptionExplanation, R as ResolvedMachTableConfig, a as ResolvedMachTableGridOptions, m as mergeMachTableConfig, n as normalizeMachTableConfig, r as resolveMachTableGridOptions } from './configuration-DmUvpJLO.cjs';
+
+type EventOptionKey = `on${Capitalize<GridEventType>}`;
+type GridOptionKey = Exclude<keyof GridOptions<any>, EventOptionKey>;
+/**
+ * Runtime single source of truth for every non-event GridOptions property.
+ *
+ * The mapped `satisfies` type intentionally makes adding a GridOptions field a
+ * compile error until its adapter/update behavior is declared here.
+ */
+declare const GRID_OPTION_META: {
+    readonly columnDefs: {
+        readonly kind: "array";
+        readonly update: "columnDefs";
+    };
+    readonly rowData: {
+        readonly kind: "array";
+        readonly update: "rowData";
+    };
+    readonly defaultColDef: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly columnTypes: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly rowKey: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly rowHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly headerHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly rowBuffer: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly columnLayout: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly enableColumnResize: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly domLayout: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly rowSelection: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly multiSort: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly size: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly stripedRows: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly showCellBorders: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly theme: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly quickFilterText: {
+        readonly kind: "string";
+        readonly update: "quickFilter";
+    };
+    readonly advancedFilterModel: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly masterDetail: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly detailRowHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly detailRowRenderer: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly isRowExpandable: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly detailToggleColumn: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly columnMenu: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly aggFuncs: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly components: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly actionPolicy: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly features: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly initialState: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly persistence: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly locale: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly editType: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly editableIndicator: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly rowEditValidator: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly singleClickEdit: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly manualSorting: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly manualFiltering: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly showSummary: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly summaryMethod: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly treeData: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly childrenKey: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly isTreeRowExpandable: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly loadTreeChildren: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly autoCheckedChildren: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly defaultExpandAll: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly indexOffset: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly applyRowDrag: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly undoStackSize: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly asyncTransactionWaitMillis: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly getRowHeight: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly pinnedTopRowData: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly pinnedBottomRowData: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly pagination: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly watermark: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly suppressWarnings: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly enableRangeSelection: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressClipboard: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly contextMenu: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly getContextMenuItems: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly tooltipComponent: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly tooltipShowDelay: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly flashCells: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly fillHandle: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly statusBar: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly datasource: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly datasourceMode: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly blockSize: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly infiniteBufferRows: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly maxBlocksInCache: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceMaxConcurrentRequests: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly blockPrefetch: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRowCount: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly dataProcessor: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly dataProcessorMinRows: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryCount: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryDelay: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryJitter: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly suppressCellFocus: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressRowHoverHighlight: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressNoRowsOverlay: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressHeaderFocus: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly ariaLabel: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly ariaLabelledBy: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly ariaDescribedBy: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly loading: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly error: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayNoRowsTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayLoadingTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayErrorTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly allowUnsafeOverlayHtml: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly className: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+};
+declare const GRID_OPTION_KEYS: readonly GridOptionKey[];
+
+export { GRID_OPTION_KEYS, GRID_OPTION_META };