@celljs/cli 3.8.0 → 4.0.0

package/lib/config/config-resolver.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-resolver.spec.d.ts","sourceRoot":"","sources":["../../src/config/config-resolver.spec.ts"],"names":[],"mappings":""}

package/lib/config/config-resolver.spec.js

@@ -0,0 +1,159 @@
+import { afterEach, describe, expect, it } from 'bun:test';
+import { CellError } from '@celljs/kit';
+import { nodePreset } from '../preset/builtin-presets.js';
+import { FixtureProject } from '../test/fixture-project.js';
+import { ConfigResolver } from './config-resolver.js';
+async function failure(promise) {
+    try {
+        await promise;
+    }
+    catch (error) {
+        expect(CellError.is(error)).toBe(true);
+        return error;
+    }
+    throw new Error('expected a CellError');
+}
+describe('ConfigResolver', () => {
+    let fixture;
+    afterEach(() => fixture?.dispose());
+    function project(config, name = 'cell.config.ts') {
+        fixture = new FixtureProject('resolver').file('package.json', { name: 'app' });
+        if (config !== undefined) {
+            fixture.file(name, config);
+        }
+        return fixture;
+    }
+    function resolve(options = {}) {
+        return new ConfigResolver({ root: fixture.root, command: 'build', env: {}, ...options }).resolve();
+    }
+    it('uses defaults when the project has no cell.config', async () => {
+        project();
+        const resolved = await resolve();
+        expect(resolved.file).toBeUndefined();
+        expect(resolved.mode).toEqual(['production']);
+        expect(resolved.preset).toEqual({ name: 'node', source: 'default' });
+        expect(resolved.build).toEqual({ format: undefined, single: false, compile: false, external: [], sourcemap: false, outDir: '.cell/output' });
+        expect(resolved.modules).toEqual([]);
+        expect(resolved.options).toEqual({});
+    });
+    it('loads TypeScript that imports defineConfig and local files, and reports them as dependencies', async () => {
+        project([
+            "import { defineConfig } from '@celljs/cli';",
+            "import { outDir } from './config/paths';",
+            "const format: 'cjs' = 'cjs';",
+            "export default defineConfig({ preset: 'fc', fc: { trigger: 'http' }, build: { format, outDir }, hooks: { 'build:before': 'echo hi' } });",
+        ].join('\n')).file('config/paths.ts', "export const outDir = 'dist';");
+        const resolved = await resolve();
+        expect(resolved.file).toBe(fixture.path('cell.config.ts'));
+        expect(resolved.dependencies).toContain(fixture.path('config', 'paths.ts'));
+        expect(resolved.preset).toEqual({ name: 'fc', source: 'config' });
+        expect(resolved.build).toMatchObject({ format: 'cjs', outDir: 'dist' });
+        expect(resolved.options).toEqual({ fc: { trigger: 'http' } });
+        expect(resolved.hooks).toEqual({ 'build:before': 'echo hi' });
+    });
+    it('loads JavaScript config files', async () => {
+        project('export default { build: { sourcemap: true } };', 'cell.config.mjs');
+        expect((await resolve()).build.sourcemap).toBe(true);
+    });
+    it('chooses the preset from flag, config, environment, CI detection, then default', async () => {
+        const detectors = [{ name: 'vercel', detect: (env) => env.VERCEL === '1' }];
+        project();
+        expect((await resolve({ env: { CI: 'true', VERCEL: '1' }, detectors })).preset).toEqual({ name: 'vercel', source: 'ci' });
+        expect((await resolve({ env: { VERCEL: '1' }, detectors })).preset.source).toBe('default');
+        expect((await resolve({ env: { CI: 'true', VERCEL: '1', CELL_PRESET: 'bun' }, detectors })).preset).toEqual({ name: 'bun', source: 'env' });
+        fixture.file('cell.config.ts', "export default { preset: 'scf' };");
+        expect((await resolve({ env: { CELL_PRESET: 'bun' } })).preset).toEqual({ name: 'scf', source: 'config' });
+        expect((await resolve({ flags: { preset: 'deno' } })).preset).toEqual({ name: 'deno', source: 'flag' });
+    });
+    it('puts the mode of the command first, then -m modes without duplicates', async () => {
+        project();
+        expect((await resolve({ command: 'dev', flags: { mode: ['test', 'test', 'local'] } })).mode).toEqual(['development', 'test', 'local']);
+        expect((await resolve({ flags: { mode: ['production'] } })).mode).toEqual(['production']);
+        expect((await failure(resolve({ flags: { mode: ['../x'] } }))).code).toBe('CELL_ARGUMENT_INVALID');
+    });
+    it('lets flags override build options and switches node executables to CommonJS', async () => {
+        project("export default { build: { sourcemap: true, outDir: 'dist', compile: true } };");
+        expect((await resolve({ flags: { sourcemap: false, outDir: 'out' } })).build).toMatchObject({ sourcemap: false, outDir: 'out', compile: 'bun' });
+        expect((await resolve({ flags: { compile: 'node' } })).build).toMatchObject({ compile: 'node', format: 'cjs' });
+        const conflict = await failure(resolve({ flags: { compile: 'node', format: 'esm' } }));
+        expect(conflict.code).toBe('CELL_CONFIG_CONFLICT');
+    });
+    it('normalises modules and resolves local paths', async () => {
+        project("export default { modules: ['./modules/audit', './modules/pkg', '@x/tool', '!@x/off', { source: '@x/react', runtime: false }] };")
+            .file('modules/audit.ts', 'export default () => {};')
+            .file('modules/pkg/package.json', { name: 'pkg' });
+        expect((await resolve()).modules).toEqual([
+            { kind: 'local', path: fixture.path('modules', 'audit.ts') },
+            { kind: 'local', path: fixture.path('modules', 'pkg') },
+            { kind: 'package', name: '@x/tool' },
+            { kind: 'disabled', name: '@x/off' },
+            { kind: 'filter', name: '@x/react', runtime: false, toolchain: true },
+        ]);
+    });
+    it('reports a missing local module where it is written', async () => {
+        project("export default {\n  modules: ['./modules/missing'],\n};");
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_LOCAL_MODULE_NOT_FOUND');
+        expect(error.file).toBe(fixture.path('cell.config.ts'));
+        expect(error.line).toBe(2);
+    });
+    it('rejects a package listed twice', async () => {
+        project("export default { modules: ['!@x/a', { source: '@x/a', toolchain: false }] };");
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_CONFIG_INVALID');
+        expect(error.message).toContain('@x/a twice');
+    });
+    it('rejects two config files', async () => {
+        project('export default {};').file('cell.config.mjs', 'export default {};');
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_CONFIG_AMBIGUOUS');
+    });
+    it('reports a config file that does not compile', async () => {
+        project('export default { preset: ;');
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_CONFIG_LOAD');
+        expect(error.file).toContain('cell.config.ts');
+    });
+    it('reports a config file that throws', async () => {
+        project("throw new Error('boom'); export default {};");
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_CONFIG_LOAD');
+        expect(error.message).toContain('boom');
+    });
+    it('validates the loaded configuration', async () => {
+        project("export default {\n  build: { format: 'umd' },\n};");
+        const error = await failure(resolve());
+        expect(error.code).toBe('CELL_CONFIG_INVALID');
+        expect(error.line).toBe(2);
+    });
+    it('requires a project root', async () => {
+        const error = await failure(new ConfigResolver({ root: '/', command: 'build' }).resolve());
+        expect(error.code).toBe('CELL_PROJECT_NOT_FOUND');
+    });
+    it('maps the configuration onto builder options', async () => {
+        project("export default { modules: ['!@x/off', { source: '@x/ui', runtime: false }, { source: '@x/tool', toolchain: false }], vite: { define: { A: '1' } }, build: { external: ['sharp'] } };");
+        const options = ConfigResolver.toBuilderOptions(await resolve({ flags: { mode: ['test'] } }), nodePreset);
+        expect(options).toEqual({
+            root: fixture.root,
+            mode: ['production', 'test'],
+            targets: undefined,
+            preset: 'node',
+            entryName: 'http',
+            format: 'esm',
+            outDir: '.cell/output',
+            external: ['sharp'],
+            sourcemap: false,
+            single: false,
+            vite: { define: { A: '1' } },
+            disabled: ['@x/off'],
+            runtimeDisabled: ['@x/ui'],
+        });
+        const single = await resolve({ flags: { single: true } });
+        expect(ConfigResolver.toBuilderOptions(single, nodePreset).single).toBe(true);
+        // An executable is built from the single-file bundle.
+        expect(ConfigResolver.toBuilderOptions(await resolve({ flags: { compile: 'bun' } }), nodePreset).single).toBe(true);
+        // The component graph does not depend on build-only settings, so `cell info` can still describe the project.
+        expect(ConfigResolver.toProjectOptions(single, nodePreset)).toMatchObject({ root: fixture.root, entryName: 'http' });
+    });
+});
+//# sourceMappingURL=config-resolver.spec.js.map

package/lib/config/config-resolver.spec.js.map

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

package/lib/config/config-validator.d.ts

@@ -0,0 +1,35 @@
+import { CellError } from '@celljs/kit';
+import type { CellConfig } from './types.js';
+type Path = readonly (string | number)[];
+/**
+ * Checks the shape of a loaded cell.config file. Every problem is a `CELL_CONFIG_INVALID` error that
+ * names the field, where it is written and how to fix it; likely typos get a "did you mean".
+ */
+export declare class ConfigValidator {
+    protected readonly file: string;
+    protected readonly source: string;
+    static readonly KEYS: string[];
+    static readonly TARGETS: string[];
+    static readonly BUILD_KEYS: string[];
+    static readonly FILTER_KEYS: string[];
+    static readonly FORMATS: string[];
+    static readonly COMPILE_TARGETS: string[];
+    static readonly PACKAGE_NAME: RegExp;
+    /** @param source text of the file, used to report line numbers */
+    constructor(file: string, source?: string);
+    static isLocalPath(entry: string): boolean;
+    validate(value: unknown): CellConfig;
+    protected modules(value: unknown): void;
+    protected targets(value: unknown): void;
+    protected build(value: unknown): void;
+    protected hooks(value: unknown): void;
+    /** Any other top-level field holds the options of a toolchain module, read with `cell.options(key)`. */
+    protected moduleOptions(key: string, value: unknown): void;
+    protected unknownKeys(value: Record<string, unknown>, known: readonly string[], path: Path): void;
+    protected expect(ok: boolean, path: Path, expected: string, actual: unknown): void;
+    protected error(path: Path, message: string, hint: string): CellError;
+    protected format(path: Path): string;
+    protected describe(value: unknown): string;
+}
+export {};
+//# sourceMappingURL=config-validator.d.ts.map

package/lib/config/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../src/config/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,SAAS,EAAgC,MAAM,aAAa,CAAC;AAGnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,KAAK,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAEzC;;;GAGG;AACH,qBAAa,eAAe;IAWpB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAC/B,SAAS,CAAC,QAAQ,CAAC,MAAM;IAX7B,MAAM,CAAC,QAAQ,CAAC,IAAI,WAA8D;IAClF,MAAM,CAAC,QAAQ,CAAC,OAAO,WAA2B;IAClD,MAAM,CAAC,QAAQ,CAAC,UAAU,WAAsE;IAChG,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAsC;IACjE,MAAM,CAAC,QAAQ,CAAC,OAAO,WAAkB;IACzC,MAAM,CAAC,QAAQ,CAAC,eAAe,WAA2B;IAC1D,MAAM,CAAC,QAAQ,CAAC,YAAY,SAA4D;IAExF,kEAAkE;IAClE,YACuB,IAAI,EAAE,MAAM,EACZ,MAAM,SAAK,EAC9B;IAEJ,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEzC;IAED,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAgCnC;IAED,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CA8BtC;IAED,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAKtC;IAED,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAepC;IAED,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CA2BpC;IAED,wGAAwG;IACxG,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAYzD;IAED,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAWhG;IAED,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAIjF;IAED,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAGpE;IAED,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnC;IAED,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAczC;CACJ"}

package/lib/config/config-validator.js

@@ -0,0 +1,160 @@
+import { CELL_EVENTS, CellError, EVENT_RULES, HOOKABLE_EVENTS } from '@celljs/kit';
+import { ConfigUtil } from '@celljs/vite';
+import { TextUtil } from '../utils/text-util.js';
+/**
+ * Checks the shape of a loaded cell.config file. Every problem is a `CELL_CONFIG_INVALID` error that
+ * names the field, where it is written and how to fix it; likely typos get a "did you mean".
+ */
+export class ConfigValidator {
+    file;
+    source;
+    static KEYS = ['preset', 'targets', 'modules', 'build', 'vite', 'hooks'];
+    static TARGETS = ['frontend', 'backend'];
+    static BUILD_KEYS = ['format', 'single', 'compile', 'external', 'sourcemap', 'outDir'];
+    static FILTER_KEYS = ['source', 'runtime', 'toolchain'];
+    static FORMATS = ['esm', 'cjs'];
+    static COMPILE_TARGETS = ['bun', 'node', 'deno'];
+    static PACKAGE_NAME = /^(@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+    /** @param source text of the file, used to report line numbers */
+    constructor(file, source = '') {
+        this.file = file;
+        this.source = source;
+    }
+    static isLocalPath(entry) {
+        return entry.startsWith('.') || entry.startsWith('/');
+    }
+    validate(value) {
+        if (!ConfigUtil.isPlainObject(value)) {
+            throw this.error([], `The default export is ${this.describe(value)}, not an object.`, 'Write `export default defineConfig({ ... })`.');
+        }
+        for (const [key, item] of Object.entries(value)) {
+            if (item === undefined) {
+                continue;
+            }
+            switch (key) {
+                case 'preset':
+                    this.expect(typeof item === 'string' && item !== '', [key], 'a preset name such as `node`', item);
+                    break;
+                case 'targets':
+                    this.targets(item);
+                    break;
+                case 'modules':
+                    this.modules(item);
+                    break;
+                case 'build':
+                    this.build(item);
+                    break;
+                case 'vite':
+                    this.expect(ConfigUtil.isPlainObject(item), [key], 'a Vite configuration object', item);
+                    break;
+                case 'hooks':
+                    this.hooks(item);
+                    break;
+                default:
+                    this.moduleOptions(key, item);
+            }
+        }
+        return value;
+    }
+    modules(value) {
+        this.expect(Array.isArray(value), ['modules'], 'an array', value);
+        value.forEach((entry, index) => {
+            const path = ['modules', index];
+            if (typeof entry === 'string') {
+                const name = entry.startsWith('!') ? entry.slice(1) : entry;
+                const valid = ConfigValidator.isLocalPath(entry) || ConfigValidator.PACKAGE_NAME.test(name);
+                this.expect(valid, path, "a relative path ('./modules/x'), a package name, or '!' and a package name", entry);
+                return;
+            }
+            this.expect(ConfigUtil.isPlainObject(entry), path, 'a string or `{ source, runtime?, toolchain? }`', entry);
+            const filter = entry;
+            this.unknownKeys(filter, ConfigValidator.FILTER_KEYS, path);
+            this.expect(typeof filter.source === 'string' && ConfigValidator.PACKAGE_NAME.test(filter.source), [...path, 'source'], 'a package name', filter.source);
+            for (const key of ['runtime', 'toolchain']) {
+                this.expect(filter[key] === undefined || typeof filter[key] === 'boolean', [...path, key], 'a boolean', filter[key]);
+            }
+            if (filter.runtime !== false && filter.toolchain !== false) {
+                throw this.error(path, `The entry for ${filter.source} keeps everything, so it has no effect.`, `Set \`runtime: false\` or \`toolchain: false\`, or write '!${filter.source}' to leave the component out.`);
+            }
+        });
+    }
+    targets(value) {
+        const list = value;
+        const valid = Array.isArray(value) && list.length > 0 && list.every(t => ConfigValidator.TARGETS.includes(t)) && new Set(list).size === list.length;
+        this.expect(valid, ['targets'], "a non-empty list of 'frontend' and 'backend' without duplicates", value);
+    }
+    build(value) {
+        this.expect(ConfigUtil.isPlainObject(value), ['build'], 'an object', value);
+        const build = value;
+        this.unknownKeys(build, ConfigValidator.BUILD_KEYS, ['build']);
+        const optional = (key, ok, expected) => this.expect(build[key] === undefined || ok, ['build', key], expected, build[key]);
+        optional('format', ConfigValidator.FORMATS.includes(build.format), "'esm' or 'cjs'");
+        optional('single', typeof build.single === 'boolean', 'a boolean');
+        optional('compile', typeof build.compile === 'boolean' || ConfigValidator.COMPILE_TARGETS.includes(build.compile), "a boolean, 'bun', 'node' or 'deno'");
+        optional('external', Array.isArray(build.external) && build.external.every(name => typeof name === 'string'), 'an array of package names');
+        optional('sourcemap', typeof build.sourcemap === 'boolean', 'a boolean');
+        optional('outDir', typeof build.outDir === 'string' && build.outDir !== '', 'a directory relative to the project root');
+    }
+    hooks(value) {
+        this.expect(ConfigUtil.isPlainObject(value), ['hooks'], 'an object of event names to hooks', value);
+        for (const [event, hook] of Object.entries(value)) {
+            if (!CELL_EVENTS.includes(event)) {
+                const suggestion = TextUtil.closest(event, CELL_EVENTS, 3);
+                throw this.error(['hooks', event], `Unknown event '${event}'.`, suggestion ? `Did you mean '${suggestion}'?` : `Use one of: ${CELL_EVENTS.join(', ')}.`);
+            }
+            if (EVENT_RULES[event] === 'mutate') {
+                throw this.error(['hooks', event], `'${event}' lets handlers change the event object, which a command cannot do.`, `Subscribe with cell.on('${event}', ...) in a local module, or run the command on one of: ${HOOKABLE_EVENTS.join(', ')}.`);
+            }
+            if (typeof hook === 'function') {
+                throw this.error(['hooks', event], `hooks['${event}'] is a function; hooks only run shell commands.`, `Move the function into a local module (export default (cell) => cell.on('${event}', ...)) and list it in \`modules\`.`);
+            }
+            this.expect(typeof hook === 'string' && hook.trim() !== '', ['hooks', event], 'a shell command', hook);
+        }
+    }
+    /** Any other top-level field holds the options of a toolchain module, read with `cell.options(key)`. */
+    moduleOptions(key, value) {
+        const suggestion = TextUtil.closest(key, ConfigValidator.KEYS, key.length >= 5 ? 2 : 1);
+        if (suggestion) {
+            throw this.error([key], `Unknown field '${key}'.`, `Did you mean '${suggestion}'?`);
+        }
+        if (!ConfigUtil.isPlainObject(value)) {
+            throw this.error([key], `'${key}' is ${this.describe(value)}; options of a toolchain module must be an object.`, `Write \`${key}: { ... }\`. To turn a component off, add '!<package>' to \`modules\`.`);
+        }
+    }
+    unknownKeys(value, known, path) {
+        for (const key of Object.keys(value)) {
+            if (!known.includes(key)) {
+                const suggestion = TextUtil.closest(key, known);
+                throw this.error([...path, key], `Unknown field '${key}'.`, suggestion ? `Did you mean '${suggestion}'?` : `Known fields: ${known.join(', ')}.`);
+            }
+        }
+    }
+    expect(ok, path, expected, actual) {
+        if (!ok) {
+            throw this.error(path, `${this.format(path)} must be ${expected}, got ${this.describe(actual)}.`, `Change ${this.format(path)} to ${expected}.`);
+        }
+    }
+    error(path, message, hint) {
+        const position = TextUtil.locate(this.source, path);
+        return new CellError({ code: 'CELL_CONFIG_INVALID', message, hint, file: this.file, line: position?.line, column: position?.column });
+    }
+    format(path) {
+        return path.map((key, i) => (typeof key === 'number' ? `[${key}]` : /^[A-Za-z_$][\w$]*$/.test(key) ? `${i ? '.' : ''}${key}` : `['${key}']`)).join('');
+    }
+    describe(value) {
+        if (value === undefined || value === null) {
+            return String(value);
+        }
+        if (typeof value === 'function') {
+            return 'a function';
+        }
+        if (Array.isArray(value)) {
+            return 'an array';
+        }
+        if (typeof value === 'object') {
+            return 'an object';
+        }
+        return JSON.stringify(value);
+    }
+}
+//# sourceMappingURL=config-validator.js.map

package/lib/config/config-validator.js.map

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

package/lib/config/config-validator.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-validator.spec.d.ts.map

package/lib/config/config-validator.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.spec.d.ts","sourceRoot":"","sources":["../../src/config/config-validator.spec.ts"],"names":[],"mappings":""}

package/lib/config/config-validator.spec.js

@@ -0,0 +1,77 @@
+import { describe, expect, it } from 'bun:test';
+import { CellError } from '@celljs/kit';
+import { ConfigValidator } from './config-validator.js';
+function failure(value, source = '') {
+    try {
+        new ConfigValidator('/app/cell.config.ts', source).validate(value);
+    }
+    catch (error) {
+        expect(CellError.is(error)).toBe(true);
+        expect(error.code).toBe('CELL_CONFIG_INVALID');
+        return error;
+    }
+    throw new Error('expected the configuration to be rejected');
+}
+describe('ConfigValidator', () => {
+    it('accepts a complete configuration and module options', () => {
+        const config = {
+            preset: 'fc',
+            fc: { trigger: 'http' },
+            vue: { jsx: true },
+            modules: ['./modules/audit', '@x/tool', '!@celljs/serve-static', { source: '@celljs/react', runtime: false }],
+            build: { format: 'cjs', single: false, compile: 'node', external: ['sharp'], sourcemap: true, outDir: 'dist' },
+            vite: { define: {} },
+            targets: ['backend'],
+            hooks: { 'build:before': 'prisma generate', close: 'echo done' },
+            unset: undefined,
+        };
+        expect(new ConfigValidator('/app/cell.config.ts').validate(config)).toBe(config);
+    });
+    it('requires an object default export', () => {
+        expect(failure(undefined).hint).toContain('defineConfig');
+        expect(failure([]).message).toContain('an array');
+    });
+    it('suggests the intended field for a misspelt top-level key, with its line', () => {
+        const error = failure({ bulid: {} }, 'export default {\n  bulid: {},\n};');
+        expect(error.message).toBe("Unknown field 'bulid'.");
+        expect(error.hint).toBe("Did you mean 'build'?");
+        expect(error.file).toBe('/app/cell.config.ts');
+        expect(error.line).toBe(2);
+    });
+    it('requires module options to be objects', () => {
+        expect(failure({ react: false }).hint).toContain("'!<package>'");
+    });
+    it('checks targets', () => {
+        expect(failure({ targets: [] }).message).toContain('targets');
+        expect(failure({ targets: ['server'] }).message).toContain('targets');
+        expect(failure({ targets: ['backend', 'backend'] }).message).toContain('without duplicates');
+    });
+    it('checks build options', () => {
+        expect(failure({ build: { format: 'umd' } }).message).toBe(`build.format must be 'esm' or 'cjs', got "umd".`);
+        expect(failure({ build: { fromat: 'esm' } }).hint).toBe("Did you mean 'format'?");
+        expect(failure({ build: { compile: 'java' } }).message).toContain('build.compile');
+        expect(failure({ build: { external: ['a', 1] } }).message).toContain('build.external');
+    });
+    it('checks modules entries', () => {
+        expect(failure({ modules: 'x' }).message).toContain('modules must be an array');
+        expect(failure({ modules: ['Not A Package'] }).message).toContain('modules[0]');
+        expect(failure({ modules: ['!'] }).message).toContain('modules[0]');
+        expect(failure({ modules: [{ source: '@x/a', runtime: 'no' }] }).message).toContain('modules[0].runtime');
+        expect(failure({ modules: [{ source: '@x/a', enabled: false }] }).hint).toContain('Known fields');
+        expect(failure({ modules: [{ source: '@x/a' }] }).hint).toContain("'!@x/a'");
+    });
+    it('checks hooks against the known events', () => {
+        const error = failure({ hooks: { 'build:befor': 'x' } }, "export default {\n  hooks: {\n    'build:befor': 'x',\n  },\n};");
+        expect(error.hint).toBe("Did you mean 'build:before'?");
+        expect(error.line).toBe(3);
+        expect(failure({ hooks: { 'output:done': 42 } }).message).toBe(`hooks['output:done'] must be a shell command, got 42.`);
+        expect(failure({ hooks: { 'output:done': ' ' } }).message).toContain('shell command');
+    });
+    it('accepts only shell commands, and only on events a command can take part in', () => {
+        expect(failure({ hooks: { 'build:before': () => { } } }).hint).toContain('local module');
+        const mutate = failure({ hooks: { 'build:done': 'echo x' } });
+        expect(mutate.message).toContain('change the event object');
+        expect(mutate.hint).toContain("cell.on('build:done'");
+    });
+});
+//# sourceMappingURL=config-validator.spec.js.map

package/lib/config/config-validator.spec.js.map

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

package/lib/config/define-config.d.ts

@@ -0,0 +1,4 @@
+import type { CellConfig } from './types.js';
+/** Types the default export of cell.config.ts; returns it unchanged. */
+export declare function defineConfig(config: CellConfig): CellConfig;
+//# sourceMappingURL=define-config.d.ts.map

package/lib/config/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE3D"}

package/lib/config/define-config.js

@@ -0,0 +1,5 @@
+/** Types the default export of cell.config.ts; returns it unchanged. */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define-config.js.map

package/lib/config/define-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.js","sourceRoot":"","sources":["../../src/config/define-config.ts"],"names":[],"mappings":"AAEA,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC3C,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/lib/config/types.d.ts

@@ -0,0 +1,53 @@
+import type { CellModuleOptions, HookableEventName, Target } from '@celljs/kit';
+import type { UserConfig } from 'vite';
+/** Targets of `cell build --compile`: the runtime that produces the executable. */
+export type CompileTarget = 'bun' | 'node' | 'deno';
+export interface BuildOptions {
+    /** Server bundle format. Default: the preset's format, else `esm`. Node executables need `cjs`. */
+    format?: 'esm' | 'cjs';
+    /** Embed the frontend into the server bundle: one file runs the whole application. */
+    single?: boolean;
+    /** Produce one executable file; `true` means `bun`. */
+    compile?: boolean | CompileTarget;
+    /** Packages the server bundle must not inline; they are copied next to it. */
+    external?: string[];
+    sourcemap?: boolean;
+    /** Output directory, relative to the project root. Default `.cell/output`. */
+    outDir?: string;
+}
+/** Narrows what a component contributes: `runtime: false` drops its DI modules, `toolchain: false` its toolchain module. */
+export interface ModuleFilter {
+    source: string;
+    runtime?: boolean;
+    toolchain?: boolean;
+}
+/**
+ * One entry of `modules`:
+ * - `'./modules/audit'` — a toolchain module of the project (a file, or a directory with a package.json);
+ * - `'@scope/name'` — the toolchain module of a package that is not a runtime dependency;
+ * - `'!@scope/name'` — leave a component out entirely;
+ * - `{ source, runtime?, toolchain? }` — keep a component but drop part of it.
+ */
+export type ModuleEntry = string | ModuleFilter;
+/**
+ * cell.config.ts: configuration of the toolchain only. Application configuration (what `@Value`
+ * reads) belongs in cell.yml (docs/design/agent-first.md R1). Every other top-level field is the
+ * options object of a toolchain module, typed through {@link CellModuleOptions}.
+ */
+export interface CellConfig extends CellModuleOptions {
+    /** Shape of the output, e.g. `node`, `fc`. Overridden by `--preset`; falls back to `CELL_PRESET`, CI detection, `node`. */
+    preset?: string;
+    /** Targets to build, replacing the default: `backend` plus the components' `targets` (e.g. `@celljs/widget` adds `frontend`). */
+    targets?: Target[];
+    modules?: ModuleEntry[];
+    build?: BuildOptions;
+    /** Merged into the Vite configuration of every environment. */
+    vite?: UserConfig;
+    /**
+     * Shell commands run on toolchain events, e.g. `{ 'build:before': 'prisma generate' }`. Only notification
+     * and gate events; a failing command cancels a gate event and fails the command otherwise. Anything that
+     * needs code belongs in a local module.
+     */
+    hooks?: Partial<Record<HookableEventName, string>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,YAAY;IACzB,mGAAmG;IACnG,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4HAA4H;AAC5H,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,iBAAiB;IACjD,2HAA2H;IAC3H,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iIAAiI;IACjI,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD"}

package/lib/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":""}