@adaptabletools/adaptable-mcp 0.1.0-canary.1 → 0.1.0-canary.2

package/dist/core/setup/rules/required-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-options.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/required-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAEzE,2GAA2G;AAC3G,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,uCAAuC;IAC7C,KAAK,CAAC,GAAG;QACP,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC;QACnC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,YAAY,CAAU,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,GAAG;oBACT,OAAO,EAAE,+BAA+B,GAAG,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,EAAE,GAAG;oBACvG,GAAG,EAAE,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,mEAAmE,CAAC,CAAC,CAAC,iFAAiF;oBACnL,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;iBAChB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC;YACzF,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC9E,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,kBAAkB,UAAU,kCAAkC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI;oBAC1J,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,oCAAoC,CAAC,CAAC,CAAC,0DAA0D;oBAC3H,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC;iBACjD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/core/setup/rules/rule.js

@@ -0,0 +1,10 @@
+export const defineSetupRule = (rule) => rule;
+/** `{ file, line, column }` of a line-map entry of an extraction, when present */
+export function positionOf(extraction, path, at = 'value') {
+    const entry = extraction?.lineMap[path];
+    if (!entry) {
+        return undefined;
+    }
+    return at === 'key' ? (entry.key ?? entry.value) : entry.value;
+}
+//# sourceMappingURL=rule.js.map

package/dist/core/setup/rules/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/rule.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAa,EAAE,CAAC,IAAI,CAAC;AAEpE,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,UAAoK,EAAE,IAAY,EAAE,KAAsB,OAAO;IAC1O,MAAM,KAAK,GAAG,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;AACjE,CAAC"}

package/dist/core/setup/rules/version-skew.js

@@ -0,0 +1,65 @@
+import { pairingFor } from '../../compat/manifest.js';
+import { satisfies } from '../../context/detect.js';
+import { defineSetupRule } from './rule.js';
+/** `>=20` → `>=20.0.0`, `>=5.4` → `>=5.4.0`: the manifest's minimums in the three-part form `satisfies` reads */
+export function padRange(range) {
+    return range.replace(/(\d+)(?:\.(\d+))?(?:\.(\d+))?/g, (_m, a, b, c) => `${a}.${b ?? '0'}.${c ?? '0'}`);
+}
+const FRAMEWORK_PACKAGE = { react: 'react', angular: '@angular/core', vue: 'vue' };
+/**
+ * Versions that do not go together: wrapper ≠ core, AG Grid below the documented
+ * pairing, framework / TypeScript below the manifest's minimums, AG Grid Community only
+ */
+export default defineSetupRule({
+    id: 'setup/version-skew',
+    docs: 'support/release-schedule',
+    check(ctx) {
+        const issues = [];
+        const { project, manifest, major } = ctx;
+        if (project.wrapper?.skew) {
+            issues.push({
+                severity: 'error',
+                message: `${project.wrapper.name} is installed at ${project.wrapper.installed} but @adaptabletools/adaptable at ${project.adaptable.installed}; the wrapper and the core must be the same version.`,
+                fix: `Pin both to the same version (\`npm i @adaptabletools/adaptable@${project.adaptable.installed} ${project.wrapper.name}@${project.adaptable.installed}\`).`,
+            });
+        }
+        if (project.agGrid && !project.agGrid.enterprise) {
+            issues.push({
+                severity: 'error',
+                message: `Only ${project.agGrid.name} is installed; AdapTable requires AG Grid Enterprise.`,
+                fix: 'Add `ag-grid-enterprise` at the paired version and register `AllEnterpriseModule` (or the Enterprise modules the grid uses).',
+            });
+        }
+        const pairing = pairingFor(manifest, major);
+        if (pairing && project.agGrid?.major !== undefined && project.agGrid.major < pairing.agGridMajor) {
+            issues.push({
+                severity: 'error',
+                message: `AG Grid ${project.agGrid.installed ?? project.agGrid.range} is below the version AdapTable ${major} is paired with (AG Grid ${pairing.agGridVersion}).`,
+                fix: `Upgrade ${project.agGrid.name} to ${pairing.agGridVersion} (the \`ag-update\` skill does the AG Grid side).`,
+            });
+        }
+        const environment = manifest?.environment?.[String(major)];
+        if (environment) {
+            const frameworkPackage = FRAMEWORK_PACKAGE[ctx.framework];
+            const frameworkMin = frameworkPackage ? environment[ctx.framework] : undefined;
+            const frameworkVersion = frameworkPackage ? project.frameworkVersions[frameworkPackage]?.installed : undefined;
+            if (frameworkMin && frameworkVersion && satisfies(frameworkVersion, padRange(frameworkMin)) === false) {
+                issues.push({
+                    severity: 'error',
+                    message: `${frameworkPackage} ${frameworkVersion} is below the ${frameworkMin} AdapTable ${major} requires.`,
+                    fix: `Upgrade ${frameworkPackage} to ${frameworkMin}.`,
+                });
+            }
+            const ts = project.typescript?.installed;
+            if (environment.typescript && ts && satisfies(ts, padRange(environment.typescript)) === false) {
+                issues.push({
+                    severity: 'warning',
+                    message: `TypeScript ${ts} is below the ${environment.typescript} AdapTable ${major} is built with; its type definitions may not compile.`,
+                    fix: `Upgrade typescript to ${environment.typescript}.`,
+                });
+            }
+        }
+        return issues;
+    },
+});
+//# sourceMappingURL=version-skew.js.map

package/dist/core/setup/rules/version-skew.js.map

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

package/dist/core/state/capabilities.js

@@ -0,0 +1,78 @@
+/**
+ * `adaptable check state <file|-> [--columns <file>] [--kind initial|persistent]` · MCP `check_state` (plan §8.4).
+ */
+import { z } from 'zod';
+import { registerCapability } from '../capabilities.js';
+import { CapabilityError, ok } from '../envelope.js';
+import { checkState } from './check.js';
+const Position = z.object({ file: z.string(), line: z.number(), column: z.number() });
+const CheckStateOutput = z.object({
+    kind: z.enum(['initial', 'persistent']),
+    source: z.object({ file: z.string(), locatedBy: z.string(), line: z.number().optional(), column: z.number().optional() }),
+    unverifiable: z.array(Position.extend({ path: z.string(), kind: z.string(), reason: z.string(), suppressed: z.array(z.string()).optional() })),
+    checked: z.object({
+        shape: z.string(),
+        semantics: z.string(),
+        columnRefs: z.string(),
+        options: z.enum(['visible', 'not visible']),
+        aql: z.string(),
+        agGridTypes: z.boolean().optional(),
+    }),
+    rules: z.array(z.string()),
+    stats: z.object({ sections: z.number(), layouts: z.number(), expressions: z.number(), columns: z.number().optional() }),
+    requiresAnotherCheckAfterFix: z.boolean(),
+});
+registerCapability({
+    name: 'check-state',
+    description: 'Validates Adaptable State (a JSON file or the literal in a .ts/.tsx/.js/.jsx/.vue file) against the checked major: shape, semantics, column references and AdapTableQL.',
+    cli: { command: ['check', 'state'], positionals: ['file'], stdinField: 'text' },
+    mcp: { tool: 'check_state' },
+    input: z.object({
+        file: z.string().optional().describe('State input: JSON / JSONC / JSON5, or a source file holding the literal; `-` reads stdin'),
+        text: z.string().optional().describe('The input text itself (stdin); the CLI fills it for `-`'),
+        state: z.union([z.string(), z.record(z.string(), z.unknown())]).optional().describe('The State as an object or JSON string (MCP; for a running grid, DevTools getPersistentState())'),
+        columns: z.string().optional().describe('Grid columns: a columnDefs JSON / source file, or DevTools getColumns() output'),
+        columnsValue: z.array(z.unknown()).optional().describe('The columns as a value (MCP)'),
+        kind: z.enum(['initial', 'persistent']).default('initial').describe('`initial` for an initialState literal, `persistent` for a persisted State (every section required)'),
+    }),
+    output: CheckStateOutput,
+    run: async (input, ctx) => {
+        const resolution = await ctx.resolveContext();
+        const major = resolution.context.adaptableMajor;
+        if (major === undefined) {
+            throw new CapabilityError('USAGE', 'The AdapTable major to check against could not be determined.', 'Run inside a project that depends on @adaptabletools/adaptable, or pass --major <n>.');
+        }
+        const result = await checkState({ file: input.file, text: input.text, state: input.state, columns: input.columns, columnsValue: input.columnsValue, kind: input.kind }, { major, projectDir: resolution.project?.path ?? ctx.cwd, offline: ctx.globals.offline });
+        return ok(result.data, {
+            issues: result.issues,
+            warnings: [...resolution.warnings, ...result.warnings],
+            resolvedContext: {
+                ...resolution.context,
+                ...(result.codeSource ? { codeSource: result.codeSource } : {}),
+                ...(result.engine ? { engine: result.engine } : {}),
+            },
+        });
+    },
+    markdown: (data, envelope) => {
+        const errors = envelope.issues.filter((i) => i.severity === 'error').length;
+        const warnings = envelope.issues.filter((i) => i.severity === 'warning').length;
+        const lines = [
+            `# check state — ${errors ? `${errors} error${errors === 1 ? '' : 's'}` : 'no errors'}${warnings ? `, ${warnings} warning${warnings === 1 ? '' : 's'}` : ''}`,
+            '',
+            `- Input: ${data.source.file}${data.source.line ? `:${data.source.line}:${data.source.column}` : ''} (${data.source.locatedBy}), ${data.kind} State`,
+            `- Checked: shape ${data.checked.shape}; semantics ${data.checked.semantics}; column refs ${data.checked.columnRefs}; options ${data.checked.options}; AdapTableQL ${data.checked.aql}${data.checked.agGridTypes === false ? '; AG Grid types absent (members they type were not checked)' : ''}`,
+            `- Stats: ${data.stats.sections} sections, ${data.stats.layouts} layouts, ${data.stats.expressions} expressions${data.stats.columns !== undefined ? `, ${data.stats.columns} columns` : ''}`,
+        ];
+        if (data.unverifiable.length) {
+            lines.push('', '## Not verifiable statically', '');
+            for (const u of data.unverifiable) {
+                lines.push(`- \`${u.path || '(root)'}\` — ${u.reason} (${u.file}:${u.line}:${u.column})`);
+            }
+        }
+        if (data.requiresAnotherCheckAfterFix) {
+            lines.push('', '_The type-check reports one problem per section; run `check state` again after fixing._');
+        }
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=capabilities.js.map

package/dist/core/state/capabilities.js.map

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

package/dist/core/state/check.js

@@ -0,0 +1,216 @@
+/**
+ * `check state` (plan §8.4): extractor → shape layer → rules → scope statement.
+ * Transport-free; `capabilities.ts` binds it to the CLI and MCP.
+ */
+import { basename } from 'node:path';
+import { CapabilityError } from '../envelope.js';
+import { extractFromFile, extractFromSource, } from '../extract/input.js';
+import { isSourceFile } from '../extract/ts-literal.js';
+import { aggregationsOf, loadAql, supportsAql } from '../aql/engine.js';
+import { bundledRenamesFor } from '../changes/records.js';
+import { packageLocation, sourceOverride } from '../packages/load-entry.js';
+import { resolvePackage } from '../packages/resolve.js';
+import { buildColumnUniverse, columnsFromInput } from './columns.js';
+import { asArray, collectExpressions, isObj } from './expressions.js';
+import { DASHBOARD_TOOLBARS_V24, INITIAL_STATE_KEYS_V24, MODULE_BUTTONS_V24, PERSISTENT_STATE_KEYS_V24 } from './known-names.js';
+import { runRules } from './rules/index.js';
+import { checkShape, readTypeNames, unexplainedShapeIssues } from './type-check.js';
+const TYPE_NAMES = {
+    initialStateKeys: 'InitialState',
+    persistentStateKeys: 'AdaptablePersistentState',
+    dashboardToolbars: 'AdaptableDashboardToolbar',
+    moduleButtons: 'AdaptableModuleButton',
+};
+const NAME_LIST_KEYS = Object.keys(TYPE_NAMES);
+const isMiss = (result) => result.value === undefined;
+/** The State from a file, stdin text or a value, through the extractor; `EXTRACTION_FAILED` / `USAGE` when there is none */
+export function readState(input) {
+    if (input.state !== undefined) {
+        if (typeof input.state === 'string') {
+            return readState({ ...input, state: undefined, text: input.state, file: input.file ?? '<state>' });
+        }
+        return {
+            extraction: {
+                value: input.state,
+                lineMap: {},
+                unverifiable: [...(input.unverifiable ?? [])],
+                source: { file: input.file ?? '<state>', locatedBy: 'json', line: 1, column: 1 },
+            },
+        };
+    }
+    if (input.text !== undefined) {
+        const file = input.file && input.file !== '-' ? input.file : '<stdin>';
+        const result = extractFromSource(input.text, { file, target: 'state' });
+        return { extraction: ensureFound(result, file), sourceText: { text: input.text, file } };
+    }
+    if (!input.file || input.file === '-') {
+        throw new CapabilityError('USAGE', 'No State input: pass a file path, `-` with the State on stdin, or the State itself.', 'Run `adaptable check state <file>` or `adaptable check state - < state.json`.');
+    }
+    return { extraction: ensureFound(extractFromFile(input.file, { target: 'state' }), input.file) };
+}
+function ensureFound(result, file) {
+    if (isMiss(result)) {
+        throw new CapabilityError('EXTRACTION_FAILED', `No Adaptable State literal was found in ${basename(file)} (tried: ${result.tried.join(', ')}).`, 'Declare the State as `const initialState: InitialState = {…}`, as the `initialState:` property of the Adaptable Options, or pass the State as JSON (for a running grid, `getPersistentState()` from DevTools).');
+    }
+    return result;
+}
+/** A second target from the same input, quietly: `undefined` when it is not there */
+export function extractQuietly(sourceText, file, target) {
+    try {
+        const result = sourceText
+            ? extractFromSource(sourceText.text, { file: sourceText.file, target })
+            : file && isSourceFile(file)
+                ? extractFromFile(file, { target })
+                : undefined;
+        return result && !isMiss(result) ? result : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readColumns(input, state, options, sourceText) {
+    if (input.columnsValue !== undefined) {
+        return buildColumnUniverse(columnsFromInput(input.columnsValue), state, options, 'columns passed with the call');
+    }
+    if (input.columns) {
+        const result = extractFromFile(input.columns, { target: 'columnDefs' });
+        if (isMiss(result)) {
+            throw new CapabilityError('EXTRACTION_FAILED', `No \`columnDefs\` array was found in ${basename(input.columns)} (tried: ${result.tried.join(', ')}).`, 'Pass a JSON array of ColDefs, DevTools `getColumns()` output, or a source file that declares `columnDefs`.');
+        }
+        return buildColumnUniverse(columnsFromInput(result.value), state, options, basename(input.columns));
+    }
+    const same = extractQuietly(sourceText, input.file, 'columnDefs');
+    if (same && Array.isArray(same.value)) {
+        return buildColumnUniverse(columnsFromInput(same.value), state, options, `columnDefs in ${basename(same.source.file)}`);
+    }
+    return undefined;
+}
+async function typeUniverse(types) {
+    const names = await readTypeNames(types, Object.values(TYPE_NAMES));
+    const fromTypes = [];
+    const pick = (key, fallback) => {
+        const found = names[TYPE_NAMES[key]];
+        if (found) {
+            fromTypes.push(key);
+            return found;
+        }
+        return fallback;
+    };
+    return {
+        initialStateKeys: pick('initialStateKeys', INITIAL_STATE_KEYS_V24),
+        persistentStateKeys: pick('persistentStateKeys', PERSISTENT_STATE_KEYS_V24),
+        dashboardToolbars: pick('dashboardToolbars', DASHBOARD_TOOLBARS_V24),
+        moduleButtons: pick('moduleButtons', MODULE_BUTTONS_V24),
+        fromTypes,
+    };
+}
+export async function checkState(input, deps) {
+    const warnings = [];
+    const { extraction, sourceText } = readState(input);
+    if (!isObj(extraction.value)) {
+        const root = extraction.unverifiable.find((u) => u.path === '');
+        throw new CapabilityError('EXTRACTION_FAILED', root
+            ? `The State in ${basename(extraction.source.file)} is not visible statically: ${root.reason}.`
+            : `The State in ${basename(extraction.source.file)} is not an object.`, root
+            ? 'Export the State of the running grid with `getPersistentState()` (DevTools) and check that JSON, or declare the State as a literal.'
+            : 'Adaptable State is a JSON object whose keys are module names (`Layout`, `FormatColumn`, …).');
+    }
+    const state = extraction.value;
+    const optionsExtraction = input.optionsValue === undefined ? extractQuietly(sourceText, input.file, 'options') : undefined;
+    const options = isObj(input.optionsValue) ? input.optionsValue : optionsExtraction && isObj(optionsExtraction.value) ? optionsExtraction.value : undefined;
+    const columns = readColumns(input, state, options, sourceText);
+    // the types package of the checked major (plan §7.3); PACKAGE_REQUIRED propagates
+    const override = sourceOverride();
+    const resolvedTypes = override ? undefined : await resolvePackage({ kind: 'types', major: deps.major }, { projectDir: deps.projectDir, offline: deps.offline, installed: deps.installed });
+    const types = override ?? packageLocation(resolvedTypes);
+    const codeSource = resolvedTypes?.source;
+    // the engine (≥ 24) for the aql rules; degrades with a warning
+    let aql;
+    let aqlStatus;
+    let engine;
+    if (!supportsAql(deps.major)) {
+        aqlStatus = 'unsupported-for-major';
+    }
+    else {
+        try {
+            const resolvedEngine = override ? undefined : await resolvePackage({ kind: 'engine' }, { projectDir: deps.projectDir, offline: deps.offline, installed: deps.installed });
+            const location = override ?? packageLocation(resolvedEngine);
+            const loaded = await loadAql(location);
+            if (loaded.ok) {
+                aql = { module: loaded.module, aggregations: aggregationsOf(loaded.module) };
+                aqlStatus = 'yes';
+                if (resolvedEngine && resolvedTypes && resolvedEngine.version !== resolvedTypes.version) {
+                    engine = { version: resolvedEngine.version, source: resolvedEngine.source };
+                }
+            }
+            else {
+                aqlStatus = `not available (${loaded.reason})`;
+            }
+        }
+        catch (error) {
+            if (!(error instanceof CapabilityError)) {
+                throw error;
+            }
+            aqlStatus = `not available (${error.message})`;
+            warnings.push(`AdapTableQL expressions were not checked: ${error.message} ${error.hint}`);
+        }
+    }
+    const names = await typeUniverse(types);
+    const shape = await checkShape({
+        value: state,
+        type: input.kind === 'persistent' ? 'AdaptablePersistentState' : 'InitialState',
+        types,
+        lineMap: extraction.lineMap,
+        unverifiable: extraction.unverifiable,
+        renames: deps.renames ?? bundledRenamesFor(deps.major),
+    });
+    if (!shape.ok) {
+        warnings.push(`The State's shape was not type-checked: ${shape.reason}`);
+    }
+    const rules = runRules({ state, major: deps.major, kind: input.kind, options, columns, names, aql }, extraction.lineMap);
+    // a rule finding at or under a stubbed value is about the stub (`null`), not the user's code — the shape layer suppresses those too
+    const stubs = extraction.unverifiable.filter((u) => u.kind !== 'spread' && u.kind !== 'computed-key' && u.path !== '');
+    const isStubbed = (path) => path !== undefined && stubs.some((u) => path === u.path || path.startsWith(`${u.path}.`) || path.startsWith(`${u.path}[`));
+    const ruleIssues = rules.issues.filter((issue) => !isStubbed(issue.path));
+    const shapeIssues = shape.ok ? unexplainedShapeIssues(shape.issues, ruleIssues.filter((i) => !!i.path)) : [];
+    const issues = [...ruleIssues, ...shapeIssues];
+    const suppressedByPath = new Map();
+    if (shape.ok) {
+        for (const s of shape.suppressed) {
+            const owner = extraction.unverifiable.find((u) => s.path === u.path || s.path.startsWith(`${u.path}.`) || s.path.startsWith(`${u.path}[`));
+            if (owner) {
+                suppressedByPath.set(owner.path, [...(suppressedByPath.get(owner.path) ?? []), s.message]);
+            }
+        }
+    }
+    const unverifiable = extraction.unverifiable.map((u) => {
+        const suppressed = suppressedByPath.get(u.path);
+        return suppressed ? { ...u, suppressed } : u;
+    });
+    const layouts = asArray(isObj(state.Layout) ? state.Layout.Layouts : undefined).length;
+    const expressions = collectExpressions(state, aql?.aggregations ?? new Map()).length;
+    const checked = {
+        shape: shape.ok ? shape.checked.types : `not checked (${shape.reason})`,
+        semantics: `${rules.applied.length} rules${names.fromTypes.length < NAME_LIST_KEYS.length ? ` (name lists for ${NAME_LIST_KEYS.filter((k) => !names.fromTypes.includes(k)).join(', ')} from the bundled 24 constants)` : ''}`,
+        columnRefs: columns ? `yes (${columns.source})` : 'no (no column source)',
+        options: options ? 'visible' : 'not visible',
+        aql: aqlStatus,
+        ...(shape.ok ? { agGridTypes: shape.checked.agGridTypes } : {}),
+    };
+    return {
+        data: {
+            kind: input.kind,
+            source: { file: extraction.source.file, locatedBy: extraction.source.locatedBy, line: extraction.source.line, column: extraction.source.column },
+            unverifiable,
+            checked,
+            rules: rules.applied,
+            stats: { sections: Object.keys(state).length, layouts, expressions, ...(columns ? { columns: columns.ids.size } : {}) },
+            requiresAnotherCheckAfterFix: shapeIssues.length > 0,
+        },
+        issues,
+        warnings,
+        ...(codeSource ? { codeSource } : {}),
+        ...(engine ? { engine } : {}),
+    };
+}
+//# sourceMappingURL=check.js.map

package/dist/core/state/check.js.map

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

package/dist/core/state/columns.js

@@ -0,0 +1,130 @@
+/**
+ * The effective column universe of plan §8.4: `columnDefs` (`colId ?? field`,
+ * groups flattened) ∪ Calculated ∪ FreeText ∪ Action columns ∪ the AG Grid
+ * auto-group / selection columns, with an AdapTable data type per column when
+ * one can be read (for the engine's column checks).
+ */
+import { asArray, getStateColumnIds, isObj } from './expressions.js';
+import { isSpecialColumn } from './known-names.js';
+/** AG Grid `cellDataType` → AdapTable data type */
+const CELL_DATA_TYPES = {
+    text: 'text',
+    number: 'number',
+    boolean: 'boolean',
+    date: 'date',
+    dateString: 'date',
+};
+/** AG Grid column `type` hints → AdapTable data type */
+const COL_TYPE_HINTS = {
+    numericColumn: 'number',
+    numberColumn: 'number',
+    dateColumn: 'date',
+};
+/** Flattens ColDefs / ColGroupDefs (`children`) into `{ id, dataType }` */
+export function columnsFromColDefs(columnDefs) {
+    const out = [];
+    const visit = (def) => {
+        if (!isObj(def)) {
+            return;
+        }
+        if (Array.isArray(def.children)) {
+            def.children.forEach(visit);
+            return;
+        }
+        const id = typeof def.colId === 'string' ? def.colId : typeof def.field === 'string' ? def.field : undefined;
+        if (!id) {
+            return;
+        }
+        let dataType;
+        if (typeof def.cellDataType === 'string') {
+            dataType = CELL_DATA_TYPES[def.cellDataType];
+        }
+        const types = typeof def.type === 'string' ? [def.type] : asArray(def.type);
+        for (const type of types) {
+            if (!dataType && typeof type === 'string' && COL_TYPE_HINTS[type]) {
+                dataType = COL_TYPE_HINTS[type];
+            }
+        }
+        out.push(dataType ? { id, dataType } : { id });
+    };
+    asArray(columnDefs).forEach(visit);
+    return out;
+}
+/**
+ * DevTools `getColumns()` shape (`{ id, dataType, friendlyName?, field?, … }[]`) or ColDefs:
+ * whichever the input is. A ColDef never has `id` (it has `colId` / `field`), so a string `id`
+ * on every item is the DevTools output even when `field` is also present.
+ */
+export function columnsFromInput(value) {
+    const items = asArray(value);
+    if (items.length && items.every((item) => isObj(item) && typeof item.id === 'string' && !('colId' in item))) {
+        return items.map((item) => {
+            const column = item;
+            return typeof column.dataType === 'string' ? { id: column.id, dataType: column.dataType } : { id: column.id };
+        });
+    }
+    return columnsFromColDefs(value);
+}
+/** Action column ids from a visible Options literal (`actionColumnOptions.actionColumns[].columnId`) */
+export function actionColumnIds(options) {
+    const ids = [];
+    for (const key of ['actionColumnOptions', 'actionOptions']) {
+        const section = options && isObj(options[key]) ? options[key] : undefined;
+        for (const column of asArray(section?.actionColumns)) {
+            if (isObj(column) && typeof column.columnId === 'string') {
+                ids.push(column.columnId);
+            }
+        }
+    }
+    return ids;
+}
+/** Custom AdapTableQL function names declared in a visible Options literal (`expressionOptions.custom*Functions`) */
+export function customFunctionNames(options) {
+    const expressionOptions = options && isObj(options.expressionOptions) ? options.expressionOptions : undefined;
+    const names = [];
+    for (const key of ['customStandardFunctions', 'customAggregatedFunctions', 'customExpressionFunctions']) {
+        const value = expressionOptions?.[key];
+        if (isObj(value)) {
+            names.push(...Object.keys(value));
+        }
+        else {
+            for (const item of asArray(value)) {
+                if (isObj(item) && typeof item.name === 'string') {
+                    names.push(item.name);
+                }
+            }
+        }
+    }
+    return names.map((n) => n.toUpperCase());
+}
+export function buildColumnUniverse(grid, state, options, source) {
+    const ids = new Set();
+    const types = {};
+    for (const column of grid) {
+        ids.add(column.id);
+        types[column.id] = column.dataType;
+    }
+    for (const [id, dataType] of getStateColumnIds(state)) {
+        ids.add(id);
+        types[id] = dataType ?? types[id];
+    }
+    for (const id of actionColumnIds(options)) {
+        ids.add(id);
+    }
+    return { ids, types, source };
+}
+/** Whether a referenced id is in the universe (special AG Grid columns always are) */
+export function knownColumn(universe, id) {
+    return universe.ids.has(id) || isSpecialColumn(id);
+}
+/** A column id that matches `id` case-insensitively, for the exact fix */
+export function caseMatch(universe, id) {
+    const lower = id.toLowerCase();
+    for (const known of universe.ids) {
+        if (known !== id && known.toLowerCase() === lower) {
+            return known;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=columns.js.map

package/dist/core/state/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../../src/core/state/columns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAY,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUnD,mDAAmD;AACnD,MAAM,eAAe,GAA2B;IAC9C,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,MAAM;CACnB,CAAC;AAEF,wDAAwD;AACxD,MAAM,cAAc,GAA2B;IAC7C,aAAa,EAAE,QAAQ;IACvB,YAAY,EAAE,QAAQ;IACtB,UAAU,EAAE,MAAM;CACnB,CAAC;AAOF,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,UAAmB;IACpD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,CAAC,GAAY,EAAQ,EAAE;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7G,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;QACT,CAAC;QACD,IAAI,QAA4B,CAAC;QACjC,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACzC,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC;IACF,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;QAC5G,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,MAAM,GAAG,IAAW,CAAC;YAC3B,OAAO,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAY,EAAE,CAAC;QACpI,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,OAAO,CAAC,GAAG,CAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACnF,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,CAAC;YACrD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACzD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAC1D,MAAM,iBAAiB,GAAG,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9G,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,CAAC,yBAAyB,EAAE,2BAA2B,EAAE,2BAA2B,CAAC,EAAE,CAAC;QACxG,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAkB,EAAE,KAAU,EAAE,OAAwB,EAAE,MAAc;IAC1G,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,KAAK,GAAuC,EAAE,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QAC1B,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrC,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACZ,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAChC,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,QAAwB,EAAE,EAAU;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAC,QAAwB,EAAE,EAAU;IAC5D,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}