Add AI integration docs and reorganize sidebar (#1644)

## Summary
- Add three new landing pages under Framework integration: HyperFormula
AI SDK, Integration with LangChain/LangGraph, and HyperFormula MCP
Server
- Rename sidebar "Overview" section to "About" and move it above
Miscellaneous (2nd to last)
- Promote "Getting started" to second position in sidebar (right after
Introduction)

## Test plan
- [ ] Run `npm run docs:dev` and verify sidebar order: Introduction →
Getting started → Framework integration → ... → About → Miscellaneous
- [ ] Verify new pages render at `/guide/ai-sdk`,
`/guide/integration-with-langchain`, `/guide/mcp-server`
- [ ] Verify existing Overview pages (Quality, Supported browsers, etc.)
still accessible at original URLs

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Low risk: documentation-only changes that add new guide pages and
reorder sidebar navigation without affecting runtime code.
> 
> **Overview**
> Adds three new guide pages describing AI-focused integrations:
`ai-sdk`, `integration-with-langchain`, and `mcp-server`.
> 
> Reorganizes the VuePress sidebar by renaming the prior *Overview*
section to **About**, moving it near the end, and renaming *Framework
integration* to **Integrations** while linking in the new AI docs pages.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
1688f23. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Kuba Sekowski <jakub.sekowski@handsontable.com>

Author: 3 people

docs/.vuepress/config.js

@@ -175,17 +175,6 @@ module.exports = {
             ['/guide/demo', 'Demo'],
           ]
         },
-        {
-          title: 'Overview',
-          collapsable: false,
-          children: [
-            ['/guide/quality', 'Quality'],
-            ['/guide/supported-browsers', 'Supported browsers'],
-            ['/guide/dependencies', 'Dependencies'],
-            ['/guide/licensing', 'Licensing'],
-            ['/guide/support', 'Support'],
-          ]
-        },
         {
           title: 'Getting started',
           collapsable: false,
@@ -199,13 +188,16 @@ module.exports = {
           ]
         },
         {
-          title: 'Framework integration',
+          title: 'Integrations',
           collapsable: false,
           children: [
             ['/guide/integration-with-react', 'Integration with React'],
             ['/guide/integration-with-vue', 'Integration with Vue'],
             ['/guide/integration-with-angular', 'Integration with Angular'],
             ['/guide/integration-with-svelte', 'Integration with Svelte'],
+            ['/guide/ai-sdk', 'HyperFormula AI SDK'],
+            ['/guide/integration-with-langchain', 'Integration with LangChain'],
+            ['/guide/mcp-server', 'HyperFormula MCP Server'],
           ]
         },
         {
@@ -276,6 +268,17 @@ module.exports = {
             ['/guide/migration-from-2.x-to-3.0', 'Migrating from 2.x to 3.0'],
           ]
         },
+        {
+          title: 'About',
+          collapsable: false,
+          children: [
+            ['/guide/quality', 'Quality'],
+            ['/guide/supported-browsers', 'Supported browsers'],
+            ['/guide/dependencies', 'Dependencies'],
+            ['/guide/licensing', 'Licensing'],
+            ['/guide/support', 'Support'],
+          ]
+        },
         {
           title: 'Miscellaneous',
           collapsable: false,

docs/guide/ai-sdk.md

@@ -0,0 +1,51 @@
+# HyperFormula AI SDK
+
+Let LLMs safely read/write spreadsheets and compute formulas via a deterministic engine.
+
+## What it does
+
+- **Evaluate formulas on the fly** —call `calculateFormula()` to evaluate any Excel-compatible formula without placing it in a cell.
+- **Read and write cells and ranges** —get or set individual cells and multi-cell ranges so an LLM can inspect, populate, or modify sheet data programmatically.
+- **Trace dependencies** —call `getCellDependents()` and `getCellPrecedents()` to understand which cells feed into a formula and what downstream values would change.
+
+## Quickstart
+
+```js
+import HyperFormula from 'hyperformula';
+import { createSpreadsheetTools } from 'hyperformula/ai';
+
+// 1. Create a HyperFormula instance with initial data
+const hf = HyperFormula.buildFromArray([
+  ['Revenue', 100],
+  ['Cost',     60],
+  ['Profit', '=B1-B2'],
+]);
+
+// 2. Create tools your LLM agent can call
+const tools = createSpreadsheetTools(hf);
+
+// 3. Agent interaction examples
+tools.evaluate({ formula: '=IRR({-1000,300,400,500,200})' });
+// → 0.1189 — deterministic, no LLM math
+
+tools.setCellContents({ sheet: 0, col: 1, row: 0, value: 200 });
+tools.getRange({ sheet: 0, startCol: 0, startRow: 0, endCol: 1, endRow: 2 });
+// → [['Revenue', 200], ['Cost', 60], ['Profit', 140]]
+
+// Agent: "What drives the profit number?"
+tools.getDependents({ sheet: 0, col: 1, row: 0 });
+// → [{ sheet: 0, col: 1, row: 2 }] — Revenue flows into Profit
+```
+
+## Use cases
+
+- **Explain a sheet** —ask an agent to summarize what a spreadsheet does, which cells are inputs, and how outputs are derived.
+- **Generate a what-if scenario** —let the model tweak assumptions (price, volume, rate) and observe how results change in real time.
+- **Validate and clean data** —have the agent scan ranges for errors, missing values, or inconsistencies and fix them with formulas or direct edits.
+- **Create formulas from natural language** —describe a calculation in plain English and let the model write and verify the correct Excel formula.
+
+## Beta access
+
+::: tip
+[Sign up for beta access](https://2fmjvg.share-eu1.hsforms.com/2e6drCkuLTn-1RuiYB91eJA)
+:::

docs/guide/integration-with-langchain.md

@@ -0,0 +1,53 @@
+# Integration with LangChain/LangGraph
+
+A LangChain/LangGraph tool that gives AI agents deterministic, Excel-compatible formula evaluation instead of relying on LLM-generated math.
+
+## What it does
+
+**Without HyperFormula:**
+
+```python
+result = llm.invoke(
+    "Calculate the IRR for these cash flows: [-1000, 300, 400, 500, 200]"
+)
+# "The IRR is approximately 12.4%" ← non-deterministic, unverifiable
+```
+
+**With HyperFormula tool:**
+
+```python
+from langchain_core.tools import tool
+from hyperformula import HyperFormula
+
+hf = HyperFormula.build_from_array([[-1000, 300, 400, 500, 200]])
+
+@tool
+def evaluate_formula(formula: str) -> str:
+    """Evaluate an Excel-compatible formula using HyperFormula."""
+    return hf.calculate_formula(formula, sheet_id=0)
+
+agent = create_react_agent(llm, [evaluate_formula])
+
+# Agent calls: evaluate_formula("=IRR(A1:E1)")
+# → 0.1189 ← deterministic, auditable
+```
+
+## How it works
+
+1. **Agent populates a HyperFormula sheet** —writes data and formulas (`=SUM`, `=IF`, `=VLOOKUP`, etc.) into cells.
+2. **HyperFormula evaluates deterministically** —resolves the full dependency graph using 400+ built-in functions. No LLM in the loop for math.
+3. **Agent continues with verified data** —computed values flow back into the chain for reasoning, reporting, or downstream actions.
+
+## Use cases
+
+- Financial modeling (NPV, IRR, amortization)
+- Data transformation and aggregation (SUMIF, VLOOKUP)
+- Dynamic pricing with formula-defined logic
+- What-if scenarios and forecasting
+- Report generation with verified KPIs
+
+## Beta access
+
+::: tip
+[Sign up for beta access](https://2fmjvg.share-eu1.hsforms.com/2e6drCkuLTn-1RuiYB91eJA)
+:::

docs/guide/mcp-server.md

@@ -0,0 +1,44 @@
+# HyperFormula MCP Server
+
+An MCP (Model Context Protocol) server that exposes HyperFormula as a tool for any MCP-compatible AI client, giving LLMs deterministic spreadsheet computation.
+
+## What it does
+
+- **Evaluate formulas** —any MCP client can call HyperFormula to evaluate Excel-compatible formulas and get exact results.
+- **Read and write cells** —get or set individual cell values and ranges through standard MCP tool calls.
+- **Inspect dependencies** —trace which cells a formula depends on and understand the calculation graph.
+
+**Without HyperFormula:**
+
+```
+User: What's the NPV at 8% for these cash flows?
+Agent: "Approximately $142.50" ← non-deterministic, unverifiable
+```
+
+**With HyperFormula MCP server:**
+
+```
+User: What's the NPV at 8% for these cash flows?
+Agent → tool call: evaluate("=NPV(0.08, B1:B5)")
+Agent: "$138.43" ← deterministic, auditable
+```
+
+## How it works
+
+1. **Start the MCP server** —runs HyperFormula as a local MCP server that any compatible client (Claude Desktop, Cursor, VS Code, etc.) can connect to.
+2. **Client sends tool calls** —the AI client calls tools like `evaluate`, `getCellValue`, and `setCellContents` via the MCP protocol.
+3. **HyperFormula evaluates deterministically** —resolves formulas using 400+ built-in functions with full dependency tracking. No LLM in the loop for math.
+4. **Results flow back to the client** —computed values return through MCP, grounding the AI's response in verified numbers.
+
+## Use cases
+
+- Spreadsheet Q&A in Claude Desktop or other MCP clients
+- Formula evaluation in IDE-based AI assistants
+- Financial calculations in chat-based agent workflows
+- Data validation and transformation via natural language
+
+## Beta access
+
+::: tip
+[Sign up for beta access](https://2fmjvg.share-eu1.hsforms.com/2e6drCkuLTn-1RuiYB91eJA)
+:::