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

package/dist/core/setup/context.js

@@ -0,0 +1,118 @@
+/**
+ * What `check setup` (plan §8.6) looks at: the project as `detect` describes it,
+ * its source and style files with line indexes, and the Options / `columnDefs` /
+ * State literals the extractor can see in its entry files.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { describeProject, listSourceFiles } from '../context/detect.js';
+import { CapabilityError } from '../envelope.js';
+import { extractFromFile } from '../extract/input.js';
+import { LineIndex } from '../extract/line-map.js';
+import { isSourceFile } from '../extract/ts-literal.js';
+const MAX_FILE_BYTES = 512 * 1024;
+const STYLE_EXTENSIONS = new Set(['.css', '.scss', '.sass', '.less']);
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', 'out', 'coverage', '.git', '.angular', '.next', '.nuxt', '.turbo']);
+function listStyleFiles(root, limit = 2000) {
+    const files = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (files.length >= limit) {
+                return;
+            }
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith('.')) {
+                    walk(join(dir, entry.name));
+                }
+            }
+            else if (entry.isFile()) {
+                const dot = entry.name.lastIndexOf('.');
+                if ((dot >= 0 && STYLE_EXTENSIONS.has(entry.name.slice(dot))) || entry.name === 'angular.json') {
+                    files.push(join(dir, entry.name));
+                }
+            }
+        }
+    };
+    walk(root);
+    return files.sort();
+}
+function readSources(root, paths) {
+    const out = [];
+    for (const path of paths) {
+        try {
+            if (statSync(path).size > MAX_FILE_BYTES) {
+                continue;
+            }
+            const text = readFileSync(path, 'utf8');
+            out.push({ path, rel: relative(root, path).split('\\').join('/'), text, index: new LineIndex(text) });
+        }
+        catch {
+            // unreadable files are skipped, as in detect
+        }
+    }
+    return out;
+}
+/** Every match of `pattern` (which must carry the `g` flag) across `files`, with its position */
+export function findAll(files, pattern) {
+    const found = [];
+    for (const file of files) {
+        for (const match of file.text.matchAll(pattern)) {
+            const { line, column } = file.index.positionAt(match.index ?? 0);
+            found.push({ file: file.path, line, column, match });
+        }
+    }
+    return found;
+}
+/** The first file among `candidates` (relative paths) where the extractor finds `target` */
+function extractFirst(root, candidates, target) {
+    for (const rel of candidates) {
+        const path = join(root, rel);
+        if (!isSourceFile(path) || !existsSync(path)) {
+            continue;
+        }
+        try {
+            const result = extractFromFile(path, { target });
+            if (result.value !== undefined) {
+                return result;
+            }
+        }
+        catch (error) {
+            if (!(error instanceof CapabilityError)) {
+                throw error;
+            }
+            // a file the extractor cannot parse is reported by its own rule, not here
+        }
+    }
+    return undefined;
+}
+export function buildSetupContext(project, options = {}) {
+    const report = describeProject(project, options.manifest, options.boundary);
+    const root = project.path;
+    const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+    const dependencies = { ...(pkg.peerDependencies ?? {}), ...(pkg.devDependencies ?? {}), ...(pkg.dependencies ?? {}) };
+    const major = options.major ?? report.adaptable.major;
+    if (major === undefined) {
+        throw new CapabilityError('USAGE', `The AdapTable major of ${root} could not be determined.`, 'Pin @adaptabletools/adaptable to a version in package.json, or pass --major <n>.');
+    }
+    const uniq = (list) => [...new Set(list)];
+    return {
+        project: report,
+        framework: report.framework,
+        major,
+        ...(options.manifest ? { manifest: options.manifest } : {}),
+        sources: readSources(root, listSourceFiles(root)),
+        styles: readSources(root, listStyleFiles(root)),
+        dependencies,
+        options: extractFirst(root, uniq([...report.entryPoints, ...report.initialStateLiterals]), 'options'),
+        columnDefs: extractFirst(root, uniq([...report.entryPoints, ...report.columnDefsFiles]), 'columnDefs'),
+        state: extractFirst(root, uniq([...report.initialStateLiterals, ...report.entryPoints]), 'state'),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/core/setup/context.js.map

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

package/dist/core/setup/rules/cell-data-type.js

@@ -0,0 +1,40 @@
+import { isObj } from '../../state/expressions.js';
+import { defineSetupRule, positionOf } from './rule.js';
+/** Every leaf ColDef declares its `cellDataType` (AdapTable's data types come from it; Appendix E) */
+export default defineSetupRule({
+    id: 'setup/cell-data-type',
+    docs: 'dev-guide-aggrid-cell-data-types',
+    check(ctx) {
+        const defs = ctx.columnDefs?.value;
+        if (!Array.isArray(defs)) {
+            return [];
+        }
+        const missing = [];
+        const visit = (def, path) => {
+            if (!isObj(def)) {
+                return;
+            }
+            if (Array.isArray(def.children)) {
+                def.children.forEach((child, i) => visit(child, `${path}.children[${i}]`));
+                return;
+            }
+            const id = typeof def.colId === 'string' ? def.colId : typeof def.field === 'string' ? def.field : undefined;
+            if (id && typeof def.cellDataType !== 'string' && def.cellDataType !== false) {
+                missing.push({ id, path });
+            }
+        };
+        defs.forEach((def, i) => visit(def, `[${i}]`));
+        if (!missing.length) {
+            return [];
+        }
+        const issues = missing.map(({ id, path }) => ({
+            severity: 'warning',
+            path,
+            message: `Column "${id}" has no \`cellDataType\`; AdapTable infers its data type from the first rows, which is unreliable for dates and empty columns.`,
+            fix: "Set `cellDataType: 'text' | 'number' | 'boolean' | 'date' | 'dateString' | 'object'` on the ColDef.",
+            ...(positionOf(ctx.columnDefs, path) ?? {}),
+        }));
+        return issues;
+    },
+});
+//# sourceMappingURL=cell-data-type.js.map

package/dist/core/setup/rules/cell-data-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-data-type.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/cell-data-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAEzE,sGAAsG;AACtG,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,kCAAkC;IACxC,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,OAAO,GAAmC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,CAAC,GAAY,EAAE,IAAY,EAAQ,EAAE;YACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO;YACT,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC3E,OAAO;YACT,CAAC;YACD,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;YAC7G,IAAI,EAAE,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;gBAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,MAAM,GAAiB,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,QAAQ,EAAE,SAAS;YACnB,IAAI;YACJ,OAAO,EAAE,WAAW,EAAE,iIAAiI;YACvJ,GAAG,EAAE,qGAAqG;YAC1G,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;SAC5C,CAAC,CAAC,CAAC;QACJ,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/core/setup/rules/coldef-ownership.js

@@ -0,0 +1,67 @@
+import { isObj } from '../../state/expressions.js';
+import { defineSetupRule, positionOf } from './rule.js';
+/**
+ * Appendix E as data: ColDef properties AdapTable owns, the Layout / State property that
+ * replaces them, and the `check setup` severity. `convert coldefs` (A4.5) derives its
+ * `remove` list (the `warning` rows) and its `candidates` (the `info` rows) from this
+ * same table.
+ */
+export const COLDEF_OWNERSHIP = {
+    hide: { owner: 'Layout.Layouts[].TableColumns (leave the column out)', severity: 'warning' },
+    pinned: { owner: 'Layout.Layouts[].ColumnPinning', severity: 'warning' },
+    width: { owner: 'Layout.Layouts[].ColumnSizing', severity: 'warning' },
+    flex: { owner: 'Layout.Layouts[].ColumnSizing', severity: 'warning' },
+    sort: { owner: 'Layout.Layouts[].ColumnSorts', severity: 'warning' },
+    sortIndex: { owner: 'Layout.Layouts[].ColumnSorts (order)', severity: 'warning' },
+    rowGroup: { owner: 'Layout.Layouts[].RowGroupedColumns', severity: 'warning' },
+    rowGroupIndex: { owner: 'Layout.Layouts[].RowGroupedColumns (order)', severity: 'warning' },
+    pivot: { owner: 'Layout.Layouts[].PivotColumns', severity: 'warning' },
+    pivotIndex: { owner: 'Layout.Layouts[].PivotColumns (order)', severity: 'warning' },
+    aggFunc: { owner: 'Layout.Layouts[].TableAggregationColumns / PivotAggregationColumns', severity: 'warning' },
+    cellStyle: { owner: 'FormatColumn (Scope + Style)', severity: 'info' },
+    cellClassRules: { owner: 'FormatColumn (Scope + Rule + Style)', severity: 'info' },
+    valueFormatter: { owner: 'FormatColumn.DisplayFormat', severity: 'info' },
+    valueGetter: { owner: 'CalculatedColumn (an AdapTableQL Expression)', severity: 'info', note: 'unless the value needs JavaScript state the Expression cannot reach' },
+    cellRenderer: { owner: 'StyledColumn (sparklines, percent bars, badges, ratings) or ActionColumn (buttons)', severity: 'info', note: 'for anything but a bespoke renderer' },
+};
+const OWNED = COLDEF_OWNERSHIP;
+/**
+ * ColDef properties AdapTable owns (Appendix E) are set in Initial State instead,
+ * where AdapTable persists and overrides them.
+ */
+export default defineSetupRule({
+    id: 'setup/coldef-ownership',
+    docs: 'dev-guide-columns-configuring-coldefs',
+    check(ctx) {
+        const defs = ctx.columnDefs?.value;
+        if (!Array.isArray(defs)) {
+            return [];
+        }
+        const issues = [];
+        const visit = (def, path) => {
+            if (!isObj(def)) {
+                return;
+            }
+            if (Array.isArray(def.children)) {
+                def.children.forEach((child, i) => visit(child, `${path}.children[${i}]`));
+                return;
+            }
+            const id = typeof def.colId === 'string' ? def.colId : typeof def.field === 'string' ? def.field : path;
+            for (const [prop, { owner, severity, note }] of Object.entries(OWNED)) {
+                if (def[prop] === undefined) {
+                    continue;
+                }
+                issues.push({
+                    severity,
+                    path: `${path}.${prop}`,
+                    message: `\`${prop}\` on column "${id}" is owned by AdapTable: set it in \`${owner}\`${note ? ` (${note})` : ''}.`,
+                    fix: severity === 'warning' ? `Remove \`${prop}\` from the ColDef and express it in Initial State (\`convert coldefs\` does this for a whole columnDefs).` : `Consider moving it to Initial State so it is persisted and editable at run time.`,
+                    ...(positionOf(ctx.columnDefs, `${path}.${prop}`, 'key') ?? {}),
+                });
+            }
+        };
+        defs.forEach((def, i) => visit(def, `[${i}]`));
+        return issues;
+    },
+});
+//# sourceMappingURL=coldef-ownership.js.map

package/dist/core/setup/rules/coldef-ownership.js.map

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

package/dist/core/setup/rules/css-import.js

@@ -0,0 +1,34 @@
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+const CSS_IMPORT = /@adaptabletools\/adaptable(?:-[a-z0-9-]+)?\/(?:index|base|themes\/[^'"`)]+)\.css/g;
+const TAILWIND = /@import\s+["']tailwindcss|@tailwind\s+(?:base|components|utilities)/g;
+/** AdapTable's stylesheet is imported somewhere: source, CSS, or angular.json `styles` */
+export default defineSetupRule({
+    id: 'setup/css-import',
+    docs: 'getting-started-installation',
+    check(ctx) {
+        const imports = findAll([...ctx.sources, ...ctx.styles], CSS_IMPORT);
+        if (!imports.length) {
+            return [
+                {
+                    severity: 'error',
+                    message: 'AdapTable\'s stylesheet (`@adaptabletools/adaptable/index.css`) is not imported anywhere; the grid renders unstyled.',
+                    fix: `Import it once, where your app loads global styles: ${ctx.framework === 'angular' ? 'add `node_modules/@adaptabletools/adaptable/index.css` to `styles` in angular.json' : "`import '@adaptabletools/adaptable/index.css';`"}.`,
+                },
+            ];
+        }
+        const issues = [];
+        const tailwind = findAll(ctx.styles, TAILWIND);
+        if (tailwind.length || 'tailwindcss' in ctx.dependencies) {
+            const where = tailwind[0];
+            issues.push({
+                severity: 'info',
+                message: 'Tailwind is present: AdapTable\'s stylesheet must not be reset by Tailwind\'s base layer.',
+                fix: 'Import `@adaptabletools/adaptable/index.css` after Tailwind\'s base layer (or wrap your Tailwind import in `@layer`), and keep AdapTable\'s container outside `@apply`-reset scopes.',
+                ...(where ? { file: where.file, line: where.line, column: where.column } : {}),
+            });
+        }
+        return issues;
+    },
+});
+//# sourceMappingURL=css-import.js.map

package/dist/core/setup/rules/css-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-import.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/css-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAmB,MAAM,WAAW,CAAC;AAE7D,MAAM,UAAU,GAAG,mFAAmF,CAAC;AACvG,MAAM,QAAQ,GAAG,sEAAsE,CAAC;AAExF,0FAA0F;AAC1F,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,8BAA8B;IACpC,KAAK,CAAC,GAAG;QACP,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO;gBACL;oBACE,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,sHAAsH;oBAC/H,GAAG,EAAE,uDAAuD,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,oFAAoF,CAAC,CAAC,CAAC,iDAAiD,GAAG;iBACtO;aACF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,IAAI,QAAQ,CAAC,MAAM,IAAI,aAAa,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,2FAA2F;gBACpG,GAAG,EAAE,sLAAsL;gBAC3L,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/core/setup/rules/direct-grid.js

@@ -0,0 +1,42 @@
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+/** AG Grid created directly, next to AdapTable: two grids, or AdapTable never sees the grid */
+const DIRECT = /\bcreateGrid\s*\(|<AgGridReact\b|<ag-grid-angular\b|<AgGridVue\b|<ag-grid-vue\b/g;
+/**
+ * The Angular wrapper's documented pattern renders `<ag-grid-angular *adaptable="let adaptable">`
+ * inside `<adaptable-provider>`: the structural directive hands the element to AdapTable.
+ */
+function isAdaptableOwned(match) {
+    if (match[0] !== '<ag-grid-angular' || match.input === undefined || match.index === undefined) {
+        return false;
+    }
+    const tagEnd = match.input.indexOf('>', match.index);
+    const tag = match.input.slice(match.index, tagEnd < 0 ? undefined : tagEnd);
+    return /\*adaptable\s*=/.test(tag);
+}
+export default defineSetupRule({
+    id: 'setup/direct-grid',
+    docs: 'getting-started-key-concepts',
+    check(ctx) {
+        return findAll(ctx.sources, DIRECT)
+            .filter((found) => !isAdaptableOwned(found.match))
+            .map((found) => {
+            const what = found.match[0].replace(/\s*\($/, '');
+            return {
+                severity: 'error',
+                message: `\`${what}\` creates an AG Grid directly; AdapTable creates and owns the grid.`,
+                fix: ctx.framework === 'react'
+                    ? 'Render `<Adaptable.Provider adaptableOptions={…} gridOptions={…} modules={…}>` with `<Adaptable.UI />` and `<Adaptable.AgGridReact />` inside it instead of `<AgGridReact>`; the provider mounts the grid.'
+                    : ctx.framework === 'angular'
+                        ? 'Render `<adaptable-provider [adaptableOptions]="…" [gridOptions]="…" [modules]="…">` with `<adaptable-ui>` and `<ag-grid-angular *adaptable="let adaptable" [gridOptions]="adaptable.gridOptions" [modules]="adaptable.modules">` inside it; the `*adaptable` directive hands the grid to AdapTable.'
+                        : ctx.framework === 'vue'
+                            ? 'Render `<AdaptableProvider :adaptableOptions="…" :gridOptions="…" :modules="…">` with `<AdaptableUI />` and `<AdaptableAgGridVue />` inside it instead of the AG Grid component.'
+                            : 'Call `Adaptable.init(adaptableOptions, { gridOptions, modules })` instead of `createGrid(...)`; it resolves with the Adaptable API once the grid is ready.',
+                file: found.file,
+                line: found.line,
+                column: found.column,
+            };
+        });
+    },
+});
+//# sourceMappingURL=direct-grid.js.map

package/dist/core/setup/rules/direct-grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-grid.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/direct-grid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,+FAA+F;AAC/F,MAAM,MAAM,GAAG,kFAAkF,CAAC;AAElG;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAuB;IAC/C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,kBAAkB,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5E,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,mBAAmB;IACvB,IAAI,EAAE,8BAA8B;IACpC,KAAK,CAAC,GAAG;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC;aAChC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;aACjD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO;gBACL,QAAQ,EAAE,OAAgB;gBAC1B,OAAO,EAAE,KAAK,IAAI,sEAAsE;gBACxF,GAAG,EACD,GAAG,CAAC,SAAS,KAAK,OAAO;oBACvB,CAAC,CAAC,4MAA4M;oBAC9M,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS;wBAC3B,CAAC,CAAC,sSAAsS;wBACxS,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,KAAK;4BACvB,CAAC,CAAC,kLAAkL;4BACpL,CAAC,CAAC,4JAA4J;gBACtK,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,53 @@
+import cellDataType from './cell-data-type.js';
+import coldefOwnership from './coldef-ownership.js';
+import cssImport from './css-import.js';
+import directGrid from './direct-grid.js';
+import licenceLiteral from './licence-literal.js';
+import modules from './modules.js';
+import reactStableRefs from './react-stable-refs.js';
+import readyHook from './ready-hook.js';
+import requiredOptions from './required-options.js';
+import versionSkew from './version-skew.js';
+export const STATIC_RULES = [
+    cssImport,
+    requiredOptions,
+    licenceLiteral,
+    versionSkew,
+    modules,
+    cellDataType,
+    directGrid,
+    coldefOwnership,
+    reactStableRefs,
+    readyHook,
+];
+export const OPTIONS_SHAPE_RULE = 'setup/options-shape';
+export const SETUP_RULE_IDS = [...STATIC_RULES.map((r) => r.id), OPTIONS_SHAPE_RULE];
+export function runStaticRules(ctx) {
+    const issues = [];
+    const applied = [];
+    const skipped = [];
+    for (const rule of STATIC_RULES) {
+        if (rule.frameworks && !rule.frameworks.includes(ctx.framework)) {
+            skipped.push(rule.id);
+            continue;
+        }
+        applied.push(rule.id);
+        for (const found of rule.check(ctx)) {
+            const issue = { code: rule.id, severity: found.severity, message: found.message, docs: rule.docs };
+            if (found.path !== undefined) {
+                issue.path = found.path;
+            }
+            if (found.fix) {
+                issue.fix = found.fix;
+            }
+            if (found.file) {
+                issue.file = found.file;
+                issue.line = found.line;
+                issue.column = found.column;
+            }
+            issues.push(issue);
+        }
+    }
+    return { issues, applied, skipped };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/index.ts"],"names":[],"mappings":"AAMA,OAAO,YAAY,MAAM,qBAAqB,CAAC;AAC/C,OAAO,eAAe,MAAM,uBAAuB,CAAC;AACpD,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,cAAc,MAAM,sBAAsB,CAAC;AAClD,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,eAAe,MAAM,wBAAwB,CAAC;AACrD,OAAO,SAAS,MAAM,iBAAiB,CAAC;AACxC,OAAO,eAAe,MAAM,uBAAuB,CAAC;AAEpD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAI5C,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,SAAS;IACT,eAAe;IACf,cAAc;IACd,WAAW;IACX,OAAO;IACP,YAAY;IACZ,UAAU;IACV,eAAe;IACf,eAAe;IACf,SAAS;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAExD,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;AAExG,MAAM,UAAU,cAAc,CAAC,GAAiB;IAC9C,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAU,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1G,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAC1B,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACxB,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACxB,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACxB,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAC9B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/setup/rules/licence-literal.js

@@ -0,0 +1,23 @@
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+/** `licenseKey: '<literal>'` — a string of licence length written in the source */
+const LICENCE_LITERAL = /\blicenseKey\s*[:=]\s*(['"`])([^'"`\n]{24,})\1/g;
+const PLACEHOLDER = /(?:YOUR|MY|INSERT|REPLACE|TODO|XXX|PLACEHOLDER|LICEN[CS]E[_-]?KEY)/i;
+/** The licence key is read from the environment or configuration, not written into the code */
+export default defineSetupRule({
+    id: 'setup/licence-literal',
+    docs: 'getting-started-license-key',
+    check(ctx) {
+        return findAll(ctx.sources, LICENCE_LITERAL)
+            .filter((found) => !PLACEHOLDER.test(found.match[2]))
+            .map((found) => ({
+            severity: 'error',
+            message: 'The AdapTable licence key is written as a string literal in the source.',
+            fix: 'Read it from the environment or build configuration (e.g. `licenseKey: process.env.ADAPTABLE_LICENSE_KEY`, `import.meta.env.VITE_ADAPTABLE_LICENSE_KEY`) and keep it out of version control.',
+            file: found.file,
+            line: found.line,
+            column: found.column,
+        }));
+    },
+});
+//# sourceMappingURL=licence-literal.js.map

package/dist/core/setup/rules/licence-literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"licence-literal.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/licence-literal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,mFAAmF;AACnF,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAC1E,MAAM,WAAW,GAAG,qEAAqE,CAAC;AAE1F,+FAA+F;AAC/F,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,6BAA6B;IACnC,KAAK,CAAC,GAAG;QACP,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC;aACzC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,QAAQ,EAAE,OAAgB;YAC1B,OAAO,EAAE,yEAAyE;YAClF,GAAG,EAAE,8LAA8L;YACnM,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC,CAAC;IACR,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,86 @@
+import { asArray, isObj } from '../../state/expressions.js';
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+const REGISTER = /\bModuleRegistry\.registerModules\s*\(/g;
+const ALL_MODULE = /\bAll(?:Enterprise|Community)Module\b/g;
+const COMMUNITY_ONLY = /\bAllCommunityModule\b/;
+/** State features → the AG Grid Enterprise module they need, for an explicit module list */
+function featuresNeeded(state, columnDefs) {
+    const needed = new Set();
+    const s = isObj(state) ? state : {};
+    for (const layout of asArray(isObj(s.Layout) ? s.Layout.Layouts : undefined)) {
+        if (!isObj(layout)) {
+            continue;
+        }
+        if (layout.RowGroupedColumns !== undefined || layout.PivotGroupedColumns !== undefined) {
+            needed.add('RowGroupingModule');
+        }
+        if (layout.PivotColumns !== undefined) {
+            needed.add('PivotModule');
+        }
+        if (layout.TableAggregationColumns !== undefined || layout.PivotAggregationColumns !== undefined) {
+            needed.add('RowGroupingModule');
+        }
+    }
+    if (s.Export !== undefined) {
+        needed.add('ExcelExportModule');
+    }
+    if (s.Charting !== undefined) {
+        needed.add('IntegratedChartsModule');
+    }
+    for (const def of asArray(columnDefs)) {
+        if (isObj(def) && (def.rowGroup || def.enableRowGroup)) {
+            needed.add('RowGroupingModule');
+        }
+        if (isObj(def) && (def.pivot || def.enablePivot)) {
+            needed.add('PivotModule');
+        }
+    }
+    return [...needed].sort();
+}
+/** AG Grid modules are registered: `AllEnterpriseModule`, or an explicit list that covers what the grid uses */
+export default defineSetupRule({
+    id: 'setup/modules',
+    docs: 'getting-started-installation',
+    check(ctx) {
+        const registrations = findAll(ctx.sources, REGISTER);
+        const allModules = findAll(ctx.sources, ALL_MODULE);
+        if (!registrations.length && !allModules.length) {
+            return [
+                {
+                    severity: 'error',
+                    message: 'No AG Grid module registration was found (`ModuleRegistry.registerModules([...])`); AG Grid 33+ renders nothing without it.',
+                    fix: "Register `AllEnterpriseModule` once at startup: `import { ModuleRegistry, AllEnterpriseModule } from 'ag-grid-enterprise'; ModuleRegistry.registerModules([AllEnterpriseModule]);`",
+                },
+            ];
+        }
+        const issues = [];
+        const community = ctx.sources.find((f) => COMMUNITY_ONLY.test(f.text) && !/\bAllEnterpriseModule\b/.test(f.text));
+        if (community && allModules.every((m) => m.match[0] === 'AllCommunityModule')) {
+            const where = allModules[0];
+            issues.push({
+                severity: 'error',
+                message: 'Only `AllCommunityModule` is registered; AdapTable needs the Enterprise modules.',
+                fix: 'Register `AllEnterpriseModule` from `ag-grid-enterprise` instead.',
+                file: where.file,
+                line: where.line,
+                column: where.column,
+            });
+            return issues;
+        }
+        if (!allModules.length && registrations.length) {
+            const needed = featuresNeeded(ctx.state?.value, ctx.columnDefs?.value);
+            const where = registrations[0];
+            issues.push({
+                severity: 'info',
+                message: `An explicit AG Grid module list is registered${needed.length ? `; the grid's State and columns need at least ${needed.join(', ')}` : ''}.`,
+                fix: 'Make sure the list covers every feature AdapTable drives (row grouping, pivoting, aggregation, Excel export, charts, menus, filters…), or register `AllEnterpriseModule`.',
+                file: where.file,
+                line: where.line,
+                column: where.column,
+            });
+        }
+        return issues;
+    },
+});
+//# sourceMappingURL=modules.js.map

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

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

package/dist/core/setup/rules/react-stable-refs.js

@@ -0,0 +1,20 @@
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+/** `adaptableOptions={{ … }}` / `gridOptions={{ … }}`: a new object on every render */
+const INLINE_PROP = /\b(adaptableOptions|gridOptions)=\{\{/g;
+export default defineSetupRule({
+    id: 'setup/react-stable-refs',
+    docs: 'getting-started-installation',
+    frameworks: ['react'],
+    check(ctx) {
+        return findAll(ctx.sources.filter((f) => /\.(tsx|jsx)$/.test(f.path)), INLINE_PROP).map((found) => ({
+            severity: 'warning',
+            message: `\`${found.match[1]}\` is an inline object literal in JSX: it is a new object on every render, so AdapTable re-initialises or ignores the change.`,
+            fix: `Declare \`${found.match[1]}\` once — at module level, or with \`useMemo(() => ({ … }), [])\` / \`useState\` — and pass the reference.`,
+            file: found.file,
+            line: found.line,
+            column: found.column,
+        }));
+    },
+});
+//# sourceMappingURL=react-stable-refs.js.map

package/dist/core/setup/rules/react-stable-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-stable-refs.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/react-stable-refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,uFAAuF;AACvF,MAAM,WAAW,GAAG,wCAAwC,CAAC;AAE7D,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,8BAA8B;IACpC,UAAU,EAAE,CAAC,OAAO,CAAC;IACrB,KAAK,CAAC,GAAG;QACP,OAAO,OAAO,CACZ,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EACtD,WAAW,CACZ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAChB,QAAQ,EAAE,SAAkB;YAC5B,OAAO,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,+HAA+H;YAC3J,GAAG,EAAE,aAAa,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,4GAA4G;YAC5I,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC"}

package/dist/core/setup/rules/ready-hook.js

@@ -0,0 +1,33 @@
+import { findAll } from '../context.js';
+import { defineSetupRule } from './rule.js';
+const READY = /\badaptableReady\b|\bonAdaptableReady\b|\(adaptableReady\)|@adaptable-ready\b|Adaptable\.init\s*\([^)]*\)\s*\.then\b|await\s+Adaptable\.init\b/g;
+const API_USE = /\badaptableApi\b/g;
+/** The Adaptable API is taken from the ready hook, not assumed to exist at construction */
+export default defineSetupRule({
+    id: 'setup/ready-hook',
+    docs: 'getting-started-adaptable-ready',
+    check(ctx) {
+        if (findAll(ctx.sources, READY).length) {
+            return [];
+        }
+        const uses = findAll(ctx.sources, API_USE);
+        const where = uses[0];
+        return [
+            {
+                severity: uses.length ? 'warning' : 'info',
+                message: uses.length
+                    ? '`adaptableApi` is used but no ready hook was found; the API exists only after AdapTable has initialised.'
+                    : 'No ready hook was found; the Adaptable API (`adaptableApi`) is delivered through it.',
+                fix: ctx.framework === 'react'
+                    ? 'Pass `onAdaptableReady={({ adaptableApi }) => …}` to `<AdaptableReact>`.'
+                    : ctx.framework === 'angular'
+                        ? 'Bind `(adaptableReady)="onReady($event)"` on `<adaptable-angular-aggrid>`.'
+                        : ctx.framework === 'vue'
+                            ? 'Listen to `@adaptable-ready="onReady"` on `<AdaptableVue>`.'
+                            : 'Use `const api = await Adaptable.init(adaptableOptions, gridOptions)` (or `.then(api => …)`).',
+                ...(where ? { file: where.file, line: where.line, column: where.column } : {}),
+            },
+        ];
+    },
+});
+//# sourceMappingURL=ready-hook.js.map

package/dist/core/setup/rules/ready-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-hook.js","sourceRoot":"","sources":["../../../../src/core/setup/rules/ready-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,KAAK,GAAG,iJAAiJ,CAAC;AAChK,MAAM,OAAO,GAAG,mBAAmB,CAAC;AAEpC,2FAA2F;AAC3F,eAAe,eAAe,CAAC;IAC7B,EAAE,EAAE,kBAAkB;IACtB,IAAI,EAAE,iCAAiC;IACvC,KAAK,CAAC,GAAG;QACP,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,OAAO;YACL;gBACE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;gBAC1C,OAAO,EAAE,IAAI,CAAC,MAAM;oBAClB,CAAC,CAAC,0GAA0G;oBAC5G,CAAC,CAAC,sFAAsF;gBAC1F,GAAG,EACD,GAAG,CAAC,SAAS,KAAK,OAAO;oBACvB,CAAC,CAAC,0EAA0E;oBAC5E,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,SAAS;wBAC3B,CAAC,CAAC,4EAA4E;wBAC9E,CAAC,CAAC,GAAG,CAAC,SAAS,KAAK,KAAK;4BACvB,CAAC,CAAC,6DAA6D;4BAC/D,CAAC,CAAC,+FAA+F;gBACzG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,43 @@
+import { columnsFromInput } from '../../state/columns.js';
+import { defineSetupRule, positionOf } from './rule.js';
+/** `adaptableId` and `primaryKey` are set, and `primaryKey` names a column when the columns are visible */
+export default defineSetupRule({
+    id: 'setup/required-options',
+    docs: 'technical-reference-adaptable-options',
+    check(ctx) {
+        const options = ctx.options?.value;
+        if (!options || typeof options !== 'object' || Array.isArray(options)) {
+            return [];
+        }
+        const issues = [];
+        const root = positionOf(ctx.options, '');
+        for (const key of ['adaptableId', 'primaryKey']) {
+            const value = options[key];
+            if (typeof value !== 'string' || !value) {
+                issues.push({
+                    severity: 'error',
+                    path: key,
+                    message: `Adaptable Options have no \`${key}\`${value === null ? ' that can be read statically' : ''}.`,
+                    fix: key === 'primaryKey' ? 'Set `primaryKey` to the column id that uniquely identifies a row.' : 'Set `adaptableId` to a stable name; it keys persisted State and licence checks.',
+                    ...(root ?? {}),
+                });
+            }
+        }
+        const primaryKey = options.primaryKey;
+        if (typeof primaryKey === 'string' && primaryKey && Array.isArray(ctx.columnDefs?.value)) {
+            const ids = columnsFromInput(ctx.columnDefs.value).map((c) => c.id);
+            if (ids.length && !ids.includes(primaryKey)) {
+                const cased = ids.find((id) => id.toLowerCase() === primaryKey.toLowerCase());
+                issues.push({
+                    severity: 'error',
+                    path: 'primaryKey',
+                    message: `\`primaryKey: "${primaryKey}"\` does not match any column (${ids.slice(0, 8).map((id) => `"${id}"`).join(', ')}${ids.length > 8 ? ', …' : ''}).`,
+                    fix: cased ? `Use "${cased}" — column ids are case-sensitive.` : 'Use a column\'s `colId` (or `field`), or add the column.',
+                    ...(positionOf(ctx.options, 'primaryKey') ?? {}),
+                });
+            }
+        }
+        return issues;
+    },
+});
+//# sourceMappingURL=required-options.js.map