@ace-grid/mcp 1.0.8 → 1.0.9

package/data/apiSpecCoverage.json

@@ -1,14 +1,14 @@
 {
-  "generatedAt": "2026-05-20T00:24:07.586Z",
+  "generatedAt": "2026-06-13T20:16:12.193Z",
   "rootInterface": "GridProps",
   "propCoverage": {
-    "generatedCount": 862,
-    "authoredSpecCount": 332,
-    "exactSpecCount": 217,
+    "generatedCount": 864,
+    "authoredSpecCount": 334,
+    "exactSpecCount": 219,
     "prefixSpecCount": 115,
-    "exactCoveredCount": 217,
+    "exactCoveredCount": 219,
     "prefixCoveredCount": 637,
-    "coveredCount": 854,
+    "coveredCount": 856,
     "missingCount": 8,
     "orphanCount": 0,
     "coveragePercent": 99.1,
@@ -294,6 +294,17 @@
       "coveragePercent": 100,
       "missingPropPathsPreview": []
     },
+    {
+      "key": "virtual",
+      "label": "Virtual",
+      "totalProps": 5,
+      "authoredProps": 5,
+      "exactCoveredProps": 5,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
     {
       "key": "clipboard",
       "label": "Clipboard",
@@ -338,17 +349,6 @@
       "coveragePercent": 100,
       "missingPropPathsPreview": []
     },
-    {
-      "key": "virtual",
-      "label": "Virtual",
-      "totalProps": 3,
-      "authoredProps": 3,
-      "exactCoveredProps": 3,
-      "prefixCoveredProps": 0,
-      "missingProps": 0,
-      "coveragePercent": 100,
-      "missingPropPathsPreview": []
-    },
     {
       "key": "accessibility",
       "label": "Accessibility",

package/data/apiSpecQuality.json

@@ -1,7 +1,7 @@
 {
-  "generatedAt": "2026-05-20T00:24:09.606Z",
+  "generatedAt": "2026-06-13T20:16:16.257Z",
   "propQuality": {
-    "checkedCount": 860,
+    "checkedCount": 862,
     "errorCount": 0,
     "warningCount": 0,
     "errorsPreview": [],

package/data/docsIndex.json

@@ -4124,17 +4124,18 @@
     },
     {
       "category": "Foundation",
-      "content": "Virtual\nVirtual\nFoundation guide\nVirtualization controls how much of the grid stays mounted at once. In most cases, leave it on.\nUse the live example to compare settings, then lift the matching `virtual` block into your own gridProps object.\nFoundation\nVirtual\nVirtualization strategy flags\nVirtualization controls how much of the grid stays mounted at once. It reduces browser work on long or wide grids.\nKeep all three virtual settings on for most production grids.\nOnly turn one off when a custom cell or embedded widget truly needs a wider mounted window.\nTurn row virtualization off and compare the mounted row count against the default mode.\nTurn horizontal virtualization off and compare the mounted column count on the same wide grid.\nTurn cell-content virtualization off and compare how many heavy cells stay mounted.\nTreat virtualization as a performance setting, not a visual feature.\nValidate custom cell renderers early. They are the most common reason teams try to change virtualization defaults.\nvirtual.enableVirtualization\nenableVirtualization\nboolean\nvirtual.enableHorizontalVirtualization\nenableHorizontalVirtualization\nboolean\nvirtual.enableCellContentVirtualization\nenableCellContentVirtualization\nboolean",
+      "content": "Virtual\nVirtual\nFoundation guide\nVirtualization controls how much of the grid stays mounted at once. Keep it on in most cases, and tune row or column buffers only when measured scrolling behavior requires it.\nUse the live example to compare settings, then lift the matching `virtual` block into your own gridProps object.\nFoundation\nVirtual\nVirtualization strategy flags\nVirtualization controls how much of the grid stays mounted at once. It reduces browser work on long or wide grids.\nKeep row and horizontal virtualization on for most production grids. Cell-content virtualization is off by default and should be enabled only for measurably expensive cell renderers.\nStart with the default buffers. Increase them only when fast scrolling exposes blank work, or reduce them when mounted DOM cost is the bottleneck.\nTurn row virtualization off and compare the mounted row count against the default mode.\nTurn horizontal virtualization off and compare the mounted column count on the same wide grid.\nTurn cell-content virtualization on and compare how many heavy cells stay mounted.\nChange row and column buffers separately, then repeat the same wheel, trackpad, keyboard, and scrollbar-drag tests.\nTreat virtualization as a performance setting, not a visual feature.\nValidate custom cell renderers early. They are the most common reason teams try to change virtualization defaults.\nvirtual.enableVirtualization\nenableVirtualization\nboolean\nvirtual.enableHorizontalVirtualization\nenableHorizontalVirtualization\nboolean\nvirtual.enableCellContentVirtualization\nenableCellContentVirtualization\nboolean\nDefers heavy inner cell content until visible. Disabled by default.\nvirtual.rowBufferPx\nrowBufferPx\nnumber\nExtra vertical pixels rendered before and after the visible row window.\nvirtual.columnBufferPx\ncolumnBufferPx\nnumber\nExtra horizontal pixels rendered before and after the visible column window.",
       "guide": {
         "whatItMeans": "Virtualization controls how much of the grid stays mounted at once. It reduces browser work on long or wide grids.",
         "whenToUse": [
-          "Keep all three virtual settings on for most production grids.",
-          "Only turn one off when a custom cell or embedded widget truly needs a wider mounted window."
+          "Keep row and horizontal virtualization on for most production grids. Cell-content virtualization is off by default and should be enabled only for measurably expensive cell renderers.",
+          "Start with the default buffers. Increase them only when fast scrolling exposes blank work, or reduce them when mounted DOM cost is the bottleneck."
         ],
         "howToTry": [
           "Turn row virtualization off and compare the mounted row count against the default mode.",
           "Turn horizontal virtualization off and compare the mounted column count on the same wide grid.",
-          "Turn cell-content virtualization off and compare how many heavy cells stay mounted."
+          "Turn cell-content virtualization on and compare how many heavy cells stay mounted.",
+          "Change row and column buffers separately, then repeat the same wheel, trackpad, keyboard, and scrollbar-drag tests."
         ],
         "implementationNotes": [
           "Treat virtualization as a performance setting, not a visual feature.",
@@ -4155,9 +4156,19 @@
           "type": "boolean"
         },
         {
-          "description": "",
+          "description": "Defers heavy inner cell content until visible. Disabled by default.",
           "path": "virtual.enableCellContentVirtualization",
           "type": "boolean"
+        },
+        {
+          "description": "Extra vertical pixels rendered before and after the visible row window.",
+          "path": "virtual.rowBufferPx",
+          "type": "number"
+        },
+        {
+          "description": "Extra horizontal pixels rendered before and after the visible column window.",
+          "path": "virtual.columnBufferPx",
+          "type": "number"
         }
       ],
       "slug": "virtual",
@@ -4218,7 +4229,7 @@
       "summary": "Web Components uses one runtime-neutral wrapper package. Register the custom element with `@ace-grid/core`, `@ace-grid/pro`, or `@ace-grid/enterprise` explicitly."
     }
   ],
-  "generatedAt": "2026-05-30T06:12:06.817Z",
+  "generatedAt": "2026-06-13T20:04:06.168Z",
   "pages": [
     {
       "category": "Foundation",

package/data/formulaFunctionSnapshot.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-20T00:24:07.079Z",
+  "generatedAt": "2026-06-13T20:16:11.300Z",
   "exportedConstant": "FORMULA_FUNCTIONS",
   "functionCount": 152,
   "categoryCount": 9,

package/data/gridApiSnapshot.json

@@ -1,8 +1,8 @@
 {
-  "generatedAt": "2026-05-20T00:24:07.049Z",
+  "generatedAt": "2026-06-13T20:16:11.265Z",
   "rootInterface": "GridProps",
   "featureGroupCount": 32,
-  "propCount": 862,
+  "propCount": 864,
   "featureGroups": [
     {
       "key": "license",
@@ -626,8 +626,8 @@
       "description": "Virtualization strategy flags",
       "typeName": "GridVirtualProps",
       "optional": true,
-      "directPropCount": 3,
-      "propCount": 3,
+      "directPropCount": 5,
+      "propCount": 5,
       "props": [
         {
           "name": "enableVirtualization",
@@ -649,7 +649,23 @@
           "name": "enableCellContentVirtualization",
           "path": "virtual.enableCellContentVirtualization",
           "type": "boolean",
-          "description": "",
+          "description": "Defers heavy inner cell content until visible. Disabled by default.",
+          "optional": true,
+          "depth": 1
+        },
+        {
+          "name": "rowBufferPx",
+          "path": "virtual.rowBufferPx",
+          "type": "number",
+          "description": "Extra vertical pixels rendered before and after the visible row window.",
+          "optional": true,
+          "depth": 1
+        },
+        {
+          "name": "columnBufferPx",
+          "path": "virtual.columnBufferPx",
+          "type": "number",
+          "description": "Extra horizontal pixels rendered before and after the visible column window.",
           "optional": true,
           "depth": 1
         }
@@ -8883,7 +8899,7 @@
       "kind": "interface",
       "description": "VIRTUALIZATION",
       "file": "src/types.ts",
-      "code": "export interface GridVirtualProps {\n  enableVirtualization?: boolean;\n  enableHorizontalVirtualization?: boolean;\n  enableCellContentVirtualization?: boolean;\n}"
+      "code": "export interface GridVirtualProps {\n  enableVirtualization?: boolean;\n  enableHorizontalVirtualization?: boolean;\n  /** Defers heavy inner cell content until visible. Disabled by default. */\n  enableCellContentVirtualization?: boolean;\n  /** Extra vertical pixels rendered before and after the visible row window. */\n  rowBufferPx?: number;\n  /** Extra horizontal pixels rendered before and after the visible column window. */\n  columnBufferPx?: number;\n}"
     },
     "GridRowsProps": {
       "name": "GridRowsProps",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ace-grid/mcp",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "Model Context Protocol server for Ace Grid docs, API metadata, config validation, migration help, and framework examples.",
   "type": "module",
   "bin": {