@mudah-cli/mudah 0.1.0

package/dist/animation.d.ts

@@ -0,0 +1 @@
+export * from '@mudah-cli/animation';

package/dist/animation.js

@@ -0,0 +1,2 @@
+export * from '@mudah-cli/animation';
+//# sourceMappingURL=animation.js.map

package/dist/animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.js","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/commands/build.command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `build` command: runs the app's `build` script (bun when the
+ * app is running under Bun, npm otherwise), streaming output.
+ */
+export default class BuildCommand extends Command {
+    signature: string;
+    description: string;
+    handle(): Promise<number | undefined>;
+}

package/dist/commands/build.command.js

@@ -0,0 +1,43 @@
+import { readFile } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+import { Command } from '@mudah-cli/console';
+function runChild(command, args, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { cwd, stdio: 'inherit' });
+        child.on('error', () => resolve(1));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+}
+/**
+ * Built-in `build` command: runs the app's `build` script (bun when the
+ * app is running under Bun, npm otherwise), streaming output.
+ */
+export default class BuildCommand extends Command {
+    signature = 'build';
+    description = 'Build the application (runs the package.json build script)';
+    async handle() {
+        const pkgPath = `${this.app.basePath}/package.json`;
+        let pkg;
+        try {
+            pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+        }
+        catch {
+            throw this.usageError('No package.json found in the app directory.');
+        }
+        const script = pkg.scripts?.['build'];
+        if (!script) {
+            this.output.warn('No "build" script in package.json — nothing to do.');
+            return;
+        }
+        const runner = process.versions.bun ? 'bun' : 'npm';
+        this.output.info(`Running: ${runner} run build`);
+        const code = await runChild(runner, ['run', 'build'], this.app.basePath);
+        if (code === 0) {
+            this.output.success('Build complete.');
+            return 0;
+        }
+        this.output.error(`Build failed with exit code ${code}.`);
+        return code;
+    }
+}
+//# sourceMappingURL=build.command.js.map

package/dist/commands/build.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.command.js","sourceRoot":"","sources":["../../src/commands/build.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,SAAS,QAAQ,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,SAAS,GAAG,OAAO,CAAC;IACpB,WAAW,GAAG,4DAA4D,CAAC;IAE3E,KAAK,CAAC,MAAM;QACV,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,eAAe,CAAC;QACpD,IAAI,GAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,CAAC,UAAU,CAAC,6CAA6C,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,YAAY,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzE,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;YACvC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,IAAI,GAAG,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/commands/dev.command.d.ts

@@ -0,0 +1,12 @@
+import { Command, type ConsoleKernel } from '@mudah-cli/console';
+/**
+ * Built-in `dev` command: run a command, then re-run it whenever
+ * src/, config/, or mudah.json change (150ms debounce). Exits on SIGINT.
+ */
+export default class DevCommand extends Command {
+    signature: string;
+    description: string;
+    private kernel;
+    constructor(kernel: ConsoleKernel);
+    handle(): Promise<void>;
+}

package/dist/commands/dev.command.js

@@ -0,0 +1,45 @@
+import { join } from 'node:path';
+import { Command } from '@mudah-cli/console';
+import { createWatcher } from '../watcher.js';
+/**
+ * Built-in `dev` command: run a command, then re-run it whenever
+ * src/, config/, or mudah.json change (150ms debounce). Exits on SIGINT.
+ */
+export default class DevCommand extends Command {
+    signature = 'dev {command}';
+    description = 'Watch mode: re-run a command when files change';
+    kernel;
+    constructor(kernel) {
+        super();
+        this.kernel = kernel;
+    }
+    async handle() {
+        const target = this.arg('command');
+        if (!this.kernel.has(target)) {
+            throw this.usageError(`Unknown command "${target}".`, 'Run "help" to list all commands.');
+        }
+        const runOnce = async () => {
+            try {
+                await this.kernel.dispatch([target]);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.output.error(message);
+            }
+        };
+        await runOnce();
+        const base = this.app.basePath;
+        const stop = createWatcher([join(base, 'src'), join(base, 'config'), join(base, 'mudah.json')], () => {
+            this.output.muted('change detected — re-running…');
+            void runOnce();
+        });
+        this.output.muted('watching for changes (ctrl+c to stop)');
+        await new Promise((resolve) => {
+            process.once('SIGINT', () => {
+                stop();
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=dev.command.js.map

package/dist/commands/dev.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.command.js","sourceRoot":"","sources":["../../src/commands/dev.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,SAAS,GAAG,eAAe,CAAC;IAC5B,WAAW,GAAG,gDAAgD,CAAC;IAEvD,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;YACxC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,OAAO,EAAE,CAAC;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE;YACnG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC1B,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/commands/doctor.command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `doctor` command: a quick health check of the runtime, manifest,
+ * scaffolding, and terminal capabilities.
+ */
+export default class DoctorCommand extends Command {
+    signature: string;
+    description: string;
+    handle(): Promise<void>;
+}

package/dist/commands/doctor.command.js

@@ -0,0 +1,53 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { Command } from '@mudah-cli/console';
+import { detectCapabilities } from '@mudah-cli/terminal';
+/**
+ * Built-in `doctor` command: a quick health check of the runtime, manifest,
+ * scaffolding, and terminal capabilities.
+ */
+export default class DoctorCommand extends Command {
+    signature = 'doctor';
+    description = 'Check the runtime, app, and terminal setup';
+    async handle() {
+        const caps = detectCapabilities();
+        this.output.section('Runtime');
+        const nodeMajor = Number(process.versions.node.split('.')[0]);
+        if (nodeMajor >= 26) {
+            this.output.success(`Node.js ${process.versions.node}`);
+        }
+        else if (process.versions.bun) {
+            this.output.success(`Bun ${process.versions.bun}`);
+        }
+        else {
+            this.output.warn(`Node.js ${process.versions.node} (Mudah targets Node >= 26)`);
+        }
+        this.output.section('Application');
+        this.output.keyValue('name', this.app.manifest.name);
+        this.output.keyValue('version', this.app.manifest.version);
+        const binDir = join(this.app.basePath, 'bin');
+        if (existsSync(join(binDir, this.app.manifest.bin)) || existsSync(binDir)) {
+            this.output.success(`bin/${this.app.manifest.bin} present`);
+        }
+        else {
+            this.output.warn(`bin/${this.app.manifest.bin} missing — add the bin stub`);
+        }
+        const modules = await this.app.discoverCommandModules();
+        if (modules.length > 0) {
+            this.output.success(`${modules.length} command(s) discovered`);
+        }
+        else {
+            this.output.warn('no commands discovered in src/commands');
+        }
+        this.output.section('Terminal');
+        this.output.keyValue('brand', caps.brand);
+        this.output.keyValue('color', caps.trueColor ? 'truecolor' : caps.colorLevel === 8 ? '256' : caps.colorLevel === 1 ? '16' : 'off');
+        this.output.keyValue('unicode', String(caps.unicode));
+        this.output.keyValue('animations', String(caps.animations));
+        this.output.keyValue('notifications', caps.osc9 ? 'osc 9' : 'none');
+        this.output.keyValue('semantic prompts', caps.osc133 ? 'osc 133' : 'none');
+        this.output.line();
+        this.output.success('doctor complete');
+    }
+}
+//# sourceMappingURL=doctor.command.js.map

package/dist/commands/doctor.command.js.map

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

package/dist/commands/help.command.d.ts

@@ -0,0 +1,11 @@
+import { Command, type ConsoleKernel } from '@mudah-cli/console';
+/**
+ * Built-in `help` command: lists all commands, or shows details for one.
+ */
+export default class HelpCommand extends Command {
+    signature: string;
+    description: string;
+    private kernel;
+    constructor(kernel: ConsoleKernel);
+    handle(): Promise<void>;
+}

package/dist/commands/help.command.js

@@ -0,0 +1,30 @@
+import { Command } from '@mudah-cli/console';
+import { renderCommandHelp, renderCommandList } from '@mudah-cli/console';
+/**
+ * Built-in `help` command: lists all commands, or shows details for one.
+ */
+export default class HelpCommand extends Command {
+    signature = 'help {command?}';
+    description = 'Show help for the CLI or a specific command';
+    kernel;
+    constructor(kernel) {
+        super();
+        this.kernel = kernel;
+    }
+    async handle() {
+        const target = this.arg('command');
+        const lines = [];
+        if (target !== undefined) {
+            const entry = this.kernel.get(target);
+            if (!entry) {
+                throw this.usageError(`Unknown command "${target}".`, 'Run "help" to list all commands.');
+            }
+            renderCommandHelp(this.app.manifest.name, entry, lines);
+        }
+        else {
+            renderCommandList(this.app.manifest.name, this.app.manifest.version, this.kernel.list(), lines);
+        }
+        this.output.raw(lines.join('\n'));
+    }
+}
+//# sourceMappingURL=help.command.js.map

package/dist/commands/help.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.command.js","sourceRoot":"","sources":["../../src/commands/help.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,SAAS,GAAG,iBAAiB,CAAC;IAC9B,WAAW,GAAG,6CAA6C,CAAC;IAEpD,MAAM,CAAgB;IAE9B,YAAY,MAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,MAAM,IAAI,EAAE,kCAAkC,CAAC,CAAC;YAC5F,CAAC;YACD,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QAClG,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/commands/make.command.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@mudah-cli/console';
+/**
+ * Built-in `make` command: scaffold commands, providers, and config files
+ * with the right structure and imports.
+ */
+export default class MakeCommand extends Command {
+    signature: string;
+    description: string;
+    handle(): Promise<void>;
+}

package/dist/commands/make.command.js

@@ -0,0 +1,86 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { isAbsolute, join, relative } from 'node:path';
+import { Command } from '@mudah-cli/console';
+function kebab(name) {
+    return name.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function pascal(name) {
+    return kebab(name)
+        .split('-')
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+const COMMAND_TEMPLATE = (command, className) => `import { Command } from '@mudah-cli/mudah';
+
+export default class ${className} extends Command {
+  signature = '${command} {target?}';
+  description = 'Describe ${command} in one line.';
+
+  async handle() {
+    this.output.success('Hello from ${command}!');
+  }
+}
+`;
+const PROVIDER_TEMPLATE = (className) => `import { ServiceProvider } from '@mudah-cli/mudah';
+
+export default class ${className} extends ServiceProvider {
+  register(): void {}
+
+  boot(): void {}
+}
+`;
+const CONFIG_TEMPLATE = `import { defineConfig } from '@mudah-cli/mudah';
+
+export default defineConfig({
+  // Add configuration for this component.
+});
+`;
+/**
+ * Built-in `make` command: scaffold commands, providers, and config files
+ * with the right structure and imports.
+ */
+export default class MakeCommand extends Command {
+    signature = 'make {type} {name}';
+    description = 'Scaffold a command, provider, or config file';
+    async handle() {
+        const type = this.arg('type');
+        const name = this.arg('name');
+        if (!['command', 'provider', 'config'].includes(type)) {
+            throw this.usageError(`Unknown make type "${type}".`, 'Use: make {command|provider|config} {name}');
+        }
+        if (!/^[a-zA-Z][a-zA-Z0-9-]*$/.test(name)) {
+            throw this.usageError(`Invalid name "${name}".`, 'Use letters, numbers, and dashes (e.g. "deploy-site").');
+        }
+        const k = kebab(name);
+        const className = pascal(name);
+        let filePath;
+        let content;
+        if (type === 'command') {
+            filePath = join(this.app.basePath, 'src', 'commands', `${k}.command.ts`);
+            content = COMMAND_TEMPLATE(k, className);
+        }
+        else if (type === 'provider') {
+            filePath = join(this.app.basePath, 'src', 'providers', `${className}Provider.ts`);
+            content = PROVIDER_TEMPLATE(`${className}Provider`);
+        }
+        else {
+            filePath = join(this.app.basePath, 'config', `${k}.ts`);
+            content = CONFIG_TEMPLATE;
+        }
+        if (isAbsolute(filePath) === false || !filePath.startsWith(this.app.basePath)) {
+            throw this.usageError('Refusing to write outside the app directory.');
+        }
+        try {
+            await mkdir(join(filePath, '..'), { recursive: true });
+            await writeFile(filePath, content, { flag: 'wx' });
+        }
+        catch (error) {
+            if (error.code === 'EEXIST') {
+                throw this.usageError(`${relative(this.app.basePath, filePath)} already exists.`);
+            }
+            throw error;
+        }
+        this.output.success(`Created ${relative(this.app.basePath, filePath)}`);
+    }
+}
+//# sourceMappingURL=make.command.js.map

package/dist/commands/make.command.js.map

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

package/dist/commands/version.command.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `version` command. */
+export default class VersionCommand extends Command {
+    signature: string;
+    description: string;
+    handle(): Promise<void>;
+}

package/dist/commands/version.command.js

@@ -0,0 +1,10 @@
+import { Command } from '@mudah-cli/console';
+/** Built-in `version` command. */
+export default class VersionCommand extends Command {
+    signature = 'version';
+    description = 'Show the application version';
+    async handle() {
+        this.output.info(`${this.app.manifest.name} v${this.app.manifest.version}`);
+    }
+}
+//# sourceMappingURL=version.command.js.map

package/dist/commands/version.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.command.js","sourceRoot":"","sources":["../../src/commands/version.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,kCAAkC;AAClC,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,SAAS,GAAG,SAAS,CAAC;IACtB,WAAW,GAAG,8BAA8B,CAAC;IAE7C,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { run, type RunOptions } from './run.js';
+export { createWatcher, type WatcherOptions } from './watcher.js';
+export { Command } from '@mudah-cli/console';
+export { Application, EventBus, ServiceProvider, UsageError, ExitError, CommandCancelled, loadManifest, type MudahManifest, type LazyProviderOptions, type ProviderClass, type AppEvents, } from '@mudah-cli/core';
+export { ConfigRepository, defineConfig, env, loadEnvFile, loadConfigFiles } from '@mudah-cli/config';
+export { Container } from '@mudah-cli/container';
+export { detectCapabilities, type TerminalCapabilities } from '@mudah-cli/terminal';

package/dist/index.js

@@ -0,0 +1,9 @@
+export { run } from './run.js';
+export { createWatcher } from './watcher.js';
+// App-facing re-exports: `import { Command } from '@mudah-cli/mudah'` is all users need.
+export { Command } from '@mudah-cli/console';
+export { Application, EventBus, ServiceProvider, UsageError, ExitError, CommandCancelled, loadManifest, } from '@mudah-cli/core';
+export { ConfigRepository, defineConfig, env, loadEnvFile, loadConfigFiles } from '@mudah-cli/config';
+export { Container } from '@mudah-cli/container';
+export { detectCapabilities } from '@mudah-cli/terminal';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAmB,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAElE,yFAAyF;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,WAAW,EACX,QAAQ,EACR,eAAe,EACf,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,GAKb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAA6B,MAAM,qBAAqB,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,32 @@
+import { type Application as App } from '@mudah-cli/core';
+export interface RunOptions {
+    /** Raw arguments (default: `process.argv.slice(2)`). */
+    argv?: string[];
+    /** Application root (default: `process.cwd()`). */
+    cwd?: string;
+    /** Pre-built application, mainly for tests. */
+    app?: App;
+    /** Environment map for capability detection (default: `process.env`). */
+    env?: NodeJS.ProcessEnv;
+    /** Where stdout/stderr go (defaults to the real streams). */
+    stdout?: {
+        write(data: string): unknown;
+    };
+    stderr?: {
+        write(data: string): unknown;
+    };
+}
+/**
+ * The Mudah entry point. An app's `bin/<name>` stub is:
+ *
+ * ```js
+ * #!/usr/bin/env node
+ * import { run } from '@mudah-cli/mudah';
+ * process.exitCode = await run();
+ * ```
+ *
+ * `run()` boots the application (providers, discovery), builds the console
+ * kernel (built-ins + discovered commands), and dispatches argv. Returns
+ * the process exit code — it never throws for user-facing errors.
+ */
+export declare function run(options?: RunOptions): Promise<number>;

package/dist/run.js

@@ -0,0 +1,114 @@
+import { Application, loadManifest, } from '@mudah-cli/core';
+import { detectCapabilities } from '@mudah-cli/terminal';
+import { Output, resolveTheme } from '@mudah-cli/ui';
+import { ConsoleKernel, renderError, renderCommandHelp, renderCommandList } from '@mudah-cli/console';
+import HelpCommand from './commands/help.command.js';
+import VersionCommand from './commands/version.command.js';
+import MakeCommand from './commands/make.command.js';
+import BuildCommand from './commands/build.command.js';
+import DoctorCommand from './commands/doctor.command.js';
+import DevCommand from './commands/dev.command.js';
+/**
+ * The Mudah entry point. An app's `bin/<name>` stub is:
+ *
+ * ```js
+ * #!/usr/bin/env node
+ * import { run } from '@mudah-cli/mudah';
+ * process.exitCode = await run();
+ * ```
+ *
+ * `run()` boots the application (providers, discovery), builds the console
+ * kernel (built-ins + discovered commands), and dispatches argv. Returns
+ * the process exit code — it never throws for user-facing errors.
+ */
+export async function run(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const argv = options.argv ?? process.argv.slice(2);
+    const env = options.env;
+    const caps = detectCapabilities({ env });
+    let manifest;
+    try {
+        manifest = loadManifest(cwd);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        (options.stderr ?? process.stderr).write(message + '\n');
+        return 1;
+    }
+    const app = options.app ?? new Application(cwd, manifest);
+    const theme = resolveTheme(manifest.ui?.theme);
+    const output = new Output({
+        stream: options.stdout ?? process.stdout,
+        errorStream: options.stderr ?? process.stderr,
+        theme,
+        colorLevel: caps.colorLevel,
+        unicode: caps.unicode,
+        osc9: caps.osc9,
+    });
+    // Providers: discover app providers, boot, then evaluate lazy predicates.
+    await app.discoverProviders();
+    await app.boot();
+    await app.evaluateLazy();
+    // Kernel: built-ins first, then discovered app commands, then manifest extras.
+    const kernel = new ConsoleKernel(app, output);
+    registerBuiltIns(kernel);
+    const modules = [...(await app.discoverCommandModules())];
+    for (const extra of manifest.commands ?? []) {
+        const mod = (await app.importModule(extra));
+        if (mod.default)
+            modules.push(mod);
+    }
+    for (const mod of modules) {
+        try {
+            kernel.register(mod);
+        }
+        catch (error) {
+            (options.stderr ?? process.stderr).write((error instanceof Error ? error.message : String(error)) + '\n');
+        }
+    }
+    // Global flags.
+    const [first] = argv;
+    if (first === '--help' || first === '-h' || first === undefined) {
+        const lines = [];
+        renderCommandList(manifest.name, manifest.version, kernel.list(), lines);
+        output.raw(lines.join('\n'));
+        return 0;
+    }
+    if (first === '--version') {
+        output.info(`${manifest.name} v${manifest.version}`);
+        return 0;
+    }
+    if (first !== undefined && (argv[1] === '--help' || argv[1] === '-h') && kernel.has(first)) {
+        const lines = [];
+        renderCommandHelp(manifest.name, kernel.get(first), lines);
+        output.raw(lines.join('\n'));
+        return 0;
+    }
+    try {
+        return await kernel.dispatch(argv);
+    }
+    catch (error) {
+        return renderError(error, output);
+    }
+}
+function registerBuiltIns(kernel) {
+    kernel.register({
+        default: class extends HelpCommand {
+            constructor() {
+                super(kernel);
+            }
+        },
+    });
+    kernel.register({ default: VersionCommand });
+    kernel.register({ default: MakeCommand });
+    kernel.register({ default: BuildCommand });
+    kernel.register({ default: DoctorCommand });
+    kernel.register({
+        default: class extends DevCommand {
+            constructor() {
+                super(kernel);
+            }
+        },
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1 @@
+export * from '@mudah-cli/terminal';

package/dist/terminal.js

@@ -0,0 +1,2 @@
+export * from '@mudah-cli/terminal';
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1 @@
+export * from '@mudah-cli/testing';

package/dist/testing.js

@@ -0,0 +1,2 @@
+export * from '@mudah-cli/testing';
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1 @@
+export * from '@mudah-cli/ui';

package/dist/ui.js

@@ -0,0 +1,2 @@
+export * from '@mudah-cli/ui';
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/watcher.d.ts

@@ -0,0 +1,10 @@
+export interface WatcherOptions {
+    /** Debounce window in milliseconds. Default 150. */
+    debounceMs?: number;
+}
+/**
+ * Watch a set of files or directories (recursively where the platform
+ * supports it) and invoke `onChange` after a quiet debounce period.
+ * Returns a stop function. Missing paths are skipped silently.
+ */
+export declare function createWatcher(paths: string[], onChange: () => void, options?: WatcherOptions): () => void;

package/dist/watcher.js

@@ -0,0 +1,37 @@
+import { watch, existsSync } from 'node:fs';
+/**
+ * Watch a set of files or directories (recursively where the platform
+ * supports it) and invoke `onChange` after a quiet debounce period.
+ * Returns a stop function. Missing paths are skipped silently.
+ */
+export function createWatcher(paths, onChange, options = {}) {
+    const debounceMs = options.debounceMs ?? 150;
+    let timer = null;
+    const emit = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = null;
+            onChange();
+        }, debounceMs);
+    };
+    const watchers = [];
+    for (const path of paths) {
+        if (!existsSync(path))
+            continue;
+        try {
+            watchers.push(watch(path, { recursive: true }, emit));
+        }
+        catch {
+            // Some platforms don't support recursive watch; skip that path.
+        }
+    }
+    return () => {
+        if (timer)
+            clearTimeout(timer);
+        for (const watcher of watchers) {
+            watcher.close();
+        }
+    };
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAkB,MAAM,SAAS,CAAC;AAO5D;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe,EAAE,QAAoB,EAAE,OAAO,GAAmB,EAAE;IAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;IAC7C,IAAI,KAAK,GAAyC,IAAI,CAAC;IAEvD,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,QAAQ,EAAE,CAAC;QACb,CAAC,EAAE,UAAU,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,OAAO,GAAG,EAAE;QACV,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@mudah-cli/mudah",
+  "version": "0.1.0",
+  "description": "An ergonomic, animation-rich CLI framework — speed, sleek design, and developer ergonomics for Node and Bun.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=26"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "default": "./dist/ui.js"
+    },
+    "./terminal": {
+      "types": "./dist/terminal.d.ts",
+      "default": "./dist/terminal.js"
+    },
+    "./animation": {
+      "types": "./dist/animation.d.ts",
+      "default": "./dist/animation.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@mudah-cli/animation": "^0.1.0",
+    "@mudah-cli/config": "^0.1.0",
+    "@mudah-cli/console": "^0.1.0",
+    "@mudah-cli/container": "^0.1.0",
+    "@mudah-cli/core": "^0.1.0",
+    "@mudah-cli/terminal": "^0.1.0",
+    "@mudah-cli/testing": "^0.1.0",
+    "@mudah-cli/ui": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}