@celljs/cli 3.9.0 → 4.0.0

package/lib/toolchain/toolchain.js

@@ -0,0 +1,100 @@
+import { resolve } from 'node:path';
+import { ComponentCollector } from '@celljs/vite';
+import { ConfigResolver } from '../config/config-resolver.js';
+import { EventBus } from '../events/event-bus.js';
+import { HookRunner } from '../events/hook-runner.js';
+import { ModuleHost } from '../modules/module-host.js';
+import { BUILTIN_PRESETS } from '../preset/builtin-presets.js';
+import { PresetRegistry } from '../preset/preset-registry.js';
+/**
+ * The toolchain of one command run: resolved configuration, toolchain modules, the preset and the
+ * event bus with the project's hooks. Startup order follows docs/design/modules.md §3.3: read
+ * cell.config.ts → find components → run module factories → resolve the preset → modules:done →
+ * config:resolved.
+ */
+export class Toolchain {
+    config;
+    preset;
+    events;
+    presets;
+    modules;
+    constructor(config, preset, events, presets, modules) {
+        this.config = config;
+        this.preset = preset;
+        this.events = events;
+        this.presets = presets;
+        this.modules = modules;
+    }
+    static async create(options) {
+        const presets = new PresetRegistry();
+        for (const preset of BUILTIN_PRESETS) {
+            presets.register(preset);
+        }
+        const config = await new ConfigResolver({ ...options, detectors: presets.detectors }).resolve();
+        const events = new EventBus(options.onNotifyError);
+        const disabled = new Set(config.modules.flatMap(spec => (spec.kind === 'disabled' ? [spec.name] : [])));
+        const components = new ComponentCollector(config.root, disabled).collect();
+        const logger = options.logger ?? { info: (m) => process.stderr.write(`${m}\n`), warn: (m) => process.stderr.write(`warning: ${m}\n`) };
+        const modules = new ModuleHost({
+            config,
+            events,
+            presets,
+            logger,
+            components: components.map(({ name, version, dir, root }) => ({ name, version, dir, root })),
+        });
+        await modules.load(ModuleHost.sources(config, components));
+        Toolchain.detectModulePreset(config, presets, options.env ?? process.env);
+        const preset = presets.resolve(config.preset.name, config.preset.source === 'config' ? config.file : undefined);
+        // The options of every preset are accepted, so switching presets does not break cell.config.ts.
+        for (const { name, options: schema } of presets.all) {
+            if (schema) {
+                modules.claimOption(name, `the ${name} preset`, schema);
+            }
+        }
+        if (preset.outDir && config.build.outDir === ConfigResolver.DEFAULT_OUT_DIR) {
+            config.build.outDir = preset.outDir;
+        }
+        await modules.checkOptions();
+        if (options.runHooks ?? true) {
+            const outDir = resolve(config.root, config.build.outDir);
+            new HookRunner({ root: config.root, preset: preset.name, mode: config.mode, outDir, quiet: options.quiet, env: options.env }).register(events, config.hooks);
+        }
+        const toolchain = new Toolchain(config, preset, events, presets, modules);
+        await events.emit('modules:done', { modules: modules.loaded.map(m => m.name) });
+        await events.emit('config:resolved', { config, preset });
+        return toolchain;
+    }
+    /** Presets added by modules take part in CI detection like the built-in ones. */
+    static detectModulePreset(config, presets, env) {
+        if (config.preset.source !== 'default' || !config.ci) {
+            return;
+        }
+        const detected = presets.detectors.find(detector => detector.detect(env));
+        if (detected) {
+            config.preset = { name: detected.name, source: 'ci' };
+        }
+    }
+    /** What decides the component graph, with what modules added (DI modules, entries). */
+    projectOptions() {
+        return { ...ConfigResolver.toProjectOptions(this.config, this.preset), ...this.moduleProjectOptions() };
+    }
+    /** Options of the build: the configuration, the preset and the modules' plugins. */
+    builderOptions() {
+        return { ...ConfigResolver.toBuilderOptions(this.config, this.preset), ...this.moduleProjectOptions(), plugins: this.modules.vitePlugins() };
+    }
+    moduleProjectOptions() {
+        const entry = this.modules.entries;
+        return {
+            ...(this.modules.extraModules.length > 0 ? { extraModules: this.modules.extraModules } : {}),
+            ...(Object.keys(entry).length > 0 ? { entry } : {}),
+        };
+    }
+    /** The options of a preset: its field of cell.config.ts, `{}` when absent. */
+    presetOptions(name = this.preset.name) {
+        return this.config.options[name] ?? {};
+    }
+    async close(reason = 'exit') {
+        await this.events.emit('close', { reason });
+    }
+}
+//# sourceMappingURL=toolchain.js.map

package/lib/toolchain/toolchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain.js","sourceRoot":"","sources":["../../src/toolchain/toolchain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAA2B,kBAAkB,EAA6B,MAAM,cAAc,CAAC;AACtG,OAAO,EAAsC,cAAc,EAAuB,MAAM,8BAA8B,CAAC;AACvH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAiB9D;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IAEL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IALpB,YACa,MAAsB,EACtB,MAAc,EACd,MAAgB,EAChB,OAAuB,EACvB,OAAmB;sBAJnB,MAAM;sBACN,MAAM;sBACN,MAAM;uBACN,OAAO;uBACP,OAAO;IACjB,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAyB;QACzC,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAChG,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxG,MAAM,UAAU,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACvJ,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;YAC3B,MAAM;YACN,MAAM;YACN,OAAO;YACP,MAAM;YACN,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;SAC/F,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3D,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChH,gGAAgG;QAChG,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAClD,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,cAAc,CAAC,eAAe,EAAE,CAAC;YAC1E,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACxC,CAAC;QACD,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAClI,MAAM,EACN,MAAM,CAAC,KAAK,CACf,CAAC;QACN,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,iFAAiF;IACvE,MAAM,CAAC,kBAAkB,CAAC,MAAsB,EAAE,OAAuB,EAAE,GAAsB;QACvG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACnD,OAAO;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1E,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC;IACL,CAAC;IAED,uFAAuF;IACvF,cAAc;QACV,OAAO,EAAE,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;IAC5G,CAAC;IAED,oFAAoF;IACpF,cAAc;QACV,OAAO,EAAE,GAAG,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;IACjJ,CAAC;IAES,oBAAoB;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACnC,OAAO;YACH,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;IACN,CAAC;IAED,8EAA8E;IAC9E,aAAa,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAM,GAAuB,MAAM;QAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/lib/utils/json-util.d.ts

@@ -0,0 +1,11 @@
+export declare namespace JsonUtil {
+    /**
+     * Parses JSON with comments and trailing commas (JSONC, as in wrangler.jsonc and tsconfig.json).
+     * Comments become spaces, so positions in error messages still match the text.
+     */
+    function parseJsonc(text: string): unknown;
+    function withoutComments(text: string): string;
+    /** Drops a comma that is followed only by whitespace and a closing bracket. */
+    function withoutTrailingCommas(text: string): string;
+}
+//# sourceMappingURL=json-util.d.ts.map

package/lib/utils/json-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-util.d.ts","sourceRoot":"","sources":["../../src/utils/json-util.ts"],"names":[],"mappings":"AAAA,yBAAiB,QAAQ,CAAC;IACtB;;;OAGG;IACH,SAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;IAED,SAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBpD;IAED,+EAA+E;IAC/E,SAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmB1D;CAUJ"}

package/lib/utils/json-util.js

@@ -0,0 +1,73 @@
+export var JsonUtil;
+(function (JsonUtil) {
+    /**
+     * Parses JSON with comments and trailing commas (JSONC, as in wrangler.jsonc and tsconfig.json).
+     * Comments become spaces, so positions in error messages still match the text.
+     */
+    function parseJsonc(text) {
+        return JSON.parse(withoutTrailingCommas(withoutComments(text)));
+    }
+    JsonUtil.parseJsonc = parseJsonc;
+    function withoutComments(text) {
+        let result = '';
+        let i = 0;
+        while (i < text.length) {
+            const char = text[i];
+            if (char === '"') {
+                const end = stringEnd(text, i);
+                result += text.slice(i, end);
+                i = end;
+            }
+            else if (char === '/' && text[i + 1] === '/') {
+                const end = text.indexOf('\n', i);
+                const stop = end === -1 ? text.length : end;
+                result += ' '.repeat(stop - i);
+                i = stop;
+            }
+            else if (char === '/' && text[i + 1] === '*') {
+                const end = text.indexOf('*/', i + 2);
+                const stop = end === -1 ? text.length : end + 2;
+                result += text.slice(i, stop).replace(/[^\n]/g, ' ');
+                i = stop;
+            }
+            else {
+                result += char;
+                i++;
+            }
+        }
+        return result;
+    }
+    JsonUtil.withoutComments = withoutComments;
+    /** Drops a comma that is followed only by whitespace and a closing bracket. */
+    function withoutTrailingCommas(text) {
+        let result = '';
+        let i = 0;
+        while (i < text.length) {
+            const char = text[i];
+            if (char === '"') {
+                const end = stringEnd(text, i);
+                result += text.slice(i, end);
+                i = end;
+                continue;
+            }
+            if (char === ',' && /^\s*[}\]]/.test(text.slice(i + 1))) {
+                result += ' ';
+            }
+            else {
+                result += char;
+            }
+            i++;
+        }
+        return result;
+    }
+    JsonUtil.withoutTrailingCommas = withoutTrailingCommas;
+    /** Index just after the string literal that starts at `start` (or the end of the text). */
+    function stringEnd(text, start) {
+        let i = start + 1;
+        while (i < text.length && text[i] !== '"') {
+            i += text[i] === '\\' ? 2 : 1;
+        }
+        return Math.min(i + 1, text.length);
+    }
+})(JsonUtil || (JsonUtil = {}));
+//# sourceMappingURL=json-util.js.map

package/lib/utils/json-util.js.map

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

package/lib/utils/json-util.spec.d.ts

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

package/lib/utils/json-util.spec.d.ts.map

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

package/lib/utils/json-util.spec.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'bun:test';
+import { JsonUtil } from './json-util.js';
+describe('JsonUtil.parseJsonc', () => {
+    it('ignores line and block comments and trailing commas', () => {
+        const text = ['{', '  // the worker', '  "name": "app", /* inline */', '  "flags": ["a", "b",],', '}'].join('\n');
+        expect(JsonUtil.parseJsonc(text)).toEqual({ name: 'app', flags: ['a', 'b'] });
+    });
+    it('keeps comment markers and commas inside strings', () => {
+        const text = '{ "url": "https://example.com/a//b", "glob": "/*", "text": "a, }", "quote": "say \\"hi\\" // not a comment" }';
+        expect(JsonUtil.parseJsonc(text)).toEqual({ url: 'https://example.com/a//b', glob: '/*', text: 'a, }', quote: 'say "hi" // not a comment' });
+    });
+    it('keeps line numbers of errors: comments become spaces', () => {
+        const stripped = JsonUtil.withoutComments('/* a\nb */ {}');
+        expect(stripped.split('\n')).toHaveLength(2);
+        expect(() => JsonUtil.parseJsonc('{ "a": }')).toThrow();
+    });
+});
+//# sourceMappingURL=json-util.spec.js.map

package/lib/utils/json-util.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-util.spec.js","sourceRoot":"","sources":["../../src/utils/json-util.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC3D,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClH,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,+GAA+G,CAAC;QAC7H,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACjJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/utils/text-util.d.ts

@@ -0,0 +1,19 @@
+export interface SourcePosition {
+    line: number;
+    column: number;
+}
+export declare namespace TextUtil {
+    /** Edit distance between two strings (insertions, deletions and substitutions). */
+    function distance(a: string, b: string): number;
+    /** The candidate closest to `word`, if it is a likely typo (at most `max` edits away). */
+    function closest(word: string, candidates: readonly string[], max?: number): string | undefined;
+    /** Line and column of the first occurrence of `text` in `source`. */
+    function find(source: string, text: string): SourcePosition | undefined;
+    function position(source: string, offset: number): SourcePosition;
+    /**
+     * Where the property at `path` is written in an object-literal source file, found by searching each
+     * key after the previous one. Good enough to point a reader at the line; undefined when not found.
+     */
+    function locate(source: string, path: readonly (string | number)[]): SourcePosition | undefined;
+}
+//# sourceMappingURL=text-util.d.ts.map

package/lib/utils/text-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-util.d.ts","sourceRoot":"","sources":["../../src/utils/text-util.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,yBAAiB,QAAQ,CAAC;IACtB,mFAAmF;IACnF,SAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAUrD;IAED,0FAA0F;IAC1F,SAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,SAAI,GAAG,MAAM,GAAG,SAAS,CAWhG;IAED,qEAAqE;IACrE,SAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG7E;IAED,SAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAGvE;IAED;;;OAGG;IACH,SAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,cAAc,GAAG,SAAS,CAkBrG;CACJ"}

package/lib/utils/text-util.js

@@ -0,0 +1,66 @@
+export var TextUtil;
+(function (TextUtil) {
+    /** Edit distance between two strings (insertions, deletions and substitutions). */
+    function distance(a, b) {
+        let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+        for (let i = 1; i <= a.length; i++) {
+            const current = [i];
+            for (let j = 1; j <= b.length; j++) {
+                current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            }
+            previous = current;
+        }
+        return previous[b.length];
+    }
+    TextUtil.distance = distance;
+    /** The candidate closest to `word`, if it is a likely typo (at most `max` edits away). */
+    function closest(word, candidates, max = 2) {
+        let best;
+        let bestDistance = max + 1;
+        for (const candidate of candidates) {
+            const d = distance(word, candidate);
+            if (d < bestDistance) {
+                best = candidate;
+                bestDistance = d;
+            }
+        }
+        return best;
+    }
+    TextUtil.closest = closest;
+    /** Line and column of the first occurrence of `text` in `source`. */
+    function find(source, text) {
+        const offset = source.indexOf(text);
+        return offset < 0 ? undefined : position(source, offset);
+    }
+    TextUtil.find = find;
+    function position(source, offset) {
+        const before = source.slice(0, offset).split('\n');
+        return { line: before.length, column: before[before.length - 1].length + 1 };
+    }
+    TextUtil.position = position;
+    /**
+     * Where the property at `path` is written in an object-literal source file, found by searching each
+     * key after the previous one. Good enough to point a reader at the line; undefined when not found.
+     */
+    function locate(source, path) {
+        let offset = 0;
+        let found = false;
+        for (const key of path) {
+            if (typeof key === 'number') {
+                continue;
+            }
+            const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const pattern = new RegExp(`(^|[\\s{,])(['"\`]?)${escaped}\\2\\s*:`, 'mg');
+            pattern.lastIndex = offset;
+            const match = pattern.exec(source);
+            if (!match) {
+                break;
+            }
+            offset = match.index + match[1].length;
+            found = true;
+        }
+        return found ? position(source, offset) : undefined;
+    }
+    TextUtil.locate = locate;
+})(TextUtil || (TextUtil = {}));
+//# sourceMappingURL=text-util.js.map

package/lib/utils/text-util.js.map

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

package/lib/utils/text-util.spec.d.ts

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

package/lib/utils/text-util.spec.d.ts.map

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

package/lib/utils/text-util.spec.js

@@ -0,0 +1,22 @@
+import { describe, expect, it } from 'bun:test';
+import { TextUtil } from './text-util.js';
+describe('TextUtil', () => {
+    it('measures edit distance', () => {
+        expect(TextUtil.distance('build', 'build')).toBe(0);
+        expect(TextUtil.distance('bulid', 'build')).toBe(2);
+        expect(TextUtil.distance('', 'abc')).toBe(3);
+    });
+    it('suggests the closest candidate within the limit', () => {
+        expect(TextUtil.closest('modlues', ['preset', 'modules', 'build'])).toBe('modules');
+        expect(TextUtil.closest('react', ['preset', 'modules', 'build'])).toBeUndefined();
+        expect(TextUtil.closest('vue', ['vite'], 1)).toBeUndefined();
+    });
+    it('locates a property path in an object literal', () => {
+        const source = ['export default {', '    build: { sourcemap: true },', '    hooks: {', "        'build:done': () => {},", '    },', '};'].join('\n');
+        expect(TextUtil.locate(source, ['hooks', 'build:done'])).toEqual({ line: 4, column: 9 });
+        expect(TextUtil.locate(source, ['build', 'sourcemap'])).toEqual({ line: 2, column: 14 });
+        expect(TextUtil.locate(source, ['modules'])).toBeUndefined();
+        expect(TextUtil.find(source, 'hooks')).toEqual({ line: 3, column: 5 });
+    });
+});
+//# sourceMappingURL=text-util.spec.js.map

package/lib/utils/text-util.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-util.spec.js","sourceRoot":"","sources":["../../src/utils/text-util.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAClF,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,CAAC,kBAAkB,EAAE,iCAAiC,EAAE,cAAc,EAAE,iCAAiC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrJ,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7D,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@celljs/cli",
-  "version": "3.9.0",
-  "description": "Cell CLI.",
+  "version": "4.0.0",
+  "description": "The Cell command-line interface: cell.config.ts, toolchain modules, presets and the `cell` command.",
+  "type": "module",
   "homepage": "https://github.com/cellbang/cell",
   "bugs": {
     "url": "https://github.com/cellbang/cell/issues"
@@ -11,51 +12,48 @@
     "url": "https://github.com/cellbang/cell.git"
   },
   "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "main": "lib/index.js",
-  "typings": "lib/index.d.ts",
+  "types": "lib/index.d.ts",
   "bin": {
-    "cell": "./bin/cell"
+    "cell": "./bin/cell.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "files": [
+    "agent",
     "bin",
     "lib",
+    "templates",
     "src",
-    "templates"
+    "!src/**/*.spec.ts"
   ],
   "scripts": {
     "build": "tsc -b",
     "clean": "rm -rf lib *.tsbuildinfo",
-    "test": "bun test --preload reflect-metadata ./lib",
+    "test": "bun test ./lib",
     "watch": "tsc -b -w --preserveWatchOutput"
   },
-  "eslintIgnore": [
-    "templates"
-  ],
   "dependencies": {
-    "@celljs/cli-common": "3.9.0",
-    "@celljs/cli-runtime": "3.9.0",
-    "@celljs/frameworks": "3.9.0",
-    "chalk": "^4.1.0",
-    "commander": "^11.0.0",
-    "dotenv": "^16.3.1",
-    "fs-extra": "^11.1.1",
-    "js-yaml": "^4.1.0",
-    "leven": "^3.1.0",
-    "minimist": "^1.2.8",
-    "ora": "^5.4.1",
-    "prompts": "2.4.2",
-    "rimraf": "^5.0.1",
-    "semver": "^7.5.3",
-    "traverse": "^0.6.7",
-    "tslib": "^2.8.0",
-    "update-notifier": "^5.0.1",
-    "watchpack": "^2.2.0"
+    "@celljs/kit": "4.0.0",
+    "@celljs/vite": "4.0.0",
+    "vite": "^8.3.6"
   },
   "devDependencies": {
-    "@types/js-yaml": "^3.12.1",
-    "@types/prompts": "^2.4.4"
+    "@celljs/core": "4.0.0",
+    "@celljs/express-adapter": "4.0.0",
+    "@celljs/http": "4.0.0",
+    "@celljs/mvc": "4.0.0",
+    "@celljs/web": "4.0.0"
   },
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/agent/agent-guide.ts

@@ -0,0 +1,90 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+
+/** Where a guide snippet comes from: a component's AGENTS.md or one in a module's docs directory. */
+export interface GuideSnippet {
+    source: string;
+    file: string;
+}
+
+export interface AgentSyncResult {
+    /** Files written, relative to the project root. */
+    files: string[];
+    /** Components and modules whose AGENTS.md went into the guide. */
+    snippets: string[];
+}
+
+/**
+ * The agent guide of a project (docs/design/agent-first.md R7): the Cell guide of the installed
+ * @celljs/cli version, followed by the AGENTS.md snippets of the installed components and toolchain
+ * modules. It is written between markers in AGENTS.md, so the rest of the file stays the project's,
+ * and as the skill `.agents/skills/cell/SKILL.md`.
+ */
+export class AgentGuide {
+    static readonly BEGIN = '<!-- cell:begin (generated by `cell agent sync`; edit outside these markers) -->';
+    static readonly END = '<!-- cell:end -->';
+    static readonly GUIDE = new URL('../../agent/guide.md', import.meta.url);
+    static readonly SKILL = '.agents/skills/cell/SKILL.md';
+
+    constructor(
+        protected readonly root: string,
+        protected readonly version: string,
+    ) {}
+
+    /** AGENTS.md of the components (not the project's own) and of module docs directories. */
+    static snippets(
+        components: readonly { name: string; dir: string; root: boolean }[],
+        moduleDocs: readonly { source: string; value: string }[],
+    ): GuideSnippet[] {
+        return [
+            ...components.filter(c => !c.root).map(c => ({ source: c.name, file: join(c.dir, 'AGENTS.md') })),
+            ...moduleDocs.map(d => ({ source: d.source, file: join(d.value, 'AGENTS.md') })),
+        ].filter(s => existsSync(s.file));
+    }
+
+    content(snippets: GuideSnippet[]): string {
+        const guide = readFileSync(AgentGuide.GUIDE, 'utf8').replaceAll('{{cellVersion}}', this.version).trim();
+        const parts = snippets.map(s => {
+            // Headings of a snippet move one level down, under its package.
+            const body = readFileSync(s.file, 'utf8')
+                .trim()
+                .replace(/^(#{1,5}) /gm, '#$1 ');
+            return `### ${s.source}\n\n${body}`;
+        });
+        return parts.length > 0 ? `${guide}\n\n## Installed components\n\n${parts.join('\n\n')}\n` : `${guide}\n`;
+    }
+
+    sync(snippets: GuideSnippet[]): AgentSyncResult {
+        const content = this.content(snippets);
+        const agents = join(this.root, 'AGENTS.md');
+        const block = `${AgentGuide.BEGIN}\n${content}${AgentGuide.END}`;
+        const current = existsSync(agents) ? readFileSync(agents, 'utf8') : '';
+        const begin = current.indexOf(AgentGuide.BEGIN.slice(0, 16));
+        const end = current.indexOf(AgentGuide.END);
+        const next =
+            begin !== -1 && end > begin
+                ? `${current.slice(0, begin)}${block}${current.slice(end + AgentGuide.END.length)}`
+                : current.trim()
+                  ? `${current.trimEnd()}\n\n${block}\n`
+                  : `${block}\n`;
+        this.write(agents, next);
+        const skill = join(this.root, AgentGuide.SKILL);
+        this.write(
+            skill,
+            [
+                '---',
+                'name: cell',
+                'description: Build, check and debug Cell applications (TypeScript, dependency injection, MVC on Express, the cell CLI) - project layout, decorators, configuration, tests, cell check and cell mcp.',
+                '---',
+                '',
+                content,
+            ].join('\n'),
+        );
+        return { files: [agents, skill].map(file => relative(this.root, file)), snippets: snippets.map(s => s.source) };
+    }
+
+    protected write(file: string, content: string): void {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, content);
+    }
+}