@celljs/cli 3.8.0 → 4.0.0

package/lib/events/event-bus.spec.js

@@ -0,0 +1,69 @@
+import { describe, expect, it } from 'bun:test';
+import { CellError } from '@celljs/kit';
+import { EventBus } from './event-bus.js';
+describe('EventBus', () => {
+    it('runs handlers in registration order and lets later ones see changes to the event', async () => {
+        const bus = new EventBus();
+        bus.on('build:done', e => e.files.push('a'), 'one');
+        bus.on('build:done', async (e) => e.files.push(`b after ${e.files.join()}`), 'two');
+        expect((await bus.emit('build:done', { files: [] })).files).toEqual(['a', 'b after a']);
+    });
+    it('dispatches on a snapshot and supports unsubscribing', async () => {
+        const bus = new EventBus();
+        const calls = [];
+        const off = bus.on('close', () => {
+            calls.push('first');
+            bus.on('close', () => calls.push('added during dispatch'));
+        });
+        await bus.emit('close', { reason: 'exit' });
+        off();
+        await bus.emit('close', { reason: 'exit' });
+        expect(calls).toEqual(['first', 'added during dispatch']);
+    });
+    it('stops a gate at the first cancel, and treats a throwing gate handler as a cancel', async () => {
+        const bus = new EventBus();
+        const calls = [];
+        bus.on('build:before', () => calls.push('open'), 'a');
+        bus.on('build:before', () => ({ cancel: true, reason: 'not today' }), 'b');
+        bus.on('build:before', () => calls.push('never'), 'c');
+        expect(await bus.gate('build:before', {})).toEqual({ cancel: true, reason: 'not today' });
+        expect(calls).toEqual(['open']);
+        const failing = new EventBus();
+        failing.on('deploy:before', () => {
+            throw new Error('no credentials');
+        }, 'deployer');
+        expect(await failing.gate('deploy:before', {})).toEqual({ cancel: true, reason: 'deployer failed on deploy:before: no credentials' });
+        expect(await new EventBus().gate('build:before', {})).toBeUndefined();
+    });
+    it('fails a notification with the source of the handler; Cell errors keep their code', async () => {
+        const bus = new EventBus();
+        bus.on('output:done', () => {
+            throw new Error('disk full');
+        }, '@x/report');
+        const error = await bus.emit('output:done', {}).catch(e => e);
+        expect(error).toMatchObject({ code: 'CELL_MODULE_ERROR', message: '@x/report failed on output:done: disk full' });
+        const own = new CellError({ code: 'CELL_X', message: 'x' });
+        expect(EventBus.handlerError('close', 'm', own)).toBe(own);
+    });
+    it('refuses to dispatch an event with the wrong rule', async () => {
+        await expect(new EventBus().emit('build:before', {})).rejects.toThrow('gate');
+        await expect(new EventBus().gate('close', {})).rejects.toThrow('not a gate');
+    });
+    it('reports failing notification handlers and goes on when told to (cell dev), but not for other rules', async () => {
+        const reported = [];
+        const bus = new EventBus(error => reported.push(error.message));
+        const calls = [];
+        bus.on('dev:reload', () => {
+            throw new Error('boom');
+        }, 'flaky');
+        bus.on('dev:reload', () => calls.push('next'), 'steady');
+        await bus.emit('dev:reload', { files: [] });
+        expect(calls).toEqual(['next']);
+        expect(reported).toEqual(['flaky failed on dev:reload: boom']);
+        bus.on('build:done', () => {
+            throw new Error('broken');
+        }, 'mutator');
+        expect(bus.emit('build:done', { files: {} })).rejects.toThrow('mutator failed on build:done: broken');
+    });
+});
+//# sourceMappingURL=event-bus.spec.js.map

package/lib/events/event-bus.spec.js.map

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

package/lib/events/hook-runner.d.ts

@@ -0,0 +1,27 @@
+import { type HookableEventName } from '@celljs/kit';
+import type { EventBus } from './event-bus.js';
+export interface HookRunnerOptions {
+    root: string;
+    preset: string;
+    mode: string[];
+    /** Absolute output directory, passed to commands as `CELL_OUT_DIR`. */
+    outDir: string;
+    /** Send command output to stderr, keeping stdout for the JSON result. */
+    quiet?: boolean;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Runs the shell commands of cell.config.ts `hooks` on their events: in the project root, without
+ * standard input, with `CELL_EVENT`, `CELL_PRESET`, `CELL_MODE` and `CELL_OUT_DIR` set. A failing command cancels a
+ * gate event and fails a notification event.
+ */
+export declare class HookRunner {
+    protected readonly options: HookRunnerOptions;
+    constructor(options: HookRunnerOptions);
+    register(bus: EventBus, hooks: Partial<Record<HookableEventName, string>>): void;
+    protected handle(event: HookableEventName, command: string): Promise<unknown>;
+    /** Like package.json scripts: `node_modules/.bin` of the project and its ancestors come first on PATH. */
+    static withLocalBins(env: NodeJS.ProcessEnv, root: string): NodeJS.ProcessEnv;
+    exec(event: HookableEventName, command: string): Promise<number>;
+}
+//# sourceMappingURL=hook-runner.d.ts.map

package/lib/events/hook-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-runner.d.ts","sourceRoot":"","sources":["../../src/events/hook-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACP,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IAAzD,YAA+B,OAAO,EAAE,iBAAiB,EAAI;IAE7D,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAI/E;IAED,UAAgB,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalF;IAED,0GAA0G;IAC1G,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAU5E;IAED,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB/D;CACJ"}

package/lib/events/hook-runner.js

@@ -0,0 +1,65 @@
+import { spawn } from 'node:child_process';
+import { delimiter, dirname, join } from 'node:path';
+import { CellError, EVENT_RULES } from '@celljs/kit';
+/**
+ * Runs the shell commands of cell.config.ts `hooks` on their events: in the project root, without
+ * standard input, with `CELL_EVENT`, `CELL_PRESET`, `CELL_MODE` and `CELL_OUT_DIR` set. A failing command cancels a
+ * gate event and fails a notification event.
+ */
+export class HookRunner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    register(bus, hooks) {
+        for (const [event, command] of Object.entries(hooks)) {
+            bus.on(event, () => this.handle(event, command), 'hooks');
+        }
+    }
+    async handle(event, command) {
+        const code = await this.exec(event, command);
+        if (code === 0) {
+            return undefined;
+        }
+        if (EVENT_RULES[event] === 'gate') {
+            return { cancel: true, reason: `hooks['${event}'] (${command}) exited with code ${code}` };
+        }
+        throw new CellError({
+            code: 'CELL_HOOK_FAILED',
+            message: `hooks['${event}'] (${command}) exited with code ${code}.`,
+            hint: 'Fix the command, or run it by hand in the project root to see the failure.',
+        });
+    }
+    /** Like package.json scripts: `node_modules/.bin` of the project and its ancestors come first on PATH. */
+    static withLocalBins(env, root) {
+        const key = Object.keys(env).find(k => k.toUpperCase() === 'PATH') ?? 'PATH';
+        const bins = [];
+        for (let dir = root;; dir = dirname(dir)) {
+            bins.push(join(dir, 'node_modules', '.bin'));
+            if (dirname(dir) === dir) {
+                break;
+            }
+        }
+        return { ...env, [key]: [...bins, env[key]].filter(Boolean).join(delimiter) };
+    }
+    exec(event, command) {
+        const { root, preset, mode, outDir, quiet, env } = this.options;
+        return new Promise((resolve, reject) => {
+            const child = spawn(command, {
+                shell: true,
+                cwd: root,
+                env: {
+                    ...HookRunner.withLocalBins(env ?? process.env, root),
+                    CELL_EVENT: event,
+                    CELL_PRESET: preset,
+                    CELL_MODE: mode.join(','),
+                    CELL_OUT_DIR: outDir,
+                },
+                stdio: ['ignore', quiet ? 2 : 'inherit', 'inherit'],
+            });
+            child.on('error', reject);
+            child.on('close', (code, signal) => resolve(code ?? (signal ? 128 : 1)));
+        });
+    }
+}
+//# sourceMappingURL=hook-runner.js.map

package/lib/events/hook-runner.js.map

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

package/lib/events/hook-runner.spec.d.ts

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

package/lib/events/hook-runner.spec.d.ts.map

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

package/lib/events/hook-runner.spec.js

@@ -0,0 +1,36 @@
+import { afterEach, describe, expect, it } from 'bun:test';
+import { readFileSync } from 'node:fs';
+import { FixtureProject } from '../test/fixture-project.js';
+import { EventBus } from './event-bus.js';
+import { HookRunner } from './hook-runner.js';
+describe('HookRunner', () => {
+    let fixture;
+    afterEach(() => fixture?.dispose());
+    function bus(hooks) {
+        fixture = new FixtureProject('hooks').file('package.json', { name: 'app' });
+        const events = new EventBus();
+        new HookRunner({ root: fixture.root, preset: 'node', mode: ['production', 'test'], outDir: fixture.path('.cell/output'), quiet: true }).register(events, hooks);
+        return events;
+    }
+    it('runs the command in the project root with the event context in the environment', async () => {
+        const events = bus({ 'output:done': 'echo "$CELL_EVENT $CELL_PRESET $CELL_MODE $(basename $PWD) $CELL_OUT_DIR" > hook.txt' });
+        await events.emit('output:done', {});
+        expect(readFileSync(fixture.path('hook.txt'), 'utf8').trim()).toBe(`output:done node production,test ${fixture.root.split('/').pop()} ${fixture.path('.cell/output')}`);
+    });
+    it('puts node_modules/.bin of the project and its ancestors first on PATH', () => {
+        const env = HookRunner.withLocalBins({ PATH: '/usr/bin' }, '/work/repo/app');
+        expect(env.PATH).toBe(['/work/repo/app/node_modules/.bin', '/work/repo/node_modules/.bin', '/work/node_modules/.bin', '/node_modules/.bin', '/usr/bin'].join(':'));
+    });
+    it('cancels a gate event when the command fails', async () => {
+        const events = bus({ 'build:before': 'exit 3' });
+        expect(await events.gate('build:before', {})).toEqual({ cancel: true, reason: "hooks['build:before'] (exit 3) exited with code 3" });
+        expect(await bus({ 'build:before': 'true' }).gate('build:before', {})).toBeUndefined();
+    });
+    it('fails a notification event when the command fails', async () => {
+        const error = await bus({ close: 'exit 1' })
+            .emit('close', { reason: 'exit' })
+            .catch(e => e);
+        expect(error).toMatchObject({ code: 'CELL_HOOK_FAILED' });
+    });
+});
+//# sourceMappingURL=hook-runner.spec.js.map

package/lib/events/hook-runner.spec.js.map

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

package/lib/index.d.ts

@@ -1,2 +1,58 @@
-export {};
+export * from './agent/agent-guide.js';
+export * from './build/executable-compiler.js';
+export * from './check/project-checker.js';
+export * from './cli/agent-command.js';
+export * from './cli/build-command.js';
+export * from './cli/cell-cli.js';
+export * from './cli/check-command.js';
+export * from './cli/command.js';
+export * from './cli/config-command.js';
+export * from './cli/deploy-command.js';
+export * from './cli/dev-command.js';
+export * from './cli/docs-command.js';
+export * from './cli/info-command.js';
+export * from './cli/init-command.js';
+export * from './cli/mcp-command.js';
+export * from './cli/preview-command.js';
+export * from './cli/reporter.js';
+export * from './config/config-explainer.js';
+export * from './config/config-file-loader.js';
+export * from './config/config-resolver.js';
+export * from './config/config-validator.js';
+export * from './config/define-config.js';
+export * from './config/types.js';
+export * from './deploy/cloud-api.js';
+export * from './deploy/code-package.js';
+export * from './deploy/deployer-registry.js';
+export * from './deploy/request-signer.js';
+export * from './deploy/zip-writer.js';
+export * from './docs/docs-index.js';
+export * from './events/event-bus.js';
+export * from './events/hook-runner.js';
+export * from './info/project-inspector.js';
+export * from './init/project-initializer.js';
+export * from './mcp/dev-activity.js';
+export * from './mcp/dev-mcp-endpoint.js';
+export * from './mcp/mcp-server.js';
+export * from './mcp/project-mcp-tools.js';
+export * from './preset/builtin-presets.js';
+export * from './preset/cloudflare/cloudflare-deployer.js';
+export * from './preset/cloudflare/cloudflare-preset.js';
+export * from './preset/cloudflare/wrangler.js';
+export * from './preset/cloudflare/wrangler-config.js';
+export * from './preset/fc/fc-deployer.js';
+export * from './preset/fc/fc-preset.js';
+export * from './preset/lambda/lambda-deployer.js';
+export * from './preset/lambda/lambda-preset.js';
+export * from './preset/preset-output.js';
+export * from './preset/preset-registry.js';
+export * from './preset/scf/scf-deployer.js';
+export * from './preset/scf/scf-preset.js';
+export * from './preset/serverless-scripts.js';
+export * from './preset/vercel/vercel-deployer.js';
+export * from './preset/vercel/vercel-preset.js';
+export * from './testing/create-test-app.js';
+export * from './toolchain/toolchain.js';
+export * from './utils/json-util.js';
+export * from './utils/text-util.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/lib/index.js

@@ -1,3 +1,58 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export * from './agent/agent-guide.js';
+export * from './build/executable-compiler.js';
+export * from './check/project-checker.js';
+export * from './cli/agent-command.js';
+export * from './cli/build-command.js';
+export * from './cli/cell-cli.js';
+export * from './cli/check-command.js';
+export * from './cli/command.js';
+export * from './cli/config-command.js';
+export * from './cli/deploy-command.js';
+export * from './cli/dev-command.js';
+export * from './cli/docs-command.js';
+export * from './cli/info-command.js';
+export * from './cli/init-command.js';
+export * from './cli/mcp-command.js';
+export * from './cli/preview-command.js';
+export * from './cli/reporter.js';
+export * from './config/config-explainer.js';
+export * from './config/config-file-loader.js';
+export * from './config/config-resolver.js';
+export * from './config/config-validator.js';
+export * from './config/define-config.js';
+export * from './config/types.js';
+export * from './deploy/cloud-api.js';
+export * from './deploy/code-package.js';
+export * from './deploy/deployer-registry.js';
+export * from './deploy/request-signer.js';
+export * from './deploy/zip-writer.js';
+export * from './docs/docs-index.js';
+export * from './events/event-bus.js';
+export * from './events/hook-runner.js';
+export * from './info/project-inspector.js';
+export * from './init/project-initializer.js';
+export * from './mcp/dev-activity.js';
+export * from './mcp/dev-mcp-endpoint.js';
+export * from './mcp/mcp-server.js';
+export * from './mcp/project-mcp-tools.js';
+export * from './preset/builtin-presets.js';
+export * from './preset/cloudflare/cloudflare-deployer.js';
+export * from './preset/cloudflare/cloudflare-preset.js';
+export * from './preset/cloudflare/wrangler.js';
+export * from './preset/cloudflare/wrangler-config.js';
+export * from './preset/fc/fc-deployer.js';
+export * from './preset/fc/fc-preset.js';
+export * from './preset/lambda/lambda-deployer.js';
+export * from './preset/lambda/lambda-preset.js';
+export * from './preset/preset-output.js';
+export * from './preset/preset-registry.js';
+export * from './preset/scf/scf-deployer.js';
+export * from './preset/scf/scf-preset.js';
+export * from './preset/serverless-scripts.js';
+export * from './preset/vercel/vercel-deployer.js';
+export * from './preset/vercel/vercel-preset.js';
+export * from './testing/create-test-app.js';
+export * from './toolchain/toolchain.js';
+export * from './utils/json-util.js';
+export * from './utils/text-util.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/lib/info/project-inspector.d.ts

@@ -0,0 +1,143 @@
+import type { CheckIssue, ComponentInfo, EnvOverrideReport, Preset, ProjectModel, ServerRuntime, Target, TargetModel } from '@celljs/kit';
+import { type ProjectLoaderOptions } from '@celljs/vite';
+import { type ModuleSpec, type ResolvedConfig, type ValueSource } from '../config/config-resolver.js';
+import type { CompileTarget } from '../config/types.js';
+import type { ModuleRegistrations } from '../modules/module-host.js';
+/** A component as `cell info` reports it. Paths are relative to the project root; empty declarations are left out. */
+export interface ComponentSummary {
+    name: string;
+    version: string;
+    dir: string;
+    /** Present (and `true`) for the project itself. */
+    root?: true;
+    configFiles: string[];
+    targets?: Target[];
+    entries?: Record<string, string>;
+    toolchain?: string;
+    optionalDependencies?: string[];
+}
+export interface TargetSummary {
+    entry: string;
+    /** Component whose `entries` provided the entry. */
+    entryComponent?: string;
+    /** DI modules in load order; files of the project are relative to its root. */
+    staticModules: string[];
+    modules: string[];
+    /** Merged application configuration, only with `--app-config`. Backend values keep `${...}`. */
+    config?: Record<string, unknown>;
+    /**
+     * `CELL_FRONTEND__*` / `CELL_BACKEND__*` variables of the current environment and the keys they set;
+     * present when there are any. Frontend ones are applied by `cell build`, backend ones by the server
+     * at startup. Values are left out.
+     */
+    envOverrides?: EnvOverrideReport;
+}
+export interface OutputSummary {
+    /** Output directory, relative to the project root. */
+    dir: string;
+    built: boolean;
+    preset?: string;
+    format?: 'esm' | 'cjs';
+    targets?: Target[];
+    server?: string;
+    public?: string;
+}
+/** The result of `cell info` (docs/design/architecture.md §8): what the next `cell build` with the same flags would use. */
+export interface ProjectInfo {
+    root: string;
+    name: string;
+    version: string;
+    cellVersion: string;
+    /** cell.config file, relative to the root. */
+    configFile?: string;
+    preset: {
+        name: string;
+        source: ValueSource;
+        description?: string;
+        entry?: string;
+        format?: 'esm' | 'cjs';
+        runtime?: ServerRuntime;
+        /** Deployer of `cell deploy`; none means the output is run by hand. */
+        deployer?: string;
+        available: string[];
+    };
+    mode: string[];
+    targets: Target[];
+    /** Why each target is built: `cell.config.ts`, `default` (the backend) or the components that declare it. */
+    targetSources: Partial<Record<Target, string[]>>;
+    build: {
+        format: 'esm' | 'cjs';
+        outDir: string;
+        external: string[];
+        sourcemap: boolean;
+        single: boolean;
+        compile: false | CompileTarget;
+    };
+    components: ComponentSummary[];
+    frontend?: TargetSummary;
+    backend?: TargetSummary;
+    /** Project hooks by event. `cell info` lists them and never runs them. */
+    hooks: Record<string, string>;
+    /** The `modules` entries of cell.config.ts. */
+    modules: ModuleSpec[];
+    /** Keys of toolchain module options in cell.config.ts. */
+    moduleOptions: string[];
+    /** Toolchain modules in load order and what each registered (docs/design/modules.md §3.5); `file` is relative to the root. */
+    toolchainModules: ModuleRegistrations[];
+    output: OutputSummary;
+}
+export interface InspectOptions {
+    /** Include the merged application configuration of each target. */
+    appConfig?: boolean;
+    cellVersion?: string;
+    /** Environment for frontend expressions and `CELL_*__` overrides. Default: `process.env`. */
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Describes a project from its resolved toolchain configuration and the project model. Reads
+ * package.json, cell*.yml and manifest.json only: no project code runs and nothing is built, so it
+ * returns quickly and is safe to call from agents and editors (docs/design/agent-first.md R2).
+ */
+export declare class ProjectInspector {
+    protected readonly config: ResolvedConfig;
+    protected readonly preset: Preset;
+    protected readonly presets: string[];
+    /** What toolchain modules contributed: project options (DI modules, entries) and their registrations. */
+    protected readonly contributions: {
+        projectOptions?: ProjectLoaderOptions;
+        modules?: ModuleRegistrations[];
+    };
+    static readonly COMMAND_MODES: string[];
+    static readonly MODE_FILE: RegExp;
+    /** What `cell info` warns about, with stable codes for `cell check`. */
+    readonly issues: CheckIssue[];
+    get warnings(): string[];
+    protected warn(code: string, message: string, file?: string): void;
+    constructor(config: ResolvedConfig, preset: Preset, presets: string[], 
+    /** What toolchain modules contributed: project options (DI modules, entries) and their registrations. */
+    contributions?: {
+        projectOptions?: ProjectLoaderOptions;
+        modules?: ModuleRegistrations[];
+    });
+    inspect(options?: InspectOptions): ProjectInfo;
+    /** The human form of {@link ProjectInfo}: a short summary; `--json` has the details. */
+    static format(info: ProjectInfo): string;
+    static missingEntryWarning(preset: Preset): string;
+    static envProblemWarning(target: Target, problem: {
+        variable: string;
+        message: string;
+    }): string;
+    /** `@x/ui (2 vite plugins, 1 check)`: what a module registered, counted. */
+    static formatToolchainModule(module: ModuleRegistrations): string;
+    static formatModule(spec: ModuleSpec): string;
+    protected targetSources(model: ProjectModel): Partial<Record<Target, string[]>>;
+    protected component(component: ComponentInfo): ComponentSummary;
+    protected target(model: TargetModel, appConfig: boolean): TargetSummary;
+    protected output(): OutputSummary;
+    /** Settings that `cell build` would accept but that change nothing or fail: say so before the build does. */
+    protected check(model: ProjectModel): void;
+    /** Modes with a `cell.<mode>.yml` in the project or any of its components, active or not. */
+    protected availableModes(model: ProjectModel): string[];
+    protected relative(path: string): string;
+}
+//# sourceMappingURL=project-inspector.d.ts.map

package/lib/info/project-inspector.d.ts.map

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