@ace-grid/mcp 1.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Grid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @ace-grid/mcp
+
+Ace Grid MCP is a local Model Context Protocol server for Ace Grid documentation, API metadata, config validation, migration help, framework example generation, and optional account/license automation.
+
+It is designed for MCP-compatible AI coding tools such as Claude Desktop, Cursor, Codex, and other clients that can launch a stdio MCP server.
+
+## Install
+
+```bash
+npm install -g @ace-grid/mcp
+```
+
+You can also run it without a global install:
+
+```bash
+npx @ace-grid/mcp
+```
+
+## MCP client configuration
+
+```json
+{
+  "mcpServers": {
+    "ace-grid": {
+      "command": "npx",
+      "args": ["@ace-grid/mcp"]
+    }
+  }
+}
+```
+
+For local development from this repository:
+
+```json
+{
+  "mcpServers": {
+    "ace-grid": {
+      "command": "node",
+      "args": ["/absolute/path/to/ace-grid-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## Local-first behavior
+
+Documentation, API search, config validation, implementation planning, and example generation use bundled metadata and run locally. Account tools call the Ace Grid portal API only when `ACE_GRID_PORTAL_TOKEN` is configured.
+
+```bash
+ACE_GRID_PORTAL_TOKEN=eyJ... ace-grid-mcp
+```
+
+Optional environment variables:
+
+- `ACE_GRID_API_BASE_URL`: Ace Grid API base URL. Defaults to `https://api.ace-grid.com`.
+- `ACE_GRID_PORTAL_TOKEN`: bearer token for authenticated account, app, and license-key operations.
+
+## Tools
+
+- `ace_grid_search_docs`: search bundled docs, guides, API metadata, and feature groups.
+- `ace_grid_search_api`: search generated Ace Grid API metadata.
+- `ace_grid_search_doc_pages`: search written docs page content.
+- `ace_grid_list_doc_pages`: list bundled docs pages.
+- `ace_grid_get_doc_page`: return a docs page by slug or path.
+- `ace_grid_list_feature_groups`: list feature groups and prop counts.
+- `ace_grid_get_prop`: inspect a prop path such as `layout.height`.
+- `ace_grid_validate_config`: report unknown and missing props in a config object.
+- `ace_grid_plan_implementation`: infer framework packages, required tier, matched features, docs, and props from a natural-language request.
+- `ace_grid_generate_implementation`: generate React, Angular, Vue, Svelte, or Web Components starter code.
+- `ace_grid_generate_react_example`: generate a React starter snippet for Core, Pro, or Enterprise.
+- `ace_grid_list_examples`: list bundled framework examples.
+- `ace_grid_generate_framework_example`: generate a bundled framework example.
+- `ace_grid_license_setup`: explain license config and public-key behavior.
+- `ace_grid_account_status`: optional authenticated account overview.
+- `ace_grid_list_apps`: optional authenticated app listing.
+- `ace_grid_create_app`: optional authenticated app creation.
+- `ace_grid_list_license_keys`: optional authenticated key listing.
+- `ace_grid_create_license_key`: optional authenticated key creation.
+
+## Publishing checklist
+
+Before publishing a new MCP version:
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+Refresh bundled metadata in `data/` whenever Ace Grid docs, API snapshots, feature groups, examples, or portal-generated metadata change.
+
+## License
+
+MIT. See the package license for details.

package/data/apiSpecCoverage.json

@@ -0,0 +1,408 @@
+{
+  "generatedAt": "2026-05-20T00:24:07.586Z",
+  "rootInterface": "GridProps",
+  "propCoverage": {
+    "generatedCount": 862,
+    "authoredSpecCount": 332,
+    "exactSpecCount": 217,
+    "prefixSpecCount": 115,
+    "exactCoveredCount": 217,
+    "prefixCoveredCount": 637,
+    "coveredCount": 854,
+    "missingCount": 8,
+    "orphanCount": 0,
+    "coveragePercent": 99.1,
+    "missingPathsPreview": [
+      "license.licenseKey",
+      "license.appId",
+      "license.apiBaseUrl",
+      "license.domain",
+      "license.leaseSigningPublicKey",
+      "license.runtime",
+      "license.version",
+      "license.fetchImpl"
+    ],
+    "orphanPaths": []
+  },
+  "typeCoverage": {
+    "usedCount": 233,
+    "needsAuthoredCount": 120,
+    "authoredCount": 127,
+    "missingCount": 1,
+    "orphanCount": 5,
+    "coveragePercent": 99.2,
+    "missingTypesPreview": [
+      "typeof fetch"
+    ],
+    "orphanTypes": [
+      "SortDirection",
+      "GridServerRowModelProps",
+      "GridFilterConfig",
+      "GridChartBrushActionOptions",
+      "GridChartRenderProps"
+    ]
+  },
+  "featureCoverage": [
+    {
+      "key": "license",
+      "label": "License",
+      "totalProps": 8,
+      "authoredProps": 0,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 0,
+      "missingProps": 8,
+      "coveragePercent": 0,
+      "missingPropPathsPreview": [
+        "license.licenseKey",
+        "license.appId",
+        "license.apiBaseUrl",
+        "license.domain",
+        "license.leaseSigningPublicKey",
+        "license.runtime",
+        "license.version",
+        "license.fetchImpl"
+      ]
+    },
+    {
+      "key": "sparkline",
+      "label": "Sparkline",
+      "totalProps": 322,
+      "authoredProps": 322,
+      "exactCoveredProps": 10,
+      "prefixCoveredProps": 312,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "charts",
+      "label": "Charts",
+      "totalProps": 192,
+      "authoredProps": 192,
+      "exactCoveredProps": 53,
+      "prefixCoveredProps": 139,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "serverRowModel",
+      "label": "Server Row Model",
+      "totalProps": 42,
+      "authoredProps": 42,
+      "exactCoveredProps": 21,
+      "prefixCoveredProps": 21,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "pagination",
+      "label": "Pagination",
+      "totalProps": 34,
+      "authoredProps": 34,
+      "exactCoveredProps": 23,
+      "prefixCoveredProps": 11,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "theming",
+      "label": "Theming",
+      "totalProps": 33,
+      "authoredProps": 33,
+      "exactCoveredProps": 2,
+      "prefixCoveredProps": 31,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "selection",
+      "label": "Selection",
+      "totalProps": 24,
+      "authoredProps": 24,
+      "exactCoveredProps": 17,
+      "prefixCoveredProps": 7,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "pinning",
+      "label": "Pinning",
+      "totalProps": 19,
+      "authoredProps": 19,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 16,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "validation",
+      "label": "Validation",
+      "totalProps": 18,
+      "authoredProps": 18,
+      "exactCoveredProps": 13,
+      "prefixCoveredProps": 5,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "contextMenu",
+      "label": "Context Menu",
+      "totalProps": 18,
+      "authoredProps": 18,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 15,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "scroll",
+      "label": "Scroll",
+      "totalProps": 15,
+      "authoredProps": 15,
+      "exactCoveredProps": 5,
+      "prefixCoveredProps": 10,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "search",
+      "label": "Search",
+      "totalProps": 14,
+      "authoredProps": 14,
+      "exactCoveredProps": 9,
+      "prefixCoveredProps": 5,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "masterDetail",
+      "label": "Master Detail",
+      "totalProps": 13,
+      "authoredProps": 13,
+      "exactCoveredProps": 7,
+      "prefixCoveredProps": 6,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "reorder",
+      "label": "Reorder",
+      "totalProps": 12,
+      "authoredProps": 12,
+      "exactCoveredProps": 5,
+      "prefixCoveredProps": 7,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "keyedHeaders",
+      "label": "Keyed Headers",
+      "totalProps": 11,
+      "authoredProps": 11,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 8,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "filter",
+      "label": "Filter",
+      "totalProps": 10,
+      "authoredProps": 10,
+      "exactCoveredProps": 6,
+      "prefixCoveredProps": 4,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "resize",
+      "label": "Resize",
+      "totalProps": 10,
+      "authoredProps": 10,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 7,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "sorting",
+      "label": "Sorting",
+      "totalProps": 9,
+      "authoredProps": 9,
+      "exactCoveredProps": 9,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "edit",
+      "label": "Edit",
+      "totalProps": 8,
+      "authoredProps": 8,
+      "exactCoveredProps": 4,
+      "prefixCoveredProps": 4,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "layout",
+      "label": "Layout",
+      "totalProps": 7,
+      "authoredProps": 7,
+      "exactCoveredProps": 5,
+      "prefixCoveredProps": 2,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "pivot",
+      "label": "Pivot",
+      "totalProps": 7,
+      "authoredProps": 7,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 7,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "treeData",
+      "label": "Tree Data",
+      "totalProps": 7,
+      "authoredProps": 7,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 7,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "clipboard",
+      "label": "Clipboard",
+      "totalProps": 5,
+      "authoredProps": 5,
+      "exactCoveredProps": 5,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "rowGrouping",
+      "label": "Row Grouping",
+      "totalProps": 5,
+      "authoredProps": 5,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 5,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "spanning",
+      "label": "Spanning",
+      "totalProps": 4,
+      "authoredProps": 4,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 4,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "columns",
+      "label": "Columns",
+      "totalProps": 3,
+      "authoredProps": 3,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "virtual",
+      "label": "Virtual",
+      "totalProps": 3,
+      "authoredProps": 3,
+      "exactCoveredProps": 3,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "accessibility",
+      "label": "Accessibility",
+      "totalProps": 3,
+      "authoredProps": 3,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 3,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "data",
+      "label": "Data",
+      "totalProps": 2,
+      "authoredProps": 2,
+      "exactCoveredProps": 2,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "formula",
+      "label": "Formula",
+      "totalProps": 2,
+      "authoredProps": 2,
+      "exactCoveredProps": 2,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "columnGrouping",
+      "label": "Column Grouping",
+      "totalProps": 1,
+      "authoredProps": 1,
+      "exactCoveredProps": 0,
+      "prefixCoveredProps": 1,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    },
+    {
+      "key": "rowsConfig",
+      "label": "Rows Config",
+      "totalProps": 1,
+      "authoredProps": 1,
+      "exactCoveredProps": 1,
+      "prefixCoveredProps": 0,
+      "missingProps": 0,
+      "coveragePercent": 100,
+      "missingPropPathsPreview": []
+    }
+  ]
+}

package/data/apiSpecQuality.json

@@ -0,0 +1,15 @@
+{
+  "generatedAt": "2026-05-20T00:24:09.606Z",
+  "propQuality": {
+    "checkedCount": 860,
+    "errorCount": 0,
+    "warningCount": 0,
+    "errorsPreview": [],
+    "warningsPreview": []
+  },
+  "typeQuality": {
+    "checkedCount": 231,
+    "warningCount": 0,
+    "warningsPreview": []
+  }
+}