@adaptabletools/adaptable-mcp 0.0.0-stage → 0.1.0-canary.0

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# AdapTable MCP Server
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [MCP](https://modelcontextprotocol.io) server that helps coding agents write correct [AdapTable](https://www.adaptabletools.com) code for the version a project actually uses.
+
+It looks things up and checks them; the agent still writes the code:
+
+- detects the project's AdapTable, framework and AG Grid versions, and flags setup mistakes
+- searches the docs for that version and framework
+- validates AdapTableQL expressions and Initial State with the installed AdapTable package
+- migrates expressions and state from older versions
+
+For AG Grid itself (column definitions, AG Grid modules, row models, grid API), use AG Grid's [ag-mcp](https://www.ag-grid.com/javascript-data-grid/mcp-server/) alongside this server.
+
+## Setup
+
+Requires Node 20+. The checks need AdapTable 24 or later installed in the project.
+
+Cursor (`.cursor/mcp.json`) and other clients that take an `mcpServers` map:
+
+```json
+{
+  "mcpServers": {
+    "adaptable": {
+      "command": "npx",
+      "args": ["-y", "@adaptabletools/adaptable-mcp"]
+    }
+  }
+}
+```
+
+Claude Code:
+
+```bash
+claude mcp add adaptable -- npx -y @adaptabletools/adaptable-mcp
+```
+
+The server finds the project from the client's workspace roots, then the current directory. Pass `projectPath` to any tool, or set `ADAPTABLE_MCP_PROJECT`, to point it elsewhere.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `detect_environment` | AdapTable and AG Grid packages, framework, peer range, documented AG Grid pairing, warnings |
+| `search_docs` | Docs sections for the project's version and framework, with URLs |
+| `get_doc` | One docs page (or one section of it) as markdown |
+| `check_expression` | Validates an AdapTableQL expression: syntax, functions, types, aggregation rules, the functions its Module offers, columns |
+| `migrate_expression` | Rewrites a pre-v24 expression to v24 syntax |
+| `list_expression_functions` | Built-in AdapTableQL functions with signatures and examples |
+| `check_state` | Initial State: type check against the installed `InitialState`, pre-v24 shapes, Layouts, column references, embedded expressions |
+| `migrate_state` | Upgrades state from an older major version (`AdaptableUpgradeHelper`) |
+
+Resources: `adaptable://docs/{major}/{slug}`, `adaptable://api/{major}/{typeName}`, `adaptable://aql/functions`.
+
+Prompts: `setup-adaptable` (framework), `upgrade-adaptable` (from, to).
+
+## How it works
+
+- Docs come from the build-time export of the docs site: `/llms/manifest.json`, `/llms-full.txt` and `/llms/pages.json`. The server picks the site that matches the project's major version (`www` for the latest major, `v{major}` for older ones, `canary` for a major that only has canary releases), caches the files, and re-downloads only when the manifest hash changes.
+- Checks use the `@adaptabletools/adaptable/aql` and `@adaptabletools/adaptable/upgrade` entry points of the installed package, so they match the project's exact version. The package ships as bundler ESM, so each entry is bundled once with esbuild and cached.
+
+## Environment variables
+
+| Variable | Default | Use |
+| --- | --- | --- |
+| `ADAPTABLE_MCP_PROJECT` | workspace root | Project to inspect |
+| `ADAPTABLE_MCP_DOCS_URL` | matched docs site | Docs site to read, e.g. `https://dev.adaptabletools.com` |
+| `ADAPTABLE_MCP_DOCS_DIR` | | Local docs build (`documentation/public`) instead of a site |
+| `ADAPTABLE_MCP_ADAPTABLE_SRC` | | AdapTable source folder (`packages/adaptable`) instead of the installed package |
+| `ADAPTABLE_MCP_CACHE_DIR` | `~/.cache/adaptable-mcp` | Cache for docs and bundled entries |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run inspect   # MCP Inspector
+```
+
+### Eval
+
+`eval/tasks.json` holds the eval tasks: setup per framework, AdapTableQL, state, option placement and upgrades. `eval/grade.mjs` grades a folder of answers (`<task-id>.md`), checking expressions and Initial State (including the type check) with the same code as the tools.
+
+`npm test` checks the checks in both directions: every Initial State in the docs demos must pass `check_state` (`test/docsExamples.test.mjs`; known docs issues are listed there until the demos are fixed), and every answer in `eval/known-wrong` (stale answers from a run without the MCP) must fail grading.
+
+Eval runs write their answers to `eval/results/<run>/` (gitignored):
+
+```bash
+node eval/grade.mjs eval/results/baseline
+```
+
+`eval/mcp-call.mjs` calls one tool from the command line, for agents that run the eval without MCP support:
+
+```bash
+ADAPTABLE_MCP_PROJECT=eval/fixture node eval/mcp-call.mjs search_docs '{"query":"pivot layout"}'
+```

package/dist/adaptable/loadEntry.js

@@ -0,0 +1,94 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { build } from 'esbuild';
+import { getCacheDir } from '../cache.js';
+const loaded = new Map();
+/**
+ * Entries come from the developer's installed package, so checks match their
+ * exact version. `ADAPTABLE_MCP_ADAPTABLE_SRC` points at an AdapTable source
+ * folder instead (e.g. `packages/adaptable` in the AdapTable repo).
+ */
+function resolveEntry(projectPath, name) {
+    const sourceDir = process.env.ADAPTABLE_MCP_ADAPTABLE_SRC;
+    if (sourceDir) {
+        const tsconfig = join(sourceDir, 'tsconfig.cjs.json');
+        // a source entry changes with every edit to the files it imports
+        return {
+            entry: join(sourceDir, `${name}.ts`),
+            tsconfig: existsSync(tsconfig) ? tsconfig : undefined,
+            cacheable: false,
+        };
+    }
+    try {
+        const require = createRequire(join(projectPath, 'package.json'));
+        return { entry: require.resolve(`@adaptabletools/adaptable/${name}.js`), cacheable: true };
+    }
+    catch {
+        return undefined;
+    }
+}
+function readPackageVersion(entry) {
+    let dir = dirname(entry);
+    for (let i = 0; i < 4; i++) {
+        const pkgPath = join(dir, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        dir = dirname(dir);
+    }
+    return undefined;
+}
+/**
+ * The published package is bundler-only ESM (extensionless relative imports),
+ * so each entry is bundled once per version with esbuild and cached.
+ */
+async function bundleAndImport(name, entry, tsconfig, cacheable) {
+    const stamp = createHash('sha256')
+        .update(entry)
+        .update(String(statSync(entry).mtimeMs))
+        .update(readPackageVersion(entry) ?? '')
+        .update(cacheable ? '' : `${process.pid}-${Date.now()}`)
+        .digest('hex')
+        .slice(0, 16);
+    const outfile = join(cacheable ? getCacheDir('adaptable') : tmpdir(), `adaptable-${name}-${stamp}.mjs`);
+    if (!cacheable || !existsSync(outfile)) {
+        await build({
+            entryPoints: [entry],
+            bundle: true,
+            platform: 'node',
+            format: 'esm',
+            outfile,
+            tsconfig,
+            logLevel: 'silent',
+        });
+    }
+    return import(pathToFileURL(outfile).href);
+}
+export function loadEntry(projectPath, name) {
+    const resolved = resolveEntry(projectPath, name);
+    if (!resolved) {
+        return Promise.resolve({
+            ok: false,
+            reason: `This project has no @adaptabletools/adaptable/${name} entry point (it ships with AdapTable 24 and later). Install AdapTable 24+ in the project first.`,
+        });
+    }
+    let result = loaded.get(resolved.entry);
+    if (!result) {
+        result = bundleAndImport(name, resolved.entry, resolved.tsconfig, resolved.cacheable).then((module) => ({ ok: true, module, source: resolved.entry }), (error) => ({
+            ok: false,
+            reason: `Could not load ${resolved.entry}: ${error instanceof Error ? error.message : String(error)}`,
+        }));
+        loaded.set(resolved.entry, result);
+    }
+    return result;
+}
+//# sourceMappingURL=loadEntry.js.map

package/dist/adaptable/loadEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEntry.js","sourceRoot":"","sources":["../../src/adaptable/loadEntry.ts"],"names":[],"mappings":"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"}

package/dist/adaptable/types.js

@@ -0,0 +1,13 @@
+export const EXPRESSION_MODULES = [
+    'Alert',
+    'CalculatedColumn',
+    'ColumnFilter',
+    'Export',
+    'FlashingCell',
+    'FormatColumn',
+    'GridFilter',
+    'NamedQuery',
+    'PlusMinus',
+    'StyledColumn',
+];
+//# sourceMappingURL=types.js.map

package/dist/adaptable/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adaptable/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,kBAAkB;IAClB,cAAc;IACd,QAAQ;IACR,cAAc;IACd,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,cAAc;CACN,CAAC"}

package/dist/cache.js

@@ -0,0 +1,11 @@
+import { mkdirSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function getCacheDir(...segments) {
+    const base = process.env.ADAPTABLE_MCP_CACHE_DIR ||
+        join(process.env.XDG_CACHE_HOME || join(homedir(), '.cache'), 'adaptable-mcp');
+    const dir = join(base, ...segments);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,GAAG,QAAkB;IAC/C,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,CAAC,uBAAuB;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/checks/stateRules.js

@@ -0,0 +1,389 @@
+/** Top-level keys of v24 `InitialState` */
+const INITIAL_STATE_KEYS = new Set([
+    'Alert',
+    'Application',
+    'CalculatedColumn',
+    'Charting',
+    'CustomSort',
+    'Dashboard',
+    'Export',
+    'FlashingCell',
+    'FormatColumn',
+    'FreeTextColumn',
+    'Layout',
+    'NamedQuery',
+    'Note',
+    'PlusMinus',
+    'QuickSearch',
+    'Shortcut',
+    'StatusBar',
+    'StyledColumn',
+    'Theme',
+    'ToolPanel',
+    'UserInterface',
+]);
+const GROUP_COLUMN_ID = 'ag-Grid-AutoColumn';
+const SELECTION_COLUMN_ID = 'ag-Grid-SelectionColumn';
+const TABLE_ONLY_KEYS = ['TableColumns', 'TableAggregationColumns', 'RowGroupedColumns'];
+const PIVOT_ONLY_KEYS = [
+    'PivotColumns',
+    'PivotAggregationColumns',
+    'PivotGroupedColumns',
+    'PivotExpandLevel',
+];
+const isObj = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const asArray = (value) => (Array.isArray(value) ? value : []);
+const STRING_LITERAL = /'(?:[^']|'')*'|"(?:[^"\\]|\\.)*"/g;
+/**
+ * True when the text calls an aggregation in its catalogue form: braces for
+ * `SUM{[price]}`, parens for `PERCENTAGE([price])`
+ */
+export function containsAggregation(expression, aggregations) {
+    const text = expression.replace(STRING_LITERAL, "''");
+    for (const match of text.matchAll(/\b([A-Za-z_][A-Za-z0-9_]*)\s*([{(])/g)) {
+        const callForm = aggregations.get(match[1].toUpperCase());
+        if (callForm && callForm === (match[2] === '{' ? 'brace' : 'paren')) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Keys of the pre-v24 expression wrapper object (`Rule: { BooleanExpression: '...' }`) */
+const LEGACY_WRAPPER_KEYS = [
+    'BooleanExpression',
+    'ScalarExpression',
+    'AggregatedBooleanExpression',
+    'AggregatedScalarExpression',
+    'AggregatedExpression',
+    'ObservableExpression',
+    'Expression',
+];
+function expressionSlots(state) {
+    const slots = [];
+    const section = (key) => (isObj(state[key]) ? state[key] : {});
+    const each = (list, owner, fn) => asArray(list).forEach((item, i) => {
+        if (isObj(item)) {
+            fn(item, `${owner}[${i}]`);
+        }
+    });
+    each(section('NamedQuery').NamedQueries, 'NamedQuery.NamedQueries', (holder, owner) => {
+        const returnType = holder.ReturnType ?? 'boolean';
+        slots.push({
+            owner,
+            holder,
+            prop: 'Expression',
+            legacyProps: LEGACY_WRAPPER_KEYS.filter((k) => k !== 'Expression'),
+            required: true,
+            module: 'NamedQuery',
+            kind: returnType === 'boolean' ? 'boolean' : 'scalar',
+        });
+    });
+    each(section('CalculatedColumn').CalculatedColumns, 'CalculatedColumn.CalculatedColumns', (holder, owner) => {
+        slots.push({
+            owner,
+            holder,
+            prop: 'Expression',
+            legacyProps: ['Query'],
+            required: true,
+            module: 'CalculatedColumn',
+            kind: 'scalar',
+            aggregatedKind: 'aggregatedScalar',
+        });
+    });
+    each(section('Alert').AlertDefinitions, 'Alert.AlertDefinitions', (holder, owner) => {
+        slots.push({ owner, holder, prop: 'Rule', module: 'Alert', kind: 'boolean', aggregatedKind: 'aggregatedBoolean' });
+    });
+    const ruleSections = [
+        ['FlashingCell', 'FlashingCellDefinitions'],
+        ['FormatColumn', 'FormatColumns'],
+        ['PlusMinus', 'PlusMinusNudges'],
+    ];
+    for (const [module, list] of ruleSections) {
+        each(section(module)[list], `${module}.${list}`, (holder, owner) => {
+            slots.push({ owner, holder, prop: 'Rule', module, kind: 'boolean' });
+        });
+    }
+    each(section('Export').Reports, 'Export.Reports', (holder, owner) => {
+        slots.push({ owner, holder, prop: 'Expression', legacyProps: ['Query'], module: 'Export', kind: 'boolean' });
+    });
+    each(section('StyledColumn').StyledColumns, 'StyledColumn.StyledColumns', (styled, styledPath) => {
+        if (isObj(styled.BadgeStyle)) {
+            each(styled.BadgeStyle.Badges, `${styledPath}.BadgeStyle.Badges`, (holder, owner) => {
+                slots.push({ owner, holder, prop: 'Rule', module: 'StyledColumn', kind: 'boolean' });
+            });
+        }
+    });
+    each(section('Layout').Layouts, 'Layout.Layouts', (layout, layoutPath) => {
+        if (isObj(layout.GridFilter)) {
+            slots.push({
+                owner: `${layoutPath}.GridFilter`,
+                holder: layout.GridFilter,
+                prop: 'Expression',
+                module: 'GridFilter',
+                kind: 'boolean',
+            });
+        }
+        each(layout.ColumnFilters, `${layoutPath}.ColumnFilters`, (holder, owner) => {
+            slots.push({ owner, holder, prop: 'Expression', module: 'ColumnFilter', kind: 'boolean' });
+        });
+    });
+    return slots;
+}
+const legacyWrapperText = (value) => LEGACY_WRAPPER_KEYS.map((k) => value[k]).find((v) => typeof v === 'string');
+/** The expression a slot holds, in v24 form or a pre-v24 shape (reported by checkStateRules) */
+function readSlot(slot) {
+    for (const prop of [slot.prop, ...(slot.legacyProps ?? [])]) {
+        const value = slot.holder[prop];
+        if (value === undefined) {
+            continue;
+        }
+        const path = `${slot.owner}.${prop}`;
+        if (typeof value === 'string') {
+            return { path, text: value, legacy: prop !== slot.prop };
+        }
+        return { path, text: isObj(value) ? legacyWrapperText(value) : undefined, legacy: true };
+    }
+    return undefined;
+}
+/** Every AdapTableQL string in state, with its Module and the kind that Module evaluates it as */
+export function collectExpressions(state, aggregations) {
+    const found = [];
+    for (const slot of expressionSlots(state)) {
+        const read = readSlot(slot);
+        if (!read?.text?.trim()) {
+            continue;
+        }
+        found.push({
+            path: read.path,
+            expression: read.text,
+            module: slot.module,
+            kind: slot.aggregatedKind && containsAggregation(read.text, aggregations) ? slot.aggregatedKind : slot.kind,
+        });
+    }
+    return found;
+}
+function expressionShapeIssues(state) {
+    const issues = [];
+    for (const slot of expressionSlots(state)) {
+        const read = readSlot(slot);
+        if (!read) {
+            if (slot.required) {
+                issues.push({
+                    path: `${slot.owner}.${slot.prop}`,
+                    severity: 'error',
+                    message: `Missing \`${slot.prop}\` (the AdapTableQL expression string).`,
+                });
+            }
+            continue;
+        }
+        if (read.legacy) {
+            const v24 = read.text === undefined ? `'...'` : JSON.stringify(read.text);
+            issues.push({
+                path: read.path,
+                severity: 'error',
+                message: `Pre-v24 shape. In v24 \`${slot.prop}\` is the expression string itself: \`${slot.prop}: ${v24}\`. To convert a whole older state use migrate_state.`,
+            });
+        }
+    }
+    eachInSection(state, 'Alert', 'AlertDefinitions', (alert, path) => {
+        const rowEvent = typeof alert.Rule === 'string' && alert.Rule.match(/^\s*ROW_(ADDED|REMOVED)\s*[{(]/);
+        if (rowEvent) {
+            const trigger = rowEvent[1] === 'ADDED' ? 'Added' : 'Removed';
+            issues.push({
+                path: `${path}.Rule`,
+                severity: 'error',
+                message: `Pre-v24 row event rule. Use a Row Change Alert: \`Type: 'RowChange', RowChangeTrigger: '${trigger}', Scope: { All: true }\`; \`Rule\` is optional and filters the ${trigger.toLowerCase()} rows (e.g. \`[status] = 'New'\`).`,
+            });
+        }
+    });
+    eachInSection(state, 'CalculatedColumn', 'CalculatedColumns', (column, path) => {
+        const settings = column.CalculatedColumnSettings;
+        if (!isObj(settings) || typeof settings.DataType !== 'string') {
+            issues.push({
+                path: `${path}.CalculatedColumnSettings${isObj(settings) ? '.DataType' : ''}`,
+                severity: 'error',
+                message: `Calculated Columns need \`CalculatedColumnSettings: { DataType: ... }\` (the type the Expression returns, e.g. 'number').`,
+            });
+        }
+    });
+    return issues;
+}
+function eachInSection(state, module, list, fn) {
+    const sectionValue = state[module];
+    if (isObj(sectionValue)) {
+        asArray(sectionValue[list]).forEach((item, i) => {
+            if (isObj(item)) {
+                fn(item, `${module}.${list}[${i}]`);
+            }
+        });
+    }
+}
+/** Columns the state itself defines (Calculated and FreeText Columns), with their data types */
+export function getStateColumnIds(state) {
+    const columns = [];
+    for (const [module, list, settings] of [
+        ['CalculatedColumn', 'CalculatedColumns', 'CalculatedColumnSettings'],
+        ['FreeTextColumn', 'FreeTextColumns', 'FreeTextColumnSettings'],
+    ]) {
+        const sectionValue = state[module];
+        if (isObj(sectionValue)) {
+            for (const c of asArray(sectionValue[list])) {
+                if (isObj(c) && typeof c.ColumnId === 'string') {
+                    const dataType = isObj(c[settings]) ? c[settings].DataType : undefined;
+                    columns.push([c.ColumnId, typeof dataType === 'string' ? dataType : undefined]);
+                }
+            }
+        }
+    }
+    return columns;
+}
+function layoutColumnRefs(layout) {
+    const refs = [];
+    for (const key of ['TableColumns', 'PivotColumns', 'RowGroupedColumns', 'PivotGroupedColumns']) {
+        for (const id of asArray(layout[key])) {
+            if (typeof id === 'string') {
+                refs.push({ key, columnId: id });
+            }
+        }
+    }
+    for (const key of ['ColumnSorts', 'ColumnFilters', 'TableAggregationColumns', 'PivotAggregationColumns']) {
+        for (const item of asArray(layout[key])) {
+            if (isObj(item) && typeof item.ColumnId === 'string') {
+                refs.push({ key, columnId: item.ColumnId });
+            }
+        }
+    }
+    for (const key of ['ColumnSizing', 'ColumnPinning', 'ColumnVisibility', 'ColumnHeaders']) {
+        if (isObj(layout[key])) {
+            for (const id of Object.keys(layout[key])) {
+                refs.push({ key, columnId: id });
+            }
+        }
+    }
+    return refs;
+}
+const isSpecialColumn = (id) => id === GROUP_COLUMN_ID || id === SELECTION_COLUMN_ID || id.startsWith(`${GROUP_COLUMN_ID}-`);
+/**
+ * Semantic rules TypeScript cannot catch, plus the expression shapes agents
+ * most often get wrong (with the v24 rewrite); other shape errors are left to
+ * the type check
+ */
+export function checkStateRules(state, input) {
+    const issues = [];
+    if (!isObj(state)) {
+        return [{ path: '', severity: 'error', message: 'State must be a JSON object (the value of `initialState`).' }];
+    }
+    for (const key of Object.keys(state)) {
+        if (key === 'PredefinedConfig') {
+            issues.push({
+                path: key,
+                severity: 'error',
+                message: '`PredefinedConfig` is not part of AdapTable state: put its contents directly in `initialState`.',
+            });
+        }
+        else if (!INITIAL_STATE_KEYS.has(key)) {
+            issues.push({
+                path: key,
+                severity: 'warning',
+                message: `\`${key}\` is not an Initial State section; AdapTable ignores it. Check search_docs for where this belongs (it may be an Adaptable Option).`,
+            });
+        }
+    }
+    issues.push(...expressionShapeIssues(state));
+    const layoutState = isObj(state.Layout) ? state.Layout : undefined;
+    const layouts = asArray(layoutState?.Layouts);
+    if (!layouts.length) {
+        issues.push({
+            path: 'Layout.Layouts',
+            severity: 'warning',
+            message: 'No Layouts: Initial State must include at least one Layout unless `layoutOptions.autoCreateLayout` is set.',
+        });
+    }
+    const known = input.columnIds
+        ? new Set([...input.columnIds, ...getStateColumnIds(state).map(([id]) => id)])
+        : undefined;
+    const names = new Map();
+    layouts.forEach((layout, i) => {
+        const path = `Layout.Layouts[${i}]`;
+        if (!isObj(layout)) {
+            issues.push({ path, severity: 'error', message: 'Layout must be an object.' });
+            return;
+        }
+        const name = layout.Name;
+        if (typeof name !== 'string' || !name) {
+            issues.push({ path: `${path}.Name`, severity: 'error', message: 'Layout needs a `Name`.' });
+        }
+        else if (names.has(name)) {
+            issues.push({
+                path: `${path}.Name`,
+                severity: 'error',
+                message: `Duplicate Layout name "${name}" (also Layout.Layouts[${names.get(name)}]); Layout names must be unique.`,
+            });
+        }
+        else {
+            names.set(name, i);
+        }
+        const isTable = layout.TableColumns !== undefined;
+        const isPivot = layout.PivotColumns !== undefined;
+        if (isTable && isPivot) {
+            issues.push({
+                path,
+                severity: 'error',
+                message: 'A Layout is either a Table Layout (`TableColumns`) or a Pivot Layout (`PivotColumns`), not both.',
+            });
+        }
+        else if (!isTable && !isPivot) {
+            issues.push({
+                path,
+                severity: 'error',
+                message: 'Layout needs `TableColumns` (Table Layout) or `PivotColumns` (Pivot Layout; use [] to show only aggregations).',
+            });
+        }
+        else {
+            const wrongKeys = (isTable ? PIVOT_ONLY_KEYS : TABLE_ONLY_KEYS).filter((k) => layout[k] !== undefined);
+            for (const key of wrongKeys) {
+                issues.push({
+                    path: `${path}.${key}`,
+                    severity: 'error',
+                    message: isTable
+                        ? `\`${key}\` belongs to Pivot Layouts; this is a Table Layout.`
+                        : `\`${key}\` belongs to Table Layouts; in Pivot Layouts use ${key === 'RowGroupedColumns' ? '`PivotGroupedColumns`' : key === 'TableAggregationColumns' ? '`PivotAggregationColumns`' : '`PivotColumns`'}.`,
+                });
+            }
+        }
+        if (isObj(layout.ColumnSizing)) {
+            for (const [columnId, sizing] of Object.entries(layout.ColumnSizing)) {
+                if (isObj(sizing) && sizing.Width !== undefined && sizing.Flex !== undefined) {
+                    issues.push({
+                        path: `${path}.ColumnSizing.${columnId}`,
+                        severity: 'error',
+                        message: 'Column sizing takes `Width` or `Flex`, not both.',
+                    });
+                }
+            }
+        }
+        if (known) {
+            const reported = new Set();
+            for (const { key, columnId } of layoutColumnRefs(layout)) {
+                if (!known.has(columnId) && !isSpecialColumn(columnId) && !reported.has(columnId)) {
+                    reported.add(columnId);
+                    issues.push({
+                        path: `${path}.${key}`,
+                        severity: 'error',
+                        message: `Column "${columnId}" is not in the grid's columns. If it is an Action Column or another column defined outside columnDefs, add it to columns.`,
+                    });
+                }
+            }
+        }
+    });
+    const current = layoutState?.CurrentLayout;
+    if (typeof current === 'string' && layouts.length && !names.has(current)) {
+        issues.push({
+            path: 'Layout.CurrentLayout',
+            severity: 'error',
+            message: `CurrentLayout "${current}" does not match any Layout Name (${[...names.keys()].map((n) => `"${n}"`).join(', ')}).`,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=stateRules.js.map

package/dist/checks/stateRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateRules.js","sourceRoot":"","sources":["../../src/checks/stateRules.ts"],"names":[],"mappings":"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"}